TiffOptions

TiffOptions class

Die TIFF-Dateiformatoptionen. Beachten Sie, dass Breiten- und Höhen-Tags bei der Bilderzeugung durch Breiten- und Höhenparameter überschrieben werden, sodass sie nicht direkt angegeben werden müssen. Beachten Sie, dass viele Optionen einen Standardwert zurückgeben, aber das bedeutet nicht diese Option wird explizit als Tag-Wert festgelegt. Um zu überprüfen, ob das Tag vorhanden ist, verwenden Sie die Tags-Eigenschaft oder die entsprechende IsTagPresent-Methode.

public class TiffOptions : ImageOptionsBase

Konstrukteure

NameBeschreibung
TiffOptions(TiffDataType[])Initialisiert eine neue Instanz vonTiffOptions Klasse.
TiffOptions(TiffExpectedFormat)Initialisiert eine neue Instanz vonTiffOptionsKlasse. Standardmäßig wird die Little-Endian-Konvention verwendet.
TiffOptions(TiffOptions)Initialisiert eine neue Instanz vonTiffOptions Klasse.
TiffOptions(TiffExpectedFormat, TiffByteOrder)Initialisiert eine neue Instanz vonTiffOptions Klasse.

Eigenschaften

NameBeschreibung
AlphaStorage { get; set; }Ruft die Alpha-Speicheroption ab oder legt sie fest. Andere Optionen alsUnspecified werden verwendet, wenn es mehr als 3 gibtSamplesPerPixel definiert.
Artist { get; set; }Ruft den Künstler ab oder legt ihn fest.
BitsPerPixel { get; }Ruft die Bits pro Pixel ab.
BitsPerSample { get; set; }Holt oder setzt die Bits pro Sample.
BufferSizeHint { get; set; }Ruft den Puffergrößenhinweis ab oder legt ihn fest, der als maximal zulässige Größe für alle internen Puffer definiert ist.
ByteOrder { get; set; }Ruft einen Wert ab oder legt einen Wert fest, der die TIFF-Byte-Reihenfolge angibt.
ColorMap { get; set; }Ruft die Farbkarte ab oder legt sie fest.
CompressedQuality { get; set; }Ruft die komprimierte Bildqualität ab oder legt sie fest. Wird mit der JPEG-Komprimierung verwendet.
Compression { get; set; }Ruft die Komprimierung ab oder legt sie fest.
Copyright { get; set; }Ruft das Urheberrecht ab oder legt es fest.
DateTime { get; set; }Ruft Datum und Uhrzeit ab oder legt sie fest.
DisableIccExport { get; set; }Ruft oder setzt einen Wert, der angibt, ob der ICC-Profilexport deaktiviert ist (das ICC-Profil wird vorher auf die Quellpixel angewendet).
Disposed { get; }Ruft einen Wert ab, der angibt, ob diese Instanz verworfen wird.
DocumentName { get; set; }Ruft den Namen des Dokuments ab oder legt ihn fest.
ExifIfd { get; }Holt oder setzt den Zeiger auf EXIF IFD.
ExtraSamples { get; }Ruft die zusätzlichen Abtastwerte ab.
FaxT4Options { get; set; }Ruft die Fax-t4-Optionen ab oder legt sie fest.
FileStandard { get; set; }Ruft den TIFF-Dateistandard ab oder legt ihn fest.
FillOrder { get; set; }Ruft die Füllreihenfolge der Byte-Bits ab oder legt sie fest.
FullFrame { get; set; }Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob [Vollbild].
HalfToneHints { get; set; }Ruft die Halbtonhinweise ab oder legt sie fest.
IccProfile { get; set; }Ruft den Icc-Profilstream ab oder legt ihn fest.
ImageDescription { get; set; }Ruft die Bildbeschreibung ab oder legt sie fest.
ImageLength { get; set; }Ruft die Bildlänge ab oder legt sie fest.
ImageWidth { get; set; }Ruft die Bildbreite ab oder legt sie fest.
InkNames { get; set; }Ruft die Tintennamen ab oder legt sie fest.
IsExtraSamplesPresent { get; }Ruft einen Wert ab, der angibt, ob die zusätzlichen Proben vorhanden sind.
IsTiled { get; }Ruft einen Wert ab, der angibt, ob das Bild gekachelt ist.
IsValid { get; }Ruft einen Wert ab, der angibt, ob dieTiffOptions richtig konfiguriert wurden. Verwenden Sie die Validate-Methode, um die Fehlerursache zu finden.
MaxSampleValue { get; set; }Ruft den maximalen Abtastwert ab oder legt ihn fest.
MinSampleValue { get; set; }Ruft den minimalen Abtastwert ab oder legt ihn fest.
MultiPageOptions { get; set; }Die mehrseitigen Optionen
Orientation { get; set; }Ruft die Ausrichtung ab oder legt sie fest.
PageName { get; set; }Ruft den Seitennamen ab oder legt ihn fest.
PageNumber { get; set; }Ruft das Seitenzahl-Tag ab oder legt es fest.
override Palette { get; set; }Ruft die Farbpalette ab oder legt sie fest.
Photometric { get; set; }Ruft die photometrischen Daten ab oder legt sie fest.
PlanarConfiguration { get; set; }Ruft die planare Konfiguration ab oder legt sie fest.
Predictor { get; set; }Ruft den Prädiktor für die LZW-Komprimierung ab oder legt ihn fest.
PremultiplyComponents { get; set; }Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob Komponenten vormultipliziert werden müssen.
ProgressEventHandler { get; set; }Ruft den Fortschrittsereignishandler ab oder legt ihn fest.
override ResolutionSettings { get; set; }Ruft die Auflösungseinstellungen ab oder legt sie fest.
ResolutionUnit { get; set; }Ruft die Auflösungseinheit ab oder legt sie fest.
RowsPerStrip { get; set; }Ruft die Zeilen pro Streifen ab oder legt sie fest.
SampleFormat { get; set; }Ruft das Beispielformat ab oder legt es fest.
SamplesPerPixel { get; }Ruft die Samples pro Pixel ab. Um diesen Eigenschaftswert zu ändern, verwenden Sie dieBitsPerSample Property-Setter.
ScannerManufacturer { get; set; }Ruft den Scannerhersteller ab oder legt ihn fest.
ScannerModel { get; set; }Ruft das Scannermodell ab oder legt es fest.
SmaxSampleValue { get; set; }Ruft den maximalen Abtastwert ab oder setzt ihn. Der Wert hat einen Feldtyp, der am besten zu den Beispieldaten passt (Typ Byte, Short oder Long).
SminSampleValue { get; set; }Ruft den minimalen Abtastwert ab oder setzt ihn. Der Wert hat einen Feldtyp, der am besten zu den Beispieldaten passt (Typ Byte, Short oder Long).
SoftwareType { get; set; }Ruft den Softwaretyp ab oder legt ihn fest.
Source { get; set; }Ruft die Quelle zum Erstellen des Bildes ab oder legt sie fest.
StripByteCounts { get; set; }Ruft die Anzahl der Strip-Bytes ab oder legt sie fest.
StripOffsets { get; set; }Holt oder setzt die Streifen-Offsets.
SubFileType { get; set; }Holt oder setzt einen allgemeinen Hinweis auf die Art der Daten, die in dieser Unterdatei enthalten sind.
Tags { get; set; }Ruft die Tags ab oder legt sie fest.
TargetPrinter { get; set; }Ruft den Zieldrucker ab oder setzt ihn.
Threshholding { get; set; }Ruft den Schwellenwert ab oder legt ihn fest.
TileByteCounts { get; set; }Ruft die Tile-Byte-Anzahl ab oder legt sie fest.
TileLength { get; set; }Ruft ot-Sets-Kachellänge ab.
TileOffsets { get; set; }Ruft die Kachel-Offsets ab oder legt sie fest.
TileWidth { get; set; }Ruft die Kachelbreite ab.
TotalPages { get; }Ruft die Gesamtzahl der Seiten ab.
ValidTagCount { get; }Ruft die gültige Tag-Anzahl ab. Dies ist nicht die Gesamtzahl der Tags, sondern die Anzahl der Tags, die beibehalten werden können.
VectorRasterizationOptions { get; set; }Ruft die Optionen für die Vektorrasterung ab oder legt sie fest.
override XmpData { get; set; }Ruft den XMP-Metadatencontainer ab oder legt ihn fest.
XPAuthor { get; set; }Ruft den Bildautor ab oder legt ihn fest, der von Windows Explorer verwendet wird.
XPComment { get; set; }Holt oder setzt Kommentar zum Bild, das von Windows Explorer verwendet wird.
XPKeywords { get; set; }Ruft das Motivbild ab oder legt es fest, das von Windows Explorer verwendet wird.
Xposition { get; set; }Ruft die x-Position ab oder legt sie fest.
XPSubject { get; set; }Ruft Informationen über Bilder ab oder legt sie fest, die von Windows Explorer verwendet werden.
XPTitle { get; set; }Ruft Informationen über Bilder ab oder legt sie fest, die von Windows Explorer verwendet werden.
Xresolution { get; set; }Ruft die x-Auflösung ab oder legt sie fest.
YCbCrCoefficients { get; set; }Ruft die YCbCrCoefficients ab oder setzt sie.
YCbCrSubsampling { get; set; }Liest oder setzt die Subsampling-Faktoren für YCbCr photometric.
Yposition { get; set; }Ruft die y-Position ab oder legt sie fest.
Yresolution { get; set; }Ruft die y-Auflösung ab oder legt sie fest.

