XML:FILM: Difference between revisions

← Older edit

XML:FILM (view source)

Revision as of 19:19, 14 November 2023

1,152 bytes added , 14 November 2023

m

no edit summary

Paradox-01

8,464

edits

@@ Line 1: / Line 1: @@
-==FILM: animation playbacks==
+{{XML_File_Header | prev=DPge | type=FILM | next=HPge | name=Film}}
-{{Template:XMLModdingHints}}
-{| border=0 cellspacing=20 cellpadding=0 align=center
-| The xml code on this page is compatible with onisplit '''v0.9.61.0''' and '''v0.9.68.0'''
-|}
+==General information==
+* The XML code on this page is compatible with OniSplit '''v0.9.61.0''' and '''v0.9.68.0'''.
+* FILM*.oni files are level-specific (they are usually used in cutscenes and can be found in level''X''_Final).
+* For best results (esp. for running and jumping), use the same character for recording and playing the FILM files.
+* Holster and unholster is the same key event, so make sure the character has their weapon holstered/unholstered as you planned or it will affect their ability to sprint.
+* The tags below have their values in radians. [http://www.unitconversion.org/angle/radians-to-degrees-conversion.html THIS] page can convert radians to degrees and vice versa.
+: <Facing>
+: <DesiredFacing>
+: <HeadFacing>
+: <HeadPitch>
-===general information===
+==BSL support==
-* FILM*.oni are level specific (they are usually used in cutscenes and can be found in level''XX''_...)
-* for best results (esp. for run and jump) use same character for recording and playing the FILM files
-* holster and unholster is same key event, make sure character has (un)holstered weapon as you planed, else it can affect sprint
-===BSL support===
   playback ''ai_name FILM_name''
   playback ''script_id FILM_name''
+==How to make your own FILM==
-===How to make an own FILM===
+* They will be saved next to the running game application. The first file will be named "saved_film000.dat".
-* They become stored in Oni/edition folder. First file is named "saved_film000.dat"
+* Enter [[Developer Mode]] to record a FILM.
-* Enter [[Developer_Mode|Developer Mode]] to record a FILM.
 : F9 - start record
 : F10 - stop record
 : F11 - play record
 ===FILM converting===
-: for original FILM*oni to FILM*.xml
+Converting FILM*oni to FILM*.xml:<br>
   onisplit -extract:xml xml_dir level''XX_name''/FILM*.oni
-: for new saved_film*.dat to saved_film*.xml
+Converting saved_film*.dat to saved_film*.xml:<br>
   onisplit film2xml xml_dir source_dir/saved_film*.dat
-: for converting original/new *.xml to *oni
+Converting *.xml to *oni:<br>
   onisplit -create oni_dir xml_dir/*.xml
+==<Keys>==
-===<Keys>===
 : None
 : Escape
@@ Line 74: / Line 72: @@
 : Fire3
+==Sample XML==
-===sample piece===
+"[...]" below stands for additional <FILMFrame>...</FILMFrame> blocks.
-[...] stands for another <FILMFrame>...</FILMFrame> code block
   <?xml version="1.0" encoding="utf-8"?>
@@ Line 101: / Line 98: @@
      </Instance>
   </Oni>
+==Frame structures==
+FILM allows two structures for <Frames>.
+===Fixed structure===
+There are always 4 elements within <FILMFrame>.
+            <FILMFrame>
+                <MouseDeltaX>0</MouseDeltaX>
+                <MouseDeltaY>0</MouseDeltaY>
+                <Keys></Keys>
+                <Frame>0</Frame>
+            </FILMFrame>
+===Modular structure===
+There can be one up to three elements.
+<nowiki><Time></nowiki> is used instead of <Frame>.
+<MouseDelta> is an array of X and Y.
+            <Frame>
+                <nowiki><Time>0</Time></nowiki>
+            </Frame>
+            <Frame>
+                <nowiki><Time>25</Time></nowiki>
+                <MouseDelta>0.25 0</MouseDelta>
+            </Frame>
+            <Frame>
+                <nowiki><Time>223</Time></nowiki>
+                <MouseDelta>0 -0.25</MouseDelta>
+                <Keys>Forward</Keys>
+            </Frame>
+{{XML}}