• 01/09/06 12:40 PM
    Sign in to follow this  
    Followers 0

    Handy PC/Mac OS X Snippets for Indie Development

    General and Gameplay Programming

    Myopic Rhino

    Introduction

    It is a fact that cross-platform indie game development is on the rise these days. The reason behind porting to Mac is that most indies sell as many copies for PC as for Mac platforms. In addition, several of the most popular indie solutions now support both Windows and Macintosh platforms, such as Torque, BlitzMax, PTK and others.

    However, even when using commercial engines, there will be a certain functionality that is not covered by the engine, and that will require native code for each platform.

    That is why we have collected the following snippets, which I am sure you will find handy during your next cross-platform development.

    Get current desktop resolution

    If your game supports different video modes, you can use the current desktop settings to adjust the default resolution and color depth in the first run.

    void GetDesktopResolution( int & width, int & height, int & bpp)
    {
    #ifdef __CARBON__
      CFDictionaryRef desktopVideoMode = CGDisplayCurrentMode( kCGDirectMainDisplay );
      if( !CFNumberGetValue( (CFNumberRef)CFDictionaryGetValue( desktopVideoMode, kCGDisplayWidth ),
                             kCFNumberIntType,
                             &width ) ||
          !CFNumberGetValue( (CFNumberRef)CFDictionaryGetValue( desktopVideoMode, kCGDisplayHeight ),
                             kCFNumberIntType,
                             &height ) ||
          !CFNumberGetValue( (CFNumberRef)CFDictionaryGetValue( desktopVideoMode, kCGDisplayBitsPerPixel ),
                             kCFNumberIntType,
                             &bpp ) )
      {
        // error, return default values
        // ...
      }
    #elif WIN32
      DEVMODE desktopVideoMode;
      ZeroMemory( reinterpret_cast( &desktopVideoMode ), sizeof( desktopVideoMode ) );
    
      if( EnumDisplaySettings( NULL, ENUM_CURRENT_SETTINGS, &desktopVideoMode ) )
      {
        m_desktopWidth = desktopVideoMode.dmPelsWidth;
        m_desktopHeight = desktopVideoMode.dmPelsHeight;
        m_desktopBpp = desktopVideoMode.dmBitsPerPel;
      }
      else
      {
        // error, return default values
        // ...
      }
    #else
    #error unsupported platform
    #endif
    }
    

    Get installed video RAM

    The Mac OS X implementation will give you the exact ammount of video memory of the first valid video adapter found. However, the Windows version, which relies on DirectX 5, will return less memory than is physically installed. For 16MB video cards, it will return about 13MB though. I ignore the purpose of this behaviour, just take it into account.

    Requiring DirectX 5 should not be a real problem, being already included in Windows 98. Furthermore, the DirectDraw DLL is dynamically loaded, so the function will just return zero in case of error (still running Windows 95 for instance).

    #ifdef WIN32
    #include 
    #include  // Needs DirectX SDK(>=5), or at least ddraw.h in your path
    typedef int (WINAPI *MYPROC)(GUID *,LPDIRECTDRAW *,IUnknown *);
    #else
    #include 
    #include 
    #endif
    
    const int GetInstalledVRAM( void )
    {
    #ifdef __CARBON__
      AGLRendererInfo info;
      GLint           vram( 0 );
      
      info = aglQueryRendererInfo ( NULL, 0 );
    
      while ( info != NULL )
      {
        if( aglDescribeRenderer( info, AGL_VIDEO_MEMORY, &vram ) == GL_TRUE )
        {
          // Return megabytes
          return static_cast( vram / (1024 * 1024) );
        }
        info = aglNextRendererInfo( info );
      }
    
      return 0;
    
    #elif WIN32
    
      HINSTANCE DDrawDLL;
      int vram ( 0 );
    
      DDrawDLL = LoadLibrary( "ddraw.dll" );
    
      if( DDrawDLL != NULL )
      {
        MYPROC DDrawCreate;
        LPDIRECTDRAW DDraw;
        HRESULT hres;
    
        DDrawCreate = ( MYPROC ) GetProcAddress( DDrawDLL, "DirectDrawCreate");
    
        if( ( DDrawCreate != NULL )
            && !FAILED( DDrawCreate( NULL, &DDraw, NULL ) ) )
        {
          DDCAPS caps;
          memset(&caps,0,sizeof(DDCAPS));
          caps.dwSize = sizeof(DDCAPS);
    
          hres = IDirectDraw2_GetCaps( DDraw, &caps, NULL );
          if( hres == S_OK )
          {
            // Return megabytes
            vram = caps.dwVidMemTotal / (1024 * 1024);
          }
    
          IDirectDraw_Release( DDraw );
        }
        FreeLibrary( DDrawDLL );
      }
      return vram;
    #else
    #error Unsupported platform
    #endif
    }
    

    Display a simple message box

    void MessageBox( const char* title, const char* message )
    {
    #if defined( __APPLE__ ) && defined( __MACH__ )
      Str255 strTitle;
      Str255 strMessage;
      CopyCStringToPascal( title, strTitle );
      CopyCStringToPascal( message, strMessage );
      StandardAlert( kAlertNoteAlert, strTitle, strMessage, NULL, 0 );
    #elif WIN32
      MessageBox( NULL, message, title, MB_OK );
    #else
    #error Unsupported platform
    #endif
    }
    

    Video playback in Windows/Mac OS X

    It is unusual to include videos in indie games because they increase the download size noticeably, but just in case you need to, here are a couple of links that will teach you how to render AVI files in OpenGL:

    In order to avoid dependencies, I recommend using the standard CinePak codec for AVI files, which is included in all versions of Windows and Mac OS X.

    Common non-portable C functions and their alternatives

    During your development, you will probably found out that there are some C functions that are not present in both Windows and Mac platforms. Three common non-portable functions are:

    round()

    You can easily implement your own version as: int Round( float x ) { return( static_cast( x + 0.5f ) ); }

    log2()

    Is the same as:

    log( x ) / log( 2 );
    

    itoa()

    Is a Microsoft specific routine. Use sprintf() instead.

    Greetings

    Thanks to Lord Trancos for pointing out the SDL source code as a useful resource to obtain the GetInstalledVRAM() code for Windows.

    Send any questions and comments to jgf8@alu.ua.es

    Resources

    0


    Sign in to follow this  
    Followers 0


    User Feedback

    Create an account or sign in to leave a review

    You need to be a member in order to leave a review

    Create an account

    Sign up for a new account in our community. It's easy!


    Register a new account

    Sign in

    Already have an account? Sign in here.


    Sign In Now

    There are no reviews to display.