مثال کامل کارآمد برای تبدیل Word به تصویر در Java

// Load the input Word document
com.aspose.words.Document doc = new com.aspose.words.Document("Words.docx");

// Initialize an object of ImageSaveOptions class
com.aspose.words.ImageSaveOptions options = new com.aspose.words.ImageSaveOptions(com.aspose.words.SaveFormat.JPEG);

// Set the "PageSet" to "0" to convert only the first page of a document.
options.setPageSet(new com.aspose.words.PageSet(0));

// Set the image's brightness and contrast.
options.setImageBrightness(0.3f);
options.setImageContrast(0.7f);

// Set the horizontal resolution.
options.setHorizontalResolution(72f);

// Save output JPG image
doc.save("Word-to-JPG.jpg", options);

توجه: این مثال کد عملکرد اصلی را نشان می‌دهد. پیش از استفاده از آن در پروژه خود، مطمئن شوید مسیرهای فایل (Words.docx, Word-to-JPG.jpg) به‌روز شده‌اند، تأیید کنید که تمام وابستگی‌های مورد نیاز به‌درستی نصب شده‌اند و به‌طور کامل در محیط توسعه خود تست کنید. اگر با مشکلی مواجه شدید، لطفاً به مستندات رسمی مراجعه کنید یا برای دریافت کمک با تیم پشتیبانی تماس بگیرید.

درک تبدیل Word به تصویر در کد جاوا

دموی نمونه یک توالی واضح را دنبال می‌کند:

1. بارگذاری سند Word ورودی - new com.aspose.words.Document("Words.docx") فایل DOCX را در حافظه بارگذاری می‌کند.

com.aspose.words.Document doc = new com.aspose.words.Document("Words.docx");

کلاس Document نقطه ورودی برای بارگذاری و دستکاری فایل‌های Word است (API reference).

2. یک نمونه از ImageSaveOptions ایجاد کنید - SaveFormat.JPEG را به سازنده پاس دهید تا سند به عنوان تصویر JPG رندر شود.

   com.aspose.words.ImageSaveOptions options = new com.aspose.words.ImageSaveOptions(com.aspose.words.SaveFormat.JPEG);
   

3. محدود کردن بازه صفحه - setPageSet(new PageSet(0)) به مبدل می‌گوید فقط صفحه اول را رندر کند (شاخص‌های صفحه از صفر شروع می‌شوند).

options.setPageSet(new com.aspose.words.PageSet(0));

4. تنظیم روشنایی، کنتراست و وضوح - به‑دقت تنظیم کنید که تصویر خروجی چگونه به‌نظر می‌رسد.

options.setImageBrightness(0.3f);
options.setImageContrast(0.7f);
options.setHorizontalResolution(72f);

5. ذخیره تصویر خروجی - doc.save("Word-to-JPG.jpg", options) سند را با گزینه‌های پیکربندی‌شده رندر می‌کند و فایل JPG را روی دیسک می‌نویسد.

doc.save("Word-to-JPG.jpg", options);

تبدیل Word به تصویر - پیش‌نیازها و تنظیمات

برای شروع استفاده از Conholdate.Total for Java، مخزن Maven و وابستگی را به فایل pom.xml خود اضافه کنید:

<repositories>
    <repository>
        <id>conholdate-repo</id>
        <name>Conholdate Maven Repository</name>
        <url>https://repository.conholdate.com/repo/</url>
    </repository>
</repositories>

<dependency>
    <groupId>com.conholdate</groupId>
    <artifactId>conholdate-total</artifactId>
    <version>24.9</version>
    <type>pom</type>
</dependency>

آخرین باینری‌های SDK را از صفحهٔ دانلود دریافت کنید. کتابخانه به Java 8 یا بالاتر نیاز دارد و بر روی هر JVM استانداردی اجرا می‌شود. هیچ مؤلفهٔ Office اضافی‌ای لازم نیست.

تنظیم دقیق تبدیل: گزینه‌ها و تنظیمات

می‌توانید چندین ویژگی را در ImageSaveOptions تنظیم کنید تا با نیازهای خروجی شما مطابقت داشته باشد:

• قالب تصویر - فرمت مورد نظر را، مانند JPEG، PNG یا BMP، به سازندهٔ ImageSaveOptions از طریق enum SaveFormat پاس دهید.

com.aspose.words.ImageSaveOptions options = new com.aspose.words.ImageSaveOptions(com.aspose.words.SaveFormat.JPEG);

• Page range - setPageSet کنترل می‌کند که کدام صفحه(ها) رندر شوند. یک ایندکس صفر‑مبنا برای یک صفحه یا یک بازه برای چند صفحه پاس دهید.

options.setPageSet(new com.aspose.words.PageSet(0));

• روشنایی و کنتراست - مقادیر از 0.0 تا 1.0؛ 0.5 مقدار پیش‌فرض (بدون تغییر) برای هر دو است.

  options.setImageBrightness(0.3f);
  options.setImageContrast(0.7f);
  

