Home · All Namespaces · All Classes · Functions · Coding Style · Scripting · Plugins · File Structure

StelTexture Class Reference

Base texture class. More...

#include <StelTexture.hpp>

List of all members.

Signals

void loadingProcessFinished (bool error)

Public Member Functions

virtual ~StelTexture ()
bool bind ()
bool canBind () const
bool getDimensions (int &width, int &height)
const QString & getErrorMessage () const
const QString & getFullPath () const
bool isLoading () const
bool glLoad ()

Classes

struct  StelTextureParams
 Contains the parameters defining how a texture is created. More...


Detailed Description

Base texture class.

For creating an instance, use StelTextureMgr::createTexture() and StelTextureMgr::createTextureThread()

See also:
StelTextureSP

Constructor & Destructor Documentation

virtual StelTexture::~StelTexture (  )  [virtual]

Destructor.


Member Function Documentation

bool StelTexture::bind (  ) 

Bind the texture so that it can be used for openGL drawing (calls glBindTexture).

If the texture is lazyly loaded, this starts the loading and return false immediately.

Returns:
true if the binding successfully occured, false if the texture is not yet loaded.

bool StelTexture::canBind (  )  const [inline]

Return whether the texture can be binded, i.e. it is fully loaded.

bool StelTexture::getDimensions ( int &  width,
int &  height 
)

Return the width and heigth of the texture in pixels.

const QString& StelTexture::getErrorMessage (  )  const [inline]

Get the error message which caused the texture loading to fail.

Returns:
the human friendly error message or empty string if no errors occured

const QString& StelTexture::getFullPath (  )  const [inline]

Return the full path to the image file.

If the texture was downloaded from a remote location, this function return the full URL.

bool StelTexture::isLoading (  )  const [inline]

Return whether the image is currently being loaded.

bool StelTexture::glLoad (  ) 

Load the texture already in the RAM to the openGL memory This function uses openGL routines and must be called in the main thread.

Returns:
false if an error occured

void StelTexture::loadingProcessFinished ( bool  error  )  [signal]

Emitted when the texture is ready to be bind(), i.e.

when downloaded, imageLoading and glLoading is over or when an error occured and the texture will never be available In case of error, you can query what the problem was by calling getErrorMessage()

Parameters:
error is equal to true if an error occured while loading the texture


Generated on Mon Mar 22 09:55:39 2010 for Stellarium by  doxygen 1.5.5