efl.evas
Module¶
Classes¶
efl.evas.Canvas
Classefl.evas.Object
Classefl.evas.Image
Classefl.evas.FilledImage
Classefl.evas.Rectangle
Classefl.evas.Line
Classefl.evas.Polygon
Classefl.evas.Text
Classefl.evas.Textblock
Classefl.evas.Textgrid
Classefl.evas.Box
Classefl.evas.Table
Classefl.evas.Grid
Classefl.evas.Map
Classefl.evas.Rect
Classefl.evas.Smart
Classefl.evas.SmartObject
Class
Enumerations¶
Size Hints Helper¶
Helper values to be used as Size Hints for objects.
- EVAS_HINT_EXPAND = -1.0
to be used with weight or expand
- EVAS_HINT_FILL = 1.0
to be used with align or fill
- EXPAND_BOTH = EVAS_HINT_EXPAND, EVAS_HINT_EXPAND
Expand in both direction
New in version 1.13.
- EXPAND_HORIZ = EVAS_HINT_EXPAND, 0.0
Expand horizontally
New in version 1.13.
- EXPAND_VERT = 0.0, EVAS_HINT_EXPAND
Expand vertically
New in version 1.13.
- FILL_BOTH = EVAS_HINT_FILL, EVAS_HINT_FILL
Fill both direction
New in version 1.13.
- FILL_HORIZ = EVAS_HINT_FILL, 0.5
Fill horizontally
New in version 1.13.
- FILL_VERT = 0.5, EVAS_HINT_FILL
Fill vertically
New in version 1.13.
Evas_Button_Flags¶
Flags for Mouse Button events.
- efl.evas.EVAS_BUTTON_NONE¶
No extra mouse button data.
- efl.evas.EVAS_BUTTON_DOUBLE_CLICK¶
This mouse button press was the 2nd press of a double click.
- efl.evas.EVAS_BUTTON_TRIPLE_CLICK¶
This mouse button press was the 3rd press of a triple click.
Evas_BiDi_Direction¶
- efl.evas.EVAS_BIDI_DIRECTION_NATURAL¶
Natural direction.
- efl.evas.EVAS_BIDI_DIRECTION_NEUTRAL¶
Neutral direction.
- efl.evas.EVAS_BIDI_DIRECTION_LTR¶
Left to right direction.
- efl.evas.EVAS_BIDI_DIRECTION_RTL¶
Right to left direction.
- efl.evas.EVAS_BIDI_DIRECTION_INHERIT¶
Inherit direction from parent object.
New in version 1.17.
Evas_Callback_Type¶
- efl.evas.EVAS_CALLBACK_MOUSE_IN¶
Mouse In Event.
- efl.evas.EVAS_CALLBACK_MOUSE_OUT¶
Mouse Out Event.
- efl.evas.EVAS_CALLBACK_MOUSE_DOWN¶
Mouse Button Down Event.
- efl.evas.EVAS_CALLBACK_MOUSE_UP¶
Mouse Button Up Event.
- efl.evas.EVAS_CALLBACK_MOUSE_MOVE¶
Mouse Move Event.
- efl.evas.EVAS_CALLBACK_MOUSE_WHEEL¶
Mouse Wheel Event.
- efl.evas.EVAS_CALLBACK_MULTI_DOWN¶
Multi-touch Down Event.
- efl.evas.EVAS_CALLBACK_MULTI_UP¶
Multi-touch Up Event.
- efl.evas.EVAS_CALLBACK_MULTI_MOVE¶
Multi-touch Move Event.
- efl.evas.EVAS_CALLBACK_FREE¶
Object Being Freed (Called after Del).
- efl.evas.EVAS_CALLBACK_KEY_DOWN¶
Key Press Event.
- efl.evas.EVAS_CALLBACK_KEY_UP¶
Key Release Event.
- efl.evas.EVAS_CALLBACK_FOCUS_IN¶
Focus In Event.
- efl.evas.EVAS_CALLBACK_FOCUS_OUT¶
Focus Out Event.
- efl.evas.EVAS_CALLBACK_SHOW¶
Show Event.
- efl.evas.EVAS_CALLBACK_HIDE¶
Hide Event.
- efl.evas.EVAS_CALLBACK_MOVE¶
Move Event.
- efl.evas.EVAS_CALLBACK_RESIZE¶
Resize Event.
- efl.evas.EVAS_CALLBACK_RESTACK¶
Restack Event.
- efl.evas.EVAS_CALLBACK_DEL¶
Object Being Deleted (called before Free).
- efl.evas.EVAS_CALLBACK_HOLD¶
Events go on/off hold.
- efl.evas.EVAS_CALLBACK_CHANGED_SIZE_HINTS¶
Size hints changed event.
- efl.evas.EVAS_CALLBACK_IMAGE_PRELOADED¶
Image has been preloaded.
- efl.evas.EVAS_CALLBACK_CANVAS_FOCUS_IN¶
Canvas got focus as a whole.
- efl.evas.EVAS_CALLBACK_CANVAS_FOCUS_OUT¶
Canvas lost focus as a whole.
- efl.evas.EVAS_CALLBACK_RENDER_FLUSH_PRE¶
Called just before rendering is updated on the canvas target.
- efl.evas.EVAS_CALLBACK_RENDER_FLUSH_POST¶
Called just after rendering is updated on the canvas target.
- efl.evas.EVAS_CALLBACK_CANVAS_OBJECT_FOCUS_IN¶
Canvas object got focus.
- efl.evas.EVAS_CALLBACK_CANVAS_OBJECT_FOCUS_OUT¶
Canvas object lost focus.
- efl.evas.EVAS_CALLBACK_IMAGE_UNLOADED¶
Image data has been unloaded.
- efl.evas.EVAS_CALLBACK_RENDER_PRE¶
Called just before rendering starts on the canvas target.
- efl.evas.EVAS_CALLBACK_RENDER_POST¶
Called just after rendering stops on the canvas target.
- efl.evas.EVAS_CALLBACK_IMAGE_RESIZE¶
Image size is changed.
- efl.evas.EVAS_CALLBACK_DEVICE_CHANGED¶
Devices added, removed or changed on canvas.
- efl.evas.EVAS_CALLBACK_AXIS_UPDATE¶
Input device changed value on some axis. (since 1.13)
- efl.evas.EVAS_CALLBACK_CANVAS_VIEWPORT_RESIZE¶
Canvas viewport resized. (since 1.15)
- efl.evas.EVAS_CALLBACK_LAST¶
kept as last element/sentinel – not really an event.
Evas_Event_Flags¶
- efl.evas.EVAS_EVENT_FLAG_NONE¶
No fancy flags set.
- efl.evas.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
- efl.evas.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
Evas_Touch_Point_State¶
- efl.evas.EVAS_TOUCH_POINT_DOWN¶
Touch point is pressed down
- efl.evas.EVAS_TOUCH_POINT_UP¶
Touch point is released
- efl.evas.EVAS_TOUCH_POINT_MOVE¶
Touch point is moved
- efl.evas.EVAS_TOUCH_POINT_STILL¶
Touch point is not moved after pressed
- efl.evas.EVAS_TOUCH_POINT_CANCEL¶
Touch point is cancelled
Evas_Font_Hinting_Flags¶
- efl.evas.EVAS_FONT_HINTING_NONE¶
No font hinting
- efl.evas.EVAS_FONT_HINTING_AUTO¶
Automatic font hinting
- efl.evas.EVAS_FONT_HINTING_BYTECODE¶
Bytecode font hinting
Evas_Colorspace¶
- efl.evas.EVAS_COLORSPACE_ARGB8888¶
ARGB8888
- efl.evas.EVAS_COLORSPACE_YCBCR422P601_PL¶
YCBCR422P601_PL
- efl.evas.EVAS_COLORSPACE_YCBCR422P709_PL¶
YCBCR422P709_PL
- efl.evas.EVAS_COLORSPACE_RGB565_A5P¶
RGB565_A5P
- efl.evas.EVAS_COLORSPACE_GRY8¶
GRY8
- efl.evas.EVAS_COLORSPACE_YCBCR422601_PL¶
YCBCR422601_PL
- efl.evas.EVAS_COLORSPACE_YCBCR420NV12601_PL¶
YCBCR420NV12601_PL
- efl.evas.EVAS_COLORSPACE_YCBCR420TM12601_PL¶
YCBCR420TM12601_PL
Evas_Object_Table_Homogeneous_Mode¶
How to pack items into cells in a table
- efl.evas.EVAS_OBJECT_TABLE_HOMOGENEOUS_NONE¶
None
- efl.evas.EVAS_OBJECT_TABLE_HOMOGENEOUS_TABLE¶
Table
- efl.evas.EVAS_OBJECT_TABLE_HOMOGENEOUS_ITEM¶
Item
Evas_Aspect_Control¶
- efl.evas.EVAS_ASPECT_CONTROL_NONE¶
Preference on scaling unset
- efl.evas.EVAS_ASPECT_CONTROL_NEITHER¶
Same effect as unset preference on scaling
- efl.evas.EVAS_ASPECT_CONTROL_HORIZONTAL¶
Use all horizontal container space to place an object, using the given aspect
- efl.evas.EVAS_ASPECT_CONTROL_VERTICAL¶
Use all vertical container space to place an object, using the given aspect
- efl.evas.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
Evas_Display_Mode¶
- efl.evas.EVAS_DISPLAY_MODE_NONE¶
Default mode.
- efl.evas.EVAS_DISPLAY_MODE_COMPRESS¶
Use this mode when you want to give compress display mode hint to an object.
- efl.evas.EVAS_DISPLAY_MODE_EXPAND¶
Use this mode when you want to give expand display mode hint to an object.
- efl.evas.EVAS_DISPLAY_MODE_DONT_CHANGE¶
Use this mode when an object should not change its display mode.
Evas_Load_Error¶
- efl.evas.EVAS_LOAD_ERROR_NONE¶
None.
- efl.evas.EVAS_LOAD_ERROR_GENERIC¶
Generic.
- efl.evas.EVAS_LOAD_ERROR_DOES_NOT_EXIST¶
Not exists.
- efl.evas.EVAS_LOAD_ERROR_PERMISSION_DENIED¶
Permission danied.
- efl.evas.EVAS_LOAD_ERROR_RESOURCE_ALLOCATION_FAILED¶
Allocation failure.
- efl.evas.EVAS_LOAD_ERROR_CORRUPT_FILE¶
Corrupted file.
- efl.evas.EVAS_LOAD_ERROR_UNKNOWN_FORMAT¶
Unknown format.
Evas_Alloc_Error¶
- efl.evas.EVAS_ALLOC_ERROR_NONE¶
No allocation error.
- efl.evas.EVAS_ALLOC_ERROR_FATAL¶
Allocation failed despite attempts to free up memory.
- efl.evas.EVAS_ALLOC_ERROR_RECOVERED¶
Allocation succeeded, but extra memory had to be found by freeing up speculative resources.
XXX¶
- efl.evas.EVAS_TEXTURE_REFLECT¶
Image fill tiling mode - tiling reflects
- efl.evas.EVAS_TEXTURE_REPEAT¶
Image fill tiling mode - tiling reflects
- efl.evas.EVAS_TEXTURE_RESTRICT¶
Tiling clamps - range offset ignored
- efl.evas.EVAS_TEXTURE_RESTRICT_REFLECT¶
Tiling clamps and any range offset reflects
- efl.evas.EVAS_TEXTURE_RESTRICT_REPEAT¶
Tiling clamps and any range offset repeats
- efl.evas.EVAS_TEXTURE_PAD¶
Tiling extends with end values
Evas_Pixel_Import_Pixel_Format¶
- efl.evas.EVAS_PIXEL_FORMAT_NONE¶
No pixel format.
- efl.evas.EVAS_PIXEL_FORMAT_ARGB32¶
ARGB 32bit pixel format with A in the high byte per 32bit pixel word.
- efl.evas.EVAS_PIXEL_FORMAT_YUV420P_601¶
YUV 420 Planar format with CCIR 601 color encoding with contiguous planes in the order Y, U and V.
_Evas_Native_Surface_Type¶
- efl.evas.EVAS_NATIVE_SURFACE_NONE¶
No surface type.
- efl.evas.EVAS_NATIVE_SURFACE_X11¶
X Window system based type.
- efl.evas.EVAS_NATIVE_SURFACE_OPENGL¶
OpenGL system based type.
- efl.evas.EVAS_NATIVE_SURFACE_WL¶
Wayland system based type.
Evas_Render_Op¶
- efl.evas.EVAS_RENDER_BLEND¶
default op: d = d*(1-sa) + s
- efl.evas.EVAS_RENDER_BLEND_REL¶
d = d*(1 - sa) + s*da
- efl.evas.EVAS_RENDER_COPY¶
d = s
- efl.evas.EVAS_RENDER_COPY_REL¶
d = s*da
- efl.evas.EVAS_RENDER_ADD¶
Unknown
- efl.evas.EVAS_RENDER_ADD_REL¶
d = d + s*da
- efl.evas.EVAS_RENDER_SUB¶
d = d - s
- efl.evas.EVAS_RENDER_SUB_REL¶
Unknown
- efl.evas.EVAS_RENDER_TINT¶
d = d*s + d*(1 - sa) + s*(1 - da)
- efl.evas.EVAS_RENDER_TINT_REL¶
d = d*(1 - sa + s)
- efl.evas.EVAS_RENDER_MASK¶
d = d*sa
- efl.evas.EVAS_RENDER_MUL¶
d = d*s
Evas_Border_Fill_Mode¶
- efl.evas.EVAS_BORDER_FILL_NONE¶
None
- efl.evas.EVAS_BORDER_FILL_DEFAULT¶
Default
- efl.evas.EVAS_BORDER_FILL_SOLID¶
Solid
Evas_Image_Scale_Hint¶
- efl.evas.EVAS_IMAGE_SCALE_HINT_NONE¶
None
- efl.evas.EVAS_IMAGE_SCALE_HINT_DYNAMIC¶
Dynamic
- efl.evas.EVAS_IMAGE_SCALE_HINT_STATIC¶
Static
Evas_Image_Animated_Loop_Hint¶
- efl.evas.EVAS_IMAGE_ANIMATED_HINT_NONE¶
None
- efl.evas.EVAS_IMAGE_ANIMATED_HINT_LOOP¶
Loop
- efl.evas.EVAS_IMAGE_ANIMATED_HINT_PINGPONG¶
Pingpong
Evas_Image_Orient¶
New in version 1.14.
- efl.evas.EVAS_IMAGE_ORIENT_NONE¶
No orientation change
- efl.evas.EVAS_IMAGE_ORIENT_0¶
No orientation change
- efl.evas.EVAS_IMAGE_ORIENT_90¶
Orient 90 degrees clockwise
- efl.evas.EVAS_IMAGE_ORIENT_180¶
Orient 180 degrees clockwise
- efl.evas.EVAS_IMAGE_ORIENT_270¶
Rotate 90 degrees counter-clockwise (i.e. 270 degrees clockwise)
- efl.evas.EVAS_IMAGE_FLIP_HORIZONTAL¶
Flip image horizontally
- efl.evas.EVAS_IMAGE_FLIP_VERTICAL¶
Flip image vertically
- efl.evas.EVAS_IMAGE_FLIP_TRANSPOSE¶
Flip image along the y = (width - x) line (bottom-left to top-right)
- efl.evas.EVAS_IMAGE_FLIP_TRANSVERSE¶
Flip image along the y = x line (top-left to bottom-right)
Evas_Engine_Render_Mode¶
- efl.evas.EVAS_RENDER_MODE_BLOCKING¶
The rendering is blocking mode.
- efl.evas.EVAS_RENDER_MODE_NONBLOCKING¶
The rendering is non blocking mode.
Evas_Image_Content_Hint¶
- efl.evas.EVAS_IMAGE_CONTENT_HINT_NONE¶
No hint at all.
- efl.evas.EVAS_IMAGE_CONTENT_HINT_DYNAMIC¶
The contents will change over time.
- efl.evas.EVAS_IMAGE_CONTENT_HINT_STATIC¶
The contents won’t change over time.
Evas_Device_Class¶
- efl.evas.EVAS_DEVICE_CLASS_NONE¶
Not a device.
- efl.evas.EVAS_DEVICE_CLASS_SEAT¶
The user/seat (the user themselves)
- efl.evas.EVAS_DEVICE_CLASS_KEYBOARD¶
A regular keyboard, numberpad or attached buttons.
- efl.evas.EVAS_DEVICE_CLASS_MOUSE¶
A mouse, trackball or touchpad relative motion device.
- efl.evas.EVAS_DEVICE_CLASS_TOUCH¶
A touchscreen with fingers or stylus.
- efl.evas.EVAS_DEVICE_CLASS_PEN¶
A special pen device.
- efl.evas.EVAS_DEVICE_CLASS_POINTER¶
A laser pointer, wii-style or “minority report” pointing device.
- efl.evas.EVAS_DEVICE_CLASS_GAMEPAD¶
A gamepad controller or joystick.
Evas_Object_Pointer_Mode¶
- efl.evas.EVAS_OBJECT_POINTER_MODE_AUTOGRAB¶
default, X11-like
- efl.evas.EVAS_OBJECT_POINTER_MODE_NOGRAB¶
pointer always bound to the object right below it
- efl.evas.EVAS_OBJECT_POINTER_MODE_NOGRAB_NO_REPEAT_UPDOWN¶
useful on object with “repeat events” enabled, where mouse/touch up and down events WONT be repeated to objects and these objects wont be auto-grabbed.
Evas_Text_Style_Type¶
- efl.evas.EVAS_TEXT_STYLE_PLAIN¶
plain
- efl.evas.EVAS_TEXT_STYLE_SHADOW¶
shadow
- efl.evas.EVAS_TEXT_STYLE_OUTLINE¶
outline
- efl.evas.EVAS_TEXT_STYLE_SOFT_OUTLINE¶
soft outline
- efl.evas.EVAS_TEXT_STYLE_GLOW¶
glow
- efl.evas.EVAS_TEXT_STYLE_OUTLINE_SHADOW¶
outline shadow
- efl.evas.EVAS_TEXT_STYLE_FAR_SHADOW¶
far shadow
- efl.evas.EVAS_TEXT_STYLE_OUTLINE_SOFT_SHADOW¶
outline soft shadow
- efl.evas.EVAS_TEXT_STYLE_SOFT_SHADOW¶
soft shadow
- efl.evas.EVAS_TEXT_STYLE_FAR_SOFT_SHADOW¶
far soft shadow
- efl.evas.EVAS_TEXT_STYLE_SHADOW_DIRECTION_BOTTOM_RIGHT¶
shadow direction bottom right
- efl.evas.EVAS_TEXT_STYLE_SHADOW_DIRECTION_BOTTOM¶
shadow direction bottom
- efl.evas.EVAS_TEXT_STYLE_SHADOW_DIRECTION_BOTTOM_LEFT¶
shadow direction bottom left
- efl.evas.EVAS_TEXT_STYLE_SHADOW_DIRECTION_LEFT¶
shadow direction left
- efl.evas.EVAS_TEXT_STYLE_SHADOW_DIRECTION_TOP_LEFT¶
shadow direction top left
- efl.evas.EVAS_TEXT_STYLE_SHADOW_DIRECTION_TOP¶
shadow direction top
- efl.evas.EVAS_TEXT_STYLE_SHADOW_DIRECTION_TOP_RIGHT¶
shadow direction top right
- efl.evas.EVAS_TEXT_STYLE_SHADOW_DIRECTION_RIGHT¶
shadow direction right
Evas_Textblock_Text_Type¶
- efl.evas.EVAS_TEXTBLOCK_TEXT_RAW¶
Textblock text of type raw.
- efl.evas.EVAS_TEXTBLOCK_TEXT_PLAIN¶
Textblock text of type plain.
- efl.evas.EVAS_TEXTBLOCK_TEXT_MARKUP¶
Textblock text of type markup.
Evas_Textblock_Cursor_Type¶
- efl.evas.EVAS_TEXTBLOCK_CURSOR_UNDER¶
Cursor type is under.
- efl.evas.EVAS_TEXTBLOCK_CURSOR_BEFORE¶
Cursor type is before.
Textgrid Palette¶
The palette to use for the foreground and background colors.
- efl.evas.EVAS_TEXTGRID_PALETTE_NONE¶
No palette is used.
- efl.evas.EVAS_TEXTGRID_PALETTE_STANDARD¶
Standard palette (around 16 colors).
- efl.evas.EVAS_TEXTGRID_PALETTE_EXTENDED¶
Extended palette (at max 256 colors).
- efl.evas.EVAS_TEXTGRID_PALETTE_LAST¶
Ignore it.
Module level functions¶
- class efl.evas.ClippedSmartObject¶
Bases:
efl.evas.SmartObject
- exception efl.evas.EvasLoadError(self, int code, filename, key)¶
Bases:
Exception
- class efl.evas.SmartCbDescription(name, types)¶
Bases:
object
Introspection description for a smart callback
- name¶
- Type
string
- type¶
- Type
string
- efl.evas.color_argb_premul(r, g, b, a)¶
- efl.evas.color_argb_unpremul(r, g, b, a)¶
- efl.evas.color_hsv_to_rgb(h, s, v)¶
- efl.evas.color_parse(desc, is_premul=None)¶
- efl.evas.color_rgb_to_hsv(r, g, b)¶
- efl.evas.extension_can_load(filename)¶
Check if a file extension is supported by
Image
.- Parameters
filename (unicode) – The file to check
- Returns
True
if we may be able to open it,``False`` if it’s unlikely.- Return type
bool
Note
This function is threadsafe.
- efl.evas.font_path_global_append(path)¶
Appends a font path to the list of font paths used by the application
- efl.evas.font_path_global_clear()¶
Removes all font paths loaded
- efl.evas.font_path_global_list()¶
Retrieves the list of font paths used by the application
- efl.evas.font_path_global_prepend(path)¶
Prepends a font path to the list of font paths used by the application
- efl.evas.init()¶
- efl.evas.render_method_list()¶
Returns a list of render method names.
- Return type
list of str
- efl.evas.render_method_lookup(name)¶
Lookup render method and return its id (> 0 if found).
- Parameters
name (string) – Render method
- Returns
ID
- Return type
int
- efl.evas.shutdown()¶