رندر کردن اشکال جدا از یک سند

هنگام پردازش اسناد، یک کار رایج استخراج تمام تصاویر موجود در سند و صادر کردن آنها به یک مکان خارجی است. این کار با Aspose.Words API که از قبل قابلیت استخراج و ذخیره داده های تصویر را فراهم می کند، ساده می شود. با این حال، گاهی اوقات ممکن است بخواهید به طور مشابه انواع دیگری از محتوای گرافیکی را استخراج کنید که با نوع دیگری از شی ترسیمی نشان داده می شود، به عنوان مثال، یک جعبه متن حاوی پاراگراف ها، شکل های فلش و یک تصویر کوچک. هیچ راه ساده ای برای رندر کردن این شی وجود ندارد زیرا ترکیبی از عناصر محتوای فردی است. همچنین ممکن است با موردی مواجه شوید که محتویات با هم در شیئی که شبیه یک تصویر واحد است، گروه بندی شده باشند.

Aspose.Words عملکردی را برای استخراج این نوع محتوا فراهم می کند به همان روشی که می توانید یک تصویر ساده را از یک شکل به عنوان محتوای رندر شده استخراج کنید. این مقاله نحوه استفاده از این قابلیت را برای ارائه اشکال مستقل از سند شرح می دهد.

انواع شکل در Aspose.Words

تمام محتوای یک لایه ترسیم سند توسط گره Shape یا GroupShape در ماژول شی سند Aspose.Words (DOM) نشان داده می شود. چنین محتویاتی می توانند جعبه های متن، تصاویر، AutoShapes، اشیاء OLE و غیره باشند. برخی از فیلدها نیز به عنوان شکل وارد می شوند، به عنوان مثال، فیلد INCLUDEPICTURE.

یک تصویر ساده توسط یک گره Shape از ShapeType.Image نشان داده می شود. این گره شکل هیچ گره فرزندی ندارد اما داده های تصویر موجود در این گره شکل با ویژگی Shape.ImageData قابل دسترسی است. از سوی دیگر، یک شکل می تواند از گره های فرزند زیادی نیز ساخته شود. به عنوان مثال، یک شکل جعبه متن، که با ویژگی ShapeType.TextBox نشان داده می شود، می تواند از گره های زیادی مانند Paragraph و Table تشکیل شود. اکثر اشکال می توانند شامل گره های سطح بلوک Paragraph و Table باشند. این گره ها همان گره هایی هستند که در بدنه اصلی ظاهر می شوند. شکل‌ها همیشه بخشی از پاراگراف هستند، یا مستقیماً درون خط قرار می‌گیرند یا به پاراگراف، متصل می‌شوند، اما در هر نقطه‌ای از صفحه سند “شناور” هستند.

یک سند همچنین می تواند شامل اشکالی باشد که با هم گروه بندی شده اند. Grouping را می توان در Microsoft Word با انتخاب چندین شی و کلیک روی “Group” در منوی کلیک راست فعال کرد.

در Aspose.Words، این گروه از اشکال با گره GroupShape نشان داده می شوند. اینها را نیز می توان به همان روش فراخوانی کرد تا کل گروه را به تصویر تبدیل کند.

فرمت DOCX می تواند شامل انواع خاصی از تصاویر، مانند نمودارها یا نمودارها باشد. این اشکال همچنین از طریق گره Shape در Aspose.Words نشان داده می شوند، که همچنین روش مشابهی را برای ارائه آنها به عنوان تصویر ارائه می دهد. با طراحی، یک شکل نمی تواند شکل دیگری را در کودکی داشته باشد، مگر اینکه آن شکل یک تصویر (ShapeType.Image) باشد. به عنوان مثال، Microsoft Word به شما اجازه نمی دهد که یک جعبه متن را در جعبه متن دیگری وارد کنید.

انواع شکلی که در بالا توضیح داده شد، روش خاصی را برای ارائه اشکال از طریق کلاس ShapeRenderer ارائه می دهند. نمونه ای از کلاس ShapeRenderer برای Shape یا GroupShape از طریق متد GetShapeRenderer یا با ارسال Shape به سازنده کلاس ShapeRenderer بازیابی می شود. این کلاس دسترسی به اعضا را فراهم می کند که امکان رندر کردن یک شکل را به موارد زیر فراهم می کند:

• فایل روی دیسک با استفاده از روش Save overload
• با استفاده از روش Save اضافه بار پخش جریانی کنید
• شیء گرافیکی .NET با استفاده از روش های RenderToSize و RenderToScale

هنگام ارائه یک Shape، باید بخشی از سلسله مراتب سند باشد. اگر Shape بخشی از درخت سند نباشد، پس از فراخوانی متدهای ShapeRenderer، خروجی رندر شده خالی خواهد بود.

ارائه به فایل یا جریان

روش Save اضافه بارهایی را فراهم می کند که یک شکل را مستقیماً به یک فایل یا جریان ارائه می دهد. هر دو اضافه بار نمونه ای از کلاس ImageSaveOptions را می پذیرند که امکان تعریف گزینه هایی برای رندر شکل را می دهد. این روش همانند روش Document.Save عمل می کند. حتی اگر این پارامتر مورد نیاز است، می‌توانید یک مقدار تهی ارسال کنید و مشخص کنید که هیچ گزینه سفارشی وجود ندارد.

