الفئة Image

Image class

الصورة هي الفئة الأساسية لجميع أنواع الصور.

public abstract class Image : DataStreamSupporter, IMetadataContainer, IObjectWithBounds

الخصائص

الاسمالوصف
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 HasBackgroundColor { get; set; }الحصول على أو تعيين قيمة تشير إلى ما إذا كانت الصورة لها لون خلفية.
abstract Height { get; }الحصول على ارتفاع الصورة.
InterruptMonitor { get; set; }الحصول على أو تعيين مراقب المقاطعة.
abstract IsCached { get; }يحصل على قيمة تشير إلى ما إذا كانت بيانات الكائن مخزنة مؤقتًا حاليًا ولا يلزم قراءة البيانات.
virtual Metadata { get; }يحصل على بيانات تعريف الصورة.
Palette { get; set; }يحصل أو يعيّن لوحة الألوان. لا تُستخدم لوحة الألوان عندما يتم تمثيل البكسلات مباشرةً.
Size { get; }يحصل على حجم الصورة.
virtual UsePalette { get; }يحصل على قيمة تشير إلى ما إذا كانت لوحة ألوان الصورة مستخدمة.
abstract Width { get; }يحصل على عرض الصورة.
XmpData { get; set; }يحصل أو يعيّن بيانات Xmp.

الطرق

الاسمالوصف
static Create(Image[])ينشئ صورة جديدة باستخدام الصور المحددة كصفحات
static Create(MultipageCreateOptions)ينشئ خيارات الإنشاء المتعددة الصفحات المحددة.
static Create(string[])ينشئ الصورة المتعددة الصفحات التي تحتوي على الملفات المحددة.
static Create(Image[], bool)ينشئ صورة جديدة باستخدام الصور المحددة كصفحات.
static Create(string[], bool)ينشئ الصورة المتعددة الصفحات التي تحتوي على الملفات المحددة.
static Create(ImageOptionsBase, int, int)ينشئ صورة جديدة باستخدام خيارات الإنشاء المحددة.
static Create(ImageOptionsBase, int, int, int[])ينشئ كائنًا من نوع RasterImage من مصفوفة البكسلات المقدمة. يتحقق من أن العرض والارتفاع المحددين يتطابقان مع أبعاد بيانات البكسل. لا يمكن استخدام هذه الطريقة إلا عندما تكون المكتبة في وضع الترخيص.
static Load(Stream)يقوم بتحميل صورة جديدة من الدفق المحدد.
static Load(string)يقوم بتحميل صورة جديدة من مسار الملف أو عنوان URL المحدد. إذا كان filePath مسار ملف، فإن الطريقة تفتح الملف فقط. إذا كان filePath عنوان URL، فإن الطريقة تقوم بتنزيل الملف، وتخزينه مؤقتًا، ثم فتحه.
static Load(Stream, LoadOptions)يقوم بتحميل صورة جديدة من الدفق المحدد.
static Load(string, LoadOptions)يقوم بتحميل صورة جديدة من مسار الملف أو عنوان URL المحدد. إذا كان filePath مسار ملف، فإن الطريقة تفتح الملف فقط. إذا كان filePath عنوان URL، فإن الطريقة تقوم بتنزيل الملف، وتخزينه مؤقتًا، ثم فتحه.
abstract CacheData()يقوم بتخزين البيانات مؤقتًا ويضمن عدم تحميل بيانات إضافية من DataStreamContainer الأساسي.
CanSave(ImageOptionsBase)يحدد ما إذا كان يمكن حفظ الصورة بالتنسيق المحدد الممثل بخيارات الحفظ الممررة.
virtual Crop(Rectangle)يقص المستطيل المحدد.
virtual Crop(int, int, int, int)قص الصورة مع إزاحات.
Dispose()يتخلص من المثيل الحالي.
virtual GetDefaultOptions(object[])يحصل على الخيارات الافتراضية.
virtual GetOriginalOptions()يحصل على الخيارات بناءً على إعدادات الملف الأصلي. يمكن أن يكون ذلك مفيدًا للحفاظ على عمق اللون وغيرها من معلمات الصورة الأصلية دون تغيير. على سبيل المثال، إذا قمنا بتحميل صورة PNG بالأبيض والأسود بعمق 1 بت لكل بكسل ثم حفظناها باستخدام طريقة Save، سيتم إنتاج صورة PNG ناتجة بعمق 8 بت لكل بكسل. لتجنب ذلك وحفظ صورة PNG بعمق 1 بت لكل بكسل، استخدم هذه الطريقة للحصول على خيارات الحفظ المقابلة ومررها إلى طريقة Save كمعامل ثانٍ.
virtual GetSerializedStream(ImageOptionsBase, Rectangle, out int)يحول إلى aps.
virtual RemoveMetadata()يزيل البيانات الوصفية.
Resize(int, int)يُعيد تحجيم الصورة. يتم استخدام NearestNeighbourResample الافتراضي.
abstract 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)يقوم بتغيير عرض الصورة بشكل متناسب.
virtual Rotate(float)دوّر الصورة حول المركز.
abstract RotateFlip(RotateFlipType)يدور أو يقلب أو يدور ويقلب الصورة.
Save()يحفظ بيانات الصورة إلى الدفق الأساسي.
Save(Stream)يحفظ بيانات الكائن إلى الدفق المحدد.
override Save(string)يحفظ الصورة إلى موقع الملف المحدد.
Save(Stream, ImageOptionsBase)يحفظ بيانات الصورة إلى الدفق المحدد بالتنسيق الملف المحدد وفقًا لخيارات الحفظ.
virtual Save(string, bool)يحفظ بيانات الكائن إلى موقع الملف المحدد.
virtual Save(string, ImageOptionsBase)يحفظ بيانات الكائن إلى موقع الملف المحدد بالتنسيق الملف المحدد وفقًا لخيارات الحفظ.
virtual Save(Stream, ImageOptionsBase, Rectangle)يحفظ بيانات الصورة إلى الدفق المحدد بالتنسيق الملف المحدد وفقًا لخيارات الحفظ.
virtual Save(string, ImageOptionsBase, Rectangle)يحفظ بيانات الكائن إلى موقع الملف المحدد بالتنسيق الملف المحدد وفقًا لخيارات الحفظ.
abstract SetPalette(IColorPalette, bool)يضبط لوحة ألوان الصورة.
virtual TrySetMetadata(IImageMetadataFormat)يحاول تعيين كائن metadata، إذا كان كائن Image هذا يدعم وينفذ النوع IImageMetadataFormat.
static CanLoad(Stream)يحدد ما إذا كان يمكن تحميل الصورة من الدفق المحدد.
static CanLoad(string)يحدد ما إذا كان يمكن تحميل الصورة من مسار الملف المحدد.
static CanLoad(Stream, LoadOptions)يحدد ما إذا كان يمكن تحميل الصورة من الدفق المحدد واختيارياً باستخدام loadOptions المحددة.
static CanLoad(string, LoadOptions)يحدد ما إذا كان يمكن تحميل الصورة من مسار الملف المحدد واختيارياً باستخدام خيارات الفتح المحددة.
static GetFileFormat(Stream)يحصل على تنسيق الملف.
static GetFileFormat(string)يحصل على تنسيق الملف.
static GetFittingRectangle(Rectangle, int, int)يحصل على المستطيل الذي يناسب الصورة الحالية.
static GetFittingRectangle(Rectangle, int[], int, int)يحصل على المستطيل الذي يناسب الصورة الحالية.
static GetProportionalHeight(int, int, int)يحصل على ارتفاع نسبي.
static GetProportionalWidth(int, int, int)يحصل على عرض نسبي.

