處理 CAD 繪圖通常意味著將 DWG 檔案轉換為適合網路的圖像，例如 PNG。Aspose.BarCode Cloud SDK for Python 透過將處理工作移至雲端，使此轉換變得簡單。在本教學中，我們將示範如何設定 SDK、驗證、編寫 Python 程式碼將 DWG 轉換為 PNG，並使用原始 cURL 請求達成相同結果，讓您輕鬆將 DWG 渲染整合到 Python 應用程式中。

在 Python 中將 DWG 轉換為 PNG - 步驟

  1. 配置憑證: 設定您的 client ID 和 client secret，以便 SDK 能夠在 Aspose cloud 上進行驗證。
client_id = "YOUR_CLIENT_ID"
client_secret = "YOUR_CLIENT_SECRET"
  1. 初始化 API 客戶端：建立 Configuration 物件，指派認證，並建構 ApiClient 與 BarcodeApi 實例。
config = Configuration()
config.client_id = client_id
config.client_secret = client_secret

api_client = ApiClient(configuration=config)
barcode_api = BarcodeApi(api_client)
  1. 讀取 DWG 檔案: 以二進位模式開啟來源 DWG 檔案，並將其內容讀取到記憶體中。
with open("sample.dwg", "rb") as file_stream:
    dwg_bytes = file_stream.read()
  1. 呼叫轉換端點：使用 convert_image 並指定 "png" 為目標格式。此方法會以位元組陣列返回 PNG 資料。
conversion_response = barcode_api.convert_image(
    file=dwg_bytes,
    format="png"
)
  1. 保存 PNG 輸出: 將返回的位元組寫入具有 .png 副檔名的檔案。
with open("sample.png", "wb") as out_file:
    out_file.write(conversion_response)

如需了解 convert_image 方法的更多細節，請參閱 API 參考。

DWG 轉 PNG 轉換（Python） - 完整工作範例

以下示例展示了在 Python 中使用 Aspose.BarCode Cloud SDK 進行 DWG 轉 PNG 的完整工作流程。

import os
from asposebarcodecloud import Configuration, ApiClient, BarcodeApi, ApiException

# -------------------- Configuration --------------------
# Replace with your actual Aspose.BarCode Cloud credentials
client_id = "YOUR_CLIENT_ID"
client_secret = "YOUR_CLIENT_SECRET"

config = Configuration()
config.client_id = client_id
config.client_secret = client_secret

# Initialize API client
api_client = ApiClient(configuration=config)
barcode_api = BarcodeApi(api_client)

# -------------------- File Paths --------------------
input_path = "sample.dwg"      # Path to the source DWG file
output_path = "sample.png"     # Desired PNG output path

# -------------------- Conversion --------------------
try:
    # Read the DWG file into memory
    with open(input_path, "rb") as file_stream:
        dwg_bytes = file_stream.read()

# The Aspose.BarCode Cloud SDK provides a generic image conversion endpoint.
    # Here we invoke it, specifying the target format as PNG.
    # The method name and parameters are based on the SDK's conversion API.
    conversion_response = barcode_api.convert_image(
        file=dwg_bytes,          # Binary content of the DWG file
        format="png"             # Target image format
    )

# Write the resulting PNG bytes to the output file
    with open(output_path, "wb") as out_file:
        out_file.write(conversion_response)

print(f"Conversion successful: '{input_path}' → '{output_path}'")

except ApiException as api_err:
    print(f"API error during conversion: {api_err}")
except Exception as err:
    print(f"Unexpected error: {err}")
finally:
    # Explicitly close the API client session if needed
    if hasattr(api_client, "close"):
        api_client.close()

注意： 此程式碼範例示範了核心功能。在將其用於您的專案之前，請確保更新所有檔案路徑和設定值以符合實際環境，驗證所有必要的相依項目已正確安裝，並在開發環境中徹底測試。如遇任何問題，請參閱官方文件或聯繫支援團隊尋求協助。

使用 cURL 透過 REST API 將 DWG 轉換為 PNG

以下是一系列使用 REST 介面執行相同轉換的 cURL 命令。

  1. 取得存取權杖
curl -X POST "https://api.aspose.cloud/connect/token" \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"

回應中包含 access_token。

  1. 上傳 DWG 檔案
curl -X PUT "https://api.aspose.cloud/v3.0/barcode/storage/file/sample.dwg" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -H "Content-Type: application/octet-stream" \
        --data-binary "@sample.dwg"
  1. 執行轉換
curl -X POST "https://api.aspose.cloud/v3.0/barcode/convert?format=png" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/octet-stream" \
     --data-binary "@sample.dwg" \
     -o sample.png
  1. 下載 PNG 結果（如果您在上面使用了 -o，則為可選）
curl -X GET "https://api.aspose.cloud/v3.0/barcode/storage/file/sample.png" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o sample.png

欲取得完整的參數清單，請參閱官方 API 文件。

安裝與設定 Aspose.BarCode Cloud SDK for Python

SDK 透過 PyPI 發佈。使用以下指令安裝它：

pip install aspose-barcode-cloud

先決條件: Python 3.6 或更新版本、有效的 Aspose 帳戶以及有效的客戶端憑證。SDK 需要網際網路存取才能連接 Aspose 雲端端點。

您也可以直接從release page下載套件。

設定 DWG 轉 PNG 的轉換參數

轉換呼叫接受一個 format 參數，用於決定輸出圖像類型。在我們的範例中，我們將其設為 "png"：

conversion_response = barcode_api.convert_image(
    file=dwg_bytes,
    format="png"
)

其他可選參數（例如 outPath、storage 或圖像品質設定）已在 API 參考 中記錄。根據需要調整它們，以符合您專案的需求。

結論

DWG to PNG 轉換在 Python 中變得輕而易舉，得益於 Aspose.BarCode Cloud SDK for Python。按照上述步驟操作，您可以將向量轉光柵的轉換整合到任何後端服務中，自動化批量處理，或為 CAD 圖紙生成即時預覽。請記得從 Aspose 臨時許可證頁面 獲取有效的臨時許可證以用於開發和測試，並考慮購買正式許可證以供生產環境使用。祝編程愉快！

常見問題

  • SDK 支援哪些檔案格式的轉換？
    雲端轉換端點支援多種向量與點陣格式，包括 DWG、DXF、SVG、PDF 等等。請參閱 文件 以取得完整清單。

  • DWG 轉 PNG 的 Python 轉換是否為執行緒安全？
    是的，只要在每個執行緒中管理單獨的憑證物件，即可同時使用每個 BarcodeApi 實例。

閱讀更多