Imported Upstream version 2.4.0~rc3

This commit is contained in:
Ari Pollak
2010-08-11 01:23:08 -04:00
parent 4be5597e32
commit f35d8506c6
668 changed files with 59324 additions and 37769 deletions

View File

@ -88,7 +88,13 @@ A widget providing a preview with fixed aspect ratio.
<link linkend="gboolean">gboolean</link> *toggle);</programlisting>
<para>
Creates a new <link linkend="GimpAspectPreview"><type>GimpAspectPreview</type></link> widget for <parameter>drawable</parameter>. See also
<link linkend="gimp-drawable-preview-new"><function>gimp_drawable_preview_new()</function></link>.</para>
<link linkend="gimp-drawable-preview-new"><function>gimp_drawable_preview_new()</function></link>.
</para>
<para>
In GIMP 2.2 the <parameter>toggle</parameter> parameter was provided to conviently access
the state of the "Preview" check-button. This is not any longer
necessary as the preview itself now stores this state, as well as
the scroll offset.</para>
<para>
</para><variablelist role="params">
@ -96,8 +102,7 @@ Creates a new <link linkend="GimpAspectPreview"><type>GimpAspectPreview</type></
<listitem><simpara> a <link linkend="GimpDrawable"><type>GimpDrawable</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>toggle</parameter>&nbsp;:</term>
<listitem><simpara> pointer to a <link linkend="gboolean"><type>gboolean</type></link> variable to sync with the "Preview"
check-button or <link linkend="NULL:CAPS"><literal>NULL</literal></link>
<listitem><simpara> unused
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>

View File

@ -46,6 +46,8 @@
<link linkend="gboolean">gboolean</link> <link linkend="gimp-context-set-font">gimp_context_set_font</link> (const <link linkend="gchar">gchar</link> *name);
<link linkend="gchar">gchar</link>* <link linkend="gimp-context-get-paint-method">gimp_context_get_paint_method</link> (void);
<link linkend="gboolean">gboolean</link> <link linkend="gimp-context-set-paint-method">gimp_context_set_paint_method</link> (const <link linkend="gchar">gchar</link> *name);
<link linkend="gboolean">gboolean</link> <link linkend="gimp-context-list-paint-methods">gimp_context_list_paint_methods</link> (<link linkend="gint">gint</link> *num_paint_methods,
<link linkend="gchar">gchar</link> ***paint_methods);
</synopsis>
</refsynopsisdiv>
@ -538,6 +540,30 @@ all subsequent paint operations.</para>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> TRUE on success.
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since GIMP 2.4
</para></refsect2>
<refsect2>
<title><anchor id="gimp-context-list-paint-methods" role="function" condition="since:GIMP 2.4"/>gimp_context_list_paint_methods ()</title>
<indexterm role="GIMP 2.4"><primary>gimp_context_list_paint_methods</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> gimp_context_list_paint_methods (<link linkend="gint">gint</link> *num_paint_methods,
<link linkend="gchar">gchar</link> ***paint_methods);</programlisting>
<para>
Lists the available paint methods.
</para>
<para>
This procedure lists the names of the available paint methods. Any
of the results can be used for <link linkend="gimp-context-set-paint-method"><function>gimp_context_set_paint_method()</function></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>num_paint_methods</parameter>&nbsp;:</term>
<listitem><simpara> The number of the available paint methods.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>paint_methods</parameter>&nbsp;:</term>
<listitem><simpara> The names of the available paint methods.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> TRUE on success.
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since GIMP 2.4
</para></refsect2>

View File

