Class: TWrinkleProcedureMap

Declaration: SampleProcedureMaps.h

Taxonomy Categories:

Member Functions:

Interface Category:

API.

Inherits From:

TNoiseProcedureMap

Inherited By:

None.

Purpose:

TWrinkleProcedureMap is a concrete class, derived from TNoiseProcedureMap, that creates a texture with a wrinkled appearance. A TWrinkleProcedureMap object alters the shading normal but not the color of a surface point. The procedure uses a TGrafNoise object (by default, an instance of TLatticeNoise) to generate a pseudo-random number for a given surface point. This number is added to the point's shading normal, which is then normalized.

Instantiation:

Allocate on the heap or the stack.

Deriving Classes:

None.

Concurrency:

Not multithread safe.

Resource Use:

No special requirements.

Member Function: TWrinkleProcedureMap::TWrinkleProcedureMap

TWrinkleProcedureMap ()
TWrinkleProcedureMap (const TWrinkleProcedureMap & map)

Interface Category:

API.

Purpose:

Default constructor. Sets the scale factor to 1.0. Sets the noise generator to a TLatticeNoise object.
Copy constructor.

Calling Context:

Called by the stream-in operators. You can also call this function directly.
Called to copy an object.

Parameters:

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

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TWrinkleProcedureMap::~TWrinkleProcedureMap

virtual ~ TWrinkleProcedureMap ()

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:

Not multithread safe.

Other Considerations:

None.

Member Function: TWrinkleProcedureMap::SetGrafNoise

virtual void SetGrafNoise (const TGrafNoise & noise)

Interface Category:

API.

Purpose:

Sets the noise object, which generate a certain type of pseudo- random number, to a copy of the specified TGrafNoise.

Calling Context:

Call this function directly.

Parameters:

const TGrafNoise & noise -The noise generator to use.

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TWrinkleProcedureMap::GetValue

virtual void GetValue (TShadingSample & info, const TSceneState &) const

Interface Category:

API.

Purpose:

Returns, in the fShadingNormal field of the TShadingSample argument, the new shading normal that the procedure map computes for the given surface point.

Calling Context:

Call this function directly.

Parameters:

TShadingSample & info -The new shading normal is returned in this object.
const TSceneState & -The state of the scene.

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TWrinkleProcedureMap::SetScale

virtual void SetScale (double scale)

Interface Category:

API.

Purpose:

Sets the scalar used to multiply the x-, y-, and z-coordinates of a surface point before computing the new color. Larger scalars make the wrinkle pattern noisier.

Calling Context:

Call this function directly.

Parameters:

double scale -The scale value to use.

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TWrinkleProcedureMap::GetModifiedShadingVariables

virtual void GetModifiedShadingVariables (TShadingUsageVariables & variables) const

Interface Category:

API.

Purpose:

Returns, in its TShadingUsageVariables argument, an object indicating which TShadingSample fields the procedure map alters (namely, fShadingNormal only). The shader needs this information to save and store variables in the TShadingSample that it operates on.

Calling Context:

Call this function directly.

Parameters:

TShadingUsageVariables & variables -The list of variables that are to be modified by the shader.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TWrinkleProcedureMap::operator=

TWrinkleProcedureMap & operator =(const TWrinkleProcedureMap & source)

Interface Category:

API.

Purpose:

Assignment operator.

Calling Context:

Call this function by using the operator in an assignment statement.

Parameters:

const TWrinkleProcedureMap & 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:

Not multithread safe.

Other Considerations:

None.

Member Function: TWrinkleProcedureMap::operator>>=

virtual TStream & operator >>=(TStream &) const

Interface Category:

API.

Purpose:

Stream-out operator.

Calling Context:

Called to stream out data.

Parameters:

TStream & -The stream that the object streams itself out to.

Return Value:

Returns a reference to the stream the object streams itself out to.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TWrinkleProcedureMap::operator<<=

virtual TStream & operator <<= (TStream &)

Interface Category:

API.

Purpose:

Stream-in operator.

Calling Context:

Called to stream in data.

Parameters:

TStream & -The stream that the object streams itself out to.

Return Value:

Returns a reference to the stream the object streams itself in from.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

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