RCOL

This article is imported from the old MTS2 wiki. You can help Sims2Wiki by cleaning it up. It's original page with comments can be found at http://old_wiki.modthesims2.com/RCOL

[Scenegraph File Format Specification]

- - - - - - - - - - - - - - - - - - - - - - - - - - - - -

RCOL, or Scenegraph Resource Collection, is a Sims 2 data type that contains numerous, arbitrary data blocks containing a variety of information.

This information is primarily used for objects, animation, textures, and the like. The file is composed of a header (somewhat confusing), and one or more data blocks. Each data block can have multiple sections or can even be recursive in nature.

After reading the header and the index, each data block must be read according to its own specification. The specifications for each possible type of data block follow the first part of this specification.

IMPORTANT NOTES: To further explain a strange quirk of this file type. The header has two possible configurations that are not readily apparent. In the specification below, the first two WORDs, "Language" and "String Format", may not be present. If, when parsing raw data of an RCOL, the first 4 bytes when read as a DWORD are not 0xFFFF0001, then reading must BACKTRACK, and reread the first 4 bytes as the "File Links" DWORD. If, when parsing, you DID backtrack and the first two WORDs are not present, then when reading "File Links", you must read only a TGI, not a TGIR (i.e. read 3 DWORDs per link, rather than DWORDs).

RCOL Header - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

; header
DWORD   	Version Mark    ; Optional - Always 0100FFFF. If present, use TGIR instead of TGI below
DWORD		File Links 	; Defines number of repetitions that follow
LOOP				; repeat "File Links" times
  DWORD		GroupID
  DWORD		InstanceID
  DWORD		ResourceID 	; Only appears if first two WORDs are 0x01/0xFF
  DWORD		TypeID
ENDLOOP

; Index
DWORD	ItemCount 		
LOOP				; repeat "ItemCount" times
  DWORD		RCOL ID
ENDLOOP

LOOP				; repeat "ItemCount" times
  ARBIT		Data Block	; See individual data blocks for further file structure
ENDLOOP

Data Block - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

BYTE		Block name length
PRIOR		Block name
DWORD		Block RCOL ID (Referenced in Index)
DWORD 		Block Version
ARBIT		Data Section

[Data Section Specifications] - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Each block ID# has a unique block name. Following are links to specifications for each known block type, by their TypeID and the translated type code (i.e. 0xAC4F8687/GMDC).

Known Data Blocks FB00791E ANIM filetype 4D51F042 CINE filetype E519C933 CRES filetype AC4F8687 GMDC filetype 7BA3838C GMND filetype C9C81B9B LGHT filetype - Lighting (Ambient Light) C9C81BA3 LGHT filetype - Lighting (Directional Light) C9C81BA9 LGHT filetype - Lighting (Point Light) C9C81BAD LGHT filetype - Lighting (Spot Light) ED534136 LIFO FC6EB1F7 SHPE 49596978 TXMT aka MATD - Material Definition 1C4A276C TXTR

Internal data blocks e9075bc5 cBoneDataExtension 1cfeceb8 cBoundingVolumeBuilder dcdda078 cCompactorBuilder 6A836D56 cDataListExtension 9bffc10d cIndexedMeshBuilder 253d2018 cLightRefNode 5ce7e026 cProcessDeformationsBuilder 65245517 cShapeRefNode 9a809646 cTagExtension 5d054225 cTangentSpaceBuilder 65246462 cTransformNode 2b70b86e cTSFaceGeometryBuilder dca76dbb cViewerRefNode 0c152b8e cViewerRefNodeRecursive

misc data blocks these blocks have block ID's of zero cSGResource cObjectGraphNode cCompositionTreeNode cReferentNode

Remaining RCOL Unknown Stuff

CINE - Unknown 1(first), Unknown 2, Unknown 3.1 GMDC - (purpose & effect for Submodel in compositions(linkages)), corrupt[obj.pack/lots] GMND - unknown3 cLight - unknown byte 253d2018 cLightRefNode - Ushort1,Uint1, B1,B2,B3,B4,B5 SHPE - (LOD listing entry purpose) 65245517 cShapeRefNode - U1,U2,U3,U4,U5,U6, UINT COLL, BYTE COLL TXTR - Unk2 e9075bc5 cBoneDataExtension - 1.1,1.2,1.3,1.4,2.1,2.2,2.3,2.4 2b70b86e cTSFaceGeometryBuilder - Unk1,2,3, Unk1(per set)

ANIM - LOTS (mostly P5/P6) 9bffc10d cIndexedMeshBuilder - LOTS dca76dbb cViewerRefNode - LOTS 0c152b8e cViewerRefNodeRecursive - LOTS

[Update History] -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=- (Spec Updated by Karybdis on Jan. 1, 2006) (Spec updated by DarkMatter on Dec. 4, 2004) -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

[Terminology Key] -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=- BYTE - Smallest unit of data, 8 bits WORD - Two bytes, or 16 bits DWORD - Four bytes, or 32 bits QWORD - Eight bytes, or 64 bits GUID - Sizteen bytes, or 128 bits

PRIOR - Notation used when the length of a

 data element is equal to the value
 of the previous data element.
 

ARBIT - Notation used when the length of a

 data element or data block is of
 arbitrary length, and the details
 are defined elsewhere.

7BITSTR - Notation used for a string that

 has its length encoded 7 bits at a time.
 See: 7BITSTR

ZDSTR - Zero Delimited String

 Notation used for a string that is ended by a 0 byte.

[C# Data Type Key] -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=- byte - unsigned byte sbyte - signed byte

short - 16bit signed integer ushort - 16but unsigned integer

int - 32bit signed integer uint - 32bit unsigned integer

long - 64bit signed integer ulong - 64bit unsigned integer

float - 32bit floating point number double - 64bit floating point number

char - UNICODE character (16bit)

string - UNICODE character string -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-