After updating so much on my blog the last 2 days and posting all the unfinished posts I had prepared a few weeks ago I finally reach the last important one I wanted to make. But due the fact that I will fly to the MVP summit tomorrow I better not stay away too long. Hopefully this post still contains all the vital information. Let's get started.

First of all you need the latest version of the free NSIS (Nullsoft Installer System):

• http://nsis.sourceforge.net/Main_Page

There are TONS of information on that website and if you are new to the NSIS scripts be sure to read at least the quick start guide (called simple tutorials) and use the NSIS Forums search feature for more specific problems and questions.

Good, now just let us go quickly through the .nsi file I currently use for all my XNA Game Setups. Please note that this file has evolved over many years (I guess I started using NSIS in 2002) and parts might not be simple to read or even be how it is done today, but the script was always a very helpful and quick way to create Setups for me. While detecting all the requirements to make XNA work is not a piece of cake many NSIS tutorials helped me to figure all the parts out.

The following .nsi script is from the previous blog post "Loading Collada Models in XNA 2.0 and doing Skinning and Animation" and was used to build the XnaSkinningColladaModelsSetup.exe (2.2 MB) file. If you want to use it for your own XNA Game project just use a text-editor and replace "XnaSkinningColladaModels" with your own game name (it occurs many times in the file). Also create a .bmp file with the name of your game for the setup header (check MUI_HEADERIMAGE_BITMAP) or comment the 2 Header Image lines out with a ; or # if you do not want any header image. All files are grabbed from the /Release directory and will be installed to the target (make sure that you only have files in the /Release directory that you want to have deployed). This should be already enough information to make your setup work, the rest of this article will just go into the details of the script.

The XnaSkinningColladaModelsSetup.nsi file is organized in 6 parts (Initialization, onInit, File section, Optional sections, Helper functions and Uninstall):

• Initialization: Just sets all the names, the required modules, and how the setup is displayed to the user (all the pages, see MUI_PAGE). Version information and file information are also a vital part here and you should enter some meaningful values here. Also put any language strings for different languages (this installer is just using english text) at text part of the initialization code.
  

  !include "MUI.nsh"
  SetCompressor /SOLID lzma
  
  ;Name and file
  Name "XnaSkinningColladaModels"
  OutFile "XnaSkinningColladaModelsSetup.exe"
  
  ;Default installation folder
  InstallDir "$PROGRAMFILES\XnaSkinningColladaModels"
  
  ;Get installation folder from registry if available
  InstallDirRegKey HKLM "Software\XnaSkinningColladaModels" ""
  
  !define MUI_COMPONENTSPAGE_NODESC
  
  ;Interface Settings
  !define MUI_ICON "${NSISDIR}\Contrib\Graphics\Icons\modern-install-blue.ico"
  !define MUI_UNICON "${NSISDIR}\Contrib\Graphics\Icons\modern-uninstall-blue.ico"
  !define MUI_HEADERIMAGE
  !define MUI_HEADERIMAGE_BITMAP "XnaSkinningColladaModels.bmp"
  !define MUI_HEADERIMAGE_UNBITMAP "XnaSkinningColladaModels.bmp"
  !define MUI_ABORTWARNING
  
  ;Pages
  !insertmacro MUI_PAGE_WELCOME
  !insertmacro MUI_PAGE_COMPONENTS
  !insertmacro MUI_PAGE_DIRECTORY
  !insertmacro MUI_PAGE_INSTFILES
  
  !insertmacro MUI_UNPAGE_CONFIRM
  !insertmacro MUI_UNPAGE_INSTFILES
  
  ;Languages
  !insertmacro MUI_LANGUAGE "English"
  
  ;Version Information
  VIProductVersion "1.0.0.0"
  VIAddVersionKey /LANG=${LANG_ENGLISH} "ProductName" "XnaSkinningColladaModels"
  VIAddVersionKey /LANG=${LANG_ENGLISH} "Comments" "XnaSkinningColladaModels project, see http://BenjaminNitschke.com"
  VIAddVersionKey /LANG=${LANG_ENGLISH} "CompanyName" "BenjaminNitschke.com"
  VIAddVersionKey /LANG=${LANG_ENGLISH} "LegalCopyright" "© BenjaminNitschke.com 2007"
  VIAddVersionKey /LANG=${LANG_ENGLISH} "FileDescription" "XnaSkinningColladaModels"
  VIAddVersionKey /LANG=${LANG_ENGLISH} "FileVersion" "1.0.0.0"
  
  ; The text to prompt the user to enter a directory
  ComponentText "This will install XnaSkinningColladaModels for XNA 2.0."
  
  UninstallText "This will remove XnaSkinningColladaModels for XNA 2.0 from your computer."
  
  ; New .NET Check function, we want at least v2.0
  !define DOT_MAJOR "2"
  !define DOT_MINOR "0"
  
  ; The text to prompt the user to enter a directory
  DirText "Please select a directory for the installation:"
  
  AutoCloseWindow true
  

  
  
• .onInit: This method is executed before the installer is run and can perform any checks you like. I just try to find out if any c:\games directory exists in several languages, if it does, then we can use it, else just use the default c:\program files location.
  

  
  Function .onInit
      ;First try to find "Games" (eng), "Spiele" (ger), "jeux" (fr),
      ; "giochi" (ita), "jogos" (port) or "spelen" (nl) directory!
      StrCpy $R1 "C:\Games"
      IfFileExists $R1 UseIt
      StrCpy $R1 "C:\Spiele"
      IfFileExists $R1 UseIt
      StrCpy $R1 "C:\jeux"
      IfFileExists $R1 UseIt
      StrCpy $R1 "C:\giochi"
      IfFileExists $R1 UseIt
      StrCpy $R1 "C:\jogos"
      IfFileExists $R1 UseIt
      StrCpy $R1 "C:\spelen"
      IfFileExists $R1 UseIt
      Goto DontUseIt
  UseIt:
      StrCpy $INSTDIR "$R1\XnaSkinningColladaModels"
  DontUseIt:
  FunctionEnd
  

  
  
