RenderWare V2.1

Previous Page Index


Cameras
Clumps
Debugging
Device Information
Errors
Library Global Defaults
Lights
Materials
Matrices
Polygons
Rasters
Scenes
Splines
System Information
Textures
Texture Dictionaries
UserDraw
Vertices

Library Defaults


This appendix details the various default values found in the RenderWare library. This includes the default values of global library parameters and the default values of RenderWare objects when first created.

Cameras

Table E-1: Camera Object Defaults

Attribute

Default

Position

[CREAL(0.0), CREAL(0.0), CREAL(0.0)]
in world coordinates

Look At

[CREAL(0.0), CREAL(0.0), CREAL(-1.0)]

Look Right

[CREAL(1.0), CREAL(0.0), CREAL(0.0)]

Look Up

[CREAL(0.0), CREAL(1.0), CREAL(0.0)]

Viewport

Position = [0, 0] Size = [0, 0]

Viewwindow

[CREAL(1.0), CREAL(1.0)]

View Offset

[CREAL(0.0), CREAL(0.0)]

Near Clipping

CREAL(0.05)

Projection

rwPERSPECTIVE

Back Color

[CREAL(0.0), CREAL(0.0), CREAL(0.0)] (Black)

Backdrop

NULL

Backdrop Offset

[0, 0]

Backdrop Viewport
Rectangle

Position = [0, 0] Size = [0, 0]

Data

NULL

Image

Device dependent

Clumps

Table E-2: Clump Object Defaults

Attribute

Default

Origin

[CREAL(0.0), CREAL(0.0), CREAL(0.0)] in world coordinates

Matrix

Identity

Joint Matrix

Identity

LTM

Identity

Owner

The default scene
(as returned by RwDefaultScene())

Parent

NULL

Root

The clump itself

Data

NULL

First Child

NULL

Next Clump

NULL

Number of Vertices

Defined at creation time

Number of Polygons

Defined at creation time

Number of Children

0

Number of UserDraws

0

Tag

0

Hints

rwHS

Axis Alignment

rwNOAXISALIGNMENT

State

rwON

Bounding Box

Computed

Viewport Rectangle

Computed

Debugging

Table E-3: Debugging Defaults

Attribute

Default

Stream

stderr on Unix
\rw.log on DOS and MS Windows
stderr on the Macintosh

Assertion State

rwON

Message State

rwON

Script State

rwOFF

Severity

rwINFORM

Trace State

rwOFF

Device Information

Table E-4: Device Information Defaults

Attribute

Default

rwRENDERDEPTH

8 or 16. Actual value is device specific

rwINDEXEDRENDERING

Non-zero if the current render depth is 8
Zero if the current render depth is 16

rwPALETTEBASED

Non-zero if the output device is palette based
Zero if the output device is not palette based

rwPALETTE

Device dependent

rwPALETTESIZE

Device dependent

rwFIRSTPALETTEENTRY

Device dependent

rwLASTPALETTEENTRY

Device dependent

Errors

Table E-5: Error Status Defaults

Attribute

Default

Status

E_RW_NOERROR

Internal Error

Undefined

Library Global Defaults

Table E-6: Library Global Defaults

Attribute

Default

Current Camera

NULL

Shape Path

Value of environment variable "RWSHAPEPATH" or "" if the environment variable is not set on DOS, MS Windows and Unix
"" on the Macintosh

Scenes

One. The default scene
(as returned by RwDefaultScene())

Lights

None

Clumps

None

Cameras

None

Textures

None

Texture Dictionaries

One on the Texture Dictionary stack.

Rasters

None

Splines

None

UserDraws

None

Matrices

One on the Scratch matrix stack, one on the Current Matrix stack and one on the Joint Matrix stack

Materials

One on the Material stack

Texture Dithering

rwAUTODITHER

Texture Gamma
Correction

rwON

Lights

Table E-7: Light Object Defaults

Attribute

Default

Type

Defined at creation time

Brightness

Defined at creation time

Color

