From 07ade38c00e7eeed6b7d5fd262df9dcbb16ac088 Mon Sep 17 00:00:00 2001 From: Junkyeong Kim Date: Tue, 24 Mar 2020 17:03:29 +0900 Subject: [PATCH] ecore_buffer: deprecate unused API and structure Change-Id: I6425deb0097efb96f2c6f4e9018ff55db3f67fe7 Signed-off-by: Junkyeong Kim --- src/lib/ecore_buffer/Ecore_Buffer.h | 119 ++++++++++++++++++++++++++---- src/lib/ecore_buffer/Ecore_Buffer_Queue.h | 69 +++++++++++------ 2 files changed, 151 insertions(+), 37 deletions(-) diff --git a/src/lib/ecore_buffer/Ecore_Buffer.h b/src/lib/ecore_buffer/Ecore_Buffer.h index 0393e92..efebb88 100644 --- a/src/lib/ecore_buffer/Ecore_Buffer.h +++ b/src/lib/ecore_buffer/Ecore_Buffer.h @@ -30,7 +30,7 @@ /** * @defgroup Ecore_Buffer_Group Ecore_Buffer - Graphics buffer functions * @ingroup Ecore - * + * @deprecated Deprecated since tizen 6.0. * The Ecore Buffer is an abstraction of graphic buffer. * * This library also provides simple mechanisms for sharing graphic buffer bet- @@ -48,226 +48,270 @@ extern "C" { /* color index */ /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format C8 ([7:0] C). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_C8 __ecore_buffer_fourcc_code('C', '8', ' ', ' ') /* 8 bpp RGB */ /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format RGB332 ([7:0] R:G:B 3:3:2). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_RGB332 __ecore_buffer_fourcc_code('R', 'G', 'B', '8') /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format RGB233 ([7:0] B:G:R 2:3:3). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_BGR233 __ecore_buffer_fourcc_code('B', 'G', 'R', '8') /* 16 bpp RGB */ /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format XRGB4444 ([15:0] x:R:G:B 4:4:4:4 little endian). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_XRGB4444 __ecore_buffer_fourcc_code('X', 'R', '1', '2') /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format XBRG4444 ([15:0] x:B:G:R 4:4:4:4 little endian). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_XBGR4444 __ecore_buffer_fourcc_code('X', 'B', '1', '2') /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format RGBX4444 ([15:0] R:G:B:x 4:4:4:4 little endian). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_RGBX4444 __ecore_buffer_fourcc_code('R', 'X', '1', '2') /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format BGRX4444 ([15:0] B:G:R:x 4:4:4:4 little endian). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_BGRX4444 __ecore_buffer_fourcc_code('B', 'X', '1', '2') /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format ARGB4444 ([15:0] A:R:G:B 4:4:4:4 little endian). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_ARGB4444 __ecore_buffer_fourcc_code('A', 'R', '1', '2') /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format ABGR4444 ([15:0] A:B:G:R 4:4:4:4 little endian). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_ABGR4444 __ecore_buffer_fourcc_code('A', 'B', '1', '2') /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format RGBA4444 ([15:0] R:G:B:A 4:4:4:4 little endian). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_RGBA4444 __ecore_buffer_fourcc_code('R', 'A', '1', '2') /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format BGRA4444 ([15:0] B:G:R:A 4:4:4:4 little endian). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_BGRA4444 __ecore_buffer_fourcc_code('B', 'A', '1', '2') /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format XRGB1555 ([15:0] x:R:G:B 1:5:5:5 little endian). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_XRGB1555 __ecore_buffer_fourcc_code('X', 'R', '1', '5') /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format XBGR1555 ([15:0] x:B:G:R 1:5:5:5 little endian). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_XBGR1555 __ecore_buffer_fourcc_code('X', 'B', '1', '5') /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format RGBX5551 ([15:0] R:G:B:x 5:5:5:1 little endian). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_RGBX5551 __ecore_buffer_fourcc_code('R', 'X', '1', '5') /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format BGRX5551 ([15:0] B:G:R:x 5:5:5:1 little endian). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_BGRX5551 __ecore_buffer_fourcc_code('B', 'X', '1', '5') /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format ARGB1555 ([15:0] A:R:G:B 1:5:5:5 little endian). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_ARGB1555 __ecore_buffer_fourcc_code('A', 'R', '1', '5') /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format ABGR1555 ([15:0] A:B:G:R 1:5:5:5 little endian). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_ABGR1555 __ecore_buffer_fourcc_code('A', 'B', '1', '5') /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format RGBA5551 ([15:0] R:G:B:A 5:5:5:1 little endian). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_RGBA5551 __ecore_buffer_fourcc_code('R', 'A', '1', '5') /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format BGRA5551 ([15:0] B:G:R:A 5:5:5:1 little endian). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_BGRA5551 __ecore_buffer_fourcc_code('B', 'A', '1', '5') /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format RGB565 ([15:0] R:G:B 5:6:5 little endian). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_RGB565 __ecore_buffer_fourcc_code('R', 'G', '1', '6') /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format BGR565 ([15:0] B:G:R 5:6:5 little endian). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_BGR565 __ecore_buffer_fourcc_code('B', 'G', '1', '6') /* 24 bpp RGB */ /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format RGB888 ([23:0] R:G:B little endian). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_RGB888 __ecore_buffer_fourcc_code('R', 'G', '2', '4') /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format BGR888 ([23:0] B:G:R little endian). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_BGR888 __ecore_buffer_fourcc_code('B', 'G', '2', '4') /* 32 bpp RGB */ /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format XRGB8888 ([31:0] x:R:G:B 8:8:8:8 little endian). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_XRGB8888 __ecore_buffer_fourcc_code('X', 'R', '2', '4') /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format XBGR8888 ([31:0] x:B:G:R 8:8:8:8 little endian). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_XBGR8888 __ecore_buffer_fourcc_code('X', 'B', '2', '4') /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format RGBX8888 ([31:0] R:G:B:x 8:8:8:8 little endian). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_RGBX8888 __ecore_buffer_fourcc_code('R', 'X', '2', '4') /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format BGRX8888 ([31:0] B:G:R:x 8:8:8:8 little endian). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_BGRX8888 __ecore_buffer_fourcc_code('B', 'X', '2', '4') /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format ARGB8888 ([31:0] A:R:G:B 8:8:8:8 little endian). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_ARGB8888 __ecore_buffer_fourcc_code('A', 'R', '2', '4') /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format ABGR8888 ([31:0] [31:0] A:B:G:R 8:8:8:8 little endian). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_ABGR8888 __ecore_buffer_fourcc_code('A', 'B', '2', '4') /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format RGBA8888 ([31:0] R:G:B:A 8:8:8:8 little endian). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_RGBA8888 __ecore_buffer_fourcc_code('R', 'A', '2', '4') /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format BGRA8888 ([31:0] B:G:R:A 8:8:8:8 little endian). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_BGRA8888 __ecore_buffer_fourcc_code('B', 'A', '2', '4') /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format XRGB2101010 ([31:0] x:R:G:B 2:10:10:10 little endian). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_XRGB2101010 __ecore_buffer_fourcc_code('X', 'R', '3', '0') /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format XBGR2101010 ([31:0] x:B:G:R 2:10:10:10 little endian). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_XBGR2101010 __ecore_buffer_fourcc_code('X', 'B', '3', '0') /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format RGBX1010102 ([31:0] R:G:B:x 10:10:10:2 little endian). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_RGBX1010102 __ecore_buffer_fourcc_code('R', 'X', '3', '0') /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format BGRX1010102 ([31:0] B:G:R:x 10:10:10:2 little endian). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_BGRX1010102 __ecore_buffer_fourcc_code('B', 'X', '3', '0') /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format ARGB2101010 ([31:0] A:R:G:B 2:10:10:10 little endian). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_ARGB2101010 __ecore_buffer_fourcc_code('A', 'R', '3', '0') /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format ABGR2101010 ([31:0] A:B:G:R 2:10:10:10 little endian). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_ABGR2101010 __ecore_buffer_fourcc_code('A', 'B', '3', '0') /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format RGBA1010102 ([31:0] R:G:B:A 10:10:10:2 little endian). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_RGBA1010102 __ecore_buffer_fourcc_code('R', 'A', '3', '0') /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format BGRA1010102 ([31:0] B:G:R:A 10:10:10:2 little endian). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_BGRA1010102 __ecore_buffer_fourcc_code('B', 'A', '3', '0') /* packed YCbCr */ /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format YUYV ([31:0] Cr0:Y1:Cb0:Y0 8:8:8:8 little endian). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_YUYV __ecore_buffer_fourcc_code('Y', 'U', 'Y', 'V') /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format YVYU ([31:0] Cb0:Y1:Cr0:Y0 8:8:8:8 little endian). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_YVYU __ecore_buffer_fourcc_code('Y', 'V', 'Y', 'U') /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format UYVY ([31:0] Y1:Cr0:Y0:Cb0 8:8:8:8 little endian). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_UYVY __ecore_buffer_fourcc_code('U', 'Y', 'V', 'Y') /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format VYUY ([31:0] Y1:Cb0:Y0:Cr0 8:8:8:8 little endian). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_VYUY __ecore_buffer_fourcc_code('V', 'Y', 'U', 'Y') /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format AYUV ([31:0] A:Y:Cb:Cr 8:8:8:8 little endian). * @since 1.15 */ @@ -280,21 +324,25 @@ extern "C" { * index 1 = Cb:Cr plane, [15:0] Cb:Cr little endian */ /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format NV12 (2x2 subsampled Cr:Cb plane). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_NV12 __ecore_buffer_fourcc_code('N', 'V', '1', '2') /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format NV21 (2x2 subsampled Cb:Cr plane). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_NV21 __ecore_buffer_fourcc_code('N', 'V', '2', '1') /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format NV16 (2x1 subsampled Cr:Cb plane). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_NV16 __ecore_buffer_fourcc_code('N', 'V', '1', '6') /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format NV61 (2x1 subsampled Cb:Cr plane). * @since 1.15 */ @@ -309,50 +357,60 @@ extern "C" { * index 2: Cb plane, [7:0] Cb */ /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format YUV410 (4x4 subsampled Cb (1) and Cr (2) planes). */ #define ECORE_BUFFER_FORMAT_YUV410 __ecore_buffer_fourcc_code('Y', 'U', 'V', '9') /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format YVU410 (4x4 subsampled Cr (1) and Cb (2) planes). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_YVU410 __ecore_buffer_fourcc_code('Y', 'V', 'U', '9') /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format YUV411 (4x1 subsampled Cb (1) and Cr (2) planes). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_YUV411 __ecore_buffer_fourcc_code('Y', 'U', '1', '1') /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format YVU411 (4x1 subsampled Cr (1) and Cb (2) planes). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_YVU411 __ecore_buffer_fourcc_code('Y', 'V', '1', '1') /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format YUV420 (2x2 subsampled Cb (1) and Cr (2) planes). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_YUV420 __ecore_buffer_fourcc_code('Y', 'U', '1', '2') /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format YVU420 (2x2 subsampled Cr (1) and Cb (2) planes). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_YVU420 __ecore_buffer_fourcc_code('Y', 'V', '1', '2') /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format YUV422 (2x1 subsampled Cb (1) and Cr (2) planes). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_YUV422 __ecore_buffer_fourcc_code('Y', 'U', '1', '6') /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format YVU422 (2x1 subsampled Cr (1) and Cb (2) planes). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_YVU422 __ecore_buffer_fourcc_code('Y', 'V', '1', '6') /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format YUV444 (non-subsampled Cb (1) and Cr (2) planes). * @since 1.15 */ #define ECORE_BUFFER_FORMAT_YUV444 __ecore_buffer_fourcc_code('Y', 'U', '2', '4') /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer format YVU444 (non-subsampled Cr (1) and Cb (2) planes). * @since 1.15 */ @@ -361,7 +419,7 @@ extern "C" { /** * @defgroup Ecore_Buffer_Lib_Group Ecore Buffer Library Functions * @ingroup Ecore_Buffer_Group - * + * @deprecated Deprecated since tizen 6.0. * Utility functions that set up and shut down the Ecore Buffer library. * This group of functions is applied to an Ecore_Buffer object. * @@ -369,48 +427,56 @@ extern "C" { */ /** + * @deprecated Deprecated since tizen 6.0. * @typedef Ecore_Buffer * An object representing a graphic buffer. * @since 1.15 */ typedef struct _Ecore_Buffer Ecore_Buffer; /** + * @deprecated Deprecated since tizen 6.0. * @typedef Ecore_Buffer_Backend * The interfaces for backend of buffer. * @since 1.15 */ typedef struct _Ecore_Buffer_Backend Ecore_Buffer_Backend; /** + * @deprecated Deprecated since tizen 6.0. * @typedef Ecore_Export_Type * Types for export buffer. * @since 1.15 */ typedef enum _Ecore_Export_Type Ecore_Export_Type; /** + * @deprecated Deprecated since tizen 6.0. * @typedef Ecore_Buffer_Format * The format of Ecore_Buffer. * @since 1.15 */ typedef unsigned int Ecore_Buffer_Format; /** + * @deprecated Deprecated since tizen 6.0. * @typedef Ecore_Pixmap * An Id of Pixmap. * @since 1.15 */ typedef unsigned long Ecore_Pixmap; /** + * @deprecated Deprecated since tizen 6.0. * @typedef Ecore_Buffer_Module_Data * The data of module. * @since 1.15 */ typedef void* Ecore_Buffer_Module_Data; /** + * @deprecated Deprecated since tizen 6.0. * @typedef Ecore_Buffer_Data * The data of Ecore_Buffer. * @since 1.15 */ typedef void* Ecore_Buffer_Data; /** + * @deprecated Deprecated since tizen 6.0. * @typedef Ecore_Buffer_Cb * Called whenever Ecore_Buffer is freed. * @since 1.15 @@ -418,6 +484,7 @@ typedef void* Ecore_Buffer_Data; typedef void (*Ecore_Buffer_Cb)(Ecore_Buffer* buf, void* data); /** + * @deprecated Deprecated since tizen 6.0. * @enum _Ecore_Export_Type * Types for export buffer. * @since 1.15 @@ -430,6 +497,7 @@ enum _Ecore_Export_Type }; /** + * @deprecated Deprecated since tizen 6.0. * @typedef Ecore_Buffer_Plane * Types for plane information. * @since 1.15 @@ -437,6 +505,7 @@ enum _Ecore_Export_Type typedef struct _Ecore_Buffer_Plane Ecore_Buffer_Plane; /** + * @deprecated Deprecated since tizen 6.0. * @typedef Ecore_Buffer_Info * Types for buffer information. * @since 1.15 @@ -444,12 +513,14 @@ typedef struct _Ecore_Buffer_Plane Ecore_Buffer_Plane; typedef struct _Ecore_Buffer_Info Ecore_Buffer_Info; /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the maximum number of Ecore_Buffer's plane. * @since 1.15 */ #define ECORE_BUFFER_PLANE_MAX 4 /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer plane struct. * @since 1.15 */ @@ -461,6 +532,7 @@ struct _Ecore_Buffer_Plane }; /** + * @deprecated Deprecated since tizen 6.0. * @brief Definition for the Ecore_Buffer information struct. * @since 1.15 */ @@ -478,6 +550,7 @@ struct _Ecore_Buffer_Info }; /** + * @deprecated Deprecated since tizen 6.0. * @struct _Ecore_Buffer_Backend * @brief Structure used when initializing Ecore Buffer Backend. This structure * is mainly used by modules implementing the Ecore Buffer Backend interface. @@ -523,6 +596,7 @@ struct _Ecore_Buffer_Backend }; /** + * @deprecated Deprecated since tizen 6.0. * @brief Initializes the Ecore_Buffer system. * * @since 1.15 @@ -535,8 +609,9 @@ struct _Ecore_Buffer_Backend * @elseif WEARABLE @since_tizen 3.0 * @endif */ -EAPI Eina_Bool ecore_buffer_init(void); +EAPI Eina_Bool ecore_buffer_init(void) EINA_DEPRECATED; /** + * @deprecated Deprecated since tizen 6.0. * @brief Shuts down the Ecore_Buffer system. * * @since 1.15 @@ -549,8 +624,9 @@ EAPI Eina_Bool ecore_buffer_init(void); * @elseif WEARABLE @since_tizen 3.0 * @endif */ -EAPI Eina_Bool ecore_buffer_shutdown(void); +EAPI Eina_Bool ecore_buffer_shutdown(void) EINA_DEPRECATED; /** + * @deprecated Deprecated since tizen 6.0. * @brief Registers the given buffer backend. * * @since 1.15 @@ -563,8 +639,9 @@ EAPI Eina_Bool ecore_buffer_shutdown(void); * @elseif WEARABLE @since_tizen 3.0 * @endif */ -EAPI Eina_Bool ecore_buffer_register(Ecore_Buffer_Backend *be); +EAPI Eina_Bool ecore_buffer_register(Ecore_Buffer_Backend *be) EINA_DEPRECATED; /** + * @deprecated Deprecated since tizen 6.0. * @brief Unregisters the given buffer backend. * * @since 1.15 @@ -575,8 +652,9 @@ EAPI Eina_Bool ecore_buffer_register(Ecore_Buffer_Backend *be); * @elseif WEARABLE @since_tizen 3.0 * @endif */ -EAPI void ecore_buffer_unregister(Ecore_Buffer_Backend *be); +EAPI void ecore_buffer_unregister(Ecore_Buffer_Backend *be) EINA_DEPRECATED; /** + * @deprecated Deprecated since tizen 6.0. * @brief Creates a new Ecore_Buffer given type. * * @since 1.15 @@ -593,8 +671,9 @@ EAPI void ecore_buffer_unregister(Ecore_Buffer_Backend *be); * @elseif WEARABLE @since_tizen 3.0 * @endif */ -EAPI Ecore_Buffer *ecore_buffer_new(const char *engine, unsigned int width, unsigned int height, Ecore_Buffer_Format format, unsigned int flags); +EAPI Ecore_Buffer *ecore_buffer_new(const char *engine, unsigned int width, unsigned int height, Ecore_Buffer_Format format, unsigned int flags) EINA_DEPRECATED; /** + * @deprecated Deprecated since tizen 6.0. * @brief Creates a new Ecore_Buffer based on given tbm surface. * * @since 1.15 @@ -609,8 +688,9 @@ EAPI Ecore_Buffer *ecore_buffer_new(const char *engine, unsigned int width, unsi * @elseif WEARABLE @since_tizen 3.0 * @endif */ -EAPI Ecore_Buffer *ecore_buffer_new_with_tbm_surface(const char *engine, void *tbm_surface, unsigned int flags); +EAPI Ecore_Buffer *ecore_buffer_new_with_tbm_surface(const char *engine, void *tbm_surface, unsigned int flags) EINA_DEPRECATED; /** + * @deprecated Deprecated since tizen 6.0. * @brief Frees the given Ecore_Buffer. * * @since 1.15 @@ -621,8 +701,9 @@ EAPI Ecore_Buffer *ecore_buffer_new_with_tbm_surface(const char *engine, void *t * @elseif WEARABLE @since_tizen 3.0 * @endif */ -EAPI void ecore_buffer_free(Ecore_Buffer *buf); +EAPI void ecore_buffer_free(Ecore_Buffer *buf) EINA_DEPRECATED; /** + * @deprecated Deprecated since tizen 6.0. * @brief Sets a callback for Ecore_Buffer free events. * * @since 1.15 @@ -640,8 +721,9 @@ EAPI void ecore_buffer_free(Ecore_Buffer *buf); * @elseif WEARABLE @since_tizen 3.0 * @endif */ -EAPI void ecore_buffer_free_callback_add(Ecore_Buffer *buf, Ecore_Buffer_Cb func, void *data); +EAPI void ecore_buffer_free_callback_add(Ecore_Buffer *buf, Ecore_Buffer_Cb func, void *data) EINA_DEPRECATED; /** + * @deprecated Deprecated since tizen 6.0. * @brief Removes a callback for Ecore_Buffer free events. * * @since 1.15 @@ -656,8 +738,9 @@ EAPI void ecore_buffer_free_callback_add(Ecore_Buffer *buf, Ecore_Buffe * @elseif WEARABLE @since_tizen 3.0 * @endif */ -EAPI void ecore_buffer_free_callback_remove(Ecore_Buffer *buf, Ecore_Buffer_Cb func, void *data); +EAPI void ecore_buffer_free_callback_remove(Ecore_Buffer *buf, Ecore_Buffer_Cb func, void *data) EINA_DEPRECATED; /** + * @deprecated Deprecated since tizen 6.0. * @brief Returns the Pixmap of given Ecore_Buffer. * * @since 1.15 @@ -670,8 +753,9 @@ EAPI void ecore_buffer_free_callback_remove(Ecore_Buffer *buf, Ecore_Bu * @elseif WEARABLE @since_tizen 3.0 * @endif */ -EAPI Ecore_Pixmap ecore_buffer_pixmap_get(Ecore_Buffer *buf); +EAPI Ecore_Pixmap ecore_buffer_pixmap_get(Ecore_Buffer *buf) EINA_DEPRECATED; /** + * @deprecated Deprecated since tizen 6.0. * @brief Returns the tbm surface handle of given Ecore_Buffer. * * @since 1.15 @@ -687,8 +771,9 @@ EAPI Ecore_Pixmap ecore_buffer_pixmap_get(Ecore_Buffer *buf); * @elseif WEARABLE @since_tizen 3.0 * @endif */ -EAPI void *ecore_buffer_tbm_surface_get(Ecore_Buffer *buf); +EAPI void *ecore_buffer_tbm_surface_get(Ecore_Buffer *buf) EINA_DEPRECATED; /** + * @deprecated Deprecated since tizen 6.0. * @brief Returns size of given Ecore_Buffer. * * @since 1.15 @@ -703,8 +788,9 @@ EAPI void *ecore_buffer_tbm_surface_get(Ecore_Buffer *buf); * @elseif WEARABLE @since_tizen 3.0 * @endif */ -EAPI Eina_Bool ecore_buffer_size_get(Ecore_Buffer *buf, unsigned int *width, unsigned int *height); +EAPI Eina_Bool ecore_buffer_size_get(Ecore_Buffer *buf, unsigned int *width, unsigned int *height) EINA_DEPRECATED; /** + * @deprecated Deprecated since tizen 6.0. * @brief Returns format of given Ecore_Buffer. * * @since 1.15 @@ -719,8 +805,9 @@ EAPI Eina_Bool ecore_buffer_size_get(Ecore_Buffer *buf, unsigned int *width, * @elseif WEARABLE @since_tizen 3.0 * @endif */ -EAPI Ecore_Buffer_Format ecore_buffer_format_get(Ecore_Buffer *buf); +EAPI Ecore_Buffer_Format ecore_buffer_format_get(Ecore_Buffer *buf) EINA_DEPRECATED; /** + * @deprecated Deprecated since tizen 6.0. * @brief Returns the flags of given Ecore_Buffer. * * @since 1.15 @@ -735,7 +822,7 @@ EAPI Ecore_Buffer_Format ecore_buffer_format_get(Ecore_Buffer *buf); * @elseif WEARABLE @since_tizen 3.0 * @endif */ -EAPI unsigned int ecore_buffer_flags_get(Ecore_Buffer *buf); +EAPI unsigned int ecore_buffer_flags_get(Ecore_Buffer *buf) EINA_DEPRECATED; /** * @} diff --git a/src/lib/ecore_buffer/Ecore_Buffer_Queue.h b/src/lib/ecore_buffer/Ecore_Buffer_Queue.h index 5dcae75..e9b0358 100644 --- a/src/lib/ecore_buffer/Ecore_Buffer_Queue.h +++ b/src/lib/ecore_buffer/Ecore_Buffer_Queue.h @@ -38,7 +38,7 @@ extern "C" { /** * @defgroup Ecore_Buffer_Queue_Group Ecore Buffer Queue functions * @ingroup Ecore_Buffer_Group - * + * @deprecated Deprecated since tizen 6.0. * Ecore Buffer Queue is a queue which connects processes for sharing * Ecore_Buffer. * One process (related object is Ecore_Buffer_Provider) has rear terminal @@ -50,7 +50,7 @@ extern "C" { /** * @defgroup Ecore_Buffer_Provider_Group Ecore Buffer Provider functions * @ingroup Ecore_Buffer_Queue_Group - * + * @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). @@ -60,7 +60,7 @@ extern "C" { /** * @defgroup Ecore_Buffer_Consumer_Group Ecore Buffer Consumer functions * @ingroup Ecore_Buffer_Queue_Group - * + * @deprecated Deprecated since tizen 6.0. * This group of functions is applied to an Ecore_Buffer_Consumer object. * Ecore_Buffer_Consumer receives Ecore_Buffer enqueued by Ecore_Buffer_Provider. * Consumer must release Ecore_Buffer when it's no longer used. @@ -68,6 +68,7 @@ extern "C" { */ /** + * @deprecated Deprecated since tizen 6.0. * @typedef Ecore_Buffer_Return * @enum _Ecore_Buffer_Return * Types for an buffer queue state on provider side. @@ -84,6 +85,7 @@ typedef enum _Ecore_Buffer_Return ECORE_BUFFER_RETURN_NEED_ALLOC, /**< need to create Ecore_Buffer @since 1.15 */ } Ecore_Buffer_Return; /** + * @deprecated Deprecated since tizen 6.0. * @typedef Ecore_Buffer_Consumer * An object representing a consumer of Ecore_Buffer. * @@ -93,6 +95,7 @@ typedef enum _Ecore_Buffer_Return */ typedef struct _Ecore_Buffer_Consumer Ecore_Buffer_Consumer; /** + * @deprecated Deprecated since tizen 6.0. * @typedef Ecore_Buffer_Provider * An object representing a provider of Ecore_Buffer. * @@ -102,6 +105,7 @@ typedef struct _Ecore_Buffer_Consumer Ecore_Buffer_Consumer; */ typedef struct _Ecore_Buffer_Provider Ecore_Buffer_Provider; /** + * @deprecated Deprecated since tizen 6.0. * @typedef Ecore_Buffer_Consumer_Provider_Add_Cb * * @brief Called whenever a Ecore_Buffer_Provider connected. @@ -113,6 +117,7 @@ typedef struct _Ecore_Buffer_Provider Ecore_Buffer_Provider; */ typedef void (*Ecore_Buffer_Consumer_Provider_Add_Cb) (Ecore_Buffer_Consumer *consumer, void *data); /** + * @deprecated Deprecated since tizen 6.0. * @typedef Ecore_Buffer_Consumer_Provider_Del_Cb * * @brief Called whenever a Ecore_Buffer_Provider disconnected. @@ -124,6 +129,7 @@ typedef void (*Ecore_Buffer_Consumer_Provider_Add_Cb) (Ecore_Buffer_Consumer *co */ typedef void (*Ecore_Buffer_Consumer_Provider_Del_Cb) (Ecore_Buffer_Consumer *consumer, void *data); /** + * @deprecated Deprecated since tizen 6.0. * @typedef Ecore_Buffer_Consumer_Enqueue_Cb * * @brief Called whenever a Ecore_Buffer enqueued in buffer queue. @@ -135,6 +141,7 @@ typedef void (*Ecore_Buffer_Consumer_Provider_Del_Cb) (Ecore_Buffer_Consumer *co */ typedef void (*Ecore_Buffer_Consumer_Enqueue_Cb) (Ecore_Buffer_Consumer *consumer, void *data); /** + * @deprecated Deprecated since tizen 6.0. * @typedef Ecore_Buffer_Provider_Consumer_Add_Cb * * @brief Called whenever a Ecore_Buffer_Consumer connected. @@ -146,6 +153,7 @@ typedef void (*Ecore_Buffer_Consumer_Enqueue_Cb) (Ecore_Buffer_Consumer *consume */ typedef void (*Ecore_Buffer_Provider_Consumer_Add_Cb) (Ecore_Buffer_Provider *provider, int queue_size, int w, int h, void *data); /** + * @deprecated Deprecated since tizen 6.0. * @typedef Ecore_Buffer_Provider_Consumer_Del_Cb * * @brief Called whenever a Ecore_Buffer_Consumer disconnected. @@ -157,6 +165,7 @@ typedef void (*Ecore_Buffer_Provider_Consumer_Add_Cb) (Ecore_Buffer_Provider *pr */ typedef void (*Ecore_Buffer_Provider_Consumer_Del_Cb) (Ecore_Buffer_Provider *provider, void *data); /** + * @deprecated Deprecated since tizen 6.0. * @typedef Ecore_Buffer_Provider_Enqueue_Cb * * @brief Called whenever a Ecore_Buffer is released. @@ -174,6 +183,7 @@ typedef void (*Ecore_Buffer_Provider_Enqueue_Cb) (Ecore_Buffer_Provider *provide */ /** + * @deprecated Deprecated since tizen 6.0. * @brief Inits the Ecore_Buffer_Queue system. * * @since 1.15 @@ -188,8 +198,9 @@ typedef void (*Ecore_Buffer_Provider_Enqueue_Cb) (Ecore_Buffer_Provider *provide * @elseif WEARABLE @since_tizen 3.0 * @endif */ -EAPI int ecore_buffer_queue_init(void); +EAPI int ecore_buffer_queue_init(void) EINA_DEPRECATED; /** + * @deprecated Deprecated since tizen 6.0. * @brief Shuts down the Ecore_Buffer_Queue system. * * @since 1.15 @@ -204,7 +215,7 @@ EAPI int ecore_buffer_queue_init(void); * @elseif WEARABLE @since_tizen 3.0 * @endif */ -EAPI int ecore_buffer_queue_shutdown(void); +EAPI int ecore_buffer_queue_shutdown(void) EINA_DEPRECATED; /** * @} @@ -216,6 +227,7 @@ EAPI int ecore_buffer_queue_shutdown(void); */ /** + * @deprecated Deprecated since tizen 6.0. * @brief Creates a new Buffer Consumer based on name and common parameters. * * @since 1.15 @@ -231,8 +243,9 @@ EAPI int ecore_buffer_queue_shutdown(void); * @elseif WEARABLE @since_tizen 3.0 * @endif */ -EAPI Ecore_Buffer_Consumer *ecore_buffer_consumer_new(const char *name, int32_t queue_size, int32_t w, int32_t h); +EAPI Ecore_Buffer_Consumer *ecore_buffer_consumer_new(const char *name, int32_t queue_size, int32_t w, int32_t h) EINA_DEPRECATED; /** + * @deprecated Deprecated since tizen 6.0. * @brief Frees an Ecore_Buffer_Consumer. * * @since 1.15 @@ -245,8 +258,9 @@ EAPI Ecore_Buffer_Consumer *ecore_buffer_consumer_new(const char *name, int32 * @elseif WEARABLE @since_tizen 3.0 * @endif */ -EAPI void ecore_buffer_consumer_free(Ecore_Buffer_Consumer *consumer); +EAPI void ecore_buffer_consumer_free(Ecore_Buffer_Consumer *consumer) EINA_DEPRECATED; /** + * @deprecated Deprecated since tizen 6.0. * @brief Returns the latest Ecore_Buffer submitted by provider. * * @since 1.15 @@ -264,8 +278,9 @@ EAPI void ecore_buffer_consumer_free(Ecore_Buffer_Consumer * @elseif WEARABLE @since_tizen 3.0 * @endif */ -EAPI Ecore_Buffer *ecore_buffer_consumer_buffer_dequeue(Ecore_Buffer_Consumer *consumer); +EAPI Ecore_Buffer *ecore_buffer_consumer_buffer_dequeue(Ecore_Buffer_Consumer *consumer) EINA_DEPRECATED; /** + * @deprecated Deprecated since tizen 6.0. * @brief Releases the acquired Ecore_Buffer. * * @since 1.15 @@ -286,8 +301,9 @@ EAPI Ecore_Buffer *ecore_buffer_consumer_buffer_dequeue(Ecore_Buffer * @elseif WEARABLE @since_tizen 3.0 * @endif */ -EAPI Eina_Bool ecore_buffer_consumer_buffer_release(Ecore_Buffer_Consumer *consumer, Ecore_Buffer *buffer); +EAPI Eina_Bool ecore_buffer_consumer_buffer_release(Ecore_Buffer_Consumer *consumer, Ecore_Buffer *buffer) EINA_DEPRECATED; /** + * @deprecated Deprecated since tizen 6.0. * @brief Checks if Queue of Ecore_Buffer is empty. * * @since 1.15 @@ -300,8 +316,9 @@ EAPI Eina_Bool ecore_buffer_consumer_buffer_release(Ecore_Buffer * @elseif WEARABLE @since_tizen 3.0 * @endif */ -EAPI Eina_Bool ecore_buffer_consumer_queue_is_empty(Ecore_Buffer_Consumer *consumer); +EAPI Eina_Bool ecore_buffer_consumer_queue_is_empty(Ecore_Buffer_Consumer *consumer) EINA_DEPRECATED; /** + * @deprecated Deprecated since tizen 6.0. * @brief Sets a callback for provider connection events. * * @since 1.15 @@ -317,8 +334,9 @@ EAPI Eina_Bool ecore_buffer_consumer_queue_is_empty(Ecore_Buffer * @elseif WEARABLE @since_tizen 3.0 * @endif */ -EAPI void ecore_buffer_consumer_provider_add_cb_set(Ecore_Buffer_Consumer *consumer, Ecore_Buffer_Consumer_Provider_Add_Cb func, void *data); +EAPI void ecore_buffer_consumer_provider_add_cb_set(Ecore_Buffer_Consumer *consumer, Ecore_Buffer_Consumer_Provider_Add_Cb func, void *data) EINA_DEPRECATED; /** + * @deprecated Deprecated since tizen 6.0. * @brief Sets a callback for provider disconnection events. * * @since 1.15 @@ -334,8 +352,9 @@ EAPI void ecore_buffer_consumer_provider_add_cb_set(Ecore_B * @elseif WEARABLE @since_tizen 3.0 * @endif */ -EAPI void ecore_buffer_consumer_provider_del_cb_set(Ecore_Buffer_Consumer *consumer, Ecore_Buffer_Consumer_Provider_Del_Cb func, void *data); +EAPI void ecore_buffer_consumer_provider_del_cb_set(Ecore_Buffer_Consumer *consumer, Ecore_Buffer_Consumer_Provider_Del_Cb func, void *data) EINA_DEPRECATED; /** + * @deprecated Deprecated since tizen 6.0. * @brief Sets a callback for enqueued buffer events. * * @since 1.15 @@ -353,7 +372,7 @@ EAPI void ecore_buffer_consumer_provider_del_cb_set(Ecore_B * @elseif WEARABLE @since_tizen 3.0 * @endif */ -EAPI void ecore_buffer_consumer_buffer_enqueued_cb_set(Ecore_Buffer_Consumer *consumer, Ecore_Buffer_Consumer_Enqueue_Cb func, void *data); +EAPI void ecore_buffer_consumer_buffer_enqueued_cb_set(Ecore_Buffer_Consumer *consumer, Ecore_Buffer_Consumer_Enqueue_Cb func, void *data) EINA_DEPRECATED; /** * @} @@ -365,6 +384,7 @@ EAPI void ecore_buffer_consumer_buffer_enqueued_cb_set(Ecor */ /** + * @deprecated Deprecated since tizen 6.0. * @brief Creates a new Buffer Provider based on name. * * @since 1.15 @@ -377,8 +397,9 @@ EAPI void ecore_buffer_consumer_buffer_enqueued_cb_set(Ecor * @elseif WEARABLE @since_tizen 3.0 * @endif */ -EAPI Ecore_Buffer_Provider *ecore_buffer_provider_new(const char *name); +EAPI Ecore_Buffer_Provider *ecore_buffer_provider_new(const char *name) EINA_DEPRECATED; /** + * @deprecated Deprecated since tizen 6.0. * @brief Frees an Ecore_Buffer_Provider. * * @since 1.15 @@ -391,8 +412,9 @@ EAPI Ecore_Buffer_Provider *ecore_buffer_provider_new(const char *name); * @elseif WEARABLE @since_tizen 3.0 * @endif */ -EAPI void ecore_buffer_provider_free(Ecore_Buffer_Provider *provider); +EAPI void ecore_buffer_provider_free(Ecore_Buffer_Provider *provider) EINA_DEPRECATED; /** + * @deprecated Deprecated since tizen 6.0. * @brief Returns the Ecore_Buffer released by consumer or State of Queue. * * @since 1.15 @@ -417,8 +439,9 @@ EAPI void ecore_buffer_provider_free(Ecore_Buffer_Provider * @elseif WEARABLE @since_tizen 3.0 * @endif */ -EAPI Ecore_Buffer_Return ecore_buffer_provider_buffer_acquire(Ecore_Buffer_Provider *provider, Ecore_Buffer **ret_buf); +EAPI Ecore_Buffer_Return ecore_buffer_provider_buffer_acquire(Ecore_Buffer_Provider *provider, Ecore_Buffer **ret_buf) EINA_DEPRECATED; /** + * @deprecated Deprecated since tizen 6.0. * @brief Submits the Ecore_Buffer to Consumer to request compositing. * * @since 1.15 @@ -438,8 +461,9 @@ EAPI Ecore_Buffer_Return ecore_buffer_provider_buffer_acquire(Ecore_Buffer * @elseif WEARABLE @since_tizen 3.0 * @endif */ -EAPI Eina_Bool ecore_buffer_provider_buffer_enqueue(Ecore_Buffer_Provider *provider, Ecore_Buffer *buffer); +EAPI Eina_Bool ecore_buffer_provider_buffer_enqueue(Ecore_Buffer_Provider *provider, Ecore_Buffer *buffer) EINA_DEPRECATED; /** + * @deprecated Deprecated since tizen 6.0. * @brief Checks if state of queue. * * @since 1.15 @@ -458,8 +482,9 @@ EAPI Eina_Bool ecore_buffer_provider_buffer_enqueue(Ecore_Buffer * @elseif WEARABLE @since_tizen 3.0 * @endif */ -EAPI Ecore_Buffer_Return ecore_buffer_provider_buffer_acquirable_check(Ecore_Buffer_Provider *provider); +EAPI Ecore_Buffer_Return ecore_buffer_provider_buffer_acquirable_check(Ecore_Buffer_Provider *provider) EINA_DEPRECATED; /** + * @deprecated Deprecated since tizen 6.0. * @brief Sets a callback for consumer connection events. * * @since 1.15 @@ -475,8 +500,9 @@ EAPI Ecore_Buffer_Return ecore_buffer_provider_buffer_acquirable_check(Eco * @elseif WEARABLE @since_tizen 3.0 * @endif */ -EAPI void ecore_buffer_provider_consumer_add_cb_set(Ecore_Buffer_Provider *provider, Ecore_Buffer_Provider_Consumer_Add_Cb func, void *data); +EAPI void ecore_buffer_provider_consumer_add_cb_set(Ecore_Buffer_Provider *provider, Ecore_Buffer_Provider_Consumer_Add_Cb func, void *data) EINA_DEPRECATED; /** + * @deprecated Deprecated since tizen 6.0. * @brief Sets a callback for consumer disconnection events. * * @since 1.15 @@ -492,8 +518,9 @@ EAPI void ecore_buffer_provider_consumer_add_cb_set(Ecore_B * @elseif WEARABLE @since_tizen 3.0 * @endif */ -EAPI void ecore_buffer_provider_consumer_del_cb_set(Ecore_Buffer_Provider *provider, Ecore_Buffer_Provider_Consumer_Del_Cb func, void *data); +EAPI void ecore_buffer_provider_consumer_del_cb_set(Ecore_Buffer_Provider *provider, Ecore_Buffer_Provider_Consumer_Del_Cb func, void *data) EINA_DEPRECATED; /** + * @deprecated Deprecated since tizen 6.0. * @brief Sets a callback for released buffer events. * * @since 1.15 @@ -511,7 +538,7 @@ EAPI void ecore_buffer_provider_consumer_del_cb_set(Ecore_B * @elseif WEARABLE @since_tizen 3.0 * @endif */ -EAPI void ecore_buffer_provider_buffer_released_cb_set(Ecore_Buffer_Provider *provider, Ecore_Buffer_Provider_Enqueue_Cb func, void *data); +EAPI void ecore_buffer_provider_buffer_released_cb_set(Ecore_Buffer_Provider *provider, Ecore_Buffer_Provider_Enqueue_Cb func, void *data) EINA_DEPRECATED; /** * @} -- 2.7.4