本文将列举一些示例，以便开发者可以快速了解 imglib 的功能并且轻松使用他们，所有的这些示例都可以在 example/.../Setting.java中找到，并且您可以运行 example 模块来执行相应的功能。

图像收集

创建一张透明图像

ImagePipes.ofEmptySource()
        .register(new TransparentImageGenerator.Builder()
             .width(300)
             .height(200)
             .build())
        .toFile(ExampleUtils.tmpFileNameOf("out/transparent.png"));

在本例中，将创建一张宽高为 300px * 200px ，背景透明的图像，并将其保存到.../out/transparent.png文件中。

创建一张纯色图像

ImagePipes.ofEmptySource()
        .register(new MonoColorImageGenerator.Builder()
            .width(300)
            .height(200)
            .alpha(0.2f)
            .color(ColorUtils.random())
            .build())
        .toFile(ExampleUtils.tmpFileNameOf("out/mono_color.png"));

在本例中，将创建一张宽高为 300px * 200px ，透明度为 0.2（透明度在 [0, 1] 之间取值，等于 0 时图像完全透明，等于 1 时图像完全不透明），背景颜色随机的图像，并将其保存到.../out/mono_color.png文件中。

截取一张屏幕快照

ImagePipes.ofEmptySource()
        .register(new ScreenshotGenerator.Builder()
            .startPoint(600, 300)
            .width(280)
            .height(190)
            .build())
        .toFile(ExampleUtils.tmpFileNameOf("out/screenshot.png"));

在本例中，将截取一张屏幕快照，截取的区域指定为左上角坐标为[600, 300], 宽度为 280px，高度为 190px，截取的快照将被保存到 .../out/screenshot.png文件中。

创建一张 HASH 图像

ImagePipes.ofEmptySource()
        .register(new HashImageGenerator.Builder("imglib-user")
            .gridVerticalNum(5)
            .fgColor(ColorUtils.of(50, 150, 50))
            .build())
        .toFile(ExampleUtils.tmpFileNameOf("out/hash.png"));

在本例中，将创建宽高为 5px * 5px 的二维矩阵，在矩阵中如果对应位置的像素点取值为 TRUE，则该像素点的前景色设置为[(R) 50,(G) 150,(B) 50]，该点阵图像将被保存到.../out/hash.png文件中。

由于生成的 HASH 图像像素点仅有 25 个像素点，为方便演示，上面的示意图并非out/hash.png，而是将其放大后得到的图像。

提取图像自 PDF 页

ImagePipes.ofPdf(ExampleUtils.tmpFileNameOf("in/jvms8.pdf"))
        .register(0)
        .dpi(280)
        .toFile(ExampleUtils.tmpFileNameOf("out/page_1_of_jvms8.jpg"));

在本例中，将解析指定的 PDF 文件.../in/jvms8.pdf，提取索引为 0 的页为图像，提取图像时指定 DPI（每英寸内像素点数）为 280，并将该图像保存到.../out/page_1_of_jvms8.jpg文件中。

提取图像自 GIF 帧

ImagePipes.ofGif(ExampleUtils.tmpFileNameOf("in/duck.gif"))
        .registerAll()
        .toFiles(ExampleUtils.tmpFileNameOf("out/gif/frame_1.jpg"),
            ExampleUtils.tmpFileNameOf("out/gif/frame_2.jpg"),
            ExampleUtils.tmpFileNameOf("out/gif/frame_3.jpg"),
            ExampleUtils.tmpFileNameOf("out/gif/frame_4.jpg"),
            ExampleUtils.tmpFileNameOf("out/gif/frame_5.jpg"));

在本例中，将解析指定的 GIF 文件.../in/duck.gif，提取该文件的所有帧为图像列表，并将这些图像按照帧的顺序逐个保存到.../out/gif/文件目录中。

原始 GIF 文件	提取的图像列表

聚合与分裂

网格化拆分图像

