Tizen Native API  3.0

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 Elm_GLView:

  • "focused" - when glview has received focus.
  • "unfocused" - when glview has lost focus.
  • "language,changed" - the program's language changed

Functions

Evas_Objectelm_glview_add (Evas_Object *parent)

Enumeration Type Documentation

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.

Note:
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 Rendering GL on Evas for more information about direct rendering.
See also:
elm_glview_mode_set
OpenGL with Elementary
Enumerator:
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

Defines a policy for gl rendering.

The rendering policy tells glview where to run the gl rendering code. ELM_GLVIEW_RENDER_POLICY_ON_DEMAND tells glview to call the rendering calls on demand, which means that the rendering code gets called only when it is visible.

Note:
Default is ELM_GLVIEW_RENDER_POLICY_ON_DEMAND
Enumerator:
ELM_GLVIEW_RENDER_POLICY_ON_DEMAND 

Render only when there is a need for redrawing

ELM_GLVIEW_RENDER_POLICY_ALWAYS 

Render always even when it is not visible

Defines a policy for the glview resizing.

The resizing policy tells glview what to do with the underlying surface when resize happens. ELM_GLVIEW_RESIZE_POLICY_RECREATE will destroy the current surface and recreate the surface to the new size. ELM_GLVIEW_RESIZE_POLICY_SCALE will instead keep the current surface but only display the result at the desired size scaled.

Note:
Default is ELM_GLVIEW_RESIZE_POLICY_RECREATE
Enumerator:
ELM_GLVIEW_RESIZE_POLICY_RECREATE 

Resize the internal surface along with the image

ELM_GLVIEW_RESIZE_POLICY_SCALE 

Only resize the internal image and not the surface


Function Documentation

Add a new glview to the parent

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