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

<a href="/usr/share/gtk-doc/html/pango/pango-pango-renderer.html#PangoRenderer">PangoRenderer</a> * <a class="link" href="gdk2-Pango-Interaction.html#gdk-pango-renderer-new" title="gdk_pango_renderer_new ()">gdk_pango_renderer_new</a> (<code><a class="link" href="GdkScreen.html" title="GdkScreen">GdkScreen</a> *screen</code>);

<a href="/usr/share/gtk-doc/html/pango/pango-pango-renderer.html#PangoRenderer">PangoRenderer</a> * <a class="link" href="gdk2-Pango-Interaction.html#gdk-pango-renderer-get-default" title="gdk_pango_renderer_get_default ()">gdk_pango_renderer_get_default</a> (<code><a class="link" href="GdkScreen.html" title="GdkScreen">GdkScreen</a> *screen</code>);

void <a class="link" href="gdk2-Pango-Interaction.html#gdk-pango-renderer-set-drawable" title="gdk_pango_renderer_set_drawable ()">gdk_pango_renderer_set_drawable</a> (<code><a class="link" href="gdk2-Pango-Interaction.html#GdkPangoRenderer">GdkPangoRenderer</a> *gdk_renderer</code>,

<code><a class="link" href="gdk2-Drawing-Primitives.html#GdkDrawable">GdkDrawable</a> *drawable</code>);

