cairo/doc/reference/xml/cairo_set_target_surface.xml

41 lines
1.6 KiB
XML

<refentry id="cairo_set_target_surface">
<refmeta>
<refentrytitle>cairo_set_target_surface</refentrytitle>
<manvolnum>3</manvolnum>
</refmeta>
<refnamediv>
<refname>cairo_set_target_surface</refname>
<refpurpose>set surface for painting operations </refpurpose>
</refnamediv>
<refsynopsisdiv>
<programlisting>
void cairo_set_target_surface (<link linkend="cairo_t">cairo_t</link> *cr, <link linkend="cairo_surface_t">cairo_surface_t</link> *surface)</programlisting>
<variablelist role="params">
<varlistentry>
<term><parameter>cr</parameter> :</term>
<listitem>
<simpara>a <link linkend="cairo_t">cairo_t</link></simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>surface</parameter> :</term>
<listitem>
<simpara>an allocated <link linkend="cairo_surface_t">cairo_surface_t</link></simpara>
</listitem>
</varlistentry>
</variablelist>
</refsynopsisdiv>
<refsect1>
<title>Description</title>
<para>
<indexterm>
<primary>functions</primary>
<secondary>cairo_set_target_surface</secondary>
</indexterm>
<indexterm>
<primary/>
</indexterm>
Selects <varname>surface</varname> as the surface to draw on. If there already is a surface set, it will be substituted by <varname>surface</varname>. It references <varname>surface</varname>e to ensure that it will be valid at least until another surface was selected or the <link linkend="cairo_t">cairo_t</link> is destroyed.
</para>
</refsect1>
</refentry>