Difference between revisions of "Sims 3:Catalog Resource"

Revision as of 16:13, 6 October 2010

Overview

The following resource types are used for catalog entries.

Format

Common

This block appears in all Catalog Resources. The name and description GUIDs can be looked up in the STBL.

DWORD Version		// Earliest seen is 0x0000000C
QWORD Name GUID		// Key into STBL for localised value to display
QWORD Desc GUID		// Key into STBL for localised value to display
7BITSTR			// "Internal" Catalog Name
7BITSTR			// "Internal" Catalog Description
FLOAT price
FLOAT			// always 1.0
4BYTE			// binary zeros
BYTE
QWORD IID of PNG icon	// When not zero, this is the catalogue thumbnail;
			// otherwise image is found by IID matching (see below)
--if Version >= 0x0000000D
	BYTE
	--if Version >= 0x0000000E
		BYTE
		--if Version >= 0x0000000F
			DWORD

Thumbnail

There are two ways of finding the thumbnails for a catalogue resource, depending on if IID of PNG icon is zero or not. The Resource Type is always one of three values (representing small, medium or large). Medium is the type of small plus 1; large is the type of small plus 2. There can be multiple thumbnails, differing only in their group, representing the different default appearances for the catalogue resource.

When non-zero

Thumbnail Types
0x2E75C764, 0x2E75C765, 0x2E75C766

The IID of the thumbnail is IID of PNG icon.

When zero

The thumbnail resource type type depends on the catalogue resource type:

Catalogue Type[4]	Thumbnail Types
Object Proxy Product Terrain Geometry Brush Terrain Water Brush Foundation[1] Roof Style Roof Pattern	0x0580A2B4, 0x0580A2B5, 0x0580A2B6
Fence	0x2653E3C8, 0x2653E3C9, 0x2653E3CA
Stairs	0x5DE9DBA0, 0x5DE9DBA1, 0x5DE9DBA2
Railing	0x2D4284F0, 0x2D4284F1, 0x2D4284F2
Terrain Paint Brush	0x05B1B524, 0x05B1B525, 0x05B1B526
Fireplace[2]	0x05B17698, 0x05B17699, 0x05B1769A
Wall/Floor Pattern[3]	0x0589DC44, 0x0589DC45, 0x0589DC46

The IID of the thumbnail is the IID of the catalog resource.

Notes

^[1] I'm not sure this has been verified.

^[2] s3oc shows the thumbnail for the first OBJD rather than this.

^[3] For all catalogue resources apart from Wall/Floor Pattern, a thumb with a Resource Group of zero is acceptable; for Wall/Floor Patterns, however, a non-zero Resource Group is needed.

^[4] Walls do not have thumbnails.

Material List

ObjectMaterialList

This section is only present in Objects, Fences (EP1+), Railings (EP1+) and Wall/Floor Patterns; it differs slightly for Wall/Floor Patterns, as annotated below.

Purpose

This is a list of all preset color options that a Catalog Resource has. Each preset has different settings for patterns used and colors applied. They are listed in the order that they appear in game. You can safely delete them. (The screen shot shows how they are presented in s3pe.)

Format

DWORD Count1
--repetition Count1 Material:
	BYTE type
	if (type != 1) DWORD
	DWORD offset		// from here to after TGI Block List
	WORD
	DWORD tgi offset	// see Sims 3:Key table
	DWORD tgi size		// see Sims 3:Key table
	--insert Material Block
	--insert TGI Block List	// see Sims 3:Key table
	DWORD
	--if Wall/Floor Style:
		DWORD
		DWORD
		DWORD

Common Values

Not all values are present in all catalog resources.

Notes

• [1] Walls - Changing to 0x00 - Entire wall disappears from catalog with all presets
• [2] Present for Walls/Floors
• [3] Values must be non-zero and unique. Changing the value does not re-order them in catalog but walls will show the thumb/catalog in new order but does not move the actual wall preset order.

Material Block

This block holds the variables used in the complate to render a texture, equivalent to the preset XML used for CAS parts. TGI Block List indexes refer to the TGI Block List following this Material Block.

BYTE index			// TGI Block List entry for Complate XML to which these variables should be applied
--insert data for typecode 0x01 // see below
--insert data for typecode 0x01 // see below
DWORD count1
--repetition count1 Type Code List:
	BYTE controlCode
	--if controlCode is 0x40:
		BYTE[]		// padding with 0x40 bytes, does not count as a list entry
	--else
		BYTE typecode
		--insert data for typecode	// see below
DWORD count2
--repeat(count2)
	Material Block		// sub-blocks used for pattern definitions

Complate Variables

Complate variables are referenced by the same strings as they are in the complate XML. All the standard complate elements are indexed via the string table so are not typically included as a literal string.

Typecodes

If (flags & 0x40 set) - read a byte; else use (flags & 0x3F); call this "index"
If (flags & 0x80 set) - a string, length is "index"
If (flags & 0x80 clear) - a string from the string table, identified by "index"