1
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>GnomeCanvasShape</title><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="index.html" title="GNOME Canvas Library Reference Manual"><link rel="up" href="ch02.html" title="GNOME Canvas Library (libgnomecanvas)"><link rel="previous" href="GnomeCanvasRichText.html" title="GnomeCanvasRichText"><link rel="next" href="GnomeCanvasText.html" title="GnomeCanvasText"><link rel="chapter" href="ch01.html" title="Object Hierarchy"><link rel="chapter" href="ch02.html" title="GNOME Canvas Library (libgnomecanvas)"><link rel="refentry" href="GnomeCanvas.html" title="GnomeCanvas"><link rel="refentry" href="GnomeCanvasBpath.html" title="GnomeCanvasBpath"><link rel="refentry" href="GnomeCanvasClipgroup.html" title="GnomeCanvasClipgroup"><link rel="refentry" href="GnomeCanvasEllipse.html" title="GnomeCanvasEllipse"><link rel="refentry" href="GnomeCanvasGroup.html" title="GnomeCanvasGroup"><link rel="refentry" href="GnomeCanvasItem.html" title="GnomeCanvasItem"><link rel="refentry" href="GnomeCanvasLine.html" title="GnomeCanvasLine"><link rel="refentry" href="GnomeCanvasPixbuf.html" title="GnomeCanvasPixbuf"><link rel="refentry" href="GnomeCanvasPolygon.html" title="GnomeCanvasPolygon"><link rel="refentry" href="GnomeCanvasRE.html" title="GnomeCanvasRE"><link rel="refentry" href="GnomeCanvasRect.html" title="GnomeCanvasRect"><link rel="refentry" href="GnomeCanvasRichText.html" title="GnomeCanvasRichText"><link rel="refentry" href="GnomeCanvasShape.html" title="GnomeCanvasShape"><link rel="refentry" href="GnomeCanvasText.html" title="GnomeCanvasText"><link rel="refentry" href="GnomeCanvasWidget.html" title="GnomeCanvasWidget"><link rel="refentry" href="libgnomecanvas-gnome-canvas-path-def.html" title="gnome-canvas-path-def"><link rel="refentry" href="libgnomecanvas-gnome-canvas-util.html" title="gnome-canvas-util"><link rel="section" href="GnomeCanvasShape.html#id3001407" title="Object Hierarchy"><link rel="section" href="GnomeCanvasShape.html#id3001464" title="Properties"><link rel="section" href="GnomeCanvasShape.html#id3001737" title="Description"><link rel="section" href="GnomeCanvasShape.html#id3001781" title="Details"><link rel="section" href="GnomeCanvasShape.html#id3002012" title="Properties"><meta name="generator" content="GTK-Doc V1.2 (XML mode)"><link rel="stylesheet" href="style.css" type="text/css"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="GnomeCanvasRichText.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch02.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">GNOME Canvas Library Reference Manual</th><td><a accesskey="n" href="GnomeCanvasText.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry" lang="en"><a name="GnomeCanvasShape"></a><div class="titlepage"><div></div><div></div></div><div class="refnamediv"><h2><span class="refentrytitle">GnomeCanvasShape</span></h2><p>GnomeCanvasShape — Base class for canvas item shapes</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><pre class="synopsis">
3
#include <libgnomecanvas/libgnomecanvas.h>
6
struct <a href="GnomeCanvasShape.html#GnomeCanvasShape-struct">GnomeCanvasShape</a>;
7
void <a href="GnomeCanvasShape.html#gnome-canvas-shape-set-path-def">gnome_canvas_shape_set_path_def</a> (<a href="GnomeCanvasShape.html" title="GnomeCanvasShape">GnomeCanvasShape</a> *shape,
8
<a href="libgnomecanvas-gnome-canvas-path-def.html#GnomeCanvasPathDef">GnomeCanvasPathDef</a> *def);
9
<a href="libgnomecanvas-gnome-canvas-path-def.html#GnomeCanvasPathDef">GnomeCanvasPathDef</a>* <a href="GnomeCanvasShape.html#gnome-canvas-shape-get-path-def">gnome_canvas_shape_get_path_def</a>
10
(<a href="GnomeCanvasShape.html" title="GnomeCanvasShape">GnomeCanvasShape</a> *shape);
12
</pre></div><div class="refsect1" lang="en"><a name="id3001407"></a><h2>Object Hierarchy</h2><pre class="synopsis">
16
+----<a href="GnomeCanvasItem.html" title="GnomeCanvasItem">GnomeCanvasItem</a>
18
+----<a href="GnomeCanvasBpath.html" title="GnomeCanvasBpath">GnomeCanvasBpath</a>
19
+----<a href="GnomeCanvasRE.html" title="GnomeCanvasRE">GnomeCanvasRE</a>
20
+----<a href="GnomeCanvasPolygon.html" title="GnomeCanvasPolygon">GnomeCanvasPolygon</a>
21
</pre></div><div class="refsect1" lang="en"><a name="id3001464"></a><h2>Properties</h2><pre class="synopsis">
23
"<a href="GnomeCanvasShape.html#GnomeCanvasShape--cap-style">cap-style</a>" GdkCapStyle : Read / Write
24
"<a href="GnomeCanvasShape.html#GnomeCanvasShape--dash">dash</a>" gpointer : Read / Write
25
"<a href="GnomeCanvasShape.html#GnomeCanvasShape--fill-color">fill-color</a>" gchararray : Write
26
"<a href="GnomeCanvasShape.html#GnomeCanvasShape--fill-color-gdk">fill-color-gdk</a>" GdkColor : Read / Write
27
"<a href="GnomeCanvasShape.html#GnomeCanvasShape--fill-color-rgba">fill-color-rgba</a>" guint : Read / Write
28
"<a href="GnomeCanvasShape.html#GnomeCanvasShape--fill-stipple">fill-stipple</a>" GdkDrawable : Read / Write
29
"<a href="GnomeCanvasShape.html#GnomeCanvasShape--join-style">join-style</a>" GdkJoinStyle : Read / Write
30
"<a href="GnomeCanvasShape.html#GnomeCanvasShape--miterlimit">miterlimit</a>" gdouble : Read / Write
31
"<a href="GnomeCanvasShape.html#GnomeCanvasShape--outline-color">outline-color</a>" gchararray : Write
32
"<a href="GnomeCanvasShape.html#GnomeCanvasShape--outline-color-gdk">outline-color-gdk</a>" GdkColor : Read / Write
33
"<a href="GnomeCanvasShape.html#GnomeCanvasShape--outline-color-rgba">outline-color-rgba</a>" guint : Read / Write
34
"<a href="GnomeCanvasShape.html#GnomeCanvasShape--outline-stipple">outline-stipple</a>" GdkDrawable : Read / Write
35
"<a href="GnomeCanvasShape.html#GnomeCanvasShape--width-pixels">width-pixels</a>" guint : Read / Write
36
"<a href="GnomeCanvasShape.html#GnomeCanvasShape--width-units">width-units</a>" gdouble : Write
37
"<a href="GnomeCanvasShape.html#GnomeCanvasShape--wind">wind</a>" guint : Read / Write
38
</pre></div><div class="refsect1" lang="en"><a name="id3001737"></a><h2>Description</h2><p>
39
Provides a base class for canvas item shapes, including: <a href="GnomeCanvasBpath.html" title="GnomeCanvasBpath"><span class="type">GnomeCanvasBpath</span></a>,
40
<a href="GnomeCanvasEllipse.html" title="GnomeCanvasEllipse"><span class="type">GnomeCanvasEllipse</span></a>, <a href="GnomeCanvasRect.html" title="GnomeCanvasRect"><span class="type">GnomeCanvasRect</span></a>, and <a href="GnomeCanvasPolygon.html" title="GnomeCanvasPolygon"><span class="type">GnomeCanvasPolygon</span></a>.
41
</p></div><div class="refsect1" lang="en"><a name="id3001781"></a><h2>Details</h2><div class="refsect2" lang="en"><a name="id3001787"></a><h3><a name="GnomeCanvasShape-struct"></a>struct GnomeCanvasShape</h3><a class="indexterm" name="id3001797"></a><pre class="programlisting">struct GnomeCanvasShape;</pre><p>
42
This structure should not be accessed directly. Use the object's properties
43
and functions for querying or changing its parameters.
44
</p></div><hr><div class="refsect2" lang="en"><a name="id3001815"></a><h3><a name="gnome-canvas-shape-set-path-def"></a>gnome_canvas_shape_set_path_def ()</h3><a class="indexterm" name="id3001827"></a><pre class="programlisting">void gnome_canvas_shape_set_path_def (<a href="GnomeCanvasShape.html" title="GnomeCanvasShape">GnomeCanvasShape</a> *shape,
45
<a href="libgnomecanvas-gnome-canvas-path-def.html#GnomeCanvasPathDef">GnomeCanvasPathDef</a> *def);</pre><p>
46
This function sets the the GnomeCanvasPathDef used by the
47
GnomeCanvasShape. Notice, that it does not request updates, as
48
it is meant to be used from item implementations, from inside
51
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>shape</tt></i>�:</span></td><td> a GnomeCanvasShape
52
</td></tr><tr><td><span class="term"><i class="parameter"><tt>def</tt></i>�:</span></td><td> a GnomeCanvasPathDef
53
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id3001902"></a><h3><a name="gnome-canvas-shape-get-path-def"></a>gnome_canvas_shape_get_path_def ()</h3><a class="indexterm" name="id3001913"></a><pre class="programlisting"><a href="libgnomecanvas-gnome-canvas-path-def.html#GnomeCanvasPathDef">GnomeCanvasPathDef</a>* gnome_canvas_shape_get_path_def
54
(<a href="GnomeCanvasShape.html" title="GnomeCanvasShape">GnomeCanvasShape</a> *shape);</pre><p>
55
This function returns the <a href="libgnomecanvas-gnome-canvas-path-def.html#GnomeCanvasPathDef"><span class="type">GnomeCanvasPathDef</span></a> that the shape
56
currently uses. It adds a reference to the <a href="libgnomecanvas-gnome-canvas-path-def.html#GnomeCanvasPathDef"><span class="type">GnomeCanvasPathDef</span></a> and
57
returns it, if there is not a <a href="libgnomecanvas-gnome-canvas-path-def.html#GnomeCanvasPathDef"><span class="type">GnomeCanvasPathDef</span></a> set for the shape
58
it returns NULL.</p><p>
60
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>shape</tt></i>�:</span></td><td> a GnomeCanvasShape
61
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> a <a href="libgnomecanvas-gnome-canvas-path-def.html#GnomeCanvasPathDef"><span class="type">GnomeCanvasPathDef</span></a> or NULL if none is set for the shape.
62
</td></tr></tbody></table></div></div></div><div class="refsect1" lang="en"><a name="id3002012"></a><h2>Properties</h2><div class="refsect2" lang="en"><a name="id3002018"></a><h3><a name="GnomeCanvasShape--cap-style"></a>The "<tt class="literal">cap-style</tt>" property</h3><pre class="programlisting"> "cap-style" GdkCapStyle : Read / Write</pre><p>
63
Cap (end point) style for the bpath.
64
</p><p>Default value: GDK_CAP_BUTT</p></div><hr><div class="refsect2" lang="en"><a name="id3002055"></a><h3><a name="GnomeCanvasShape--dash"></a>The "<tt class="literal">dash</tt>" property</h3><pre class="programlisting"> "dash" gpointer : Read / Write</pre><p>
66
</p></div><hr><div class="refsect2" lang="en"><a name="id3002089"></a><h3><a name="GnomeCanvasShape--fill-color"></a>The "<tt class="literal">fill-color</tt>" property</h3><pre class="programlisting"> "fill-color" gchararray : Write</pre><p>
67
X color specification for fill color, or NULL pointer for no color
69
</p><p>Default value: NULL</p></div><hr><div class="refsect2" lang="en"><a name="id3002127"></a><h3><a name="GnomeCanvasShape--fill-color-gdk"></a>The "<tt class="literal">fill-color-gdk</tt>" property</h3><pre class="programlisting"> "fill-color-gdk" GdkColor : Read / Write</pre><p>
70
Allocated GdkColor for fill.
71
</p></div><hr><div class="refsect2" lang="en"><a name="id3002161"></a><h3><a name="GnomeCanvasShape--fill-color-rgba"></a>The "<tt class="literal">fill-color-rgba</tt>" property</h3><pre class="programlisting"> "fill-color-rgba" guint : Read / Write</pre><p>
72
Fill color with an alpha component (in the format 0xRRGGBBAA).
73
</p><p>Default value: 0</p></div><hr><div class="refsect2" lang="en"><a name="id3002200"></a><h3><a name="GnomeCanvasShape--fill-stipple"></a>The "<tt class="literal">fill-stipple</tt>" property</h3><pre class="programlisting"> "fill-stipple" GdkDrawable : Read / Write</pre><p>
74
Stipple pattern for fill.
75
</p></div><hr><div class="refsect2" lang="en"><a name="id3002235"></a><h3><a name="GnomeCanvasShape--join-style"></a>The "<tt class="literal">join-style</tt>" property</h3><pre class="programlisting"> "join-style" GdkJoinStyle : Read / Write</pre><p>
76
Vertex join style for the bpath.
77
</p><p>Default value: GDK_JOIN_MITER</p></div><hr><div class="refsect2" lang="en"><a name="id3002273"></a><h3><a name="GnomeCanvasShape--miterlimit"></a>The "<tt class="literal">miterlimit</tt>" property</h3><pre class="programlisting"> "miterlimit" gdouble : Read / Write</pre><p>
78
Minimum angle between segments, where miter join rule is applied.
79
</p><p>Allowed values: >= 0</p><p>Default value: 0</p></div><hr><div class="refsect2" lang="en"><a name="id3002315"></a><h3><a name="GnomeCanvasShape--outline-color"></a>The "<tt class="literal">outline-color</tt>" property</h3><pre class="programlisting"> "outline-color" gchararray : Write</pre><p>
80
X color specification for outline color, or NULL pointer for no color
82
</p><p>Default value: NULL</p></div><hr><div class="refsect2" lang="en"><a name="id3002355"></a><h3><a name="GnomeCanvasShape--outline-color-gdk"></a>The "<tt class="literal">outline-color-gdk</tt>" property</h3><pre class="programlisting"> "outline-color-gdk" GdkColor : Read / Write</pre><p>
83
Allocated GdkColor for outline.
84
</p></div><hr><div class="refsect2" lang="en"><a name="id3002388"></a><h3><a name="GnomeCanvasShape--outline-color-rgba"></a>The "<tt class="literal">outline-color-rgba</tt>" property</h3><pre class="programlisting"> "outline-color-rgba" guint : Read / Write</pre><p>
85
Outline color with an alpha component (in the format 0xRRGGBBAA).
86
</p><p>Default value: 0</p></div><hr><div class="refsect2" lang="en"><a name="id3002428"></a><h3><a name="GnomeCanvasShape--outline-stipple"></a>The "<tt class="literal">outline-stipple</tt>" property</h3><pre class="programlisting"> "outline-stipple" GdkDrawable : Read / Write</pre><p>
87
Stipple pattern for outline.
88
</p></div><hr><div class="refsect2" lang="en"><a name="id3002462"></a><h3><a name="GnomeCanvasShape--width-pixels"></a>The "<tt class="literal">width-pixels</tt>" property</h3><pre class="programlisting"> "width-pixels" guint : Read / Write</pre><p>
89
Width of the outline in pixels. The outline will not be scaled when the
90
canvas zoom factor is changed.
91
</p><p>Default value: 0</p></div><hr><div class="refsect2" lang="en"><a name="id3002501"></a><h3><a name="GnomeCanvasShape--width-units"></a>The "<tt class="literal">width-units</tt>" property</h3><pre class="programlisting"> "width-units" gdouble : Write</pre><p>
92
Width of the outline in canvas units. The outline will be scaled when
93
the canvas zoom factor is changed.
94
</p><p>Allowed values: >= 0</p><p>Default value: 0</p></div><hr><div class="refsect2" lang="en"><a name="id3002545"></a><h3><a name="GnomeCanvasShape--wind"></a>The "<tt class="literal">wind</tt>" property</h3><pre class="programlisting"> "wind" guint : Read / Write</pre><p>
95
Winding rule for the bpath (ArtWindRule).
96
</p><p>Default value: 0</p></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="GnomeCanvasRichText.html"><b><<�GnomeCanvasRichText</b></a></td><td align="right"><a accesskey="n" href="GnomeCanvasText.html"><b>GnomeCanvasText�>></b></a></td></tr></table></body></html>