Typedefs | Enumerations | Functions
GLView

Typedefs

typedef void(* Elm_GLView_Func_Cb) (Evas_Object *obj)
 

Enumerations

enum  Elm_GLView_Mode {
  ELM_GLVIEW_NONE = 0,
  ELM_GLVIEW_ALPHA = 2,
  ELM_GLVIEW_DEPTH = 4,
  ELM_GLVIEW_STENCIL = 8,
  ELM_GLVIEW_DIRECT = 16,
  ELM_GLVIEW_CLIENT_SIDE_ROTATION = 32,
  ELM_GLVIEW_DEPTH_8 = 68,
  ELM_GLVIEW_DEPTH_16 = 132,
  ELM_GLVIEW_DEPTH_24 = 196,
  ELM_GLVIEW_DEPTH_32 = 260,
  ELM_GLVIEW_STENCIL_1 = 520,
  ELM_GLVIEW_STENCIL_2 = 1032,
  ELM_GLVIEW_STENCIL_4 = 1544,
  ELM_GLVIEW_STENCIL_8 = 2056,
  ELM_GLVIEW_STENCIL_16 = 2568,
  ELM_GLVIEW_MULTISAMPLE_LOW = 4096,
  ELM_GLVIEW_MULTISAMPLE_MED = 8192,
  ELM_GLVIEW_MULTISAMPLE_HIGH = 12288
}
 Selects the target surface properties. More...
 

Functions

Evas_Objectelm_glview_add (Evas_Object *parent)
 Add a new glview to the parent. More...
 
void elm_glview_changed_set (Evas_Object *obj)
 Notifies that there has been changes in the GLView. More...
 
void elm_glview_size_get (const Evas_Object *obj, int *w, int *h)
 Gets the size of the GLView. More...
 
void elm_glview_size_set (Evas_Object *obj, int w, int h)
 Sets the size of the GLView. More...
 
void elm_glview_del_func_set (Evas_Object *obj, Elm_GLView_Func_Cb func)
 Set the delete function that runs in the main loop. More...
 
void elm_glview_resize_func_set (Evas_Object *obj, Elm_GLView_Func_Cb func)
 Set the resize function that gets called when resize happens. More...
 
void elm_glview_render_func_set (Evas_Object *obj, Elm_GLView_Func_Cb func)
 Set the render function that runs in the main loop. More...
 

Detailed Description

glview_inheritance_tree.png

A GLView widget allows for simple GL rendering in elementary environment. GLView hides all the complicated evas_gl details so that the user only has to deal with registering a few callback functions for rendering to a surface using OpenGL APIs.

This widget emits the following signals, besides the ones sent from GLView:

Below is an illustrative example of how to use GLView and and OpenGL to render in elementary environment. glview_example_01_page

Enumeration Type Documentation

◆ Elm_GLView_Mode

Selects the target surface properties.

An OR combination of Elm_GLView_Mode values should be passed to elm_glview_mode_set when setting up a GL widget. These flags will specify the properties of the rendering target surface; in particular, the mode can request the surface to support alpha, depth and stencil buffers.

ELM_GLVIEW_CLIENT_SIDE_ROTATION is a special value that indicates to EFL that the application will handle the view rotation when the device is rotated. This is needed only when the application requests direct rendering. Please refer to Evas_GL for more information about direct rendering.

See elm_glview_mode_set See elm_opengl_page

Enumerator
ELM_GLVIEW_NONE 

Default mode.

ELM_GLVIEW_ALPHA 

Alpha channel enabled rendering mode.

ELM_GLVIEW_DEPTH 

Depth buffer enabled rendering mode (24 bits by default)

ELM_GLVIEW_STENCIL 

Stencil buffer enabled rendering mode (8 bits by default)

ELM_GLVIEW_DIRECT 

Request direct rendering, unless there must be a fallback.

ELM_GLVIEW_CLIENT_SIDE_ROTATION 

Client will handle GL view rotation if direct rendering is enabled.

ELM_GLVIEW_DEPTH_8 

Request min.

8 bits for the depth buffer

ELM_GLVIEW_DEPTH_16 

Request min.

16 bits for the depth buffer

ELM_GLVIEW_DEPTH_24 

Request min.

24 bits for the depth buffer (default)

ELM_GLVIEW_DEPTH_32 

Request min.

32 bits for the depth buffer

ELM_GLVIEW_STENCIL_1 

Request min.

1 bits for the stencil buffer

ELM_GLVIEW_STENCIL_2 

Request min.

2 bits for the stencil buffer

ELM_GLVIEW_STENCIL_4 

Request min.

4 bits for the stencil buffer

ELM_GLVIEW_STENCIL_8 

Request min.

8 bits for the stencil buffer (default)

ELM_GLVIEW_STENCIL_16 

Request min.

16 bits for the stencil buffer

ELM_GLVIEW_MULTISAMPLE_LOW 

MSAA with minimum number of samples.

ELM_GLVIEW_MULTISAMPLE_MED 

MSAA with half the number of maximum samples.

ELM_GLVIEW_MULTISAMPLE_HIGH 

MSAA with maximum number of samples.

Function Documentation

◆ elm_glview_add()

Evas_Object* elm_glview_add ( Evas_Object parent)

Add a new glview to the parent.

Parameters
parentThe parent object
Returns
The new object or NULL if it cannot be created

◆ elm_glview_changed_set()

void elm_glview_changed_set ( Evas_Object obj)

Notifies that there has been changes in the GLView.

Parameters
objThe GLView object

◆ elm_glview_size_get()

void elm_glview_size_get ( const Evas_Object obj,
int *  w,
int *  h 
)

Gets the size of the GLView.

Parameters
objThe GLView object
wpointer of int width
hpointer of int height

◆ elm_glview_size_set()

void elm_glview_size_set ( Evas_Object obj,
int  w,
int  h 
)

Sets the size of the GLView.

Parameters
objThe GLView object
wwidth of GLView
hheight of GLView

◆ elm_glview_del_func_set()

void elm_glview_del_func_set ( Evas_Object obj,
Elm_GLView_Func_Cb  func 
)

Set the delete function that runs in the main loop.

Parameters
objThe GLView object
funcThe callback function

◆ elm_glview_resize_func_set()

void elm_glview_resize_func_set ( Evas_Object obj,
Elm_GLView_Func_Cb  func 
)

Set the resize function that gets called when resize happens.

Parameters
objThe GLView object
funcThe callback function

◆ elm_glview_render_func_set()

void elm_glview_render_func_set ( Evas_Object obj,
Elm_GLView_Func_Cb  func 
)

Set the render function that runs in the main loop.

Parameters
objThe GLView object
funcThe callback function