XML:TXMP: Difference between revisions

==General notes==

* The XML on this page was tested with OniSplit '''v0.9.61.0'''.

* Textures' X and Y dimensions must be powers of two: 512, 256, 128, 64, etc. (The TXMPs used to compose [[XML:TXMB|TXMBs]] seem to be an exception.)

** However the height and width don't need to be equal, e.g. you can use 128x256.

* The camera can look at 2049 transparent textures at once; one more, and Oni crashes.

==TXMP subtypes==

! Standard texture

! Animated texture

! Reflective texture

!width=120px| Content type

! Description

[[Image:problems_with_AdditiveBlend_and_regular_transparency.jpg|thumb|200px|right|Be careful with transparent textures.]]

: AnimUseLocalTime (to export an animated texture, extract the .oni file as XML)

: HasEnvMap (don't use directly; used via tag)

: SwapBytes (defunct; this is automatically added in v0.9.56.0 and above, so you won't see the flag in an exported)

| '''A'''RGB formats are used for reflective textures (Alpha Red Green Blue)

ARGB8888 can be used only if you use an updated engine (which comes with the AE). (When Macs were still on the PowerPC processor, Oni's textures needed to have [http://oni.bungie.org/forum/viewtopic.php?pid=29967#p29967 their color channels swapped] or else they would appear color-inverted, but after the move to Intel Macs, both platforms used the same Windows-format textures.)

!colspan=2|<font color="#999999">Options for command line argument "-format:"</font>

|Up to OniSplit v0.9.52.0

|For higher versions

|<font color="#999999">Up to OniSplit v0.9.52.0</font>

|<font color="#999999">For higher versions</font>

| This tag is used if the XML file is meant to create an animated texture. In that case you would use multiple <Image> tags.

Let's say Speed is set to 7 — then the animation will advance every 7th frame.

This tag is used if the XML file is meant to create a reflective texture. File suffixes like .tga or .oni are not used in the EnvMap link.

Creating a texture from a JPEG, PNG or DDS is only supported via the command line's "-create:txmp" argument.

It's tiresome to manually create an XML file with a large number of <Image> tags. Skip that work by using [http://paradox.oni2.net/programs/Simple_OniSplit_GUI.zip Simple OniSplit GUI]. (Normal TXMP creation is also supported.)

# Long animations in high quality (512x512, RGB) produce VERY big .oni files. The source billboard GIF is 1.7MB and the resulting .oni file is 273MB. That's because TXAN doesn't support variable timing like the GIF format, so a smooth animation like this one will have a ton of duplicate frames in it. Even as a ZIP, the .oni file was still 66MB, which is unreasonably large. The billboard could possibly be broken into 3 static and 3 transitional images, and then animated "manually" via a [[XML:ONLV#Texture_exchange|BSL loop]]. The conclusion is to use animated images with lower quality settings and to avoid long periods of duplicate frames which waste space.