Back to Hands-On Interactive Game Development

02.07 - The Readiness Test

Teej · 2003-12-15T22:40:18

Oh Goody, Code Time! Alright recruits, we’re about to test your compiling and linking skills. I’ve added a zipfile called BASECODE1 on my website that I’d like you to download now (don’t unzip it yet though!). The zipfile contains the following files: Globals.h – the main header file for the game template WinBase.cpp – the windows application overhead we’ve discussed InitTerm.cpp – the initialization/shutdown functions GameMain.cpp – where the game code goes Utils.h – prototypes for our helper functions Utils.cpp – the helper functions themselves Resource.bmp – a sample bitmap Sample.wav – a sample WAV file Once you have this file in your possession, it’s time to create a project for our game template. Folks, the following discussion pertains specifically to those using the Microsoft Visual C++ (MSVC) IDE (a part of Microsoft Visual Studio). If you’re doing something else, you might need to raise a fuss by replying to this article if you need assistance. Create a New Project To create a project, Choose File|New , and select Win32 Application from the list of project types. Provide a name and location for this project (BaseCode1 would be a good idea) and let the IDE create an empty project for you. Once it’s done, there will be a new directory created for you with some standard project files already there. This is where we’d like the BaseCode1 files to end up, so go ahead and unzip the archive to there. The end result is that you’ll have a single directory (perhaps called BaseCode1 ) that contains all of these files. Adding these files to our new project involves nothing more than selecting the FileView tab on the bottom left of the IDE (or wherever you placed the project view) and right-clicking on BaseCode1 files . Add them all in by selecting them and there you have it! Ah, but wait! We’re not ready to attempt building the project yet. A couple more steps are involved. Tell the IDE Where to Look Move to Tools|Options|Directories , and you’ll see a list of locations that the IDE searches through when looking for project files. We’re not talking about our files here – they’re all in the project’s directory and therefore easy for the IDE to find. No, what the compiler is really going to have a hard time finding without our help is all of the DirectX header files that we intend to use. So, here’s what you do. Where did you install your DirectX SDK? Mine is at C:\DXVCSDK , so I’ll use that as an example (substitute with your own). All of the DirectX header files are located in the INCLUDE subdirectory, so you’d add an entry like this to the list: C:\DXVCSDK\INCLUDE Now that you have it in the list, and this is very important, move the entry up until it’s the very first one. The reason for this is because MSVC comes with some older DirectX header files, and if the IDE looks in the MSVC default directories before trying yours, things will be screwed-up. Tell the Linker Where to Look The IDE may now know where all of the header files are (in our project directory and in the DirectX SDK include directory), but it also needs to know where the ‘real’ DirectX code libraries are. After all, the header files only contain prototypes (kind of like usage instructions) for the DirectX components – the components themselves are in DLL files on your system. What the linker needs to do is know which libraries (files with linking instructions) are needed for our project. We’ll be looking at compiling and linking in a later article, but for now here’s what I’m talking about: Our project uses these files: DDRAW.H DINPUT.H DSOUND.H …which contains prototypes for the DirectDraw, DirectInput and DirectSound components we’re using. The actual components (the DirectX runtimes) are called: DDRAW.DLL DINPUT.DLL DSOUND.DLL …which are the files that everyone has for playing DirectX games with. Finally, we have library files that connect code using DirectX components: DDRAW.LIB DINPUT.LIB DSOUND.LIB Okay, so just read this next sentence very carefully and you’ll be fine: Our source code is compiled with instructions contained within header files, and linked with instructions contained in library files, which ultimately allow our code to use the components in the runtime (DLL) files. So, where was I? Oh yeah… Head to Project|Settings|Link , and you’ll see an edit field called Object/library modules . You may even see some entries already here, all ending in .LIB. All we need to do is add our library files here, and they happen to be located in a directory called LIB inside our main DirectX folder. What I do is add this to the front of the library list: C:\DXVCSDK\LIB\*.lib If there are other libraries in this list already, leave them after yours (separated by a space). Now, there happens to be one other library that we’re using (for our sound code), so you’ll need to add WINMM.LIB to this list as well. So, to recap, let’s say that when you first showed up in this dialog, the edit box showed something like: SOMELIB.LIB OTHERLIB.LIB YETMORE.LIB… (Whatever their names actually are, who cares). Now it should be: C:\DXVCSDK\LIB\*.lib WINMM.LIB SOMELIB.LIB OTHERLIB.LIB… Got it? Mission Control… Now for the big moment. Build the project (by hitting F7), and pray that you see ‘0 errors, 0 warnings ’ when it’s done. If you are having problems, first realize that the build process involves two stages, compiling and linking, both with their own types of errors. For instance, the link process won’t even begin if there were errors in the compile stage. Either you saw ‘Linking…’ in the output window or you didn’t. If you are getting complaints like: Compiling... GameMain.cpp c:\gdn\basecode\globals.h(87) : error C2146: syntax error : missing ';' before identifier 'lpDD' c:\gdn\basecode\globals.h(87) : error C2501: 'LPDIRECTDRAW7' : missing storage-class or type specifiers c:\gdn\basecode\globals.h(87) : error C2501: 'lpDD' : missing storage-class or type specifiers c:\gdn\basecode\globals.h(88) : error C2146: syntax error : missing ';' before identifier 'lpDDSPrimary' c:\gdn\basecode\globals.h(88) : error C2501: 'LPDIRECTDRAWSURFACE7' : missing storage-class or type specifiers c:\gdn\basecode\globals.h(88) : error C2501: 'lpDDSPrimary' : missing storage-class or type specifiers c:\gdn\basecode\globals.h(89) : error C2146: syntax error : missing ';' before identifier 'lpDDSBack' c:\gdn\basecode\globals.h(89) : error C2501: 'LPDIRECTDRAWSURFACE7' : missing storage-class or type specifiers c:\gdn\basecode\globals.h(89) : error C2501: 'lpDDSBack' : missing storage-class or type specifiers c:\gdn\basecode\globals.h(90) : error C2146: syntax error : missing ';' before identifier 'lpDDSRes' c:\gdn\basecode\globals.h(90) : error C2501: 'LPDIRECTDRAWSURFACE7' : missing storage-class or type specifiers c:\gdn\basecode\globals.h(90) : error C2501: 'lpDDSRes' : missing storage-class or type specifiers c:\gdn\basecode\globals.h(94) : error C2146: syntax error : missing ';' before identifier 'lpDI' c:\gdn\basecode\globals.h(94) : error C2501: 'LPDIRECTINPUT7' : missing storage-class or type specifiers (…on and on…) then you probably need to make sure that you’re pointing the IDE to the DirectX header files (look in Tools|Options|Directories ). If you have other compile errors, try to get ahold of me (teej@gdnmail.net or 70816765 on ICQ) or post a reply to this article with your questions. As for the linking, well, that’s primarily the job of the LIB list we prepared under Project|Settings|Link. Here’s an example of having it entered incorrectly: Linking... InitTerm.obj : error LNK2001: unresolved external symbol _DirectDrawCreateEx@16 InitTerm.obj : error LNK2001: unresolved external symbol _IID_IDirectDraw7 InitTerm.obj : error LNK2001: unresolved external symbol _c_dfDIKeyboard InitTerm.obj : error LNK2001: unresolved external symbol _GUID_SysKeyboard InitTerm.obj : error LNK2001: unresolved external symbol _IID_IDirectInputDevice7A InitTerm.obj : error LNK2001: unresolved external symbol _DirectInputCreateEx@20 InitTerm.obj : error LNK2001: unresolved external symbol _IID_IDirectInput7A InitTerm.obj : error LNK2001: unresolved external symbol _DirectSoundCreate@12 Debug/basecode.exe : fatal error LNK1120: 8 unresolved externals Error executing link.exe. basecode.exe - 9 error(s), 0 warning(s) As you can see, since the libraries weren’t included properly, the poor linker was lost when it came to including these symbols. Once again, let us know if you’re stumped. NOTE: When we added the libraries in for the linker, you may have noticed on the left side of the screen that there was a box that had ‘Settings for: Win32 Debug ’. Keep in mind that these libraries that you’re adding are only valid when in Debug mode. You can either change this box to read ‘All Configurations ’ before entering your libraries, or enter them a second time when in Release mode. So Far So Good… If you managed to reach the finish line, ‘0 errors, 0 warnings ’, run the program (CTRL-F5) and hopefully you’ll be rewarded with some text on the screen. The space bar will cause a sound to play, and ESCAPE will exit the program. If you aren’t here yet, don’t bother continuing in the forum! That’s why this is called the ‘Readiness Test’… if you can’t get this stuff to run you need to let us know so that we can help rectify the situation. What about the program itself? On the surface, it doesn’t seem to do much. In fact, it uses DirectDraw, DirectInput and DirectSound in proper form (initialization, use and shutdown), so it’s a good learning example. In later articles we will be using and building on this framework, so it’s a good idea to get your DirectX online documentation ready and try going through the code. Of course, the documentation provides excellent introductory material on each of these components, and if you take the time to read some of it you’ll be ahead of the game. The Ladder series was designed to represent ‘prerequisite knowledge’. You know have everything you need to start on your path to enlightenment: An introduction to game development A basic windows application framework C language resources A quick overview of some of the basic tools required Some insight into how a game might be written Information on resolutions, colors and pixel plotting The role of DirectX in our games A first run with some game template code Congratulations… You have your compiler/linker in order, the DirectX runtimes and SDK installed, the online documentation at your fingertips, and some template code that sits before you like an open book with blank pages – ready to be filled in with the knowledge and practice that is the rite of passage for any apprentice. Get ready folks, because next up is the proverbial ‘Square One’. See you there. Questions? Comments? Can’t get the damned code to build? Reply to this article – help is on the way! Edited by - teej on April 20, 2001 11:10:00 AM

