weimingtom / capimage Goto Github PK

##介绍 在很多编程语言中都有resizable image这样的概念，比如android中的NinePatch graphic ，css3中的border image，微软的Nine-Grid Rendering，还有就是iOS中UIImage的resizable image。

capimage.py是一个使用python的PIL库写的脚本，用于将一个普通的图片去除重复部分生成一个可伸缩的图片（resizable image），这样使得图片资源的使用更加灵活和节省空间。cap image支持苹果格式的高清图片（命名格式为[email protected]），脚本会智能的进行检查，上面所提及的capinsets的单位是point而非pixel，在高清的情况下1point等于2pixel。

##安装

1. Mac或者Linux平台， Python2.7

2. 使用pip或者easy_install 安装 PIL 模块, sudo pip install PIL

3. 安装 capimage

    git clone https://github.com/kejinlu/capimage.git
    cd capimage
    sudo python setup.py install
   

##用法

1. 图片检测

    capimage detect my_image.png
    capimage detect *.png
   

图片检测所做的事情就是对单个图片进行逐行以及逐列的像素对比，找出其所有的行像素连续相等的区间，以及列像素连续相等的区间。

2. 生成图片

usage: capimage.py gen [-h] [-c top left bottom right] [-t target_directory] source_file [source_file ...]

positional arguments: source_file The source image file paths

optional arguments:
-h, --help show this help message and exit
-c top left bottom right, --capinsets top left bottom right The cap insets for the resizable image
-t target_directory, --target-directory target_directory The directory where save the generated image

	capimage gen -c 20 20 20 20 my_image.png
	capimage gen -t ./ ~/Desktop/*.png

如果生成的时候没有指定 cap insets，那么脚本会自动去进行检测，算出最终的cap insets，计算capinsets并不是简单的根据当前图片来进行计算，还会检测与之配对的高清（或非高清）的图片的cap insets，然后算出最终的cap insets。这是因为一般情况下非高清和高清图片并不是简单的把每一个行或者列的像素重复一次，而是有很多矢量的放大效果，所以高清和非高清图片算出来的cap insets往往不一样。

##使用案例

假设我有两个原始图片:common_modal_bkg.png and [email protected]

然后我运行 capimage detect common_modal_bkg*.png,得到如下结果:

Luke@LukesMac:~/Desktop » capimage detect common_modal_bkg*.png
************************************
Image:common_modal_bkg.png
This is a low-resolution image
Image size:451x274
Starting to detect...
Repeated rows intervals:[[19, 253]]
Max row interval:[19, 253]
Repeated columns intervals:[[19, 430]]
Max column interval:[19, 430]
Suggested cap insets:(19, 19, 20, 20)
************************************
Image:[email protected]
This is a high-resolution image
Image size:902x548
Starting to detect...
Repeated rows intervals:[[35, 36], [38, 41], [42, 503], [504, 507], [509, 510], [545, 547]]
Max row interval:[42, 503]
Repeated columns intervals:[[38, 41], [42, 857], [858, 861], [899, 901]]
Max column interval:[42, 857]
Suggested cap insets:(21, 21, 22, 22)

若运行 capimage gen common_modal_bkg*.png,便生成两个可伸缩的图片，这个两个图片的capinsets均为 (21,21,22,22)