Tizen Native API
6.5
|
- Deprecated:
- Deprecated since tizen 6.0. This group of functions is applied to an Ecore_Buffer_Provider object. Ecore_Buffer_Provider provides Ecore_Buffer to Ecore_Buffer_Consumer(usually different process or thread from Ecore_Buffer_Provider). Ecore_Buffer_Provider should creates Ecore_Buffer as a provider.
Functions | |
Ecore_Buffer_Provider * | ecore_buffer_provider_new (const char *name) EINA_DEPRECATED |
Creates a new Buffer Provider based on name. | |
void | ecore_buffer_provider_free (Ecore_Buffer_Provider *provider) EINA_DEPRECATED |
Frees an Ecore_Buffer_Provider. | |
Ecore_Buffer_Return | ecore_buffer_provider_buffer_acquire (Ecore_Buffer_Provider *provider, Ecore_Buffer **ret_buf) EINA_DEPRECATED |
Returns the Ecore_Buffer released by consumer or State of Queue. | |
Eina_Bool | ecore_buffer_provider_buffer_enqueue (Ecore_Buffer_Provider *provider, Ecore_Buffer *buffer) EINA_DEPRECATED |
Submits the Ecore_Buffer to Consumer to request compositing. | |
Ecore_Buffer_Return | ecore_buffer_provider_buffer_acquirable_check (Ecore_Buffer_Provider *provider) EINA_DEPRECATED |
Checks if state of queue. | |
void | ecore_buffer_provider_consumer_add_cb_set (Ecore_Buffer_Provider *provider, Ecore_Buffer_Provider_Consumer_Add_Cb func, void *data) EINA_DEPRECATED |
Sets a callback for consumer connection events. | |
void | ecore_buffer_provider_consumer_del_cb_set (Ecore_Buffer_Provider *provider, Ecore_Buffer_Provider_Consumer_Del_Cb func, void *data) EINA_DEPRECATED |
Sets a callback for consumer disconnection events. | |
void | ecore_buffer_provider_buffer_released_cb_set (Ecore_Buffer_Provider *provider, Ecore_Buffer_Provider_Enqueue_Cb func, void *data) EINA_DEPRECATED |
Sets a callback for released buffer events. | |
Typedefs | |
typedef struct _Ecore_Buffer_Provider | Ecore_Buffer_Provider |
typedef void(* | Ecore_Buffer_Provider_Consumer_Add_Cb )(Ecore_Buffer_Provider *provider, int queue_size, int w, int h, void *data) |
Called whenever a Ecore_Buffer_Consumer connected. | |
typedef void(* | Ecore_Buffer_Provider_Consumer_Del_Cb )(Ecore_Buffer_Provider *provider, void *data) |
Called whenever a Ecore_Buffer_Consumer disconnected. | |
typedef void(* | Ecore_Buffer_Provider_Enqueue_Cb )(Ecore_Buffer_Provider *provider, void *data) |
Called whenever a Ecore_Buffer is released. |
Typedef Documentation
- Deprecated:
Deprecated since tizen 6.0.
An object representing a provider of Ecore_Buffer.
- Since (EFL) :
- 1.15
Called whenever a Ecore_Buffer_Consumer connected.
- Deprecated:
- Deprecated since tizen 6.0.
- Since (EFL) :
- 1.15
Called whenever a Ecore_Buffer_Consumer disconnected.
- Deprecated:
- Deprecated since tizen 6.0.
- Since (EFL) :
- 1.15
Called whenever a Ecore_Buffer is released.
- Deprecated:
- Deprecated since tizen 6.0.
- Since (EFL) :
- 1.15
Enumeration Type Documentation
enum _Ecore_Buffer_Return |
Types for an buffer queue state on provider side.
Function Documentation
Ecore_Buffer_Return ecore_buffer_provider_buffer_acquirable_check | ( | Ecore_Buffer_Provider * | provider | ) |
Checks if state of queue.
- Deprecated:
- Deprecated since tizen 6.0.
- Since (EFL) :
- 1.15
- Parameters:
-
[in] provider The Ecore_Buffer_Provider to query
- ECORE_BUFFER_RETURN_NOT_EMPTY, means there is a dequeueable Ecore_Buffer at least one.
- ECORE_BUFFER_RETURN_EMPTY, means queue is empty, not available slot in Queue. in other words, there is no free drawable buffer in Queue.
- ECORE_BUFFER_RETURN_NEED_ALLOC, means that there is available slot, but not allocated. so, You may create new Ecore_Buffer, and then just enqueue the Ecore_Buffer.
- Returns:
EINA_TRUE
means queue is empty,EINA_FALSE
otherwise.
- Since :
- 2.4
Ecore_Buffer_Return ecore_buffer_provider_buffer_acquire | ( | Ecore_Buffer_Provider * | provider, |
Ecore_Buffer ** | ret_buf | ||
) |
Returns the Ecore_Buffer released by consumer or State of Queue.
- Deprecated:
- Deprecated since tizen 6.0.
- Since (EFL) :
- 1.15
- Parameters:
-
[in] provider The Ecore_Buffer_Provider to request for buffer [out] ret_buf A Pointer to the Ecore_Buffer
- Returns:
- The enumeration of Ecore_Buffer_Return to indicate result of Dequeuing.
This function gives you drawable buffer and inform you the state of Queue. Each return value of enumeration has meaning as below.
- ECORE_BUFFER_RETURN_ERROR, means error occurred.
- ECORE_BUFFER_RETURN_SUCCESS, means success to dequeue, therefore ret_buf is valid.
- ECORE_BUFFER_RETURN_EMPTY, means queue is empty, not available slot in Queue. in other words, there is no free drawable buffer in Queue.
- ECORE_BUFFER_RETURN_NEED_ALLOC, means that there is available slot, but not allocated. so, You may create new Ecore_Buffer, and then just enqueue the Ecore_Buffer.
- Since :
- 2.4
Eina_Bool ecore_buffer_provider_buffer_enqueue | ( | Ecore_Buffer_Provider * | provider, |
Ecore_Buffer * | buffer | ||
) |
Submits the Ecore_Buffer to Consumer to request compositing.
- Deprecated:
- Deprecated since tizen 6.0.
- Since (EFL) :
- 1.15
- Parameters:
-
[in] provider The Ecore_Buffer_Provider connected with consumer. [in] buffer The Ecore_Buffer to submit
- Returns:
EINA_TRUE
on success,EINA_FALSE
otherwise.
This function allow you to submit the Ecore_Buffer to consumer to request compositing. And this will be success, in case only you submit dequeued Ecore_Buffer, and new Ecore_Buffer after received return value of ECORE_BUFFER_RETURN_NEED_ALLOC by ecore_buffer_provider_buffer_acquire().
- See also:
- ecore_buffer_new(), ecore_buffer_provider_buffer_dequeue()
- Since :
- 2.4
void ecore_buffer_provider_buffer_released_cb_set | ( | Ecore_Buffer_Provider * | provider, |
Ecore_Buffer_Provider_Enqueue_Cb | func, | ||
void * | data | ||
) |
Sets a callback for released buffer events.
- Deprecated:
- Deprecated since tizen 6.0.
- Since (EFL) :
- 1.15
- Parameters:
-
[in] provider The Ecore_Buffer_Provider to set callbacks on [in] func The function to call [in] data A pointer to the user data to store.
A call to this function will set a callback on an Ecore_Buffer_Provider, causing func
to be called whenever provider
has received Ecore_Buffer released from provider.
You may success dequeue the Ecore_Buffer after this callback called.
- Since :
- 2.4
void ecore_buffer_provider_consumer_add_cb_set | ( | Ecore_Buffer_Provider * | provider, |
Ecore_Buffer_Provider_Consumer_Add_Cb | func, | ||
void * | data | ||
) |
Sets a callback for consumer connection events.
- Deprecated:
- Deprecated since tizen 6.0.
- Since (EFL) :
- 1.15
- Parameters:
-
[in] provider The Ecore_Buffer_Provider to set callbacks on [in] func The function to call [in] data A pointer to the user data to store.
A call to this function will set a callback on an Ecore_Buffer_Provider, causing func
to be called whenever provider
is connected with consumer.
- Since :
- 2.4
void ecore_buffer_provider_consumer_del_cb_set | ( | Ecore_Buffer_Provider * | provider, |
Ecore_Buffer_Provider_Consumer_Del_Cb | func, | ||
void * | data | ||
) |
Sets a callback for consumer disconnection events.
- Deprecated:
- Deprecated since tizen 6.0.
- Since (EFL) :
- 1.15
- Parameters:
-
[in] provider The Ecore_Buffer_Provider to set callbacks on [in] func The function to call [in] data A pointer to the user data to store.
A call to this function will set a callback on an Ecore_Buffer_Provider, causing func
to be called whenever provider
is disconnected with consumer.
- Since :
- 2.4
void ecore_buffer_provider_free | ( | Ecore_Buffer_Provider * | provider | ) |
Frees an Ecore_Buffer_Provider.
- Deprecated:
- Deprecated since tizen 6.0.
- Since (EFL) :
- 1.15
- Parameters:
-
[in] provider The Ecore_Buffer_Provider to free
This frees up any memory used by the Ecore_Buffer_Provider.
- Since :
- 2.4
Ecore_Buffer_Provider* ecore_buffer_provider_new | ( | const char * | name | ) |
Creates a new Buffer Provider based on name.
- Deprecated:
- Deprecated since tizen 6.0.
- Since (EFL) :
- 1.15
- Parameters:
-
[in] name The name of Buffer_Queue.
- Returns:
- Ecore_Buffer_Provider instance or
NULL
if creation failed.
- Since :
- 2.4