Hands-On Interactive Game Development Workshops

Started by Teej April 20, 2001 10:05 AM

214 comments, last by Teej 20 years, 5 months ago

seze8

122

August 18, 2001 10:39 AM

My compiler says(Dev-C++ for the moment, will be getting Visual C++ before next weekend) that global.h''s header file mmreg.h doesn''t exist, and it doesn''t on my computer because I checked all of Teej''s program and all of the includes that go to my compiler.

Please help! Where can I get mmreg.h?

In life we are all blind men or women, sometimes you crash into a wall, sometimes you remember to bring your walking stick.

SEZ

-darkcoder8

Weatherman

122

August 19, 2001 09:54 AM

Andyc:

Is it really necessary to post every single error? Couldn''t you just edit your post to eliminate duplications?

andyc

122

August 20, 2001 05:15 AM

sorry to all about the posting of all the errors, i got hold of vc++ and reinstalled sdk8 and now i am ready to make games.
thanks for the help everyone.

have seen the light (MVC++)

Kaezin

158

August 23, 2001 09:12 PM

I get these stupid errors when I try to compile:

Linking...
Game.obj : error LNK2001: unresolved external symbol _IID_IDirectDraw4
Debug/Game.exe : fatal error LNK1120: 1 unresolved externals
Error executing link.exe.

