TiffOptions

TiffOptions class

Le opzioni del formato del file tiff. Si noti che i tag di larghezza e altezza verranno sovrascritti durante la creazione dell’immagine dai parametri di larghezza e altezza, quindi non è necessario specificarli direttamente. Si noti che molte opzioni restituiscono un valore predefinito, ma ciò non significa che questa opzione è impostata esplicitamente come valore di tag. Per verificare la presenza del tag utilizzare la proprietà Tags o il metodo IsTagPresent corrispondente.

public class TiffOptions : ImageOptionsBase

Costruttori

NomeDescrizione
TiffOptions(TiffDataType[])Inizializza una nuova istanza diTiffOptions classe.
TiffOptions(TiffExpectedFormat)Inizializza una nuova istanza diTiffOptionsclasse. Per impostazione predefinita viene utilizzata la convenzione little endian.
TiffOptions(TiffOptions)Inizializza una nuova istanza diTiffOptions classe.
TiffOptions(TiffExpectedFormat, TiffByteOrder)Inizializza una nuova istanza diTiffOptions classe.

Proprietà

NomeDescrizione
AlphaStorage { get; set; }Ottiene o imposta l’opzione di archiviazione alfa. Opzioni diverse daUnspecified vengono utilizzati quando ce ne sono più di 3SamplesPerPixel definito.
Artist { get; set; }Ottiene o imposta l’artista.
BitsPerPixel { get; }Ottiene i bit per pixel.
BitsPerSample { get; set; }Ottiene o imposta i bit per campione.
BufferSizeHint { get; set; }Ottiene o imposta l’hint per la dimensione del buffer che è la dimensione massima consentita per tutti i buffer interni.
ByteOrder { get; set; }Ottiene o imposta un valore che indica l’ordine dei byte tiff.
ColorMap { get; set; }Ottiene o imposta la mappa dei colori.
CompressedQuality { get; set; }Ottiene o imposta la qualità dell’immagine compressa. Usato con la compressione Jpeg.
Compression { get; set; }Ottiene o imposta la compressione.
Copyright { get; set; }Ottiene o imposta il copyright.
DateTime { get; set; }Ottiene o imposta la data e l’ora.
DisableIccExport { get; set; }Ottiene o imposta un valore che indica se l’esportazione del profilo ICC è disabilitata (il profilo ICC viene applicato in anticipo ai pixel di origine).
Disposed { get; }Ottiene un valore che indica se questa istanza è stata eliminata.
DocumentName { get; set; }Ottiene o imposta il nome del documento.
ExifIfd { get; }Ottiene o imposta il puntatore su EXIF IFD.
ExtraSamples { get; }Ottiene i valori dei campioni extra.
FaxT4Options { get; set; }Ottiene o imposta le opzioni fax t4.
FileStandard { get; set; }Ottiene o imposta lo standard del file TIFF.
FillOrder { get; set; }Ottiene o imposta l’ordine di riempimento dei bit di byte.
FullFrame { get; set; }Ottiene o imposta un valore che indica se [fotogramma intero].
HalfToneHints { get; set; }Ottiene o imposta i suggerimenti per i mezzitoni.
IccProfile { get; set; }Ottiene o imposta il flusso del profilo Icc.
ImageDescription { get; set; }Ottiene o imposta la descrizione dell’immagine.
ImageLength { get; set; }Ottiene o imposta la lunghezza dell’immagine.
ImageWidth { get; set; }Ottiene o imposta la larghezza dell’immagine.
InkNames { get; set; }Ottiene o imposta i nomi degli inchiostri.
IsExtraSamplesPresent { get; }Ottiene un valore che indica se i campioni aggiuntivi sono presenti.
IsTiled { get; }Ottiene un valore che indica se l’immagine è affiancata.
IsValid { get; }Ottiene un valore che indica se ilTiffOptions sono stati configurati correttamente. Utilizzare il metodo Convalida per trovare il motivo dell’errore.
MaxSampleValue { get; set; }Ottiene o imposta il valore di campionamento massimo.
MinSampleValue { get; set; }Ottiene o imposta il valore di campionamento minimo.
MultiPageOptions { get; set; }Le opzioni multipagina
Orientation { get; set; }Ottiene o imposta l’orientamento.
PageName { get; set; }Ottiene o imposta il nome della pagina.
PageNumber { get; set; }Ottiene o imposta il tag del numero di pagina.
override Palette { get; set; }Ottiene o imposta la tavolozza dei colori.
Photometric { get; set; }Ottiene o imposta la fotometrica.
PlanarConfiguration { get; set; }Ottiene o imposta la configurazione planare.
Predictor { get; set; }Ottiene o imposta il predittore per la compressione LZW.
PremultiplyComponents { get; set; }Ottiene o imposta un valore che indica se i componenti devono essere premoltiplicati.
ProgressEventHandler { get; set; }Ottiene o imposta il gestore dell’evento di avanzamento.
override ResolutionSettings { get; set; }Ottiene o imposta le impostazioni di risoluzione.
ResolutionUnit { get; set; }Ottiene o imposta l’unità di risoluzione.
RowsPerStrip { get; set; }Ottiene o imposta le righe per striscia.
SampleFormat { get; set; }Ottiene o imposta il formato di esempio.
SamplesPerPixel { get; }Ottiene i campioni per pixel. Per modificare questo valore di proprietà, utilizzare ilBitsPerSample setter proprietà.
ScannerManufacturer { get; set; }Ottiene o imposta il produttore dello scanner.
ScannerModel { get; set; }Ottiene o imposta il modello dello scanner.
SmaxSampleValue { get; set; }Ottiene o imposta il valore di campionamento massimo. Il valore ha un tipo di campo che corrisponde meglio ai dati di esempio (tipo Byte, Short o Long).
SminSampleValue { get; set; }Ottiene o imposta il valore di campionamento minimo. Il valore ha un tipo di campo che corrisponde meglio ai dati di esempio (tipo Byte, Short o Long).
SoftwareType { get; set; }Ottiene o imposta il tipo di software.
Source { get; set; }Ottiene o imposta l’origine in cui creare l’immagine.
StripByteCounts { get; set; }Ottiene o imposta i conteggi di strip byte.
StripOffsets { get; set; }Ottiene o imposta gli offset delle strisce.
SubFileType { get; set; }Ottiene o imposta un’indicazione generale del tipo di dati contenuti in questo file secondario.
Tags { get; set; }Ottiene o imposta i tag.
TargetPrinter { get; set; }Ottiene o imposta la stampante di destinazione.
Threshholding { get; set; }Ottiene o imposta la soglia.
TileByteCounts { get; set; }Ottiene o imposta i conteggi di byte del riquadro.
TileLength { get; set; }Ottiene o imposta la lunghezza del riquadro.
TileOffsets { get; set; }Ottiene o imposta gli offset delle tessere.
TileWidth { get; set; }Ottiene o imposta la larghezza della piastrella.
TotalPages { get; }Ottiene le pagine totali.
ValidTagCount { get; }Ottiene il conteggio dei tag validi. Questo non è il conteggio totale dei tag ma il numero di tag che possono essere conservati.
VectorRasterizationOptions { get; set; }Ottiene o imposta le opzioni di rasterizzazione del vettore.
override XmpData { get; set; }Ottiene o imposta il contenitore di metadati XMP.
XPAuthor { get; set; }Ottiene o imposta l’autore dell’immagine, utilizzato da Esplora risorse.
XPComment { get; set; }Ottiene o imposta il commento sull’immagine, utilizzato da Esplora risorse.
XPKeywords { get; set; }Ottiene o imposta l’immagine del soggetto, utilizzata da Esplora risorse.
Xposition { get; set; }Ottiene o imposta la posizione x.
XPSubject { get; set; }Ottiene o imposta informazioni sull’immagine, utilizzate da Esplora risorse.
XPTitle { get; set; }Ottiene o imposta informazioni sull’immagine, utilizzate da Esplora risorse.
Xresolution { get; set; }Ottiene o imposta la risoluzione x.
YCbCrCoefficients { get; set; }Ottiene o imposta YCbCrCoefficients.
YCbCrSubsampling { get; set; }Ottiene o imposta i fattori di sottocampionamento per il fotometrico YCbCr.
Yposition { get; set; }Ottiene o imposta la posizione y.
Yresolution { get; set; }Ottiene o imposta la risoluzione y.