Methoden

NameBeschreibung
AddTag(TiffDataType)Fügt ein neues Tag hinzu.
AddTags(TiffDataType[])Fügt die Tags hinzu.
virtual Clone()Klont diese Instanz.
Dispose()Verwirft die aktuelle Instanz.
GetTagByType(TiffTags)Ruft die Instanz des Tags nach Typ ab.
IsTagPresent(TiffTags)Legt fest, ob Tag in den Optionen vorhanden ist oder nicht.
RemoveTag(TiffTags)Entfernt das Tag.
Validate()Prüft, ob Optionen eine gültige Kombination von Tags haben
static GetValidTagsCount(TiffDataType[])Ruft die Anzahl gültiger Tags ab.

Beispiele

Dieses Beispiel demonstriert die Verwendung verschiedener Klassen aus dem SaveOptions-Namespace für Exportzwecke. Ein Bild vom Typ Gif wird in eine Instanz von Image geladen und dann in mehrere Formate exportiert.

[C#]

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

//Ein vorhandenes Bild (vom Typ Gif) in eine Instanz der Image-Klasse laden
using (Aspose.Imaging.Image image = Aspose.Imaging.Image.Load(dir + "sample.gif"))
{
    //Export in das BMP-Dateiformat unter Verwendung der Standardoptionen
    image.Save(dir + "output.bmp", new Aspose.Imaging.ImageOptions.BmpOptions());

    // Mit den Standardoptionen in das JPEG-Dateiformat exportieren
    image.Save(dir + "output.jpg", new Aspose.Imaging.ImageOptions.JpegOptions());

    // Mit den Standardoptionen in das PNG-Dateiformat exportieren
    image.Save(dir + "output.png", new Aspose.Imaging.ImageOptions.PngOptions());

    // Mit den Standardoptionen in das TIFF-Dateiformat exportieren
    image.Save(dir + "output.tif", new Aspose.Imaging.ImageOptions.TiffOptions(Aspose.Imaging.FileFormats.Tiff.Enums.TiffExpectedFormat.Default));
}

Das folgende Beispiel zeigt, wie Sie ein mehrseitiges Vektorbild auf allgemeine Weise in das TIFF-Format konvertieren, ohne auf einen bestimmten Bildtyp zu verweisen.

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

    // Nur die ersten beiden Seiten exportieren. Diese Seiten werden im Ausgabe-TIFF als Rahmen dargestellt.
    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);
}

