Taxonomy Categories:
Member Functions:
Interface Category:
API.
Inherits From:
MCollectible
Inherited By:
TMipMapA8R8G8B8
Purpose:
TTextureMap is an abstract base class for texture maps that use an image (such as an instance of TImage).
Instantiation:
Abstract class; do not allocate.
Deriving Classes:
Note that TBumpTextureMap has a, not is a, TTextureMap. The same is true of TImageTextureMap.
Concurrency:
Not multithread safe.
Resource Use:
No special requirements.
virtual ~ TTextureMap ()
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.
Member Function: TTextureMap::GetItemValue
- virtual void GetItemValue (const TGPoint & index, double filterRange, TColor & returnColor) const
- virtual void GetItemValue (const TGPoint & index, const TGPoint & filterRange, TColor & returnColor)
- virtual void GetItemValue (const TGPoint & index, const TGPointArray & filterRange, TColor & returnColor)
Interface Category:
API.
Purpose:
- Returns the color from the texture-map image that corresponds to the index point. The filter range argument allows the image to be filtered to provide less detail than is available in the actual image array. Filter range values greater than 1.0 causes the image to become more fuzzy. This is a pure virtual function which must be overridden by derived classes.
- Returns the color from the texture-map image that corresponds to the index point. The filter range argument allows the image to be filtered to provide less detail than is available in the actual image array. This is a virtual function designed to be overridden by a derived class. However, a default value of kBlack is returned for classes that choose not to implement the function.
- Returns the color from the texture-map image that corresponds to the index point. The filter range argument allows the image to be filtered to provide less detail than is available in the actual image array. This is a virtual function designed to be overridden by a derived class. However, a default value of kBlack is returned for classes that choose not to implement the function.
Calling Context:
- Do not call this function directly.
- Do not call this function directly, except from within a derived class.
- Do not call this function directly, except from within a derived class.
Parameters:
- const TGPoint & index -The index point into the image of the texture map.
- double filterRange -The filter range used to blur the image.
- TColor & returnColor -The resulting color.
- const TGPoint & index -The index point into the image of the texture map.
- const TGPoint & filterRange -The filter range used to blur the image.
- TColor & returnColor -The resulting color.
- const TGPoint & index -The index point into the image of the texture map.
- const TGPointArray & filterRange -The filter range used to blur the image.
- TColor & returnColor -The resulting color is returned here.
Return Value:
None.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
Member Function: TTextureMap::GetImageSize
virtual TGPoint GetImageSize () const
Interface Category:
API.
Purpose:
Returns a TGPoint specifying the height and width of the image in pixels. This is a pure virtual function which must be overridden by derived classes.
Calling Context:
Do not call this function directly.
Parameters:
Return Value:
Returns a TGPoint representing the height and width of the image in pixels.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
Member Function: TTextureMap::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: TTextureMap::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 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.
- TTextureMap ()
- TTextureMap (const TTextureMap & source)
Interface Category:
API.
Purpose:
- Default constructor. This is a protected constructor which must be overridden by derived classes.
- Copy constructor. This is a protected constructor designed to be overridden by derived classes.
Calling Context:
- Called by the stream-in operators. Do not call this function directly.
- Called to copy an object. Do not call this function directly, except from a derived class' copy constructor.
Parameters:
- Takes no parameters.
- const TTextureMap & source -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: TTextureMap::operator=
TTextureMap & operator =(const TTextureMap & source)
Interface Category:
API.
Purpose:
Assignment operator. This is a protected member function designed to be overridden by derived classes.
Calling Context:
Do not call this function directly, except from a derived class' operator
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.
Click the icon to mail questions or corrections about this material to Taligent personnel.
Copyright©1995 Taligent,Inc. All rights reserved.