الفئة TiffOptions

TiffOptions class

خيارات تنسيق ملف tiff. لاحظ أن وسمي العرض والارتفاع سيتم استبدالهما عند إنشاء الصورة بواسطة معلمات العرض والارتفاع، لذا لا حاجة لتحديدهما مباشرة. لاحظ أن العديد من الخيارات تُعيد قيمة افتراضية ولكن هذا لا يعني أن هذا الخيار تم تعيينه صراحةً كقيمة للوسم. للتحقق من وجود الوسم استخدم خاصية Tags أو الطريقة المقابلة IsTagPresent.

public class TiffOptions : ImageOptionsBase

المنشئات

الاسمالوصف
TiffOptions(TiffDataType[])يُنشئ كائنًا جديدًا من الفئة TiffOptions.
TiffOptions(TiffExpectedFormat)يُنشئ كائنًا جديدًا من الفئة TiffOptions. بشكل افتراضي يتم استخدام نظام little endian.
TiffOptions(TiffOptions)يُنشئ كائنًا جديدًا من الفئة TiffOptions.
TiffOptions(TiffExpectedFormat, TiffByteOrder)يُنشئ كائنًا جديدًا من الفئة TiffOptions.

الخصائص

الاسمالوصف
AlphaStorage { get; set; }يحصل أو يعيّن خيار تخزين ألفا. تُستخدم الخيارات غير Unspecified عندما يكون هناك أكثر من 3 SamplesPerPixel معرفة.
Artist { get; set; }الحصول أو تعيين الفنان.
BitsPerPixel { get; }يحصل على عدد البتات لكل بكسل.
BitsPerSample { get; set; }الحصول أو تعيين عدد البتات لكل عينة.
BufferSizeHint { get; set; }الحصول على أو تعيين تلميح حجم المخزن المؤقت الذي يحدد الحد الأقصى المسموح به لجميع المخازن الداخلية.
ByteOrder { get; set; }يحصل أو يعيّن قيمة تشير إلى ترتيب بايتات TIFF.
ColorMap { get; set; }يحصل أو يعيّن خريطة الألوان.
CompressedQuality { get; set; }يحصل أو يعيّن جودة الصورة المضغوطة. يُستخدم مع ضغط JPEG.
Compression { get; set; }الحصول أو تعيين الضغط.
Copyright { get; set; }الحصول أو تعيين حقوق النشر.
DateTime { get; set; }يحصل أو يعيّن التاريخ والوقت.
DisableIccExport { get; set; }يحصل أو يعيّن قيمة تشير إلى ما إذا كان تصدير ملف تعريف ICC معطلاً (يُطبق ملف تعريف ICC على بكسلات المصدر مسبقًا).
Disposed { get; }يحصل على قيمة تشير إلى ما إذا كان هذا المثال تم التخلص منه.
DocumentName { get; set; }يحصل أو يعيّن اسم المستند.
override ExifData { get; set; }تحصل أو تعين بيانات Exif.
ExifIfd { get; }الحصول أو تعيين المؤشر إلى EXIF IFD.
ExtraSamples { get; }يحصل على قيم العينات الإضافية.
FaxT4Options { get; set; }يحصل أو يعيّن خيارات الفاكس T4.
FileStandard { get; set; }يحصل أو يعيّن معيار ملف TIFF.
FillOrder { get; set; }يحصل أو يعيّن ترتيب تعبئة بتات البايت.
FullFrame { get; set; }يحصل أو يضبط قيمة تشير إلى ما إذا كان [full frame].
HalfToneHints { get; set; }يحصل أو يعيّن تلميحات نصف النغمة.
IccProfile { get; set; }يحصل أو يعيّن تدفق ملف تعريف ICC.
ImageDescription { get; set; }الحصول أو تعيين وصف الصورة.
ImageLength { get; set; }الحصول أو تعيين طول الصورة.
ImageWidth { get; set; }الحصول أو تعيين عرض الصورة.
InkNames { get; set; }يحصل أو يعيّن أسماء الأحبار.
IsExtraSamplesPresent { get; }يحصل على قيمة تشير إلى ما إذا كانت العينات الإضافية موجودة.
IsTiled { get; }يحصل على قيمة تشير إلى ما إذا كانت الصورة مقسمة إلى بلاطات.
IsValid { get; }يحصل على قيمة تُشير إلى ما إذا كانت TiffOptions مُكوّنة بشكل صحيح. استخدم طريقة Validate للعثور على سبب الفشل.
KeepMetadata { get; set; }يحصل على قيمة ما إذا كان يجب الاحتفاظ ببيانات تعريف الصورة الأصلية عند التصدير.
MaxSampleValue { get; set; }يحصل أو يعيّن قيمة العينة القصوى.
MinSampleValue { get; set; }يحصل أو يعيّن قيمة العينة الدنيا.
MultiPageOptions { get; set; }خيارات الصفحات المتعددة
Orientation { get; set; }يحصل أو يضبط الاتجاه.
PageName { get; set; }يحصل أو يعيّن اسم الصفحة.
PageNumber { get; set; }يحصل أو يعيّن وسم رقم الصفحة.
override Palette { get; set; }يحصل أو يضبط لوحة الألوان.
Photometric { get; set; }يحصل أو يعيّن الفوتومتري.
PlanarConfiguration { get; set; }الحصول أو تعيين تكوين المستوى.
Predictor { get; set; }يحصل أو يعيّن المتنبئ لضغط LZW.
PremultiplyComponents { get; set; }يحصل أو يعيّن قيمة تشير إلى ما إذا كان يجب ضرب المكونات مسبقًا.
ProgressEventHandler { get; set; }يحصل أو يضبط معالج حدث التقدم.
override ResolutionSettings { get; set; }يحصل أو يضبط إعدادات الدقة.
ResolutionUnit { get; set; }الحصول أو تعيين وحدة الدقة.
RowsPerStrip { get; set; }يحصل أو يعيّن عدد الصفوف لكل شريط.
SampleFormat { get; set; }يحصل أو يعيّن تنسيق العينة.
SamplesPerPixel { get; }يحصل على عدد العينات لكل بكسل. لتغيير قيمة هذه الخاصية استخدم مُعيّن الخاصية BitsPerSample.
ScannerManufacturer { get; set; }يحصل أو يعيّن شركة صانع الماسح.
ScannerModel { get; set; }يحصل أو يعيّن طراز الماسح.
SmaxSampleValue { get; set; }يحصل أو يعيّن قيمة العينة القصوى. القيمة لها نوع حقل يتطابق بأفضل شكل مع بيانات العينة (نوع Byte أو Short أو Long).
SminSampleValue { get; set; }يحصل أو يعيّن قيمة العينة الدنيا. القيمة لها نوع حقل يتطابق بأفضل شكل مع بيانات العينة (نوع Byte أو Short أو Long).
SoftwareType { get; set; }يحصل أو يعيّن نوع البرنامج.
Source { get; set; }يحصل أو يضبط المصدر لإنشاء الصورة فيه.
StripByteCounts { get; set; }يحصل أو يعيّن عدد بايتات الشريط.
StripOffsets { get; set; }يحصل أو يعيّن إزاحات الشريط.
SubFileType { get; set; }يحصل أو يعيّن إشارة عامة لنوع البيانات الموجودة في هذا الملف الفرعي.
TagCount { get; }يحصل على عدد الوسوم.
Tags { get; set; }يحصل أو يعيّن الوسوم.
TargetPrinter { get; set; }يحصل أو يعيّن الطابعة المستهدفة.
Threshholding { get; set; }يحصل أو يعيّن تحديد العتبة.
TileByteCounts { get; set; }يحصل أو يعيّن عدد بايتات البلاط.
TileLength { get; set; }يحصل أو يضبط طول البلاطة.
TileOffsets { get; set; }يحصل أو يضبط إزاحات البلاطة.
TileWidth { get; set; }يحصل أو يضبط عرض البلاطة.
TotalPages { get; }يحصل على إجمالي الصفحات.
ValidTagCount { get; }يحصل على عدد العلامات الصالحة. هذا ليس إجمالي عدد العلامات بل عدد العلامات التي يمكن حفظها.
VectorRasterizationOptions { get; set; }يحصل أو يضبط خيارات تحويل المتجه إلى نقطية.
virtual XmpData { get; set; }يحصل أو يضبط حاوية بيانات تعريف XMP.
XPAuthor { get; set; }يحصل أو يضبط مؤلف الصورة، الذي يستخدمه مستكشف Windows.
XPComment { get; set; }يحصل أو يضبط التعليق على الصورة، الذي يستخدمه مستكشف Windows.
XPKeywords { get; set; }يحصل أو يضبط موضوع الصورة، الذي يستخدمه مستكشف Windows.
Xposition { get; set; }يحصل أو يضبط موضع x.
XPSubject { get; set; }يحصل أو يضبط معلومات حول الصورة، التي يستخدمها مستكشف Windows.
XPTitle { get; set; }يحصل أو يضبط معلومات حول الصورة، التي يستخدمها مستكشف Windows.
Xresolution { get; set; }يحصل أو يضبط دقة x.
YCbCrCoefficients { get; set; }يحصل أو يضبط معاملات YCbCr.
YCbCrSubsampling { get; set; }يحصل أو يضبط عوامل أخذ العينات الفرعية للقياس الضوئي YCbCr.
Yposition { get; set; }يحصل أو يضبط موضع y.
Yresolution { get; set; }الحصول أو تعيين دقة y.

