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
|
#----------------------------------------------------------------------
# Name: wx.lib.wxcairo
# Purpose: Glue code to allow either the PyCairo package or the
# cairocffi package to be used with a wx.DC as the cairo
# surface.
#
# Author: Robin Dunn
#
# Created: 3-Sept-2008
# Copyright: (c) 2008-2020 by Total Control Software
# Licence: wxWindows license
#
# Tags: phoenix-port, py3-port
#----------------------------------------------------------------------
"""
This package provides some glue code that allows the Cairo library to draw
directly on :class:`wx.DC` objects, convert to/from :class:`wx.Bitmap`
objects, etc. using either the PyCairo or the newer cairocffi Cairo wrappers.
In Cairo terms, the DC is the drawing surface. The ``CairoContextFromDC``
function in this module will return an instance of the Cairo Context class
that is ready for drawing, using the native cairo surface type for the current
platform.
.. note:: Be sure to import ``wx.lib.wxcairo`` before importing the ``cairo``
module.
To use Cairo with wxPython you will need to have a few dependencies
installed. On Linux and other unix-like systems you may already have
them, or can easily get them with your system's package manager. Just
check if libcairo and either cairocffi or pycairo packages are installed.
On Mac you can get Cairo from MacPorts or similar tools. Make sure that
the quartz option is turned on so those Mac-specific APIs will be included in
the Cairo library when it is built. You can then use ``pip install cairocffi``
to get the Python wrappers. If your cairo shared library is in a non-standard
location, then you can help it be found by setting DYLD_FALLBACK_LIBRARY_PATH
in the environment.
On Windows a copy of the Cairo and related DLLs are included with wxPython
inside the wx package folder. These files were extracted from the GTK runtime
installers found at the following URLs. You can replace those DLLs with others
if you choose, or you can cause the wx_cairocffi module to use DLLs from some
other location by setting the CAIRO environment variable.
32bit: http://gtk-win.sourceforge.net/home/index.php/Main/Downloads
64bit: https://github.com/tschoonj/GTK-for-Windows-Runtime-Environment-Installer
"""
#----------------------------------------------------------------------------
import wx
# Import our glue functions for either cairocffi or pycairo, depending on
# which is installed.
try:
# Use cairocffi first if it is available
from .wx_cairocffi import _ContextFromDC, _FontFaceFromFont
import cairo
except ImportError:
try:
# otherwise use pycairo
from .wx_pycairo import _ContextFromDC, _FontFaceFromFont
import cairo
except ImportError:
# or provide some exception raising stubs instead
def _ContextFromDC(dc):
raise NotImplementedError("Cairo wrappers not found")
def _FontFaceFromFont(font):
raise NotImplementedError("Cairo wrappers not found")
#----------------------------------------------------------------------------
def ContextFromDC(dc):
"""
Creates and returns a ``cairo.Context`` object using the :class:`wx.DC` as
the surface. (Only window, client, paint and memory DC's are allowed at
this time.)
"""
return _ContextFromDC(dc)
def FontFaceFromFont(font):
"""
Creates and returns a ``cairo.FontFace`` object from the native
information in a :class:`wx.Font`.
"""
return _FontFaceFromFont(font)
#----------------------------------------------------------------------------
# wxBitmap <--> ImageSurface
def BitmapFromImageSurface(surface):
"""
Create a :class:`wx.Bitmap` from a Cairo ``ImageSurface``.
"""
format = surface.get_format()
if format not in [cairo.FORMAT_ARGB32, cairo.FORMAT_RGB24]:
raise TypeError("Unsupported format")
width = surface.get_width()
height = surface.get_height()
stride = surface.get_stride()
data = surface.get_data()
if format == cairo.FORMAT_ARGB32:
fmt = wx.BitmapBufferFormat_ARGB32
else:
fmt = wx.BitmapBufferFormat_RGB32
bmp = wx.Bitmap(width, height, 32)
bmp.CopyFromBuffer(data, fmt, stride)
return bmp
def ImageSurfaceFromBitmap(bitmap):
"""
Create a Cairo ``ImageSurface`` from a :class:`wx.Bitmap`
"""
width, height = bitmap.GetSize()
if bitmap.ConvertToImage().HasAlpha():
format = cairo.FORMAT_ARGB32
fmt = wx.BitmapBufferFormat_ARGB32
else:
format = cairo.FORMAT_RGB24
fmt = wx.BitmapBufferFormat_RGB32
try:
stride = cairo.ImageSurface.format_stride_for_width(format, width)
except AttributeError:
stride = width * 4
surface = cairo.ImageSurface(format, width, height)
bitmap.CopyToBuffer(surface.get_data(), fmt, stride)
surface.mark_dirty()
return surface
#----------------------------------------------------------------------------
|
