TiffOptions

Inheritance: java.lang.Object, com.aspose.imaging.DisposableObject, com.aspose.imaging.ImageOptionsBase

All Implemented Interfaces: com.aspose.imaging.IMetadataContainer

public class TiffOptions extends ImageOptionsBase implements IMetadataContainer

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

تحذير! لا تقم بتعديل خيارات TIFF أثناء الحفظ لأن ذلك قد يسبب آثارًا جانبية وأخطاء يصعب اكتشافها. تم ترك السطر التالي معلقًا خصيصًا لأنه تسبب في تحديد غير صحيح لبداية البيانات. الخيارات الممررة لم تحتوي على spp (على الرغم من أن الخيارات غير صحيحة في هذه الحالة لكن هذا السيناريو لا يزال يسبب أخطاء) والسطر التالي تسبب في إضافة وسم +spp ووسم +bpp وعند كتابة الخيارات بعد كتابة البيانات بالكامل تم استبدال بداية البيانات للترميز غير المضغوط!!! راجع TiffUncompressedCodec.Encode. this.Options.SamplesPerPixel = 3;

المنشئات

المنشئ	الوصف
TiffOptions(int expectedFormat, int byteOrder)	يُنشئ مثيلاً جديدًا من الفئة TiffOptions.
TiffOptions(int expectedFormat)	يُنشئ مثيلاً جديدًا من الفئة TiffOptions.
TiffOptions(TiffOptions options)	يُنشئ مثيلاً جديدًا من الفئة TiffOptions.
TiffOptions(TiffDataType[] tags)	يُنشئ مثيلاً جديدًا من الفئة TiffOptions.

الطرق

طريقة	الوصف
getValidTagsCount(TiffDataType[] tags)	يحصل على عدد الوسوم الصالحة.
getTagCount()	يحصل على عدد الوسوم.
getFileStandard()	يسترجع أو يعيّن معيار ملف TIFF.
setFileStandard(int value)	يسترجع أو يعيّن معيار ملف TIFF.
getDefaultMemoryAllocationLimit()	يسترجع أو يعيّن حد تخصيص الذاكرة الافتراضي.
setDefaultMemoryAllocationLimit(int value)	يسترجع أو يعيّن حد تخصيص الذاكرة الافتراضي.
getPremultiplyComponents()	يسترجع أو يعيّن قيمة تشير إلى ما إذا كان يجب ضرب المكونات مسبقًا.
setPremultiplyComponents(boolean value)	يسترجع أو يعيّن قيمة تشير إلى ما إذا كان يجب ضرب المكونات مسبقًا.
isValid()	يسترجع قيمة تشير إلى ما إذا تم تكوين TiffOptions بشكل صحيح.
getYCbCrSubsampling()	يسترجع أو يعيّن عوامل أخذ العينات الفرعية للقياس الضوئي YCbCr.
setYCbCrSubsampling(int[] value)	يسترجع أو يعيّن عوامل أخذ العينات الفرعية للقياس الضوئي YCbCr.
getYCbCrCoefficients()	يسترجع أو يعيّن معاملات YCbCr.
setYCbCrCoefficients(TiffRational[] value)	يسترجع أو يعيّن معاملات YCbCr.
isTiled()	يسترجع قيمة تشير إلى ما إذا كانت الصورة مقسمة إلى مربعات.
getArtist()	يسترجع أو يعيّن الفنان.
setArtist(String value)	يسترجع أو يعيّن الفنان.
isTagPresent(int tag)	يحدد ما إذا كان الوسم موجودًا في الخيارات أم لا.
getByteOrder()	يسترجع أو يعيّن قيمة تشير إلى ترتيب بايتات TIFF.
setByteOrder(int value)	يسترجع أو يعيّن قيمة تشير إلى ترتيب بايتات TIFF.
getIccProfile()	يسترجع تدفق ملف تعريف ICC.
setIccProfile(byte[] value)	يعيّن تدفق ملف تعريف ICC.
isDisableIccExport()	يسترجع قيمة تشير إلى ما إذا تم تعطيل تصدير ملف تعريف ICC (يتم تطبيق ملف تعريف ICC على بكسلات المصدر مسبقًا).
setDisableIccExport(boolean value)	يعيّن قيمة تشير إلى ما إذا تم تعطيل تصدير ملف تعريف ICC (يتم تطبيق ملف تعريف ICC على بكسلات المصدر مسبقًا).
getBitsPerSample()	يسترجع عدد البتات لكل عينة.
setBitsPerSample(int[] value)	يعيّن عدد البتات لكل عينة.
getExtraSamples()	يسترجع قيم العينات الإضافية.
getCompression()	يسترجع الضغط.
setCompression(int value)	يعيّن الضغط.
getCompressedQuality()	يسترجع جودة الصورة المضغوطة.
setCompressedQuality(int value)	يعيّن جودة الصورة المضغوطة.
getCopyright()	يسترجع حقوق النشر.
setCopyright(String value)	يعيّن حقوق النشر.
getColorMap()	يسترجع أو يعيّن خريطة الألوان.
setColorMap(int[] value)	يسترجع أو يعيّن خريطة الألوان.
getPalette()	يسترجع أو يعيّن لوحة الألوان.
setPalette(IColorPalette value)	يسترجع أو يعيّن لوحة الألوان.
getDateTime()	يحصل أو يضبط التاريخ والوقت.
setDateTime(String value)	يحصل أو يضبط التاريخ والوقت.
getDocumentName()	يحصل أو يضبط اسم المستند.
setDocumentName(String value)	يحصل أو يضبط اسم المستند.
getAlphaStorage()	يحصل أو يضبط خيار تخزين ألفا.
setAlphaStorage(int value)	يحصل أو يضبط خيار تخزين ألفا.
isExtraSamplesPresent()	يحصل على قيمة تشير إلى ما إذا كانت العينات الإضافية موجودة.
getFillOrder()	يحصل أو يضبط ترتيب تعبئة بتات البايت.
setFillOrder(int value)	يحصل أو يضبط ترتيب تعبئة بتات البايت.
getHalfToneHints()	يحصل أو يضبط تلميحات نصف النغمة.
setHalfToneHints(int[] value)	يحصل أو يضبط تلميحات نصف النغمة.
getImageDescription()	يحصل أو يضبط وصف الصورة.
setImageDescription(String value)	يحصل أو يضبط وصف الصورة.
getInkNames()	يحصل أو يضبط أسماء الحبر.
setInkNames(String value)	يحصل أو يضبط أسماء الحبر.
getScannerManufacturer()	يحصل أو يضبط شركة صانع الماسح.
setScannerManufacturer(String value)	يحصل أو يضبط شركة صانع الماسح.
getMaxSampleValue()	يحصل أو يضبط قيمة العينة القصوى.
setMaxSampleValue(int[] value)	يحصل أو يضبط قيمة العينة القصوى.
getMinSampleValue()	يحصل أو يضبط قيمة العينة الدنيا.
setMinSampleValue(int[] value)	يحصل أو يضبط قيمة العينة الدنيا.
getScannerModel()	يحصل أو يضبط طراز الماسح.
setScannerModel(String value)	يحصل أو يضبط طراز الماسح.
getOrientation()	يحصل أو يضبط الاتجاه.
setOrientation(int value)	يحصل أو يضبط الاتجاه.
getPageName()	يحصل أو يضبط اسم الصفحة.
setPageName(String value)	يحصل أو يضبط اسم الصفحة.
getPageNumber()	يحصل أو يضبط وسم رقم الصفحة.
setPageNumber(int[] value)	يحصل أو يضبط وسم رقم الصفحة.
getPhotometric()	يحصل أو يضبط الفوتومتري.
setPhotometric(int value)	يحصل أو يضبط الفوتومتري.
getPlanarConfiguration()	يحصل أو يضبط تكوين المستوى.
setPlanarConfiguration(int value)	يحصل أو يضبط تكوين المستوى.
getResolutionUnit()	يحصل أو يضبط وحدة الدقة.
setResolutionUnit(int value)	يحصل أو يضبط وحدة الدقة.
getRowsPerStrip()	يحصل أو يضبط عدد الصفوف لكل شريط.
setRowsPerStrip(long value)	يحصل أو يضبط عدد الصفوف لكل شريط.
getTileWidth()	يحصل أو يضبط عرض البلاطة.
setTileWidth(long value)	يحصل أو يضبط عرض البلاطة.
getTileLength()	يحصل أو يضبط طول البلاطة.
setTileLength(long value)	يحصل أو يضبط طول البلاطة.
getSampleFormat()	يحصل أو يضبط تنسيق العينة.
setSampleFormat(int[] value)	يحصل أو يضبط تنسيق العينة.
getSamplesPerPixel()	يحصل على العينات لكل بكسل.
getSmaxSampleValue()	يحصل أو يضبط قيمة العينة القصوى.
setSmaxSampleValue(long[] value)	يحصل أو يضبط قيمة العينة القصوى.
getSminSampleValue()	يحصل أو يضبط قيمة العينة الدنيا.
setSminSampleValue(long[] value)	يحصل أو يضبط قيمة العينة الدنيا.
getSoftwareType()	يحصل أو يضبط نوع البرنامج.
setSoftwareType(String value)	يحصل أو يضبط نوع البرنامج.
getStripByteCounts()	يحصل أو يضبط عدد بايتات الشريط.
setStripByteCounts(long[] value)	يحصل أو يضبط عدد بايتات الشريط.
getStripOffsets()	يحصل أو يضبط إزاحات الشريط.
setStripOffsets(long[] value)	يحصل أو يضبط إزاحات الشريط.
getTileByteCounts()	يحصل أو يضبط عدد بايتات البلاط.
setTileByteCounts(long[] value)	يحصل أو يضبط عدد بايتات البلاط.
getTileOffsets()	يحصل أو يضبط إزاحات البلاط.
setTileOffsets(long[] value)	يحصل أو يضبط إزاحات البلاط.
getSubFileType()	يحصل أو يضبط إشارة عامة لنوع البيانات الموجودة في هذا الملف الفرعي.
setSubFileType(long value)	يحصل أو يضبط إشارة عامة لنوع البيانات الموجودة في هذا الملف الفرعي.
getTargetPrinter()	يحصل أو يضبط الطابعة المستهدفة.
setTargetPrinter(String value)	يحصل أو يضبط الطابعة المستهدفة.
getThreshholding()	يحصل أو يضبط العتبة.
setThreshholding(int value)	يحصل أو يضبط العتبة.
getTotalPages()	يحصل على إجمالي الصفحات.
getXposition()	يحصل أو يضبط موضع x.
setXposition(TiffRational value)	يحصل أو يضبط موضع x.
getResolutionSettings()	يحصل أو يضبط إعدادات الدقة.
setResolutionSettings(ResolutionSetting value)	يحصل أو يضبط إعدادات الدقة.
getXresolution()	يحصل أو يضبط دقة x.
setXresolution(TiffRational value)	يحصل أو يضبط دقة x.
getYposition()	يحصل أو يضبط موضع y.
setYposition(TiffRational value)	يحصل أو يضبط موضع y.
getYresolution()	يحصل أو يضبط دقة y.
setYresolution(TiffRational value)	يحصل أو يضبط دقة y.
getFaxT4Options()	يحصل أو يضبط خيارات الفاكس t4.
setFaxT4Options(long value)	يحصل أو يضبط خيارات الفاكس t4.
getPredictor()	يحصل أو يضبط المتنبئ لضغط LZW.
setPredictor(int value)	يحصل أو يضبط المتنبئ لضغط LZW.
getImageLength()	يحصل أو يضبط طول الصورة.
setImageLength(long value)	يحصل أو يضبط طول الصورة.
getImageWidth()	يحصل أو يضبط عرض الصورة.
setImageWidth(long value)	يحصل أو يضبط عرض الصورة.
getExifIfd()	يحصل أو يضبط المؤشر إلى EXIF IFD.
getTags()	يحصل أو يضبط العلامات.
setTags(TiffDataType[] value)	يحصل أو يضبط العلامات.
getValidTagCount()	يحصل على عدد العلامات الصالحة.
getBitsPerPixel()	يحصل على عدد البتات لكل بكسل.
getXPTitle()	يحصل على معلومات حول الصورة، التي يستخدمها مستكشف Windows.
setXPTitle(String value)	يضبط معلومات حول الصورة، التي يستخدمها مستكشف Windows.
getXPComment()	يحصل على تعليق على الصورة، الذي يستخدمه مستكشف Windows.
setXPComment(String value)	يضبط تعليق على الصورة، الذي يستخدمه مستكشف Windows.
getXPAuthor()	يحصل على مؤلف الصورة، الذي يستخدمه مستكشف Windows.
setXPAuthor(String value)	يضبط مؤلف الصورة، الذي يستخدمه مستكشف Windows.
getXPKeywords()	يحصل على موضوع الصورة، الذي يستخدمه مستكشف Windows.
setXPKeywords(String value)	يضبط صورة الموضوع، التي تُستخدم بواسطة Windows Explorer.
getXPSubject()	يحصل على معلومات حول الصورة، التي يستخدمها مستكشف Windows.
setXPSubject(String value)	يضبط معلومات حول الصورة، التي يستخدمها مستكشف Windows.
getExifData()	يحصل على بيانات Exif.
setExifData(ExifData value)	يضبط بيانات Exif.
removeTag(int tag)	يزيل العلامة.
removeTags(int[] tags)	يزيل العلامات.
validate()	يتحقق مما إذا كانت الخيارات تحتوي على تركيبة صالحة من العلامات
addTags(TiffDataType[] tagsToAdd)	يضيف العلامات.
addTag(TiffDataType tagToAdd)	يضيف علامة جديدة.
getTagByType(int tagKey)	يحصل على نسخة العلامة حسب النوع.

