![](../../Home/Icons/Home.gif)
![](../icons/UpCNM.gif)
![](../icons/CNMContext.gif)
![](../../Home/Icons/Search.gif)
Taxonomy Categories:
Member Functions:
Interface Category:
API.
Inherits From:
TSceneState
Inherited By:
TSceneBundle
Purpose:
TLinkableClippingSceneState is an abstract class derived from TSceneState. The base class provides protocol for accessing the scene attributes, as well as functionality for maintaining a time stamp. To these functions, TLinkableClippingSceneState adds the pure virtual member functions LinkTo and Unlink. Contrary to what you might expect from experience with other classes, the LinkTo function is not used to build a hierarchy of TSceneStates. Instead, this LinkTo function takes a TMatrixState and TClipState as arguments. From these, the TLinkableClippingSceneState obtains the 2-D view matrix and clip area, which its camera uses to calculate its own 3-D matrix.
TLinkableClippingSceneState is used mainly through its concrete derived class, TSceneBundle.
Instantiation:
Abstract class; do not allocate.
Deriving Classes:
None.
Concurrency:
Not multithread safe.
Resource Use:
No special requirements.
virtual ~ TLinkableClippingSceneState ()
Interface Category:
API.
Purpose:
Destructor.
Calling Context:
Called to destroy an object.
Parameters:
Return Value:
None.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
virtual void GetAmbientLight (TColor &) const
Interface Category:
API.
Purpose:
Returns, in its argument, a TColor indicating the intensity and hue of the ambient light shining on the scene. This is a pure virtual function that must be overridden by derived classes.
Calling Context:
Do not call this function directly.
Parameters:
- TColor & -The color (intensity and hue) of the ambient light is returned here.
Return Value:
None.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
virtual const TAtmosphereShader * GetAtmosphereShader () const
Interface Category:
API.
Purpose:
Returns a constant pointer to the TAtmosphereShader, which simulates atmospheric attenuation due to haze, clouds, or fog between the objects in the scene and the viewer. This is a pure virtual function that must be overridden by derived classes.
Calling Context:
Do not call this function directly.
Parameters:
Return Value:
Returns a constant pointer to the TAtmosphereShader, which simulates atmospheric attenuation due to haze, clouds, or fog between the objects in the scene and the viewer.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
virtual const TCamera * GetCamera () const
Interface Category:
API.
Purpose:
Returns a constant pointer to the TCamera, which simulates a camera or eye that views the scene. This is a pure virtual function that must be overridden by derived classes.
Calling Context:
Do not call this function directly.
Parameters:
Return Value:
Returns a constant pointer to the TCamera, which simulates a camera or eye that views the scene.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
virtual const TGrafAttribute * GetSceneAttribute (const TToken & attributeName) const
Interface Category:
API.
Purpose:
Returns a constant pointer to the named extended TGrafAttribute. This is a pure virtual function that must be overridden by derived classes.
Calling Context:
Do not call this function directly.
Parameters:
- const TToken & attributeName -The name of the attribute being requested.
Return Value:
Returns a constant pointer to the named TGrafAttribute. Returns NIL if the name attribute is not found.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
virtual TSceneAttributeIterator * CreateSceneAttributeIterator () const
Interface Category:
API.
Purpose:
Creates an iterator that accesses the scene's extended attributes (but not the standard attributes). This is a pure virtual function that must be overridden by derived classes.
Calling Context:
Do not call this function directly.
Parameters:
Return Value:
Returns a pointer to a TSceneAttributeIterator that can be used to access the extended attributes held by this object.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
- TLinkableClippingSceneState ()
- TLinkableClippingSceneState (const TLinkableClippingSceneState &)
Interface Category:
API.
Purpose:
- Default constructor. This is a protected constructor that must be overridden by the derived classes.
- Copy constructor. This is a protected member function that is designed to be overridden by the derived classes.
Calling Context:
- Do not call this function directly.
- Do not call this function directly, except from within the copy constructor of a derived class.
Parameters:
Return Value:
None.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
TLinkableClippingSceneState & operator =(const TLinkableClippingSceneState &)
Interface Category:
API.
Purpose:
Assignment operator. This is a protected member function that is designed to be overridden by derived classes.
Calling Context:
Do not call this function directly, except from within the operator =of a derived class.
Parameters:
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.
TStream & operator >>=(TStream &) const
Interface Category:
API.
Purpose:
Stream-out operator. This is a protected member function that is designed to be overridden by derived classes.
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.
TStream & operator <<= (TStream &)
Interface Category:
API.
Purpose:
Stream-in operator. This is a protected member function that is designed to be overridden by derived classes.
Calling Context:
Called to stream in data.
Parameters:
- TStream & -The stream that the object streams itself in from.
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.
virtual TIteratorOver < TKeyValuePair < TLightSurrogate , TLight >>* CreateLightIterator () const
Interface Category:
API.
Purpose:
Creates an iterator that can be used to access the list of lights that shine upon the scene from specific locations. This is a pure virtual function that must be overridden by derived classes.
Calling Context:
Do not call this function directly.
Parameters:
Return Value:
Returns a pointer to a TIterator object that can be used to access the list of lights that shine upon the scene.
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.
Copyright©1995 Taligent,Inc. All rights reserved.