الفئة Jpeg2000Image

Jpeg2000Image class

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

public sealed class Jpeg2000Image : RasterCachedImage

المنشئات

الاسمالوصف
Jpeg2000Image(RasterImage)أنشئ كائنًا جديدًا من الفئة Jpeg2000Image باستخدام صورة نقطية. يسهّل هذا المُنشئ إنشاء صورة JPEG2000 من صورة نقطية موجودة، موفرًا تكاملًا سلسًا وتحويلًا بين صيغ الصور المختلفة.
Jpeg2000Image(Stream)قم بتهيئة نسخة جديدة من الفئة Jpeg2000Image بسهولة عن طريق توفير كائن تدفق. يبسط هذا المُنشئ عملية تحميل صور JPEG2000 مباشرةً من التدفقات، موفرًا مرونة وراحة في التعامل مع بيانات الصور من مصادر متعددة.
Jpeg2000Image(string)ابدأ العمل مع الفئة Jpeg2000Image بتهيئة نسخة جديدة باستخدام مسار الصورة التي تريد تحميلها. يتيح هذا المُنشئ الوصول السهل إلى صور JPEG2000، مبسطًا عملية تحميل ومعالجة ملفات الصور. من خلال توفير مسار الملف، يمكنك البدء بسرعة في معالجة وتعديل صور JPEG2000 في تطبيقك.
Jpeg2000Image(int, int)أنشئ نسخة جديدة من الفئة Jpeg2000Image مع تحديد معلمات العرض والارتفاع. يتيح هذا المُنشئ تهيئة صورة JPEG2000 بأبعاد محددة، وهو مفيد في السيناريوهات التي تحتاج فيها إلى إنشاء صورة بحجم معين برمجيًا.
Jpeg2000Image(RasterImage, int)قم بتهيئة نسخة جديدة من Jpeg2000Image باستخدام صورة نقطية ومعلمات البتات لكل بكسل. يتيح هذا المُنشئ تحكمًا دقيقًا في جودة وحجم صورة JPEG2000 الناتجة، مما يجعله مثاليًا للسيناريوهات التي تكون فيها التخصيص ضروريًا.
Jpeg2000Image(Stream, int)قم بتهيئة نسخة جديدة من الفئة Jpeg2000Image باستخدام تدفق لتحميل الصورة، بالإضافة إلى معلمات البتات لكل بكسل. يوفر هذا المُنشئ مرونة من خلال السماح لك بتحديد كل من مصدر بيانات الصورة والبتات المطلوبة لكل بكسل، مما يمنح تحكمًا أدق في عملية تحميل الصورة.
Jpeg2000Image(string, int)ابدأ بسهولة مع الفئة Jpeg2000Image بإنشاء نسخة جديدة باستخدام كل من مسار الملف ومعلمة البتات المطلوبة لكل بكسل. يتيح هذا المُنشئ ضبط عملية تحميل الصورة بدقة، مما يضمن التوافق مع صيغ الصور المختلفة وإعدادات الجودة. بفضل هذه المرونة، يمكنك إدارة وتعديل صور JPEG2000 بفعالية وفقًا لمتطلباتك الخاصة.
Jpeg2000Image(int, int, int)أنشئ نسخة جديدة من الفئة Jpeg2000Image مع معلمات العرض والارتفاع وعدد البتات. يتيح هذا المُنشئ إنشاء صور JPEG2000 بأبعاد وعمق بتات محددين، موفرًا مرونة لتلبية احتياجات التصوير المختلفة.
Jpeg2000Image(int, int, Jpeg2000Options)أنشئ كائنًا جديدًا من Jpeg2000Image، مع توفير معلمات العرض والارتفاع وخيارات الصورة. يتيح هذا المُنشئ إنشاء صور JPEG2000 بأبعاد محددة وخيارات إضافية، مما يوفر مرونة في توليد الصور.

الخصائص

