Kiwi tea at 17:34, 17 September 2012

2012-09-17T17:34:40Z

Echo: Reformatting

2006-09-10T08:20:49Z

Reformatting

Show changes

Delphy: Auto-inserted from WakkaWikki

2006-01-01T01:27:46Z

Auto-inserted from WakkaWikki

New page

{{OldWikiEntry}} '''[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''
- - - - - - - - - - - - - - - - - - - - - - - - - - - - -

<pre>
; 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

</pre>

''Data Block''
- - - - - - - - - - - - - - - - - - - - - - - - - - - - -

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

'''[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
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=- [[Category:Modding]]

← Older revision		Revision as of 17:34, 17 September 2012
Line 162:		Line 162:
	;string : UNICODE character string		;string : UNICODE character string

−	[[Category:Modding]]	+	[[Category:Sims 2 Modding]]

RCOL - Revision history

Kiwi tea at 17:34, 17 September 2012

Echo: Reformatting

Delphy: Auto-inserted from WakkaWikki