Main Page Modules Alphabetical List Data Structures Data Fields

G3x_ADL
[Custom Lighting Pipelines]


Defines
#define	rwPDS_G3x_ADL_CodeArraySize
#define	rwPDS_G3x_ADL_MatPipeRegister()
Functions
RwBool	RpPDS_G3x_ADL_LightingUpload (RpLight ambient, RpLight directional)
Variables
void *	rwPDS_G3x_ADL_VU1Transforms [rwPDS_G3x_ADL_CodeArraySize]
RpPDSSkyVU1CodeTemplate	rwPDS_G3x_ADL_VU1Code
RwUInt64	G3x_ADLGenericPER
RpPDSSkyMatTemplate	rwPDS_G3x_ADL_MatPipe

Detailed Description

Documentation for the G3x_ADL rendering pipeline. The individual pipelines are not documented fully. However an Example Pipeline Definition is fully documented and all the pipelines have the same structure.

G3x_ADL definitions

 
 Projection:    Perspective correct projection

 Primitive:     Triangle strips
                Triangle list

 Lighting:      Custom light buffer
                Fixed lighting

                1 Ambient light
                1 Directional light
            
 Clipping:      Fast path rendering
                Triangle fast culling

 Fog:           All primitives support linear fog

This pipeline supports persistent lighting and uses a custom lighting buffer. The lighting upload function RpPDS_G3x_ADL_LightingUpload should be used to initialize the lighting buffer prior to pipeline execution.

See also:: RpPDS_G3x_ADL_LightingUpload

Define Documentation

#define rwPDS_G3x_ADL_CodeArraySize

VU1 Code array size

See also:: rwPDS_G3_Example_CodeArraySize

#define rwPDS_G3x_ADL_MatPipeRegister	(
	)

Material pipe register

See also:: rwPDS_G3_Example_MatPipeRegister , RpPDSRegisterMatPipe

Function Documentation

RwBool RpPDS_G3x_ADL_LightingUpload	(	RpLight *	ambient,
		RpLight *	directional
	)

This function setups the custom lighting buffers used by the custom lighting pipelines. The ambient and directional lights are uploaded into vector memory for use by the custom lighting pipeline. The lighting information will persist whilst the same combination lighting pipelines are used. However, if another set of lighting pipelines are used, either another custom lighting pipeline or a generic lighting pipeline, then the lighting buffer must be reinitialized with this function.

If the lighting setup is changing for each pipeline execution then the lighting upload function could be put into a render callback.

Parameters: