TgaImage

TgaImage class

صورة TGA .

public class TgaImage : RasterCachedImage

المنشئون

اسموصف
TgaImage(RasterImage)يقوم بتهيئة مثيل جديد لملفTgaImage فئة .
TgaImage(Stream)يقوم بتهيئة مثيل جديد لملفTgaImage فئة .
TgaImage(string)يقوم بتهيئة مثيل جديد لملفTgaImage فئة .

الخصائص

اسموصف
AuthorComments { get; set; }الحصول على تعليقات المؤلف أو تعيينها . هذا حقل ASCII يتكون من 324 بايت والتي تم تنظيمها على شكل أربعة أسطر من 80 حرفًا ، يتبع كل منها حرف إنهاء فارغ.
AuthorName { get; set; }الحصول على اسم المؤلف أو تعيينه . هذا الحقل يبلغ إجمالي 40 حرفًا من أحرف ASCII للاسم. إذا تم استخدام الحقل ، يجب أن يحتوي الحقل على اسم الشخص الذي أنشأ الصورة (المؤلف) .
AutoAdjustPalette { get; set; }الحصول على أو تعيين قيمة تشير إلى ما إذا كانت لوحة الضبط التلقائي.
override BackgroundColor { get; set; }الحصول على لون الخلفية أو تعيينه.
override BitsPerPixel { get; }يحصل على بت لكل بكسل.
Bounds { get; }يحصل على حدود الصورة .
BufferSizeHint { get; set; }الحصول على أو تعيين تلميح حجم المخزن المؤقت الذي تم تحديده بالحجم الأقصى المسموح به لجميع المخازن المؤقتة الداخلية.
BytesPerPixel { get; }يحصل على بايت لكل بكسل .
Container { get; }يحصل على ملفImage حاوية .
DataStreamContainer { get; }يحصل على دفق بيانات الكائن.
DateTimeStamp { get; set; }الحصول على طابع التاريخ / الوقت أو تعيينه . يحدد هذا الحقل قيمة التاريخ والوقت اللذين تم حفظ الصورة فيهما. على الرغم من أن أنظمة التشغيل عادةً ملفات طابع الوقت والتاريخ ، فإن هذه الميزة متوفرة لأن نظام التشغيل قد يغير طابع الوقت والتاريخ إذا تم نسخ الملف . باستخدام هذه المنطقة ، نضمن لك منطقة غير معدلة للتاريخ والوقت التسجيل .
Disposed { get; }يحصل على قيمة تشير إلى ما إذا كان هذا المثيل قد تم التخلص منه.
override FileFormat { get; }يحصل على تنسيق الملف.
GammaValueDenominator { get; }الحصول على جزء مقام قيمة جاما. يجب أن يكون للصورة غير المصححة (صورة بدون جاما) القيمة 1.0 كنتيجة .
GammaValueNumerator { get; }الحصول على جزء البسط لقيمة جاما. يجب أن تحتوي الصورة غير المصححة (صورة بدون جاما) على القيمة 1.0 كنتيجة .
override HasAlpha { get; }يحصل على قيمة تشير إلى ما إذا كان هذاTgaImage لديه قناة ألفا.
override HasBackgroundColor { get; set; }الحصول على أو تعيين قيمة تشير إلى ما إذا كانت الصورة لها لون خلفية.
HasColorMap { get; }يحصل على قيمة تشير إلى ما إذا كانت هذه الصورة تحتوي على خريطة ملونة.
override HasTransparentColor { get; set; }الحصول على أو تعيين قيمة تشير إلى ما إذا كانت الصورة ذات لون شفاف.
override Height { get; }الحصول على ارتفاع هذه الصورة .
virtual HorizontalResolution { get; set; }الحصول على أو تعيين الدقة الأفقية ، بالبكسل في البوصة ، لهذاRasterImage .
ImageId { get; set; }الحصول على معرف الصورة أو تعيينه.
virtual ImageOpacity { get; }يحصل على عتامة هذه الصورة .
InterruptMonitor { get; set; }الحصول على أو تعيين شاشة المقاطعة.
override IsCached { get; }يحصل على قيمة تشير إلى ما إذا كانت بيانات الصورة مخزنة مؤقتًا حاليًا.
IsGrayScale { get; }يحصل على قيمة تشير إلى ما إذا كان هذاTgaImage مقياس رمادي .
IsRawDataAvailable { get; }يحصل على قيمة تشير إلى ما إذا كان تحميل البيانات الأولية متاحًا.
JobNameOrId { get; set; }الحصول على أو تعيين اسم / معرف الوظيفة.
JobTime { get; set; }الحصول على وقت العمل أو تعيينه .
Palette { get; set; }الحصول على لوحة الألوان أو تعيينها. لا يتم استخدام لوحة الألوان عندما يتم تمثيل وحدات البكسل مباشرةً.
PixelAspectRatioDenominator { get; }يحصل على جزء مقام نسبة العرض إلى الارتفاع للبكسل.
PixelAspectRatioNumerator { get; }يحصل على جزء البسط نسبة العرض إلى الارتفاع للبكسل.
virtual PremultiplyComponents { get; set; }الحصول على أو تعيين قيمة تشير إلى ما إذا كان يجب مضاعفة مكونات الصورة مسبقًا.
RawCustomColorConverter { get; set; }الحصول على أو تعيين محول الألوان المخصص
virtual RawDataFormat { get; }يحصل على تنسيق البيانات الأولية.
RawDataSettings { get; }يحصل على إعدادات البيانات الأولية الحالية. ملاحظة عند استخدام هذه الإعدادات ، يتم تحميل البيانات بدون تحويل.
RawFallbackIndex { get; set; }الحصول على الفهرس الاحتياطي أو تعيينه لاستخدامه عندما يكون فهرس اللوحة خارج الحدود
RawIndexedColorConverter { get; set; }الحصول على أو تعيين محول الألوان المفهرس
virtual RawLineSize { get; }الحصول على حجم الخط الخام بالبايت.
Size { get; }يحصل على حجم الصورة .
SoftwareId { get; set; }الحصول على معرف البرنامج أو تعيينه . إجمالي 40 حرفًا من أحرف ASCII لمعرف البرنامج.
SoftwareVersion { get; set; }الحصول على إصدار البرنامج أو تعيينه. طول سلسلة الإصدار المقبول هو 3-4 أحرف.
SoftwareVersionLetter { get; set; }الحصول على جزء حرف إصدار البرنامج أو تعيينه.
SoftwareVersionNumber { get; set; }الحصول على جزء رقم إصدار البرنامج أو تعيينه.
override TransparentColor { get; set; }الحصول على لون المفتاح أو تعيينه .
virtual UpdateXmpData { get; set; }الحصول على أو تعيين قيمة تشير إلى ما إذا كان سيتم تحديث بيانات تعريف XMP.
override UsePalette { get; }يحصل على قيمة تشير إلى ما إذا كانت لوحة الصور مستخدمة.
virtual UseRawData { get; set; }الحصول على أو تعيين قيمة تشير إلى ما إذا كان سيتم استخدام تحميل البيانات الأولية عند توفر تحميل البيانات الأولية.
virtual VerticalResolution { get; set; }الحصول على أو تحديد الدقة الرأسية ، بالبكسل في البوصة ، لهذاRasterImage .
override Width { get; }الحصول على عرض الصورة هذا .
virtual XmpData { get; set; }الحصول على بيانات تعريف XMP أو تعيينها.
XOrigin { get; set; }الحصول على أو تعيين إحداثيات أفقية مطلقة للزاوية اليسرى السفلية من image حيث يتم وضعها على جهاز عرض أصله في الجزء السفلي الأيسر من شاشة (على سبيل المثال ، سلسلة TARGA) .
YOrigin { get; set; }الحصول على أو تعيين إحداثيات رأسية مطلقة للزاوية اليسرى السفلية من image حيث يتم وضعها على جهاز عرض أصله في الجزء السفلي الأيسر من شاشة (على سبيل المثال ، سلسلة TARGA) .

