inc/thorvg_capi.h

   1 #ifndef __THORVG_CAPI_H__
   2 #define __THORVG_CAPI_H__
   3
   4 #ifdef TVG_EXPORT
   5     #undef TVG_EXPORT
   6 #endif
   7
   8 #ifdef TVG_BUILD
   9     #define TVG_EXPORT __attribute__ ((visibility ("default")))
  10 #else
  11     #define TVG_EXPORT
  12 #endif
  13
  14
  15 #ifdef __cplusplus
  16 extern "C" {
  17 #endif
  18
  19 typedef struct _Tvg_Canvas Tvg_Canvas;
  20 typedef struct _Tvg_Paint Tvg_Paint;
  21 typedef struct _Tvg_Gradient Tvg_Gradient;
  22
  23 #define TVG_ENGINE_SW (1 << 1)
  24 #define TVG_ENGINE_GL (1 << 2)
  25
  26 #define TVG_COLORSPACE_ABGR8888 0
  27 #define TVG_COLORSPACE_ARGB8888 1
  28
  29 typedef enum {
  30     TVG_RESULT_SUCCESS = 0,
  31     TVG_RESULT_INVALID_ARGUMENT,
  32     TVG_RESULT_INSUFFICIENT_CONDITION,
  33     TVG_RESULT_FAILED_ALLOCATION,
  34     TVG_RESULT_MEMORY_CORRUPTION,
  35     TVG_RESULT_NOT_SUPPORTED,
  36     TVG_RESULT_UNKNOWN
  37 } Tvg_Result;
  38
  39
  40 typedef enum {
  41     TVG_PATH_COMMAND_CLOSE = 0,
  42     TVG_PATH_COMMAND_MOVE_TO,
  43     TVG_PATH_COMMAND_LINE_TO,
  44     TVG_PATH_COMMAND_CUBIC_TO
  45 } Tvg_Path_Command;
  46
  47
  48 typedef enum {
  49     TVG_STROKE_CAP_SQUARE = 0,
  50     TVG_STROKE_CAP_ROUND,
  51     TVG_STROKE_CAP_BUTT
  52 } Tvg_Stroke_Cap;
  53
  54
  55 typedef enum {
  56     TVG_STROKE_JOIN_BEVEL = 0,
  57     TVG_STROKE_JOIN_ROUND,
  58     TVG_STROKE_JOIN_MITER
  59 } Tvg_Stroke_Join;
  60
  61
  62 typedef enum {
  63     TVG_STROKE_FILL_PAD = 0,
  64     TVG_STROKE_FILL_REFLECT,
  65     TVG_STROKE_FILL_REPEAT
  66 } Tvg_Stroke_Fill;
  67
  68
  69 typedef struct
  70 {
  71     float x, y;
  72 } Tvg_Point;
  73
  74
  75 typedef struct
  76 {
  77     float e11, e12, e13;
  78     float e21, e22, e23;
  79     float e31, e32, e33;
  80 } Tvg_Matrix;
  81
  82 typedef struct
  83 {
  84     float offset;
  85     uint8_t r, g, b, a;
  86 } Tvg_Color_Stop;
  87
  88 /************************************************************************/
  89 /* Engine API                                                           */
  90 /************************************************************************/
  91 TVG_EXPORT Tvg_Result tvg_engine_init(unsigned engine_method, unsigned threads);
  92 TVG_EXPORT Tvg_Result tvg_engine_term(unsigned engine_method);
  93
  94
  95 /************************************************************************/
  96 /* SwCanvas API                                                         */
  97 /************************************************************************/
  98 TVG_EXPORT Tvg_Canvas* tvg_swcanvas_create();
  99 TVG_EXPORT Tvg_Result tvg_swcanvas_set_target(Tvg_Canvas* canvas, uint32_t* buffer, uint32_t stride, uint32_t w, uint32_t h, uint32_t cs);
 100
 101
 102 /************************************************************************/
 103 /* Common Canvas API                                                    */
 104 /************************************************************************/
 105 TVG_EXPORT Tvg_Result tvg_canvas_destroy(Tvg_Canvas* canvas);
 106 TVG_EXPORT Tvg_Result tvg_canvas_push(Tvg_Canvas* canvas, Tvg_Paint* paint);
 107 TVG_EXPORT Tvg_Result tvg_canvas_reserve(Tvg_Canvas* canvas, uint32_t n);
 108 TVG_EXPORT Tvg_Result tvg_canvas_clear(Tvg_Canvas* canvas);
 109 TVG_EXPORT Tvg_Result tvg_canvas_update(Tvg_Canvas* canvas);
 110 TVG_EXPORT Tvg_Result tvg_canvas_update_paint(Tvg_Canvas* canvas, Tvg_Paint* paint);
 111 TVG_EXPORT Tvg_Result tvg_canvas_draw(Tvg_Canvas* canvas);
 112 TVG_EXPORT Tvg_Result tvg_canvas_sync(Tvg_Canvas* canvas);
 113
 114
 115 /************************************************************************/
 116 /* Paint API                                                            */
 117 /************************************************************************/
 118 TVG_EXPORT Tvg_Result tvg_paint_del(Tvg_Paint* paint);
 119 TVG_EXPORT Tvg_Result tvg_paint_scale(Tvg_Paint* paint, float factor);
 120 TVG_EXPORT Tvg_Result tvg_paint_rotate(Tvg_Paint* paint, float degree);
 121 TVG_EXPORT Tvg_Result tvg_paint_translate(Tvg_Paint* paint, float x, float y);
 122 TVG_EXPORT Tvg_Result tvg_paint_transform(Tvg_Paint* paint, const Tvg_Matrix* m);
 123
 124
 125 /************************************************************************/
 126 /* Shape API                                                            */
 127 /************************************************************************/
 128 TVG_EXPORT Tvg_Paint* tvg_shape_new();
 129 TVG_EXPORT Tvg_Result tvg_shape_reset(Tvg_Paint* paint);
 130 TVG_EXPORT Tvg_Result tvg_shape_move_to(Tvg_Paint* paint, float x, float y);
 131 TVG_EXPORT Tvg_Result tvg_shape_line_to(Tvg_Paint* paint, float x, float y);
 132 TVG_EXPORT Tvg_Result tvg_shape_cubic_to(Tvg_Paint* paint, float cx1, float cy1, float cx2, float cy2, float x, float y);
 133 TVG_EXPORT Tvg_Result tvg_shape_close(Tvg_Paint* paint);
 134 TVG_EXPORT Tvg_Result tvg_shape_append_rect(Tvg_Paint* paint, float x, float y, float w, float h, float rx, float ry);
 135 TVG_EXPORT Tvg_Result tvg_shape_append_circle(Tvg_Paint* paint, float cx, float cy, float rx, float ry);
 136 TVG_EXPORT Tvg_Result tvg_shape_append_arc(Tvg_Paint* paint, float cx, float cy, float radius, float startAngle, float sweep, uint8_t pie);
 137 TVG_EXPORT Tvg_Result tvg_shape_append_path(Tvg_Paint* paint, const Tvg_Path_Command* cmds, uint32_t cmdCnt, const Tvg_Point* pts, uint32_t ptsCnt);
 138 TVG_EXPORT Tvg_Result tvg_shape_set_stroke_width(Tvg_Paint* paint, float width);
 139 TVG_EXPORT Tvg_Result tvg_shape_set_stroke_color(Tvg_Paint* paint, uint8_t r, uint8_t g, uint8_t b, uint8_t a);
 140 TVG_EXPORT Tvg_Result tvg_shape_set_stroke_dash(Tvg_Paint* paint, const float* dashPattern, uint32_t cnt);
 141 TVG_EXPORT Tvg_Result tvg_shape_set_stroke_cap(Tvg_Paint* paint, Tvg_Stroke_Cap cap);
 142 TVG_EXPORT Tvg_Result tvg_shape_set_stroke_join(Tvg_Paint* paint, Tvg_Stroke_Join join);
 143 TVG_EXPORT Tvg_Result tvg_shape_fill_color(Tvg_Paint* paint, uint8_t r, uint8_t g, uint8_t b, uint8_t a);
 144 TVG_EXPORT Tvg_Result tvg_shape_linear_gradient_set(Tvg_Paint* paint, Tvg_Gradient *grad);
 145 TVG_EXPORT Tvg_Result tvg_shape_radial_gradient_set(Tvg_Paint* paint, Tvg_Gradient *grad);
 146
 147
 148 /************************************************************************/
 149 /* Gradient API                                                         */
 150 /************************************************************************/
 151 TVG_EXPORT Tvg_Gradient* tvg_linear_gradient_new();
 152 TVG_EXPORT Tvg_Gradient* tvg_radial_gradient_new();
 153 TVG_EXPORT Tvg_Result tvg_gradient_del(Tvg_Gradient* grad);
 154 TVG_EXPORT Tvg_Result tvg_linear_gradient_set(Tvg_Gradient* grad, float x1, float y1, float x2, float y2);
 155 TVG_EXPORT Tvg_Result tvg_radial_gradient_set(Tvg_Gradient* grad, float cx, float cy, float radius);
 156 TVG_EXPORT Tvg_Result tvg_gradient_color_stops(Tvg_Gradient* grad, const Tvg_Color_Stop* color_stop, uint32_t cnt);
 157 TVG_EXPORT Tvg_Result tvg_gradient_spread(Tvg_Gradient* grad, const Tvg_Stroke_Fill);
 158
 159
 160 /************************************************************************/
 161 /* Picture API                                                          */
 162 /************************************************************************/
 163 TVG_EXPORT Tvg_Paint* tvg_picture_new();
 164 TVG_EXPORT Tvg_Result tvg_picture_load(Tvg_Paint* paint, const char* path);
 165 TVG_EXPORT Tvg_Result tvg_picture_get_viewbox(Tvg_Paint* paint, float* x, float* y, float* w, float* h);
 166
 167 #ifdef __cplusplus
 168 }
 169 #endif
 170
 171 #endif //_THORVG_CAPI_H_