93d0de1d9a
Reviewed-by: Neil Roberts <neil@linux.intel.com> (cherry picked from commit a99512e5798e48ffa3a9a1a7eb98bc55647ee1b6)
106 lines
3.8 KiB
C
106 lines
3.8 KiB
C
/*
|
|
* Cogl
|
|
*
|
|
* An object oriented GL/GLES Abstraction/Utility Layer
|
|
*
|
|
* Copyright (C) 2008,2009 Intel Corporation.
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2 of the License, or (at your option) any later version.
|
|
*
|
|
* This library is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
|
|
*
|
|
*
|
|
*/
|
|
|
|
#if !defined(__COGL_H_INSIDE__) && !defined(COGL_COMPILATION)
|
|
#error "Only <cogl/cogl.h> can be included directly."
|
|
#endif
|
|
|
|
#ifndef __COGL_PATH_H__
|
|
#define __COGL_PATH_H__
|
|
|
|
#include <cogl/cogl-types.h>
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
/**
|
|
* SECTION:cogl-paths
|
|
* @short_description: Functions for constructing and drawing 2D paths.
|
|
*
|
|
* There are two levels on which drawing with cogl-paths can be used.
|
|
* The highest level functions construct various simple primitive
|
|
* shapes to be either filled or stroked. Using a lower-level set of
|
|
* functions more complex and arbitrary paths can be constructed by
|
|
* concatenating straight line, bezier curve and arc segments.
|
|
*
|
|
* When constructing arbitrary paths, the current pen location is
|
|
* initialized using the move_to command. The subsequent path segments
|
|
* implicitly use the last pen location as their first vertex and move
|
|
* the pen location to the last vertex they produce at the end. Also
|
|
* there are special versions of functions that allow specifying the
|
|
* vertices of the path segments relative to the last pen location
|
|
* rather then in the absolute coordinates.
|
|
*/
|
|
|
|
typedef struct _CoglPath CoglPath;
|
|
|
|
#define COGL_PATH(obj) ((CoglPath *)(obj))
|
|
|
|
/**
|
|
* CoglPathFillRule:
|
|
* @COGL_PATH_FILL_RULE_NON_ZERO: Each time the line crosses an edge of
|
|
* the path from left to right one is added to a counter and each time
|
|
* it crosses from right to left the counter is decremented. If the
|
|
* counter is non-zero then the point will be filled. See <xref
|
|
* linkend="fill-rule-non-zero"/>.
|
|
* @COGL_PATH_FILL_RULE_EVEN_ODD: If the line crosses an edge of the
|
|
* path an odd number of times then the point will filled, otherwise
|
|
* it won't. See <xref linkend="fill-rule-even-odd"/>.
|
|
*
|
|
* #CoglPathFillRule is used to determine how a path is filled. There
|
|
* are two options - 'non-zero' and 'even-odd'. To work out whether any
|
|
* point will be filled imagine drawing an infinetely long line in any
|
|
* direction from that point. The number of times and the direction
|
|
* that the edges of the path crosses this line determines whether the
|
|
* line is filled as described below. Any open sub paths are treated
|
|
* as if there was an extra line joining the first point and the last
|
|
* point.
|
|
*
|
|
* The default fill rule is %COGL_PATH_FILL_RULE_EVEN_ODD. The fill
|
|
* rule is attached to the current path so preserving a path with
|
|
* cogl_get_path() also preserves the fill rule. Calling
|
|
* cogl_path_new() resets the current fill rule to the default.
|
|
*
|
|
* <figure id="fill-rule-non-zero">
|
|
* <title>Example of filling various paths using the non-zero rule</title>
|
|
* <graphic fileref="fill-rule-non-zero.png" format="PNG"/>
|
|
* </figure>
|
|
*
|
|
* <figure id="fill-rule-even-odd">
|
|
* <title>Example of filling various paths using the even-odd rule</title>
|
|
* <graphic fileref="fill-rule-even-odd.png" format="PNG"/>
|
|
* </figure>
|
|
*
|
|
* Since: 1.4
|
|
*/
|
|
typedef enum {
|
|
COGL_PATH_FILL_RULE_NON_ZERO,
|
|
COGL_PATH_FILL_RULE_EVEN_ODD
|
|
} CoglPathFillRule;
|
|
|
|
G_END_DECLS
|
|
|
|
#include "cogl-path-functions.h"
|
|
|
|
#endif /* __COGL_PATH_H__ */
|
|
|