XML:TRAM: Difference between revisions

TRAM files can be extracted '''A) as pure xml''' files or combined '''B) as xml and dae''' files.

 

For editing the actual animation you will want to use method B.

 

While doing the export with ONCC you might see errors such as

Ignore them, those files doesn't exist.

 

(Someday we should remove them from TRAC.)

 

for single file export

for merged file export

<!--[[Image:Vago_xml_plus_dae_extraction.png|thumb|200px|right|combined extraction of dae and xml]]-->

When you start '''[[Vago_(tool)|Vago]]''' the "General" tab should be open by default. If not click on it. Then follow the five easy steps.

'''Step 1:''' Select "ONI" as ("From") input format.

'''Step 2:''' Select "XML" as ("To") output format.

'''Step 4:''' Click on "Add" button to chose an ONCC file.

 

'''Step 5:''' Click on "Convert".

There was a long standing problem with ONCC-TRAM-combined files whereby the textures will be missing.<br>With an older method you couldn't export non-native TRAM which meant to the TRAM had to be registered in the TRAC the ONCC is using.

 

'''[http://www.paradox.oni2.net/programs/Simple_OniSplit_GUI.zip Simple OniSplit GUI]''' post-edits the dae to fix the missing textures. The character related oni files must be all in one folder. Usually level0_Final folder does the trick.