Example: This example demonstrates the use of different classes from SaveOptions Namespace for export purposes.

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

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

//تحميل صورة موجودة (من نوع Gif) في مثيل من الفئة Image
com.aspose.imaging.Image image = com.aspose.imaging.Image.load(dir + "sample.gif");
try {
    //تصدير إلى تنسيق ملف BMP باستخدام الخيارات الافتراضية
    image.save(dir + "output.bmp", new com.aspose.imaging.imageoptions.BmpOptions());

    //تصدير إلى تنسيق ملف JPEG باستخدام الخيارات الافتراضية
    image.save(dir + "output.jpeg", new com.aspose.imaging.imageoptions.JpegOptions());

    //تصدير إلى تنسيق ملف PNG باستخدام الخيارات الافتراضية
    image.save(dir + "output.png", new com.aspose.imaging.imageoptions.PngOptions());

    //تصدير إلى تنسيق ملف TIFF باستخدام الخيارات الافتراضية
    image.save(dir + "output.tif", new com.aspose.imaging.imageoptions.TiffOptions(com.aspose.imaging.fileformats.tiff.enums.TiffExpectedFormat.Default));
} finally {
    image.dispose();
}

Example: The following example shows how to convert a multipage vector image to TIFF format in general way without referencing to a particular image type.

String dir = "C:\\aspose.imaging\\net\\misc\\ImagingReleaseQATester\\Tests\\testdata\\2548\\";
String inputFilePath = dir + "Multipage.cdr";
String outputFilePath = dir + "Multipage.cdr.tiff";

com.aspose.imaging.ImageOptionsBase exportOptions = new com.aspose.imaging.imageoptions.TiffOptions(com.aspose.imaging.fileformats.tiff.enums.TiffExpectedFormat.Default);

try (com.aspose.imaging.Image image = com.aspose.imaging.Image.load(inputFilePath))
{
    exportOptions.setMultiPageOptions(null);

    // تصدير الصفحتين الأوليين فقط. سيتم عرض هاتين الصفحتين كإطارات في ملف TIFF الناتج.
    com.aspose.imaging.IMultipageImage multipageImage = (image instanceof com.aspose.imaging.IMultipageImage) ? (com.aspose.imaging.IMultipageImage) image : null;
    if (multipageImage != null && (multipageImage.getPages() != null && multipageImage.getPageCount() > 2))
    {
        exportOptions.setMultiPageOptions(new com.aspose.imaging.imageoptions.MultiPageOptions(new com.aspose.imaging.IntRange(0, 2)));
    }

    if (image instanceof com.aspose.imaging.VectorImage)
    {
        com.aspose.imaging.imageoptions.VectorRasterizationOptions defaultOptions = (com.aspose.imaging.imageoptions.VectorRasterizationOptions) image.getDefaultOptions(new Object[]{Color.getWhite(), image.getWidth(), image.getHeight()});
        exportOptions.setVectorRasterizationOptions(defaultOptions);
        defaultOptions.setTextRenderingHint(com.aspose.imaging.TextRenderingHint.SingleBitPerPixel);
        defaultOptions.setSmoothingMode(com.aspose.imaging.SmoothingMode.None);
    }

    image.save(outputFilePath, exportOptions);
}

TiffOptions(int expectedFormat, int byteOrder)

public TiffOptions(int expectedFormat, int byteOrder)

يُنشئ مثيلاً جديدًا من الفئة TiffOptions.

Parameters:

معامل	نوع	الوصف
expectedFormat	int	تنسيق ملف TIFF المتوقع.
byteOrder	int	ترتيب بايتات تنسيق ملف TIFF.

TiffOptions(int expectedFormat)

public TiffOptions(int expectedFormat)

ينشئ نسخة جديدة من الفئة TiffOptions. بشكل افتراضي، يُستخدم نظام الـ little endian.

Parameters:

معامل	نوع	الوصف
expectedFormat	int	تنسيق ملف TIFF المتوقع.

TiffOptions(TiffOptions options)

public TiffOptions(TiffOptions options)

يُنشئ مثيلاً جديدًا من الفئة TiffOptions.

Parameters:

معامل	نوع	الوصف
options	TiffOptions	الخيارات للنسخ منها.

TiffOptions(TiffDataType[] tags)

public TiffOptions(TiffDataType[] tags)

يُنشئ مثيلاً جديدًا من الفئة TiffOptions.

Parameters:

معامل	نوع	الوصف
tags	TiffDataType[]	العلامات لتهيئة الخيارات بها.

getValidTagsCount(TiffDataType[] tags)

