Tizen Native API

Typedefs

typedef enum _Evas_Callback_Type Evas_Callback_Type
typedef Eo_Callback_Priority Evas_Callback_Priority
typedef enum _Evas_Button_Flags Evas_Button_Flags
typedef enum _Evas_Event_Flags Evas_Event_Flags
typedef enum
_Evas_Touch_Point_State 
Evas_Touch_Point_State
typedef enum
_Evas_Font_Hinting_Flags 
Evas_Font_Hinting_Flags
typedef struct
_Evas_Coord_Rectangle 
Evas_Coord_Rectangle
typedef struct _Evas_Point Evas_Point
typedef struct _Evas_Coord_Point Evas_Coord_Point
typedef struct
_Evas_Coord_Precision_Point 
Evas_Coord_Precision_Point
typedef struct _Evas_Coord_Size Evas_Coord_Size
typedef struct
_Evas_Coord_Precision_Size 
Evas_Coord_Precision_Size
typedef struct _Evas_Position Evas_Position
typedef struct
_Evas_Precision_Position 
Evas_Precision_Position
typedef struct _Evas_Smart_Class Evas_Smart_Class
typedef struct
_Evas_Smart_Interface 
Evas_Smart_Interface
typedef struct
_Evas_Smart_Cb_Description 
Evas_Smart_Cb_Description
typedef Eo Efl_VG
typedef void Evas_Performance
typedef struct _Evas_Modifier Evas_Modifier
typedef struct _Evas_Lock Evas_Lock
typedef struct _Evas_Smart Evas_Smart
typedef struct _Evas_Native_Surface Evas_Native_Surface
typedef struct _Evas_Video_Surface Evas_Video_Surface
typedef unsigned long long Evas_Modifier_Mask
typedef int Evas_Coord
typedef int Evas_Font_Size
typedef int Evas_Angle
typedef enum _Evas_Aspect_Control Evas_Aspect_Control
typedef enum _Evas_Display_Mode Evas_Display_Mode
typedef struct _Evas_Engine_Info Evas_Engine_Info
typedef struct _Evas_Device Evas_Device
typedef struct
_Evas_Event_Mouse_Down 
Evas_Event_Mouse_Down
typedef struct _Evas_Event_Mouse_Up Evas_Event_Mouse_Up
typedef struct _Evas_Event_Mouse_In Evas_Event_Mouse_In
typedef struct
_Evas_Event_Mouse_Out 
Evas_Event_Mouse_Out
typedef struct
_Evas_Event_Mouse_Move 
Evas_Event_Mouse_Move
typedef struct
_Evas_Event_Mouse_Wheel 
Evas_Event_Mouse_Wheel
typedef struct
_Evas_Event_Multi_Down 
Evas_Event_Multi_Down
typedef struct _Evas_Event_Multi_Up Evas_Event_Multi_Up
typedef struct
_Evas_Event_Multi_Move 
Evas_Event_Multi_Move
typedef struct _Evas_Event_Key_Down Evas_Event_Key_Down
typedef struct _Evas_Event_Key_Up Evas_Event_Key_Up
typedef struct _Evas_Event_Hold Evas_Event_Hold
typedef struct
_Evas_Event_Render_Post 
Evas_Event_Render_Post
typedef struct _Evas_Axis Evas_Axis
typedef struct
_Evas_Event_Axis_Update 
Evas_Event_Axis_Update
typedef enum _Evas_Alloc_Error Evas_Alloc_Error
typedef enum
_Evas_Native_Surface_Type 
Evas_Native_Surface_Type
typedef void(* Evas_Video_Cb )(void *data, Evas_Object *obj, const Evas_Video_Surface *surface)
typedef void(* Evas_Video_Coord_Cb )(void *data, Evas_Object *obj, const Evas_Video_Surface *surface, Evas_Coord a, Evas_Coord b)
typedef enum
_Evas_Video_Surface_Caps 
Evas_Video_Surface_Caps
typedef enum _Evas_Border_Fill_Mode Evas_Border_Fill_Mode
typedef enum
_Evas_Engine_Render_Mode 
Evas_Engine_Render_Mode
typedef enum
_Evas_Image_Content_Hint 
Evas_Image_Content_Hint
typedef enum _Evas_Device_Class Evas_Device_Class
typedef enum _Evas_Device_Subclass Evas_Device_Subclass
typedef enum _Evas_Axis_Label Evas_Axis_Label
typedef void(* Evas_Async_Events_Put_Cb )(void *target, Evas_Callback_Type type, void *event_info)
 Evas Async events put function signature.

