Evas.h File Reference

These routines are used for Evas library interaction. More...

Data Structures
struct	_Evas_Coord_Rectangle
	< A rectangle in Evas_Coord More...
struct	_Evas_Engine_Info
	Generic engine information. More...
struct	_Evas_Event_Mouse_Down
	Mouse button press event. More...
struct	_Evas_Event_Mouse_Up
	Mouse button release event. More...
struct	_Evas_Event_Mouse_In
	Mouse enter event. More...
struct	_Evas_Event_Mouse_Out
	Mouse leave event. More...
struct	_Evas_Event_Mouse_Move
	Mouse button down event. More...
struct	_Evas_Event_Mouse_Wheel
	Wheel event. More...
struct	_Evas_Event_Multi_Down
	Multi button press event. More...
struct	_Evas_Event_Multi_Up
	Multi button release event. More...
struct	_Evas_Event_Multi_Move
	Multi button down event. More...
struct	_Evas_Event_Key_Down
	Key press event. More...
struct	_Evas_Event_Key_Up
	Key release event. More...
struct	_Evas_Event_Hold
	Hold change event. More...
struct	_Evas_Smart_Class
	a smart object class More...
struct	_Evas_Smart_Cb_Description
	Describes a callback used by a smart class evas_object_smart_callback_call(), particularly useful to explain to user and its code (ie: introspection) what the parameter `event_info` will contain. More...
struct	_Evas_Object_Box_Api
	This structure should be used by any class that wants to inherit from box to provide custom behavior not allowed only by providing a layout function with evas_object_box_layout_set(). More...
struct	_Evas_Object_Box_Data
	This structure augments clipped smart object's instance data, providing extra members required by generic box implementation. More...
struct	_Evas_Cserve_Stats
	Statistics about server that shares cached bitmaps. More...
struct	_Evas_Cserve_Image_Cache
	Cache of images shared by server. More...
struct	_Evas_Cserve_Image
	An image shared by the server. More...
struct	_Evas_Cserve_Config
	Configuration that controls the server that shares cached bitmaps. More...
Defines
#define	EVAS_LAYER_MIN -32768
	bottom-most layer number
#define	EVAS_LAYER_MAX 32767
	top-most layer number
#define	EVAS_COLOR_SPACE_ARGB 0
	Not used for anything.
#define	EVAS_COLOR_SPACE_AHSV 1
	Not used for anything.
#define	EVAS_TEXT_INVALID -1
	Not used for anything.
#define	EVAS_TEXT_SPECIAL -2
	Not used for anything.
#define	EVAS_HINT_EXPAND 1.0
	Use with evas_object_size_hint_weight_set(), evas_object_size_hint_weight_get(), evas_object_size_hint_expand_set(), evas_object_size_hint_expand_get().
#define	EVAS_HINT_FILL -1.0
	Use with evas_object_size_hint_align_set(), evas_object_size_hint_align_get(), evas_object_size_hint_fill_set(), evas_object_size_hint_fill_get().
#define	evas_object_size_hint_fill_set evas_object_size_hint_align_set
	Convenience macro to make it easier to understand that align is also used for fill properties (as fill is mutually exclusive to align).
#define	evas_object_size_hint_fill_get evas_object_size_hint_align_get
	Convenience macro to make it easier to understand that align is also used for fill properties (as fill is mutually exclusive to align).
#define	evas_object_size_hint_expand_set evas_object_size_hint_weight_set
	Convenience macro to make it easier to understand that weight is also used for expand properties.
#define	evas_object_size_hint_expand_get evas_object_size_hint_weight_get
	Convenience macro to make it easier to understand that weight is also used for expand properties.
#define	EVAS_SMART_CLASS_VERSION 4
	The version you have to put into the version field in the smart class struct.
#define	EVAS_SMART_CLASS_INIT_NULL {NULL, 0, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL}
	Initializer to zero a whole Evas_Smart_Class structure.
#define	EVAS_SMART_CLASS_INIT_VERSION {NULL, EVAS_SMART_CLASS_VERSION, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL}
	Initializer to zero a whole Evas_Smart_Class structure and set version.
#define	EVAS_SMART_CLASS_INIT_NAME_VERSION(name) {name, EVAS_SMART_CLASS_VERSION, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL}
	Initializer to zero a whole Evas_Smart_Class structure and set name and version.
#define	EVAS_SMART_CLASS_INIT_NAME_VERSION_PARENT(name, parent) {name, EVAS_SMART_CLASS_VERSION, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, parent, NULL, NULL}
	Initializer to zero a whole Evas_Smart_Class structure and set name, version and parent class.
#define	EVAS_SMART_CLASS_INIT_NAME_VERSION_PARENT_CALLBACKS(name, parent, callbacks) {name, EVAS_SMART_CLASS_VERSION, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, parent, callbacks, NULL}
	Initializer to zero a whole Evas_Smart_Class structure and set name, version, parent class and callbacks definition.
#define	EVAS_SMART_SUBCLASS_NEW(smart_name, prefix, api_type, parent_type, parent_func, cb_desc)
	Convenience macro to subclass a Smart Class.
#define	EVAS_SMART_DATA_ALLOC(o, priv_type)
	Convenience macro to allocate smart data only if needed.
#define	evas_smart_class_inherit(sc, parent_sc) evas_smart_class_inherit_full(sc, parent_sc, sizeof(*parent_sc))
	Easy to use version of evas_smart_class_inherit_full().
#define	EVAS_OBJECT_BOX_API_INIT(smart_class_init) {smart_class_init, EVAS_OBJECT_BOX_API_VERSION, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL}
	Initializer for whole Evas_Object_Box_Api structure.
#define	EVAS_OBJECT_BOX_API_INIT_NULL EVAS_OBJECT_BOX_API_INIT(EVAS_SMART_CLASS_INIT_NULL)
	Initializer to zero a whole Evas_Object_Box_Api structure.
#define	EVAS_OBJECT_BOX_API_INIT_VERSION EVAS_OBJECT_BOX_API_INIT(EVAS_SMART_CLASS_INIT_VERSION)
	Initializer to zero a whole Evas_Object_Box_Api structure and set version.
#define	EVAS_OBJECT_BOX_API_INIT_NAME_VERSION(name) EVAS_OBJECT_BOX_API_INIT(EVAS_SMART_CLASS_INIT_NAME_VERSION(name))
	Initializer to zero a whole Evas_Object_Box_Api structure and set name and version.
Typedefs
typedef enum _Evas_Callback_Type	Evas_Callback_Type
	Identifier of callbacks to be used with object or canvas.
typedef enum _Evas_Button_Flags	Evas_Button_Flags
	Flags for Mouse Button events.
typedef enum _Evas_Event_Flags	Evas_Event_Flags
	Flags for Events.
typedef enum _Evas_Font_Hinting_Flags	Evas_Font_Hinting_Flags
	Flags for Font Hinting.
typedef enum _Evas_Colorspace	Evas_Colorspace
	Colorspaces for pixel data supported by Evas.
typedef enum _Evas_Object_Table_Homogeneous_Mode	Evas_Object_Table_Homogeneous_Mode
	How to pack items into cells in a table.
typedef struct _Evas_Coord_Rectangle	Evas_Coord_Rectangle
	A generic rectangle handle.
typedef struct _Evas_Point	Evas_Point
	integer point
typedef struct _Evas_Coord_Point	Evas_Coord_Point
	Evas_Coord point.
typedef struct _Evas_Coord_Precision_Point	Evas_Coord_Precision_Point
	Evas_Coord point with sub-pixel precision.
typedef struct _Evas_Position	Evas_Position
	associates given point in Canvas and Output
typedef struct _Evas_Precision_Position	Evas_Precision_Position
	associates given point in Canvas and Output, with sub-pixel precision
typedef struct _Evas_Smart_Class	Evas_Smart_Class
	A smart object base class.
typedef struct _Evas_Smart_Cb_Description	Evas_Smart_Cb_Description
	A smart object callback description, used to provide introspection.
typedef struct _Evas_Map	Evas_Map
	An opaque handle to map points.
typedef struct _Evas	Evas
	An Evas canvas handle.
typedef struct _Evas_Object	Evas_Object
	An Evas Object handle.
typedef void	Evas_Performance
	An Evas Performance handle.
typedef struct _Evas_Modifier	Evas_Modifier
	An Evas Modifier.
typedef struct _Evas_Lock	Evas_Lock
	An Evas Lock.
typedef struct _Evas_Smart	Evas_Smart
	An Evas Smart Object handle.
typedef struct _Evas_Native_Surface	Evas_Native_Surface
	A generic datatype for engine specific native surface information.
typedef unsigned long long	Evas_Modifier_Mask
	An Evas modifier mask type.
typedef struct _Evas_Pixel_Import_Source	Evas_Pixel_Import_Source
	A source description of pixels for importing pixels.
typedef struct _Evas_Engine_Info	Evas_Engine_Info
	A generic Evas Engine information structure.
typedef struct _Evas_Device	Evas_Device
	A source device handle - where the event came from.
typedef struct _Evas_Event_Mouse_Down	Evas_Event_Mouse_Down
	Event structure for EVAS_CALLBACK_MOUSE_DOWN event callbacks.
typedef struct _Evas_Event_Mouse_Up	Evas_Event_Mouse_Up
	Event structure for EVAS_CALLBACK_MOUSE_UP event callbacks.
typedef struct _Evas_Event_Mouse_In	Evas_Event_Mouse_In
	Event structure for EVAS_CALLBACK_MOUSE_IN event callbacks.
typedef struct _Evas_Event_Mouse_Out	Evas_Event_Mouse_Out
	Event structure for EVAS_CALLBACK_MOUSE_OUT event callbacks.
typedef struct _Evas_Event_Mouse_Move	Evas_Event_Mouse_Move
	Event structure for EVAS_CALLBACK_MOUSE_MOVE event callbacks.
typedef struct _Evas_Event_Mouse_Wheel	Evas_Event_Mouse_Wheel
	Event structure for EVAS_CALLBACK_MOUSE_WHEEL event callbacks.
typedef struct _Evas_Event_Multi_Down	Evas_Event_Multi_Down
	Event structure for EVAS_CALLBACK_MULTI_DOWN event callbacks.
typedef struct _Evas_Event_Multi_Up	Evas_Event_Multi_Up
	Event structure for EVAS_CALLBACK_MULTI_UP event callbacks.
typedef struct _Evas_Event_Multi_Move	Evas_Event_Multi_Move
	Event structure for EVAS_CALLBACK_MULTI_MOVE event callbacks.
typedef struct _Evas_Event_Key_Down	Evas_Event_Key_Down
	Event structure for EVAS_CALLBACK_KEY_DOWN event callbacks.
typedef struct _Evas_Event_Key_Up	Evas_Event_Key_Up
	Event structure for EVAS_CALLBACK_KEY_UP event callbacks.
typedef struct _Evas_Event_Hold	Evas_Event_Hold
	Event structure for EVAS_CALLBACK_HOLD event callbacks.
typedef enum _Evas_Load_Error	Evas_Load_Error
	Load error you can get from loading of files - see evas_load_error_str() too.
typedef enum _Evas_Alloc_Error	Evas_Alloc_Error
	Possible allocation errors returned by evas_alloc_error().
typedef enum _Evas_Fill_Spread	Evas_Fill_Spread
	Fill types used for evas_object_image_fill_spread_set().
typedef enum _Evas_Pixel_Import_Pixel_Format	Evas_Pixel_Import_Pixel_Format
	Pixel format for import call.
typedef enum _Evas_Render_Op	Evas_Render_Op
typedef enum _Evas_Object_Pointer_Mode	Evas_Object_Pointer_Mode
	How mouse pointer should be handled by Evas.
typedef struct _Evas_Object_Textblock_Node_Format	Evas_Object_Textblock_Node_Format
	A format node.
typedef struct _Evas_Object_Smart_Clipped_Data	Evas_Object_Smart_Clipped_Data
	Every subclass should provide this at the beginning of their own data set with evas_object_smart_data_set().
typedef struct _Evas_Object_Box_Api	Evas_Object_Box_Api
	Smart Class extension providing extra box requirements.
typedef struct _Evas_Object_Box_Data	Evas_Object_Box_Data
	Smart instance data providing box requirements.
typedef struct _Evas_Object_Box_Option	Evas_Object_Box_Option
	The base structure for a box option.
