TiffOptions

TiffOptions class

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

public class TiffOptions : ImageOptionsBase

المنشئون

اسموصف
TiffOptions(TiffDataType[])يقوم بتهيئة مثيل جديد لملفTiffOptions فئة .
TiffOptions(TiffExpectedFormat)يقوم بتهيئة مثيل جديد لملفTiffOptionsصف دراسي. بشكل افتراضي ، يتم استخدام اصطلاح Endian الصغير.
TiffOptions(TiffOptions)يقوم بتهيئة مثيل جديد لملفTiffOptions فئة .
TiffOptions(TiffExpectedFormat, TiffByteOrder)يقوم بتهيئة مثيل جديد لملفTiffOptions فئة .

الخصائص

اسموصف
AlphaStorage { get; set; }الحصول على أو تحديد خيار تخزين ألفا. خيارات أخرى غيرUnspecified يتم استخدام عندما يكون هناك أكثر من 3SamplesPerPixel محددة .
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; }الحصول على أو تحديد اسم المستند.
ExifIfd { get; }الحصول على المؤشر أو تعيينه إلى EXIF IFD .
ExtraSamples { get; }يحصل على قيم العينات الإضافية .
FaxT4Options { get; set; }الحصول على أو تعيين خيارات الفاكس t4 .
FileStandard { get; set; }الحصول على أو تحديد معيار ملف TIFF.
FillOrder { get; set; }الحصول على أو تعيين ترتيب ملء بتات البايت.
FullFrame { get; set; }الحصول على أو تعيين قيمة تشير إلى ما إذا كان [إطار كامل] .
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 تم تكوينه بشكل صحيح. استخدم طريقة التحقق من الصحة للعثور على سبب الفشل.
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; }الحصول على الحد الأقصى لقيمة العينة أو تعيينها. تحتوي القيمة على نوع حقل يتطابق بشكل أفضل مع بيانات العينة (نوع بايت أو قصير أو طويل).
SminSampleValue { get; set; }الحصول على القيمة الدنيا للعينة أو تعيينها. تحتوي القيمة على نوع حقل يتطابق بشكل أفضل مع بيانات العينة (نوع بايت أو قصير أو طويل).
SoftwareType { get; set; }يحصل أو يحدد نوع البرنامج.
Source { get; set; }الحصول على أو تعيين المصدر لإنشاء الصورة فيه.
StripByteCounts { get; set; }الحصول على عدد بايتات الشريط أو تعيينه.
StripOffsets { get; set; }الحصول على أو تعيين إزاحة الشريط .
SubFileType { get; set; }الحصول على أو تعيين إشارة عامة لنوع البيانات الموجودة في هذا الملف الفرعي.
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; }الحصول على أو تعيين خيارات التحويل النقطي للمتجه.
override 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; }الحصول على أو تعيين YCbCrCoefficients .
YCbCrSubsampling { get; set; }الحصول على أو تعيين عوامل أخذ العينات الفرعية لمقاييس الضوء YCbCr .
Yposition { get; set; }الحصول على أو تحديد الموضع y .
Yresolution { get; set; }الحصول على دقة y أو تعيينها .

طُرق

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

أمثلة

يوضح هذا المثال استخدام فئات مختلفة من SaveOptions Namespace لأغراض التصدير. يتم تحميل صورة من نوع 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 المعروضة بواسطة فئة الرسومات لعرض المسارات على السطح.

[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);

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

        // مسح سطح الرسومات
        graphics.Clear(Color.Wheat);

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

        // إنشاء مثيل لفئة الشكل
        Aspose.Imaging.Figure figure = new Aspose.Imaging.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));

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

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

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

أنظر أيضا