ApngImage

Inheritance: java.lang.Object, com.aspose.imaging.DisposableObject, com.aspose.imaging.DataStreamSupporter, com.aspose.imaging.Image, com.aspose.imaging.RasterImage, com.aspose.imaging.RasterCachedImage, com.aspose.imaging.RasterCachedMultipageImage

All Implemented Interfaces: com.aspose.imaging.IMultipageImageExt

public final class ApngImage extends RasterCachedMultipageImage implements IMultipageImageExt

واجهة برمجة التطبيقات لتنسيق ملف صورة Animated PNG (Animated Portable Network Graphics) هي حل متعدد الاستخدامات للمطورين الذين يتطلعون إلى دمج محتوى متحرك في تطبيقاتهم. توفر هذه الواجهة تحكمًا واسعًا في إعدادات الإطارات، مما يسمح للمستخدمين بتحديد معلمات خاصة بالإطار، بما في ذلك مدة الحلقة وإعدادات ملف PNG. باستخدام هذه الأداة الغنية بالميزات، يمكنك إدارة وتحسين عرض صور APNG بسهولة، واستيراد وتصدير الصور، مما يعزز الجوانب الديناميكية والتفاعلية لتطبيقاتك.

المنشئات

المنشئ	الوصف
ApngImage(ApngOptions options, int width, int height)	ابدأ العمل مع الفئة ApngImage عن طريق إنشاء نسخة جديدة بسهولة.

الطرق