Enumerations
enum	_Evas_Callback_Type { EVAS_CALLBACK_MOUSE_IN, EVAS_CALLBACK_MOUSE_OUT, EVAS_CALLBACK_MOUSE_DOWN, EVAS_CALLBACK_MOUSE_UP, EVAS_CALLBACK_MOUSE_MOVE, EVAS_CALLBACK_MOUSE_WHEEL, EVAS_CALLBACK_MULTI_DOWN, EVAS_CALLBACK_MULTI_UP, EVAS_CALLBACK_MULTI_MOVE, EVAS_CALLBACK_FREE, EVAS_CALLBACK_KEY_DOWN, EVAS_CALLBACK_KEY_UP, EVAS_CALLBACK_FOCUS_IN, EVAS_CALLBACK_FOCUS_OUT, EVAS_CALLBACK_SHOW, EVAS_CALLBACK_HIDE, EVAS_CALLBACK_MOVE, EVAS_CALLBACK_RESIZE, EVAS_CALLBACK_RESTACK, EVAS_CALLBACK_DEL, EVAS_CALLBACK_HOLD, EVAS_CALLBACK_CHANGED_SIZE_HINTS, EVAS_CALLBACK_IMAGE_PRELOADED, EVAS_CALLBACK_CANVAS_FOCUS_IN, EVAS_CALLBACK_CANVAS_FOCUS_OUT, EVAS_CALLBACK_RENDER_FLUSH_PRE, EVAS_CALLBACK_RENDER_FLUSH_POST, EVAS_CALLBACK_CANVAS_OBJECT_FOCUS_IN, EVAS_CALLBACK_CANVAS_OBJECT_FOCUS_OUT, EVAS_CALLBACK_IMAGE_UNLOADED, EVAS_CALLBACK_LAST }
	Identifier of callbacks to be used with object or canvas. More...
enum	_Evas_Button_Flags { EVAS_BUTTON_NONE = 0, EVAS_BUTTON_DOUBLE_CLICK = (1 << 0), EVAS_BUTTON_TRIPLE_CLICK = (1 << 1) }
	Flags for Mouse Button events. More...
enum	_Evas_Event_Flags { EVAS_EVENT_FLAG_NONE = 0, EVAS_EVENT_FLAG_ON_HOLD = (1 << 0), EVAS_EVENT_FLAG_ON_SCROLL = (1 << 1) }
	Flags for Events. More...
enum	_Evas_Font_Hinting_Flags { EVAS_FONT_HINTING_NONE, EVAS_FONT_HINTING_AUTO, EVAS_FONT_HINTING_BYTECODE }
	Flags for Font Hinting. More...
enum	_Evas_Colorspace { EVAS_COLORSPACE_ARGB8888, EVAS_COLORSPACE_YCBCR422P601_PL, EVAS_COLORSPACE_YCBCR422P709_PL, EVAS_COLORSPACE_RGB565_A5P, EVAS_COLORSPACE_GRY8 }
	Colorspaces for pixel data supported by Evas. More...
enum	_Evas_Object_Table_Homogeneous_Mode
	How to pack items into cells in a table.
enum	_Evas_Load_Error { EVAS_LOAD_ERROR_NONE = 0, EVAS_LOAD_ERROR_GENERIC = 1, EVAS_LOAD_ERROR_DOES_NOT_EXIST = 2, EVAS_LOAD_ERROR_PERMISSION_DENIED = 3, EVAS_LOAD_ERROR_RESOURCE_ALLOCATION_FAILED = 4, EVAS_LOAD_ERROR_CORRUPT_FILE = 5, EVAS_LOAD_ERROR_UNKNOWN_FORMAT = 6 }
enum	_Evas_Alloc_Error { EVAS_ALLOC_ERROR_NONE = 0, EVAS_ALLOC_ERROR_FATAL = 1, EVAS_ALLOC_ERROR_RECOVERED = 2 }
enum	_Evas_Fill_Spread { EVAS_TEXTURE_REFLECT = 0, EVAS_TEXTURE_REPEAT = 1, EVAS_TEXTURE_RESTRICT = 2, EVAS_TEXTURE_RESTRICT_REFLECT = 3, EVAS_TEXTURE_RESTRICT_REPEAT = 4, EVAS_TEXTURE_PAD = 5 }
enum	_Evas_Pixel_Import_Pixel_Format { EVAS_PIXEL_FORMAT_NONE = 0, EVAS_PIXEL_FORMAT_ARGB32 = 1, EVAS_PIXEL_FORMAT_YUV420P_601 = 2 }
enum	_Evas_Render_Op { EVAS_RENDER_BLEND = 0, EVAS_RENDER_BLEND_REL = 1, EVAS_RENDER_COPY = 2, EVAS_RENDER_COPY_REL = 3, EVAS_RENDER_ADD = 4, EVAS_RENDER_ADD_REL = 5, EVAS_RENDER_SUB = 6, EVAS_RENDER_SUB_REL = 7, EVAS_RENDER_TINT = 8, EVAS_RENDER_TINT_REL = 9, EVAS_RENDER_MASK = 10, EVAS_RENDER_MUL = 11 }
	How the object should be rendered to output. More...
enum	_Evas_Object_Pointer_Mode { EVAS_OBJECT_POINTER_MODE_AUTOGRAB }
	How mouse pointer should be handled by Evas. More...
Functions
EAPI int	evas_init (void)
	Initialize Evas.
EAPI int	evas_shutdown (void)
	Shutdown Evas.
EAPI Evas_Alloc_Error	evas_alloc_error (void)
	Return if any allocation errors have occurred during the prior function.
EAPI int	evas_async_events_fd_get (void) EINA_WARN_UNUSED_RESULT EINA_PURE
	Get evas' internal asynchronous events read file descriptor.
EAPI int	evas_async_events_process (void)
	Trigger the processing of all events waiting on the file descriptor returned by evas_async_events_fd_get().
EAPI Evas *	evas_new (void) EINA_WARN_UNUSED_RESULT EINA_MALLOC
	Creates a new empty evas.
EAPI void	evas_free (Evas *e) EINA_ARG_NONNULL(1)
	Frees the given evas and any objects created on it.
EAPI void	evas_focus_in (Evas *e)
	Inform to the evas that it got the focus.
EAPI void	evas_focus_out (Evas *e)
	Inform to the evas that it lost the focus.
EAPI Eina_Bool	evas_focus_state_get (const Evas *e) EINA_PURE
	Get the focus state known by the given evas.
EAPI void	evas_nochange_push (Evas *e)
	Push the nochange flag up 1.
EAPI void	evas_nochange_pop (Evas *e)
	Pop the nochange flag down 1.
EAPI void	evas_data_attach_set (Evas e, void data) EINA_ARG_NONNULL(1)
	Attaches a specific pointer to the evas for fetching later.
EAPI void *	evas_data_attach_get (const Evas *e) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Returns the pointer attached by evas_data_attach_set().
EAPI void	evas_damage_rectangle_add (Evas *e, int x, int y, int w, int h) EINA_ARG_NONNULL(1)
	Add a damage rectangle.
EAPI void	evas_obscured_rectangle_add (Evas *e, int x, int y, int w, int h) EINA_ARG_NONNULL(1)
	Add an obscured region.
EAPI void	evas_obscured_clear (Evas *e) EINA_ARG_NONNULL(1)
	Remove all obscured region rectangles from the canvas.
EAPI Eina_List *	evas_render_updates (Evas *e) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1)
	Force immediate renderization of the given canvas.
EAPI void	evas_render_updates_free (Eina_List *updates)
	Free the rectangles returned by evas_render_updates().
EAPI void	evas_render (Evas *e) EINA_ARG_NONNULL(1)
	Force renderization of the given canvas.
EAPI void	evas_norender (Evas *e) EINA_ARG_NONNULL(1)
	Update the canvas internal objects but not triggering immediate renderization.
EAPI void	evas_render_idle_flush (Evas *e) EINA_ARG_NONNULL(1)
	Make the canvas discard internally cached data used for rendering.
EAPI int	evas_render_method_lookup (const char *name) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1)
	Look up a numeric ID from a string name of a rendering engine.
EAPI Eina_List *	evas_render_method_list (void) EINA_WARN_UNUSED_RESULT
	List all the rendering engines compiled into the copy of the Evas library.
EAPI void	evas_render_method_list_free (Eina_List *list)
	This function should be called to free a list of engine names.
EAPI void	evas_output_method_set (Evas *e, int render_method) EINA_ARG_NONNULL(1)
	Sets the output engine for the given evas.
EAPI int	evas_output_method_get (const Evas *e) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Retrieves the number of the output engine used for the given evas.
EAPI Evas_Engine_Info *	evas_engine_info_get (const Evas *e) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Retrieves the current render engine info struct from the given evas.
EAPI Eina_Bool	evas_engine_info_set (Evas e, Evas_Engine_Info info) EINA_ARG_NONNULL(1)
	Applies the engine settings for the given evas from the given `Evas_Engine_Info` structure.
EAPI void	evas_output_size_set (Evas *e, int w, int h) EINA_ARG_NONNULL(1)
	Sets the output size of the render engine of the given evas.
EAPI void	evas_output_size_get (const Evas e, int w, int *h) EINA_ARG_NONNULL(1)
	Retrieve the output size of the render engine of the given evas.
EAPI void	evas_output_viewport_set (Evas *e, Evas_Coord x, Evas_Coord y, Evas_Coord w, Evas_Coord h) EINA_ARG_NONNULL(1)
	Sets the output viewport of the given evas in evas units.
EAPI void	evas_output_viewport_get (const Evas e, Evas_Coord x, Evas_Coord y, Evas_Coord w, Evas_Coord *h) EINA_ARG_NONNULL(1)
	Get the render engine's output viewport co-ordinates in canvas units.
EAPI Evas_Coord	evas_coord_screen_x_to_world (const Evas *e, int x) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1)
	Convert/scale an ouput screen co-ordinate into canvas co-ordinates.
EAPI Evas_Coord	evas_coord_screen_y_to_world (const Evas *e, int y) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1)
	Convert/scale an ouput screen co-ordinate into canvas co-ordinates.
EAPI int	evas_coord_world_x_to_screen (const Evas *e, Evas_Coord x) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1)
	Convert/scale a canvas co-ordinate into output screen co-ordinates.
EAPI int	evas_coord_world_y_to_screen (const Evas *e, Evas_Coord y) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1)
	Convert/scale a canvas co-ordinate into output screen co-ordinates.
EAPI void	evas_pointer_output_xy_get (const Evas e, int x, int *y) EINA_ARG_NONNULL(1)
	This function returns the current known pointer co-ordinates.
EAPI void	evas_pointer_canvas_xy_get (const Evas e, Evas_Coord x, Evas_Coord *y) EINA_ARG_NONNULL(1)
	This function returns the current known pointer co-ordinates.
EAPI int	evas_pointer_button_down_mask_get (const Evas *e) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1)
	Returns a bitmask with the mouse buttons currently pressed, set to 1.
EAPI Eina_Bool	evas_pointer_inside_get (const Evas *e) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1)
	Returns whether the mouse pointer is logically inside the canvas.
EAPI void	evas_event_freeze (Evas *e) EINA_ARG_NONNULL(1)
	Freeze all event processing.
EAPI void	evas_event_thaw (Evas *e) EINA_ARG_NONNULL(1)
	Thaw a canvas out after freezing.
EAPI int	evas_event_freeze_get (const Evas *e) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Return the freeze count of a given canvas.
EAPI void	evas_event_feed_mouse_down (Evas e, int b, Evas_Button_Flags flags, unsigned int timestamp, const void data) EINA_ARG_NONNULL(1)
	Mouse down event feed.
EAPI void	evas_event_feed_mouse_up (Evas e, int b, Evas_Button_Flags flags, unsigned int timestamp, const void data) EINA_ARG_NONNULL(1)
	Mouse up event feed.
EAPI void	evas_event_feed_mouse_move (Evas e, int x, int y, unsigned int timestamp, const void data) EINA_ARG_NONNULL(1)
	Mouse move event feed.
EAPI void	evas_event_feed_mouse_in (Evas e, unsigned int timestamp, const void data) EINA_ARG_NONNULL(1)
	Mouse in event feed.
EAPI void	evas_event_feed_mouse_out (Evas e, unsigned int timestamp, const void data) EINA_ARG_NONNULL(1)
	Mouse out event feed.
EAPI void	evas_event_feed_mouse_cancel (Evas e, unsigned int timestamp, const void data) EINA_ARG_NONNULL(1)
	Mouse cancel event feed.
EAPI void	evas_event_feed_mouse_wheel (Evas e, int direction, int z, unsigned int timestamp, const void data) EINA_ARG_NONNULL(1)
	Mouse wheel event feed.
EAPI void	evas_event_feed_key_down (Evas e, const char keyname, const char key, const char string, const char compose, unsigned int timestamp, const void data) EINA_ARG_NONNULL(1)
	Key down event feed.
EAPI void	evas_event_feed_key_up (Evas e, const char keyname, const char key, const char string, const char compose, unsigned int timestamp, const void data) EINA_ARG_NONNULL(1)
	Key up event feed.
EAPI void	evas_event_feed_hold (Evas e, int hold, unsigned int timestamp, const void data) EINA_ARG_NONNULL(1)
	Hold event feed.
EAPI void EAPI void EAPI void EAPI void	evas_post_event_callback_push (Evas e, Evas_Object_Event_Post_Cb func, const void data)
	Push a callback on the post-event callback stack.
