Java 中将 Word 转换为图像的完整工作示例

// Load the input Word document
com.aspose.words.Document doc = new com.aspose.words.Document("Words.docx");

// Initialize an object of ImageSaveOptions class
com.aspose.words.ImageSaveOptions options = new com.aspose.words.ImageSaveOptions(com.aspose.words.SaveFormat.JPEG);

// Set the "PageSet" to "0" to convert only the first page of a document.
options.setPageSet(new com.aspose.words.PageSet(0));

// Set the image's brightness and contrast.
options.setImageBrightness(0.3f);
options.setImageContrast(0.7f);

// Set the horizontal resolution.
options.setHorizontalResolution(72f);

// Save output JPG image
doc.save("Word-to-JPG.jpg", options);

注意： 此代码示例演示了核心功能。在将其用于项目之前，请确保更新文件路径（Words.docx、Word-to-JPG.jpg），验证所有必需的依赖项已正确安装，并在开发环境中彻底测试。如果遇到任何问题，请参阅官方文档或联系支持团队获取帮助。

了解在 Java 代码中将 Word 转换为图像

演示遵循清晰的顺序：

1. 加载输入的 Word 文档 - new com.aspose.words.Document("Words.docx") 将 DOCX 文件加载到内存中。

   com.aspose.words.Document doc = new com.aspose.words.Document("Words.docx");
   

   Document 类是加载和操作 Word 文件的入口点（API 参考）。

2. 创建 ImageSaveOptions 实例 - 将 SaveFormat.JPEG 传递给构造函数，以便文档渲染为 JPG 图像。

   com.aspose.words.ImageSaveOptions options = new com.aspose.words.ImageSaveOptions(com.aspose.words.SaveFormat.JPEG);
   

3. 限制页面范围 - setPageSet(new PageSet(0)) 告诉转换器仅渲染第一页（页面索引从零开始）。

   options.setPageSet(new com.aspose.words.PageSet(0));
   

4. 调整亮度、对比度和分辨率 - 微调输出图像的外观。

options.setImageBrightness(0.3f);
options.setImageContrast(0.7f);
options.setHorizontalResolution(72f);

5. 保存输出图像 - doc.save("Word-to-JPG.jpg", options) 使用配置的选项渲染文档并将 JPG 文件写入磁盘。

doc.save("Word-to-JPG.jpg", options);

Word 转图像转换 - 前提条件和设置

要开始使用 Conholdate.Total for Java，请将 Maven 仓库和依赖项添加到您的 pom.xml 中：

<repositories>
    <repository>
        <id>conholdate-repo</id>
        <name>Conholdate Maven Repository</name>
        <url>https://repository.conholdate.com/repo/</url>
    </repository>
</repositories>

<dependency>
    <groupId>com.conholdate</groupId>
    <artifactId>conholdate-total</artifactId>
    <version>24.9</version>
    <type>pom</type>
</dependency>

从下载页面下载最新的 SDK 二进制文件。该库需要 Java 8 或更高版本，并可在任何标准 JVM 上运行。无需额外的 Office 组件。

微调转换：选项和设置

您可以调整 ImageSaveOptions 上的多个属性，以符合您的输出要求：

• Image format - 传递所需的格式，例如 JPEG、PNG 或 BMP，到 ImageSaveOptions 构造函数，通过 SaveFormat 枚举。

  com.aspose.words.ImageSaveOptions options = new com.aspose.words.ImageSaveOptions(com.aspose.words.SaveFormat.JPEG);
  

• 页面范围 - setPageSet 控制渲染哪些页面。传入单个从零开始的索引以渲染单页，或传入范围以渲染多页。

  options.setPageSet(new com.aspose.words.PageSet(0));
  

• 亮度和对比度 - 值范围从 0.0 到 1.0；0.5 是默认（未更改）的水平。

options.setImageBrightness(0.3f);
options.setImageContrast(0.7f);

• 分辨率 (DPI) - setHorizontalResolution（以及相应的 setVerticalResolution）控制输出图像的像素密度；更高的值会在文件大小的代价下提供更清晰的图像。

options.setHorizontalResolution(72f);

这些设置已在 API reference 中记录。

转换多个页面

上面的示例仅渲染文档的第一页。要将每页导出为单独的图像，请遍历文档的页数并在每次迭代中更新 PageSet：

com.aspose.words.Document doc = new com.aspose.words.Document("Words.docx");
com.aspose.words.ImageSaveOptions options = new com.aspose.words.ImageSaveOptions(com.aspose.words.SaveFormat.JPEG);
options.setImageBrightness(0.3f);
options.setImageContrast(0.7f);
options.setHorizontalResolution(72f);

int pageCount = doc.getPageCount();
for (int page = 0; page < pageCount; page++) {
    options.setPageSet(new com.aspose.words.PageSet(page));
    doc.save(String.format("Word-to-JPG-page_%d.jpg", page + 1), options);
}

在循环中重复使用相同的 Document 和 ImageSaveOptions 实例可以保持内存使用低，并避免为每页重新加载文件的开销。

高质量图像输出的实用技巧

• 重用相同的 ImageSaveOptions 实例，用于所有页面，以避免不必要的对象创建。
• 以流式方式处理文件（例如，使用 InputStream），以在处理大文档时保持低内存使用。
• 选择合适的分辨率：72 DPI 对于网页预览已足够，而 300 DPI 推荐用于打印质量输出。
• 保守地调节亮度和对比度——小幅度调整（相对于默认 0.5 的 ±0.1–0.2）通常比极端值更能保持可读性。
• 在转换前验证输出路径，以防止 IOException 并确保目标目录存在。

结论

Conholdate.Total for Java 使在 Java 中将 Word 转换为图像变得简单，能够在服务器上无需 Microsoft Office 即生成高保真 JPG 页面。按照上述步骤，您可以将文档转图像转换集成到任何 Java 应用程序中，微调亮度、对比度和分辨率，并保持资源消耗在可控范围内。对于生产部署，您需要商业许可证；定价详情请参阅定价页面，临时许可证可从临时许可证页面获取。

常见问题

当文档包含多页时，如何在 Java 中将 Word 转换为图像？
遍历 doc.getPageCount()，在每次迭代中更新 options.setPageSet(new PageSet(page))，为每页保存一个单独的图像文件，如上面Converting Multiple Pages章节所示。

是否可以直接将 Word 转换为 PNG 而不是 JPEG？
是的。在构造 ImageSaveOptions 时，将 com.aspose.words.SaveFormat.JPEG 更改为 com.aspose.words.SaveFormat.PNG。

在转换过程中，我能保留原始布局和字体吗？
SDK 默认嵌入原始的布局、颜色和字体。如果需要嵌入自定义字体，请确保这些字体在服务器上可用（参阅文档）。

我应该为商业项目选择哪种授权模式？
从定价页面购买永久或订阅许可证。通过临时许可证页面可获取用于评估的临时许可证。

阅读更多

• 在 Java 中将图像转换为灰度
• 在 Java 中将 Word 转换为 PDF
• 在 Java 中将 CDR 转换为 PNG