ImagePipes.of(ExampleUtils.tmpFileNameOf("in/panda.jpg"))
        .addFilter(new GridSplitHandler.Builder()
            .gridWidth(400)
            .gridHeight(250)
            .build())
        .toFiles(ExampleUtils.tmpFileNameOf("out/split/slice_1.jpg"),
            ExampleUtils.tmpFileNameOf("out/split/slice_2.jpg"),
            ExampleUtils.tmpFileNameOf("out/split/slice_3.jpg"),
            ExampleUtils.tmpFileNameOf("out/split/slice_4.jpg"),
            ExampleUtils.tmpFileNameOf("out/split/slice_5.jpg"),
            ExampleUtils.tmpFileNameOf("out/split/slice_6.jpg"),
            ExampleUtils.tmpFileNameOf("out/split/slice_7.jpg"),
            ExampleUtils.tmpFileNameOf("out/split/slice_8.jpg"),
            ExampleUtils.tmpFileNameOf("out/split/slice_9.jpg"));

在本例中，将使用宽高为 400px * 250px 的矩形区域逐行自左往右从原始图像中提取图像，直至该矩形已触碰到（或者已包含）图像边界，并将提取的图像按照顺序保存到.../out/split/文件目录中。

原始图像	拆分后的图像列表

网格化合并图像

ImagePipes.of(ExampleUtils.tmpFileNameOf("in/to_merge/spring.jpg"),
            ExampleUtils.tmpFileNameOf("in/to_merge/summer.jpg"),
            ExampleUtils.tmpFileNameOf("in/to_merge/winter.jpg"),
            ExampleUtils.tmpFileNameOf("in/to_merge/autumn.jpg"))
        .addFilter(new GridMergeHandler.Builder()
            .horizontalNum(2)
            .fillColor(ColorUtils.of(240, 240, 240))
            .gridWidth(530)
            .gridHeight(530)
            .autoAdapts()
            .alignCenter()
            .build())
        .toFile(ExampleUtils.tmpFileNameOf("out/after_merge.jpg"));

在本例中，将从.../in/to_merge/文件目录中加载spring.jpg summer.jpg winter.jpg autumn.jpg四幅图像，并将这些图像按照顺序拼接在一幅图像内，拼接的规则如下：

使用固定宽高为 530px * 530px 的网格盛放每幅图像；
开启网格自动调整，当网格不足以容纳某幅图像时，重置网格的大小到足以容纳；
设置图像居中摆放，包括水平居中和垂直居中；
每一行摆放的网格设置为 2 个；
如某个图像不能铺满整个网格区域，则空白部分使用颜色[(R) 240,(G) 240,(B) 240]填充；

拼接的图像将被保存到.../out/after_merge.jpg文件中。

原始图像列表	拼接后的图像

将图像保存为 GIF 文件

ImagePipes.of(ExampleUtils.tmpFileNameOf("in/to_merge/spring.jpg"),
            ExampleUtils.tmpFileNameOf("in/to_merge/summer.jpg"),
            ExampleUtils.tmpFileNameOf("in/to_merge/winter.jpg"),
            ExampleUtils.tmpFileNameOf("in/to_merge/autumn.jpg"))
        .toFile(new GifFileEncoder.Builder()
            .filename(ExampleUtils.tmpFileNameOf("out/seasons.gif"))
            .delay(400)
            .repeat(0)
            .build());

在本例中，将从.../in/to_merge/文件目录中加载spring.jpg summer.jpg winter.jpg autumn.jpg四幅图像，并将这些图像编码到.../out/seasons.gif文件中，该 GIF 格式的文件每隔 400ms 切换下一帧，并且已设定为重复播放模式。

原始图像列表	合成后的 GIF 文件

图像处理

尽管 Thumbnailator 主要用于处理缩略图，但其仍然为我们提供了基础的图像处理能力，包括有尺寸缩放、比例缩放、区域裁剪、旋转和添加水印等等。 Imglib 在 Thumbnailator 的基础之上扩展了一系列新的图像处理能力，所有新功能都实现了ImageFilter接口，可通过 Thumbnails.Builder#addFilter(ImageFilter)、Thumbnails.Builder#addFilters(List<ImageFilter>)方式使用。

添加边框

