P3D Model Info

From Bohemia Interactive Community
Revision as of 03:12, 22 May 2010 by Mikero (talk | contribs) (→‎Model Info: additonal unknown bytes in V7)
Jump to navigation Jump to search

Template:unsupported-doc

Model Info

The Model Info structure is last in file for ODOL7 (ofp) and at top of file for ODOL4x (ARMAx)

ModelInfo
{
  float      LodTypes[Header.NoOfLods];// alias resolutions
  ulong      Index;                    // appears to be a bit flag, 512, 256 eg
  float      Sphere1;
  float      Sphere2;                  // mostly same as Sphere1
  ulong      PointFlags[3];            // typically 00 00 00 00  00 00 00 00 00 00 0C 00 eg (last is same as user point flags)
  XYZTriplet Offset;                   // model offset (unknown functionality),//mostly same as offset2
  ulong      mapIconColor;             // RGBA 32 color
  ulong      mapSelectedColor;         // RGBA 32 color
  float      ViewDensity;              //
  XYZTriplet bboxMinPosition;          // minimum coordinates of bounding box
  XYZTriplet bboxMaxPosition;          // maximum coordinates of bounding box. Generally the complement of the 1st
                                       // Resolution&GeometryBounds in Pew is bboxMinPosition-bboxMaxPosition for X and Z
  XYZTriplet WrpModelOffset;           // Resolution&GeometryAutoCenterPos in pew
  XYZTriplet Offset2;                  // mostly same as Offset often same as ModelCentreOfGravity
  XYZTriplet ModelCentreOfGravity;     //
  XYZTriplet ModelMassVectors[3];      // for ODOL7 this is a mixture of floats and index values
  TinyBool   AutoCenter,
             lockAutoCenter,
             canOcclude,
             canBeOccluded,
             allowAnimation;
  ///////////ARMA (V4x) ONLY ////////////
  bytes      UnknownARMAFlags[6];      //
  byte       ThermalProfile[24];       // Arma2 only (43,47,48 & VBS2)
  ulong      UnknownLong;              // V48 only
  Skeleton   Skeleton;                 //
  ///////////////////////////////////////
  byte       UnknownByte;
  ulong      nFloats;                  // always zero for arma
  float      UnknownFloats[nFloats];   // potentially compressed
  float      Mass;                     
  /////// ODOLV7 BIS ////////////////////
  float      MassReciprocal;           //
  float      AltMass;                  //
  float      AltMassReciprocal;        //
  byte       UnknownByteIndices[12]    // generally FF FF FF FF FF FF FF FF FF FF FF FF
  ///////////ARMA (V4x) ONLY ////////////
  ulong      UnknownLong;              // often same as lodcount
  TinyBool   UnknownBool;              // generally set if ascii below has strings
  asciiz     ClassType;                // class="" or "House" or...
  asciiz     DestructType;             // damage="" or "Tent" or "Building",,,,
  TinyBool   UnknownBool2;             // rarely true
  ulong      Always0;                  //
  ///////////////////////////////////////
}

ODOLV7 BIS

This area of 24 bytes is, as represented in the supplied, 'official' addons from Bis and the various games (cwc thru to resistance)

MOST oem addons subscribe to above.

SOME oem addons, notably those from VTE, and any with optics, have a varying amount of data after the Mass float. Some less than 24, some, a lot more than 24. CLearly this area needs further work. The models themselves are unlikely to be faulty, and were generated by O2L. There is nothing in previous data structures that would suggest appended or truncated data. Perhaps, like it's MLOD-SP3X equivalent, it has a default file size, and anything 'extra', is tested for.


Skeleton

 Skeleton
 {
   asciiz                    SkeletonName;  //"A10Skeleton"
   if (SkeletonName != null)
   {
     tbool                   isInherited;
     ulong                   NoOfBoneNames;
     SkeletonBoneName        SkeletonBoneNames[NoOfBoneNames];
     if (type>40 && ! VBS2) // ie arma2
     {
     byte                    Always0;
     }
   }
 }