طُرق

اسموصف
override AdjustBrightness(int)ضبط سطوع الصورة .
override AdjustContrast(float)تباين الصورة
override AdjustGamma(float)تصحيح جاما لصورة .
override AdjustGamma(float, float, float)تصحيح جاما لصورة .
override BinarizeBradley(double)ثنائية الصورة باستخدام خوارزمية العتبة التكيفية لبرادلي باستخدام عتبة الصورة المتكاملة
override BinarizeBradley(double, int)ثنائية الصورة باستخدام خوارزمية العتبة التكيفية لبرادلي باستخدام عتبة الصورة المتكاملة
override BinarizeFixed(byte)ثنائية الصورة مع عتبة محددة مسبقًا
override BinarizeOtsu()ثنائية الصورة مع عتبة Otsu
override CacheData()يخزن البيانات ويضمن عدم إجراء أي تحميل إضافي للبيانات من الأساسDataStreamContainer .
CanSave(ImageOptionsBase)يحدد ما إذا كان يمكن حفظ الصورة بتنسيق الملف المحدد الذي تم تمثيله بواسطة خيارات الحفظ التي تم تمريرها.
Clone()إنشاء كائن جديد يمثل نسخة من المثيل الحالي.
Clone(TgaImage)استنساخ أخرىTgaImage خصائص الكائن .
override Crop(Rectangle)اقتصاص الصورة .
override Crop(int, int, int, int)اقتصاص الصورة مع التحولات .
Dispose()التخلص من المثيل الحالي .
Dither(DitheringMethod, int)يقوم بالتردد على الصورة الحالية.
override Dither(DitheringMethod, int, IColorPalette)يقوم بالتردد على الصورة الحالية.
override Equals(object)مقارنة المساواة .
Equals(TgaImage)مقارنة المساواة .
virtual Filter(Rectangle, FilterOptionsBase)يقوم بتصفية المستطيل المحدد .
GetArgb32Pixel(int, int)الحصول على صورة ARGB بكسل 32 بت .
GetDefaultArgb32Pixels(Rectangle)الحصول على صفيف ARGB بكسل الافتراضي 32 بت.
virtual GetDefaultOptions(object[])يحصل على الخيارات الافتراضية .
GetDefaultPixels(Rectangle, IPartialArgb32PixelLoader)الحصول على مصفوفة البكسل الافتراضية باستخدام محمل البكسل الجزئي.
GetDefaultRawData(Rectangle, RawDataSettings)يحصل على مصفوفة البيانات الأولية الافتراضية.
GetDefaultRawData(Rectangle, IPartialRawDataLoader, RawDataSettings)الحصول على مصفوفة البيانات الأولية الافتراضية باستخدام محمل البكسل الجزئي.
override GetHashCode()احصل على كود التجزئة لهذا المثال. غير مناسب لاستخدامه كمفتاح مثلTgaImage غير ثابت.
virtual GetModifyDate(bool)الحصول على تاريخ ووقت آخر تعديل لصورة المورد.
virtual GetOriginalOptions()الحصول على الخيارات بناءً على إعدادات الملف الأصلية. يمكن أن يكون هذا مفيدًا للحفاظ على عمق البت والمعلمات الأخرى للصورة الأصلية دون تغيير . على سبيل المثال ، إذا قمنا بتحميل صورة PNG أبيض وأسود مع 1 بت لكل بكسل ثم احفظه باستخدام the Save الطريقة ، سيتم إنتاج صورة PNG الناتجة بمعدل 8 بت لكل بكسل. لتجنب ذلك وحفظ صورة PNG بمعدل 1 بت لكل بكسل ، استخدم هذه الطريقة للحصول على خيارات الحفظ المقابلة وتمريرها إلىSave الطريقة كمعامل ثاني.
GetPixel(int, int)الحصول على بكسل صورة .
GetSkewAngle()الحصول على زاوية الانحراف. هذه الطريقة قابلة للتطبيق على المستندات النصية الممسوحة ضوئيًا ، لتحديد زاوية الانحراف عند المسح.
override Grayscale()تحويل الصورة إلى تمثيلها بالتدرج الرمادي
LoadArgb32Pixels(Rectangle)تحميل 32 بت ARGB بكسل .
LoadArgb64Pixels(Rectangle)تحميل 64 بت ARGB بكسل .
LoadCmyk32Pixels(Rectangle)تحميل وحدات البكسل بتنسيق CMYK .
LoadPartialArgb32Pixels(Rectangle, IPartialArgb32PixelLoader)تحميل 32 بت ARGB بكسل جزئيًا بواسطة الحزم.
LoadPartialPixels(Rectangle, IPartialPixelLoader)يتم تحميل وحدات البكسل جزئيًا بالحزم .
LoadPixels(Rectangle)تحميل بكسل .
LoadRawData(Rectangle, RawDataSettings, IPartialRawDataLoader)تحميل البيانات الأولية .
LoadRawData(Rectangle, Rectangle, RawDataSettings, IPartialRawDataLoader)تحميل البيانات الأولية .
NormalizeAngle()تطبيع الزاوية. هذه الطريقة قابلة للتطبيق على المستندات النصية الممسوحة ضوئيًا للتخلص من المسح المنحرف. تستخدم هذه الطريقةGetSkewAngle وRotate الطرق .
virtual NormalizeAngle(bool, Color)تطبيع الزاوية. هذه الطريقة قابلة للتطبيق على المستندات النصية الممسوحة ضوئيًا للتخلص من المسح المنحرف. تستخدم هذه الطريقةGetSkewAngle وRotate الطرق .
ReadArgb32ScanLine(int)يقرأ خط المسح بالكامل بواسطة فهرس خط المسح المحدد.
ReadScanLine(int)يقرأ خط المسح بالكامل بواسطة فهرس خط المسح المحدد.
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)يغير حجم العرض بشكل متناسب .
virtual Rotate(float)تدوير الصورة حول المركز .
override Rotate(float, bool, Color)!:RasterCahcedMultipageImage.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[])يحفظ 32 بت ARGB بكسل .
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()تحويل الصورة النقطية إلى الصورة النقطية.
WriteArgb32ScanLine(int, int[])يكتب خط المسح بالكامل إلى فهرس خط المسح المحدد.
WriteScanLine(int, Color[])يكتب خط المسح بالكامل إلى فهرس خط المسح المحدد.
operator ==مقارنة المساواة .
operator !=مقارنة عدم المساواة .