• File section: This is the most important section and always required because it tells the setup where the files come from (in our case from the Release sub directory) and where they should be installed (in #INSTDIR).
  

  
  ; The stuff to install
  Section "XnaSkinningColladaModels"
    SectionIn RO
    ; Set output path to the installation directory.
    SetOutPath $INSTDIR
    ; Put file there
    File /r "Release\*.*"
   
    ; Write the installation path into the registry
    WriteRegStr HKLM "SOFTWARE\XnaSkinningColladaModels" "Install_Dir" "$INSTDIR"
    WriteRegStr HKLM "SOFTWARE\XnaSkinningColladaModels" "Version" "v1.0"
    ; Write the uninstall keys for Windows
    WriteRegStr HKLM "Software\Microsoft\Windows\CurrentVersion\Uninstall\XnaSkinningColladaModels" "DisplayName" "XnaSkinningColladaModels"
    WriteRegStr HKLM "Software\Microsoft\Windows\CurrentVersion\Uninstall\XnaSkinningColladaModels" "UninstallString" "$INSTDIR\uninstall.exe $INSTDIR"
    WriteUninstaller "uninstall.exe"
  SectionEnd
  

  
  
• Optional sections: These sections are optional and the user can decide not to create desktop shortcuts, not to install XNA 2.0 if it is not found, etc. I usually leave them all on by default because they make sense. Most important here are the DirectX and XNA prequisites sections, which make a lot of use of the helper functions.
  

  
  ; Optional sections
  Section "Create Start-Menu shortcuts"
    StrCpy $R1 "$SMPROGRAMS\XnaSkinningColladaModels"
    CreateDirectory "$R1"
    CreateShortCut "$R1\XnaSkinningColladaModels.lnk" "$INSTDIR\XnaSkinningColladaModels.exe" "" "$INSTDIR\XnaSkinningColladaModels.exe" 0 "" "" "XnaSkinningColladaModels"
    CreateShortCut "$R1\XnaSkinningColladaModels Uninstall.lnk" "$INSTDIR\uninstall.exe" "" "$INSTDIR\uninstall.exe" 0 "" "" "Uninstall XnaSkinningColladaModels."
    CreateShortCut "$R1\BenjaminNitschke.com.lnk" "http://BenjaminNitschke.com" "" "" 0 "" "" "BenjaminNitschke.com website from the creator of this game"
  SectionEnd
  
  Section "Create Desktop shortcuts"
    CreateShortCut "$DESKTOP\XnaSkinningColladaModels.lnk" "$INSTDIR\XnaSkinningColladaModels.exe" "" "$INSTDIR\XnaSkinningColladaModels.exe" 0
  SectionEnd
  
  Section "Check for .NET 2.0 Framework (required)"
    Call IsDotNETInstalled
    Pop $0
    StrCmp $0 1 found.NETFramework no.NETFramework
  no.NETFramework:
  ;MessageBox MB_OK ".NET was not found .."
    ; First of all check for correct IE version!
    Call CheckForCorrectIEVersion
    ; First check if DotNetFx.exe exists
    IfFileExists "$EXEDIR\DotNetFx.exe" 0 DotNetFileNotFound
    ReadRegStr $R0 HKLM "SOFTWARE\Microsoft\Windows NT\CurrentVersion\Winlogon" "AutoAdminLogon"
    ExecWait '"$EXEDIR\DotNetFx.exe" /q'
    StrCmp $R0 1 RestoreAutoLogon End
  RestoreAutoLogon:
    WriteRegStr HKLM "SOFTWARE\Microsoft\Windows NT\CurrentVersion\Winlogon" "AutoAdminLogon" "1"
    goto End
  
    ; If DotNetFx.exe was not found, try downloading online
  DotNetFileNotFound:
    MessageBox MB_YESNOCANCEL|MB_ICONQUESTION ".NET Framework 2.0 was not found. XnaSkinningColladaModels will not run without it! $\r$\nWould you like to automatically download and install it? $\r$\n $\r$\nChoose Yes for an automatic download and installation. $\r$\nChoose No, you want to select the download yourself (e.g. locally if already downloaded). $\r$\nMicrosoft's .NET Framework Download page will open up! $\r$\nChoose cancel to abort any action here, you will have to install the .NET Framework (2.0) $\r$\nyourself. That can be done for example automatically by the Windows Update $\r$\n(just go to http://windowsupdate.microsoft.com )" IDYES DL IDNO IndirectDL
    goto End
    IndirectDL:
      ExecShell open "http://www.microsoft.com/downloads/details.aspx?FamilyID=0856eacb-4362-4b0d-8edd-aab15c5e04f5" "" SW_SHOWNORMAL
      goto End
    DL:
      Call ConnectInternet ;Make an internet connection (if no connection available)
  
      StrCpy $2 "$TEMP\DotNetFX_Setup.exe"
      NSISdl::download http://download.microsoft.com/download/5/6/7/567758a3-759e-473e-bf8f-52154438565a/dotnetfx.exe $2
      Pop $0
      StrCmp $0 success success
        SetDetailsView show
        DetailPrint "download failed: $0"
        MessageBox MB_OK ".NET could not be installed, download was aborted. Please install .NET yourself! $\r$\nRest of the installation went ok, you just need .NET 2.0 to start XnaSkinningColladaModels!"
        goto End
      success:
        ; Install, in quiet mode (will do everything automatically)
        ExecWait '"$2" /q'
        Delete $2
    
      goto End
  found.NETFramework:
  ;MessageBox MB_OK ".NET is installed, very good ^^"
  End:
  SectionEnd
  
  Section "Check for DirectX 9.0c (November 2007) (required)"
    call IsDirectX9Installed
    pop $0
    StrCmp $R1 1 maybefound.DirectX9 notFound.DirectX9
  maybefound.DirectX9:
      ; Check if managed directx december 2006 is installed!
      IfFileExists "$WINDIR\Microsoft.NET\DirectX for Managed Code\1.0.2911.0" found.DirectX9  
  notFound.DirectX9:
  ;MessageBox MB_OK "DirectX9 or better was not found!"
    ; First check if a file "dx90update_redist.exe" exists
    IfFileExists "$EXEDIR\directx_nov2007_redist.exe" 0 DX9RedistFileNotFoundTest1
    ExecWait '"$EXEDIR\directx_nov2007_redist.exe" /Q /T:"$TEMP" /C'
    ; Now install DirectX9
    ExecWait "$TEMP\dxsetup.exe"
    goto End
  DX9RedistFileNotFoundTest1:
      ; Check again in temp folder
    IfFileExists "$TEMP\directx_nov2007_redist.exe" 0 DX9RedistFileNotFound
    ExecWait '"$TEMP\directx_nov2007_redist.exe" /Q /T:"$TEMP" /C'
    ; Now install DirectX9
    ExecWait "$TEMP\dxsetup.exe"
    goto End
    ; If that failed, ask user!
  DX9RedistFileNotFound:
    MessageBox MB_YESNOCANCEL|MB_ICONQUESTION "DirectX9.0c November 2007 or better was not found. XnaSkinningColladaModels needs DirectX9.0c and Managed DirectX runtimes to run. $\r$\nWould you like to automatically download and install it? $\r$\n $\r$\nChoose Yes for an automatic download and installation. $\r$\nChoose No, you want to select the download yourself (e.g. in another language than english). $\r$\nMicrosoft's DirectX Download page will open up! $\r$\nChoose cancel to abort any action here, you will have to install DirectX yourself." IDYES DL IDNO IndirectDL
    goto End
  IndirectDL:
    ExecShell open "http://www.microsoft.com/downloads/details.aspx?familyid=1A2393C0-1B2F-428E-BD79-02DF977D17B8" "" SW_SHOWNORMAL 
    goto End
  DL:
    Call ConnectInternet ;Make an internet connection (if no connection available)
  
    StrCpy $2 "$TEMP\directx_nov2007_redist.exe"
    NSISdl::download http://download.microsoft.com/download/c/6/a/c6af7ea3-f85c-4fef-a475-5810f82def1f/directx_nov2007_redist.exe $2
  
    Pop $0
    StrCmp $0 success success
      SetDetailsView show
      DetailPrint "download failed: $0"
      MessageBox MB_OK "DirectX could not be installed, download was aborted. Please install DirectX yourself! $\r$\nRest of the installation went ok, you just need DirectX 9.0c December 2006 to start XnaSkinningColladaModels!"
      goto End
    success:
      ; Install quietly into temp folder
      ExecWait '"$2" /Q /T:"$TEMP" /C'
      ; Now install DirectX9
      ExecWait "$TEMP\dxsetup.exe"
      ; Yeah, we made it!
      ;why delete, maybe user wants to keep it ^^ Delete $2
    goto End
  found.DirectX9:
  ;MessageBox MB_OK "Found DirectX9 or better .."
    goto End
  End:
  SectionEnd
  
  Section "Check for XNA 2.0 (December 2007) (required)"
    call IsXNAInstalled
    pop $0
    StrCmp $R1 1 found.XNA notFound.XNA
  notFound.XNA:
    MessageBox MB_YESNOCANCEL|MB_ICONQUESTION "XNA 2.0 (December 2007) or better was not found. The XnaSkinningColladaModels needs the XNA 2.0 runtimes to run. $\r$\nWould you like to automatically download and install it? $\r$\n $\r$\nChoose Yes for an automatic download and installation. $\r$\nChoose No, you want to select the download yourself (e.g. in another language than english). $\r$\nMicrosoft's XNA Download page will open up! $\r$\nChoose cancel to abort any action here, you will have to install XNA yourself." IDYES DL IDNO IndirectDL
    goto End
  IndirectDL:
    ExecShell open "http://www.microsoft.com/downloads/details.aspx?FamilyID=15fb9169-4a25-4dca-bf40-9c497568f102" "" SW_SHOWNORMAL 
    goto End
  DL:
    Call ConnectInternet ;Make an internet connection (if no connection available)
  
    StrCpy $2 "$TEMP\xnafx20_redist.msi"
    NSISdl::download "http://download.microsoft.com/download/b/8/a/b8a1f45a-63e6-4d1f-9c03-55a83d30ee3b/xnafx20_redist.msi" $2
  
    Pop $0
    StrCmp $0 success success
      SetDetailsView show
      DetailPrint "download failed: $0"
      MessageBox MB_OK "XNA 2.0 could not be installed, download was aborted. Please install XNA 2.0 yourself! $\r$\nRest of the installation went ok, you just need XNA 2.0 (December 2007) to start the XnaSkinningColladaModels!"
      goto End
    success:
      ; Install XNA, quietly does not work on vista for some reason ...
      ExecWait 'msiexec /i "$2" /q'
      ; Yeah, we made it!
      ;why delete, maybe user wants to keep it ^^ Delete $2
    goto End
  found.XNA:
  ;MessageBox MB_OK "Found XNA 2.0 or better .."
    goto End
  End:
  SectionEnd
  
  Section "-Ask some questions"
    MessageBox MB_YESNO|MB_ICONQUESTION "Start the XnaSkinningColladaModels now?" IDYES StartRC
    goto DontStart
  StartRC:
    Exec "$INSTDIR\XnaSkinningColladaModels.exe"
  DontStart:
  SectionEnd
  

  
  
• Helper functions: These little helpers are the utitilies to make all the complex XNA installation steps work. They go through all the steps from making sure .NET is installed, installing it automatically for you if you like, even opening up an internet connection if you are on dialup, checking all the prequisites for installing .NET (like having at least IE 5) and then finally install all the XNA 2.0 and DirectX stuff that is required to run your game on top of that. All without ever leaving the installer and tested on many platforms. I usually do not touch this code unless I have to update some links or include a newer version of .NET, DirectX or XNA. I tried to comment my work, but understanding this script part will not be easy. Just do not expect that any changes you make here will be safe. You need to do a lot of testing in order to add additional functionality here.
  

  ; IsDotNETInstalled
  ;
  ; Usage:
  ;   Call IsDotNETInstalled
  ;   Pop $0
  ;   StrCmp $0 1 found.NETFramework no.NETFramework
  ;Function IsDotNETInstalled
  ;   Push $0
  ;   Push $1
  ;   Push $2
  ;   Push $3
  ;   Push $4
  ;
  ;   ReadRegStr $4 HKEY_LOCAL_MACHINE \
  ;     "Software\Microsoft\.NETFramework" "InstallRoot"
  ;   # remove trailing back slash
  ;   Push $4
  ;   Exch $EXEDIR
  ;   Exch $EXEDIR
  ;   Pop $4
  ;   # if the root directory doesn't exist .NET is not installed
  ;   IfFileExists $4 0 noDotNET
  ;
  ;   StrCpy $0 0
  ;
  ;   EnumStart:
  ;
  ;     EnumRegKey $2 HKEY_LOCAL_MACHINE \
  ;       "Software\Microsoft\.NETFramework\Policy"  $0
  ;     IntOp $0 $0 + 1
  ;     StrCmp $2 "" noDotNET
  ;
  ;     StrCpy $1 0
  ;
  ;     EnumPolicy:
  ;
  ;       EnumRegValue $3 HKEY_LOCAL_MACHINE \
  ;         "Software\Microsoft\.NETFramework\Policy\$2" $1
  ;       IntOp $1 $1 + 1
  ;        StrCmp $3 "" EnumStart
  ;         IfFileExists "$4\$2.$3" foundDotNET EnumPolicy
  ;
  ;   noDotNET:
  ;     StrCpy $0 0
  ;     Goto done
  ;
  ;   foundDotNET:
  ;     StrCpy $0 1
  ;
  ;   done:
  ;     Pop $4
  ;     Pop $3
  ;     Pop $2
  ;     Pop $1
  ;     Exch $0
  ;FunctionEnd
  
  ; Call IsDotNetInstalled
  ; This function will abort the installation if the required version 
  ; or higher version of the .NETFramework is not installed.  Place it in
  ; either your .onInit function or your first install section before 
  ; other code.
  Function IsDotNETInstalled
    Push $0
    Push $1
    Push $2
    Push $3
    Push $4
  
    StrCpy $0 "0"
    StrCpy $1 "SOFTWARE\Microsoft\.NETFramework" ;registry entry to look in.
    StrCpy $2 0
  
    StartEnum:
      ;Enumerate the versions installed.
      EnumRegKey $3 HKLM "$1\policy" $2
  
  ;MessageBox MB_OK "EnumRegKey $3"
      ;If we don't find any versions installed, it's not here.
      StrCmp $3 "" noDotNet notEmpty
  
      ;We found something.
      notEmpty:
        ;Find out if the RegKey starts with 'v'.  
        ;If it doesn't, goto the next key.
        StrCpy $4 $3 1 0
        StrCmp $4 "v" +1 goNext
        StrCpy $4 $3 1 1
        
        ;It starts with 'v'.  Now check to see how the installed major version
        ;relates to our required major version.
        ;If it's equal check the minor version, if it's greater, 
        ;we found a good RegKey.
        IntCmp $4 ${DOT_MAJOR} +1 goNext yesDotNetReg
        ;Check the minor version.  If it's equal or greater to our requested 
        ;version then we're good.
        StrCpy $4 $3 1 3
        IntCmp $4 ${DOT_MINOR} yesDotNetReg goNext yesDotNetReg
  
      goNext:
        ;Go to the next RegKey.
        IntOp $2 $2 + 1
        goto StartEnum
  
    yesDotNetReg:
  ;MessageBox MB_OK "DotNet Reg stuff was found!"
      ;Now that we've found a good RegKey, let's make sure it's actually
      ;installed by getting the install path and checking to see if the 
      ;mscorlib.dll exists.
      EnumRegValue $2 HKLM "$1\policy\$3" 0
      ;$2 should equal whatever comes after the major and minor versions 
      ;(ie, v1.1.4322)
      StrCmp $2 "" noDotNet
      ReadRegStr $4 HKLM $1 "InstallRoot"
      ;Hopefully the install root isn't empty.
      StrCmp $4 "" noDotNet
      ;build the actuall directory path to mscorlib.dll.
      StrCpy $4 "$4$3.$2\mscorlib.dll"
  ;MessageBox MB_OK "Does $4 exists?"
      IfFileExists $4 yesDotNet noDotNet
  
    noDotNet:
  ;MessageBox MB_OK "DotNet was not found .."
      StrCpy $0 0
      Goto done
  
    yesDotNet:
  ;MessageBox MB_OK "DotNet stuff was found!"
      StrCpy $0 1
    done:
      Pop $4
      Pop $3
      Pop $2
      Pop $1
      Exch $0
  FunctionEnd
  
  Function ConnectInternet
    ClearErrors
    Dialer::AttemptConnect
    IfErrors noie3
  
    Pop $R0
    StrCmp $R0 "online" connected
      Strcpy $R0 "Cannot connect to the internet."
      MessageBox MB_OK|MB_ICONSTOP $R0
      Quit
  
    noie3:
  
    ; IE3 not installed
    MessageBox MB_OK|MB_ICONINFORMATION "Please connect to the internet now."
  
    connected:
  FunctionEnd
  
  ;GetIEVersion
  ; Based on Yazno's function, [url]http://yazno.tripod.com/powerpimpit/[/url]
  ; Returns on top of stack
  ; 1-6 (Installed IE Version)
  ; or
  ; '' (IE is not installed)
  ;
  ; Usage:
  ;   Call GetIEVersion
  ;   Pop $R0
  ;   ; at this point $R0 is "5" or whatnot
  Function GetIEVersion
     Push $R0
     ClearErrors
     ReadRegStr $R0 HKLM "Software\Microsoft\Internet Explorer" "Version"
     IfErrors lbl_123 lbl_456
  
     lbl_456: ; ie 4+
        ReadRegStr $R0 HKLM "Software\Microsoft\Internet Explorer\Version Vector" "IE"   
        Strcpy $R0 $R0 4
        Goto lbl_done
  
     lbl_123: ; older ie version
        ClearErrors
        ReadRegStr $R0 HKLM "Software\Microsoft\Internet Explorer" "IVer"
        IfErrors lbl_error
  
        StrCpy $R0 $R0 3
        StrCmp $R0 '100' lbl_ie1
        StrCmp $R0 '101' lbl_ie2
        StrCmp $R0 '102' lbl_ie2
  
        StrCpy $R0 '3' ; default to ie3 if not 100, 101, or 102.
        Goto lbl_done
        lbl_ie1:
           StrCpy $R0 '1'
           Goto lbl_done
        lbl_ie2:
           StrCpy $R0 '2'
           Goto lbl_done
        lbl_error:
           StrCpy $R0 ''
        lbl_done:
     Exch $R0
  FunctionEnd
  
  ; Checks for current IE version and will try to call
  ; IE6Setup.exe if it exists, otherwise prompt the user
  ; to install it for himself (at least IE5.01 is required for .NET)
  Function CheckForCorrectIEVersion
     Call GetIEVersion
     Pop $R0
     Push $R1
     StrCpy $R1 $R0 1
     StrCmp $R1 '6' lbl_IEOK
     StrCmp $R1 '5' lbl_IE5
     StrCmp $R1 '4' lbl_IEKO
     StrCmp $R1 '2' lbl_IEKO
     StrCmp $R1 '3' lbl_IEKO
     StrCmp $R1 '1' lbl_IEKO
  
     lbl_IE5:
        StrCmp $R0 '5.00' lbl_IEKO
        Goto lbl_IEOK
     lbl_IEKO:
  ;MessageBox MB_OK "IE5.01 or better was not found!"
        ; First check if ie6setup.exe exists
        IfFileExists "$EXEDIR\Setups\ie6sp1\ie6setup.exe" 0 IE6FileNotFound
        ExecWait '"$EXEDIR\Setups\ie6sp1\ie6setup.exe"'
        goto lbl_IEOK
        ; If DotNetFx.exe was not found, try downloading online
      IE6FileNotFound:
        MessageBox MB_YESNOCANCEL|MB_ICONQUESTION "IE5.01 or better was not found. .NET can't be installed without it! $\r$\nWould you like to automatically download and install it? $\r$\n $\r$\nChoose Yes for an automatic download and installation. $\r$\nChoose No, you want to select the download yourself (e.g. in another language than english). $\r$\nMicrosoft's .NET Framework Download page will open up! $\r$\nChoose cancel to abort any action here, you will have to install IE5.01 or better$\r$\nyourself, that can be done for example automatically by the Windows Update $\r$\n(just go to http://windowsupdate.microsoft.com )" IDYES DL IDNO IndirectDL
        goto lbl_IEOK
       IndirectDL:
        ExecShell open "http://www.microsoft.com/downloads/details.aspx?FamilyID=1e1550cb-5e5d-48f5-b02b-20b602228de6" "" SW_SHOWNORMAL
        goto lbl_IEOK
       DL:
        Call ConnectInternet ;Make an internet connection (if no connection available)
        StrCpy $2 "$TEMP\IE6Setup.exe"
        NSISdl::download http://download.microsoft.com/download/ie6sp1/finrel/6_sp1/W98NT42KMeXP/EN-US/ie6setup.exe $2
        Pop $0
        StrCmp $0 success success
        SetDetailsView show
        DetailPrint "download failed: $0"
        MessageBox MB_OK "IE6Setup could not be installed, download was aborted. Please install IE and .NET yourself! $\r$\nRest of the installation went ok, you just need IE for .NET to start XnaSkinningColladaModels!"
        goto lbl_IEOK
      success:
        ; Install, in quiet mode (will do everything automatically)
        ExecWait '"$2"'
        Delete $2
     lbl_IEOK:
  ;MessageBox MB_OK "IE5.01 or better was found .."
  FunctionEnd
  
  ; Check if DirectX9 or better is installed,
  ; will return $0 1 then, else $0 is 0.
  Function IsDirectX9Installed
    Push $0
  
    ReadRegStr $0 HKLM "SOFTWARE\Microsoft\DirectX" "Version"
    StrCpy $1 $0 4 3
    IntCmp $1 9 found.DirectX9 notFound.DirectX9 found.DirectX9
  notFound.DirectX9:
  ;MessageBox MB_OK "can't find direct9"
    StrCpy $0 0
    Goto done
  
  found.DirectX9:
  ;MessageBox MB_OK "found direct9 or better"
    StrCpy $0 1
  
  done:
  ;MessageBox MB_OK "direct9 found value: $0"
    StrCpy $R1 $0
    Exec $0
  FunctionEnd
  
  ; Check if XNA 2.0 or better is installed,
  ; will return $0 1 then, else $0 is 0.
  Function IsXNAInstalled
    Push $0
  
    ;Enumerate the versions installed.
    EnumRegKey $0 HKCU "SOFTWARE\Microsoft\XNA\Game Studio" "v2.0"
      ;if the root directory doesn't exist XNA is not installed
    StrCmp $0 "" notFound.XNA found.XNA
  
  notFound.XNA:
  ;MessageBox MB_OK "can't find XNA"
    StrCpy $0 0
    Goto done
  
  found.XNA:
  ;MessageBox MB_OK "found XNA or better"
    StrCpy $0 1
  
  done:
  ;MessageBox MB_OK "XNA found value: $0"
    StrCpy $R1 $0
    Exec $0
  FunctionEnd
  

  
  
  
• And finally the uninstall section: This section will deinstall your game and get rid of all files in the directory that belong to the game, if there is more, it will not kill any other sub directories or even delete the game directory if there is other data present. If you want to be totally sure that only your game files are deleted, only include files that have been installed in this section via the Delete command. I used 2 RMDir /r commands to delete the Content and ColladaModels directories, which makes things much easier. But if for example the user made screenshots, they will be saved in a /Screenshots directory, which is not deleted here and will stay alive even after the uninstall is complete. There is also another check to make sure the game is still installed at this location by making sure the .exe file still exists. If the .exe file is missing, the uninstaller assumes the game is already uninstalled and it will only remove registry keys, but not any files.
  

  
  ; special uninstall section.
  Section "Uninstall"
    ; REMOVE UNINSTALLER
    Delete $INSTDIR\uninstall.exe
  
    ; remove registry keys
    DeleteRegKey HKLM "Software\Microsoft\Windows\CurrentVersion\Uninstall\XnaSkinningColladaModels"
    DeleteRegKey HKLM "SOFTWARE\XnaSkinningColladaModels"
  
    ; remove shortcuts, if any.
    Delete "$SMPROGRAMS\XnaSkinningColladaModels\*.*"
    Delete "$DESKTOP\XnaSkinningColladaModels.lnk"
    ; remove directories used.
    RMDir "$SMPROGRAMS\XnaSkinningColladaModels"
  
    ; First check if rocket commander is located here, if not, dont kill stuff!
    IfFileExists "$INSTDIR\XnaSkinningColladaModels.exe" 0 RCNotFound
    ; remove files
    Delete "$INSTDIR\XnaSkinningColladaModels.*"
    RMDir /r "$INSTDIR\Content"
    RMDir /r "$INSTDIR\ColladaModels"
    
    ; Try to kill main folder, but this will fail if there are still some files in it
    RMDir "$INSTDIR"
    goto End
    RCNotFound:
    MessageBox MB_OK "XnaSkinningColladaModels.exe was not found in $INSTDIR, won't delete any files, $\r$\nplease remove directory and files yourself (all registry keys were killed)."
    End:
  SectionEnd
  

  
  

Okay, we have now covered all code of the XnaSkinningColladaModelsSetup.nsi file, download it and check it out for yourself if you want to learn more about it or even use it in your projects. Good luck!

Even when I did not post much last week I was very busy converting all the old XNA 1.0 games to XNA 2.0. I did not only convert all projects (8 games in total, see below), but I also tested them extensively on Windows XP, Vista (32 and 64 bit) and the Xbox 360. Additionally a lot of usability improvements have been implemented in the games, for example the XNA Shooter is now much easier (was almost impossible to even reach 50% of the level) and a lot more fun due better balancing. The XNA Racing Game has now a better physic engine and will not longer let the car fly out of the track or leave ground in loopings. Due the better input control and fixed physics the cars drive now much faster and it is more challenging to complete the tracks in shorter time frames.

Games in this article:

• Chapter1Game
• Xna Pong
• Xna Breakout
• Xna Tetris
• Rocket Commander Xna
• Xna Shooter
• Xna Racing Game
• Dungeon Quest GDC

Please read my previous post about Converting XNA 1.0 games to XNA 2.0 for all technical tips. All the games can also be found on http://XnaProjects.net, but I will also make them easier accessible on this blog soon, which has an update overdue (need to clean up the left and right sides) ^^

Thanks to the great VS2005 support of XNA 2.0 all games have now just one single solution file, which works on Windows and the Xbox 360. The projects can be opened in XNA Game Studio 2.0 and Visual Studio 2005 without having to convert the files over and over again like in the past. The Icons for all games were also improved. Lets take a look at the Icons (.ico files) on Windows:


For the Xbox 360 game icons the .png files (usually named GameThumbnail.png) are used:


Ok, let's take a look at the games and what has changed for them. Most games are pretty much the same as for XNA 1.0, but a lot of smaller bugs were fixed and they have been tested more.

• Chapter1Game: This application is not really a game, but a test project to check out if XNA 2.0 is properly working on both Windows and the Xbox 360. It is from the first chapter of my book "Professional XNA Game Programming". BTW: The second edition of the book is coming out soon, there are 3 more chapters about Multiplayer game programming and a cool new role playing game.
  
  
  • Game Installer: Chapter1GameSetup.exe (210 KB)
  • Source Code and Game Content: Chapter1GameSourceCode.zip (57 KB)
  • Screenshot:
    
    
    
• Xna Pong: Xna Pong is a simple clone of the favorite pong game from 1978. It is just a few hunderd lines of code and should be very easy to understand.
  
  This game is from the book "Professional XNA Game Programming" by Benjamin Nitschke. For more information read chapter 2. (2008-02-10: Now updated to XNA 2.0)
  
  
  • Game Installer: XnaPongSetup.exe (309 KB)
  • Source Code and Game Content: XnaPongSourceCode.zip (258 KB)
  • Screenshot:
    
    
    
• Xna Breakout: XNA Breakout is a simple Breakout/Arcanoid game based on the XNA Pong game from the previous chapter.
  
  It is fully described and covered in Chapter 3 of my book "Professional XNA Game Programming". The code is quite short and should be easy to understand. (2008-02-10: Now updated to XNA 2.0)
  
  
  • Game Installer: XnaBreakoutSetup.exe (383 KB)
  • Source Code and Game Content: XnaBreakoutSourceCode.zip (316 KB)
  • Screenshot:
    
    
    
• Xna Tetris: This is a simple, but highly addictive Tetris game. You can control the blocks with your cursor keys, aswd or a game pad and the game works both on Windows and the Xbox 360. Reaching levels above 5 is really hard. My highest level was 9, try to reach more :) (2008-02-10: Now updated to XNA 2.0)
  
  This game introduces the helper classes (chapter 4 of my book) and makes more use of unit testing and game components in XNA.
  
  
  • Game Installer: XnaTetrisSetup.exe (310 KB)
  • Source Code and Game Content: XnaTetrisSourceCode.zip (277 KB)
  • Screenshot:
    
    
    
• Rocket Commander Xna: XNA port of the famous Rocket Commander game. The game principle stayed the same, but the controls were a little bit simplified to make it more fun on the Xbox 360.
  
  If you want to learn more about the Rocket Commander game, check out its official website www.RocketCommander.com and check out the Video Tutorials on Coding4Fun by MSDN. (2008-02-10: Now updated to XNA 2.0, also supports very big resolutions now and runs faster on the Xbox 360)
  
  
  • Game Installer: RocketCommanderXnaSetup.exe (16.5 MB)
  • Source Code and Game Content: RocketCommanderXnaSourceCode.zip (52.8 MB)
  • Screenshot:
    
    
    
• Xna Shooter: Shoot'n'up game specifically created for my book "Professional XNA Game Programming". It features full HDTV support, runs on Windows and the Xbox 360, 5 weapon types, 5 enemy types, a powerful ship and some power ups. It is quite fun to play and it gets harder and harder the longer you play. Based partly on the Rocket Commander XNA engine, but also features lots of new effects and shaders. (2008-02-10: Now updated to XNA 2.0, also much easier and balanced)
  
  This game and the racing game are the most improved. The game works now much better in high resolutions and on the Xbox 360. But most importantly the game is now much easier, balanced and more fun. Additionally a level percentage is now visible on the bottom and more EMP bombs can be picked up to make it easier at the end of the level.
  
  • Game Installer: XnaShooterSetup.exe (14.9 MB)
  • Source Code and Game Content: XnaShooterSourceCode.zip (32.2 MB)
  • Screenshot:
    
    
    
• Xna Racing Game: XNA Racing Game Starter Kit I wrote for http://creators.xna.com. More information and more downloads can be found on http://XnaRacingGame.com. It runs best on the Xbox 360 in HDTV (1920x1200), but it also runs fine on the PC. (2008-02-10: Now updated to XNA 2.0, driving also improved a lot, better tested on Xbox 360 and fixed some issues).
  
  Following things were improved: Shadow mapping on very big resolutions works now (crashed before), more options for lower quality settings, fixed physics, car now always stays on the road, fixed loopings, cars are much faster now, winning conditions work better now, and fixed several other bugs.
  
  • Game Installer: XnaRacingGameSetup.exe (40.2 MB)
  • Source Code and Game Content: XnaRacingGameSourceCode.zip (95.4 MB)
  • Screenshot:
    
    
    
• Dungeon Quest GDC: And finally the Dungeon Quest XNA Game, which was developed in just 4 days on the GDC 2007 at the XNA Contest. Dungeon Quest GDC is a relatively complex 3D role playing game (at least for just 4 days of work). An early version even supported coop multiplayer on the Xbox 360 via splitscreen. The game was developed by Benjamin Nitschke (abi.exDream.com) and Christoph Rienaecker (WAII). (2008-02-10: Now updated to XNA 2.0). This is NOT the full Dungeon Quest game (see www.DungeonQuestGame.com for that), this is just the GDC version.
  
  Please note that the level was reduced to allow loading on the Xbox 360 (which otherwise crashes with an OutOfMemoryException), the game is not fully playable, only the first part is implemented. You can also press F2 to toggle the Options menu and some minor bugs were fixed. But this game is no longer supported, I will not improve it anymore! Please check out the new Dungeon Quest game from www.DungeonQuestGame.com, which is coming in a month or so.
  
  • Game Installer: DungeonQuestGDCSetup.exe (25.6 MB)
  • Source Code and Game Content: DungeonQuestGDCSourceCode.zip (67.2 MB)
  • Screenshot:
    
    
    

