From 0d441f51a2053f37057742ec95edb6532277d754 Mon Sep 17 00:00:00 2001 From: Xavi Artigas Date: Mon, 27 Apr 2020 17:25:27 +0200 Subject: [PATCH] doxygen docs: Fix most errors on Evas_Legacy.h Oh boy... References to Unified API, horribly misshapen groups, typos, invalid commands, invalid references, and on top of that, Evas VG. --- src/lib/evas/Evas_Common.h | 5 ++-- src/lib/evas/Evas_Legacy.h | 74 ++++++++++++++++++++++------------------------ src/lib/evas/Evas_Loader.h | 28 +++++++++++++----- 3 files changed, 59 insertions(+), 48 deletions(-) diff --git a/src/lib/evas/Evas_Common.h b/src/lib/evas/Evas_Common.h index 1402ce4..9c80eca 100644 --- a/src/lib/evas/Evas_Common.h +++ b/src/lib/evas/Evas_Common.h @@ -1277,9 +1277,10 @@ EAPI Evas_Device *evas_device_default_get(const Evas *eo_e, Evas_Device_Class cl */ /** - * @defgroup Evas_Image_Group Image Functions + * @defgroup Evas_Image Image Functions * - * Functions that deal with images at canvas level. + * Functions that deal with images at canvas level. Compare with + * @ref Evas_Object_Image functions which deal with images at the object level. * * @ingroup Evas_Canvas */ diff --git a/src/lib/evas/Evas_Legacy.h b/src/lib/evas/Evas_Legacy.h index bac35d8..0d4eb3e 100755 --- a/src/lib/evas/Evas_Legacy.h +++ b/src/lib/evas/Evas_Legacy.h @@ -1592,6 +1592,7 @@ EAPI void evas_object_color_get(const Evas_Object *obj, int *r, int *g, int *b, * * @param[in] x in * @param[in] y in + * @ingroup Evas_Object_Group */ EAPI void evas_object_move(Evas_Object *obj, Evas_Coord x, Evas_Coord y); @@ -1601,6 +1602,7 @@ EAPI void evas_object_move(Evas_Object *obj, Evas_Coord x, Evas_Coord y); * * @param[in] w in * @param[in] h in + * @ingroup Evas_Object_Group */ EAPI void evas_object_resize(Evas_Object *obj, Evas_Coord w, Evas_Coord h); @@ -1608,6 +1610,7 @@ EAPI void evas_object_resize(Evas_Object *obj, Evas_Coord w, Evas_Coord h); * * Retrieves whether or not the given Evas object is visible. * + * @ingroup Evas_Object_Group */ EAPI Eina_Bool evas_object_visible_get(const Evas_Object *obj); @@ -1783,7 +1786,7 @@ EAPI void evas_object_size_hint_padding_get(const Evas_Object *obj, Evas_Coord * * weight macro) or the complete one of taking each child's weight hint as real * weights to how much of its size to allocate for them in each axis. A * container is supposed to, after normalizing the weights of its children - * (with weight hints), distribut the space it has to layout them by those + * (with weight hints), distribute the space it has to layout them by those * factors -- most weighted children get larger in this process than the least * ones. * @@ -3562,7 +3565,7 @@ EAPI Evas_Object *evas_object_rectangle_add(Evas *e) EINA_WARN_UNUSED_RESULT EIN * @defgroup Evas_Object_Vg Vector Graphics Object * @ingroup Evas * - * Evas_Object_Vg is the scene graph for managing vector graphics objects. + * @ref Evas_Object_Vg is the scene graph for managing vector graphics objects. * User can create shape objects as well as fill objects and give them to the * Evas_Object_Vg for drawing on the screen as well as managing the lifecycle * of the objects, enabling reuse of shape objects. @@ -3622,6 +3625,8 @@ EAPI Evas_Object *evas_object_rectangle_add(Evas *e) EINA_WARN_UNUSED_RESULT EIN * @endcode * * @since 1.14 + * + * @{ */ /** @@ -3730,7 +3735,6 @@ EAPI int evas_object_vg_animated_frame_get(const Evas_Object *obj) EINA_ARG_NONN * @since 1.24 * @since_tizen 6.0 * - * @ingroup Evas_Vg_Cap */ typedef enum Evas_Vg_Cap_Type { @@ -3752,11 +3756,10 @@ typedef enum Evas_Vg_Cap_Type * @since 1.24 * @since_tizen 6.0 * - * @ingroup Evas_Vg_Join */ typedef enum Evas_Vg_Join_Type { - EVAS_VG_JOIN_MITER = 0, /**< Used to render mitered line joins. The intersectioni + EVAS_VG_JOIN_MITER = 0, /**< Used to render mitered line joins. The intersection * of the strokes is clipped at a line perpendicular to * the bisector of the angle between the strokes, at the * distance from the intersection of the segments equal @@ -3769,7 +3772,7 @@ typedef enum Evas_Vg_Join_Type * triangular region of the corner with a straight line * between the outer corners of each stroke */ EVAS_VG_JOIN_LAST /**< Sentinel value to indicate last enum field during - * teration */ + * iteration */ } Evas_Vg_Join; /** @@ -3777,8 +3780,6 @@ typedef enum Evas_Vg_Join_Type * * @since 1.24 * @since_tizen 6.0 - * - * @ingroup Evas_Vg_Path_Command */ typedef enum Evas_Vg_Path_Command_Type { @@ -3801,8 +3802,6 @@ typedef enum Evas_Vg_Path_Command_Type * * @since 1.24 * @since_tizen 6.0 - * - * @ingroup Evas_Vg_Gradient_Stop */ typedef struct _Evas_Vg_Gradient_Stop { @@ -3820,8 +3819,6 @@ typedef struct _Evas_Vg_Gradient_Stop * * @since 1.24 * @since_tizen 6.0 - * - * @ingroup Evas_Vg_Gradient_Spread */ typedef enum Evas_Vg_Gradient_Spread_Type { @@ -3840,8 +3837,6 @@ typedef enum Evas_Vg_Gradient_Spread_Type * @ref evas_vg_shape_stroke_dash_set * * @since 1.24 - * - * @ingroup Evas_Vg_Dash */ typedef struct _Evas_Vg_Dash { @@ -3876,7 +3871,7 @@ EAPI Evas_Vg_Container* evas_vg_container_add(Evas_Object *parent); * @brief Retrieves whether or not the given Evas_Vg_Node object is visible. * * @param[in] obj The object. - * @return @c EINA_TRUE if the object is visible, @EINA_FALSE otherwise. + * @return @c EINA_TRUE if the object is visible, @c EINA_FALSE otherwise. * * @since 1.24 * @since_tizen 6.0 @@ -3925,8 +3920,6 @@ EAPI void evas_vg_node_color_get(Evas_Vg_Node *obj, int *r, int *g, int *b, int * @see evas_vg_node_color_get() (for an example) * @note These color values are expected to be premultiplied by @p a. * - * @ingroup Evas_Object_Group_Basic - * * @param[in] obj The object. * @param[in] r The red component of the given color. * @param[in] g The green component of the given color. @@ -4455,8 +4448,6 @@ EAPI void evas_vg_shape_append_arc_to(Evas_Vg_Shape *obj, double x, double y, do * * @since 1.18 * @since_tizen 6.0 - * - * @ingroup Evas_Vg_Shape */ EAPI void evas_vg_shape_append_arc(Evas_Vg_Shape *obj, double x, double y, double w, double h, double start_angle, double sweep_length); @@ -4558,7 +4549,7 @@ EAPI Eina_Bool evas_vg_shape_equal_commands(Evas_Vg_Shape *obj, const Eo *with); * @brief Set a vg object as the fill property. * * @param[in] obj The object whose fill property gets modified. - * @param[in] The object content will be used for filling. + * @param[in] f The object content to be used for filling. * * @since 1.24 * @since_tizen 6.0 @@ -4671,7 +4662,7 @@ EAPI Evas_Vg_Gradient_Linear* evas_vg_gradient_linear_add(Evas_Vg_Container *par EAPI void evas_vg_gradient_linear_start_set(Evas_Vg_Gradient_Linear *obj, double x, double y); /** - * @biref Gets the start point of this linear gradient. + * @brief Gets the start point of this linear gradient. * * @param[in] obj The object. * @param[out] x The x co-ordinate of start point. @@ -5696,7 +5687,7 @@ EAPI void evas_object_image_filled_set(Evas_Object *obj, Eina_Bool filled); * object's size. * * Returns @c true if it is tracking, @c false if not (and @ref - * evas_object_fill_set must be called manually). + * evas_object_image_fill_set must be called manually). * * @param[in] obj The object * @return @c true to make the fill property follow object size or @c false @@ -5836,8 +5827,7 @@ typedef enum * to be drawn, which must be one of the values in @ref Evas_Border_Fill_Mode. * By center we mean the complementary part of that defined by * @ref evas_object_image_border_set. This one is very useful for making frames - * and decorations. You would most probably also be using a filled image (as in - * @ref Efl.Gfx.Fill.fill_auto) to use as a frame. + * and decorations. * * @param[in] obj The object * @param[in] fill Fill mode of the center region of @c obj (a value in @@ -5853,8 +5843,7 @@ EAPI void evas_object_image_border_center_fill_set(Evas_Object *obj, Evas_Border * to be drawn, which must be one of the values in @ref Evas_Border_Fill_Mode. * By center we mean the complementary part of that defined by * @ref evas_object_image_border_set. This one is very useful for making frames - * and decorations. You would most probably also be using a filled image (as in - * @ref Efl.Gfx.Fill.fill_auto) to use as a frame. + * and decorations. * * The default value is * @@ -6039,7 +6028,7 @@ EAPI void evas_object_image_data_copy_set(Evas_Object *obj, void *data); * * Note that the raw data must be of the same size (see @ref * evas_object_image_size_set, which has to be called before this one) and - * colorspace (see @Evas.Image.colorspace.set) of the image. If data is + * colorspace (see @ref evas_object_image_colorspace_set) of the image. If data is * @c null, the current image data will be freed. Naturally, if one does not * set an image object's data manually, it will still have one, allocated by * Evas. @@ -6068,7 +6057,7 @@ EAPI void evas_object_image_data_set(Evas_Object *obj, void *data); * @note The contents' format returned by it depend on the color space of the * given image object. * - * @note You may want to use @Evas.Image.data_update_add to inform data + * @note You may want to use @ref evas_object_image_data_update_add to inform data * changes, if you did any. * * @param[in] obj The object @@ -6978,10 +6967,6 @@ EAPI void *evas_object_smart_interface_data_get(const Evas_Object *o * * If @c obj is not a smart object, this call will fail immediately. * - * This function supports Eo and legacy inheritance mechanisms. However, it is - * recommended to use @ref efl_isa instead if your object is using Eo from top - * to bottom. - * * The checks use smart classes names and string comparison. There is a version * of this same check using pointer comparison, since a smart class' name is a * single string in Evas. @@ -7095,9 +7080,22 @@ EAPI Evas_Smart *evas_object_smart_smart_get(const Evas_Object *obj) EINA_WARN_U * * See also @ref evas_object_smart_data_get. * + * @param[in] obj The object * @param[in] data A pointer to user data. */ EAPI void evas_object_smart_data_set(Evas_Object *obj, void *data); + +/** + * @brief Retrieves the pointer to user data for a given smart object. + * + * This data is stored independently of the one set by evas_object_data_set(), + * naturally. + * + * See also @ref evas_object_smart_data_set. + * + * @param[in] obj The object + * @return A pointer to user data. + */ EAPI void *evas_object_smart_data_get(const Evas_Object *obj); /** @@ -7117,8 +7115,8 @@ EAPI Evas_Object *evas_object_smart_clipped_clipper_get(const Evas_Object *obj) * * This function will return @c null when a non-smart object is passed. * - * See also @ref Efl.Canvas.Group.group_member_add, - * @ref Efl.Canvas.Group.group_member_remove and @ref evas_object_smart_iterator_new. + * See also @ref evas_object_smart_member_add, + * @ref evas_object_smart_member_del and @ref evas_object_smart_iterator_new. * * @return Returns the list of the member objects of @c obj. * @@ -7168,8 +7166,8 @@ EAPI Eina_Bool evas_object_smart_need_recalculate_get(const Evas_Object *obj); * @brief Retrieves an iterator of the member objects of a given Evas smart * object. * - * See also @ref Efl.Canvas.Group.group_member_add and - * @ref Efl.Canvas.Group.group_member_remove + * See also @ref evas_object_smart_member_add and + * @ref evas_object_smart_member_del * * @return Returns the iterator of the member objects of @c obj. * @@ -8563,7 +8561,7 @@ EAPI void evas_map_point_color_get(const Evas_Map *m, int idx, int *r * * @param[in] map The map. * - * @ingroup Efl_Canvas_Object + * @ingroup Evas_Object_Group */ EAPI void evas_object_map_set(Evas_Object *obj, const Evas_Map *map); @@ -8576,7 +8574,7 @@ EAPI void evas_object_map_set(Evas_Object *obj, const Evas_Map *map); * * @return The map. * - * @ingroup Efl_Canvas_Object + * @ingroup Evas_Object_Group */ EAPI const Evas_Map *evas_object_map_get(const Evas_Object *obj); diff --git a/src/lib/evas/Evas_Loader.h b/src/lib/evas/Evas_Loader.h index 214c951..276f3e4 100644 --- a/src/lib/evas/Evas_Loader.h +++ b/src/lib/evas/Evas_Loader.h @@ -119,6 +119,11 @@ struct _Evas_Module unsigned char loaded : 1; }; +/** + * @addtogroup Evas_Image + * @{ + */ + typedef struct _Evas_Image_Load_Opts Evas_Image_Load_Opts; struct _Evas_Image_Load_Opts @@ -164,16 +169,19 @@ struct _Evas_Image_Property typedef struct _Evas_Image_Load_Func Evas_Image_Load_Func; +/** + * @brief Possible outcomes of a load operation + */ typedef enum { - EVAS_LOAD_ERROR_NONE = 0, - EVAS_LOAD_ERROR_GENERIC, - EVAS_LOAD_ERROR_DOES_NOT_EXIST, - EVAS_LOAD_ERROR_PERMISSION_DENIED, - EVAS_LOAD_ERROR_RESOURCE_ALLOCATION_FAILED, - EVAS_LOAD_ERROR_CORRUPT_FILE, - EVAS_LOAD_ERROR_UNKNOWN_FORMAT, - EVAS_LOAD_ERROR_CANCELLED, + EVAS_LOAD_ERROR_NONE = 0, /**< No error on load */ + EVAS_LOAD_ERROR_GENERIC, /**< A non-specific error occurred */ + EVAS_LOAD_ERROR_DOES_NOT_EXIST, /**< File (or file path) does not exist */ + EVAS_LOAD_ERROR_PERMISSION_DENIED, /**< Permission denied to an existing file (or path) */ + EVAS_LOAD_ERROR_RESOURCE_ALLOCATION_FAILED, /**< Allocation of resources failure prevented load */ + EVAS_LOAD_ERROR_CORRUPT_FILE, /**< File corrupt (but was detected as a known format) */ + EVAS_LOAD_ERROR_UNKNOWN_FORMAT, /**< File is not a known format */ + EVAS_LOAD_ERROR_CANCELLED, /**< File loading has been cancelled */ } Evas_Load_Error; typedef Emile_Image_Animated_Loop_Hint Evas_Image_Animated_Loop_Hint; @@ -305,6 +313,10 @@ evas_loader_helper_stretch_region_push(uint8_t **region, return EINA_TRUE; } +/** + * @} + */ + #ifdef __cplusplus } #endif -- 2.7.4