Metodi

NomeDescrizione
AddTag(TiffDataType)Aggiunge un nuovo tag.
AddTags(TiffDataType[])Aggiunge i tag.
virtual Clone()Clona questa istanza.
Dispose()Elimina l’istanza corrente.
GetTagByType(TiffTags)Ottiene l’istanza del tag per tipo.
IsTagPresent(TiffTags)Determina se il tag è presente nelle opzioni o meno.
RemoveTag(TiffTags)Rimuove il tag.
Validate()Convalida se le opzioni hanno una combinazione valida di tag
static GetValidTagsCount(TiffDataType[])Ottiene il conteggio dei tag validi.

Esempi

Questo esempio mostra l’uso di classi diverse da SaveOptions Namespace per scopi di esportazione. Un’immagine di tipo Gif viene caricata in un’istanza di Image e quindi esportata in diversi formati.

[C#]

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

//Carica un'immagine esistente (di tipo Gif) in un'istanza della classe Image
using (Aspose.Imaging.Image image = Aspose.Imaging.Image.Load(dir + "sample.gif"))
{
    //Esporta in formato file BMP utilizzando le opzioni predefinite
    image.Save(dir + "output.bmp", new Aspose.Imaging.ImageOptions.BmpOptions());

    //Esporta in formato file JPEG utilizzando le opzioni predefinite
    image.Save(dir + "output.jpg", new Aspose.Imaging.ImageOptions.JpegOptions());

    //Esporta in formato file PNG utilizzando le opzioni predefinite
    image.Save(dir + "output.png", new Aspose.Imaging.ImageOptions.PngOptions());

    //Esporta in formato file TIFF utilizzando le opzioni predefinite
    image.Save(dir + "output.tif", new Aspose.Imaging.ImageOptions.TiffOptions(Aspose.Imaging.FileFormats.Tiff.Enums.TiffExpectedFormat.Default));
}

L’esempio seguente mostra come convertire un’immagine vettoriale multipagina in formato TIFF in modo generale senza fare riferimento a un particolare tipo di immagine.

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

    // Esporta solo le prime due pagine. Queste pagine verranno presentate come frame nel TIFF di output.
    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);
}

