cairo/doc/reference/xml/cairo_set_target_surface.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>surfacee</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 calid at least until another surface was selected or the <link linkend="cairo_t">cairo_t</link> is destroyed.
    </para>
  </refsect1>
</refentry>