الفئة TiffFrame

TiffFrame class

إطار TIFF.

public sealed class TiffFrame : RasterCachedImage

المنشئات

الاسمالوصف
TiffFrame(RasterImage)يُهيئ نسخة جديدة من فئة TiffFrame.
TiffFrame(Stream)يُهيئ نسخة جديدة من فئة TiffFrame.
TiffFrame(string)يُهيئ نسخة جديدة من فئة TiffFrame.
TiffFrame(RasterImage, TiffOptions)يُهيئ نسخة جديدة من فئة TiffFrame.
TiffFrame(Stream, TiffOptions)يُهيئ نسخة جديدة من فئة TiffFrame.
TiffFrame(string, TiffOptions)يُهيئ نسخة جديدة من فئة TiffFrame.
TiffFrame(TiffOptions, int, int)يُهيئ نسخة جديدة من فئة TiffFrame.

الخصائص

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

الطرق

الاسمالوصف
static CopyFrame(TiffFrame)ينسخ الإطار بالكامل (نسخ مكررة).
static CreateFrameFrom(TiffFrame, TiffOptions)ينشئ الإطار من tiffFrame المحدد باستخدام options المحددة. يتم الحفاظ على بيانات البكسل ولكن يتم تحويلها إلى التنسيق المطلوب.
override AdjustBrightness(int)ضبط السطوع للصورة.
override AdjustContrast(float)تباين الصورة
override AdjustGamma(float)تصحيح جاما للصورة.
override AdjustGamma(float, float, float)تصحيح جاما للصورة.
AlignResolutions()طريقة مساعدة لجعل الدقة الأفقية والعمودية متساوية.
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 وExifData إلى 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[])يكتب كامل سطر المسح إلى فهرس سطر المسح المحدد.

أمثلة

يوضح هذا المثال كيفية إنشاء صورة TIFF من الصفر وحفظها إلى ملف.

[C#]

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

Aspose.Imaging.ImageOptions.TiffOptions createOptions = new Aspose.Imaging.ImageOptions.TiffOptions(Imaging.FileFormats.Tiff.Enums.TiffExpectedFormat.Default);
    
// حدد 8 بتات لكل مكوّن لوني.
createOptions.BitsPerSample = new ushort[] { 8, 8, 8 };

// حدد ترتيب البايت Big Endian (Motorola)
createOptions.ByteOrder = Aspose.Imaging.FileFormats.Tiff.Enums.TiffByteOrder.BigEndian;

// حدد ضغط LZW.
createOptions.Compression = Aspose.Imaging.FileFormats.Tiff.Enums.TiffCompressions.Lzw;

// حدد نموذج اللون RGB.
createOptions.Photometric = Aspose.Imaging.FileFormats.Tiff.Enums.TiffPhotometrics.Rgb;

// سيتم تخزين جميع مكونات اللون داخل مستوى واحد.
createOptions.PlanarConfiguration = Aspose.Imaging.FileFormats.Tiff.Enums.TiffPlanarConfigs.Contiguous;

// إنشاء إطار TIFF بحجم 100x100 بكسل.
// لاحظ أنك لست مضطرًا لتفريغ الإطار صراحةً إذا تم تضمينه في TiffImage.
// عند تفريغ الحاوية سيتم تفريغ جميع الإطارات تلقائيًا.
Aspose.Imaging.FileFormats.Tiff.TiffFrame firstFrame = new Aspose.Imaging.FileFormats.Tiff.TiffFrame(createOptions, 100, 100);
    
// املأ الإطار بالكامل بالتدرج الأزرق-الأصفر.
Aspose.Imaging.Brushes.LinearGradientBrush gradientBrush = new Aspose.Imaging.Brushes.LinearGradientBrush(
        new Aspose.Imaging.Point(0, 0),
        new Aspose.Imaging.Point(firstFrame.Width, firstFrame.Height),
        Aspose.Imaging.Color.Blue,
        Aspose.Imaging.Color.Yellow);

Aspose.Imaging.Graphics graphics = new Aspose.Imaging.Graphics(firstFrame);
graphics.FillRectangle(gradientBrush, firstFrame.Bounds);

// إنشاء صورة TIFF.
using (Aspose.Imaging.FileFormats.Tiff.TiffImage tiffImage = new Aspose.Imaging.FileFormats.Tiff.TiffImage(firstFrame))
{
    tiffImage.Save(dir + "output.tif");
}

انظر أيضًا