EAPI void	evas_post_event_callback_remove (Evas *e, Evas_Object_Event_Post_Cb func)
	Remove a callback from the post-event callback stack.
EAPI void	evas_post_event_callback_remove_full (Evas e, Evas_Object_Event_Post_Cb func, const void data)
	Remove a callback from the post-event callback stack.
EAPI void	evas_image_cache_flush (Evas *e) EINA_ARG_NONNULL(1)
	Flush the image cache of the canvas.
EAPI void	evas_image_cache_reload (Evas *e) EINA_ARG_NONNULL(1)
	Reload the image cache.
EAPI void	evas_image_cache_set (Evas *e, int size) EINA_ARG_NONNULL(1)
	Set the image cache.
EAPI int	evas_image_cache_get (const Evas *e) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Set the image cache.
EAPI void	evas_font_hinting_set (Evas *e, Evas_Font_Hinting_Flags hinting) EINA_ARG_NONNULL(1)
	Changes the font hinting for the given evas.
EAPI Evas_Font_Hinting_Flags	evas_font_hinting_get (const Evas *e) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Retrieves the font hinting used by the given evas.
EAPI Eina_Bool	evas_font_hinting_can_hint (const Evas *e, Evas_Font_Hinting_Flags hinting) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Checks if the font hinting is supported by the given evas.
EAPI void	evas_font_cache_flush (Evas *e) EINA_ARG_NONNULL(1)
	Force the given evas and associated engine to flush its font cache.
EAPI void	evas_font_cache_set (Evas *e, int size) EINA_ARG_NONNULL(1)
	Changes the size of font cache of the given evas.
EAPI int	evas_font_cache_get (const Evas *e) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Changes the size of font cache of the given evas.
EAPI Eina_List *	evas_font_available_list (const Evas *e) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	List of available font descriptions known or found by this evas.
EAPI void	evas_font_available_list_free (Evas e, Eina_List available) EINA_ARG_NONNULL(1)
	Free list of font descriptions returned by evas_font_dir_available_list().
EAPI void	evas_font_path_clear (Evas *e) EINA_ARG_NONNULL(1)
	Removes all font paths loaded into memory for the given evas.
