~inkscape.dev/inkscape-devlibs/devlibs-gtk3

void <a class="link" href="gdk2-GdkRGB.html#gdk-draw-rgb-image" title="gdk_draw_rgb_image ()">gdk_draw_rgb_image</a> (<code><a class="link" href="gdk2-Drawing-Primitives.html#GdkDrawable">GdkDrawable</a> *drawable</code>,

<code><a class="link" href="gdk2-Graphics-Contexts.html#GdkGC">GdkGC</a> *gc</code>,

<code>gint x</code>,

<code>gint y</code>,

<code>gint width</code>,

<code>gint height</code>,

<code><a class="link" href="gdk2-GdkRGB.html#GdkRgbDither" title="enum GdkRgbDither">GdkRgbDither</a> dith</code>,

<code>const guchar *rgb_buf</code>,

<code>gint rowstride</code>);

void <a class="link" href="gdk2-GdkRGB.html#gdk-draw-rgb-image-dithalign" title="gdk_draw_rgb_image_dithalign ()">gdk_draw_rgb_image_dithalign</a> (<code><a class="link" href="gdk2-Drawing-Primitives.html#GdkDrawable">GdkDrawable</a> *drawable</code>,

<code><a class="link" href="gdk2-Graphics-Contexts.html#GdkGC">GdkGC</a> *gc</code>,

<code>gint x</code>,

<code>gint y</code>,

<code>gint width</code>,

<code>gint height</code>,

<code><a class="link" href="gdk2-GdkRGB.html#GdkRgbDither" title="enum GdkRgbDither">GdkRgbDither</a> dith</code>,

<code>const guchar *rgb_buf</code>,

<code>gint rowstride</code>,

<code>gint xdith</code>,

<code>gint ydith</code>);

void <a class="link" href="gdk2-GdkRGB.html#gdk-draw-indexed-image" title="gdk_draw_indexed_image ()">gdk_draw_indexed_image</a> (<code><a class="link" href="gdk2-Drawing-Primitives.html#GdkDrawable">GdkDrawable</a> *drawable</code>,

<code><a class="link" href="gdk2-Graphics-Contexts.html#GdkGC">GdkGC</a> *gc</code>,

<code>gint x</code>,

<code>gint y</code>,

<code>gint width</code>,

<code>gint height</code>,

<code><a class="link" href="gdk2-GdkRGB.html#GdkRgbDither" title="enum GdkRgbDither">GdkRgbDither</a> dith</code>,

<code>const guchar *buf</code>,

<code>gint rowstride</code>,

<code><a class="link" href="gdk2-GdkRGB.html#GdkRgbCmap" title="struct GdkRgbCmap">GdkRgbCmap</a> *cmap</code>);

void <a class="link" href="gdk2-GdkRGB.html#gdk-draw-gray-image" title="gdk_draw_gray_image ()">gdk_draw_gray_image</a> (<code><a class="link" href="gdk2-Drawing-Primitives.html#GdkDrawable">GdkDrawable</a> *drawable</code>,

<code><a class="link" href="gdk2-Graphics-Contexts.html#GdkGC">GdkGC</a> *gc</code>,

<code>gint x</code>,

<code>gint y</code>,

<code>gint width</code>,

<code>gint height</code>,

<code><a class="link" href="gdk2-GdkRGB.html#GdkRgbDither" title="enum GdkRgbDither">GdkRgbDither</a> dith</code>,

<code>const guchar *buf</code>,

<code>gint rowstride</code>);

void <a class="link" href="gdk2-GdkRGB.html#gdk-draw-rgb-32-image" title="gdk_draw_rgb_32_image ()">gdk_draw_rgb_32_image</a> (<code><a class="link" href="gdk2-Drawing-Primitives.html#GdkDrawable">GdkDrawable</a> *drawable</code>,

<code><a class="link" href="gdk2-Graphics-Contexts.html#GdkGC">GdkGC</a> *gc</code>,

<code>gint x</code>,

<code>gint y</code>,

<code>gint width</code>,

<code>gint height</code>,

<code><a class="link" href="gdk2-GdkRGB.html#GdkRgbDither" title="enum GdkRgbDither">GdkRgbDither</a> dith</code>,

<code>const guchar *buf</code>,

<code>gint rowstride</code>);

void <a class="link" href="gdk2-GdkRGB.html#gdk-draw-rgb-32-image-dithalign" title="gdk_draw_rgb_32_image_dithalign ()">gdk_draw_rgb_32_image_dithalign</a> (<code><a class="link" href="gdk2-Drawing-Primitives.html#GdkDrawable">GdkDrawable</a> *drawable</code>,

<code><a class="link" href="gdk2-Graphics-Contexts.html#GdkGC">GdkGC</a> *gc</code>,

<code>gint x</code>,

<code>gint y</code>,

<code>gint width</code>,

<code>gint height</code>,

<code><a class="link" href="gdk2-GdkRGB.html#GdkRgbDither" title="enum GdkRgbDither">GdkRgbDither</a> dith</code>,

100

<code>const guchar *buf</code>,

101

<code>gint rowstride</code>,

102

<code>gint xdith</code>,

103

<code>gint ydith</code>);

104

enum <a class="link" href="gdk2-GdkRGB.html#GdkRgbDither" title="enum GdkRgbDither">GdkRgbDither</a>;

105

106

<a class="link" href="gdk2-GdkRGB.html#GdkRgbCmap" title="struct GdkRgbCmap">GdkRgbCmap</a> * <a class="link" href="gdk2-GdkRGB.html#gdk-rgb-cmap-new" title="gdk_rgb_cmap_new ()">gdk_rgb_cmap_new</a> (<code>guint32 *colors</code>,

107

<code>gint n_colors</code>);

108

void <a class="link" href="gdk2-GdkRGB.html#gdk-rgb-cmap-free" title="gdk_rgb_cmap_free ()">gdk_rgb_cmap_free</a> (<code><a class="link" href="gdk2-GdkRGB.html#GdkRgbCmap" title="struct GdkRgbCmap">GdkRgbCmap</a> *cmap</code>);

109

struct <a class="link" href="gdk2-GdkRGB.html#GdkRgbCmap" title="struct GdkRgbCmap">GdkRgbCmap</a>;

110

111

void <a class="link" href="gdk2-GdkRGB.html#gdk-rgb-gc-set-foreground" title="gdk_rgb_gc_set_foreground ()">gdk_rgb_gc_set_foreground</a> (<code><a class="link" href="gdk2-Graphics-Contexts.html#GdkGC">GdkGC</a> *gc</code>,

112

<code>guint32 rgb</code>);

113

void <a class="link" href="gdk2-GdkRGB.html#gdk-rgb-gc-set-background" title="gdk_rgb_gc_set_background ()">gdk_rgb_gc_set_background</a> (<code><a class="link" href="gdk2-Graphics-Contexts.html#GdkGC">GdkGC</a> *gc</code>,

114

<code>guint32 rgb</code>);

115

