summaryrefslogtreecommitdiff
path: root/NEWS
blob: daf1ca7969b270efce5120501ed7a992b0d152cc (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
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
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
Overview of changes from pycairo 1.8.8 to pycairo 1.8.10
========================================================
General Changes:
    Pycairo 1.8.10 requires cairo 1.8.10 (or later).

New Classes/Types:
    Win32PrintingSurface
    XCBSurface - add XCB support using xpyb

Bug Fixes:
    Fix for libtool 2.2 (#27974).
    Mingw32 and pypy fixes (#25203).

Other Changes:
    Tests updated.

The Win32PrintingSurface and XCBSurface changes mean that pycairo 1.8.10 is
not binary compatible with pycairo 1.8.8. So modules that use the pycairo C
API (like pygtk) will need to be recompiled to use pycairo 1.8.10.


Overview of changes from pycairo 1.8.6 to pycairo 1.8.8
=======================================================
General Changes:
    Pycairo 1.8.8 requires cairo 1.8.8 (or later).
    Move from CVS to git.
    Add support for the waf build tool.

Updated Methods:
    The PDF/PS/SVGSurface constructors now accept None as a filename.


Overview of changes from pycairo 1.8.4 to pycairo 1.8.6
=======================================================
General Changes:
    Pycairo 1.8.6 requires cairo 1.8.6 (or later)

Bug Fixes:
    ImageSurface.create_from_png _read_func fix
    ToyFontFace type fix
    19221: restore cairo.Matrix '*' operator to the way it originally worked.

Other Changes:
    Documentation completed.


Overview of changes from pycairo 1.8.2 to pycairo 1.8.4
=======================================================
General Changes:
    Pycairo 1.8.4 requires cairo 1.8.4 (or later) and Python 2.6

Bug Fixes:
    20674: Add get/set_extend for Gradient Patterns

New Classes:
    cairo.ToyFontFace

New Methods:
    Pattern.get_extend
    Pattern.set_extend
    ToyFontFace.get_family
    ToyFontFace.get_slant
    ToyFontFace.get_weight

Deleted Methods:
    SurfacePattern.get_extend
    SurfacePattern.set_extend

Other Changes:
    Threading for surfaces with stream functions has been reenabled.
    Documentation updates.


Overview of changes from pycairo 1.8.0 to pycairo 1.8.2
=======================================================

Pycairo 1.8.0 resulted in crashes for some applications using threads. So
upgrading to 1.8.2 is recommended for threaded applications.

Bug Fixes: #19287: Threading support results in crashes in cairo.ImageSurface

New Methods:
    Context.set_scaled_font

API Changes:
    Matrix multiplication:
    old code: matrix3 = matrix1 * matrix2
    new equivalent code: matrix3 = matrix1.multiply(matrix2)
    matrix3 = matrix1 * matrix2
    is now equivalent to matrix3 = matrix2.multiply(matrix1)
    which is consistent with standard matrix multiplication.


Overview of changes from pycairo 1.6.4 to pycairo 1.8.0
=======================================================
General Changes:
    Pycairo 1.8.0 requires cairo 1.8.0 (or later).
    Add documentation (available separately)

Bug Fixes:
    18101: Add support for threading
    18947: cairo.SurfacePattern should INCREF the used surface

New Methods:
    ScaledFont.get_scale_matrix
    Surface.mark_dirty_rectangle
    Surface.set_fallback_resolution

New Constants:
    cairo.EXTEND_PAD
    cairo.HAS_IMAGE_SURFACE
    cairo.HAS_USER_FONT

API Changes:
    Surface.mark_dirty: no longer accepts keyword arguments with default
    values.
    PycairoPattern_FromPattern (C API): has a new 'base' argument - to fix
    #18947.

Other Changes:
    Allow unknown cairo Pattern/Surface types to use the pycairo base
    Pattern/Surface type.


Overview of changes from pycairo 1.4.12 to pycairo 1.6.4
========================================================
General changes:
    Pycairo 1.6.4 requires cairo 1.6.4 (or later).
                  requires Python 2.5 (or later).

Bug fixes:
    16112: Fix win32 'python setup.py ...' build -- use double quotes

New Methods:
    Context.has_current_point
    Context.path_extents
    ImageSurface.format_stride_for_width
    PSSurface.get_eps
    PSSurface.set_eps
    PSSurface.ps_level_to_string
    PSSurface.restrict_to_level
    Surface.copy_page
    Surface.show_page

New Constants:
    cairo.PS_LEVEL_2, cairo.PS_LEVEL_3

Other changes:
    test/pygame-test1.py, test/pygame-test2.py : pygame tests

    examples/cairo_snippets/snippets/ellipse.py : Update
    so line-width is a constant width in device-space not user-space


Overview of changes from pycairo 1.4.0 to pycairo 1.4.12
========================================================
General changes:
    Pycairo 1.4.12 requires cairo 1.4.12 (or later).
                   requires Python 2.4 (or later).

Bug fixes:
    10006: update autogen.sh to support automake >= 1.10
    13460: use python-config to get python includes

Other changes:
    - allow cairo.Context to be subclassed
    - create a 'doc' subdirectory and start a FAQ file


Overview of changes from pycairo 1.2.6 to pycairo 1.4.0
=======================================================
General changes:
Pycairo 1.4.0 requires cairo 1.4.0 (or later).

New methods:
    Context.clip_extents
    Context.copy_clip_rectangles
    Context.get_dash
    Context.get_dash_count
    Context.get_scaled_font
    Context.glyph_extents
    Context.glyph_path
    Context.show_glyphs
    LinearGradient.get_linear_points
    RadialGradient.get_radial_circles
    SolidPattern.get_rgba
    SurfacePattern.get_surface

Deleted methods:
    ImageSurface.create_for_array
    Remove Numeric Python support, since Numeric has been made obsolete by
    numpy, and numpy data can be read using ImageSurface.create_for_data.

Other changes:
    the module cairo.gtk has been removed (pygtk 2.7.0 onwards has cairo
    support built in).


Overview of changes from pycairo 1.2.2 to pycairo 1.2.6
=======================================================

* Pycairo 1.2.6 requires cairo 1.2.6 (or later).

* mingw32 compiler fixes (Cedric Gustin)

* setup.py improvements  (Cedric Gustin)

* ImageSurface.get_data() new method added
  ImageSurface.get_data_as_rgba() method removed


Overview of changes from pycairo 1.2.0 to pycairo 1.2.2
=======================================================

* Pycairo requires cairo 1.2.2 (or later).

* setup.py has been updated to allow installation by executing
  $ python setup.py install

* examples/cairo_snippets/snippets/gradient_mask.py
  A new example to demonstrate pattern masks.

* The cairo.svg module has been removed because:
  1) Cairo does not include SVG parsing, so this module does not belong
     in pycairo.
  2) libsvg-cairo (the underlying C library) is unmaintained.


Overview of changes from pycairo 1.1.6 to pycairo 1.2.0
=======================================================
General changes:
Pycairo has been updated to work with cairo 1.2.0.

New methods:
    Surface.set_fallback_resolution
    Surface_get_content
    ImageSurface_get_format
    Image_surface_get_stride

Deleted methods:
    PDFSurface.set_dpi, PSSurface.set_dpi, SVGSurface.set_dpi
     - replaced by Surface.set_fallback_resolution

Other changes:
    cairo.FORMAT_RGB16_565 added


Overview of changes from pycairo 1.0.2 to pycairo 1.1.6
=======================================================
General changes:
Pycairo has been updated to work with cairo 1.1.6.

New objects:
    SVGSurface

New methods:
    Context.get_group_target
    Context.new_sub_path
    Context.pop_group
    Context.pop_group_to_source
    Context.push_group
    Context.push_group_with_content
    FontOptions.get_antialias
    FontOptions.get_hint_metrics
    FontOptions.get_hint_style
    FontOptions.get_subpixel_order
    FontOptions.set_antialias
    FontOptions.set_hint_metrics
    FontOptions.set_hint_style
    FontOptions.set_subpixel_order
    PDFSurface.set_size
    PSSurface.dsc_begin_page_setup
    PSSurface.dsc_begin_setup
    PSSurface.dsc_comment
    PSSurface.set_size
    ScaledFont.get_font_face
    ScaledFont.text_extents
    Surface.get_device_offset
    XlibSurface.get_depth

Updated methods:
    PDFSurface()/PSSurface() - can now write to file-like objects (like
    StringIO).

    surface.write_to_png() and ImageSurface.create_from_png() can now write to
    file-like objects (like StringIO).

    select_font_face, show_text, text_extents and text_path now accept unicode
    objects.

Other changes:
    misc bug fixes.

New examples:
    examples/cairo_snippets/snippets_svg.py
    examples/cairo_snippets/snippets/ellipse.py
    examples/cairo_snippets/snippets/group.py
    examples/svg/svgconvert.py


Overview of changes from pycairo 1.0.0 to pycairo 1.0.2
=======================================================
General changes:
Pycairo has been updated to work with cairo 1.0.2.

New cairo functions supported:
    cairo.ImageSurface.create_for_data()

Updated functions:
    ctx.set_source_rgba (r, g, b, a=1.0) now supports a default alpha argument

Other changes:
    cairo.Matrix now supports the Python sequence protocol, so you can do:
    xx, yx, xy, yy, x0, y0 = matrix


Overview of changes from pycairo 0.9.0 to pycairo 1.0.0
=======================================================
General changes:
Pycairo has been updated to work with cairo 1.0.0.

New cairo functions supported:
    cairo.cairo_version()
    cairo.cairo_version_string()
    PSSurface.set_dpi()

Patterns are now implemented in a class hierarchy, the new constructors are:
    cairo.SolidPattern (r, g, b, a=1.0)
    cairo.SurfacePattern (surface)
    cairo.LinearGradient (x0, y0, x1, y1)
    cairo.RadialGradient (cx0, cy0, radius0, cx1, cy1, radius1)

Updated functions:
    Surface.write_to_png() now accepts a file object as well as a filename

Updated examples:
    The gtk examples now work with pygtk >= 2.7.0 without requiring the
    cairo.gtk module

Bug Fixes
    fix "initializer element is not constant" compiler warnings


Overview of changes from pycairo 0.6.0 to pycairo 0.9.0
=======================================================
General changes:
Pycairo has been updated to work with cairo 0.9.0.

New cairo functions supported:
	cairo_get_antialias
	cairo_set_antialias
	cairo_surface_mark_dirty_rectangle
	cairo_surface_flush

Bug Fixes
- double buffering now works with the cairo.gtk module


Overview of changes from pycairo 0.5.1 to pycairo 0.6.0
=======================================================
General changes:
 Pycairo has been updated to work with cairo 0.6.0, including using cairo's new
 error handling scheme.

New features:
 cairo.CONTENT_COLOR, cairo.ALPHA, cairo.COLOR_ALPHA have been added for
 working with surfaces.

 A new class cairo.FontOptions has been added.

 cairo.ImageSurface.create_from_png() now accepts a filename string or a file
 object

 New wrapper functions have been added for cairo_get_font_options,
 cairo_set_font_options and cairo_surface_get_font_options.


Overview of changes from pycairo 0.5.0 to pycairo 0.5.1
=======================================================
New features:
- new class cairo.Win32Surface (Niki Spahiev)
- cairo.HAS_WIN32_SURFACE, cairo.HAS_PS_SURFACE etc are defined to give access
  to the values from cairo-features.h

Fixes:
- fix cairo_mask, cairo_mask_surface and cairo_stroke_preserve wrappers
- compile properly against GTK+ 2.7 (Gustavo Carneiro)
- other small fixes, including fixes for gcc 4.0 warnings


Overview of changes from pycairo 0.5.1 to pycairo 0.6.0
=======================================================
This version has many changes which update Pycairo to the new cairo API. The
change list is not duplicated here, instead see the cairo/NEWS file for full
details of all these API changes.

Pycairo method names that were different from the underlying cairo function
names have been changed to make Pycairo more closely follow cairo and so
enable the cairo documentation to be used for writing Pycairo programs.
NOTES has been updated to list the differences between the C API and the
Pycairo API.

Context.copy_path() has been implemented, it returns a Path instance which
supports the iterator protocol.

Python 2.3 is now required.

New examples:
examples/warpedtext.py
	shows usage of the Path iterator

examples/cairo_snippets/
	shows many of the 'cairo-demo/cairo_snippets' examples

examples/gtk/png_view.py
	example using cairo.ImageSurface.create_from_png()


Overview of changes from pycairo 0.1.4 to pycairo 0.4.0
=======================================================
New cairo bindings:
	cairo_font_extents

Bindings removed:
	cairo_font_set_transform
	cairo_font_current_transform

New examples:
	gtk/hangman.py

Other:
	Changed version numbering to correspond directly with the Cairo
	version Pycairo was developed to work with. So, for example,
	Pycairo version 0.4.0 represents the Pycairo version that has been
	developed and tested with Cairo 0.4.0.

Overview of changes from pycairo 0.1.3 to pycairo 0.1.4
=======================================================
The Pycairo license has changed so that it is now dual-licensed under the LGPL
and the MPL, the same as Cairo itself. For details see the COPYING file as
well as COPYING-LGPL-2.1 and COPYING-MPL-1.1.

New cairo bindings:
	cairo_pdf_surface_create
	cairo_set_target_pdf

New libsvg-cairo bindings:
	svg_cairo_parse
	svg_cairo_parse_buffer
	svg_cairo_render
	svg_cairo_get_size

Other:
	Added --without-pygtk configure option.
	Renamed the Pycairo API _new() functions to _wrap() to allow _new() to
	be used for python __new__ functions.
	New examples: svg2png.py and svgview.py.


Overview of changes for pycairo 0.1.3
=====================================
After the recent server compromise we discarded all unsigned
snapshots. That left us without a pycairo snapshot.

Additionally, there were no tags in the source repository so I
couldn't recreate the 0.1.2 snapshot, so here's a new 0.1.3 snapshot.

I apologize if I botched the version number or left something
significant out of this announcement---I'm not the one who will
usually be doing pycairo maintenance.

New bindings:
	current_path
	current_path_flat
	current_font_extents

Changes:
	fill_extents,stroke_extents: Remove unnecessary args and
	change from a method to an attribute.

Other:
	Added two new examples: context-subclass.py and warpedtext.py