For an overview about Renderers,
see General Information.
For a list of all Renderer functions and related topics,
see Rendering.
Invoke the PEXlib output command functions
(see Programming Interface
for Generating Output Commands)
to direct output commands directly to a
renderer for immediate rendering or to a structure
for structure mode rendering.
- Immediate Rendering:
- With immediate rendering, the client program sends output
commands directly to a renderer to be rendered immediately
to the drawable.
For immediate processing, start rendering by invoking the
PEXBeginRendering
function, which associates the renderer with a drawable.
You can use the renderer in immediate mode by specifying
PEXOCRender in the OC functions.
You can associate a different drawable without changing the
pipeline state by using the
PEXBindDrawableToRenderer
function.
When finished rendering, invoke the
PEXEndRendering
function, which disassociates the renderer from the
drawable.
- Structure Mode Rendering:
- With structure mode rendering, you store output commands in
structures (see Structures.)
You can use the renderer in structure mode by specifying
PEXOCStore in the OC functions and later instruct the
renderer, with the
PEXRenderNetwork
function, to traverse these structure networks.
The PEXRenderNetwork function implicitly does the
operations done explicitly by the
PEXBeginRendering
and PEXEndRendering functions.
- Mixed Mode Rendering:
To render in mixed mode, invoke the
PEXExecuteStructure
function in immediate mode which traverses stored
structures.
If you want to traverse part of a stored structure in mixed
mode, invoke the PEXRenderElements
function.
A renderer is said to be "rendering" when its
renderer state attribute is
PEXRendering or
PEXMultipassRendering.