Dieses Beispiel verwendet GraphicsPath und die Graphics-Klasse, um Figuren auf einer Bildoberfläche zu erstellen und zu manipulieren. Beispiel erstellt ein neues Bild (vom Typ Tiff), löscht die Oberfläche und zeichnet Pfade mit Hilfe der GraphicsPath-Klasse. Am Ende wird die DrawPath-Methode aufgerufen, die von der Graphics-Klasse bereitgestellt wird, um die Pfade auf der Oberfläche zu rendern.

[C#]

//Eine Instanz von FileStream erstellen
using (System.IO.FileStream stream = new System.IO.FileStream(@"C:\temp\output.tiff", System.IO.FileMode.Create))
{
    //Eine Instanz von TiffOptions erstellen und ihre verschiedenen Eigenschaften festlegen
    Aspose.Imaging.ImageOptions.TiffOptions tiffOptions = new Aspose.Imaging.ImageOptions.TiffOptions(Imaging.FileFormats.Tiff.Enums.TiffExpectedFormat.Default);

    //Setzen Sie die Quelle für die Instanz von ImageOptions
    tiffOptions.Source = new Aspose.Imaging.Sources.StreamSource(stream);

    //Eine Instanz von Image erstellen 
    using (Aspose.Imaging.Image image = Aspose.Imaging.Image.Create(tiffOptions, 500, 500))
    {
        //Eine Instanz der Graphics-Klasse erstellen und initialisieren
        Aspose.Imaging.Graphics graphics = new Aspose.Imaging.Graphics(image);

        //Grafikoberfläche löschen
        graphics.Clear(Color.Wheat);

        //Eine Instanz der GraphicsPath-Klasse erstellen
        Aspose.Imaging.GraphicsPath graphicspath = new Aspose.Imaging.GraphicsPath();

        //Eine Instanz der Figure-Klasse erstellen
        Aspose.Imaging.Figure figure = new Aspose.Imaging.Figure();

        //Formen zum Figurobjekt hinzufügen
        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-Objekt zu GraphicsPath hinzufügen
        graphicspath.AddFigure(figure);

        // Pfad mit Stiftobjekt der Farbe Schwarz zeichnen
        graphics.DrawPath(new Aspose.Imaging.Pen(Aspose.Imaging.Color.Black, 2), graphicspath);

        // Alle Änderungen speichern.
        image.Save();
    }
}

Siehe auch

TgaOptions TiffOptionsError