الاسمالوصف
AutoAdjustPalette { get; set; }الحصول على أو تعيين قيمة تشير إلى ما إذا كان يتم تعديل اللوحة تلقائيًا.
virtual BackgroundColor { get; set; }الحصول على أو تعيين قيمة للون الخلفية.
override BitsPerPixel { get; }تُعيد هذه الخاصية عمق الصورة، مقاسًا بالبتات لكل بكسل (bpp). تُظهر كمية معلومات اللون المخزنة في كل بكسل من الصورة. فهم عمق الصورة أمر حاسم لتحديد دقة الألوان وجودة الصورة. باستخدام هذه المعلومات، يمكن للمستخدمين تقييم مستوى التفاصيل وغنى الألوان الموجود في الصورة.
Bounds { get; }الحصول على حدود الصورة.
BufferSizeHint { get; set; }الحصول على أو تعيين تلميح حجم المخزن المؤقت الذي يحدد الحد الأقصى المسموح به لجميع المخازن الداخلية.
Codec { get; }تسترجع هذه الخاصية برنامج الترميز JPEG2000 المرتبط بالصورة. برنامج الترميز JPEG2000 مسؤول عن ترميز وفك ترميز بيانات الصورة بصيغة JPEG2000، موفرًا ضغطًا فعالًا مع الحفاظ على جودة صورة عالية. يمكن أن يكون الوصول إلى هذا البرنامج مفيدًا لإجراء عمليات معالجة صور متقدمة أو تحسين إعدادات ضغط الصورة وفقًا لمتطلبات محددة.
Comments { get; set; }تسمح هذه الخاصية باسترجاع أو تحديث التعليقات المرتبطة بالصورة. توفر التعليقات معلومات إضافية حول محتوى الصورة، مثل الشروحات أو الوصف أو البيانات الوصفية. تعديل هذه التعليقات يمكن أن يكون مفيدًا لتنظيم وتصنيف الصور، وكذلك لنقل تفاصيل مهمة للمشاهدين أو المستخدمين.
Container { get; }الحصول على حاوية Image.
DataStreamContainer { get; }الحصول على تدفق بيانات الكائن.
Disposed { get; }يحصل على قيمة تشير إلى ما إذا كان هذا المثال تم التخلص منه.
ExifData { get; set; }الحصول على أو تعيين بيانات Exif.
override FileFormat { get; }استرجع تنسيق ملف الصورة. تُوفر هذه الخاصية معلومات حول تنسيق ملف الصورة. استخدم هذه الخاصية لتحديد تنسيق ملف الصورة برمجيًا، مما يسهل التعامل المناسب والمعالجة بناءً على تنسيق الملف.
virtual HasAlpha { get; }يحصل على قيمة تشير إلى ما إذا كان هذا الكائن يحتوي على ألفا.
virtual HasBackgroundColor { get; set; }الحصول على أو تعيين قيمة تشير إلى ما إذا كانت الصورة لها لون خلفية.
virtual HasTransparentColor { get; set; }يحصل أو يعيّن قيمة تشير إلى ما إذا كان هذا RasterImage يحتوي على لون شفاف.
override Height { get; }تسترجع هذه الخاصية ارتفاع الصورة بالبكسل. تُعد هذه المعلومة أساسية لفهم الأبعاد العمودية للصورة، وتساعد في مهام معالجة الصور المختلفة مثل تغيير الحجم والقص والعرض. يتيح الوصول إلى هذه الخاصية للمستخدمين معرفة الحجم العمودي للصورة، مما يمكّن من تخطيط وعرض دقيق في التطبيقات.
override HorizontalResolution { get; set; }تسمح لك هذه الخاصية باسترجاع أو تعديل الدقة الأفقية لـ RasterImage، مقاسة بالبكسل لكل بوصة (PPI). يمكن أن يؤثر تعديل هذه الدقة على حجم وجودة الصورة عند الطباعة أو العرض. من خلال ضبط الدقة الأفقية، يمكن للمستخدمين تحسين الصورة لأجهزة الإخراج أو التطبيقات المحددة، لضمان أفضل نتائج بصرية ممكنة.
virtual ImageOpacity { get; }الحصول على شفافية هذه الصورة.
InterruptMonitor { get; set; }الحصول على أو تعيين مراقب المقاطعة.
override IsCached { get; }الحصول على قيمة تشير إلى ما إذا كانت بيانات الصورة مخزنة مؤقتًا حاليًا.
IsRawDataAvailable { get; }الحصول على قيمة تشير إلى ما إذا كان تحميل البيانات الخام متاحًا.
virtual Metadata { get; }يحصل على بيانات تعريف الصورة.
Palette { get; set; }يحصل أو يعيّن لوحة الألوان. لا تُستخدم لوحة الألوان عندما يتم تمثيل البكسلات مباشرةً.
virtual PremultiplyComponents { get; set; }يحصل أو يعيّن قيمة تشير إلى ما إذا كان يجب ضرب مكونات الصورة مسبقًا.
RawCustomColorConverter { get; set; }يحصل أو يعيّن محول الألوان المخصص
override RawDataFormat { get; }تسترجع هذه الخاصية تنسيق البيانات الخام للصورة. تُوفر معلومات حول كيفية تخزين بيانات البكسل في الذاكرة. استخدم هذه الخاصية لفهم تنسيق البيانات الأساسي للصورة، وهو أمر حاسم للعديد من عمليات معالجة الصور مثل تحويل الألوان أو الضغط أو فك الضغط.
RawDataSettings { get; }يحصل على إعدادات البيانات الخام الحالية. لاحظ أنه عند استخدام هذه الإعدادات يتم تحميل البيانات بدون تحويل.
RawFallbackIndex { get; set; }يحصل أو يعيّن فهرس الاحتياطي للاستخدام عندما يكون فهرس اللوحة خارج النطاق.
RawIndexedColorConverter { get; set; }يحصل أو يعيّن محول الألوان المفهرسة
override RawLineSize { get; }تسترجع هذه الخاصية حجم سطر واحد من بيانات الصورة الخام بالبايت. تُظهر مقدار الذاكرة التي يشغلها صف واحد من البكسلات في تنسيق البيانات الخام للصورة. فهم حجم السطر الخام أمر أساسي للمهام مثل تخصيص الذاكرة، ومعالجة البيانات، وخوارزميات معالجة الصور التي تعمل على خطوط الصورة الفردية.
Size { get; }يحصل على حجم الصورة.
virtual TransparentColor { get; set; }يحصل على لون الشفافية في الصورة.
virtual UpdateXmpData { get; set; }يحصل أو يعيّن قيمة تشير إلى ما إذا كان يجب تحديث بيانات التعريف XMP.
override UsePalette { get; }يحصل على قيمة تشير إلى ما إذا كانت لوحة ألوان الصورة مستخدمة.
virtual UseRawData { get; set; }يحصل أو يعيّن قيمة تشير إلى ما إذا كان يجب استخدام تحميل البيانات الخام عندما يكون تحميل البيانات الخام متاحًا.
override VerticalResolution { get; set; }توفر هذه الخاصية الوصول إلى الدقة العمودية لـ RasterImage، مقاسة بالبكسل لكل بوصة (PPI). يمكن أن يؤثر تعديل هذه الدقة على جودة وحجم الصورة عند الطباعة أو العرض. من خلال ضبط الدقة العمودية، يمكن للمستخدمين تحسين الصورة لأجهزة الإخراج أو التطبيقات المختلفة، لضمان عرض بصري مثالي.
override Width { get; }تُعيد هذه الخاصية عرض الصورة بالبكسل. تُوفر معلومة أساسية حول أبعاد الصورة، وهي ضرورية لمهام معالجة الصور المختلفة، بما في ذلك تغيير الحجم والقص والعرض.
XmpData { get; set; }يحصل أو يعيّن بيانات Xmp.

