类 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; }获取或设置 alpha 存储选项。当定义的 SamplesPerPixel 超过 3 时，除 Unspecified 之外的选项将被使用。
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 属性的 setter。
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 Explorer 使用。
XPComment { get; set; }获取或设置图像注释，此信息由 Windows Explorer 使用。
XPKeywords { get; set; }获取或设置图像主题，此信息由 Windows Explorer 使用。
Xposition { get; set; }获取或设置 x 位置。
XPSubject { get; set; }获取或设置信息关于图像，此信息由 Windows Explorer 使用。
XPTitle { get; set; }获取或设置信息关于图像，此信息由 Windows Explorer 使用。
Xresolution { get; set; }获取或设置 x 分辨率。
YCbCrCoefficients { get; set; }获取或设置 YCbCrCoefficients。
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\\";

//在 Image 类的实例中加载现有的 Gif 类型图像。
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 类在图像表面上创建和操作图形。示例创建一个新的 Image（Tiff 类型），清除表面并借助 GraphicsPath 类绘制路径。最后调用 Graphics 类公开的 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);

    //创建 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);

        //使用颜色为 Black 的 Pen 对象绘制路径
        graphics.DrawPath(new Aspose.Imaging.Pen(Aspose.Imaging.Color.Black, 2), graphicspath);

        // 保存所有更改。
        image.Save();
    }
}

另请参见

类 TgaOptions 枚举 TiffOptionsError