Using display windows to examine the source code

• Working with a Source window
• Setting breakpoints
• Examining a structure and changing variable values

Working with a Source window

1. Make sure the files UFO (executable), UFO.sym (symbols file), and UFO.spt (script file) are in the /remote folder.

2. Type into the Terminal window:

    debug ufo 
   
   

   and press Enter.

   The Debugger launches the program and stops at main().

3. Press Command-K to bring up a Source window (or choose New Window, then Source from the View menu).

   When you use debug prog_name to start a program (as in Step 2), the Debugger always puts a breakpoint at main(). In the Source window shown in the figure below, the program is stopped at main().

   

   Figure 1: Source window stopped at a breakpoint at main().

4. Press Command-G to release the program.

   The startup screen should appear on the TV monitor after a short time.

5. In the Terminal window, watch the information about the program's progress. When the text "DoOptions called" appears, press the Start button on the control pad attached to the 3DO system to start the game.

Setting breakpoints

1. In the Source window, click on the cross-hatch (#) next to the line TargetAction(pcUFO)as shown in the figure below.

   The cross-hatch changes to a red bullet.

   

   Figure 2: Location for setting a breakpoint.

   When the program reaches the breakpoint in the while loop the next time, it stops. You can now examine the program by stepping through it.

2. Use Command-, (comma)-Step Over-to move to UpdateDashboard().
3. Use Command-; (semicolon)-Step In-to move to the first line of UpdateDashboard().
4. Continue to examine the program for as long as you like.
5. To remove the breakpoint, click on it again and it changes back to the cross-hatch.

Note: Step Over goes to the first executing instruction of a function. Step In goes to the next executable line and makes it possible to look at local variables and other function-internal information. Usually, you use Step In only to look at a particular function in detail.

Examining a structure and changing variable values

1. Return to the main loop and press Command-, (Command-comma) to step into the TargetAction() function.

2. With the PC (program counter) inside the TargetAction() function, select pcTarget, then press Command-D to bring up a Variables window.

   

   Figure 3: Variables window invoked from a Source window.

3. Hold down the Command key and double-click on the structure in the Variables window to expand it.

   

   Figure 4: Structure displayed in a Variables window.

4. To interactively change variable values, click on the ccb_Flags line to make it appear in the edit region.

   

   Figure 5: Variable value selected for interactive change.

5. Change 7F26... to FF26..., then press the Return key.

6. To see the change take effect, look at the TV screen and watch the UFO disappear as you press Command-G to release the breakpoint and continue program execution.

   If you want to change the value back, set a breakpoint elsewhere and change the value, then release the breakpoint again.

7. To change the position of the UFO, double-click on the ccb_XPOS line.

8. From the Options menu, select Frac16-16 to see the position's actual value.

   

   Figure 6: Display options pull-down menu in the Variables window.

9. Change the value of the position in the ccb_XPOS line, then press the Enter key.

10. Release the breakpoint by pressing Command-G to continue.