FCDImage Class Reference
[COLLADA Effect Classes [ColladaFX]]

A COLLADA image. More...

#include <FCDImage.h>

Inheritance diagram for FCDImage:

FCDEntity FCDObjectWithId FCDObject FUObject List of all members.

Public Member Functions

 FCDImage (FCDocument *document)
 Constructor: do not use directly.
virtual ~FCDImage ()
 Destructor: do not use directly.
virtual Type GetType () const
 Retrieves the entity type for this class.
const fstring & GetFilename () const
 Retrieves the filename of the image file.
void SetFilename (const fstring &_filename)
 Sets the filename of the image file.
const uint32 & GetWidth () const
 Retrieves the width of the image.
void SetWidth (uint32 _width)
 Sets the width of the image.
const uint32 & GetHeight () const
 Retrieves the height of the image.
void SetHeight (uint32 _height)
 Sets the height of the image.
const uint32 & GetDepth () const
 Retrieves the depth of the 3D image.
void SetDepth (uint32 _depth)
 Sets the depth of the 3D image.
virtual FUStatus LoadFromXML (xmlNode *imageNode)
 [INTERNAL] Reads in the <image> element from a given COLLADA XML tree node.
virtual xmlNode * WriteToXML (xmlNode *parentNode) const
 [INTERNAL] Writes out the <image> element to the given COLLADA XML tree node.

Detailed Description

A COLLADA image.

A COLLADA image encapsulates an image file and are contained within the image library. FCollada doesn't support inlined image bits.

An image is solely defined by its filename. For some image types and optionally, the width, height and depth of the image may be required and valid.


Constructor & Destructor Documentation

FCDImage::FCDImage FCDocument document  ) 
 

Constructor: do not use directly.

Instead, use the FCDLibrary::AddEntity function.

Parameters:
document The COLLADA document that owns the image.

virtual FCDImage::~FCDImage  )  [virtual]
 

Destructor: do not use directly.

Instead, use the FCDLibrary::ReleaseEntity function.


Member Function Documentation

const uint32& FCDImage::GetDepth  )  const [inline]
 

Retrieves the depth of the 3D image.

This parameter is optional for texture image files.

Returns:
The depth of the image. This value will be zero to indicate that you should retrieve the depth of the image from the image file.

const fstring& FCDImage::GetFilename  )  const [inline]
 

Retrieves the filename of the image file.

This is the image file that you should load when attempting to use the image bits. FCollada will deal with the filename internally and provide an absolute filename.

Returns:
The filename of the image file.

const uint32& FCDImage::GetHeight  )  const [inline]
 

Retrieves the height of the image.

This parameter is useful for off-screen render targets and is optional for texture image files.

Returns:
The height of the image. This value will be zero to indicate that you should retrieve the height of the image from the image file.

virtual Type FCDImage::GetType  )  const [inline, virtual]
 

Retrieves the entity type for this class.

This function is part of the FCDEntity class interface.

Returns:
The entity type: IMAGE.

Reimplemented from FCDEntity.

const uint32& FCDImage::GetWidth  )  const [inline]
 

Retrieves the width of the image.

This parameter is useful for off-screen render targets and is optional for texture image files.

Returns:
The width of the image. This value will be zero to indicate that you should retrieve the width of the image from the image file.

virtual FUStatus FCDImage::LoadFromXML xmlNode *  imageNode  )  [virtual]
 

[INTERNAL] Reads in the <image> element from a given COLLADA XML tree node.

Parameters:
imageNode The COLLADA XML tree node.
Returns:
The status of the import. If the status is not successful, it may be dangerous to extract information from the image.

Reimplemented from FCDEntity.

void FCDImage::SetDepth uint32  _depth  )  [inline]
 

Sets the depth of the 3D image.

This parameter is optional for texture image files.

Parameters:
_depth The depth of the image. This value can be zero to indicate that you should retrieve the depth of the image from the image file.

void FCDImage::SetFilename const fstring &  _filename  )  [inline]
 

Sets the filename of the image file.

This is the image file that you should load when attempting to use the image bits. FCollada will deal with the filename internally and export a relative filename.

Parameters:
_filename The filename of the image file.

void FCDImage::SetHeight uint32  _height  )  [inline]
 

Sets the height of the image.

This parameter is useful for off-screen render targets and is optional for texture image files.

Parameters:
_height The height of the image. This value can be zero to indicate that you should retrieve the width of the image from the image file.

void FCDImage::SetWidth uint32  _width  )  [inline]
 

Sets the width of the image.

This parameter is useful for off-screen render targets and is optional for texture image files.

Parameters:
_width The width of the image. This value can be zero to indicate that you should retrieve the width of the image from the image file.

virtual xmlNode* FCDImage::WriteToXML xmlNode *  parentNode  )  const [virtual]
 

[INTERNAL] Writes out the <image> element to the given COLLADA XML tree node.

Parameters:
parentNode The COLLADA XML parent node in which to insert the image.
Returns:
The created element XML tree node.

Reimplemented from FCDEntity.


The documentation for this class was generated from the following file:
Generated on Fri May 12 16:44:43 2006 for FCollada by  doxygen 1.4.6-NO