PythonMagick库使用心得

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")