Functions
Scene Object

A scene represents a captured image of a scene graph through its viewing camera. More...

Functions

EOAPI void evas_canvas3d_scene_root_node_set (Eo *obj, Evas_Canvas3D_Node *node)
 Set the root node of a scene. More...
 
EOAPI Evas_Canvas3D_Node * evas_canvas3d_scene_root_node_get (const Eo *obj)
 Get the root node of a scene. More...
 
EOAPI void evas_canvas3d_scene_camera_node_set (Eo *obj, Evas_Canvas3D_Node *node)
 Set the camera node of a scene. More...
 
EOAPI Evas_Canvas3D_Node * evas_canvas3d_scene_camera_node_get (const Eo *obj)
 Get the camera node of a scene. More...
 
EOAPI void evas_canvas3d_scene_shadows_depth_set (Eo *obj, Evas_Real depth_offset, Evas_Real depth_constant)
 Set scale and units used to calculate depth values. More...
 
EOAPI void evas_canvas3d_scene_shadows_depth_get (const Eo *obj, Evas_Real *depth_offset, Evas_Real *depth_constant)
 Get scale and units used to calculate depth values. More...
 
EOAPI void evas_canvas3d_scene_size_set (Eo *obj, int w, int h)
 Set the resolution of a scene. More...
 
EOAPI void evas_canvas3d_scene_size_get (const Eo *obj, int *w, int *h)
 Get the internal resolution of a scene. More...
 
EOAPI void evas_canvas3d_scene_background_color_set (Eo *obj, Evas_Real r, Evas_Real g, Evas_Real b, Evas_Real a)
 Set the background color of a scene. More...
 
EOAPI void evas_canvas3d_scene_background_color_get (const Eo *obj, Evas_Real *r, Evas_Real *g, Evas_Real *b, Evas_Real *a)
 Get the background color of a scene. More...
 
EOAPI Eina_Bool evas_canvas3d_scene_pick (const Eo *obj, Evas_Real x, Evas_Real y, Evas_Canvas3D_Node **node, Evas_Canvas3D_Mesh **mesh, Evas_Real *s, Evas_Real *t)
 Get information on the most front visible mesh for the given position. More...
 
EOAPI Evas_Canvas3D_Node * evas_canvas3d_scene_exist (const Eo *obj, Evas_Real x, Evas_Real y, Evas_Canvas3D_Node *node)
 Search given node in the given position. More...
 
EOAPI Eina_Listevas_canvas3d_scene_pick_member_list_get (const Eo *obj, Evas_Real x, Evas_Real y)
 Get list of the all root members from scene in the given position. More...
 
EOAPI void evas_canvas3d_scene_shadows_enable_set (Eo *obj, Eina_Bool shadows_enabled)
 Enable or disable shadows on given scene. More...
 
EOAPI Eina_Bool evas_canvas3d_scene_shadows_enable_get (const Eo *obj)
 Get shadows enabled status for given scene. More...
 
EOAPI Eina_Bool evas_canvas3d_scene_color_pick_enable_get (const Eo *obj)
 Get status of color picking of the scene.
 
EOAPI Eina_Bool evas_canvas3d_scene_color_pick_enable_set (Eo *obj, Eina_Bool color_pick)
 Set posibility color picking. More...
 

Detailed Description

A scene represents a captured image of a scene graph through its viewing camera.

A scene can be set to an image object to be displayed on the Evas canvas by using evas_object_image_scene_set() function.

Function Documentation

◆ evas_canvas3d_scene_root_node_set()

EOAPI void evas_canvas3d_scene_root_node_set ( Eo obj,
Evas_Canvas3D_Node *  node 
)

Set the root node of a scene.

Parameters
[in]nodeA node which will be used as a root node for the scene.

◆ evas_canvas3d_scene_root_node_get()

EOAPI Evas_Canvas3D_Node* evas_canvas3d_scene_root_node_get ( const Eo obj)

Get the root node of a scene.

Returns
A node which will be used as a root node for the scene.

◆ evas_canvas3d_scene_camera_node_set()

EOAPI void evas_canvas3d_scene_camera_node_set ( Eo obj,
Evas_Canvas3D_Node *  node 
)

Set the camera node of a scene.

Parameters
[in]nodeA node which will be used as a camera node for the scene.

◆ evas_canvas3d_scene_camera_node_get()

EOAPI Evas_Canvas3D_Node* evas_canvas3d_scene_camera_node_get ( const Eo obj)

Get the camera node of a scene.

Returns
A node which will be used as a camera node for the scene.

◆ evas_canvas3d_scene_shadows_depth_set()

EOAPI void evas_canvas3d_scene_shadows_depth_set ( Eo obj,
Evas_Real  depth_offset,
Evas_Real  depth_constant 
)

Set scale and units used to calculate depth values.

