plugins/image-plugin/readme.md · 尚晓东/quick-media

image-plugin

提供图片的各种操作封装类，目前支持功能：

1. 依赖

jar包引入，请注意使用最新的版本，直接到中央仓库依赖

<dependency>
    <groupId>com.github.liuyueyi.media</groupId>
    <artifactId>image-plugin</artifactId>
    <version>2.6.3</version>
</dependency>

2. 使用说明

目前提供了都中图文生成方式，可以通过测试包下的case来查看使用说明

a. ImgCreateWrapper

图文生成封装类，提供了多重生成功能的方式，生成条件参数

/**
 * 绘制的背景图
 */
private BufferedImage bgImg;


/**
 * 生成图片的宽
 */
private Integer imgW;


/**
 * 生成图片的高
 */
private Integer imgH;


/**
 * 文字对应的字体
 */
private Font font = DEFAULT_FONT;


/**
 * 字体色
 */
private Color fontColor = Color.BLACK;


/**
 * 左边距
 */
private int leftPadding;

/**
 * 右边距
 */
private int rightPadding;

/**
 * 上边距
 */
private int topPadding;

/**
 * 底边距
 */
private int bottomPadding;

/**
 * 行距
 */
private int linePadding;


/**
 * 对齐方式
 *
 * 水平绘制时: 左对齐，居中， 右对齐
 * 垂直绘制时: 上对齐，居中，下对齐
 *
 */
private AlignStyle alignStyle;


/**
 * 文本绘制方式， 水平or垂直
 */
private DrawStyle drawStyle;

一个简单的使用姿势，详情查看: ImgCreateWrapperTest.java

public void testLocalGenImg() throws IOException {
    int w = 400;
    int leftPadding = 10;
    int topPadding = 20;
    int bottomPadding = 10;
    int linePadding = 10;
    Font font = new Font("手札体", Font.PLAIN, 18);

    ImgCreateWrapper.Builder build = ImgCreateWrapper.build()
            .setImgW(w)
            .setLeftPadding(leftPadding)
            .setRightPadding(leftPadding)
            .setTopPadding(topPadding)
            .setBottomPadding(bottomPadding)
            .setLinePadding(linePadding)
            .setFont(font)
            .setAlignStyle(ImgCreateOptions.AlignStyle.CENTER)
            .setDrawStyle(ImgCreateOptions.DrawStyle.HORIZONTAL)
            .setBgColor(Color.WHITE)
            .setBorder(true)
            .setBorderColor(0xFFF7EED6);


    BufferedReader reader = FileReadUtil.createLineRead("text/poem.txt");
    String line;
    while ((line = reader.readLine()) != null) {
        build.drawContent(line);
    }

    build.setAlignStyle(ImgCreateOptions.AlignStyle.RIGHT)
            .drawImage("https://gitee.com/liuyueyi/Source/raw/master/img/info/blogInfoV2.png");

    BufferedImage img = build.asImage();
    ImageIO.write(img, "png", new File("/Users/yihui/Desktop/2out.png"));
}

b. LineGifCreateWrapper

逐行打印文本，主要参数同上，使用姿势可以参考: LineCreateWrapperTest

一个使用示意方式

private static final String sign = "https://gitee.com/liuyueyi/Source/raw/master/img/info/blogInfoV2.png";

@Test
public void genVerticalImg() throws IOException, FontFormatException {
    int h = 500;
    int leftPadding = 10;
    int topPadding = 10;
    int bottomPadding = 10;
    int linePadding = 10;

    LineGifCreateWrapper.Builder build = (LineGifCreateWrapper.Builder) LineGifCreateWrapper.build()
            .setImgH(h)
            .setDrawStyle(ImgCreateOptions.DrawStyle.VERTICAL_RIGHT)
            .setLeftPadding(leftPadding)
            .setTopPadding(topPadding)
            .setBottomPadding(bottomPadding)
            .setLinePadding(linePadding)
            .setFont(FontUtil.DEFAULT_FONT)
            .setFontColor(Color.BLUE)
            .setAlignStyle(ImgCreateOptions.AlignStyle.CENTER)
            .setBgColor(Color.WHITE)
            .setBorder(true)
            .setBorderColor(0xFFF7EED6);


    BufferedReader reader = FileReadUtil.createLineRead("text/poem.txt");
    String line;
    while ((line = reader.readLine()) != null) {
        build.drawContent(line);
    }

    build.setAlignStyle(ImgCreateOptions.AlignStyle.BOTTOM)
            .drawImage(sign);

    build.asGif("/Users/yihui/Desktop/out.gif");
//        String str = build.asString();
//
//        String dom = "<img src=\"" + DomUtil.toDomSrc(str, MediaType.ImageGif) + "\"/>";
//        System.out.println(dom);
}

