← Back to branch summary

~canonical-dx-team/ubuntu/maverick/gtk+2.0/menuproxy

« back to all changes in this revision

Viewing changes to docs/reference/gdk/tmpl/regions.sgml

  • Committer: Bazaar Package Importer
  • Author(s): Sebastien Bacher
  • Date: 2007-05-04 12:24:25 UTC
  • mfrom: (1.1.21 upstream)
  • Revision ID: james.westby@ubuntu.com-20070504122425-0m8midgzrp40y8w2
Tags: 2.10.12-1ubuntu1
* Sync with Debian
* New upstream version:
  Fixed bugs:
  - 379414 file chooser warnings when changing path in the entry
  - 418585 GtkFileChooserDefault sizing code is not DPI independent
  - 419568 Crash in search if start with special letter
  - 435062 build dies with icon cache validation
  - 379399 Segfault to call gtk_print_operation_run twice.
  - 387889 cups backend has problems when there are too many printers
  - 418531 invalid read to gtkicontheme.c gtk_icon_theme_lookup_icon...
  - 423916 crash in color scheme code
  - 424042 Segmentation fault while quickly pressing Alt+arrows
  - 415260 Protect against negative indices when setting values in G...
  - 419171 XGetVisualInfo() may not set nxvisuals
  - 128852 Gdk cursors don't look good on win32
  - 344657 Ctrl-H doesn't toggle "Show Hidden Files" setting
  - 345345 PrintOperation::paginate is not emitted for class handler
  - 347567 GtkPrintOperation::end-print is not emitted if it's cance...
  - 369112 gtk_ui_manager_add_ui should accept unnamed separator
  - 392015 Selected menu item invisible on Windows Vista
  - 399253 MS-Windows Theme Bottom Tab placement rendering glitches
  - 399425 gtk_input_dialog_fill_axes() adds child to gtkscrolledwin...
  - 403251 [patch] little memory leak in GtkPrintJob
  - 403267 [patch] memory leak in GtkPageSetupUnixDialog
  - 403470 MS-Windows Theme tab placement other than on top leaks a ...
  - 404506 Windows system fonts that have multi-byte font names cann...
  - 405089 Incorrect window placement for GtkEventBox private window
  - 405515 Minor leak in gtkfilesystemmodel.c
  - 405539 gdk_pixbuf_save() for PNG saver can return FALSE without ...
  - 415681 gdk_window_clear_area includes an extra line and column o...
  - 418219 GtkRecentChooser should apply filter before sorting and c...
  - 418403 Scroll to printer after selecting it from settings
  - 421985 _gtk_print_operation_platform_backend_launch_preview
  - 421990 gtk_print_job_get_surface
  - 421993 gtk_print_operation_init
  - 423064 Conditional jump or move depends on uninitialised value(s...
  - 423722 Fix printing header in gtk-demo
  - 424168 gtk_print_operation_run on async preview
  - 425655 Don't install gtk+-unix-print-2.0.pc on non-UNIX platforms
  - 425786 GDK segfaults if XineramaQueryScreens fails
  - 428665 Lpr Backend gets stuck in infinite loop during gtk_enumer...
  - 429902 GtkPrintOperation leaks cairo contextes
  - 431997 First delay of GdkPixbufAnimationIter is wrong
  - 433242 Inconsistent scroll arrow position calculations
  - 433972 Placing gtk.Expander inside a gtk.TextView() changes gtk....
  - 434261 _gtk_toolbar_elide_underscores incorrectly handles some s...
  - 383354 ctrl-L should make 'Location' entry disappear
  - 418673 gtk_recent_manager_add_item
  - 429732 gtk_accel_group_finalize accesses invalid memory
  - 435028 WM_CLIENT_LEADER is wrong on the leader_window
  - 431067 Background of the header window is not updated
  - 338843 add recent files support inside the ui manager
  - 148535 add drop shadow to menus, tooltips, etc. under Windows XP
* debian/control.in:
  - Conflicts on ubuntulooks (<= 0.9.11-1)
* debian/patches/15_default-fallback-icon-theme.patch:
  - patch from Debian, fallback on gnome icon theme

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/gdk/tmpl/regions.sgml
 
1
<!-- ##### SECTION Title ##### -->
 
2
Points, Rectangles and Regions
 
3
 
 
4
<!-- ##### SECTION Short_Description ##### -->
 
5
Simple graphical data types
 
6
 
 
7
<!-- ##### SECTION Long_Description ##### -->
 
8
<para>
 
9
GDK provides the #GdkPoint, #GdkRectangle, #GdkRegion and #GdkSpan data types
 
10
for representing pixels and sets of pixels on the screen.
 
11
</para>
 
12
<para>
 
13
#GdkPoint is a simple structure containing an x and y coordinate of a point.
 
14
</para>
 
15
<para>
 
16
#GdkRectangle is a structure holding the position and size of a rectangle.
 
17
The intersection of two rectangles can be computed with
 
18
gdk_rectangle_intersect(). To find the union of two rectangles use
 
19
gdk_rectangle_union().
 
20
</para>
 
21
<para>
 
22
#GdkRegion is an opaque data type holding a set of arbitrary pixels, and is
 
23
usually used for clipping graphical operations (see gdk_gc_set_clip_region()).
 
24
</para>
 
25
<para>
 
26
#GdkSpan is a structure holding a spanline. A spanline is a horizontal line that
 
27
is one pixel wide. It is mainly used when rasterizing other graphics primitives.
 
28
It can be intersected to regions by using gdk_region_spans_intersect_foreach().
 
29
</para>
 
30
 
 
31
<!-- ##### SECTION See_Also ##### -->
 
32
<para>
 
33
 
 
34
</para>
 
35
 
 
36
<!-- ##### SECTION Stability_Level ##### -->
 
37
 
 
38
 
 
39
<!-- ##### STRUCT GdkPoint ##### -->
 
40
<para>
 
41
Defines the x and y coordinates of a point.
 
42
</para>
 
43
 
 
44
@x: the x coordinate of the point.
 
45
@y: the y coordinate of the point.
 
46
 
 
47
<!-- ##### STRUCT GdkRectangle ##### -->
 
48
<para>
 
49
Defines the position and size of a rectangle.
 
50
</para>
 
51
 
 
52
@x: the x coordinate of the left edge of the rectangle.
 
53
@y: the y coordinate of the top of the rectangle.
 
54
@width: the width of the rectangle.
 
55
@height: the height of the rectangle.
 
56
 
 
57
<!-- ##### FUNCTION gdk_rectangle_intersect ##### -->
 
58
<para>
 
59
 
 
60
</para>
 
61
 
 
62
@src1: 
 
63
@src2: 
 
64
@dest: 
 
65
@Returns: 
 
66
 
 
67
 
 
68
<!-- ##### FUNCTION gdk_rectangle_union ##### -->
 
69
<para>
 
70
 
 
71
</para>
 
72
 
 
73
@src1: 
 
74
@src2: 
 
75
@dest: 
 
76
 
 
77
 
 
78
<!-- ##### STRUCT GdkRegion ##### -->
 
79
<para>
 
80
A GdkRegion represents a set of pixels on the screen.
 
81
</para>
 
82
 
 
83
 
 
84
<!-- ##### FUNCTION gdk_region_new ##### -->
 
85
<para>
 
86
 
 
87
</para>
 
88
 
 
89
@Returns: 
 
90
 
 
91
 
 
92
<!-- ##### FUNCTION gdk_region_polygon ##### -->
 
93
<para>
 
94
 
 
95
</para>
 
96
 
 
97
@points: 
 
98
@npoints: 
 
99
@fill_rule: 
 
100
@Returns: 
 
101
 
 
102
 
 
103
<!-- ##### ENUM GdkFillRule ##### -->
 
104
<para>
 
105
The method for determining which pixels are included in a region, when
 
106
creating a #GdkRegion from a polygon.
 
107
The fill rule is only relevant for polygons which overlap themselves.
 
108
</para>
 
109
 
 
110
@GDK_EVEN_ODD_RULE: areas which are overlapped an odd number of times are
 
111
included in the region, while areas overlapped an even number of times are not.
 
112
@GDK_WINDING_RULE: overlapping areas are always included.
 
113
 
 
114
<!-- ##### FUNCTION gdk_region_copy ##### -->
 
115
<para>
 
116
 
 
117
</para>
 
118
 
 
119
@region: 
 
120
@Returns: 
 
121
 
 
122
 
 
123
<!-- ##### FUNCTION gdk_region_rectangle ##### -->
 
124
<para>
 
125
 
 
126
</para>
 
127
 
 
128
@rectangle: 
 
129
@Returns: 
 
130
 
 
131
 
 
132
<!-- ##### FUNCTION gdk_region_destroy ##### -->
 
133
<para>
 
134
 
 
135
</para>
 
136
 
 
137
@region: 
 
138
 
 
139
 
 
140
<!-- ##### FUNCTION gdk_region_get_clipbox ##### -->
 
141
<para>
 
142
 
 
143
</para>
 
144
 
 
145
@region: 
 
146
@rectangle: 
 
147
 
 
148
 
 
149
<!-- ##### FUNCTION gdk_region_get_rectangles ##### -->
 
150
<para>
 
151
 
 
152
</para>
 
153
 
 
154
@region: 
 
155
@rectangles: 
 
156
@n_rectangles: 
 
157
 
 
158
 
 
159
<!-- ##### FUNCTION gdk_region_empty ##### -->
 
160
<para>
 
161
 
 
162
</para>
 
163
 
 
164
@region: 
 
165
@Returns: 
 
166
 
 
167
 
 
168
<!-- ##### FUNCTION gdk_region_equal ##### -->
 
169
<para>
 
170
 
 
171
</para>
 
172
 
 
173
@region1: 
 
174
@region2: 
 
175
@Returns: 
 
176
 
 
177
 
 
178
<!-- ##### FUNCTION gdk_region_point_in ##### -->
 
179
<para>
 
180
 
 
181
</para>
 
182
 
 
183
@region: 
 
184
@x: 
 
185
@y: 
 
186
@Returns: 
 
187
 
 
188
 
 
189
<!-- ##### FUNCTION gdk_region_rect_in ##### -->
 
190
<para>
 
191
 
 
192
</para>
 
193
 
 
194
@region: 
 
195
@rectangle: 
 
196
@Returns: 
 
197
 
 
198
 
 
199
<!-- ##### ENUM GdkOverlapType ##### -->
 
200
<para>
 
201
Specifies the possible values returned by gdk_region_rect_in().
 
202
</para>
 
203
 
 
204
@GDK_OVERLAP_RECTANGLE_IN: if the rectangle is inside the #GdkRegion.
 
205
@GDK_OVERLAP_RECTANGLE_OUT: if the rectangle is outside the #GdkRegion.
 
206
@GDK_OVERLAP_RECTANGLE_PART: if the rectangle is partly inside the #GdkRegion.
 
207
 
 
208
<!-- ##### FUNCTION gdk_region_offset ##### -->
 
209
<para>
 
210
 
 
211
</para>
 
212
 
 
213
@region: 
 
214
@dx: 
 
215
@dy: 
 
216
 
 
217
 
 
218
<!-- ##### FUNCTION gdk_region_shrink ##### -->
 
219
<para>
 
220
 
 
221
</para>
 
222
 
 
223
@region: 
 
224
@dx: 
 
225
@dy: 
 
226
 
 
227
 
 
228
<!-- ##### FUNCTION gdk_region_union_with_rect ##### -->
 
229
<para>
 
230
 
 
231
</para>
 
232
 
 
233
@region: 
 
234
@rect: 
 
235
 
 
236
 
 
237
<!-- ##### FUNCTION gdk_region_intersect ##### -->
 
238
<para>
 
239
</para>
 
240
 
 
241
@source1: 
 
242
@source2: 
 
243
 
 
244
 
 
245
<!-- ##### FUNCTION gdk_region_union ##### -->
 
246
<para>
 
247
 
 
248
</para>
 
249
 
 
250
@source1: 
 
251
@source2: 
 
252
 
 
253
 
 
254
<!-- ##### FUNCTION gdk_region_subtract ##### -->
 
255
<para>
 
256
</para>
 
257
 
 
258
@source1: 
 
259
@source2: 
 
260
 
 
261
 
 
262
<!-- ##### FUNCTION gdk_region_xor ##### -->
 
263
<para>
 
264
</para>
 
265
 
 
266
@source1: 
 
267
@source2: 
 
268
 
 
269
 
 
270
<!-- ##### STRUCT GdkSpan ##### -->
 
271
<para>
 
272
A GdkSpan represents a horizontal line of pixels starting
 
273
at the pixel with coordinates @x, @y and ending before @x + @width, @y.
 
274
</para>
 
275
 
 
276
@x: x coordinate of the first pixel.
 
277
@y: y coordinate of the first pixel.
 
278
@width: number of pixels in the span.
 
279
 
 
280
<!-- ##### USER_FUNCTION GdkSpanFunc ##### -->
 
281
<para>
 
282
This defines the type of the function passed to 
 
283
gdk_region_spans_intersect_foreach(). 
 
284
</para>
 
285
 
 
286
@span: a #GdkSpan.
 
287
@data: the user data passed to gdk_region_spans_intersect_foreach().
 
288
 
 
289
 
 
290
<!-- ##### FUNCTION gdk_region_spans_intersect_foreach ##### -->
 
291
<para>
 
292
 
 
293
</para>
 
294
 
 
295
@region: 
 
296
@spans: 
 
297
@n_spans: 
 
298
@sorted: 
 
299
@function: 
 
300
@data: 
 
301
 
 
302