Have fun with all the games :)

When I wrote this (a little bit each day while working on converting the old XNA projects) I was very aware about the disappointment of my blog readers about the fact that I did not blog much in the last couple of months, especially on XNA. I not only got a lot of emails about that, but also quite a lot of questions, especially since XNA 2.0 was released. I made yet another promise to myself to change that and finally blog more, maybe not only when something very interesting pops up, but instead about the everyday issues I run into.

Some Notes about XNA 2.0: More solid, lots of little new features, networking, while it may not be a very complete solution, at least it is now possible on the Xbox 360 and overall I have the feeling even more people are interested in XNA than a year ago. Plus the guys at the XNA Team doing a great job and are constantly improving the XNA Creators Club website for us game programmers and artists :)


Several people had problems using the old XNA 1.0 code of my games and make them work with XNA 2.0, so here is a little help in case you want to convert XNA 1.0 projects to XNA 2.0. You will also notice this if you go to any XNA community site as most samples will still be in XNA 1.0 and not work out of the box in XNA 2.0, and many of those will probably never be changed since they are not longer actively being developed.

For most games almost all of the code can stay unchanged, you just have to poke at a few things that have changed in the framework or were improved. More information about converting projects can be found here (read this first, this article is based on the stuff there). You can also use the Cross-Platform Game Project Converter from XNA 2.0 to add a Xbox 360 project to your existing Windows XNA project without having to create a separate project (it is helpful, but I used pretty much the same trick for all of my XNA 1.0 games anyway).

Let's go through the steps:

1. Either use the XNA project conversion utility (can be found on the XNA Creators Club website) or just create a new XNA 2.0 project in VS 2005.
   
   
2. If you created a new project, drag all source code files into the project and seperate the content files out and put them all in the existing Content directory (only there the content pipeline is activated). If you just converted a project and the content files did not move, move them yourself to the content directory. Gladly all my projects with more than 5 content files had a special content directory anyway, so no need to change anything content-wise for them. If you don't want some of the files to be compiled to .xnb files, you have to change the build action from "compile" to "content" (and then use the "copy to output directory" switch) or to "none" if you want them to be ignored like for .wav files, which are automatically processed by the .xct (XACT) file for you.
   
   
3. Find the line content = new ContentManager(Services); and replace it with Content.RootDirectory = "Content";. If you do that, get rid of the content manager in your game class since you can now use the build-in Content property to access the underlying Game content manager. In case you don't want to do that or if you need an extra variable, replace the above line with content = new ContentManager(Services, "Content");. Both ways will make sure all the content is now loaded from the content directory instead from the main directory of the application. In more complex XNA games you can also change the BaseGameDirectory to the content directory, but then you would also have to move all other resource files to this directory (config files, save games, levels, etc.). It is usually a good idea to separate the compiled (.xnb) content from the content the user can change (config, levels, etc.), so I suggest just redirecting the content directory of the content manager.
   
   
4. Replace the LoadGraphicsContent(bool) method with LoadContent, remove all the if (loadAllContent) commands (was never false anyway, just let the content of the if loop stay) and also remove the call to base.LoadGraphicsContent(bool) (does not do anything like all the Load or Unload methods in the XNA Game class, they are just empty virtual methods). You can also ignore this and the next step since it will only generate depreciated warnings, but I suggest cleaning up your source code whenever an opportunity like this presents itself. I also added some missing region blocks to the code and some comments here and there were they were missing.
   
   
5. Finally delete the UnloadGraphicsContent method unless it did anything beside base.Unload and base.UnloadGraphicsContent. In my XNA games the UnloadGraphicsContent usually looked like this and can be safely removed now (at least if nothing else is in there):

/// <summary>
/// Unload graphic content if the device gets lost.
/// </summary>
/// <param name="unloadAllContent">Unload everything?</param>
protected override void UnloadGraphicsContent(bool unloadAllContent)
{
  if (unloadAllContent == true)
    content.Unload();

  base.UnloadGraphicsContent(unloadAllContent);
} // UnloadGraphicsContent(loadAllContent)



6. In case you load sound and music via the AudioEngine, you have to change the directory to the content directory too, which will not be done automatically for you since you load the .xct file directly in the AudioEngine constructor. Basically just exchange the following code:
   
   

   audioEngine = new AudioEngine("YourSound.xgs");
   waveBank = new WaveBank(audioEngine, "Wave Bank.xwb");
   soundBank = new SoundBank(audioEngine, "Sound Bank.xsb");
   

   with:
   

   audioEngine = new AudioEngine("Content\\YourSound.xgs");
   waveBank = new WaveBank(audioEngine, "Content\\Wave Bank.xwb");
   soundBank = new SoundBank(audioEngine, "Content\\Sound Bank.xsb");

      
   
7. In case you have used the StorageDevice and specifically the ShowStorageDeviceGuide helper method, it is gone now in XNA 2.0. I had it in some helper classes, but never actually used it. In case you want to show a save game dialog (or some network game select dialog for example), please follow the XNA 2.0 help instructions to do this asynchronously now.
   
   
8. In case you use any ResourceUsage enum, replace it with TextureUsage instead or remove it if the issue is not texture related. You can also safely remove any ResourceManagementMode.Automatic parameters, which are not longer supported. Everything is now automatic anyway. Just if you have been using ResourceUsage.RenderTarget you will need to change the Texture2D class to a ResolveTexture2D class in order to archive the same behaviour as before. Some calls to the device (e.g. ResolveBackBuffer) have also changed and require a ResolveTexture2D now. You may also want to check if you have any manual texture management or disposing, which you can remove or simplify.
   
   
9. For simpler games (2D) games you should be done now. More complex games using render targets and other features that have changed in XNA 2.0 will require some more changes, but after you have done them once (or know where to change what) this is also a quick process.

The following only applies to the RocketCommanderXna, XnaShooter and XnaRacingGame engines, but you might find similarities with other XNA games and the converting process:

1. First of all make sure the old XNA 1.1 code gets compileable by going though the changes mentioned above (e.g. replacing ResourceUsage with TextureUsage or BufferUsage) and removing everything that does not exist anymore (like ResourceManagementMode.Automatic). If a method is non-existent in XNA 2.0 like ResolveRenderTarget, comment it out and remember where it happened.
   
   
2. You might go through other issues, but you have to come back to the RenderTarget issue. This took the most time in the converting process for me (probably half of all my issues come by something related to changes with RenderTargets in XNA 2.0). For that reason always make sure that rendering to textures still works while you make changing. I always used the TestCreateRenderToTexture unit test inside the RenderToTexture class to figure things out.
   
   
3. Additionally to making some changes in the BaseGame class (loading content via LoadContent, using the base.Content instead of creating a new content manager, etc.) I also removed all the RenderTarget helper methods and fields from the BaseGame class (SetRenderTarget, ResetRenderTarget, etc.) and moved them into the RenderToTexture class. While this makes the code more clean and restructured by making a few more fields private, if you do not call the new InitializeDepthBufferFormatAndMultisampling of the RenderToTexture class the calls to SetRenderTarget and ResetRenderTarget will not work correctly and will not restore the default depth buffer (which has to be remembered first). If you get the following exception it means the DepthBuffer Device.DepthStencilBuffer was set to null, but is obviously still used. In order to fix that make sure the remDepthBuffer variable is set to a correct value in the InitializeDepthBufferFormatAndMultisampling method!
   


An error has occurred during the Clear operation while trying to clear the depth or stencil buffer, no DepthStencilBuffer surface exists.
System.InvalidOperationException: An error has occurred during the Clear operation while trying to clear the depth or stencil buffer, no DepthStencilBuffer surface exists.
at Microsoft.Xna.Framework.Graphics.GraphicsDevice.Clear(ClearOptions options, Color color, Single depth, Int32 stencil, Rectangle[] regions)
at Microsoft.Xna.Framework.Graphics.GraphicsDevice.Clear(Color color)

   

4. 4. Even if you have now done everything, the app may still crash when you are trying to clear a render target (which usually happens at the start of each pre or post screen shader). The reason for the following error is the multi sampling format, which might be set to the background buffer, but not to the render targets:
   

   
   The active render target and depth stencil surface must have the same pixel size and multisampling type.
   System.InvalidOperationException: The active render target and depth stencil surface must have the same pixel size and multisampling type.
   at Microsoft.Xna.Framework.Graphics.GraphicsDevice.VerifyDepthRenderTargetCompat()
   at Microsoft.Xna.Framework.Graphics.GraphicsDevice.Clear(ClearOptions options, Color color, Single depth, Int32 stencil, Rectangle[] regions)

      
   In order to get rid of this error without changing the RenderToTexture class a lot, you can just comment out the line where multi sampling is activated in BaseGame:
   

   //this.graphics.PreferMultiSampling = true;

There are probably even more things that I forgot while converting the projects (converted 8 games and about 15 projects in total now), but the above list should be helpful. Especially for me because I always forget some of those little things and having this checklist is very helpful.

Tomorrow I will probably test all the XNA 2.0 games on my Xbox 360 and make some final adjustments and then post them all on http://XnaProjects.net (and here).

Yes. My XNA book is finally out and some people even got an early version last week. There is also some discussion going on in the XNA Forums and on the official Wrox forum for the book.

The coolest thing yesterday that my book was on Rank #16 for Computer/Technical books on Amazon.com and on Rank 500 something for all books. Quite impressive if you ask me, hopefully it will continue to stay high and make me filthy rich .. just kidding.

Yesterday I wanted to put all the samples from the book on my blog, but it is already way to overloaded here with screenshots and games, adding another 10 games will not make anything better. Instead I had a crazy idea to create a XNA Community site in one day. It is called XnaProjects.Net. The idea is for everyone to submit their games and links. News are grabbed with Google Blog Search and more features will come in July 2007 when I got more than 5 minutes time in a row.

Anyway, check out this great new website, submit your games and links and check out whats already submitted by me (10 Games so far, yes, thats a lot of XNA games I did in the past few months):

• XNA Pong
• XNA Breakout
• XNA Tetris
• Rocket Commander XNA
• XNA Shooter
• XNA Racing Game
• SimpleRacingGame
• SpeedyRacer
• Dungeon Quest
• Skinning with Collada Models in XNA

You can find source code and game installers for all of these games, including some nice screenshots and a YouTube video for each of them on the XnaProjects.Net website. Check it out:

Sorry for not blogging yesterday. We were working all day on our game here on the GDC 2007 and it was very noisy and distracting here. If you want to watch us work: We are in the Moscone North Lobby and shouldn't be hard to find. Anyway, I will probably just blog at the morning of the next day for each day here.

Our game is called Dungeon Quest and we are absolutely insane because we want to create a Multiplayer Role Playing Game in just 4 days and we haven't even thought of all the distractions here. I will try to give you a screen per day and tell you want we have done so far.

Yesterday we worked purely on the environment, the level and the general game idea and some smaller details. As I said before we started with nothing, I just created a new project and Christoph did just open up 3DS Max and started working, there are no textures or models we have already done. And we both have never worked on a role playing game before.

In the morning we still had a lot of problems getting our computers up and running (3DS Max wasn't starting, I needed lots of plugins and tools, stuff like that). It usually takes a day or more to set up a development machine in our opinion. Probably a week until you got all the important tools installed you forgot in the first day. Anyway, we finally started to build the cave, create new custom collada exporter for that and placed lights. While Christoph was working on the 3D cave I was getting the engine up and running and noticed that there are many things that have to be done:

• Like just rendering some text on the screen,
• Finding a good font for that,
• Creating a bitmap font,
• Also making other UI elements (selected monster, health, level up, etc.)
• Rendering shaders and playing around with point lights
• Working on many other smaller issues like effects, billboards, vertex formats, etc.
• Most unit tests require a good camera and testing the cave level itself was very hard, so I already created the ThridPersonCamera class we going to use for this game.

I started with most classes that are required for that and I also could drop in some Texture/Font code from Rocket Commander XNA, but most of the shader and collada import classes had to be created from scratch. Then we spend all evening and even this morning tweaking the shaders, getting all the lights working, adding fog, figuring out how to do 6 complex light passes in one shader, and so on.

Today we will focus on building the main character, getting some collision detection working and some basic game logic (keys, doors, monster state machines, player behaviour and animations). Hopefully I can provide you with a nicer screenshot tomorrow, just an empty level is pretty boring.

And here are some pictures from yesterday for your enjoyment.

This is the lobby of the Moscone North building at the GDC. The GDC Expo hall is below us and on Monday the Serious Games Summit was here, but we hadn't had any time to even check out who is speaking at the actual GDC. At wednesday I will be at some Collada round table speaking about Collada and issues we had with it so far ^^

There are many art galleries here in San Francisco and the Asian population is also huge. It was not hard to find an Asian Art Gallery.

Here you can see an ad for Microsoft's Vista Operating System directly in front of the big Mac building here (seems a lot of people got one here). There is nothing interesting about a Mac for a game developer IMO.

Alcatraz at day time. I already showed you a picture at night earlier.

A view from my desk at the Hotel over San Francisco. Its still impressive every day you wake up ^^

And some picture of a place I don't know the name of. Usually I would look it up, but I have to go back to work. Cya tomorrow!

Don't ask me how I managed to not post anything this week. My plan was certainly different, but I didn't want to post my problem with this little project too early. To make up with the lack of blog posts this year until now this is going to be a very long and hopefully very useful article

Content

• Video, Screenshot and Downloads
• Introduction and why Collada?
• Class Overview
• Loading collada files
• Problems with the animation data
• Optimizing vertices
• Optimizing the Optimization
• Adjusting the shaders for skinned meshes
• Post screen shaders for the final result
• References and Links

Video, Screenshot and Downloads

First of all, here is a video for the project I'm talking about here:

Screenshot of the same scene (better quality since youtube videos just suck quality wise):

Before you start reading this article I suggest you download the executable and source code first in case you want to try it out directly while reading. The whole project is based on the RocketCommanderXNA engine and just adds the ColladaModel.cs class, which does all the amazing stuff you see in the video The video above shows shadowing from the XNA Shooter engine, which is not yet released and their fore not included in the downloads. The rest of the code is the same, just the shadow map rendering was removed. More details about shadow mapping in XNA can also be found in my book (plug plug plug ^^).

• The source code is about 2.6 MB and contains projects for XNA Game Studio Windows and the Xbox platform, as well as a project for Visual Studio 2005. It was tested on Windows XP and Vista 32 and 64 bit as well as on the Xbox 360.
  SkinningWithColladaModelsInXnaSourceCode.zip (2.6 MB)
• The executable contains the output (32 bit Windows, but runs on 64 bit and Vista too) from the project in case you just want to try it out or do not have XNA Game Studio Express installed yet. You still need the XNA Framework for this program, download it here, if you do not have it installed yet! You also need a Shader Model 2.0 capable graphic card.
  SkinningWithColladaModelsInXnaExecuteable.zip (2.5 MB)
  
  Update 2007-02-26: Fixed time steps, in release mode with more than 200-300 fps the animation was getting too slow. Now works flawless :)
  

Please note that the 3D Goblin Model was created by my friend Christoph Rienaecker (WAII) and if you want to use it, please credit him (see Readme.txt). The source code and collada loading class can be used freely too, but I want some credits too (at least in the source code ^^).

Introduction and why Collada?

OK, let's get started. I talked a lot about the XNA Content Pipeline and its problems on my blog, and in several recent interviews and also in my upcoming XNA book. For projects like Rocket Commander or even the Racing Game it was sometimes a little bit annoying, but I could do everything I needed by loading X files and adding some features to it to fix the tangents, load the correct shader techniques, etc.
However XNA does not support loading animation data or gives you a way to display them. You have to do all that work by yourself. This includes static mesh animations (like it was used in Rocket Commander, I just left it out in Rocket Commander XNA), but also skeletal animation with bones and skinned meshes.

There is a nice project on CodePlex called XNA Animation Component Library, but it only support FBX and ASCII X files (and recently BVH, ASF and AMC formats) and I could not get any of my test models to work with this library. The main thing missing here is good shader support and it also has a lot of problems with complex animated models. Other than that exporting 3D Models as X files is really a pain in the ass, no matter which exporter you use (Panda Exporter for 3dsMax was good a year ago, I still use it, now kiloWatt X file Exporter for 3dsMax is better, and the Microsoft X File Exporter for Max always sucked). Simple models might work, but the more complex 3D models get and the more meshes and animation data is stored in a scene, the more problems you will have. Sometimes it is not possible to reconstruct everything correctly on your importer side.

Anyway, at the very beginning of the Racing Game development there was no content pipeline in XNA (it was Beta 1) and I implemented loading 3D Models with help of the collada file format, which is basically just XML and very easy to read. For that reason it was relatively simple to get some 3D data loaded and displayed in the early XNA versions with help of vertex buffers. There were some problems with shader settings and I had to try many different exporters and ended up with the one from Feeling Software. Back then it had still some problems loading shaders and using the correct techniques, but the recent version (3.0.2) is much better and works like a charm.

After Microsoft had implemented the content pipeline and made it possible to load X and FBX files indirectly by going over the content pipeline I had to remove most of my collada code and re implement the model loading with the new framework. Loading and displaying 3D models was much simpler this way and especially some early unit tests were really simple, but as soon I tried shaders and loading tangents there were a bunch of problems. I reported many bugs back then and it has gotten a lot better, but I still had to fix several issues in the Racing Game and Rocket Commander XNA myself like finding out the correct shader technique and fixing tangent data with help of a custom model processor.

Some things like the level loading in the Racing Game just do not work with X or FBX files because they use splines, which are not exported at all in these formats. Collada came as the rescue again because it is really no big problem for this format. Later versions of the Racing Game removed the collada level loading and introduced a binary format for the levels, but the importer still accepts collada files.

Recently I wanted to test a couple of animated models and use skinning since it can often be more useful than static animations and it usually looks much better, especially for organic 3D models. As I said above I could not get anything working with the XNA Animation Component Library and I especially do not like the way they still use the content pipeline and the project is too complicated for me anyway (I just do not need 6 different file formats, I just want one and it should work perfectly with all the features I need).

After some searching I saw some guy called remi from the collada forum was working on importing collada models too and I posted some thoughts there too (maybe this was a mistake, I got many emails asking me about tips ^^). Here is the thread about that in the collada forum. He has provided a test project with some models and it works nice for static meshes without shader information, but that was not really what I was searching for.

This was a month ago and I had not much time working on any of these issues, but after restarting my blog earlier this week I thought this would be a nice topic to talk about. I'm still pretty busy with Arena Wars Reloaded, but I worked a couple of hours every day on this little test program for the past few days. The rest of this article explains the project and into which problems I ran.