public static int getValidTagsCount(TiffDataType[] tags)

يحصل على عدد الوسوم الصالحة.

Parameters:

معامل	نوع	الوصف
tags	TiffDataType[]	العلامات للتحقق منها.

Returns: int - عدد العلامات الصالحة.

getTagCount()

public final int getTagCount()

يحصل على عدد الوسوم.

Returns: int - عدد العلامات.

getFileStandard()

public int getFileStandard()

يسترجع أو يعيّن معيار ملف TIFF.

Returns: int - معيار ملف TIFF.

setFileStandard(int value)

public void setFileStandard(int value)

يسترجع أو يعيّن معيار ملف TIFF.

Parameters:

معامل	نوع	الوصف
القيمة	int	معيار ملف TIFF.

getDefaultMemoryAllocationLimit()

public int getDefaultMemoryAllocationLimit()

يسترجع أو يعيّن حد تخصيص الذاكرة الافتراضي.

Returns: int - الحد الافتراضي لتخصيص الذاكرة.

setDefaultMemoryAllocationLimit(int value)

public void setDefaultMemoryAllocationLimit(int value)

يسترجع أو يعيّن حد تخصيص الذاكرة الافتراضي.

Parameters:

معامل	نوع	الوصف
القيمة	int	الحد الافتراضي لتخصيص الذاكرة.

getPremultiplyComponents()

public boolean getPremultiplyComponents()

يسترجع أو يعيّن قيمة تشير إلى ما إذا كان يجب ضرب المكونات مسبقًا.

Returns: boolean - true إذا كان يجب ضرب المكونات مسبقًا؛ وإلا false.

setPremultiplyComponents(boolean value)

public void setPremultiplyComponents(boolean value)

يسترجع أو يعيّن قيمة تشير إلى ما إذا كان يجب ضرب المكونات مسبقًا.

Parameters:

معامل	نوع	الوصف
القيمة	boolean	true إذا كان يجب ضرب المكونات مسبقًا؛ وإلا false.

isValid()

public boolean isValid()

يحصل على قيمة تشير إلى ما إذا كانت TiffOptions مكوّنة بشكل صحيح. استخدم طريقة Validate للعثور على سبب الفشل.

Returns: boolean - true إذا كانت TiffOptions مكوّنة بشكل صحيح؛ وإلا false.

getYCbCrSubsampling()

public int[] getYCbCrSubsampling()

يسترجع أو يعيّن عوامل أخذ العينات الفرعية للقياس الضوئي YCbCr.

Returns: int[] - عوامل التقسيم الفرعي للقياس الضوئي YCbCr.

setYCbCrSubsampling(int[] value)

public void setYCbCrSubsampling(int[] value)

يسترجع أو يعيّن عوامل أخذ العينات الفرعية للقياس الضوئي YCbCr.

Parameters:

معامل	نوع	الوصف
القيمة	int[]	عوامل التقسيم الفرعي للقياس الضوئي YCbCr.

Example: This example shows how to save a raster image to the TIFF format using various options.

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

com.aspose.imaging.imageoptions.TiffOptions saveOptions
        = new com.aspose.imaging.imageoptions.TiffOptions(com.aspose.imaging.fileformats.tiff.enums.TiffExpectedFormat.Default);

// تعيين 8 بت لكل مكوّن لوني.
saveOptions.setBitsPerSample(new int[]{8, 8, 8});

// تعيين ترتيب البايتات Big Endian (Motorola)
saveOptions.setByteOrder(com.aspose.imaging.fileformats.tiff.enums.TiffByteOrder.BigEndian);

// تعيين ضغط LZW.
saveOptions.setCompression(com.aspose.imaging.fileformats.tiff.enums.TiffCompressions.Lzw);

// السماح بتقليل حجم الصور ذات النغمة المستمرة.
// حاليًا يُستخدم هذا الحقل فقط مع ترميز LZW لأن LZW ربما يكون نظام الترميز الوحيد لملفات TIFF
// الذي يستفيد بشكل كبير من خطوة المتنبئ.
saveOptions.setPredictor(com.aspose.imaging.fileformats.tiff.enums.TiffPredictor.Horizontal);

// تعيين نموذج اللون RGB.
saveOptions.setPhotometric(com.aspose.imaging.fileformats.tiff.enums.TiffPhotometrics.Rgb);

// بالنسبة إلى YCbCr، يمكنك استخدام أحد الخيارات التالية:
// حقل YCbCrSubSampling   عوامل أخذ العينات JPEG
// ----------------------------------------------
// 1,1                      1x1, 1x1, 1x1
// 2,1                      2x1, 1x1, 1x1
// 2,2(القيمة الافتراضية)       2x2, 1x1, 1x1
// saveOptions.YCbCrSubsampling = new ushort[] { 2, 2 };

// ستُخزن جميع مكوّنات اللون في مستوى واحد.
saveOptions.setPlanarConfiguration(com.aspose.imaging.fileformats.tiff.enums.TiffPlanarConfigs.Contiguous);

// إنشاء إطار TIFF بحجم 100×100 بكسل.
com.aspose.imaging.Image image = new com.aspose.imaging.fileformats.bmp.BmpImage(100, 100);
try {
    // املأ الصورة بالكامل بالتدرج الأزرق-الأصفر.
    com.aspose.imaging.brushes.LinearGradientBrush gradientBrush = new com.aspose.imaging.brushes.LinearGradientBrush(
            new com.aspose.imaging.Point(0, 0),
            new com.aspose.imaging.Point(image.getWidth(), image.getHeight()),
            com.aspose.imaging.Color.getBlue(),
            com.aspose.imaging.Color.getYellow());

    com.aspose.imaging.Graphics graphics = new com.aspose.imaging.Graphics(image);
    graphics.fillRectangle(gradientBrush, image.getBounds());

    image.save(dir + "output.tif", saveOptions);
} finally {
    image.dispose();
}

getYCbCrCoefficients()

public TiffRational[] getYCbCrCoefficients()

يسترجع أو يعيّن معاملات YCbCr.

Returns: com.aspose.imaging.fileformats.tiff.TiffRational[] - الـ YCbCrCoefficients.

setYCbCrCoefficients(TiffRational[] value)

public void setYCbCrCoefficients(TiffRational[] value)

يسترجع أو يعيّن معاملات YCbCr.

Parameters:

معامل	نوع	الوصف
value	TiffRational[]	ال YCbCrCoefficients.

isTiled()

public boolean isTiled()

يسترجع قيمة تشير إلى ما إذا كانت الصورة مقسمة إلى مربعات.

Returns: منطقي - true إذا كانت الصورة مقسمة إلى بلاطات؛ وإلا false.

getArtist()

public String getArtist()

يسترجع أو يعيّن الفنان.

Returns: java.lang.String - الـ artist.

setArtist(String value)

public void setArtist(String value)

يسترجع أو يعيّن الفنان.

Parameters:

معامل	نوع	الوصف
القيمة	java.lang.String	الفنان.

isTagPresent(int tag)

public boolean isTagPresent(int tag)

يحدد ما إذا كان الوسم موجودًا في الخيارات أم لا.

Parameters:

معامل	نوع	الوصف
علامة	int	معرف العلامة للتحقق منه.

Returns: منطقي - true إذا كانت العلامة موجودة؛ وإلا false.

getByteOrder()

public int getByteOrder()

يسترجع أو يعيّن قيمة تشير إلى ترتيب بايتات TIFF.

Returns: int

setByteOrder(int value)

public void setByteOrder(int value)

يسترجع أو يعيّن قيمة تشير إلى ترتيب بايتات TIFF.

Parameters:

معامل	نوع	الوصف
القيمة	int

Example: This example shows how to save a raster image to the TIFF format using various options.

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

com.aspose.imaging.imageoptions.TiffOptions saveOptions
        = new com.aspose.imaging.imageoptions.TiffOptions(com.aspose.imaging.fileformats.tiff.enums.TiffExpectedFormat.Default);

// تعيين 8 بت لكل مكوّن لوني.
saveOptions.setBitsPerSample(new int[]{8, 8, 8});

// تعيين ترتيب البايتات Big Endian (Motorola)
saveOptions.setByteOrder(com.aspose.imaging.fileformats.tiff.enums.TiffByteOrder.BigEndian);

// تعيين ضغط LZW.
saveOptions.setCompression(com.aspose.imaging.fileformats.tiff.enums.TiffCompressions.Lzw);

// السماح بتقليل حجم الصور ذات النغمة المستمرة.
// حاليًا يُستخدم هذا الحقل فقط مع ترميز LZW لأن LZW ربما يكون نظام الترميز الوحيد لملفات TIFF
// الذي يستفيد بشكل كبير من خطوة المتنبئ.
saveOptions.setPredictor(com.aspose.imaging.fileformats.tiff.enums.TiffPredictor.Horizontal);

// تعيين نموذج اللون RGB.
saveOptions.setPhotometric(com.aspose.imaging.fileformats.tiff.enums.TiffPhotometrics.Rgb);

