dwww Home | Manual pages | Find package

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  struc-
          ture 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 <https://docs.gtk.org/gdk-pixbuf/> .

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

Generated by dwww version 1.16 on Sat Oct 3 07:41:51 CEST 2026.