callisto-debian/gimp
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

New upstream version 2.10.0

Browse Source
This commit is contained in:
Jeremy Bicha
2018-04-27 11:44:24 -04:00
parent 566351d422 5e662c37d7
commit 07c3f6bee3
477 changed files with 45624 additions and 20193 deletions
Download Patch File Download Diff File Expand all files Collapse all files

238
devel-docs/libgimp/html/libgimp-gimpitemtransform.html
View File

@ -128,16 +128,21 @@ gimp_item_transform_flip_simple (<em class="parameter"><code><a href="../glib/gl
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> auto_center</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> axis</code></em>);</pre>
<p>Flip the specified item either vertically or horizontally.</p>
<p>This procedure flips the specified item. If a selection exists and
the item is a drawable, 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 item. If there was no selection or the item is not a
drawable, this will be equal to the item ID supplied as input.
Otherwise, this will be the newly created and flipped drawable.
This procedure is affected by the following context setters:
<p>This procedure flips the specified item.</p>
<p>If a selection exists and the item is a drawable, 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 floating selection.</p>
<p>If there is no selection or the item is not a drawable, the entire
item will be flipped around its center if auto_center is set to
TRUE, otherwise the coordinate of the axis needs to be specified.
Additionally, if the item has its linked flag set to TRUE, all
additional items contained in the image which have the linked flag
set to TRUE will also be flipped around the same axis. The return
value will be equal to the item ID supplied as input.</p>
<p>This procedure is affected by the following context setters:
<a class="link" href="libgimp-gimpcontext.html#gimp-context-set-transform-resize" title="gimp_context_set_transform_resize ()"><code class="function">gimp_context_set_transform_resize()</code></a>.</p>
<div class="refsect3">
<a name="gimp-item-transform-flip-simple.parameters"></a><h4>Parameters</h4>
@ -187,16 +192,19 @@ gimp_item_transform_flip (<em class="parameter"><code><a href="../glib/glib-Basi
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> x1</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> y1</code></em>);</pre>
<p>Flip the specified item around a given line.</p>
<p>This procedure flips the specified item. If a selection exists and
the item is a drawable , 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 item. If there was no selection or the item
is not a drawable, this will be equal to the item ID supplied as
input. Otherwise, this will be the newly created and flipped
drawable.
This procedure is affected by the following context setters:
<p>This procedure flips the specified item.</p>
<p>If a selection exists and the item is a drawable, 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 floating selection.</p>
<p>If there is no selection or the item is not a drawable, the entire
item will be flipped around the specified axis. Additionally, if the
item has its linked flag set to TRUE, all additional items contained
in the image which have the linked flag set to TRUE will also be
flipped around the same axis. The return value will be equal to the
item ID supplied as input.</p>
<p>This procedure is affected by the following context setters:
<a class="link" href="libgimp-gimpcontext.html#gimp-context-set-interpolation" title="gimp_context_set_interpolation ()"><code class="function">gimp_context_set_interpolation()</code></a>,
<a class="link" href="libgimp-gimpcontext.html#gimp-context-set-transform-direction" title="gimp_context_set_transform_direction ()"><code class="function">gimp_context_set_transform_direction()</code></a>,
<a class="link" href="libgimp-gimpcontext.html#gimp-context-set-transform-resize" title="gimp_context_set_transform_resize ()"><code class="function">gimp_context_set_transform_resize()</code></a>.</p>
@ -259,21 +267,25 @@ gimp_item_transform_perspective (<em class="parameter"><code><a href="../glib/gl
<p>Perform a possibly non-affine transformation on the specified item.</p>
<p>This procedure performs a possibly non-affine transformation on the
specified item by allowing the corners of the original bounding box
to be arbitrarily remapped to any values. The specified item is
remapped if no selection exists or it is not a drawable. However, if
a selection exists and the item is a drawable, the portion of the
to be arbitrarily remapped to any values.</p>
<p>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 item will appear to have been projected via a
perspective transform.</p>
<p>If a selection exists and the item is a drawable, 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 item. If there was no
selection or the item is not a drawable, this will be equal to the
item 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 item will appear to have been
projected via a perspective transform.
This procedure is affected by the following context setters:
made into a floating selection which is then transformed as
specified. The return value is the ID of the transformed floating
selection.</p>
<p>If there is no selection or the item is not a drawable, the entire
item will be transformed according to the specified mapping.
Additionally, if the item has its linked flag set to TRUE, all
additional items contained in the image which have the linked flag
set to TRUE will also be transformed the same way. The return value
will be equal to the item ID supplied as input.</p>
<p>This procedure is affected by the following context setters:
<a class="link" href="libgimp-gimpcontext.html#gimp-context-set-interpolation" title="gimp_context_set_interpolation ()"><code class="function">gimp_context_set_interpolation()</code></a>,
<a class="link" href="libgimp-gimpcontext.html#gimp-context-set-transform-direction" title="gimp_context_set_transform_direction ()"><code class="function">gimp_context_set_transform_direction()</code></a>,
<a class="link" href="libgimp-gimpcontext.html#gimp-context-set-transform-resize" title="gimp_context_set_transform_resize ()"><code class="function">gimp_context_set_transform_resize()</code></a>.</p>
@ -336,7 +348,7 @@ This procedure is affected by the following context setters:
</div>
<div class="refsect3">
<a name="gimp-item-transform-perspective.returns"></a><h4>Returns</h4>
<p> The newly mapped item.</p>
<p> The transformed item.</p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-8.html#api-index-2.8">2.8</a></p>
</div>
@ -351,15 +363,23 @@ gimp_item_transform_rotate_simple (<em class="parameter"><code><a href="../glib/
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> center_y</code></em>);</pre>
<p>Rotate the specified item about given coordinates through the
specified angle.</p>
<p>This function rotates the specified item. If a selection exists and
the item is a drawable, 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 item. If there was no selection or
the item is not a drawable, this will be equal to the item ID
supplied as input. Otherwise, this will be the newly created and
rotated drawable.
This procedure is affected by the following context setters:
<p>This function rotates the specified item.</p>
<p>If a selection exists and the item is a drawable, 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. If auto_center is set to TRUE, the rotation is
around the selection's center. Otherwise, the coordinate of the
center point needs to be specified. The return value is the ID of
the rotated floating selection.</p>
<p>If there is no selection or the item is not a drawable, the entire
item will be rotated around its center if auto_center is set to
TRUE, otherwise the coordinate of the center point needs to be
specified. Additionally, if the item has its linked flag set to
TRUE, all additional items contained in the image which have the
linked flag set to TRUE will also be rotated around the same center
point. The return value will be equal to the item ID supplied as
input.</p>
<p>This procedure is affected by the following context setters:
<a class="link" href="libgimp-gimpcontext.html#gimp-context-set-transform-resize" title="gimp_context_set_transform_resize ()"><code class="function">gimp_context_set_transform_resize()</code></a>.</p>
<div class="refsect3">
<a name="gimp-item-transform-rotate-simple.parameters"></a><h4>Parameters</h4>
@ -415,15 +435,23 @@ gimp_item_transform_rotate (<em class="parameter"><code><a href="../glib/glib-Ba
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> center_y</code></em>);</pre>
<p>Rotate the specified item about given coordinates through the
specified angle.</p>
<p>This function rotates the specified item. If a selection exists and
the item is a drawable, 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 item. If there was no selection or
the item is not a drawable, this will be equal to the item ID
supplied as input. Otherwise, this will be the newly created and
rotated drawable.
This procedure is affected by the following context setters:
<p>This function rotates the specified item.</p>
<p>If a selection exists and the item is a drawable, 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. If auto_center is set to TRUE, the rotation is
around the selection's center. Otherwise, the coordinate of the
center point needs to be specified. The return value is the ID of
the rotated floating selection.</p>
<p>If there is no selection or the item is not a drawable, the entire
item will be rotated around its center if auto_center is set to
TRUE, otherwise the coordinate of the center point needs to be
specified. Additionally, if the item has its linked flag set to
TRUE, all additional items contained in the image which have the
linked flag set to TRUE will also be rotated around the same center
point. The return value will be equal to the item ID supplied as
input.</p>
<p>This procedure is affected by the following context setters:
<a class="link" href="libgimp-gimpcontext.html#gimp-context-set-interpolation" title="gimp_context_set_interpolation ()"><code class="function">gimp_context_set_interpolation()</code></a>,
<a class="link" href="libgimp-gimpcontext.html#gimp-context-set-transform-direction" title="gimp_context_set_transform_direction ()"><code class="function">gimp_context_set_transform_direction()</code></a>,
<a class="link" href="libgimp-gimpcontext.html#gimp-context-set-transform-resize" title="gimp_context_set_transform_resize ()"><code class="function">gimp_context_set_transform_resize()</code></a>.</p>
@ -480,15 +508,20 @@ gimp_item_transform_scale (<em class="parameter"><code><a href="../glib/glib-Bas
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> x1</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> y1</code></em>);</pre>
<p>Scale the specified item.</p>
<p>This procedure scales the specified item. If a selection exists and
the item is a drawable, 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 item. If there was no selection or the
item is not a drawable, this will be equal to the item ID supplied
as input. Otherwise, this will be the newly created and scaled
drawable.
This procedure is affected by the following context setters:
<p>This procedure scales the specified item.</p>
<p>The 2 coordinates specify the new locations of the top-left and
bottom-roght corners of the original bounding box.</p>
<p>If a selection exists and the item is a drawable, 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 as specified.
The return value is the ID of the scaled floating selection.</p>
<p>If there is no selection or the item is not a drawable, the entire
item will be scaled according to the specified coordinates.
Additionally, if the item has its linked flag set to TRUE, all
additional items contained in the image which have the linked flag
set to TRUE will also be scaled the same way. The return value will
be equal to the item ID supplied as input.</p>
<p>This procedure is affected by the following context setters:
<a class="link" href="libgimp-gimpcontext.html#gimp-context-set-interpolation" title="gimp_context_set_interpolation ()"><code class="function">gimp_context_set_interpolation()</code></a>,
<a class="link" href="libgimp-gimpcontext.html#gimp-context-set-transform-direction" title="gimp_context_set_transform_direction ()"><code class="function">gimp_context_set_transform_direction()</code></a>,
<a class="link" href="libgimp-gimpcontext.html#gimp-context-set-transform-resize" title="gimp_context_set_transform_resize ()"><code class="function">gimp_context_set_transform_resize()</code></a>.</p>
@ -544,18 +577,21 @@ gimp_item_transform_shear (<em class="parameter"><code><a href="../glib/glib-Bas
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> magnitude</code></em>);</pre>
<p>Shear the specified item about its center by the specified
magnitude.</p>
<p>This procedure shears the specified item. If a selection exists and
the item is a drawable, 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 item. If there was no selection or the
item is not a drawable, this will be equal to the item 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.
This procedure is affected by the following context setters:
<p>This procedure shears the specified item.</p>
<p>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>If a selection exists and the item is a drawable, the portion of the
drawable which lies under the selection is cut from the drawable and
made into a floating selection which is then sheared as specified.
The return value is the ID of the sheared floating selection.</p>
<p>If there is no selection or the item is not a drawable, the entire
item will be sheared according to the specified parameters.
Additionally, if the item has its linked flag set to TRUE, all
additional items contained in the image which have the linked flag
set to TRUE will also be sheared the same way. The return value will
be equal to the item ID supplied as input.</p>
<p>This procedure is affected by the following context setters:
<a class="link" href="libgimp-gimpcontext.html#gimp-context-set-interpolation" title="gimp_context_set_interpolation ()"><code class="function">gimp_context_set_interpolation()</code></a>,
<a class="link" href="libgimp-gimpcontext.html#gimp-context-set-transform-direction" title="gimp_context_set_transform_direction ()"><code class="function">gimp_context_set_transform_direction()</code></a>,
<a class="link" href="libgimp-gimpcontext.html#gimp-context-set-transform-resize" title="gimp_context_set_transform_resize ()"><code class="function">gimp_context_set_transform_resize()</code></a>.</p>
@ -605,18 +641,23 @@ gimp_item_transform_2d (<em class="parameter"><code><a href="../glib/glib-Basic-
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> dest_x</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> dest_y</code></em>);</pre>
<p>Transform the specified item in 2d.</p>
<p>This procedure transforms the specified item. If a selection exists
and the item is a drawable, 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 or the item is not a drawable, this will be equal to the
item ID supplied as input. Otherwise, this will be the newly created
and transformed drawable.
This procedure is affected by the following context setters:
<p>This procedure transforms the specified item.</p>
<p>The transformation is done by scaling 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).</p>
<p>If a selection exists and the item is a drawable, 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 as
specified. The return value is the ID of the transformed floating
selection.</p>
<p>If there is no selection or the item is not a drawable, the entire
item will be transformed according to the specified parameters.
Additionally, if the item has its linked flag set to TRUE, all
additional items contained in the image which have the linked flag
set to TRUE will also be transformed the same way. The return value
will be equal to the item ID supplied as input.</p>
<p>This procedure is affected by the following context setters:
<a class="link" href="libgimp-gimpcontext.html#gimp-context-set-interpolation" title="gimp_context_set_interpolation ()"><code class="function">gimp_context_set_interpolation()</code></a>,
<a class="link" href="libgimp-gimpcontext.html#gimp-context-set-transform-direction" title="gimp_context_set_transform_direction ()"><code class="function">gimp_context_set_transform_direction()</code></a>,
<a class="link" href="libgimp-gimpcontext.html#gimp-context-set-transform-resize" title="gimp_context_set_transform_resize ()"><code class="function">gimp_context_set_transform_resize()</code></a>.</p>
@ -693,16 +734,21 @@ gimp_item_transform_matrix (<em class="parameter"><code><a href="../glib/glib-Ba
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> coeff_2_1</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> coeff_2_2</code></em>);</pre>
<p>Transform the specified item in 2d.</p>
<p>This procedure transforms the specified item. If a selection exists
and the item is a drawable, 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 transformed item. If there was no
selection or the item is not a drawable, this will be equal to the
item ID supplied as input. Otherwise, this will be the newly created
and transformed drawable.
This procedure is affected by the following context setters:
<p>This procedure transforms the specified item.</p>
<p>The transformation is done by assembling a 3x3 matrix from the
coefficients passed.</p>
<p>If a selection exists and the item is a drawable, 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 as
specified. The return value is the ID of the transformed floating
selection.</p>
<p>If there is no selection or the item is not a drawable, the entire
item will be transformed according to the specified matrix.
Additionally, if the item has its linked flag set to TRUE, all
additional items contained in the image which have the linked flag
set to TRUE will also be transformed the same way. The return value
will be equal to the item ID supplied as input.</p>
<p>This procedure is affected by the following context setters:
<a class="link" href="libgimp-gimpcontext.html#gimp-context-set-interpolation" title="gimp_context_set_interpolation ()"><code class="function">gimp_context_set_interpolation()</code></a>,
<a class="link" href="libgimp-gimpcontext.html#gimp-context-set-transform-direction" title="gimp_context_set_transform_direction ()"><code class="function">gimp_context_set_transform_direction()</code></a>,
<a class="link" href="libgimp-gimpcontext.html#gimp-context-set-transform-resize" title="gimp_context_set_transform_resize ()"><code class="function">gimp_context_set_transform_resize()</code></a>.</p>