Parameters
[in]depth_offsetScale factor that is used to create a variable depth offset for each polygon.
[in]depth_constantValue to create a constant depth offset

◆ evas_canvas3d_scene_shadows_depth_get()

EOAPI void evas_canvas3d_scene_shadows_depth_get ( const Eo obj,
Evas_Real depth_offset,
Evas_Real depth_constant 
)

Get scale and units used to calculate depth values.

Parameters
[out]depth_offsetScale factor that is used to create a variable depth offset for each polygon.
[out]depth_constantValue to create a constant depth offset

◆ evas_canvas3d_scene_size_set()

EOAPI void evas_canvas3d_scene_size_set ( Eo obj,
int  w,
int  h 
)

Set the resolution of a scene.

A scene should be rendered to be displayed through an image objects. The resolution defines size of the internal surface holding the rendered result.

Parameters
[in]wWidth of the resolution.
[in]hHeight of the resolution.

◆ evas_canvas3d_scene_size_get()

EOAPI void evas_canvas3d_scene_size_get ( const Eo obj,
int *  w,
int *  h 
)

Get the internal resolution of a scene.

Parameters
[out]wPointer to receive width of the resolution.
[out]hPointer to receive height of the resolution.

◆ evas_canvas3d_scene_background_color_set()

EOAPI void evas_canvas3d_scene_background_color_set ( Eo obj,
Evas_Real  r,
Evas_Real  g,
Evas_Real  b,
Evas_Real  a 
)

Set the background color of a scene.

Background color defines initial color of pixels before a scene is rendered. If you want to display a scene with background evas objects are still remaining as if it was the background, set the alpha term to 0.0.

Default background color is (0.0, 0.0, 0.0, 0.0).

Parameters
[in]rRed component of the background color.
[in]gGreen component of the background color.
[in]bBlue component of the background color.
[in]aAlpha component of the background color.

◆ evas_canvas3d_scene_background_color_get()

EOAPI void evas_canvas3d_scene_background_color_get ( const Eo obj,
Evas_Real r,
Evas_Real g,
Evas_Real b,
Evas_Real a 
)

Get the background color of a scene.

Parameters
[out]rPointer to receive red component of the background color.
[out]gPointer to receive green component of the background color.
[out]bPointer to receive blue component of the background color.
[out]aPointer to receive alpha component of the background color.

◆ evas_canvas3d_scene_pick()

EOAPI Eina_Bool evas_canvas3d_scene_pick ( const Eo obj,
Evas_Real  x,
Evas_Real  y,
Evas_Canvas3D_Node **  node,
Evas_Canvas3D_Mesh **  mesh,
Evas_Real s,
Evas_Real t 
)

Get information on the most front visible mesh for the given position.

(x, y) is the screen coordinate of the given scene. That is, left-top is (0, 0) and right-bottom is (w, h) where (w, h) is the size of the scene. The texture coordinate is useful when using proxy texture source.

Parameters
[in]xX coordinate of the picking position.
[in]yY coordinate of the picking position.
[out]nodePointer to receive the node contains the picked mesh.
[out]meshPointer to receive the picked mesh.
[out]sPointer to receive the texture "s" coordinate.
[out]tPointer to receive the texture "t" coordinate.

◆ evas_canvas3d_scene_exist()

EOAPI Evas_Canvas3D_Node* evas_canvas3d_scene_exist ( const Eo obj,
Evas_Real  x,
Evas_Real  y,
Evas_Canvas3D_Node *  node 
)

Search given node in the given position.

Parameters
[in]xX coordinate of the picking position.
[in]yY coordinate of the picking position.
[in]nodeNode for search.

◆ evas_canvas3d_scene_pick_member_list_get()

EOAPI Eina_List* evas_canvas3d_scene_pick_member_list_get ( const Eo obj,
Evas_Real  x,
Evas_Real  y 
)

Get list of the all root members from scene in the given position.

Parameters
[in]xX coordinate of the picking position.
[in]yY coordinate of the picking position.

◆ evas_canvas3d_scene_shadows_enable_set()

EOAPI void evas_canvas3d_scene_shadows_enable_set ( Eo obj,
Eina_Bool  shadows_enabled 
)

Enable or disable shadows on given scene.

If shadows_enabled is true, the objects in the scene can throw shadow to another objects located behind them. The depth map used for shading. Directed and projective light sources are supported.

Parameters
[in]shadows_enabledShadows enabled status.

◆ evas_canvas3d_scene_shadows_enable_get()

EOAPI Eina_Bool evas_canvas3d_scene_shadows_enable_get ( const Eo obj)

Get shadows enabled status for given scene.

Returns
The shadows enabled status.

◆ evas_canvas3d_scene_color_pick_enable_set()

EOAPI Eina_Bool evas_canvas3d_scene_color_pick_enable_set ( Eo obj,
Eina_Bool  color_pick 
)

Set posibility color picking.

Parameters
[in]color_pickPosibility flag