EAPI void EAPI void EAPI const Eina_List *	evas_font_path_list (const Evas *e) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Retrieves the list of font paths used by the given evas.
EAPI void EAPI Evas_Object *	evas_object_clip_get (const Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Get the object clipping this one (if any).
EAPI void	evas_object_clip_unset (Evas_Object *obj)
	Disable clipping for an object.
EAPI const Eina_List *	evas_object_clipees_get (const Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Return a list of objects currently clipped by a specific object.
EAPI void	evas_object_focus_set (Evas_Object *obj, Eina_Bool focus) EINA_ARG_NONNULL(1)
	Sets focus to the given object.
EAPI Eina_Bool	evas_object_focus_get (const Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Test if the object has focus.
EAPI void	evas_object_layer_set (Evas_Object *obj, short l) EINA_ARG_NONNULL(1)
	Sets the layer of the evas that the given object will be part of.
EAPI short	evas_object_layer_get (const Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Retrieves the layer of the evas that the given object is part of.
EAPI void	evas_object_name_set (Evas_Object obj, const char name) EINA_ARG_NONNULL(1)
	Sets the name of the given evas object to the given name.
EAPI const char *	evas_object_name_get (const Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Retrieves the name of the given evas object.
EAPI void	evas_object_del (Evas_Object *obj) EINA_ARG_NONNULL(1)
	Deletes the given evas object and frees its memory.
EAPI void	evas_object_move (Evas_Object *obj, Evas_Coord x, Evas_Coord y) EINA_ARG_NONNULL(1)
	Moves the given evas object to the given location.
EAPI void	evas_object_resize (Evas_Object *obj, Evas_Coord w, Evas_Coord h) EINA_ARG_NONNULL(1)
	Changes the size of the given evas object.
EAPI void	evas_object_geometry_get (const Evas_Object obj, Evas_Coord x, Evas_Coord y, Evas_Coord w, Evas_Coord *h) EINA_ARG_NONNULL(1)
	Retrieves the position and rectangular size of the given evas object.
EAPI void	evas_object_show (Evas_Object *obj) EINA_ARG_NONNULL(1)
	Makes the given evas object visible.
EAPI void	evas_object_hide (Evas_Object *obj) EINA_ARG_NONNULL(1)
	Makes the given evas object invisible.
EAPI Eina_Bool	evas_object_visible_get (const Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Retrieves whether or not the given evas object is visible.
EAPI void	evas_object_color_set (Evas_Object *obj, int r, int g, int b, int a) EINA_ARG_NONNULL(1)
	Sets the general colour of the given evas object to the given colour.
EAPI void	evas_object_color_get (const Evas_Object obj, int r, int g, int b, int *a) EINA_ARG_NONNULL(1)
	Retrieves the general colour of the given evas object.
EAPI Evas *	evas_object_evas_get (const Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Retrieves the evas that the given evas object is on.
EAPI const char *	evas_object_type_get (const Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Retrieves the name of the type of the given evas object.
EAPI void	evas_object_raise (Evas_Object *obj) EINA_ARG_NONNULL(1)
	Raise `obj` to the top of its layer.
EAPI void	evas_object_lower (Evas_Object *obj) EINA_ARG_NONNULL(1)
	Lower `obj` to the bottom of its layer.
EAPI void EAPI void EAPI Evas_Object *	evas_object_above_get (const Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Get the evas object above `obj`.
EAPI Evas_Object *	evas_object_below_get (const Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Get the evas object below `obj`.
EAPI void EAPI void EAPI void EAPI void	evas_object_pass_events_set (Evas_Object *obj, Eina_Bool pass) EINA_ARG_NONNULL(1)
	Set an object's pass events state.
EAPI Eina_Bool	evas_object_pass_events_get (const Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Determine whether an object is set to pass events.
EAPI void	evas_object_repeat_events_set (Evas_Object *obj, Eina_Bool repeat) EINA_ARG_NONNULL(1)
	Set an object's repeat events state.
EAPI Eina_Bool	evas_object_repeat_events_get (const Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Determine whether an object is set to repeat events.
EAPI void	evas_object_propagate_events_set (Evas_Object *obj, Eina_Bool prop) EINA_ARG_NONNULL(1)
	Set whether events on a smart member object should propagate to its parent.
EAPI Eina_Bool	evas_object_propagate_events_get (const Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Determine whether an object is set to propagate events.
EAPI void	evas_object_map_enable_set (Evas_Object *obj, Eina_Bool enabled)
	Enable or disable the map that is set.
EAPI Eina_Bool	evas_object_map_enable_get (const Evas_Object *obj)
	Get the map enabled state.
EAPI void	evas_object_map_source_set (Evas_Object obj, Evas_Object src)
	Set the map source object.
EAPI Evas_Object *	evas_object_map_source_get (const Evas_Object *obj)
	Get the map source object.
EAPI void	evas_object_map_set (Evas_Object obj, const Evas_Map map)
	Set current object transformation map.
EAPI const Evas_Map *	evas_object_map_get (const Evas_Object *obj)
	Get current object transformation map.
EAPI void	evas_map_util_points_populate_from_object_full (Evas_Map m, const Evas_Object obj, Evas_Coord z)
	Populate source and destination map points to match exactly object.
EAPI void	evas_map_util_points_populate_from_object (Evas_Map m, const Evas_Object obj)
	Populate source and destination map points to match exactly object.
EAPI void	evas_map_util_points_populate_from_geometry (Evas_Map *m, Evas_Coord x, Evas_Coord y, Evas_Coord w, Evas_Coord h, Evas_Coord z)
	Populate source and destination map points to match given geometry.
EAPI void	evas_map_util_points_color_set (Evas_Map *m, int r, int g, int b, int a)
	Set color of all points to given color.
EAPI void	evas_map_util_rotate (Evas_Map *m, double degrees, Evas_Coord cx, Evas_Coord cy)
	Change the map to apply the given rotation.
EAPI void	evas_map_util_zoom (Evas_Map *m, double zoomx, double zoomy, Evas_Coord cx, Evas_Coord cy)
	Change the map to apply the given zooming.
EAPI void	evas_map_util_3d_rotate (Evas_Map *m, double dx, double dy, double dz, Evas_Coord cx, Evas_Coord cy, Evas_Coord cz)
	Rotate the map around 3 axes in 3D.
EAPI void	evas_map_util_3d_lighting (Evas_Map *m, Evas_Coord lx, Evas_Coord ly, Evas_Coord lz, int lr, int lg, int lb, int ar, int ag, int ab)
	Perform lighting calculations on the given Map.
EAPI void	evas_map_util_3d_perspective (Evas_Map *m, Evas_Coord px, Evas_Coord py, Evas_Coord z0, Evas_Coord foc)
	Apply a perspective transform to the map.
EAPI Eina_Bool	evas_map_util_clockwise_get (Evas_Map *m)
	Get the clockwise state of a map.
EAPI Evas_Map *	evas_map_new (int count)
	Create map of transformation points to be later used with an evas object.
EAPI void	evas_map_smooth_set (Evas_Map *m, Eina_Bool enabled)
	Set the smoothing for map rendering.
EAPI Eina_Bool	evas_map_smooth_get (const Evas_Map *m)
	get the smoothing for map rendering
EAPI void	evas_map_alpha_set (Evas_Map *m, Eina_Bool enabled)
	Set the alpha flag for map rendering.
EAPI Eina_Bool	evas_map_alpha_get (const Evas_Map *m)
	get the alpha flag for map rendering
EAPI Evas_Map *	evas_map_dup (const Evas_Map *m)
	Copy a previously allocated map.
EAPI void	evas_map_free (Evas_Map *m)
	Free a previously allocated map.
EAPI void	evas_map_point_coord_set (Evas_Map *m, int idx, Evas_Coord x, Evas_Coord y, Evas_Coord z)
	Change the map point's coordinate.
EAPI void	evas_map_point_coord_get (const Evas_Map m, int idx, Evas_Coord x, Evas_Coord y, Evas_Coord z)
	Get the map point's coordinate.
EAPI void	evas_map_point_image_uv_set (Evas_Map *m, int idx, double u, double v)
	Change the map point's U and V texture source point.
EAPI void	evas_map_point_image_uv_get (const Evas_Map m, int idx, double u, double *v)
	Get the map point's U and V texture source points.
EAPI void	evas_map_point_color_set (Evas_Map *m, int idx, int r, int g, int b, int a)
	Set the color of a vertex in the map.
EAPI void	evas_map_point_color_get (const Evas_Map m, int idx, int r, int g, int b, int *a)
	Get the color set on a vertex in the map.
EAPI void	evas_object_size_hint_min_get (const Evas_Object obj, Evas_Coord w, Evas_Coord *h) EINA_ARG_NONNULL(1)
	Retrieves the size hint for the minimum size.
EAPI void	evas_object_size_hint_min_set (Evas_Object *obj, Evas_Coord w, Evas_Coord h) EINA_ARG_NONNULL(1)
	Sets the size hint for the minimum size.
EAPI void	evas_object_size_hint_max_get (const Evas_Object obj, Evas_Coord w, Evas_Coord *h) EINA_ARG_NONNULL(1)
	Retrieves the size hint for the maximum size.
EAPI void	evas_object_size_hint_max_set (Evas_Object *obj, Evas_Coord w, Evas_Coord h) EINA_ARG_NONNULL(1)
	Sets the size hint for the maximum size.
EAPI void	evas_object_size_hint_request_get (const Evas_Object obj, Evas_Coord w, Evas_Coord *h) EINA_ARG_NONNULL(1)
	Retrieves the size request hint.
EAPI void	evas_object_size_hint_request_set (Evas_Object *obj, Evas_Coord w, Evas_Coord h) EINA_ARG_NONNULL(1)
	Sets the requested size hint.
EAPI void	evas_object_size_hint_aspect_get (const Evas_Object obj, Evas_Aspect_Control aspect, Evas_Coord w, Evas_Coord h) EINA_ARG_NONNULL(1)
	Retrieves the size aspect control hint.
EAPI void	evas_object_size_hint_aspect_set (Evas_Object *obj, Evas_Aspect_Control aspect, Evas_Coord w, Evas_Coord h) EINA_ARG_NONNULL(1)
	Sets the size aspect control hint.
EAPI void	evas_object_size_hint_align_get (const Evas_Object obj, double x, double *y) EINA_ARG_NONNULL(1)
	Retrieves the size align control hint.
EAPI void	evas_object_size_hint_align_set (Evas_Object *obj, double x, double y) EINA_ARG_NONNULL(1)
	Sets the size align control hint.
EAPI void	evas_object_size_hint_weight_get (const Evas_Object obj, double x, double *y) EINA_ARG_NONNULL(1)
	Retrieves the size weight control hint.
EAPI void	evas_object_size_hint_weight_set (Evas_Object *obj, double x, double y) EINA_ARG_NONNULL(1)
	Sets the size weight control hint.
EAPI void	evas_object_size_hint_padding_get (const Evas_Object obj, Evas_Coord l, Evas_Coord r, Evas_Coord t, Evas_Coord *b) EINA_ARG_NONNULL(1)
	Retrieves the size padding control hint.
EAPI void	evas_object_size_hint_padding_set (Evas_Object *obj, Evas_Coord l, Evas_Coord r, Evas_Coord t, Evas_Coord b) EINA_ARG_NONNULL(1)
	Sets the size padding control hint.
EAPI void *EAPI void	evas_object_pointer_mode_set (Evas_Object *obj, Evas_Object_Pointer_Mode setting) EINA_ARG_NONNULL(1)
	Set pointer behavior.
EAPI Evas_Object_Pointer_Mode	evas_object_pointer_mode_get (const Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Determine how pointer will behave.
EAPI void	evas_object_anti_alias_set (Evas_Object *obj, Eina_Bool antialias) EINA_ARG_NONNULL(1)
	Sets whether or not the given evas object is to be drawn anti-aliased.
EAPI Eina_Bool	evas_object_anti_alias_get (const Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Retrieves whether or not the given evas object is to be drawn anti_aliased.
EAPI void	evas_object_scale_set (Evas_Object *obj, double scale) EINA_ARG_NONNULL(1)
	Sets the scaling factor for an evas object.
EAPI double	evas_object_scale_get (const Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Retrieves the scaling factor for the given evas object.
EAPI void	evas_object_render_op_set (Evas_Object *obj, Evas_Render_Op op) EINA_ARG_NONNULL(1)
	Sets the render_op to be used for rendering the evas object.
EAPI Evas_Render_Op	evas_object_render_op_get (const Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Retrieves the current value of the operation used for rendering the evas object.
EAPI void	evas_object_precise_is_inside_set (Evas_Object *obj, Eina_Bool precise) EINA_ARG_NONNULL(1)
	Set whether to use a precise (usually expensive) point collision detection.
EAPI Eina_Bool	evas_object_precise_is_inside_get (const Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Determine whether an object is set to use a precise point collision detection.
EAPI void	evas_object_static_clip_set (Evas_Object *obj, Eina_Bool is_static_clip) EINA_ARG_NONNULL(1)
	Set a hint flag on the object that this is used as a static "clipper".
EAPI Eina_Bool	evas_object_static_clip_get (const Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Get static "clipper" hint flag.
EAPI Evas_Object *	evas_focus_get (const Evas *e) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Retrieve the object that currently has focus.
EAPI Evas_Object *	evas_object_name_find (const Evas e, const char name) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Retrieves the object on the given evas with the given name.
EAPI Evas_Object *	evas_object_top_at_xy_get (const Evas *e, Evas_Coord x, Evas_Coord y, Eina_Bool include_pass_events_objects, Eina_Bool include_hidden_objects) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Retrieves the top object at the given position (x,y).
EAPI Evas_Object *	evas_object_top_at_pointer_get (const Evas *e) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Retrieves the top object at mouse pointer position.
EAPI Evas_Object *	evas_object_top_in_rectangle_get (const Evas *e, Evas_Coord x, Evas_Coord y, Evas_Coord w, Evas_Coord h, Eina_Bool include_pass_events_objects, Eina_Bool include_hidden_objects) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Retrieves the top object in the given rectangle region.
EAPI Eina_List *	evas_objects_at_xy_get (const Evas *e, Evas_Coord x, Evas_Coord y, Eina_Bool include_pass_events_objects, Eina_Bool include_hidden_objects) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Retrieves the objects at the given position.
EAPI Eina_List *	evas_objects_in_rectangle_get (const Evas *e, Evas_Coord x, Evas_Coord y, Evas_Coord w, Evas_Coord h, Eina_Bool include_pass_events_objects, Eina_Bool include_hidden_objects) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	To be documented.
EAPI Evas_Object *	evas_object_bottom_get (const Evas *e) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Get the lowest evas object on the Evas `e`.
EAPI Evas_Object *	evas_object_top_get (const Evas *e) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Get the highest evas object on the Evas `e`.
EAPI Evas_Object *	evas_object_rectangle_add (Evas *e) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_MALLOC
	Adds a rectangle to the given evas.
EAPI Evas_Object *	evas_object_image_add (Evas *e) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_MALLOC
	Creates a new image object on the given evas.
EAPI Evas_Object *	evas_object_image_filled_add (Evas *e) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_MALLOC
	Creates a new image object that automatically scales on the given evas.
EAPI void	evas_object_image_file_set (Evas_Object obj, const char file, const char *key) EINA_ARG_NONNULL(1)
	Sets the filename and key of the given image object.
EAPI void EAPI void	evas_object_image_border_set (Evas_Object *obj, int l, int r, int t, int b) EINA_ARG_NONNULL(1)
	Sets how much of each border of the given image object is not to be scaled.
EAPI void	evas_object_image_border_get (const Evas_Object obj, int l, int r, int t, int *b) EINA_ARG_NONNULL(1)
	Retrieves how much of each border of the given image object is not to be scaled.
EAPI void	evas_object_image_border_center_fill_set (Evas_Object *obj, Evas_Border_Fill_Mode fill) EINA_ARG_NONNULL(1)
	Sets if the center part of the given image object (not the border) should be drawn.
EAPI Evas_Border_Fill_Mode	evas_object_image_border_center_fill_get (const Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Retrieves if the center of the given image object is to be drawn or not.
EAPI void	evas_object_image_filled_set (Evas_Object *obj, Eina_Bool setting) EINA_ARG_NONNULL(1)
	Sets if image fill property should track object size.
EAPI Eina_Bool	evas_object_image_filled_get (const Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Retrieves if image fill property is tracking object size.
EAPI void	evas_object_image_border_scale_set (Evas_Object *obj, double scale)
	Sets a scale factor (multiplier) for the borders of an image.
EAPI double	evas_object_image_border_scale_get (const Evas_Object *obj)
	Retrieves the border scale factor.
EAPI void	evas_object_image_fill_set (Evas_Object *obj, Evas_Coord x, Evas_Coord y, Evas_Coord w, Evas_Coord h) EINA_ARG_NONNULL(1)
	Sets the rectangle of the given image object that the image will be drawn to.
EAPI void	evas_object_image_fill_get (const Evas_Object obj, Evas_Coord x, Evas_Coord y, Evas_Coord w, Evas_Coord *h) EINA_ARG_NONNULL(1)
	Retrieves the dimensions of the rectangle of the given image object that the image will be drawn to.
EAPI void	evas_object_image_fill_spread_set (Evas_Object *obj, Evas_Fill_Spread spread) EINA_ARG_NONNULL(1)
	Sets the tiling mode for the given evas image object's fill.
EAPI Evas_Fill_Spread	evas_object_image_fill_spread_get (const Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Retrieves the spread (tiling mode) for the given image object's fill.
EAPI void	evas_object_image_size_set (Evas_Object *obj, int w, int h) EINA_ARG_NONNULL(1)
	Sets the size of the given image object.
EAPI void	evas_object_image_size_get (const Evas_Object obj, int w, int *h) EINA_ARG_NONNULL(1)
	Retrieves the size of the given image object.
EAPI int	evas_object_image_stride_get (const Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Retrieves the row stride of the given image object,.
EAPI Evas_Load_Error	evas_object_image_load_error_get (const Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Retrieves a number representing any error that occurred during the last load of the given image object.
EAPI void	evas_object_image_data_set (Evas_Object obj, void data) EINA_ARG_NONNULL(1)
	Sets the raw image data of the given image object.
EAPI void *	evas_object_image_data_convert (Evas_Object *obj, Evas_Colorspace to_cspace) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Converts the raw image data of the given image object to the specified colorspace.
EAPI void *	evas_object_image_data_get (const Evas_Object *obj, Eina_Bool for_writing) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Get a pointer to the raw image data of the given image object.
EAPI void	evas_object_image_data_copy_set (Evas_Object obj, void data) EINA_ARG_NONNULL(1)
	Replaces the raw image data of the given image object.
EAPI void	evas_object_image_data_update_add (Evas_Object *obj, int x, int y, int w, int h) EINA_ARG_NONNULL(1)
	Mark a sub-region of the given image object to be redrawn.
EAPI void	evas_object_image_alpha_set (Evas_Object *obj, Eina_Bool has_alpha) EINA_ARG_NONNULL(1)
	Enable or disable alpha channel of the given image object.
EAPI Eina_Bool	evas_object_image_alpha_get (const Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Retrieves the alpha channel setting of the given image object.
EAPI void	evas_object_image_smooth_scale_set (Evas_Object *obj, Eina_Bool smooth_scale) EINA_ARG_NONNULL(1)
	Sets whether to use of high-quality image scaling algorithm of the given image object.
EAPI Eina_Bool	evas_object_image_smooth_scale_get (const Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Retrieves whether the given image object is using use a high-quality image scaling algorithm.
EAPI void	evas_object_image_preload (Evas_Object *obj, Eina_Bool cancel) EINA_ARG_NONNULL(1)
	Preload image in the background.
EAPI void	evas_object_image_reload (Evas_Object *obj) EINA_ARG_NONNULL(1)
	Reload a image of the canvas.
EAPI Eina_Bool EAPI Eina_Bool EAPI void EAPI void	evas_object_image_pixels_dirty_set (Evas_Object *obj, Eina_Bool dirty) EINA_ARG_NONNULL(1)
	Mark whether the given image object is dirty (needs to be redrawn).
EAPI Eina_Bool	evas_object_image_pixels_dirty_get (const Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Retrieves whether the given image object is dirty (needs to be redrawn).
EAPI void	evas_object_image_load_dpi_set (Evas_Object *obj, double dpi) EINA_ARG_NONNULL(1)
	Set the dpi resolution of a loaded image of the canvas.
EAPI double	evas_object_image_load_dpi_get (const Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Get the dpi resolution of a loaded image of the canvas.
EAPI void	evas_object_image_load_size_set (Evas_Object *obj, int w, int h) EINA_ARG_NONNULL(1)
	Set the size of a loaded image of the canvas.
EAPI void	evas_object_image_load_size_get (const Evas_Object obj, int w, int *h) EINA_ARG_NONNULL(1)
	Get the size of a loaded image of the canvas.
EAPI void	evas_object_image_load_scale_down_set (Evas_Object *obj, int scale_down) EINA_ARG_NONNULL(1)
	Set the scale down of a loaded image of the canvas.
EAPI int	evas_object_image_load_scale_down_get (const Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Get the scale down value of given image of the canvas.
EAPI void	evas_object_image_colorspace_set (Evas_Object *obj, Evas_Colorspace cspace) EINA_ARG_NONNULL(1)
	Set the colorspace of a given image of the canvas.
EAPI Evas_Colorspace	evas_object_image_colorspace_get (const Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Get the colorspace of a given image of the canvas.
EAPI void EAPI Evas_Native_Surface *	evas_object_image_native_surface_get (const Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Get the native surface of a given image of the canvas.
EAPI void	evas_object_image_scale_hint_set (Evas_Object *obj, Evas_Image_Scale_Hint hint) EINA_ARG_NONNULL(1)
	Set the scale hint of a given image of the canvas.
EAPI Evas_Image_Scale_Hint	evas_object_image_scale_hint_get (const Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Get the scale hint of a given image of the canvas.
EAPI void	evas_object_image_content_hint_set (Evas_Object *obj, Evas_Image_Content_Hint hint) EINA_ARG_NONNULL(1)
	Set the content hint of a given image of the canvas.
EAPI Evas_Image_Content_Hint	evas_object_image_content_hint_get (const Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Get the content hint of a given image of the canvas.
EAPI Evas_Object *	evas_object_text_add (Evas *e) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_MALLOC
	Creates a new text `Evas_Object` on the provided `Evas` canvas.
EAPI void	evas_object_text_font_source_set (Evas_Object obj, const char font) EINA_ARG_NONNULL(1)
	To be documented.
EAPI const char *	evas_object_text_font_source_get (const Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	To be documented.
EAPI void	evas_object_text_font_set (Evas_Object obj, const char font, Evas_Font_Size size) EINA_ARG_NONNULL(1)
	To be documented.
EAPI void EAPI void	evas_object_text_text_set (Evas_Object obj, const char text) EINA_ARG_NONNULL(1)
	Sets the text to be displayed by the given evas text object.
EAPI const char *	evas_object_text_text_get (const Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Retrieves the text currently being displayed by the given evas text object.
EAPI Evas_Coord	evas_object_text_ascent_get (const Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	To be documented.
EAPI Evas_Coord	evas_object_text_descent_get (const Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	To be documented.
EAPI Evas_Coord	evas_object_text_max_ascent_get (const Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	To be documented.
EAPI Evas_Coord	evas_object_text_max_descent_get (const Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	To be documented.
EAPI Evas_Coord	evas_object_text_horiz_advance_get (const Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	To be documented.
EAPI Evas_Coord	evas_object_text_vert_advance_get (const Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	To be documented.
EAPI Evas_Coord	evas_object_text_inset_get (const Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	To be documented.
EAPI Eina_Bool	evas_object_text_char_pos_get (const Evas_Object obj, int pos, Evas_Coord cx, Evas_Coord cy, Evas_Coord cw, Evas_Coord *ch) EINA_ARG_NONNULL(1)
	Retrieve position and dimension information of a character within a text `Evas_Object`.
EAPI int	evas_object_text_char_coords_get (const Evas_Object obj, Evas_Coord x, Evas_Coord y, Evas_Coord cx, Evas_Coord cy, Evas_Coord cw, Evas_Coord *ch) EINA_ARG_NONNULL(1)
	To be documented.
EAPI int	evas_object_text_last_up_to_pos (const Evas_Object *obj, Evas_Coord x, Evas_Coord y) EINA_ARG_NONNULL(1)
	Returns the logical position of the last char in the text up to the pos given.
EAPI Evas_Text_Style_Type	evas_object_text_style_get (const Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	To be documented.
EAPI void	evas_object_text_style_set (Evas_Object *obj, Evas_Text_Style_Type type) EINA_ARG_NONNULL(1)
	To be documented.
EAPI void	evas_object_text_shadow_color_set (Evas_Object *obj, int r, int g, int b, int a) EINA_ARG_NONNULL(1)
	To be documented.
EAPI void	evas_object_text_shadow_color_get (const Evas_Object obj, int r, int g, int b, int *a) EINA_ARG_NONNULL(1)
	To be documented.
EAPI void	evas_object_text_glow_color_set (Evas_Object *obj, int r, int g, int b, int a) EINA_ARG_NONNULL(1)
	To be documented.
EAPI void	evas_object_text_glow_color_get (const Evas_Object obj, int r, int g, int b, int *a) EINA_ARG_NONNULL(1)
	To be documented.
EAPI void	evas_object_text_glow2_color_set (Evas_Object *obj, int r, int g, int b, int a) EINA_ARG_NONNULL(1)
	To be documented.
EAPI void	evas_object_text_glow2_color_get (const Evas_Object obj, int r, int g, int b, int *a) EINA_ARG_NONNULL(1)
	To be documented.
EAPI void	evas_object_text_outline_color_set (Evas_Object *obj, int r, int g, int b, int a) EINA_ARG_NONNULL(1)
	To be documented.
EAPI void	evas_object_text_outline_color_get (const Evas_Object obj, int r, int g, int b, int *a) EINA_ARG_NONNULL(1)
	To be documented.
EAPI void	evas_object_text_style_pad_get (const Evas_Object obj, int l, int r, int t, int *b) EINA_ARG_NONNULL(1)
	Gets the text style pad of a text object.
EAPI Evas_Object *	evas_object_textblock_add (Evas *e) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_MALLOC
	Adds a textblock to the given evas.
EAPI const char *	evas_textblock_escape_string_get (const char *escape) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Returns the unescaped version of escape.
EAPI const char *	evas_textblock_string_escape_get (const char string, int len_ret) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Returns the escaped version of the string.
EAPI Evas_Textblock_Style *	evas_textblock_style_new (void) EINA_WARN_UNUSED_RESULT EINA_MALLOC
	Creates a new textblock style.
EAPI void	evas_textblock_style_free (Evas_Textblock_Style *ts) EINA_ARG_NONNULL(1)
	Destroys a textblock style.
EAPI void	evas_textblock_style_set (Evas_Textblock_Style ts, const char text) EINA_ARG_NONNULL(1)
	Sets the style ts to the style passed as text by text.
EAPI const char *	evas_textblock_style_get (const Evas_Textblock_Style *ts) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Return the text of the style ts.
EAPI void	evas_object_textblock_style_set (Evas_Object obj, Evas_Textblock_Style ts) EINA_ARG_NONNULL(1)
	Set the objects style to ts.
EAPI const Evas_Textblock_Style *	evas_object_textblock_style_get (const Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Return the style of an object.
EAPI void	evas_object_textblock_replace_char_set (Evas_Object obj, const char ch) EINA_ARG_NONNULL(1)
	Set the "replacement character" to use for the given textblock object.
EAPI const char *	evas_object_textblock_replace_char_get (Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Get the "replacement character" for given textblock object.
EAPI void	evas_object_textblock_text_markup_set (Evas_Object obj, const char text) EINA_ARG_NONNULL(1)
	Sets the tetxblock's text to the markup text.
EAPI void EAPI const char *	evas_object_textblock_text_markup_get (const Evas_Object *obj) EINA_ARG_NONNULL(1)
	Return the markup of the object.
EAPI const Evas_Textblock_Cursor *	evas_object_textblock_cursor_get (const Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Return the object's main cursor.
EAPI Evas_Textblock_Cursor *	evas_object_textblock_cursor_new (Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_MALLOC
	Create a new cursor, associate it to the obj and init it to point to the start of the textblock.
EAPI void	evas_textblock_cursor_free (Evas_Textblock_Cursor *cur) EINA_ARG_NONNULL(1)
	Free the cursor and unassociate it from the object.
EAPI void	evas_textblock_cursor_paragraph_first (Evas_Textblock_Cursor *cur) EINA_ARG_NONNULL(1)
	Sets the cursor to the start of the first text node.
EAPI void	evas_textblock_cursor_paragraph_last (Evas_Textblock_Cursor *cur) EINA_ARG_NONNULL(1)
	sets the cursor to the end of the last text node.
EAPI Eina_Bool	evas_textblock_cursor_paragraph_next (Evas_Textblock_Cursor *cur) EINA_ARG_NONNULL(1)
	Advances to the the start of the next text node.
EAPI Eina_Bool	evas_textblock_cursor_paragraph_prev (Evas_Textblock_Cursor *cur) EINA_ARG_NONNULL(1)
	Advances to the the end of the previous text node.
EAPI const Evas_Object_Textblock_Node_Format *	evas_textblock_node_format_first_get (const Evas_Object *obj) EINA_ARG_NONNULL(1)
	Returns the first format node.
EAPI const Evas_Object_Textblock_Node_Format *	evas_textblock_node_format_last_get (const Evas_Object *obj) EINA_ARG_NONNULL(1)
	Returns the last format node.
EAPI const Evas_Object_Textblock_Node_Format *	evas_textblock_node_format_next_get (const Evas_Object_Textblock_Node_Format *n) EINA_ARG_NONNULL(1)
	Returns the next format node (after n).
EAPI const Evas_Object_Textblock_Node_Format *	evas_textblock_node_format_prev_get (const Evas_Object_Textblock_Node_Format *n) EINA_ARG_NONNULL(1)
	Returns the prev format node (after n).
EAPI void EAPI void EAPI const Evas_Object_Textblock_Node_Format *	evas_textblock_cursor_format_get (const Evas_Textblock_Cursor *cur) EINA_ARG_NONNULL(1)
	Return the format node at the position pointed by cur.
EAPI const char *	evas_textblock_node_format_text_get (const Evas_Object_Textblock_Node_Format *cur) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1)
	Get the text format representation of the format node.
EAPI void EAPI Eina_Bool	evas_textblock_cursor_format_is_visible_get (const Evas_Textblock_Cursor *cur) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Check if the current cursor position is a visible format.
EAPI Eina_Bool	evas_textblock_cursor_format_next (Evas_Textblock_Cursor *cur) EINA_ARG_NONNULL(1)
	Advances to the next format node.
EAPI Eina_Bool	evas_textblock_cursor_format_prev (Evas_Textblock_Cursor *cur) EINA_ARG_NONNULL(1)
	Advances to the previous format node.
EAPI Eina_Bool	evas_textblock_cursor_is_format (const Evas_Textblock_Cursor *cur) EINA_ARG_NONNULL(1)
	Returns true if the cursor points to a format.
EAPI Eina_Bool	evas_textblock_cursor_char_next (Evas_Textblock_Cursor *cur) EINA_ARG_NONNULL(1)
	Advances 1 char forward.
EAPI Eina_Bool	evas_textblock_cursor_char_prev (Evas_Textblock_Cursor *cur) EINA_ARG_NONNULL(1)
	Advances 1 char backward.
EAPI void	evas_textblock_cursor_paragraph_char_first (Evas_Textblock_Cursor *cur) EINA_ARG_NONNULL(1)
	Go to the first char in the node the cursor is pointing on.
EAPI void	evas_textblock_cursor_paragraph_char_last (Evas_Textblock_Cursor *cur) EINA_ARG_NONNULL(1)
	Go to the last char in a text node.
EAPI void	evas_textblock_cursor_line_char_first (Evas_Textblock_Cursor *cur) EINA_ARG_NONNULL(1)
	Go to the start of the current line.
EAPI void	evas_textblock_cursor_line_char_last (Evas_Textblock_Cursor *cur) EINA_ARG_NONNULL(1)
	Go to the end of the current line.
EAPI int	evas_textblock_cursor_pos_get (const Evas_Textblock_Cursor *cur) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Return the current cursor pos.
EAPI void	evas_textblock_cursor_pos_set (Evas_Textblock_Cursor *cur, int pos) EINA_ARG_NONNULL(1)
	Set the cursor pos.
EAPI Eina_Bool	evas_textblock_cursor_line_set (Evas_Textblock_Cursor *cur, int line) EINA_ARG_NONNULL(1)
	Go to the start of the line passed.
EAPI void	evas_textblock_cursor_char_delete (Evas_Textblock_Cursor *cur) EINA_ARG_NONNULL(1)
	Delete the character at the location of the cursor.
EAPI void EAPI const char *	evas_textblock_cursor_paragraph_text_get (const Evas_Textblock_Cursor *cur) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Return the text of the paragraph cur points to - returns the text in markup.
EAPI int	evas_textblock_cursor_paragraph_text_length_get (const Evas_Textblock_Cursor *cur) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Return the length of the paragraph, cheaper the eina_unicode_strlen().
EAPI char *	evas_textblock_cursor_content_get (const Evas_Textblock_Cursor *cur) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_MALLOC
	Return the content of the cursor.
EAPI int	evas_textblock_cursor_geometry_get (const Evas_Textblock_Cursor cur, Evas_Coord cx, Evas_Coord cy, Evas_Coord cw, Evas_Coord ch, Evas_BiDi_Direction dir, Evas_Textblock_Cursor_Type ctype) EINA_ARG_NONNULL(1)
	Returns the geometry of the cursor.
EAPI int	evas_textblock_cursor_char_geometry_get (const Evas_Textblock_Cursor cur, Evas_Coord cx, Evas_Coord cy, Evas_Coord cw, Evas_Coord *ch) EINA_ARG_NONNULL(1)
	Returns the geometry of the char at cur.
EAPI int	evas_textblock_cursor_line_geometry_get (const Evas_Textblock_Cursor cur, Evas_Coord cx, Evas_Coord cy, Evas_Coord cw, Evas_Coord *ch) EINA_ARG_NONNULL(1)
	Returns the geometry of the line at cur.
EAPI Eina_Bool	evas_textblock_cursor_char_coord_set (Evas_Textblock_Cursor *cur, Evas_Coord x, Evas_Coord y) EINA_ARG_NONNULL(1)
	Set the position of the cursor according to the X and Y coordinates.
EAPI int	evas_textblock_cursor_line_coord_set (Evas_Textblock_Cursor *cur, Evas_Coord y) EINA_ARG_NONNULL(1)
	Set the cursor position according to the y coord.
EAPI Eina_Bool	evas_textblock_cursor_format_item_geometry_get (const Evas_Textblock_Cursor cur, Evas_Coord cx, Evas_Coord cy, Evas_Coord cw, Evas_Coord *ch) EINA_ARG_NONNULL(1)
	to be documented.
EAPI Eina_Bool	evas_textblock_cursor_eol_get (const Evas_Textblock_Cursor *cur) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Checks if the cursor points to the end of the line.
EAPI Eina_Bool	evas_object_textblock_line_number_geometry_get (const Evas_Object obj, int line, Evas_Coord cx, Evas_Coord cy, Evas_Coord cw, Evas_Coord *ch) EINA_ARG_NONNULL(1)
	Get the geometry of a line number.
EAPI void	evas_object_textblock_clear (Evas_Object *obj) EINA_ARG_NONNULL(1)
	Clear the textblock object.
EAPI void	evas_object_textblock_size_formatted_get (const Evas_Object obj, Evas_Coord w, Evas_Coord *h) EINA_ARG_NONNULL(1)
	Get the formatted width and height.
EAPI void	evas_object_textblock_size_native_get (const Evas_Object obj, Evas_Coord w, Evas_Coord *h) EINA_ARG_NONNULL(1)
	Get the native width and height.
EAPI void	evas_object_textblock_style_insets_get (const Evas_Object obj, Evas_Coord l, Evas_Coord r, Evas_Coord t, Evas_Coord *b) EINA_ARG_NONNULL(1)
	to be documented.
EAPI Evas_Object *	evas_object_line_add (Evas *e) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_MALLOC
	Adds a new evas line object to the given evas.
EAPI void	evas_object_line_xy_set (Evas_Object *obj, Evas_Coord x1, Evas_Coord y1, Evas_Coord x2, Evas_Coord y2)
	Sets the coordinates of the end points of the given evas line object.
EAPI void	evas_object_line_xy_get (const Evas_Object obj, Evas_Coord x1, Evas_Coord y1, Evas_Coord x2, Evas_Coord *y2)
	Retrieves the coordinates of the end points of the given evas line object.
EAPI Evas_Object *	evas_object_polygon_add (Evas *e) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_MALLOC
	Adds a new evas polygon object to the given evas.
EAPI void	evas_object_polygon_point_add (Evas_Object *obj, Evas_Coord x, Evas_Coord y) EINA_ARG_NONNULL(1)
	Adds the given point to the given evas polygon object.
EAPI void	evas_object_polygon_points_clear (Evas_Object *obj) EINA_ARG_NONNULL(1)
	Removes all of the points from the given evas polygon object.
EAPI void	evas_smart_free (Evas_Smart *s) EINA_ARG_NONNULL(1)
	Free an Evas_Smart.
EAPI Evas_Smart *	evas_smart_class_new (const Evas_Smart_Class *sc) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_MALLOC
	Creates an Evas_Smart from an Evas_Smart_Class.
EAPI const Evas_Smart_Class *	evas_smart_class_get (const Evas_Smart *s) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Get the Evas_Smart_Class of an Evas_Smart.
EAPI void *	evas_smart_data_get (const Evas_Smart *s) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Get the data pointer set on an Evas_Smart.
EAPI void EAPI void	evas_object_smart_member_del (Evas_Object *obj) EINA_ARG_NONNULL(1)
	Removes a member object from a smart object.
EAPI Evas_Object *	evas_object_smart_parent_get (const Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Gets the smart parent of an Evas_Object.
EAPI Eina_List *	evas_object_smart_members_get (const Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Gets the list of the member objects of an Evas_Object.
EAPI Evas_Smart *	evas_object_smart_smart_get (const Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Get the Evas_Smart from which `obj` was created.
EAPI void *	evas_object_smart_data_get (const Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Retrieve user data stored on a smart object.
EAPI void	evas_object_smart_data_set (Evas_Object obj, void data) EINA_ARG_NONNULL(1)
	Store a pointer to user data for a smart object.
EAPI void EAPI void EAPI void EAPI Eina_Bool	evas_object_smart_callbacks_descriptions_set (Evas_Object obj, const Evas_Smart_Cb_Description descriptions) EINA_ARG_NONNULL(1)
	Set smart object instance callbacks descriptions.
EAPI void	evas_object_smart_callbacks_descriptions_get (const Evas_Object obj, const Evas_Smart_Cb_Description *class_descriptions, unsigned int class_count, const Evas_Smart_Cb_Description **instance_descriptions, unsigned int instance_count) EINA_ARG_NONNULL(1)
	Get the callbacks descriptions known by this smart object.
EAPI void EAPI void	evas_object_smart_changed (Evas_Object *obj) EINA_ARG_NONNULL(1)
	Mark smart object as changed, dirty.
EAPI void	evas_object_smart_need_recalculate_set (Evas_Object *obj, Eina_Bool value) EINA_ARG_NONNULL(1)
	Set the need_recalculate flag of given smart object.
EAPI Eina_Bool	evas_object_smart_need_recalculate_get (const Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Get the current value of need_recalculate flag.
EAPI void	evas_object_smart_calculate (Evas_Object *obj) EINA_ARG_NONNULL(1)
	Call user provided calculate() and unset need_calculate.
EAPI void	evas_smart_objects_calculate (Evas *e)
	Call user provided calculate() and unset need_calculate on all objects.
EAPI Evas_Object *	evas_object_smart_clipped_clipper_get (Evas_Object *obj) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Get the clipper object for the given clipped smart object.
EAPI void	evas_object_smart_clipped_smart_set (Evas_Smart_Class *sc) EINA_ARG_NONNULL(1)
	Set smart class callbacks so it implements the "Clipped Smart Object".
EAPI const Evas_Smart_Class *	evas_object_smart_clipped_class_get (void) EINA_CONST
	Get a pointer to the Clipped Smart Class to use for proper inheritance.
EAPI void	evas_object_smart_move_children_relative (Evas_Object *obj, Evas_Coord dx, Evas_Coord dy) EINA_ARG_NONNULL(1)
	Moves all children objects relative to given offset.
EAPI void	evas_object_box_smart_set (Evas_Object_Box_Api *api) EINA_ARG_NONNULL(1)
	Set the default box api struct (Evas_Object_Box_Api) with the default values.
EAPI const Evas_Object_Box_Api *	evas_object_box_smart_class_get (void) EINA_CONST
	Get Box Smart Class for inheritance purposes.
EAPI void EAPI Evas_Object *	evas_object_box_add (Evas *evas) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_MALLOC
	Create a new box.
EAPI Evas_Object *	evas_object_box_add_to (Evas_Object *parent) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_MALLOC
	Create a box that is child of a given element parent.
EAPI void EAPI void EAPI void EAPI void EAPI void EAPI void EAPI void EAPI void EAPI void EAPI void	evas_object_box_align_set (Evas_Object *o, double horizontal, double vertical) EINA_ARG_NONNULL(1)
	Set the alignment of the whole bounding box of contents.
EAPI void	evas_object_box_align_get (const Evas_Object o, double horizontal, double *vertical) EINA_ARG_NONNULL(1)
	Get alignment of the whole bounding box of contents.
EAPI void	evas_object_box_padding_set (Evas_Object *o, Evas_Coord horizontal, Evas_Coord vertical) EINA_ARG_NONNULL(1)
	Set the space (padding) between cells.
EAPI void	evas_object_box_padding_get (const Evas_Object o, Evas_Coord horizontal, Evas_Coord *vertical) EINA_ARG_NONNULL(1)
	Get the (space) padding between cells.
EAPI Evas_Object_Box_Option EAPI Evas_Object_Box_Option EAPI Evas_Object_Box_Option EAPI Evas_Object_Box_Option EAPI Evas_Object_Box_Option *EAPI Eina_Bool EAPI Eina_Bool	evas_object_box_remove_at (Evas_Object *o, unsigned int pos) EINA_ARG_NONNULL(1)
	Remove an object from the box o which occupies position pos.
EAPI Eina_Bool	evas_object_box_remove_all (Evas_Object *o, Eina_Bool clear) EINA_ARG_NONNULL(1)
	Remove all child objects.
EAPI Eina_Iterator *	evas_object_box_iterator_new (const Evas_Object *o) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_MALLOC
	Get an iterator to walk the list of children for the box.
EAPI Eina_Accessor *	evas_object_box_accessor_new (const Evas_Object *o) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_MALLOC
	Get an accessor to get random access to the list of children for the box.
EAPI Eina_List *	evas_object_box_children_get (const Evas_Object *o) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_MALLOC
	Get the list of children for the box.
EAPI const char *	evas_object_box_option_property_name_get (Evas_Object *o, int property) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Get the name of the property of the child elements of the box o whose id is property.
EAPI Evas_Object *	evas_object_table_add (Evas *evas) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_MALLOC
	Create a new table.
EAPI Evas_Object *	evas_object_table_add_to (Evas_Object *parent) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_MALLOC
	Create a table that is child of a given element parent.
EAPI void	evas_object_table_homogeneous_set (Evas_Object *o, Evas_Object_Table_Homogeneous_Mode homogeneous) EINA_ARG_NONNULL(1)
	Set how this table should layout children.
EAPI Evas_Object_Table_Homogeneous_Mode	evas_object_table_homogeneous_get (const Evas_Object *o) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Get the current layout homogeneous mode.
EAPI void	evas_object_table_padding_set (Evas_Object *o, Evas_Coord horizontal, Evas_Coord vertical) EINA_ARG_NONNULL(1)
	Set padding between cells.
EAPI void	evas_object_table_padding_get (const Evas_Object o, Evas_Coord horizontal, Evas_Coord *vertical) EINA_ARG_NONNULL(1)
	Get padding between cells.
EAPI void	evas_object_table_align_set (Evas_Object *o, double horizontal, double vertical) EINA_ARG_NONNULL(1)
	Set the alignment of the whole bounding box of contents.
EAPI void	evas_object_table_align_get (const Evas_Object o, double horizontal, double *vertical) EINA_ARG_NONNULL(1)
	Get alignment of the whole bounding box of contents.
EAPI Eina_Bool EAPI Eina_Bool EAPI void	evas_object_table_clear (Evas_Object *o, Eina_Bool clear) EINA_ARG_NONNULL(1)
	Faster way to remove all child objects from a table object.
EAPI void	evas_object_table_col_row_size_get (const Evas_Object o, int cols, int *rows) EINA_ARG_NONNULL(1)
	Get the number of columns and rows this table takes.
EAPI Eina_Iterator *	evas_object_table_iterator_new (const Evas_Object *o) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_MALLOC
	Get an iterator to walk the list of children for the table.
EAPI Eina_Accessor *	evas_object_table_accessor_new (const Evas_Object *o) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_MALLOC
	Get an accessor to get random access to the list of children for the table.
EAPI Eina_List *	evas_object_table_children_get (const Evas_Object *o) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_MALLOC
	Get the list of children for the table.
EAPI Evas_Object *	evas_object_table_child_get (const Evas_Object *o, unsigned short col, unsigned short row) EINA_ARG_NONNULL(1)
	Get a child from the table using its coordinates.
EAPI Eina_Bool	evas_cserve_want_get (void) EINA_WARN_UNUSED_RESULT EINA_PURE
	Retrieves if the system wants to share bitmaps using the server.
EAPI Eina_Bool	evas_cserve_connected_get (void) EINA_WARN_UNUSED_RESULT
	Retrieves if the system is connected to the server used to shae bitmaps.
EAPI Eina_Bool	evas_cserve_stats_get (Evas_Cserve_Stats *stats) EINA_WARN_UNUSED_RESULT
	Retrieves if the system wants to share bitmaps using the server.
EAPI Eina_Bool	evas_cserve_config_get (Evas_Cserve_Config *config) EINA_WARN_UNUSED_RESULT EINA_PURE
	Retrieves the current configuration of the server.
EAPI Eina_Bool	evas_cserve_config_set (const Evas_Cserve_Config *config) EINA_WARN_UNUSED_RESULT EINA_PURE
	Changes the configuration of the server.
EAPI void	evas_cserve_disconnect (void)
	Force system to disconnect from cache server.
EAPI const char *	evas_load_error_str (Evas_Load_Error error)
	Converts the given error code into a string describing it in english.
EAPI void	evas_color_hsv_to_rgb (float h, float s, float v, int r, int g, int *b)
	Convert a given color from HSV to RGB format.
EAPI void	evas_color_rgb_to_hsv (int r, int g, int b, float h, float s, float *v)
	Convert a given color from RGB to HSV format.
EAPI void	evas_color_argb_premul (int a, int r, int g, int *b)
	Pre-multiplies a rgb triplet by an alpha factor.
EAPI void	evas_color_argb_unpremul (int a, int r, int g, int *b)
	Undo pre-multiplication of a rgb triplet by an alpha factor.
EAPI void	evas_data_argb_premul (unsigned int *data, unsigned int len)
	Pre-multiplies data by an alpha factor.
EAPI void	evas_data_argb_unpremul (unsigned int *data, unsigned int len)
	Undo pre-multiplication data by an alpha factor.
EAPI int	evas_string_char_next_get (const char str, int pos, int decoded) EINA_ARG_NONNULL(1)
	Gets the next character in the string.
EAPI int	evas_string_char_prev_get (const char str, int pos, int decoded) EINA_ARG_NONNULL(1)
	Gets the previous character in the string.
EAPI int	evas_string_char_len_get (const char *str) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Get the length in characters of the string.
EAPI const Evas_Modifier *	evas_key_modifier_get (const Evas *e) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	TO BE DOCUMENTED:
EAPI const Evas_Lock *	evas_key_lock_get (const Evas *e) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_PURE
	Returns a handle to the locks available in the system.

Detailed Description

These routines are used for Evas library interaction.

Todo:

check boolean return values and convert to Eina_Bool

change all api to use EINA_SAFETY_*

finish api documentation

Typedef Documentation

typedef enum _Evas_Button_Flags Evas_Button_Flags

Flags for Mouse Button events.

Flags for Mouse Button events

typedef enum _Evas_Callback_Type Evas_Callback_Type

Identifier of callbacks to be used with object or canvas.

See also:: evas_object_event_callback_add(); evas_event_callback_add() The type of event to trigger the callback

typedef enum _Evas_Event_Flags Evas_Event_Flags

Flags for Events.

Flags for Events

typedef enum _Evas_Pixel_Import_Pixel_Format Evas_Pixel_Import_Pixel_Format

Pixel format for import call.

See evas_object_image_pixels_import()

Enumeration Type Documentation

enum _Evas_Alloc_Error

Enumerator:

EVAS_ALLOC_ERROR_NONE	No allocation error.
EVAS_ALLOC_ERROR_FATAL	Allocation failed despite attempts to free up memory.
EVAS_ALLOC_ERROR_RECOVERED	Allocation succeeded, but extra memory had to be found by freeing up speculative resources.

enum _Evas_Button_Flags

Flags for Mouse Button events.

Enumerator:

EVAS_BUTTON_NONE	No extra mouse button data.
EVAS_BUTTON_DOUBLE_CLICK	This mouse button press was the 2nd press of a double click.
EVAS_BUTTON_TRIPLE_CLICK	This mouse button press was the 3rd press of a triple click.

enum _Evas_Callback_Type

Identifier of callbacks to be used with object or canvas.

See also:: evas_object_event_callback_add(); evas_event_callback_add()

Enumerator:

EVAS_CALLBACK_MOUSE_IN	Mouse In Event.
EVAS_CALLBACK_MOUSE_OUT	Mouse Out Event.
EVAS_CALLBACK_MOUSE_DOWN	Mouse Button Down Event.
EVAS_CALLBACK_MOUSE_UP	Mouse Button Up Event.
EVAS_CALLBACK_MOUSE_MOVE	Mouse Move Event.
EVAS_CALLBACK_MOUSE_WHEEL	Mouse Wheel Event.
EVAS_CALLBACK_MULTI_DOWN	Multi-touch Down Event.
EVAS_CALLBACK_MULTI_UP	Multi-touch Up Event.
EVAS_CALLBACK_MULTI_MOVE	Multi-touch Move Event.
EVAS_CALLBACK_FREE	Object Being Freed (Called after Del).
EVAS_CALLBACK_KEY_DOWN	Key Press Event.
EVAS_CALLBACK_KEY_UP	Key Release Event.
EVAS_CALLBACK_FOCUS_IN	Focus In Event.
EVAS_CALLBACK_FOCUS_OUT	Focus Out Event.
EVAS_CALLBACK_SHOW	Show Event.
EVAS_CALLBACK_HIDE	Hide Event.
EVAS_CALLBACK_MOVE	Move Event.
EVAS_CALLBACK_RESIZE	Resize Event.
EVAS_CALLBACK_RESTACK	Restack Event.
EVAS_CALLBACK_DEL	Object Being Deleted (called before Free).
EVAS_CALLBACK_HOLD	Events go on/off hold.
EVAS_CALLBACK_CHANGED_SIZE_HINTS	Size hints changed event.
EVAS_CALLBACK_IMAGE_PRELOADED	Image as been preloaded.
EVAS_CALLBACK_CANVAS_FOCUS_IN	Canvas got focus as a whole.
EVAS_CALLBACK_CANVAS_FOCUS_OUT	Canvas lost focus as a whole.
EVAS_CALLBACK_RENDER_FLUSH_PRE	Called just before rendering is updated on the canvas target.
EVAS_CALLBACK_RENDER_FLUSH_POST	Called just after rendering is updated on the canvas target.
EVAS_CALLBACK_CANVAS_OBJECT_FOCUS_IN	Canvas object got focus.
EVAS_CALLBACK_CANVAS_OBJECT_FOCUS_OUT	Canvas object lost focus.
EVAS_CALLBACK_IMAGE_UNLOADED	Image data has been unloaded (by some mechanims in evas that throws out original image data).
EVAS_CALLBACK_LAST	keep as last element/sentinel -- not really an event

enum _Evas_Event_Flags

Flags for Events.

Enumerator:

EVAS_EVENT_FLAG_NONE

No fancy flags set.

EVAS_EVENT_FLAG_ON_HOLD

This event is being delivered but should be put "on hold" until the on hold flag is unset.

the event should be used for informational purposes and maybe some indications visually, but not actually perform anything

EVAS_EVENT_FLAG_ON_SCROLL

This event flag indicates the event occurs while scrolling; for exameple, DOWN event occurs during scrolling; the event should be used for informational purposes and maybe some indications visually, but not actually perform anything.

enum _Evas_Fill_Spread

Enumerator:

EVAS_TEXTURE_REFLECT	image fill tiling mode - tiling reflects
EVAS_TEXTURE_REPEAT	tiling repeats
EVAS_TEXTURE_RESTRICT	tiling clamps - range offset ignored
EVAS_TEXTURE_RESTRICT_REFLECT	tiling clamps and any range offset reflects
EVAS_TEXTURE_RESTRICT_REPEAT	tiling clamps and any range offset repeats
EVAS_TEXTURE_PAD	tiling extends with end values

enum _Evas_Load_Error

Enumerator:

EVAS_LOAD_ERROR_NONE	No error on load.
EVAS_LOAD_ERROR_GENERIC	A non-specific error occurred.
EVAS_LOAD_ERROR_DOES_NOT_EXIST	File (or file path) does not exist.
EVAS_LOAD_ERROR_PERMISSION_DENIED	Permission deinied to an existing file (or path).
EVAS_LOAD_ERROR_RESOURCE_ALLOCATION_FAILED	Allocation of resources failure prevented load.
EVAS_LOAD_ERROR_CORRUPT_FILE	File corrupt (but was detected as a known format).
EVAS_LOAD_ERROR_UNKNOWN_FORMAT	File is not a known format.

enum _Evas_Pixel_Import_Pixel_Format

Enumerator:

EVAS_PIXEL_FORMAT_NONE	No pixel format.
EVAS_PIXEL_FORMAT_ARGB32	ARGB 32bit pixel format with A in the high byte per 32bit pixel word.
EVAS_PIXEL_FORMAT_YUV420P_601	YUV 420 Planar format with CCIR 601 color encoding wuth contiguous planes in the order Y, U and V.

Function Documentation

EAPI const Evas_Lock* evas_key_lock_get ( const Evas * e )

Returns a handle to the locks available in the system.

This is required to check for locks with the evas_key_lock_is_set function.

See also:: evas_key_lock_add; evas_key_lock_del; evas_key_lock_on; evas_key_lock_off; evas_key_lock_is_set

Parameters:

e

The pointer to the Evas Canvas

Returns:: An Evas_Lock handle to query the lock subsystem with evas_key_lock_is_set, or NULL on error.

EAPI const Evas_Modifier* evas_key_modifier_get ( const Evas * e )

TO BE DOCUMENTED:

Todo:: document key modifiers.

TO BE DOCUMENTED:

This is required to check for modifiers with the evas_key_modifier_is_set function.

See also:: evas_key_modifier_add; evas_key_modifier_del; evas_key_modifier_on; evas_key_modifier_off; evas_key_modifier_is_set

Parameters:

e

The pointer to the Evas Canvas

Returns:: An Evas_Modifier handle to query the modifier subsystem with evas_key_modifier_is_set, or NULL on error.

EAPI Eina_Bool evas_map_alpha_get ( const Evas_Map * m )

get the alpha flag for map rendering

This gets the alph flag for map rendering.

Parameters:

m

map to get the alpha from. Must not be NULL.

EAPI void evas_map_alpha_set	(	Evas_Map *	m,
		Eina_Bool	enabled
	)

Set the alpha flag for map rendering.

This sets alpha flag for map rendering. If the object is a type that has its own alpha settings, then this will take precedence. Only image objects have this currently. Fits stops alpha blending of the map area, and is useful if you know the object and/or all sub-objects is 100% solid.

Parameters:

	m	map to modify. Must not be NULL.
	enabled	enable or disable alpha map rendering

EAPI Evas_Map* evas_map_dup ( const Evas_Map * m )

Copy a previously allocated map.

This makes a duplicate of the m object and returns it.

Parameters:

m

map to copy. Must not be NULL.

Returns:: newly allocated map with the same count and contents as m.

EAPI void evas_map_free ( Evas_Map * m )

Free a previously allocated map.

This frees a givem map m and all memory associated with it. You must NOT free a map returned by evas_object_map_get() as this is internal.

Parameters:

m

map to free.

EAPI Evas_Map* evas_map_new ( int count )

Create map of transformation points to be later used with an evas object.

This creates a set of points (currently only 4 is supported. no other number for count will work). That is empty and ready to be modified with evas_map calls.

Parameters:

count

number of points in the map. *

Returns:: a newly allocated map or NULL on errors.

See also:: evas_map_free(); evas_map_dup(); evas_map_point_coord_set(); evas_map_point_image_uv_set(); evas_map_util_points_populate_from_object_full(); evas_map_util_points_populate_from_object(); evas_object_map_set()

EAPI void evas_map_point_color_get	(	const Evas_Map *	m,
		int	idx,
		int *	r,
		int *	g,
		int *	b,
		int *	a
	)

Get the color set on a vertex in the map.

This gets the color set by evas_map_point_color_set() on the given vertex of the map.

Parameters:

	m	map to get the color of the vertex from.
	idx	index of point get. Must be smaller than map size.
	r	pointer to red return
	g	pointer to green return
	b	pointer to blue return
	a	pointer to alpha return (0 - 255)

See also:: evas_map_point_coord_set(); evas_object_map_set()

EAPI void evas_map_point_color_set	(	Evas_Map *	m,
		int	idx,
		int	r,
		int	g,
		int	b,
		int	a
	)

Set the color of a vertex in the map.

This sets the color of the vertex in the map. Colors will be linearly interpolated between vertex points through the map. Color will multiply the "texture" pixels (like GL_MODULATE in OpenGL). The default color of a vertex in a map is white solid (255, 255, 255, 255) which means it will have no affect on modifying the texture pixels.

Parameters:

	m	map to change the color of.
	idx	index of point to change. Must be smaller than map size.
	r	red (0 - 255)
	g	green (0 - 255)
	b	blue (0 - 255)
	a	alpha (0 - 255)

See also:: evas_map_util_points_color_set(); evas_map_point_coord_set(); evas_object_map_set()

EAPI void evas_map_point_coord_get	(	const Evas_Map *	m,
		int	idx,
		Evas_Coord *	x,
		Evas_Coord *	y,
		Evas_Coord *	z
	)

Get the map point's coordinate.

This returns the coordinates of the given point in the map.

Parameters:

	m	map to query point.
	idx	index of point to query. Must be smaller than map size.
	x	where to return the X coordinate.
	y	where to return the Y coordinate.
	z	where to return the Z coordinate.

EAPI void evas_map_point_coord_set	(	Evas_Map *	m,
		int	idx,
		Evas_Coord	x,
		Evas_Coord	y,
		Evas_Coord	z
	)

Change the map point's coordinate.

This sets the fixen point's coordinate in the map. Note that points describe the outline of a quadrangle and are ordered either clockwise or anit-clock-wise. It is suggested to keep your quadrangles concave and non-complex, though these polygon modes may work, they may not render a desired set of output. The quadrangle will use points 0 and 1 , 1 and 2, 2 and 3, and 3 and 0 to describe the edges of the quandrangle.

The X and Y and Z coordinates are in canvas units. Z is optional and may or may not be honored in drawing. Z is a hint and does not affect the X and Y rendered coordinates. It may be used for calculating fills with perspective correct rendering.

Remember all coordinates are canvas global ones like with move and reize in evas.

Parameters:

	m	map to change point. Must not be `NULL`.
	idx	index of point to change. Must be smaller than map size.
	x	Point X Coordinate
	y	Point Y Coordinate
	z	Point Z Coordinate hint (pre-perspective transform)

See also:: evas_map_util_rotate(); evas_map_util_zoom(); evas_map_util_points_populate_from_object_full(); evas_map_util_points_populate_from_object()

EAPI void evas_map_point_image_uv_get	(	const Evas_Map *	m,
		int	idx,
		double *	u,
		double *	v
	)

Get the map point's U and V texture source points.

This returns the texture points set by evas_map_point_image_uv_set().

Parameters:

	m	map to query point.
	idx	index of point to query. Must be smaller than map size.
	u	where to write the X coordinate within the image/texture source
	v	where to write the Y coordinate within the image/texture source

EAPI void evas_map_point_image_uv_set	(	Evas_Map *	m,
		int	idx,
		double	u,
		double	v
	)

Change the map point's U and V texture source point.

This sets the U and V coordinates for the point. This determines which coordinate in the source image is mapped to the given point, much like OpenGL and textures. Notes that these points do select the pixel, but are double floating point values to allow for accuracy and sub-pixel selection.

Parameters:

	m	map to change the point of.
	idx	index of point to change. Must be smaller than map size.
	u	the X coordinate within the image/texture source
	v	the Y coordinate within the image/texture source

See also:: evas_map_point_coord_set(); evas_object_map_set(); evas_map_util_points_populate_from_object_full(); evas_map_util_points_populate_from_object()

EAPI Eina_Bool evas_map_smooth_get ( const Evas_Map * m )

get the smoothing for map rendering

This gets smoothing for map rendering.

Parameters:

m

map to get the smooth from. Must not be NULL.

EAPI void evas_map_smooth_set	(	Evas_Map *	m,
		Eina_Bool	enabled
	)

Set the smoothing for map rendering.

This sets smoothing for map rendering. If the object is a type that has its own smoothing settings, then both the smooth settings for this object and the map must be turned off. By default smooth maps are enabled.

Parameters:

	m	map to modify. Must not be NULL.
	enabled	enable or disable smooth map rendering

EAPI void evas_map_util_3d_lighting	(	Evas_Map *	m,
		Evas_Coord	lx,
		Evas_Coord	ly,
		Evas_Coord	lz,
		int	lr,
		int	lg,
		int	lb,
		int	ar,
		int	ag,
		int	ab
	)

Perform lighting calculations on the given Map.

This is used to apply lighting calculations (from a single light source) to a given map. The R, G and B values of each vertex will be modified to reflect the lighting based on the lixth point coordinates, the light color and the ambient color, and at what angle the map is facing the light source. A surface should have its points be declared in a clockwise fashion if the face is "facing" towards you (as opposed to away from you) as faces have a "logical" side for lighting.

Parameters:

	m	map to change.
	lx	X coordinate in space of light point
	ly	Y coordinate in space of light point
	lz	Z coordinate in space of light point
	lr	light red value (0 - 255)
	lg	light green value (0 - 255)
	lb	light blue value (0 - 255)
	ar	ambient color red value (0 - 255)
	ag	ambient color green value (0 - 255)
	ab	ambient color blue value (0 - 255)

EAPI void evas_map_util_3d_perspective	(	Evas_Map *	m,
		Evas_Coord	px,
		Evas_Coord	py,
		Evas_Coord	z0,
		Evas_Coord	foc
	)

Apply a perspective transform to the map.

This applies a given perspective (3D) to the map coordinates. X, Y and Z values are used. The px and py points specify the "infinite distance" point in the 3D conversion (where all lines converge to like when artists draw 3D by hand). The z0 value specifis the z value at which there is a 1:1 mapping between spatial coorinates and screen coordinates. Any points on this z value will not have their X and Y values modified in the transform. Those further away (Z value higher) will shrink into the distance, and those less than this value will expand and become bigger. The foc value determines the "focal length" of the camera. This is in reality the distance between the camera lens plane itself (at or closer than this rendering results are undefined) and the "z0" z value. This allows for some "depth" control and foc must be greater than 0.

Parameters:

	m	map to change.
	px	The pespective distance X coordinate
	py	The pespective distance Y coordinate
	z0	The "0" z plane value
	foc	The focal distance

EAPI void evas_map_util_3d_rotate	(	Evas_Map *	m,
		double	dx,
		double	dy,
		double	dz,
		Evas_Coord	cx,
		Evas_Coord	cy,
		Evas_Coord	cz
	)

Rotate the map around 3 axes in 3D.

This will rotate not just around the "Z" axis as in evas_map_util_rotate() (which is a convenience call for those only wanting 2D). This will rotate around the X, Y and Z axes. The Z axis points "into" the screen with low values at the screen and higher values further away. The X axis runs from left to right on the screen and the Y axis from top to bottom. Like with evas_map_util_rotate(0 you provide a center point to rotate around (in 3D).

Parameters:

	m	map to change.
	dx	amount of degrees from 0.0 to 360.0 to rotate arount X axis.
	dy	amount of degrees from 0.0 to 360.0 to rotate arount Y axis.
	dz	amount of degrees from 0.0 to 360.0 to rotate arount Z axis.
	cx	rotation's center horizontal position.
	cy	rotation's center vertical position.
	cz	rotation's center vertical position.

EAPI Eina_Bool evas_map_util_clockwise_get ( Evas_Map * m )

Get the clockwise state of a map.

This determines if the output points (X and Y. Z is not used) are clockwise or anti-clockwise. This can be used for "back-face culling". This is where you hide objects that "face away" from you. In this case objects that are not clockwise.

Parameters:

m

map to query.

Returns:: 1 if clockwise, 0 otherwise

EAPI void evas_map_util_points_color_set	(	Evas_Map *	m,
		int	r,
		int	g,
		int	b,
		int	a
	)

Set color of all points to given color.

This call is useful to reuse maps after they had 3d lightning or any other colorization applied before.

Parameters:

	m	map to change the color of.
	r	red (0 - 255)
	g	green (0 - 255)
	b	blue (0 - 255)
	a	alpha (0 - 255)

See also:: evas_map_point_color_set()

EAPI void evas_map_util_points_populate_from_geometry	(	Evas_Map *	m,
		Evas_Coord	x,
		Evas_Coord	y,
		Evas_Coord	w,
		Evas_Coord	h,
		Evas_Coord	z
	)

Populate source and destination map points to match given geometry.

Similar to evas_map_util_points_populate_from_object_full(), this call takes raw values instead of querying object's unmapped geometry. The given width will be used to calculate destination points (evas_map_point_coord_set()) and set the image uv (evas_map_point_image_uv_set()).

Parameters:

	m	map to change all 4 points (must be of size 4).
	x	Point X Coordinate
	y	Point Y Coordinate
	w	width to use to calculate second and third points.
	h	height to use to calculate third and fourth points.
	z	Point Z Coordinate hint (pre-perspective transform). This value will be used for all four points.

See also:: evas_map_util_points_populate_from_object(); evas_map_point_coord_set(); evas_map_point_image_uv_set()

EAPI void evas_map_util_points_populate_from_object	(	Evas_Map *	m,
		const Evas_Object *	obj
	)

Populate source and destination map points to match exactly object.

Usually one initialize map of an object to match it's original position and size, then transform these with evas_map_util_* functions, such as evas_map_util_rotate() or evas_map_util_3d_rotate(). The original set is done by this function, avoiding code duplication all around.

Z Point coordinate is assumed as 0 (zero).

Parameters:

	m	map to change all 4 points (must be of size 4).
	obj	object to use unmapped geometry to populate map coordinates.

See also:: evas_map_util_points_populate_from_object_full(); evas_map_util_points_populate_from_geometry(); evas_map_point_coord_set(); evas_map_point_image_uv_set()

EAPI void evas_map_util_points_populate_from_object_full	(	Evas_Map *	m,
		const Evas_Object *	obj,
		Evas_Coord	z
	)

Populate source and destination map points to match exactly object.

Usually one initialize map of an object to match it's original position and size, then transform these with evas_map_util_* functions, such as evas_map_util_rotate() or evas_map_util_3d_rotate(). The original set is done by this function, avoiding code duplication all around.

Parameters:

	m	map to change all 4 points (must be of size 4).
	obj	object to use unmapped geometry to populate map coordinates.
	z	Point Z Coordinate hint (pre-perspective transform). This value will be used for all four points.

See also:: evas_map_util_points_populate_from_object(); evas_map_point_coord_set(); evas_map_point_image_uv_set()

EAPI void evas_map_util_rotate	(	Evas_Map *	m,
		double	degrees,
		Evas_Coord	cx,
		Evas_Coord	cy
	)

Change the map to apply the given rotation.

This rotates the indicated map's coordinates around the center coordinate given by cx and cy as the rotation center. The points will have their X and Y coordinates rotated clockwise by degrees degress (360.0 is a full rotation). Negative values for degrees will rotate counter-clockwise by that amount. All coordinates are canvas global coordinates.

Parameters:

	m	map to change.
	degrees	amount of degrees from 0.0 to 360.0 to rotate.
	cx	rotation's center horizontal position.
	cy	rotation's center vertical position.

See also:: evas_map_point_coord_set(); evas_map_util_zoom()

EAPI void evas_map_util_zoom	(	Evas_Map *	m,
		double	zoomx,
		double	zoomy,
		Evas_Coord	cx,
		Evas_Coord	cy
	)

Change the map to apply the given zooming.

Like evas_map_util_rotate(), this zooms the points of the map from a center point. That center is defined by cx and cy. The zoomx and zoomy parameters specific how much to zoom in the X and Y direction respectively. A value of 1.0 means "don't zoom". 2.0 means "dobule the size". 0.5 is "half the size" etc. All coordinates are canvas global coordinates.

Parameters:

	m	map to change.
	zoomx	horizontal zoom to use.
	zoomy	vertical zoom to use.
	cx	zooming center horizontal position.
	cy	zooming center vertical position.

See also:: evas_map_point_coord_set(); evas_map_util_rotate()

EAPI Eina_Bool evas_object_map_enable_get ( const Evas_Object * obj )

Get the map enabled state.

This returns the currently enabled state of the map on the object indicated. The default map enable state is off. You can enable and disable it with evas_object_map_enable_set().

Parameters:

obj

object to get the map enabled state from

Returns:: the map enabled state

EAPI void evas_object_map_enable_set	(	Evas_Object *	obj,
		Eina_Bool	enabled
	)

Enable or disable the map that is set.

This enables the map that is set or disables it. On enable, the object geometry will be saved, and the new geometry will change (position and size) to reflect the map geometry set. If none is set yet, this may be an undefined geometry, unless you have already set the map with evas_object_map_set(). It is suggested you first set a map with evas_object_map_set() with valid useful coordinates then enable and disable the map with evas_object_map_enable_set() as needed.

Parameters:

	obj	object to enable the map on
	enabled	enabled state

EAPI const Evas_Map* evas_object_map_get ( const Evas_Object * obj )

Get current object transformation map.

This returns the current internal map set on the indicated object. It is intended for read-only acces and is only valid as long as the object is not deleted or the map on the object is not changed. If you wish to modify the map and set it back do the following:

 const Evas_Map *m = evas_object_map_get(obj);
 Evas_Map *m2 = evas_map_dup(m);
 evas_map_util_rotate(m2, 30.0, 0, 0);
 evas_object_map_set(obj);
 evas_map_free(m2);

Parameters:

obj

object to query transformation map.

Returns:: map reference to map in use. This is an internal data structure, so do not modify it.

See also:: evas_object_map_set()

EAPI void evas_object_map_set	(	Evas_Object *	obj,
		const Evas_Map *	map
	)

Set current object transformation map.

This sets the map on a given object. It is copied from the map pointer, so there is no need to keep the map object if you don't need it anymore.

A map is a set of 4 points which have canvas x, y coordinates per point, with an optional z point value as a hint for perspective correction, if it is available. As well each point has u and v coordinates. These are like "texture coordinates" in OpenGL in that they define a point in the source image that is mapped to that map vertex/point. The u corresponds to the x coordinate of this mapped point and v, the y coordinate. Note that these coordinates describe a bounding region to sample. If you have a 200x100 source image and want to display it at 200x100 with proper pixel precision, then do:

 Evas_Map *m = evas_map_new(4);
 evas_map_point_coord_set(m, 0,   0,   0, 0);
 evas_map_point_coord_set(m, 1, 200,   0, 0);
 evas_map_point_coord_set(m, 2, 200, 100, 0);
 evas_map_point_coord_set(m, 3,   0, 100, 0);
 evas_map_point_image_uv_set(m, 0,   0,   0);
 evas_map_point_image_uv_set(m, 1, 200,   0);
 evas_map_point_image_uv_set(m, 2, 200, 100);
 evas_map_point_image_uv_set(m, 3,   0, 100);
 evas_object_map_set(obj, m);
 evas_map_free(m);

Note that the map points a uv coordinates match the image geometry. If the map parameter is NULL, the stored map will be freed and geometry prior to enabling/setting a map will be restored.

Parameters:

	obj	object to change transformation map
	map	new map to use

See also:: evas_map_new()

EAPI Evas_Object* evas_object_map_source_get ( const Evas_Object * obj )

Get the map source object.

See evas_object_map_source_set()

Parameters:

obj

object to set the map source of

Returns:: the object set as the source

EAPI void evas_object_map_source_set	(	Evas_Object *	obj,
		Evas_Object *	src
	)

Set the map source object.

This sets the object from which the map is taken - can be any object that has map enabled on it.

Currently not implemented. for future use.

Parameters:

	obj	object to set the map source of
	src	the source object from which the map is taken

EAPI Eina_List* evas_object_smart_members_get ( const Evas_Object * obj )

Gets the list of the member objects of an Evas_Object.

Parameters:

obj

the Evas_Object you want to get the list of member objects

Returns:: Returns the list of the member objects of obj. The returned list should be freed with eina_list_free() when you no longer need it

Enlightenment

Beauty at your fingertips

Evas.h File Reference

Data Structures

Defines

Typedefs

Enumerations

Functions

Detailed Description

Typedef Documentation

Enumeration Type Documentation

Function Documentation