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