ApngImage

ApngImage class

صورة PNG المتحركة .

public sealed class ApngImage : RasterCachedMultipageImage, IMultipageImageExt

المنشئون

اسم	وصف
ApngImage(ApngOptions, int, int)	يقوم بتهيئة مثيل جديد لملفApngImage فئة .

الخصائص

اسم	وصف
AutoAdjustPalette { get; set; }	الحصول على أو تعيين قيمة تشير إلى ما إذا كانت لوحة الضبط التلقائي.
override BackgroundColor { get; set; }	الحصول على أو تعيين قيمة للون الخلفية .
override BitsPerPixel { get; }	الحصول على عدد بتات الصورة لكل بكسل .
Bounds { get; }	يحصل على حدود الصورة .
BufferSizeHint { get; set; }	الحصول على أو تعيين تلميح حجم المخزن المؤقت الذي تم تحديده بالحجم الأقصى المسموح به لجميع المخازن المؤقتة الداخلية.
Container { get; }	يحصل على ملفImage حاوية .
DataStreamContainer { get; }	يحصل على دفق بيانات الكائن.
DefaultFrameTime { get; set; }	الحصول على أو تعيين مدة الإطار الافتراضية . يُستخدم عند إنشاء إطارات جديدة .
Disposed { get; }	يحصل على قيمة تشير إلى ما إذا كان هذا المثيل قد تم التخلص منه.
override FileFormat { get; }	يحصل على قيمة تنسيق الملف
override HasAlpha { get; }	يحصل على قيمة تشير إلى ما إذا كان هذا المثيل يحتوي على alpha.
virtual HasBackgroundColor { get; set; }	الحصول على أو تعيين قيمة تشير إلى ما إذا كانت الصورة لها لون خلفية.
override HasTransparentColor { get; }	يحصل على قيمة تشير إلى ما إذا كانت الصورة ذات لون شفاف.
override Height { get; }	الحصول على ارتفاع الصورة .
virtual HorizontalResolution { get; set; }	الحصول على أو تعيين الدقة الأفقية ، بالبكسل في البوصة ، لهذاRasterImage .
override ImageOpacity { get; }	يحصل على عتامة هذه الصورة .
Interlaced { get; }	يحصل على قيمة تشير إلى ما إذا كان هذاPngImage متشابك.
InterruptMonitor { get; set; }	الحصول على أو تعيين شاشة المقاطعة.
IsCached { get; }	يحصل على قيمة تشير إلى ما إذا كانت بيانات الصورة مخزنة مؤقتًا حاليًا.
IsRawDataAvailable { get; }	يحصل على قيمة تشير إلى ما إذا كان تحميل البيانات الأولية متاحًا.
NumPlays { get; set; }	الحصول على أو تعيين عدد مرات تكرار الرسوم المتحركة. 0 يشير إلى التكرار اللانهائي.
override PageCount { get; }	الحصول على عدد الصفحات .
override PageExportingAction { get; set; }	الحصول على إجراء تصدير الصفحة أو تعيينه . يرجى ملاحظة أن تعيين هذه الطريقة سيؤدي تلقائيًا إلى تحرير موارد الصفحة بعد تنفيذها. سيتم تنفيذها قبل حفظ كل صفحة مباشرةً.
override Pages { get; }	الحصول على الصفحات .
Palette { get; set; }	الحصول على لوحة الألوان أو تعيينها. لا يتم استخدام لوحة الألوان عندما يتم تمثيل وحدات البكسل مباشرةً.
virtual PremultiplyComponents { get; set; }	الحصول على أو تعيين قيمة تشير إلى ما إذا كان يجب مضاعفة مكونات الصورة مسبقًا.
RawCustomColorConverter { get; set; }	الحصول على أو تعيين محول الألوان المخصص
virtual RawDataFormat { get; }	يحصل على تنسيق البيانات الأولية.
RawDataSettings { get; }	يحصل على إعدادات البيانات الأولية الحالية. ملاحظة عند استخدام هذه الإعدادات ، يتم تحميل البيانات بدون تحويل.
RawFallbackIndex { get; set; }	الحصول على الفهرس الاحتياطي أو تعيينه لاستخدامه عندما يكون فهرس اللوحة خارج الحدود
RawIndexedColorConverter { get; set; }	الحصول على أو تعيين محول الألوان المفهرس
virtual RawLineSize { get; }	الحصول على حجم الخط الخام بالبايت.
Size { get; }	يحصل على حجم الصورة .
virtual TransparentColor { get; set; }	الحصول على لون شفاف للصورة .
virtual UpdateXmpData { get; set; }	الحصول على أو تعيين قيمة تشير إلى ما إذا كان سيتم تحديث بيانات تعريف XMP.
override UsePalette { get; }	يحصل على قيمة تشير إلى ما إذا كانت لوحة الصور مستخدمة.
virtual UseRawData { get; set; }	الحصول على أو تعيين قيمة تشير إلى ما إذا كان سيتم استخدام تحميل البيانات الأولية عند توفر تحميل البيانات الأولية.
virtual VerticalResolution { get; set; }	الحصول على أو تحديد الدقة الرأسية ، بالبكسل في البوصة ، لهذاRasterImage .
override Width { get; }	الحصول على عرض الصورة .
override XmpData { get; set; }	الحصول على بيانات تعريف XMP أو تعيينها.