Class Overview

Before we go into the details here is a little class overview of the project. As I said before the Rocket Commander XNA engine was used to get up and running with the project without having to re implement the basics. Most of the classes were already in place and had not to be changed. ColladaModel and SkinnedTangentVertex are the 2 new classes and to help us out with the XML loading of the collada files the XmlHelper class was also brought into the project.

I wrote the ColladaModel file from scratch, but I could reuse some of the static mesh loading code I had done last year. All of the bone and animation loading code was just try and error and I only used the collada specifications as a source of help, but most stuff had to be tested with the unit tests at the end of the class many many times.

The main program just calls the unit tests TestGoblinColladaModelScene or TestShowBones, there is no real game here, its just a test program. The unit test then calls several Standard Engine classes for doing all the post screen processing, rendering the ground plane, etc. More importantly the ColladaModel class itself basically just provides a constructor and a Render method, everything else is private and will be handled automatically for you. Most people might ignore this, but this is always the most important thing about my classes, the use should be as simple as possible and when I look at the projects mentioned above I really ask myself why people sometimes think so complicated.

The internal Bone class inside ColladaModel is used to store all the bones in a flat list, but each entry has a parent and a list old children bones. This way the list can be used both in a simple for loop, but you can also go through it recursively (which is obviously slower and often more complicated). We will talk about the loading process in a minute.

All the mesh data is stored in vertices, which is just a list of SkinnedTangentVertex structs. The SkinnedTangentVertex struct is very much like the standard TangentVertex struct used in Rocket Commander XNA, but it has 2 new members: blendIndices and blendWeights. Both are in the form of Vector3 and their fore can hold 3 values allowing us to interpolate up to 3 bone influences for each vertex in the shader. More is often not required and we have to re normalize all bone weights anyway, so skipping the least important bone weights is not a big deal. My test models use mostly max. 2-3 influences. Please also note that the vertex shader has now a lot more work to do with all that skinning and you should really optimize it as much as possible. Both the number of vertices we have to process is important (we will talk about optimizing that in the optimizing part of this article) and also the number of instructions the vertex shader has, both numbers should be as low as possible. The GPU is really fast processing this data, but if you do not have animated geometry with bones, there is no reason to let it process all that data (which can make the vertex shader 2-3 times longer and slower). The ground of our test scene does not use a skinning shader as an example.

And finally there are some additions to the ShaderEffect class. First of all we got a new shader called "SkinnedNormalMapping", which does the same thing as the normal mapping (or parallax mapping) shader, but it has an array of 80 bone matrices we can use for skinning. These matrices are set with help of the SetBoneMatrices method in the Set Parameter region of ShaderEffect.cs.

Loading collada files

Before we go into the details of the loading process, lets make sure we read the summary of the class first because it clearly states what we can do and can't do with this class. This is just a test project and I wanted to make things as simple as possible for both you as the reader and for my requirements.

   /// <summary>
   /// Collada model. Supports bones and animation for collada (.dae) exported
   /// 3D Models from 3D Studio Max (8 or 9).
   /// This class is just for testing and it will only display one single mesh
   /// with bone and skinning support, the mesh also can only have one single
   /// material. Bones can be either in matrix mode or stored with transform
   /// and rotation values. SkinnedTangentVertex is used to store the vertices.
   /// </summary>
   class ColladaModel : IDisposable

OK, with that said let's go directly into the loading code, which is located in the constructor of this class. All variables used in these class are just for internal use, all you need to know are the vertices and bone lists, which I have already mentioned, and the vertex and index buffers, which are used for rendering. All the rest of the variables are just there to help us loading the collada file (don't worry, there are not many variables anyway and most methods are short too).

    #region Constructor
    /// <summary>
    /// Create a model from a collada file
    /// </summary>
    /// <param name="setName">Set name</param>
    public ColladaModel(string setName)
    {
        // Set name to identify this model and build the filename
        name = setName;
        string filename = Path.Combine(ColladaDirectory,
            StringHelper.ExtractFilename(name, true) + "." +
            ColladaExtension);

        // Load file
        Stream file = File.OpenRead(filename);
        string colladaXml = new StreamReader(file).ReadToEnd();
        XmlNode colladaFile = XmlHelper.LoadXmlFromText(colladaXml);

        // Load material (we only support one)
        LoadMaterial(colladaFile);
        
        // Load bones
        LoadBones(colladaFile);

        // Load mesh (vertices data, combine with bone weights)
        LoadMesh(colladaFile);

        // And finally load bone animation data
        LoadAnimation(colladaFile);

        // Close file, we are done.
        file.Close();
    } // ColladaModel(setFilename)
    #endregion

As you can see first of all the filename is constructed and we just load the file as a text file and throw it to the XmlHelper.LoadXmlFromText helper method (which just uses the existing XmlDocument functionality to load xml from a string). We now get the main collada node, which contains all the children nodes we need for loading the materials, bones, meshes, etc.

Next all the materials are loaded, but we are only going to use the first one we find because we only support one single mesh anyway. The LoadMaterial method goes through all used textures and shader effects from the collada file and constructs the material at the end of the method with help of a new constructor in the Material class itself. While this is cool and a lot easier than loading material data from x files, it is not very exciting code, so let's move along.

Even through the bones are located at the end of the collada file, we have to load them first because all our other loading methods, specifically LoadMesh and LoadAnimation need the bone tree structure and the overall bone list to work. All bones are loaded in sequential order because we want to make sure that we can use the animation matrices later in an easy way without having to check the parent order all the time. Only this way we can be sure that going through our flat bones list we still respect the internal tree structure and always initialize the parents first because the children bones matrices are always multiplied with the parent bones.

    foreach (XmlNode boneNode in boneNodes)
        if (boneNode.Name == "node" &&
            (XmlHelper.GetXmlAttribute(boneNode, "id").Contains("Bone") ||
            XmlHelper.GetXmlAttribute(boneNode, "type").Contains("JOINT")))
        {
            // [...] get matrix
            matrix = LoadColladaMatrix(...);

            // Create this node, use the current number of bones as number.
            Bone newBone = new Bone(matrix, parentBone, bones.Count,
                XmlHelper.GetXmlAttribute(boneNode, "sid"));

            // Add to our global bones list
            bones.Add(newBone);
            // And to our parent, this way we have a tree and a flat list in
            // the bones list :)
            if (parentBone != null)
                parentBone.children.Add(newBone);

            // Create all children (will do nothing if there are no sub bones)
            FillBoneNodes(newBone, boneNode);
        } // foreach if (boneNode.Name)

As you can see the code uses the XmlHelper class extensively because otherwise the code would look much uglier and complex. Next we have to load the mesh itself, this is probably the longest method and not easy to figure out if you work with collada for the first time. Good thing I had already done that in the past and I only had to add the code for getting the blend weights and indices. The following code does load all the weights, which we will use later to fill the blendWeights and blendIndices members of the SkinnedTangentVertex struct vertices list. The code for that is actually a little bit more complicated because we have to find out which weights are the top 3 weights for each vertex in case more than 3 are given.

    #region Load weights
    float[] weights = null;
    foreach (XmlNode sourceNode in skinNode)
    {
        // Get all inv bone skin matrices
        if (sourceNode.Name == "source" &&
            XmlHelper.GetXmlAttribute(sourceNode, "id").Contains("bind_poses"))
        {
            // Get inner float array
            float[] mat = StringHelper.ConvertStringToFloatArray(
                XmlHelper.GetChildNode(sourceNode, "float_array").InnerText);
            for (int boneNum = 0; boneNum < bones.Count; boneNum++)
                if (mat.Length / 16 > boneNum)
                {
                    bones[boneArrayOrder[boneNum]].invBoneSkinMatrix =
                        LoadColladaMatrix(mat, boneNum * 16);
                } // for if
        } // if

        // Get all weights
        if (sourceNode.Name == "source" &&
            XmlHelper.GetXmlAttribute(sourceNode, "id").Contains("skin-weights"))
        {
            // Get inner float array
            weights = StringHelper.ConvertStringToFloatArray(
                XmlHelper.GetChildNode(sourceNode, "float_array").InnerText);
        } // if
    } // foreach

    if (weights == null)
        throw new InvalidOperationException(
            "No weights were found in our skin, unable to continue!");
    #endregion

For more information about the mesh loading please check out the last region in the LoadMesh method, it should explain all the important steps in case you want to add something there or just look how it works.

Problems with the animation data

Getting the animation data was not so easy. First of all I never had done this before because my collada files for the Racing Game were all just static meshes and I really did not need any animation there. Everything that is actually animated in the Racing Game was done directly in XNA, not in 3D Studio.

The first problem is the many formats that animation data can be in. You can have rotations around any axis or translations and even scalings, but most of your bones will only use one or two of these if they are animated at all. Alternatively all the animation data can be computed directly by the exporter plugin in 3D Studio Max and this way you can make sure that all the animation data is in the correct format. It makes testing certainly a lot harder and if you don't even know the format the matrices are in or how to apply them to each other in which order, you are in a world of trouble.

This is exactly what happened to me, I had most of my test models with rotation animation data only, but the Goblin above from my friend Christoph was done with another technique and the exporter could only export the matrices, so I had to support that too. After some try and error I managed to get the basic animations for my test models working. They are all in the project, feel free to load and test them. To test the bone animations I used the following unit test:

    #region Unit Testing
    // Note: Allow calling all this even in release mode (see Program.cs)
    #region TestShowBones
    /// <summary>
    /// TestShowBones
    /// </summary>
    public static void TestShowBones()
    {
        ColladaModel model = null;
        PlaneRenderer groundPlane = null;
        // Bone colors for displaying bone lines.
        Color[] BoneColors = new Color[]
            { Color.Blue, Color.Red, Color.Yellow, Color.White, Color.Teal,
            Color.RosyBrown, Color.Orange, Color.Olive, Color.Maroon, Color.Lime,
            Color.LightBlue, Color.LightGreen, Color.Lavender, Color.Green,
            Color.Firebrick, Color.DarkKhaki, Color.BlueViolet, Color.Beige };

        TestGame.Start("TestLoadColladaModel",
            delegate
            {
                // Load our goblin here, you can also load one of my test models!
                model = new ColladaModel(
                    //"Goblin");
                    //"test_bones_simple_baked");
                    //"test_bones_advanced_baked");
                    "test_man_baked");

                // And load ground plane
                groundPlane = new PlaneRenderer(
                    new Vector3(0, 0, -0.001f),
                    new Plane(new Vector3(0, 0, 1), 0),
                    new Material(
                        "GroundStone", "GroundStoneNormal", "GroundStoneHeight"),
                    50);
            },
            delegate
            {
                // Show ground
                groundPlane.Render(ShaderEffect.parallaxMapping, "DiffuseSpecular20");

                // Show bones without rendering the model itself
                if (model.bones.Count == 0)
                    return;

                // Update bone animation.
                model.UpdateAnimation(Matrix.Identity);

                // Show bones (all endpoints)
                foreach (Bone bone in model.bones)
                {
                    foreach (Bone childBone in bone.children)
                        BaseGame.DrawLine(
                            bone.finalMatrix.Translation,
                            childBone.finalMatrix.Translation,
                            BoneColors[bone.num % BoneColors.Length]);
                } // foreach (bone)
            });
    } // TestShowBones()
    #endregion

The most important call here is the call to UpdateAnimations, which goes through the list of bones and updates the so called finalMatrix from the Bone class for each of the bones. In earlier versions this code was horribly complicated and still had a lot of problems, but as soon as I removed all the rotation, translation, scaling, etc. animation support and just allow loading the correctly baked matrices from the collada files, the code has become much simpler (the actual code does have some optimizations in it, but it is basically the same as the posted code here):

    #region Update animation
    /// <summary>
    /// Update animation.
    /// </summary>
    private void UpdateAnimation(Matrix renderMatrix)
    {
        int aniMatrixNum = (int)(BaseGame.TotalTime * frameRate)) % numOfAnimations;

        foreach (Bone bone in bones)
        {
            // Just assign the final matrix from the animation matrices.
            bone.finalMatrix = bone.animationMatrices[aniMatrixNum];

            // Also use parent matrix if we got one
            // This will always work because all the bones are in order.
            if (bone.parent != null)
                bone.finalMatrix *=
                    bone.parent.finalMatrix;
        } // foreach
    } // UpdateAnimation()
    #endregion

For the loading itself we just have to make sure that the animationMatrices are the correct ones. Collada saves them in a absolute mode. Earlier code from me constructed relative matrices (relative to the initial bone matrix), it was easier to construct relative matrices from the rotation, translation, etc. animation data, but much harder to use these matrices later for the animation. Having these absolute matrices makes the UpdateAnimation code so much easier, so make sure you always use them this way.

However, when rendering the vertices later we can't use the absolute matrices because the vertices have to transformed first to get into a relative space to the bones, rotations should not be around the origin, but around the bone positions. Luckily for us (and you should have seen my face when I finally found out that these matrices already exist in collada and I did not have to create them myself in my own over complicated way ^^) collada stores the so called invBoneSkin matrices for each bone. By applying these matrices we can easily get the bone matrices we need for rendering, these are directly passed to our shader (as compressed 4x3 matrices BTW to save shader constants, the code for that is a little bit more complex, please check out ShaderEffect.cs and the SkinnedNormalMapping.fx shader itself for details).

    #region GetBoneMatrices
    /// <summary>
    /// Get bone matrices for the shader. We have to apply the invBoneSkinMatrix
    /// to each final matrix, which is the recursively created matrix from
    /// all the animation data (see UpdateAnimation).
    /// </summary>
    /// <returns></returns>
    private Matrix[] GetBoneMatrices(Matrix renderMatrix)
    {
        // Update the animation data in case it is not up to date anymore.
        UpdateAnimation(renderMatrix);

        // And get all bone matrices, we support max. 80 (see shader).
        Matrix[] matrices = new Matrix[Math.Min(80, bones.Count)];
        for (int num = 0; num < matrices.Length; num++)
            // The matrices are constructed from the invBoneSkinMatrix and
            // the finalMatrix, which holds the recursively added animation matrices
            // and finally we add the render matrix too here.
            matrices[num] =
                bones[num].invBoneSkinMatrix * bones[num].finalMatrix * renderMatrix;

        return matrices;
    } // GetBoneMatrices()
    #endregion

And this is what you finally get after executing the TestShowBones unit test. I had not implemented mesh loading or the shader itself at this point. I just was loading and testing the bones itself.

 

Optimizing the vertices

One major problem with the loaded mesh is the high vertices count, I had two test models with 30k and 60k vertices and as you can imagine this will slow down the vertex shader quite a lot and it is really not necessary to process all these vertices because many of them are exactly the same. The reason we end up with an unoptimized vertices list anyway is because collada stores seperate lists for each component we have to put together at the end of the LoadMesh method. By doing so we have to duplicate the data many times and we just can't know how often each part is reused and how often the overall vertex changes. If just the texture coordinate or normal differs, we have a completely different vertex, which will produce different results in the vertex shader, so just merging everything together is not that simple.

The rendering uses an index buffer anway, but for the data constructed in LoadMesh it would just be sequential (0, 1, 2 form the first polygon, 3, 4, 5 the next, etc.). Instead of having one index for each vertex, we can often reuse the same vertex 3 or 4 times and reducing the number of vertices drastically. This has also the advantage that we can store much more vertices and complexer meshes even if we still use ushort (16 bit) for our indices (which is half the size of ints and their fore faster). For example if you have 150,000 vertices, but you can reduce them to 40-50,000 optimized vertices, they all can be indexed with ushorts

The easy solution is just to optimize all the vertices after all of them have been loaded, if you have a binary format and do not use collada directly, this solution is absolutely great, but it still will take a lot of time processing the collada models if they just have many vertices because we have to check each vertex against each other one and that can be a lot of compares if you have 60 or 70 thousand vertices in a mesh. It actually takes up to a whole minute just to compute that and I have no slow computer ^^ Here is the method that does all that for us:

    #region OptimizeVertexBufferSlow
    /// <summary>
    /// Optimize vertex buffer. Note: The vertices list array will be changed
    /// and shorted quite a lot here. We are also going to create the indices
    /// for the index buffer here (we don't have them yet, they are just
    /// sequential from the loading process above).
    ///
    /// Note: Slow version because we have to check each vertex against
    /// each other vertex, which makes this method exponentially slower
    /// the more vertices we have. Takes 10 seconds for 30k vertices,
    /// and over 40 seconds for 60k vertices. It is much easier to understand,
    /// but it produces the same output as the fast OptimizeVertexBuffer
    /// method and you should always use that one (it only requires a couple
    /// of miliseconds instead of the many seconds this method will spend).
    /// </summary>
    /// <returns>ushort array for the optimized indices</returns>
    private ushort[] OptimizeVertexBufferSlow()
    {
        List<SkinnedTangentVertex> newVertices =
            new List<SkinnedTangentVertex>();
        List<ushort> newIndices = new List<ushort>();

        // Go over all vertices (indices are currently 1:1 with the vertices)
        for (int num = 0; num < vertices.Count; num++)
        {
            // Try to find already existing vertex in newVertices list that
            // matches the vertex of the current index.
            SkinnedTangentVertex currentVertex = vertices[FlipIndexOrder(num)];
            bool reusedExistingVertex = false;
            for (int checkNum = 0; checkNum < newVertices.Count; checkNum++)
            {
                if (SkinnedTangentVertex.NearlyEquals(
                    currentVertex, newVertices[checkNum]))
                {
                    // Reuse the existing vertex, don't add it again, just
                    // add another index for it!
                    newIndices.Add((ushort)checkNum);
                    reusedExistingVertex = true;
                    break;
                } // if (TangentVertex.NearlyEquals)
            } // for (checkNum)

            if (reusedExistingVertex == false)
            {
                // Add the currentVertex and set it as the current index
                newIndices.Add((ushort)newVertices.Count);
                newVertices.Add(currentVertex);
            } // if (reusedExistingVertex)
        } // for (num)

        // Reassign the vertices, we might have deleted some duplicates!
        vertices = newVertices;

        // And return index list for the caller
        return newIndices.ToArray();
    } // OptimizeVertexBufferSlow()
    #endregion

 

Optimizing the Optimization

While this is all nice and dandy and we just optimized the rendering code by 20-30% (I tested with 9 goblins and using 3 passes for them, 2 for shadowing and 1 for the rendering), but the loading now takes painfully long. The main idea here is to not compare every single vertex against every other possible vertex because it does not make much sense, most of the vertices (>99,9%) will always be different. We only need to check the ones that share at least the same position.

