GraphicsMagick 的另一个 Python 包装器
项目描述
关于
pgmagick 是另一个基于 boost.python 的GraphicsMagick包装器。
安装
安装到:
$ pip install pgmagick
要求
Python3.5++(或 Python2.7)、GraphicsMagick 和 Boost.Python。
在 Debian Buster 上安装软件包:
$ apt-get install g++ libgraphicsmagick++1-dev libboost-python-dev
在 Ubuntu 上安装包(在 Ubuntu10.04+ 上测试):
### Ubuntu11.10+ ### $ apt-get install python-pgmagick ### Ubuntu10.04+ ### $ apt-get install libgraphicsmagick++1-dev $ apt-get install libboost-python1.40-dev
在 Fedora 上安装包:
$ yum install GraphicsMagick-c++-devel $ yum install boost-devel
源包中的 GraphicsMagick:
$ ./configure --enable-shared=yes $ make && make install
macOS
通过带有 Python3 的 homebrew-cask(homebrew-pgmagick)
$ brew tap hhatto/pgmagick $ brew install pgmagick
通过带有 Python3 的 homebrew-cask(homebrew-pgmagick)
通过自制软件和使用 Python3 的 pip
在 MacOSX (10.13.5~10.15.x) 上:
$ 酿造安装蟒蛇 $ brew install graphicsmagick $ brew install boost-python3 $ pip install pgmagick
视窗
现在,不是官方支持。但是,存在非官方的二进制包。
ImageMagick 支持
ImageMagick 库支持 pgmagick。(版本:0.4+)
在 Ubuntu 上安装包(在 Ubuntu10.04+ 上测试):
$ apt-get install libmagick++-dev
显示库名称和版本:
>>> from pgmagick import gminfo >>> gminfo.library 'GraphicsMagick' # or 'ImageMagick' >>> gminfo.version '1.3.x' >>>
用法
比例示例:
>>> from pgmagick import Image
>>> im = Image('input.jpg')
>>> im.quality(100)
>>> im.scale('100x100')
>>> im.sharpen(1.0)
>>> im.write('output.jpg')
调整大小示例:
>>> from pgmagick import Image
>>> im = Image('input.jpg')
>>> im.filterType(FilterTypes.SincFilter)
>>> im.resize('100x100')
>>> im.write('output.jpg')
复合示例:
>>> from pgmagick import Image, CompositeOperator as co
>>> base = Image('base.png')
>>> layer = Image('layer_one.png')
>>> base.composite(layer, 100, 100, co.OverCompositeOp)
>>> im.write('output.png')
绘制示例:
>>> from pgmagick import Image, DrawableCircle, DrawableText, Geometry, Color
>>> im = Image(Geometry(300, 300), Color("yellow"))
>>> circle = DrawableCircle(100, 100, 20, 20)
>>> im.draw(circle)
>>> im.fontPointsize(65)
>>> text = DrawableText(30, 250, "Hello pgmagick")
>>> im.draw(text)
>>> im.write('hoge.png')
块访问:
>>> from pgmagick import Image, Blob, Geometry
>>> blob = Blob(open('filename.jpg').read())
>>> blob.update(open('filename2.jpg').read())
>>> img = Image(blob, Geometry(600, 480))
>>> img.scale('300x200')
>>> img.write('out.jpg')
创建动画-GIF:
from pgmagick import Image, ImageList, Geometry, Color
imgs = ImageList()
for color in ('red', 'blue', 'green', 'black', 'yellow'):
imgs.append(Image(Geometry(200, 200), Color(color)))
imgs.animationDelayImages(100)
imgs.scaleImages(Geometry(100, 100))
imgs.writeImages('output.gif')
更多 API 细节……阅读Magick++ API for GraphicsMagick文档。
Python API(注意!!此 api 是 alpha 版本!!):
>>> from pgmagick.api import Image
>>> img = Image((300, 300), "gradient:#ffffff-#000000")
>>> img.scale(0.8)
>>> img.write('out.png')