فئة RasterImage

RasterImage class

يمثل صورة نقطية تدعم عمليات الرسومات النقطية.

public abstract class RasterImage : Image, IRasterImageArgb32PixelLoader

الخصائص

الاسمالوصف
AutoAdjustPalette { get; set; }الحصول على أو تعيين قيمة تشير إلى ما إذا كان يتم تعديل اللوحة تلقائيًا.
virtual BackgroundColor { get; set; }الحصول على أو تعيين قيمة للون الخلفية.
abstract BitsPerPixel { get; }الحصول على عدد البتات لكل بكسل في الصورة.
Bounds { get; }الحصول على حدود الصورة.
BufferSizeHint { get; set; }الحصول على أو تعيين تلميح حجم المخزن المؤقت الذي يحدد الحد الأقصى المسموح به لجميع المخازن الداخلية.
Container { get; }يحصل على حاوية Image.
DataStreamContainer { get; }الحصول على تدفق بيانات الكائن.
Disposed { get; }يحصل على قيمة تشير إلى ما إذا كان هذا المثال تم التخلص منه.
ExifData { get; set; }الحصول على أو تعيين بيانات Exif.
virtual FileFormat { get; }يحصل على قيمة تنسيق الملف
virtual HasAlpha { get; }يحصل على قيمة تشير إلى ما إذا كان هذا الكائن يحتوي على ألفا.
virtual HasBackgroundColor { get; set; }الحصول على أو تعيين قيمة تشير إلى ما إذا كانت الصورة لها لون خلفية.
virtual HasTransparentColor { get; set; }يحصل أو يعيّن قيمة تشير إلى ما إذا كانت هذه المثيلة RasterImage لها لون شفاف.
abstract Height { get; }الحصول على ارتفاع الصورة.
virtual HorizontalResolution { get; set; }يحصل أو يعيّن الدقة الأفقية، بوحدة البكسل لكل بوصة، لهذه RasterImage.
virtual ImageOpacity { get; }الحصول على شفافية هذه الصورة.
InterruptMonitor { get; set; }الحصول على أو تعيين مراقب المقاطعة.
abstract IsCached { get; }يحصل على قيمة تشير إلى ما إذا كانت بيانات الكائن مخزنة مؤقتًا حاليًا ولا يلزم قراءة البيانات.
IsRawDataAvailable { get; }الحصول على قيمة تشير إلى ما إذا كان تحميل البيانات الخام متاحًا.
virtual Metadata { 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.
abstract Width { get; }يحصل على عرض الصورة.
XmpData { get; set; }يحصل أو يعيّن بيانات Xmp.

الطرق

الاسمالوصف
virtual AdjustBrightness(int)ضبط السطوع للصورة.
virtual AdjustContrast(float)تباين الصورة
virtual AdjustGamma(float)تصحيح جاما للصورة.
virtual AdjustGamma(float, float, float)تصحيح جاما للصورة.
virtual AnalyzePercentageDigitalSignature(string)يحسب نسبة التشابه بين البيانات المستخرجة وكلمة المرور الأصلية.
virtual AutoBrightnessContrast()تطبيع تلقائي متكيف للسطوع والتباين لكامل الصورة.
AutoRotate()يقوم بتدوير الصورة تلقائيًا بناءً على بيانات الاتجاه المستخرجة من بيانات Exif. تضمن هذه الطريقة عرض الصور بالاتجاه الصحيح، مما يعزز تجربة المستخدم ويقضي على الحاجة إلى التعديلات اليدوية. من خلال تحليل معلومات Exif، يتم تدوير الصورة وفقًا لذلك، مما يوفر تجربة مشاهدة سلسة عبر مختلف المنصات والأجهزة. تبسط عملية التدوير الآلية معالجة الصور وتحسن قابلية الاستخدام العامة، خاصةً عند التعامل مع دفعات كبيرة من الصور ذات الاتجاهات المتنوعة.
virtual BinarizeBradley(double)تحويل الصورة إلى ثنائية باستخدام خوارزمية العتبة التكيفية لبرايدلي باستخدام عتبة الصورة المتكاملة.
virtual BinarizeBradley(double, int)تحويل الصورة إلى ثنائية باستخدام خوارزمية العتبة التكيفية لبرايدلي باستخدام عتبة الصورة المتكاملة.
virtual BinarizeFixed(byte)تحويل الصورة إلى ثنائية باستخدام عتبة محددة مسبقًا
virtual BinarizeOtsu()تحويل الصورة إلى ثنائية باستخدام عتبة Otsu
Blend(Point, RasterImage, byte)يمزج هذه النسخة من الصورة مع الصورة overlay.
virtual Blend(Point, RasterImage, Rectangle, byte)يمزج هذه النسخة من الصورة مع الصورة overlay.
abstract CacheData()يقوم بتخزين البيانات مؤقتًا ويضمن عدم تحميل بيانات إضافية من DataStreamContainer الأساسي.
CanSave(ImageOptionsBase)يحدد ما إذا كان يمكن حفظ الصورة بالتنسيق المحدد الممثل بخيارات الحفظ الممررة.
virtual Crop(Rectangle)يقص المستطيل المحدد.
virtual Crop(int, int, int, int)قص الصورة مع إزاحات.
Dispose()يتخلص من المثيل الحالي.
Dither(DitheringMethod, int)يقوم بأداء التمويه على الصورة الحالية.
abstract Dither(DitheringMethod, int, IColorPalette)يقوم بأداء التمويه على الصورة الحالية.
virtual EmbedDigitalSignature(string)إدراج توقيع رقمي بناءً على كلمة المرور المقدمة داخل الصورة باستخدام تقنية التضمين.
virtual Filter(Rectangle, FilterOptionsBase)يفلتر المستطيل المحدد.
GetArgb32Pixel(int, int)يحصل على بكسل صورة 32-بت ARGB.
GetDefaultArgb32Pixels(Rectangle)يحصل على مصفوفة بكسلات 32-بت ARGB الافتراضية.
virtual GetDefaultOptions(object[])يحصل على الخيارات الافتراضية.
GetDefaultPixels(Rectangle, IPartialArgb32PixelLoader)يحصل على مصفوفة البكسلات الافتراضية باستخدام محمل البكسل الجزئي.
GetDefaultRawData(Rectangle, RawDataSettings)يحصل على مصفوفة البيانات الخام الافتراضية.
GetDefaultRawData(Rectangle, IPartialRawDataLoader, RawDataSettings)يحصل على مصفوفة البيانات الخام الافتراضية باستخدام محمل البكسل الجزئي.
virtual GetModifyDate(bool)يحصل على تاريخ ووقت آخر تعديل لصورة المورد.
virtual GetOriginalOptions()يحصل على الخيارات بناءً على إعدادات الملف الأصلي. يمكن أن يكون هذا مفيدًا للحفاظ على عمق اللون والمعلمات الأخرى للصورة الأصلية دون تغيير. على سبيل المثال، إذا قمنا بتحميل صورة PNG بالأبيض والأسود بعمق 1 بت لكل بكسل ثم حفظناها باستخدام طريقة Save، سيتم إنتاج صورة PNG ناتجة بعمق 8 بت لكل بكسل. لتجنب ذلك وحفظ صورة PNG بعمق 1 بت لكل بكسل، استخدم هذه الطريقة للحصول على خيارات الحفظ المقابلة ومرّرها إلى طريقة Save كمعامل ثانٍ.
GetPixel(int, int)يحصل على بكسل صورة.
virtual GetSerializedStream(ImageOptionsBase, Rectangle, out int)يحول إلى aps.
GetSkewAngle()يحصل على زاوية الانحراف. هذه الطريقة قابلة للتطبيق على المستندات النصية الممسوحة ضوئيًا، لتحديد زاوية الانحراف عند المسح.
virtual Grayscale()تحويل الصورة إلى تمثيلها بتدرج الرمادي
virtual IsDigitalSigned(string, int)يُجري فحصًا سريعًا لتحديد ما إذا كانت الصورة موقعة رقمياً، باستخدام كلمة المرور والحدّ المحدد.
LoadArgb32Pixels(Rectangle)يحمّل بكسلات ARGB 32‑بت.
LoadArgb64Pixels(Rectangle)يحمّل بكسلات ARGB 64‑بت.
LoadCmyk32Pixels(Rectangle)يحمّل بكسلات بتنسيق CMYK.
LoadPartialArgb32Pixels(Rectangle, IPartialArgb32PixelLoader)يحمّل بكسلات ARGB 32‑بت جزئيًا عن طريق الحزم.
LoadPartialArgb64Pixels(Rectangle, IPartialArgb64PixelLoader)يحمّل بكسلات ARGB 64‑بت جزئيًا عن طريق الحزم.
LoadPartialPixels(Rectangle, IPartialPixelLoader)يحمّل البكسلات جزئيًا عن طريق الحزم.
LoadPixels(Rectangle)يحمّل البكسلات.
LoadRawData(Rectangle, RawDataSettings, IPartialRawDataLoader)يحمّل البيانات الخام.
LoadRawData(Rectangle, Rectangle, RawDataSettings, IPartialRawDataLoader)يحمّل البيانات الخام.
NormalizeAngle()يُطبع الزاوية. هذه الطريقة قابلة للتطبيق على مستندات النص الممسوحة ضوئيًا للتخلص من الانحراف. تستخدم هذه الطريقة الأساليب GetSkewAngle وRotate.
virtual NormalizeAngle(bool, Color)يُطبع الزاوية. هذه الطريقة قابلة للتطبيق على مستندات النص الممسوحة ضوئيًا للتخلص من الانحراف. تستخدم هذه الطريقة الأساليب GetSkewAngle وRotate.
virtual NormalizeHistogram()يضبط هيستوجرام الصورة — يضبط قيم البكسل لاستخدام كامل النطاق المتاح.
ReadArgb32ScanLine(int)يقرأ كامل سطر المسح وفقًا لفهرس سطر المسح المحدد.
ReadScanLine(int)يقرأ كامل سطر المسح وفقًا لفهرس سطر المسح المحدد.
override RemoveMetadata()يزيل بيانات التعريف الخاصة بهذه الصورة عن طريق تعيين قيمة XmpData إلى null.
ReplaceColor(Color, byte, Color)يستبدل لونًا بآخر مع فرق مسموح ويحافظ على قيمة ألفا الأصلية لحفظ الحواف السلسة.
virtual ReplaceColor(int, byte, int)يستبدل لونًا بآخر مع فرق مسموح ويحافظ على قيمة ألفا الأصلية لحفظ الحواف السلسة.
ReplaceNonTransparentColors(Color)يستبدل جميع الألوان غير الشفافة بلون جديد ويحافظ على قيمة ألفا الأصلية لحفظ الحواف السلسة. ملاحظة: إذا استخدمتها على صور بدون شفافية، سيتم استبدال جميع الألوان بلون واحد.
virtual ReplaceNonTransparentColors(int)يستبدل جميع الألوان غير الشفافة بلون جديد ويحافظ على قيمة ألفا الأصلية لحفظ الحواف السلسة. ملاحظة: إذا استخدمتها على صور بدون شفافية، سيتم استبدال جميع الألوان بلون واحد.
Resize(int, int)يُعيد تحجيم الصورة. يتم استخدام NearestNeighbourResample الافتراضي.
override Resize(int, int, ImageResizeSettings)يعيد تحجيم الصورة باستخدام خيارات موسعة.
virtual Resize(int, int, ResizeType)تغيير حجم الصورة.
ResizeHeightProportionally(int)يُعيد تحجيم الارتفاع بنسبية. يتم استخدام NearestNeighbourResample الافتراضي.
virtual ResizeHeightProportionally(int, ImageResizeSettings)يُعيد تحجيم الارتفاع بنسبية.
virtual ResizeHeightProportionally(int, ResizeType)يُعيد تحجيم الارتفاع بنسبية.
ResizeWidthProportionally(int)يقوم بتغيير عرض الصورة بشكل متناسب. يتم استخدام NearestNeighbourResample الافتراضي.
virtual ResizeWidthProportionally(int, ImageResizeSettings)يقوم بتغيير عرض الصورة بشكل متناسب.
virtual ResizeWidthProportionally(int, ResizeType)يقوم بتغيير عرض الصورة بشكل متناسب.
override Rotate(float)دوّر الصورة حول المركز.
virtual Rotate(float, bool, Color)دوّر الصورة حول المركز.
abstract 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[])يحفظ بكسلات ARGB 32 بت.
SaveCmyk32Pixels(Rectangle, int[])يحفظ البكسلات.
SavePixels(Rectangle, Color[])يحفظ البكسلات.
SaveRawData(byte[], int, Rectangle, RawDataSettings)يحفظ البيانات الخام.
SetArgb32Pixel(int, int, int)يضبط بكسل صورة ARGB 32 بت للموقع المحدد.
override SetPalette(IColorPalette, bool)يضبط لوحة ألوان الصورة.
SetPixel(int, int, Color)يضبط بكسل الصورة للموقع المحدد.
virtual SetResolution(double, double)يعيّن الدقة لهذه RasterImage.
virtual ToBitmap()يحوّل الصورة النقطية إلى bitmap. هذه الطريقة غير مدعومة في الإصدارات بدءًا من .Net7.0 وما فوق.
virtual TrySetMetadata(IImageMetadataFormat)يحاول تعيين مثيل metadata، إذا كان هذا المثيل Image يدعم ويطبق النوع IImageMetadataFormat.
WriteArgb32ScanLine(int, int[])يكتب كامل سطر المسح إلى فهرس سطر المسح المحدد.
WriteScanLine(int, Color[])يكتب كامل سطر المسح إلى فهرس سطر المسح المحدد.