I started with comparing neighboring vertices, but since the vertices are stored in index order, they are totally messed up, vertex 1 and 4383 can be equal, but if we just check -10 to +10 we are going to miss it. Instead we have to know which vertices come from the same position data, which we know since collada saves unique positions. All we have to do is to keep a list of all vertices that share the same position and then we can optimize the comparsions later on. Usually only up to 4 to 6 vertices share the same position, this way the whole comparison process just needs 60,000 * 6 comparisons, not 60,000*60,000 anymore.

    // Initialize reuseVertexPositions and reverseReuseVertexPositions
    // to make it easier to use them below
    reuseVertexPositions = new int[trianglecount * 3];
    reverseReuseVertexPositions = new List<int>[positions.Count / 3];
    for (int i = 0; i < reverseReuseVertexPositions.Length; i++)
        reverseReuseVertexPositions[i] = new List<int>();

    // We have to use int indices here because we often have models
    // with more than 64k triangles (even if that gets optimized later).
    for (int i = 0; i < trianglecount * 3; i++)
    {
        // [...] vertex construction

        // Remember pos for optimizing the vertices later more easily.
        reuseVertexPositions[i] = pos / 3;
        reverseReuseVertexPositions[pos / 3].Add(i);
    } // for (ushort)

And then finally the fast vesion of OptimizeVertexBuffer, which uses that data:

    #region OptimizeVertexBuffer
    /// <summary>
    /// Optimize vertex buffer. Note: The vertices list array will be changed
    /// and shorted quite a lot here. We are also going to create the indices
    /// for the index buffer here (we don't have them yet, they are just
    /// sequential from the loading process above).
    ///
    /// Note: This method is highly optimized for speed, it performs
    /// hundred of times faster than OptimizeVertexBufferSlow, see below!
    /// </summary>
    /// <returns>ushort array for the optimized indices</returns>
    private ushort[] OptimizeVertexBuffer()
    {
        List<SkinnedTangentVertex> newVertices =
            new List<SkinnedTangentVertex>();
        List<ushort> newIndices = new List<ushort>();

        // Helper to only search already added newVertices and for checking the
        // old position indices by transforming them into newVertices indices.
        List<int> newVerticesPositions = new List<int>();

        // Go over all vertices (indices are currently 1:1 with the vertices)
        for (int num = 0; num < vertices.Count; num++)
        {
            // Get current vertex
            SkinnedTangentVertex currentVertex = vertices[num];
            bool reusedExistingVertex = false;

            // Find out which position index was used, then we can compare
            // all other vertices that share this position. They will not
            // all be equal, but some of them can be merged.
            int sharedPos = reuseVertexPositions[num];
            foreach (int otherVertexIndex in reverseReuseVertexPositions[sharedPos])
            {
                // Only check the indices that have already been added!
                if (otherVertexIndex != num &&
                    // Make sure we already are that far in our new index list
                    otherVertexIndex < newIndices.Count &&
                    // And make sure this index has been added to newVertices yet!
                    newIndices[otherVertexIndex] < newVertices.Count &&
                    // Then finally compare vertices (this call is slow, but thanks to
                    // all the other optimizations we don't have to call it that often)
                    SkinnedTangentVertex.NearlyEquals(
                    currentVertex, newVertices[newIndices[otherVertexIndex]]))
                {
                    // Reuse the existing vertex, don't add it again, just
                    // add another index for it!
                    newIndices.Add((ushort)newIndices[otherVertexIndex]);
                    reusedExistingVertex = true;
                    break;
                } // if (TangentVertex.NearlyEquals)
            } // foreach (otherVertexIndex)

            if (reusedExistingVertex == false)
            {
                // Add the currentVertex and set it as the current index
                newIndices.Add((ushort)newVertices.Count);
                newVertices.Add(currentVertex);
            } // if (reusedExistingVertex)
        } // for (num)

        // Finally flip order of all triangles to allow us rendering
        // with CullCounterClockwiseFace (default for XNA) because all the data
        // is in CullClockwiseFace format right now!
        for (int num = 0; num < newIndices.Count / 3; num++)
        {
            ushort swap = newIndices[num * 3 + 1];
            newIndices[num * 3 + 1] = newIndices[num * 3 + 2];
            newIndices[num * 3 + 2] = swap;
        } // for

        // Reassign the vertices, we might have deleted some duplicates!
        vertices = newVertices;

        // And return index list for the caller
        return newIndices.ToArray();
    } // OptimizeVertexBuffer()
    #endregion

With this optimization loading is now pretty fast and rendering performs also nicely thanks to the quick shaders we will discuss below. When running ANTS Profiler over the new project the slowest line of code becomes the actual text parsing, actually the conversion of the long strings for all vertices data into the actual vertices float data, especially the positions array. But we can't do anything about that without loading the data binary and not parsing them ourselfs. It takes maybe half a second for a 50k vertices model to load, not great, but ok for our little test app.

Adjusting the shaders for skinned meshes

Now we got a bunch of vertices we can render, but as you know we need a shader to do anything in XNA, there is no fixed function pipeline. There are also no animation helper classes like in DirectX, but they won't help you anyway if you want to render with shaders. Transforming the vertices on the CPU may sometimes be a choice if you do not have many vertices and not many skinned models overall or if they all have to be updated the same way. But generally it is a much better idea to transform all the vertices on the GPU, which costs a little bit more instructions in the vertex shader, but the rest of the rendering stays the same. Most graphic apps are pixel shader bound anyway and I use fairly complex pixel shaders too. Additionally on Shader Model 4.0 cards like the GeForce 8800 with up to 128 parallel unified shader units you can do very complex vertex shaders and use simpler pixel shaders and it will just use more units for the vertex shaders automatically :)

We already have defined the bones matrix array for skinning above and we limited it to 80 bones per mesh, which is quite a lot. Even if you would spend 3 bones per finger and 20-30 bones for the body you would still have plenty of bones left for complex animations. Sure modelers will now say "thats not enough sometimes" ... well, you can always split up the mesh into several meshes with up to 80 bones each if you really need more. My graphic artists are happy with 80 bones ^^

If we want full Shader Model 2.0 support we can only be sure that we got at least 256 shader constants. NVidia has usually more (1024), but you still want your game to run on ATI cards too, especially older ones. Each constant can hold a float4 and we need 4 constants for each 4x4 matrix. This means we can only have up to 64 matrices with this limit and we still need some constants for the world, view, and projection matrices, the light and material values and anything else we want to do in our shader. You should reserve 10-20 constants for that and now we are down to less than 60 matrices, which might sometimes be too little.

Instead of splitting the mesh or providing a different code path in case the GPU can do more constants (I couldn't get that do work in XNA for some reason, not sure if there is some limit or if I made a mistake, my GPU should be able to do at least 1024 constants, and even 2048 for the 8800), there is a trick to save only a 3x4 matrix. The last colum is always 0, 0, 0, 1 if we have correctly applied the invBoneMatrix and the animation matrix (see GetBoneMatrices in ColladaModel for details and the order of the matrices). But saving 4 float3 values still needs 4 shader constants per matrix so we have to save it as 4x3 matrices instead.

My first idea was to grab the .w values and reconstruct the translation part of the matrix this way. This worked, but the resulting shader had 80 instructions (from abount 20 without skinning), which is not good for the resulting performance when rendering many skinned 3D models.

float4x4 RebuildSkinMatrix(float index)
{
    return float4x4(
        float4(skinnedMatricesVS20[index*3+0].xyz, 0),
        float4(skinnedMatricesVS20[index*3+1].xyz, 0),
        float4(skinnedMatricesVS20[index*3+2].xyz, 0),
        float4(
            skinnedMatricesVS20[index*3+0].w,
            skinnedMatricesVS20[index*3+1].w,
            skinnedMatricesVS20[index*3+2].w, 1));
} // RebuildSkinMatrix(.)

A better idea is to use the 4x3 matrix as a 3x4 matrix by just reversing the order we call mul. This involves some changes to the vertex shader code and looks a little bit confusing sometimes, but if you make sure you transform the world matrix the same way and use it in this reversed mul order too, everything works just fine. Another thing that can be optimized is to pre-multiply the indices of blendIndices for each vertex at the loading time. These indices never change and they don't really care if they are 0, 1, 2 or 0, 3, 6, etc. We save one instruction per matrix we are going to reconstruct (the rest is optimized out by the compiler). This is the much easier version of RebuildSkinMatrix, for more details take a look at the SkinnedNormalMapping.fx file:

// Note: This returns a transposed matrix, use it in reversed order.
// First tests used a 3x3 matrix +3 w values for the transpose values, but
// reconstructing this in the shader costs 20+ extra instructions and after
// some testing I found out this is finally the best way to use 4x3 matrices
// for skinning :)
float4x4 RebuildSkinMatrix(float index)
{
    return float4x4(
        skinnedMatricesVS20[index+0],
        skinnedMatricesVS20[index+1],
        skinnedMatricesVS20[index+2],
        float4(0, 0, 0, 1));
} // RebuildSkinMatrix(.)

This results in a vertex shader that has almost half as many instructions as before and their fore is twice as fast :) Good work. Performance tests showed that I could increase the framerate from 220 fps to 270 fps just by doing that (test scene with 9 goblins). The following code is actually more or less the only part you have to replace in an existing shader if you want to make it skinnable (plus providing the helper method and the skinned matrices too of course).

    // First transform position with bones that affect this vertex
    // Use the 3 indices and blend weights we have precalculated.
    float4x4 skinMatrix =
        RebuildSkinMatrix(In.blendIndices.x) * In.blendWeights.x +
        RebuildSkinMatrix(In.blendIndices.y) * In.blendWeights.y +
        RebuildSkinMatrix(In.blendIndices.z) * In.blendWeights.z;
    
    // Calculate local world matrix with help of the skinning matrix
    float4x4 localWorld = mul(world, skinMatrix);
    
    // Now calculate final screen position with world and viewProj matrices.
    float4 worldPos = mul(localWorld, float4(In.pos, 1));
    Out.pos = mul(worldPos, viewProj);

 

Post screen shaders for the final result

All the skinning code and bone transformations are nice once you get them done, but without a cool model and some post screen shaders to make the scene look more cool, it is only half the fun. Good think I got the Goblin 3D Model, thanks to Christoph (WAII) again. I also had a couple of other test models and another more complex 3D Model (big evil monster ^^) which was good for some stress testing, but the material just did not look that cool.

As you can see on the following image 6 render targets are used to accomplish the final image. Most shader passes do several things at once and the list of operations (see right side of the image) is longer than the list of used passes. Most of this was just trying to get the best looking values together quickly. If you are an experienced artist you can probably do much better than me, I'm just playing around with the shader parameters until I get bored and then I leave it the way it is. The sceneMap (render target nummero three) shows the unmodified scene without applying the post screen shaders. It does not look half as cool as the final result.

I hope you enjoyed this article and that you are not as tired as I am writing this all at once (uff). It was a fun project, I have already another one in mind for next week Take care. If you have problems, post a comment. Please note that not all collada models will work, you have to follow the rules of ColladaModel or improve the class a bit for other use

 

References and Links

• SkinningWithColladaModelsInXnaSourceCode.zip (2.6 MB) from this article
• SkinningWithColladaModelsInXnaExecuteable.zip (2.5 MB) from this article
• XNA Animation Component Library
• Panda Exporter for 3dsMax
• kiloWatt X file Exporter for 3dsMax
• Official Collada site from the Khronos Group
• Feeling Software Collada Plugins for 3dsMax and Maya, best exporters ever!
• Public Forum of Collada.org
• Wikipedia on Collada
• Collada Forum post about remi's Collada for XNA project
• COLLADA 1.4.1 Specification (PDF)

 

 

I developed a little Shoot'n'up game in the last couple of days. It is actually quite fun to play. It is just one level and is kind of a prototype. The game will be released together with my XNA Professional Game Development book in a few months (it will be freely available from my website shortly after that). My book features many other games too, it is not just about one game, there are many arcade, action and other games in the book (about 8 games or so) and they will be described as I explain all the important aspects of Game Programming and the XNA Framework.

For now I can only give you a little video about XNA Shooter. I hope you like it.

A "little" 1920x1200 screenshot:

These days there are a lot of discussions about XNA, especially in the GameDev.net boards and of course in the official XNA forum by Microsoft.
http://www.gamedev.net/community/forums/topic.asp?topic_id=430119
http://forums.microsoft.com/msdn/showforum.aspx?forumid=846

I also want to mention a great article by the .NET Compact Framework team about the .NET performance on the Xbox 360 with the XNA Framework. The main issue here is the Garbage Collector, which is not generational and theirfore can only collect all the objects in the GC at once and not in 3 levels like in the normal .NET Framework, which can handle a lot more dead objects and more complicated situations.

Here are the links to the .NET Compact Framework on XNA article:
http://blogs.msdn.com/netcfteam/archive/2006/12/22/
managed-code-performance-on-xbox-360-for-the-xna-framework-1-0.aspx
http://blogs.msdn.com/netcfteam/archive/2006/12/22/
managed-code-performance-on-xbox-360-for-xna-part-2-gc-and-tools.aspx

From my experience there are a couple of things you have to remember when developing XNA games on the Xbox 360. All of these issue are not a big deal on the PC, but they can cost some extra time until you get them right. One of the main problems is that if you develop your game on the PC only and then test it on the Xbox 360 only at the end a lot of things may go wrong (bad performance on the .NET Compact Framework, UI elements at the border of the screen, which are just not visible on some TVs, bad Xbox 360 controller support, which is the main input device for Xbox 360s, etc.).

• Test test test. This is the most important tip. Write unit tests and constantly test them on your PC AND your Xbox 360. I keep 2 projects open at the same time (both of them use the same files, but I only develop the PC solution and use the Xbox 360 solution for deploying and testing only). Almost all of my classes have unit tests and I constantly test them until they are completed.
• Don't use foreach loops, especially not in tight render loops. This may sound a little crazy since it does not matter on a PC game and todays CPUs are fast enough to handle the creation and deletion of many thousand objects each frame, which most games don't even need. But on the compact framework you will spam the memory even with things like foreach loops because a new enumerator instance is created everytime you start a foreach loop. After a while there will be a lot of dead objects, which have to be collected. This can take some time and slow your game down immensely. The PC version might run at over 200 frames, but your Xbox 360 version is stuck at something like 30-40 frames. Avoiding creation of new data each frame and avoiding foreach loops (just replace them with normal for loops, it is mostly just 1 line of extra code) can improve your performance by a factor of 100% or more.
• In Arena Wars I never created any data during the game. All objects were created at the beginning of each mission and they were reused (which was no big deal since the game principle did not allow an infinite number of units, it always stayed around the same because you get your money back from dead units to build new units). In later project I did not care so much about creating new objects and I coded just the easy way because unit tests drive you into a direction to quickly develop solutions, which work and are tested, but may not be the best in other situations like for the Xbox 360 .NET Compact Framework. That is ok because we can now use the unit tests to check if other solutions work just they way we expect them to work. For XNA Shooter and XNA Racer (and a couple of other new game projects) I now make sure that most of the game data is created at the beginning of each level and not dynamically during the game.
• Save-Regions on TVs can be a pain in the ass. Just google for Xbox 360 screenshots and you will notice that the GUI (graphical user interface) looks a lot different from most PC games. PC games have often UI at the screen border showing you tips, little buttons and other not so important things. If you do that in your Xbox 360 game all of these UI elements may be cut of on a regular TV. For the XNA Shooter I had to rework all the UI elements because they just did not fit on a TV screen and it was not practical to put them in a bar (like the windows task bar) because it looks so different on the PC and certain TV monitors. Instead I put all UI elements in floating bars, which will be adjusted depending on the screen the user is looking at.
  These are some of the Save-Regions I have encountered:
  
  • PC: 100% visible
  • Xbox 360 connected through a VGA cable: 100% (or close to 100%) visible.
  • Xbox 360 connected to an old style monitor with SCART: around 92% visible.
  • Xbox 360 connected through Component cables to my new Dell 24" Monitor (yeah HDTV): around 93-95% visible (depends on the resolution).
  • Some old TV sets (according to the XNA docs and tips on the web) have a save region of 80-90%, but I never saw the 80% case, that is probably the worst case scenario.
  The important thing is to keep the important UI element in this inner 90% (or 93% if you want to be close to the edges) rectangle. This means instead of using a full 1920x1080 pixel resolution you only use 90% of it (1728x945). Or just start rendering UI elements at about 5% of the screen (x coordinate: 96, y coordinate: 54). This pixel locations obviously depend on the screen resolution, just calculate them in your main class and use them whenever you render UI.
• There are probably a lot more tips I can give, but I'm to lazy right now. Maybe more in a little while :)

Btw: I currently also do a lot of OpenGL development again and I have to say I have totally forgotten about the way you can program OpenGL. It is often a lot easier, it only gets hard if something does not work the way you expect it to be (but thats hard in DirectX too). Well, the most annoying part is of course that you have to wrap all OpenGL methods through PInvoke and that just costs time. On the other hand if you already have a robust framework (like I have with Arena Wars, hehe), it is relatively easy to plug in new features. It also took not long to learn the differences between glsl and hlsl. I do currently also test out the FX Composer 2.0 (alpha), which has a great idea behind it, but it is too much like Render Monkey and that is never a good thing. Render Monkey by ATI is just overcomplicated and hard to use (and was not updated for 2 years, which shows that no one even uses it anymore). The great thing about FX Composer 1 was the fact it was so easy to use and it did only support a very limited feature set. It is not the best tool ever, but it was certainly a lot easier to use than FX Composer 2.0, which will hopefully be improved before NVidia release it.
I have confidence that NVidia will deliver a great tool as always, but they have lost a lot of fans in the last months because of the lack of drivers for Vista, especially for the Geforce 8800, which does not work at all in Vista, but it is the only card on the market that even supports Direct3D 10 (and the new cool unified shader technology in DirectX). The only way you can currently use the new graphic card features is to program them yourself natively with OpenGL ... but my 8800 is in repair anyway, else I would have tried out some of the new features by now.

ArenaWars Reloaded - Coming Soon

Hey now!

Before you read on (I guess this is going to be a long post) please also check out www.exDream.com. We made some pictures from our new office and we recently announced ArenaWars Reloaded (see image on the right), a new game with a new graphic engine and many new cool features based on the original Arena Wars idea (the game play and levels will be similar, but look much better).

My little Christmas present for you is the new port of Rocket Commander to the XNA Framework. It allows you to play the popular Rocket Commander (113 000 played games already can't be wrong) on your Xbox 360 for the first time. You just need an Xbox 360 and have XNA on there. Here are the downloads, the file sizes are are little bit bigger than the original game (my comments are below):

• Rocket Commander XNA on Windows (16 MB): Includes Setup, that will automatically install DirectX Dec 2006 and the XNA Framework if you don't have it yet!
• Rocket Commander XNA on the Xbox 360 cannot be redistributed. You currently have to download the source code and run it in XNA Game Studio Express to even get it on your Xbox. Once you have Rocket Commander XNA deployed with help of the XNA Launcher you can start it anytime you want to without having your PC on or having to redeploy it.
• Full Rocket Commander XNA source code (53 MB): All Content, Sound and Music files are included in this download, this is all you need to compile and run the game on Windows and Xbox 360. The music files are almost 50MB (5MB as mp3, which is not supported in XNA).
• Rocket Commander XNA source code only (213 KB). No content files (models, textures, sounds, etc.) in here, just the .cs, .csproj, .sln and .fx files.

Update: 2007-01-03: Fixed some Bugs with the Input, PostScreenGlow and when device loses focus. Works now more stable. Also cleaned up some of the source code.

Note: Use RocketCommanderXna.sln to compile and run the game on Windows and RocketCommanderXnaXbox360.sln to compile and deploy it to your Xbox 360. For additional details please read the XNA documentation.

The game runs at a very good performance on the Xbox 360, you still got over 60 fps in HDTV 1920x1050 (1080p) with full AA enabled.

Check out some of the new screenshots. Warning, all of them are big, HDTV 1080p resolution. Actually I could not capture any images from the Xbox 360 directly, which runs at 60fps on 1920x1050 and uses fullscreen Antialiasing and using the highest settings. These screenshots are from my PC hooked up to my new 1920x1200 monitor, also nice :)