طُرق

اسم	وصف
AddFrame()	يضيف إطارًا جديدًا إلى نهاية مجموعة الإطارات الخاصة . سيتم إنشاء إطار جديد وفقًا لحجم الصورة الحالية.
AddFrame(RasterImage)	يضيف إطارًا جديدًا إلى نهاية مجموعة الإطارات الخاصة . سيتم ملء محتويات الإطار الجديد من الصورة المحددة.
AddFrame(RasterImage, uint)	يضيف إطارًا جديدًا إلى نهاية مجموعة الإطارات الخاصة . سيتم ملء محتويات الإطار الجديد من الصورة المحددة.
AddPage(RasterImage)	يضيف صفحة للصورة.
override AdjustBrightness(int)	ضبط أbrightness للصورة .
override AdjustContrast(float)	Image التباين
override AdjustGamma(float)	تصحيح جاما لصورة .
override AdjustGamma(float, float, float)	تصحيح جاما لصورة .
override BinarizeBradley(double)	ثنائية الصورة باستخدام خوارزمية العتبة التكيفية لبرادلي باستخدام عتبة الصورة المتكاملة
override BinarizeBradley(double, int)	ثنائية الصورة باستخدام خوارزمية العتبة التكيفية لبرادلي باستخدام عتبة الصورة المتكاملة
override BinarizeFixed(byte)	ثنائية الصورة مع عتبة محددة مسبقًا
override BinarizeOtsu()	ثنائية الصورة مع عتبة Otsu
override CacheData()	تخزين البيانات الخاصة.
CanSave(ImageOptionsBase)	يحدد ما إذا كان يمكن حفظ الصورة بتنسيق الملف المحدد الذي تم تمثيله بواسطة خيارات الحفظ التي تم تمريرها.
override Crop(Rectangle)	اقتصاص الصورة .
override Crop(int, int, int, int)	اقتصاص الصورة مع التحولات .
Dispose()	التخلص من المثيل الحالي .
Dither(DitheringMethod, int)	يقوم بالتردد على الصورة الحالية.
override Dither(DitheringMethod, int, IColorPalette)	يقوم بالتردد على الصورة الحالية.
override Filter(Rectangle, FilterOptionsBase)	يقوم بتصفية المستطيل المحدد .
GetArgb32Pixel(int, int)	الحصول على صورة ARGB بكسل 32 بت .
GetDefaultArgb32Pixels(Rectangle)	الحصول على صفيف ARGB بكسل الافتراضي 32 بت.
override GetDefaultOptions(object[])	يحصل على الخيارات الافتراضية .
GetDefaultPixels(Rectangle, IPartialArgb32PixelLoader)	الحصول على مصفوفة البكسل الافتراضية باستخدام محمل البكسل الجزئي.
GetDefaultRawData(Rectangle, RawDataSettings)	يحصل على مصفوفة البيانات الأولية الافتراضية.
GetDefaultRawData(Rectangle, IPartialRawDataLoader, RawDataSettings)	الحصول على مصفوفة البيانات الأولية الافتراضية باستخدام محمل البكسل الجزئي.
override GetModifyDate(bool)	الحصول على تاريخ ووقت آخر تعديل لصورة المورد.
override GetOriginalOptions()	الحصول على الخيارات بناءً على إعدادات الملف الأصلية. يمكن أن يكون هذا مفيدًا للحفاظ على عمق البت والمعلمات الأخرى للصورة الأصلية دون تغيير . على سبيل المثال ، إذا قمنا بتحميل صورة PNG أبيض وأسود مع 1 بت لكل بكسل ثم احفظه باستخدام the Save الطريقة ، سيتم إنتاج صورة PNG الناتجة بمعدل 8 بت لكل بكسل. لتجنب ذلك وحفظ صورة PNG بمعدل 1 بت لكل بكسل ، استخدم هذه الطريقة للحصول على خيارات الحفظ المقابلة وتمريرها إلىSave الطريقة كمعامل ثاني.
GetPixel(int, int)	الحصول على بكسل صورة .
GetSkewAngle()	الحصول على زاوية الانحراف. هذه الطريقة قابلة للتطبيق على المستندات النصية الممسوحة ضوئيًا ، لتحديد زاوية الانحراف عند المسح.
override Grayscale()	تحويل الصورة إلى تمثيلها بالتدرج الرمادي
InsertFrame(int)	إدراج إطار جديد في مجموعة الإطارات الخاصة في الفهرس المحدد . سيتم إنشاء إطار جديد وفقًا لحجم الصورة الحالية.
InsertFrame(int, RasterImage)	إدراج إطار جديد في مجموعة الإطارات الخاصة في الفهرس المحدد. سيتم ملء محتويات الإطار الجديد من الصورة المحددة.
InsertFrame(int, RasterImage, uint)	إدراج إطار جديد في مجموعة الإطارات الخاصة في الفهرس المحدد. سيتم ملء محتويات الإطار الجديد من الصورة المحددة.
LoadArgb32Pixels(Rectangle)	تحميل 32 بت ARGB بكسل .
LoadArgb64Pixels(Rectangle)	تحميل 64 بت ARGB بكسل .
LoadCmyk32Pixels(Rectangle)	تحميل وحدات البكسل بتنسيق CMYK .
LoadPartialArgb32Pixels(Rectangle, IPartialArgb32PixelLoader)	تحميل 32 بت ARGB بكسل جزئيًا بواسطة الحزم.
LoadPartialPixels(Rectangle, IPartialPixelLoader)	يتم تحميل وحدات البكسل جزئيًا بالحزم .
LoadPixels(Rectangle)	تحميل بكسل .
LoadRawData(Rectangle, RawDataSettings, IPartialRawDataLoader)	تحميل البيانات الأولية .
LoadRawData(Rectangle, Rectangle, RawDataSettings, IPartialRawDataLoader)	تحميل البيانات الأولية .
NormalizeAngle()	تطبيع الزاوية. هذه الطريقة قابلة للتطبيق على المستندات النصية الممسوحة ضوئيًا للتخلص من المسح المنحرف. تستخدم هذه الطريقةGetSkewAngle وRotate الطرق .
override NormalizeAngle(bool, Color)	تطبيع الزاوية. هذه الطريقة قابلة للتطبيق على المستندات النصية الممسوحة ضوئيًا للتخلص من المسح المنحرف. تستخدم هذه الطريقة!:GetSkewAngle وRotate الطرق .
PopFrameAt(int)	يزيل ويعيد الإطار بالفهرس المحدد لمجموعة الإطارات الخاصة.
ReadArgb32ScanLine(int)	يقرأ خط المسح بالكامل بواسطة فهرس خط المسح المحدد.
ReadScanLine(int)	يقرأ خط المسح بالكامل بواسطة فهرس خط المسح المحدد.
RemoveAllFrames()	يزيل كل الإطارات من مجموعة الإطارات الخاصة .
RemoveFrameAt(int)	يزيل الإطار في الفهرس المحدد لمجموعة الإطارات الخاصة . سيتم التخلص من الإطار المراد حذفه .
ReplaceColor(Color, byte, Color)	يستبدل لونًا بآخر بالاختلاف المسموح به ويحتفظ بقيمة ألفا الأصلية لحفظ الحواف المتجانسة.
override ReplaceColor(int, byte, int)	يستبدل لونًا بآخر بالاختلاف المسموح به ويحتفظ بقيمة ألفا الأصلية لحفظ الحواف المتجانسة.
ReplaceNonTransparentColors(Color)	يستبدل كل الألوان غير الشفافة بلون جديد ويحتفظ بقيمة ألفا الأصلية لحفظ الحواف الناعمة . ملاحظة: إذا كنت تستخدمها على صور بدون شفافية ، فسيتم استبدال كل الألوان بواحد.
override ReplaceNonTransparentColors(int)	يستبدل كل الألوان غير الشفافة بلون جديد ويحتفظ بقيمة ألفا الأصلية لحفظ الحواف الناعمة . ملاحظة: إذا كنت تستخدمها على صور بدون شفافية ، فسيتم استبدال كل الألوان بأخرى.
ResetDefaultImage()	حذف صورة افتراضية تم تعيينها مسبقًا . بعد ذلك ، تكون الصورة الافتراضية هي الإطار الأول في مجموعة الإطارات الخاصة (لا يمكن حذفها باستخدام هذه الطريقة) .
Resize(int, int)	يغير حجم الصورة. الافتراضيNearestNeighbourResample يستخدم .
override Resize(int, int, ImageResizeSettings)	يغير حجم الصورة.
override Resize(int, int, ResizeType)	يغير حجم الصورة.
ResizeHeightProportionally(int)	يغير حجم الارتفاع بشكل متناسب. الافتراضيNearestNeighbourResample يستخدم .
virtual ResizeHeightProportionally(int, ImageResizeSettings)	يغير حجم الارتفاع بشكل متناسب .
override ResizeHeightProportionally(int, ResizeType)	يغير حجم العرض بشكل متناسب .
ResizeWidthProportionally(int)	يغير حجم العرض بشكل متناسب. الافتراضيNearestNeighbourResample يستخدم .
virtual ResizeWidthProportionally(int, ImageResizeSettings)	يغير حجم العرض بشكل متناسب .
override ResizeWidthProportionally(int, ResizeType)	يغير حجم العرض بشكل متناسب .
virtual Rotate(float)	تدوير الصورة حول المركز .
override Rotate(float, bool, Color)	!:RasterCahcedMultipageImage.Rotate الصورة حول المركز .
override RotateFlip(RotateFlipType)	يقوم بتدوير الإطار النشط فقط أو قلبه أو تدويره وقلبه.
Save()	يحفظ بيانات الصورة في التدفق الأساسي.
Save(Stream)	يحفظ بيانات الكائن في الدفق المحدد.
override Save(string)	يحفظ الصورة في موقع الملف المحدد.
Save(Stream, ImageOptionsBase)	يحفظ بيانات الصورة إلى التدفق المحدد بتنسيق الملف المحدد وفقًا لخيارات الحفظ.
virtual Save(string, bool)	يحفظ بيانات الكائن في موقع الملف المحدد.
virtual Save(string, ImageOptionsBase)	يحفظ بيانات الكائن في موقع الملف المحدد بتنسيق الملف المحدد وفقًا لخيارات الحفظ.
override Save(Stream, ImageOptionsBase, Rectangle)	يحفظ بيانات الصورة إلى التدفق المحدد بتنسيق الملف المحدد وفقًا لخيارات الحفظ.
virtual Save(string, ImageOptionsBase, Rectangle)	يحفظ بيانات الكائن في موقع الملف المحدد بتنسيق الملف المحدد وفقًا لخيارات الحفظ.
SaveArgb32Pixels(Rectangle, int[])	يحفظ 32 بت ARGB بكسل .
SaveCmyk32Pixels(Rectangle, int[])	يحفظ البكسل .
SavePixels(Rectangle, Color[])	يحفظ البكسل .
SaveRawData(byte[], int, Rectangle, RawDataSettings)	يحفظ البيانات الأولية .
SetArgb32Pixel(int, int, int)	يضبط صورة ARGB بكسل 32 بت للوضع المحدد.
SetDefaultImage(RasterImage)	يضبط الصورة النقطية المحددة كصورة افتراضية للرسوم المتحركة الحالية.
override SetPalette(IColorPalette, bool)	يضبط لوحة الصور .
SetPixel(int, int, Color)	يضبط بكسل الصورة للوضع المحدد.
virtual SetResolution(double, double)	يضبط الدقة لهذا الغرضRasterImage .
virtual ToBitmap()	تحويل الصورة النقطية إلى الصورة النقطية.
WriteArgb32ScanLine(int, int[])	يكتب خط المسح بالكامل إلى فهرس خط المسح المحدد.
WriteScanLine(int, Color[])	يكتب خط المسح بالكامل إلى فهرس خط المسح المحدد.

