PDFXLTiffImage¶

Namespace: O2S.Components.PDF4NET.Graphics

Defines an extra large TIFF image.

public class PDFXLTiffImage : PDFImage

Inheritance Object → PDFImage → PDFXLTiffImage

Remarks

Extra large TIFF images are not loaded in memory while the PDF file is created, their content is transfered directly to the output PDF file when it is saved. Because of this a reference to the original TIFF stream must be kept until the PDF file is saved.

Constructors¶

PDFXLTiffImage(Stream)¶

Initializes a new PDFXLTiffImage object.

public PDFXLTiffImage(Stream stream)

Parameters

stream Stream
TIFF stream.

PDFXLTiffImage(Stream, Boolean)¶

Initializes a new PDFXLTiffImage object.

public PDFXLTiffImage(Stream stream, bool disposeStream)

Parameters

stream Stream
TIFF stream.

disposeStream Boolean
If true, the input stream is disposed after the image has been written to the PDF file.

PDFXLTiffImage(Stream, Int32)¶

Initializes a new PDFXLTiffImage object.

public PDFXLTiffImage(Stream stream, int frameIndex)

Parameters

stream Stream
TIFF stream.

frameIndex Int32
TIFF frame to use for creating the image.

PDFXLTiffImage(Stream, Int32, Boolean)¶

Initializes a new PDFXLTiffImage object.

public PDFXLTiffImage(Stream stream, int frameIndex, bool disposeStream)

Parameters

stream Stream
TIFF stream.

frameIndex Int32
TIFF frame to use for creating the image.

disposeStream Boolean
If true, the input stream is disposed after the image has been written to the PDF file.

Properties¶

AlternateImages¶

Gets or sets the alternate images.

public PDFAlternateImageCollection AlternateImages { get; set; }

Property Value

PDFAlternateImageCollection
A collection of alternate images to be used instead of this image.

BitsPerComponent¶

Gets or sets the bits per component.

public int BitsPerComponent { get; set; }

Property Value

Int32
The number of bits used to represent each color component.

Remarks

Valid values are 1, 2, 4, 8, and (in PDF 1.5) 16

ColorSpace¶

Gets or sets the color space.

public PDFColorSpace ColorSpace { get; set; }

Property Value

PDFColorSpace
The color space in which image samples are specified.

CosDictionary¶

Gets the COS dictionary asssociated with this object.

public PDFCosDictionary CosDictionary { get; }

Property Value

PDFCosDictionary
The internal COS dictionary.

Remarks

Incorrect manipulation of the information in the COS dictionary can lead to invalid PDF files.

FrameCount¶

Gets the image frame count.

public int FrameCount { get; }

Property Value

Int32
The number of frames in this TIFF image.

Height¶

Gets the image height.

public int Height { get; set; }

Property Value

Int32
The image height in pixels.

Interpolate¶

Gets or sets a value indicating whether image interpolation is to be performed.

public bool Interpolate { get; set; }

Property Value

Boolean
If true, the image is interpolated when displayed on the output device.

LogicalHeight¶

Gets the logical image height.

public int LogicalHeight { get; }

Property Value

Int32
The image height in pixels depending on image orientation.

LogicalWidth¶

Gets the logical image width.

public int LogicalWidth { get; }

Property Value

Int32
The image width in pixels depending on image orientation.

Mask¶

Gets or sets the image mask.

public PDFImageMask Mask { get; set; }

Property Value

PDFImageMask
An image mask to be applied to this image.

Measure¶

Gets or sets the image measure.

public PDFMeasure Measure { get; set; }

Property Value

PDFMeasure
A PDFMeasure descendant object that specifies the scale and units which shall apply to the image.

Orientation¶

Gets or sets the image orientation.

public PDFImageOrientation Orientation { get; internal set; }

Property Value

PDFImageOrientation

PointData¶

Gets or sets the point data.

public PDFPointData PointData { get; set; }

Property Value

PDFPointData
A PDFPointData object that specifies the extended geospatial data that shall apply to the image.

SourceXResolution¶

Gets the X resolution in the source image.

public double SourceXResolution { get; }

Property Value

Double
The X resolution of the source image or 0 if the value is not specified.

SourceYResolution¶

Gets the Y resolution in the source image.

public double SourceYResolution { get; }

Property Value

Double
The Y resolution of the source image or 0 if the value is not specified.

StructureElement¶

Gets or sets the structure element that represents this image.

public PDFStructureElement StructureElement { get; set; }

Property Value

PDFStructureElement
A PDFStructureElement object representing this image.

Width¶

Gets the image width.

public int Width { get; set; }

Property Value

Int32
The image width in pixels.

Methods¶

ApplyFilter(PDFFilterType)¶

Applies the specified PDF compression filter to image data.

public void ApplyFilter(PDFFilterType pdfFilter)

Parameters

pdfFilter PDFFilterType
Type of compression to apply

Remarks

This class does not support applying additional filters on image data.