RenderWare V2.1

Previous Page Index Next Page

void

RwImmediateBegin(RwRect *rect);

Description

Set up for rendering using immediate mode primitives outside of an immediate mode callback.

Arguments

rect Rectangle defining the area in the camera where Z buffering will occur. NULL if no Z buffering will occur.

Return Value

None.

Comments

If immediate mode rendering is required outside of an immediate mode callback, this function must be called to set up immediate mode rendering. Note that this function can only be called i the context of an RwBeginCameraUpdate() .. RwEndCameraUpdate() block.

When immediate mode rendering has completed then the function RwImmediateEnd() should be used. Note that only immediate mode rendering can be used between RwImmediateBegin() and RwImmediateEnd() (i.e. RwRenderClump() and RwRenderScene() cannot be used).

If you wish to perform Z buffering and you know the range (i.e. the furthest z value and nearest z value of vertices in camera space) it is advisable to set the Z buffer Z range via RwSetImmediateZRange(), otherwise the Z range from the near to the far clipping plane will be used which might not provide sufficient Z resolution.

See Also

RwImmediateEnd()

RwSetupImmediateLine()

RwSetupImmediateTriangle()

RwRenderImmediateTriangle()

RwRenderImmediateLine()

RwRenderImmediateClump()

RwSetImmediateZRange()