如何在 Java 中使用 GroupDocs.Viewer 轉換 OBJ 為 HTML、JPG、PNG 與 PDF

將 3D OBJ 模型轉換為適合網頁或列印的格式是建築師、電商平台及 e‑learning 內容製作者的常見需求。在本教學中，您將了解 如何轉換 OBJ 檔案為 HTML、JPG、PNG 與 PDF，使用 GroupDocs.Viewer for Java——快速且可靠。

OBJ to HTML/JPG/PNG/PDF Conversion in Java with GroupDocs.Viewer for Java

快速解答

主要的函式庫是什麼？ GroupDocs.Viewer for Java (v25.2)
OBJ 可以匯出為哪些格式？ HTML、JPG、PNG 與 PDF
需要授權嗎？ 免費試用可用於開發；正式環境需購買永久授權
支援 Maven 嗎？ 支援——將 GroupDocs 的儲存庫與相依性加入 pom.xml
可以自訂影像品質嗎？ 可以，透過 JpgViewOptions 與 PngViewOptions

什麼是 OBJ 轉換以及為何需要它？

OBJ 是廣泛使用的 3D 幾何定義檔案格式。雖然在 CAD 與建模工具中功能強大，但無法直接在瀏覽器或列印文件中檢視。將 OBJ 轉換為 HTML 可提供互動式檢視器，而 JPG/PNG 則提供靜態快照，PDF 則可產生通用的可分享文件。這正是 如何渲染 OBJ 以因應多種傳遞渠道的方式。

前置條件

GroupDocs.Viewer 25.2（或更新版本）——提供轉換功能的函式庫。
Java 17+ 與 Maven 已安裝於開發機器上。
具備 Java 程式設計與 Maven 專案結構的基本認識。

設定 GroupDocs.Viewer for Java

Maven 安裝

將儲存庫與相依性加入您的 pom.xml，如以下範例所示：

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/viewer/java/</url>
   </repository>
</repositories>
<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-viewer</artifactId>
      <version>25.2</version>
   </dependency>
</dependencies>

取得授權

免費試用： 從 GroupDocs 官方網站下載免費試用版。
臨時授權： 若需延長測試，可於此處取得臨時授權。
購買授權： 建議透過此連結購買完整授權，以取得完整功能。

基本初始化

開始渲染時，您需要：

匯入必要的類別（Viewer、檢視選項類別等）。
建立指向 OBJ 檔案的 Viewer 實例。
選擇適當的檢視選項（HTML、JPG、PNG 或 PDF）。

此基礎讓您 如何轉換 OBJ 為任何支援的格式。

實作指南

以下提供每種目標格式的逐步程式碼片段。程式碼區塊與原教學保持一致，原樣保留以確保相容性。

渲染 OBJ 為 HTML

如何渲染 OBJ 為互動式 HTML 頁面。

步驟說明

Path outputDirectory = Paths.get("YOUR_OUTPUT_DIRECTORY");
Path pageFilePathFormat = outputDirectory.resolve("obj_result.html");

建立 Viewer 實例

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_OBJ")) {
    // Code for rendering will go here
}

設定 HTML 檢視選項

HtmlViewOptions options = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);

渲染 OBJ 文件

viewer.view(options);

渲染 OBJ 為 JPG

如何渲染 OBJ 為高解析度 JPEG 影像。

步驟說明

Path outputDirectory = Paths.get("YOUR_OUTPUT_DIRECTORY");
Path pageFilePathFormat = outputDirectory.resolve("obj_result.jpg");

建立 Viewer 實例

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_OBJ")) {
    // Code for rendering will go here
}

設定 JPG 檢視選項

JpgViewOptions options = new JpgViewOptions(pageFilePathFormat);

渲染 OBJ 文件

viewer.view(options);

渲染 OBJ 為 PNG

如何渲染 OBJ 為支援透明度的 PNG。

步驟說明

Path outputDirectory = Paths.get("YOUR_OUTPUT_DIRECTORY");
Path pageFilePathFormat = outputDirectory.resolve("obj_result.png");

建立 Viewer 實例

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_OBJ")) {
    // Code for rendering will go here
}

設定 PNG 檢視選項

PngViewOptions options = new PngViewOptions(pageFilePathFormat);

渲染 OBJ 文件

viewer.view(options);

渲染 OBJ 為 PDF

如何渲染 OBJ 為可列印的 PDF 文件（常稱為 java convert 3d pdf）。

步驟說明

Path outputDirectory = Paths.get("YOUR_OUTPUT_DIRECTORY");
Path pageFilePathFormat = outputDirectory.resolve("obj_result.pdf");

建立 Viewer 實例

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_OBJ")) {
    // Code for rendering will go here
}

設定 PDF 檢視選項

PdfViewOptions options = new PdfViewOptions(pageFilePathFormat);

渲染 OBJ 文件

viewer.view(options);

實務應用

情境	為何要轉換 OBJ？	推薦輸出
建築可視化	與客戶分享互動式模型	HTML 或 PDF
線上產品目錄	在網頁上顯示靜態預覽	JPG / PNG
教學教材	在 e‑learning 模組中嵌入 3D 圖示	HTML 或 PDF
列印就緒文件	製作高品質列印頁面	PDF

效能考量與常見陷阱

記憶體管理： 大型 OBJ 檔案可能佔用大量堆積空間。請始終使用 try‑with‑resources 模式（如範例所示）即時關閉 Viewer。
品質設定： 對於 JPG/PNG，可透過 JpgViewOptions.setResolution(int) 或 PngViewOptions.setResolution(int) 調整解析度。
檔案路徑： 確保 OBJ 檔案路徑為絕對路徑或相對於專案根目錄正確解析；否則會拋出 FileNotFoundException。
授權錯誤： 若出現 “License not found” 例外，請再次確認授權檔案已放置於 classpath，且非試用時使用正式授權。

常見問答

Q: GroupDocs.Viewer for Java 支援哪些格式？
A: 它支援多種檔案類型，包括 HTML、JPG、PNG、PDF 等等。

Q: 如何排除 OBJ 檔案的渲染問題？
A: 核對 OBJ 檔案路徑，確保所有相依的 MTL 檔案皆存在，並確認 Maven 相依版本與已安裝的函式庫相符。

Q: GroupDocs.Viewer 能有效處理大型 OBJ 檔案嗎？
A: 可以，但需監控 JVM 記憶體使用情況，對於非常大的模型建議增大堆積大小 (-Xmx)。

Q: 渲染影像時能自訂輸出品質嗎？
A: 能，您可以在 JpgViewOptions 與 PngViewOptions 中調整影像解析度與壓縮等設定。

Q: 如何取得臨時授權？
A: 請於此處取得臨時授權。

最後更新： 2026-02-21
測試環境： GroupDocs.Viewer 25.2 for Java
作者： GroupDocs