// بالنسبة إلى YCbCr، يمكنك استخدام أحد الخيارات التالية:
// حقل YCbCrSubSampling   عوامل أخذ العينات JPEG
// ----------------------------------------------
// 1,1                      1x1, 1x1, 1x1
// 2,1                      2x1, 1x1, 1x1
// 2,2(القيمة الافتراضية)       2x2, 1x1, 1x1
// saveOptions.YCbCrSubsampling = new ushort[] { 2, 2 };

// ستُخزن جميع مكوّنات اللون في مستوى واحد.
saveOptions.setPlanarConfiguration(com.aspose.imaging.fileformats.tiff.enums.TiffPlanarConfigs.Contiguous);

// إنشاء إطار TIFF بحجم 100×100 بكسل.
com.aspose.imaging.Image image = new com.aspose.imaging.fileformats.bmp.BmpImage(100, 100);
try {
    // املأ الصورة بالكامل بالتدرج الأزرق-الأصفر.
    com.aspose.imaging.brushes.LinearGradientBrush gradientBrush = new com.aspose.imaging.brushes.LinearGradientBrush(
            new com.aspose.imaging.Point(0, 0),
            new com.aspose.imaging.Point(image.getWidth(), image.getHeight()),
            com.aspose.imaging.Color.getBlue(),
            com.aspose.imaging.Color.getYellow());

    com.aspose.imaging.Graphics graphics = new com.aspose.imaging.Graphics(image);
    graphics.fillRectangle(gradientBrush, image.getBounds());

    image.save(dir + "output.tif", saveOptions);
} finally {
    image.dispose();
}

getIccProfile()

public byte[] getIccProfile()

يسترجع تدفق ملف تعريف ICC.

Returns: byte[] - الـ icc profile.

setIccProfile(byte[] value)

public void setIccProfile(byte[] value)

يعيّن تدفق ملف تعريف ICC.

Parameters:

معامل	نوع	الوصف
القيمة	byte[]	ملف تعريف icc.

isDisableIccExport()

public final boolean isDisableIccExport()

يسترجع قيمة تشير إلى ما إذا تم تعطيل تصدير ملف تعريف ICC (يتم تطبيق ملف تعريف ICC على بكسلات المصدر مسبقًا).

Returns: منطقي - قيمة تشير إلى ما إذا تم تعطيل تصدير ملف تعريف ICC (ICC profile يُطبق على بكسلات المصدر مسبقًا).

setDisableIccExport(boolean value)

public final void setDisableIccExport(boolean value)

يعيّن قيمة تشير إلى ما إذا تم تعطيل تصدير ملف تعريف ICC (يتم تطبيق ملف تعريف ICC على بكسلات المصدر مسبقًا).

Parameters:

معامل	نوع	الوصف
القيمة	boolean	قيمة تشير إلى ما إذا تم تعطيل تصدير ملف تعريف ICC (ICC profile يُطبق على بكسلات المصدر مسبقًا).

getBitsPerSample()

public int[] getBitsPerSample()

يسترجع عدد البتات لكل عينة.

Returns: int[] - الـ bits per sample value.

عند ضبط هذه القيمة، ضع في اعتبارك أنها ستضبط أيضًا قيمة SamplesPerPixel إلى طول المصفوفة. هاتان الخاصيتان مرتبطتان ارتباطًا وثيقًا جدًا لذا قد يتم ضبطهما معًا فقط.

setBitsPerSample(int[] value)

public void setBitsPerSample(int[] value)

يعيّن عدد البتات لكل عينة.

Parameters:

معامل	نوع	الوصف
	القيمة	int[]

عند ضبط هذه القيمة، ضع في اعتبارك أنها ستضبط أيضًا قيمة SamplesPerPixel إلى طول المصفوفة. هاتان الخاصيتان مرتبطتان ارتباطًا وثيقًا جدًا لذا قد يتم ضبطهما معًا فقط. |

Example: The following example shows how to create a grayscale copy of an existing frame and add it to a TIFF image.

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

com.aspose.imaging.imageoptions.TiffOptions createTiffOptions
        = new com.aspose.imaging.imageoptions.TiffOptions(com.aspose.imaging.fileformats.tiff.enums.TiffExpectedFormat.Default);

// إنشاء مصدر ملف دائم، غير مؤقت.
createTiffOptions.setSource(new com.aspose.imaging.sources.FileCreateSource(dir + "multipage.tif", false));
createTiffOptions.setPhotometric(com.aspose.imaging.fileformats.tiff.enums.TiffPhotometrics.Rgb);
createTiffOptions.setBitsPerSample(new int[]{8, 8, 8});

com.aspose.imaging.fileformats.tiff.TiffImage tiffImage = (com.aspose.imaging.fileformats.tiff.TiffImage) com.aspose.imaging.Image.create(createTiffOptions, 100, 100);
try {
    // التدرج الخطي من الزاوية اليسرى العليا إلى الزاوية اليمنى السفلية للصورة.
    com.aspose.imaging.brushes.LinearGradientBrush brush =
            new com.aspose.imaging.brushes.LinearGradientBrush(
                    new com.aspose.imaging.Point(0, 0),
                    new com.aspose.imaging.Point(tiffImage.getWidth(), tiffImage.getHeight()),
                    com.aspose.imaging.Color.getRed(),
                    com.aspose.imaging.Color.getGreen());

    // ملء الإطار النشط بفرشاة تدرج خطي.
    com.aspose.imaging.Graphics gr = new com.aspose.imaging.Graphics(tiffImage.getActiveFrame());
    gr.fillRectangle(brush, tiffImage.getBounds());

    // خيارات التدرج الرمادي
    com.aspose.imaging.imageoptions.TiffOptions createTiffFrameOptions
            = new com.aspose.imaging.imageoptions.TiffOptions(com.aspose.imaging.fileformats.tiff.enums.TiffExpectedFormat.Default);
    createTiffFrameOptions.setSource(new com.aspose.imaging.sources.StreamSource(new java.io.ByteArrayInputStream(new byte[0])));
    createTiffFrameOptions.setPhotometric(com.aspose.imaging.fileformats.tiff.enums.TiffPhotometrics.MinIsBlack);
    createTiffFrameOptions.setBitsPerSample(new int[]{8});

    // إنشاء نسخة بتدرج رمادي من الإطار النشط.
    // يتم الحفاظ على بيانات البكسل ولكن يتم تحويلها إلى الصيغة المطلوبة.
    com.aspose.imaging.fileformats.tiff.TiffFrame grayscaleFrame
            = com.aspose.imaging.fileformats.tiff.TiffFrame.createFrameFrom(tiffImage.getActiveFrame(), createTiffFrameOptions);

    // إضافة الإطار الذي تم إنشاؤه حديثًا إلى صورة TIFF.
    tiffImage.addFrame(grayscaleFrame);

    tiffImage.save();
} finally {
    tiffImage.dispose();
}

getExtraSamples()

public final int[] getExtraSamples()

يسترجع قيم العينات الإضافية.

القيمة: الـ extra samples value.

Returns: int[] - قيم الـ extra samples.

getCompression()

public int getCompression()

يسترجع الضغط.

Returns: int - الـ compression.

setCompression(int value)

public void setCompression(int value)

يعيّن الضغط.

Parameters:

معامل	نوع	الوصف
القيمة	int	ال compression.

Example: This example shows how to create a TIFF image with 2 frames and save it to a file.

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

// خيارات الإطار الأول
com.aspose.imaging.imageoptions.TiffOptions createOptions1 =
        new com.aspose.imaging.imageoptions.TiffOptions(com.aspose.imaging.fileformats.tiff.enums.TiffExpectedFormat.Default);

// تعيين 8 بت لكل مكوّن لوني.
createOptions1.setBitsPerSample(new int[]{8, 8, 8});

// تعيين ترتيب البايتات Big Endian (Motorola)
createOptions1.setByteOrder(com.aspose.imaging.fileformats.tiff.enums.TiffByteOrder.BigEndian);

// تعيين ضغط LZW.
createOptions1.setCompression(com.aspose.imaging.fileformats.tiff.enums.TiffCompressions.Lzw);

// تعيين نموذج اللون RGB.
createOptions1.setPhotometric(com.aspose.imaging.fileformats.tiff.enums.TiffPhotometrics.Rgb);

// ستُخزن جميع مكوّنات اللون في مستوى واحد.
createOptions1.setPlanarConfiguration(com.aspose.imaging.fileformats.tiff.enums.TiffPlanarConfigs.Contiguous);

// إنشاء الإطار الأول بصيغة TIFF بحجم 100×100 بكسل.
// لاحظ أنك لا تحتاج إلى تحرير الإطارات صراحةً إذا تم تضمينها في TiffImage.
// عند التخلص من الحاوية، سيتم التخلص من جميع الإطارات تلقائيًا.
com.aspose.imaging.fileformats.tiff.TiffFrame frame1 = new com.aspose.imaging.fileformats.tiff.TiffFrame(createOptions1, 100, 100);

// املأ الإطار الأول بالتدرج اللوني الأزرق-الأصفر.
com.aspose.imaging.brushes.LinearGradientBrush gradientBrush = new com.aspose.imaging.brushes.LinearGradientBrush(
        new com.aspose.imaging.Point(0, 0),
        new com.aspose.imaging.Point(frame1.getWidth(), frame1.getHeight()),
        com.aspose.imaging.Color.getBlue(),
        com.aspose.imaging.Color.getYellow());

