evas canvas3d: Eolian doc conversion of canvas3d_node.

Summary: Signed-off-by: Srivardhan Hebbar <sri.hebbar@samsung.com>

Reviewers: cedric, tasn, q66

Reviewed By: q66

Subscribers: cedric

Differential Revision: https://phab.enlightenment.org/D2839
This commit is contained in:
Srivardhan Hebbar 2015-07-20 11:53:56 +01:00 committed by Daniel Kolesa
parent 4bc09bd09e
commit 03fe4813e9
1 changed files with 126 additions and 367 deletions

View File

@ -4,149 +4,98 @@ class Evas.Canvas3D.Node (Evas.Canvas3D.Object, Evas.Common_Interface)
data: Evas_Canvas3D_Node_Data;
methods {
constructor {
/*@ Constructor. */
[[Constructor.]]
legacy: null;
params {
@in type: Evas.Canvas3D.Node_Type;
}
}
type_get @const {
/*@
Get the type of the given node.
[[Get the type of the given node.
@return The type of the given node.
@see evas_canvas3d_node_add()
@ingroup Evas_Canvas3D_Node
*/
return: Evas.Canvas3D.Node_Type ;
See also @Evas.Canvas3D.Node.member_add.]]
return: Evas.Canvas3D.Node_Type ; [[The type of the given node.]]
}
member_add {
/*@
Add a member node to the given node.
[[Add a member node to the given node.
Nodes can be constructed into N-ary tree structure like other ordinary scene
graph. Basically a node inherit transforms from its parent.
@see evas_canvas3d_node_parent_get()
@ingroup Evas_Canvas3D_Node
*/
See also @Evas.Canvas3D.Node.parent_get.]]
params {
@in member: Evas.Canvas3D.Node *; /*@ Node object to be added. */
@in member: Evas.Canvas3D.Node *; [[Node object to be added.]]
}
}
member_del {
/*@
Delete a member node from the given node.
@see evas_canvas3d_node_member_add()
@ingroup Evas_Canvas3D_Node
*/
[[Delete a member node from the given node.
See also @Evas.Canvas3D.Node.member_add.]]
params {
@in member: Evas.Canvas3D.Node *; /*@ Member node to be deleted from the given node. */
@in member: Evas.Canvas3D.Node *; [[Member node to be deleted from the given node.]]
}
}
parent_get @const {
/*@
Get the parent node of the given node.
[[Get the parent node of the given node.
@return The parent node of the given node.
@see evas_canvas3d_node_member_add()
@ingroup Evas_Canvas3D_Node
*/
return: Evas.Canvas3D.Node *;
See also @Evas.Canvas3D.Node.member_add.]]
return: Evas.Canvas3D.Node *; [[The parent node of the given node.]]
}
member_list_get @const {
/*@
Get the list of member nodes of the given node.
[[Get the list of member nodes of the given node.
@return The list of member nodes if any or @c NULL if there are none.
@see evas_canvas3d_node_member_add()
@ingroup Evas_Canvas3D_Node
*/
return: const(list<Evas.Canvas3D.Node *>)*;
See also @Evas.Canvas3D.Node.member_add.]]
return: const(list<Evas.Canvas3D.Node *>)*; [[The list of member nodes if any or $null if there are none.]]
}
position_set {
/*@
Set the position of the given node.
[[Set the position of the given node.
According to the inheritance flag, (x, y, z) can be a world space position or
parent space position.
Default position is (0.0, 0.0, 0.0).
@see evas_canvas3d_node_position_inherit_set()
@ingroup Evas_Canvas3D_Node_Transform
*/
See also @Evas.Canvas3D.Node.position_inherit.set.]]
params {
@in x: Evas_Real; /*@ X coordinate of the position. */
@in y: Evas_Real; /*@ Y coordinate of the position. */
@in z: Evas_Real; /*@ Z coordinate of the position. */
@in x: Evas_Real; [[X coordinate of the position.]]
@in y: Evas_Real; [[Y coordinate of the position.]]
@in z: Evas_Real; [[Z coordinate of the position.]]
}
}
orientation_set {
/*@
Set the orientation of the given node using quaternion.
[[Set the orientation of the given node using quaternion.
According the the inheritance flag, (w, x, y, z) can be a world space
orientation or parent space orientation.
Default orientation is (1.0, 0.0, 0.0, 0.0) (identity quaternion).
@see evas_canvas3d_node_orientation_inherit_set()
@ingroup Evas_Canvas3D_Node_Transform
*/
See also @Evas.Canvas3D.Node.orientation_inherit.set.]]
params {
@in x: Evas_Real; /*@ X term of the orientation quaternion (w, x, y, z) */
@in y: Evas_Real; /*@ Y term of the orientation quaternion (w, x, y, z) */
@in z: Evas_Real; /*@ Z term of the orientation quaternion (w, x, y, z) */
@in w: Evas_Real; /*@ W term of the orientation quaternion (w, x, y, z) */
@in x: Evas_Real; [[X term of the orientation quaternion (w, x, y, z.]]
@in y: Evas_Real; [[Y term of the orientation quaternion (w, x, y, z.]]
@in z: Evas_Real; [[Z term of the orientation quaternion (w, x, y, z.]]
@in w: Evas_Real; [[W term of the orientation quaternion (w, x, y, z.]]
}
}
orientation_angle_axis_set {
/*@
Set the orientation of the given node using axis-angle.
[[Set the orientation of the given node using axis-angle.
@param node The given node.
@param angle Rotation angle.
@param x X term of the rotation axis.
@param y Y term of the rotation axis.
@param z Z term of the rotation axis.
@see evas_canvas3d_node_orientation_set()
@ingroup Evas_Canvas3D_Node_Transform
*/
See also @Evas.Canvas3D.Node.orientation_set.]]
params {
@in angle: Evas_Real; /*@ Rotation angle.*/
@in x: Evas_Real; /*@ X term of the rotation axis.*/
@in y: Evas_Real; /*@ Y term of the rotation axis.*/
@in z: Evas_Real; /*@ Z term of the rotation axis.*/
@in angle: Evas_Real; [[Rotation angle.]]
@in x: Evas_Real; [[X term of the rotation axis.]]
@in y: Evas_Real; [[Y term of the rotation axis.]]
@in z: Evas_Real; [[Z term of the rotation axis.]]
}
}
scale_set {
/*@
Set the scale of the given node.
@param node The given node.
@param x Scale factor along X-axis.
@param y Scale factor along Y-axis.
@param z Scale factor along Z-axis.
[[Set the scale of the given node.
According to the inheritance flag, (x, y, z) can be a world space scale or
parent space scale. Be careful when using non-uniform scale factor with
@ -154,452 +103,262 @@ class Evas.Canvas3D.Node (Evas.Canvas3D.Object, Evas.Common_Interface)
Default scale is (1.0, 1.0, 1.0).
@see evas_canvas3d_node_scale_inherit_set()
@ingroup Evas_Canvas3D_Node_Transform
*/
See also @Evas.Canvas3D.Node.scale_inherit.set.]]
params {
@in x: Evas_Real; /*@ Scale factor along X-axis.*/
@in y: Evas_Real; /*@ Scale factor along Y-axis.*/
@in z: Evas_Real; /*@ Scale factor along Z-axis.*/
@in x: Evas_Real; [[Scale factor along X-axis.]]
@in y: Evas_Real; [[Scale factor along Y-axis.]]
@in z: Evas_Real; [[Scale factor along Z-axis.]]
}
}
position_get @const {
/*@
Get the position of the given node.
[[Get the position of the given node.
@param node The given node.
@param x Pointer to receive X coordinate of the position.
@param y Pointer to receive Y coordinate of the position.
@param z Pointer to receive Z coordinate of the position.
@see evas_canvas3d_node_position_set()
@ingroup Evas_Canvas3D_Node_Transform
*/
See also @Evas.Canvas3D.Node.position_set.]]
params {
@in space: Evas.Canvas3D.Space; /*@ */
@out x: Evas_Real; /*@ Pointer to receive X coordinate of the position.*/
@out y: Evas_Real; /*@ Pointer to receive Y coordinate of the position.*/
@out z: Evas_Real; /*@ Pointer to receive Z coordinate of the position.*/
@in space: Evas.Canvas3D.Space; [[The given node.]]
@out x: Evas_Real; [[Pointer to receive X coordinate of the position.]]
@out y: Evas_Real; [[Pointer to receive Y coordinate of the position.]]
@out z: Evas_Real; [[Pointer to receive Z coordinate of the position.]]
}
}
orientation_get @const {
/*@
Get the orientation of the given node as quaternion.
[[Get the orientation of the given node as quaternion.
@param node The given node.
@param x Pointer to receive X term of the orientation quaternion.
@param y Pointer to receive Y term of the orientation quaternion.
@param z Pointer to receive Z term of the orientation quaternion.
@param w Pointer to receive W term of the orientation quaternion.
@see evas_canvas3d_node_orientation_set()
@ingroup Evas_Canvas3D_Node_Transform
*/
See also @Evas.Canvas3D.Node.orientation_set.]]
params {
@in space: Evas.Canvas3D.Space; /*@ */
@out x: Evas_Real; /*@ Pointer to receive X term of the orientation quaternion.*/
@out y: Evas_Real; /*@ Pointer to receive Y term of the orientation quaternion.*/
@out z: Evas_Real; /*@ Pointer to receive Z term of the orientation quaternion.*/
@out w: Evas_Real; /*@ Pointer to receive W term of the orientation quaternion.*/
@in space: Evas.Canvas3D.Space; [[The given node.]]
@out x: Evas_Real; [[Pointer to receive X term of the orientation quaternion.]]
@out y: Evas_Real; [[Pointer to receive Y term of the orientation quaternion.]]
@out z: Evas_Real; [[Pointer to receive Z term of the orientation quaternion.]]
@out w: Evas_Real; [[Pointer to receive W term of the orientation quaternion.]]
}
}
scale_get @const {
/*@
Get the scale of the given node.
[[Get the scale of the given node.
@param node The given node.
@param x Pointer to receive Scale factor along X-axis.
@param y Pointer to receive Scale factor along Y-axis.
@param z Pointer to receive Scale factor along Z-axis.
@see evas_canvas3d_node_scale_get()
@ingroup Evas_Canvas3D_Node_Transform
*/
See also @Evas.Canvas3D.Node.scale_get.]]
params {
@in space: Evas.Canvas3D.Space; /*@ */
@out x: Evas_Real; /*@ Pointer to receive Scale factor along X-axis.*/
@out y: Evas_Real; /*@ Pointer to receive Scale factor along X-axis.*/
@out z: Evas_Real; /*@ Pointer to receive Scale factor along X-axis.*/
@in space: Evas.Canvas3D.Space; [[The given node.]]
@out x: Evas_Real; [[Pointer to receive Scale factor along X-axis.]]
@out y: Evas_Real; [[Pointer to receive Scale factor along X-axis.]]
@out z: Evas_Real; [[Pointer to receive Scale factor along X-axis.]]
}
}
look_at_set {
/*@
Rotate the given node to look at desired position.
@param node The given node.
@param target_space Space where the target position belongs to.
@param x X coordinate of the target position.
@param y Y coordinate of the target position.
@param z Z coordinate of the target position.
@param up_space Space where the up vector belongs to.
@param ux X term of the up vector.
@param uy Y term of the up vector.
@param uz Z term of the up vector.
[[Rotate the given node to look at desired position.
This function rotate the given node so that its forward vector (negative
Z-axis) points to the desired position and the up vector coincide with the
given up vector.
@see evas_canvas3d_node_orientation_set()
@ingroup Evas_Canvas3D_Node_Transform
*/
See also @Evas.Canvas3D.Node.orientation_set.]]
params {
@in target_space: Evas.Canvas3D.Space; /*@ Space where the target position belongs to. */
@in x: Evas_Real; /*@ X coordinate of the target position. */
@in y: Evas_Real; /*@ Y coordinate of the target position. */
@in z: Evas_Real; /*@ Z coordinate of the target position. */
@in up_space: Evas.Canvas3D.Space; /*@ Space where the up vector belongs to. */
@in ux: Evas_Real; /*@ X term of the up vector. */
@in uy: Evas_Real; /*@ Y term of the up vector. */
@in uz: Evas_Real; /*@ Z term of the up vector. */
@in target_space: Evas.Canvas3D.Space; [[Space where the target position belongs to.]]
@in x: Evas_Real; [[X coordinate of the target position.]]
@in y: Evas_Real; [[Y coordinate of the target position.]]
@in z: Evas_Real; [[Z coordinate of the target position.]]
@in up_space: Evas.Canvas3D.Space; [[Space where the up vector belongs to.]]
@in ux: Evas_Real; [[X term of the up vector.]]
@in uy: Evas_Real; [[Y term of the up vector.]]
@in uz: Evas_Real; [[Z term of the up vector.]]
}
}
mesh_add {
/*@
Add a mesh to the given node.
@param node The given node.
@param mesh The mesh to be added.
[[Add a mesh to the given node.
If the node is not of type EVAS_CANVAS3D_NODE_TYPE_MESH, error message will be
generated and nothing happens.
@see evas_canvas3d_node_add()
@ingroup Evas_Canvas3D_Node
*/
See also @Evas.Canvas3D.Node.member_add.]]
params {
@in mesh: Evas.Canvas3D.Mesh *; /*@ The mesh to be added.*/
@in mesh: Evas.Canvas3D.Mesh *; [[The mesh to be added.]]
}
}
mesh_del {
/*@
Delete a mesh from the given node.
@param node The given node.
@param mesh The mesh to be deleted.
[[Delete a mesh from the given node.
If the node is not of type EVAS_CANVAS3D_NODE_TYPE_MESH or the given mesh does not
belong to the given node, error message will be gnerated and nothing happens.
@see evas_canvas3d_node_mesh_add()
@ingroup Evas_Canvas3D_Node
*/
See also @Evas.Canvas3D.Node.mesh_add.]]
params {
@in mesh: Evas.Canvas3D.Mesh *; /*@ The mesh to be deleted.*/
@in mesh: Evas.Canvas3D.Mesh *; [[The mesh to be deleted.]]
}
}
mesh_list_get @const {
/*@
Get the list of meshes of the given node.
@param node The given node.
@return The list of meshes if any, or @c NULL if there're none.
[[Get the list of meshes of the given node.
If the node is not of type EVAS_CANVAS3D_NODE_TYPE_MESH, error message will be
generated and @c NULL will be returned. If there're no meshes in the given
node, @c NULL will be returned.
generated and $null will be returned. If there're no meshes in the given
node, $null will be returned.
@see evas_canvas3d_node_mesh_add()
@ingroup Evas_Canvas3D_Node
*/
return: const(list<Evas.Canvas3D.Mesh *>)*;
See also @Evas.Canvas3D.Node.mesh_add.]]
return: const(list<Evas.Canvas3D.Mesh *>)*; [[The list of meshes if any, or $null if there're none.]]
}
bounding_box_get{
/*@
Get axis-aligned bounding box (AABB) of the given node.
*
* @param node The given node.
* @param x Pointer to receive X coordinate of the first point of AABB.
* @param y Pointer to receive Y coordinate of the first point of AABB.
* @param z Pointer to receive Z coordinate of the first point of AABB.
* @param x2 Pointer to receive X coordinate of the second point of AABB.
* @param y2 Pointer to receive Y coordinate of the second point of AABB.
* @param z2 Pointer to receive Z coordinate of the second point of AABB.
@ingroup Evas_Canvas3D_Node
*/
[[Get axis-aligned bounding box (AABB) of the given node.]]
params {
@in x: Evas_Real *; /*@ Coordinates of vector.*/
@in y: Evas_Real *;
@in z: Evas_Real *;
@in x2: Evas_Real *;
@in y2: Evas_Real *;
@in z2: Evas_Real *;
@in x: Evas_Real *; [[Pointer to receive X coordinate of the first point of AABB.]]
@in y: Evas_Real *; [[Pointer to receive Y coordinate of the first point of AABB.]]
@in z: Evas_Real *; [[Pointer to receive Z coordinate of the first point of AABB.]]
@in x2: Evas_Real *; [[Pointer to receive X coordinate of the second point of AABB.]]
@in y2: Evas_Real *; [[Pointer to receive Y coordinate of the second point of AABB.]]
@in z2: Evas_Real *; [[Pointer to receive Z coordinate of the second point of AABB.]]
}
}
bounding_sphere_get {
/*@
Get bounding sphere of the given node.
*
* @param node The given node.
* @param x Pointer to receive X coordinate of the center of sphere.
* @param y Pointer to receive Y coordinate of the center of sphere.
* @param z Pointer to receive Z coordinate of center of sphere.
* @param r Pointer to receive radius of center of sphere.
@ingroup Evas_Canvas3D_Node
*/
[[Get bounding sphere of the given node.]]
params {
@in x: Evas_Real *; /*@ Coordinates of vector.*/
@in y: Evas_Real *;
@in z: Evas_Real *;
@in r: Evas_Real *;
@in x: Evas_Real *; [[Pointer to receive X coordinate of the center of sphere.]]
@in y: Evas_Real *; [[Pointer to receive Y coordinate of the center of sphere.]]
@in z: Evas_Real *; [[Pointer to receive Z coordinate of center of sphere.]]
@in r: Evas_Real *; [[Pointer to receive radius of center of sphere.]]
}
}
@property position_inherit {
set {
/*@
Set the position inheritance flag of the given node.
@param node The given node.
@param inherit Whether to inherit parent position @c EINA_TRUE or not @c EINA_FALSE.
[[Set the position inheritance flag of the given node.
When inheritance is enabled, a node's world space position is determined by
adding the parent node's world position and the node's position, otherwise,
the node's position will be the world space position.
@ingroup Evas_Canvas3D_Node_Transform
*/
the node's position will be the world space position.]]
}
get {
/*@
Get the position inheritance flag of the given node.
[[Get the position inheritance flag of the given node.
@param node The given node.
@return @c EINA_TRUE if inheritance is enabled, or @c EINA_FALSE if not.
@see evas_canvas3d_node_position_inherit_set()
@ingroup Evas_Canvas3D_Node_Transform
*/
See also @Evas.Canvas3D.Node.position_inherit.set.]]
}
values {
inherit: bool; /*@ Whether to inherit parent position*/
inherit: bool; [[Whether to inherit parent position.]]
}
}
@property orientation_inherit {
set {
/*@
Set the orientation inheritance flag of the given node.
@param node The given node.
@param inherit Whether to inherit parent orientation @c EINA_TRUE or not @c EINA_FALSE.
[[Set the orientation inheritance flag of the given node.
When inheritance is enabled, a node's world space orientation is determined
by multiplying the parent node's world orientation and the node's
orientation, otherwise, the node's orientation will be the world space
orientation.
@ingroup Evas_Canvas3D_Node_Transform
*/
orientation.]]
}
get {
/*@
Get the orientation inheritance flag of the given node.
[[Get the orientation inheritance flag of the given node.
@param node The given node.
@return @c EINA_TRUE if inheritance is enabled, or @c EINA_FALSE if not.
@see evas_canvas3d_node_orientation_inherit_set()
@ingroup Evas_Canvas3D_Node_Transform
*/
See also @Evas.Canvas3D.Node.orientation_inherit.set.]]
}
values {
inherit: bool; /*@ Whether to inherit parent orientation*/
inherit: bool; [[Whether to inherit parent orientation.]]
}
}
@property scale_inherit {
set {
/*@
Set the scale inheritance flag of the given node.
@param node The given node.
@param inherit Whether to inherit parent scale @c EINA_TRUE or not @c EINA_FALSE.
[[Set the scale inheritance flag of the given node.
When inheritance is enabled, a node's world space scale is determined by
multiplying the parent node's world scale and the node's scale, otherwise,
the node's scale will be the world space scale.
@ingroup Evas_Canvas3D_Node_Transform
*/
the node's scale will be the world space scale.]]
}
get {
/*@
Get the scale inheritance flag of the given node.
[[Get the scale inheritance flag of the given node.
@param node The given node.
@return @c EINA_TRUE if inheritance is enabled, or @c EINA_FALSE if not.
@see evas_canvas3d_node_scale_inherit_set()
@ingroup Evas_Canvas3D_Node_Transform
*/
See also @Evas.Canvas3D.Node.scale_inherit.set.]]
}
values {
inherit: bool; /*@ Whether to inherit parent scale*/
inherit: bool; [[Whether to inherit parent scale.]]
}
}
@property camera {
set {
/*@
Set a camera to the given node.
@param node The given node.
@param camera The camera to be set.
[[Set a camera to the given node.
If the node is not of type EVAS_CANVAS3D_NODE_TYPE_CAMERA, error message will be
generated and nothing happens.
@see evas_canvas3d_node_add()
@ingroup Evas_Canvas3D_Node
*/
See also @Evas.Canvas3D.Node.member_add.]]
}
get {
/*@
Get the camera of the given node.
[[Get the camera of the given node.
@param node The given node.
@return The camera of the given node if any, or @c NULL if there're none.
@see evas_canvas3d_node_camera_set()
@ingroup Evas_Canvas3D_Node
*/
See also @Evas.Canvas3D.Node.camera.set.]]
}
values {
// FIXME: Evas_Canvas3D_Camera is necessary, but that introduces a cycle
camera: Evas.Canvas3D.Object *; /*@ The camera */
camera: Evas.Canvas3D.Object *; [[The camera of the given node if any, or $null if there're none.]]
}
}
@property light {
set {
/*@
Set the light of the given node.
@param node The given node.
@param light The light to be set.
[[Set the light of the given node.
If the node is not of type EVAS_CANVAS3D_NODE_TYPE_LIGHT, error message will be
generated and nothing happens.
@see evas_canvas3d_node_add()
@ingroup Evas_Canvas3D_Node
*/
See also @Evas.Canvas3D.Node.member_add.]]
}
get {
/*@
Get the light of the given node.
[[Get the light of the given node.
@param node The given node.
@return The light of the given node if any, or @c NULL if there're none.
@see evas_canvas3d_node_light_set()
@ingroup Evas_Canvas3D_Node
*/
See also @Evas.Canvas3D.Node.light.set.]]
}
values {
light: Evas.Canvas3D.Light *; /*@ The light */
light: Evas.Canvas3D.Light *; [[The light of the given node if any, or $null if there're none.]]
}
}
@property mesh_frame {
set {
/*@
Set the animation frame number of the given node for the given mesh.
@param node The given node.
@param mesh The given mesh.
@param frame The animation frame number.
[[Set the animation frame number of the given node for the given mesh.
If the node is not of type EVAS_CANVAS3D_NODE_TYPE_MESH or the given mesh does not
belong to the given mesh error mesh will be generated and nothing happens.
Default mesh frame is 0.
@see evas_canvas3d_node_mesh_add()
@ingroup Evas_Canvas3D_Node
*/
See also @Evas.Canvas3D.Node.mesh_add.]]
}
get {
/*@
Set the animation frame number of the given node for the given mesh.
@param node The given node.
@param mesh The given mesh.
@param frame The animation frame number.
[[Set the animation frame number of the given node for the given mesh.
If the node is not of type EVAS_CANVAS3D_NODE_TYPE_MESH or the given mesh does not
belong to the given mesh error mesh will be generated and nothing happens.
@see evas_canvas3d_node_mesh_add()
@ingroup Evas_Canvas3D_Node
*/
See also @Evas.Canvas3D.Node.mesh_add.]]
}
keys {
mesh: Evas.Canvas3D.Mesh *; /*@ The given mesh.*/
mesh: Evas.Canvas3D.Mesh *; [[The given mesh.]]
}
values {
frame: int; /*@ The animation frame number.*/
frame: int; [[The animation frame number.]]
}
}
@property billboard_target {
set {
/*@
Set behavior of node like billboard object.
@param node The given node.
@param billboard Pointer to target node for given node.
@ingroup Evas_Canvas3D_Node
*/
[[Set behavior of node like billboard object.]]
}
get {
/*@
Get the target node for billboard object.
[[Get the target node for billboard object.
@param node The given node.
@return The pointer to target node for billboard object,
or @c NULL if there're none.
@see evas_canvas3d_node_billboard_set()
@ingroup Evas_Canvas3D_Node
*/
See also @Evas.Canvas3D.Node.billboard_target.set.]]
}
values {
target: Evas.Canvas3D.Node *; /*@ Target node.*/
target: Evas.Canvas3D.Node *; [[The pointer to target node for billboard object,
or $null if there're none.]]
}
}
}