Tizen Native API
Public Member Functions | Static Public Member Functions
Dali::NativeImage Class Reference
Images

NativeImage represents an image resource that can be added to ImageViews. More...

Inheritance diagram for Dali::NativeImage:
Dali::Image Dali::BaseHandle

Public Member Functions

 NativeImage ()
 Constructor with creates an uninitialized NativeImage object.
 ~NativeImage ()
 Destructor.
 NativeImage (const NativeImage &handle)
 This copy constructor is required for (smart) pointer semantics.
NativeImage & operator= (const NativeImage &rhs)
 This assignment operator is required for (smart) pointer semantics.
void CreateGlTexture ()
 Trigger asynchronous creation of backing GL texture immediately.

Static Public Member Functions

static NativeImage New (NativeImageInterface &nativeImageInterface)
 Create a new NativeImage, which used native resources.
static NativeImage DownCast (BaseHandle handle)
 Downcast a handle to NativeImage handle.

Detailed Description

NativeImage represents an image resource that can be added to ImageViews.

Its data is provided by native resources, such as shared bitmap memory or pixmap from X11 or ECORE-X11, etc.

Since :
2.4

Constructor & Destructor Documentation

Dali::NativeImage::NativeImage ( )

Constructor with creates an uninitialized NativeImage object.

Use NativeImage::New(...) to create an initialised object.

Since :
2.4
Dali::NativeImage::~NativeImage ( )

Destructor.

This is non-virtual since derived Handle types must not contain data or virtual methods.

Since :
2.4
Dali::NativeImage::NativeImage ( const NativeImage &  handle)

This copy constructor is required for (smart) pointer semantics.

Since :
2.4
Parameters:
[in]handleA reference to the copied handle

Member Function Documentation

void Dali::NativeImage::CreateGlTexture ( )

Trigger asynchronous creation of backing GL texture immediately.

The normal policy is for a GL texture to created lazily when needed. This function forces the allocation of a texture to happen at the earliest opportunity.

Since :
2.4
Note:
If the application loses its GL context, native images may lose their GL textures. This function can be called again after context regain to force the creation of the GL texture if still needed.
static NativeImage Dali::NativeImage::DownCast ( BaseHandle  handle) [static]

Downcast a handle to NativeImage handle.

If handle points to a NativeImage object, the downcast produces valid handle. If not, the returned handle is left unintialized.

Since :
2.4
Parameters:
[in]handleHandle to an object.
Returns:
handle to a NativeImage or an uninitialized handle.

Reimplemented from Dali::Image.

static NativeImage Dali::NativeImage::New ( NativeImageInterface &  nativeImageInterface) [static]

Create a new NativeImage, which used native resources.

The maximum size of the image is limited by GL_MAX_TEXTURE_SIZE

Since :
2.4
Parameters:
[in]nativeImageInterfaceAn reference to the object of the interface implementation.
Returns:
A handle to a newly allocated object.
NativeImage& Dali::NativeImage::operator= ( const NativeImage &  rhs)

This assignment operator is required for (smart) pointer semantics.

Since :
2.4
Parameters:
[in]rhsA reference to the copied handle.
Returns:
A reference to this.