The Evas_Canvas3D_Scene structure represents a captured image of a scene graph through its viewing camera. More...
Macros | |
#define | EVAS_CANVAS3D_SCENE_CLASS evas_canvas3d_scene_class_get() |
Efl 3D canvas scene class. | |
Functions | |
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_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. 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. More... | |
EOAPI Eina_Bool | evas_canvas3d_scene_color_pick_enable_set (Eo *obj, Eina_Bool color_pick) |
Set possibility color picking. More... | |
EOAPI void | evas_canvas3d_scene_root_node_set (Eo *obj, Evas_Canvas3D_Node *node) |
The root node of a scene. More... | |
EOAPI Evas_Canvas3D_Node * | evas_canvas3d_scene_root_node_get (const Eo *obj) |
The root node of a scene. More... | |
EOAPI void | evas_canvas3d_scene_camera_node_set (Eo *obj, Evas_Canvas3D_Node *node) |
The camera node of a scene. More... | |
EOAPI Evas_Canvas3D_Node * | evas_canvas3d_scene_camera_node_get (const Eo *obj) |
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) |
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) |
Scale and units used to calculate depth values. More... | |
The Evas_Canvas3D_Scene structure represents a captured image of a scene graph through its viewing camera.
A scene can be associated with an image object for canvas display via the evas_object_image_scene_set() function.
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 image objects. The resolution defines the size of the internal surface holding the rendered result.
[in] | obj | The object. |
[in] | w | Width of the resolution. |
[in] | h | Height of the resolution. |
EOAPI void evas_canvas3d_scene_size_get | ( | const Eo * | obj, |
int * | w, | ||
int * | h | ||
) |
Get the internal resolution of a scene.
[in] | obj | The object. |
[out] | w | Pointer to receive width of the resolution. |
[out] | h | Pointer to receive height of the resolution. |
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 the initial color of pixels before a scene is rendered. If you want to display a scene with background evas objects as if they're part of the background, set the alpha term to 0.0.
Default background color is (0.0, 0.0, 0.0, 0.0).
[in] | obj | The object. |
[in] | r | Red component of the background color. |
[in] | g | Green component of the background color. |
[in] | b | Blue component of the background color. |
[in] | a | Alpha component of the background color. |
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.
[in] | obj | The object. |
[out] | r | Pointer to receive red component of the background color. |
[out] | g | Pointer to receive green component of the background color. |
[out] | b | Pointer to receive blue component of the background color. |
[out] | a | Pointer to receive alpha component of the background color. |
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.
[in] | obj | The object. |
[in] | x | X coordinate of the picking position. |
[in] | y | Y coordinate of the picking position. |
[out] | node | Pointer to receive the node contains the picked mesh. |
[out] | mesh | Pointer to receive the picked mesh. |
[out] | s | Pointer to receive the texture "s" coordinate. |
[out] | t | Pointer to receive the texture "t" coordinate. |
true
on success, false
otherwise 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.
[in] | obj | The object. |
[in] | x | X coordinate of the picking position. |
[in] | y | Y coordinate of the picking position. |
[in] | node | Node for search. |
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.
[in] | obj | The object. |
[in] | x | X coordinate of the picking position. |
[in] | y | Y coordinate of the picking position. |
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.
[in] | obj | The object. |
[in] | shadows_enabled | Shadows enabled status. |
Get shadows enabled status for given scene.
[in] | obj | The object. |
Get status of color picking of the scene.
[in] | obj | The object. |
Set possibility color picking.
[in] | obj | The object. |
[in] | color_pick | Possibility flag |
true
on success, false
otherwise EOAPI void evas_canvas3d_scene_root_node_set | ( | Eo * | obj, |
Evas_Canvas3D_Node * | node | ||
) |
The root node of a scene.
[in] | obj | The object. |
[in] | node | A node which will be used as a root node for the scene. |
EOAPI Evas_Canvas3D_Node* evas_canvas3d_scene_root_node_get | ( | const Eo * | obj | ) |
The root node of a scene.
[in] | obj | The object. |
EOAPI void evas_canvas3d_scene_camera_node_set | ( | Eo * | obj, |
Evas_Canvas3D_Node * | node | ||
) |
The camera node of a scene.
[in] | obj | The object. |
[in] | node | A node which will be used as a camera node for the scene. |
EOAPI Evas_Canvas3D_Node* evas_canvas3d_scene_camera_node_get | ( | const Eo * | obj | ) |
The camera node of a scene.
[in] | obj | The object. |
EOAPI void evas_canvas3d_scene_shadows_depth_set | ( | Eo * | obj, |
Evas_Real | depth_offset, | ||
Evas_Real | depth_constant | ||
) |
Scale and units used to calculate depth values.
[in] | obj | The object. |
[in] | depth_offset | Scale factor that is used to create a variable depth offset for each polygon. |
[in] | depth_constant | Value to create a constant depth offset |
EOAPI void evas_canvas3d_scene_shadows_depth_get | ( | const Eo * | obj, |
Evas_Real * | depth_offset, | ||
Evas_Real * | depth_constant | ||
) |
Scale and units used to calculate depth values.
[in] | obj | The object. |
[out] | depth_offset | Scale factor that is used to create a variable depth offset for each polygon. |
[out] | depth_constant | Value to create a constant depth offset |