@ -91,11 +91,13 @@ A widget providing a preview of a <link linkend="GimpDrawable"><type>GimpDrawabl
<indexterm role="GIMP 2.2"><primary>gimp_drawable_preview_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>* gimp_drawable_preview_new (<link linkend="GimpDrawable">GimpDrawable</link> *drawable,
<link linkend="gboolean">gboolean</link> *toggle);</programlisting>
<para>
Creates a new <link linkend="GimpDrawablePreview"><type>GimpDrawablePreview</type></link> widget for <parameter>drawable</parameter>. If
updating the preview takes considerable time, you will want to
store the state of the "Preview" check-button in the plug-in
data. For convenience you can pass a pointer to the <link linkend="gboolean"><type>gboolean</type></link> as
<parameter>toggle</parameter>.</para>
Creates a new <link linkend="GimpDrawablePreview"><type>GimpDrawablePreview</type></link> widget for <parameter>drawable</parameter>.
</para>
<para>
In GIMP 2.2 the <parameter>toggle</parameter> parameter was provided to conviently access
the state of the "Preview" check-button. This is not any longer
necessary as the preview itself now stores this state, as well as
the scroll offset.</para>
<para>
</para><variablelist role="params">
@ -103,8 +105,7 @@ data. For convenience you can pass a pointer to the <link linkend="gboolean"><ty
<listitem><simpara> a <link linkend="GimpDrawable"><type>GimpDrawable</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>toggle</parameter>&nbsp;:</term>
<listitem><simpara> pointer to a <link linkend="gboolean"><type>gboolean</type></link> variable to sync with the "Preview"
check-button or <link linkend="NULL:CAPS"><literal>NULL</literal></link>
<listitem><simpara> unused
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> A pointer to the new <link linkend="GimpDrawablePreview"><type>GimpDrawablePreview</type></link> widget.

View File

@ -293,10 +293,10 @@ transform.</para>
<listitem><simpara> Type of interpolation.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>supersample</parameter>&nbsp;:</term>
<listitem><simpara> Whether to perform supersample.
<listitem><simpara> This parameter is ignored, supersampling is performed based on the interpolation type.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>recursion_level</parameter>&nbsp;:</term>
<listitem><simpara> Level of recursion (3 is a nice default).
<listitem><simpara> Maximum recursion level used for supersampling (3 is a nice value).
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>clip_result</parameter>&nbsp;:</term>
<listitem><simpara> Whether to clip results.
@ -425,10 +425,10 @@ to have been projected via a perspective transform.</para>
<listitem><simpara> Type of interpolation.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>supersample</parameter>&nbsp;:</term>
<listitem><simpara> Whether to perform supersample.
<listitem><simpara> This parameter is ignored, supersampling is performed based on the interpolation type.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>recursion_level</parameter>&nbsp;:</term>
<listitem><simpara> Level of recursion (3 is a nice default).
<listitem><simpara> Maximum recursion level used for supersampling (3 is a nice value).
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>clip_result</parameter>&nbsp;:</term>
<listitem><simpara> How to clip results.
@ -597,10 +597,10 @@ this will be the newly created and rotated drawable.</para>
<listitem><simpara> Type of interpolation.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>supersample</parameter>&nbsp;:</term>
<listitem><simpara> Whether to perform supersample.
<listitem><simpara> This parameter is ignored, supersampling is performed based on the interpolation type.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>recursion_level</parameter>&nbsp;:</term>
<listitem><simpara> Level of recursion (3 is a nice default).
<listitem><simpara> Maximum recursion level used for supersampling (3 is a nice value).
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>clip_result</parameter>&nbsp;:</term>
<listitem><simpara> How to clip results.
@ -705,10 +705,10 @@ this will be the newly created and scaled drawable.</para>
<listitem><simpara> Type of interpolation.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>supersample</parameter>&nbsp;:</term>
<listitem><simpara> Whether to perform supersample.
<listitem><simpara> This parameter is ignored, supersampling is performed based on the interpolation type.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>recursion_level</parameter>&nbsp;:</term>
<listitem><simpara> Level of recursion (3 is a nice default).
<listitem><simpara> Maximum recursion level used for supersampling (3 is a nice value).
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>clip_result</parameter>&nbsp;:</term>
<listitem><simpara> How to clip results.
@ -808,10 +808,10 @@ indicates the extent (in pixels) to shear by.</para>
<listitem><simpara> Type of interpolation.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>supersample</parameter>&nbsp;:</term>
<listitem><simpara> Whether to perform supersample.
<listitem><simpara> This parameter is ignored, supersampling is performed based on the interpolation type.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>recursion_level</parameter>&nbsp;:</term>
<listitem><simpara> Level of recursion (3 is a nice default).
<listitem><simpara> Maximum recursion level used for supersampling (3 is a nice value).
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>clip_result</parameter>&nbsp;:</term>
<listitem><simpara> How to clip results.
@ -923,10 +923,10 @@ Otherwise, this will be the newly created and transformed drawable.</para>
<listitem><simpara> Type of interpolation.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>supersample</parameter>&nbsp;:</term>
<listitem><simpara> Whether to perform supersample.
<listitem><simpara> This parameter is ignored, supersampling is performed based on the interpolation type.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>recursion_level</parameter>&nbsp;:</term>
<listitem><simpara> Level of recursion (3 is a nice default).
<listitem><simpara> Maximum recursion level used for supersampling (3 is a nice value).
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>clip_result</parameter>&nbsp;:</term>
<listitem><simpara> How to clip results.
@ -1062,10 +1062,10 @@ Otherwise, this will be the newly created and transformed drawable.</para>
<listitem><simpara> Type of interpolation.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>supersample</parameter>&nbsp;:</term>
<listitem><simpara> Whether to perform supersample.
<listitem><simpara> This parameter is ignored, supersampling is performed based on the interpolation type.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>recursion_level</parameter>&nbsp;:</term>
<listitem><simpara> Level of recursion (3 is a nice default).
<listitem><simpara> Maximum recursion level used for supersampling (3 is a nice value).
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>clip_result</parameter>&nbsp;:</term>
<listitem><simpara> How to clip results.

