Files
gimp/devel-docs/libgimp/html/libgimp-gimpvectors.html
2010-08-11 01:21:06 -04:00

1951 lines
64 KiB
HTML

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>gimpvectors</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.71.0">
<link rel="start" href="index.html" title="GIMP Library Reference Manual">
<link rel="up" href="libgimp-image.html" title="Manupulating Images and their Properties">
<link rel="prev" href="libgimp-gimpundo.html" title="gimpundo">
<link rel="next" href="libgimp-data.html" title="Data Objects">
<meta name="generator" content="GTK-Doc V1.7 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
<link rel="part" href="libgimp.html" title="Part&#160;I.&#160;GIMP Library">
<link rel="chapter" href="libgimp-general.html" title="Functions not Related to Specific Images">
<link rel="chapter" href="libgimp-image.html" title="Manupulating Images and their Properties">
<link rel="chapter" href="libgimp-data.html" title="Data Objects">
<link rel="chapter" href="libgimp-selectors.html" title="Controlling the Core's Selection Dialogs">
<link rel="part" href="libgimpui.html" title="Part&#160;II.&#160;GIMP User Interface Library">
<link rel="chapter" href="libgimpui-hierarchy.html" title="Object Hierarchy">
<link rel="index" href="libgimp-index.html" title="Index">
<link rel="index" href="libgimp-index-new-in-2-2.html" title="Index of new symbols in GIMP 2.2">
<link rel="index" href="libgimp-index-new-in-2-4.html" title="Index of new symbols in GIMP 2.4">
<link rel="index" href="libgimp-index-deprecated.html" title="Index of deprecated symbols">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="libgimp-gimpundo.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="libgimp-image.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">GIMP Library Reference Manual</th>
<td><a accesskey="n" href="libgimp-data.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2604128" class="shortcut">Top</a>
&#160;|&#160;
<a href="#id2675972" class="shortcut">Description</a></nobr></td></tr>
</table>
<div class="refentry" lang="en">
<a name="libgimp-gimpvectors"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2>
<a name="id2604128"></a><span class="refentrytitle">gimpvectors</span>
</h2>
<p>gimpvectors</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<h2>Synopsis</h2>
<pre class="synopsis">
gint32 <a href="libgimp-gimpvectors.html#gimp-vectors-new">gimp_vectors_new</a> (gint32 image_ID,
const gchar *name);
gboolean <a href="libgimp-gimpvectors.html#gimp-vectors-import-from-file">gimp_vectors_import_from_file</a> (gint32 image_ID,
const gchar *filename,
gboolean merge,
gboolean scale,
gint *num_vectors,
gint32 **vectors_ids);
gboolean <a href="libgimp-gimpvectors.html#gimp-vectors-import-from-string">gimp_vectors_import_from_string</a> (gint32 image_ID,
const gchar *string,
gint length,
gboolean merge,
gboolean scale,
gint *num_vectors,
gint32 **vectors_ids);
gboolean <a href="libgimp-gimpvectors.html#gimp-vectors-is-valid">gimp_vectors_is_valid</a> (gint32 vectors_ID);
gint* <a href="libgimp-gimpvectors.html#gimp-vectors-get-strokes">gimp_vectors_get_strokes</a> (gint32 vectors_ID,
gint *num_strokes);
gint32 <a href="libgimp-gimpvectors.html#gimp-vectors-get-image">gimp_vectors_get_image</a> (gint32 vectors_ID);
gboolean <a href="libgimp-gimpvectors.html#gimp-vectors-get-linked">gimp_vectors_get_linked</a> (gint32 vectors_ID);
gchar* <a href="libgimp-gimpvectors.html#gimp-vectors-get-name">gimp_vectors_get_name</a> (gint32 vectors_ID);
gint <a href="libgimp-gimpvectors.html#gimp-vectors-get-tattoo">gimp_vectors_get_tattoo</a> (gint32 vectors_ID);
gboolean <a href="libgimp-gimpvectors.html#gimp-vectors-get-visible">gimp_vectors_get_visible</a> (gint32 vectors_ID);
gboolean <a href="libgimp-gimpvectors.html#gimp-vectors-set-linked">gimp_vectors_set_linked</a> (gint32 vectors_ID,
gboolean linked);
gboolean <a href="libgimp-gimpvectors.html#gimp-vectors-set-name">gimp_vectors_set_name</a> (gint32 vectors_ID,
const gchar *name);
gboolean <a href="libgimp-gimpvectors.html#gimp-vectors-set-tattoo">gimp_vectors_set_tattoo</a> (gint32 vectors_ID,
gint tattoo);
gboolean <a href="libgimp-gimpvectors.html#gimp-vectors-set-visible">gimp_vectors_set_visible</a> (gint32 vectors_ID,
gboolean visible);
gboolean <a href="libgimp-gimpvectors.html#gimp-vectors-remove-stroke">gimp_vectors_remove_stroke</a> (gint32 vectors_ID,
gint stroke_id);
gboolean <a href="libgimp-gimpvectors.html#gimp-vectors-to-selection">gimp_vectors_to_selection</a> (gint32 vectors_ID,
<a
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpChannelOps"
>GimpChannelOps</a> operation,
gboolean antialias,
gboolean feather,
gdouble feather_radius_x,
gdouble feather_radius_y);
gboolean <a href="libgimp-gimpvectors.html#gimp-vectors-parasite-attach">gimp_vectors_parasite_attach</a> (gint32 vectors_ID,
const <a
href="../libgimpbase/libgimpbase-gimpparasite.html#GimpParasite"
>GimpParasite</a> *parasite);
gboolean <a href="libgimp-gimpvectors.html#gimp-vectors-parasite-detach">gimp_vectors_parasite_detach</a> (gint32 vectors_ID,
const gchar *name);
<a
href="../libgimpbase/libgimpbase-gimpparasite.html#GimpParasite"
>GimpParasite</a>* <a href="libgimp-gimpvectors.html#gimp-vectors-parasite-find">gimp_vectors_parasite_find</a> (gint32 vectors_ID,
const gchar *name);
gboolean <a href="libgimp-gimpvectors.html#gimp-vectors-parasite-list">gimp_vectors_parasite_list</a> (gint32 vectors_ID,
gint *num_parasites,
gchar ***parasites);
gint <a href="libgimp-gimpvectors.html#gimp-vectors-stroke-new-from-points">gimp_vectors_stroke_new_from_points</a>
(gint32 vectors_ID,
<a
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpVectorsStrokeType"
>GimpVectorsStrokeType</a> type,
gint num_points,
const gdouble *controlpoints,
gboolean closed);
gboolean <a href="libgimp-gimpvectors.html#gimp-vectors-stroke-close">gimp_vectors_stroke_close</a> (gint32 vectors_ID,
gint stroke_id);
gdouble <a href="libgimp-gimpvectors.html#gimp-vectors-stroke-get-length">gimp_vectors_stroke_get_length</a> (gint32 vectors_ID,
gint stroke_id,
gdouble precision);
<a
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpVectorsStrokeType"
>GimpVectorsStrokeType</a> <a href="libgimp-gimpvectors.html#gimp-vectors-stroke-get-points">gimp_vectors_stroke_get_points</a>
(gint32 vectors_ID,
gint stroke_id,
gint *num_points,
gdouble **controlpoints,
gboolean *closed);
gboolean <a href="libgimp-gimpvectors.html#gimp-vectors-stroke-get-point-at-dist">gimp_vectors_stroke_get_point_at_dist</a>
(gint32 vectors_ID,
gint stroke_id,
gdouble dist,
gdouble precision,
gdouble *x_point,
gdouble *y_point,
gdouble *slope,
gboolean *valid);
gdouble* <a href="libgimp-gimpvectors.html#gimp-vectors-stroke-interpolate">gimp_vectors_stroke_interpolate</a> (gint32 vectors_ID,
gint stroke_id,
gdouble precision,
gint *num_coords,
gboolean *closed);
gboolean <a href="libgimp-gimpvectors.html#gimp-vectors-stroke-scale">gimp_vectors_stroke_scale</a> (gint32 vectors_ID,
gint stroke_id,
gdouble scale_x,
gdouble scale_y);
gboolean <a href="libgimp-gimpvectors.html#gimp-vectors-stroke-translate">gimp_vectors_stroke_translate</a> (gint32 vectors_ID,
gint stroke_id,
gint off_x,
gint off_y);
gboolean <a href="libgimp-gimpvectors.html#gimp-vectors-stroke-flip">gimp_vectors_stroke_flip</a> (gint32 vectors_ID,
gint stroke_id,
<a href="libgimp-gimpenums.html#GimpOrientationType">GimpOrientationType</a> flip_type,
gdouble axis);
gboolean <a href="libgimp-gimpvectors.html#gimp-vectors-stroke-flip-free">gimp_vectors_stroke_flip_free</a> (gint32 vectors_ID,
gint stroke_id,
gdouble x1,
gdouble y1,
gdouble x2,
gdouble y2);
gboolean <a href="libgimp-gimpvectors.html#gimp-vectors-stroke-rotate">gimp_vectors_stroke_rotate</a> (gint32 vectors_ID,
gint stroke_id,
gdouble center_x,
gdouble center_y,
gdouble angle);
gboolean <a href="libgimp-gimpvectors.html#gimp-vectors-bezier-stroke-conicto">gimp_vectors_bezier_stroke_conicto</a>
(gint32 vectors_ID,
gint stroke_id,
gdouble x0,
gdouble y0,
gdouble x1,
gdouble y1);
gboolean <a href="libgimp-gimpvectors.html#gimp-vectors-bezier-stroke-cubicto">gimp_vectors_bezier_stroke_cubicto</a>
(gint32 vectors_ID,
gint stroke_id,
gdouble x0,
gdouble y0,
gdouble x1,
gdouble y1,
gdouble x2,
gdouble y2);
gboolean <a href="libgimp-gimpvectors.html#gimp-vectors-bezier-stroke-lineto">gimp_vectors_bezier_stroke_lineto</a>
(gint32 vectors_ID,
gint stroke_id,
gdouble x0,
gdouble y0);
gint <a href="libgimp-gimpvectors.html#gimp-vectors-bezier-stroke-new-ellipse">gimp_vectors_bezier_stroke_new_ellipse</a>
(gint32 vectors_ID,
gdouble x0,
gdouble y0,
gdouble radius_x,
gdouble radius_y,
gdouble angle);
gint <a href="libgimp-gimpvectors.html#gimp-vectors-bezier-stroke-new-moveto">gimp_vectors_bezier_stroke_new_moveto</a>
(gint32 vectors_ID,
gdouble x0,
gdouble y0);
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id2675972"></a><h2>Description</h2>
<p>
</p>
</div>
<div class="refsect1" lang="en">
<a name="id2675986"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="id2675995"></a><h3>
<a name="gimp-vectors-new"></a>gimp_vectors_new ()</h3>
<a class="indexterm" name="id2676007"></a><pre class="programlisting">gint32 gimp_vectors_new (gint32 image_ID,
const gchar *name);</pre>
<p>
Creates a new empty vectors object.
</p>
<p>
Creates a new empty vectors object. Needs to be added to an image
using <a href="libgimp-gimpimage.html#gimp-image-add-vectors"><code class="function">gimp_image_add_vectors()</code></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>image_ID</code></em>&#160;:</span></td>
<td> The image.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>name</code></em>&#160;:</span></td>
<td> the name of the new vector object.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> the current vector object, 0 if no vector exists in the image.
</td>
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2676097"></a><h3>
<a name="gimp-vectors-import-from-file"></a>gimp_vectors_import_from_file ()</h3>
<a class="indexterm" name="id2676110"></a><pre class="programlisting">gboolean gimp_vectors_import_from_file (gint32 image_ID,
const gchar *filename,
gboolean merge,
gboolean scale,
gint *num_vectors,
gint32 **vectors_ids);</pre>
<p>
Import paths from an SVG file.
</p>
<p>
This procedure imports paths from an SVG file. SVG elements other
than paths and basic shapes are ignored.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>image_ID</code></em>&#160;:</span></td>
<td> The image.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>filename</code></em>&#160;:</span></td>
<td> The name of the SVG file to import.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>merge</code></em>&#160;:</span></td>
<td> Merge paths into a single vectors object.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>scale</code></em>&#160;:</span></td>
<td> Scale the SVG to image dimensions.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>num_vectors</code></em>&#160;:</span></td>
<td> The number of newly created vectors.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>vectors_ids</code></em>&#160;:</span></td>
<td> The list of newly created vectors.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> TRUE on success.
</td>
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2676267"></a><h3>
<a name="gimp-vectors-import-from-string"></a>gimp_vectors_import_from_string ()</h3>
<a class="indexterm" name="id2676281"></a><pre class="programlisting">gboolean gimp_vectors_import_from_string (gint32 image_ID,
const gchar *string,
gint length,
gboolean merge,
gboolean scale,
gint *num_vectors,
gint32 **vectors_ids);</pre>
<p>
Import paths from an SVG string.
</p>
<p>
This procedure works like <a href="libgimp-gimpvectors.html#gimp-vectors-import-from-file"><code class="function">gimp_vectors_import_from_file()</code></a> but takes
a string rather than reading the SVG from a file. This allows you to
write scripts that generate SVG and feed it to GIMP.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>image_ID</code></em>&#160;:</span></td>
<td> The image.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>string</code></em>&#160;:</span></td>
<td> A string that must be a complete and valid SVG document.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>length</code></em>&#160;:</span></td>
<td> Number of bytes in string or -1 if the string is NULL terminated.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>merge</code></em>&#160;:</span></td>
<td> Merge paths into a single vectors object.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>scale</code></em>&#160;:</span></td>
<td> Scale the SVG to image dimensions.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>num_vectors</code></em>&#160;:</span></td>
<td> The number of newly created vectors.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>vectors_ids</code></em>&#160;:</span></td>
<td> The list of newly created vectors.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> TRUE on success.
</td>
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2676475"></a><h3>
<a name="gimp-vectors-is-valid"></a>gimp_vectors_is_valid ()</h3>
<a class="indexterm" name="id2676487"></a><pre class="programlisting">gboolean gimp_vectors_is_valid (gint32 vectors_ID);</pre>
<p>
Returns TRUE if the vectors object is valid.
</p>
<p>
This procedure checks if the given vectors ID is valid and refers to
an existing vectors object.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>vectors_ID</code></em>&#160;:</span></td>
<td> The vectors object to check.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> Whether the vectors ID is valid.
</td>
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2676552"></a><h3>
<a name="gimp-vectors-get-strokes"></a>gimp_vectors_get_strokes ()</h3>
<a class="indexterm" name="id2676564"></a><pre class="programlisting">gint* gimp_vectors_get_strokes (gint32 vectors_ID,
gint *num_strokes);</pre>
<p>
List the strokes associated with the passed path.
</p>
<p>
Returns an Array with the stroke-IDs associated with the passed
path.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>vectors_ID</code></em>&#160;:</span></td>
<td> The vectors object.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>num_strokes</code></em>&#160;:</span></td>
<td> The number of strokes returned.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> List of the strokes belonging to the path.
</td>
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2676648"></a><h3>
<a name="gimp-vectors-get-image"></a>gimp_vectors_get_image ()</h3>
<a class="indexterm" name="id2676660"></a><pre class="programlisting">gint32 gimp_vectors_get_image (gint32 vectors_ID);</pre>
<p>
Returns the vectors objects image.
</p>
<p>
Returns the vectors objects image.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>vectors_ID</code></em>&#160;:</span></td>
<td> The vectors object.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> The vectors image.
</td>
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2676722"></a><h3>
<a name="gimp-vectors-get-linked"></a>gimp_vectors_get_linked ()</h3>
<a class="indexterm" name="id2676735"></a><pre class="programlisting">gboolean gimp_vectors_get_linked (gint32 vectors_ID);</pre>
<p>
Gets the linked state of the vectors object.
</p>
<p>
Gets the linked state of the vectors object.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>vectors_ID</code></em>&#160;:</span></td>
<td> The vectors object.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> TRUE if the path is linked, FALSE otherwise.
</td>
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2676798"></a><h3>
<a name="gimp-vectors-get-name"></a>gimp_vectors_get_name ()</h3>
<a class="indexterm" name="id2676810"></a><pre class="programlisting">gchar* gimp_vectors_get_name (gint32 vectors_ID);</pre>
<p>
Gets the name of the vectors object.
</p>
<p>
Gets the name of the vectors object.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>vectors_ID</code></em>&#160;:</span></td>
<td> The vectors object.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> The name of the vectors object.
</td>
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2676873"></a><h3>
<a name="gimp-vectors-get-tattoo"></a>gimp_vectors_get_tattoo ()</h3>
<a class="indexterm" name="id2676886"></a><pre class="programlisting">gint gimp_vectors_get_tattoo (gint32 vectors_ID);</pre>
<p>
Get the tattoo of the vectors object.
</p>
<p>
Get the tattoo state of the vectors object.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>vectors_ID</code></em>&#160;:</span></td>
<td> The vectors object.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> The vectors tattoo.
</td>
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2676948"></a><h3>
<a name="gimp-vectors-get-visible"></a>gimp_vectors_get_visible ()</h3>
<a class="indexterm" name="id2676961"></a><pre class="programlisting">gboolean gimp_vectors_get_visible (gint32 vectors_ID);</pre>
<p>
Gets the visibility of the vectors object.
</p>
<p>
Gets the visibility of the vectors object.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>vectors_ID</code></em>&#160;:</span></td>
<td> The vectors object.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> TRUE if the path is visible, FALSE otherwise.
</td>
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2677024"></a><h3>
<a name="gimp-vectors-set-linked"></a>gimp_vectors_set_linked ()</h3>
<a class="indexterm" name="id2677036"></a><pre class="programlisting">gboolean gimp_vectors_set_linked (gint32 vectors_ID,
gboolean linked);</pre>
<p>
Sets the linked state of the vectors object.
</p>
<p>
Sets the linked state of the vectors object.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>vectors_ID</code></em>&#160;:</span></td>
<td> The vectors object.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>linked</code></em>&#160;:</span></td>
<td> Whether the path is linked.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> TRUE on success.
</td>
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2677118"></a><h3>
<a name="gimp-vectors-set-name"></a>gimp_vectors_set_name ()</h3>
<a class="indexterm" name="id2677131"></a><pre class="programlisting">gboolean gimp_vectors_set_name (gint32 vectors_ID,
const gchar *name);</pre>
<p>
Sets the name of the vectors object.
</p>
<p>
Sets the name of the vectors object.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>vectors_ID</code></em>&#160;:</span></td>
<td> The vectors object.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>name</code></em>&#160;:</span></td>
<td> the new name of the path.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> TRUE on success.
</td>
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2677212"></a><h3>
<a name="gimp-vectors-set-tattoo"></a>gimp_vectors_set_tattoo ()</h3>
<a class="indexterm" name="id2677225"></a><pre class="programlisting">gboolean gimp_vectors_set_tattoo (gint32 vectors_ID,
gint tattoo);</pre>
<p>
Set the tattoo of the vectors object.
</p>
<p>
Set the tattoo of the vectors object.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>vectors_ID</code></em>&#160;:</span></td>
<td> The vectors object.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>tattoo</code></em>&#160;:</span></td>
<td> the new tattoo.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> TRUE on success.
</td>
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2677306"></a><h3>
<a name="gimp-vectors-set-visible"></a>gimp_vectors_set_visible ()</h3>
<a class="indexterm" name="id2677318"></a><pre class="programlisting">gboolean gimp_vectors_set_visible (gint32 vectors_ID,
gboolean visible);</pre>
<p>
Sets the visibility of the vectors object.
</p>
<p>
Sets the visibility of the vectors object.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>vectors_ID</code></em>&#160;:</span></td>
<td> The vectors object.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>visible</code></em>&#160;:</span></td>
<td> Whether the path is visible.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> TRUE on success.
</td>
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2677400"></a><h3>
<a name="gimp-vectors-remove-stroke"></a>gimp_vectors_remove_stroke ()</h3>
<a class="indexterm" name="id2677413"></a><pre class="programlisting">gboolean gimp_vectors_remove_stroke (gint32 vectors_ID,
gint stroke_id);</pre>
<p>
remove the stroke from a vectors object.
</p>
<p>
Remove the stroke from a vectors object.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>vectors_ID</code></em>&#160;:</span></td>
<td> The vectors object.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>stroke_id</code></em>&#160;:</span></td>
<td> The stroke ID.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> TRUE on success.
</td>
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2677494"></a><h3>
<a name="gimp-vectors-to-selection"></a>gimp_vectors_to_selection ()</h3>
<a class="indexterm" name="id2677508"></a><pre class="programlisting">gboolean gimp_vectors_to_selection (gint32 vectors_ID,
<a
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpChannelOps"
>GimpChannelOps</a> operation,
gboolean antialias,
gboolean feather,
gdouble feather_radius_x,
gdouble feather_radius_y);</pre>
<p>
Transforms the specified vectors object into a selection
</p>
<p>
This procedure renders the desired vectors object into the current
selection of the image the vectors object belongs to.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>vectors_ID</code></em>&#160;:</span></td>
<td> The vectors object to render to the selection.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>operation</code></em>&#160;:</span></td>
<td> The desired operation with current selection.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>antialias</code></em>&#160;:</span></td>
<td> Antialias selection.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>feather</code></em>&#160;:</span></td>
<td> Feather selection.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>feather_radius_x</code></em>&#160;:</span></td>
<td> Feather radius x.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>feather_radius_y</code></em>&#160;:</span></td>
<td> Feather radius y.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> TRUE on success.
</td>
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2677668"></a><h3>
<a name="gimp-vectors-parasite-attach"></a>gimp_vectors_parasite_attach ()</h3>
<a class="indexterm" name="id2677682"></a><pre class="programlisting">gboolean gimp_vectors_parasite_attach (gint32 vectors_ID,
const <a
href="../libgimpbase/libgimpbase-gimpparasite.html#GimpParasite"
>GimpParasite</a> *parasite);</pre>
<p>
Add a parasite to a vectors object
</p>
<p>
This procedure attaches a parasite to a vectors object. It has no
return values.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>vectors_ID</code></em>&#160;:</span></td>
<td> The vectors object.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>parasite</code></em>&#160;:</span></td>
<td> The parasite to attach to a vectors object.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> TRUE on success.
</td>
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2677766"></a><h3>
<a name="gimp-vectors-parasite-detach"></a>gimp_vectors_parasite_detach ()</h3>
<a class="indexterm" name="id2677780"></a><pre class="programlisting">gboolean gimp_vectors_parasite_detach (gint32 vectors_ID,
const gchar *name);</pre>
<p>
Removes a parasite from a vectors object
</p>
<p>
This procedure detaches a parasite from a vectors object. It has no
return values.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>vectors_ID</code></em>&#160;:</span></td>
<td> The vectors object.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>name</code></em>&#160;:</span></td>
<td> The name of the parasite to detach from a vectors object.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> TRUE on success.
</td>
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2677864"></a><h3>
<a name="gimp-vectors-parasite-find"></a>gimp_vectors_parasite_find ()</h3>
<a class="indexterm" name="id2677877"></a><pre class="programlisting"><a
href="../libgimpbase/libgimpbase-gimpparasite.html#GimpParasite"
>GimpParasite</a>* gimp_vectors_parasite_find (gint32 vectors_ID,
const gchar *name);</pre>
<p>
Look up a parasite in a vectors object
</p>
<p>
Finds and returns the parasite that was previously attached to a
vectors object.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>vectors_ID</code></em>&#160;:</span></td>
<td> The vectors object.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>name</code></em>&#160;:</span></td>
<td> The name of the parasite to find.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> The found parasite.
</td>
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2677960"></a><h3>
<a name="gimp-vectors-parasite-list"></a>gimp_vectors_parasite_list ()</h3>
<a class="indexterm" name="id2677973"></a><pre class="programlisting">gboolean gimp_vectors_parasite_list (gint32 vectors_ID,
gint *num_parasites,
gchar ***parasites);</pre>
<p>
List all parasites.
</p>
<p>
Returns a list of all currently attached parasites.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>vectors_ID</code></em>&#160;:</span></td>
<td> The vectors object.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>num_parasites</code></em>&#160;:</span></td>
<td> The number of attached parasites.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>parasites</code></em>&#160;:</span></td>
<td> The names of currently attached parasites.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> TRUE on success.
</td>
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2678074"></a><h3>
<a name="gimp-vectors-stroke-new-from-points"></a>gimp_vectors_stroke_new_from_points ()</h3>
<a class="indexterm" name="id2678089"></a><pre class="programlisting">gint gimp_vectors_stroke_new_from_points
(gint32 vectors_ID,
<a
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpVectorsStrokeType"
>GimpVectorsStrokeType</a> type,
gint num_points,
const gdouble *controlpoints,
gboolean closed);</pre>
<p>
Adds a stroke of a given type to the vectors object.
</p>
<p>
Adds a stroke of a given type to the vectors object. The coordinates
of the control points can be specified. For now only strokes of the
type GIMP_VECTORS_STROKE_TYPE_BEZIER are supported. The control
points are specified as a pair of float values for the x- and
y-coordinate. The Bezier stroke type needs a multiple of three
control points. Each Bezier segment endpoint (anchor, A) has two
additional control points (C) associated. They are specified in the
order CACCACCAC...</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>vectors_ID</code></em>&#160;:</span></td>
<td> The vectors object.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>type</code></em>&#160;:</span></td>
<td> type of the stroke (always GIMP_VECTORS_STROKE_TYPE_BEZIER for now).
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>num_points</code></em>&#160;:</span></td>
<td> The number of elements in the array, i.e. the number of controlpoints in the stroke * 2 (x- and y-coordinate).
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>controlpoints</code></em>&#160;:</span></td>
<td> List of the x- and y-coordinates of the control points.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>closed</code></em>&#160;:</span></td>
<td> Whether the stroke is to be closed or not.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> The stroke ID of the newly created stroke.
</td>
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2678252"></a><h3>
<a name="gimp-vectors-stroke-close"></a>gimp_vectors_stroke_close ()</h3>
<a class="indexterm" name="id2678269"></a><pre class="programlisting">gboolean gimp_vectors_stroke_close (gint32 vectors_ID,
gint stroke_id);</pre>
<p>
closes the specified stroke.
</p>
<p>
Closes the specified stroke.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>vectors_ID</code></em>&#160;:</span></td>
<td> The vectors object.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>stroke_id</code></em>&#160;:</span></td>
<td> The stroke ID.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> TRUE on success.
</td>
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2678360"></a><h3>
<a name="gimp-vectors-stroke-get-length"></a>gimp_vectors_stroke_get_length ()</h3>
<a class="indexterm" name="id2678376"></a><pre class="programlisting">gdouble gimp_vectors_stroke_get_length (gint32 vectors_ID,
gint stroke_id,
gdouble precision);</pre>
<p>
Measure the length of the given stroke.
</p>
<p>
Measure the length of the given stroke.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>vectors_ID</code></em>&#160;:</span></td>
<td> The vectors object.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>stroke_id</code></em>&#160;:</span></td>
<td> The stroke ID.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>precision</code></em>&#160;:</span></td>
<td> The precision used for the approximation.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> The length (in pixels) of the given stroke.
</td>
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2678490"></a><h3>
<a name="gimp-vectors-stroke-get-points"></a>gimp_vectors_stroke_get_points ()</h3>
<a class="indexterm" name="id2678507"></a><pre class="programlisting"><a
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpVectorsStrokeType"
>GimpVectorsStrokeType</a> gimp_vectors_stroke_get_points
(gint32 vectors_ID,
gint stroke_id,
gint *num_points,
gdouble **controlpoints,
gboolean *closed);</pre>
<p>
returns the control points of a stroke.
</p>
<p>
returns the control points of a stroke. The interpretation of the
coordinates returned depends on the type of the stroke. For Gimp 2.4
this is always a bezier stroke, where the coordinates are the
control points.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>vectors_ID</code></em>&#160;:</span></td>
<td> The vectors object.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>stroke_id</code></em>&#160;:</span></td>
<td> The stroke ID.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>num_points</code></em>&#160;:</span></td>
<td> The number of floats returned.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>controlpoints</code></em>&#160;:</span></td>
<td> List of the control points for the stroke (x0, y0, x1, y1, ...).
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>closed</code></em>&#160;:</span></td>
<td> Whether the stroke is closed or not.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> type of the stroke (always GIMP_VECTORS_STROKE_TYPE_BEZIER for now).
</td>
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2678669"></a><h3>
<a name="gimp-vectors-stroke-get-point-at-dist"></a>gimp_vectors_stroke_get_point_at_dist ()</h3>
<a class="indexterm" name="id2678686"></a><pre class="programlisting">gboolean gimp_vectors_stroke_get_point_at_dist
(gint32 vectors_ID,
gint stroke_id,
gdouble dist,
gdouble precision,
gdouble *x_point,
gdouble *y_point,
gdouble *slope,
gboolean *valid);</pre>
<p>
Get point at a specified distance along the stroke.
</p>
<p>
This will return the x,y position of a point at a given distance
along the stroke. The distance will be obtained by first digitizing
the curve internally and then walking along the curve. For a closed
stroke the start of the path is the first point on the path that was
created. This might not be obvious. If the stroke is not long
enough, a \"valid\" flag will be FALSE.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>vectors_ID</code></em>&#160;:</span></td>
<td> The vectors object.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>stroke_id</code></em>&#160;:</span></td>
<td> The stroke ID.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>dist</code></em>&#160;:</span></td>
<td> The given distance.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>precision</code></em>&#160;:</span></td>
<td> The precision used for the approximation.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>x_point</code></em>&#160;:</span></td>
<td> The x position of the point.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>y_point</code></em>&#160;:</span></td>
<td> The y position of the point.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>slope</code></em>&#160;:</span></td>
<td> The slope (dy / dx) at the specified point.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>valid</code></em>&#160;:</span></td>
<td> Indicator for the validity of the returned data.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> TRUE on success.
</td>
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2678914"></a><h3>
<a name="gimp-vectors-stroke-interpolate"></a>gimp_vectors_stroke_interpolate ()</h3>
<a class="indexterm" name="id2678931"></a><pre class="programlisting">gdouble* gimp_vectors_stroke_interpolate (gint32 vectors_ID,
gint stroke_id,
gdouble precision,
gint *num_coords,
gboolean *closed);</pre>
<p>
returns polygonal approximation of the stroke.
</p>
<p>
returns polygonal approximation of the stroke.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>vectors_ID</code></em>&#160;:</span></td>
<td> The vectors object.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>stroke_id</code></em>&#160;:</span></td>
<td> The stroke ID.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>precision</code></em>&#160;:</span></td>
<td> The precision used for the approximation.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>num_coords</code></em>&#160;:</span></td>
<td> The number of floats returned.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>closed</code></em>&#160;:</span></td>
<td> Whether the stroke is closed or not.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> List of the coords along the path (x0, y0, x1, y1, ...).
</td>
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2679088"></a><h3>
<a name="gimp-vectors-stroke-scale"></a>gimp_vectors_stroke_scale ()</h3>
<a class="indexterm" name="id2679105"></a><pre class="programlisting">gboolean gimp_vectors_stroke_scale (gint32 vectors_ID,
gint stroke_id,
gdouble scale_x,
gdouble scale_y);</pre>
<p>
scales the given stroke.
</p>
<p>
Scale the given stroke.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>vectors_ID</code></em>&#160;:</span></td>
<td> The vectors object.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>stroke_id</code></em>&#160;:</span></td>
<td> The stroke ID.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>scale_x</code></em>&#160;:</span></td>
<td> Scale factor in x direction.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>scale_y</code></em>&#160;:</span></td>
<td> Scale factor in y direction.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> TRUE on success.
</td>
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2679238"></a><h3>
<a name="gimp-vectors-stroke-translate"></a>gimp_vectors_stroke_translate ()</h3>
<a class="indexterm" name="id2679255"></a><pre class="programlisting">gboolean gimp_vectors_stroke_translate (gint32 vectors_ID,
gint stroke_id,
gint off_x,
gint off_y);</pre>
<p>
translate the given stroke.
</p>
<p>
Translate the given stroke.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>vectors_ID</code></em>&#160;:</span></td>
<td> The vectors object.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>stroke_id</code></em>&#160;:</span></td>
<td> The stroke ID.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>off_x</code></em>&#160;:</span></td>
<td> Offset in x direction.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>off_y</code></em>&#160;:</span></td>
<td> Offset in y direction.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> TRUE on success.
</td>
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2679389"></a><h3>
<a name="gimp-vectors-stroke-flip"></a>gimp_vectors_stroke_flip ()</h3>
<a class="indexterm" name="id2679405"></a><pre class="programlisting">gboolean gimp_vectors_stroke_flip (gint32 vectors_ID,
gint stroke_id,
<a href="libgimp-gimpenums.html#GimpOrientationType">GimpOrientationType</a> flip_type,
gdouble axis);</pre>
<p>
flips the given stroke.
</p>
<p>
Rotates the given stroke around given center by angle (in degrees).</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>vectors_ID</code></em>&#160;:</span></td>
<td> The vectors object.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>stroke_id</code></em>&#160;:</span></td>
<td> The stroke ID.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>flip_type</code></em>&#160;:</span></td>
<td> Flip orientation, either vertical or horizontal.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>axis</code></em>&#160;:</span></td>
<td> axis coordinate about which to flip, in pixels.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> TRUE on success.
</td>
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2679541"></a><h3>
<a name="gimp-vectors-stroke-flip-free"></a>gimp_vectors_stroke_flip_free ()</h3>
<a class="indexterm" name="id2679558"></a><pre class="programlisting">gboolean gimp_vectors_stroke_flip_free (gint32 vectors_ID,
gint stroke_id,
gdouble x1,
gdouble y1,
gdouble x2,
gdouble y2);</pre>
<p>
flips the given stroke about an arbitrary axis.
</p>
<p>
Flips the given stroke about an arbitrary axis. Axis is defined by
two coordinates in the image (in pixels), through which the flipping
axis passes.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>vectors_ID</code></em>&#160;:</span></td>
<td> The vectors object.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>stroke_id</code></em>&#160;:</span></td>
<td> The stroke ID.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>x1</code></em>&#160;:</span></td>
<td> X coordinate of the first point of the flipping axis.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>y1</code></em>&#160;:</span></td>
<td> Y coordinate of the first point of the flipping axis.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>x2</code></em>&#160;:</span></td>
<td> X coordinate of the second point of the flipping axis.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>y2</code></em>&#160;:</span></td>
<td> Y coordinate of the second point of the flipping axis.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> TRUE on success.
</td>
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2679738"></a><h3>
<a name="gimp-vectors-stroke-rotate"></a>gimp_vectors_stroke_rotate ()</h3>
<a class="indexterm" name="id2679755"></a><pre class="programlisting">gboolean gimp_vectors_stroke_rotate (gint32 vectors_ID,
gint stroke_id,
gdouble center_x,
gdouble center_y,
gdouble angle);</pre>
<p>
rotates the given stroke.
</p>
<p>
Rotates the given stroke around given center by angle (in degrees).</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>vectors_ID</code></em>&#160;:</span></td>
<td> The vectors object.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>stroke_id</code></em>&#160;:</span></td>
<td> The stroke ID.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>center_x</code></em>&#160;:</span></td>
<td> X coordinate of the rotation center.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>center_y</code></em>&#160;:</span></td>
<td> Y coordinate of the rotation center.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>angle</code></em>&#160;:</span></td>
<td> angle to rotate about.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> TRUE on success.
</td>
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2679911"></a><h3>
<a name="gimp-vectors-bezier-stroke-conicto"></a>gimp_vectors_bezier_stroke_conicto ()</h3>
<a class="indexterm" name="id2679929"></a><pre class="programlisting">gboolean gimp_vectors_bezier_stroke_conicto
(gint32 vectors_ID,
gint stroke_id,
gdouble x0,
gdouble y0,
gdouble x1,
gdouble y1);</pre>
<p>
Extends a bezier stroke with a conic bezier spline.
</p>
<p>
Extends a bezier stroke with a conic bezier spline. Actually a cubic
bezier spline gets added that realizes the shape of a conic bezier
spline.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>vectors_ID</code></em>&#160;:</span></td>
<td> The vectors object.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>stroke_id</code></em>&#160;:</span></td>
<td> The stroke ID.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>x0</code></em>&#160;:</span></td>
<td> The x-coordinate of the control point.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>y0</code></em>&#160;:</span></td>
<td> The y-coordinate of the control point.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>x1</code></em>&#160;:</span></td>
<td> The x-coordinate of the end point.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>y1</code></em>&#160;:</span></td>
<td> The y-coordinate of the end point.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> TRUE on success.
</td>
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2680109"></a><h3>
<a name="gimp-vectors-bezier-stroke-cubicto"></a>gimp_vectors_bezier_stroke_cubicto ()</h3>
<a class="indexterm" name="id2680126"></a><pre class="programlisting">gboolean gimp_vectors_bezier_stroke_cubicto
(gint32 vectors_ID,
gint stroke_id,
gdouble x0,
gdouble y0,
gdouble x1,
gdouble y1,
gdouble x2,
gdouble y2);</pre>
<p>
Extends a bezier stroke with a cubic bezier spline.
</p>
<p>
Extends a bezier stroke with a cubic bezier spline.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>vectors_ID</code></em>&#160;:</span></td>
<td> The vectors object.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>stroke_id</code></em>&#160;:</span></td>
<td> The stroke ID.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>x0</code></em>&#160;:</span></td>
<td> The x-coordinate of the first control point.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>y0</code></em>&#160;:</span></td>
<td> The y-coordinate of the first control point.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>x1</code></em>&#160;:</span></td>
<td> The x-coordinate of the second control point.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>y1</code></em>&#160;:</span></td>
<td> The y-coordinate of the second control point.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>x2</code></em>&#160;:</span></td>
<td> The x-coordinate of the end point.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>y2</code></em>&#160;:</span></td>
<td> The y-coordinate of the end point.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> TRUE on success.
</td>
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2680348"></a><h3>
<a name="gimp-vectors-bezier-stroke-lineto"></a>gimp_vectors_bezier_stroke_lineto ()</h3>
<a class="indexterm" name="id2680365"></a><pre class="programlisting">gboolean gimp_vectors_bezier_stroke_lineto
(gint32 vectors_ID,
gint stroke_id,
gdouble x0,
gdouble y0);</pre>
<p>
Extends a bezier stroke with a lineto.
</p>
<p>
Extends a bezier stroke with a lineto.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>vectors_ID</code></em>&#160;:</span></td>
<td> The vectors object.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>stroke_id</code></em>&#160;:</span></td>
<td> The stroke ID.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>x0</code></em>&#160;:</span></td>
<td> The x-coordinate of the lineto.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>y0</code></em>&#160;:</span></td>
<td> The y-coordinate of the lineto.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> TRUE on success.
</td>
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2680500"></a><h3>
<a name="gimp-vectors-bezier-stroke-new-ellipse"></a>gimp_vectors_bezier_stroke_new_ellipse ()</h3>
<a class="indexterm" name="id2680516"></a><pre class="programlisting">gint gimp_vectors_bezier_stroke_new_ellipse
(gint32 vectors_ID,
gdouble x0,
gdouble y0,
gdouble radius_x,
gdouble radius_y,
gdouble angle);</pre>
<p>
Adds a bezier stroke describing an ellipse the vectors object.
</p>
<p>
Adds a bezier stroke describing an ellipse the vectors object.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>vectors_ID</code></em>&#160;:</span></td>
<td> The vectors object.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>x0</code></em>&#160;:</span></td>
<td> The x-coordinate of the center.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>y0</code></em>&#160;:</span></td>
<td> The y-coordinate of the center.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>radius_x</code></em>&#160;:</span></td>
<td> The radius in x direction.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>radius_y</code></em>&#160;:</span></td>
<td> The radius in y direction.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>angle</code></em>&#160;:</span></td>
<td> The angle the x-axis of the ellipse (radians, counterclockwise).
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> The resulting stroke.
</td>
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2680697"></a><h3>
<a name="gimp-vectors-bezier-stroke-new-moveto"></a>gimp_vectors_bezier_stroke_new_moveto ()</h3>
<a class="indexterm" name="id2680714"></a><pre class="programlisting">gint gimp_vectors_bezier_stroke_new_moveto
(gint32 vectors_ID,
gdouble x0,
gdouble y0);</pre>
<p>
Adds a bezier stroke with a single moveto to the vectors object.
</p>
<p>
Adds a bezier stroke with a single moveto to the vectors object.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>vectors_ID</code></em>&#160;:</span></td>
<td> The vectors object.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>x0</code></em>&#160;:</span></td>
<td> The x-coordinate of the moveto.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>y0</code></em>&#160;:</span></td>
<td> The y-coordinate of the moveto.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> The resulting stroke.
</td>
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.4
</p>
</div>
</div>
</div>
</body>
</html>