Class: T3DSpanPainter

Declaration: 3DSpanPainter.h

Taxonomy Categories:

Member Functions:

Interface Category:

API.

Inherits From:

TPainter

Inherited By:

TFB3DSpanPainter

Purpose:

T3DSpanPainter derives from TPainter and is used in the rendering pipeline for filling in 3-D surfaces. Its rendering function is invoked by polygon-rendering objects.

Instantiation:

Allocate on the heap or the stack.

Deriving Classes:

Different types of painters are derived from this base class, depending on the pixel type of the desired rendering engine. For example, TA8R8G8B83DSpanColorPainter, TA8R8G8B83DSpanNormalPainter, and TA8R8G8B83DSpanTexturePainter are three derived classes derived for 24-bit graphics.

Concurrency:

Multithread safe.

Resource Use:

No special requirements.

Other Considerations:

None.

Member Function: T3DSpanPainter::~T3DSpanPainter

virtual ~ T3DSpanPainter ()

Interface Category:

API.

Purpose:

Destructor.

Calling Context:

Called to destroy an object.

Parameters:

Takes no parameters.

Return Value:

None

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Multithread safe.

Other Considerations:

None.

Member Function: T3DSpanPainter::Render

virtual void Render (const TDeviceSample & devLeft, const TDeviceSample & devRight, const TShadingSample & shadingLeft, const TShadingSample & shadingRight, const TShader & shader, const TGrafState & gstate)

Interface Category:

API.

Purpose:

Performs the actual rendering of the polygon data, as directed by the polygon rendering object. A call to this routine renders on one scanline from left to right.

Calling Context:

Call this function directly.

Parameters:

const TDeviceSample & devLeft -The left boundary for the rendering.
const TDeviceSample & devRight -The right boundary for the rendering.
const TShadingSample & shadingLeft -The shading information for the left-hand boundary.
const TShadingSample & shadingRight -The shading information for the right-hand boundary.
const TShader & shader -The shading data for the polygon.
const TGrafState & gstate -The graphical state data for the polygon.

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Multithread safe.

Other Considerations:

None.

Member Function: T3DSpanPainter::T3DSpanPainter

T3DSpanPainter ()
T3DSpanPainter (const T3DSpanPainter &)

Interface Category:

API.

Purpose:

Default constructor.
Copy constructor.

Calling Context:

Called by the stream-in operators and directly.
Called to copy an object.

Parameters:

Takes no parameters.
const T3DSpanPainter & -The object to be copied.

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Multithread safe.

Other Considerations:

None.

Member Function: T3DSpanPainter::operator=

const T3DSpanPainter & operator =(const T3DSpanPainter & source)

Interface Category:

API.

Purpose:

Assignment operator.

Calling Context:

Called when an object is assigned to another compatible object.

Parameters:

const T3DSpanPainter & source -The object to be copied.

Return Value:

A non-const reference to the left-hand side object.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Multithread safe.

Other Considerations:

None.

Click the icon to mail questions or corrections about this material to Taligent personnel.