/
NEWS
1145 lines (822 loc) · 32.2 KB
/
NEWS
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
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
Since version 1.11.0 Pycairo uses `Semantic Versioning <http://semver.org/>`__
.. _v1.26.0:
1.26.0 - 2024-02-11
-------------------
This release only contains build related changes/fixes and no API changes.
* Bump minimum required meson version from 0.56.0 to 0.64.0 :pr:`346`
* Various meson related cleanups :pr:`350`
* Fix header file being installed to the wrong location with meson on some systems :pr:`350`
* Adds a new ``wheel`` meson build option as preparation for meson-python support :pr:`350` :pr:`345`
* Update dependencies (libpng, pixman, zlib) of the Windows wheels :pr:`358`
* Various maintenance related updates :pr:`360` :pr:`359` :pr:`361` :pr:`362`
.. _v1.25.1:
1.25.1 - 2023-10-21
-------------------
* Fix a crash with pypy3.10 :pr:`344`
* Fix the build with CPython 3.13.0a1 :pr:`343`
.. _v1.25.0:
1.25.0 - 2023-09-26
-------------------
* Update to cairo 1.18.0 for the Windows wheel
* Provide a Windows arm64 wheel
* New APIs:
* :attr:`Status.SVG_FONT_ERROR` :pr:`334`
* :meth:`FontOptions.get_color_mode`, :meth:`FontOptions.set_color_mode`, :class:`ColorMode` :pr:`336`
* :meth:`FontOptions.set_color_palette`, :meth:`FontOptions.get_color_palette`, :attr:`COLOR_PALETTE_DEFAULT` :pr:`338`
* :meth:`FontOptions.set_custom_palette_color`, :meth:`FontOptions.get_custom_palette_color` :pr:`339`
* :attr:`TAG_CONTENT`, :attr:`TAG_CONTENT_REF` :pr:`340`
* :meth:`Pattern.get_dither`, :meth:`Pattern.set_dither`, :class:`Dither` :pr:`341`
.. _v1.24.0:
1.24.0 - 2023-06-19
-------------------
* Dropped Python 3.7 support
* Bumped meson version requirement from 0.53.0 to 0.56.0
* Various cairo dependency updates for the Windows wheel build
* examples: update to GTK4 :pr:`307`
* examples: add a clip_image example :pr:`316`
* docs: fix the build with Sphinx 6 :pr:`318`
* Various code cleanups :pr:`306`
* Added Python 3.12 Windows wheels
.. _v1.23.0:
1.23.0 - 2022-11-28
-------------------
Reminder to distro packagers: Building/installing pycairo using setup.py is
deprecated, please use meson instead.
* git: changed default branch from "master" to "main"
* Windows: Update the cairo version included in the wheels from 1.17.2 to 1.17.6 :pr:`243`
* docs: Document how to look up pycairo headers without loading the module :pr:`300`
* tests: don't error out if cairo wasn't built with all features :pr:`293`
* New APIs:
* :attr:`Status.DWRITE_ERROR` :pr:`294`
* :attr:`Format.RGB96F`, :attr:`Format.RGBA128F` :pr:`295`
* :attr:`PDFVersion.VERSION_1_6`, :attr:`PDFVersion.VERSION_1_7` :pr:`296`
* :attr:`HAS_DWRITE_FONT` :pr:`297`
* :meth:`Context.set_hairline`, :meth:`Context.get_hairline` :pr:`298`
* :meth:`PDFSurface.set_custom_metadata` :pr:`299`
.. _v1.22.0:
1.22.0 - 2022-11-19
-------------------
* Officially support Python 3.11 :pr:`285`
* PDFSurface.version_to_string(): Fix crash with negative versions :pr:`279`
* typing: ImageSurface.get_stride() returns an int :pr:`282`
* typing: Fix incorrect interface for Matrix constructor :pr:`271`
* typing: Use Generic for Context :pr:`274`
* docs: some cairo.Context fixes :pr:`276`
* docs: try to make create_from_png/write_to_png more clear :pr:`261`
* docs: add an example for how to convert a surface to pillow :pr:`281`
* docs: cairo.Format.RGB24: document that unused bytes may be overwritten :pr:`289`
* tests: don't depend on specific ref counts :pr:`291`
* tests: compatibility fixes for cairo 1.17.6 :pr:`264`
.. _v1.21.0:
1.21.0 - 2022-03-07
-------------------
* Require Python 3.7+ :pr:`250`
* Require meson 0.53+
* Using `setup.py` directly to build/install pycairo is deprecated.
Use meson instead.
* `setup.py` now requires setuptools. Previously it was optional.
* The complete API reference is now included in the typing stubs, so it can be consumed/shown by IDEs. :pr:`236` :pr:`252`
.. _v1.20.1:
1.20.1 - 2021-06-03
-------------------
* Use poetry for development :pr:`232`
* setup.py: Respect the PKG_CONFIG environment variable :pr:`235`
* Make import_cairo inline in addition to static :pr:`224`
* docs: Fix example in Pattern.set_filter() docs :pr:`221`
* docs: Fix build with newer sphinx :pr:`222`
* docs: Fix NumPy width, height-conventions in examples :pr:`231`
* docs: Last parameter of rel_curve_to should be dy3, not dy4 :pr:`230`
* mypy: Fixes for mypy 0.800+ :pr:`233`
* mypy: Don't run mypy via pytest :pr:`234`
.. _v1.20.0:
1.20.0 - 2020-10-05
-------------------
* Require Python 3.6+ :pr:`201`
* Require cairo 1.15.10+ :pr:`204`
* docs: support Sphinx 3.0 :pr:`207`
* meson: add 'tests' option to skip tests :pr:`188`
* Windows: build wheels :pr:`197`
* Add support for Python 3.9 and 3.10 :pr:`198` :pr:`202`
* examples: add a Jupyter Notebook example :pr:`181`
* Raise an error early when being passed a file object not opened in binary mode :pr:`205`
* Add a pyproject.toml file :pr:`206`
.. _v1.19.1:
1.19.1 - 2020-02-16
-------------------
* docs: Add moderngl in the integration section. :pr:`174` (:user:`Einar Forselv <einarf>`)
* Support os.PathLike with PyPy3 >= 7.3.0
.. _v1.19.0:
1.19.0 - 2020-01-23
-------------------
* Python 2 is no longer supported :pr:`172`
* Add machine-readable license statement :pr:`158` (:user:`Maxim Ivanov <ulidtko>`)
* travis-ci: Manually set sysroot so correct SDK is used (:user:`Stuart Axon <stuaxo>`)
* Support Python 3.8 on Windows (because of DLL lookup changes)
* Fix wrong type for set_dash() offset parameter in the docs/types.
.. _v1.18.2:
1.18.2 - 2019-10-24
-------------------
* Fix a minor compatibility issue with Python 3.8 (fixes the test suite)
.. _v1.18.1:
1.18.1 - 2019-04-19
-------------------
* meson: install .egg-info to platlib
* meson: fix configure error with meson 0.50 re absolute paths :pr:`145`
* PyPy: don't use PyOS_FSPath() with PyPy3.6, it's missing: https://foss.heptapod.net/pypy/pypy/-/issues/2961
* Docs fixes :pr:`134` (:user:`Matteo Italia <cvtsi2sd>`)
.. _v1.18.0:
1.18.0 - 2018-11-04
-------------------
Build:
* Dropped Python 3.3 support
* meson build requires meson >=0.47 (was >=0.46)
* Fix various build warnings with GCC8
* meson: Don't link against libpython on non-Windows systems :pr:`120`
* meson: Improve support for Visual Studio builds
:pr:`121` (:user:`Chun-wei Fan <fanc999>`)
* setup.py: Support specifying custom ``--pkgconfigdir``
:pr:`127` (:user:`Michał Górny <mgorny>`)
Fixes:
* docs: Remove a broken link :pr:`124` (:user:`Nik Nyby <nikolas@gnu.org>`)
* typing: Add missing annotations for __enter__/__exit__ :pr:`126`
New API:
Some are only available when building with newer cairo versions, see the
linked API docs for details.
* :data:`CAIRO_VERSION`, :data:`CAIRO_VERSION_STRING`,
:data:`CAIRO_VERSION_MAJOR`, :data:`CAIRO_VERSION_MINOR`,
:data:`CAIRO_VERSION_MICRO`
* :attr:`Status.TAG_ERROR`, :attr:`Status.FREETYPE_ERROR`,
:attr:`Status.PNG_ERROR`, :attr:`Status.WIN32_GDI_ERROR`
* :class:`SVGUnit`, :class:`PDFMetadata`, :class:`PDFOutlineFlags`
* :meth:`FontOptions.set_variations`, :meth:`FontOptions.get_variations`
* :meth:`Context.tag_begin`, :meth:`Context.tag_end`,
:data:`TAG_DEST`, :data:`TAG_LINK`
* :meth:`PDFSurface.set_page_label`, :meth:`PDFSurface.set_metadata`,
:meth:`PDFSurface.set_thumbnail_size`, :meth:`PDFSurface.add_outline`,
:data:`PDF_OUTLINE_ROOT`
* :meth:`SVGSurface.set_document_unit`, :meth:`SVGSurface.get_document_unit`
* :data:`MIME_TYPE_CCITT_FAX`, :data:`MIME_TYPE_CCITT_FAX_PARAMS`,
:data:`MIME_TYPE_EPS`, :data:`MIME_TYPE_EPS_PARAMS`,
:data:`MIME_TYPE_JBIG2`, :data:`MIME_TYPE_JBIG2_GLOBAL`,
:data:`MIME_TYPE_JBIG2_GLOBAL_ID`
.. _v1.17.1:
1.17.1 - 2018-07-07
-------------------
* `Meson <https://mesonbuild.com/>`__ support (>=0.46). :bug:`114`
.. _v1.17.0:
1.17.0 - 2018-04-15
-------------------
* :class:`cairo.Surface` and :class:`cairo.Device` can now be used as context
managers. :bug:`103`
* Fix a leak when a cairo error was raised.
* Fix a leak when a mapped surface was GCed instead of unmapped.
* Make it possible to use the C API with Python 3 outside of the compilation
unit doing the import by defining ``PYCAIRO_NO_IMPORT``. :bug:`110`
* Implement PEP 561 (added a py.typed marker)
.. _v1.16.3:
1.16.3 - 2018-02-27
-------------------
* Ship Python type annotation stubs. They are currently supported by mypy and
PyCharm. :bug:`99` :pr:`101`
.. _v1.16.2:
1.16.2 - 2018-02-10
-------------------
* setup.py: Some fixes for Debian pybuild quirks. :bug:`98`
.. _v1.16.1:
1.16.1 - 2018-02-06
-------------------
* setup.py: correctly install pkgconfig into /usr/lib* again.
To make JHBuild on Fedora work the following patch is needed:
https://bugzilla.gnome.org/show_bug.cgi?id=793216
.. _v1.16.0:
1.16.0 - 2018-02-05
-------------------
* Add a :func:`get_include` function which returns the compiler include path
needed for interfacing with the Pycairo C API :bug:`92`
* Note for packagers: The default header installation path has changed, but a
compat header is installed to the old location to prevent breakage in case
anyone has hardcoded the old path instead of using pkg-config.
Just in case anyone is wondering why there are two header files now.
.. _v1.15.6:
1.15.6 - 2018-01-30
-------------------
* Experimental PyPy and PyPy3 support :bug:`90`
.. _v1.15.5:
1.15.5 - 2018-01-29
-------------------
* Support Unicode paths under Windows with cairo 1.15.10+ :pr:`87`
* Don't include the pkg-config file when building a wheel :bug:`83`
.. _v1.15.4:
1.15.4 - 2017-11-08
-------------------
Fixes:
* Fix some enum conversation errors with (unused) large and negative values.
:pr:`81`
Tests:
* Fix a rare test error :pr:`80` (:user:`Sergei Trofimovich <trofi>`)
.. _v1.15.3:
1.15.3 - 2017-09-17
-------------------
Fixes:
* setup.py: Install pkgconfig file into /usr/share/pkgconfig to work around
JHBuild on Fedora not picking it up.
* Fix tests on big endian machines. :bug:`75`
* Support building with MSVC :pr:`72` (:user:`Chun-wei Fan <fanc999>`)
Tests:
* Test MSVC builds on appveyor
.. _v1.15.2:
1.15.2 - 2017-09-03
-------------------
Fixes:
* setup.py: Install pkgconfig file to the same library prefix that Python
uses. (/usr/lib64 instead of /usr/lib under Fedora for example) :bug:`70`
:pr:`71` (:user:`Sander Sweers <infirit>`)
.. _v1.15.1:
1.15.1 - 2017-08-19
-------------------
Fixes:
* Improved support for Python filesystem paths including
:class:`os.PathLike`. See :class:`_PathLike` for details.
* Various minor fixes
Changes:
* Expose :class:`cairo.Path`
Tests:
* Improved test coverage from ~70% to ~90%
.. _v1.15.0:
1.15.0 - 2017-07-24
-------------------
New Features:
* Add :meth:`Surface.map_to_image` and :meth:`Surface.unmap_image` :bug:`51`
* Add :class:`RasterSourcePattern` :bug:`48`
* Add :class:`Glyph` :bug:`53`
* Add :class:`Rectangle` :bug:`54`
* Add :class:`TextCluster` :bug:`61`
* Add :meth:`ScaledFont.text_to_glyphs` and :meth:`ScaledFont.glyph_extents`
* Add :meth:`Context.show_text_glyphs`
* Add :class:`TextExtents` :bug:`62`
Changes:
* Pycairo instances wrapping the same underlying cairo object now hash and
compare equally e.g. ``context.get_target() == context.get_target()``
* Functions which returned a cairo error with :attr:`Status.NO_MEMORY` no
longer raise :exc:`python3:MemoryError`, but a subclass of :exc:`Error`
and :exc:`python3:MemoryError`. Similarly errors with
:attr:`Status.READ_ERROR` and :attr:`Status.WRITE_ERROR` no longer raise
:exc:`python3:IOError`, but a subclass of :exc:`Error` and
:exc:`python3:IOError`. :bug:`55`
* Some functions which previously returned a tuple now return a tuple
subclass like :class:`Rectangle`, :class:`Glyph`, :class:`TextCluster` and
:class:`TextExtents`
.. _v1.14.1:
1.14.1 - 2017-07-24
-------------------
Fixes:
* Fix a crash with :meth:`Surface.get_device` :bug:`57`
.. _v1.14.0:
1.14.0 - 2017-07-12
-------------------
General:
* Requires at least cairo 1.13.1 (The snapshop in Ubuntu 14.04)
Tests:
* Optional `Hypothesis <https://hypothesis.readthedocs.io>`__ tests.
New Features:
* Add :meth:`Surface.set_device_scale` and :meth:`Surface.get_device_scale`.
:pr:`44` (:user:`Sander Sweers <infirit>`)
* Add :class:`Device` :pr:`45`
* Add :meth:`Surface.get_device` :pr:`45`
* Add :class:`ScriptDevice` and :class:`ScriptMode` :pr:`46`
* Add :class:`ScriptSurface` :bug:`17`
* Add :attr:`Status.JBIG2_GLOBAL_MISSING`
* Add :meth:`Format.stride_for_width`
* Add :class:`TextClusterFlags` and :class:`SurfaceObserverMode`
* Add :meth:`Gradient.get_color_stops_rgba`
* Add :class:`TeeSurface`
* Add :class:`MeshPattern`
.. _v1.13.4:
1.13.4 - 2017-07-12
-------------------
Fixes:
* Fix a rare crash with :meth:`get_data() <ImageSurface.get_data>` under
Python 3 (1.13.3 regression).
.. _v1.13.3:
1.13.3 - 2017-06-01
-------------------
Fixes:
* Fix ImageSurface leaking in case :meth:`get_data() <ImageSurface.get_data>` is used under Python 3.
:bug:`41`
Documentation:
* Add Pillow to ImageSurface example. :pr:`40` (:user:`Stuart Axon <stuaxo>`)
* Describe Freetype-py intergration. :bug:`25` :pr:`43`
(:user:`Hin-Tak Leung <HinTak>`)
.. _v1.13.2:
1.13.2 - 2017-05-21
-------------------
Fixes:
* Fix pip failing to install pycairo in some cases. :bug:`39`
Testing:
* Added continuous testing for Windows using MSYS2 and appveyor. :bug:`19`
.. _v1.13.1:
1.13.1 - 2017-05-07
-------------------
Fixes:
* setup.py install: Fix generated pkg-config file if ``--home`` or
``--user`` is specified. :bug:`34`
* Fix a build error on macOS Sierra. :pr:`36`
(:user:`Nicolas P. Rougier <rougier>`)
* examples: Fix snippet examples when .pyc files are present. :bug:`35`
Documentation:
* Add Pyglet integration example. :pr:`33` (:user:`Stuart Axon <stuaxo>`)
.. _v1.13.0:
1.13.0 - 2017-05-03
-------------------
New Features:
* The buffer returned by :meth:`ImageSurface.get_data` under Python 2 now
implements the character buffer interface to make it work with
pygame.image.frombuffer(). :pr:`29`
* All C enum types now have their own corresponding Python enum type:
:class:`Antialias`, :class:`Content`, :class:`Extend`, :class:`FillRule`,
:class:`Filter`, :class:`FontSlant`, :class:`FontWeight`, :class:`Format`,
:class:`HintMetrics`, :class:`HintStyle`, :class:`LineCap`,
:class:`LineJoin`, :class:`Operator`, :class:`PDFVersion`,
:class:`PSLevel`, :class:`PathDataType`, :class:`RegionOverlap`,
:class:`SVGVersion`, :class:`Status`, :class:`SubpixelOrder`. :bug:`26`
All relevant constants are now an alias to attributes of those types e.g.
:data:`ANTIALIAS_DEFAULT` is the same as :attr:`Antialias.DEFAULT`.
All functions returning enum values now return instances of the new types
e.g. :meth:`Context.get_antialias` returns a :class:`Antialias`.
:attr:`Error.status` is now a :class:`Status`.
* All included examples now work with Python 2 & 3
* All included examples using GTK+ have been ported to GTK+ 3/PyGObject 3
Fixes:
* Fix the signature of the :class:`ImageSurface` buffer interface for Python 2
(int -> Py_ssize_t)
* setup.py: Ensure "-fno-strict-aliasing" is used with Python 2.
Testing:
* Added travis-ci tests for flake8 and sphinx. :pr:`30`, :pr:`32`
* The test suite now has optional tests for numpy and pygame integration.
.. _v1.12.0:
1.12.0 - 2017-04-18
-------------------
General:
* Require cairo 1.12.0
* Use C90 and enforce it on travis-ci. :bug:`5`, :fdobug:`22940`
Constants:
* Add various new cairo.OPERATOR_*, cairo.ANTIALIAS_* and
cairo.FORMAT_* constants. :bug:`1`
* Add :data:`HAS_MIME_SURFACE` and cairo.MIME_TYPE_*. :bug:`7`,
:fdobug:`58771`
* Add cairo.PDF_VERSION_*. :pr:`16`
* Add cairo.SVG_VERSION_*
:exc:`Error`:
* Add a :data:`Error.status` attribute exposing cairo.STATUS_*
* Add :exc:`CairoError` alias for :exc:`Error` for cairocffi compatibility
:class:`Matrix`:
* Expose matrix components as read/write properties. e.g. :data:`Matrix.xx`
* Fix type checking of the multiplication operator under
Python 3. :bug:`8`, :fdobug:`89162` (Lawrence D'Oliveiro)
:class:`Surface`:
* Add :meth:`Surface.set_mime_data`. :bug:`7`, :fdobug:`58771`
* Add :meth:`Surface.get_mime_data`. :bug:`7`, :fdobug:`58771`
* Add :meth:`Surface.supports_mime_type`. :bug:`7`, :fdobug:`58771`
* Add :meth:`Surface.create_for_rectangle`. :pr:`13`
* Add :meth:`Surface.create_similar_image`. :pr:`15`
* Add :meth:`Surface.has_show_text_glyphs`
* Fix crash when the surface wrapper gets deallocated before the surface
object. :bug:`11`
:class:`Context`:
* Add :meth:`Context.in_clip`. :pr:`14`
:class:`PDFSurface`:
* Add :meth:`PDFSurface.restrict_to_version`. :pr:`16`
* Add :meth:`PDFSurface.get_versions`. :pr:`16`
* Add :meth:`PDFSurface.version_to_string`. :pr:`16`
:class:`SVGSurface`:
* Add :meth:`SVGSurface.restrict_to_version`
* Add :meth:`SVGSurface.get_versions`
* Add :meth:`SVGSurface.version_to_string`
:class:`XCBSurface`:
* Add :meth:`XCBSurface.set_size`
:class:`PSSurface`:
* Add :meth:`PSSurface.get_levels`
* Add :meth:`PSSurface.level_to_string`
:class:`Pattern`:
* Add :meth:`Pattern.set_filter`
* Add :meth:`Pattern.get_filter`
:class:`RecordingSurface`:
* Add :meth:`RecordingSurface.get_extents`
:class:`FontOptions`:
* Implement ``__eq__`` and ``__ne__``
* Add :meth:`FontOptions.copy`
* Add :meth:`FontOptions.hash`
* Add :meth:`FontOptions.equal`
* Add :meth:`FontOptions.merge`
:class:`ScaledFont`:
* Add :meth:`ScaledFont.get_ctm`
* Add :meth:`ScaledFont.get_font_matrix`
* Add :meth:`ScaledFont.get_font_options`
.. _v1.11.1:
1.11.1 - 2017-04-12
-------------------
This release fixes an ABI breakage. I missed that the original pycairo master
had already broken ABI compared to 1.10.0.
.. _v1.11.0:
1.11.0 - 2017-04-09
-------------------
This version is based on the Python 2 version of pycairo 1.10.0 and is API/ABI
compatible with both py2cairo 1.10.0 and py3cairo 1.10.0.
General Changes:
* Requires cairo 1.10.2+
* Switch to semantic versioning
* Switch build system to distutils/setup.py (xpyb integration can be
enabled with passing ``--enable-xpyb`` to setup.py build)
* Moved to GitHub: https://github.com/pygobject/pycairo
New Features:
* Python 3 support (API/ABI compatible with py3cairo 1.10.0) including
support for :exc:`cairo.Error`, :meth:`cairo.ImageSurface.get_data` and
:meth:`cairo.ImageSurface.create_for_data`, which were missing in
py3cairo.
* :class:`cairo.RecordingSurface` (:fdobug:`36854`,
`Torsten Landschoff <t.landschoff@gmx.net>`__)
* :class:`cairo.Region`, :class:`cairo.RectangleInt` and
cairo.REGION_OVERLAP_*
(:fdobug:`44336`, `Bug Fly <mozbugbox@yahoo.com.au>`__)
Bug Fixes:
* Fix crash when read()/write() methods of file objects passed to pycairo
raise exceptions.
* Fix possible value truncation of handles passed to Win32Surface and
Win32PrintingSurface on 64bit Windows. :fdobug:`57493`
1.10.0 - 2011-05-01
-------------------
General Changes:
py2cairo 1.10.0 requires cairo 1.10.0 (or later).
New Constants:
cairo.FORMAT_RGB16_565
Bug Fixes:
* context.get_source().get_surface() fails :fdobug:`33013`
* Add support for './waf configure --libdir=XXX' :fdobug:`30230`
Documentation Changes:
* Upgrade to using Sphinx 1.0.7.
* Include html documentation in the pycairo archive file.
Build Changes:
* Update waf to 1.6.3
* Remove setup.py
Other Changes:
* Improve/simplify unicode filename support.
* Improve/simplify unicode text support.
1.8.10 - 2010-05-20
-------------------
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 (:fdobug:`27974`).
* Mingw32 and pypy fixes (:fdobug:`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.
1.8.8 - 2009-08-26
------------------
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.
1.8.6 - 2009-06-25
------------------
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
* :fdobug:`19221`: restore cairo.Matrix '*' operator to the way it
originally worked.
Other Changes:
Documentation completed.
1.8.4 - 2009-03-19
------------------
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.
1.8.2 - 2009-01-15
------------------
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:
* :fdobug:`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.
1.8.0 - 2008-12-15
------------------
General Changes:
Pycairo 1.8.0 requires cairo 1.8.0 (or later).
Add documentation (available separately)
Bug Fixes:
* :fdobug:`18101`: Add support for threading
* :fdobug:`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
:fdobug:`18947`.
Other Changes:
Allow unknown cairo Pattern/Surface types to use the pycairo base
Pattern/Surface type.
1.6.4 - 2008-08-18
------------------
General changes:
Pycairo 1.6.4 requires cairo 1.6.4 (or later).
requires Python 2.5 (or later).
Bug fixes:
:fdobug:`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
1.4.12 - 2007-12-13
-------------------
General changes:
Pycairo 1.4.12 requires cairo 1.4.12 (or later).
requires Python 2.4 (or later).
Bug fixes:
* :fdobug:`10006`: update autogen.sh to support automake >= 1.10
* :fdobug:`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
1.4.0 - 2007-03-14
------------------
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).
1.2.6 - 2006-11-27
------------------
* 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
1.2.2 - 2006-08-21
------------------
* 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.
1.2.0 - 2006-07-03
------------------
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
1.1.6 - 2006-05-29
------------------
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
1.0.2 - 2005-10-11
------------------
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
1.0.0 - 2005-08-31
------------------
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