Public Attributes
int	version
Evas_Native_Surface_Type	type
union {
struct {
void * visual
unsigned long pixmap
} x11
struct {
unsigned int texture_id
unsigned int framebuffer_id
unsigned int internal_format
unsigned int format
unsigned int h
} opengl
struct {
void * legacy_buffer
} wl
struct {
void * buffer
int rot
float ratio
int flip
} tbm
struct {
void * surface
} evasgl
}	data

Detailed Description

A generic datatype for engine specific native surface information.

Please fill up Evas_Native_Surface fields that regarded with current surface type. If you want to set the native surface type to EVAS_NATIVE_SURFACE_X11, you need to set union data with x11.visual or x11.pixmap. If you need to set the native surface as EVAS_NATIVE_SURFACE_OPENGL, on the other hand, you need to set union data with opengl.texture_id or opengl.framebuffer_id and so on. If you need to set the native surface as EVAS_NATIVE_SURFACE_WL, you need to set union data with wl.legacy_buffer. If you need to set the native surface as EVAS_NATIVE_SURFACE_TBM, you need to set union data with tbm surface. The version field should be set with EVAS_NATIVE_SURFACE_VERSION in order to check abi break in your application on the different efl library versions.

Warning:: Native surface types totally depend on the system. Please be aware that the types are supported on your system before using them.

Note:: The information stored in an Evas_Native_Surface returned by evas_gl_native_surface_get() is not meant to be used by applications except for passing it to evas_object_image_native_surface_set().

See also:: evas_object_image_native_surface_set()

Member Data Documentation

void* _Evas_Native_Surface::buffer

tbm surface buffer to use

Since (EFL) :: 1.14

union { ... } _Evas_Native_Surface::data

Choose one union data according to your surface.

struct { ... } _Evas_Native_Surface::evasgl

Set this struct fields if surface data is Evas GL based.

Since (EFL) :: 1.14

int _Evas_Native_Surface::flip

flip (EVAS_IMAGE_FLIP_HORIZONTAL:horizontal, EVAS_IMAGE_FLIP_VERTICAL:vertical)

Since (EFL) :: 1.14

unsigned int _Evas_Native_Surface::format

same as 'format' for glTexImage2D()

unsigned int _Evas_Native_Surface::framebuffer_id

0 if not a FBO, FBO id otherwise from glGenFramebuffers()

unsigned int _Evas_Native_Surface::h

region inside the texture to use (image size is assumed as texture size, with 0, 0 being the top-left and co-ordinates working down to the right and bottom being positive)

unsigned int _Evas_Native_Surface::internal_format

same as 'internalFormat' for glTexImage2D()

void* _Evas_Native_Surface::legacy_buffer

wayland client buffer to use

struct { ... } _Evas_Native_Surface::opengl

Set this struct fields if surface data is OpenGL based.

unsigned long _Evas_Native_Surface::pixmap

pixmap id to use (Pixmap)

float _Evas_Native_Surface::ratio

width/height ratio of the source image