The main menu. Not much happend here.

The ingame HUD and general user experience has changed a bit. There is also a new object for the goal since creating a sphere dynamically is not that easy in XNA.

Rocket Commander is still fast and it pumps up your adrenaline even more in combination with a big monitor :)

Another screenshot from the last level. Please note that you can see more asteroids at the same time than in the original game. You can also look a lot farther and see more items from great distances.

The explosion is unchanged. It still looks the same crappy way, but the AnimationTexture class had to be reimplemented to work with XNA textures now.

Initially I thought "Hey, this is easy, let's port Rocket Commander to XNA.". The initial port attempt was pretty good, it took only 3-4 days to port the 25 000+ lines of code used in Rocket Commander. I could remove some classes and I also simplified some classes, the total number of lines got smaller (~20 000 lines), but after adding some new features and some new unit tests and some testing code for multithreading it is about 22 000 lines of code, still less than the original. XNA is definately the future, MDX was great, but it was not updated for a long time and if you start something new, go with the fresh XNA Framework!

Here are some of my experiences from the process of writing Rocket Commander XNA. Please note that some of these comments were written while I was developing and kinda sleep deprived. Beware of the harsh tone, in the end all worked out great :)
++ means this topic was great and better than MDX.
+ means it was good and nice to work with.
- means I did not like that feature or it was easier in MDX.
-- means this was really annoying and should be improved in the future.

By the way: I did Rocket Commander XNA just for fun, but it also proves how great XNA performs on the Xbox 360. Try to find any other game with this many polygons and effects running in 1080p (1920x1080) with AA enabled on the Xbox 360 ^^ It does not look as good as Gears of War or Halo 3, but it took only 1 man and a short time to develop and it still pushes up to 80-100mio polys each second to the GPU (in some early unit tests, the game runs fine with 20-30 mio polys per second most of the time, check out the model class and its unit tests for more details).

I also use the Rocket Commander XNA engine for 2 other smaller projects because I like the fact that I can test and play these games on the Xbox 360 too and having a complete engine up and running is always a great plus, even if you know how to do a game. It is just easier if you got all the basics covered.

Topic	Rating	Comments
Sound	++	Very easy to use, 1 short class instead of 2 complex ones I had in MDX. Once you get used to XAct you learn that it is a good tool for sound effects, at least if they don't have to be loaded dynamically. The porting process was very simple for sound effect files, they just had to be dragged to XACT and then the project had to be saved, that's it.
Music	--	A lot of converting, different formats, hard to handle, a lot to test, bad documentation. The music from RC was below 5 MB, now it is over 50 MB, which just blows up the source code. Even the compressed take up 13 MB on the PC (ADPCM) and 9 MB on the Xbox 360 (XMA), both in a quality below the original. The rest of the game content (5MB compressed textures, models, effects, sound, etc.) stayed almost the same and could be reused for the most parts.
Unit Testing	-	Harder to use on the Xbox 360, no edit and continue support in the compact .NET framework. There are also no unit testing tools available and all you can do is to call static unit tests from the program class, which is still useful, but harder to do. I still prefer to test on windows. One great thing about the Xbox 360 is the fact that you get multimonitor debugging for free if you have a TV screen and your PC screen. Debug and step through code on your PC and see the result on the TV screen :)
Window handling	++	No extra code required, I could remove several classes and even the helper classes that are still in Rocket Commander Xna are not required for the most parts. Except for some of the game component classes and the design that is not really useful (more about that below) the Game class is really easy to use and simplifies the process to create a new game in a few minutes.
Shaders	++	Everything in XNA is shader based. The original Rocket Commander runs on fixed pipeline only hardware too, but it was a lot of work to handle 2 ways to render everything. With XNA you just have to write the shaders once and just use them. They work perfectly on the PC (Shader Model 1.1 up to 3.0) and on the Xbox 360, all fx files compiled without any problems. Some shaders had to be adjusted to be right-handed now instead of left-handed like in MDX, but that did just take a few minutes to change and all the rest of the shader code could be reused. In the last few months of XNA development I never had once a problem with shaders in XNA, thats really great :)
IDE Features	-	MDX is much older and was never made popular by Microsoft. XNA is new, fresh and great, but it is missing some serious features like Animations for Models. You can implement it yourself, but why even bother with the content pipeline, do it all yourself. It will be much easier and you can extend it in any way you need in the future. XNA development is currently also only avialable with XNA Game Studio Express, which is painful if you are a pure Visual Studio 2005 Professional developer and have lots of plugins you rely on every day (source code management, code rush, testdriven, slickedit, explorer, and many more). This will change in the future and XNA will grow up and dominate the whole world one day :)
Content	--	Sorry, I just don't like the content pipeline (and I have been using it for several months now)! It is bad for dynamically loading textures or shaders or reloadindg them after changes (just not possible with compile-time generated content). On the windows platform you can still load textures and shaders the normal way, which is good, but loading .x file models is just not possible, you have to use the content pipeline. And the content pipeline sucks feature-wise, you have to implement all of stuff yourself. This is my main problem, why should I re-implement generating tangents, shader technique indices, fixing other x file problems, etc. all by myself in a custom content processor, which is not easy to write IMO (bad docu again). By the time I did all that I would have implemented a much more flexible and vesatile custom importer like from .collada files, which are very popular these days ...
Performance	+	The overall performance especially when just doing some benchmarks and performance tests is absolutely perfect on both Windows and the Xbox 360. The GPU is pushed to its limits and there is no reason why you should be afraid of managed code. Windows performance is especially great, all my programs and games are completely GPU bound even in low resolutions and even when they only have one thread. On the Xbox 360 the performance is much worse and you have to take many things into consideration, which is hard because there is again not much documentation around. For example the worst thing you can do on the Xbox 360 is to generate new data each frame, even if you just create an enumerator by executing a foreach loop, it will affect your performance. The good thing is that you have 3 cores (and 6 hardware threads) at your fingertips, which allow you to optimize performance. It was possible for the Rocket Commander game to optimize the game loop a lot because the physics and update threads eat up almost 50% of the CPU time. On the PC it does not matter much because my GPU is slowing everything down (see image below), but on the Xbox 360 I was able to almost double the framerate using multiple threads, nice :) Click Image for to maximize it.
Usability	-	It gets a little easier though all the game helper classes, but the game component class is pretty useless, you can implement something like that in 5 minutes yourself. There is also a DrawableGameComponent class, but you have to call Draw yourself, whats the point here? My classes have some Draw or Render method anyway, I don't need to derive them from GameComponent, I can implement my own interfaces and implement exactly the features I need. Often it is easier to give the Render method a few parameters or even call it several times with different parameters, all that is not possible with DrawableGameComponent. Next there is the content pipeline, which is just a pain in the ass for 3d models. This makes the usability very bad, especially if you develop on Visual Studio 2005 (not Express), which does not support the content pipeline. Also if you are a Vista-Developer XNA Game Studio Express will also not run as expected and my intern hates now both Vista and XNA. It should not happen that someone can get so angry about such great pieces of software, just because they don't work together ^^
Porting	+	If you have written a XNA game or have some XNA code flying around (like the Rocket Commander XNA source code) it is very easy to port existing MDX code to XNA. If you do it from the scratch it is a lot more work and testing until everything works out the way you expect it, but overall it is easy to port from MDX to XNA. Thats very cool, thank the main MDX man Tom Miller for that, who architected parts of XNA too. Porting is easy, but getting the game to work the way you want on the Xbox 360 is not that easy. First of all you got that annoying content pipeline again (I keep repeating myself, maybe I'm too angry ^^), then you have to make sure that you don't render important User Interface on the none-visible area of a monitor that is plugged into a Xbox 360. For example Rocket Commander was only designed for 1 resolution to look good, it had a very small font for some texts on the screen, which is unreadable on TV monitors. Rocket Commander did also not scale well on Widescreen monitors and it rendered a lot of UI elements at the screen borders, which were cut off on TV monitors. The porting took maybe 3-4 days, but I spend at least 4 more days for fixing UI elments and improving the code on the Xbox 360, optimizing asteroid rendering, physics and multithreading. I did not expect that it would take that long and I had only some time in the evenings to even get some XNA work done.
Most annoying		Porting left-handed models, matrices and other complicated math functions over to the right handed system that XNA uses. Maybe it would be easier to use left handed matrices like in the original Rocket Commander for XNA too, but XNA does not provide them and I did think getting it to work with a right handed system would be easier. Then there is of course the problem getting the models into the content pipeline. I used a special content processor, which is also included in the Rocket Commander source code and it can be used for other projects too (I use it for everything I do with XNA). Another annoying thing is the re-deploying of existing game content to the Xbox 360. If you just have 5 files it will not matter to you, but if you got over 50 (Rocket Commander) or even several hundert content files and sometimes due some crazy bug all these files get re-compiled or re-deployed over and over again, it gets really annoying. It takes 30-60 seconds and is not fun ... good think it does not happen that often, but it is still annoying me. Maybe the main reason for regenerating the content on my PC is the fact that I often switch between the Xbox 360 and Windows platforms to test if everything is working the same way on both systems.
Missing features		The XNA version does have all the features from the original Rocket Commander game, including all levels, sub menus and the whole game play. It does not have animated models however because it is not supported out of the box in XNA and I did not have time to reimplement this feature. It does also not support polygon based collision checking for asteroids, which can sometimes be annoying if you fly near asteroids or if you want to fly through the donut asteroid. The problem here is that the mesh intersection methods are missing, all you can do is render models, not much else. Last but not least XNA does not support any network code. On the windows platform it would be possible to still use the Webservice to upload and get highscores, but for compatibility with the Xbox 360 the code is currently commented out. If you want to play with online highscores, just play the original Rocket Commander game. There are also some smaller issues like getting the bitmap data of a texture on the Xbox 360. There is method called GetData in the texture class, but it is not supported on the Xbox 360. There is also no bitmap class in XNA because you would need the System.Windows.Forms namespace, which is not included in the .NET compact framework. I ended up saving the level data into a custom file (.level) and then loading it again with help of standard IO methods (byte by byte, but the loading process is still fast, less than 1 second for all textures, levels, models and sounds). The Rocket Commander Mods are also not supported yet, but porting them should be easy with the existing Rocket Commander XNA source code.
Improvements		The controls, especially for the Xbox 360 Controller have been improved. It is now much easier to fly the rocket, the speed was increased and you can look at up to 4 times as much asteroids thanks to several optimizations and the great performance gain of using multiple threads on the Xbox 360. There are also many smaller improvements to the UI, the structure and some classes in the game, but the game looks still very similar (see screenshots above).

Maybe I will write a little more next week. I should get some sleep now, in a few hours it is christmas time and I have not packed any presents yet.

Now have fun with Rocket Commander XNA and have a nice christmas of course

PS: I know my blog has currently some problems (posting and comments do not work as they should), I will fix that in a week or two, have currently not much time to investigate this issue.

Yesterday was the german developer price 2006 event (Deutscher Entwicklerpreis 2006) in Essen (Germany).

The Lichtburg (light castle) in Essen.

Miriam Pielhau (known from german TV, well at least if you watch german TV, I don't) moderated the event together with the usual hosts (Aruba, politicians, other guys from the german game developer scene).

Martin Kesici (Sat1, Superstars star or something, never saw him before either) did make some music in a short break. Was neither great nor bad.

After about 10 prices were given to the developers almost 2 hours have passed and the rest of the 30 prices had to be given out. In a IMO unprofessional manner everyone just had to come on the stage and get his price. In a matter of minutes the rest of the prices were given out.

Then everyone left to the after-show party with more food, drinks and some games.

And Pong (actually it is called Plong) on the Xbox 360. It really shows how to use the GPU correctly and have all 3 cores at full CPU load. The game looks actually a lot worse, my bad camera just made it more beautiful because I always have a blur, glow and motion blur effect on all my pics :)

Some angle girls dancing around. Reminded me of the song: Rammstein - Engel

And finally a little in-house fireworks show at the end. Always fun to watch.

All in all it was a nice and enjoyful event and it was nice to meet all the usual faces again. If you want more photos check out: www.deutscher-entwicklerpreis.de

Microsoft released their XNA Framework 1.0 and XNA Game Studio Express today, which allow you to build games for Windows and the Xbox 360. To compile and play your XNA games on the Xbox 360 you will need to join the "XNA Creators Club" (for $49 per 4 months or $99 anually). There you will have access to additional starter kits, features, etc.

I ported the Rocket Commander game to XNA, just for fun .. and it runs great. It is optimized to run on all 3 cores of the Xbox 360 and I will finetune it a bit in the next few days to run perfectly on the XNA 1.0 release. The performance is really good, the current build has over 800 fps in PAL on the Xbox 360, in very high resolutions (have only 1600x1200 monitor, but I will test it on 1920x1080 too later this week) it still runs good with more than enough frames.

Here is a little preview picture, it shows about 8 times more asteroids and runs at over 200 fps here. I will try to post some of the porting problems in the next few days, for example all the network and internet code had to be ripped out from the Xbox 360 build and the sound features are a little stripped down in XNA (no 3d listener support, not easy or not even possible to do any stereo or surround sound, looks like playback is all mono :-( ).

Early alpha screenshot of Rocket Commander XNA:

As I reported few days ago a nice guy named Marc Guevremont made a pretty amazing Mod for the Rocket Commander Game called Canyon Commander.

You can download the game (just 2.8 MB) and source code on
www.RocketCommander.com

I also made a little video of the game play, which is similar to Rocket Commander very fast and action packed :)

Text from www.RocketCommander.com:

Canyon Commander

This Mod was created by Marc Guevremont and it really shows how extensible the Rocket Commander engine is.
New features include a completely new Landscape rendering algorithm and a very clever way to build canyon levels.
The mod also contains language files for german, english and french text support for the first time.

The gameplay is basically the same as Rocket Commander, just collect all the items and fly to the end of the levels.
Because the game looks so much different, you will play it very different from Rocket Commander.
Instead of avoiding asteroids you have to fly through canyons and avoid flying into a canyon wall.
This may sound easy, but it is a lot harder than just avoiding some asteroids because you can't see very far.

About the source code for this game: You can probably see quite easily that all the namespaces are still intact
and that most of the engine is unchanged, but if you take a look into the game namespace you will see a lot of new
classes. For the terrain rendering Marc implemented his own classes and he used the basic dependencies from
Rocket Commander to solve all the base rendering, physics and collision testing and finally the game management.

Good job Marc, thanks for the effort. Everyone else: Have fun!

Version 1.0 (16 November 2006) - 2.8 MB (requires Rocket Commander to be installed first) www.RocketCommander.com Server: Canyon Commander V1.0 Installer (2.8 MB) Source code to Canyon Commander V1.0 (259 kB).

Screenshots:


Canyon Commander main menu


Canyon Commander first level


Canyon Commander spiky canyon


Canyon Commander avoid the mines

Someone recorded XNA Racer, which was shown at some Tokio Gameshow named "kotaku".

Here is the original link. Some harsh tone in those comments, no you don't have to pay 99 dollars to play this game, it will be completly free. And about the "boring" gameplay, hey it was not done, this was just an alpha preview and the game looks much better now and is getting better physics and levels as we speak. Well, at least some are comparing it to AAA titles, thats always nice (and totally crazy, you wouldn't compare a house build by 1 guy to a scyscrapper).

Thanks for posting about it to ZMan and Ultrahead.

I guess I have to release a video of the game myself, these leaked videos look not very pretty and showing off an early alpha version has its disadvantages (almost 90% of the ingame objects are missing, the video shows the second track, which is not done yet, completely dummy and it was an early alpha version, the game runs now about 3 times faster).

As some of you (like ZMan) already found out, there is also an XNA book coming out written by me. I just started a few weeks back writing it (but it will be complete by the end of the year). Funny you can already order it on amazon. I will write more about it when its done. You will not only learn about game programming and XNA, but there will be plenty of practical examples in the book. In every of the 14 chapters a new game is introduced and you go though the process of writing a game from start to finish.

One final note: Canyon Commander is a lot of fun, it is a new mod, which will come out in the next days.


Btw: The Coding4Fun site was redesigned in the last weeks and most of the old links do not work anymore (which is something MSDN usually never does). But now most of the content is back and can be found in the new categories (Rocket Commander is under Games -> Arcade). I also updated the link on www.RocketCommander.com and the link for the video tutorials is:
http://msdn.microsoft.com/coding4fun/gaming/arcade/article.aspx?articleid=997852

Update: The old link works now too, I guess the MSDN relinking system is working as expected now :)

This was my first day working at Microsoft. Pretty interesting people work there and a lot of them. Good thing no one noticed that I'm not able to remember 500 names per second. I was installing stuff half of the day, but I found out more about XNA and already fixed some issues. Before talking more about my day, here are some News:

