resources: Add to-pixdata preprocessing option

This commit is contained in:
Alexander Larsson
2012-01-31 16:07:09 +01:00
parent b79cfda49c
commit 47aa8c43e8
3 changed files with 85 additions and 4 deletions

View File

@@ -66,11 +66,18 @@ G_DEFINE_BOXED_TYPE (GResource, g_resource, g_resource_ref, g_resource_unref)
*
* Resource files can also be marked to be preprocessed, by setting the value of the
* <literal>preprocess</literal> attribute to a comma-separated list of preprocessing options.
* The only option currently supported is
* The only options currently supported are:
*
* <literal>xml-stripblanks</literal> which will use <literal>xmllint</literal> to strip
* ignorable whitespace from the xml file. For this to work, the <envar>XMLLINT</envar>
* environment variable must be set to the full path to the xmllint executable;
* otherwise the preprocessing step is skipped.
* environment variable must be set to the full path to the xmllint executable, or xmllint
* must be in the PATH; otherwise the preprocessing step is skipped.
*
* <literal>to-pixdata</literal> which will use <literal>gdk-pixbuf-pixdata</literal> to convert
* images to the GdkPixdata format, which allows you to create pixbufs directly using the data inside
* the resource file, rather than an (uncompressed) copy if it. For this to work, the gdk-pixbuf-pixdata
* program must be in the PATH, or the <envar>GDK_PIXBUF_PIXDATA</envar> environment variable must be
* set to the full path to the gdk-pixbuf-pixdata executable; otherwise the preprocessing step is skipped.
*
* Resource bundles are created by the <link linkend="glib-compile-resources">glib-compile-resources</link> program
* which takes an xml file that describes the bundle, and a set of files that the xml references. These