Java 图片转换为字符图 CharMaps (整理)

 
/*
 *                    Java 图片转换成字符图 CharMaps (整理)                             
 *                                              
 *                                              2016-1-2 深圳 南山平山村 曾剑锋 
 *
 * @(#)CharMaps.java     2014/1/16  
 *         1、这个一个Java程序,感谢您花费大量时间阅读本文档;
 *         2、本人知道大家并不喜欢看大量文字描述,但实属无奈,因为我们的沟通只能通过文字;
 *         3、当您在复制、粘贴的时候请注意包名为:practice,文件名为:CharMaps,以防止一些不必要的麻烦;
 *         4、下面这张由字符组成的图是直接由图片生成的,信与不信由您决定,另外可以肯定的是本人绝对不会一个字一个敲这幅图;
 *         5、如果想知道她是如何完成的,请看完CharMaps类前面的全部注释,因为她是工具,有些内容需要了解、素材需要准备;
 *         6、本次注释参考了MyEclipse的注释风格,相对比上次来说注释要规范一些,但由于本人经验、认知水平有限,可能很多地方没有
 *             考虑完全,或者没有解释清楚,请谅解。
 */
package demo;

import java.awt.image.BufferedImage;
import java.io.BufferedWriter;
import java.io.File;
import java.io.FileWriter;
import java.io.IOException;
import java.util.Arrays;
import java.util.regex.Matcher;
import java.util.regex.Pattern;
import javax.imageio.ImageIO;
import javax.swing.JFileChooser;
import javax.swing.filechooser.FileNameExtensionFilter;
/**
 *
 * <p>
 * <h4>一、软件声明:</h4><br><ol>
 *         <li>该软件是为了解决TTS无法上图的原因才写出来的,同时感谢您花费宝贵的时间来阅读本文档;<br>
 *         <li>如果您打算使用这个小工具,那么请阅读完这个这整段注释;
 *         <li>如果您只是路过,那么您可以也可以猫一眼 ^_^,不过我相信她不会让您失望的;<br>
 *         <li>该软件已被我命名为CharMaps,在后面的注释中,我说明了命名理由 ^_^;<br>
 *         <li>TTS最小字号是9px阻碍了CharMaps的强大功能,但CharMaps至少能缓解一下我们对图片的向往,希望TTS以后会放宽规则;<br>
 *     
 *         该小工具被我命名为:CharMaps,没有抄袭他人的思路,是根据自己的需求写的,希望她能给您带来乐趣<br>
 * </ol></p>
 *
 * <p>
 * <h4>二、CharMaps由来:</h4><br><ol>
 *         <li>CharMaps制作初衷是因为TTS不能上图,之前上传《动态写轮眼(火影)——Java原创》系列软件时感觉实在不爽,所以自己通过
 *                自己目前的认知水平写了这个CharMaps。<br>
 *         <li>灵感来自硬件传感器——摄像头——的工作原理,有兴趣的朋友可以去找下度娘或者谷哥,听说他们很懂的样子。 ^_^<br>
 *</ol></p>
 *
 * <p>
 * <h4>三、CharMaps命名解析:</h4><br><ol>
 *         <li>Char代表字符,因为她将图片里对一个的像素转换成了字符,为什么是字符而不是字节?原因在于字节宽高比大约是1:2.5,
 *                而字符的宽高大约是1:1,我说的是大约 ^_^;<br>
 *        <li>Map是代表输出的就像每张图片一个映射(map);<br>
 *        <li>s是因为能同时处理多张图片;<br>
 *        <li>最终组合为CharMaps,很优雅的名字,^_^ ;<br>
 *</ol></p>
 *
 * <p>
 * <h4>四、CharMaps知识预备:</h4><br><ol>
 *         <li>CharMaps采用了具有RGB(red,green,blue)三基色的图片,后缀名为png/PNG/jpeg/jpe/JPEG,但只能处理黑白
 *                 图,原因是黑白图在三基色上是平均分布的,而CharMaps仅是依靠blue分量进行图片处理。<br>
 *         <li>如果您手上没有黑白图,您可以使用我们使用的操作系统自带的The GIMP,该软件自带了离线中文帮助文档,界面挺清爽
 *                 的,您可以通过以下途径打开:应用程序 ——> 图像 ——> The GIMP,如果您不会使用,那就看看帮助文档吧,如果
 *                 您以前使用Photoshop(PS),估计您会有很熟悉的感觉,您以前投资在PS上的时间终于得到了有效回报, ^_^。<br>
 * </ol></p>
 *
 * <p>
 * <h4>五、CharMaps缺陷:</h4><br><ol>
 *         <li>目前只支持黑白图,其他的图不保证效果,主要是写复杂了不利于学习交流,简单并能提供一些思路,并且每个人可以根据
 *                 自己需要进行功能改进或者定制才是沟通学习的王道;<br>
 *         <li>所能转换的图片目前默认支持宽:int charMapsCol = 2000;高:int charMapsRow = 1000;您自己可以修改;<br>
 *         <li>没有提供图片的自动缩放功能,所以不要操作默认支持的宽高,或者你自己修改的宽高;<br>
 *         <li>目前没有发现Bug,不保证您在使用的时候会不会出现Bug,就算遇到了,相信您也能够独立解决,TTS不提供沟通讨论,没办法,
 *                 另外本软件代码行数150左右(不包括注释),您懂的 ;^_^<br>
 *         <li>如果这个小软件给您带来了不必要的麻烦,本人向您表示歉意。<br>
 * </ol></P>
 *
 * <p>
 * <h4>六、CharMaps操作流程:</h4><br><ol>
 *         <li>准备好一张或者多张后缀是png/PNG/jpeg/jpe/JPEG的文件,运行本程序;<br>
 *         <li>在文件选择框选择要转换的后缀是png/PNG/jpeg/jpe/JPEG的文件,选择完成后点“打开”按钮;不选择就会得到一个空文件;<br>
 *         <li>根据Console提示框中内容找到输出文件,默认是路径/home/soft1/charMaps.txt,您可以自己修改;<br>
 *         <li>用文本编辑器打开,把字号(不是字体)改成2px,看看效果吧。<br>
 * </ol></p>
 *
 * <p>
 * <h4>七、CharMaps工作流程图(非代码分析的朋友可以略过):</h4><br><ol>
 *             本次注释参考了MyEclipse的注释风格,注释尽量简洁,没有添加过多的额外的注释,以下为main()函数工作流程层次:<br>
 *             <ul>
 *         <li>|--filesSelectInit() //初始化文件选择器,主要用于过滤掉一些后缀不是png/PNG/jpeg/jpe/JPEG的文件,方便选择文件;<br>
 *         <li>|--charMapsInit()     //初始化charMaps数组,并以字符‘虢’填充,主要是笔画多,作为黑色背景好,还有就是字里有老虎 ^_^;<br>
 *         <li>|--ImageProcessing() //图片处理函数,里面包含了如何对图片进行处理的方法;<br>
 *         <ul><li>|--singleImageProcessing() //单张图片处理函数;<br>
 *             <ul><li>|--fileSuffixCheck()   //文件后缀检查,采用了正则表达式,主要是为了防止有些朋友选错;<br>
 *                 <li>|--ImageSizeCheck()       //图片大小检查,主要是因为charMaps大小已由charMapsRow和charMapsCol固定了;<br>
 *                 <li>|--ImageMapToCharMaps() //将图片(Image)映射(map)到charMaps,所有的图片都是以charMaps中心点进行映射
 *                                                 这个步骤中把每张图片的没有内容的边框裁减掉了;<br>
 *             </ul>
 *         </ul>
 *         <li>|--addFrameForCharMaps()//如果转换的图片尺寸没有大于charMaps,那么给图片加个框,您可以通过注释掉这一行
 *                                         看有这个函数和没有这个函数的区别;<br>    
 *         <li>|--fileSave()         //将最终的结果保存起来,路径已经固定,如果您有需要的话可以自己修改里面的路径。<br>
 * </ul></ol></P>
 * @author 曾剑锋<br>
 * @date 2014-1-16<br>
 */
