تبدیل DWG به PNG در پایتون

کار با نقشه‌های CAD اغلب به معنای تبدیل فایل‌های DWG به تصاویر وب‌دوست مانند PNG است. Aspose.BarCode Cloud SDK for Python این تبدیل را با انتقال پردازش به ابر ساده می‌کند. در این آموزش، نحوه تنظیم SDK، احراز هویت، نوشتن کد پایتون برای تبدیل DWG به PNG، و دستیابی به همان نتیجه با یک درخواست cURL خام را نشان می‌دهیم، تا بتوانید رندرینگ DWG را به راحتی در برنامه‌های پایتون خود ادغام کنید.

تبدیل DWG به PNG در پایتون - مراحل

پیکربندی اعتبارنامه‌ها: شناسهٔ کلاینت و کلید محرمانهٔ خود را تنظیم کنید تا SDK بتواند با سرویس Aspose cloud احراز هویت کند.

client_id = "YOUR_CLIENT_ID"
client_secret = "YOUR_CLIENT_SECRET"

مقداردهی اولیه کلاینت 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)

خواندن فایل DWG: فایل منبع DWG را در حالت باینری باز کنید و محتویات آن را در حافظه بخوانید.

with open("sample.dwg", "rb") as file_stream:
    dwg_bytes = file_stream.read()

فراخوانی نقطه انتهایی تبدیل: از convert_image استفاده کنید و "png" را به عنوان قالب هدف مشخص کنید. این متد داده‌های PNG را به صورت آرایه بایت برمی‌گرداند.

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

ذخیره خروجی PNG: بایت‌های بازگشتی را در فایلی با پسوند .png بنویسید.

with open("sample.png", "wb") as out_file:
    out_file.write(conversion_response)

برای جزئیات بیشتر در مورد متد convert_image، به مرجع API مراجعه کنید.

تبدیل DWG به PNG در پایتون - نمونه کامل کار

مثال زیر جریان کاری کامل تبدیل DWG به PNG را در پایتون با استفاده از Aspose.BarCode Cloud SDK نشان می‌دهد.

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()

توجه: این مثال کد عملکرد اصلی را نشان می‌دهد. قبل از استفاده از آن در پروژه خود، مطمئن شوید که مسیرهای فایل و مقادیر پیکربندی را به‌گونه‌ای به‌روز کنید که با محیط واقعی شما مطابقت داشته باشد، اطمینان حاصل کنید که تمام وابستگی‌های مورد نیاز به‌درستی نصب شده‌اند و به‌طور کامل در محیط توسعه خود تست کنید. اگر با مشکلی مواجه شدید، لطفاً به مستندات رسمی مراجعه کنید یا برای دریافت کمک به تیم پشتیبانی مراجعه کنید.

تبدیل DWG به PNG از طریق REST API با استفاده از cURL

در زیر مجموعه‌ای از دستورات cURL آورده شده است که همان تبدیل را با استفاده از رابط REST انجام می‌دهند.

دریافت توکن دسترسی

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 است.

بارگذاری فایل 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"

اجرای تبدیل

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

دانلود نتیجه 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 برای Python

SDK از طریق PyPI توزیع می‌شود. آن را با فرمان زیر نصب کنید:

pip install aspose-barcode-cloud

پیش‌نیازها: Python 3.6 یا بالاتر، یک حساب Aspose فعال، و اعتبارهای معتبر مشتری. SDK برای دسترسی به نقاط انتهایی ابر Aspose نیاز به اتصال اینترنت دارد.

شما همچنین می‌توانید بسته را به‌صورت مستقیم از صفحهٔ انتشار دانلود کنید.

پیکربندی پارامترهای تبدیل برای DWG به PNG

فراخوانی تبدیل یک پارامتر format می‌پذیرد که نوع تصویر خروجی را تعیین می‌کند. در مثال ما آن را به "png" تنظیم می‌کنیم:

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

پارامترهای اختیاری دیگر (مانند outPath، storage یا تنظیمات کیفیت تصویر) در مرجع API مستند شده‌اند. آنها را بر حسب نیاز تنظیم کنید تا با الزامات پروژه شما مطابقت داشته باشد.

نتیجه‌گیری

تبدیل DWG به PNG در پایتون با قدرت Aspose.BarCode Cloud SDK for Python به سادگی انجام می‌شود. با دنبال کردن مراحل بالا، می‌توانید تبدیل بردار‑به‑رستر را در هر سرویس بک‌اند یکپارچه کنید، پردازش دسته‌ای را خودکار کنید یا پیش‌نمایش‌های بر‑تقاضا برای نقشه‌های CAD تولید کنید. به‌خاطر داشته باشید برای توسعه و تست یک مجوز موقت معتبر از Aspose temporary license page دریافت کنید و برای استفاده در محیط تولید خرید یک مجوز کامل را در نظر بگیرید. برنامه‌نویسی خوش!

سوالات متداول

SDK برای تبدیل چه فرمت‌های فایلی را پشتیبانی می‌کند؟
نقطه انتهای تبدیل ابری بسیاری از فرمت‌های برداری و رستری را پشتیبانی می‌کند، از جمله DWG، DXF، SVG، PDF، و موارد دیگر. برای لیست کامل به مستندات مراجعه کنید.
آیا تبدیل DWG به PNG در پایتون ایمن برای استفاده در چندین نخ است؟
بله، هر نمونه BarcodeApi می‌تواند به‌صورت همزمان استفاده شود به شرطی که اشیای اعتبارنامه جداگانه برای هر نخ مدیریت کنید.

تبدیل DWG به PNG در پایتون - مراحل#

تبدیل DWG به PNG در پایتون - نمونه کامل کار#

تبدیل DWG به PNG از طریق REST API با استفاده از cURL#

نصب و پیکربندی Aspose.BarCode Cloud SDK برای Python#

پیکربندی پارامترهای تبدیل برای DWG به PNG#

نتیجه‌گیری#

سوالات متداول#

Read More#