Questi esempi utilizzano la classe GraphicsPath e Graphics per creare e manipolare figure su un’area Image. Esempio crea una nuova immagine (di tipo Tiff), cancella la superficie e disegna percorsi con l’aiuto della classe GraphicsPath. Alla fine viene chiamato il metodo DrawPath esposto dalla classe Graphics per eseguire il rendering dei tracciati sulla superficie.

[C#]

//Crea un'istanza di FileStream
using (System.IO.FileStream stream = new System.IO.FileStream(@"C:\temp\output.tiff", System.IO.FileMode.Create))
{
    //Crea un'istanza di TiffOptions e imposta le sue varie proprietà
    Aspose.Imaging.ImageOptions.TiffOptions tiffOptions = new Aspose.Imaging.ImageOptions.TiffOptions(Imaging.FileFormats.Tiff.Enums.TiffExpectedFormat.Default);

    //Imposta l'origine per l'istanza di ImageOptions
    tiffOptions.Source = new Aspose.Imaging.Sources.StreamSource(stream);

    //Crea un'istanza di Image 
    using (Aspose.Imaging.Image image = Aspose.Imaging.Image.Create(tiffOptions, 500, 500))
    {
        //Crea e inizializza un'istanza della classe Graphics
        Aspose.Imaging.Graphics graphics = new Aspose.Imaging.Graphics(image);

        //Cancella superficie grafica
        graphics.Clear(Color.Wheat);

        //Crea un'istanza della classe GraphicsPath
        Aspose.Imaging.GraphicsPath graphicspath = new Aspose.Imaging.GraphicsPath();

        //Crea un'istanza della classe Figure
        Aspose.Imaging.Figure figure = new Aspose.Imaging.Figure();

        //Aggiungi forme all'oggetto Figura
        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));

        //Aggiungi l'oggetto Figure a GraphicsPath
        graphicspath.AddFigure(figure);

        //Disegna il percorso con l'oggetto Penna di colore Nero
        graphics.DrawPath(new Aspose.Imaging.Pen(Aspose.Imaging.Color.Black, 2), graphicspath);

        // salva tutte le modifiche.
        image.Save();
    }
}

Guarda anche

TgaOptions TiffOptionsError