com.aspose.imaging.Graphics graphics = new com.aspose.imaging.Graphics(frame1);
graphics.fillRectangle(gradientBrush, frame1.getBounds());

// خيارات الإطار الأول
com.aspose.imaging.imageoptions.TiffOptions createOptions2
        = new com.aspose.imaging.imageoptions.TiffOptions(com.aspose.imaging.fileformats.tiff.enums.TiffExpectedFormat.Default);

// عيّن 1 بت لكل بكسل لصورة أبيض وأسود.
createOptions2.setBitsPerSample(new int[]{1});

// عيّن ترتيب البايت Little Endian (Intel)
createOptions2.setByteOrder(com.aspose.imaging.fileformats.tiff.enums.TiffByteOrder.LittleEndian);

// عيّن ضغط الفاكس CCITT Group 3.
createOptions2.setCompression(com.aspose.imaging.fileformats.tiff.enums.TiffCompressions.CcittFax3);

// عيّن نموذج اللون أبيض/أسود حيث 0 هو الأسود، 1 هو الأبيض.
createOptions2.setPhotometric(com.aspose.imaging.fileformats.tiff.enums.TiffPhotometrics.MinIsBlack);

// إنشاء الإطار الثاني بصيغة TIFF بحجم 200×200 بكسل.
com.aspose.imaging.fileformats.tiff.TiffFrame frame2 = new com.aspose.imaging.fileformats.tiff.TiffFrame(createOptions2, 200, 200);

// املأ الإطار الثاني بالتدرج اللوني الأزرق-الأصفر.
// سيتم تحويله تلقائيًا إلى تنسيق أبيض/أسود بسبب الإعدادات المقابلة للإطار.
com.aspose.imaging.Graphics graphics2 = new com.aspose.imaging.Graphics(frame2);
graphics2.fillRectangle(gradientBrush, frame2.getBounds());

// إنشاء صورة TIFF.
com.aspose.imaging.fileformats.tiff.TiffImage tiffImage = new com.aspose.imaging.fileformats.tiff.TiffImage(
        new com.aspose.imaging.fileformats.tiff.TiffFrame[]{frame1, frame2});
try {
    tiffImage.save(dir + "output.mutliframe.tif");
} finally {
    tiffImage.dispose();
}

getCompressedQuality()

public final int getCompressedQuality()

يحصل على جودة الصورة المضغوطة. يُستخدم مع ضغط Jpeg.

Returns: int - جودة الصورة المضغوطة.

setCompressedQuality(int value)

public final void setCompressedQuality(int value)

يضبط جودة الصورة المضغوطة. يُستخدم مع ضغط Jpeg.

Parameters:

معامل	نوع	الوصف
القيمة	int	جودة الصورة المضغوطة.

Example: This example shows how to create a TIFF image with the Jpeg compression and the specified compressed image quality.

try (com.aspose.imaging.fileformats.tiff.TiffImage image = (com.aspose.imaging.fileformats.tiff.TiffImage) com.aspose.imaging.Image.load("c:\\temp\\zeebra.tif"))
{
    com.aspose.imaging.imageoptions.TiffOptions tiffOptions = new com.aspose.imaging.imageoptions.TiffOptions(com.aspose.imaging.fileformats.tiff.enums.TiffExpectedFormat.Default);
    // تعيين نموذج اللون RGB.
    tiffOptions.setPhotometric(com.aspose.imaging.fileformats.tiff.enums.TiffPhotometrics.Rgb);
    // عيّن ضغط Jpeg.
    tiffOptions.setCompression(com.aspose.imaging.fileformats.tiff.enums.TiffCompressions.Jpeg);
    tiffOptions.setCompressedQuality(50);
    // تعيين 8 بت لكل مكوّن لوني.
    tiffOptions.setBitsPerSample(new int[]{8, 8, 8});

    image.save("zeebra.tif-50.tiff", tiffOptions);
}

getCopyright()

public String getCopyright()

يسترجع حقوق النشر.

Returns: java.lang.String - حقوق النشر.

setCopyright(String value)

public void setCopyright(String value)

يعيّن حقوق النشر.

Parameters:

معامل	نوع	الوصف
القيمة	java.lang.String	حقوق النشر.

getColorMap()

public int[] getColorMap()

يسترجع أو يعيّن خريطة الألوان.

Returns: int[] - خريطة الألوان.

setColorMap(int[] value)

public void setColorMap(int[] value)

يسترجع أو يعيّن خريطة الألوان.

Parameters:

معامل	نوع	الوصف
القيمة	int[]	خريطة الألوان.

getPalette()

public IColorPalette getPalette()

يسترجع أو يعيّن لوحة الألوان.

Returns: IColorPalette - The color palette.

setPalette(IColorPalette value)

public void setPalette(IColorPalette value)

يسترجع أو يعيّن لوحة الألوان.

Parameters:

معامل	نوع	الوصف
value	IColorPalette	لوحة الألوان.

getDateTime()

public String getDateTime()

يحصل أو يضبط التاريخ والوقت.

Returns: java.lang.String - التاريخ والوقت.

setDateTime(String value)

public void setDateTime(String value)

يحصل أو يضبط التاريخ والوقت.

Parameters:

معامل	نوع	الوصف
القيمة	java.lang.String	التاريخ والوقت.

getDocumentName()

public String getDocumentName()

يحصل أو يضبط اسم المستند.

Returns: java.lang.String - اسم المستند.

setDocumentName(String value)

public void setDocumentName(String value)

يحصل أو يضبط اسم المستند.

Parameters:

معامل	نوع	الوصف
القيمة	java.lang.String	اسم المستند.

getAlphaStorage()

public int getAlphaStorage()

يحصل أو يضبط خيار تخزين ألفا. تُستخدم الخيارات غير TiffAlphaStorage.Unspecified عندما يكون هناك أكثر من 3 SamplesPerPixel معرفة.

Returns: int - خيار تخزين ألفا.

setAlphaStorage(int value)

public void setAlphaStorage(int value)

يحصل أو يضبط خيار تخزين ألفا. تُستخدم الخيارات غير TiffAlphaStorage.Unspecified عندما يكون هناك أكثر من 3 SamplesPerPixel معرفة.

Parameters:

معامل	نوع	الوصف
القيمة	int	خيار تخزين ألفا.

isExtraSamplesPresent()

public boolean isExtraSamplesPresent()

يحصل على قيمة تشير إلى ما إذا كانت العينات الإضافية موجودة.

Returns: boolean - true إذا كان العينة الإضافية موجودة؛ وإلا false.

getFillOrder()

public int getFillOrder()

يحصل أو يضبط ترتيب تعبئة بتات البايت.

Returns: int - ترتيب تعبئة بتات البايت.

setFillOrder(int value)

public void setFillOrder(int value)

يحصل أو يضبط ترتيب تعبئة بتات البايت.

Parameters:

معامل	نوع	الوصف
القيمة	int	ترتيب تعبئة بتات البايت.

getHalfToneHints()

public int[] getHalfToneHints()

يحصل أو يضبط تلميحات نصف النغمة.

Returns: int[] - تلميحات نصف النغمة.

setHalfToneHints(int[] value)

public void setHalfToneHints(int[] value)

يحصل أو يضبط تلميحات نصف النغمة.

Parameters:

معامل	نوع	الوصف
القيمة	int[]	تلميحات نصف النغمة.

getImageDescription()

public String getImageDescription()

يحصل أو يضبط وصف الصورة.

Returns: java.lang.String - وصف الصورة.

setImageDescription(String value)

public void setImageDescription(String value)

يحصل أو يضبط وصف الصورة.

Parameters:

معامل	نوع	الوصف
القيمة	java.lang.String	وصف الصورة.

getInkNames()

public String getInkNames()

يحصل أو يضبط أسماء الحبر.

Returns: java.lang.String - أسماء الحبر.

setInkNames(String value)

public void setInkNames(String value)

يحصل أو يضبط أسماء الحبر.

Parameters:

معامل	نوع	الوصف
القيمة	java.lang.String	أسماء الحبر.

getScannerManufacturer()

public String getScannerManufacturer()

يحصل أو يضبط شركة صانع الماسح.

Returns: java.lang.String - الشركة المصنعة للمسح الضوئي.

setScannerManufacturer(String value)

public void setScannerManufacturer(String value)

يحصل أو يضبط شركة صانع الماسح.

Parameters:

معامل	نوع	الوصف
القيمة	java.lang.String	الشركة المصنعة للمسح الضوئي.

getMaxSampleValue()

public int[] getMaxSampleValue()

يحصل أو يضبط قيمة العينة القصوى.

Returns: int[] - قيمة العينة القصوى.

setMaxSampleValue(int[] value)

public void setMaxSampleValue(int[] value)

يحصل أو يضبط قيمة العينة القصوى.

Parameters:

معامل	نوع	الوصف
القيمة	int[]	قيمة العينة القصوى.

getMinSampleValue()

public int[] getMinSampleValue()

يحصل أو يضبط قيمة العينة الدنيا.

Returns: int[] - قيمة العينة الدنيا.

setMinSampleValue(int[] value)

public void setMinSampleValue(int[] value)