c. WordGifCreateWrapper

逐字输出，生成gif动画，详细使用参考： LineCreateWrapperTest

一个简单的case如下:

@Test
public void testWordGif() throws IOException {
    int h = 300;
    int leftPadding = 10;
    int topPadding = 10;
    int bottomPadding = 10;
    int linePadding = 10;

    WordGifCreateWrapper.Builder build = (WordGifCreateWrapper.Builder) WordGifCreateWrapper.build()
            .setDelay(100)
            .setImgH(h)
            .setImgW(h)
            .setDrawStyle(ImgCreateOptions.DrawStyle.VERTICAL_RIGHT)
            .setLeftPadding(leftPadding)
            .setTopPadding(topPadding)
            .setBottomPadding(bottomPadding)
            .setLinePadding(linePadding)
            .setFont(FontUtil.DEFAULT_FONT)
            .setAlignStyle(ImgCreateOptions.AlignStyle.CENTER)
            .setBgColor(Color.WHITE)
            .setBorder(true)
            .setBorderColor(0xFFF7EED6)
            ;


    BufferedReader reader = FileReadUtil.createLineRead("text/poem.txt");
    String line;
    while ((line = reader.readLine()) != null) {
        build.drawContent(line);
    }

    build.drawContent(" ");

    build.setAlignStyle(ImgCreateOptions.AlignStyle.CENTER)
            .drawImage(sign);

    build.asGif("/Users/yihui/Desktop/out_word.gif");
}

d. ImgMergeWrapper

图片合成，目前提供一个生成个人签名的模板，生成如下格式的图

使用姿势就比较简单了，详细使用可以参考: ImgMergeWrapperTest

@Test
public void testTemplate() throws IOException {
    BufferedImage logo = ImageLoadUtil.getImageByPath("logo.jpg");
    BufferedImage qrCode = ImageLoadUtil.getImageByPath("QrCode.jpg");
    String name = "小灰灰Blog";
    List<String> desc = Arrays.asList("我是一灰灰，一匹不吃羊的狼", "专注码农技术分享");

    int w = QrCodeCardTemplate.w, h = QrCodeCardTemplate.h;
    List<IMergeCell> list = QrCodeCardTemplateBuilder.build(logo, name, desc, qrCode, "微 信 公 众 号");

    BufferedImage bg = ImgMergeWrapper.merge(list, w, h);

    try {
        ImageIO.write(bg, "jpg", new File("/Users/yihui/Desktop/merge.jpg"));
    } catch (Exception e) {
        e.printStackTrace();
    }
}

e. WaterMarkWrapper

水印封装类，详细使用可以参考: WaterMarkWrapperTest

一个简单的演示case

@Test
public void testWaterMark() {
        try {
            BufferedImage img = WaterMarkWrapper.of("bg.png")
                    .setInline(true)
                    .setWaterLogo("xcx.jpg")
                    .setWaterLogoHeight(50)
                    .setWaterInfo(" 图文小工具\n By 小灰灰Blog")
                    .setStyle(WaterMarkOptions.WaterStyle.FILL_BG)
                    .setWaterColor(Color.LIGHT_GRAY)
                    .setWaterOpacity(0.8f)
                    .setRotate(45)
                    .setPaddingX(80)
                    .setPaddingX(80)
                    .build()
                    .asImage();

            ImageIO.write(img, "jpg", new File("/Users/yihui/Desktop/FILL_BG.jpg"));
            System.out.println(img);
        } catch (Exception e) {
            e.printStackTrace();
        }
}

e. ImgPixelWrapper

实现图片灰度化、像素化、字符图、位图转矢量图等基本功能