الطرق

الاسمالوصف
override AdjustBrightness(int)ضبط السطوع للصورة.
override AdjustContrast(float)تباين الصورة
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()يقوم بتخزين البيانات مؤقتًا ويضمن عدم تحميل بيانات إضافية من DataStreamContainer الأساسي.
CanSave(ImageOptionsBase)يحدد ما إذا كان يمكن حفظ الصورة بالتنسيق المحدد الممثل بخيارات الحفظ الممررة.
override Crop(Rectangle)قص الصورة.
virtual Crop(int, int, int, int)قص الصورة مع إزاحات.
Dispose()يتخلص من المثيل الحالي.
Dither(DitheringMethod, int)يقوم بأداء التمويه على الصورة الحالية.
override Dither(DitheringMethod, int, IColorPalette)يقوم بأداء التمويه على الصورة الحالية.
override 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)يحصل على تاريخ ووقت آخر تعديل لصورة المورد.
override GetOriginalOptions()استرجع خيارات الصورة بناءً على إعدادات الملف الأصلي. تُعد هذه الطريقة مفيدة للحفاظ على عمق البتات وغيرها من معلمات الصورة الأصلية، مما يضمن التناسق ويحافظ على سلامة بيانات الصورة. يسهّل الوصول إلى هذه الخيارات التعامل السلس ومعالجة الصورة مع الاحتفاظ بخصائصها الأصلية. على سبيل المثال، إذا قمنا بتحميل صورة PNG بالأبيض والأسود بعمق 1 بت لكل بكسل ثم حفظناها باستخدام طريقة Save، سيتم إنتاج صورة PNG ناتجة بعمق 8 بت لكل بكسل. لتجنب ذلك وحفظ صورة PNG بعمق 1 بت لكل بكسل، استخدم هذه الطريقة للحصول على خيارات الحفظ المقابلة ومرّرها إلى طريقة Save كمعامل ثانٍ.
GetPixel(int, int)يحصل على بكسل صورة.
virtual 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 الطرق.
virtual NormalizeAngle(bool, Color)يضبط الزاوية. هذه الطريقة قابلة للتطبيق على مستندات النص الممسوحة ضوئياً للتخلص من الانحراف. تستخدم هذه الطريقة GetSkewAngle وRotate الطرق.
override 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)تغيير حجم الصورة.
override 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)دوّر الصورة حول المركز.
override Rotate(float, bool, Color)دوّر الصورة حول المركز.
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[])يكتب كامل سطر المسح إلى فهرس سطر المسح المحدد.

أمثلة

يوضح هذا المثال كيفية تحميل صورة JPEG2000 من ملف وحفظها بصيغة PNG.

[C#]

string dir = "c:\\temp\\";

// حمّل صورة JPEG2000.
using (Aspose.Imaging.FileFormats.Jpeg2000.Jpeg2000Image jpeg2000Image = new Aspose.Imaging.FileFormats.Jpeg2000.Jpeg2000Image(dir + "sample.jp2"))
{
    // حفظ إلى PNG
    jpeg2000Image.Save(dir + "sample.output.png", new Aspose.Imaging.ImageOptions.PngOptions());
}

انظر أيضًا

الفئة Jpeg2000CustomException