SkeletonBoneName

 SkeletonBoneName
 {
   asciiz BoneName;            //"3dhud" or "Gearlocks" or "Fuel" or ...
   asciiz ParentBoneName;      // "Aeileron_1"
 }

corresponds to model.cfg

 class cfgSkeletons
 {
	class SkeletonClassname: Default
	{
		skeletonBones[]=
		{
			"RightDoor1","",
			"RightDoor2","",
			"LeftDoor1","",
			"LeftDoor2","RightDoor2",
			etc"
		};
	};

LodTypes

LodTypes are resolutions. Most of them have humanly readable context such as the 'memory' lod. And are selected as such in Oxygen. The are consequently referred to here as 'LodTypes', since the floating point values, although relevant to the engine, are not as immediately apparent to a human.

  • Lods in the file are highest to lowest. The lowest resolution (eg. Resolution 1.0) will be the last in the file.
  • Start and ending addresses are random (not sorted). The LodTypes array declares which Lod an address-pair is referring to.

Thus, if the first Lodtype entry(eg) specifies a resolution of 1.0e13 (a geometry lod), that lod is located via the 1st Starting address. It is NOT, necessarily, the 1st lod in the file.


Resolution Values

Hex Float Decimal Description
<1,000 Graphical Lod
Functional Lods
0x447a0000 1.0e3 1,000 View Gunner
0x44898000 1.1e3 1,100 View Pilot
0x44960000 1.2e3 1,200 View Cargo
"" "" Shadow Lods
0x461c4000 1.0e4 10,000 Stencil Shadow
0x461c6800 1.001e4 10,010 Stencil Shadow 2
0x462be000 1.1e4 11000 Shadow Volume
0x462c0800 1.101e4 11010 Shadow Volume 2
0x551184e7 1.0e13 10,000,000,000,000 Geometry
0x58635fa9 1.0e15 1,000,000,000,000,000 Memory
0x58e35fa9 2.0e15 2,000,000,000,000,000 Land Contact
0x592a87bf 3.0e15 3,000,000,000,000,000 Roadway
0x59635fa9 4.0e15 4,000,000,000,000,000 Paths
0x598e1bca 5.0e15 5,000,000,000,000,000 HitPoints
0x59aa87bf 6.0e15 6,000,000,000,000,000 View Geometry
0x59c6f3b4 7.0e15 7,000,000,000,000,000 Fire Geometry
0x59e35fa9 8.0e15 8,000,000,000,000,000 View Cargo Geometry
0x59ffcb9e 9.0e15 9,000,000,000,000,000 View Cargo Fire Geometry
0x5a0e1bca 1.0e16 10,000,000,000,000,000 View Commander
0x5a1c51c4 1.1e16 11,000,000,000,000,000 View Commander Geometry
0x5a2a87bf 1.2e16 12,000,000,000,000,000 View Commander Fire Geometry
0x5a38bdb9 1.3e16 13,000,000,000,000,000 View Pilot Geometry
0x5a46f3b4 1.4e16 14,000,000,000,000,000 View Pilot Fire Geometry
0x5a5529af 1.5e16 15,000,000,000,000,000 View Gunner Geometry
0x5a635fa9 1.6e16 16,000,000,000,000,000 View Gunner Fire Geometry
0x5a7195a4 1.7e16 17,000,000,000,000,000 Sub Parts


If the value is below 1000.0, then the LOD is supposed to be a graphical LOD. If the value equals or is above 10000.0 and is not one of the functional LODs, it is a shadow LOD.

The LOD selected for displaying if

DistanceToObject * LODCoef * M <= LODResolution 

Where:

  • LODCoef is value from OFP preferences (I have LODCoef = 0.019).
  • M is some value that changed by OFP developers (I use M=1 in WRPEdit and M=2 in P3DEdit).

Related Page(s)

Model File Formats