Name

cgSetLastListing - set the current listing text

Synopsis

#include <Cg/cg.h>

void cgSetLastListing( CGhandle handle,
                       const char * listing );

Parameters

handle

A CGcontext, CGstateassignment, CGeffect, CGpass, or CGtechnique belonging to the context whose listing text is to be set.

listing

The new listing text.

Return Values

None.

Description

Each Cg context maintains a null-terminated string containing warning and error messages generated by the Cg compiler, state managers and the like. cgSetLastListing allows applications and custom state managers to set the listing text.

cgSetLastListing is not normally used directly by applications. Instead, custom state managers can use cgSetLastListing to provide detailed technique validation error messages to the application.

Examples

to-be-written

Errors

CG_INVALID_PARAMETER_ERROR is generated if handle is invalid.

History

cgSetLastListing was introduced in Cg 1.4.

See Also

cgGetLastListing, cgCreateContext, cgSetErrorHandler