NAME

       glib-compile-resources - GLib resource compiler

SYNOPSIS

       glib-compile-resources [OPTION…] FILE

DESCRIPTION

       glib-compile-resources  reads  the  resource  description  from FILE and the files that it
       references and creates a binary  resource  bundle  that  is  suitable  for  use  with  the
       GResource  API. The resulting bundle is then written out as-is, or as C source for linking
       into an application.

       The XML resource files  normally  have  the  filename  extension  .gresource.xml.   For  a
       detailed   description   of   the   XML  file  format,  see  the  GResource  documentation
       <https://docs.gtk.org/gio/struct.Resource.html> .

OPTIONS

       -h, --help
          Print help and exit.

       --version
          Print program version and exit.

       --target <TARGET>
          Store the compiled resources in the file TARGET. If not specified a filename  based  on
          the FILE basename is used.

       --sourcedir <DIRECTORY>
          The  files  referenced  in  FILE  are loaded from this directory. If not specified, the
          current directory is used.

       --generate
          Write the output file in the format selected for by its filename extension:

          .c
              C source

          .h
              C header

          .gresource
              resource bundle

       --generate-source
          Instead of a writing the resource bundle in binary form, create a C  source  file  that
          contains  the  resource  bundle. This can then be compiled into an application for easy
          access.

       --generate-header
          Generate a header file for use with C code generated by --generate-source.

       --generate-dependencies
          Prints the list of files that the resource bundle references to standard  output.  This
          can  be used to track dependencies in the build system. For example, the following make
          rule would mark test.gresource as depending on all the  files  that  test.gresource.xml
          includes, so that it is automatically rebuilt if any of them change:

              test.gresource: test.gresource.xml $(shell $(GLIB_COMPILE_RESOURCES) --generate-dependencies test.gresource.xml)

          Note that this may or may not be portable to non-GNU make.

          Also see --dependency-file.

       --c-name
          Specify   the   prefix   used   for   the  C  identifiers  in  the  code  generated  by
          --generate-source and --generate-header.

       --manual-register
          By default, code generated by --generate-source uses automatic  initialization  of  the
          resource.  This  works  on most systems by using the compiler support for constructors.
          However, some  (uncommon)  compilers  may  not  support  this,  you  can  then  specify
          --manual-register,  which  will  generate custom register and unregister functions that
          your code can manually call at initialization and uninitialization time.

       --internal
          By default, code generated by --generate-source declares all  initialization  functions
          as  extern.   So  they  are exported unless this is prevented by a link script or other
          means.  Since libraries usually want to use the functions only  internally  it  can  be
          more useful to declare them as G_GNUC_INTERNAL which is what --internal does.

       --external-data
          By  default,  code  generated by --generate-source embeds the resource data as a string
          literal. When --external-data is given, the data is only declared in  the  generated  C
          file, and the data has to be linked externally.

       --dependency-file <FILE>
          Write dependencies in the same style as gcc -M -MF to the given file. If FILE is -, the
          dependencies are written to the standard output. Unlike  --generate-dependencies,  this
          option  can  be  combined  with  other --generate options to generate dependencies as a
          side-effect of generating sources.

       --generate-phony-targets
          When creating a dependency file with --dependency-file include  phony  targets  in  the
          same style as gcc -MP. This would typically be used with make.

       --compiler <NAME>
          Generate code that is going to target the given compiler NAME. The current two compiler
          modes are gcc, for all GCC-compatible toolchains; and msvc, for the Microsoft Visual  C
          Compiler.  If  this  option  isn’t  set,  then  the  default  will be taken from the CC
          environment variable.

ENVIRONMENT

       XMLLINT
          The full path to the xmllint executable. This is used to preprocess resources with  the
          xml-stripblanks  preprocessing option. If this environment variable is not set, xmllint
          is searched for in the PATH.

       GDK_PIXBUF_PIXDATA
          Deprecated since gdk-pixbuf 2.32, as GResource supports embedding modern image  formats
          without conversion.

          The  full  path  to  the  gdk-pixbuf-pixdata  executable.  This  is  used to preprocess
          resources with the to-pixdata preprocessing option. If this environment variable is not
          set, gdk-pixbuf-pixdata is searched for in the PATH.

       JSON_GLIB_FORMAT
          The  full path to the json-glib-format executable. This is used to preprocess resources
          with the json-stripblanks preprocessing option. If this  environment  variable  is  not
          set, json-glib-format is searched for in the PATH.

                                                                         GLIB-COMPILE-RESOURCES()