1 /* 2 * Copyright 2014 Google Inc. 3 * 4 * Use of this source code is governed by a BSD-style license that can be 5 * found in the LICENSE file. 6 */ 7 8 // EXPERIMENTAL EXPERIMENTAL EXPERIMENTAL EXPERIMENTAL 9 // DO NOT USE -- FOR INTERNAL TESTING ONLY 10 11 #ifndef sk_path_DEFINED 12 #define sk_path_DEFINED 13 14 #include "include/c/sk_types.h" 15 16 SK_C_PLUS_PLUS_BEGIN_GUARD 17 18 typedef enum { 19 CW_SK_PATH_DIRECTION, 20 CCW_SK_PATH_DIRECTION, 21 } sk_path_direction_t; 22 23 typedef struct sk_pathbuilder_t sk_pathbuilder_t; 24 25 /** Create a new, empty path. */ 26 SK_API sk_pathbuilder_t* sk_pathbuilder_new(void); 27 28 /** Release the memory used by a sk_pathbuilder_t. */ 29 SK_API void sk_pathbuilder_delete(sk_pathbuilder_t*); 30 31 /** Set the beginning of the next contour to the point (x,y). */ 32 SK_API void sk_pathbuilder_move_to(sk_pathbuilder_t*, float x, float y); 33 /** 34 Add a line from the last point to the specified point (x,y). If no 35 sk_pathbuilder_move_to() call has been made for this contour, the first 36 point is automatically set to (0,0). 37 */ 38 SK_API void sk_pathbuilder_line_to(sk_pathbuilder_t*, float x, float y); 39 /** 40 Add a quadratic bezier from the last point, approaching control 41 point (x0,y0), and ending at (x1,y1). If no sk_pathbuilder_move_to() call 42 has been made for this contour, the first point is automatically 43 set to (0,0). 44 */ 45 SK_API void sk_pathbuilder_quad_to(sk_pathbuilder_t*, float x0, float y0, float x1, float y1); 46 /** 47 Add a conic curve from the last point, approaching control point 48 (x0,y01), and ending at (x1,y1) with weight w. If no 49 sk_pathbuilder_move_to() call has been made for this contour, the first 50 point is automatically set to (0,0). 51 */ 52 SK_API void sk_pathbuilder_conic_to(sk_pathbuilder_t*, float x0, float y0, float x1, float y1, float w); 53 /** 54 Add a cubic bezier from the last point, approaching control points 55 (x0,y0) and (x1,y1), and ending at (x2,y2). If no 56 sk_pathbuilder_move_to() call has been made for this contour, the first 57 point is automatically set to (0,0). 58 */ 59 SK_API void sk_pathbuilder_cubic_to(sk_pathbuilder_t*, 60 float x0, float y0, 61 float x1, float y1, 62 float x2, float y2); 63 /** 64 Close the current contour. If the current point is not equal to the 65 first point of the contour, a line segment is automatically added. 66 */ 67 SK_API void sk_pathbuilder_close(sk_pathbuilder_t*); 68 69 /** 70 Add a closed rectangle contour to the path. 71 */ 72 SK_API void sk_pathbuilder_add_rect(sk_pathbuilder_t*, const sk_rect_t*, sk_path_direction_t); 73 /** 74 Add a closed oval contour to the path 75 */ 76 SK_API void sk_pathbuilder_add_oval(sk_pathbuilder_t*, const sk_rect_t*, sk_path_direction_t); 77 78 /**** path *****/ 79 80 /** 81 * Return a Path from the builder, resetting the builder to its original empty state. 82 */ 83 SK_API sk_path_t* sk_pathbuilder_detach_path(sk_pathbuilder_t*); 84 85 /** 86 * Return a Path from the builder. The builder reamins in its current state. 87 */ 88 SK_API sk_path_t* sk_pathbuilder_snapshot_path(sk_pathbuilder_t*); 89 90 /** Release the memory used by a sk_path_t. */ 91 SK_API void sk_path_delete(sk_path_t*); 92 93 /** 94 * If the path is empty, return false and set the rect parameter to [0, 0, 0, 0]. 95 * else return true and set the rect parameter to the bounds of the control-points 96 * of the path. 97 */ 98 SK_API bool sk_path_get_bounds(const sk_path_t*, sk_rect_t*); 99 100 SK_C_PLUS_PLUS_END_GUARD 101 102 #endif 103