XML:OPge: Difference between revisions

From OniGalore
Jump to navigation Jump to search
mNo edit summary
mNo edit summary
Line 1: Line 1:
==[[OBD:OPge|OPge]]: objective page==
==[[OBD:OPge|OPge]]: objective page==
{{Template:XMLModdingHints}}
===general notes===
===general notes===
* '''OPge*.oni''' are level specific. (They can be found in edition/GameDataFolder/level''XX''_...)
* '''OPge*.oni''' are level specific. (They can be found in edition/GameDataFolder/level''XX''_...)
* Objective pages can be called via BSL command "objective_set ''page_number''" or "objective_set ''page_number'' silent".
* Objective pages can be called via BSL command "objective_set ''page_number''" or "objective_set ''page_number'' silent".


===XML structure===
===XML structure===
{{Template:XMLModdingHints}}
{| border=0 cellspacing=20 cellpadding=0 align=center
| The xml code on this page is compatible with onisplit '''v0.9.61.0'''
|}
Think of "instances" (#N) as file sections, they go from 1 to N. 0 is the header (it defines the file type, here "OPge").
Think of "instances" (#N) as file sections, they go from 1 to N. 0 is the header (it defines the file type, here "OPge").


Line 84: Line 84:


  <?xml version="1.0" encoding="utf-8"?>
  <?xml version="1.0" encoding="utf-8"?>
  <Oni Version="0.9.30.0">
  <Oni>
     <Instance id="0" type="OPge">
     <OPge id="0">
         <LevelNumber>21</LevelNumber>
         <LevelNumber>21</LevelNumber>
         <Pages>#1</Pages>
         <Pages>#1</Pages>
     </Instance>
     </OPge>
     <Instance id="1" type="IGPA">
     <IGPA id="1">
         <Pages>
         <Pages>
             <Link>#2</Link>
             <Link>#2</Link>
         </Pages>
         </Pages>
     </Instance>
     </IGPA>


You can display a little image if you use the image tag in the IGPG instance. (Either non-animated TXMP or [[PSpc]].)
You can display a little image if you use the image tag in the IGPG instance. (Either non-animated TXMP or [[PSpc]].)
Line 99: Line 99:
<Text2> is used for the hint field -- see screenshot ("page 1B - hint text").
<Text2> is used for the hint field -- see screenshot ("page 1B - hint text").


     <Instance id="2" type="IGPG">
     <IGPG id="2">
         <nowiki><Font></nowiki>
         <nowiki><Font></nowiki>
             <Family></Family>
             <Family></Family>
Line 110: Line 110:
         <Text1>#3</Text1>
         <Text1>#3</Text1>
         <Text2>#7</Text2>
         <Text2>#7</Text2>
     </Instance>
     </IGPG>


Instance number 5 has a space between the text tags (<Text> </Text>) to produce a new paragraph. The import ignores that so far but you can fix it by writing "<Text xml:space="preserve"> </Text>".
Instance #5 has a space between the text tags (<Text> </Text>) to produce a new paragraph. The import ignores that so far but you can fix it by writing "<Text xml:space="preserve"> </Text>".


     <Instance id="3" type="IGSA">
     <IGSA id="3">
         <Strings>
         <Strings>
             <Link>#4</Link>
             <Link>#4</Link>
Line 120: Line 120:
             <Link>#6</Link>
             <Link>#6</Link>
         </Strings>
         </Strings>
     </Instance>
     </IGSA>
     <Instance id="4" type="IGSt">
     <IGSt id="4">
         <nowiki><Font></nowiki>
         <nowiki><Font></nowiki>
             <Family></Family>
             <Family></Family>
Line 130: Line 130:
         <nowiki></Font></nowiki>
         <nowiki></Font></nowiki>
         <Text>page 1A - caption</Text>
         <Text>page 1A - caption</Text>
     </Instance>
     </IGSt>
     <Instance id="5" type="IGSt">
     <IGSt id="5">
         <nowiki><Font></nowiki>
         <nowiki><Font></nowiki>
             <Family></Family>
             <Family></Family>
Line 140: Line 140:
         <nowiki></Font></nowiki>
         <nowiki></Font></nowiki>
         <Text xml:space="preserve"> </Text>
         <Text xml:space="preserve"> </Text>
     </Instance>
     </IGSt>
     <Instance id="6" type="IGSt">
     <IGSt id="6">
         <nowiki><Font></nowiki>
         <nowiki><Font></nowiki>
             <Family></Family>
             <Family></Family>
Line 150: Line 150:
         <nowiki></Font></nowiki>
         <nowiki></Font></nowiki>
         <Text>page 1A - text</Text>
         <Text>page 1A - text</Text>
     </Instance>
     </IGSt>
     <Instance id="7" type="IGSA">
     <IGSA id="7">
         <Strings>
         <Strings>
             <Link>#8</Link>
             <Link>#8</Link>
         </Strings>
         </Strings>
     </Instance>
     </IGSA>
     <Instance id="8" type="IGSt">
     <IGSt id="8">
         <nowiki><Font></nowiki>
         <nowiki><Font></nowiki>
             <Family></Family>
             <Family></Family>
Line 165: Line 165:
         <nowiki></Font></nowiki>
         <nowiki></Font></nowiki>
         <Text>page 1B - hint text</Text>
         <Text>page 1B - hint text</Text>
     </Instance>
     </IGSt>
  </Oni>
  </Oni>

Revision as of 12:54, 7 April 2012

OPge: objective page

general notes

  • OPge*.oni are level specific. (They can be found in edition/GameDataFolder/levelXX_...)
  • Objective pages can be called via BSL command "objective_set page_number" or "objective_set page_number silent".

XML structure

Template:XMLModdingHints

The xml code on this page is compatible with onisplit v0.9.61.0

Think of "instances" (#N) as file sections, they go from 1 to N. 0 is the header (it defines the file type, here "OPge").

Every OPge contains one instance of type IGPA.
Every IGPA contains a number of instances of type IGPG.
Every IGPG contains a number of instances of type IGSA.
Every IGSA contains a number of instances of type IGSt.
IGPA means a page array (think of it as a little book)
IGPG means a page
IGSA means a (text) string array
IGSt means a (text) string
Take care of the structure and the cake is yours.


example on "OPgelevel_21.xml":

#0 (OPge instance) links to #1 (IGPA instance)
#1 (IGPA instance) links to #2 (IGPG instance)
#2 (IGPG instance) links to #3 and #7 (IGSA instances)
#3 (IGSA instance) links from #4 up to #6 (IGSt instances)
#7 (IGSA instance) links to #8 (IGSt instance)


XML tags and options

OPge instance tags

<LevelNumber> (the page won't show up if this tag has the wrong number)
<Pages> (link to IGPA instance)

IGPA instance tags

<Pages> (every link represents a page, be aware of it for BSL command "objective_set")
<Link> (links to an IGPG instance)

IGPG instance tags

<Font> (defines the font in case it isn't defined in the IGSt instance; the style is bold by default)
<Family>
TSFFTahoma
<Style>
Normal
Bold
Italic
<Color> (RGB range, e.g. <Color>255 0 77</Color>)
<Size> (10 and 12 are usually used)
<Image> (links to a TXMP or PSpc file)
<Text1> (links to an IGSA instance)
<Text2> (links to an IGSA instance (hint field))

IGSA instance tags

<Strings>
<Link> (links to an IGSt instance)

IGSt instance tags

<Font>
<Family>
TSFFTahoma
<Style>
Normal
Bold
Italic
<Color>
<Size>
<Flags> (Every IGSt can use own properties. The <Flag> tag let you enable these. Add "Size" when you want to get a new font size, add "Color" when you want to get a new font color, etc..)
Family
Style
Color
Size
<Text> (contains the actual text but can also create a bare paragraph (see example at instance #5))


example

OPge_preview.png
<?xml version="1.0" encoding="utf-8"?>
<Oni>
   <OPge id="0">
       <LevelNumber>21</LevelNumber>
       <Pages>#1</Pages>
   </OPge>
   <IGPA id="1">
       <Pages>
           <Link>#2</Link>
       </Pages>
   </IGPA>

You can display a little image if you use the image tag in the IGPG instance. (Either non-animated TXMP or PSpc.)

<Text2> is used for the hint field -- see screenshot ("page 1B - hint text").

   <IGPG id="2">
       <Font>
           <Family></Family>
           <Style>Normal</Style>
           <Color>0 0 0 0</Color>
           <Size>0</Size>
           <Flags></Flags>
       </Font>
       <Image>TXMPmc_big_ware_room</Image>
       <Text1>#3</Text1>
       <Text2>#7</Text2>
   </IGPG>

Instance #5 has a space between the text tags (<Text> </Text>) to produce a new paragraph. The import ignores that so far but you can fix it by writing "<Text xml:space="preserve"> </Text>".

   <IGSA id="3">
       <Strings>
           <Link>#4</Link>
           <Link>#5</Link>
           <Link>#6</Link>
       </Strings>
   </IGSA>
   <IGSt id="4">
       <Font>
           <Family></Family>
           <Style>Normal</Style>
           <Color>191 0 0</Color>
           <Size>0</Size>
           <Flags>Color</Flags>
       </Font>
       <Text>page 1A - caption</Text>
   </IGSt>
   <IGSt id="5">
       <Font>
           <Family></Family>
           <Style>Normal</Style>
           <Color>0 0 0 0</Color>
           <Size>0</Size>
           <Flags></Flags>
       </Font>
       <Text xml:space="preserve"> </Text>
   </IGSt>
   <IGSt id="6">
       <Font>
           <Family></Family>
           <Style>Normal</Style>
           <Color>0 0 0 0</Color>
           <Size>0</Size>
           <Flags>Style</Flags>
       </Font>
       <Text>page 1A - text</Text>
   </IGSt>
   <IGSA id="7">
       <Strings>
           <Link>#8</Link>
       </Strings>
   </IGSA>
   <IGSt id="8">
       <Font>
           <Family></Family>
           <Style>Normal</Style>
           <Color>0 0 0 0</Color>
           <Size>0</Size>
           <Flags>Style</Flags>
       </Font>
       <Text>page 1B - hint text</Text>
   </IGSt>
</Oni>