Tizen Native API
Functions
Elementary Engine
Elementary Infrastructure

Functions

const char * elm_config_engine_get (void)
 Gets Elementary's rendering engine in use.
void elm_config_engine_set (const char *engine)
 Sets Elementary's rendering engine for use.
const char * elm_config_preferred_engine_get (void)
 Gets Elementary's preferred engine to use.
void elm_config_preferred_engine_set (const char *engine)
 Sets Elementary's preferred rendering engine for use.
const char * elm_config_accel_preference_get (void)
 Get Elementary's preferred engine to use.
void elm_config_accel_preference_set (const char *pref)
 Set Elementary's acceleration preferences for new windows.
Eina_Bool elm_config_accel_preference_override_get (void)
 Get the acceleration override preference flag.
void elm_config_accel_preference_override_set (Eina_Bool enabled)
 Set the acceleration override preference flag.

These are functions that set and query the rendering engine that Elementary uses for drawing its windows' pixels.

The following are the available engines:

Note:
Please use elm_config_accel_preference_override_set() instead

Function Documentation

const char* elm_config_accel_preference_get ( void  )

Get Elementary's preferred engine to use.

Returns:
The acceleration preference hint string
Note:
there's no need to free the returned string, here.

See elm_config_accel_preference_set() for more information, but this simply returns what was set by this call, nothing more.

Since :
2.3
See also:
elm_config_accel_preference_set()
Since (EFL) :
1.10

Get the acceleration override preference flag.

Since :
2.3

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.

Returns:
If acceleration override is enabled
Since (EFL) :
1.11

Set the acceleration override preference flag.

Since :
2.3

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.

Parameters:
[in]enabledThis should be EINA_TRUE if enabled, or EINA_FALSE if not.
Since (EFL) :
1.11
void elm_config_accel_preference_set ( const char *  pref)

Set Elementary's acceleration preferences for new windows.

Parameters:
[in]prefThe 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. 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)
Note:
This takes precedence over engine preferences set with elm_config_preferred_engine_set().
Since :
2.3
See also:
elm_win_add()
Since (EFL) :
1.10
const char* elm_config_engine_get ( void  )

Gets Elementary's rendering engine in use.

This gets the global rendering engine that is applied to all Elementary applications.

Since :
2.3
Remarks:
There's no need to free the returned string, here.
Returns:
The rendering engine name
See also:
elm_config_engine_set()
void elm_config_engine_set ( const char *  engine)

Sets Elementary's rendering engine for use.

Since :
2.3
Remarks:
Note that it takes effect only on Elementary windows created after this is called.
Parameters:
[in]engineThe rendering engine name
See also:
elm_win_add()
const char* elm_config_preferred_engine_get ( void  )

Gets 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 that is configured for all applications.

Since :
2.3
Remarks:
There's no need to free the returned string, here.
Returns:
The rendering engine name
See also:
elm_config_preferred_engine_set()
void elm_config_preferred_engine_set ( const char *  engine)

Sets Elementary's preferred rendering engine for use.

Since :
2.3
Remarks:
Note that it takes effect only on Elementary windows created after this is called. This overrides the engine set by the configuration at application startup. Note that it is a hint and may not be honored.
Parameters:
[in]engineThe rendering engine name
See also:
elm_win_add()

Except as noted, this content - excluding the Code Examples - is licensed under Creative Commons Attribution 3.0 and all of the Code Examples contained herein are licensed under BSD-3-Clause.
For details, see the Content License