Defines

#define EVAS_VERSION_MAJOR   EFL_VERSION_MAJOR
#define EVAS_VERSION_MINOR   EFL_VERSION_MINOR
#define EVAS_CALLBACK_PRIORITY_BEFORE   -100
#define EVAS_CALLBACK_PRIORITY_DEFAULT   0
#define EVAS_CALLBACK_PRIORITY_AFTER   100
#define EVAS_NATIVE_SURFACE_VERSION   3
#define EVAS_VIDEO_SURFACE_VERSION   1
#define EVAS_LAYER_MIN   -32768
#define EVAS_LAYER_MAX   32767
#define EVAS_COLOR_SPACE_ARGB   0
#define EVAS_COLOR_SPACE_AHSV   1
#define EVAS_TEXT_INVALID   -1
#define EVAS_TEXT_SPECIAL   -2
#define EVAS_HINT_EXPAND   1.0
#define EVAS_HINT_FILL   -1.0

Drawing canvas.


Define Documentation

#define EVAS_CALLBACK_PRIORITY_AFTER   100

Slightly less prioritized than default.

Since (EFL) :
1.1
#define EVAS_CALLBACK_PRIORITY_BEFORE   -100

Slightly more prioritized than default.

Since (EFL) :
1.1

Default callback priority level

Since (EFL) :
1.1
#define EVAS_COLOR_SPACE_AHSV   1

Not used for anything

#define EVAS_COLOR_SPACE_ARGB   0

Not used for anything

#define EVAS_LAYER_MAX   32767

top-most layer number

#define EVAS_LAYER_MIN   -32768

bottom-most layer number

Magic version number to know what the native surface struct looks like

#define EVAS_TEXT_INVALID   -1

Not used for anything

#define EVAS_TEXT_SPECIAL   -2

Not used for anything

#define EVAS_VERSION_MAJOR   EFL_VERSION_MAJOR

The major number of evas version

#define EVAS_VERSION_MINOR   EFL_VERSION_MINOR

The minor number of eet version

Magic version number to know what the video surf struct looks like

Since (EFL) :
1.1

Typedef Documentation

typedef Eo Efl_VG

Type of abstract VG node

Possible allocation errors

typedef int Evas_Angle

A type for angle

Aspect types/policies for scaling size hints, used for evas_object_size_hint_aspect_set()

typedef void(* Evas_Async_Events_Put_Cb)(void *target, Evas_Callback_Type type, void *event_info)

Evas Async events put function signature.

Since :
2.3
typedef struct _Evas_Axis Evas_Axis

Details for a single device axis state

Since (EFL) :
1.13

Types of recognized device axes

Since (EFL) :
1.13

How an image's center region (the complement to the border region) should be rendered by Evas

Flags for Mouse Button events Flags for Mouse Button events

Callback priority value. Range is -32k - 32k. The lower the number, the bigger the priority.

See also:
EVAS_CALLBACK_PRIORITY_AFTER
EVAS_CALLBACK_PRIORITY_BEFORE
EVAS_CALLBACK_PRIORITY_DEFAULT
Since (EFL) :
1.1

Identifier of callbacks to be set for Evas canvases or Evas objects.

The following figure illustrates some Evas callbacks:

evas-callbacks.png
See also:
evas_object_event_callback_add()
evas_event_callback_add() The types of events triggering a callback
typedef int Evas_Coord

A type for coordinates

Evas_Coord point

Evas_Coord point with sub-pixel precision

Evas_Coord size with sub-pixel precision

Since (EFL) :
1.8

A generic rectangle handle

Evas_Coord size

Since (EFL) :
1.8
typedef struct _Evas_Device Evas_Device

A source device handle - where the event came from

A general class of device

Since (EFL) :
1.8

A general class of device

Since (EFL) :
1.8

object's display mode type related with compress/expand or etc mode

A generic Evas Engine information structure

behaviour of the renderer

typedef struct _Evas_Event_Axis_Update Evas_Event_Axis_Update

Event structure for EVAS_CALLBACK_AXIS_UPDATE event callbacks

