تبدیل نقشه‌های CAD به تصاویر سازگار با وب یک نیاز مکرر هنگام یکپارچه‌سازی داده‌های مهندسی در برنامه‌های مدرن است. Aspose.HTML Cloud SDK for Python یک کتابخانه قدرتمند فراهم می‌کند که تبدیل DWG به PNG را در Python ساده می‌سازد. این راهنما شما را در نصب کتابخانه، پیکربندی احراز هویت، اجرای یک نمونه کد کامل، استفاده از cURL برای تبدیل REST، و اعمال نکات عملکردی برای فایل‌های CAD بزرگ راهنمایی می‌کند.
مراحل تبدیل DWG به PNG در Python
- پیکربندی احراز هویت API: اعتبارنامه‌های کلاینت خود را در شیء
Configurationتنظیم کنید.
config = Configuration()
config.api_key['client_id'] = 'YOUR_CLIENT_ID'
config.api_key['client_secret'] = 'YOUR_CLIENT_SECRET'
- راه‌اندازی کلاینت API: یک نمونه
ApiClientو یک نمونهHtmlApiایجاد کنید.
api_client = ApiClient(config)
html_api = HtmlApi(api_client)
- بارگذاری فایل DWG: فایل DWG منبع را به یک آرایه بایت بخوانید.
with open('sample.dwg', 'rb') as f:
dwg_data = f.read()
- تبدیل DWG به PNG: متد
convert_documentرا باformat='png'صدا بزنید.
png_bytes = html_api.convert_document(dwg_data, format='png')
- ذخیره خروجی PNG: بایت‌های بازگشتی را در یک فایل PNG بنویسید.
with open('sample.png', 'wb') as out_file:
out_file.write(png_bytes)
برای مرجع دقیق API، به مستندات کلاس HtmlApi مراجعه کنید.
تبدیل DWG به PNG با استفاده از Aspose.HTML Cloud SDK for Python - مثال کامل کد
مثال زیر کل جریان کار را از احراز هویت تا ذخیره‌سازی نتیجه PNG نشان می‌دهد.
import asposehtmlcloud
from asposehtmlcloud.rest import ApiException
from asposehtmlcloud import Configuration, HtmlApi, ApiClient
def main():
# Configure API authentication (replace with your actual credentials)
config = Configuration()
config.api_key['client_id'] = 'YOUR_CLIENT_ID'
config.api_key['client_secret'] = 'YOUR_CLIENT_SECRET'
# Initialise the API client
api_client = ApiClient(config)
html_api = HtmlApi(api_client)
# Input DWG file and desired PNG output file
input_path = 'sample.dwg'
output_path = 'sample.png'
# Read the DWG file into memory
with open(input_path, 'rb') as f:
dwg_data = f.read()
try:
# Perform the conversion: DWG -> PNG
png_bytes = html_api.convert_document(dwg_data, format='png')
# Write the resulting PNG to disk
with open(output_path, 'wb') as out_file:
out_file.write(png_bytes)
print(f'Conversion succeeded, PNG saved to: {output_path}')
except ApiException as e:
print(f'Conversion failed: {e}')
if __name__ == '__main__':
main()
توجه: این مثال کد عملکرد اصلی را نشان می‌دهد. پیش از استفاده از آن در پروژه‌تان، اطمینان حاصل کنید که مسیرهای فایل و مقادیر پیکربندی را به‌گونه‌ای به‌روز کنید که با محیط واقعی شما مطابقت داشته باشد، بررسی کنید که تمام وابستگی‌های مورد نیاز به‌درستی نصب شده‌اند، و به‌طور کامل در محیط توسعه خود تست کنید. اگر با مشکلی مواجه شدید، لطفاً به مستندات رسمی مراجعه کنید یا برای دریافت کمک به تیم پشتیبانی مراجعه نمایید.
تبدیل DWG به PNG از طریق REST API با استفاده از cURL
می‌توانید بدون نوشتن کد Python، با فراخوانی مستقیم نقاط انتهایی REST سرویس Aspose.HTML Cloud، همان نتیجه را به دست آورید.
-
دریافت توکن دسترسی
curl -X POST "https://api.aspose.cloud/connect/token" \ -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET" -
بارگذاری فایل DWG
curl -X POST "https://api.aspose.cloud/v4.0/html/upload" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \ -F "file=@sample.dwg" -
درخواست تبدیل به PNG
curl -X POST "https://api.aspose.cloud/v4.0/html/convert?format=png" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \ -F "file=@sample.dwg" -
دانلود نتیجه PNG
curl -X GET "https://api.aspose.cloud/v4.0/html/download/sample.png" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \ -o sample.png
برای دریافت فهرست کامل پارامترها، به مرجع API مراجعه کنید.
Aspose.HTML Cloud SDK - پیش‌نیازها و راه‌اندازی
این کتابخانه از طریق PyPI توزیع می‌شود. آن را با pip نصب کنید و اطمینان حاصل کنید که یک حساب Aspose Cloud معتبر دارید.
pip install asposehtmlcloud
اگر نصب دستی را ترجیح می‌دهید، همچنین باید آخرین بستهٔ کلاینت را دانلود کنید:
curl -L -o asposehtmlcloud.zip https://releases.aspose.cloud/html/python/
اطمینان حاصل کنید که Python 3.7+ نصب شده است و client_id و client_secret خود را از داشبورد Aspose Cloud دریافت کرده‌اید.
ملاحظات عملکرد برای فایل‌های DWG بزرگ
- جریان به جای بارگذاری کل فایل: برای فایل‌های DWG بسیار بزرگ، فایل را به صورت تکه‑تکه بخوانید و یک جریان به
convert_documentپاس دهید تا فشار حافظه کاهش یابد. - تنظیم وضوح خروجی: از
format='png'همراه با پارامترهای پرس‌و‌جو اضافی (مثلاًdpi=150) استفاده کنید تا کیفیت و اندازه متعادل شوند. - تبدیل دسته‌ای چندین فایل: اگر نیاز به تبدیل تعداد زیادی فایل دارید، همان نمونه
HtmlApiرا دوباره استفاده کنید تا از هزینهٔ تکراری احراز هویت جلوگیری شود. - اجرای موازی: تبدیل‌ها را در رشته‌ها یا پردازش‌های جداگانه اجرا کنید وقتی منابع CPU اجازه می‌دهند، اما استفاده از حافظه را نظارت کنید تا از تمام شدن آن جلوگیری شود.
نتیجه‌گیری
تبدیل DWG به PNG در پایتون با استفاده از Aspose.HTML Cloud SDK for Python ساده می‌شود. با دنبال کردن مراحل، مثال کد و دستورات cURL ارائه‌شده در اینجا، می‌توانید تبدیل CAD‑to‑image را در هر گردش کار مبتنی بر پایتون یکپارچه کنید. به‌خاطر داشته باشید که برای استفاده در محیط تولید یک لایسنس مناسب تهیه کنید؛ جزئیات قیمت‌گذاری در صفحه محصول موجود است و می‌توانید یک لایسنس موقت را از صفحه لایسنس موقت دریافت کنید. کدنویسی خوش!
FAQs
-
چگونه می‌توانم تبدیل DWG به PNG را در پایتون با استفاده از Aspose.HTML Cloud SDK for Python انجام دهم؟
از متدconvert_documentباformat='png'پس از پیکربندی احراز هویت استفاده کنید. مثال کامل کد در این مقاله گام‌های دقیق را نشان می‌دهد. -
کدام روش احراز هویت را Aspose.HTML Cloud SDK for Python برای تبدیل DWG به PNG نیاز دارد؟
این کتابخانه از اعتبارنامه‌های مشتری OAuth2 استفاده می‌کند. قبل از ایجاد کلاینتHtmlApi، مقادیرclient_idوclient_secretرا در شیءConfigurationتنظیم کنید. -
آیا می‌توانم فایل‌های بزرگ DWG را به‌صورت کارآمد به تصاویر PNG با وضوح بالا تبدیل کنم؟
بله. فایل را به‌صورت استریم پردازش کنید، تنظیمات DPI را تنظیم کنید و برای پردازش دسته‌ای، کلاینت API را مجدداً استفاده کنید. برای نکات دقیق به بخش ملاحظات عملکرد مراجعه کنید. -
آیا یک نقطه انتهایی REST برای تبدیل DWG به PNG وجود دارد که بتوانم با cURL فراخوانی کنم؟
مطمئناً. بخش دستورات cURL فراخوانی‌های دقیق برای دریافت توکن دسترسی، بارگذاری DWG، درخواست تبدیل و دانلود نتیجه PNG را فراهم می‌کند.