DragonFly On-Line Manual Pages

GDK-PIXBUF-CSOURCE()                                      GDK-PIXBUF-CSOURCE()

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()