PEW File Format

From Bohemia Interactive Community
Jump to navigation Jump to search

Template:unsupported-doc

Introduction

To do...

Legend

Type Description
byte 8 bit (1 byte)
short 16 bit signed short (2 bytes)
int 32 bit signed integer (4 bytes)
float 32 bit signed single precision floating point value (4 bytes)
asciiz Null terminated (0x00) variable length ascii string
ascii fixed length ascii string

Although technically there should never be negetive values for many of the 16 bit & 32 bit values, it's 'safer' in programming terms to use signed datatypes as opposed to unsigned datatypes.


File Format

The following is a mix of pseudo-code and structure references that could be used to describe the file format of POSEW60.pew project design file.
Any naming definitions or naming conventions used may or may not be accurate.
  • This file format is principally used with Armed Assault v1.09 and later plus the ArmA Tools Suite Final release (v1.14).

POSEW60 { structHeader Header; int NoOfObjectTypes; structObjectType[NoOfObjectTypes] ObjectTypes; short Unknown; short Unknown; short RoadNetworkTypesIndicator; if(RoadNetworkTypesIndicator == 0) { int NoOfRoadNetworkTypes; structRoadNetworkType[NoOfRoadNetworkTypes] RoadNetworkTypes; int Unknown; } int TerrainGrid_X; int TerrainGrid_Z; float[TerrainGrid_Z,TerrainGrid_X] TerrainGridHeights; int NoOfBlueFloats = (TerrainGrid_X / 16) * TerrainGrid_X; float[NoOfBlueFloats] BlueEdgeTerrainHeights; //Always zero values. int Unknown; int NoOfObjects; if (NoOfObjects != 0) { structObject[NoOfObjects] Objects; while (i < NoOfObjects) { short Indicator; if (Indicator != 0) { short Unknown; int InstanceId; float TransformColumn_1_Row_1; // described here to solidly illustrate to reader float TransformColumn_1_Row_2; // this is a standard DirectX Transform matrix float TransformColumn_1_Row_3; // but in COLUMN format; float TransformColumn_2_Row_1; float TransformColumn_2_Row_2; float TransformColumn_2_Row_3; float TransformColumn_3_Row_1; float TransformColumn_3_Row_2; float TransformColumn_3_Row_3; float Unknown; float Unknown; int NoOfCharsInInstanceName; ascii[NoOfCharsInInstanceName] InstanceName; float RelativeSurfaceElevation; byte[4] OutlineColour; // rgba 0xFFFF FFFF means 'default' byte[4] ObjectColour; // rgba 0xFFFF FFFF means 'default' int ObjectTypeId; } } } int NoOfLayers; structLayer[NoOfLayers] Layers; }


Structures

structLayer

struct structLayer { int NoOfCharsInLayerName1; ascii[NoOfCharsInLayerName1] LayerName1; int LayerSizeType; int NoOfCharsInLayerName2; ascii[NoOfCharsInLayerName2] LayerName2; short DefaultIndicator; int NoOfTerrainMaterials; if (NoOfTerrainMaterials != 0) { structTerrainMaterial[NoOfTerrainMaterials] TerrainMaterials; } }


structTerrainMaterial

struct structTerrainMaterial { int Unknown; int NoOfCharsInMaterialName; ascii[NoOfCharsInMaterialName] MaterialName; int Unknown; }



structObjectType

struct structObjectType { int NoOfCharsInObjectModelFilename; ascii[NoOfCharsInObjectModelFilename] ModelFilename; int NoOfCharsInObjectName; ascii[NoOfCharsInObjectName] ObjectTypeName; int ObjectClassId; byte[4] OutlineColour; // rgba 0xFFFF FFFF means 'default' byte[4] ObjectColour; // rgba 0xFFFF FFFF means 'default' switch (ObjectClassId) { case ObjectClassEnum.Natural // 1 { byte[118] VariousInfo; } case ObjectClassEnum.Artificial // 2 { byte[118] VariousInfo; } case ObjectClassEnum.Road // 3 { byte[214] VariousInfo; } } int NoOfArtificialSubObjects; if (NoOfArtificialSubObjects != 0) { structArtificialSubObject[NoOfArtificialSubObjects] ArtificialSubObjects; } int MarkerType; //See MarkerTypeEnum int ObjectTypeId = VariousInfo.Offset(16).[4].ToInt; // The 4-bytes at offset 16 in the VariousInfo is the ObjectTypeId. }

NB: While the 'VariousInfo' byte array is decernable at this time it essentially defines various floats, integers, transforms etc. that denote the 'default' and/or 'seed' values for a given ObjectType.
The most important data is the ObjectTypeId found at the 16th byte and is an 4-byte int.


structArtificialSubObject

struct structArtificialSubObject { int NoOfCharsInArtificialSubObjectName; ascii[NoOfCharsInArtificialSubObjectName] ArtificialSubObjectName; int Something1; int Something2; float[6] arySomethingFloats; }


structRoadNetworkType

struct structRoadNetworkType { int NoOfCharsInRoadNetworkTypeName; ascii[NoOfCharsInRoadNetworkTypeName] NetworkTypeName; byte[4] KeyPartsColour; // rgba 0xFFFF FFFF means 'default' byte[4] NormalPartsColour; // rgba 0xFFFF FFFF means 'default' short FilledLine; // 0x0000=No, 0x0100=Yes double[2] Steps; // int NoOfStraightParts; if (NoOfStraightParts != 0) { structRoadNetworkTypeStraightPart[NoOfStraightParts] RoadNetworkTypeStraightParts; } int NoOfCurveParts; if (NoOfCurveParts != 0) { structRoadNetworkTypeCurvePart[NoOfCurveParts] RoadNetworkTypeCurveParts; } int NoOfSpecialParts; if (NoOfSpecialParts != 0) { structRoadNetworkTypeSpecialPart[NoOfSpecialParts] RoadNetworkTypeSpecialParts; } int NoOfTerminatorParts; if (NoOfTerminatorParts != 0) { structRoadNetworkTypeTerminatorPart[NoOfTerminatorParts] RoadNetworkTypeTerminatorParts; } }

structRoadNetworkTypeStraightPart

struct structRoadNetworkTypeStraightPart { int NoOfCharsInStraightPartName; ascii[NoOfCharsInStraightPartName] StraightPartName; int ObjectId; short StraightPartType; short CanChangeBankAngle; }


structRoadNetworkTypeCurvePart

struct structRoadNetworkTypeCurvePart { int NoOfCharsInCurvePartName; ascii[NoOfCharsInCurvePartName] CurvePartName; int ObjectId; short CurvePartType; }


structRoadNetworkTypeSpecialPart

struct structRoadNetworkTypeSpecialPart { int NoOfCharsInSpecialPartName; ascii[NoOfCharsInSpecialPartName] SpecialPartName; int ObjectId; short SpecialPartType; short CanChangeBankAngle; }


structRoadNetworkTypeTerminatorPart

struct structRoadNetworkTypeTerminatorPart { int NoOfCharsInTerminatorPartName; ascii[NoOfCharsInTerminatorPartName] TerminatorPartName; int ObjectId; short TerminatorPartType; short CanChangeBankAngle; }


structLayer

struct structLayer { int NoOfCharsInTerminatorPartName; ascii[NoOfCharsInTerminatorPartName] TerminatorPartName; int ObjectId; short TerminatorPartType; short CanChangeBankAngle; }


Enums

ObjectClassEnum

enum ObjectClassEnum { Natural = 1, Artificial = 2, Road = 3 }

MarkerTypeEnum

enum MarkerTypeEnum { Rectangular = 0, Elliptical = 1 }