gulong <a class="link" href="gdk2-GdkRGB.html#gdk-rgb-xpixel-from-rgb" title="gdk_rgb_xpixel_from_rgb ()">gdk_rgb_xpixel_from_rgb</a> (<code>guint32 rgb</code>);

116

void <a class="link" href="gdk2-GdkRGB.html#gdk-rgb-find-color" title="gdk_rgb_find_color ()">gdk_rgb_find_color</a> (<code><a class="link" href="gdk2-Colormaps-and-Colors.html#GdkColormap" title="GdkColormap">GdkColormap</a> *colormap</code>,

117

<code><a class="link" href="gdk2-Colormaps-and-Colors.html#GdkColor" title="GdkColor">GdkColor</a> *color</code>);

118

119

void <a class="link" href="gdk2-GdkRGB.html#gdk-rgb-set-install" title="gdk_rgb_set_install ()">gdk_rgb_set_install</a> (<code>gboolean install</code>);

120

void <a class="link" href="gdk2-GdkRGB.html#gdk-rgb-set-min-colors" title="gdk_rgb_set_min_colors ()">gdk_rgb_set_min_colors</a> (<code>gint min_colors</code>);

121

<a class="link" href="gdk2-Visuals.html#GdkVisual" title="GdkVisual">GdkVisual</a> * <a class="link" href="gdk2-GdkRGB.html#gdk-rgb-get-visual" title="gdk_rgb_get_visual ()">gdk_rgb_get_visual</a> (<code>void</code>);

122

<a class="link" href="gdk2-Colormaps-and-Colors.html#GdkColormap" title="GdkColormap">GdkColormap</a> * <a class="link" href="gdk2-GdkRGB.html#gdk-rgb-get-colormap" title="gdk_rgb_get_colormap ()">gdk_rgb_get_colormap</a> (<code>void</code>);

123

#define <a class="link" href="gdk2-GdkRGB.html#gdk-rgb-get-cmap" title="gdk_rgb_get_cmap">gdk_rgb_get_cmap</a>

124

gboolean <a class="link" href="gdk2-GdkRGB.html#gdk-rgb-ditherable" title="gdk_rgb_ditherable ()">gdk_rgb_ditherable</a> (<code>void</code>);

125

gboolean <a class="link" href="gdk2-GdkRGB.html#gdk-rgb-colormap-ditherable" title="gdk_rgb_colormap_ditherable ()">gdk_rgb_colormap_ditherable</a> (<code><a class="link" href="gdk2-Colormaps-and-Colors.html#GdkColormap" title="GdkColormap">GdkColormap</a> *cmap</code>);

126

void <a class="link" href="gdk2-GdkRGB.html#gdk-rgb-set-verbose" title="gdk_rgb_set_verbose ()">gdk_rgb_set_verbose</a> (<code>gboolean verbose</code>);

127

</pre>

128

</div>

129

130

<a name="gdk2-GdkRGB.description"></a><h2>Description</h2>

131

132

GdkRGB is a low-level module which renders RGB, grayscale, and indexed

133

colormap images to a <a class="link" href="gdk2-Drawing-Primitives.html#GdkDrawable">GdkDrawable</a>. It does this as efficiently as

134

possible, handling issues such as colormaps, visuals, dithering,

135

temporary buffers, and so on. Most code should use the higher-level

136

<a href="/usr/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf">GdkPixbuf</a> features in place of this module; for example,

137

<a class="link" href="gdk2-Drawing-Primitives.html#gdk-draw-pixbuf" title="gdk_draw_pixbuf ()"><code class="function">gdk_draw_pixbuf()</code></a> uses GdkRGB in its implementation.

138

139

140

GdkRGB allocates a color cube to use when rendering images. You can

141

set the threshold for installing colormaps with

142

<a class="link" href="gdk2-GdkRGB.html#gdk-rgb-set-min-colors" title="gdk_rgb_set_min_colors ()"><code class="function">gdk_rgb_set_min_colors()</code></a>. The default is 5x5x5 (125). If a colorcube

143

of this size or larger can be allocated in the default colormap, then

144

that's done. Otherwise, GdkRGB creates its own private colormap.

145

Setting it to 0 means that it always tries to use the default

146

colormap, and setting it to 216 means that it always creates a private

147

one if it cannot allocate the 6x6x6 colormap in the default. If you

148

always want a private colormap (to avoid consuming too many colormap

149

entries for other apps, say), you can use

150

<code class="literal">gdk_rgb_set_install(TRUE)</code>.

151

Setting the value greater than 216 exercises a bug in older versions

152

of GdkRGB. Note, however, that setting it to 0 doesn't let you get

153

away with ignoring the colormap and visual - a colormap is always

154

created in grayscale and direct color modes, and the visual is changed

155

in cases where a "better" visual than the default is available.

156

157

158

If GDK is built with the Sun mediaLib library, the GdkRGB functions are

159

accelerated using mediaLib, which provides hardware acceleration on Intel,

160

AMD, and Sparc chipsets. If desired, mediaLib support can be turned off

161

by setting the GDK_DISABLE_MEDIALIB environment variable.

162

163

164

<a name="idp16118400"></a>Example 4. A simple example program using GdkRGB

165

166

167

<tbody>

168

<tr>

169

<td class="listing_lines" align="right"><pre>1

170

171

172

173

174

175

176

177

178

179

180

181

182

183

184

185

186

187

188

189

190

191

192

193

194

195

196

197

198

199

200

201

202

203

204

205

206

207

208

209

210

211

212

213

45</pre></td>

214

<td class="listing_code"><pre class="programlisting">#include <gtk/gtk.h>

215

#define IMAGE_WIDTH 256

216

#define IMAGE_HEIGHT 256

217

guchar rgbbuf[IMAGE_WIDTH * IMAGE_HEIGHT * 3];

218

gboolean on_darea_expose (GtkWidget *widget,

219

GdkEventExpose *event,

220

gpointer user_data);

221

int

222

main (int argc, char *argv[])

223

