|
Tizen Native API
5.5
|
These are functions setting and querying which rendering engine Elementary will use for drawing its windows' pixels.
The following are the available engines:
| const char* elm_config_accel_preference_get | ( | void | ) |
Get Elementary's preferred engine to use.
See elm_config_accel_preference_set() for more information, but this simply returns what was set by this call, nothing more.
Get the acceleration override preference flag
This gets the acceleration override preference. This is a flag that has the global system acceleration preference configuration forcibly override whatever acceleration preference the application may want.
| void elm_config_accel_preference_override_set | ( | Eina_Bool | enabled | ) |
Set the acceleration override preference flag
This sets the acceleration override preference. This is a flag that has the global system acceleration preference configuration forcibly override whatever acceleration preference the application may want.
| enabled | This should be EINA_TRUE if enabled, or EINA_FALSE if not. |
| void elm_config_accel_preference_set | ( | const char * | pref | ) |
Set Elementary's acceleration preferences for new windows.
| pref | The preference desired as a normal C string |
Note that it will take effect only to Elementary windows created after this is called. The pref string is a freeform C string that indicates what kind of acceleration is preferred. Here "acceleration" majorly means to rendering and which hardware unit application renders GUIs with. This may or may not be honored, but a best attempt will be made. Known strings are as follows:
"gl", "opengl" - try use OpenGL. "3d" - try and use a 3d acceleration unit. "hw", "hardware", "accel" - try any acceleration unit (best possible) "none" - use no acceleration. try use software (since 1.16)
Since 1.14, it is also possible to specify some GL properties for the GL window surface. This allows applications to use GLView with depth, stencil and MSAA buffers with direct rendering. The new accel preference string format is thus "{HW Accel}[:depth{value}[:stencil{value}[:msaa{str}]]]".
Accepted values for depth are for instance "depth", "depth16", "depth24". Accepted values for stencil are "stencil", "stencil1", "stencil8". For MSAA, only predefined strings are accepted: "msaa", "msaa_low", "msaa_mid" and "msaa_high". The selected configuration is not guaranteed and is only valid in case of GL acceleration. Only the base acceleration string will be saved (e.g. "gl" or "hw").
Full examples include:
"gl", - try to use OpenGL "hw:depth:stencil", - use HW acceleration with default depth and stencil buffers "opengl:depth24:stencil8:msaa_mid" - use OpenGL with 24-bit depth, 8-bit stencil and a medium number of MSAA samples in the backbuffer.
This takes precedence over engine preferences set with elm_config_preferred_engine_set().
| Eina_Bool elm_config_access_get | ( | void | ) |
Get access mode
| void elm_config_access_set | ( | Eina_Bool | is_access | ) |
Set access mode
| is_access | If EINA_TRUE, enables access mode |
Get the configure flag that will define if a window aggressively drop its resources when minimized.
| void elm_config_agressive_withdrawn_set | ( | Eina_Bool | enabled | ) |
Set the configure flag that will make a window aggressively drop its resources when minimized.
| enabled | This should be EINA_TRUE if enabled, or EINA_FALSE if not. |
| Eina_Bool elm_config_audio_mute_get | ( | Edje_Channel | channel | ) |
Get the mute state of an audio channel for effects
| channel | The channel to get the mute state of |
| void elm_config_audio_mute_set | ( | Edje_Channel | channel, |
| Eina_Bool | mute | ||
| ) |
Set the mute state of the specified channel
| channel | The channel to set the mute state of |
| mute | The mute state to set |
| Eina_Bool elm_config_clouseau_enabled_get | ( | void | ) |
Get the clouseau state. EINA_TRUE if clouseau was tried to be run.
EINA_TRUE if clouseau was tried to run, EINA_FALSE otherwise | void elm_config_clouseau_enabled_set | ( | Eina_Bool | enabled | ) |
Get the clouseau state. EINA_TRUE if clouseau should be attempted to be run.
| enabled | EINA_TRUE to try and run clouseau, EINA_FALSE otherwise. |
| void elm_config_color_classes_list_free | ( | Eina_List * | list | ) |
Free Elementary's list of supported color classes.
| list | The list of color classes to freed |
| Eina_List* elm_config_color_classes_list_get | ( | void | ) |
Get Elementary's list of supported color classes.
Elm_Color_Class blobs as data.Release the list with elm_color_classes_list_free().
| void elm_config_color_overlay_apply | ( | void | ) |
Apply the changes made with elm_config_color_overlay_set() and elm_config_color_overlay_unset() on the current Elementary window.
This applies all color overlays set to all objects in the UI.
| const Eina_List* elm_config_color_overlay_list_get | ( | void | ) |
Get Elementary's list of color overlays, set with elm_config_color_overlay_set().
Elm_Color_Overlay blobs as data.For each color class, one can set a color overlay for it, overriding the default color properties for that class coming from the theme in use. There is no need to free this list.
| void elm_config_color_overlay_set | ( | const char * | color_class, |
| int | r, | ||
| int | g, | ||
| int | b, | ||
| int | a, | ||
| int | r2, | ||
| int | g2, | ||
| int | b2, | ||
| int | a2, | ||
| int | r3, | ||
| int | g3, | ||
| int | b3, | ||
| int | a3 | ||
| ) |
Set a color overlay for a given Elementary color class.
| color_class | Color class name |
| r | Object Red value |
| g | Object Green value |
| b | Object Blue value |
| a | Object Alpha value |
| r2 | Text outline Red value |
| g2 | Text outline Green value |
| b2 | Text outline Blue value |
| a2 | Text outline Alpha value |
| r3 | Text shadow Red value |
| g3 | Text shadow Green value |
| b3 | Text shadow Blue value |
| a3 | Text shadow Alpha value |
The first color is for the object itself, the second color is for the text outline, and the third color is for the text shadow.
Setting color emits a signal "color_class,set" with source being the given color class in all edje objects.
| void elm_config_color_overlay_unset | ( | const char * | color_class | ) |
Unset a color overlay for a given Elementary color class.
| color_class | Color class name |
This will bring back color elements belonging to color class color_class back to their default color settings.
| Eina_Bool elm_config_desktop_entry_get | ( | void | ) |
Get the desktop style entry enabled state
| void elm_config_desktop_entry_set | ( | Eina_Bool | enable | ) |
Set the desktop style entry enabled state
| enable | The desktop style enabled state for entries |
| double elm_config_drag_anim_duration_get | ( | void | ) |
Get the animation duration for container objects
| void elm_config_drag_anim_duration_set | ( | double | set | ) |
Set the animation duration for container objects
| set | Animation duration |
| EINA_DEPRECATED const char* elm_config_engine_get | ( | void | ) |
Get Elementary's rendering engine in use.
This gets the global rendering engine that is applied to all Elementary applications.
| EINA_DEPRECATED void elm_config_engine_set | ( | const char * | engine | ) |
Set Elementary's rendering engine for use.
| engine | The rendering engine's name |
Note that it will take effect only to Elementary windows created after this is called.
| const char* elm_config_indicator_service_get | ( | int | rotation | ) |
Get the indicator service name according to the rotation degree.
| rotation | The rotation which related with the indicator service name, in degrees (0-360), |
"elm_indicator_portrait" or "elm_indicator_landscape".Get the system auto mirrored mode. This determines whether the mirrored mode is determined automatically by the locale or not.
EINA_TRUE if mirrored is set, EINA_FALSE otherwise| void elm_config_language_auto_mirrored_set | ( | Eina_Bool | auto_mirrored | ) |
Set the system auto mirrored mode. This determines whether the mirrored mode is determined automatically by the locale or not.
| mirrored | EINA_TRUE to set auto mirrored mode, EINA_FALSE to unset it. |
| Eina_Bool elm_config_magnifier_enable_get | ( | void | ) |
Get the magnifier enabled state for entries
| void elm_config_magnifier_enable_set | ( | Eina_Bool | enable | ) |
Set the magnifier enabled state for entires
| enable | The magnifier config state |
| double elm_config_magnifier_scale_get | ( | void | ) |
Get the amount of scaling the magnifer does
| void elm_config_magnifier_scale_set | ( | double | scale | ) |
Set the amount of scaling the magnifier does
| scale | The scaling amount for magnifiers |
| Eina_Bool elm_config_mirrored_get | ( | void | ) |
Get the system mirrored mode. This determines the default mirrored mode of widgets.
EINA_TRUE if mirrored is set, EINA_FALSE otherwise | void elm_config_mirrored_set | ( | Eina_Bool | mirrored | ) |
Set the system mirrored mode. This determines the default mirrored mode of widgets.
| mirrored | EINA_TRUE to set mirrored mode, EINA_FALSE to unset it. |
| Eina_Bool elm_config_offline_get | ( | void | ) |
Get whether the system is offline
| void elm_config_offline_set | ( | Eina_Bool | set | ) |
Set whether the system is offline
| set | True only if the system is offline |
| Eina_Bool elm_config_popup_scrollable_get | ( | void | ) |
Get the popup scrollable flag
If scrollable is true, popup's contents is wrapped in a scroller container in order to popup shouldn't be larger than its parent.
| void elm_config_popup_scrollable_set | ( | Eina_Bool | scrollable | ) |
Set the popup scrollable flag
If scrollable is true, popup's contents is wrapped in a scroller container in order to popup shouldn't be larger than its parent.
| scrollable | enable the popup scroll |
| int elm_config_powersave_get | ( | void | ) |
Get whether the system should be conserving power
| void elm_config_powersave_set | ( | int | set | ) |
Set whether the system should be conserving power
| set | Values greater than 0 if power is being conserved; higher numbers indicate greater conservation |
| const char* elm_config_preferred_engine_get | ( | void | ) |
Get Elementary's preferred engine to use.
This gets the global rendering engine that is applied to all Elementary applications and is PREFERRED by the application. This can (and will) override the engine configured for all applications which. It is rare to explicitly ask for an engine (likely need is the buffer engine and not much more), so use elm_config_accel_preference_get() and elm_config_accel_preference_set() normally.
| void elm_config_preferred_engine_set | ( | const char * | engine | ) |
Set Elementary's preferred rendering engine for use.
| engine | The rendering engine's name |
Note that it will take effect only to Elementary windows created after this is called. This overrides the engine set by configuration at application startup. Note that it is a hint and may not be honored. It is rare to explicitly ask for an engine (likely need is the buffer engine and not much more), so use elm_config_accel_preference_get() and elm_config_accel_preference_set() normally.
Get whether selection should be cleared when entry widget is unfocused.
| void elm_config_selection_unfocused_clear_set | ( | Eina_Bool | enabled | ) |
Set whether selection should be cleared when entry widget is unfocused.
| enabled | If EINA_TRUE, clear selection when unfocus, otherwise does not clear selection when unfocus. |
| double elm_config_transition_duration_factor_get | ( | void | ) |
Get the duration factor of transitions
| void elm_config_transition_duration_factor_set | ( | double | factor | ) |
Set the transition duration factor
This function sets the edje transition duration factor It will affect the duration of edje transitions
| factor | The duration factor for transition in edje |
| Eina_Bool elm_config_vsync_get | ( | void | ) |
Get the configured vsync flag
This gets the globally configured vsync flag that asks some backend engines to use vsync display if possible.
| void elm_config_vsync_set | ( | Eina_Bool | enabled | ) |
Set the configured vsync flag
This sets the globally configured vsync flag that asks some backend engines to use vsync display if possible.
| enabled | This should be EINA_TRUE if enabled, or EINA_FALSE if not. |
| const char* elm_config_web_backend_get | ( | void | ) |
Get the currently set backend engine used by Elm_Web widget
This function get the name of the external module used by elm_web to render web page.
| void elm_config_web_backend_set | ( | const char * | backend | ) |
Set the backend engine used by Elm_Web widget
This function set the name of the external module used by elm_web to render web page.
| backend | The new backend to use. |
Get the auto focus animate flag
If auto focus - see elm_config_window_auto_focus_enable_set() , is enabled then this will determine if the focus display will be animated or not.
| void elm_config_window_auto_focus_animate_set | ( | Eina_Bool | enable | ) |
Set the auto focus animation flag
If auto focus - see elm_config_window_auto_focus_enable_set() , is enabled then this will determine if the focus display will be animated or not.
| enable | the auto focus animation state |
Get the auto focus enable flag
This determines if elementary will show a focus box indicating the focused widget automatically if keyboard controls like "Tab" are used to switch focus between widgets. Mouse or touch control will hide this auto shown focus, unless focus display has been explicitly forced on for the window.
| void elm_config_window_auto_focus_enable_set | ( | Eina_Bool | enable | ) |
Set the auto focus enabled state
This determines if elementary will show a focus box indicating the focused widget automatically if keyboard controls like "Tab" are used to switch focus between widgets. Mouse or touch control will hide this auto shown focus, unless focus display has been explicitly forced on for the window.
| enable | the auto focus display enabled state |