public class CharMaps{
    /** 声明一个文件选择器引用 */
    static JFileChooser jFileChooser = null;
    /**
     *&nbsp &nbsp &nbsp &nbsp
     *      在很多时候,我们在转换成为字符的时候,上、下、左、右总有我们那些我们不需要的一些行,这行不
     *是我们自己需要的,我们还让软件帮我们处理掉吧,默认赋值有那么点讲究,您应该能看懂的,其实跟后面
     *的判断取值有关,初始化值是根据小的取大值,大的取小值的方式,您自己可以看着取。
     *
     */
    static int firstOfUpRow = Integer.MAX_VALUE;
    static int firstOfCol = Integer.MAX_VALUE;
    static int lastOfUpRow = Integer.MIN_VALUE;
    static int lastOfCol = Integer.MIN_VALUE;
    /**
     * charMapsRow用于定义charMaps的行数<br>
     * charMapsCol用于定义charMaps的列数<br>
     */
    static int charMapsRow = 1000;
    static int charMapsCol = 2000;
    static char[][] charMaps = null;

    /** 用于保存您选择的单个或者多个文件路径集合, 初始化为null */
    static File[] filePaths = null;
    
    /** 保存图片的宽、高 */
    static int imageWidth = 0;
    static int imageHeight = 0;
    /**
     * &nbsp &nbsp &nbsp &nbsp
     *       在多张图片处理时候,每张图片处理使用不同的字符区别,charSelectindex用于计数,10个字符循环,
     * 如果一个charMaps同一个位置上字符会被后面的字符替代,如果没有则保持之前的字符<br>
     */
    static int charSelectindex = 0;
    static char[] charSelects = {'一','二','三','四','五','六','七','八','九','十'};
    /** 图像缓冲引用 */
    static BufferedImage bufferedImage = null;
    /**
     * main()函数,完成任务如下:<br><ol>
     *         <li>对文件选择器进行初始化;<br>
     *         <li>对charMaps二维数组进行初始化;<br>
     *         <li>对已选择的图片集进行处理;<br>
     *         <li>由于图片集处理函数对图片有效边界进行了记录,调用addFrameForCharMaps(),添加在上、下、左、右各
     *             添加一个字符的边框,使输出的CharMaps转换出来的图更具视觉效果;<br>
     *         <li>保存转换好的文件;<br>
     *         <li>如果出现异常,给出提示信息。<br></ol>
     */
    public static void main(String[] args) {
        try {
            filesSelectInit();
            charMapsInit();
            ImageProcessing();
            addFrameForCharMaps();
            fileSave();    
        } catch (Exception e) {
            System.out.println("请选择后缀为png/PNG/jpeg/jpe/JPEG的文件");
        }
    }
    /**
     * 图像处理函数,完成任务如下:<br><ol>
     *         <li>判断jFileChooser是否按下了打开;<br>
     *         <li>获取一个或者多个文件,保存于filePaths中;<br>
     *         <li>使用for循环迭代分成单张图片依次处理,调用singleImageProcessing()函数处理;<br>
     *         <li>图片处理完给出提示。<br></ol>
     */
    private static void ImageProcessing() throws IOException {
        //判断是否在文件选择框上点了确定
        if (jFileChooser.showOpenDialog(null) == JFileChooser.APPROVE_OPTION) {
            filePaths = jFileChooser.getSelectedFiles();
            for (File filePath : filePaths) {
                singleImageProcessing(filePath);
            }
            System.out.println("3、完成图像处理");
        }
    }
    /**
     * 单张图片处理函数,完成任务如下:<br><ol>
     *         <li>调用文件后缀检查函数fileSuffixCheck(),防止因操作失误而引发的异常;<br>
     *         <li>调用图片尺寸检查函数ImageSizeCheck(),防止图片尺寸过大,因为没有提供图片缩放功能;<br>
     *         <li>调用图片映射函数ImageMapToCharMaps(),将图片的像素点映射到CharMaps数组中;<br>
     *         <li>如果是多张图片的charSelectindex完成对charSelects数组中10个字符的自动选择。<br></ol>
     *
     * @param filePath    传入filePath进行检查,在返回回来,如果不行就抛弃。<br>
     * @throws IOException<br>
     */
    private static void singleImageProcessing(File filePath) throws IOException {
        filePath = fileSuffixCheck(filePath);
        ImageSizeCheck(filePath);
        ImageMapToCharMaps();
        charSelectindex = charSelectindex++ % 10;
    }
    /**
     * 为charMaps添加边框,完成任务如下:<br>
     * &nbsp &nbsp &nbsp &nbsp
     *         如果有效的图形区域小于charMaps数组大小,在上、下、左、右按条件添加一个字符的边框,使输出的CharMaps转换出来的图更具视觉效果;<br>
     */
    private static void addFrameForCharMaps() {
        firstOfCol = firstOfCol > 0 ? firstOfCol-1 : 0;
        firstOfUpRow = firstOfUpRow > 0 ? firstOfUpRow-1 : 0;
        lastOfCol = lastOfCol < charMapsCol ? lastOfCol+1 : charMapsCol;
        lastOfUpRow = lastOfUpRow < charMapsRow ? lastOfUpRow+1 : charMapsRow;
    }
    /**
     * 图片映射函数,完成任务如下:<br><ol>
     *         <li>双重循环获取图片的宽高;<br>
     *         <li>读出图片对应的坐标的RGB值<br>
     *         <li>判断对应坐标点的RGB是背景还是需要转换,这里之使用了B(blue)的值,判断,这也是为什么目前的
     *             CharMaps只能处理黑白图,当然应该也可以处理白蓝 ^_^<br>
     *         <li>对符合要求的的像素点改变charMaps对应点的字符<br>
     *         <li>对符合要求的像素进行边界检测,主要是完成对图片的边沿检查<br></ol>
     */
    private static void ImageMapToCharMaps() {
        for (int i = 0; i < imageHeight; i++) {
            for (int j = 0; j < imageWidth; j++) {
                int rgb = bufferedImage.getRGB(j, i);
                if ((rgb&0xff)<128 ) {
                    charMaps[charMaps.length/2-imageHeight/2+i][charMaps[0].length/2-imageWidth/2+j] = charSelects[charSelectindex];
                    boundedRangeOfImage(i,j);
                }
            }
        }
    }
    /**
     * 图片边界范围检查函数,完成任务如下:<br>
     * &nbsp &nbsp &nbsp &nbsp
     *         主要是完成检查当前点是否是图片的有效边缘,对图片上、下、左、右有效区域进行查找,为后面保存时裁剪作准备。<br>
     * @param i 当前点的行号
     * @param j 当前点的列号
     */
    private static void boundedRangeOfImage(int i, int j) {
        //记录图形中最上面开始出现图形行号
        if (charMaps.length/2-imageHeight/2+i<firstOfUpRow) {
            firstOfUpRow = charMaps.length/2-imageHeight/2+i;
        }
        //记录图形中最下面开始不再出现图形行号
        if (charMaps.length/2-imageHeight/2+i>lastOfUpRow) {
            lastOfUpRow = charMaps.length/2-imageHeight/2+i;
        }
        //记录图形中一行里面开始出现图形列号
        if (charMaps[0].length/2-imageWidth/2+j<firstOfCol) {
            firstOfCol = charMaps[0].length/2-imageWidth/2+j;
        }
        //记录图形中一行里面开始不再出现图形列号
        if (charMaps[0].length/2-imageWidth/2+j>lastOfCol) {
            lastOfCol = charMaps[0].length/2-imageWidth/2+j;
        }
    }
    /**
     * 图片尺寸检查函数,完成任务如下:<br>
     * &nbsp &nbsp &nbsp &nbsp
     *         主要是完成对图片的尺寸进行检查,不要比默认设置或者自己定制的charMaps数组大。<br>
     */
    private static void ImageSizeCheck(File filePath) throws IOException {
        bufferedImage = ImageIO.read(filePath);
        //得到图片的长宽
        imageWidth = bufferedImage.getWidth();
        imageHeight = bufferedImage.getHeight();
        if ((charMapsRow < imageHeight) || (charMapsCol < imageWidth)) {
            System.out.println("图片宽因该小于2000,高小于1000");
            return ;
        }        
    }
    /**
     * 文件后缀检查函数,完成任务如下:<br>
     * &nbsp &nbsp &nbsp &nbsp
     *         采用正则表达式对文件进行匹配。<br>
     */
    private static File fileSuffixCheck(File filePath) {
        //使用正则表达式来防止选择目前不支持的文件,目前只支持png/PNG/jpeg/jpe/JPEG格式图片
        Pattern pattern = Pattern.compile(".+[.][pPJj][nNpP][eEgGpP][gG]?");
        Matcher matcher = pattern.matcher(filePath.getName());
        if (matcher.matches() == false) {
            return null;
        }
        return filePath;
    }
    /**
     * charMaps初始化函数,Init是初始化的英文单词缩写,完成任务如下:<br>
     * &nbsp &nbsp &nbsp &nbsp
     *         完成对charMaps初始化,并提示完成。<br>
     */
    private static void charMapsInit() {
        charMaps = new char[charMapsRow][charMapsCol];
        //记得需要初始化,否则好像出不来值
        for (int i = 0; i < charMaps.length; i++) {
            Arrays.fill(charMaps[i], '虢');
        }    
        System.out.println("2、完成charMaps数组初始化");
    }
    /**
     * 文件保存函数,完成任务如下:<br><ol>
     *         <li>设置一个文件保存的路径,这个路径可以自己修改;<br>
     *         <li>创建文件路径下的文件缓冲区;<br>
     *         <li>将charMaps中的字符写好文件中,忽略在上、下、左、右边界之外的部分,只将边界内的字符输出;<br>
     *         <li>每写完一行字符,进行换行;<br>
     *         <li>最后关闭文件缓冲区,如果不关闭,文件缓冲区内的字符可能不会写到文件中,请注意;<br>
     *         <li>提示完成以及提示文件路径。<br><ol>
     */
    private static void fileSave() {
        JFileChooser jFileChooser = new JFileChooser();
        jFileChooser.setFileSelectionMode(JFileChooser.DIRECTORIES_ONLY);//只能选择目录
        jFileChooser.showOpenDialog(null);
        File saveFilePath = new File(jFileChooser.getSelectedFile().getPath()+"charMaps.txt");
        try {
            BufferedWriter bufferedWriter = new BufferedWriter(new FileWriter(saveFilePath));
            for (int i = 0; i < charMaps.length; i++) {
                if ((i >= firstOfUpRow) && (i <= lastOfUpRow)) {
                    bufferedWriter.write(charMaps[i], firstOfCol, lastOfCol-firstOfCol+1);
                    bufferedWriter.newLine();
                }
            }
            bufferedWriter.close();
        } catch (IOException e1) {
            e1.printStackTrace();
        }
        System.out.println("4、完成文件保存\n");
        System.out.println("CharMaps已完成完成工作,请到"+saveFilePath.getPath()+"中查看结果 ^_^\n");
    }
    /**
     * 文件选择对话框初始化函数,Init是初始化的英文单词缩写,完成任务如下:<br><ol>
     *         <li>提示欢迎使用CharMaps;<br>
     *         <li>创建文件选择对话框;<br>
     *         <li>创建文件选择过滤器;<br>
     *         <li>将文件选择过滤器添加进入文件对话框,还句话说是:使文件选择过滤器有效;<br>
     *         <li>将文件选择对话框设置为可以多选;<br>
     *         <li>提示完成初始化。<br></ol>
     */
    private static void filesSelectInit() {
        System.out.println("\n\t欢迎使用CharMaps");
        jFileChooser = new JFileChooser();
        FileNameExtensionFilter filter = new FileNameExtensionFilter(
                "Images", "jpg", "png","PNG","JPG","jpe","JPE");
        jFileChooser.setFileFilter(filter);
        jFileChooser.setMultiSelectionEnabled(true);
        System.out.println("1、完成文件选择初始化");
    }
}

 

 

转换的图片:

  

转换后的图片:

  

posted on 2016-01-02 15:16  zengjf  阅读(628)  评论(0编辑  收藏  举报

导航