{

224

GtkWidget *window, *darea;

225

gint x, y;

226

guchar *pos;

227

<a href="http://developer.gnome.org/gtk2/gtk3-General.html#gtk-init">gtk_init</a> (&argc, &argv);

228

window = <a href="http://developer.gnome.org/gtk2/GtkWindow.html#gtk-window-new">gtk_window_new</a> (<a href="http://developer.gnome.org/gtk2/gtk3-Standard-Enumerations.html#GTK-WINDOW-TOPLEVEL:CAPS">GTK_WINDOW_TOPLEVEL</a>);

229

darea = <a href="http://developer.gnome.org/gtk2/GtkDrawingArea.html#gtk-drawing-area-new">gtk_drawing_area_new</a> ();

230

<a href="http://developer.gnome.org/gtk2/GtkWidget.html#gtk-widget-set-size-request">gtk_widget_set_size_request</a> (darea, IMAGE_WIDTH, IMAGE_HEIGHT);

231

<a href="http://developer.gnome.org/gtk2/GtkContainer.html#gtk-container-add">gtk_container_add</a> (GTK_CONTAINER (window), darea);

232

gtk_signal_connect (GTK_OBJECT (darea), "expose-event",

233

GTK_SIGNAL_FUNC (on_darea_expose), <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS">NULL</a>);

234

<a href="http://developer.gnome.org/gtk2/GtkWidget.html#gtk-widget-show-all">gtk_widget_show_all</a> (window);

235

/* Set up the RGB buffer. */

236

pos = rgbbuf;

237

for (y = 0; y < IMAGE_HEIGHT; y++)

238

{

239

for (x = 0; x < IMAGE_WIDTH; x++)

240

{

241

242

*pos++ = (x / 32) * 4 + y - y % 32; /* Green. */

243

244

}

245

}

246

<a href="http://developer.gnome.org/gtk2/gtk3-General.html#gtk-main">gtk_main</a> ();

247

return 0;

248

}

249

gboolean

250

on_darea_expose (GtkWidget *widget,

251

GdkEventExpose *event,

252

gpointer user_data)

253

{

254

<a href="gdk2-GdkRGB.html#gdk-draw-rgb-image">gdk_draw_rgb_image</a> (widget->window, widget->style->fg_gc[<a href="http://developer.gnome.org/gtk2/gtk3-Standard-Enumerations.html#GTK-STATE-NORMAL:CAPS">GTK_STATE_NORMAL</a>],

255

0, 0, IMAGE_WIDTH, IMAGE_HEIGHT,

256

<a href="gdk2-GdkRGB.html#GDK-RGB-DITHER-MAX:CAPS">GDK_RGB_DITHER_MAX</a>, rgbbuf, IMAGE_WIDTH * 3);

257

return TRUE;

258

}</pre></td>

259

</tr>

260

</tbody>

261

</table>

262

</div>

263

264

</div>

265

266

</div>

267

268

<a name="gdk2-GdkRGB.details"></a><h2>Details</h2>

269

270

271

272

273

<h3 class="title">Warning</h3>

274

<code class="literal">gdk_rgb_init</code> is deprecated and should not be used in newly-written code.

275

</div>

276

277

This function no longer does anything at all. It's completely useless

278

(and harmless).

279

280

</div>

281

<hr>

282

283

<a name="gdk-draw-rgb-image"></a><h3>gdk_draw_rgb_image ()</h3>

284

<pre class="programlisting">void gdk_draw_rgb_image (<code><a class="link" href="gdk2-Drawing-Primitives.html#GdkDrawable">GdkDrawable</a> *drawable</code>,

285

<code><a class="link" href="gdk2-Graphics-Contexts.html#GdkGC">GdkGC</a> *gc</code>,

286

<code>gint x</code>,

287

<code>gint y</code>,

288

<code>gint width</code>,

289

<code>gint height</code>,

290

<code><a class="link" href="gdk2-GdkRGB.html#GdkRgbDither" title="enum GdkRgbDither">GdkRgbDither</a> dith</code>,

291

<code>const guchar *rgb_buf</code>,

292

<code>gint rowstride</code>);</pre>

293

294

<h3 class="title">Warning</h3>

295

<code class="literal">gdk_draw_rgb_image</code> is deprecated and should not be used in newly-written code.

296

</div>

297

298

Draws an RGB image in the drawable. This is the core GdkRGB

299

function, and likely the only one you will need to use.

300

301

302

The <code>rowstride</code> parameter allows for lines to be aligned more flexibly.

303

For example, lines may be allocated to begin on 32-bit boundaries,

304

even if the width of the rectangle is odd. Rowstride is also useful

305

when drawing a subrectangle of a larger image in memory. Finally, to

306

replicate the same line a number of times, the trick of setting

307

<code>rowstride</code> to 0 is allowed.

308

309

310

In general, for 0 <= i < <code>width</code> and 0 <= j < height,

311

the pixel (x + i, y + j) is colored with red value <code>rgb_buf</code>[<code>j</code> *

312

<code>rowstride</code> + <code>i</code> * 3], green value <code>rgb_buf</code>[<code>j</code> * <code>rowstride</code> + <code>i</code> * 3 +

313

1], and blue value <code>rgb_buf</code>[<code>j</code> * <code>rowstride</code> + <code>i</code> * 3 + 2].

314

315

316

317

318

<col>

319

</colgroup>

320

<tbody>

321

<tr>

322

<td><code>drawable</code> :</td>

323

<td>The <a class="link" href="gdk2-Drawing-Primitives.html#GdkDrawable">GdkDrawable</a> to draw in (usually a <a class="link" href="gdk2-Windows.html#GdkWindow">GdkWindow</a>).</td>

324

</tr>

325

<tr>

326

327

<td>The graphics context (all GDK drawing operations require one; its

328

contents are ignored).</td>

329

</tr>

330

<tr>

331

332

<td>The x coordinate of the top-left corner in the drawable.</td>

333

</tr>

334

<tr>

335

336

<td>The y coordinate of the top-left corner in the drawable.</td>

337

</tr>

338

<tr>

339

<td><code>width</code> :</td>

340

<td>The width of the rectangle to be drawn.</td>

341

</tr>

342

<tr>

343

<td><code>height</code> :</td>

344

<td>The height of the rectangle to be drawn.</td>

345

</tr>

346

<tr>

347

348

<td>A <a class="link" href="gdk2-GdkRGB.html#GdkRgbDither" title="enum GdkRgbDither">GdkRgbDither</a> value, selecting the desired dither mode.</td>

349

</tr>

350

<tr>

351

352

<td>The pixel data, represented as packed 24-bit data.</td>

353

</tr>

354

<tr>

355

<td><code>rowstride</code> :</td>

356

<td>The number of bytes from the start of one row in <code>rgb_buf</code> to the

357

start of the next.</td>

358

</tr>

359

</tbody>

360

</table></div>

361

</div>

362

<hr>

363

364

<a name="gdk-draw-rgb-image-dithalign"></a><h3>gdk_draw_rgb_image_dithalign ()</h3>

365

<pre class="programlisting">void gdk_draw_rgb_image_dithalign (<code><a class="link" href="gdk2-Drawing-Primitives.html#GdkDrawable">GdkDrawable</a> *drawable</code>,

366

<code><a class="link" href="gdk2-Graphics-Contexts.html#GdkGC">GdkGC</a> *gc</code>,

367

<code>gint x</code>,

368

<code>gint y</code>,

369

<code>gint width</code>,

370

<code>gint height</code>,

371

<code><a class="link" href="gdk2-GdkRGB.html#GdkRgbDither" title="enum GdkRgbDither">GdkRgbDither</a> dith</code>,

372

<code>const guchar *rgb_buf</code>,

373

<code>gint rowstride</code>,

374

<code>gint xdith</code>,

375

<code>gint ydith</code>);</pre>

376

377

<h3 class="title">Warning</h3>

378

<code class="literal">gdk_draw_rgb_image_dithalign</code> is deprecated and should not be used in newly-written code.

379

</div>

380

381

Draws an RGB image in the drawable, with an adjustment for dither alignment.

382

383

384

This function is useful when drawing dithered images into a window

385

that may be scrolled. Pixel (x, y) will be drawn dithered as if its

386

actual location is (x + <code>xdith</code>, y + <code>ydith</code>). Thus, if you draw an

387

image into a window using zero dither alignment, then scroll up one

388

pixel, subsequent draws to the window should have <code>ydith</code> = 1.

389

390

391

Setting the dither alignment correctly allows updating of small parts

392

of the screen while avoiding visible "seams" between the different

393

dither textures.

394

395

396

397

398

<col>

399

</colgroup>

400

<tbody>

401

<tr>

402

<td><code>drawable</code> :</td>

403

404

</tr>

405

<tr>

406

407

<td>The graphics context.</td>

408

</tr>

409

<tr>

410

411

<td>The x coordinate of the top-left corner in the drawable.</td>

412

</tr>

413

<tr>

414

415

<td>The y coordinate of the top-left corner in the drawable.</td>

416

</tr>

417

<tr>

418

<td><code>width</code> :</td>

419

<td>The width of the rectangle to be drawn.</td>

420

</tr>

421

<tr>

422

<td><code>height</code> :</td>

423

<td>The height of the rectangle to be drawn.</td>

424

</tr>

425

<tr>

426

427

<td>A <a class="link" href="gdk2-GdkRGB.html#GdkRgbDither" title="enum GdkRgbDither">GdkRgbDither</a> value, selecting the desired dither mode.</td>

428

</tr>

429

<tr>

430

431

<td>The pixel data, represented as packed 24-bit data.</td>

432

</tr>

433

<tr>

434

<td><code>rowstride</code> :</td>

435

<td>The number of bytes from the start of one row in <code>rgb_buf</code> to the

436

start of the next.</td>

437

</tr>

438

<tr>

439

<td><code>xdith</code> :</td>

440

<td>An x offset for dither alignment.</td>

441

</tr>

442

<tr>

443

<td><code>ydith</code> :</td>

444

<td>A y offset for dither alignment.</td>

445

</tr>

446

</tbody>

447

</table></div>

448

</div>

449

<hr>

450

451

<a name="gdk-draw-indexed-image"></a><h3>gdk_draw_indexed_image ()</h3>

452

<pre class="programlisting">void gdk_draw_indexed_image (<code><a class="link" href="gdk2-Drawing-Primitives.html#GdkDrawable">GdkDrawable</a> *drawable</code>,

453

<code><a class="link" href="gdk2-Graphics-Contexts.html#GdkGC">GdkGC</a> *gc</code>,

454

<code>gint x</code>,

455

<code>gint y</code>,

456

<code>gint width</code>,

457

<code>gint height</code>,

458

<code><a class="link" href="gdk2-GdkRGB.html#GdkRgbDither" title="enum GdkRgbDither">GdkRgbDither</a> dith</code>,

459

<code>const guchar *buf</code>,

460

<code>gint rowstride</code>,

461

<code><a class="link" href="gdk2-GdkRGB.html#GdkRgbCmap" title="struct GdkRgbCmap">GdkRgbCmap</a> *cmap</code>);</pre>

462

463

<h3 class="title">Warning</h3>

464

<code class="literal">gdk_draw_indexed_image</code> is deprecated and should not be used in newly-written code.

465

</div>

466

467

Draws an indexed image in the drawable, using a <a class="link" href="gdk2-GdkRGB.html#GdkRgbCmap" title="struct GdkRgbCmap">GdkRgbCmap</a> to assign

468

actual colors to the color indices.

469

470

471

472

473

<col>

474

</colgroup>

475

<tbody>

476

<tr>

477

<td><code>drawable</code> :</td>

478

479

</tr>

480

<tr>

481

482

<td>The graphics context.</td>

483

</tr>

484

<tr>

485

486

<td>The x coordinate of the top-left corner in the drawable.</td>

487

</tr>

488

<tr>

489

490

<td>The y coordinate of the top-left corner in the drawable.</td>

491

</tr>

492

<tr>

493

<td><code>width</code> :</td>

494

<td>The width of the rectangle to be drawn.</td>

495

</tr>

496

<tr>

497

<td><code>height</code> :</td>

498

<td>The height of the rectangle to be drawn.</td>

499

</tr>

500

<tr>

501

502

<td>A <a class="link" href="gdk2-GdkRGB.html#GdkRgbDither" title="enum GdkRgbDither">GdkRgbDither</a> value, selecting the desired dither mode.</td>

503

</tr>

504

<tr>

505

506

<td>The pixel data, represented as 8-bit color indices.</td>

507

</tr>

508

<tr>

509

<td><code>rowstride</code> :</td>

510

<td>The number of bytes from the start of one row in <code>buf</code> to the

511

start of the next.</td>

512

</tr>

513

<tr>

514

515

<td>The <a class="link" href="gdk2-GdkRGB.html#GdkRgbCmap" title="struct GdkRgbCmap">GdkRgbCmap</a> used to assign colors to the color indices.</td>

516

</tr>

517

</tbody>

518

</table></div>

519

</div>

520

<hr>

521

522

<a name="gdk-draw-gray-image"></a><h3>gdk_draw_gray_image ()</h3>

523

<pre class="programlisting">void gdk_draw_gray_image (<code><a class="link" href="gdk2-Drawing-Primitives.html#GdkDrawable">GdkDrawable</a> *drawable</code>,

524

<code><a class="link" href="gdk2-Graphics-Contexts.html#GdkGC">GdkGC</a> *gc</code>,

525

<code>gint x</code>,

526

<code>gint y</code>,

527

<code>gint width</code>,

528

<code>gint height</code>,

529

<code><a class="link" href="gdk2-GdkRGB.html#GdkRgbDither" title="enum GdkRgbDither">GdkRgbDither</a> dith</code>,

530

<code>const guchar *buf</code>,

531

<code>gint rowstride</code>);</pre>

532

533

<h3 class="title">Warning</h3>

534

<code class="literal">gdk_draw_gray_image</code> is deprecated and should not be used in newly-written code.

535

</div>

536

537

Draws a grayscale image in the drawable.

538

539

540

541

542

<col>

543

</colgroup>

544

<tbody>

545

<tr>

546

<td><code>drawable</code> :</td>

547

548

</tr>

549

<tr>

550

551

<td>The graphics context.</td>

552

</tr>

553

<tr>

554

555

<td>The x coordinate of the top-left corner in the drawable.</td>

556

</tr>

557

<tr>

558

559

<td>The y coordinate of the top-left corner in the drawable.</td>

560

</tr>

561

<tr>

562

<td><code>width</code> :</td>

563

<td>The width of the rectangle to be drawn.</td>

564

</tr>

565

<tr>

566

<td><code>height</code> :</td>

567

<td>The height of the rectangle to be drawn.</td>

568

</tr>

569

<tr>

570

571

<td>A <a class="link" href="gdk2-GdkRGB.html#GdkRgbDither" title="enum GdkRgbDither">GdkRgbDither</a> value, selecting the desired dither mode.</td>

572

</tr>

573

<tr>

574

575

<td>The pixel data, represented as 8-bit gray values.</td>

576

</tr>

577

<tr>

578

<td><code>rowstride</code> :</td>

579

<td>The number of bytes from the start of one row in <code>buf</code> to the

580

start of the next.</td>

581

</tr>

582

</tbody>

583

</table></div>

584

</div>

585

<hr>

586

587

<a name="gdk-draw-rgb-32-image"></a><h3>gdk_draw_rgb_32_image ()</h3>

588

<pre class="programlisting">void gdk_draw_rgb_32_image (<code><a class="link" href="gdk2-Drawing-Primitives.html#GdkDrawable">GdkDrawable</a> *drawable</code>,

589

<code><a class="link" href="gdk2-Graphics-Contexts.html#GdkGC">GdkGC</a> *gc</code>,

590

<code>gint x</code>,

591

<code>gint y</code>,

592

<code>gint width</code>,

593

<code>gint height</code>,

594

<code><a class="link" href="gdk2-GdkRGB.html#GdkRgbDither" title="enum GdkRgbDither">GdkRgbDither</a> dith</code>,

595

<code>const guchar *buf</code>,

596

<code>gint rowstride</code>);</pre>

597

598

<h3 class="title">Warning</h3>

599

<code class="literal">gdk_draw_rgb_32_image</code> is deprecated and should not be used in newly-written code.

600

</div>

601

602

Draws a padded RGB image in the drawable. The image is stored as one

603

pixel per 32-bit word. It is laid out as a red byte, a green byte, a

604

blue byte, and a padding byte.

605

606

607

It's unlikely that this function will give significant performance

608

gains in practice. In my experience, the performance gain from having

609

pixels aligned to 32-bit boundaries is cancelled out by the increased

610

memory bandwidth.

611

612

613

614

615

<col>

616

</colgroup>

617

<tbody>

618

<tr>

619

<td><code>drawable</code> :</td>

620

621

</tr>

622

<tr>

623

624

<td>The graphics context.</td>

625

</tr>

626

<tr>

627

628

<td>The x coordinate of the top-left corner in the drawable.</td>

629

</tr>

630

<tr>

631

632

<td>The y coordinate of the top-left corner in the drawable.</td>

633

</tr>

634

<tr>

635

<td><code>width</code> :</td>

636

<td>The width of the rectangle to be drawn.</td>

637

</tr>

638

<tr>

639

<td><code>height</code> :</td>

640

<td>The height of the rectangle to be drawn.</td>

641

</tr>

642

<tr>

643

644

<td>A <a class="link" href="gdk2-GdkRGB.html#GdkRgbDither" title="enum GdkRgbDither">GdkRgbDither</a> value, selecting the desired dither mode.</td>

645

</tr>

646

<tr>

647

648

<td>The pixel data, represented as padded 32-bit data.</td>

649

</tr>

650

<tr>

651

<td><code>rowstride</code> :</td>

652

<td>The number of bytes from the start of one row in <code>buf</code> to the

653

start of the next.</td>

654

</tr>

655

</tbody>

656

</table></div>

657

</div>

658

<hr>

659

660

<a name="gdk-draw-rgb-32-image-dithalign"></a><h3>gdk_draw_rgb_32_image_dithalign ()</h3>

661

<pre class="programlisting">void gdk_draw_rgb_32_image_dithalign (<code><a class="link" href="gdk2-Drawing-Primitives.html#GdkDrawable">GdkDrawable</a> *drawable</code>,

662

<code><a class="link" href="gdk2-Graphics-Contexts.html#GdkGC">GdkGC</a> *gc</code>,

663

<code>gint x</code>,

664

<code>gint y</code>,

665

<code>gint width</code>,

666

<code>gint height</code>,

667

<code><a class="link" href="gdk2-GdkRGB.html#GdkRgbDither" title="enum GdkRgbDither">GdkRgbDither</a> dith</code>,

668

<code>const guchar *buf</code>,

669

<code>gint rowstride</code>,

670

<code>gint xdith</code>,

671

<code>gint ydith</code>);</pre>

672

673

<h3 class="title">Warning</h3>

674

<code class="literal">gdk_draw_rgb_32_image_dithalign</code> has been deprecated since version 2.22 and should not be used in newly-written code. Cairo handles colors automatically.

675

</div>

676

677

Like <a class="link" href="gdk2-GdkRGB.html#gdk-draw-rgb-32-image" title="gdk_draw_rgb_32_image ()"><code class="function">gdk_draw_rgb_32_image()</code></a>, but allows you to specify the dither

678

offsets. See <a class="link" href="gdk2-GdkRGB.html#gdk-draw-rgb-image-dithalign" title="gdk_draw_rgb_image_dithalign ()"><code class="function">gdk_draw_rgb_image_dithalign()</code></a> for more details.

679

680

681

682

683

<col>

684

</colgroup>

685

<tbody>

686

<tr>

687

<td><code>drawable</code> :</td>

688

<td>a <a class="link" href="gdk2-Drawing-Primitives.html#GdkDrawable">GdkDrawable</a>

689

</td>

690

</tr>

691

<tr>

692

693

<td>a <a class="link" href="gdk2-Graphics-Contexts.html#GdkGC">GdkGC</a>

694

</td>

695

</tr>

696

<tr>

697

698

<td>X coordinate on <code>drawable</code> where image should go</td>

699

</tr>

700

<tr>

701

702

<td>Y coordinate on <code>drawable</code> where image should go</td>

703

</tr>

704

<tr>

705

<td><code>width</code> :</td>

706

<td>width of area of image to draw</td>

707

</tr>

708

<tr>

709

<td><code>height</code> :</td>

710

<td>height of area of image to draw</td>

711

</tr>

712

<tr>

713

714

<td>dithering mode</td>

715

</tr>

716

<tr>

717

718

<td>RGB image data</td>

719

</tr>

720

<tr>

721

<td><code>rowstride</code> :</td>

722

<td>rowstride of RGB image data</td>

723

</tr>

724

<tr>

725

<td><code>xdith</code> :</td>

726

<td>X dither offset</td>

727

</tr>

728

<tr>

729

<td><code>ydith</code> :</td>

730

<td>Y dither offset</td>

731

</tr>

732

</tbody>

733

</table></div>

734

</div>

735

<hr>

736

737

<a name="GdkRgbDither"></a><h3>enum GdkRgbDither</h3>

738

<pre class="programlisting">typedef enum {

739

GDK_RGB_DITHER_NONE,

740

GDK_RGB_DITHER_NORMAL,

741

GDK_RGB_DITHER_MAX

742

} GdkRgbDither;

743

</pre>

744

745

Selects whether or not GdkRGB applies dithering

746

to the image on display.

747

748

749

Since GdkRGB currently only handles images with 8 bits per component,

750

dithering on 24 bit per pixel displays is a moot point.

751

752

753

754

755

<col>

756

</colgroup>

757

<tbody>

758

<tr>

759

<td><a name="GDK-RGB-DITHER-NONE:CAPS"></a><code class="literal">GDK_RGB_DITHER_NONE</code></td>

760

<td>Never use dithering.

761

</td>

762

</tr>

763

<tr>

764

<td><a name="GDK-RGB-DITHER-NORMAL:CAPS"></a><code class="literal">GDK_RGB_DITHER_NORMAL</code></td>

765

<td>Use dithering in 8 bits per pixel (and below)

766

only.

767

</td>

768

</tr>

769

<tr>

770

<td><a name="GDK-RGB-DITHER-MAX:CAPS"></a><code class="literal">GDK_RGB_DITHER_MAX</code></td>

771

<td>Use dithering in 16 bits per pixel and below.

772

</td>

773

</tr>

774

</tbody>

775

</table></div>

776

</div>

777

<hr>

778

779

780

<pre class="programlisting"><a class="link" href="gdk2-GdkRGB.html#GdkRgbCmap" title="struct GdkRgbCmap">GdkRgbCmap</a> * gdk_rgb_cmap_new (<code>guint32 *colors</code>,

781

<code>gint n_colors</code>);</pre>

782

783

<h3 class="title">Warning</h3>

784

<code class="literal">gdk_rgb_cmap_new</code> is deprecated and should not be used in newly-written code.

785

</div>

786

787

Creates a new <a class="link" href="gdk2-GdkRGB.html#GdkRgbCmap" title="struct GdkRgbCmap">GdkRgbCmap</a> structure. The cmap maps color indexes to

788

RGB colors. If <code>n_colors</code> is less than 256, then images containing

789

color values greater than or equal to <code>n_colors</code> will produce undefined

790

results, including possibly segfaults.

791

792

793

794

795

<col>

796

</colgroup>

797

<tbody>

798

<tr>

799

<td><code>colors</code> :</td>

800

<td>The colors, represented as 0xRRGGBB integer values.</td>

801

</tr>

802

<tr>

803

<td><code>n_colors</code> :</td>

804

<td>The number of colors in the cmap.</td>

805

</tr>

806

<tr>

807

<td>Returns :</td>

808

<td>The newly created <a class="link" href="gdk2-GdkRGB.html#GdkRgbCmap" title="struct GdkRgbCmap">GdkRgbCmap</a>

809

</td>

810

</tr>

811

</tbody>

812

</table></div>

813

</div>

814

<hr>

815

816

817

<pre class="programlisting">void gdk_rgb_cmap_free (<code><a class="link" href="gdk2-GdkRGB.html#GdkRgbCmap" title="struct GdkRgbCmap">GdkRgbCmap</a> *cmap</code>);</pre>

818

819

<h3 class="title">Warning</h3>

820

<code class="literal">gdk_rgb_cmap_free</code> is deprecated and should not be used in newly-written code.

821

</div>

822

823

Frees the memory associated with a <a class="link" href="gdk2-GdkRGB.html#GdkRgbCmap" title="struct GdkRgbCmap">GdkRgbCmap</a> created by <a class="link" href="gdk2-GdkRGB.html#gdk-rgb-cmap-new" title="gdk_rgb_cmap_new ()"><code class="function">gdk_rgb_cmap_new()</code></a>.

824

825

826

827

828

<col>

829

</colgroup>

830

831

832

<td>The <a class="link" href="gdk2-GdkRGB.html#GdkRgbCmap" title="struct GdkRgbCmap">GdkRgbCmap</a> to free.</td>

833

</tr></tbody>

834

</table></div>

835

</div>

836

<hr>

837

838

<a name="GdkRgbCmap"></a><h3>struct GdkRgbCmap</h3>

839

<pre class="programlisting">struct GdkRgbCmap {

840

guint32 colors[256];

841

gint n_colors;

842

};

843

</pre>

844

845

<h3 class="title">Warning</h3>

846

<code class="literal">GdkRgbCmap</code> is deprecated and should not be used in newly-written code.

847

</div>

848

849

A private data structure which maps color indices to actual RGB

850

colors. This is used only for <a class="link" href="gdk2-GdkRGB.html#gdk-draw-indexed-image" title="gdk_draw_indexed_image ()"><code class="function">gdk_draw_indexed_image()</code></a>.

851

852

853

854

855

<col>

856

</colgroup>

857

<tbody>

858

<tr>

859

<td>guint32 <code><a name="GdkRgbCmap.colors"></a>colors</code>[256];</td>

860

<td>The colors, represented as 0xRRGGBB integer values.</td>

861

</tr>

862

<tr>

863

<td>gint <code><a name="GdkRgbCmap.n-colors"></a>n_colors</code>;</td>

864

<td>The number of colors in the cmap.</td>

865

</tr>

866

</tbody>

867

</table></div>

868

</div>

869

<hr>

870

871

<a name="gdk-rgb-gc-set-foreground"></a><h3>gdk_rgb_gc_set_foreground ()</h3>

872

<pre class="programlisting">void gdk_rgb_gc_set_foreground (<code><a class="link" href="gdk2-Graphics-Contexts.html#GdkGC">GdkGC</a> *gc</code>,

873

<code>guint32 rgb</code>);</pre>

874

875

<h3 class="title">Warning</h3>

876

<code class="literal">gdk_rgb_gc_set_foreground</code> is deprecated and should not be used in newly-written code.

877

</div>

878

879

Sets the foreground color in <code>gc</code> to the specified color (or the

880

closest approximation, in the case of limited visuals).

881

882

883

884

885

<col>

886

</colgroup>

887

<tbody>

888

<tr>

889

890

<td>The <a class="link" href="gdk2-Graphics-Contexts.html#GdkGC">GdkGC</a> to modify.</td>

891

</tr>

892

<tr>

893

894

<td>The color, represented as a 0xRRGGBB integer value.</td>

895

</tr>

896

</tbody>

897

</table></div>

898

</div>

899

<hr>

900

901

<a name="gdk-rgb-gc-set-background"></a><h3>gdk_rgb_gc_set_background ()</h3>

902

<pre class="programlisting">void gdk_rgb_gc_set_background (<code><a class="link" href="gdk2-Graphics-Contexts.html#GdkGC">GdkGC</a> *gc</code>,

903

<code>guint32 rgb</code>);</pre>

904

905

<h3 class="title">Warning</h3>

906

<code class="literal">gdk_rgb_gc_set_background</code> is deprecated and should not be used in newly-written code.

907

</div>

908

909

Sets the background color in <code>gc</code> to the specified color (or the

910

closest approximation, in the case of limited visuals).

911

912

913

914

915

<col>

916

</colgroup>

917

<tbody>

918

<tr>

919

920

<td>The <a class="link" href="gdk2-Graphics-Contexts.html#GdkGC">GdkGC</a> to modify.</td>

921

</tr>

922

<tr>

923

924

<td>The color, represented as a 0xRRGGBB integer value.</td>

925

</tr>

926

</tbody>

927

</table></div>

928

</div>

929

<hr>

930

931

<a name="gdk-rgb-xpixel-from-rgb"></a><h3>gdk_rgb_xpixel_from_rgb ()</h3>

932

<pre class="programlisting">gulong gdk_rgb_xpixel_from_rgb (<code>guint32 rgb</code>);</pre>

933

934

<h3 class="title">Warning</h3>

935

<code class="literal">gdk_rgb_xpixel_from_rgb</code> is deprecated and should not be used in newly-written code.

936

</div>

937

938

Finds the X pixel closest in color to the <code>rgb</code> color specified. This

939

value may be used to set the <code>pixel</code> field of

940

a <a class="link" href="gdk2-Colormaps-and-Colors.html#GdkColor" title="GdkColor">GdkColor</a> struct.

941

942

943

944

945

<col>

946

</colgroup>

947

<tbody>

948

<tr>

949

950

<td>The color, represented as a 0xRRGGBB integer value.</td>

951

</tr>

952

<tr>

953

<td>Returns :</td>

954

<td>The X pixel value.</td>

955

</tr>

956

</tbody>

957

</table></div>

958

</div>

959

<hr>

960

961

<a name="gdk-rgb-find-color"></a><h3>gdk_rgb_find_color ()</h3>

962

<pre class="programlisting">void gdk_rgb_find_color (<code><a class="link" href="gdk2-Colormaps-and-Colors.html#GdkColormap" title="GdkColormap">GdkColormap</a> *colormap</code>,

963

<code><a class="link" href="gdk2-Colormaps-and-Colors.html#GdkColor" title="GdkColor">GdkColor</a> *color</code>);</pre>

964

965

<h3 class="title">Warning</h3>

966

<code class="literal">gdk_rgb_find_color</code> has been deprecated since version 2.22 and should not be used in newly-written code. Cairo handles colors automatically.

967

</div>

968

969

<code>colormap</code> should be the colormap for the graphics context and

970

drawable you're using to draw. If you're drawing to a <a href="http://developer.gnome.org/gtk2/GtkWidget.html">GtkWidget</a>,

971

call <code class="function">gtk_widget_get_colormap()</code>.

972

973

974

<code>color</code> should have its <code class="literal">red</code>, <code class="literal">green</code>, and <code class="literal">blue</code> fields initialized;

975

<a class="link" href="gdk2-GdkRGB.html#gdk-rgb-find-color" title="gdk_rgb_find_color ()"><code class="function">gdk_rgb_find_color()</code></a> will fill in the <code class="literal">pixel</code> field with the best

976

matching pixel from a color cube. The color is then ready to be

977

used for drawing, e.g. you can call <a class="link" href="gdk2-Graphics-Contexts.html#gdk-gc-set-foreground" title="gdk_gc_set_foreground ()"><code class="function">gdk_gc_set_foreground()</code></a> which

978

expects <code class="literal">pixel</code> to be initialized.

979

980

981

In many cases, you can avoid this whole issue by calling

982

<a class="link" href="gdk2-Graphics-Contexts.html#gdk-gc-set-rgb-fg-color" title="gdk_gc_set_rgb_fg_color ()"><code class="function">gdk_gc_set_rgb_fg_color()</code></a> or <a class="link" href="gdk2-Graphics-Contexts.html#gdk-gc-set-rgb-bg-color" title="gdk_gc_set_rgb_bg_color ()"><code class="function">gdk_gc_set_rgb_bg_color()</code></a>, which

983

do not expect <code class="literal">pixel</code> to be initialized in advance. If you use those

984

functions, there's no need for <a class="link" href="gdk2-GdkRGB.html#gdk-rgb-find-color" title="gdk_rgb_find_color ()"><code class="function">gdk_rgb_find_color()</code></a>.

985

986

987

988

989

<col>

990

</colgroup>

991

<tbody>

992

<tr>

993

<td><code>colormap</code> :</td>

994

<td>a <a class="link" href="gdk2-Colormaps-and-Colors.html#GdkColormap" title="GdkColormap">GdkColormap</a>

995

</td>

996

</tr>

997

<tr>

998

<td><code>color</code> :</td>

999

<td>a <a class="link" href="gdk2-Colormaps-and-Colors.html#GdkColor" title="GdkColor">GdkColor</a>

1000

</td>

1001

</tr>

1002

</tbody>

1003

</table></div>

1004

</div>

1005

<hr>

1006

1007

<a name="gdk-rgb-set-install"></a><h3>gdk_rgb_set_install ()</h3>

1008

<pre class="programlisting">void gdk_rgb_set_install (<code>gboolean install</code>);</pre>

1009

1010

<h3 class="title">Warning</h3>

1011

<code class="literal">gdk_rgb_set_install</code> is deprecated and should not be used in newly-written code.

1012

</div>

1013

1014

If <code>install</code> is <code class="literal">TRUE</code>, directs GdkRGB to always install a new "private"

1015

colormap rather than trying to find a best fit with the colors already

1016

allocated. Ordinarily, GdkRGB will install a colormap only if a

1017

sufficient cube cannot be allocated.

1018

1019

1020

A private colormap has more colors, leading to better quality display,

1021

but also leads to the dreaded "colormap flashing" effect.

1022

1023

1024

1025

1026

<col>

1027

</colgroup>

1028

1029

<td><code>install</code> :</td>

1030

<td>

1031

<code class="literal">TRUE</code> to set install mode.</td>

1032

</tr></tbody>

1033

</table></div>

1034

</div>

1035

<hr>

1036

1037

<a name="gdk-rgb-set-min-colors"></a><h3>gdk_rgb_set_min_colors ()</h3>

1038

<pre class="programlisting">void gdk_rgb_set_min_colors (<code>gint min_colors</code>);</pre>

1039

1040

<h3 class="title">Warning</h3>

1041

<code class="literal">gdk_rgb_set_min_colors</code> is deprecated and should not be used in newly-written code.

1042

</div>

1043

1044

Sets the minimum number of colors for the color cube. Generally,

1045

GdkRGB tries to allocate the largest color cube it can. If it can't

1046

allocate a color cube at least as large as <code>min_colors</code>, it installs a

1047

private colormap.

1048

1049

1050

1051

1052

<col>

1053

</colgroup>

1054

1055

<td><code>min_colors</code> :</td>

1056

<td>The minimum number of colors accepted.</td>

1057

</tr></tbody>

1058

</table></div>

1059

</div>

1060

<hr>

1061

1062

<a name="gdk-rgb-get-visual"></a><h3>gdk_rgb_get_visual ()</h3>

1063

<pre class="programlisting"><a class="link" href="gdk2-Visuals.html#GdkVisual" title="GdkVisual">GdkVisual</a> * gdk_rgb_get_visual (<code>void</code>);</pre>

1064

1065

<h3 class="title">Warning</h3>

1066

<code class="literal">gdk_rgb_get_visual</code> has been deprecated since version 2.22 and should not be used in newly-written code. Use gdk_visual_get_system_visual (<a class="link" href="GdkScreen.html#gdk-screen-get-default" title="gdk_screen_get_default ()"><code class="function">gdk_screen_get_default()</code></a>) instead.

1067

</div>

1068

1069

Gets a "preferred visual" chosen by GdkRGB for rendering image data

1070

on the default screen. In previous versions of GDK, this was the

1071

only visual GdkRGB could use for rendering. In current versions,

1072

it's simply the visual GdkRGB would have chosen as the optimal one

1073

in those previous versions. GdkRGB can now render to drawables with

1074

any visual.

1075

1076

1077

1078

1079

<col>

1080

</colgroup>

1081

1082

<td>Returns :</td>

1083

<td>The <a class="link" href="gdk2-Visuals.html#GdkVisual" title="GdkVisual">GdkVisual</a> chosen by GdkRGB. [<acronym title="Don't free data after the code is done.">transfer none</acronym>]

1084

</td>

1085

</tr></tbody>

1086

</table></div>

1087

</div>

1088

<hr>

1089

1090

<a name="gdk-rgb-get-colormap"></a><h3>gdk_rgb_get_colormap ()</h3>

1091

<pre class="programlisting"><a class="link" href="gdk2-Colormaps-and-Colors.html#GdkColormap" title="GdkColormap">GdkColormap</a> * gdk_rgb_get_colormap (<code>void</code>);</pre>

1092

1093

<h3 class="title">Warning</h3>

1094

<code class="literal">gdk_rgb_get_colormap</code> has been deprecated since version 2.22 and should not be used in newly-written code. Use gdk_screen_get_system_colormap (<a class="link" href="GdkScreen.html#gdk-screen-get-default" title="gdk_screen_get_default ()"><code class="function">gdk_screen_get_default()</code></a>) instead.

1095

</div>

1096

1097

Get the preferred colormap for rendering image data. Not a

1098

very useful function; historically, GDK could only render RGB image

1099

data to one colormap and visual, but in the current version it can

1100

render to any colormap and visual. So there's no need to call this

1101

function.

1102

1103

1104

1105

1106

<col>

1107

</colgroup>

1108

1109

<td>Returns :</td>

1110

<td>the preferred colormap. [<acronym title="Don't free data after the code is done.">transfer none</acronym>]

1111

</td>

1112

</tr></tbody>

1113

</table></div>

1114

</div>

1115

<hr>

1116

1117

1118

<pre class="programlisting">#define gdk_rgb_get_cmap gdk_rgb_get_colormap

1119

</pre>

1120

1121

<h3 class="title">Warning</h3>

1122

<code class="literal">gdk_rgb_get_cmap</code> is deprecated and should not be used in newly-written code.

1123

</div>

1124

1125

Gets the colormap set by GdkRGB. This colormap and the corresponding

1126

visual should be used when creating windows that will be drawn in by GdkRGB.

1127

1128

1129

1130

1131

<col>

1132

</colgroup>

1133

1134

<td>Returns :</td>

1135

<td>The <a class="link" href="gdk2-Colormaps-and-Colors.html#GdkColormap" title="GdkColormap">GdkColormap</a> set by GdkRGB.</td>

1136

</tr></tbody>

1137

</table></div>

1138

</div>

1139

<hr>

1140

1141

<a name="gdk-rgb-ditherable"></a><h3>gdk_rgb_ditherable ()</h3>

1142

<pre class="programlisting">gboolean gdk_rgb_ditherable (<code>void</code>);</pre>

1143

1144

<h3 class="title">Warning</h3>

1145

<code class="literal">gdk_rgb_ditherable</code> is deprecated and should not be used in newly-written code.

1146

</div>

1147

1148

Determines whether the preferred visual is ditherable. This function may be

1149

useful for presenting a user interface choice to the user about which

1150

dither mode is desired; if the display is not ditherable, it may make

1151

sense to gray out or hide the corresponding UI widget.

1152

1153

1154

1155

1156

<col>

1157

</colgroup>

1158

1159

<td>Returns :</td>

1160

<td>

1161

<code class="literal">TRUE</code> if the preferred visual is ditherable.</td>

1162

</tr></tbody>

1163

</table></div>

1164

</div>

1165

<hr>

1166

1167

<a name="gdk-rgb-colormap-ditherable"></a><h3>gdk_rgb_colormap_ditherable ()</h3>

1168

<pre class="programlisting">gboolean gdk_rgb_colormap_ditherable (<code><a class="link" href="gdk2-Colormaps-and-Colors.html#GdkColormap" title="GdkColormap">GdkColormap</a> *cmap</code>);</pre>

1169

1170

<h3 class="title">Warning</h3>

1171

<code class="literal">gdk_rgb_colormap_ditherable</code> is deprecated and should not be used in newly-written code.

1172

</div>

1173

1174

Determines whether the visual associated with <code>cmap</code> is ditherable. This

1175

function may be useful for presenting a user interface choice to the user

1176

about which dither mode is desired; if the display is not ditherable, it may

1177

make sense to gray out or hide the corresponding UI widget.

1178

1179

1180

1181

1182

<col>

1183

</colgroup>

1184

<tbody>

1185

<tr>

1186

1187

<td>a <a class="link" href="gdk2-Colormaps-and-Colors.html#GdkColormap" title="GdkColormap">GdkColormap</a>

1188

</td>

1189

</tr>

1190

<tr>

1191

<td>Returns :</td>

1192

<td>

1193

<code class="literal">TRUE</code> if the visual associated with <code>cmap</code> is ditherable.</td>

1194

</tr>

1195

</tbody>

1196

</table></div>

1197

</div>

1198

<hr>

1199

1200

<a name="gdk-rgb-set-verbose"></a><h3>gdk_rgb_set_verbose ()</h3>

1201

<pre class="programlisting">void gdk_rgb_set_verbose (<code>gboolean verbose</code>);</pre>

1202

1203

<h3 class="title">Warning</h3>

1204

<code class="literal">gdk_rgb_set_verbose</code> is deprecated and should not be used in newly-written code.

1205

</div>

1206

1207

Sets the "verbose" flag. This is generally only useful for debugging.

1208

1209

1210

1211

1212

<col>

1213

</colgroup>

1214

1215

<td><code>verbose</code> :</td>

1216

<td>

1217

<code class="literal">TRUE</code> if verbose messages are desired.</td>

1218

</tr></tbody>

1219

</table></div>

1220

</div>

1221

</div>

1222

1223

1224

1225

1226

1227

1228

1229

<col>

1230

</colgroup>

1231

<tbody>

1232

<tr>

1233

<td><a class="link" href="gdk2-Colormaps-and-Colors.html#GdkColor" title="GdkColor">GdkColor</a></td>

1234

<td>The underlying GDK mechanism for allocating

1235

colors.</td>

1236

</tr>

1237

<tr>

1238

<td><a href="/usr/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf">GdkPixbuf</a> and <a class="link" href="gdk2-Drawing-Primitives.html#gdk-draw-pixbuf" title="gdk_draw_pixbuf ()"><code class="function">gdk_draw_pixbuf()</code></a></td>

1239

<td>Higher-level image handling.</td>

1240

</tr>

1241

</tbody>

1242

</table></div>

1243

1244

1245

</div>

1246

</div>

1247

1248

<hr>

1249

Generated by GTK-Doc V1.18</div>

1250

</body>

1251

</html>

b'\\ No newline at end of file'

Older »