Since (EFL) :
1.13

Flags for Events Flags for Events

Event structure for EVAS_CALLBACK_HOLD event callbacks

Event structure for EVAS_CALLBACK_KEY_DOWN event callbacks

Event structure for EVAS_CALLBACK_KEY_UP event callbacks

Event structure for EVAS_CALLBACK_MOUSE_DOWN event callbacks

Event structure for EVAS_CALLBACK_MOUSE_IN event callbacks

Event structure for EVAS_CALLBACK_MOUSE_MOVE event callbacks

Event structure for EVAS_CALLBACK_MOUSE_OUT event callbacks

Event structure for EVAS_CALLBACK_MOUSE_UP event callbacks

Event structure for EVAS_CALLBACK_MOUSE_WHEEL event callbacks

Event structure for EVAS_CALLBACK_MULTI_DOWN event callbacks

Event structure for EVAS_CALLBACK_MULTI_MOVE event callbacks

Event structure for EVAS_CALLBACK_MULTI_UP event callbacks

Event structure that may come with EVAS_CALLBACK_RENDER_POST event callbacks

Since (EFL) :
1.8

Flags for Font Hinting Flags for Font Hinting

typedef int Evas_Font_Size

A type for font size

How an image's data is to be treated by Evas, for optimization

typedef struct _Evas_Lock Evas_Lock

An opaque type containing information on which lock keys are registered in an Evas canvas

typedef struct _Evas_Modifier Evas_Modifier

An opaque type containing information on which modifier keys are registered in an Evas canvas

typedef unsigned long long Evas_Modifier_Mask

An Evas modifier mask type

A generic datatype for engine specific native surface information

Native surface types that image object supports

See also:
Evas_Native_Surface
evas_object_image_native_surface_set()
typedef void Evas_Performance

An Evas Performance handle

typedef struct _Evas_Point Evas_Point

integer point

typedef struct _Evas_Position Evas_Position

associates given point in Canvas and Output

associates given point in Canvas and Output, with sub-pixel precision

typedef struct _Evas_Smart Evas_Smart

An Evas Smart Object handle

A smart object callback description, used to provide introspection

A smart object's base class definition

A smart object's base interface definition

An Evas interface is exactly like the OO-concept: an 'contract' or API a given object is declared to support. A smart object may have more than one interface, thus extending the behavior it gets from sub-classing.

Since (EFL) :
1.7

State of Evas_Coord_Touch_Point

typedef void(* Evas_Video_Cb)(void *data, Evas_Object *obj, const Evas_Video_Surface *surface)

Evas video callback function signature

typedef void(* Evas_Video_Coord_Cb)(void *data, Evas_Object *obj, const Evas_Video_Surface *surface, Evas_Coord a, Evas_Coord b)

Evas video coordinates callback function signature

A generic datatype for video specific surface information

See also:
evas_object_image_video_surface_set
evas_object_image_video_surface_get
Since (EFL) :
1.1

Enum values for the Video surface capabilities


Enumeration Type Documentation

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

Enumerator:
EVAS_ASPECT_CONTROL_NONE 

Preference on scaling unset

EVAS_ASPECT_CONTROL_NEITHER 

Same effect as unset preference on scaling

EVAS_ASPECT_CONTROL_HORIZONTAL 

Use all horizontal container space to place an object, using the given aspect

EVAS_ASPECT_CONTROL_VERTICAL 

Use all vertical container space to place an object, using the given aspect

EVAS_ASPECT_CONTROL_BOTH 

Use all horizontal and vertical container spaces to place an object (never growing it out of those bounds), using the given aspect

Enumerator:
EVAS_AXIS_LABEL_UNKNOWN 

Axis containing unknown (or not yet representable) data. Range: Unbounded. Unit: Undefined.

Since (EFL) :
1.13
EVAS_AXIS_LABEL_X 

Position along physical X axis; not window relative. Range: Unbounded. Unit: Undefined.

Since (EFL) :
1.13
EVAS_AXIS_LABEL_Y 

Position along physical Y axis; not window relative. Range: Unbounded. Unit: Undefined.

Since (EFL) :
1.13
EVAS_AXIS_LABEL_PRESSURE 

Force applied to tool tip. Range: [0.0, 1.0]. Unit: Unitless.