The XNA Team did a little 2 minute video of a couple of XNA games, my starter kit XNA Racer (which I hadn't talked about yet in detail, but that will come soon) can be seen at the end of the video. I got a lot of nice comments about that already :)

Here is the link to the video (Major Nelson has a nice blog btw):
http://www.majornelson.com/archive/2006/11/08/zune-video-xna-video-montage.aspx
And this is David Weller talking about it:
http://letskilldave.com/archive/2006/11/08/XNA-Video-Montage-_2300_1-is-ready-for-you_2100_.aspx

A nice guy from France with the name "Marc Guevremont" made yet another Rocket Commander Mod and this one just looks impressive. He managed to implement a landscape engine with shadow mapping (I guess precalculated). It looks very much like Rebel Assault. The game itself is still similar to Rocket Commander, but it looks so much different and he also made 3 cool levels. The game is called Canyon Commander and will hopefully be available soon.

More information, screenshots and a video can be found in the Rocket Commander Forums and here: http://www.webs7.com/Canyon/

I did not make many pictures today and it was to dark when we drove back to make any useful pictures with my phone camera.

Driving through Seattle.

And going over the long Evergreen Point Floating Bridge between Seattle and Redmond. It goes over the lake Washington and I couldn't get an answer if a Russian atom u-boot could fit under the bridge.

I was told that Bill Gates has his house somewhere on the right here, but you can't see it, too much leaves.

More pictures tomorrow.

• Download XNA Beta1

• XNA Framework Forum and XNA Game Studio Express Forum

• Getting Started: Open C# Express (which is XNA Game Studio), Help->Content->Select XNA and navigate to Getting Started with XNA and read through Your First XNA Game

• Next you could try out the Space War Starter Kit Game. If you can't control the game read this tutorial from xnaspot.com about changing it to support keyboard input.

• x64 Bit platform support: Read this blog entry for an easy fix. Basically just add <PlatformTarget>x86</PlatformTarget> to your csproj file.
  Or download and extract this file (Xna64BitSupport.zip 14 KB) into:
  C:\Program Files (x86)\Microsoft Visual Studio 8\Common7\IDE\VCSExpress\

• Blogs:
  
  • http://blogs.msdn.com/xna/ XNA Team blog to get news from the makers
  • http://xbox360homebrew.com/ XBOX 360 Homebrew, quite good
  • http://thezbuffer.com/ Always a good resource, biggest MDX site ever
  • http://letskilldave.com/ Let's Kill Dave! Davil Weller about XNA. He posts a lot of interessting things.
  • http://blogs.msdn.com/tmiller/ Tom Millers Blog, yeah, this is the MDX father of all things :)
  • http://blogs.msdn.com/mitchw/ Mitch Walker, one of the XNA guys
  • http://blogs.msdn.com/al_msft/ Albert Ho, XNA Redux, another XNA guy
  • http://blogs.msdn.com/mklucher/default.aspx Michael Klucher's XNA Blog, guess what, another XNA guy
  • http://blogs.msdn.com/shawnhar/default.aspx Shawn Hargreaves Blog, Game programming, C#, and the XNA Framework Content Pipeline
  • http://blogs.msdn.com/rickhos/default.aspx Rick Hoskinson's Blog about XNA
  • And there are many more, but who's got the time ^^

• Tutorials:
  
  • http://www.xnadevelopment.com/ XNA Development, Tutorials and Co
  • http://learn-xna.com/default.aspx Learn XNA I guess, not much there yet
  • http://www.xnaspot.com/ XNA Spot, got already a nice tutorial about Getting started with the Space War Starter Kit

• Interessting reads:
  
  • http://msdn.microsoft.com/directx/XNA/default.aspx XNA Info and FAQ
  • http://forums.microsoft.com/msdn/default.aspx?forumgroupid=20&siteid=1 XNA Forums
  • http://makeitbigingames.com/blog/?p=34 XNA Game Studio Express Doubters Get It Wrong
  • http://xbox360homebrew.com/blogs/homebrew360/archive/2006/08/24/75.aspx Hearing some Audio from the Games Convention in Leipzig (scroll to 48:00 minutes). It demonstrates basically a Torque X game with XNA, but its quite interessting.
  • http://forums.microsoft.com/MSDN/ShowPost.aspx?PostID=634578&SiteID=1 Forum post about Xbox 360 Official Dev Kit vs. "the XNA thing"
  • http://forums.microsoft.com/MSDN/ShowPost.aspx?PostID=684005&SiteID=1 Pretty negative post about XNA, he wants to stay with c++ and DX (ever heard of MDX?)
  
  

• And now finally my own thoughts and tips:
  
  
  • How to render fonts like with Direct3D.Font?

    Well, thats not possible, there are not Font classes in XNA at all yet! You have to create your own font code by rendering bitmap fonts. If you want to see some code about that check out the SpaceWar Starter Kit and look inside the Font.cs class. The fonts in SpaceWar just contain numbers, but the game contains some text. How did they do that? Well, they just put most of the text in the game directly onto the textures, buttons, etc.
    Here is also a forum post about this issue and some source code, which might help.

  • How to play sounds?

    Thats quite easy, create sounds with XAct, load them in your game and then use the SoundBank class to play your sounds. Some tutorials can be found in the help and a simple example is in the Sound.cs file in SpaceWar Starter Kit.

  • Okay, where do I add my mp3 for some music playback?

    Could you stop asking this questions? Arg, I'm asking myself this, oh no. But I guess sooner or later this would come up anyway. Well the solution? There is none. No, I'm not kidding. There is no support for mp3, wma or CD playback of music in XNA. On the windows platform you could use some external stuff (DirectShow, MCI, external libraries, etc.), but on the XBox360 you are stuck with XAct, which does just support sound effect files.

    Ok, then just let add the .mp3 as a .wav file there. Yup, thats possible, but consider your game size. If your binaries are maybe 1MB, textures 5-10MB and sounds 2MB you don't want to add 3*50MB for 3 music files. I had quite a long discussion with some music artist about this issue and we agreed that it would be best to do try out some 22kHz mono sounds for the music for a smaller game size. Don't even try to think about any compression, the only format that XAct eats is PCM .Wav files. Sample them down or live with mega-files, your choice ...

  • How to add Controller (Mouse, Keyboard, XBox360 Controller) support?

    Again, this is not hard stuff. If you have worked with XInput before, this will be easy for you. Otherwise just read the XNA Programming Guide->Input pages, which all contain easy to work with code samples.

  • How to show a mouse cursor?

    You might notice that there is no mouse cursor in the samples, starter kit or any new project you create. The reason for this is that by default the Game.IsMouseVisible is set to false. If you set it to true (e.g. in your game constructor) you will see the mouse cursor again (write: this.IsMouseVisible = true;). Another way would be to display your own custom mouse cursor as a sprite at the current mouse position (see help to get mouse position, it is quit easy).

  • How to capture keyboard text?

    Well, thats not that easy. You can only check the state of each button (mouse, keyboard, whatever), but you can't get the text directly like with the OnKeyPress event in window forms. One way would be to write your own custom text handling, like this:
    
    string chatText = "";
List keysLastFrame = new List();

...

Keys[] keysNow = Keyboard.GetState().GetPressedKeys();
foreach (Keys key in keysNow)
    if (keysLastFrame.Contains(key) == false)
        chatText += key.ToString();
keysLastFrame = new List (keysNow);

    But this has the disadvantage if you run low on frames or the user types very fast you might miss some keys (test this by adding Thread.Sleep(50)), which really sucks. It is also a bit of work to get all the special keys, shift combinations, backspace, etc. working. For windows apps it might be wise to think about capuring the keyboard directly with some dummy form (very easy to get text then with OnKeyPress). Another approach would be to create an extra thread just for handling the keyboard at a high rate to make sure you catch all the keys. More about this solution can be found in this post.

  • What about drawing lines, boxes or other simple 2d stuff?

    Oh no, this is one of the parts that is really annoying and this does require some rethinking because all this kind of rendering was done with help of the fixed function pipeline (hello DirectX 7), which is no longer supported in XNA. It was never easy in DirectX to draw lines or filled boxes, you had to create your own vertex buffer or just draw some primitives and set all kinds of renderstages, but with XNA this gets even more complicated. Better not tell anyone how simple this is in OpenGL (glLine anyone ^^).

    So how can we draw some lines in 3d?

    Again: It is very important to know that you have to do EVERYTHING with shaders! The Sprite classes are just some helpers, but for 3d you need shaders, nothing else will work! I say this that often because many people in the XNA Forum already having problems rendering data and do not understand that if you don't have a shader around your rendering code, nothing will happen! Additionally you have to make sure you pass all the required data to your shader, there is a lot more work involved that just rendering some primitives in DirectX using the fixed function pipeline.

    I will try to keep this as short as possible, but you will see this is quite a lot of code for just rendering a single line. Here we go. We start with the variables we need (add to your Game class):

    Matrix Projection = Matrix.Identity,
View = Matrix.Identity;
Vector3 pos1 = new Vector3(0, 0, 0),
pos2 = new Vector3(100, 100, 100);
VertexPositionColor[] lineVertices =
new VertexPositionColor[2];
lineVertices[0] = new VertexPositionColor(pos1, Color.Red);
lineVertices[1] = new VertexPositionColor(pos2, Color.Yellow);

Effect effect = null;
EffectParameter worldViewProj = null;


    We will use the Projection and View to calculate the worldViewProj matrix for our shader to convert the 3d coordinates to 2d (yep, I told you, we have to do everything ourself). If you want some camera control, always update the View matrix, which again you have to manage yourself (hello XNA team, some help with this basic stuff plz). Ok, lets continue before I explode, here is the initialization code (copy to your Game constructor):

    float aspectRatio = (float)TestGame.Width / (float)TestGame.Height;
Projection = Matrix.CreatePerspectiveFieldOfView(
    (float)Math.PI / 2, aspectRatio, 0.1f, 1000.0f);
View = Matrix.CreateLookAt(
    new Vector3(0, 0, -50), Vector3.Zero, Vector3.Up);

CompiledEffect compiledEffect = Effect.CompileEffectFromFile(
    "Shaders\\LineRendering.fx", null, null, CompilerOptions.None,
    TargetPlatform.Windows);
effect = new Effect(TestGame.Device,
    compiledEffect.GetShaderCode(), CompilerOptions.None, null);

worldViewProj = effect.Parameters["worldViewProj"];


    Ok, what happens here? First of all we calculate our aspect ratio, nothing special. Then we have to calculate our projection and view matrices (please read the DirectX documentation if you have no idea what I'm talking about). Basically we have a field of view of 90 degrees (PI/2), we use our aspect ratio and we have a view range from 0.1 (near) to 1000.0 units (far). Then we create our camera at the position (0, 0, -50) looking at the center of our scene.

    Next we have to load our shader effect file. Yes, I told you about that earlier, we need a freaking shader to draw our simple line. We will get into that in a little bit, but ALWAYS make sure the .fx file is correct (test with FX Composer first). If the .fx file contains compiler errors you get unfunny NullReferenceExceptions, which won't help you (see below). Finally we are getting the worldViewProj parameter. This is the only line of this whole line code I really appreciate. Getting shader parameters is now a lot easier and cleaner, good work here! Also working with shaders is very easy now.

    Time to continue with our code, we need the rendering code (add to Draw()) now:

    // Start line shader
effect.Begin(EffectStateOptions.Default);
effect.Techniques[0].Passes[0].Begin();

// Render line
worldViewProj.SetValue(View * Projection);
TestGame.device.VertexDeclaration = new VertexDeclaration(
TestGame.device, VertexPositionColor.VertexElements);

TestGame.device.DrawUserPrimitives (
PrimitiveType.LineList, 1, lineVertices);

// End shader
effect.Techniques[0].Passes[0].End();
effect.End();


    This code is pretty straight forward. We start our shader and select the first technique (the only one we got). Then we calculate our worldViewProj matrix from the View and Projection matrices we calculated in the constructor. After setting the VertexDeclaration we can draw our primitives, which are lines in our case. Just one to be more specific. Adding more lines is quite easy at this point. Finally we have to close the rendering pass (we just got 1 pass, else we would have to make a foreach loop around this code) and we also close the shader.

    So far so good, but how does the rendering now happen? 100% in the shader, the code we just wrote will do nothing more than calling the shader with the data we set, the line point positions and colors. So lets take a look at the shader, which does all the rendering. The shader itself is quite simple:

    // File: LineRendering.fx, Author: Abi
// Code lines: 52, Size of file: 1,18 KB
// Creation date: 31.08.2006 05:36
// Last modified: 31.08.2006 06:44
// Generated with Commenter by abi.exDream.com
// Note: To test this use FX Composer from NVIDIA!

string description = "Line rendering helper shader for XNA";

// Default variables, supported by the engine
float4x4 worldViewProj : WorldViewProjection;

struct VertexInput
{
    float3 pos : POSITION;
    float4 color : COLOR;
};

struct VertexOutput
{
    float4 pos : POSITION;
    float4 color : COLOR;
};

VertexOutput LineRenderingVS(VertexInput In)
{
    VertexOutput Out;

    // Transform position
    Out.pos = mul(float4(In.pos, 1), worldViewProj);
    Out.color = In.color;

    // And pass everything to the pixel shader
    return Out;
} // LineRenderingVS(VertexInput In)

float4 LineRenderingPS(VertexOutput In) : Color
{
    return In.color;
} // LineRenderingPS(VertexOutput In)

// Techniques
technique LineRendering
{
    pass Pass0
    {
        VertexShader = compile vs_1_1 LineRenderingVS();
        PixelShader = compile ps_1_1 LineRenderingPS();
    } // Pass0
} // LineRendering


    And thats it. As you can see we just take the input position, transform it and then output the color we interpolated through the vertex shader. The pixel shader has just to output the color. Working with other primitive types can be done in a similar way, so I hope this code helps.

    And what about 2d lines?

    2D lines can be done quite similary. In DirectX you would never think about rendering 2D lines with shaders, when it is so much easier with the fixed function pipeline. But this is not possible in XNA, so we have to use shaders again. Lets go quickly through the code that is required:

    Matrix Projection = Matrix.Identity,
View = Matrix.Identity;
Point pos1 = new Point(0, 0),
pos2 = new Point(500, 250);
VertexPositionColor[] lineVertices =
new VertexPositionColor[2];
Effect effect = null;
EffectParameter worldViewProj = null;


    Very similar to what we had above, only our positions are now Points and not Vector3. Also note we don't calculate the lineVertices here because the data is resolution dependant and we have to grab the resolution from the graphics object first. Lets take a look at the initialization code:

    float aspectRatio = (float)TestGame.Width / (float)TestGame.Height;
Projection = Matrix.CreatePerspectiveFieldOfView(
    (float)Math.PI / 2, aspectRatio, 0.1f, 1000.0f);
View = Matrix.CreateLookAt(
    new Vector3(0, 0, -50), Vector3.Zero, Vector3.Up);

lineVertices[0] = new VertexPositionColor(
    new Vector3(
    -1.0f + 2.0f * pos1.X / TestGame.Width,
    -(-1.0f + 2.0f * pos1.Y / TestGame.Height), 0), Color.Red);
lineVertices[1] = new VertexPositionColor(
    new Vector3(
    -1.0f + 2.0f * pos2.X / TestGame.Width,
    -(-1.0f + 2.0f * pos2.Y / TestGame.Height), 0), Color.Green);

CompiledEffect compiledEffect = Effect.CompileEffectFromFile(
    "Shaders\\LineRendering2D.fx", null, null, CompilerOptions.None,
    TargetPlatform.Windows);
effect = new Effect(TestGame.Device,
    compiledEffect.GetShaderCode(), CompilerOptions.None, null);

worldViewProj = effect.Parameters["worldViewProj"];


    This looks slightly more complex. The reason for that is the conversation from pixel coordinates to screen space, which goes from -1 to +1 and has y inverted. We could also do this calculation in the vertex shader, but I like C# more ^^ Please also note that we don't need the z coordinate, but it is way easier to just use the VertexPositionColor struct instead of creating our own struct. Lets continue with the rendering.

    // Start line shader
effect.Begin(EffectStateOptions.Default);
effect.Techniques[0].Passes[0].Begin();

// Render line
worldViewProj.SetValue(View * Projection);
TestGame.device.VertexDeclaration = new VertexDeclaration(
TestGame.device, VertexPositionColor.VertexElements);

TestGame.device.DrawUserPrimitives (
PrimitiveType.LineList, 1, lineVertices);

// End shader
effect.Techniques[0].Passes[0].End();
effect.End();


    Nothing changed here, nothing we have to discuss. Everything works just the same. lets take a look at the shader!

    // File: LineRendering2D.fx, Author: Abi
// Code lines: 52, Size of file: 1,18 KB
// Creation date: 31.08.2006 05:36
// Last modified: 31.08.2006 06:55
// Generated with Commenter by abi.exDream.com
// Note: To test this use FX Composer from NVIDIA!

string description = "Line rendering in 2D space shader for XNA";

// Default variables, supported by the engine
float4x4 worldViewProj : WorldViewProjection;

struct VertexInput
{
    float3 pos : POSITION;
    float4 color : COLOR;
};

struct VertexOutput
{
    float4 pos : POSITION;
    float4 color : COLOR;
};

VertexOutput LineRendering2DVS(VertexInput In)
{
    VertexOutput Out;

    // Transform position
    Out.pos = float4(In.pos, 1);
    Out.color = In.color;

    // And pass everything to the pixel shader
    return Out;
} // LineRendering2DVS(VertexInput In)

float4 LineRendering2DPS(VertexOutput In) : Color
{
    return In.color;
} // LineRendering2DPS(VertexOutput In)

// Techniques
technique LineRendering2D
{
    pass Pass0
    {
        VertexShader = compile vs_1_1 LineRendering2DVS();
        PixelShader = compile ps_1_1 LineRendering2DPS();
    } // Pass0
} // LineRendering2D


    Not much changed here either. Only the vertex shader is changed, we don't have to use our worldViewProj matrix anymore. We are just copying the data over to the pixel shader for rendering the screen stuff directly.

    Thats it for rendering 2D data. I guess most 2D stuff will be covered by the Sprite class, but if you need some custom 2d stuff (lines, boxes, etc.) this code should help you out. Have fun writing more complex stuff.

  • Ok, if the line stuff is that hard, lets do some simple mesh rendering, right?

    Wrong again. While this was planed for the XNA Beta release, it didn't make it into the beta and you have to do your own mesh loading, handling and rendering. In the SpaceWar Starter Kit game you can find some code to load swm model files (wtf is this format?), but you can't render .x or .fbx files that easily yet. In the future no problem, but right know you are f .. erm, not able to ^^. When I got some code for mesh loading and rendering, I will show it

  • Content Management, what about that?

    Well, its quite cool to just drop your content files into your project and then you can directly access them in your code. But since this feature is not supported yet, there is no point discussing it ... If you want to read stuff anyway, check this blog posts about the content pipeline out: http://blogs.msdn.com/xna/archive/2006/08/29/730168.aspx and http://blogs.msdn.com/shawnhar/archive/2006/08/26/725954.aspx.

  • Why are there so few help topics in the most important namespace Microsoft.XNA.Graphics, especially for 3d rendering?

    Well, since most of the line rendering, mesh or even the content pipeline is not supported, it is no wonder some important topics are missing. The help basically just tells you how to create a textured cube yet, nothing else. But this is also an early beta release, expect more help topics in the future. The many new XNA pages that are created these days (like 10 new ones each day ^^) will also provide a lot of resources. I bet XNA will have a really big community after a while. XNA has already interessted a lot of people about this new technology.

    Please also try to use the DirectX documentation as backup help in case you need more tutorials, samples and documentation.

  • Shaders?

    Yap, everything except Sprites has to be done with shaders. I guess this will be reason enough for most XNA games to never have any 3d content. Working with sprites is quite easy, but having to write custom shader code, declaring vertex types and having crazy random exceptions is nothing easy.

    For example if your shader fails to compile you get just a System.NullReferenceException: Object reference not set to an instance of an object. There is no explanation what did went wrong, which is pretty bad IMO. Shaders are really a pain in the ass because they are not managed in any way. Its just some script that gets compiled for the GPU and if anything went wrong you can hope your tools tell you exactly what to do. MDX did already suck in this regard, but from my quick early preview XNA is way worse. I really hope this part gets improved. What does nice and clean sprite, sound and controller programming help me if the 3d code is ugly as hell and as hard to write as c++ minus the debugging benefits from DirectX.

    Debugging DirectX? Yes, lets do that. First you need VS 2005 (see below how to get that to work with XNA). Now activate unmanaged Debugging and make sure DirectX is running in Debug mode (either go to your control panel and open up DirectX or use Start->Programs->DirectX->Utilities->Control Panel (which is the only available choice on x64 bit), now select debug mode and also set the Managed DirectX dlls to debug for better debugging support. Now when crazy NullReferenceExceptions happen and you are lucky you might see some helpful explanation.

    Scroll above to see some simple shaders for the line rendering stuff. There is also another shader example in the documentation, work with that code and change it with help of tools like FX Composer to find out about compiling errors beforehand.

  • Do I have to dispose textures, models, etc. like in MDX?

    Not really. I didn't notice any problems yet. I guess XNA has some mechanisms to collect all resources when disposing itself (game component and device). As you can see in the SpaceWar Starter Kit they didn't had to implement any disposing for their MeshCache or TextureCache lists in SpacewarGame.cs.

    This is quite cool IMO, it makes coding even easier than it was in MDX.

  • Why does my game crash with a NullReferenceException when I drag it over to another screen when using SpriteBatches?

    I guess this is some bug in the SpriteBatch class, which does not handle the device lost event correctly or something. It always crashes in the Begin() method when dragging the window out of my first screen. Since the SpriteBatch class does not have any events other than disposing, the best and simplest solution is just to add a event handler for the OnCreateDevice event and put your SpriteBatch creation code there too. This way it gets re-created when you need it. Would be nice if you didn't have to do this yourself ... XNA team reading this? Who knows ^^

  • Occlusion quering for example for lens flare effects?

    Not supported, check out this post.

  • What about Physics, AI, Collision, Particles, etc.?

    Not supported right now, check out this post. Since XNA is mainly a graphic engine with sound and controller support, it is not very likely you get advanced engine features soon.

  • How to get XNA working in VS 2005 (with all the plugins you might have, which do not work in Express)?

    Thats not supported or even possible out of the box! Read more about this here (Forum) and in the FAQ.

    But since I'm such a clever guy I modified the XNA templates quite a bit and added support opening the project in VS 2005. Read the full story here. Basically just download this: Xna64BitSupport.zip (14 KB) and extract it to:
    C:\Program Files\Microsoft Visual Studio 8\Common7\IDE\VCSExpress\
    Now you can open your created XNA Game Studio Express projects in VS 2005 and continue working on them there.

  • Unit Testing in XNA?

    Quite simple, just add NUnit.Framework.dll, which is fully managed and should even work on the XBox360 (not that you need unit testing there). If you use VS Express, TestDriven.NET will not work (unless you have a version from last year, which still supported it). If you use VS 2005 use TestDriven.NET or TestRunner (tested it few weeks ago, very nice, but does not support static unit tests, big nono for me).

    I also suggest using a TestGame class and do many static unit tests to play around with XNA (I already wrote 5 static unit tests today). Thats much faster than to create a new project everytime. And each test looks much easier and shorter than a complete new project.

  • Performance of XNA compared to MDX or native DirectX.

    I couldn't detect any performance penalities yet, someone in the XNA forums had some problems archiving 800 fps when using bitmap fonts, dunno what that was about. But it is very hard to say how XNA performs in relation to MDX because there is not much code or games we can compare yet.

    But in my opinion it does not even matter, the XBox360 is fast enough even if you write really shitty code and the windows platform is also quite fast with all this dual core around. For most simpler or casual games this will never matter much. However I do strongly believe that XNA will perform on the same level as MDX and DirectX.

  • But I want to play my XNA game on my XBox 360?

    Me too, but we have to wait for the next drop of XNA ^^ Not supported yet.

  • What about Rocket Commander for the XBox 360?

    Well, I thought about that, but since many of the classes used in Rocket Commander are not supported yet in XNA and the actual XBox360 execution is not yet possible, why even bother? As soon as XBox360 XNA'ing is possible, I will consider a Rocket Commander port again.

  • Btw: Why is the SpaceWar Starter Kit so big (155 MB uncompressed)? There is not even music in it.

    Most textures are uncompressed as .tga files, not good ... Rocket Commander has more graphics, music and I guess more sound files too, but is less than 10 MB.

  • Need more help? Then ask in the XNA Forums and not here, I got stuff to do :D

Hope this helps. I will post more about XNA Trick & Tips soon

Yes, I'm writing a XNA game too. It will even be a Starter Kit for the next XNA Game Studio Release, more about that next week, I will post weekly screenshots like in the Rocket Commander Development time.

I installed Windows XP Professional x64 Bit today and this post is about my experiences with it. I tried it a year ago, but most drivers were not available for 64 bit back then. Now most drivers are supported and most programs will work without a problem. However some drivers and programs will still make trouble. Most of the issues could be resolved one way or another.

Generally I would say Windows XP x64 works great and is even a little bit faster than 32 bit Windows.

^{No problems}

Had to change my mainboard because my current one went dead yesterday, I could use the same Windows x64 version without reinstalling, thats nice. Windows 32 bit does not work anymore (some driver troubles I guess). I also noticed that about Vista, no more reinstalls required if you change your board and cpu.

Games worked great, no problems here. I guess Microsoft plays a lot of games and wants to make sure all of them work, hehe. Even 15 year old games like Raptor (my all time shoot'n'up favorite) or Wolfenstein 3D worked without problems. Starcraft, Quake3 and current games worked nice too. Daemon Tools also provides a x64 bit version for Windows XP x86 for emulating CDs or DVDs.

Visual Studio 2005, DirectX SDK and all other development tools like VS Express, SharpDevelop, CodeRush, Perforce, UltraEdit, PCalc, NSIS, etc. work great too. For running 32 bit IIS apps you might have to follow these instructions.

Virtual Server 2005 works nicely and you can run virtual x64 and x86 computers, I guess the performance is also good or even better than before, but maybe my system is just faster.

Most normal programs did work too, but since nearly 99% of all programs are still 32 bit, it does not really make sense to have a 64bit platform yet. For browsing IE 64 bit is available and for Firefox (which is 32bit again) there is a 64 bit port called Deer Park, which works nicely. Both of these browsers are useful if you need more than 2 GB memory for your crazy browsing. Some programs do provide a x64 bit version, which works just the same way as the 32 bit version (I guess they did just a recompile with different compiler settings). I would say more programs and tools will be tested for x64 in the future, especially for Vista, when more users might choose x64 for their operating system.

^{Programs with problems}

Most .NET 2.0 tools I tested did not work, but all of them could be fixed by changing the build setting from Any CPU to x86 Platform. While .NET 2.0 has NO problem running in 32 or 64 bit, it is not that easy in the case you call any external code (and almost all my tools do that). For example my AbiTrafficMonitor tool uses SharpPcap, which again uses wpcap.dll, which is only available as a 32bit dll. By forcing 32 bit to the application everything works great, in 64 bit the dll is not found and can't be forced. It is not possible to load 32 bit dlls in 64 bit mode, you will get the following error message when attempting to do that. An attempt was made to load a program with an incorrect format. (Exception from HRESULT: 0x8007000B)

So you have to make sure a 64 bit version of all used dlls exists, else DO NOT use the Any CPU or x64 Platform settings. so this has to do something with .NET 2.0 (just some stupid compiler setting, recompile works, but a smarter version would be cool).

Here is the new installer for AbiTrafficMonitor, which works on Windows XP x64 too (by forcing the x86 mode). It does obviously still work on a normal 32 bit (x86) windows platform.

.NET 1.1 games like my Arena Wars game worked too, also .NET 1.1 tools worked fine. All .NET 1.1 assemblies run automatically as 32bit applications by design. .NET 2.0 runs automatically in 64bit mode on x64 platforms if All CPU is selected.

However my .NET 2.0 game Rocket Commander could not be started. Actually this is the same problem as above (not allowed to call 32 bit dlls from 64 bit code). .NET 2.0 runs fine in 64 bit mode and DirectX provides also 64 bit dlls, BUT Managed DirectX does NOT support using 64 bit. There is no version available to do that right now, neither MDX 1.1 nor MDX 2.0 support x64. So again, force the platform to be x86 and everything works again.

I recompiled Rocket Commander and it is available at the default download location: www.RocketCommander.com download page
There were also a couple of discussions about this issue in the Rocket Commander boards.

Another issue are external tools or helper tools like TestDriven.NET, which support x64, but it seems the underlaying NUnit Framework does work only in 32 bit. Not funny at all if you have a x64 bit app or just run All CPU on a x64 platform and want to test your code. This issue can be resolved by testing in 32 bit mode and then later switch to 64 bit if you want a 64 bit version of your app.

UltraEdit, WinZip and WinRar work fine, but all of them are 32 bit. So whats the problem? They all provide shell extensions for the Windows Explorer, which do not work in the 64bit version of the Explorer. There are 2 solutions for this.

• Start the Windows Explorer 32 bit with the command line. Command:
  c:\windows\syswow64\explorer.exe /separate
  This didn't work very well for me, some of the shell commands did not work properly and it is really annoying to start the windows explorer this way. Often you might open a folder or jump to a containing folder, then of course the default 64 bit Windows Explorer is used.
  
  
• Add your own shell commands in the registry. This works great for Open with UltraEdit or Extract files here, but if you need smarter commands like Extract to subfolder this doesn't help. Anyways, here is the solution. Add this file to your registry to add the following lines (change them to whatever you need):
  
  Windows Registry Editor Version 5.00
  
  [HKEY_CLASSES_ROOT\*\shell]
  
  [HKEY_CLASSES_ROOT\*\shell\Extract here]
  @="Extract here"
  [HKEY_CLASSES_ROOT\*\shell\Extract here\command]
  @="C:\\Program Files (x86)\\WinRAR\\winrar x \"%1\""
  
  [HKEY_CLASSES_ROOT\*\shell\Ultra Edit]
  @="Open with UltraEdit"
  [HKEY_CLASSES_ROOT\*\shell\Ultra Edit\command]
  @="c:\\Program Files (x86)\\ULTRAEDIT-32\\uedit32.exe \"%1\""

^{Programs and drivers that do not work}

Some old setups like for the Panorama Wallpaper changer do not at all (wrong windows version error message), but I managed to install some of the manually (copying files and setting registry settings).

My on board network drivers do not work at all, neither does my old TV card, but I had many driver problems in Vista Beta 2 x64 too. I found a old 1Gbit network card that works and I never watch TV anyways. All other drivers (board, gfx, sound, mouse, keyboard) work just fine.

Update 2008-08-19: My onboard sound really sucks and I tried to install my old PCI Soundcard (XFire 1024), but since the vendor does not provide 64 bit drivers, there is no way I can use that card. The onboard network adapter (Marvell 88E1111) also stopped working and does not even show up. Another old VIA VT6120 1gbit card could be installed, but didn't work either. Maybe I have to try out deactivating the other cards and then it should work, a 64 bit driver is installed.

Now to my main issue: You cannot use ANY new keyboard layouts at all! I really need my own AbiKeyboardV9 layout to type efficiently. I tried like 10 different other keyboard layouts too, all of them can be installed, but as soon as you try to use a new layout you always get a error message like "Windows could not load the x keyboard layout.". Not funny at all and I found absolutely NOTHING for either vista or x64 Windows to fix this problem on the internet. I used the Microsoft Keyboard Layout Creator, which works great on Windows XP 32 bit and lower. But this tool was last updated 2003 and the support for future windows version or x64 is just not-existant. Other tools I tried (keytrans, klm, etc.) suck even more and usually cost a lot of money, none of them worked on 64 bit or provide any useful features for me. All of them work only in 32bit.

More links on that topic (all of them have x64 bit problems and are unresolved)
http://www.planetamd64.com/lofiversion/index.php/t15929.html
http://blogs.msdn.com/michkap/archive/2006/01/26/517728.aspx
http://blogs.msdn.com/michkap/archive/2005/10/06/477930.aspx

I found some information on Marks Blog from Sysinternals in which he provides a solution to his Cap2Ctrl tool (which just maps the Caps Lock key to Ctrl). Similar to that I found out which keys have which codes with help of the scancode.doc doc from Microsoft for keyboard developers and wrote my own keyboard remapping code.

While the normal keys worked great and were changed in a couple of minutes all the special keys are messed up because I had different meanings for pressing shift with special keys. I found no solution to that so I updated my keyboard layout, there were some minor changes I wanted to do anyways. This is my new keyboard layout, which now works on all windows versions (finally I can use Vista too ^^). Some keys are not optimal, but to support both the german and US keyboards some '/" have to be used twice (scan code 2B) and some keys like -/_ had to be moved to worse positions (relative to my old layout, not much of a difference compared on the US layout). This can't be fixed with scancode remapping. I've used my new layout for a couple of hours now and it seems fine. The most annoying changes are <>, (), \|- and -_, everything else stays, but I guess I will manage.

This is my new Keyboard Layout:

• AbiKeyboardLayout v10
  
• To install you can use the following file: abi keyboard installer.reg
• And uninstall it again with this file: abi keyboard uninstall.reg
• This is the content of abi keyboard installer.reg:
  
  Windows Registry Editor Version 5.00
  
  [HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Keyboard Layout]
  "Scancode Map"=hex:00,00,00,00, 00,00,00,00, 19,00,00,00, 2A,00,3A,00, 2B,00,0C,00, 0C,00,0D,00, 0D,00,10,00, 19,00,12,00, 15,00,14,00, 10,00,15,00, 22,00,16,00, 20,00,17,00, 21,00,18,00, 25,00,19,00, 28,00,2B,00, 18,00,1F,00, 12,00,20,00, 16,00,21,00, 17,00,22,00, 1F,00,24,00, 14,00,25,00, 31,00,26,00, 26,00,27,00, 27,00,28,00, 0C,00,56,00, 24,00,30,00, 30,00,31,00, 00,00,00,00

  To understand the scan codes and how this binary code is formated please read this document: scancode.doc.

So far so good, I will stick with x64 and you guys know now how complicated my computer is ^^

Hi there. If you watched one of my webcasts and need a link or something, I can help you out

Searching for more webcasts?

• For example the Webcast Introduction to Shaders Using Managed DirectX (Level 200) by ZMan is at 31 May 2006
• My blog post about the Rocket Commander webcasts and the schedule
• Check out http://www.microsoft.com/webcasts/ for all the webcasts at microsoft

---

Rocket Commander Webcast Part 1 of 3: The Graphic Engine (16 May 2006) On demand webcast download Please remember: This webcast has very poor audio and many problems during the desktop sharing, the next two webcasts are MUCH better! Get Visual Studio Express for free at http://msdn.microsoft.com/vstudio/express/ Get the source code from http://www.RocketCommander.com Link to all the Video Tutorials of Rocket Commander MyOwnGraphicEngine.zip, which is used in the webcast More Links: http://www.thezbuffer.com http://www.gamedev.net http://www.CodeProject.com http://msdn.microsoft.com/Coding4Fun/
Rocket Commander Webcast Part 2 of 3: Shaders (17 May 2006) On demand webcast download Get FX Composer from NVidia: http://developer.nvidia.com/object/fx_composer_home.html Get the source code from http://www.RocketCommander.com Link to all the Video Tutorials of Rocket Commander RCTutorial06.zip, which is used in the webcast Nice online article about bumpmapping Books: Programming Vertex & Pixel Shaders (Wolfgang Engel) Game Programming Gems 1-6 (Charles River Media) GPU Gems 1+2 (NVidia) Shader X 1-4 Programming Series (Wolfgang Engel) Shaders for Game Programmers and Artists (Premier Press) More Links: http://www.thezbuffer.com http://www.gamedev.net http://www.CodeProject.com http://msdn.microsoft.com/Coding4Fun/
Rocket Commander Webcast Part 3 of 3: Creating your own Game Modification (19 May 2006) On demand webcast. Get FX Composer from NVidia: http://developer.nvidia.com/object/fx_composer_home.html Get the source code from http://www.RocketCommander.com Link to all the Video Tutorials of Rocket Commander Download the Flower Commander installer, which shown in the webcast Download the Flower Commander source code from the webcast. More Links: http://www.thezbuffer.com http://www.gamedev.net http://www.CodeProject.com http://msdn.microsoft.com/Coding4Fun/

I just wanted to remind you of the 3 webcasts I will do about Game Development next week.
Its about the Rocket Commander game in particular and many other topics (see below).

• Tuesday, May 16, 2006 9AM - 10AM PST (6PM - 7PM CET)
  Rocket Commander Part 1: The graphic engine.
  Link to MSDN Webcast: Rocket Commander Part 1/3 to register
  
  
• Wednesday, May 17, 2006 9AM - 10AM PST (6PM - 7PM CET)
  Rocket Commander Part 2: User Interface, Sound and more
  Link to MSDN Webcast: Rocket Commander Part 2/3 to register
  
  
• Friday, May 19, 2006 9AM - 10AM PST (6PM - 7PM CET)
  Rocket Commander Part 3: Game design and creating a game mod
  Link to MSDN Webcast: Rocket Commander Part 3/3 to register
  
  

I will talk about the following topics:

• Part 1: The graphic engine
• Learning Game Development from Rocket Commander
• Introducing Rocket Commander
• The graphic engine and its features
• How to write your own graphic engine
• Time for questions about graphics
  
  
• Part 2: Shaders
• What are Shaders?
• Example Games
• Create Shader files with FXComposer
• Normal Mapping
• Implementing Shaders into the Engine
• Feel free to ask any questions you have about Shaders.
  
  
• Part 3: Creating a Game Modification
• Input devices and User Interface
• Keyboard, Mouse and XBox Controller
• Menu and IGameScreen classes
• Game logic and how to change it
• Creating Flower Commander
• New main menu, new models, etc.
• Testing the finished Mod
• Game logic discussion and FAQ session at the end.

See you next week

exDream entertainment will be at the CeBIT again this year. You can find us at the  CeBIT 2006 in Hannover: Hall 27/C29 (Digital Media by nordmedia). The CeBit starts at 2006-03-09 and ends 2006-03-15.

Polynapping: I think I will adjust my polynapping schedule for this week to stay awake for 8 hours over the day. I have several meetings and I don't think it would be cool to fall asleep there ^^ I would bet the CeBIT is also not very polynapping-friendly. Instead of sleeping 6 times 20 minutes I will sleep now only 4 times 20 minutes (evening and night) and before I go to work I sleep 3 hours straight. This will keep me awake for 8 hours (at least it worked today ), then 4 polynapps follow and the same thing starts over the next day. Thats now twice as much sleep as before (4 hours instead of 2-3), but still only half the amount normal people sleep.

Coop Commander: Looks quite good, the game physics and ship control are finished now and it is quite fun to shoot around and see everything exloding. There are still 2 major issues left: Good enemy unit AI (they move pretty stupid right now, either straight ahead or on a collision path) and multiplayer syncronization. Dunno if I can make it this week, but I should have some time at nights with my new schedule to keep working on that.