685 lines
64 KiB
HTML
685 lines
64 KiB
HTML
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>gimpdrawabletransform</title><meta name="generator" content="DocBook XSL Stylesheets V1.68.1"><link rel="start" href="index.html" title="GIMP Library Reference Manual"><link rel="up" href="libgimp-image.html" title="Manupulating Images and all their Properties"><link rel="prev" href="libgimp-gimpdrawable.html" title="gimpdrawable"><link rel="next" href="libgimp-gimpedit.html" title="gimpedit"><meta name="generator" content="GTK-Doc V1.3 (XML mode)"><link rel="stylesheet" href="style.css" type="text/css"><link rel="part" href="gimpdefinitions.html" title="Part I. GIMP Constants"><link rel="part" href="libgimp.html" title="Part II. 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 all 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 III. GIMP User Interface Library"><link rel="chapter" href="libgimpui-hierarchy.html" title="Object Hierarchy"></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="libgimp-gimpdrawable.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-gimpedit.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry" lang="en"><a name="libgimp-gimpdrawabletransform"></a><div class="titlepage"></div><div class="refnamediv"><table width="100%"><tr><td valign="top"><h2><span class="refentrytitle">gimpdrawabletransform</span></h2><p>gimpdrawabletransform — </p></td><td valign="top" align="right"></td></tr></table></div><div class="refsynopsisdiv"><h2>Synopsis</h2><pre class="synopsis">
|
||
|
||
|
||
|
||
gint32 <a href="libgimp-gimpdrawabletransform.html#gimp-drawable-transform-flip-simple">gimp_drawable_transform_flip_simple</a>
|
||
(gint32 drawable_ID,
|
||
<a href="libgimp-gimpenums.html#GimpOrientationType">GimpOrientationType</a> flip_type,
|
||
gboolean auto_center,
|
||
gdouble axis,
|
||
gboolean clip_result);
|
||
gint32 <a href="libgimp-gimpdrawabletransform.html#gimp-drawable-transform-flip">gimp_drawable_transform_flip</a> (gint32 drawable_ID,
|
||
gdouble x0,
|
||
gdouble y0,
|
||
gdouble x1,
|
||
gdouble y1,
|
||
<a href="libgimp-gimpenums.html#GimpTransformDirection">GimpTransformDirection</a> transform_direction,
|
||
<a href="libgimp-gimpenums.html#GimpInterpolationType">GimpInterpolationType</a> interpolation,
|
||
gboolean supersample,
|
||
gint recursion_level,
|
||
gboolean clip_result);
|
||
gint32 <a href="libgimp-gimpdrawabletransform.html#gimp-drawable-transform-flip-default">gimp_drawable_transform_flip_default</a>
|
||
(gint32 drawable_ID,
|
||
gdouble x0,
|
||
gdouble y0,
|
||
gdouble x1,
|
||
gdouble y1,
|
||
gboolean interpolate,
|
||
gboolean clip_result);
|
||
gint32 <a href="libgimp-gimpdrawabletransform.html#gimp-drawable-transform-perspective">gimp_drawable_transform_perspective</a>
|
||
(gint32 drawable_ID,
|
||
gdouble x0,
|
||
gdouble y0,
|
||
gdouble x1,
|
||
gdouble y1,
|
||
gdouble x2,
|
||
gdouble y2,
|
||
gdouble x3,
|
||
gdouble y3,
|
||
<a href="libgimp-gimpenums.html#GimpTransformDirection">GimpTransformDirection</a> transform_direction,
|
||
<a href="libgimp-gimpenums.html#GimpInterpolationType">GimpInterpolationType</a> interpolation,
|
||
gboolean supersample,
|
||
gint recursion_level,
|
||
gboolean clip_result);
|
||
gint32 <a href="libgimp-gimpdrawabletransform.html#gimp-drawable-transform-perspective-default">gimp_drawable_transform_perspective_default</a>
|
||
(gint32 drawable_ID,
|
||
gdouble x0,
|
||
gdouble y0,
|
||
gdouble x1,
|
||
gdouble y1,
|
||
gdouble x2,
|
||
gdouble y2,
|
||
gdouble x3,
|
||
gdouble y3,
|
||
gboolean interpolate,
|
||
gboolean clip_result);
|
||
gint32 <a href="libgimp-gimpdrawabletransform.html#gimp-drawable-transform-rotate-simple">gimp_drawable_transform_rotate_simple</a>
|
||
(gint32 drawable_ID,
|
||
<a href="libgimp-gimpenums.html#GimpRotationType">GimpRotationType</a> rotate_type,
|
||
gboolean auto_center,
|
||
gint center_x,
|
||
gint center_y,
|
||
gboolean clip_result);
|
||
gint32 <a href="libgimp-gimpdrawabletransform.html#gimp-drawable-transform-rotate">gimp_drawable_transform_rotate</a> (gint32 drawable_ID,
|
||
gdouble angle,
|
||
gboolean auto_center,
|
||
gint center_x,
|
||
gint center_y,
|
||
<a href="libgimp-gimpenums.html#GimpTransformDirection">GimpTransformDirection</a> transform_direction,
|
||
<a href="libgimp-gimpenums.html#GimpInterpolationType">GimpInterpolationType</a> interpolation,
|
||
gboolean supersample,
|
||
gint recursion_level,
|
||
gboolean clip_result);
|
||
gint32 <a href="libgimp-gimpdrawabletransform.html#gimp-drawable-transform-rotate-default">gimp_drawable_transform_rotate_default</a>
|
||
(gint32 drawable_ID,
|
||
gdouble angle,
|
||
gboolean auto_center,
|
||
gint center_x,
|
||
gint center_y,
|
||
gboolean interpolate,
|
||
gboolean clip_result);
|
||
gint32 <a href="libgimp-gimpdrawabletransform.html#gimp-drawable-transform-scale">gimp_drawable_transform_scale</a> (gint32 drawable_ID,
|
||
gdouble x0,
|
||
gdouble y0,
|
||
gdouble x1,
|
||
gdouble y1,
|
||
<a href="libgimp-gimpenums.html#GimpTransformDirection">GimpTransformDirection</a> transform_direction,
|
||
<a href="libgimp-gimpenums.html#GimpInterpolationType">GimpInterpolationType</a> interpolation,
|
||
gboolean supersample,
|
||
gint recursion_level,
|
||
gboolean clip_result);
|
||
gint32 <a href="libgimp-gimpdrawabletransform.html#gimp-drawable-transform-scale-default">gimp_drawable_transform_scale_default</a>
|
||
(gint32 drawable_ID,
|
||
gdouble x0,
|
||
gdouble y0,
|
||
gdouble x1,
|
||
gdouble y1,
|
||
gboolean interpolate,
|
||
gboolean clip_result);
|
||
gint32 <a href="libgimp-gimpdrawabletransform.html#gimp-drawable-transform-shear">gimp_drawable_transform_shear</a> (gint32 drawable_ID,
|
||
<a href="libgimp-gimpenums.html#GimpOrientationType">GimpOrientationType</a> shear_type,
|
||
gdouble magnitude,
|
||
<a href="libgimp-gimpenums.html#GimpTransformDirection">GimpTransformDirection</a> transform_direction,
|
||
<a href="libgimp-gimpenums.html#GimpInterpolationType">GimpInterpolationType</a> interpolation,
|
||
gboolean supersample,
|
||
gint recursion_level,
|
||
gboolean clip_result);
|
||
gint32 <a href="libgimp-gimpdrawabletransform.html#gimp-drawable-transform-shear-default">gimp_drawable_transform_shear_default</a>
|
||
(gint32 drawable_ID,
|
||
<a href="libgimp-gimpenums.html#GimpOrientationType">GimpOrientationType</a> shear_type,
|
||
gdouble magnitude,
|
||
gboolean interpolate,
|
||
gboolean clip_result);
|
||
gint32 <a href="libgimp-gimpdrawabletransform.html#gimp-drawable-transform-2d">gimp_drawable_transform_2d</a> (gint32 drawable_ID,
|
||
gdouble source_x,
|
||
gdouble source_y,
|
||
gdouble scale_x,
|
||
gdouble scale_y,
|
||
gdouble angle,
|
||
gdouble dest_x,
|
||
gdouble dest_y,
|
||
<a href="libgimp-gimpenums.html#GimpTransformDirection">GimpTransformDirection</a> transform_direction,
|
||
<a href="libgimp-gimpenums.html#GimpInterpolationType">GimpInterpolationType</a> interpolation,
|
||
gboolean supersample,
|
||
gint recursion_level,
|
||
gboolean clip_result);
|
||
gint32 <a href="libgimp-gimpdrawabletransform.html#gimp-drawable-transform-2d-default">gimp_drawable_transform_2d_default</a>
|
||
(gint32 drawable_ID,
|
||
gdouble source_x,
|
||
gdouble source_y,
|
||
gdouble scale_x,
|
||
gdouble scale_y,
|
||
gdouble angle,
|
||
gdouble dest_x,
|
||
gdouble dest_y,
|
||
gboolean interpolate,
|
||
gboolean clip_result);
|
||
gint32 <a href="libgimp-gimpdrawabletransform.html#gimp-drawable-transform-matrix">gimp_drawable_transform_matrix</a> (gint32 drawable_ID,
|
||
gdouble coeff_0_0,
|
||
gdouble coeff_0_1,
|
||
gdouble coeff_0_2,
|
||
gdouble coeff_1_0,
|
||
gdouble coeff_1_1,
|
||
gdouble coeff_1_2,
|
||
gdouble coeff_2_0,
|
||
gdouble coeff_2_1,
|
||
gdouble coeff_2_2,
|
||
<a href="libgimp-gimpenums.html#GimpTransformDirection">GimpTransformDirection</a> transform_direction,
|
||
<a href="libgimp-gimpenums.html#GimpInterpolationType">GimpInterpolationType</a> interpolation,
|
||
gboolean supersample,
|
||
gint recursion_level,
|
||
gboolean clip_result);
|
||
gint32 <a href="libgimp-gimpdrawabletransform.html#gimp-drawable-transform-matrix-default">gimp_drawable_transform_matrix_default</a>
|
||
(gint32 drawable_ID,
|
||
gdouble coeff_0_0,
|
||
gdouble coeff_0_1,
|
||
gdouble coeff_0_2,
|
||
gdouble coeff_1_0,
|
||
gdouble coeff_1_1,
|
||
gdouble coeff_1_2,
|
||
gdouble coeff_2_0,
|
||
gdouble coeff_2_1,
|
||
gdouble coeff_2_2,
|
||
gboolean interpolate,
|
||
gboolean clip_result);
|
||
</pre></div><div class="refsect1" lang="en"><a name="id2612409"></a><h2>Description</h2><p>
|
||
|
||
</p></div><div class="refsect1" lang="en"><a name="id2612419"></a><h2>Details</h2><div class="refsect2" lang="en"><a name="id2612424"></a><h3><a name="gimp-drawable-transform-flip-simple"></a>gimp_drawable_transform_flip_simple ()</h3><a class="indexterm" name="id2612432"></a><pre class="programlisting">gint32 gimp_drawable_transform_flip_simple
|
||
(gint32 drawable_ID,
|
||
<a href="libgimp-gimpenums.html#GimpOrientationType">GimpOrientationType</a> flip_type,
|
||
gboolean auto_center,
|
||
gdouble axis,
|
||
gboolean clip_result);</pre><p>
|
||
Flip the specified drawable either vertically or horizontally.
|
||
</p><p>
|
||
This procedure flips the specified drawable if no selection exists.
|
||
If a selection exists, the portion of the drawable which lies under
|
||
the selection is cut from the drawable and made into a floating
|
||
selection which is then flipped. If auto_center is set to true, the
|
||
flip is around the selection's center. Otherwise, the coordinate of
|
||
the axis needs to be specified. The return value is the ID of the
|
||
flipped drawable. If there was no selection, this will be equal to
|
||
the drawable ID supplied as input. Otherwise, this will be the newly
|
||
created and flipped drawable.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>drawable_ID</code></em> :</span></td><td> The affected drawable.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>flip_type</code></em> :</span></td><td> Type of flip.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>auto_center</code></em> :</span></td><td> Whether to automatically position the axis in the selection center.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>axis</code></em> :</span></td><td> coord. of flip axis.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>clip_result</code></em> :</span></td><td> Whether to clip results.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> The flipped drawable.
|
||
|
||
</td></tr></tbody></table></div><p>Since GIMP 2.2
|
||
</p></div><hr><div class="refsect2" lang="en"><a name="id2612568"></a><h3><a name="gimp-drawable-transform-flip"></a>gimp_drawable_transform_flip ()</h3><a class="indexterm" name="id2612576"></a><pre class="programlisting">gint32 gimp_drawable_transform_flip (gint32 drawable_ID,
|
||
gdouble x0,
|
||
gdouble y0,
|
||
gdouble x1,
|
||
gdouble y1,
|
||
<a href="libgimp-gimpenums.html#GimpTransformDirection">GimpTransformDirection</a> transform_direction,
|
||
<a href="libgimp-gimpenums.html#GimpInterpolationType">GimpInterpolationType</a> interpolation,
|
||
gboolean supersample,
|
||
gint recursion_level,
|
||
gboolean clip_result);</pre><p>
|
||
Flip the specified drawable around a given line.
|
||
</p><p>
|
||
This procedure flips the specified drawable if no selection exists.
|
||
If a selection exists, the portion of the drawable which lies under
|
||
the selection is cut from the drawable and made into a floating
|
||
selection which is then flipped. The axis to flip around is
|
||
specified by specifying two points from that line. The return value
|
||
is the ID of the flipped drawable. If there was no selection, this
|
||
will be equal to the drawable ID supplied as input. Otherwise, this
|
||
will be the newly created and flipped drawable. The clip results
|
||
parameter specifies wheter current selection will affect the
|
||
transform.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>drawable_ID</code></em> :</span></td><td> The affected drawable.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>x0</code></em> :</span></td><td> horz. coord. of one end of axis.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>y0</code></em> :</span></td><td> vert. coord. of one end of axis.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>x1</code></em> :</span></td><td> horz. coord. of other end of axis.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>y1</code></em> :</span></td><td> vert. coord. of other end of axis.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>transform_direction</code></em> :</span></td><td> Direction of Transformation.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>interpolation</code></em> :</span></td><td> Type of interpolation.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>supersample</code></em> :</span></td><td> Whether to perform supersample.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>recursion_level</code></em> :</span></td><td> Level of recursion (3 is a nice default).
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>clip_result</code></em> :</span></td><td> Whether to clip results.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> The flipped drawable.
|
||
|
||
</td></tr></tbody></table></div><p>Since GIMP 2.2
|
||
</p></div><hr><div class="refsect2" lang="en"><a name="id2612793"></a><h3><a name="gimp-drawable-transform-flip-default"></a>gimp_drawable_transform_flip_default ()</h3><a class="indexterm" name="id2612802"></a><pre class="programlisting">gint32 gimp_drawable_transform_flip_default
|
||
(gint32 drawable_ID,
|
||
gdouble x0,
|
||
gdouble y0,
|
||
gdouble x1,
|
||
gdouble y1,
|
||
gboolean interpolate,
|
||
gboolean clip_result);</pre><p>
|
||
Flip the specified drawable around a given line.
|
||
</p><p>
|
||
This procedure is a variant of <a href="libgimp-gimpdrawabletransform.html#gimp-drawable-transform-flip"><code class="function">gimp_drawable_transform_flip()</code></a> which
|
||
uses no interpolation/supersampling at all, or default values
|
||
(depending on the 'interpolate' parameter).</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>drawable_ID</code></em> :</span></td><td> The affected drawable.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>x0</code></em> :</span></td><td> horz. coord. of one end of axis.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>y0</code></em> :</span></td><td> vert. coord. of one end of axis.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>x1</code></em> :</span></td><td> horz. coord. of other end of axis.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>y1</code></em> :</span></td><td> vert. coord. of other end of axis.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>interpolate</code></em> :</span></td><td> Whether to use interpolation and supersampling.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>clip_result</code></em> :</span></td><td> Whether to clip results.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> The flipped drawable.
|
||
|
||
</td></tr></tbody></table></div><p>Since GIMP 2.2
|
||
</p></div><hr><div class="refsect2" lang="en"><a name="id2612968"></a><h3><a name="gimp-drawable-transform-perspective"></a>gimp_drawable_transform_perspective ()</h3><a class="indexterm" name="id2612977"></a><pre class="programlisting">gint32 gimp_drawable_transform_perspective
|
||
(gint32 drawable_ID,
|
||
gdouble x0,
|
||
gdouble y0,
|
||
gdouble x1,
|
||
gdouble y1,
|
||
gdouble x2,
|
||
gdouble y2,
|
||
gdouble x3,
|
||
gdouble y3,
|
||
<a href="libgimp-gimpenums.html#GimpTransformDirection">GimpTransformDirection</a> transform_direction,
|
||
<a href="libgimp-gimpenums.html#GimpInterpolationType">GimpInterpolationType</a> interpolation,
|
||
gboolean supersample,
|
||
gint recursion_level,
|
||
gboolean clip_result);</pre><p>
|
||
Perform a possibly non-affine transformation on the specified
|
||
drawable, with extra parameters.
|
||
</p><p>
|
||
This procedure performs a possibly non-affine transformation on the
|
||
specified drawable by allowing the corners of the original bounding
|
||
box to be arbitrarily remapped to any values. The specified drawable
|
||
is remapped if no selection exists. However, if a selection exists,
|
||
the portion of the drawable which lies under the selection is cut
|
||
from the drawable and made into a floating selection which is then
|
||
remapped as specified. The return value is the ID of the remapped
|
||
drawable. If there was no selection, this will be equal to the
|
||
drawable ID supplied as input. Otherwise, this will be the newly
|
||
created and remapped drawable. The 4 coordinates specify the new
|
||
locations of each corner of the original bounding box. By specifying
|
||
these values, any affine transformation (rotation, scaling,
|
||
translation) can be affected. Additionally, these values can be
|
||
specified such that the resulting transformed drawable will appear
|
||
to have been projected via a perspective transform.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>drawable_ID</code></em> :</span></td><td> The affected drawable.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>x0</code></em> :</span></td><td> The new x coordinate of upper-left corner of original bounding box.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>y0</code></em> :</span></td><td> The new y coordinate of upper-left corner of original bounding box.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>x1</code></em> :</span></td><td> The new x coordinate of upper-right corner of original bounding box.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>y1</code></em> :</span></td><td> The new y coordinate of upper-right corner of original bounding box.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>x2</code></em> :</span></td><td> The new x coordinate of lower-left corner of original bounding box.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>y2</code></em> :</span></td><td> The new y coordinate of lower-left corner of original bounding box.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>x3</code></em> :</span></td><td> The new x coordinate of lower-right corner of original bounding box.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>y3</code></em> :</span></td><td> The new y coordinate of lower-right corner of original bounding box.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>transform_direction</code></em> :</span></td><td> Direction of Transformation.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>interpolation</code></em> :</span></td><td> Type of interpolation.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>supersample</code></em> :</span></td><td> Whether to perform supersample.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>recursion_level</code></em> :</span></td><td> Level of recursion (3 is a nice default).
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>clip_result</code></em> :</span></td><td> Whether to clip results.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> The newly mapped drawable.
|
||
|
||
</td></tr></tbody></table></div><p>Since GIMP 2.2
|
||
</p></div><hr><div class="refsect2" lang="en"><a name="id2613280"></a><h3><a name="gimp-drawable-transform-perspective-default"></a>gimp_drawable_transform_perspective_default ()</h3><a class="indexterm" name="id2613290"></a><pre class="programlisting">gint32 gimp_drawable_transform_perspective_default
|
||
(gint32 drawable_ID,
|
||
gdouble x0,
|
||
gdouble y0,
|
||
gdouble x1,
|
||
gdouble y1,
|
||
gdouble x2,
|
||
gdouble y2,
|
||
gdouble x3,
|
||
gdouble y3,
|
||
gboolean interpolate,
|
||
gboolean clip_result);</pre><p>
|
||
Perform a possibly non-affine transformation on the specified
|
||
drawable, with extra parameters.
|
||
</p><p>
|
||
This procedure is a variant of <a href="libgimp-gimpdrawabletransform.html#gimp-drawable-transform-perspective"><code class="function">gimp_drawable_transform_perspective()</code></a>
|
||
which uses no interpolation/supersampling at all, or default values
|
||
(depending on the 'interpolate' parameter).</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>drawable_ID</code></em> :</span></td><td> The affected drawable.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>x0</code></em> :</span></td><td> The new x coordinate of upper-left corner of original bounding box.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>y0</code></em> :</span></td><td> The new y coordinate of upper-left corner of original bounding box.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>x1</code></em> :</span></td><td> The new x coordinate of upper-right corner of original bounding box.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>y1</code></em> :</span></td><td> The new y coordinate of upper-right corner of original bounding box.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>x2</code></em> :</span></td><td> The new x coordinate of lower-left corner of original bounding box.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>y2</code></em> :</span></td><td> The new y coordinate of lower-left corner of original bounding box.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>x3</code></em> :</span></td><td> The new x coordinate of lower-right corner of original bounding box.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>y3</code></em> :</span></td><td> The new y coordinate of lower-right corner of original bounding box.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>interpolate</code></em> :</span></td><td> Whether to use interpolation and supersampling.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>clip_result</code></em> :</span></td><td> Whether to clip results.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> The newly mapped drawable.
|
||
|
||
</td></tr></tbody></table></div><p>Since GIMP 2.2
|
||
</p></div><hr><div class="refsect2" lang="en"><a name="id2613535"></a><h3><a name="gimp-drawable-transform-rotate-simple"></a>gimp_drawable_transform_rotate_simple ()</h3><a class="indexterm" name="id2613544"></a><pre class="programlisting">gint32 gimp_drawable_transform_rotate_simple
|
||
(gint32 drawable_ID,
|
||
<a href="libgimp-gimpenums.html#GimpRotationType">GimpRotationType</a> rotate_type,
|
||
gboolean auto_center,
|
||
gint center_x,
|
||
gint center_y,
|
||
gboolean clip_result);</pre><p>
|
||
Rotate the specified drawable about given coordinates through the
|
||
specified angle.
|
||
</p><p>
|
||
This function rotates the specified drawable if no selection exists.
|
||
If a selection exists, the portion of the drawable which lies under
|
||
the selection is cut from the drawable and made into a floating
|
||
selection which is then rotated by the specified amount. The return
|
||
value is the ID of the rotated drawable. If there was no selection,
|
||
this will be equal to the drawable ID supplied as input. Otherwise,
|
||
this will be the newly created and rotated drawable.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>drawable_ID</code></em> :</span></td><td> The affected drawable.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>rotate_type</code></em> :</span></td><td> Type of rotation.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>auto_center</code></em> :</span></td><td> Whether to automatically rotate around the selection center.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>center_x</code></em> :</span></td><td> The hor. coordinate of the center of rotation.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>center_y</code></em> :</span></td><td> The vert. coordinate of the center of rotation.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>clip_result</code></em> :</span></td><td> Whether to clip results.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> The rotated drawable.
|
||
|
||
</td></tr></tbody></table></div><p>Since GIMP 2.2
|
||
</p></div><hr><div class="refsect2" lang="en"><a name="id2613696"></a><h3><a name="gimp-drawable-transform-rotate"></a>gimp_drawable_transform_rotate ()</h3><a class="indexterm" name="id2613705"></a><pre class="programlisting">gint32 gimp_drawable_transform_rotate (gint32 drawable_ID,
|
||
gdouble angle,
|
||
gboolean auto_center,
|
||
gint center_x,
|
||
gint center_y,
|
||
<a href="libgimp-gimpenums.html#GimpTransformDirection">GimpTransformDirection</a> transform_direction,
|
||
<a href="libgimp-gimpenums.html#GimpInterpolationType">GimpInterpolationType</a> interpolation,
|
||
gboolean supersample,
|
||
gint recursion_level,
|
||
gboolean clip_result);</pre><p>
|
||
Rotate the specified drawable about given coordinates through the
|
||
specified angle.
|
||
</p><p>
|
||
This function rotates the specified drawable if no selection exists.
|
||
If a selection exists, the portion of the drawable which lies under
|
||
the selection is cut from the drawable and made into a floating
|
||
selection which is then rotated by the specified amount. The return
|
||
value is the ID of the rotated drawable. If there was no selection,
|
||
this will be equal to the drawable ID supplied as input. Otherwise,
|
||
this will be the newly created and rotated drawable.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>drawable_ID</code></em> :</span></td><td> The affected drawable.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>angle</code></em> :</span></td><td> The angle of rotation (radians).
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>auto_center</code></em> :</span></td><td> Whether to automatically rotate around the selection center.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>center_x</code></em> :</span></td><td> The hor. coordinate of the center of rotation.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>center_y</code></em> :</span></td><td> The vert. coordinate of the center of rotation.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>transform_direction</code></em> :</span></td><td> Direction of Transformation.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>interpolation</code></em> :</span></td><td> Type of interpolation.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>supersample</code></em> :</span></td><td> Whether to perform supersample.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>recursion_level</code></em> :</span></td><td> Level of recursion (3 is a nice default).
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>clip_result</code></em> :</span></td><td> Whether to clip results.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> The rotated drawable.
|
||
|
||
</td></tr></tbody></table></div><p>Since GIMP 2.2
|
||
</p></div><hr><div class="refsect2" lang="en"><a name="id2613924"></a><h3><a name="gimp-drawable-transform-rotate-default"></a>gimp_drawable_transform_rotate_default ()</h3><a class="indexterm" name="id2613932"></a><pre class="programlisting">gint32 gimp_drawable_transform_rotate_default
|
||
(gint32 drawable_ID,
|
||
gdouble angle,
|
||
gboolean auto_center,
|
||
gint center_x,
|
||
gint center_y,
|
||
gboolean interpolate,
|
||
gboolean clip_result);</pre><p>
|
||
Rotate the specified drawable about given coordinates through the
|
||
specified angle.
|
||
</p><p>
|
||
This procedure is a variant of <a href="libgimp-gimpdrawabletransform.html#gimp-drawable-transform-rotate"><code class="function">gimp_drawable_transform_rotate()</code></a>
|
||
which uses no interpolation/supersampling at all, or default values
|
||
(depending on the 'interpolate' parameter).</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>drawable_ID</code></em> :</span></td><td> The affected drawable.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>angle</code></em> :</span></td><td> The angle of rotation (radians).
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>auto_center</code></em> :</span></td><td> Whether to automatically rotate around the selection center.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>center_x</code></em> :</span></td><td> The hor. coordinate of the center of rotation.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>center_y</code></em> :</span></td><td> The vert. coordinate of the center of rotation.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>interpolate</code></em> :</span></td><td> Whether to use interpolation and supersampling.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>clip_result</code></em> :</span></td><td> Whether to clip results.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> The rotated drawable.
|
||
|
||
</td></tr></tbody></table></div><p>Since GIMP 2.2
|
||
</p></div><hr><div class="refsect2" lang="en"><a name="id2614103"></a><h3><a name="gimp-drawable-transform-scale"></a>gimp_drawable_transform_scale ()</h3><a class="indexterm" name="id2614111"></a><pre class="programlisting">gint32 gimp_drawable_transform_scale (gint32 drawable_ID,
|
||
gdouble x0,
|
||
gdouble y0,
|
||
gdouble x1,
|
||
gdouble y1,
|
||
<a href="libgimp-gimpenums.html#GimpTransformDirection">GimpTransformDirection</a> transform_direction,
|
||
<a href="libgimp-gimpenums.html#GimpInterpolationType">GimpInterpolationType</a> interpolation,
|
||
gboolean supersample,
|
||
gint recursion_level,
|
||
gboolean clip_result);</pre><p>
|
||
Scale the specified drawable with extra parameters
|
||
</p><p>
|
||
This procedure scales the specified drawable if no selection exists.
|
||
If a selection exists, the portion of the drawable which lies under
|
||
the selection is cut from the drawable and made into a floating
|
||
selection which is then scaled by the specified amount. The return
|
||
value is the ID of the scaled drawable. If there was no selection,
|
||
this will be equal to the drawable ID supplied as input. Otherwise,
|
||
this will be the newly created and scaled drawable.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>drawable_ID</code></em> :</span></td><td> The affected drawable.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>x0</code></em> :</span></td><td> The new x coordinate of upper-left corner of newly scaled region.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>y0</code></em> :</span></td><td> The new y coordinate of upper-left corner of newly scaled region.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>x1</code></em> :</span></td><td> The new x coordinate of lower-right corner of newly scaled region.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>y1</code></em> :</span></td><td> The new y coordinate of lower-right corner of newly scaled region.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>transform_direction</code></em> :</span></td><td> Direction of Transformation.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>interpolation</code></em> :</span></td><td> Type of interpolation.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>supersample</code></em> :</span></td><td> Whether to perform supersample.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>recursion_level</code></em> :</span></td><td> Level of recursion (3 is a nice default).
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>clip_result</code></em> :</span></td><td> Whether to clip results.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> The scaled drawable.
|
||
|
||
</td></tr></tbody></table></div><p>Since GIMP 2.2
|
||
</p></div><hr><div class="refsect2" lang="en"><a name="id2614331"></a><h3><a name="gimp-drawable-transform-scale-default"></a>gimp_drawable_transform_scale_default ()</h3><a class="indexterm" name="id2614340"></a><pre class="programlisting">gint32 gimp_drawable_transform_scale_default
|
||
(gint32 drawable_ID,
|
||
gdouble x0,
|
||
gdouble y0,
|
||
gdouble x1,
|
||
gdouble y1,
|
||
gboolean interpolate,
|
||
gboolean clip_result);</pre><p>
|
||
Scale the specified drawable with extra parameters
|
||
</p><p>
|
||
This procedure is a variant of <a href="libgimp-gimpdrawabletransform.html#gimp-drawable-transform-scale"><code class="function">gimp_drawable_transform_scale()</code></a> which
|
||
uses no interpolation/supersampling at all, or default values
|
||
(depending on the 'interpolate' parameter).</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>drawable_ID</code></em> :</span></td><td> The affected drawable.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>x0</code></em> :</span></td><td> The new x coordinate of upper-left corner of newly scaled region.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>y0</code></em> :</span></td><td> The new y coordinate of upper-left corner of newly scaled region.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>x1</code></em> :</span></td><td> The new x coordinate of lower-right corner of newly scaled region.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>y1</code></em> :</span></td><td> The new y coordinate of lower-right corner of newly scaled region.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>interpolate</code></em> :</span></td><td> Whether to use interpolation and supersampling.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>clip_result</code></em> :</span></td><td> Whether to clip results.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> The scaled drawable.
|
||
|
||
</td></tr></tbody></table></div><p>Since GIMP 2.2
|
||
</p></div><hr><div class="refsect2" lang="en"><a name="id2614512"></a><h3><a name="gimp-drawable-transform-shear"></a>gimp_drawable_transform_shear ()</h3><a class="indexterm" name="id2614520"></a><pre class="programlisting">gint32 gimp_drawable_transform_shear (gint32 drawable_ID,
|
||
<a href="libgimp-gimpenums.html#GimpOrientationType">GimpOrientationType</a> shear_type,
|
||
gdouble magnitude,
|
||
<a href="libgimp-gimpenums.html#GimpTransformDirection">GimpTransformDirection</a> transform_direction,
|
||
<a href="libgimp-gimpenums.html#GimpInterpolationType">GimpInterpolationType</a> interpolation,
|
||
gboolean supersample,
|
||
gint recursion_level,
|
||
gboolean clip_result);</pre><p>
|
||
Shear the specified drawable about its center by the specified
|
||
magnitude, with extra parameters.
|
||
</p><p>
|
||
This procedure shears the specified drawable if no selection exists.
|
||
If a selection exists, the portion of the drawable which lies under
|
||
the selection is cut from the drawable and made into a floating
|
||
selection which is then sheard by the specified amount. The return
|
||
value is the ID of the sheard drawable. If there was no selection,
|
||
this will be equal to the drawable ID supplied as input. Otherwise,
|
||
this will be the newly created and sheard drawable. The shear type
|
||
parameter indicates whether the shear will be applied horizontally
|
||
or vertically. The magnitude can be either positive or negative and
|
||
indicates the extent (in pixels) to shear by.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>drawable_ID</code></em> :</span></td><td> The affected drawable.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>shear_type</code></em> :</span></td><td> Type of shear.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>magnitude</code></em> :</span></td><td> The magnitude of the shear.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>transform_direction</code></em> :</span></td><td> Direction of Transformation.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>interpolation</code></em> :</span></td><td> Type of interpolation.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>supersample</code></em> :</span></td><td> Whether to perform supersample.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>recursion_level</code></em> :</span></td><td> Level of recursion (3 is a nice default).
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>clip_result</code></em> :</span></td><td> Whether to clip results.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> The sheared drawable.
|
||
|
||
</td></tr></tbody></table></div><p>Since GIMP 2.2
|
||
</p></div><hr><div class="refsect2" lang="en"><a name="id2614706"></a><h3><a name="gimp-drawable-transform-shear-default"></a>gimp_drawable_transform_shear_default ()</h3><a class="indexterm" name="id2614714"></a><pre class="programlisting">gint32 gimp_drawable_transform_shear_default
|
||
(gint32 drawable_ID,
|
||
<a href="libgimp-gimpenums.html#GimpOrientationType">GimpOrientationType</a> shear_type,
|
||
gdouble magnitude,
|
||
gboolean interpolate,
|
||
gboolean clip_result);</pre><p>
|
||
Shear the specified drawable about its center by the specified
|
||
magnitude, with extra parameters.
|
||
</p><p>
|
||
This procedure is a variant of <a href="libgimp-gimpdrawabletransform.html#gimp-drawable-transform-shear"><code class="function">gimp_drawable_transform_shear()</code></a> which
|
||
uses no interpolation/supersampling at all, or default values
|
||
(depending on the 'interpolate' parameter).</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>drawable_ID</code></em> :</span></td><td> The affected drawable.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>shear_type</code></em> :</span></td><td> Type of shear.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>magnitude</code></em> :</span></td><td> The magnitude of the shear.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>interpolate</code></em> :</span></td><td> Whether to use interpolation and supersampling.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>clip_result</code></em> :</span></td><td> Whether to clip results.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> The sheared drawable.
|
||
|
||
</td></tr></tbody></table></div><p>Since GIMP 2.2
|
||
</p></div><hr><div class="refsect2" lang="en"><a name="id2614848"></a><h3><a name="gimp-drawable-transform-2d"></a>gimp_drawable_transform_2d ()</h3><a class="indexterm" name="id2614856"></a><pre class="programlisting">gint32 gimp_drawable_transform_2d (gint32 drawable_ID,
|
||
gdouble source_x,
|
||
gdouble source_y,
|
||
gdouble scale_x,
|
||
gdouble scale_y,
|
||
gdouble angle,
|
||
gdouble dest_x,
|
||
gdouble dest_y,
|
||
<a href="libgimp-gimpenums.html#GimpTransformDirection">GimpTransformDirection</a> transform_direction,
|
||
<a href="libgimp-gimpenums.html#GimpInterpolationType">GimpInterpolationType</a> interpolation,
|
||
gboolean supersample,
|
||
gint recursion_level,
|
||
gboolean clip_result);</pre><p>
|
||
Transform the specified drawable in 2d, with extra parameters.
|
||
</p><p>
|
||
This procedure transforms the specified drawable if no selection
|
||
exists. If a selection exists, the portion of the drawable which
|
||
lies under the selection is cut from the drawable and made into a
|
||
floating selection which is then transformed. The transformation is
|
||
done by scaling the image by the x and y scale factors about the
|
||
point (source_x, source_y), then rotating around the same point,
|
||
then translating that point to the new position (dest_x, dest_y).
|
||
The return value is the ID of the rotated drawable. If there was no
|
||
selection, this will be equal to the drawable ID supplied as input.
|
||
Otherwise, this will be the newly created and transformed drawable.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>drawable_ID</code></em> :</span></td><td> The affected drawable.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>source_x</code></em> :</span></td><td> X coordinate of the transformation center.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>source_y</code></em> :</span></td><td> Y coordinate of the transformation center.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>scale_x</code></em> :</span></td><td> Amount to scale in x direction.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>scale_y</code></em> :</span></td><td> Amount to scale in y direction.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>angle</code></em> :</span></td><td> The angle of rotation (radians).
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>dest_x</code></em> :</span></td><td> X coordinate of where the center goes.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>dest_y</code></em> :</span></td><td> Y coordinate of where the center goes.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>transform_direction</code></em> :</span></td><td> Direction of Transformation.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>interpolation</code></em> :</span></td><td> Type of interpolation.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>supersample</code></em> :</span></td><td> Whether to perform supersample.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>recursion_level</code></em> :</span></td><td> Level of recursion (3 is a nice default).
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>clip_result</code></em> :</span></td><td> Whether to clip results.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> The transformed drawable.
|
||
|
||
</td></tr></tbody></table></div><p>Since GIMP 2.2
|
||
</p></div><hr><div class="refsect2" lang="en"><a name="id2615128"></a><h3><a name="gimp-drawable-transform-2d-default"></a>gimp_drawable_transform_2d_default ()</h3><a class="indexterm" name="id2615138"></a><pre class="programlisting">gint32 gimp_drawable_transform_2d_default
|
||
(gint32 drawable_ID,
|
||
gdouble source_x,
|
||
gdouble source_y,
|
||
gdouble scale_x,
|
||
gdouble scale_y,
|
||
gdouble angle,
|
||
gdouble dest_x,
|
||
gdouble dest_y,
|
||
gboolean interpolate,
|
||
gboolean clip_result);</pre><p>
|
||
Transform the specified drawable in 2d, with extra parameters.
|
||
</p><p>
|
||
This procedure is a variant of <a href="libgimp-gimpdrawabletransform.html#gimp-drawable-transform-2d"><code class="function">gimp_drawable_transform_2d()</code></a> which
|
||
uses no interpolation/supersampling at all, or default values
|
||
(depending on the 'interpolate' parameter).</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>drawable_ID</code></em> :</span></td><td> The affected drawable.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>source_x</code></em> :</span></td><td> X coordinate of the transformation center.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>source_y</code></em> :</span></td><td> Y coordinate of the transformation center.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>scale_x</code></em> :</span></td><td> Amount to scale in x direction.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>scale_y</code></em> :</span></td><td> Amount to scale in y direction.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>angle</code></em> :</span></td><td> The angle of rotation (radians).
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>dest_x</code></em> :</span></td><td> X coordinate of where the center goes.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>dest_y</code></em> :</span></td><td> Y coordinate of where the center goes.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>interpolate</code></em> :</span></td><td> Whether to use interpolation and supersampling.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>clip_result</code></em> :</span></td><td> Whether to clip results.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> The transformed drawable.
|
||
|
||
</td></tr></tbody></table></div><p>Since GIMP 2.2
|
||
</p></div><hr><div class="refsect2" lang="en"><a name="id2615364"></a><h3><a name="gimp-drawable-transform-matrix"></a>gimp_drawable_transform_matrix ()</h3><a class="indexterm" name="id2615375"></a><pre class="programlisting">gint32 gimp_drawable_transform_matrix (gint32 drawable_ID,
|
||
gdouble coeff_0_0,
|
||
gdouble coeff_0_1,
|
||
gdouble coeff_0_2,
|
||
gdouble coeff_1_0,
|
||
gdouble coeff_1_1,
|
||
gdouble coeff_1_2,
|
||
gdouble coeff_2_0,
|
||
gdouble coeff_2_1,
|
||
gdouble coeff_2_2,
|
||
<a href="libgimp-gimpenums.html#GimpTransformDirection">GimpTransformDirection</a> transform_direction,
|
||
<a href="libgimp-gimpenums.html#GimpInterpolationType">GimpInterpolationType</a> interpolation,
|
||
gboolean supersample,
|
||
gint recursion_level,
|
||
gboolean clip_result);</pre><p>
|
||
Transform the specified drawable in 2d, with extra parameters.
|
||
</p><p>
|
||
This procedure transforms the specified drawable if no selection
|
||
exists. If a selection exists, the portion of the drawable which
|
||
lies under the selection is cut from the drawable and made into a
|
||
floating selection which is then transformed. The transformation is
|
||
done by assembling a 3x3 matrix from the coefficients passed. The
|
||
return value is the ID of the rotated drawable. If there was no
|
||
selection, this will be equal to the drawable ID supplied as input.
|
||
Otherwise, this will be the newly created and transformed drawable.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>drawable_ID</code></em> :</span></td><td> The affected drawable.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>coeff_0_0</code></em> :</span></td><td> coefficient (0,0) of the transformation matrix.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>coeff_0_1</code></em> :</span></td><td> coefficient (0,1) of the transformation matrix.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>coeff_0_2</code></em> :</span></td><td> coefficient (0,2) of the transformation matrix.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>coeff_1_0</code></em> :</span></td><td> coefficient (1,0) of the transformation matrix.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>coeff_1_1</code></em> :</span></td><td> coefficient (1,1) of the transformation matrix.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>coeff_1_2</code></em> :</span></td><td> coefficient (1,2) of the transformation matrix.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>coeff_2_0</code></em> :</span></td><td> coefficient (2,0) of the transformation matrix.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>coeff_2_1</code></em> :</span></td><td> coefficient (2,1) of the transformation matrix.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>coeff_2_2</code></em> :</span></td><td> coefficient (2,2) of the transformation matrix.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>transform_direction</code></em> :</span></td><td> Direction of Transformation.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>interpolation</code></em> :</span></td><td> Type of interpolation.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>supersample</code></em> :</span></td><td> Whether to perform supersample.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>recursion_level</code></em> :</span></td><td> Level of recursion (3 is a nice default).
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>clip_result</code></em> :</span></td><td> Whether to clip results.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> The transformed drawable.
|
||
|
||
</td></tr></tbody></table></div><p>Since GIMP 2.2
|
||
</p></div><hr><div class="refsect2" lang="en"><a name="id2615690"></a><h3><a name="gimp-drawable-transform-matrix-default"></a>gimp_drawable_transform_matrix_default ()</h3><a class="indexterm" name="id2615701"></a><pre class="programlisting">gint32 gimp_drawable_transform_matrix_default
|
||
(gint32 drawable_ID,
|
||
gdouble coeff_0_0,
|
||
gdouble coeff_0_1,
|
||
gdouble coeff_0_2,
|
||
gdouble coeff_1_0,
|
||
gdouble coeff_1_1,
|
||
gdouble coeff_1_2,
|
||
gdouble coeff_2_0,
|
||
gdouble coeff_2_1,
|
||
gdouble coeff_2_2,
|
||
gboolean interpolate,
|
||
gboolean clip_result);</pre><p>
|
||
Transform the specified drawable in 2d, with extra parameters.
|
||
</p><p>
|
||
This procedure is a variant of <a href="libgimp-gimpdrawabletransform.html#gimp-drawable-transform-matrix"><code class="function">gimp_drawable_transform_matrix()</code></a>
|
||
which uses no interpolation/supersampling at all, or default values
|
||
(depending on the 'interpolate' parameter).</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>drawable_ID</code></em> :</span></td><td> The affected drawable.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>coeff_0_0</code></em> :</span></td><td> coefficient (0,0) of the transformation matrix.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>coeff_0_1</code></em> :</span></td><td> coefficient (0,1) of the transformation matrix.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>coeff_0_2</code></em> :</span></td><td> coefficient (0,2) of the transformation matrix.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>coeff_1_0</code></em> :</span></td><td> coefficient (1,0) of the transformation matrix.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>coeff_1_1</code></em> :</span></td><td> coefficient (1,1) of the transformation matrix.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>coeff_1_2</code></em> :</span></td><td> coefficient (1,2) of the transformation matrix.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>coeff_2_0</code></em> :</span></td><td> coefficient (2,0) of the transformation matrix.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>coeff_2_1</code></em> :</span></td><td> coefficient (2,1) of the transformation matrix.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>coeff_2_2</code></em> :</span></td><td> coefficient (2,2) of the transformation matrix.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>interpolate</code></em> :</span></td><td> Whether to use interpolation and supersampling.
|
||
</td></tr><tr><td><span class="term"><em class="parameter"><code>clip_result</code></em> :</span></td><td> Whether to clip results.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> The transformed drawable.
|
||
|
||
</td></tr></tbody></table></div><p>Since GIMP 2.2
|
||
</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="libgimp-gimpdrawable.html"><b><< gimpdrawable</b></a></td><td align="right"><a accesskey="n" href="libgimp-gimpedit.html"><b>gimpedit >></b></a></td></tr></table></body></html>
|