الفئة IcoImage

IcoImage class

قم بالتعامل بسهولة مع ملفات صور ICO باستخدام واجهة برمجة التطبيقات الخاصة بنا، مع دعم تنسيقات ملفات متعددة وأنواع إطارات تشمل PNG و BMP. خصّص إعدادات البتات لكل بكسل وقم بتحديث أبعاد الصورة بسلاسة، لضمان تمثيل مثالي وتوافق أيقوناتك عبر مختلف المنصات.

public class IcoImage : RasterCachedMultipageImage, IMultipageImageExt

المنشئات

الاسمالوصف
IcoImage(Image, IcoOptions)صُممت للبساطة والكفاءة، تمكّنك الفئة IcoImage من إنشاء صور ICO بسهولة. يقوم هذا المُنشئ بتهيئة نسخة جديدة من الفئة، موفرًا أساسًا قويًا لاحتياجاتك في تعديل الصور. سواءً كنت تطور تطبيقات أو تحسن واجهات المستخدم، تُبسّط الفئة IcoImage إدارة صور ICO، مما يتيح لك التركيز على تقديم تجارب استثنائية.
IcoImage(int, int, IcoOptions)ابدأ إنشاء صور ICO بسهولة باستخدام الفئة IcoImage. يتيح لك هذا المُنشئ تهيئة نسخ جديدة من صور ICO عن طريق تحديد عرض، ارتفاع، ومعلمات خيارات الإنشاء. باستخدام هذا المُنشئ البسيط، يمكنك تخصيص صور ICO وفقًا لمواصفاتك الدقيقة، مما يضمن توافقًا سلسًا وجاذبية بصرية عبر مختلف المنصات والأجهزة.

الخصائص

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

الطرق