Defined at creation time (each of the red, green and blue components of the color are equal to the specified brightness)

Position

Defined at creation time for point and conical lights

Vector

Defined at creation time for directional lights.
[CREAL(0.0), CREAL(-1.0), CREAL(0.0)]
for conical lights

Owner

The default scene (as returned by RwDefaultScene())

Cone Angle

CREAL(30.0) for conical lights
CREAL(180.0) for point lights

State

rwON

Data

NULL

Materials

Table E-8: Material Object Defaults

Attribute

Default

Ambient

CREAL(0.0)

Diffuse

CREAL(0.0)

Specular

CREAL(0.0)

Light Sampling

rwFACET

Geometry Sampling

rwSOLID

Color

[CREAL(0.0), CREAL(0.0), CREAL(0.0)]
(Black)

Opacity

CREAL(1.0)

Texture

NULL

Texture Modes

rwLIT

Matrices

Table E-9: Matrix Object Defaults

Attribute

Default

Elements

Identity

Polygons

Table E-10: Polygon Object Defaults

Attribute

Default

Material

Defined at creation time by the Current Material
(as returned by RwCurrentMaterial())

Vertices

Defined at creation time

Center

Computed

Normal

Computed

Number of Sides

Defined at creation time

Owner

Defined at creation time

UV

[CREAL(0.5), CREAL(0.5)] for all vertices

Tag

0

Data

NULL

Rasters

Table E-11: Raster Object Defaults

Attribute

Default

Width

Defined at creation time (either explicitly or by source image)

Height

Defined at creation time (either explicitly or by source image)

Depth

Equal to the current RenderWare render depth

Stride

Computed from the width

Pixel Pointer

Defined at creation time

Pixel Values

Undefined if created with RwCreateRaster()
Derived from the source image if created by RwBitmapRaster(), RwReadRaster() or RwReadMaskRaster()

Data

NULL

Scenes

Table E-12: Scene Object Defaults

Attribute

Default

Number of Clumps

0

Number of Lights

0

Data

NULL

Splines

Table E-13: Spline Object Defaults

Attribute

Default

Type

Defined at creation time

Points

Defined at creation time

Number of Points

Defined at creation time

Data

NULL

System Information

Table E-14: System Information Defaults

Attribute

Default

rwVERSIONSTRING

Library dependent

rwVERSIONMAJOR

Library dependent

rwVERSIONMINOR

Library dependent

rwVERSIONRELEASE

Library dependent

rwFIXEDPOINTLIB

Non-zero for fixed point library
Zero for floating point library

rwDEBUGGINGLIB

Non-zero for debugging library
Zero for production library

Textures

Table E-15: Texture Object Defaults

Attribute

Default

Name

Computed for named textures
NULL for other textures

Frame

0

Frame Step

+1

Number of Frames

Defined at creation time

Raster

Defined at creation time

Mask

Unmasked

Dithering

Defined by the global dithering mode for a texture read by RwReadTexture() or
RwReadNamedTexture()
Defined by the specified raster options for a texture created from a raster created by RwReadRaster() or RwBitmapRaster().

Gamma Correction

Defined by the global gamma correction mode for a texture read by RwReadTexture() or
RwReadNamedTexture()
Defined by the specified raster options for a texture created from a raster created by RwReadRaster() or RwBitmapRaster()

Data

NULL

Texture Dictionaries

Table E-16: Texture Dictionary Defaults

Attribute

Default

Textures

None

Search Mode

rwGLOBAL

UserDraw

Table E-17: UserDraw Object Defaults

Attribute

Default

Alignment

Defined at creation time

Call-back

Defined at creation time

Offset

Defined at creation time

Size

Defined at creation time

Type

Defined at creation time

Owner

NULL

Data

NULL

Vertex Index

Undefined

Parent Alignment

Undefined

Vertices

Table E-18: Vertex Defaults

Attribute

Default

Coordinates

Defined at creation time

Texture coordinates

[CREAL(0.5), CREAL(0.5)]

Normal

Computed

Viewport Position

Computed