طريقة	الوصف
getFileFormat()	احصل بسرعة على معلومات حول تنسيق الملف باستخدام هذه الخاصية المريحة.
getPageCount()	استرجع إجمالي عدد الصفحات في ملف الصورة الخاص بك بسهولة باستخدام هذه الخاصية.
getPages()	الوصول بسهولة إلى صفحات صورتك باستخدام هذه الخاصية المريحة.
getNumPlays()	تحكم بسهولة في عدد مرات تكرار الرسوم المتحركة باستخدام هذه الخاصية المتعددة الاستخدامات.
setNumPlays(int value)	تحكم بسهولة في عدد مرات تكرار الرسوم المتحركة باستخدام هذه الخاصية المتعددة الاستخدامات.
getDefaultFrameTime()	قم بضبط مدة الإطار الافتراضية لإنشاء إطارات جديدة بسهولة باستخدام هذه الخاصية المرنة.
setDefaultFrameTime(long value)	قم بضبط مدة الإطار الافتراضية لإنشاء إطارات جديدة بسهولة باستخدام هذه الخاصية المرنة.
getInterlaced()	حدد بسرعة ما إذا كان كائن PngImage هذا متشابكًا باستخدام هذه الخاصية المريحة.
getOriginalOptions()	استرجع الخيارات بناءً على إعدادات الملف الأصلي بسهولة باستخدام هذه الطريقة البديهية.
getDefaultOptions(Object[] args)	استرجع الخيارات الافتراضية بسهولة باستخدام هذه الطريقة البسيطة.
getModifyDate(boolean useDefault)	احصل بسرعة على التاريخ والوقت عندما تم تعديل صورة المورد آخر مرة باستخدام هذه الطريقة سهلة الاستخدام.
addPage(RasterImage page)	أضف صفحة جديدة إلى الصورة بسهولة باستخدام هذه الطريقة البديهية.
addFrame()	/**
addFrame(RasterImage frameImage)	قم بتوسيع مجموعة الإطارات الخاصة بك بسهولة عن طريق إضافة إطار جديد في النهاية باستخدام هذه الطريقة البديهية.
addFrame(RasterImage frameImage, long frameTime)	قم بتوسيع مجموعة الإطارات الخاصة بك بسلاسة عن طريق إلحاق إطار جديد باستخدام هذه الطريقة البديهية.
insertFrame(int index)	قم بإدراج إطار جديد بسهولة في مجموعة الإطارات الخاصة بك في الموضع المحدد باستخدام هذه الطريقة البديهية.
insertFrame(int index, RasterImage frameImage)	يدرج إطارًا جديدًا في مجموعة الإطارات الخاصة به في الفهرس المحدد.
insertFrame(int index, RasterImage frameImage, long frameTime)	يدرج إطارًا جديدًا في مجموعة الإطارات الخاصة به في الفهرس المحدد.
popFrameAt(int index)	قم بإزالة واسترجاع الإطار في الفهرس المحدد من مجموعة الإطارات الخاصة بك باستخدام هذه الطريقة البديهية.
removeFrameAt(int index)	قم بإزالة الإطار في الفهرس المحدد من مجموعة الإطارات الخاصة بك بسلاسة باستخدام هذه الطريقة.
removeAllFrames()	قم بمسح مجموعة الإطارات الخاصة بك عن طريق إزالة جميع الإطارات باستخدام هذه الطريقة البديهية.
setDefaultImage(RasterImage image)	قم بتعيين الصورة النقطية المحددة كالصورة الافتراضية للرسوم المتحركة الحالية بسهولة باستخدام هذه الطريقة.
resetDefaultImage()	قم بإزالة الصورة الافتراضية التي تم تعيينها مسبقًا باستخدام هذه الطريقة البديهية.

Example: The following example shows how to export to APNG file format.

import com.aspose.imaging;
import com.aspose.imaging.imageoptions;

try (Image image = Image.load("Animation1.webp"))
{
    // تصدير إلى رسوم متحركة APNG مع دورات غير محدودة كإعداد افتراضي
    image.save("Animation1.webp.png", new ApngOptions());
    // إعداد دورات الرسوم المتحركة
    ApngOptions options = new ApngOptions();
    options.setNumPlays(5);
    image.save("Animation2.webp.png", options); // 5 cycles
}

Example: The following example shows how to export apng APNG file format from other non-animated multi-page format.

import com.aspose.imaging;
import com.aspose.imaging.imageoptions;

try (Image image = Image.load("img4.tif"))
{
    // إعداد مدة الإطار الافتراضية
    ApngOptions options = new ApngOptions();
    options.setDefaultFrameTime(500);
    image.save("img4.tif.500ms.png", options); // 500 ms
    options.setDefaultFrameTime(250);
    image.save("img4.tif.250ms.png", options); // 250 ms
}

ApngImage(ApngOptions options, int width, int height)

public ApngImage(ApngOptions options, int width, int height)

ابدأ العمل مع الفئة ApngImage عن طريق إنشاء نسخة جديدة بسهولة. مثالي للمطورين الذين يرغبون في بدء استخدام كائنات ApngImage بسرعة وكفاءة في مشاريعهم.

Parameters:

معامل	نوع	الوصف
options	ApngOptions	الخيارات.
width	int	العرض.
height	int	الارتفاع.

getFileFormat()

public long getFileFormat()

احصل بسرعة على معلومات حول تنسيق الملف باستخدام هذه الخاصية المريحة. مثالي للمطورين الذين يحتاجون إلى استرجاع تفاصيل حول تنسيق ملفات Apng الخاصة بهم بسهولة.

Returns: long

getPageCount()

public int getPageCount()

استرجع إجمالي عدد الصفحات في ملف الصورة الخاص بك بسهولة باستخدام هذه الخاصية. مثالي للمطورين الذين يحتاجون إلى وصول سريع إلى معلومات عدد الصفحات.

القيمة: عدد الصفحات.

Returns: int

getPages()

public Image[] getPages()

قم بالوصول بسهولة إلى صفحات صورتك باستخدام هذه الخاصية المريحة. مثالي للمطورين الذين يسعون إلى وصول سريع وسهل إلى الصفحات الفردية للتعديل.

القيمة: الصفحات.

Returns: com.aspose.imaging.Image[]

getNumPlays()

public int getNumPlays()

تحكم بسهولة في عدد مرات تكرار الرسوم المتحركة الخاصة بك باستخدام هذه الخاصية المتعددة الاستخدامات. مثالي للمطورين الذين يسعون إلى تحكم دقيق في سلوك الرسوم المتحركة، مع دعم التكرار اللانهائي في حال كانت القيمة تساوي 0.

القيمة: عدد مرات التكرار.

Returns: int

setNumPlays(int value)

public void setNumPlays(int value)

تحكم بسهولة في عدد مرات تكرار الرسوم المتحركة الخاصة بك باستخدام هذه الخاصية المتعددة الاستخدامات. مثالي للمطورين الذين يسعون إلى تحكم دقيق في سلوك الرسوم المتحركة، مع دعم التكرار اللانهائي في حال كانت القيمة تساوي 0.

القيمة: عدد مرات التكرار.

Parameters:

معامل	نوع	الوصف
value	int

getDefaultFrameTime()

public long getDefaultFrameTime()

قم بضبط مدة الإطار الافتراضية لإنشاء إطارات جديدة بسهولة باستخدام هذه الخاصية المرنة. مثالي للمطورين الذين يرغبون في تخصيص توقيت الإطارات بفعالية في رسوماتهم المتحركة.

القيمة: مدة الإطار الافتراضية، بالمللي ثانية.

Returns: long

setDefaultFrameTime(long value)

public void setDefaultFrameTime(long value)

قم بضبط مدة الإطار الافتراضية لإنشاء إطارات جديدة بسهولة باستخدام هذه الخاصية المرنة. مثالي للمطورين الذين يرغبون في تخصيص توقيت الإطارات بفعالية في رسوماتهم المتحركة.

القيمة: مدة الإطار الافتراضية، بالمللي ثانية.

Parameters:

معامل	نوع	الوصف
value	long

getInterlaced()

public boolean getInterlaced()

حدد بسرعة ما إذا كان كائن PngImage هذا متشابكًا باستخدام هذه الخاصية المريحة. مثالي للمطورين الذين يحتاجون إلى فحص حالة التشابك لصور PNG بسهولة.

القيمة: true إذا كان متشابكًا؛ وإلا false.

Returns: boolean

getOriginalOptions()

public ImageOptionsBase getOriginalOptions()

استرجع الخيارات بناءً على إعدادات الملف الأصلي بسهولة باستخدام هذه الطريقة البديهية. مثالي للمطورين الذين يرغبون في الوصول إلى الإعدادات واستخدامها بما يتماشى مع خصائص الملف الأصلي. يمكن أن يساعد ذلك في الحفاظ على عمق البت وغيرها من معلمات الصورة الأصلية دون تغيير. على سبيل المثال، إذا قمنا بتحميل صورة PNG بالأبيض والأسود بعمق 1 بت لكل بكسل ثم حفظناها باستخدام طريقة DataStreamSupporter.save(String)، سيتم إنتاج صورة PNG ناتجة بعمق 8 بت لكل بكسل. لتجنب ذلك وحفظ صورة PNG بعمق 1 بت لكل بكسل، استخدم هذه الطريقة للحصول على خيارات الحفظ المقابلة ومررها إلى طريقة Image.save(String, ImageOptionsBase) كمعامل ثانٍ.

Returns: ImageOptionsBase - The options based on the original file settings.

getDefaultOptions(Object[] args)

public ImageOptionsBase getDefaultOptions(Object[] args)

استرجع الخيارات الافتراضية بسهولة باستخدام هذه الطريقة المبسطة. مثالي للمطورين الذين يرغبون في وصول سريع إلى إعدادات صورة Apng الافتراضية.

Parameters:

معامل	نوع	الوصف
args	java.lang.Object[]	المعاملات.

Returns: ImageOptionsBase - Default options

getModifyDate(boolean useDefault)

public Date getModifyDate(boolean useDefault)

احصل بسرعة على التاريخ والوقت عندما تم تعديل صورة المورد آخر مرة باستخدام هذه الطريقة سهلة الاستخدام. مثالي للمطورين الذين يحتاجون إلى تتبع التغييرات وإدارة الموارد بفعالية.

Parameters:

معامل	نوع	الوصف
useDefault	boolean	إذا تم تعيينه إلى true يستخدم المعلومات من FileInfo كقيمة افتراضية.

Returns: java.util.Date - التاريخ والوقت الذي تم فيه تعديل صورة المورد آخر مرة.

addPage(RasterImage page)

public void addPage(RasterImage page)

أضف صفحة جديدة إلى الصورة بسهولة باستخدام هذه الطريقة البديهية. مثالي للمطورين الذين يرغبون في توسيع محتوى ملفات الصور الخاصة بهم بشكل ديناميكي.

Parameters:

معامل	نوع	الوصف
page	RasterImage	الصفحة المراد إضافتها.

addFrame()

public ApngFrame addFrame()

/**

قم بإلحاق إطار جديد في نهاية مجموعة الإطارات الخاصة بك بسهولة باستخدام هذه الطريقة المبسطة. مثالي للمطورين الذين يرغبون في توسيع مجموعة إطاراتهم بشكل ديناميكي للرسوم المتحركة ذات الصور متعددة الإطارات. سيتم إنشاء إطار جديد وفقًا لحجم الصورة الحالية.

Returns: ApngFrame - The newly created APNG frame.

addFrame(RasterImage frameImage)

public void addFrame(RasterImage frameImage)

قم بتوسيع مجموعة الإطارات الخاصة بك بسهولة عن طريق إضافة إطار جديد في النهاية باستخدام هذه الطريقة البديهية. مثالي للمطورين الذين يرغبون في تحسين الرسوم المتحركة للصور متعددة الإطارات بشكل ديناميكي. سيتم ملء محتويات الإطار الجديد من الصورة المحددة.

Parameters:

معامل	نوع	الوصف
frameImage	RasterImage	صورة الإطار.

addFrame(RasterImage frameImage, long frameTime)

public void addFrame(RasterImage frameImage, long frameTime)

قم بتوسيع مجموعة الإطارات الخاصة بك بسلاسة عن طريق إلحاق إطار جديد إلى الـ مع هذه الطريقة البديهية. مثالي للمطورين الذين يتطلعون إلى إثراء الرسوم المتحركة للصور متعددة الإطارات. سيتم ملء محتويات الإطار الجديد من الصورة المحددة.

Parameters:

معامل	نوع	الوصف
frameImage	RasterImage	صورة الإطار.
frameTime	long	مدة الإطار، بالميليثانية.

insertFrame(int index)

public ApngFrame insertFrame(int index)

أدخل إطارًا جديدًا في مجموعة الإطارات الخاصة بك بسهولة عند المحدد مع هذه الطريقة البديهية. مثالي للمطورين الذين يسعون إلى تحكم دقيق في ترتيب الإطارات في الرسوم المتحركة للصور متعددة الإطارات. سيتم إنشاء إطار جديد وفقًا لحجم الصورة الحالية.

Parameters:

معامل	نوع	الوصف
index	int	المؤشر.

Returns: ApngFrame - The newly created APNG frame.

insertFrame(int index, RasterImage frameImage)

public void insertFrame(int index, RasterImage frameImage)

يدرج إطارًا جديدًا في مجموعة الإطارات الخاصة به عند الفهرس المحدد. سيتم ملء محتويات الإطار الجديد من الصورة المحددة.

Parameters:

معامل	نوع	الوصف
index	int	المؤشر.
frameImage	RasterImage	صورة الإطار.

insertFrame(int index, RasterImage frameImage, long frameTime)

public void insertFrame(int index, RasterImage frameImage, long frameTime)

يدرج إطارًا جديدًا في مجموعة الإطارات الخاصة به عند الفهرس المحدد. سيتم ملء محتويات الإطار الجديد من الصورة المحددة.

Parameters:

معامل	نوع	الوصف
index	int	المؤشر.
frameImage	RasterImage	صورة الإطار.
frameTime	long	مدة الإطار، بالميليثانية.

popFrameAt(int index)

public ApngFrame popFrameAt(int index)

قم بإزالة واسترجاع الإطار عند الفهرس المحدد من مجموعة الإطارات الخاصة بك باستخدام هذه الطريقة البديهية. مثالي للمطورين الذين يسعون إلى إدارة فعّالة للإطارات في الرسوم المتحركة الخاصة بهم.

Parameters:

معامل	نوع	الوصف
index	int	المؤشر.

Returns: ApngFrame - The removed APNG frame.

removeFrameAt(int index)

public void removeFrameAt(int index)

قم بإزالة الإطار عند الفهرس المحدد من مجموعة الإطارات الخاصة بك بسلاسة باستخدام هذه الطريقة. مثالي للمطورين الذين يسعون إلى إدارة مبسطة للإطارات في صورهم متعددة الإطارات. سيتم التخلص من الإطار الذي سيتم حذفه.

Parameters:

معامل	نوع	الوصف
index	int	المؤشر.

removeAllFrames()

public void removeAllFrames()

امسح مجموعة الإطارات الخاصة بك عن طريق إزالة جميع الإطارات باستخدام هذه الطريقة البديهية. مثالي للمطورين الذين يرغبون في إعادة ضبط أو تحديث الرسوم المتحركة الخاصة بهم.

setDefaultImage(RasterImage image)

public void setDefaultImage(RasterImage image)

قم بتعيين الصورة النقطية المحددة كصورة افتراضية للرسوم المتحركة الحالية بسهولة باستخدام هذه الطريقة. مثالي للمطورين الذين يرغبون في تخصيص الصورة الافتراضية في الرسوم المتحركة الخاصة بهم.

Parameters:

معامل	نوع	الوصف
image	RasterImage	الصورة.

resetDefaultImage()

public void resetDefaultImage()

قم بإزالة صورة افتراضية تم تعيينها مسبقًا باستخدام هذه الطريقة البديهية. مثالي للمطورين الذين يرغبون في إعادة ضبط أو مسح الصورة الافتراضية في الرسوم المتحركة الخاصة بهم. بعد ذلك، تصبح الصورة الافتراضية هي الإطار الأول في مجموعة الإطارات الخاصة به (لا يمكن حذفها باستخدام هذه الطريقة).