يحصل أو يضبط قيمة العينة الدنيا.

Parameters:

معامل	نوع	الوصف
القيمة	int[]	قيمة العينة الدنيا.

getScannerModel()

public String getScannerModel()

يحصل أو يضبط طراز الماسح.

Returns: java.lang.String - طراز الماسح الضوئي.

setScannerModel(String value)

public void setScannerModel(String value)

يحصل أو يضبط طراز الماسح.

Parameters:

معامل	نوع	الوصف
القيمة	java.lang.String	طراز الماسح الضوئي.

getOrientation()

public int getOrientation()

يحصل أو يضبط الاتجاه.

Returns: int - الاتجاه TiffOrientations.

setOrientation(int value)

public void setOrientation(int value)

يحصل أو يضبط الاتجاه.

Parameters:

معامل	نوع	الوصف
value	int	الاتجاه TiffOrientations.

getPageName()

public String getPageName()

يحصل أو يضبط اسم الصفحة.

Returns: java.lang.String - اسم الصفحة.

setPageName(String value)

public void setPageName(String value)

يحصل أو يضبط اسم الصفحة.

Parameters:

معامل	نوع	الوصف
القيمة	java.lang.String	اسم الصفحة.

getPageNumber()

public int[] getPageNumber()

يحصل أو يضبط وسم رقم الصفحة.

Returns: int[] - علامة رقم الصفحة.

setPageNumber(int[] value)

public void setPageNumber(int[] value)

يحصل أو يضبط وسم رقم الصفحة.

Parameters:

معامل	نوع	الوصف
القيمة	int[]	علامة رقم الصفحة.

getPhotometric()

public int getPhotometric()

يحصل أو يضبط الفوتومتري.

Returns: int - الفوتومتري.

setPhotometric(int value)

public void setPhotometric(int value)

يحصل أو يضبط الفوتومتري.

Parameters:

معامل	نوع	الوصف
القيمة	int	الفوتومتري.

Example: The following example shows how to create a grayscale copy of an existing frame and add it to a TIFF image.

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

com.aspose.imaging.imageoptions.TiffOptions createTiffOptions
        = new com.aspose.imaging.imageoptions.TiffOptions(com.aspose.imaging.fileformats.tiff.enums.TiffExpectedFormat.Default);

// إنشاء مصدر ملف دائم، غير مؤقت.
createTiffOptions.setSource(new com.aspose.imaging.sources.FileCreateSource(dir + "multipage.tif", false));
createTiffOptions.setPhotometric(com.aspose.imaging.fileformats.tiff.enums.TiffPhotometrics.Rgb);
createTiffOptions.setBitsPerSample(new int[]{8, 8, 8});

com.aspose.imaging.fileformats.tiff.TiffImage tiffImage = (com.aspose.imaging.fileformats.tiff.TiffImage) com.aspose.imaging.Image.create(createTiffOptions, 100, 100);
try {
    // التدرج الخطي من الزاوية اليسرى العليا إلى الزاوية اليمنى السفلية للصورة.
    com.aspose.imaging.brushes.LinearGradientBrush brush =
            new com.aspose.imaging.brushes.LinearGradientBrush(
                    new com.aspose.imaging.Point(0, 0),
                    new com.aspose.imaging.Point(tiffImage.getWidth(), tiffImage.getHeight()),
                    com.aspose.imaging.Color.getRed(),
                    com.aspose.imaging.Color.getGreen());

    // ملء الإطار النشط بفرشاة تدرج خطي.
    com.aspose.imaging.Graphics gr = new com.aspose.imaging.Graphics(tiffImage.getActiveFrame());
    gr.fillRectangle(brush, tiffImage.getBounds());

    // خيارات التدرج الرمادي
    com.aspose.imaging.imageoptions.TiffOptions createTiffFrameOptions
            = new com.aspose.imaging.imageoptions.TiffOptions(com.aspose.imaging.fileformats.tiff.enums.TiffExpectedFormat.Default);
    createTiffFrameOptions.setSource(new com.aspose.imaging.sources.StreamSource(new java.io.ByteArrayInputStream(new byte[0])));
    createTiffFrameOptions.setPhotometric(com.aspose.imaging.fileformats.tiff.enums.TiffPhotometrics.MinIsBlack);
    createTiffFrameOptions.setBitsPerSample(new int[]{8});

    // إنشاء نسخة بتدرج رمادي من الإطار النشط.
    // يتم الحفاظ على بيانات البكسل ولكن يتم تحويلها إلى الصيغة المطلوبة.
    com.aspose.imaging.fileformats.tiff.TiffFrame grayscaleFrame
            = com.aspose.imaging.fileformats.tiff.TiffFrame.createFrameFrom(tiffImage.getActiveFrame(), createTiffFrameOptions);

    // إضافة الإطار الذي تم إنشاؤه حديثًا إلى صورة TIFF.
    tiffImage.addFrame(grayscaleFrame);

    tiffImage.save();
} finally {
    tiffImage.dispose();
}

getPlanarConfiguration()

public int getPlanarConfiguration()

يحصل أو يضبط تكوين المستوى.

Returns: int - التكوين المستوي.

setPlanarConfiguration(int value)

public void setPlanarConfiguration(int value)

يحصل أو يضبط تكوين المستوى.

Parameters:

معامل	نوع	الوصف
القيمة	int	التكوين المستوي.

Example: This example shows how to create a TIFF image from scratch and save it to a file.

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

com.aspose.imaging.imageoptions.TiffOptions createOptions =
        new com.aspose.imaging.imageoptions.TiffOptions(com.aspose.imaging.fileformats.tiff.enums.TiffExpectedFormat.Default);

// تعيين 8 بت لكل مكوّن لوني.
createOptions.setBitsPerSample(new int[]{8, 8, 8});

// تعيين ترتيب البايتات Big Endian (Motorola)
createOptions.setByteOrder(com.aspose.imaging.fileformats.tiff.enums.TiffByteOrder.BigEndian);

// تعيين ضغط LZW.
createOptions.setCompression(com.aspose.imaging.fileformats.tiff.enums.TiffCompressions.Lzw);

// تعيين نموذج اللون RGB.
createOptions.setPhotometric(com.aspose.imaging.fileformats.tiff.enums.TiffPhotometrics.Rgb);

// ستُخزن جميع مكوّنات اللون في مستوى واحد.
createOptions.setPlanarConfiguration(com.aspose.imaging.fileformats.tiff.enums.TiffPlanarConfigs.Contiguous);

// إنشاء إطار TIFF بحجم 100×100 بكسل.
// لاحظ أنه لا يلزم التخلص من الإطار صراحةً إذا كان مُدرجًا في TiffImage.
// عند التخلص من الحاوية، سيتم التخلص من جميع الإطارات تلقائيًا.
com.aspose.imaging.fileformats.tiff.TiffFrame firstFrame = new com.aspose.imaging.fileformats.tiff.TiffFrame(createOptions, 100, 100);

// املأ الإطار بالكامل بالتدرج اللوني الأزرق-الأصفر.
com.aspose.imaging.brushes.LinearGradientBrush gradientBrush = new com.aspose.imaging.brushes.LinearGradientBrush(
        new com.aspose.imaging.Point(0, 0),
        new com.aspose.imaging.Point(firstFrame.getWidth(), firstFrame.getHeight()),
        com.aspose.imaging.Color.getBlue(),
        com.aspose.imaging.Color.getYellow());

com.aspose.imaging.Graphics graphics = new com.aspose.imaging.Graphics(firstFrame);
graphics.fillRectangle(gradientBrush, firstFrame.getBounds());

// إنشاء صورة TIFF.
com.aspose.imaging.fileformats.tiff.TiffImage tiffImage = new com.aspose.imaging.fileformats.tiff.TiffImage(firstFrame);
try {
    tiffImage.save(dir + "output.tif");
} finally {
    tiffImage.dispose();
}

getResolutionUnit()

public int getResolutionUnit()

يحصل أو يضبط وحدة الدقة.

Returns: int - وحدة الدقة.

setResolutionUnit(int value)

public void setResolutionUnit(int value)

يحصل أو يضبط وحدة الدقة.

Parameters:

معامل	نوع	الوصف
القيمة	int	وحدة الدقة.

getRowsPerStrip()

public long getRowsPerStrip()

يحصل أو يضبط عدد الصفوف لكل شريط.

Returns: long - الصفوف لكل شريط.

setRowsPerStrip(long value)

public void setRowsPerStrip(long value)

يحصل أو يضبط عدد الصفوف لكل شريط.

Parameters:

معامل	نوع	الوصف
القيمة	long	الصفوف لكل شريط.

getTileWidth()

public long getTileWidth()

يحصل أو يضبط عرض البلاطة.

Returns: long

setTileWidth(long value)

public void setTileWidth(long value)

يحصل أو يضبط عرض البلاطة.

Parameters:

معامل	نوع	الوصف
القيمة	long

getTileLength()

public long getTileLength()

يحصل أو يضبط طول البلاطة.

Returns: long

setTileLength(long value)

public void setTileLength(long value)

يحصل أو يضبط طول البلاطة.

Parameters:

معامل	نوع	الوصف
القيمة	long

getSampleFormat()

public int[] getSampleFormat()