Thumbnails.of(ExampleUtils.tmpFileNameOf("in/panda.jpg"))
        .addFilter(new BorderHandler.Builder()
            .vMargins(30)
            .hMargins(20)
            .fillColor(ColorUtils.of(240, 230, 175))
            .build())
        .scale(1.0)
        .toFile(ExampleUtils.tmpFileNameOf("out/bordered.jpg"));

在本例中，将为.../in/panda.jpg图像添加一个边框，该边框在水平方向的边距为 20 px，垂直方向的边距为 30 px，处理后的图像将被保存到 .../out/bordered.jpg文件中。

原始图像	添加边框后图像

图像马赛克

Thumbnails.of(ExampleUtils.tmpFileNameOf("in/panda.jpg"))
        .addFilter(new MosaicHandler.Builder()
            .height(160)
            .width(180)
            .startX(480)
            .startY(260)
            .sideLength(10)
            .build())
        .scale(1.0)
        .toFile(ExampleUtils.tmpFileNameOf("out/after_mosaic.jpg"));

在本例中，将为.../in/panda.jpg图像的部分区域马赛克化，区域的左上角坐标是[480, 260]，宽高分别为 180px 和 160px，每一个马赛克方块的边长固定为 10 px，处理后的图像将被保存到.../out/after_mosaic.jpg文件中。

原始图像	马赛克后图像

图像圆角化

Thumbnails.of(ExampleUtils.tmpFileNameOf("in/panda.jpg"))
        .addFilter(new RoundRectHandler.Builder()
            .arcWidth(100)
            .arcHeight(100)
            .build())
        .scale(1.0)
        .toFile(ExampleUtils.tmpFileNameOf("out/rounded.png"));

在本例中，将改变原始图像.../in/panda.jpg的四个角为圆角，角圆弧的水平直径和垂直直径均为 100px，处理后的图像将被保存到 .../out/rounded.png文件中。值得注意的是，圆角化后的图像在保存时必须指定为 PNG 格式，否则将看不出任何效果。

原始图像	圆角化后图像

无损放大图像尺寸

Thumbnails.of(ExampleUtils.tmpFileNameOf("in/chaotic_points.png"))
        .addFilter(new HighQualityExpandHandler.Builder()
            .finalWidth(300)
            .keepAspectRatio(true)
            .build())
        .scale(1.0)
        .toFile(ExampleUtils.tmpFileNameOf("out/expanded.png"));

尽管 Thumbnailator 已经提供重置图像尺寸的功能，但其在将图像扩大后通常会变得模糊不清，这是因为图像质量的损失。当我们需要对图像进行无损放大时，可使用HighQualityExpandHandler实现。

在本例中，原始图像.../in/chaotic_points.png的尺寸为 100px * 60px，在经过处理后，我们将得到一幅 300px * 180px 的图像，并将其保存在 .../out/expanded.png文件中。通常情况下，我们只需要指定一个最终的宽度（或者最终的高度），并设置为保持长宽比例，这样就能得到相较于原始图像等比放大的图像。

原始图像	放大后图像

size:100px * 60px	size:300px * 180px

图像灰度化

Thumbnails.of(ExampleUtils.tmpFileNameOf("in/panda.jpg"))
        .addFilter(new ModeAdaptor(
            new WeightGrayingStrategy.Builder()
                .redWeight(0.3f)
                .greenWeight(0.59f)
                .build()))
        .scale(1.0)
        .toFile(ExampleUtils.tmpFileNameOf("out/grayed.jpg"));

在本例中，原始图像.../in/panda.jpg将被进行灰度化处理，采用的策略为按权重灰度化，红色分量占比 30%，绿色分量占比 59%，蓝色分量则占比 11%，灰度化完成后的图像将被保存到.../out/grayed.jpg文件中。假定任一像素点的原始 RGB 值为[r', g', b']，则灰度值的计算公式为 val = (r' * 0.3 + g' * 0.59 + b' * 0.11)，该像素点的最终 RGB 值为[val, val, val]。

除按权重灰度化策略之外，imglib 还提供了平均值灰度化策略AvgGrayingStrategy、最大值灰度化策略MaxGrayingStrategy、最小值灰度化策略 MinGrayingStrategy和固定分量灰度化策略FixedGrayingStrategy，并且，开发者可继承AbstractGrayingStrategy来扩展自定义的灰度化实现。

