146 lines
4.0 KiB
C
146 lines
4.0 KiB
C
/*
|
|
* Copyright 2014 Google Inc.
|
|
*
|
|
* Use of this source code is governed by a BSD-style license that can be
|
|
* found in the LICENSE file.
|
|
*/
|
|
|
|
// EXPERIMENTAL EXPERIMENTAL EXPERIMENTAL EXPERIMENTAL
|
|
// DO NOT USE -- FOR INTERNAL TESTING ONLY
|
|
|
|
#ifndef sk_paint_DEFINED
|
|
#define sk_paint_DEFINED
|
|
|
|
#include "sk_types.h"
|
|
|
|
SK_C_PLUS_PLUS_BEGIN_GUARD
|
|
|
|
/**
|
|
Create a new paint with default settings:
|
|
antialias : false
|
|
stroke : false
|
|
stroke width : 0.0f (hairline)
|
|
stroke miter : 4.0f
|
|
stroke cap : BUTT_SK_STROKE_CAP
|
|
stroke join : MITER_SK_STROKE_JOIN
|
|
color : opaque black
|
|
shader : NULL
|
|
maskfilter : NULL
|
|
xfermode_mode : SRCOVER_SK_XFERMODE_MODE
|
|
*/
|
|
SK_API sk_paint_t* sk_paint_new();
|
|
/**
|
|
Release the memory storing the sk_paint_t and unref() all
|
|
associated objects.
|
|
*/
|
|
SK_API void sk_paint_delete(sk_paint_t*);
|
|
|
|
/**
|
|
Return true iff the paint has antialiasing enabled.
|
|
*/
|
|
SK_API bool sk_paint_is_antialias(const sk_paint_t*);
|
|
/**
|
|
Set to true to enable antialiasing, false to disable it on this
|
|
sk_paint_t.
|
|
*/
|
|
SK_API void sk_paint_set_antialias(sk_paint_t*, bool);
|
|
|
|
/**
|
|
Return the paint's curent drawing color.
|
|
*/
|
|
SK_API sk_color_t sk_paint_get_color(const sk_paint_t*);
|
|
/**
|
|
Set the paint's curent drawing color.
|
|
*/
|
|
SK_API void sk_paint_set_color(sk_paint_t*, sk_color_t);
|
|
|
|
/* stroke settings */
|
|
|
|
/**
|
|
Return true iff stroking is enabled rather than filling on this
|
|
sk_paint_t.
|
|
*/
|
|
SK_API bool sk_paint_is_stroke(const sk_paint_t*);
|
|
/**
|
|
Set to true to enable stroking rather than filling with this
|
|
sk_paint_t.
|
|
*/
|
|
SK_API void sk_paint_set_stroke(sk_paint_t*, bool);
|
|
|
|
/**
|
|
Return the width for stroking. A value of 0 strokes in hairline mode.
|
|
*/
|
|
SK_API float sk_paint_get_stroke_width(const sk_paint_t*);
|
|
/**
|
|
Set the width for stroking. A value of 0 strokes in hairline mode
|
|
(always draw 1-pixel wide, regardless of the matrix).
|
|
*/
|
|
SK_API void sk_paint_set_stroke_width(sk_paint_t*, float width);
|
|
|
|
/**
|
|
Return the paint's stroke miter value. This is used to control the
|
|
behavior of miter joins when the joins angle is sharp.
|
|
*/
|
|
SK_API float sk_paint_get_stroke_miter(const sk_paint_t*);
|
|
/**
|
|
Set the paint's stroke miter value. This is used to control the
|
|
behavior of miter joins when the joins angle is sharp. This value
|
|
must be >= 0.
|
|
*/
|
|
SK_API void sk_paint_set_stroke_miter(sk_paint_t*, float miter);
|
|
|
|
typedef enum {
|
|
BUTT_SK_STROKE_CAP,
|
|
ROUND_SK_STROKE_CAP,
|
|
SQUARE_SK_STROKE_CAP
|
|
} sk_stroke_cap_t;
|
|
|
|
/**
|
|
Return the paint's stroke cap type, controlling how the start and
|
|
end of stroked lines and paths are treated.
|
|
*/
|
|
SK_API sk_stroke_cap_t sk_paint_get_stroke_cap(const sk_paint_t*);
|
|
/**
|
|
Set the paint's stroke cap type, controlling how the start and
|
|
end of stroked lines and paths are treated.
|
|
*/
|
|
SK_API void sk_paint_set_stroke_cap(sk_paint_t*, sk_stroke_cap_t);
|
|
|
|
typedef enum {
|
|
MITER_SK_STROKE_JOIN,
|
|
ROUND_SK_STROKE_JOIN,
|
|
BEVEL_SK_STROKE_JOIN
|
|
} sk_stroke_join_t;
|
|
|
|
/**
|
|
Return the paint's stroke join type, specifies the treatment that
|
|
is applied to corners in paths and rectangles
|
|
*/
|
|
SK_API sk_stroke_join_t sk_paint_get_stroke_join(const sk_paint_t*);
|
|
/**
|
|
Set the paint's stroke join type, specifies the treatment that
|
|
is applied to corners in paths and rectangles
|
|
*/
|
|
SK_API void sk_paint_set_stroke_join(sk_paint_t*, sk_stroke_join_t);
|
|
|
|
/**
|
|
* Set the paint's shader to the specified parameter. This will automatically call unref() on
|
|
* any previous value, and call ref() on the new value.
|
|
*/
|
|
SK_API void sk_paint_set_shader(sk_paint_t*, sk_shader_t*);
|
|
|
|
/**
|
|
* Set the paint's maskfilter to the specified parameter. This will automatically call unref() on
|
|
* any previous value, and call ref() on the new value.
|
|
*/
|
|
SK_API void sk_paint_set_maskfilter(sk_paint_t*, sk_maskfilter_t*);
|
|
|
|
/**
|
|
* Set the paint's xfermode to the specified parameter.
|
|
*/
|
|
SK_API void sk_paint_set_xfermode_mode(sk_paint_t*, sk_xfermode_mode_t);
|
|
|
|
SK_C_PLUS_PLUS_END_GUARD
|
|
|
|
#endif
|