PythonMagick库使用心得

Posted 2021-01-11 darknight

PythonMagick是imagemagick的python版本

实际上他是magick++的封装。函数，参数和magick++是一样的

参考文档：https://imagemagick.org/Magick++/tutorial/Magick++_tutorial.pdf

下面是一些摸索下来的心得，提供给需要的人，少走弯路

 

 

 

1 颜色空间转换

接到一个任务，批量生成荣誉证书，要求根据设计稿，生成图片：格式：JPG，PPI：300，颜色模式：CMYK,提供的素材也是这样的格式

首先想到的是用PIL库来操作，毕竟在python上面基本是标准库了

因为证书上还需要添加证件照，证件照只有RGB模式的，所以需要将图片从RGB转到CMYK

PIL下面就是一个convert就搞定了

lena =Image.open("lena.jpg")
lena_CMYK =lena.convert("CMYK")

但是就是颜色不对，转过来的图片变色了(如下图，右边是美工提供的设计稿，左边是通过PIL转换的cmyk），这样的色差是难以接受的

查了下原因，PIL的转换，操作比较简单，k值直接是0，这样颜色必然是不准的

模式“RGB”转换为模式“CMYK”以后，图像从三通道变成了四通道，其C、M、Y三个通道的数值是通过之前的公式计算得到，K通道被直接赋值为0。

C = 255 - R
M = 255 - G
Y = 255 - B
K = 0

　　

通过查询，得知需要导入icc文件才能得到ps的转换效果，查询了PIL，没有找到导入的选项（这里可能是本人水平有限，没有找到，如果有的话，希望能回复下，研究下看看）

查询下来，找到了一个工具imagemagick，是一个图片处理的工具包，这个工具包可以将图片转换颜色，按照提供的icc进行转换

命令行操作很简单

convert -profile "sRGB.icm" RGB.jpg -profile "CMYK.icc" CMYK.jpg

这样就完成了颜色的转换，和PS下转换的效果是一样的

然后发现这个工具包有python下面的库，http://www.lfd.uci.edu/~gohlke/pythonlibs/#pythonmagick

2.7版本的不知道为啥，总是装不好，换了3.7的就ok了

安装好以后查看支持的函数，dir(PythonMagick),可以看到如下函数，具体的函数帮助可以输入help()来查看

[\'Blob\', \'Color\', \'ColorspaceType\', \'CompositeOperator\', \'CompressionType\', \'Coordinate\', \'DecorationType\', \'DrawableAffine\', \'DrawableAlpha\', \'DrawableArc\', \'DrawableBezier\', \'DrawableCircle\', \'DrawableClipPath\', \'DrawableColor\', \'DrawableCompositeImage\', \'DrawableEllipse\', \'DrawableFillColor\', \'DrawableFillOpacity\', \'DrawableFillRule\', \'DrawableFont\', \'DrawableGravity\', \'DrawableLine\', \'DrawableMiterLimit\', \'DrawablePath\', \'DrawablePoint\', \'DrawablePointSize\', \'DrawablePolygon\', \'DrawablePolyline\', \'DrawablePopClipPath\', \'DrawablePopGraphicContext\', \'DrawablePopPattern\', \'DrawablePushClipPath\', \'DrawablePushGraphicContext\', \'DrawablePushPattern\', \'DrawableRectangle\', \'DrawableRotation\', \'DrawableRoundRectangle\', \'DrawableScaling\', \'DrawableSkewX\', \'DrawableSkewY\', \'DrawableStrokeAntialias\', \'DrawableStrokeColor\', \'DrawableStrokeDashArray\', \'DrawableStrokeDashOffset\', \'DrawableStrokeLineCap\', \'DrawableStrokeLineJoin\', \'DrawableStrokeOpacity\', \'DrawableStrokeWidth\', \'DrawableText\', \'DrawableTextAntialias\', \'DrawableTextDecoration\', \'DrawableTextUnderColor\', \'DrawableTranslation\', \'DrawableViewbox\', \'Exception\', \'FilterType\', \'Geometry\', \'GravityType\', \'Image\', \'PathArcAbs\', \'PathArcArgs\', \'PathArcRel\', \'PathClosePath\', \'PathCurvetoAbs\', \'PathCurvetoArgs\', \'PathCurvetoRel\', \'PathLinetoAbs\', \'PathLinetoHorizontalAbs\', \'PathLinetoHorizontalRel\', \'PathLinetoRel\', \'PathLinetoVerticalAbs\', \'PathLinetoVerticalRel\', \'PathMovetoAbs\', \'PathMovetoRel\', \'PathQuadraticCurvetoAbs\', \'PathQuadraticCurvetoArgs\', \'PathQuadraticCurvetoRel\', \'PathSmoothCurvetoAbs\', \'PathSmoothCurvetoRel\', \'PathSmoothQuadraticCurvetoAbs\', \'PathSmoothQuadraticCurvetoRel\', \'Pixels\', \'TypeMetric\', \'VPath\', \'_PythonMagick\', \'__builtins__\', \'__cached__\', \'__doc__\', \'__file__\', \'__loader__\', \'__name__\', \'__package__\', \'__path__\', \'__spec__\']

 

这个是PythonMagick.Image下的函数

[\'__class__\', \'__delattr__\', \'__dict__\', \'__dir__\', \'__doc__\', \'__eq__\', \'__format__\', \'__ge__\', \'__getattribute__\', \'__gt__\', \'__hash__\', \'__init__\', \'__init_subclass__\', \'__instance_size__\', \'__le__\', \'__lt__\', \'__module__\', \'__ne__\', \'__new__\', \'__reduce__\', \'__reduce_ex__\', \'__repr__\', \'__setattr__\', \'__sizeof__\', \'__str__\', \'__subclasshook__\', \'__weakref__\', \'adaptiveThreshold\', \'addNoise\', \'adjoin\', \'affineTransform\', \'alpha\', \'animationDelay\', \'animationIterations\', \'annotate\', \'attribute\', \'backgroundColor\', \'backgroundTexture\', \'baseColumns\', \'baseFilename\', \'baseRows\', \'blur\', \'border\', \'borderColor\', \'boundingBox\', \'boxColor\', \'channel\', \'channelDepth\', \'charcoal\', \'chop\', \'chromaBluePrimary\', \'chromaGreenPrimary\', \'chromaRedPrimary\', \'chromaWhitePoint\', \'classType\', \'colorFuzz\', \'colorMap\', \'colorMapSize\', \'colorSpace\', \'colorize\', \'columns\', \'comment\', \'compare\', \'compose\', \'composite\', \'compressType\', \'contrast\', \'convolve\', \'crop\', \'cycleColormap\', \'debug\', \'defineSet\', \'defineValue\', \'density\', \'depth\', \'despeckle\', \'directory\', \'display\', \'draw\', \'edge\', \'emboss\', \'endian\', \'enhance\', \'equalize\', \'erase\', \'fileName\', \'fileSize\', \'fillColor\', \'fillPattern\', \'fillRule\', \'filterType\', \'flip\', \'floodFillAlpha\', \'floodFillColor\', \'floodFillTexture\', \'flop\', \'font\', \'fontPointsize\', \'fontTypeMetrics\', \'format\', \'frame\', \'gamma\', \'gaussianBlur\', \'geometry\', \'gifDisposeMethod\', \'iccColorProfile\', \'implode\', \'interlaceType\', \'iptcProfile\', \'isValid\', \'label\', \'magick\', \'magnify\', \'map\', \'matteColor\', \'meanErrorPerPixel\', \'medianFilter\', \'minify\', \'modifyImage\', \'modulate\', \'modulusDepth\', \'monochrome\', \'montageGeometry\', \'negate\', \'normalize\', \'normalizedMaxError\', \'normalizedMeanError\', \'oilPaint\', \'opaque\', \'page\', \'ping\', \'pixelColor\', \'process\', \'profile\', \'quality\', \'quantize\', \'quantizeColorSpace\', \'quantizeColors\', \'quantizeDither\', \'quantizeTreeDepth\', \'raise\', \'read\', \'readPixels\', \'reduceNoise\', \'renderingIntent\', \'resize\', \'resolutionUnits\', \'roll\', \'rotate\', \'rows\', \'sample\', \'scale\', \'scene\', \'segment\', \'shade\', \'sharpen\', \'shave\', \'shear\', \'signature\', \'size\', \'solarize\', \'spread\', \'statistics\', \'stegano\', \'stereo\', \'strip\', \'strokeAntiAlias\', \'strokeColor\', \'strokeDashOffset\', \'strokeLineCap\', \'strokeLineJoin\', \'strokeMiterLimit\', \'strokePattern\', \'strokeWidth\', \'subImage\', \'subRange\', \'swirl\', \'syncPixels\', \'textEncoding\', \'texture\', \'threshold\', \'totalColors\', \'transformOrigin\', \'transformReset\', \'transformRotation\', \'transformScale\', \'transformSkewX\', \'transformSkewY\', \'transparent\', \'trim\', \'type\', \'unsharpmask\', \'verbose\', \'wave\', \'write\', \'writePixels\', \'x11Display\', \'xResolution\', \'yResolution\', \'zoom\']

=============================================================================================

上面都是介绍，下面才是正文

=============================================================================================

经过测试，加载icc文件使用的是\'iccColorProfile\'这个函数,如下是内置的帮助，可以看到，有2中用法，

1，传入blob类型参数，就可以设置icc文件

2，不传入参数，可以返回一个blob类型，意思是获取这个图片当前的icc文件

blob是内存中的二进制文件类型

Help on built-in function iccColorProfile:

iccColorProfile(...)
    iccColorProfile( (Image)arg1, (Blob)arg2) -> None :
    
        C++ signature :
            void iccColorProfile(class Magick::Image {lvalue},class Magick::Blob)
    
    iccColorProfile( (Image)arg1) -> Blob :
    
        C++ signature :
            class Magick::Blob iccColorProfile(class Magick::Image {lvalue})

官方的文档提供了blob类型的设置

Blob::Blob();
Blob::Blob(void* data, unsigned int size); // explicitly specifies a memory area to be
 　　　　　　　　　　　　　　　　　　　　　　　　　// associated with the new Blob object
Blob::operator=(const Blob& blob);
　　　　　　　　　　　　　　　　　　　　　　　　　 // Examples of using Blobs in conjuction with Images
Blob my_blob; // create a blob
Image my_image("my_image.gif"); 　　　　　　// create an image form a GIF image file
my_image.magick("JPEG"); 　　　　　　　　　　// set JPEG output format
my_image.write(&my_blob); 　　　　　　　　　　// encode \'my_image\' in JPEG format,
 　　　　　　　　　　　　　　　　　　　　　　　　// and store the encoded image in my_blob
Image image_from_blob(my_blob); 　　　　　　// create an image from the JPEG blob
 　　　　　　　　　　　　　　　　　　　　　　　　// (use the Blob-based Image constructor)
image_from_blob.magick("BMP"); 　　　　　　// set the image format to bitmap
image_from_blob.write("image_from_blob.bmp"); // save the image on disk in BMP format

使用image打开一个文件，然后写入到一个新的Blob类型即可,这边写了一个函数，调用即可得到一个Blob类型的实例，内容是相应的icc文件

#获取对应颜色空间的blob（例如cmyk，rgb）
def get_color_blob(file_name):
    color = PythonMagick.Blob()
    im = PythonMagick.Image(file_name)
    im.write(color,"icc")
    return color

cmyk = get_color_blob("CMYK.icc")
temp = PythonMagick.Image("rgb.jpg")
temp.iccColorProfile(cmyk)
temp.write("cmyk.jpg")

这样就能完成从rgb到cmyk的转换了，经测试，转换效果完美，和ps转换出来是一摸一样的

2 PPI设置

使用pythonmagick的话无需设置PPI，原始是300PPI，保存下来就是300PPI，但是使用PIL打开300PPI的图片，进行操作，然后保存，就会变成蜜汁72PPI（这个在印刷制品上是

不行的，印刷出来会模糊），pythonmagick完美的避开了这个坑

3 图片缩放

img = PythonMagick.Image("test.jpg")
#不保持比例
img.sample(\'298x412!\')
#保持比例
img.sample(\'298x412\')

4 图片覆盖

有时候需要把一个透明的PNG覆盖到底图的某个位置，比如说一个印章

back_img = PythonMagick.Image("back.jpg")
logo_img = PythonMagick.Image("logo.png")
#此操作会出现logo的底图是黑色的
back_img.composite(logo_img,x,y)
#使用over模式,具体可以查看magick++的文档，对应查找pythonmagick下面的函数，其他模式类似
back_img.composite(logo_img,x,y,PythonMagick.CompositeOperator.OverCompositeOp)

 

5 文字书写

系统提供DrawableFont，Image.annotate来在图片上书写字体

这里介绍使用ttf字体进行书写，并且使用奇葩的方法来实现粗体，字间距

Image.annotate查看系统的说明如下

Help on built-in function annotate:

annotate(...)
    annotate( (Image)arg1, (str)arg2, (Geometry)arg3) -> None :
    
        C++ signature :
            void annotate(class Magick::Image {lvalue},class std::basic_string<char,struct std::char_traits<char>,class std::allocator<char> >,class Magick::Geometry)
    
    annotate( (Image)arg1, (str)arg2, (Geometry)arg3, (GravityType)arg4) -> None :
    
        C++ signature :
            void annotate(class Magick::Image {lvalue},class std::basic_string<char,struct std::char_traits<char>,class std::allocator<char> >,class Magick::Geometry,enum MagickCore::GravityType)
    
    annotate( (Image)arg1, (str)arg2, (Geometry)arg3, (GravityType)arg4, (float)arg5) -> None :
    
        C++ signature :
            void annotate(class Magick::Image {lvalue},class std::basic_string<char,struct std::char_traits<char>,class std::allocator<char> >,class Magick::Geometry,enum MagickCore::GravityType,double)
    
    annotate( (Image)arg1, (str)arg2, (GravityType)arg3) -> None :
    
        C++ signature :
            void annotate(class Magick::Image {lvalue},class std::basic_string<char,struct std::char_traits<char>,class std::allocator<char> >,enum MagickCore::GravityType)

测试代码如下，注意：如果图片是cmyk模式，请先转换成rgb再书写文字，最后再保存cmyk，否则会变色

#打开底图
img = PythonMagick.Image("test.jpg")
#设置ttf字体
img.font("W3.TTF")
#设置字体大小
img.fontPointsize(60) 
#设置颜色
img.fillColor(PythonMagick.Color("#ff00ff"))
#书写字体（100，100是xy坐标）
img.annotate("你好",PythonMagick.Geometry("+100+100"))
#保存
img.write("000.jpg")

测试写字（下图是使用了奇葩方法实现的粗体，因为找不到粗体的选项）

之前使用PIL写字可以加粗，但是他写出来的字体比ps里面粗，而且无法调整粗的程度

这里就自己写了个加粗方法，原理很简单，写5次文字，

首先x，y坐标写一次

然后x-1，y写一次，x+1，y写一次，x，y-1写一次，x，y+1写一次

就是上下左右各偏一个像素写一遍，这样写出来的文字和ps里面的粗体可以说能达到99%的相似度

可以看出，书写出来的文字还是有一些差异的，不过这样的效果完全是OK的

#书写粗体字（默认间隔）
def img_text_bold(img,font_name,size,text,postion):
    img.font(font_name)
    img.fontPointsize(size) 
    #img.annotate(text,PythonMagick.Geometry("+%s+%s"%(postion[0],postion[1])))
    img.annotate(text,PythonMagick.Geometry("+%s+%s"%(postion[0]+1,postion[1])))
    img.annotate(text,PythonMagick.Geometry("+%s+%s"%(postion[0]-1,postion[1])))
    img.annotate(text,PythonMagick.Geometry("+%s+%s"%(postion[0],postion[1]+1)))
    img.annotate(text,PythonMagick.Geometry("+%s+%s"%(postion[0],postion[1]-1)))

#书写粗体字（自定义间隔）
def img_text_bold_space(img,font_name,size,space,text,postion):
    zz = 0
    for i in text:
        postion_new = [postion[0]+int(round(zz*space)),postion[1]]
        img_text_bold(img,font_name,size,i,postion_new)
        zz = zz + 1

因为找不到行间距这个参数，所以只能写一个奇葩的方法来实现字间距，实现原理就是一个个字写，写完一个字偏移一定的像素，如此来达到设置字间距的效果

如下效果

通过这一系列奇葩实现，可以达到设计稿的95%相似度，这样就完成了任务

 

6 图片对象引用

 

back_img = PythonMagick.Image("back.png")

temp1 = back_img
#对temp1进行各种操作，比如写字，剪裁，反转等
temp1.xxx()
temp1.xxx()
temp1.write("001.png")


temp2 = back_img
#对temp2进行各种操作，比如写字，剪裁，反转等
temp2.xxx()
temp2.xxx()
temp2.write("002.png")

 

上面的引用是不行的，temp2保存下来会带有temp1的操作效果，他这里 = 操作只是引用，不是复制

正确的做法是先新建一个Blob对象，把底图放在里面，然后temp去读取这个Blob对象来获得一个图片对象

#获取一个图片的Blob对象
def get_img_blob(file_name):
    last = file_name.split(".")[-1]
    img = PythonMagick.Image(file_name)
    blob = PythonMagick.Blob()
    img.write(blob,last)
    return blob

back_img_blob = get_img_blob("back.png")

temp1 = PythonMagick.Image(back_img_blob)
#对temp1进行各种操作，比如写字，剪裁，反转等
temp1.xxx()
temp1.xxx()
temp1.write("001.png")


temp2 = PythonMagick.Image(back_img_blob)
#对temp2进行各种操作，比如写字，剪裁，反转等
temp2.xxx()
temp2.xxx()
temp2.write("002.png")