ایجاد تصویرهای بندانگشتی از شکلهای ارائه در اندروید
مقدمه
Aspose.Slides for Android via Java میتواند برای ایجاد فایلهای ارائه استفاده شود که در آن هر صفحه متناظر با یک اسلاید است. اسلایدها را میتوان با باز کردن فایلهای ارائه با Microsoft PowerPoint مشاهده کرد. اما گاهی اوقات توسعهدهندگان نیاز دارند تصاویر شکلها را بهصورت جداگانه در یک برنامهٔ مشاهدهکننده تصویر ببینند. در چنین مواردی، Aspose.Slides for Android via Java به آنها کمک میکند تا تصاویر بندانگشتی از شکلهای اسلاید تولید کنند.
در این مطلب، نحوهٔ تولید تصویرهای بندانگشتی اسلاید در شرایط مختلف را نشان میدهیم:
- تولید تصویر بندانگشتی یک شکل در داخل اسلاید.
- تولید تصویر بندانگشتی یک شکل اسلاید با ابعاد تعریفشده توسط کاربر.
- تولید تصویر بندانگشتی یک شکل در محدودهٔ ظاهر شکل.
تولید تصویر بندانگشتی شکل از یک اسلاید
برای تولید تصویر بندانگشتی یک شکل از هر اسلاید با استفاده از Aspose.Slides for Android via Java، این کار را انجام دهید:
- یک نمونه از کلاس Presentation ایجاد کنید.
- مرجع هر اسلاید را با استفاده از شناسه یا ایندکس آن بهدست آورید.
- دریافت تصویر بندانگشتی شکل از اسلاید مرجع با مقیاس پیشفرض.
- تصویر بندانگشتی را در قالب تصویر موردنظر خود ذخیره کنید.
این نمونه کد نشان میدهد چگونه تصویر بندانگشتی یک شکل را از یک اسلاید تولید کنید:
// یک شیء از کلاس Presentation بسازید که نمایانگر فایل ارائه است
Presentation pres = new Presentation("Thumbnail.pptx");
try {
// یک تصویر با مقیاس کامل بسازید
IImage slideImage = pres.getSlides().get_Item(0).getShapes().get_Item(0).getImage();
// تصویر را در قالب PNG روی دیسک ذخیره کنید
try {
slideImage.save("output.png", ImageFormat.Png);
} finally {
if (slideImage != null) slideImage.dispose();
}
} finally {
if (pres != null) pres.dispose();
}
تولید تصویر بندانگشتی با مقیاسساز تعریفشده توسط کاربر
برای تولید تصویر بندانگشتی شکل یک اسلاید با استفاده از Aspose.Slides for Android via Java، این کار را انجام دهید:
- یک نمونه از کلاس Presentation ایجاد کنید.
- مرجع هر اسلاید را با استفاده از شناسه یا ایندکس آن بهدست آورید.
- دریافت تصویر بندانگشتی شکل از اسلاید مرجع با ابعاد تعریفشده توسط کاربر.
- تصویر بندانگشتی را در قالب تصویر موردنظر خود ذخیره کنید.
این نمونه کد نشان میدهد چگونه تصویر بندانگشتی یک شکل را بر اساس یک عامل مقیاسساز تعریفشده تولید کنید:
// یک شیء از کلاس Presentation بسازید که نمایانگر فایل ارائه است
Presentation pres = new Presentation("Thumbnail.pptx");
try {
// یک تصویر با مقیاس کامل بسازید
IImage slideImage = pres.getSlides().get_Item(0).getShapes().get_Item(0).getImage(ShapeThumbnailBounds.Shape, 1, 1);
// تصویر را در قالب PNG روی دیسک ذخیره کنید
try {
slideImage.save("output.png", ImageFormat.Png);
} finally {
if (slideImage != null) slideImage.dispose();
}
} finally {
if (pres != null) pres.dispose();
}
ایجاد تصویر بندانگشتی ظاهر شکل مبتنی بر محدوده
این روش ایجاد تصویرهای بندانگشتی از شکلها به توسعهدهندگان اجازه میدهد تا تصویری بندانگشتی در محدودهٔ ظاهر شکل تولید کنند. تمام اثرات شکل در نظر گرفته میشود. تصویر بندانگشتی تولیدشده توسط محدودهٔ اسلاید محدود میشود. برای تولید تصویر بندانگشتی یک شکل اسلاید در محدودهٔ ظاهر آن، این کار را انجام دهید:
- یک نمونه از کلاس Presentation ایجاد کنید.
- مرجع هر اسلاید را با استفاده از شناسه یا ایندکس آن بهدست آورید.
- تصویر بندانگشتی اسلاید مرجع را با مرزهای شکل بهعنوان ظاهر دریافت کنید.
- تصویر بندانگشتی را در قالب تصویر موردنظر خود ذخیره کنید.
این نمونه کد بر پایهٔ مراحل فوق است:
// یک شیء از کلاس Presentation بسازید که نمایانگر فایل ارائه است
Presentation pres = new Presentation("Thumbnail.pptx");
try {
// یک تصویر با مقیاس کامل بسازید
IImage slideImage = pres.getSlides().get_Item(0).getShapes().get_Item(0).getImage(ShapeThumbnailBounds.Appearance, 1, 1);
// تصویر را در قالب PNG روی دیسک ذخیره کنید
try {
slideImage.save("output.png", ImageFormat.Png);
} finally {
if (slideImage != null) slideImage.dispose();
}
} finally {
if (pres != null) pres.dispose();
}
دریافت مرزهای بصری واقعی یک شکل
ویژگیهای چارچوب IShape—متدهای getX(), getY(), getWidth(), و getHeight() آن—مستطیلی را که در مدل ارائه ذخیره شده توصیف میکنند. محتوای واقعاً رندر شده میتواند فراتر از آن چارچوب گسترش یابد یا مستطیل محور محور متفاوتی را اشغال کند. چرخش، خطوط پیرامونی، سرپنجهها، چینش و سرریز متن، هندسهٔ تولید شدهٔ SmartArt و سایر اثرات رندر میتوانند تماماً ناحیهٔ اشغالی را تغییر دهند.
از Shape.getVisualBounds برای محاسبهٔ آن ناحیهٔ اشغالی بدون ایجاد تصویر استفاده کنید. این متد یک RectF در مختصات اسلاید برمیگرداند. مستطیل برگشتی به اسلاید قطع نمیشود، بنابراین مختصات آن میتواند منفی باشد وقتی محتوا فراتر از مبدأ اسلاید گسترش یابد.
در حال حاضر Shape.getVisualBounds توسط رابط IShape اعلام نشده است. بنابراین، شکل بهدستآمده از مجموعهٔ شکلهای اسلاید را بهعنوان مقدار رابط نگه دارید و تنها هنگام فراخوانی متد آن را تبدیل (cast) کنید.
مثال زیر چارچوب و مرزهای بصری را دریافت و مقایسه میکند:
Presentation presentation = new Presentation("example.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
IShape shape = slide.getShapes().get_Item(0);
RectF visualBounds = ((Shape) shape).getVisualBounds();
float frameLeft = shape.getX();
float frameTop = shape.getY();
float frameRight = frameLeft + shape.getWidth();
float frameBottom = frameTop + shape.getHeight();
RectF frameBounds = new RectF(frameLeft, frameTop, frameRight, frameBottom);
System.out.println("Frame bounds: " + frameBounds);
System.out.println("Visual bounds: " + visualBounds);
} finally {
presentation.dispose();
}
همان RectF میتواند برای همترازی شکلهای نزدیک به لبهٔ چپ، راست، بالا یا پایین آن استفاده شود؛ فضای کافی در یک چیدمان تولیدشده حفظ کند؛ یا محتوا را خارج از ناحیهٔ مجاز شناسایی کند. مرزهای بصری بهویژه برای SmartArt، جعبههای متن، پیکانها، تصاویر، شکلهای چرخان و گروهی مفید هستند، جایی که چارچوب ذخیرهشده ممکن است نمای کامل رندر شده را نشان ندهد.
از Shape.getVisualBounds زمانی که به مختصات برای چیدمان یا اعتبارسنجی نیاز دارید و به bitmap نیازی ندارید، استفاده کنید. از IShape.getImage وقتی که نیاز به رندر شکل دارید، استفاده کنید. با ShapeThumbnailBounds، ShapeThumbnailBounds.Shape تصویر را از مرزهای شکل، شامل تنظیمات خطوط پیرامونی، اندازهگیری میکند، در حالی که ShapeThumbnailBounds.Appearance آن را از ظاهر شکل اندازهگیری میکند و نتیجه را به مرزهای اسلاید محدود میکند. برعکس، Shape.getVisualBounds فقط مستطیل محاسبهشده را برمیگرداند و آن را به اسلاید قطع نمیکند.
پرسشهای متداول
چه قالبهای تصویری میتوانند هنگام ذخیرهٔ تصویرهای بندانگشتی شکل استفاده شوند؟
PNG, JPEG, BMP, GIF, TIFF، و سایرین. همچنین میتوان شکلها را بهصورت SVG برداری صادر کرد با ذخیرهٔ محتویات شکل بهصورت SVG.
تفاوت بین مرزهای Shape و Appearance هنگام رندر تصویر بندانگشتی چیست؟
Shape از هندسهٔ شکل استفاده میکند؛ Appearance اثرات بصری visual effects (سایهها، تابشها و غیره) را در نظر میگیرد.
اگر یک شکل بهعنوان مخفی علامتگذاری شود، چه اتفاقی میافتد؟ آیا همچنان بهعنوان تصویر بندانگشتی رندر میشود؟
یک شکل مخفی همچنان بخشی از مدل باقی میماند و میتواند رندر شود؛ پرچم مخفی بودن بر نمایش اسلایدشو تأثیر میگذارد اما جلوی تولید تصویر شکل را نمیگیرد.
آیا شکلهای گروهی، نمودارها، SmartArt و سایر اشیای پیچیده پشتیبانی میشوند؟
بله. هر شیئی که بهصورت Shape نمایان شده باشد (از جمله GroupShape، Chart، و SmartArt) میتواند بهعنوان تصویر بندانگشتی یا بهصورت SVG ذخیره شود.
آیا فونتهای نصبشده در سیستم بر کیفیت تصویرهای بندانگشتی برای شکلهای متنی تأثیر میگذارند؟
بله. باید فونتهای موردنیاز را فراهم کنید (یا جایگزینی فونتها را پیکربندی کنید) تا از واگذاریهای ناخواسته و دوبارهچیدمان متن جلوگیری شود.