NAME

       gdk-pixbuf-csource - C code generation utility for GdkPixbuf images

SYNOPSIS

       gdk-pixbuf-csource [OPTIONS...] <IMAGE>

DESCRIPTION

       gdk-pixbuf-csource  is a small utility that generates C code containing images, useful for
       compiling images directly into programs.

       gdk-pixbuf-csource either takes as input one image file name to  generate  code  for,  or,
       using  the  --build-list option, a list of (name, image) pairs to generate code for a list
       of images into named variables.

       This  tool  is  mostly  meant  to  be  used  for  backward  compatibility.  Newly  written
       applications and libraries should use GResource to embed image assets in their binary.

OPTIONS

       --stream
          Generate  pixbuf  data  stream:  a  single  string  containing  a serialized GdkPixdata
          structure in network byte order.

       --struct
          Generate GdkPixdata structure; your code needs the GdkPixdata structure definition from
          gdk-pixdata.h.

       --macros
          Generate  *_ROWSTRIDE,  *_WIDTH,  *_HEIGHT,  *_BYTES_PER_PIXEL  and *_RLE_PIXEL_DATA or
          *_PIXEL_DATA macro definitions for the image.

       --rle
          Enables run-length encoding for the generated pixel data (default).

       --raw
          Disables run-length encoding for the generated pixel data.

       --extern
          Generate extern symbols.

       --static
          Generate static symbols (default).

       --decoder
          Provide a *_RUN_LENGTH_DECODE(image_buf,  rle_data,  size,  bpp)  macro  definition  to
          decode run-length encoded image data.

       --name=identifier
          Specifies  the  identifier  name (prefix) for the generated variables or macros (useful
          only if --build-list was not specified).

       --build-list
          Enables (name, image) pair parsing mode.

       -h, --help
          Prints a brief help and exit.

       -v, --version
          Prints the tool version and exit.

       --g-fatal-warnings
          Makes warnings fatal, and causes the program to abort.

SEE ALSO

       The  GdkPixbuf  documentation,  shipped  by  gdk-pixbuf,  and  also  available  online  on
       docs.gtk.org.

BUGS

       The  runlength  encoder  gets out of sync with the pixel boundaries, since it includes the
       rowstride padding in the encoded stream. Furthermore, it generates pixbufs with suboptimal
       rowstride in some cases.

                                                                             GDK-PIXBUF-CSOURCE()