يحصل أو يضبط تنسيق العينة.

Returns: int[] - تنسيق العينة.

setSampleFormat(int[] value)

public void setSampleFormat(int[] value)

يحصل أو يضبط تنسيق العينة.

Parameters:

معامل	نوع	الوصف
القيمة	int[]	تنسيق العينة.

getSamplesPerPixel()

public int getSamplesPerPixel()

يحصل على العينات لكل بكسل. لتغيير قيمة هذه الخاصية استخدم مُعيّن الخاصية BitsPerSample.

Returns: int - العينات لكل بكسل.

getSmaxSampleValue()

public long[] getSmaxSampleValue()

يحصل أو يعيّن قيمة العينة القصوى. القيمة لها نوع حقل يتطابق بأفضل شكل مع بيانات العينة (نوع Byte أو Short أو Long).

Returns: long[] - قيمة العينة القصوى.

setSmaxSampleValue(long[] value)

public void setSmaxSampleValue(long[] value)

يحصل أو يعيّن قيمة العينة القصوى. القيمة لها نوع حقل يتطابق بأفضل شكل مع بيانات العينة (نوع Byte أو Short أو Long).

Parameters:

معامل	نوع	الوصف
القيمة	long[]	قيمة العينة القصوى.

getSminSampleValue()

public long[] getSminSampleValue()

يحصل أو يعيّن قيمة العينة الدنيا. القيمة لها نوع حقل يتطابق بأفضل شكل مع بيانات العينة (نوع Byte أو Short أو Long).

Returns: long[] - قيمة العينة الدنيا.

setSminSampleValue(long[] value)

public void setSminSampleValue(long[] value)

يحصل أو يعيّن قيمة العينة الدنيا. القيمة لها نوع حقل يتطابق بأفضل شكل مع بيانات العينة (نوع Byte أو Short أو Long).

Parameters:

معامل	نوع	الوصف
القيمة	long[]	قيمة العينة الدنيا.

getSoftwareType()

public String getSoftwareType()

يحصل أو يضبط نوع البرنامج.

Returns: java.lang.String - نوع البرنامج.

setSoftwareType(String value)

public void setSoftwareType(String value)

يحصل أو يضبط نوع البرنامج.

Parameters:

معامل	نوع	الوصف
القيمة	java.lang.String	نوع البرنامج.

getStripByteCounts()

public long[] getStripByteCounts()

يحصل أو يضبط عدد بايتات الشريط.

Returns: long[] - عدد بايتات الشريط.

setStripByteCounts(long[] value)

public void setStripByteCounts(long[] value)

يحصل أو يضبط عدد بايتات الشريط.

Parameters:

معامل	نوع	الوصف
القيمة	long[]	عدد بايتات الشريط.

getStripOffsets()

public long[] getStripOffsets()

يحصل أو يضبط إزاحات الشريط.

Returns: long[] - إزاحات الشريط.

setStripOffsets(long[] value)

public void setStripOffsets(long[] value)

يحصل أو يضبط إزاحات الشريط.

Parameters:

معامل	نوع	الوصف
القيمة	long[]	إزاحات الشريط.

getTileByteCounts()

public long[] getTileByteCounts()

يحصل أو يضبط عدد بايتات البلاط.

Returns: long[]

setTileByteCounts(long[] value)

public void setTileByteCounts(long[] value)

يحصل أو يضبط عدد بايتات البلاط.

Parameters:

معامل	نوع	الوصف
القيمة	long[]

getTileOffsets()

public long[] getTileOffsets()

يحصل أو يضبط إزاحات البلاط.

Returns: long[]

setTileOffsets(long[] value)

public void setTileOffsets(long[] value)

يحصل أو يضبط إزاحات البلاط.

Parameters:

معامل	نوع	الوصف
القيمة	long[]

getSubFileType()

public long getSubFileType()

يحصل أو يضبط إشارة عامة لنوع البيانات الموجودة في هذا الملف الفرعي.

Returns: long - الدلالة العامة على نوع البيانات الموجودة في هذا الملف الفرعي.

setSubFileType(long value)

public void setSubFileType(long value)

يحصل أو يضبط إشارة عامة لنوع البيانات الموجودة في هذا الملف الفرعي.

Parameters:

معامل	نوع	الوصف
القيمة	long	الدلالة العامة على نوع البيانات الموجودة في هذا الملف الفرعي.

getTargetPrinter()

public String getTargetPrinter()

يحصل أو يضبط الطابعة المستهدفة.

Returns: java.lang.String - الطابعة المستهدفة.

setTargetPrinter(String value)

public void setTargetPrinter(String value)

يحصل أو يضبط الطابعة المستهدفة.

Parameters:

معامل	نوع	الوصف
القيمة	java.lang.String	الطابعة المستهدفة.

getThreshholding()

public int getThreshholding()

يحصل أو يضبط العتبة.

Returns: int - العتبة.

setThreshholding(int value)

public void setThreshholding(int value)

يحصل أو يضبط العتبة.

Parameters:

معامل	نوع	الوصف
القيمة	int	العتبة.

getTotalPages()

public int getTotalPages()

يحصل على إجمالي الصفحات.

Returns: int - إجمالي الصفحات.

getXposition()

public TiffRational getXposition()

يحصل أو يضبط موضع x.

Returns: TiffRational - The x position.

setXposition(TiffRational value)

public void setXposition(TiffRational value)

يحصل أو يضبط موضع x.

Parameters:

معامل	نوع	الوصف
value	TiffRational	موضع x.

getResolutionSettings()

public ResolutionSetting getResolutionSettings()

يحصل أو يضبط إعدادات الدقة.

Returns: ResolutionSetting

setResolutionSettings(ResolutionSetting value)

public void setResolutionSettings(ResolutionSetting value)

يحصل أو يضبط إعدادات الدقة.

Parameters:

معامل	نوع	الوصف
value	ResolutionSetting

getXresolution()

public TiffRational getXresolution()

يحصل أو يضبط دقة x.

Returns: TiffRational - The x resolution.

setXresolution(TiffRational value)

public void setXresolution(TiffRational value)

يحصل أو يضبط دقة x.

Parameters:

معامل	نوع	الوصف
value	TiffRational	دقة x.

getYposition()

public TiffRational getYposition()

يحصل أو يضبط موضع y.

Returns: TiffRational - The y position.

setYposition(TiffRational value)

public void setYposition(TiffRational value)

يحصل أو يضبط موضع y.

Parameters:

معامل	نوع	الوصف
value	TiffRational	موضع y.

getYresolution()

public TiffRational getYresolution()

يحصل أو يضبط دقة y.

Returns: TiffRational - The y resolution.

setYresolution(TiffRational value)

public void setYresolution(TiffRational value)

يحصل أو يضبط دقة y.

Parameters:

معامل	نوع	الوصف
value	TiffRational	دقة y.

getFaxT4Options()

public long getFaxT4Options()

يحصل أو يضبط خيارات الفاكس t4.

Returns: long - خيارات الفاكس t4.

setFaxT4Options(long value)

public void setFaxT4Options(long value)

يحصل أو يضبط خيارات الفاكس t4.

Parameters:

معامل	نوع	الوصف
القيمة	long	خيارات الفاكس t4.

getPredictor()

public int getPredictor()

يحصل أو يضبط المتنبئ لضغط LZW.

Returns: int - نوع المتنبئ.

setPredictor(int value)

public void setPredictor(int value)

يحصل أو يضبط المتنبئ لضغط LZW.

Parameters:

معامل	نوع	الوصف
القيمة	int	نوع المتنبئ.

Example: This example shows how to save a raster image to the TIFF format using various options.

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

com.aspose.imaging.imageoptions.TiffOptions saveOptions
        = new com.aspose.imaging.imageoptions.TiffOptions(com.aspose.imaging.fileformats.tiff.enums.TiffExpectedFormat.Default);

// تعيين 8 بت لكل مكوّن لوني.
saveOptions.setBitsPerSample(new int[]{8, 8, 8});

// تعيين ترتيب البايتات Big Endian (Motorola)
saveOptions.setByteOrder(com.aspose.imaging.fileformats.tiff.enums.TiffByteOrder.BigEndian);

// تعيين ضغط LZW.
saveOptions.setCompression(com.aspose.imaging.fileformats.tiff.enums.TiffCompressions.Lzw);

// السماح بتقليل حجم الصور ذات النغمة المستمرة.
// حاليًا يُستخدم هذا الحقل فقط مع ترميز LZW لأن LZW ربما يكون نظام الترميز الوحيد لملفات TIFF
// الذي يستفيد بشكل كبير من خطوة المتنبئ.
saveOptions.setPredictor(com.aspose.imaging.fileformats.tiff.enums.TiffPredictor.Horizontal);

// تعيين نموذج اللون RGB.
saveOptions.setPhotometric(com.aspose.imaging.fileformats.tiff.enums.TiffPhotometrics.Rgb);

// بالنسبة إلى YCbCr، يمكنك استخدام أحد الخيارات التالية:
// حقل YCbCrSubSampling   عوامل أخذ العينات JPEG
// ----------------------------------------------
// 1,1                      1x1, 1x1, 1x1
// 2,1                      2x1, 1x1, 1x1
// 2,2(القيمة الافتراضية)       2x2, 1x1, 1x1
// saveOptions.YCbCrSubsampling = new ushort[] { 2, 2 };

