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

NativeImage represents a platform specific image resource. 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 ()
 Triggers asynchronous creation of backing GL texture immediately.
const char * GetCustomFragmentPreFix ()
 Gets custom fragment prefix for rendering a native image.
const char * GetCustomSamplerTypename ()
 Gets custom sampler type name for rendering a native image.

Static Public Member Functions

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

Detailed Description

NativeImage represents a platform specific image resource.

Its data is provided by native resources, such as shared bitmap memory or pixmap.

Since:
3.0, DALi version 1.0.0

Constructor & Destructor Documentation

Dali::NativeImage::NativeImage ( )

Constructor with creates an uninitialized NativeImage object.

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

Since:
3.0, DALi version 1.0.0
Dali::NativeImage::~NativeImage ( )

Destructor.

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

Since:
3.0, DALi version 1.0.0
Dali::NativeImage::NativeImage ( const NativeImage &  handle)

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

Since:
3.0, DALi version 1.0.0
Parameters:
[in]handleA reference to the copied handle

Member Function Documentation

void Dali::NativeImage::CreateGlTexture ( )

Triggers 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:
3.0, DALi version 1.0.0
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]

Downcasts a handle to NativeImage handle.

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

Since:
3.0, DALi version 1.0.0
Parameters:
[in]handleHandle to an object
Returns:
handle to a NativeImage or an uninitialized handle

Reimplemented from Dali::Image.

const char* Dali::NativeImage::GetCustomFragmentPreFix ( )

Gets custom fragment prefix for rendering a native image.

Returns:
String for custom fragment prefix
const char* Dali::NativeImage::GetCustomSamplerTypename ( )

Gets custom sampler type name for rendering a native image.

Returns:
String for custom sampler type name
static NativeImage Dali::NativeImage::New ( NativeImageInterface &  nativeImageInterface) [static]

Creates a new NativeImage, which used native resources.

The maximum size of the image is limited by GL_MAX_TEXTURE_SIZE

Since:
3.0, DALi version 1.0.0
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:
3.0, DALi version 1.0.0
Parameters:
[in]rhsA reference to the copied handle
Returns:
A reference to this