أمثلة

يوضح المثال التالي كيفية تصدير تنسيق ملف APNG من تنسيق آخر متعدد الصفحات غير متحرك.

[C#]

using Aspose.Imaging;
using Aspose.Imaging.ImageOptions;

using (Image image = Image.Load("img4.tif")) {
    // إعداد مدة الإطار الافتراضية
    image.Save("img4.tif.500ms.png", new ApngOptions() { DefaultFrameTime = 500 }); // 500 مللي ثانية
    image.Save("img4.tif.250ms.png", new ApngOptions() { DefaultFrameTime = 250 }); // 250 مللي ثانية
}

يوضح المثال التالي كيفية التصدير إلى تنسيق ملف APNG.

[C#]

using Aspose.Imaging;
using Aspose.Imaging.ImageOptions;

using (Image image = Image.Load("Animation1.webp")) {
    // تصدير إلى رسوم متحركة APNG مع دورات رسوم متحركة غير محدودة كإعداد افتراضي
    image.Save("Animation1.webp.png", new ApngOptions());
    // إعداد دورات الرسوم المتحركة
    image.Save("Animation2.webp.png", new ApngOptions() { NumPlays = 5 }); // 5 دورات
}

يوضح المثال التالي كيفية إنشاء صورة APNG من صورة نقطية أخرى أحادية الصفحة.

[C#]

using Aspose.Imaging;
using Aspose.Imaging.ImageOptions;
using Aspose.Imaging.FileFormats.Apng;

const int AnimationDuration = 1000; // 1 ثانية
const int FrameDuration = 70; // 70 مللي ثانية
using (RasterImage sourceImage = (RasterImage)Image.Load("not_animated.png"))
{
    ApngOptions createOptions = new ApngOptions
    {
        Source = new FileCreateSource("raster_animation.png", false),
        DefaultFrameTime = (uint)FrameDuration,
        ColorType = PngColorType.TruecolorWithAlpha,
    };

    using (ApngImage apngImage = (ApngImage)Image.Create(
        createOptions,
        sourceImage.Width,
        sourceImage.Height))
    {
        // من الممكن ضبط وقت الإطار الافتراضي للصورة هناك: apngImage.DefaultFrameTime = (uint) FrameDuration ;

        int numOfFrames = AnimationDuration / FrameDuration;
        int numOfFrames2 = numOfFrames / 2;

        // التنظيف لأن الصورة تحتوي على إطار واحد افتراضيًا
        apngImage.RemoveAllFrames();

        // إضافة الإطار الأول
        apngImage.AddFrame(sourceImage);

        // إضافة إطارات وسيطة
        for (int frameIndex = 1; frameIndex < numOfFrames - 1; ++frameIndex)
        {
            apngImage.AddFrame(sourceImage);
            ApngFrame lastFrame = (ApngFrame)apngImage.Pages[apngImage.PageCount - 1];
            float gamma = frameIndex >= numOfFrames2 ? numOfFrames - frameIndex - 1 : frameIndex;
            lastFrame.AdjustGamma(gamma);
        }

        // إضافة الإطار الأخير
        apngImage.AddFrame(sourceImage);

        apngImage.Save();
    }
}

أنظر أيضا

• class RasterCachedMultipageImage
• interface IMultipageImageExt
• مساحة الاسم Aspose.Imaging.FileFormats.Apng
• المجسم Aspose.Imaging