Since (EFL) :
1.13
EVAS_AXIS_LABEL_DISTANCE 

Relative distance along physical Z axis. Range: [0.0, 1.0]. Unit: Unitless

Since (EFL) :
1.13
EVAS_AXIS_LABEL_AZIMUTH 

Angle of tool about the Z axis from positive X axis. Range: [-PI, PI]. Unit: Radians.

Since (EFL) :
1.13
EVAS_AXIS_LABEL_TILT 

Angle of tool about plane of sensor from positive Z axis. Range: [0.0, PI]. Unit: Radians.

Since (EFL) :
1.13
EVAS_AXIS_LABEL_TWIST 

Rotation of tool about its major axis from its natural position. Range: [-PI, PI] Unit: Radians.

Since (EFL) :
1.13
EVAS_AXIS_LABEL_TOUCH_WIDTH_MAJOR 

Length of contact ellipse along AZIMUTH. Range: Unbounded: Unit: Same as EVAS_AXIS_LABEL_{X,Y}.

Since (EFL) :
1.13
EVAS_AXIS_LABEL_TOUCH_WIDTH_MINOR 

Length of contact ellipse perpendicular to AZIMUTH. Range: Unbounded. Unit: Same as EVAS_AXIS_LABEL_{X,Y}.

Since (EFL) :
1.13
EVAS_AXIS_LABEL_TOOL_WIDTH_MAJOR 

Length of tool ellipse along AZIMUTH. Range: Unbounded. Unit: Same as EVAS_AXIS_LABEL_{X,Y}.

Since (EFL) :
1.13
EVAS_AXIS_LABEL_TOOL_WIDTH_MINOR 

Length of tool ellipse perpendicular to AZIMUTH. Range: Unbounded. Unit: Same as EVAS_AXIS_LABEL_{X,Y}.

Since (EFL) :
1.13
Enumerator:
EVAS_BORDER_FILL_NONE 

Image's center region is not to be rendered

EVAS_BORDER_FILL_DEFAULT 

Image's center region is to be blended with objects underneath it, if it has transparency. This is the default behavior for image objects

EVAS_BORDER_FILL_SOLID 

Image's center region is to be made solid, even if it has transparency on it

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

Identifier of callbacks to be set for Evas canvases or Evas objects.

The following figure illustrates some Evas callbacks:

evas-callbacks.png
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 has 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 mechanism in Evas that throw out original image data)

EVAS_CALLBACK_RENDER_PRE 

Called just before rendering starts on the canvas target

Since (EFL) :
1.2
EVAS_CALLBACK_RENDER_POST 

Called just after rendering stops on the canvas target

Since (EFL) :
1.2
EVAS_CALLBACK_IMAGE_RESIZE 

Image size is changed

Since (EFL) :
1.8
EVAS_CALLBACK_DEVICE_CHANGED 

Devices added, removed or changed on canvas

Since (EFL) :
1.8
EVAS_CALLBACK_AXIS_UPDATE 

Input device changed value on some axis

Since (EFL) :
1.13
EVAS_CALLBACK_CANVAS_VIEWPORT_RESIZE 

Canvas viewport resized

Since (EFL) :
1.15
EVAS_CALLBACK_LAST 

kept as last element/sentinel -- not really an event

Enumerator:
EVAS_DEVICE_CLASS_NONE 

Not a device

Since (EFL) :
1.8
EVAS_DEVICE_CLASS_SEAT 

The user/seat (the user themselves)

Since (EFL) :
1.8
EVAS_DEVICE_CLASS_KEYBOARD 

A regular keyboard, numberpad or attached buttons

Since (EFL) :
1.8
EVAS_DEVICE_CLASS_MOUSE 

A mouse, trackball or touchpad relative motion device

Since (EFL) :
1.8
EVAS_DEVICE_CLASS_TOUCH 

A touchscreen with fingers or stylus

Since (EFL) :
1.8
EVAS_DEVICE_CLASS_PEN 

A special pen device

Since (EFL) :
1.8
EVAS_DEVICE_CLASS_POINTER 

A laser pointer, wii-style or minority report pointing device

Since (EFL) :
1.8
EVAS_DEVICE_CLASS_GAMEPAD 

A gamepad controller or joystick

Since (EFL) :
1.8
Enumerator:
EVAS_DEVICE_SUBCLASS_NONE 