View File

@ -44,6 +44,7 @@
<link linkend="gint">gint</link> offx,
<link linkend="gint">gint</link> offy);
<link linkend="gboolean">gboolean</link> <link linkend="gimp-layer-add-alpha">gimp_layer_add_alpha</link> (<link linkend="gint32">gint32</link> layer_ID);
<link linkend="gboolean">gboolean</link> <link linkend="gimp-layer-flatten">gimp_layer_flatten</link> (<link linkend="gint32">gint32</link> layer_ID);
<link linkend="gboolean">gboolean</link> <link linkend="gimp-layer-set-offsets">gimp_layer_set_offsets</link> (<link linkend="gint32">gint32</link> layer_ID,
<link linkend="gint">gint</link> offx,
<link linkend="gint">gint</link> offy);
@ -293,10 +294,9 @@ Add an alpha channel to the layer if it doesn't already have one.
<para>
This procedure adds an additional component to the specified layer
if it does not already possess an alpha channel. An alpha channel
makes it possible to move a layer from the bottom of the layer stack
and to clear and erase to transparency, instead of the background
color. This transforms images of type RGB to RGBA, GRAY to GRAYA,
and INDEXED to INDEXEDA.</para>
makes it possible to clear and erase to transparency, instead of the
background color. This transforms layers of type RGB to RGBA, GRAY
to GRAYA, and INDEXED to INDEXEDA.</para>
<para>
</para><variablelist role="params">
@ -307,6 +307,28 @@ and INDEXED to INDEXEDA.</para>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gimp-layer-flatten" role="function" condition="since:GIMP 2.4"/>gimp_layer_flatten ()</title>
<indexterm role="GIMP 2.4"><primary>gimp_layer_flatten</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> gimp_layer_flatten (<link linkend="gint32">gint32</link> layer_ID);</programlisting>
<para>
Remove the alpha channel from the layer if it has one.
</para>
<para>
This procedure removes the alpha channel from a layer, blending all
(partially) transparent pixels in the layer against the background
color. This transforms layers of type RGBA to RGB, GRAYA to GRAY,
and INDEXEDA to INDEXED.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>layer_ID</parameter>&nbsp;:</term>
<listitem><simpara> The layer.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> TRUE on success.
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since GIMP 2.4
</para></refsect2>
<refsect2>
<title><anchor id="gimp-layer-set-offsets" role="function"/>gimp_layer_set_offsets ()</title>
<indexterm><primary>gimp_layer_set_offsets</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> gimp_layer_set_offsets (<link linkend="gint32">gint32</link> layer_ID,
<link linkend="gint">gint</link> offx,