I put in all the headers and everything fine =\ (I modified the code a little, I am using the Tricks of the Windows Game Programming Gurus book)

Half the people you know are below average.Trogdor the Burninator

milkywayman

122

August 24, 2001 10:18 PM

teej....if got a big problem, i cant seem to access your website. it has been 3 weeks now, and i fear that i willnot be able to follow your lessons.
your address "http://teejb.webjump.com/" never loads on my computer
HELP.

thanks

Anonymous

September 09, 2001 10:59 PM

Hmmmmm...
My problem:
I''ve got the files entered correctly (i.e. C:\mssdk\lib\ddraw.lib) With a space in between each, and a spcae between the last and the other .lib files. Maybe a problem with the fact that I''m using DirectX 8.0a and you''re using 7? I don''t know, please help. thanks.

Anonymous

September 09, 2001 11:11 PM

quote:Original post by Anonymous Poster
Hmmmmm...
My problem:
I''ve got the files entered correctly (i.e. C:\mssdk\lib\ddraw.lib) With a space in between each, and a spcae between the last and the other .lib files. Maybe a problem with the fact that I''m using DirectX 8.0a and you''re using 7? I don''t know, please help. thanks.

Hmmm, figured out at least part of my problem, reduced errors from 15 to 10 by making it "C:\mssdk\lib\*.lib" But I still have the last ten. Here''s the list:

Utils.obj : error LNK2001: unresolved external symbol __imp__mmioAscend@12
Utils.obj : error LNK2001: unresolved external symbol __imp__mmioRead@12
Utils.obj : error LNK2001: unresolved external symbol __imp__mmioDescend@16
Utils.obj : error LNK2001: unresolved external symbol __imp__mmioClose@8
Utils.obj : error LNK2001: unresolved external symbol __imp__mmioOpenA@12
Utils.obj : error LNK2001: unresolved external symbol __imp__mmioSeek@12
Utils.obj : error LNK2001: unresolved external symbol __imp__mmioSetInfo@12
Utils.obj : error LNK2001: unresolved external symbol __imp__mmioAdvance@12
Utils.obj : error LNK2001: unresolved external symbol __imp__mmioGetInfo@12
Debug/Basecode1.exe : fatal error LNK1120: 9 unresolved externals
Error executing link.exe.

Basecode1.exe - 10 error(s), 0 warning(s)

Once again, hmmmmmmmmm...

Anonymous

September 10, 2001 10:22 PM

Add winmm.lib after the directx libs.

Anonymous

September 14, 2001 05:49 PM

quote:Original post by Anonymous Poster
Add winmm.lib after the directx libs.

