TiffOptions

TiffOptions class

Параметры формата файла tiff. Обратите внимание, что теги ширины и высоты будут перезаписаны при создании изображения параметрами ширины и высоты, поэтому нет необходимости указывать их напрямую. Обратите внимание, что многие параметры возвращают значение по умолчанию, но это не означает, что этот параметр задается явно как значение тега. Чтобы проверить наличие тега, используйте свойство Tags или соответствующий метод IsTagPresent.

public class TiffOptions : ImageOptionsBase

Конструкторы

ИмяОписание
TiffOptions(TiffDataType[])Инициализирует новый экземплярTiffOptions класс.
TiffOptions(TiffExpectedFormat)Инициализирует новый экземплярTiffOptionsучебный класс. По умолчанию используется соглашение с прямым порядком байтов.
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; }Получает или задает максимальное значение выборки. Значение имеет тип поля, который лучше всего соответствует образцу данных (тип Byte, Short или Long).
SminSampleValue { get; set; }Получает или задает минимальное значение выборки. Значение имеет тип поля, который лучше всего соответствует образцу данных (тип Byte, Short или Long).
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 для целей экспорта. Изображение типа 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);

    //Создаем экземпляр изображения 
    using (Aspose.Imaging.Image image = Aspose.Imaging.Image.Create(tiffOptions, 500, 500))
    {
        //Создаем и инициализируем экземпляр класса Graphics
        Aspose.Imaging.Graphics graphics = new Aspose.Imaging.Graphics(image);

        //Очистить графическую поверхность
        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();
    }
}

Смотрите также