• رزولوشن (DPI) - setHorizontalResolution (و setVerticalResolution متناظر) تراکم پیکسل تصویر خروجی را کنترل می‌کند؛ مقادیر بالاتر تصاویر واضح‌تری تولید می‌کنند به‌قیمت افزایش حجم فایل.

  options.setHorizontalResolution(72f);
  

این تنظیمات در مرجع API مستند شده‌اند.

تبدیل چند صفحه

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

com.aspose.words.Document doc = new com.aspose.words.Document("Words.docx");
com.aspose.words.ImageSaveOptions options = new com.aspose.words.ImageSaveOptions(com.aspose.words.SaveFormat.JPEG);
options.setImageBrightness(0.3f);
options.setImageContrast(0.7f);
options.setHorizontalResolution(72f);

int pageCount = doc.getPageCount();
for (int page = 0; page < pageCount; page++) {
    options.setPageSet(new com.aspose.words.PageSet(page));
    doc.save(String.format("Word-to-JPG-page_%d.jpg", page + 1), options);
}

استفاده مجدد از همان نمونه‌های Document و ImageSaveOptions در طول حلقه، مصرف حافظه را کم نگه می‌دارد و از هزینه‌ی بارگذاری مجدد فایل برای هر صفحه جلوگیری می‌کند.

نکات عملی برای خروجی تصویر با کیفیت بالا

• از همان نمونه ImageSaveOptions برای تمام صفحات استفاده کنید تا از ایجاد شیء غیرضروری جلوگیری شود.
• فایل‌ها را به صورت جریان‌دار پردازش کنید (مثلاً با استفاده از InputStream) تا مصرف حافظه برای اسناد بزرگ کم بماند.
• یک وضوح مناسب انتخاب کنید: 72 DPI برای پیش‌نمایش‌های وب کافی است، در حالی که 300 DPI برای خروجی با کیفیت چاپ توصیه می‌شود.
• روشنایی و کنتراست را به‌طور محتاطانه تنظیم کنید - تنظیمات کوچک (±0.1–0.2 از مقدار پیش‌فرض 0.5) معمولاً خوانایی را بهتر از مقادیر شدید حفظ می‌کند.
• مسیرهای خروجی را قبل از تبدیل اعتبارسنجی کنید تا از بروز IOException جلوگیری شود و اطمینان حاصل شود که پوشه هدف وجود دارد.

نتیجه‌گیری

Conholdate.Total for Java به‌صورت ساده امکان تبدیل Word به تصویر در Java را فراهم می‌کند و صفحات JPG با دقت بالا را بدون نیاز به Microsoft Office بر روی سرور ارائه می‌دهد. با دنبال کردن مراحل بالا می‌توانید تبدیل سند به تصویر را در هر برنامه Java یکپارچه کنید، روشنایی، کنتراست و وضوح را به‌دقت تنظیم کنید و مصرف منابع را تحت کنترل نگه دارید. برای استقرارهای تولیدی به یک لایسنس تجاری نیاز خواهید داشت؛ جزئیات قیمت‌گذاری در صفحه قیمت‌گذاری موجود است و یک لایسنس موقت می‌تواند از صفحه لایسنس موقت دریافت شود.

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

چگونه می‌توانم Word را به تصویر در Java تبدیل کنم وقتی سند شامل صفحات زیادی است؟ در هر تکرار بر doc.getPageCount() حلقه بزنید و options.setPageSet(new PageSet(page)) را به‌روزرسانی کنید، به‌طوری که برای هر صفحه یک فایل تصویر جداگانه ذخیره شود، همان‌طور که در بخش تبدیل چند صفحه بالا نشان داده شده است.

آیا می‌توان Word را مستقیماً به PNG به‌جای JPEG تبدیل کرد؟
بله. هنگام ساخت ImageSaveOptions مقدار com.aspose.words.SaveFormat.JPEG را به com.aspose.words.SaveFormat.PNG تغییر دهید.

آیا می‌توانم طرح‌بندی و فونت‌های اصلی را در حین تبدیل حفظ کنم؟

SDK به‌طور پیش‌فرض طرح‌بندی، رنگ‌ها و فونت‌های اصلی را جاسازی می‌کند. اگر نیاز به جاسازی فونت‌های سفارشی دارید، اطمینان حاصل کنید که این فونت‌ها بر روی سرور موجود باشند (به مستندات مراجعه کنید).

کدام مدل مجوز را برای یک پروژه تجاری باید انتخاب کنم؟ یک مجوز دائمی یا اشتراکی را از صفحه قیمت‌گذاری خریداری کنید. یک مجوز موقت برای ارزیابی از طریق صفحه مجوز موقت در دسترس است.

بیشتر بخوانید

• تبدیل تصویر به مقیاس خاکستری در جاوا
• تبدیل Word به PDF در جاوا
• تبدیل CDR به PNG در جاوا