أمثلة

تحديد ما إذا كانت اللوحة مستخدمة من قبل الصورة.

[C#]

using (var image = Image.Load(folder + "Sample.bmp"))
{
    if (image.UsePalette)
    {
        Console.WriteLine("The palette is used by the image");
    }
}

تغيير حجم الصورة باستخدام نوع التحجيم المحدد.

[C#]

using (var image = Image.Load("Photo.jpg"))
{
    image.Resize(640, 480, ResizeType.CatmullRom);
    image.Save("ResizedPhoto.jpg");

    image.Resize(1024, 768, ResizeType.CubicConvolution);
    image.Save("ResizedPhoto2.jpg");

    var resizeSettings = new ImageResizeSettings
    {
        Mode = ResizeType.CubicBSpline,
        FilterType = ImageFilterType.SmallRectangular
    };

    image.Resize(800, 800, resizeSettings);
    image.Save("ResizedPhoto3.jpg");
}

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

[C#]

//أنشئ مثيلاً من BmpOptions وعيّن خصائصه المتنوعة
Aspose.Imaging.ImageOptions.BmpOptions bmpOptions = new Aspose.Imaging.ImageOptions.BmpOptions();
bmpOptions.BitsPerPixel = 24;

//أنشئ مثيلاً من FileCreateSource وعيّنها كمصدر للمثيل من BmpOptions
//المعامل المنطقي الثاني يحدد ما إذا كان الملف الذي سيُنشأ مؤقتًا أم لا
bmpOptions.Source = new Aspose.Imaging.Sources.FileCreateSource(@"C:\temp\output.bmp", false);

//إنشاء كائن من نوع Image وتهيئته بكائن BmpOptions عن طريق استدعاء طريقة Create.
using (Aspose.Imaging.Image image = Aspose.Imaging.Image.Create(bmpOptions, 500, 500))
{
    //قم ببعض معالجة الصورة.

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

انظر أيضًا

الواجهة IRasterImageRawDataLoader تعداد Image.ImageOperation