شکل را می توان در هر قالب تصویری که در شمارش SaveFormat مشخص شده است صادر کرد. به عنوان مثال، تصویر را می توان به عنوان یک تصویر شطرنجی، مانند JPEG با مشخص کردن شمارش SaveFormat.Jpeg، یا به عنوان یک تصویر برداری، مانند EMF با تعیین SaveFormat.Emf ارائه کرد.

مثال کد زیر ارائه یک شکل به تصویر EMF جدا از سند و ذخیره در دیسک را نشان می دهد:

مثال کد زیر رندر کردن یک شکل به یک تصویر JPEG را جدا از سند و ذخیره در یک جریان را نشان می دهد:

کلاس ImageSaveOptions به شما اجازه می دهد تا گزینه های مختلفی را تعیین کنید که نحوه رندر شدن تصویر را کنترل می کنند. عملکردی که در بالا توضیح داده شد می تواند به همان شیوه برای گره های GroupShape و Shape اعمال شود.

ارائه به یک شی گرافیکی .NET

رندر مستقیم به یک شیء Graphics به شما امکان می دهد تنظیمات و وضعیت خود را برای شیء Graphics تعریف کنید. یک سناریوی رایج شامل رندر کردن یک شکل به طور مستقیم به یک شی Graphics است که از یک فرم Windows یا یک Bitmap بازیابی شده است. هنگامی که گره Shape رندر می شود، تنظیمات بر ظاهر شکل تأثیر می گذارد. به عنوان مثال، می توانید با استفاده از روش های RotateTransform یا ScaleTransform برای شی Graphics، شکل را بچرخانید یا مقیاس دهید.

مثال زیر نشان می دهد که چگونه می توان یک شکل را به یک شی .NET Graphics جدا از سند ارائه کرد و چرخش را روی تصویر رندر شده اعمال کرد:

به طور مشابه، به روش RenderToSize، روش RenderToSize به ارث رسیده از NodeRendererBase برای ایجاد تصاویر کوچک از محتوای سند مفید است. اندازه شکل از طریق سازنده مشخص می شود. متد RenderToSize شی Graphics، مختصات X و Y موقعیت تصویر و اندازه تصویر (عرض و ارتفاع) که روی شی Graphics کشیده می شود را می پذیرد.

Shape را می توان با استفاده از روش ShapeRenderer.RenderToScale که از کلاس NodeRendererBase به ارث رسیده است، در مقیاس خاصی رندر کرد. این شبیه به روش Document.RenderToScale است که همان پارامترهای اصلی را می پذیرد. تفاوت این دو روش در این است که با روش ShapeRenderer.RenderToScale به جای اندازه تحت اللفظی، یک مقدار شناور را انتخاب می کنید که شکل را در حین رندر کردن آن مقیاس می کند. اگر مقدار شناور برابر با 1.0 باشد باعث می شود شکل در 100٪ اندازه اصلی خود ارائه شود. مقدار شناور 0.5 اندازه تصویر را به نصف کاهش می دهد.

ارائه یک تصویر شکل

کلاس Shape اشیایی را در لایه ترسیم نشان می دهد، مانند AutoShape، جعبه متن، فرم آزاد، شی OLE، کنترل ActiveX یا یک عکس. با استفاده از کلاس Shape، می توانید اشکال را در یک سند Microsoft Word ایجاد یا تغییر دهید. ویژگی مهم یک شکل ShapeType آن است. اشکال از انواع مختلف می توانند قابلیت های متفاوتی در یک سند Word داشته باشند. برای مثال، فقط شکل‌های تصویر و OLE می‌توانند تصاویر درون خود داشته باشند، در حالی که بیشتر شکل‌ها فقط می‌توانند متن داشته باشند.

مثال زیر نشان می دهد که چگونه می توان یک تصویر Shape را به یک تصویر JPEG جدا از سند ارائه کرد و آن را در دیسک ذخیره کرد:

بازیابی یک اندازه شکل

کلاس ShapeRenderer همچنین عملکردی برای بازیابی اندازه شکل در پیکسل از طریق روش GetSizeInPixels ارائه می دهد. این روش دو پارامتر شناور (Single) - مقیاس و DPI را می پذیرد که در محاسبه اندازه شکل هنگام ارائه شکل استفاده می شود. متد شی Size را برمی گرداند که شامل عرض و ارتفاع اندازه محاسبه شده است. این زمانی مفید است که لازم است از قبل اندازه شکل رندر شده را بدانید، به عنوان مثال هنگام ایجاد یک بیت مپ جدید از خروجی رندر شده.

مثال زیر نحوه ایجاد یک شیء Bitmap و Graphics جدید با عرض و ارتفاع شکل مورد نظر را نشان می دهد:

هنگام استفاده از روش‌های RenderToSize یا RenderToScale، اندازه تصویر رندر شده نیز در شی SizeF برگردانده می‌شود. این را می توان به یک متغیر اختصاص داد و در صورت لزوم از آن استفاده کرد.

ویژگی SizeInPoints اندازه Shape اندازه‌گیری شده در نقاط را برمی‌گرداند (به ShapeRenderer مراجعه کنید. نتیجه یک شی SizeF حاوی عرض و ارتفاع است.