psx.wiki

RSD (3D Model Data)

Text format for 3D models made with the PlayStation artist tools.

RSD (3D Model Data)
Extension.RSD
Version3.0 (@RSD970401)

This is an old revision of this page, as edited by RemmyLee at 02:46, 23 October 2026. Edit this revision | Latest revision

Overview

The RSD format represents 3D models. The PlayStation artist tools work with RSD models.1

An RSD model is made of four files. Together they are called "RSD" or "RSD data".1

The four files are as follows:

Table 1: RSD model files
File Contents
RSD Relationships between the PLY, MAT and GRP files, the texture files and the extended files
PLY Positions of the vertices of polygons
MAT Material information on polygons
GRP Grouping information on polygons

Four extended files and one sub-extended file were added to support HMD.1

The extended files are as follows:

Table 2: RSD extended files
File Kind Contents
MSH Extended How polygons are linked
PVT Extended Offsets for centers of rotation
COD Extended COORDINATE information for VERTEX
MOT Extended Animation information
OGP Sub-extended Grouping information for VERTEX. Named only from a COD file.

All RSD files are text files. Lines end with LF or CR/LF, and lines that begin with '#' are comments.1

Files in one directory are named by their file names alone. Files in other directories need relative or absolute path names.1

The manual describes the following versions:2

Table 3: RSD file versions
File Version
RSD 3.0
PLY 3.0
MAT 3.0
GRP 3.0
MSH 1.0
PVT 1.0
COD 1.0
OGP 1.0
MOT 1.0

RSDLINK converts RSD data to TMD.3

RSD File

The RSD file tells how the other files combine for one object. With extended files, one set of RSD files can hold several objects.2

The RSD file has an ID followed by file specifications.2

The ID is a string "@RSDnnnnnn" that gives the format version. Version 3.0 is "@RSD970401".2

The file specifications are as follows:

Table 4: RSD file specifications
Line Contents
PLY= PLY file name
MAT= MAT file name
GRP= GRP file name
MSH= MSH file name
PVT= PVT file name
COD= COD file name
NMOT= Number of MOT files
MOT[n]= File name of the nth MOT file
NTEX= Number of TIM (texture) files
TEX[n]= File name of the nth TIM (texture) file

PLY File

The PLY file holds the vertex positions of polygons and related objects.4

Without extended files, the PLY coordinate system is the libgs system. X increases to the right and Y increases down, and Z points into the screen.4

With extended files, HMD conversion converts each COD vertex into the libgs system. The rotations and translations of the PVT file are applied.4

The order of the vertices sets the front of a single-faced polygon. The front is the side from which the vertices run clockwise.4

A PLY file has the following parts:5

Table 5: PLY file structure
Part Contents
ID "@PLYnnnnnn". Version 3.0 is "@PLY970401".
Data length record Number of lines in the VERTEX, NORMAL and POLYGON blocks
VERTEX descriptor X, Y and Z coordinates as floating point values, one vertex per line
NORMAL descriptor X, Y and Z elements of a normal vector as floating point values
POLYGON descriptor A flag and nine parameters

POLYGON Descriptor

The flag is a hexadecimal integer without the '0x' prefix. Its TYPE field gives the polygon type.6

The TYPE values are as follows:

Table 6: PLY polygon types
TYPE Polygon type
000 Triangle
001 Quadrangle
010 Straight line
011 Sprite
1XX Reserved

The nine parameters depend on the type:6

Table 7: POLYGON descriptor parameters
Type Parameters
Triangle or quadrangle Vertex 0 to 3, then Normal 0 to 3
Straight line Vertex 0, Vertex 1, then zeros
Sprite Vertex 0, Width, Height, then zeros

For a triangle, vertex 3 and normal 3 are 0. A quadrangle is drawn as two triangles.6

A flat-shaded polygon uses the normal of the first vertex. A Gouraud-shaded polygon has a normal for each vertex.6

A sprite is a rectangular image in 3D space. It acts as a textured polygon that always faces the viewpoint.6

MAT File

The MAT file opens with an ID "@MATnnnnnn" and a MATERIAL descriptor count. The MATERIAL descriptors follow.78

Each MATERIAL descriptor holds a polygon number, a flag, the shading and the material information for one polygon.8

The polygon number is an index into the POLYGON group of the PLY file.8

References

  1. ^ a b c d e Sony Computer Entertainment Inc. File Formats. November 1998. Page 2-3.

  2. ^ a b c d Sony Computer Entertainment Inc. File Formats. November 1998. Page 2-4, Figure 18.

  3. ^ Sony Computer Entertainment Inc. File Formats. November 1998. Page 2-24.

  4. ^ a b c d Sony Computer Entertainment Inc. File Formats. November 1998. Page 2-5, Figure 19.

  5. ^ Sony Computer Entertainment Inc. File Formats. November 1998. Page 2-6, Figures 20 to 23.

  6. ^ a b c d e Sony Computer Entertainment Inc. File Formats. November 1998. Page 2-7, Figures 24 to 27.

  7. ^ Sony Computer Entertainment Inc. File Formats. November 1998. Page 2-8, Figure 29.

  8. ^ a b c Sony Computer Entertainment Inc. File Formats. November 1998. Page 2-9, Figure 30.

Categories: File formats