// ستُخزن جميع مكوّنات اللون في مستوى واحد.
saveOptions.setPlanarConfiguration(com.aspose.imaging.fileformats.tiff.enums.TiffPlanarConfigs.Contiguous);

// إنشاء إطار TIFF بحجم 100×100 بكسل.
com.aspose.imaging.Image image = new com.aspose.imaging.fileformats.bmp.BmpImage(100, 100);
try {
    // املأ الصورة بالكامل بالتدرج الأزرق-الأصفر.
    com.aspose.imaging.brushes.LinearGradientBrush gradientBrush = new com.aspose.imaging.brushes.LinearGradientBrush(
            new com.aspose.imaging.Point(0, 0),
            new com.aspose.imaging.Point(image.getWidth(), image.getHeight()),
            com.aspose.imaging.Color.getBlue(),
            com.aspose.imaging.Color.getYellow());

    com.aspose.imaging.Graphics graphics = new com.aspose.imaging.Graphics(image);
    graphics.fillRectangle(gradientBrush, image.getBounds());

    image.save(dir + "output.tif", saveOptions);
} finally {
    image.dispose();
}

getImageLength()

public long getImageLength()

يحصل أو يضبط طول الصورة.

Returns: long - طول الصورة.

setImageLength(long value)

public void setImageLength(long value)

يحصل أو يضبط طول الصورة.

Parameters:

معامل	نوع	الوصف
القيمة	long	طول الصورة.

getImageWidth()

public long getImageWidth()

يحصل أو يضبط عرض الصورة.

Returns: long - عرض الصورة.

setImageWidth(long value)

public void setImageWidth(long value)

يحصل أو يضبط عرض الصورة.

Parameters:

معامل	نوع	الوصف
القيمة	long	عرض الصورة.

getExifIfd()

public TiffExifIfd getExifIfd()

يحصل أو يضبط المؤشر إلى EXIF IFD.

Returns: TiffExifIfd - The pointer to EXIF IFD.

getTags()

public TiffDataType[] getTags()

يحصل أو يضبط العلامات.

Returns: com.aspose.imaging.fileformats.tiff.TiffDataType[] - العلامات.

setTags(TiffDataType[] value)

public void setTags(TiffDataType[] value)

يحصل أو يضبط العلامات.

Parameters:

معامل	نوع	الوصف
value	TiffDataType[]	العلامات.

getValidTagCount()

public int getValidTagCount()

يحصل على عدد العلامات الصالحة. هذا ليس إجمالي عدد العلامات ولكن عدد العلامات التي يمكن حفظها.

Returns: int - عدد العلامات الصالحة.

getBitsPerPixel()

public int getBitsPerPixel()

يحصل على عدد البتات لكل بكسل.

Returns: int - عدد البتات لكل بكسل.

getXPTitle()

public final String getXPTitle()

يحصل على معلومات حول الصورة، التي يستخدمها مستكشف Windows.

القيمة: معلومات حول الصورة، تُستخدم بواسطة Windows Explorer. يتم تجاهل XPTitle(\#getXPTitle/#setXPTitle(String).setXPTitle(String)) بواسطة Windows Explorer إذا كان وسم ImageDescription(#getImageDescription.getImageDescription/#setImageDescription(String).setImageDescription(String)) موجودًا.

Returns: java.lang.String - معلومات حول الصورة، التي تُستخدم بواسطة Windows Explorer.

setXPTitle(String value)

public final void setXPTitle(String value)

يضبط معلومات حول الصورة، التي يستخدمها مستكشف Windows.

القيمة: معلومات حول الصورة، تُستخدم بواسطة Windows Explorer. يتم تجاهل XPTitle(#getXPTitle.getXPTitle/\#setXPTitle(String)) بواسطة Windows Explorer إذا كان وسم ImageDescription(#getImageDescription.getImageDescription/#setImageDescription(String).setImageDescription(String)) موجودًا.

Parameters:

معامل	نوع	الوصف
القيمة	java.lang.String	معلومات حول الصورة، التي تُستخدم بواسطة Windows Explorer.

getXPComment()

public final String getXPComment()

يحصل على تعليق على الصورة، الذي يستخدمه مستكشف Windows.

القيمة: تعليق على الصورة، يُستخدم بواسطة Windows Explorer.

Returns: java.lang.String - تعليق على الصورة، الذي يُستخدم بواسطة Windows Explorer.

setXPComment(String value)

public final void setXPComment(String value)

يضبط تعليق على الصورة، الذي يستخدمه مستكشف Windows.

القيمة: تعليق على الصورة، يُستخدم بواسطة Windows Explorer.

Parameters:

معامل	نوع	الوصف
القيمة	java.lang.String	تعليق على الصورة، والذي يستخدمه مستكشف Windows.

getXPAuthor()

public final String getXPAuthor()

يحصل على مؤلف الصورة، الذي يستخدمه مستكشف Windows.

القيمة: مؤلف الصورة، يستخدمه مستكشف Windows. يتم تجاهل XPAuthor(\#getXPAuthor/#setXPAuthor(String).setXPAuthor(String)) من قبل مستكشف Windows إذا كان وسم Artist(#getArtist.getArtist/#setArtist(String).setArtist(String)) موجودًا.

Returns: java.lang.String - مؤلف الصورة، والذي يستخدمه مستكشف Windows.

setXPAuthor(String value)

public final void setXPAuthor(String value)

يضبط مؤلف الصورة، الذي يستخدمه مستكشف Windows.

القيمة: مؤلف الصورة، يستخدمه مستكشف Windows. يتم تجاهل XPAuthor(#getXPAuthor.getXPAuthor/\#setXPAuthor(String)) من قبل مستكشف Windows إذا كان وسم Artist(#getArtist.getArtist/#setArtist(String).setArtist(String)) موجودًا.

Parameters:

معامل	نوع	الوصف
القيمة	java.lang.String	مؤلف الصورة، والذي يستخدمه مستكشف Windows.

getXPKeywords()

public final String getXPKeywords()

يحصل على موضوع الصورة، الذي يستخدمه مستكشف Windows.

القيمة: صورة الموضوع، يستخدمها مستكشف Windows.

Returns: java.lang.String - صورة الموضوع، والتي يستخدمها مستكشف Windows.

setXPKeywords(String value)

public final void setXPKeywords(String value)

يضبط صورة الموضوع، التي تُستخدم بواسطة Windows Explorer.

القيمة: صورة الموضوع، يستخدمها مستكشف Windows.

Parameters:

معامل	نوع	الوصف
القيمة	java.lang.String	صورة الموضوع، والتي يستخدمها مستكشف Windows.

getXPSubject()

public final String getXPSubject()

يحصل على معلومات حول الصورة، التي يستخدمها مستكشف Windows.

القيمة: معلومات حول الصورة، يستخدمها مستكشف Windows.

Returns: java.lang.String - معلومات حول الصورة، التي تُستخدم بواسطة Windows Explorer.

setXPSubject(String value)

public final void setXPSubject(String value)

يضبط معلومات حول الصورة، التي يستخدمها مستكشف Windows.

القيمة: معلومات حول الصورة، يستخدمها مستكشف Windows.

Parameters:

معامل	نوع	الوصف
القيمة	java.lang.String	معلومات حول الصورة، التي تُستخدم بواسطة Windows Explorer.

getExifData()

public ExifData getExifData()

يحصل على بيانات Exif.

Returns: ExifData - Exif data.

setExifData(ExifData value)

public void setExifData(ExifData value)

يضبط بيانات Exif.

Parameters:

معامل	نوع	الوصف
value	ExifData	بيانات Exif.

removeTag(int tag)

public boolean removeTag(int tag)

يزيل العلامة.

Parameters:

معامل	نوع	الوصف
علامة	int	الوسم المراد إزالته.

Returns: منطقي - true إذا تم الإزالة بنجاح

removeTags(int[] tags)

public final boolean removeTags(int[] tags)

يزيل العلامات.

Parameters:

معامل	نوع	الوصف
الوسوم	int[]	الوسوم المراد إزالتها.

Returns: منطقي - `` إذا تغير حجم مجموعة الوسوم.

validate()

public void validate()

يتحقق مما إذا كانت الخيارات تحتوي على تركيبة صالحة من العلامات

addTags(TiffDataType[] tagsToAdd)

public void addTags(TiffDataType[] tagsToAdd)

يضيف العلامات.

Parameters:

معامل	نوع	الوصف
tagsToAdd	TiffDataType[]	الوسوم المراد إضافتها.

addTag(TiffDataType tagToAdd)

public void addTag(TiffDataType tagToAdd)

يضيف علامة جديدة.

Parameters:

معامل	نوع	الوصف
tagToAdd	TiffDataType	الوسم المراد إضافته.

getTagByType(int tagKey)

public TiffDataType getTagByType(int tagKey)

يحصل على نسخة العلامة حسب النوع.

Parameters:

معامل	نوع	الوصف
tagKey	int	مفتاح الوسم.

Returns: TiffDataType - Instance of the tag if exists or null otherwise.