Hmmm, it built, but In the debug window, after running, I get this:

Loaded ''C:\WINDOWS\SYSTEM\OLE32.DLL'', no matching symbolic information found.
Loaded ''C:\WINDOWS\SYSTEM\RPCRT4.DLL'', no matching symbolic information found.
Loaded ''C:\WINDOWS\SYSTEM\DSOUND.DLL'', no matching symbolic information found.
Loaded ''C:\WINDOWS\SYSTEM\WINMM.DLL'', no matching symbolic information found.
Loaded ''C:\WINDOWS\SYSTEM\DINPUT.DLL'', no matching symbolic information found.
Loaded ''C:\WINDOWS\SYSTEM\VERSION.DLL'', no matching symbolic information found.
Loaded ''C:\WINDOWS\SYSTEM\ADVAPI32.DLL'', no matching symbolic information found.
Loaded ''C:\WINDOWS\SYSTEM\GDI32.DLL'', no matching symbolic information found.
Loaded ''C:\WINDOWS\SYSTEM\USER32.DLL'', no matching symbolic information found.
Loaded ''C:\WINDOWS\SYSTEM\KERNEL32.DLL'', no matching symbolic information found.
Loaded ''C:\WINDOWS\SYSTEM\NTDLL.DLL'', no matching symbolic information found.
Loaded ''C:\WINDOWS\SYSTEM\DDRAW.DLL'', no matching symbolic information found.
Loaded ''C:\Program Files\Metabyte\EyeSCREAM\Global\R_DDRAW.DLL'', no matching symbolic information found.
Loaded ''C:\WINDOWS\SYSTEM\MSOSS.DLL'', no matching symbolic information found.
Loaded ''C:\WINDOWS\SYSTEM\CRYPT32.DLL'', no matching symbolic information found.
Loaded ''C:\WINDOWS\SYSTEM\MSVCRT.DLL'', no matching symbolic information found.
Loaded ''C:\WINDOWS\SYSTEM\MSCAT32.DLL'', no matching symbolic information found.
Loaded ''C:\WINDOWS\SYSTEM\WINTRUST.DLL'', no matching symbolic information found.
Loaded ''C:\WINDOWS\SYSTEM\IMAGEHLP.DLL'', no matching symbolic information found.
Loaded ''C:\WINDOWS\SYSTEM\MSSIP32.DLL'', no matching symbolic information found.
Loaded ''C:\WINDOWS\SYSTEM\RSABASE.DLL'', no matching symbolic information found.
Loaded ''C:\WINDOWS\SYSTEM\HID.DLL'', no matching symbolic information found.
Loaded ''C:\WINDOWS\SYSTEM\MPR.DLL'', no matching symbolic information found.
Loaded ''C:\WINDOWS\SYSTEM\CFGMGR32.DLL'', no matching symbolic information found.
Loaded ''C:\WINDOWS\SYSTEM\WINSPOOL.DRV'', no matching symbolic information found.
Loaded ''C:\WINDOWS\SYSTEM\COMDLG32.DLL'', no matching symbolic information found.
Loaded ''C:\WINDOWS\SYSTEM\LZ32.DLL'', no matching symbolic information found.
Loaded ''C:\WINDOWS\SYSTEM\COMCTL32.DLL'', no matching symbolic information found.
Loaded ''C:\WINDOWS\SYSTEM\SHLWAPI.DLL'', no matching symbolic information found.
Loaded ''C:\WINDOWS\SYSTEM\SHELL32.DLL'', no matching symbolic information found.
Loaded ''C:\WINDOWS\SYSTEM\SETUPAPI.DLL'', no matching symbolic information found.
Loaded ''C:\Program Files\NeoPlanet\bin\idledet.dll'', no matching symbolic information found.
Loaded ''C:\Program Files\Microsoft Hardware\Mouse\Msh_zwf.dll'', no matching symbolic information found.
The thread 0xFFE3CC01 has exited with code -1 (0xFFFFFFFF).
The thread 0xFFE8E0E1 has exited with code 0 (0x0).
The program ''C:\My Programs\Basecode1\Debug\Basecode1.exe'' has exited with code 0 (0x0).

Something to do with my optical mouse? Anyone?

TheTramp

122

September 17, 2001 01:44 PM

Those ''no matching symbolic information found'' messages are not errors, that jsut means that you cant debug into those files.

That means that it has compiled fine and should run without any problems.

02.07 - The Readiness Test

This topic is closed to new replies.

Popular Topics

Recommended Tutorials

02.07 - The Readiness Test

This topic is closed to new replies.

Popular Topics

Recommended Tutorials

Reticulating splines