'''Step 1:''' Drag and drop TRAM and ONCC into the [http://www.paradox.oni2.net/images/simpleOniSplitGui.png big field.] (One by one. Or simultaneously. The order doesn't matter.)

 

You can load the dae file into an compatible editor. So far the community's favorite is Mod Tool.

* For correct Mod Tool settings look [[Mod Tool#Animating|HERE]]

* Tutorial: <font style="color:#777777">basics of Oni animation editing</font> (todo)

 

====Total new animations====

   +-- additional data: positions, throw adjustments, selfdamage, attack parts, extents

 

: Somtimes FromState is set to None; in another scenarios one FromState possibility is not enough.

:: In those cases Shortcuts are used. They extent the number from what state the animation can be played and under what conditions (replace atomic yes/no).

| "<Varient />" if unused. E.g. that's the case for non-combat animations.

|

:::(this bit is not animation related, it is used at runtime to mark that the animation was loaded)

:::while playing this animation user is invulnerable to melee damage AND cannot be thrown, PAR3/height still hurts him

:::if set then while playing this animation user can block high or undefined attacks within some arc which is '''before''' him, so if you set this to some animation where user spins, then he can still be legaly kicked to the @$$ and he can be thrown

:::same as before only it can block low or undefined attacks

:::animations with attack part have it, unknown what it does, IMO it turns on soft lock (characters turns with animation a bit in order to hit nearby enemy), but didn't checked

:::if user is armed, he drops weapon when he plays this animation

:::something with jumps, didn't checked

:::whole animation must be played, user cannot interrupt it once it starts

:::cannot turn by mouse while performing this animation  

:::unknown, looks like this is rough info for AI2 about where attack aims from user's point of view -[[User:Loser|Loser]]

:::same as above

:::same as above

:::these are not standalone animations, they just overwrite part of already playing one, for example holstering weapon is such an animation

:::unknown, but maybe it has something to do with X,Y,Z velocities and fact that for example directional jumps take info about direction vector from X-Z velocity part of TRAM (Y vector is in ONCC)

:::unknown, throws use it

:::if set, then animation can hurt anybody, with its attack part, including teammates. User of TRAM can even hurt himself with "damage part" (user cannot hurt himself with own attack parts). It also allows two (try more, get crash ^_^) attack parts to be executed instead of only one (maybe bug?).

::::-If you set first attack part to be able to deal damage from 1st to 100th frame of TRAM, and second attack part to deal damage within that limit (e.g. from 25th to 41st frame, it can be again from 1 to 100), than first attack part an hurt from 1st to 100th (as usual), but even if it hits, that second one attack part (25th to 41st) can hurt enemy as well during "its lifetime". So two attack parts are allowed to execute. Note that second attack part MUST be executed while first attack part has active "window", otherwise it won't work.

:::It appears this flag was used to create TRAM and OBAN from one animation source. The OBAN is supposed to store pelvis rotations and positions because that way a character can move over obstacles/gaps. The very most of them are used in cutscenes.

:::forces aim animation (PIS/RIF) if user has weapon

:::forces not to aim

:::can pickup items in this animations, not like it plays pickup one, but like it "takes" the item if you have this animation on and you collide with item.

:::unknown

:::if user had active supershield (chr_super "name" 1), this forces him to disable it (chr_super "name" 0) -[[User:Loser|Loser]]

:::AI2 are not permitted to pick up items with this animations

| "<UsedBones />" if unsued.

| "<ReplacedBones />" if unused.

| final rotation in degrees

| "<Impact />" if unsued.

| <font color="#777777">OSBD</font>file<font color="#777777">.imp.oni</font> <font color="#777777">(don't use file prefix/suffix)</font>

| the frame when the sound starts to play

| absolute position

| relative positions

| There are 19 bone tags. One for each [[TRIA#Bones|body part]].

| for normal animations. The first value specifies the frames number for which the rotation applies, the sum of all of these first numbers for all the EKey elements always equals to the total number of frames for the animation.

| for overlay animations used by [[TRAS|TRAS]]

onisplit v0.9.54.0 produces <QKeys> (quaternions) instead of (euler rotations) <EKey> for normal animations

| <PositionOffset> and <Positions> belong together. In the [[OBD:TRAM/raw0x30|binaries]] they are written in the place.

: "fw" = face to face throw

: "throw" inside TRAM names are sometimes shortened with "thr"

: "p" can also be missing

| damage taken by character

| frame of the animation, when damage is dealt

| Only 2 attack parts per file are allowed. Normally the target gets only one hit. But if the attack frames of both attack parts are overlapping then the target can be [http://oni.bungie.org/community/forum/viewtopic.php?pid=39787#p39787 hit by both of them].

| First frame where damage can be inflicted to an opponent.

| Last frame where damage can be inflicted to an opponent.

| Set here the bones that can inflict damage.

: Low - blocker needs to crouch

: High - blocker needs to stand; if Low and High are set then blocker can block from stand and crouch

: HalfDamage - the blocker gets half of the damage

| Target gets knockbacked by this amount.

| damage points

| Animation type for opponent's animation when attack isn't blocked.

| Number of frames for how long should blocking char remain in hit anim when he gots hit.

| Number in frames for how long should blocking char remain in blocking animation.

| Number of frames for how long should blocking char perform stagger anim after sucessful block.

| Gets calculated by onisplit if there's a dae file referenced in xml.

| One tag per frame. In numbers: attack end - attack start + 1. (E.g. start=5; end=6; it makes 2 involved frames.)

| In degree.

| Contains always 36 <Length> tags, no more, no less. Gets calculated by onisplit if there's a dae file referenced in xml. (The AttackRing was formerly know as horizontal extents.)

| Horizontal extents in 10° intervals. They make a ''zone of danger'' so the AI knows that the animation is harmful there. (It give them the chance to dogde an attack.)

Ever wondered how comes Artificial Intelligence can recognize incoming attack and block or dodge? Extents ( found out by Geyser and fully uncovered by Neo ) are the key.

There are two types of extents -

*'''<Extents>''', its packages store this info:

::<Angle> at which is this extent radiated from character. 0° is in front of character, 180° is in the back

::<Length> of this extent,

::<MinY> minimal height of this extent

::<MaxY> maximal height of this extent

:Length, MinY and MaxY serve for creating invisible area in space which is "dangerous to be in". If AI collides and notices it (refer to notice field in [[MELE]]), it will attempt to block or dodge according to its modifiers in given MELE profile. Again, see fields in [[MELE]].

::: Number of <Extent> is equal to attack frames: <End> minus <Start> plus one (because start frame counts too).

:::: (e.g. TRAMKONCOMkick_low1: <End>30</End> minus <Start>22</Start> plus one = nine <Extent>.)

 

 

 

 

 

Open the xml formated TRAM and search for the "Particles" tag and insert your code.

"contrail" is looked up by the used character class (ONCC) which lunch the actual particle, here it is "h2h_strtrail_e01".

 

Second example is about two different contrails in one TRAM at same time. The animation is "TRAMSTRCOMpunch_heavy.xml".

Note that you need to register the second contrail in the used ONCC as well. Using your own contrail particle is also possible, just insert it's name between the <Type> tags.

:5. If you need this information for a patch mod, run "-extract:xml" on the TRAMsomething.oni you've created, <u>without</u> using "-anim-body". Now you can copy the Extents and AttackRing data to your XML patch. For an example of how the patch should look, see the Domino Knockdowns mod.

 

Throws target animation are registered in the TRAC of the throw initiator (a.k.a. throw source). Target animations are forced onto the other character removing the need to have that animation in target TRAC.

 

Throw target (TRAM*tgt) animations can cover only up to 256 (0-255) frames.

 

 

Situation: you load two chars into Mod Tools and rotate (+/-180°) the throw target char because you want them to stand face to face. When you are done animating, the target animation would need to be reversed again: multiplying the velocities with -1, also the rotation needs a tweak. So far it looks like you need *(-1) for the x rotation and -/+180° (depending on your initial change) for the y rotation.

===Excel macro to tweak fw throws===

* put your files into the "input_and_output" folder

* disable macro security if you don't want to click every time on the macro option button

* close other worksheets first before you run the macro

* if you are not afraid of VBA code you can enter the developer environment by hitting [alt]+[F11], e.g. for extending the attack library with more screenshots and settings

** in that case search for: "LibraryThrows", " LibraryAttack", "Picture", "CBAttackHelp.AddItem"

* [http://dl.dropbox.com/u/139715/OniGalore/TRAM_macro.zip the macro] (for all TRAM except overlay-TRAM), [http://youtu.be/wxzJ8ahjP8k demo vid]

 

==A look on run move complex==

Example on Striker's moves, meant as illustration for "what would be needed for new run trams".

 

 

Run - ''a minimal cycle'':

Start looking on the image most right.

* KONOKOconsole_punch           what the name says (the engine can use that animation depending on the console's configuration, see [[OBD:BINA/OBJC/CONS|CONS]])  

* KONOKOlev3_intro looks like she was placing something (bomb?) and then running away

* KONOKOlev4_undress from an official aborted cutscene

* KONOKOlev16_bomb             planting a bomb

* KONCOMsuper_kick now used in OTA scripts (mod) as spawn event

* KONCOMsuper_punch KONCOMpunch_heavy but without ''attack name shout'', HalfDamage, and makes 10 less damage in first attack part

* COMPISidle_special1 comguy checking environment and his gun (it's actually used if you wait long enough, isn't it?)

* STRPISidle_special1 striker showing off his gun, whatever (it's actually used if you wait long enough, isn't it?)

* THUGlev1_direct thug probably directing a truck driver

Following files are available in DAE (and maybe ONI format).

** note: prone mode artefact

* [https://www.dropbox.com/s/luf7ayqikcuupo7/female_stun--dae.zip?dl=0 female stun (throw pair)] (.dae)

** note: needs to be slowed down (-> more frames)