一行代码搞定图片缩放、旋转、加水印

CharlotteNS 3年前
   <h2>概述</h2>    <p>Thumbnailator 是一个开源的 <strong>Java</strong> 项目,它提供了非常简单的 API 来对图片进行缩放、旋转以及加水印的处理。</p>    <p>有多简单呢?简单到一行代码就可以完成图片处理。形式如下:</p>    <pre>  <code class="language-java">Thumbnails.of(new File("path/to/directory").listFiles())      .size(640, 480)      .outputFormat("jpg")      .toFiles(Rename.PREFIX_DOT_THUMBNAIL);</code></pre>    <p>当然,Thumbnailator 还有一些使用细节,下面我会一一道来。</p>    <h2>核心 API</h2>    <h2>Thumbnails</h2>    <p>Thumbnails 是使用 Thumbnailator 创建缩略图的主入口。</p>    <p>它提供了一组初始化 Thumbnails.Builder 的接口。</p>    <p>先看下这组接口的声明:</p>    <pre>  <code class="language-java">// 可变长度参数列表  public static Builder<File> of(String... files) {...}  public static Builder<File> of(File... files) {...}  public static Builder<URL> of(URL... urls) {...}  public static Builder<? extends InputStream> of(InputStream... inputStreams) {...}  public static Builder<BufferedImage> of(BufferedImage... images) {...}  // 迭代器(所有实现 Iterable 接口的 Java 对象都可以,当然也包括 List、Set)  public static Builder<File> fromFilenames(Iterable<String> files) {...}  public static Builder<File> fromFiles(Iterable<File> files) {...}  public static Builder<URL> fromURLs(Iterable<URL> urls) {...}  public static Builder<InputStream> fromInputStreams(Iterable<? extends InputStream> inputStreams) {...}  public static Builder<BufferedImage> fromImages(Iterable<BufferedImage> images) {...}</code></pre>    <p>很显然, Thumbnails 允许通过传入文件名、文件、网络图的URL、图片流、图片缓存多种方式来初始化构造器 。</p>    <p>因此,你可以根据实际需求来灵活的选择图片的输入方式。</p>    <p>需要注意一点: 如果输入是多个对象(无论你是直接输入容器对象或使用可变参数方式传入多个对象),则输出也必须选用输出多个对象的方式,否则会报异常。</p>    <h2>Thumbnails.Builder</h2>    <p>Thumbnails.Builder 是 Thumbnails 的内部静态类。它用于设置生成缩略图任务的相关参数。</p>    <p>注: Thumbnails.Builder 的构造函数是私有函数。所以,它只允许通过 Thumbnails 的实例化函数来进行初始化。</p>    <h3>设置参数的函数</h3>    <p>Thumbnails.Builder 提供了一组函数链形式的接口来设置缩放图参数。</p>    <p>以设置大小函数为例:</p>    <pre>  <code class="language-java">public Builder<T> size(int width, int height)  {      updateStatus(Properties.SIZE, Status.ALREADY_SET);      updateStatus(Properties.SCALE, Status.CANNOT_SET);            validateDimensions(width, height);      this.width = width;      this.height = height;            return this;  }</code></pre>    <p>通过返回this指针,使得设置参数函数可以以链式调用的方式来使用,形式如下:</p>    <pre>  <code class="language-java">Thumbnails.of(new File("original.jpg"))          .size(160, 160)          .rotate(90)          .watermark(Positions.BOTTOM_RIGHT, ImageIO.read(new File("watermark.png")), 0.5f)          .outputQuality(0.8)          .toFile(new File("image-with-watermark.jpg"));</code></pre>    <p>好处,不言自明:那就是大大简化了代码。</p>    <h3>输出函数</h3>    <p>Thumbnails.Builder 提供了一组重载函数来输出生成的缩放图。</p>    <p>函数声明如下:</p>    <pre>  <code class="language-java">// 返回图片缓存  public List<BufferedImage> asBufferedImages() throws IOException {...}  public BufferedImage asBufferedImage() throws IOException {...}  // 返回文件列表  public List<File> asFiles(Iterable<File> iterable) throws IOException {...}  public List<File> asFiles(Rename rename) throws IOException {...}  public List<File> asFiles(File destinationDir, Rename rename) throws IOException {...}  // 创建文件  public void toFile(File outFile) throws IOException {...}  public void toFile(String outFilepath) throws IOException {...}  public void toFiles(Iterable<File> iterable) throws IOException {...}  public void toFiles(Rename rename) throws IOException {...}  public void toFiles(File destinationDir, Rename rename) throws IOException {...}  // 创建输出流  public void toOutputStream(OutputStream os) throws IOException {...}  public void toOutputStreams(Iterable<? extends OutputStream> iterable) throws IOException {...}</code></pre>    <h2>工作流</h2>    <p>Thumbnailator 的工作步骤十分简单,可分为三步:</p>    <ol>     <li> <p>输入: Thumbnails 根据输入初始化构造器—— Thumbnails.Builder 。</p> </li>     <li> <p>设置: Thumbnails.Builder 设置缩放图片的参数。</p> </li>     <li> <p>输出: Thumbnails.Builder 输出图片文件或图片流。</p> </li>    </ol>    <h2>实战</h2>    <p>前文介绍了 Thumbnailator 的核心 API,接下来我们就可以通过实战来看看 Thumbnailator 究竟可以做些什么。</p>    <p>Thumbnailator 生成什么样的图片,是根据设置参数来决定的。</p>    <h2>安装</h2>    <p>maven项目中引入依赖:</p>    <pre>  <code class="language-java"><dependency>    <groupId>net.coobird</groupId>    <artifactId>thumbnailator</artifactId>    <version>[0.4, 0.5)</version>  </dependency></code></pre>    <h2>图片缩放</h2>    <p>Thumbnails.Builder 的 size 函数可以设置新图片精确的宽度和高度,也可以用 scale 函数设置缩放比例。</p>    <pre>  <code class="language-java">Thumbnails.of("oldFile.png")          .size(16, 16)          .toFile("newFile_16_16.png");    Thumbnails.of("oldFile.png")          .scale(2.0)          .toFile("newFile_scale_2.0.png");    Thumbnails.of("oldFile.png")          .scale(1.0, 0.5)          .toFile("newFile_scale_1.0_0.5.png");</code></pre>    <p>oldFile.png</p>    <p style="text-align:center"><img src="https://simg.open-open.com/show/5f30b70a781dc468587f34bd207fe981.png"></p>    <p style="text-align:center">newFile_scale_1.0_0.5.png</p>    <p style="text-align:center"><img src="https://simg.open-open.com/show/644018c97361c00de7d04ec510b9fc44.png"></p>    <h2>图片旋转</h2>    <p>Thumbnails.Builder 的 size 函数可以设置新图片的旋转角度。</p>    <pre>  <code class="language-java">Thumbnails.of("oldFile.png")          .scale(0.8)          .rotate(90)          .toFile("newFile_rotate_90.png");    Thumbnails.of("oldFile.png")          .scale(0.8)          .rotate(180)          .toFile("newFile_rotate_180.png");</code></pre>    <p style="text-align:center">newFile_rotate_90.png</p>    <p style="text-align:center"><img src="https://simg.open-open.com/show/ab5cd407d38f204dfd294496f1d1fffb.png"></p>    <h2>加水印</h2>    <p>Thumbnails.Builder 的 watermark 函数可以为图片添加水印图片。第一个参数是水印的位置;第二个参数是水印图片的缓存数据;第三个参数是透明度。</p>    <pre>  <code class="language-java">BufferedImage watermarkImage = ImageIO.read(new File("wartermarkFile.png"));  Thumbnails.of("oldFile.png")          .scale(0.8)          .watermark(Positions.BOTTOM_LEFT, watermarkImage, 0.5f)          .toFile("newFile_watermark.png");</code></pre>    <p style="text-align:center">wartermarkFile.png</p>    <p style="text-align:center"><img src="https://simg.open-open.com/show/03619f75494a0bd6d69c5c1e59e18c41.gif"></p>    <p style="text-align:center">newFile_watermark.png</p>    <p style="text-align:center"><img src="https://simg.open-open.com/show/220af5a8d232a46ec6b3605fe16da035.png"></p>    <h2>批量处理图片</h2>    <p>下面以批量给图片加水印来展示一下如何处理多个图片文件。</p>    <pre>  <code class="language-java">BufferedImage watermarkImage = ImageIO.read(new File("wartermarkFile.png"));    File destinationDir = new File("D:\\watermark\\");  Thumbnails.of("oldFile.png", "oldFile2.png")          .scale(0.8)          .watermark(Positions.BOTTOM_LEFT, watermarkImage, 0.5f)          .toFiles(destinationDir, Rename.PREFIX_DOT_THUMBNAIL);</code></pre>    <p> </p>    <h2>参考</h2>    <p><a href="/misc/goto?guid=4959735291911060145" rel="nofollow,noindex">Thumbnailator 官方示例文档</a></p>    <p> </p>    <p>来自:http://www.cnblogs.com/jingmoxukong/p/6293877.html</p>    <p> </p>