Changes between Version 9 and Version 10 of pps/tutorial_basic

Timestamp:

Sep 30, 2008, 8:12:28 PM (16 years ago)

Author:

rgrieder

Comment:

—

pps/tutorial_basic

@@ -81 +81 @@
 You should now be able to fire quicker. It doesn't yet go faster than the framerate though. [[br]][[br]]
 
-=== XML loading ===
+=== Declare XML loading ===
 This part is about how you can load class parameters with XML. Unlike ConfigValues, XML parameters are per object instead of per class. That means you can load multiple objects of the same class with different settings. We are now going to add one XML parameter for the TutorialShip class. [[br]]
-1. Find the ''XMLPort()'' function in the source file. You can see that there is comment but no statement after it. That's where you can insert the macro which specifies a parameter. Keep in mind that when loading with XMLPort, you need to have an access and a store function (not just a variable). These have already been created for the ''specialEffects'' parameter which tells the underlaying !SpaceShip whether to visualise the special effects. The syntax for XML parameters is:
+Find the ''XMLPort()'' function in the source file. You can see that there is comment but no statement after it. That's where you can insert the macro which specifies a parameter. Keep in mind that when loading with XMLPort, you need to have an access and a store function (not just a variable). These have already been created for the ''specialEffects'' parameter which tells the underlaying !SpaceShip whether to visualise the special effects. The syntax for XML parameters is:
 {{{
-XMLPortParam(class name, parameter name as string, setSpecialEffects, hasSpecialEffects, xmlelement, mode);
+XMLPortParam(classname, parameter name as string, setSpecialEffects, hasSpecialEffects, xmlelement, mode);
 }}}
 (You only need to adjust the first two macro parameters)
+
+=== Configuring the XML parameter ===
+Where to modify that XML stuff now? Of course in an XML file. It is the same that you have already opened previously when switching from !SpaceShip to TutorialShip. Look at the XML attributes: The first ones sound cryptic and are on one line. Ignore them and add a new line afterwards. Here you can configure your self declared XML parameter:
+{{{
+<TutorialShip
+    # Some unimportant parameters. Better don't mess with them ;)
+    camera="true" position="0,0,0".......
+    # Your own. Set it to "false" to disable showing special effects.
+    name-of-your-parameter="true"
+/>
+}}}
 
 === Logging messages ===