Home | History | Annotate | Download | only in c
      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 "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 /** Create a new, empty path. */
     24 SK_API sk_path_t* sk_path_new();
     25 /** Release the memory used by a sk_path_t. */
     26 SK_API void sk_path_delete(sk_path_t*);
     27 
     28 /** Set the beginning of the next contour to the point (x,y). */
     29 SK_API void sk_path_move_to(sk_path_t*, float x, float y);
     30 /**
     31     Add a line from the last point to the specified point (x,y). If no
     32     sk_path_move_to() call has been made for this contour, the first
     33     point is automatically set to (0,0).
     34 */
     35 SK_API void sk_path_line_to(sk_path_t*, float x, float y);
     36 /**
     37     Add a quadratic bezier from the last point, approaching control
     38     point (x0,y0), and ending at (x1,y1). If no sk_path_move_to() call
     39     has been made for this contour, the first point is automatically
     40     set to (0,0).
     41 */
     42 SK_API void sk_path_quad_to(sk_path_t*, float x0, float y0, float x1, float y1);
     43 /**
     44     Add a conic curve from the last point, approaching control point
     45     (x0,y01), and ending at (x1,y1) with weight w.  If no
     46     sk_path_move_to() call has been made for this contour, the first
     47     point is automatically set to (0,0).
     48 */
     49 SK_API void sk_path_conic_to(sk_path_t*, float x0, float y0, float x1, float y1, float w);
     50 /**
     51     Add a cubic bezier from the last point, approaching control points
     52     (x0,y0) and (x1,y1), and ending at (x2,y2). If no
     53     sk_path_move_to() call has been made for this contour, the first
     54     point is automatically set to (0,0).
     55 */
     56 SK_API void sk_path_cubic_to(sk_path_t*,
     57                              float x0, float y0,
     58                              float x1, float y1,
     59                              float x2, float y2);
     60 /**
     61    Close the current contour. If the current point is not equal to the
     62    first point of the contour, a line segment is automatically added.
     63 */
     64 SK_API void sk_path_close(sk_path_t*);
     65 
     66 /**
     67     Add a closed rectangle contour to the path.
     68 */
     69 SK_API void sk_path_add_rect(sk_path_t*, const sk_rect_t*, sk_path_direction_t);
     70 /**
     71     Add a closed oval contour to the path
     72 */
     73 SK_API void sk_path_add_oval(sk_path_t*, const sk_rect_t*, sk_path_direction_t);
     74 
     75 /**
     76  *  If the path is empty, return false and set the rect parameter to [0, 0, 0, 0].
     77  *  else return true and set the rect parameter to the bounds of the control-points
     78  *  of the path.
     79  */
     80 SK_API bool sk_path_get_bounds(const sk_path_t*, sk_rect_t*);
     81 
     82 SK_C_PLUS_PLUS_END_GUARD
     83 
     84 #endif
     85