/usr/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-csource.html is in libgdk-pixbuf2.0-doc 2.30.7-0ubuntu1.8.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>GDK-PixBuf Reference Manual: gdk-pixbuf-csource</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
<link rel="home" href="index.html" title="GDK-PixBuf Reference Manual">
<link rel="up" href="rn02.html" title="Tools Reference">
<link rel="prev" href="rn02.html" title="Tools Reference">
<link rel="next" href="gdk-pixbuf-query-loaders.html" title="gdk-pixbuf-query-loaders">
<meta name="generator" content="GTK-Doc V1.20 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="10"><tr valign="middle">
<td width="100%" align="left" class="shortcuts"></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
<td><a accesskey="u" href="rn02.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
<td><a accesskey="p" href="rn02.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
<td><a accesskey="n" href="gdk-pixbuf-query-loaders.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
</tr></table>
<div class="refentry">
<a name="gdk-pixbuf-csource"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle">gdk-pixbuf-csource</span></h2>
<p>gdk-pixbuf-csource — C code generation utility for GdkPixbuf images</p>
</td>
<td class="gallery_image" valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<h2>Synopsis</h2>
<div class="cmdsynopsis"><p><code class="command">gdk-pixbuf-csource</code> [OPTION...] [IMAGE]</p></div>
<div class="cmdsynopsis"><p><code class="command">gdk-pixbuf-csource</code> [OPTION...] --build-list [
[NAME]
[IMAGE]
...]</p></div>
</div>
<div class="refsect1">
<a name="id-1.3.3.5"></a><h2>Description</h2>
<p>
<span class="command"><strong>gdk-pixbuf-csource</strong></span> is a small utility that generates
C code containing images, useful for compiling images directly into programs.
</p>
<p>
<span class="command"><strong>gdk-pixbuf-csource</strong></span> either takes as input one image file
name to generate code for, or, using the <code class="option">--build-list</code> option,
a list of (<em class="replaceable"><code>name</code></em>, <em class="replaceable"><code>image</code></em>)
pairs to generate code for a list of images into named variables.
</p>
</div>
<div class="refsect1">
<a name="id-1.3.3.6"></a><h2>Options</h2>
<div class="variablelist"><table border="0" class="variablelist">
<colgroup>
<col align="left" valign="top">
<col>
</colgroup>
<tbody>
<tr>
<td><p><span class="term"><code class="option">--stream</code></span></p></td>
<td><p>
Generate pixbuf data stream (a single string containing a serialized
<span class="structname">GdkPixdata</span> structure in network byte order).
</p></td>
</tr>
<tr>
<td><p><span class="term"><code class="option">--struct</code></span></p></td>
<td><p>
Generate GdkPixdata structure (needs the <span class="structname">GdkPixdata</span>
structure definition from <code class="filename">gdk-pixdata.h</code>).
</p></td>
</tr>
<tr>
<td><p><span class="term"><code class="option">--macros</code></span></p></td>
<td><p>
Generate *_ROWSTRIDE, *_WIDTH, *_HEIGHT, *_BYTES_PER_PIXEL and
*_RLE_PIXEL_DATA or *_PIXEL_DATA macro definitions for the image.
</p></td>
</tr>
<tr>
<td><p><span class="term"><code class="option">--rle</code></span></p></td>
<td><p>
Enables run-length encoding for the generated pixel data (default).
</p></td>
</tr>
<tr>
<td><p><span class="term"><code class="option">--raw</code></span></p></td>
<td><p>
Disables run-length encoding for the generated pixel data.
</p></td>
</tr>
<tr>
<td><p><span class="term"><code class="option">--extern</code></span></p></td>
<td><p>
Generate extern symbols.
</p></td>
</tr>
<tr>
<td><p><span class="term"><code class="option">--static</code></span></p></td>
<td><p>
Generate static symbols (default).
</p></td>
</tr>
<tr>
<td><p><span class="term"><code class="option">--decoder</code></span></p></td>
<td><p>
Provide a *_RUN_LENGTH_DECODE(image_buf, rle_data, size, bpp) macro definition
to decode run-length encoded image data.
</p></td>
</tr>
<tr>
<td><p><span class="term"><code class="option">--name=identifier</code></span></p></td>
<td><p>
Specifies the identifier name (prefix) for the generated variables or
macros (useful only if <code class="option">--build-list</code> was not specified).
</p></td>
</tr>
<tr>
<td><p><span class="term"><code class="option">--build-list</code></span></p></td>
<td><p>
Enables (<em class="replaceable"><code>name</code></em>, <em class="replaceable"><code>image</code></em>)
pair parsing mode.
</p></td>
</tr>
<tr>
<td><p><span class="term"><code class="option">-h</code>, <code class="option">--help</code></span></p></td>
<td><p>
Print brief help and exit.
</p></td>
</tr>
<tr>
<td><p><span class="term"><code class="option">-v</code>, <code class="option">--version</code></span></p></td>
<td><p>
Print version and exit.
</p></td>
</tr>
<tr>
<td><p><span class="term"><code class="option">--g-fatal-warnings</code></span></p></td>
<td><p>
Make warnings fatal (causes the program to abort).
</p></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="id-1.3.3.7"></a><h2>See also</h2>
<p>
The <span class="structname">GdkPixbuf</span> documentation, shipped with the
Gtk+ distribution, available from <a class="ulink" href="http://www.gtk.org" target="_top">www.gtk.org</a>.
</p>
</div>
<div class="refsect1">
<a name="id-1.3.3.8"></a><h2>Bugs</h2>
<p>
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.
</p>
</div>
</div>
<div class="footer">
<hr>
Generated by GTK-Doc V1.20</div>
</body>
</html>
|