الاسمالوصف
AddPage(Image)قم بإثراء صورة ICO الخاصة بك بسهولة عن طريق إدراج صفحة صورة باستخدام الإعدادات الافتراضية من IcoOptions. يقوم هذا الأسلوب بتحويل الصورة المُدخلة إلى صيغة PNG 32‑بت بسهولة، مما يضمن التوافق وجودة عرض عالية داخل صورة ICO. مثالي لدمج صور PNG بسلاسة في ملفات ICO بسهولة وكفاءة.
AddPage(RasterImage)وسّع صورة ICO الخاصة بك بإضافة صفحة صورة، مستفيدًا من IcoOptions. يدمج هذا الأسلوب صورًا نقطية في ملف ICO بسلاسة، محولًا إياها إلى صيغة PNG 32‑بت عالية الجودة. مثالي لتعزيز ملفات ICO بالصور النقطية مع ضمان التوافق الأمثل وجودة العرض.
AddPage(Image, IcoOptions)نوّع صورة ICO الخاصة بك بسهولة عبر دمج إدخال صورة مخصص وفقًا لاحتياجاتك باستخدام IcoOptions المحددة. يدمج هذا الأسلوب الصورة وفقًا للخيارات المخصصة الخاصة بك، مما يضمن المرونة والدقة في ملف ICO.
override AdjustBrightness(int)ضبط السطوع للصورة.
override AdjustContrast(float)Image متباين
override AdjustGamma(float)تصحيح جاما للصورة.
override AdjustGamma(float, float, float)تصحيح جاما للصورة.
override AnalyzePercentageDigitalSignature(string)يحسب نسبة التشابه بين البيانات المستخرجة وكلمة المرور الأصلية.
override AutoBrightnessContrast()ينفّذ تعديلًا تلقائيًا متكيفًا للسطوع والتباين عبر الصورة بأكملها.
AutoRotate()يقوم بتدوير الصورة تلقائيًا بناءً على بيانات الاتجاه المستخرجة من بيانات Exif. تضمن هذه الطريقة عرض الصور بالاتجاه الصحيح، مما يعزز تجربة المستخدم ويقضي على الحاجة إلى التعديلات اليدوية. من خلال تحليل معلومات Exif، يتم تدوير الصورة وفقًا لذلك، مما يوفر تجربة مشاهدة سلسة عبر مختلف المنصات والأجهزة. تبسط عملية التدوير الآلية معالجة الصور وتحسن قابلية الاستخدام العامة، خاصةً عند التعامل مع دفعات كبيرة من الصور ذات الاتجاهات المتنوعة.
override BinarizeBradley(double)تحويل الصورة إلى ثنائية باستخدام خوارزمية العتبة التكيفية لبرايدلي باستخدام عتبة الصورة المتكاملة.
override BinarizeBradley(double, int)تحويل الصورة إلى ثنائية باستخدام خوارزمية العتبة التكيفية لبرايدلي باستخدام عتبة الصورة المتكاملة.
override BinarizeFixed(byte)تحويل الصورة إلى ثنائية باستخدام عتبة محددة مسبقًا
override BinarizeOtsu()تحويل الصورة إلى ثنائية باستخدام عتبة Otsu
Blend(Point, RasterImage, byte)يمزج هذه النسخة من الصورة مع الصورة overlay.
override Blend(Point, RasterImage, Rectangle, byte)يمزج هذه النسخة من الصورة مع الصورة overlay.
override CacheData()يخزن البيانات بشكل خاص.
CanSave(ImageOptionsBase)يحدد ما إذا كان يمكن حفظ الصورة بالتنسيق المحدد الممثل بخيارات الحفظ الممررة.
override Crop(Rectangle)قص الصورة.
override Crop(int, int, int, int)قص الصورة مع إزاحات.
Dispose()يتخلص من المثيل الحالي.
Dither(DitheringMethod, int)يقوم بأداء التمويه على الصورة الحالية.
override Dither(DitheringMethod, int, IColorPalette)يقوم بأداء التمويه على الصورة الحالية.
override EmbedDigitalSignature(string)أدمج توقيعًا رقميًا بناءً على كلمة المرور المقدمة في كل صفحة من الصورة.
override 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)يحصل على بكسل صورة.
override GetSerializedStream(ImageOptionsBase, Rectangle, out int)يحول إلى aps.
GetSkewAngle()يحصل على زاوية الانحراف. هذه الطريقة قابلة للتطبيق على المستندات النصية الممسوحة ضوئيًا، لتحديد زاوية الانحراف عند المسح.
override Grayscale()تحويل الصورة إلى تمثيلها بتدرج الرمادي
override 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 الطرق.
override NormalizeAngle(bool, Color)يضبط الزاوية. هذه الطريقة قابلة للتطبيق على مستندات النص الممسوحة ضوئياً للتخلص من الانحراف. تستخدم هذه الطريقة GetSkewAngle وRotate الطرق.
override NormalizeHistogram()يضبط هيستوجرام الصورة — يضبط قيم البكسل لاستخدام كامل النطاق المتاح.
ReadArgb32ScanLine(int)يقرأ كامل سطر المسح وفقًا لفهرس سطر المسح المحدد.
ReadScanLine(int)يقرأ كامل سطر المسح وفقًا لفهرس سطر المسح المحدد.
override RemoveMetadata()يزيل بيانات التعريف الخاصة بهذه الصورة عن طريق تعيين قيمة XmpData إلى null.
RemovePage(int)قم بضبط صورة ICO بدقة عن طريق إزالة إدخال صورة محدد يقع في الفهرس المحدد داخل الملف. يوفر هذا الأسلوب تحكمًا دقيقًا في تكوين الصورة، مما يتيح لك تحسين ملف ICO بسهولة.
ReplaceColor(Color, byte, Color)يستبدل لونًا بآخر مع فرق مسموح ويحافظ على قيمة ألفا الأصلية لحفظ الحواف السلسة.
override ReplaceColor(int, byte, int)يستبدل لونًا بآخر مع فرق مسموح ويحافظ على قيمة ألفا الأصلية لحفظ الحواف السلسة.
ReplaceNonTransparentColors(Color)يستبدل جميع الألوان غير الشفافة بلون جديد ويحافظ على قيمة ألفا الأصلية لحفظ الحواف السلسة. ملاحظة: إذا استخدمتها على صور بدون شفافية، سيتم استبدال جميع الألوان بلون واحد.
override ReplaceNonTransparentColors(int)يستبدل جميع الألوان غير الشفافة بلون جديد ويحافظ على قيمة ألفا الأصلية لحفظ الحواف السلسة. ملاحظة: إذا استخدمتها على صور بدون شفافية، سيتم استبدال جميع الألوان بلون واحد.
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)يقوم بتغيير عرض الصورة بشكل متناسب.
override Rotate(float)دوّر الصورة حول المركز.
override Rotate(float, bool, Color)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[])يحفظ بكسلات 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[])يكتب كامل سطر المسح إلى فهرس سطر المسح المحدد.

انظر أيضًا