Not a device

Since (EFL) :
1.8
EVAS_DEVICE_SUBCLASS_FINGER 

The normal flat of your finger

Since (EFL) :
1.8
EVAS_DEVICE_SUBCLASS_FINGERNAIL 

A fingernail

Since (EFL) :
1.8
EVAS_DEVICE_SUBCLASS_KNUCKLE 

A Knuckle

Since (EFL) :
1.8
EVAS_DEVICE_SUBCLASS_PALM 

The palm of a users hand

Since (EFL) :
1.8
EVAS_DEVICE_SUBCLASS_HAND_SIZE 

The side of your hand

Since (EFL) :
1.8
EVAS_DEVICE_SUBCLASS_HAND_FLAT 

The flat of your hand

Since (EFL) :
1.8
EVAS_DEVICE_SUBCLASS_PEN_TIP 

The tip of a pen

Since (EFL) :
1.8
EVAS_DEVICE_SUBCLASS_TRACKPAD 

A trackpad style mouse

Since (EFL) :
1.8
EVAS_DEVICE_SUBCLASS_TRACKPOINT 

A trackpoint style mouse

Since (EFL) :
1.8
EVAS_DEVICE_SUBCLASS_TRACKBALL 

A trackball style mouse

Since (EFL) :
1.8
Enumerator:
EVAS_DISPLAY_MODE_NONE 

Default mode

EVAS_DISPLAY_MODE_COMPRESS 

deprecated Use this mode when you want to give compress display mode hint to an object

EVAS_DISPLAY_MODE_EXPAND 

Use this mode when you want to give expand display mode hint to an object

EVAS_DISPLAY_MODE_DONT_CHANGE 

Use this mode when an object should not change its display mode

Enumerator:
EVAS_RENDER_MODE_BLOCKING 

The rendering is blocking mode

EVAS_RENDER_MODE_NONBLOCKING 

The rendering is non blocking mode

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 example, DOWN event occurs during scrolling; the event should be used for informational purposes and maybe some indications visually, but not actually perform anything

Flags for Font Hinting

Enumerator:
EVAS_FONT_HINTING_NONE 

No font hinting

EVAS_FONT_HINTING_AUTO 

Automatic font hinting

EVAS_FONT_HINTING_BYTECODE 

Bytecode font hinting

Enumerator:
EVAS_IMAGE_CONTENT_HINT_NONE 

No hint at all

EVAS_IMAGE_CONTENT_HINT_DYNAMIC 

The contents will change over time

EVAS_IMAGE_CONTENT_HINT_STATIC 

The contents won't change over time

Native surface types that image object supports

See also:
Evas_Native_Surface
evas_object_image_native_surface_set()
Enumerator:
EVAS_NATIVE_SURFACE_NONE 

No surface type

EVAS_NATIVE_SURFACE_X11 

X Window system based type. pixmap id or visual of the pixmap

EVAS_NATIVE_SURFACE_OPENGL 

OpenGL system based type. texture or framebuffer id

EVAS_NATIVE_SURFACE_TBM 

deprecated Tizen system based type. This is used for tizen buffer manager.

EVAS_NATIVE_SURFACE_EVASGL 

Evas GL based type. evas gl surface

EVAS_NATIVE_SURFACE_WL 

Wayland system based type. buffer of surface

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 with contiguous planes in the order Y, U and V

State of Evas_Coord_Touch_Point

Enumerator:
EVAS_TOUCH_POINT_DOWN 

Touch point is pressed down

EVAS_TOUCH_POINT_UP 

Touch point is released

EVAS_TOUCH_POINT_MOVE 

Touch point is moved

EVAS_TOUCH_POINT_STILL 

Touch point is not moved after pressed

EVAS_TOUCH_POINT_CANCEL 

Touch point is cancelled

Enum values for the Video surface capabilities

Enumerator:
EVAS_VIDEO_SURFACE_MOVE 

Move capability

EVAS_VIDEO_SURFACE_RESIZE 

Resize capability

EVAS_VIDEO_SURFACE_CLIP 

Clip capability

EVAS_VIDEO_SURFACE_BELOW 

Below capability

EVAS_VIDEO_SURFACE_STACKING_CHECK 

Stacking capability

EVAS_VIDEO_SURFACE_IGNORE_WINDOW 

Ignore window capability