// 位图转矢量图输出
@Test
public void testSvg() throws Exception {
    String file = "http://pic.dphydh.com/pic/newspic/2017-12-13/505831-1.png";
//        String file = "https://c-ssl.duitang.com/uploads/item/202003/29/20200329043918_2FUvk.thumb.400_0.gif";
    ImgPixelWrapper.build()
            .setSourceImg(file)
            .setBlockSize(3)
            .setRate(0.6)
            .setPixelType(PixelStyleEnum.CHAR_BLACK)
            .build()
            .asSvgFile(prefix + "/out.svg");
}

f. WaterMarkRemoveWrapper

三种移除水印的姿势

WaterMarkRemoveTypeEnum.FILL：使用给定的颜色，填充水印区域
WaterMarkRemoveTypeEnum.PIXEL: 将水印区域通过马赛克的方式进行模糊化
WaterMarkRemoveTypeEnum.BG：基于水印区周边背景色，来填充水印区域

本功能服务于：https://tool.hhui.top/tools/image/rmwater/，欢迎尝鲜

@Test
public void testRemove() throws IOException {
    String url = "https://mmbiz.qpic.cn/mmbiz_png/dYV9cAW65kYJ2uVS43GPVqNQcAtJqVCWhBmISJXF9KpNib7zicjIX7VFYnNccafC7LomzqIZKQe4A54RNicic9HTvw/640?wx_fmt=png&wxfrom=5&wx_lazy=1&wx_co=1";

    BufferedImage img = WaterMarkRemoveWrapper.of(url)
            .setType(WaterMarkRemoveTypeEnum.FILL.getType())
            .setWaterMarkH(47)
            .setWaterMarkW(189)
            .setWaterMarkX(782)
            .setWaterMarkY(352)
            .setFillColor("0xff557ec6")
            .build()
            .asImage();
    System.out.println("---");
}

@Test
public void testRemove2() throws IOException {
    String url = "https://mmbiz.qpic.cn/mmbiz_png/dYV9cAW65kYJ2uVS43GPVqNQcAtJqVCWhBmISJXF9KpNib7zicjIX7VFYnNccafC7LomzqIZKQe4A54RNicic9HTvw/640?wx_fmt=png&wxfrom=5&wx_lazy=1&wx_co=1";

    BufferedImage img = WaterMarkRemoveWrapper.of(url)
            .setType(WaterMarkRemoveTypeEnum.PIXEL.getType())
            .setWaterMarkH(47)
            .setWaterMarkW(189)
            .setWaterMarkX(782)
            .setWaterMarkY(352)
            .setPixelSize(8)
            .build()
            .asImage();
    System.out.println("---");
}

@Test
public void testRemove3() throws IOException {
    String url = "https://mmbiz.qpic.cn/mmbiz_png/dYV9cAW65kYJ2uVS43GPVqNQcAtJqVCWhBmISJXF9KpNib7zicjIX7VFYnNccafC7LomzqIZKQe4A54RNicic9HTvw/640?wx_fmt=png&wxfrom=5&wx_lazy=1&wx_co=1";

    BufferedImage img = WaterMarkRemoveWrapper.of(url)
            .setType(WaterMarkRemoveTypeEnum.BG.getType())
            .setWaterMarkH(47)
            .setWaterMarkW(189)
            .setWaterMarkX(782)
            .setWaterMarkY(352)
            .setUpDownRate(0.2F)
            .setDownRange(0.2f)
            .build()
            .asImage();
    System.out.println("---");
}

尚晓东 / quick-media

image-plugin

1. 依赖

2. 使用说明

a. ImgCreateWrapper

b. LineGifCreateWrapper

c. WordGifCreateWrapper

d. ImgMergeWrapper

e. WaterMarkWrapper

e. ImgPixelWrapper

f. WaterMarkRemoveWrapper

简介

发行版

贡献者

近期动态

尚晓东 / quick-media .gitee-modal { width: 500px !important; }

image-plugin

1. 依赖

2. 使用说明

a. ImgCreateWrapper

b. LineGifCreateWrapper

c. WordGifCreateWrapper

d. ImgMergeWrapper

e. WaterMarkWrapper

e. ImgPixelWrapper

f. WaterMarkRemoveWrapper

简介

发行版

贡献者

近期动态

搜索帮助

尚晓东 / quick-media