GroupDocs Viewer OBJ 轉換為 HTML、JPG、PNG、PDF（Java）

在本完整教學中，您將學習 groupdocs viewer obj conversion —— 使用 GroupDocs.Viewer for Java 將 3D OBJ 模型轉換為可在網頁上顯示的 HTML 或圖像格式（JPG、PNG）以及可列印的 PDF 的過程。無論您是要打造建築展示、電子商務商品檢視器，或是 e‑learning 教材，以下步驟都會示範如何僅用幾行程式碼即可取得高品質的結果。

在 Java 中使用 GroupDocs.Viewer for Java 進行 OBJ 轉換為 HTML/JPG/PNG/PDF 在 Java 中使用 GroupDocs.Viewer for Java 進行 OBJ 轉換為 HTML/JPG/PNG/PDF

快速解答

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

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

OBJ 轉換會將 3D OBJ 模型轉換為瀏覽器或文件檢視器能夠顯示的格式，從而實現互動或可列印的呈現。OBJ 檔案適合用於 CAD 工具，但無法直接在網頁上檢視；將其轉換為 HTML 可提供互動檢視器，JPG/PNG 則提供靜態快照，PDF 則提供可普遍分享的文件。

前置條件

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

設定 GroupDocs.Viewer for Java

Maven 安裝

將儲存庫與相依性加入 pom.xml，請完全照以下範例操作：

<repositories>
    <repository>
        <id>groupdocs-repo</id>
        <url>https://releases.groupdocs.com/maven/</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-viewer</artifactId>
        <version>25.2</version>
    </dependency>
</dependencies>

取得授權

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

基本初始化

Viewer 類別是載入與渲染支援文件（包括 OBJ 檔案）的核心元件。要開始渲染，您需要：

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

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

如何在 Java 中執行 GroupDocs Viewer OBJ 轉換？

使用 new Viewer("model.obj") 載入 OBJ 檔案，選擇所需的檢視選項（例如 HtmlViewOptions.forEmbeddedResources(outputPath)），然後呼叫 viewer.view(options)。函式庫會自動處理網格解析、紋理映射與頁面產生，只需幾行程式碼即可產生可直接使用的 HTML、影像或 PDF 檔案。

渲染 OBJ 為 HTML

HtmlViewOptions 類別定義了 OBJ 模型如何匯出為互動式 HTML 頁面，支援嵌入資源與自訂設定。

  1. 設定輸出目錄
    確保您指定的資料夾已存在且具寫入權限。

repository.groupdocs.com GroupDocs Repository https://releases.groupdocs.com/viewer/java/ com.groupdocs groupdocs-viewer 25.2 ```

  1. 建立 Viewer 實例
    Viewer 類別載入 OBJ 檔案並準備渲染。

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


3. **設定 HTML 檢視選項**  
   `HtmlViewOptions.forEmbeddedResources(outputPath)` 會將所有資源（紋理、腳本）嵌入至輸出資料夾。  

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

  1. 渲染 OBJ 文件
    呼叫 viewer.view(htmlOptions) 以產生 HTML 表示。

HtmlViewOptions options = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);


### 渲染 OBJ 為 JPG

`JpgViewOptions` 類別讓您為 JPEG 輸出定義解析度、品質與背景顏色。

1. **設定輸出目錄**  

   ```java
viewer.view(options);

  1. 建立 Viewer 實例

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


3. **設定 JPG 檢視選項**  
   調整 `setResolution(int)` 與 `setQuality(int)` 以控制影像尺寸與壓縮。  

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

  1. 渲染 OBJ 文件

JpgViewOptions options = new JpgViewOptions(pageFilePathFormat);


### 渲染 OBJ 為 PNG

`PngViewOptions` 類別支援透明度與高解析度 PNG 產生。

1. **設定輸出目錄**  

   ```java
viewer.view(options);

  1. 建立 Viewer 實例

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


3. **設定 PNG 檢視選項**  
   使用 `setResolution(int)` 來控制 DPI，必要時使用 `setTransparentBackground(true)` 以設定透明背景。  

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

  1. 渲染 OBJ 文件

PngViewOptions options = new PngViewOptions(pageFilePathFormat);


### 渲染 OBJ 為 PDF

`PdfViewOptions` 類別可建立可列印的 PDF，保留 3D 模型的視覺真實度。

1. **設定輸出目錄**  

   ```java
viewer.view(options);

  1. 建立 Viewer 實例

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


3. **設定 PDF 檢視選項**  
   設定頁面大小、邊距，並可選擇將原始 OBJ 作為附件嵌入。  

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

  1. 渲染 OBJ 文件

PdfViewOptions options = new PdfViewOptions(pageFilePathFormat);


## 實務應用

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

GroupDocs.Viewer 支援 **超過 100 種檔案格式**，包括 OBJ、PDF、DOCX 等，且能在不將整個檔案載入記憶體的情況下處理數百頁的文件。

## 效能考量與常見陷阱

- **記憶體管理：** 大型 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: 它支援超過 100 種輸入與輸出格式，包括 HTML、JPG、PNG、PDF、DOCX 與 OBJ。

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

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

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

**Q: 如何取得臨時授權？**  
A: 可於[此處](https://purchase.groupdocs.com/temporary-license/) 取得臨時授權。

---

**最後更新：** 2026-07-29  
**測試環境：** GroupDocs.Viewer 25.2 for Java  
**作者：** GroupDocs  

```java
viewer.view(options);

相關教學