blob: 6b4e83d3b2a69c4bfd2149a599265610a28ff3cc [file] [log] [blame]
reed73c25012014-11-17 06:15:42 -08001/*
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
16SK_C_PLUS_PLUS_BEGIN_GUARD
17
18typedef enum {
19 CW_SK_PATH_DIRECTION,
20 CCW_SK_PATH_DIRECTION,
21} sk_path_direction_t;
22
halcanaryc9119062015-09-01 10:45:09 -070023/** Create a new, empty path. */
halcanary219f18f2015-09-01 10:01:38 -070024SK_API sk_path_t* sk_path_new();
halcanaryc9119062015-09-01 10:45:09 -070025/** Release the memory used by a sk_path_t. */
halcanary219f18f2015-09-01 10:01:38 -070026SK_API void sk_path_delete(sk_path_t*);
reed73c25012014-11-17 06:15:42 -080027
halcanaryc9119062015-09-01 10:45:09 -070028/** Set the beginning of the next contour to the point (x,y). */
halcanary219f18f2015-09-01 10:01:38 -070029SK_API void sk_path_move_to(sk_path_t*, float x, float y);
halcanaryc9119062015-09-01 10:45:09 -070030/**
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*/
halcanary219f18f2015-09-01 10:01:38 -070035SK_API void sk_path_line_to(sk_path_t*, float x, float y);
halcanaryc9119062015-09-01 10:45:09 -070036/**
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*/
halcanary219f18f2015-09-01 10:01:38 -070042SK_API void sk_path_quad_to(sk_path_t*, float x0, float y0, float x1, float y1);
halcanaryc9119062015-09-01 10:45:09 -070043/**
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*/
halcanary219f18f2015-09-01 10:01:38 -070049SK_API void sk_path_conic_to(sk_path_t*, float x0, float y0, float x1, float y1, float w);
halcanaryc9119062015-09-01 10:45:09 -070050/**
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*/
halcanary219f18f2015-09-01 10:01:38 -070056SK_API void sk_path_cubic_to(sk_path_t*,
57 float x0, float y0,
58 float x1, float y1,
59 float x2, float y2);
halcanaryc9119062015-09-01 10:45:09 -070060/**
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*/
halcanary219f18f2015-09-01 10:01:38 -070064SK_API void sk_path_close(sk_path_t*);
reed73c25012014-11-17 06:15:42 -080065
halcanaryc9119062015-09-01 10:45:09 -070066/**
67 Add a closed rectangle contour to the path.
68*/
halcanary219f18f2015-09-01 10:01:38 -070069SK_API void sk_path_add_rect(sk_path_t*, const sk_rect_t*, sk_path_direction_t);
halcanaryc9119062015-09-01 10:45:09 -070070/**
71 Add a closed oval contour to the path
72*/
halcanary219f18f2015-09-01 10:01:38 -070073SK_API void sk_path_add_oval(sk_path_t*, const sk_rect_t*, sk_path_direction_t);
reed73c25012014-11-17 06:15:42 -080074
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 */
halcanary219f18f2015-09-01 10:01:38 -070080SK_API bool sk_path_get_bounds(const sk_path_t*, sk_rect_t*);
reed73c25012014-11-17 06:15:42 -080081
82SK_C_PLUS_PLUS_END_GUARD
83
84#endif