/**
|
* 图片处理工具包
|
*
|
* <h2>主要功能</h2>
|
* <ul>
|
* <li>智能图片压缩（专为OCR优化）</li>
|
* <li>高质量图片缩放</li>
|
* <li>图片格式转换</li>
|
* </ul>
|
*
|
* <h2>使用示例</h2>
|
*
|
* <h3>1. OCR图片智能压缩（推荐）</h3>
|
* <pre>
|
* // 自动压缩到3MB以下，保证OCR识别准确率
|
* File compressedFile = ImageCompressUtil.compressForOCR(multipartFile);
|
*
|
* // 自定义大小限制
|
* File compressedFile = ImageCompressUtil.compressForOCR(multipartFile, 5 * 1024 * 1024); // 5MB
|
* </pre>
|
*
|
* <h3>2. 按尺寸压缩</h3>
|
* <pre>
|
* // 压缩到指定宽高
|
* File compressedFile = ImageCompressUtil.compress(multipartFile, 1920, 1080, 0.85f);
|
* </pre>
|
*
|
* <h3>3. 按比例压缩</h3>
|
* <pre>
|
* // 缩小到原来的50%
|
* File compressedFile = ImageCompressUtil.compressByScale(multipartFile, 0.5, 0.90f);
|
* </pre>
|
*
|
* <h3>4. 高质量图片缩放</h3>
|
* <pre>
|
* BufferedImage originalImage = ImageIO.read(file);
|
* BufferedImage resizedImage = ImageCompressUtil.resizeImageHighQuality(originalImage, 800, 600);
|
* </pre>
|
*
|
* <h3>5. 自定义质量压缩</h3>
|
* <pre>
|
* BufferedImage image = ImageIO.read(file);
|
* File compressed = ImageCompressUtil.compressWithQuality(image, "photo.jpg", 0.80f); // 80%质量
|
* </pre>
|
*
|
* <h2>压缩质量常量</h2>
|
* <ul>
|
* <li>{@code ImageCompressUtil.HIGH_QUALITY} - 0.90（高质量，推荐OCR使用）</li>
|
* <li>{@code ImageCompressUtil.MEDIUM_QUALITY} - 0.80（中等质量）</li>
|
* <li>{@code ImageCompressUtil.LOW_QUALITY} - 0.75（低质量）</li>
|
* </ul>
|
*
|
* <h2>注意事项</h2>
|
* <ul>
|
* <li>压缩后的文件保存在系统临时目录，使用完毕后需手动删除</li>
|
* <li>OCR压缩会保证最小边不小于1500px，确保文字清晰</li>
|
* <li>支持PNG、BMP、GIF等格式自动转为JPEG</li>
|
* </ul>
|
*
|
* @author ruoyi
|
* @since 2025-01-20
|
*/
|
package com.ruoyi.common.utils.image;
|
