The Evas_Canvas3D_Primitive structure defines the data for generating meshes for various types of primitive shapes such as cubes, cylinders, spheres, surfaces, terrain, etc. More...
Macros | |
#define | EVAS_CANVAS3D_PRIMITIVE_CLASS evas_canvas3d_primitive_class_get() |
Evas 3D canvas primitive class. | |
Typedefs | |
typedef void() | Evas_Canvas3D_Surface_Func(Evas_Real *out_x, Evas_Real *out_y, Evas_Real *out_z, Evas_Real a, Evas_Real b) |
The Evas_Canvas3D_Surface_Func type of functions are used to create parametric surfaces as primitives. More... | |
Functions | |
EOAPI void | evas_canvas3d_primitive_form_set (Eo *obj, Evas_Canvas3D_Mesh_Primitive form) |
Set the form of the given primitive. More... | |
EOAPI Evas_Canvas3D_Mesh_Primitive | evas_canvas3d_primitive_form_get (const Eo *obj) |
Get the form of the given primitive. More... | |
EOAPI void | evas_canvas3d_primitive_mode_set (Eo *obj, Evas_Canvas3D_Primitive_Mode mode) |
Set the mode of the given primitive. More... | |
EOAPI Evas_Canvas3D_Primitive_Mode | evas_canvas3d_primitive_mode_get (const Eo *obj) |
Get the mode of the given primitive. More... | |
EOAPI void | evas_canvas3d_primitive_ratio_set (Eo *obj, Evas_Real ratio) |
Set the ratio of the given primitive. More... | |
EOAPI Evas_Real | evas_canvas3d_primitive_ratio_get (const Eo *obj) |
Get the ratio of the given primitive. More... | |
EOAPI void | evas_canvas3d_primitive_precision_set (Eo *obj, int precision) |
Set the precision of the given primitive. More... | |
EOAPI int | evas_canvas3d_primitive_precision_get (const Eo *obj) |
Get the precision of the given primitive. More... | |
EOAPI void | evas_canvas3d_primitive_surface_set (Eo *obj, Evas_Canvas3D_Surface_Func *surface) |
Set the surface of the given primitive. More... | |
EOAPI void | evas_canvas3d_primitive_tex_scale_set (Eo *obj, Evas_Real tex_scale_x, Evas_Real tex_scale_y) |
Set the texture scale of the given primitive. More... | |
EOAPI void | evas_canvas3d_primitive_tex_scale_get (const Eo *obj, Evas_Real *tex_scale_x, Evas_Real *tex_scale_y) |
Get the texture scale of the given primitive. More... | |
The Evas_Canvas3D_Primitive structure defines the data for generating meshes for various types of primitive shapes such as cubes, cylinders, spheres, surfaces, terrain, etc.
Use the evas_canvas3d_mesh_from_primitive_set() function to generate a mesh's frame of this primitive.
Evas_Canvas3D_Surface_Func |
The Evas_Canvas3D_Surface_Func type of functions are used to create parametric surfaces as primitives.
These compute the vertex x,y,z values for given v,u values.
out_x | The x component of the calculated value. |
out_y | The y component of the calculated value. |
out_z | The z component of the calculated value. |
a | is the v value. |
b | is the u value. |
EOAPI void evas_canvas3d_primitive_form_set | ( | Eo * | obj, |
Evas_Canvas3D_Mesh_Primitive | form | ||
) |
Set the form of the given primitive.
Form defines which function will be chosen to set data to mesh on call of evas_canvas3d_mesh_primitive_set.
Now available next forms of primitives are tabulated primitives (SQUARE and CUBE), solids of revolution (CYLINDER, CONE, SPHERE and TORUS) and surfaces (SURFACE and TERRAIN).
Default form is EVAS_CANVAS3D_MESH_PRIMITIVE_NONE.
[in] | obj | The object. |
[in] | form | Form of primitive. |
EOAPI Evas_Canvas3D_Mesh_Primitive evas_canvas3d_primitive_form_get | ( | const Eo * | obj | ) |
Get the form of the given primitive.
See also evas_canvas3d_primitive_form_set.
[in] | obj | The object. |
EOAPI void evas_canvas3d_primitive_mode_set | ( | Eo * | obj, |
Evas_Canvas3D_Primitive_Mode | mode | ||
) |
Set the mode of the given primitive.
Mode defines which function will be chosen to set data to mesh on call of evas_canvas3d_mesh_primitive_set. It helps to choose an alternative algorithm for primitives with a given form, such as a cone without a base or sphere textured in alternative way.
Mods of primitives are now available without base (bases) (supported for cylinder and cone) and with alternative UV (supported by sphere).
Default form is EVAS_CANVAS3D_PRIMITIVE_MODE_DEFAULT.
[in] | obj | The object. |
[in] | mode | Mode of primitive. |
EOAPI Evas_Canvas3D_Primitive_Mode evas_canvas3d_primitive_mode_get | ( | const Eo * | obj | ) |
Get the mode of the given primitive.
See also evas_canvas3d_primitive_mode_set.
[in] | obj | The object. |
Set the ratio of the given primitive.
Ratio is used only in torus as the ratio of the major radius and minor radius. For this usage Available values is from 1.0 to infinity. If ratio for torus has a bad value, 3.0 will be used as the ratio.
Default ratio is 3.0.
[in] | obj | The object. |
[in] | ratio | Ratio of primitive. |
Get the ratio of the given primitive.
See also evas_canvas3d_primitive_ratio_set.
[in] | obj | The object. |
EOAPI void evas_canvas3d_primitive_precision_set | ( | Eo * | obj, |
int | precision | ||
) |
Set the precision of the given primitive.
Precision is used in all non tabulated primitives and defines the precision of created primitives. Available values range from 3 to infinity. If the value is more than 100, you may see a warning about possibility of incorrect values or slow processing.
Default ratio is 10.
[in] | obj | The object. |
[in] | precision | Precision of primitive. |
EOAPI int evas_canvas3d_primitive_precision_get | ( | const Eo * | obj | ) |
Get the precision of the given primitive.
See also evas_canvas3d_primitive_precision_set.
[in] | obj | The object. |
EOAPI void evas_canvas3d_primitive_surface_set | ( | Eo * | obj, |
Evas_Canvas3D_Surface_Func * | surface | ||
) |
Set the surface of the given primitive.
Surface is used only in surface primitives and defines the equation of filling mesh data on call of evas_canvas3d_mesh_primitive_set.
This allows you to create customers primitives like shell, heart, hyperbolic paraboloid etc. See _shell_func in examples/evas/evas-3d-visual-test.c or _perlin_terrain in modules/evas/primitives/surfaces/terrain.c for usage examples.
Default surface is null
[in] | obj | The object. |
[in] | surface | Pointer to customers surface function. |
EOAPI void evas_canvas3d_primitive_tex_scale_set | ( | Eo * | obj, |
Evas_Real | tex_scale_x, | ||
Evas_Real | tex_scale_y | ||
) |
Set the texture scale of the given primitive.
Texture scale uses in all non tabulated primitives and defines scale of texture coordinates or primitives.
It uses to create periodical textured meshes.
Default tex_scale is {1.0, 1.0}
[in] | obj | The object. |
[in] | tex_scale_x | Texture scale X coordinate |
[in] | tex_scale_y | Texture scale Y coordinate |
EOAPI void evas_canvas3d_primitive_tex_scale_get | ( | const Eo * | obj, |
Evas_Real * | tex_scale_x, | ||
Evas_Real * | tex_scale_y | ||
) |
Get the texture scale of the given primitive.
See also evas_canvas3d_primitive_tex_scale_set.
[in] | obj | The object. |
[out] | tex_scale_x | Texture scale X coordinate |
[out] | tex_scale_y | Texture scale Y coordinate |