summaryrefslogtreecommitdiff
path: root/libs/cairo-1.16.0/doc/public/xml/cairo-image.xml
diff options
context:
space:
mode:
authorsanine <sanine.not@pm.me>2023-02-12 23:53:22 -0600
committersanine <sanine.not@pm.me>2023-02-12 23:53:22 -0600
commitf1fe73d1909a2448a004a88362a1a532d0d4f7c3 (patch)
treeab37ae3837e2f858de2932bcee9f26e69fab3db1 /libs/cairo-1.16.0/doc/public/xml/cairo-image.xml
parentf567ea1e2798fd3156a416e61f083ea3e6b95719 (diff)
switch to tinyobj and nanovg from assimp and cairo
Diffstat (limited to 'libs/cairo-1.16.0/doc/public/xml/cairo-image.xml')
-rw-r--r--libs/cairo-1.16.0/doc/public/xml/cairo-image.xml425
1 files changed, 0 insertions, 425 deletions
diff --git a/libs/cairo-1.16.0/doc/public/xml/cairo-image.xml b/libs/cairo-1.16.0/doc/public/xml/cairo-image.xml
deleted file mode 100644
index f9c9443..0000000
--- a/libs/cairo-1.16.0/doc/public/xml/cairo-image.xml
+++ /dev/null
@@ -1,425 +0,0 @@
-<?xml version='1.0' encoding='UTF-8'?>
-<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
- "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
-<!ENTITY version SYSTEM "version.xml">
-]>
-<refentry id="cairo-Image-Surfaces">
-<refmeta>
-<refentrytitle role="top_of_page" id="cairo-Image-Surfaces.top_of_page">Image Surfaces</refentrytitle>
-<manvolnum>3</manvolnum>
-<refmiscinfo>CAIRO Library</refmiscinfo>
-</refmeta>
-<refnamediv>
-<refname>Image Surfaces</refname>
-<refpurpose>Rendering to memory buffers</refpurpose>
-</refnamediv>
-
-<refsect1 id="cairo-Image-Surfaces.functions" role="functions_proto">
-<title role="functions_proto.title">Functions</title>
-<informaltable pgwide="1" frame="none">
-<tgroup cols="2">
-<colspec colname="functions_return" colwidth="150px"/>
-<colspec colname="functions_name"/>
-<tbody>
-<row><entry role="function_type"><link linkend="int"><returnvalue>int</returnvalue></link>
-</entry><entry role="function_name"><link linkend="cairo-format-stride-for-width">cairo_format_stride_for_width</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
-<row><entry role="function_type"><link linkend="cairo-surface-t"><returnvalue>cairo_surface_t</returnvalue></link>&#160;*
-</entry><entry role="function_name"><link linkend="cairo-image-surface-create">cairo_image_surface_create</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
-<row><entry role="function_type"><link linkend="cairo-surface-t"><returnvalue>cairo_surface_t</returnvalue></link>&#160;*
-</entry><entry role="function_name"><link linkend="cairo-image-surface-create-for-data">cairo_image_surface_create_for_data</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
-<row><entry role="function_type">unsigned <link linkend="char"><returnvalue>char</returnvalue></link>&#160;*
-</entry><entry role="function_name"><link linkend="cairo-image-surface-get-data">cairo_image_surface_get_data</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
-<row><entry role="function_type"><link linkend="cairo-format-t"><returnvalue>cairo_format_t</returnvalue></link>
-</entry><entry role="function_name"><link linkend="cairo-image-surface-get-format">cairo_image_surface_get_format</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
-<row><entry role="function_type"><link linkend="int"><returnvalue>int</returnvalue></link>
-</entry><entry role="function_name"><link linkend="cairo-image-surface-get-width">cairo_image_surface_get_width</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
-<row><entry role="function_type"><link linkend="int"><returnvalue>int</returnvalue></link>
-</entry><entry role="function_name"><link linkend="cairo-image-surface-get-height">cairo_image_surface_get_height</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
-<row><entry role="function_type"><link linkend="int"><returnvalue>int</returnvalue></link>
-</entry><entry role="function_name"><link linkend="cairo-image-surface-get-stride">cairo_image_surface_get_stride</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
-
-</tbody>
-</tgroup>
-</informaltable>
-</refsect1>
-<refsect1 id="cairo-Image-Surfaces.other" role="other_proto">
-<title role="other_proto.title">Types and Values</title>
-<informaltable role="enum_members_table" pgwide="1" frame="none">
-<tgroup cols="2">
-<colspec colname="name" colwidth="150px"/>
-<colspec colname="description"/>
-<tbody>
-<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="CAIRO-HAS-IMAGE-SURFACE:CAPS">CAIRO_HAS_IMAGE_SURFACE</link></entry></row>
-<row><entry role="datatype_keyword">enum</entry><entry role="function_name"><link linkend="cairo-format-t">cairo_format_t</link></entry></row>
-
-</tbody>
-</tgroup>
-</informaltable>
-</refsect1>
-
-
-<refsect1 id="cairo-Image-Surfaces.description" role="desc">
-<title role="desc.title">Description</title>
-<para>Image surfaces provide the ability to render to memory buffers
-either allocated by cairo or by the calling code. The supported
-image formats are those defined in <link linkend="cairo-format-t"><type>cairo_format_t</type></link>.</para>
-
-</refsect1>
-<refsect1 id="cairo-Image-Surfaces.functions_details" role="details">
-<title role="details.title">Functions</title>
-<refsect2 id="cairo-format-stride-for-width" role="function" condition="since:1.6">
-<title>cairo_format_stride_for_width&#160;()</title>
-<indexterm zone="cairo-format-stride-for-width" role="1.6"><primary sortas="format_stride_for_width">cairo_format_stride_for_width</primary></indexterm>
-<programlisting language="C"><link linkend="int"><returnvalue>int</returnvalue></link>
-cairo_format_stride_for_width (<parameter><link linkend="cairo-format-t"><type>cairo_format_t</type></link> format</parameter>,
- <parameter><link linkend="int"><type>int</type></link> width</parameter>);</programlisting>
-<para>This function provides a stride value that will respect all
-alignment requirements of the accelerated image-rendering code
-within cairo. Typical usage will be of the form:</para>
-<informalexample><programlisting>
-int stride;
-unsigned char *data;
-cairo_surface_t *surface;
-
-stride = cairo_format_stride_for_width (format, width);
-data = malloc (stride * height);
-surface = cairo_image_surface_create_for_data (data, format,
- width, height,
- stride);
-</programlisting></informalexample>
-<refsect3 id="cairo-format-stride-for-width.parameters" role="parameters">
-<title>Parameters</title>
-<informaltable role="parameters_table" pgwide="1" frame="none">
-<tgroup cols="3">
-<colspec colname="parameters_name" colwidth="150px"/>
-<colspec colname="parameters_description"/>
-<colspec colname="parameters_annotations" colwidth="200px"/>
-<tbody>
-<row><entry role="parameter_name"><para>format</para></entry>
-<entry role="parameter_description"><para>A <link linkend="cairo-format-t"><type>cairo_format_t</type></link> value</para></entry>
-<entry role="parameter_annotations"></entry></row>
-<row><entry role="parameter_name"><para>width</para></entry>
-<entry role="parameter_description"><para>The desired width of an image surface to be created.</para></entry>
-<entry role="parameter_annotations"></entry></row>
-</tbody></tgroup></informaltable>
-</refsect3><refsect3 id="cairo-format-stride-for-width.returns" role="returns">
-<title>Returns</title>
-<para> the appropriate stride to use given the desired
-format and width, or -1 if either the format is invalid or the width
-too large.</para>
-</refsect3><para role="since">Since: <link linkend="api-index-1.6">1.6</link></para></refsect2>
-<refsect2 id="cairo-image-surface-create" role="function" condition="since:1.0">
-<title>cairo_image_surface_create&#160;()</title>
-<indexterm zone="cairo-image-surface-create" role="1.0"><primary sortas="image_surface_create">cairo_image_surface_create</primary></indexterm>
-<programlisting language="C"><link linkend="cairo-surface-t"><returnvalue>cairo_surface_t</returnvalue></link>&#160;*
-cairo_image_surface_create (<parameter><link linkend="cairo-format-t"><type>cairo_format_t</type></link> format</parameter>,
- <parameter><link linkend="int"><type>int</type></link> width</parameter>,
- <parameter><link linkend="int"><type>int</type></link> height</parameter>);</programlisting>
-<para>Creates an image surface of the specified format and
-dimensions. Initially the surface contents are set to 0.
-(Specifically, within each pixel, each color or alpha channel
-belonging to format will be 0. The contents of bits within a pixel,
-but not belonging to the given format are undefined).</para>
-<refsect3 id="cairo-image-surface-create.parameters" role="parameters">
-<title>Parameters</title>
-<informaltable role="parameters_table" pgwide="1" frame="none">
-<tgroup cols="3">
-<colspec colname="parameters_name" colwidth="150px"/>
-<colspec colname="parameters_description"/>
-<colspec colname="parameters_annotations" colwidth="200px"/>
-<tbody>
-<row><entry role="parameter_name"><para>format</para></entry>
-<entry role="parameter_description"><para>format of pixels in the surface to create</para></entry>
-<entry role="parameter_annotations"></entry></row>
-<row><entry role="parameter_name"><para>width</para></entry>
-<entry role="parameter_description"><para>width of the surface, in pixels</para></entry>
-<entry role="parameter_annotations"></entry></row>
-<row><entry role="parameter_name"><para>height</para></entry>
-<entry role="parameter_description"><para>height of the surface, in pixels</para></entry>
-<entry role="parameter_annotations"></entry></row>
-</tbody></tgroup></informaltable>
-</refsect3><refsect3 id="cairo-image-surface-create.returns" role="returns">
-<title>Returns</title>
-<para> a pointer to the newly created surface. The caller
-owns the surface and should call <link linkend="cairo-surface-destroy"><function>cairo_surface_destroy()</function></link> when done
-with it.</para>
-<para>This function always returns a valid pointer, but it will return a
-pointer to a "nil" surface if an error such as out of memory
-occurs. You can use <link linkend="cairo-surface-status"><function>cairo_surface_status()</function></link> to check for this.</para>
-</refsect3><para role="since">Since: <link linkend="api-index-1.0">1.0</link></para></refsect2>
-<refsect2 id="cairo-image-surface-create-for-data" role="function" condition="since:1.0">
-<title>cairo_image_surface_create_for_data&#160;()</title>
-<indexterm zone="cairo-image-surface-create-for-data" role="1.0"><primary sortas="image_surface_create_for_data">cairo_image_surface_create_for_data</primary></indexterm>
-<programlisting language="C"><link linkend="cairo-surface-t"><returnvalue>cairo_surface_t</returnvalue></link>&#160;*
-cairo_image_surface_create_for_data (<parameter>unsigned <link linkend="char"><type>char</type></link> *data</parameter>,
- <parameter><link linkend="cairo-format-t"><type>cairo_format_t</type></link> format</parameter>,
- <parameter><link linkend="int"><type>int</type></link> width</parameter>,
- <parameter><link linkend="int"><type>int</type></link> height</parameter>,
- <parameter><link linkend="int"><type>int</type></link> stride</parameter>);</programlisting>
-<para>Creates an image surface for the provided pixel data. The output
-buffer must be kept around until the <link linkend="cairo-surface-t"><type>cairo_surface_t</type></link> is destroyed
-or <link linkend="cairo-surface-finish"><function>cairo_surface_finish()</function></link> is called on the surface. The initial
-contents of <parameter>data</parameter>
- will be used as the initial image contents; you
-must explicitly clear the buffer, using, for example,
-<link linkend="cairo-rectangle"><function>cairo_rectangle()</function></link> and <link linkend="cairo-fill"><function>cairo_fill()</function></link> if you want it cleared.</para>
-<para>Note that the stride may be larger than
-width*bytes_per_pixel to provide proper alignment for each pixel
-and row. This alignment is required to allow high-performance rendering
-within cairo. The correct way to obtain a legal stride value is to
-call <link linkend="cairo-format-stride-for-width"><function>cairo_format_stride_for_width()</function></link> with the desired format and
-maximum image width value, and then use the resulting stride value
-to allocate the data and to create the image surface. See
-<link linkend="cairo-format-stride-for-width"><function>cairo_format_stride_for_width()</function></link> for example code.</para>
-<refsect3 id="cairo-image-surface-create-for-data.parameters" role="parameters">
-<title>Parameters</title>
-<informaltable role="parameters_table" pgwide="1" frame="none">
-<tgroup cols="3">
-<colspec colname="parameters_name" colwidth="150px"/>
-<colspec colname="parameters_description"/>
-<colspec colname="parameters_annotations" colwidth="200px"/>
-<tbody>
-<row><entry role="parameter_name"><para>data</para></entry>
-<entry role="parameter_description"><para>a pointer to a buffer supplied by the application in which
-to write contents. This pointer must be suitably aligned for any
-kind of variable, (for example, a pointer returned by malloc).</para></entry>
-<entry role="parameter_annotations"></entry></row>
-<row><entry role="parameter_name"><para>format</para></entry>
-<entry role="parameter_description"><para>the format of pixels in the buffer</para></entry>
-<entry role="parameter_annotations"></entry></row>
-<row><entry role="parameter_name"><para>width</para></entry>
-<entry role="parameter_description"><para>the width of the image to be stored in the buffer</para></entry>
-<entry role="parameter_annotations"></entry></row>
-<row><entry role="parameter_name"><para>height</para></entry>
-<entry role="parameter_description"><para>the height of the image to be stored in the buffer</para></entry>
-<entry role="parameter_annotations"></entry></row>
-<row><entry role="parameter_name"><para>stride</para></entry>
-<entry role="parameter_description"><para>the number of bytes between the start of rows in the
-buffer as allocated. This value should always be computed by
-<link linkend="cairo-format-stride-for-width"><function>cairo_format_stride_for_width()</function></link> before allocating the data
-buffer.</para></entry>
-<entry role="parameter_annotations"></entry></row>
-</tbody></tgroup></informaltable>
-</refsect3><refsect3 id="cairo-image-surface-create-for-data.returns" role="returns">
-<title>Returns</title>
-<para> a pointer to the newly created surface. The caller
-owns the surface and should call <link linkend="cairo-surface-destroy"><function>cairo_surface_destroy()</function></link> when done
-with it.</para>
-<para>This function always returns a valid pointer, but it will return a
-pointer to a "nil" surface in the case of an error such as out of
-memory or an invalid stride value. In case of invalid stride value
-the error status of the returned surface will be
-<link linkend="CAIRO-STATUS-INVALID-STRIDE:CAPS"><literal>CAIRO_STATUS_INVALID_STRIDE</literal></link>. You can use
-<link linkend="cairo-surface-status"><function>cairo_surface_status()</function></link> to check for this.</para>
-<para>See <link linkend="cairo-surface-set-user-data"><function>cairo_surface_set_user_data()</function></link> for a means of attaching a
-destroy-notification fallback to the surface if necessary.</para>
-</refsect3><para role="since">Since: <link linkend="api-index-1.0">1.0</link></para></refsect2>
-<refsect2 id="cairo-image-surface-get-data" role="function" condition="since:1.2">
-<title>cairo_image_surface_get_data&#160;()</title>
-<indexterm zone="cairo-image-surface-get-data" role="1.2"><primary sortas="image_surface_get_data">cairo_image_surface_get_data</primary></indexterm>
-<programlisting language="C">unsigned <link linkend="char"><returnvalue>char</returnvalue></link>&#160;*
-cairo_image_surface_get_data (<parameter><link linkend="cairo-surface-t"><type>cairo_surface_t</type></link> *surface</parameter>);</programlisting>
-<para>Get a pointer to the data of the image surface, for direct
-inspection or modification.</para>
-<para>A call to <link linkend="cairo-surface-flush"><function>cairo_surface_flush()</function></link> is required before accessing the
-pixel data to ensure that all pending drawing operations are
-finished. A call to <link linkend="cairo-surface-mark-dirty"><function>cairo_surface_mark_dirty()</function></link> is required after
-the data is modified.</para>
-<refsect3 id="cairo-image-surface-get-data.parameters" role="parameters">
-<title>Parameters</title>
-<informaltable role="parameters_table" pgwide="1" frame="none">
-<tgroup cols="3">
-<colspec colname="parameters_name" colwidth="150px"/>
-<colspec colname="parameters_description"/>
-<colspec colname="parameters_annotations" colwidth="200px"/>
-<tbody>
-<row><entry role="parameter_name"><para>surface</para></entry>
-<entry role="parameter_description"><para>a <link linkend="cairo-image-surface-t"><type>cairo_image_surface_t</type></link></para></entry>
-<entry role="parameter_annotations"></entry></row>
-</tbody></tgroup></informaltable>
-</refsect3><refsect3 id="cairo-image-surface-get-data.returns" role="returns">
-<title>Returns</title>
-<para> a pointer to the image data of this surface or <link linkend="NULL:CAPS"><literal>NULL</literal></link>
-if <parameter>surface</parameter>
-is not an image surface, or if <link linkend="cairo-surface-finish"><function>cairo_surface_finish()</function></link>
-has been called.</para>
-</refsect3><para role="since">Since: <link linkend="api-index-1.2">1.2</link></para></refsect2>
-<refsect2 id="cairo-image-surface-get-format" role="function" condition="since:1.2">
-<title>cairo_image_surface_get_format&#160;()</title>
-<indexterm zone="cairo-image-surface-get-format" role="1.2"><primary sortas="image_surface_get_format">cairo_image_surface_get_format</primary></indexterm>
-<programlisting language="C"><link linkend="cairo-format-t"><returnvalue>cairo_format_t</returnvalue></link>
-cairo_image_surface_get_format (<parameter><link linkend="cairo-surface-t"><type>cairo_surface_t</type></link> *surface</parameter>);</programlisting>
-<para>Get the format of the surface.</para>
-<refsect3 id="cairo-image-surface-get-format.parameters" role="parameters">
-<title>Parameters</title>
-<informaltable role="parameters_table" pgwide="1" frame="none">
-<tgroup cols="3">
-<colspec colname="parameters_name" colwidth="150px"/>
-<colspec colname="parameters_description"/>
-<colspec colname="parameters_annotations" colwidth="200px"/>
-<tbody>
-<row><entry role="parameter_name"><para>surface</para></entry>
-<entry role="parameter_description"><para>a <link linkend="cairo-image-surface-t"><type>cairo_image_surface_t</type></link></para></entry>
-<entry role="parameter_annotations"></entry></row>
-</tbody></tgroup></informaltable>
-</refsect3><refsect3 id="cairo-image-surface-get-format.returns" role="returns">
-<title>Returns</title>
-<para> the format of the surface</para>
-</refsect3><para role="since">Since: <link linkend="api-index-1.2">1.2</link></para></refsect2>
-<refsect2 id="cairo-image-surface-get-width" role="function" condition="since:1.0">
-<title>cairo_image_surface_get_width&#160;()</title>
-<indexterm zone="cairo-image-surface-get-width" role="1.0"><primary sortas="image_surface_get_width">cairo_image_surface_get_width</primary></indexterm>
-<programlisting language="C"><link linkend="int"><returnvalue>int</returnvalue></link>
-cairo_image_surface_get_width (<parameter><link linkend="cairo-surface-t"><type>cairo_surface_t</type></link> *surface</parameter>);</programlisting>
-<para>Get the width of the image surface in pixels.</para>
-<refsect3 id="cairo-image-surface-get-width.parameters" role="parameters">
-<title>Parameters</title>
-<informaltable role="parameters_table" pgwide="1" frame="none">
-<tgroup cols="3">
-<colspec colname="parameters_name" colwidth="150px"/>
-<colspec colname="parameters_description"/>
-<colspec colname="parameters_annotations" colwidth="200px"/>
-<tbody>
-<row><entry role="parameter_name"><para>surface</para></entry>
-<entry role="parameter_description"><para>a <link linkend="cairo-image-surface-t"><type>cairo_image_surface_t</type></link></para></entry>
-<entry role="parameter_annotations"></entry></row>
-</tbody></tgroup></informaltable>
-</refsect3><refsect3 id="cairo-image-surface-get-width.returns" role="returns">
-<title>Returns</title>
-<para> the width of the surface in pixels.</para>
-</refsect3><para role="since">Since: <link linkend="api-index-1.0">1.0</link></para></refsect2>
-<refsect2 id="cairo-image-surface-get-height" role="function" condition="since:1.0">
-<title>cairo_image_surface_get_height&#160;()</title>
-<indexterm zone="cairo-image-surface-get-height" role="1.0"><primary sortas="image_surface_get_height">cairo_image_surface_get_height</primary></indexterm>
-<programlisting language="C"><link linkend="int"><returnvalue>int</returnvalue></link>
-cairo_image_surface_get_height (<parameter><link linkend="cairo-surface-t"><type>cairo_surface_t</type></link> *surface</parameter>);</programlisting>
-<para>Get the height of the image surface in pixels.</para>
-<refsect3 id="cairo-image-surface-get-height.parameters" role="parameters">
-<title>Parameters</title>
-<informaltable role="parameters_table" pgwide="1" frame="none">
-<tgroup cols="3">
-<colspec colname="parameters_name" colwidth="150px"/>
-<colspec colname="parameters_description"/>
-<colspec colname="parameters_annotations" colwidth="200px"/>
-<tbody>
-<row><entry role="parameter_name"><para>surface</para></entry>
-<entry role="parameter_description"><para>a <link linkend="cairo-image-surface-t"><type>cairo_image_surface_t</type></link></para></entry>
-<entry role="parameter_annotations"></entry></row>
-</tbody></tgroup></informaltable>
-</refsect3><refsect3 id="cairo-image-surface-get-height.returns" role="returns">
-<title>Returns</title>
-<para> the height of the surface in pixels.</para>
-</refsect3><para role="since">Since: <link linkend="api-index-1.0">1.0</link></para></refsect2>
-<refsect2 id="cairo-image-surface-get-stride" role="function" condition="since:1.2">
-<title>cairo_image_surface_get_stride&#160;()</title>
-<indexterm zone="cairo-image-surface-get-stride" role="1.2"><primary sortas="image_surface_get_stride">cairo_image_surface_get_stride</primary></indexterm>
-<programlisting language="C"><link linkend="int"><returnvalue>int</returnvalue></link>
-cairo_image_surface_get_stride (<parameter><link linkend="cairo-surface-t"><type>cairo_surface_t</type></link> *surface</parameter>);</programlisting>
-<para>Get the stride of the image surface in bytes</para>
-<refsect3 id="cairo-image-surface-get-stride.parameters" role="parameters">
-<title>Parameters</title>
-<informaltable role="parameters_table" pgwide="1" frame="none">
-<tgroup cols="3">
-<colspec colname="parameters_name" colwidth="150px"/>
-<colspec colname="parameters_description"/>
-<colspec colname="parameters_annotations" colwidth="200px"/>
-<tbody>
-<row><entry role="parameter_name"><para>surface</para></entry>
-<entry role="parameter_description"><para>a <link linkend="cairo-image-surface-t"><type>cairo_image_surface_t</type></link></para></entry>
-<entry role="parameter_annotations"></entry></row>
-</tbody></tgroup></informaltable>
-</refsect3><refsect3 id="cairo-image-surface-get-stride.returns" role="returns">
-<title>Returns</title>
-<para> the stride of the image surface in bytes (or 0 if
-<parameter>surface</parameter>
-is not an image surface). The stride is the distance in
-bytes from the beginning of one row of the image data to the
-beginning of the next row.</para>
-</refsect3><para role="since">Since: <link linkend="api-index-1.2">1.2</link></para></refsect2>
-
-</refsect1>
-<refsect1 id="cairo-Image-Surfaces.other_details" role="details">
-<title role="details.title">Types and Values</title>
-<refsect2 id="CAIRO-HAS-IMAGE-SURFACE:CAPS" role="macro" condition="since:1.8">
-<title>CAIRO_HAS_IMAGE_SURFACE</title>
-<indexterm zone="CAIRO-HAS-IMAGE-SURFACE:CAPS" role="1.8"><primary sortas="HAS_IMAGE_SURFACE">CAIRO_HAS_IMAGE_SURFACE</primary></indexterm>
-<programlisting language="C">#define CAIRO_HAS_IMAGE_SURFACE 1
-</programlisting>
-<para>Defined if the image surface backend is available.
-The image surface backend is always built in.
-This macro was added for completeness in cairo 1.8.</para>
-<para role="since">Since: <link linkend="api-index-1.8">1.8</link></para></refsect2>
-<refsect2 id="cairo-format-t" role="enum" condition="since:1.0">
-<title>enum cairo_format_t</title>
-<indexterm zone="cairo-format-t" role="1.0"><primary sortas="format_t">cairo_format_t</primary></indexterm>
-<para><link linkend="cairo-format-t"><type>cairo_format_t</type></link> is used to identify the memory format of
-image data.</para>
-<para>New entries may be added in future versions.</para>
-<refsect3 id="cairo-format-t.members" role="enum_members">
-<title>Members</title>
-<informaltable role="enum_members_table" pgwide="1" frame="none">
-<tgroup cols="3">
-<colspec colname="enum_members_name" colwidth="300px"/>
-<colspec colname="enum_members_description"/>
-<colspec colname="enum_members_annotations" colwidth="200px"/>
-<tbody>
-<row role="constant"><entry role="enum_member_name"><para id="CAIRO-FORMAT-INVALID:CAPS">CAIRO_FORMAT_INVALID</para></entry>
-<entry role="enum_member_description"><para>no such format exists or is supported.</para>
-</entry>
-<entry role="enum_member_annotations"></entry>
-</row>
-<row role="constant"><entry role="enum_member_name"><para id="CAIRO-FORMAT-ARGB32:CAPS">CAIRO_FORMAT_ARGB32</para></entry>
-<entry role="enum_member_description"><para>each pixel is a 32-bit quantity, with
- alpha in the upper 8 bits, then red, then green, then blue.
- The 32-bit quantities are stored native-endian. Pre-multiplied
- alpha is used. (That is, 50% transparent red is 0x80800000,
- not 0x80ff0000.) (Since 1.0)</para>
-</entry>
-<entry role="enum_member_annotations"></entry>
-</row>
-<row role="constant"><entry role="enum_member_name"><para id="CAIRO-FORMAT-RGB24:CAPS">CAIRO_FORMAT_RGB24</para></entry>
-<entry role="enum_member_description"><para>each pixel is a 32-bit quantity, with
- the upper 8 bits unused. Red, Green, and Blue are stored
- in the remaining 24 bits in that order. (Since 1.0)</para>
-</entry>
-<entry role="enum_member_annotations"></entry>
-</row>
-<row role="constant"><entry role="enum_member_name"><para id="CAIRO-FORMAT-A8:CAPS">CAIRO_FORMAT_A8</para></entry>
-<entry role="enum_member_description"><para>each pixel is a 8-bit quantity holding
- an alpha value. (Since 1.0)</para>
-</entry>
-<entry role="enum_member_annotations"></entry>
-</row>
-<row role="constant"><entry role="enum_member_name"><para id="CAIRO-FORMAT-A1:CAPS">CAIRO_FORMAT_A1</para></entry>
-<entry role="enum_member_description"><para>each pixel is a 1-bit quantity holding
- an alpha value. Pixels are packed together into 32-bit
- quantities. The ordering of the bits matches the
- endianness of the platform. On a big-endian machine, the
- first pixel is in the uppermost bit, on a little-endian
- machine the first pixel is in the least-significant bit. (Since 1.0)</para>
-</entry>
-<entry role="enum_member_annotations"></entry>
-</row>
-<row role="constant"><entry role="enum_member_name"><para id="CAIRO-FORMAT-RGB16-565:CAPS">CAIRO_FORMAT_RGB16_565</para></entry>
-<entry role="enum_member_description"><para>each pixel is a 16-bit quantity
- with red in the upper 5 bits, then green in the middle
- 6 bits, and blue in the lower 5 bits. (Since 1.2)</para>
-</entry>
-<entry role="enum_member_annotations"></entry>
-</row>
-<row role="constant"><entry role="enum_member_name"><para id="CAIRO-FORMAT-RGB30:CAPS">CAIRO_FORMAT_RGB30</para></entry>
-<entry role="enum_member_description"><para>like RGB24 but with 10bpc. (Since 1.12)</para>
-</entry>
-<entry role="enum_member_annotations"></entry>
-</row>
-</tbody></tgroup></informaltable>
-</refsect3><para role="since">Since: <link linkend="api-index-1.0">1.0</link></para></refsect2>
-
-</refsect1>
-<refsect1 id="cairo-Image-Surfaces.see-also">
-<title>See Also</title>
-<para><link linkend="cairo-surface-t"><type>cairo_surface_t</type></link></para>
-
-</refsect1>
-
-</refentry>