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

Imported Upstream version 2.4.0~rc2

Browse Source
This commit is contained in:
Ari Pollak
2010-08-11 01:22:44 -04:00
parent d884b2912c
commit 4be5597e32
576 changed files with 70261 additions and 80724 deletions
Download Patch File Download Diff File Expand all files Collapse all files

290
devel-docs/libgimp/html/libgimp-gimppixbuf.html
View File

@ -3,7 +3,7 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>gimppixbuf</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.72.0">
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
<link rel="start" href="index.html" title="GIMP Library Reference Manual">
<link rel="up" href="libgimpui.html" title="Part&#160;II.&#160;GIMP User Interface Library">
<link rel="prev" href="GimpImageComboBox.html" title="gimpimagecombobox">
@ -31,16 +31,16 @@
<th width="100%" align="center">GIMP Library Reference Manual</th>
<td><a accesskey="n" href="GimpProgressBar.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2589060" class="shortcut">Top</a>
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2627047" class="shortcut">Top</a>
&#160;|&#160;
<a href="#id2714961" class="shortcut">Description</a></nobr></td></tr>
<a href="#id2733143" class="shortcut">Description</a></nobr></td></tr>
</table>
<div class="refentry" lang="en">
<a name="libgimp-gimppixbuf"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2>
<a name="id2589060"></a><span class="refentrytitle">gimppixbuf</span>
<a name="id2627047"></a><span class="refentrytitle">gimppixbuf</span>
</h2>
<p>gimppixbuf &#8212; Get a thumbnail pixbuf for a drawable or image.</p>
</td>
@ -52,90 +52,44 @@
enum <a href="libgimp-gimppixbuf.html#GimpPixbufTransparency">GimpPixbufTransparency</a>;
<a
href="../gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
>GdkPixbuf</a>* <a href="libgimp-gimppixbuf.html#gimp-image-get-thumbnail">gimp_image_get_thumbnail</a> (<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> image_ID,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> width,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> height,
<a href="libgimp-gimppixbuf.html#GimpPixbufTransparency">GimpPixbufTransparency</a> alpha);
<a
href="../gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
>GdkPixbuf</a>* <a href="libgimp-gimppixbuf.html#gimp-drawable-get-thumbnail">gimp_drawable_get_thumbnail</a> (<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> drawable_ID,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> width,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> height,
<a href="libgimp-gimppixbuf.html#GimpPixbufTransparency">GimpPixbufTransparency</a> alpha);
<a
href="../gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
>GdkPixbuf</a>* <a href="libgimp-gimppixbuf.html#gimp-drawable-get-sub-thumbnail">gimp_drawable_get_sub_thumbnail</a> (<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> drawable_ID,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> src_x,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> src_y,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> src_width,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> src_height,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> dest_width,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> dest_height,
<a href="libgimp-gimppixbuf.html#GimpPixbufTransparency">GimpPixbufTransparency</a> alpha);
<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> <a href="libgimp-gimppixbuf.html#gimp-layer-new-from-pixbuf">gimp_layer_new_from_pixbuf</a> (<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> image_ID,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *name,
<a
href="../gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
>GdkPixbuf</a> *pixbuf,
<a
href="../glib/glib-Basic-Types.html#gdouble"
>gdouble</a> opacity,
<a href="libgimp-gimpenums.html#GimpLayerModeEffects">GimpLayerModeEffects</a> mode,
<a
href="../glib/glib-Basic-Types.html#gdouble"
>gdouble</a> progress_start,
<a
href="../glib/glib-Basic-Types.html#gdouble"
>gdouble</a> progress_end);
enum <a class="link" href="libgimp-gimppixbuf.html#GimpPixbufTransparency">GimpPixbufTransparency</a>;
GdkPixbuf* <a class="link" href="libgimp-gimppixbuf.html#gimp-image-get-thumbnail">gimp_image_get_thumbnail</a> (gint32 image_ID,
gint width,
gint height,
<a class="link" href="libgimp-gimppixbuf.html#GimpPixbufTransparency">GimpPixbufTransparency</a> alpha);
GdkPixbuf* <a class="link" href="libgimp-gimppixbuf.html#gimp-drawable-get-thumbnail">gimp_drawable_get_thumbnail</a> (gint32 drawable_ID,
gint width,
gint height,
<a class="link" href="libgimp-gimppixbuf.html#GimpPixbufTransparency">GimpPixbufTransparency</a> alpha);
GdkPixbuf* <a class="link" href="libgimp-gimppixbuf.html#gimp-drawable-get-sub-thumbnail">gimp_drawable_get_sub_thumbnail</a> (gint32 drawable_ID,
gint src_x,
gint src_y,
gint src_width,
gint src_height,
gint dest_width,
gint dest_height,
<a class="link" href="libgimp-gimppixbuf.html#GimpPixbufTransparency">GimpPixbufTransparency</a> alpha);
gint32 <a class="link" href="libgimp-gimppixbuf.html#gimp-layer-new-from-pixbuf">gimp_layer_new_from_pixbuf</a> (gint32 image_ID,
const gchar *name,
GdkPixbuf *pixbuf,
gdouble opacity,
<a class="link" href="libgimp-gimpenums.html#GimpLayerModeEffects">GimpLayerModeEffects</a> mode,
gdouble progress_start,
gdouble progress_end);
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id2714961"></a><h2>Description</h2>
<a name="id2733143"></a><h2>Description</h2>
<p>
Get a thumbnail pixbuf for a drawable or image.
</p>
</div>
<div class="refsect1" lang="en">
<a name="id2716516"></a><h2>Details</h2>
<a name="id2735497"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="id2716526"></a><h3>
<a name="id2735507"></a><h3>
<a name="GimpPixbufTransparency"></a>enum GimpPixbufTransparency</h3>
<a class="indexterm" name="id2716537"></a><pre class="programlisting">typedef enum
<a class="indexterm" name="id2735518"></a><pre class="programlisting">typedef enum
{
GIMP_PIXBUF_KEEP_ALPHA,
GIMP_PIXBUF_SMALL_CHECKS,
@ -148,20 +102,12 @@ Get a thumbnail pixbuf for a drawable or image.
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2716554"></a><h3>
<a name="id2735535"></a><h3>
<a name="gimp-image-get-thumbnail"></a>gimp_image_get_thumbnail ()</h3>
<a class="indexterm" name="id2716567"></a><pre class="programlisting"><a
href="../gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
>GdkPixbuf</a>* gimp_image_get_thumbnail (<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> image_ID,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> width,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> height,
<a href="libgimp-gimppixbuf.html#GimpPixbufTransparency">GimpPixbufTransparency</a> alpha);</pre>
<a class="indexterm" name="id2735548"></a><pre class="programlisting">GdkPixbuf* gimp_image_get_thumbnail (gint32 image_ID,
gint width,
gint height,
<a class="link" href="libgimp-gimppixbuf.html#GimpPixbufTransparency">GimpPixbufTransparency</a> alpha);</pre>
<p>
Retrieves a thumbnail pixbuf for the image identified by <em class="parameter"><code>image_ID</code></em>.
The thumbnail will be not larger than the requested size.</p>
@ -172,30 +118,28 @@ The thumbnail will be not larger than the requested size.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>image_ID</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>image_ID</code></em>&#160;:</span></p></td>
<td> the image ID
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>width</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>width</code></em>&#160;:</span></p></td>
<td> the requested thumbnail width (&lt;= 1024 pixels)
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>height</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>height</code></em>&#160;:</span></p></td>
<td> the requested thumbnail height (&lt;= 1024 pixels)
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>alpha</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>alpha</code></em>&#160;:</span></p></td>
<td> how to handle an alpha channel
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> a new <a
href="../gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
><span class="type">GdkPixbuf</span></a>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> a new <span class="type">GdkPixbuf</span>
</td>
</tr>
@ -206,20 +150,12 @@ href="../gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2719182"></a><h3>
<a name="id2732225"></a><h3>
<a name="gimp-drawable-get-thumbnail"></a>gimp_drawable_get_thumbnail ()</h3>
<a class="indexterm" name="id2719195"></a><pre class="programlisting"><a
href="../gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
>GdkPixbuf</a>* gimp_drawable_get_thumbnail (<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> drawable_ID,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> width,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> height,
<a href="libgimp-gimppixbuf.html#GimpPixbufTransparency">GimpPixbufTransparency</a> alpha);</pre>
<a class="indexterm" name="id2732238"></a><pre class="programlisting">GdkPixbuf* gimp_drawable_get_thumbnail (gint32 drawable_ID,
gint width,
gint height,
<a class="link" href="libgimp-gimppixbuf.html#GimpPixbufTransparency">GimpPixbufTransparency</a> alpha);</pre>
<p>
Retrieves a thumbnail pixbuf for the drawable identified by
<em class="parameter"><code>drawable_ID</code></em>. The thumbnail will be not larger than the requested
@ -231,30 +167,28 @@ size.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>drawable_ID</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>drawable_ID</code></em>&#160;:</span></p></td>
<td> the drawable ID
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>width</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>width</code></em>&#160;:</span></p></td>
<td> the requested thumbnail width (&lt;= 1024 pixels)
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>height</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>height</code></em>&#160;:</span></p></td>
<td> the requested thumbnail height (&lt;= 1024 pixels)
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>alpha</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>alpha</code></em>&#160;:</span></p></td>
<td> how to handle an alpha channel
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> a new <a
href="../gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
><span class="type">GdkPixbuf</span></a>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> a new <span class="type">GdkPixbuf</span>
</td>
</tr>
@ -265,32 +199,16 @@ href="../gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2719341"></a><h3>
<a name="id2732383"></a><h3>
<a name="gimp-drawable-get-sub-thumbnail"></a>gimp_drawable_get_sub_thumbnail ()</h3>
<a class="indexterm" name="id2719354"></a><pre class="programlisting"><a
href="../gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
>GdkPixbuf</a>* gimp_drawable_get_sub_thumbnail (<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> drawable_ID,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> src_x,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> src_y,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> src_width,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> src_height,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> dest_width,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> dest_height,
<a href="libgimp-gimppixbuf.html#GimpPixbufTransparency">GimpPixbufTransparency</a> alpha);</pre>
<a class="indexterm" name="id2732397"></a><pre class="programlisting">GdkPixbuf* gimp_drawable_get_sub_thumbnail (gint32 drawable_ID,
gint src_x,
gint src_y,
gint src_width,
gint src_height,
gint dest_width,
gint dest_height,
<a class="link" href="libgimp-gimppixbuf.html#GimpPixbufTransparency">GimpPixbufTransparency</a> alpha);</pre>
<p>
Retrieves a thumbnail pixbuf for the drawable identified by
<em class="parameter"><code>drawable_ID</code></em>. The thumbnail will be not larger than the requested
@ -302,50 +220,48 @@ size.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>drawable_ID</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>drawable_ID</code></em>&#160;:</span></p></td>
<td> the drawable ID
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>src_x</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>src_x</code></em>&#160;:</span></p></td>
<td> the x coordinate of the area
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>src_y</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>src_y</code></em>&#160;:</span></p></td>
<td> the y coordinate of the area
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>src_width</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>src_width</code></em>&#160;:</span></p></td>
<td> the width of the area
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>src_height</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>src_height</code></em>&#160;:</span></p></td>
<td> the height of the area
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>dest_width</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>dest_width</code></em>&#160;:</span></p></td>
<td> the requested thumbnail width (&lt;= 1024 pixels)
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>dest_height</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>dest_height</code></em>&#160;:</span></p></td>
<td> the requested thumbnail height (&lt;= 1024 pixels)
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>alpha</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>alpha</code></em>&#160;:</span></p></td>
<td> how to handle an alpha channel
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> a new <a
href="../gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
><span class="type">GdkPixbuf</span></a>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> a new <span class="type">GdkPixbuf</span>
</td>
</tr>
@ -356,45 +272,27 @@ href="../gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2709408"></a><h3>
<a name="id2733355"></a><h3>
<a name="gimp-layer-new-from-pixbuf"></a>gimp_layer_new_from_pixbuf ()</h3>
<a class="indexterm" name="id2709422"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> gimp_layer_new_from_pixbuf (<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> image_ID,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *name,
<a
href="../gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
>GdkPixbuf</a> *pixbuf,
<a
href="../glib/glib-Basic-Types.html#gdouble"
>gdouble</a> opacity,
<a href="libgimp-gimpenums.html#GimpLayerModeEffects">GimpLayerModeEffects</a> mode,
<a
href="../glib/glib-Basic-Types.html#gdouble"
>gdouble</a> progress_start,
<a
href="../glib/glib-Basic-Types.html#gdouble"
>gdouble</a> progress_end);</pre>
<a class="indexterm" name="id2733368"></a><pre class="programlisting">gint32 gimp_layer_new_from_pixbuf (gint32 image_ID,
const gchar *name,
GdkPixbuf *pixbuf,
gdouble opacity,
<a class="link" href="libgimp-gimpenums.html#GimpLayerModeEffects">GimpLayerModeEffects</a> mode,
gdouble progress_start,
gdouble progress_end);</pre>
<p>
Create a new layer from a <a
href="../gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
><code class="literal">GdkPixbuf</code></a>.
Create a new layer from a <code class="literal">GdkPixbuf</code>.
</p>
<p>
This procedure creates a new layer from the given <a
href="../gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
><code class="literal">GdkPixbuf</code></a>. The
image has to be an RGB image and just like with <a href="libgimp-gimplayer.html#gimp-layer-new"><code class="function">gimp_layer_new()</code></a>
This procedure creates a new layer from the given <code class="literal">GdkPixbuf</code>. The
image has to be an RGB image and just like with <a class="link" href="libgimp-gimplayer.html#gimp-layer-new"><code class="function">gimp_layer_new()</code></a>
you will still need to add the layer to it.
</p>
<p>
If you pass <em class="parameter"><code>progress_end</code></em> &gt; <em class="parameter"><code>progress_start</code></em> to this function,
@<a href="libgimp-gimpprogress.html#gimp-progress-update"><code class="function">gimp_progress_update()</code></a> will be called for. You have to call
@<a href="libgimp-gimpprogress.html#gimp-progress-init"><code class="function">gimp_progress_init()</code></a> beforehand.</p>
@<a class="link" href="libgimp-gimpprogress.html#gimp-progress-update"><code class="function">gimp_progress_update()</code></a> will be called for. You have to call
@<a class="link" href="libgimp-gimpprogress.html#gimp-progress-init"><code class="function">gimp_progress_init()</code></a> beforehand.</p>
<p>
</p>
@ -402,42 +300,42 @@ If you pass <em class="parameter"><code>progress_end</code></em> &gt; <em class=
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>image_ID</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>image_ID</code></em>&#160;:</span></p></td>
<td> The RGB image to which to add the layer.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>name</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>name</code></em>&#160;:</span></p></td>
<td> The layer name.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>pixbuf</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>pixbuf</code></em>&#160;:</span></p></td>
<td> A GdkPixbuf.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>opacity</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>opacity</code></em>&#160;:</span></p></td>
<td> The layer opacity.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>mode</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>mode</code></em>&#160;:</span></p></td>
<td> The layer combination mode.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>progress_start</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>progress_start</code></em>&#160;:</span></p></td>
<td> start of progress
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>progress_end</code></em>&#160;:</span></td>
<td><p><span class="term"><em class="parameter"><code>progress_end</code></em>&#160;:</span></p></td>
<td> end of progress
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> The newly created layer.
</td>