原始图像	灰度化后图像

图像二值化

AbstractGrayingStrategy strategy = new FixedGrayingStrategy(FixedGrayingStrategy.FixedOption.R);
Thumbnails.of(ExampleUtils.tmpFileNameOf("in/panda.jpg"))
        .addFilter(new ModeAdaptor(
            new SimpleBinaryStrategy.Builder()
                .grayingStrategy(strategy)
                .threshold(120)
                .build()))
        .scale(1.0)
        .toFile(ExampleUtils.tmpFileNameOf("out/binary.jpg"));

在本例中，原始图像.../in/panda.jpg将被进行二值化处理，采用的灰度化策略为固定分量（R）灰度化策略，二值化策略为简单策略，该策略要求设定阈值 threshold，当灰度值大于该阈值时，该像素点的各个分量都将置为 255，否则将被置为 0。

除简单二值化策略之外，开发者可继承AbstractBinaryStrategy来扩展自定义的二值化实现。

原始图像	二值化后图像

绘制开口形状

Thumbnails.of(ExampleUtils.tmpFileNameOf("in/panda.jpg"))
        .addFilter(new ShapeAdaptor(
            new Line.Builder()
                .start(new Point(200, 260))
                .end(new Point(1000, 260))
                .color(ColorUtils.random())
                .stroke(new BasicStroke(6))
                .build()))
        .scale(1.0)
        .toFile(ExampleUtils.tmpFileNameOf("out/painted_line.jpg"));

在本例中，将在原始图像/in/panda.jpg上绘制一条直线，该直线的起点和终点分别为[200, 260]、[1000, 260]，线条颜色随机，笔刷粗细设定为 6px，处理完成后的图像将被保存到.../out/painted_line.jpg文件中。

针对于开口形状的扩展，开发者可通过继承AbstractOpenedShape实现。

原始图像	添加开口形状后图像

绘制闭合形状

Thumbnails.of(ExampleUtils.tmpFileNameOf("in/panda.jpg"))
        .addFilter(new ShapeAdaptor(
            new Oval.Builder()
                .fill(true)
                .color(ColorUtils.random())
                .rect(new Rectangle(220, 110, 680, 350))
                .build()))
        .scale(1.0)
        .toFile(ExampleUtils.tmpFileNameOf("out/fill_oval.jpg"));

在本例中，将在原始图像/in/panda.jpg上绘制一个椭圆形状，该椭圆的外切矩形左上角坐标为[220, 110]、外切矩形的长宽分别为 680px 和 350px，并且设定为使用随机颜色填充该椭圆内部，处理完成后的图像将被保存到.../out/fill_oval.jpg文件中。

对于一个封闭形状而言，绘制时有两种模式，其一是填充内部，另一种是仅绘制边框，如果开发者希望绘制形状的边框，还应指定一个笔刷Stroke对象。除椭圆外，imglib 还提供了矩形Rect的实现，开发者还可通过继承AbstractClosedShape扩展其他的封闭形状。

原始图像	添加闭合形状后图像

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Examples.md

Examples.md

图像收集

创建一张透明图像

创建一张纯色图像

截取一张屏幕快照

创建一张 HASH 图像

提取图像自 PDF 页

提取图像自 GIF 帧

聚合与分裂

网格化拆分图像

网格化合并图像

将图像保存为 GIF 文件

图像处理

添加边框

图像马赛克

图像圆角化

无损放大图像尺寸

图像灰度化

图像二值化

绘制开口形状

绘制闭合形状

Files

Examples.md

Latest commit

History

Examples.md

File metadata and controls

图像收集

创建一张透明图像

创建一张纯色图像

截取一张屏幕快照

创建一张 HASH 图像

提取图像自 PDF 页

提取图像自 GIF 帧

聚合与分裂

网格化拆分图像

网格化合并图像

将图像保存为 GIF 文件

图像处理

添加边框

图像马赛克

图像圆角化

无损放大图像尺寸

图像灰度化

图像二值化

绘制开口形状

绘制闭合形状