OniGalore

XML:OPge: Difference between revisions

XML Discussion

XML:OPge (view source)

Revision as of 14:43, 31 March 2021

286 bytes removed ,  31 March 2021
m
link fix
mNo edit summary
m (link fix)
 
(10 intermediate revisions by 2 users not shown)
Line 1: Line 1:
==[[OBD:OPge|OPge]]: objective page==
{{XML_File_Header | prev=ONWC | type=OPge | next=PNTA | name=Objective Page}}


{{Template:XMLModdingHints}}
==General notes==
* The XML on this page is compatible with OniSplit '''v0.9.61.0'''.
* '''OPge*.oni''' files are level-specific (they can be found in AE/AEInstaller/vanilla/level'''X'''_Final.dat).
* Objective pages can be called via the BSL command "objective_set ''page_number''" or "objective_set ''page_number'' silent".


===general notes===
==XML structure==
* '''OPge*.oni''' are level specific. (They can be found in edition/GameDataFolder/level''XX''_...)
Think of "instances" (#N) as file sections; they go from 1 to N. 0 is the header (it defines the file type, here "OPge").
* Objective pages can be called via BSL command "objective_set ''page_number''" or "objective_set ''page_number'' silent".
 
 
===XML structure===
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 OPge contains one instance of type IGPA.
Line 16: Line 14:
: Every IGSA contains a number of instances of type IGSt.
: Every IGSA contains a number of instances of type IGSt.


: IGPA means a page array (think of it as a little book)
: IGPA means a page array (think of it as a little book).
: IGPG means a page
: IGPG means a page.
: IGSA means a (text) string array
: IGSA means a (text) string array.
: IGSt means a (text) string
: IGSt means a (text) string.
 
:Take care of the structure and the cake is yours.


:Be mindful of the structure and it's a piece of cake.


example on "OPgelevel_21.xml":
Example from "OPgelevel_21.xml":


: #0  (OPge instance) links to #1 (IGPA instance)
: #0  (OPge instance) links to #1 (IGPA instance)
Line 31: Line 28:
: #3  (IGSA instance) links from #4 up to #6 (IGSt instances)
: #3  (IGSA instance) links from #4 up to #6 (IGSt instances)
: #7  (IGSA instance) links to #8 (IGSt instance)
: #7  (IGSA instance) links to #8 (IGSt instance)


===XML tags and options===
===XML tags and options===
Line 50: Line 46:
::: '''Bold'''
::: '''Bold'''
::: ''Italic''
::: ''Italic''
:: <Color> ([[wikipedia:RGB_color_model#The_24-bit_RGB_representation|RGB]] range, e.g. <Color>255 0 77</Color>)
:: <Color> ([[wikipedia:RGB_color_model#Numeric_representations|RGB]] range, e.g. <Color>255 0 77</Color>)
:: <Size> (10 and 12 are usually used)
:: <Size> (10 and 12 are usually used)
: <Image> (links to a TXMP or PSpc file)
: <Image> (links to a TXMP or PSpc file)
Line 70: Line 66:
:: <Color>
:: <Color>
:: <Size>
:: <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..)
:: <Flags> (Every IGSt can have its 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.)
::: <font style="color:#777">Family</font>
::: <font style="color:#777">Family</font>
::: Style
::: Style
::: Color
::: Color
::: Size
::: Size
:: <Text> (contains the actual text but can also create a bare paragraph (see example at instance #5))
:: <Text> (Contains the actual text, but can also create a bare paragraph (see example at instance #5))


 
===Example===
===example===
[[Image:XML_OPge_modded.jpg|400px|right|thumb]]
{| border=0 cellspacing=20 cellpadding=0 align=right
| [http://i305.photobucket.com/albums/nn207/unknownfuture/Oni_Galore_Images/XML_modding/OPge.png http://i305.photobucket.com/albums/nn207/unknownfuture/Oni_Galore_Images/XML_modding/OPge_preview.png]
|}


  <?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 small image if you use the <Image> tag in the IGPG instance. (Either non-animated TXMP or [[XML:PSpc|PSpc]].)


<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 103:
         <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. OniSplit's import ignores that currently, 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 113:
             <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 123:
         <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 133:
         <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 143:
         <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 158:
         <nowiki></Font></nowiki>
         <nowiki></Font></nowiki>
         <Text>page 1B - hint text</Text>
         <Text>page 1B - hint text</Text>
     </Instance>
     </IGSt>
  </Oni>
  </Oni>
{{XML}}
Retrieved from "https://wiki.oni2.net/Special:MobileDiff/18481...32963"