أمثلة

حفظ صورة JPG كصورة TGA.

[C#]

using (RasterImage image = (JpegImage)Image.Load("test.jpg"))
{
    image.Save("test.tga"", new TgaOptions());
}

تحميل صورة PNG وتحويلها إلى TgaImage وحفظها كصورة TGA.

[C#]

using (RasterImage image = (RasterImage)Image.Load("test.png"))
{
    using (TgaImage tgaImage = new TgaImage(image))
    {
        tgaImage.Save("test.tga");
    }
}

تحديث الخصائص العامة لصورة TGA المحملة.

[C#]

using (TgaImage image = (TgaImage)Image.Load("test.tga"))
{
    image.DateTimeStamp = testTime;
    image.AuthorName = "John Smith";
    image.AuthorComments = "Comment";
    image.ImageId = "ImageId";
    image.JobNameOrId = "Important Job";
    image.JobTime = TimeSpan.FromDays(10);
    image.TransparentColor = Color.FromArgb(123);
    image.SoftwareId = "SoftwareId";
    image.SoftwareVersion = "abc1";
    image.SoftwareVersionLetter = 'a';
    image.SoftwareVersionNumber = 2;
    image.XOrigin = 1000;
    image.YOrigin = 1000;

    image.Save("test.tga")
}

الحصول على قيم الخصائص العامة لصورة TGA المحملة.

[C#]

using (TgaImage image = (TgaImage)Image.Load("test.tga"))
{
    dateTimeStamp = image.DateTimeStamp;
    authorName = image.AuthorName;
    authorComments = image.AuthorComments;
    imageId = image.ImageId;
    jobNameOrId = image.JobNameOrId;
    jobTime = image.JobTime;
    keyColor = image.TransparentColor;
    softwareId = image.SoftwareId;
    softwareVersion = image.SoftwareVersion;
    softwareVersionLetter = image.SoftwareVersionLetter;
    softwareVersionNumber = image.SoftwareVersionNumber;
    xOrigin = image.XOrigin;
    yOrigin = image.YOrigin;
    gammaValueDenominator = image.GammaValueDenominator;
    gammaValueNumerator = image.GammaValueNumerator;
    hasAlphaChannel = image.HasAlpha;
    hasColorMap = image.HasColorMap;
    height = image.Height;
    isGrayScale = image.IsGrayScale;
    pixelAspectRatioDenominator = image.PixelAspectRatioDenominator;
    pixelAspectRatioNumerator = image.PixelAspectRatioNumerator;
    size = image.Size;
    width = image.Width;
}

أنظر أيضا