void <a class="link" href="gdk2-Pango-Interaction.html#gdk-pango-renderer-set-gc" title="gdk_pango_renderer_set_gc ()">gdk_pango_renderer_set_gc</a> (<code><a class="link" href="gdk2-Pango-Interaction.html#GdkPangoRenderer">GdkPangoRenderer</a> *gdk_renderer</code>,

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

void <a class="link" href="gdk2-Pango-Interaction.html#gdk-pango-renderer-set-stipple" title="gdk_pango_renderer_set_stipple ()">gdk_pango_renderer_set_stipple</a> (<code><a class="link" href="gdk2-Pango-Interaction.html#GdkPangoRenderer">GdkPangoRenderer</a> *gdk_renderer</code>,

<code><a href="/usr/share/gtk-doc/html/pango/pango-pango-renderer.html#PangoRenderPart">PangoRenderPart</a> part</code>,

<code><a class="link" href="gdk2-Bitmaps-and-Pixmaps.html#GdkBitmap" title="GdkBitmap">GdkBitmap</a> *stipple</code>);

void <a class="link" href="gdk2-Pango-Interaction.html#gdk-pango-renderer-set-override-color" title="gdk_pango_renderer_set_override_color ()">gdk_pango_renderer_set_override_color</a>

(<code><a class="link" href="gdk2-Pango-Interaction.html#GdkPangoRenderer">GdkPangoRenderer</a> *gdk_renderer</code>,

<code><a href="/usr/share/gtk-doc/html/pango/pango-pango-renderer.html#PangoRenderPart">PangoRenderPart</a> part</code>,

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

<a href="/usr/share/gtk-doc/html/pango/pango-Text-Processing.html#PangoContext">PangoContext</a> * <a class="link" href="gdk2-Pango-Interaction.html#gdk-pango-context-get" title="gdk_pango_context_get ()">gdk_pango_context_get</a> (<code>void</code>);

<a href="/usr/share/gtk-doc/html/pango/pango-Text-Processing.html#PangoContext">PangoContext</a> * <a class="link" href="gdk2-Pango-Interaction.html#gdk-pango-context-get-for-screen" title="gdk_pango_context_get_for_screen ()">gdk_pango_context_get_for_screen</a> (<code><a class="link" href="GdkScreen.html" title="GdkScreen">GdkScreen</a> *screen</code>);

void <a class="link" href="gdk2-Pango-Interaction.html#gdk-pango-context-set-colormap" title="gdk_pango_context_set_colormap ()">gdk_pango_context_set_colormap</a> (<code><a href="/usr/share/gtk-doc/html/pango/pango-Text-Processing.html#PangoContext">PangoContext</a> *context</code>,

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

struct <a class="link" href="gdk2-Pango-Interaction.html#GdkPangoAttrEmbossed" title="struct GdkPangoAttrEmbossed">GdkPangoAttrEmbossed</a>;

struct <a class="link" href="gdk2-Pango-Interaction.html#GdkPangoAttrEmbossColor" title="struct GdkPangoAttrEmbossColor">GdkPangoAttrEmbossColor</a>;

struct <a class="link" href="gdk2-Pango-Interaction.html#GdkPangoAttrStipple" title="struct GdkPangoAttrStipple">GdkPangoAttrStipple</a>;

<a href="/usr/share/gtk-doc/html/pango/pango-Text-Attributes.html#PangoAttribute">PangoAttribute</a> * <a class="link" href="gdk2-Pango-Interaction.html#gdk-pango-attr-emboss-color-new" title="gdk_pango_attr_emboss_color_new ()">gdk_pango_attr_emboss_color_new</a> (<code>const <a class="link" href="gdk2-Colormaps-and-Colors.html#GdkColor" title="GdkColor">GdkColor</a> *color</code>);

<a href="/usr/share/gtk-doc/html/pango/pango-Text-Attributes.html#PangoAttribute">PangoAttribute</a> * <a class="link" href="gdk2-Pango-Interaction.html#gdk-pango-attr-embossed-new" title="gdk_pango_attr_embossed_new ()">gdk_pango_attr_embossed_new</a> (<code>gboolean embossed</code>);

<a href="/usr/share/gtk-doc/html/pango/pango-Text-Attributes.html#PangoAttribute">PangoAttribute</a> * <a class="link" href="gdk2-Pango-Interaction.html#gdk-pango-attr-stipple-new" title="gdk_pango_attr_stipple_new ()">gdk_pango_attr_stipple_new</a> (<code><a class="link" href="gdk2-Bitmaps-and-Pixmaps.html#GdkBitmap" title="GdkBitmap">GdkBitmap</a> *stipple</code>);

<a class="link" href="gdk2-Points-Rectangles-and-Regions.html#GdkRegion" title="GdkRegion">GdkRegion</a> * <a class="link" href="gdk2-Pango-Interaction.html#gdk-pango-layout-get-clip-region" title="gdk_pango_layout_get_clip_region ()">gdk_pango_layout_get_clip_region</a> (<code><a href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayout">PangoLayout</a> *layout</code>,

<code>gint x_origin</code>,

<code>gint y_origin</code>,

<code>const gint *index_ranges</code>,

<code>gint n_ranges</code>);

(<code><a href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayoutLine">PangoLayoutLine</a> *line</code>,

<code>gint x_origin</code>,

<code>gint y_origin</code>,

<code>const gint *index_ranges</code>,

<code>gint n_ranges</code>);

</pre>

</div>

<a name="gdk2-Pango-Interaction.object-hierarchy"></a><h2>Object Hierarchy</h2>

GObject

+----<a href="/usr/share/gtk-doc/html/pango/pango-pango-renderer.html#PangoRenderer">PangoRenderer</a>

+----GdkPangoRenderer

</pre>

</div>

<a name="gdk2-Pango-Interaction.properties"></a><h2>Properties</h2>

"<a class="link" href="gdk2-Pango-Interaction.html#GdkPangoRenderer--screen" title='The "screen" property'>screen</a>" <a class="link" href="GdkScreen.html" title="GdkScreen">GdkScreen</a>* : Read / Write / Construct Only

</pre>

</div>

100

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

101

102

Pango is the text layout system used by GDK and GTK+. The functions

103

and types in this section are used to render Pango objects to GDK.

104

drawables, and also extend the set of Pango attributes to include

105

stippling and embossing.

106

107

108

Creating a <a href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayout">PangoLayout</a> object is the first step in rendering text,

109

and requires getting a handle to a <a href="/usr/share/gtk-doc/html/pango/pango-Text-Processing.html#PangoContext">PangoContext</a>. For GTK+ programs,

110

you'll usually want to use <a href="http://developer.gnome.org/gtk2/GtkWidget.html#gtk-widget-get-pango-context"><code class="function">gtk_widget_get_pango_context()</code></a>, or

111

<a href="http://developer.gnome.org/gtk2/GtkWidget.html#gtk-widget-create-pango-layout"><code class="function">gtk_widget_create_pango_layout()</code></a>, rather than using the lowlevel

112

<a class="link" href="gdk2-Pango-Interaction.html#gdk-pango-context-get-for-screen" title="gdk_pango_context_get_for_screen ()"><code class="function">gdk_pango_context_get_for_screen()</code></a>. Once you have a <a href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayout">PangoLayout</a>, you

113

can set the text and attributes of it with Pango functions like

114

<a href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#pango-layout-set-text"><code class="function">pango_layout_set_text()</code></a> and get its size with <a href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#pango-layout-get-size"><code class="function">pango_layout_get_size()</code></a>.

115

(Note that Pango uses a fixed point system internally, so converting

116

between Pango units and pixels using PANGO_SCALE or the <a href="/usr/share/gtk-doc/html/pango/pango-Glyph-Storage.html#PANGO-PIXELS:CAPS"><code class="function">PANGO_PIXELS()</code></a> macro.)

117

118

119

Rendering a Pango layout is done most simply with <a class="link" href="gdk2-Drawing-Primitives.html#gdk-draw-layout" title="gdk_draw_layout ()"><code class="function">gdk_draw_layout()</code></a>;

120

you can also draw pieces of the layout with <a class="link" href="gdk2-Drawing-Primitives.html#gdk-draw-layout" title="gdk_draw_layout ()"><code class="function">gdk_draw_layout()</code></a> or

121

<a class="link" href="gdk2-Drawing-Primitives.html#gdk-draw-glyphs" title="gdk_draw_glyphs ()"><code class="function">gdk_draw_glyphs()</code></a>. <a class="link" href="gdk2-Pango-Interaction.html#GdkPangoRenderer">GdkPangoRenderer</a> is a subclass of <a href="/usr/share/gtk-doc/html/pango/pango-pango-renderer.html#PangoRenderer">PangoRenderer</a>

122

that is used internally to implement these functions. Using it

123

directly or subclassing it can be useful in some cases. See the

124

<a class="link" href="gdk2-Pango-Interaction.html#GdkPangoRenderer">GdkPangoRenderer</a> documentation for details.

125

126

127

<a name="rotated-example"></a>Example 8. Using <a class="link" href="gdk2-Pango-Interaction.html#GdkPangoRenderer">GdkPangoRenderer</a> to draw transformed text

128

129

130

<tbody>

131

<tr>

132

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

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

168

169

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

64</pre></td>

196

<td class="listing_code"><pre class="programlisting">#define RADIUS 100

197

#define N_WORDS 10

198

#define FONT "Sans Bold 18"

199

GdkScreen *screen = <a href="gdk2-Drawing-Primitives.html#gdk-drawable-get-screen">gdk_drawable_get_screen</a> (drawable);

200

PangoRenderer *renderer;

201

GdkGC *gc;

202

PangoMatrix matrix = <a href="/usr/share/gtk-doc/html/pango/pango-Glyph-Storage.html#PANGO-MATRIX-INIT:CAPS">PANGO_MATRIX_INIT</a>;

203

PangoContext *context;

204

PangoLayout *layout;

205

PangoFontDescription *desc;

206

double device_radius;

207

int width, height;

208

int i;

209

/* Get the default renderer for the screen, and set it up for drawing */

210

renderer = <a href="gdk2-Pango-Interaction.html#gdk-pango-renderer-get-default">gdk_pango_renderer_get_default</a> (screen);

211

<a href="gdk2-Pango-Interaction.html#gdk-pango-renderer-set-drawable">gdk_pango_renderer_set_drawable</a> (GDK_PANGO_RENDERER (renderer), drawable);

212

gc = <a href="gdk2-Graphics-Contexts.html#gdk-gc-new">gdk_gc_new</a> (drawable);

213

<a href="gdk2-Pango-Interaction.html#gdk-pango-renderer-set-gc">gdk_pango_renderer_set_gc</a> (GDK_PANGO_RENDERER (renderer), gc);

214

/* Set up a transformation matrix so that the user space coordinates for

215

* where we are drawing are [-RADIUS, RADIUS], [-RADIUS, RADIUS]

216

* We first center, then change the scale */

217

<a href="gdk2-Drawing-Primitives.html#gdk-drawable-get-size">gdk_drawable_get_size</a> (drawable, &width, &height);

218

device_radius = MIN (width, height) / 2.;

219

<a href="/usr/share/gtk-doc/html/pango/pango-Glyph-Storage.html#pango-matrix-translate">pango_matrix_translate</a> (&matrix,

220

device_radius + (width - 2 * device_radius) / 2,

221

device_radius + (height - 2 * device_radius) / 2);

222

<a href="/usr/share/gtk-doc/html/pango/pango-Glyph-Storage.html#pango-matrix-scale">pango_matrix_scale</a> (&matrix, device_radius / RADIUS, device_radius / RADIUS);

223

/* Create a PangoLayout, set the font and text */

224

context = <a href="gdk2-Pango-Interaction.html#gdk-pango-context-get-for-screen">gdk_pango_context_get_for_screen</a> (screen);

225

layout = <a href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#pango-layout-new">pango_layout_new</a> (context);

226

<a href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#pango-layout-set-text">pango_layout_set_text</a> (layout, "Text", -1);

227

desc = <a href="/usr/share/gtk-doc/html/pango/pango-Fonts.html#pango-font-description-from-string">pango_font_description_from_string</a> (FONT);

228

<a href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#pango-layout-set-font-description">pango_layout_set_font_description</a> (layout, desc);

229

<a href="/usr/share/gtk-doc/html/pango/pango-Fonts.html#pango-font-description-free">pango_font_description_free</a> (desc);

230

/* Draw the layout N_WORDS times in a circle */

231

for (i = 0; i < N_WORDS; i++)

232

{

233

GdkColor color;

234

PangoMatrix rotated_matrix = matrix;

235

int width, height;

236

double angle = (360. * i) / N_WORDS;

237

/* Gradient from red at angle == 60 to blue at angle == 300 */

238

color.red = 65535 * (1 + cos ((angle - 60) * M_PI / 180.)) / 2;

239

color.green = 0;

240

color.blue = 65535 - color.red;

241

<a href="gdk2-Pango-Interaction.html#gdk-pango-renderer-set-override-color">gdk_pango_renderer_set_override_color</a> (GDK_PANGO_RENDERER (renderer),

242

<a href="/usr/share/gtk-doc/html/pango/pango-pango-renderer.html#PANGO-RENDER-PART-FOREGROUND:CAPS">PANGO_RENDER_PART_FOREGROUND</a>, &color);

243

<a href="/usr/share/gtk-doc/html/pango/pango-Glyph-Storage.html#pango-matrix-rotate">pango_matrix_rotate</a> (&rotated_matrix, angle);

244

<a href="/usr/share/gtk-doc/html/pango/pango-Text-Processing.html#pango-context-set-matrix">pango_context_set_matrix</a> (context, &rotated_matrix);

245

/* Inform Pango to re-layout the text with the new transformation matrix */

246

<a href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#pango-layout-context-changed">pango_layout_context_changed</a> (layout);

247

<a href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#pango-layout-get-size">pango_layout_get_size</a> (layout, &width, &height);

248

<a href="/usr/share/gtk-doc/html/pango/pango-pango-renderer.html#pango-renderer-draw-layout">pango_renderer_draw_layout</a> (renderer, layout,

249

- width / 2, - RADIUS * <a href="/usr/share/gtk-doc/html/pango/pango-Glyph-Storage.html#PANGO-SCALE:CAPS">PANGO_SCALE</a>);

250

}

251

/* Clean up default renderer, since it is shared */

252

<a href="gdk2-Pango-Interaction.html#gdk-pango-renderer-set-override-color">gdk_pango_renderer_set_override_color</a> (GDK_PANGO_RENDERER (renderer),

253

<a href="/usr/share/gtk-doc/html/pango/pango-pango-renderer.html#PANGO-RENDER-PART-FOREGROUND:CAPS">PANGO_RENDER_PART_FOREGROUND</a>, <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS">NULL</a>);

254

255

256

/* free the objects we created */

257

g_object_unref (layout);

258

g_object_unref (context);

259

g_object_unref (gc);</pre></td>

260

</tr>

261

</tbody>

262

</table>

263

</div>

264

265

</div>

266

267

<a name="idp24397744"></a>Figure 1. Output of <a class="xref" href="gdk2-Pango-Interaction.html#rotated-example" title="Example 8. Using GdkPangoRenderer to draw transformed text">Example 8, “Using GdkPangoRenderer to draw transformed text”</a>

268

269

</div>

270

271

</div>

272

273

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

274

275

<a name="GdkPangoRenderer-struct"></a><h3>struct GdkPangoRenderer</h3>

276

<pre class="programlisting">struct GdkPangoRenderer;</pre>

277

278

<a class="link" href="gdk2-Pango-Interaction.html#GdkPangoRenderer">GdkPangoRenderer</a> is a subclass of <a href="/usr/share/gtk-doc/html/pango/pango-pango-renderer.html#PangoRenderer">PangoRenderer</a> used for rendering

279

Pango objects into GDK drawables. The default renderer for a particular

280

screen is obtained with <a class="link" href="gdk2-Pango-Interaction.html#gdk-pango-renderer-get-default" title="gdk_pango_renderer_get_default ()"><code class="function">gdk_pango_renderer_get_default()</code></a>; Pango

281

functions like <a href="/usr/share/gtk-doc/html/pango/pango-pango-renderer.html#pango-renderer-draw-layout"><code class="function">pango_renderer_draw_layout()</code></a> and

282

<a href="/usr/share/gtk-doc/html/pango/pango-pango-renderer.html#pango-renderer-draw-layout-line"><code class="function">pango_renderer_draw_layout_line()</code></a> are then used to draw objects with

283

the renderer.

284

285

286

In most simple cases, applications can just use <a class="link" href="gdk2-Drawing-Primitives.html#gdk-draw-layout" title="gdk_draw_layout ()"><code class="function">gdk_draw_layout()</code></a>, and

287

don't need to directly use <a class="link" href="gdk2-Pango-Interaction.html#GdkPangoRenderer">GdkPangoRenderer</a> at all. Using the

288

<a class="link" href="gdk2-Pango-Interaction.html#GdkPangoRenderer">GdkPangoRenderer</a> directly is most useful when working with a

289

transformation such as a rotation, because the Pango drawing functions

290

take user space coordinates (coordinates before the transformation)

291

instead of device coordinates.

292

293

294

In certain cases it can be useful to subclass <a class="link" href="gdk2-Pango-Interaction.html#GdkPangoRenderer">GdkPangoRenderer</a>. Examples

295

of reasons to do this are to add handling of custom attributes by

296

overriding 'prepare_run' or to do custom drawing of embedded objects

297

by overriding 'draw_shape'.

298

299

Since 2.6

300

</div>

301

<hr>

302

303

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

304

<pre class="programlisting">struct GdkPangoRendererClass {

305

};

306

</pre>

307

308

<a class="link" href="gdk2-Pango-Interaction.html#GdkPangoRenderer">GdkPangoRenderer</a> is the class structure for <a class="link" href="gdk2-Pango-Interaction.html#GdkPangoRenderer">GdkPangoRenderer</a>.

309

310

Since 2.6

311

</div>

312

<hr>

313

314

<a name="gdk-pango-renderer-new"></a><h3>gdk_pango_renderer_new ()</h3>

315

<pre class="programlisting"><a href="/usr/share/gtk-doc/html/pango/pango-pango-renderer.html#PangoRenderer">PangoRenderer</a> * gdk_pango_renderer_new (<code><a class="link" href="GdkScreen.html" title="GdkScreen">GdkScreen</a> *screen</code>);</pre>

316

317

Creates a new <a href="/usr/share/gtk-doc/html/pango/pango-pango-renderer.html#PangoRenderer">PangoRenderer</a> for <code>screen</code>. Normally you can use the

318

results of <a class="link" href="gdk2-Pango-Interaction.html#gdk-pango-renderer-get-default" title="gdk_pango_renderer_get_default ()"><code class="function">gdk_pango_renderer_get_default()</code></a> rather than creating a new

319

renderer.

320

321

322

323

324

<col>

325

</colgroup>

326

<tbody>

327

<tr>

328

<td><code>screen</code> :</td>

329

<td>a <a class="link" href="GdkScreen.html" title="GdkScreen">GdkScreen</a>

330

</td>

331

</tr>

332

<tr>

333

<td>Returns :</td>

334

<td>a newly created <a href="/usr/share/gtk-doc/html/pango/pango-pango-renderer.html#PangoRenderer">PangoRenderer</a>. Free with <code class="function">g_object_unref()</code>.</td>

335

</tr>

336

</tbody>

337

</table></div>

338

Since 2.6

339

</div>

340

<hr>

341

342

<a name="gdk-pango-renderer-get-default"></a><h3>gdk_pango_renderer_get_default ()</h3>

343

<pre class="programlisting"><a href="/usr/share/gtk-doc/html/pango/pango-pango-renderer.html#PangoRenderer">PangoRenderer</a> * gdk_pango_renderer_get_default (<code><a class="link" href="GdkScreen.html" title="GdkScreen">GdkScreen</a> *screen</code>);</pre>

344

345

Gets the default <a href="/usr/share/gtk-doc/html/pango/pango-pango-renderer.html#PangoRenderer">PangoRenderer</a> for a screen. This default renderer

346

is shared by all users of the display, so properties such as the color

347

or transformation matrix set for the renderer may be overwritten

348

by functions such as <a class="link" href="gdk2-Drawing-Primitives.html#gdk-draw-layout" title="gdk_draw_layout ()"><code class="function">gdk_draw_layout()</code></a>.

349

350

351

Before using the renderer, you need to call <a class="link" href="gdk2-Pango-Interaction.html#gdk-pango-renderer-set-drawable" title="gdk_pango_renderer_set_drawable ()"><code class="function">gdk_pango_renderer_set_drawable()</code></a>

352

and <a class="link" href="gdk2-Pango-Interaction.html#gdk-pango-renderer-set-gc" title="gdk_pango_renderer_set_gc ()"><code class="function">gdk_pango_renderer_set_gc()</code></a> to set the drawable and graphics context

353

to use for drawing.

354

355

356

357

358

<col>

359

</colgroup>

360

<tbody>

361

<tr>

362

<td><code>screen</code> :</td>

363

<td>a <a class="link" href="GdkScreen.html" title="GdkScreen">GdkScreen</a>

364

</td>

365

</tr>

366

<tr>

367

<td>Returns :</td>

368

<td>the default <a href="/usr/share/gtk-doc/html/pango/pango-pango-renderer.html#PangoRenderer">PangoRenderer</a> for <code>screen</code>. The

369

renderer is owned by GTK+ and will be kept around until the

370

screen is closed.</td>

371

</tr>

372

</tbody>

373

</table></div>

374

Since 2.6

375

</div>

376

<hr>

377

378

<a name="gdk-pango-renderer-set-drawable"></a><h3>gdk_pango_renderer_set_drawable ()</h3>

379

<pre class="programlisting">void gdk_pango_renderer_set_drawable (<code><a class="link" href="gdk2-Pango-Interaction.html#GdkPangoRenderer">GdkPangoRenderer</a> *gdk_renderer</code>,

380

<code><a class="link" href="gdk2-Drawing-Primitives.html#GdkDrawable">GdkDrawable</a> *drawable</code>);</pre>

381

382

Sets the drawable the renderer draws to.

383

384

385

386

387

<col>

388

</colgroup>

389

<tbody>

390

<tr>

391

<td><code>gdk_renderer</code> :</td>

392

<td>a <a class="link" href="gdk2-Pango-Interaction.html#GdkPangoRenderer">GdkPangoRenderer</a>

393

</td>

394

</tr>

395

<tr>

396

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

397

<td>the new target drawable, or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

398

</td>

399

</tr>

400

</tbody>

401

</table></div>

402

Since 2.6

403

</div>

404

<hr>

405

406

<a name="gdk-pango-renderer-set-gc"></a><h3>gdk_pango_renderer_set_gc ()</h3>

407

<pre class="programlisting">void gdk_pango_renderer_set_gc (<code><a class="link" href="gdk2-Pango-Interaction.html#GdkPangoRenderer">GdkPangoRenderer</a> *gdk_renderer</code>,

408

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

409

410

Sets the GC the renderer draws with. Note that the GC must not be

411

modified until it is unset by calling the function again with

412

<a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a> for the <code>gc</code> parameter, since GDK may make internal copies

413

of the GC which won't be updated to follow changes to the

414

original GC.

415

416

417

418

419

<col>

420

</colgroup>

421

<tbody>

422

<tr>

423

<td><code>gdk_renderer</code> :</td>

424

<td>a <a class="link" href="gdk2-Pango-Interaction.html#GdkPangoRenderer">GdkPangoRenderer</a>

425

</td>

426

</tr>

427

<tr>

428

429

<td>the new GC to use for drawing, or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

430

</td>

431

</tr>

432

</tbody>

433

</table></div>

434

Since 2.6

435

</div>

436

<hr>

437

438

<a name="gdk-pango-renderer-set-stipple"></a><h3>gdk_pango_renderer_set_stipple ()</h3>

439

<pre class="programlisting">void gdk_pango_renderer_set_stipple (<code><a class="link" href="gdk2-Pango-Interaction.html#GdkPangoRenderer">GdkPangoRenderer</a> *gdk_renderer</code>,

440

<code><a href="/usr/share/gtk-doc/html/pango/pango-pango-renderer.html#PangoRenderPart">PangoRenderPart</a> part</code>,

441

<code><a class="link" href="gdk2-Bitmaps-and-Pixmaps.html#GdkBitmap" title="GdkBitmap">GdkBitmap</a> *stipple</code>);</pre>

442

443

Sets the stipple for one render part (foreground, background, underline,

444

etc.) Note that this is overwritten when iterating through the individual

445

styled runs of a <a href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayout">PangoLayout</a> or <a href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayoutLine">PangoLayoutLine</a>. This function is thus

446

only useful when you call low level functions like <a href="/usr/share/gtk-doc/html/pango/pango-pango-renderer.html#pango-renderer-draw-glyphs"><code class="function">pango_renderer_draw_glyphs()</code></a>

447

directly, or in the 'prepare_run' virtual function of a subclass of

448

<a class="link" href="gdk2-Pango-Interaction.html#GdkPangoRenderer">GdkPangoRenderer</a>.

449

450

451

452

453

<col>

454

</colgroup>

455

<tbody>

456

<tr>

457

<td><code>gdk_renderer</code> :</td>

458

<td>a <a class="link" href="gdk2-Pango-Interaction.html#GdkPangoRenderer">GdkPangoRenderer</a>

459

</td>

460

</tr>

461

<tr>

462

463

<td>the part to render with the stipple</td>

464

</tr>

465

<tr>

466

<td><code>stipple</code> :</td>

467

<td>the new stipple value.</td>

468

</tr>

469

</tbody>

470

</table></div>

471

Since 2.6

472

</div>

473

<hr>

474

475

<a name="gdk-pango-renderer-set-override-color"></a><h3>gdk_pango_renderer_set_override_color ()</h3>

476

<pre class="programlisting">void gdk_pango_renderer_set_override_color

477

(<code><a class="link" href="gdk2-Pango-Interaction.html#GdkPangoRenderer">GdkPangoRenderer</a> *gdk_renderer</code>,

478

<code><a href="/usr/share/gtk-doc/html/pango/pango-pango-renderer.html#PangoRenderPart">PangoRenderPart</a> part</code>,

479

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

480

481

Sets the color for a particular render part (foreground,

482

background, underline, etc.), overriding any attributes on the layouts

483

renderered with this renderer.

484

485

486

487

488

<col>

489

</colgroup>

490

<tbody>

491

<tr>

492

<td><code>gdk_renderer</code> :</td>

493

<td>a <a class="link" href="gdk2-Pango-Interaction.html#GdkPangoRenderer">GdkPangoRenderer</a>

494

</td>

495

</tr>

496

<tr>

497

498

<td>the part to render to set the color of</td>

499

</tr>

500

<tr>

501

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

502

<td>the color to use, or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a> to unset a previously

503

set override color. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

504

</td>

505

</tr>

506

</tbody>

507

</table></div>

508

Since 2.6

509

</div>

510

<hr>

511

512

<a name="gdk-pango-context-get"></a><h3>gdk_pango_context_get ()</h3>

513

<pre class="programlisting"><a href="/usr/share/gtk-doc/html/pango/pango-Text-Processing.html#PangoContext">PangoContext</a> * gdk_pango_context_get (<code>void</code>);</pre>

514

515

Creates a <a href="/usr/share/gtk-doc/html/pango/pango-Text-Processing.html#PangoContext">PangoContext</a> for the default GDK screen.

516

517

518

The context must be freed when you're finished with it.

519

520

521

When using GTK+, normally you should use <a href="http://developer.gnome.org/gtk2/GtkWidget.html#gtk-widget-get-pango-context"><code class="function">gtk_widget_get_pango_context()</code></a>

522

instead of this function, to get the appropriate context for

523

the widget you intend to render text onto.

524

525

526

The newly created context will have the default font options (see

527

<a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-font-options-t.html#cairo-font-options-t">cairo_font_options_t</a>) for the default screen; if these options

528

change it will not be updated. Using <a href="http://developer.gnome.org/gtk2/GtkWidget.html#gtk-widget-get-pango-context"><code class="function">gtk_widget_get_pango_context()</code></a>

529

is more convenient if you want to keep a context around and track

530

changes to the screen's font rendering settings.

531

532

533

534

535

<col>

536

</colgroup>

537

538

<td>Returns :</td>

539

<td>a new <a href="/usr/share/gtk-doc/html/pango/pango-Text-Processing.html#PangoContext">PangoContext</a> for the default display</td>

540

</tr></tbody>

541

</table></div>

542

</div>

543

<hr>

544

545

<a name="gdk-pango-context-get-for-screen"></a><h3>gdk_pango_context_get_for_screen ()</h3>

546

<pre class="programlisting"><a href="/usr/share/gtk-doc/html/pango/pango-Text-Processing.html#PangoContext">PangoContext</a> * gdk_pango_context_get_for_screen (<code><a class="link" href="GdkScreen.html" title="GdkScreen">GdkScreen</a> *screen</code>);</pre>

547

548

Creates a <a href="/usr/share/gtk-doc/html/pango/pango-Text-Processing.html#PangoContext">PangoContext</a> for <code>screen</code>.

549

550

551

The context must be freed when you're finished with it.

552

553

554

When using GTK+, normally you should use <a href="http://developer.gnome.org/gtk2/GtkWidget.html#gtk-widget-get-pango-context"><code class="function">gtk_widget_get_pango_context()</code></a>

555

instead of this function, to get the appropriate context for

556

the widget you intend to render text onto.

557

558

559

The newly created context will have the default font options

560

(see <a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-font-options-t.html#cairo-font-options-t">cairo_font_options_t</a>) for the screen; if these options

561

change it will not be updated. Using <a href="http://developer.gnome.org/gtk2/GtkWidget.html#gtk-widget-get-pango-context"><code class="function">gtk_widget_get_pango_context()</code></a>

562

is more convenient if you want to keep a context around and track

563

changes to the screen's font rendering settings.

564

565

566

567

568

<col>

569

</colgroup>

570

<tbody>

571

<tr>

572

<td><code>screen</code> :</td>

573

<td>the <a class="link" href="GdkScreen.html" title="GdkScreen">GdkScreen</a> for which the context is to be created.</td>

574

</tr>

575

<tr>

576

<td>Returns :</td>

577

<td>a new <a href="/usr/share/gtk-doc/html/pango/pango-Text-Processing.html#PangoContext">PangoContext</a> for <code>screen</code>

578

</td>

579

</tr>

580

</tbody>

581

</table></div>

582

Since 2.2

583

</div>

584

<hr>

585

586

<a name="gdk-pango-context-set-colormap"></a><h3>gdk_pango_context_set_colormap ()</h3>

587

<pre class="programlisting">void gdk_pango_context_set_colormap (<code><a href="/usr/share/gtk-doc/html/pango/pango-Text-Processing.html#PangoContext">PangoContext</a> *context</code>,

588

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

589

590

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

591

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

592

</div>

593

594

This function used to set the colormap to be used for drawing with

595

<code>context</code>. The colormap is now always derived from the graphics

596

context used for drawing, so calling this function is no longer

597

necessary.

598

599

600

601

602

<col>

603

</colgroup>

604

<tbody>

605

<tr>

606

<td><code>context</code> :</td>

607

<td>a <a href="/usr/share/gtk-doc/html/pango/pango-Text-Processing.html#PangoContext">PangoContext</a>

608

</td>

609

</tr>

610

<tr>

611

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

612

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

613

</td>

614

</tr>

615

</tbody>

616

</table></div>

617

</div>

618

<hr>

619

620

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

621

<pre class="programlisting">struct GdkPangoAttrEmbossed {

622

PangoAttribute attr;

623

gboolean embossed;

624

};

625

</pre>

626

627

A Pango text attribute containing a embossed bitmap to be used when

628

rendering the text.

629

630

631

632

633

<col>

634

</colgroup>

635

<tbody>

636

<tr>

637

<td><a href="/usr/share/gtk-doc/html/pango/pango-Text-Attributes.html#PangoAttribute">PangoAttribute</a> <code><a name="GdkPangoAttrEmbossed.attr"></a>attr</code>;</td>

638

<td>the <a href="/usr/share/gtk-doc/html/pango/pango-Text-Attributes.html#PangoAttribute">PangoAttribute</a>.</td>

639

</tr>

640

<tr>

641

<td>gboolean <code><a name="GdkPangoAttrEmbossed.embossed"></a>embossed</code>;</td>

642

<td>the embossed bitmap.</td>

643

</tr>

644

</tbody>

645

</table></div>

646

</div>

647

<hr>

648

649

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

650

<pre class="programlisting">struct GdkPangoAttrEmbossColor {

651

PangoAttribute attr;

652

PangoColor color;

653

};

654

</pre>

655

656

A Pango text attribute specifying the color to emboss text with.

657

658

659

660

661

<col>

662

</colgroup>

663

<tbody>

664

<tr>

665

666

<td>the <a href="/usr/share/gtk-doc/html/pango/pango-Text-Attributes.html#PangoAttribute">PangoAttribute</a>

667

</td>

668

</tr>

669

<tr>

670

<td><a href="/usr/share/gtk-doc/html/pango/pango-Text-Attributes.html#PangoColor">PangoColor</a> <code><a name="GdkPangoAttrEmbossColor.color"></a>color</code>;</td>

671

<td>the color</td>

672

</tr>

673

</tbody>

674

</table></div>

675

</div>

676

<hr>

677

678

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

679

<pre class="programlisting">struct GdkPangoAttrStipple {

680

PangoAttribute attr;

681

GdkBitmap *stipple;

682

};

683

</pre>

684

685

A Pango text attribute containing a stipple bitmap to be used when

686

rendering the text.

687

688

689

690

691

<col>

692

</colgroup>

693

<tbody>

694

<tr>

695

<td><a href="/usr/share/gtk-doc/html/pango/pango-Text-Attributes.html#PangoAttribute">PangoAttribute</a> <code><a name="GdkPangoAttrStipple.attr"></a>attr</code>;</td>

696

<td>the <a href="/usr/share/gtk-doc/html/pango/pango-Text-Attributes.html#PangoAttribute">PangoAttribute</a>.</td>

697

</tr>

698

<tr>

699

<td><a class="link" href="gdk2-Bitmaps-and-Pixmaps.html#GdkBitmap" title="GdkBitmap">GdkBitmap</a> *<code><a name="GdkPangoAttrStipple.stipple"></a>stipple</code>;</td>

700

<td>the stipple bitmap.</td>

701

</tr>

702

</tbody>

703

</table></div>

704

</div>

705

<hr>

706

707

<a name="gdk-pango-attr-emboss-color-new"></a><h3>gdk_pango_attr_emboss_color_new ()</h3>

708

<pre class="programlisting"><a href="/usr/share/gtk-doc/html/pango/pango-Text-Attributes.html#PangoAttribute">PangoAttribute</a> * gdk_pango_attr_emboss_color_new (<code>const <a class="link" href="gdk2-Colormaps-and-Colors.html#GdkColor" title="GdkColor">GdkColor</a> *color</code>);</pre>

709

710

Creates a new attribute specifying the color to emboss text with.

711

712

713

714

715

<col>

716

</colgroup>

717

<tbody>

718

<tr>

719

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

720

<td>a GdkColor representing the color to emboss with</td>

721

</tr>

722

<tr>

723

<td>Returns :</td>

724

<td>new <a href="/usr/share/gtk-doc/html/pango/pango-Text-Attributes.html#PangoAttribute">PangoAttribute</a>

725

</td>

726

</tr>

727

</tbody>

728

</table></div>

729

Since 2.12

730

</div>

731

<hr>

732

733

<a name="gdk-pango-attr-embossed-new"></a><h3>gdk_pango_attr_embossed_new ()</h3>

734

<pre class="programlisting"><a href="/usr/share/gtk-doc/html/pango/pango-Text-Attributes.html#PangoAttribute">PangoAttribute</a> * gdk_pango_attr_embossed_new (<code>gboolean embossed</code>);</pre>

735

736

Creates a new attribute flagging a region as embossed or not.

737

738

739

740

741

<col>

742

</colgroup>

743

<tbody>

744

<tr>

745

<td><code>embossed</code> :</td>

746

<td>if the region should be embossed</td>

747

</tr>

748

<tr>

749

<td>Returns :</td>

750

<td>new <a href="/usr/share/gtk-doc/html/pango/pango-Text-Attributes.html#PangoAttribute">PangoAttribute</a>

751

</td>

752

</tr>

753

</tbody>

754

</table></div>

755

</div>

756

<hr>

757

758

<a name="gdk-pango-attr-stipple-new"></a><h3>gdk_pango_attr_stipple_new ()</h3>

759

<pre class="programlisting"><a href="/usr/share/gtk-doc/html/pango/pango-Text-Attributes.html#PangoAttribute">PangoAttribute</a> * gdk_pango_attr_stipple_new (<code><a class="link" href="gdk2-Bitmaps-and-Pixmaps.html#GdkBitmap" title="GdkBitmap">GdkBitmap</a> *stipple</code>);</pre>

760

761

Creates a new attribute containing a stipple bitmap to be used when

762

rendering the text.

763

764

765

766

767

<col>

768

</colgroup>

769

<tbody>

770

<tr>

771

<td><code>stipple</code> :</td>

772

<td>a bitmap to be set as stipple</td>

773

</tr>

774

<tr>

775

<td>Returns :</td>

776

<td>new <a href="/usr/share/gtk-doc/html/pango/pango-Text-Attributes.html#PangoAttribute">PangoAttribute</a>

777

</td>

778

</tr>

779

</tbody>

780

</table></div>

781

</div>

782

<hr>

783

784

<a name="gdk-pango-layout-get-clip-region"></a><h3>gdk_pango_layout_get_clip_region ()</h3>

785

<pre class="programlisting"><a class="link" href="gdk2-Points-Rectangles-and-Regions.html#GdkRegion" title="GdkRegion">GdkRegion</a> * gdk_pango_layout_get_clip_region (<code><a href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayout">PangoLayout</a> *layout</code>,

786

<code>gint x_origin</code>,

787

<code>gint y_origin</code>,

788

<code>const gint *index_ranges</code>,

789

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

790

791

Obtains a clip region which contains the areas where the given ranges

792

of text would be drawn. <code>x_origin</code> and <code>y_origin</code> are the same position

793

you would pass to <a class="link" href="gdk2-Drawing-Primitives.html#gdk-draw-layout-line" title="gdk_draw_layout_line ()"><code class="function">gdk_draw_layout_line()</code></a>. <code>index_ranges</code> should contain

794

ranges of bytes in the layout's text.

795

796

797

Note that the regions returned correspond to logical extents of the text

798

ranges, not ink extents. So the drawn layout may in fact touch areas out of

799

the clip region. The clip region is mainly useful for highlightling parts

800

of text, such as when text is selected.

801

802

803

804

805

<col>

806

</colgroup>

807

<tbody>

808

<tr>

809

<td><code>layout</code> :</td>

810

<td>a <a href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayout">PangoLayout</a>

811

</td>

812

</tr>

813

<tr>

814

<td><code>x_origin</code> :</td>

815

<td>X pixel where you intend to draw the layout with this clip</td>

816

</tr>

817

<tr>

818

<td><code>y_origin</code> :</td>

819

<td>Y pixel where you intend to draw the layout with this clip</td>

820

</tr>

821

<tr>

822

<td><code>index_ranges</code> :</td>

823

<td>array of byte indexes into the layout, where even members of array are start indexes and odd elements are end indexes</td>

824

</tr>

825

<tr>

826

<td><code>n_ranges</code> :</td>

827

<td>number of ranges in <code>index_ranges</code>, i.e. half the size of <code>index_ranges</code>

828

</td>

829

</tr>

830

<tr>

831

<td>Returns :</td>

832

<td>a clip region containing the given ranges</td>

833

</tr>

834

</tbody>

835

</table></div>

836

</div>

837

<hr>

838

839

<a name="gdk-pango-layout-line-get-clip-region"></a><h3>gdk_pango_layout_line_get_clip_region ()</h3>

840

841

(<code><a href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayoutLine">PangoLayoutLine</a> *line</code>,

842

<code>gint x_origin</code>,

843

<code>gint y_origin</code>,

844

<code>const gint *index_ranges</code>,

845

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

846

847

Obtains a clip region which contains the areas where the given

848

ranges of text would be drawn. <code>x_origin</code> and <code>y_origin</code> are the same

849

position you would pass to <a class="link" href="gdk2-Drawing-Primitives.html#gdk-draw-layout-line" title="gdk_draw_layout_line ()"><code class="function">gdk_draw_layout_line()</code></a>. <code>index_ranges</code>

850

should contain ranges of bytes in the layout's text. The clip

851

region will include space to the left or right of the line (to the

852

layout bounding box) if you have indexes above or below the indexes

853

contained inside the line. This is to draw the selection all the way

854

to the side of the layout. However, the clip region is in line coordinates,

855

not layout coordinates.

856

857

858

Note that the regions returned correspond to logical extents of the text

859

ranges, not ink extents. So the drawn line may in fact touch areas out of

860

the clip region. The clip region is mainly useful for highlightling parts

861

of text, such as when text is selected.

862

863

864

865

866

<col>

867

</colgroup>

868

<tbody>

869

<tr>

870

871

<td>a <a href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayoutLine">PangoLayoutLine</a>

872

</td>

873

</tr>

874

<tr>

875

<td><code>x_origin</code> :</td>

876

<td>X pixel where you intend to draw the layout line with this clip</td>

877

</tr>

878

<tr>

879

<td><code>y_origin</code> :</td>

880

<td>baseline pixel where you intend to draw the layout line with this clip</td>

881

</tr>

882

<tr>

883

<td><code>index_ranges</code> :</td>

884

<td>array of byte indexes into the layout, where even members of array are start indexes and odd elements are end indexes</td>

885

</tr>

886

<tr>

887

<td><code>n_ranges</code> :</td>

888

<td>number of ranges in <code>index_ranges</code>, i.e. half the size of <code>index_ranges</code>

889

</td>

890

</tr>

891

<tr>

892

<td>Returns :</td>

893

<td>a clip region containing the given ranges</td>

894

</tr>

895

</tbody>

896

</table></div>

897

</div>

898

</div>

899

900

<a name="gdk2-Pango-Interaction.property-details"></a><h2>Property Details</h2>

901

902

<a name="GdkPangoRenderer--screen"></a><h3>The <code class="literal">"screen"</code> property</h3>

903

<pre class="programlisting"> "screen" <a class="link" href="GdkScreen.html" title="GdkScreen">GdkScreen</a>* : Read / Write / Construct Only</pre>

904

the GdkScreen for the renderer.

905

</div>

906

</div>

907

</div>

908

909

<hr>

910

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

911

</body>

912

</html>

b'\\ No newline at end of file'

Older »