P3D Named Selections

From Bohemia Interactive Community
Revision as of 01:15, 14 May 2010 by Mikero (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Template:unsupported-doc

Intro

currently a place holder until this is better organised

MLOD

Named Selections are contained in the Taggs structure in MLOD file format

struct structTag_SelectedWeighted { TinyBool Active; //Always true asciiz "<Any Ascii Characters>\0"; ulong NoOfBytes; //eg. Will always be NoOfPoints + NoOfFaces byte[NoOfPoints] SelectedWeightedPoints; byte[NoOfFaces] SelectedFaces; }

NB: The byte array's indicate a zero-based offset into the corresponding Points & Faces structures.

To clarify, the purpose of this 'chunk' is to denote which points & faces belong to a given 'Named Selection' and also to denote the 'per-point-weight' associated with this selection.

Each byte in the SelectedWeightedPoints array denotes a value 0 to 255 (0 to FF hex).

And, serves a dual purpose in...

1. Denoting the selectedness and
2. Denoting per point weighting.


  • Zero (0) or 0x00 hex indicates the corresponding point in the LODs Points array is not selected.
Any value other than zero indicates that the point is not only part of the selection but also has a weighting value.


  • One (1) or 0x01 hex indicates the corresponding point in the LODs Points array is selected and has 100% weighting.
Every value between 2 and 255 (0x02 to 0xFF hex) indicates the percentage weight of the corresponding point and that it is part of the selection.
Two (2) being almost 100% weighted and 255 being almost 0% weighted.


Following is some appropriate pseudo-code to illustrate.

byte2weight

float32 byte2weight = (256 - weight)/255; if (byte2weight > 1.0) then byte2weight = 0; Where 'weight' is a unit8 (single byte) in the range... 0 >= weight <= 255 or 0x00 >= weight <= 0xFF.

weight2byte

unit8 weight2byte = round(256 - (255 x weight),0); if (weight2byte == 256) then weight2byte = 0; Where 'weight' is a float32 in the range... 0.0 >= weight <= 1.0.

ODOL

All arrays are subject to the 1024 rule. Which type of compression depends on odol version

  • ODOL7 and ODOL40: LZSS compressed
  • Arma2: LZO compressed.

ODOL7

NamedSelection
{
 asciiz NamedSelectionName;
 ulong  Count;
 ushort Vertices[Count];
 ulong  Count;  
 ushort Unknown[Count];
 ulong  Count; 
 ulong  Unknown[Count];
 byte   IsSectional; 
 ulong  Count; 
 ulong  Unknown[Count];
 ulong  Count;  
 ushort Faces[Count];
 ulong  Count;       
 byte   TextureWeights[Count];//probably
};

ODOL4x

 LodNamedSelection
 {
   asciiz      NamedSelectionName;                          // "rightleg" or "neck" eg
   ulong       NoOfSelectedFaces;
   ushort      SelectedFaceIndexes[NoOfSelectedFaces];
   ulong       Always0Count;
   unknownType Array[Always0Count]
   tbool       IsSectional;                                 //Appears in the sections[]= list of a model.cfg
   ulong       NoOfUlongs;
   ulong       UnknownArray[NoOfUlongs];                    // compression. none seen so far
   ulong       nSelectedVertices;
   ushort      SelectedVerticesIndexes[nSelectedVertices];
   ulong       nTextureWeights;
   byte        SelectedVerticesWeights[nTextureWeights];
 }