الطرق

الاسمالوصف
AddTag(TiffDataType)يضيف علامة جديدة.
AddTags(TiffDataType[])يضيف العلامات.
override Clone()ينسخ هذه المثيلة.
Dispose()يتخلص من المثيل الحالي.
GetTagByType(TiffTags)يحصل على نسخة العلامة حسب النوع.
IsTagPresent(TiffTags)يحدد ما إذا كانت العلامة موجودة في الخيارات أم لا.
RemoveTag(TiffTags)يزيل العلامة.
RemoveTags(params TiffTags[])يزيل العلامات.
TrySetMetadata(IImageMetadataFormat)يحاول تعيين مثيل metadata، إذا كان مثيل Image يدعم ويطبق مثيل IImageMetadataFormat.
Validate()يتحقق من صحة ما إذا كانت الخيارات تحتوي على تركيبة صالحة من العلامات.
static GetValidTagsCount(TiffDataType[])يحصل على عدد العلامات الصالحة.

أمثلة

يوضح هذا المثال استخدام فئات مختلفة من مساحة الأسماء SaveOptions لأغراض التصدير. يتم تحميل صورة من نوع Gif في مثيل من الفئة Image ثم يتم تصديرها إلى عدة تنسيقات.

[C#]

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

//حمّل صورة موجودة (من نوع Gif) في مثيل من الفئة Image
using (Aspose.Imaging.Image image = Aspose.Imaging.Image.Load(dir + "sample.gif"))
{
    //تصدير إلى تنسيق ملف BMP باستخدام الخيارات الافتراضية
    image.Save(dir + "output.bmp", new Aspose.Imaging.ImageOptions.BmpOptions());

    //تصدير إلى تنسيق ملف JPEG باستخدام الخيارات الافتراضية
    image.Save(dir + "output.jpg", new Aspose.Imaging.ImageOptions.JpegOptions());

    //تصدير إلى تنسيق ملف PNG باستخدام الخيارات الافتراضية
    image.Save(dir + "output.png", new Aspose.Imaging.ImageOptions.PngOptions());

    //تصدير إلى تنسيق ملف TIFF باستخدام الخيارات الافتراضية
    image.Save(dir + "output.tif", new Aspose.Imaging.ImageOptions.TiffOptions(Aspose.Imaging.FileFormats.Tiff.Enums.TiffExpectedFormat.Default));
}

يوضح المثال التالي كيفية تحويل صورة متجهية متعددة الصفحات إلى تنسيق TIFF بطريقة عامة دون الإشارة إلى نوع صورة معين.

[C#]

string dir = "C:\\aspose.imaging\\net\\misc\\ImagingReleaseQATester\\Tests\\testdata\\2548";
string inputFilePath = System.IO.Path.Combine(dir, "Multipage.cdr");
string outputFilePath = System.IO.Path.Combine(dir, "Multipage.cdr.tiff");

Aspose.Imaging.ImageOptionsBase exportOptions = new Aspose.Imaging.ImageOptions.TiffOptions(Aspose.Imaging.FileFormats.Tiff.Enums.TiffExpectedFormat.Default);

using (Aspose.Imaging.Image image = Aspose.Imaging.Image.Load(inputFilePath))
{
    exportOptions.MultiPageOptions = null;

    // تصدير الصفحتين الأوليين فقط. سيتم عرض هاتين الصفحتين كإطارات في ملف TIFF الناتج.
    Aspose.Imaging.IMultipageImage multipageImage = image as Aspose.Imaging.IMultipageImage;
    if (multipageImage != null && (multipageImage.Pages != null && multipageImage.PageCount > 2))
    {
        exportOptions.MultiPageOptions = new Aspose.Imaging.ImageOptions.MultiPageOptions(new Aspose.Imaging.IntRange(0, 2));
    }

    if (image is Aspose.Imaging.VectorImage)
    {
        exportOptions.VectorRasterizationOptions = (Aspose.Imaging.ImageOptions.VectorRasterizationOptions)image.GetDefaultOptions(new object[] { Aspose.Imaging.Color.White, image.Width, image.Height });
        exportOptions.VectorRasterizationOptions.TextRenderingHint = Aspose.Imaging.TextRenderingHint.SingleBitPerPixel;
        exportOptions.VectorRasterizationOptions.SmoothingMode = Aspose.Imaging.SmoothingMode.None;
    }

    image.Save(outputFilePath, exportOptions);
}

تستخدم هذه الأمثلة فئة GraphicsPath وفئة Graphics لإنشاء وتعديل الأشكال على سطح صورة. ينشئ المثال صورة جديدة (من نوع Tiff)، يمسح السطح ويرسم المسارات بمساعدة فئة GraphicsPath. في النهاية يتم استدعاء طريقة DrawPath التي توفرها فئة Graphics لعرض المسارات على السطح.

[C#]

//إنشاء مثيل من FileStream
using (System.IO.FileStream stream = new System.IO.FileStream(@"C:\temp\output.tiff", System.IO.FileMode.Create))
{
    //إنشاء مثيل من TiffOptions وتعيين خصائصه المتنوعة
    Aspose.Imaging.ImageOptions.TiffOptions tiffOptions = new Aspose.Imaging.ImageOptions.TiffOptions(Imaging.FileFormats.Tiff.Enums.TiffExpectedFormat.Default);

    //تعيين المصدر لمثيل ImageOptions
    tiffOptions.Source = new Aspose.Imaging.Sources.StreamSource(stream);

    //إنشاء مثيل من Image
    using (Aspose.Imaging.Image image = Aspose.Imaging.Image.Create(tiffOptions, 500, 500))
    {
        //إنشاء وتهيئة مثيل من فئة Graphics
        Aspose.Imaging.Graphics graphics = new Aspose.Imaging.Graphics(image);

        //مسح سطح Graphics
        graphics.Clear(Color.Wheat);

        //إنشاء مثيل من فئة GraphicsPath
        Aspose.Imaging.GraphicsPath graphicspath = new Aspose.Imaging.GraphicsPath();

        //إنشاء كائن من الفئة Figure
        Aspose.Imaging.Figure figure = new Aspose.Imaging.Figure();

        //إضافة أشكال إلى كائن Figure
        figure.AddShape(new Aspose.Imaging.Shapes.RectangleShape(new Aspose.Imaging.RectangleF(10f, 10f, 300f, 300f)));
        figure.AddShape(new Aspose.Imaging.Shapes.EllipseShape(new Aspose.Imaging.RectangleF(50f, 50f, 300f, 300f)));
        figure.AddShape(new Aspose.Imaging.Shapes.PieShape(new Aspose.Imaging.RectangleF(new Aspose.Imaging.PointF(250f, 250f), new Aspose.Imaging.SizeF(200f, 200f)), 0f, 45f));

        //إضافة كائن Figure إلى GraphicsPath
        graphicspath.AddFigure(figure);

        //رسم المسار باستخدام كائن Pen باللون الأسود
        graphics.DrawPath(new Aspose.Imaging.Pen(Aspose.Imaging.Color.Black, 2), graphicspath);

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

انظر أيضًا

الفئة TgaOptions Enum TiffOptionsError