أمثلة

يوضح هذا المثال كيفية تحميل معلومات البكسل في مصفوفة من النوع Color، تعديل المصفوفة وإعادتها إلى الصورة. لتنفيذ هذه العمليات، ينشئ هذا المثال ملف صورة جديد (بتنسيق GIF) باستخدام كائن MemoryStream.

[C#]

//إنشاء مثيل من MemoryStream
using (System.IO.MemoryStream stream = new System.IO.MemoryStream())
{
    //إنشاء مثيل من GifOptions وتعيين خصائصه المتنوعة بما في ذلك خاصية Source
    Aspose.Imaging.ImageOptions.GifOptions gifOptions = new Aspose.Imaging.ImageOptions.GifOptions();
    gifOptions.Source = new Aspose.Imaging.Sources.StreamSource(stream);

    //إنشاء مثيل من Image
    using (Aspose.Imaging.RasterImage image = (Aspose.Imaging.RasterImage)Aspose.Imaging.Image.Create(gifOptions, 500, 500))
    {
        //احصل على بكسلات الصورة عن طريق تحديد المنطقة كحدود الصورة
        Aspose.Imaging.Color[] pixels = image.LoadPixels(image.Bounds);

        //التكرار عبر المصفوفة وتعيين لون البكسل المفهرس البديل
        for (int index = 0; index < pixels.Length; index++)
        {
            if (index % 2 == 0)
            {
                //تعيين لون البكسل المفهرس إلى الأصفر
                pixels[index] = Aspose.Imaging.Color.Yellow;
            }
            else
            {
                //تعيين لون البكسل المفهرس إلى الأزرق
                pixels[index] = Aspose.Imaging.Color.Blue;
            }
        }

        //تطبيق تغييرات البكسل على الصورة
        image.SavePixels(image.Bounds, pixels);

        // احفظ جميع التغييرات.
        image.Save();
    }

    // كتابة MemoryStream إلى ملف
    using (System.IO.FileStream fileStream = new System.IO.FileStream(@"C:\temp\output.gif", System.IO.FileMode.Create))
    {
        stream.WriteTo(fileStream);
    }   
}

انظر أيضًا

الفئة RasterCachedMultipageImage الفئة RawDataSettings