TiffOptions

TiffOptions class

Les options de format de fichier tiff. Notez que les balises de largeur et de hauteur seront écrasées lors de la création de l’image par les paramètres de largeur et de hauteur, il n’est donc pas nécessaire de les spécifier directement. Notez que de nombreuses options renvoient une valeur par défaut, mais cela ne signifie pas que cette option est définie explicitement en tant que valeur de balise. Pour vérifier que la balise est présente, utilisez la propriété Tags ou la méthode IsTagPresent correspondante.

public class TiffOptions : ImageOptionsBase

Constructeurs

NomLa description
TiffOptions(TiffDataType[])Initialise une nouvelle instance duTiffOptions classe.
TiffOptions(TiffExpectedFormat)Initialise une nouvelle instance duTiffOptionsclasser. Par défaut, la convention Little Endian est utilisée.
TiffOptions(TiffOptions)Initialise une nouvelle instance duTiffOptions classe.
TiffOptions(TiffExpectedFormat, TiffByteOrder)Initialise une nouvelle instance duTiffOptions classe.

Propriétés

NomLa description
AlphaStorage { get; set; }Obtient ou définit l’option de stockage alpha. Options autres queUnspecified sont utilisés lorsqu’il y a plus de 3SamplesPerPixel défini.
Artist { get; set; }Obtient ou définit l’artiste.
BitsPerPixel { get; }Obtient les bits par pixel.
BitsPerSample { get; set; }Obtient ou définit les bits par échantillon.
BufferSizeHint { get; set; }Obtient ou définit l’indice de taille de tampon qui est défini comme la taille maximale autorisée pour tous les tampons internes.
ByteOrder { get; set; }Obtient ou définit une valeur indiquant l’ordre des octets tiff.
ColorMap { get; set; }Obtient ou définit la palette de couleurs.
CompressedQuality { get; set; }Obtient ou définit la qualité de l’image compressée. Utilisé avec la compression Jpeg.
Compression { get; set; }Obtient ou définit la compression.
Copyright { get; set; }Obtient ou définit le copyright.
DateTime { get; set; }Obtient ou définit la date et l’heure.
DisableIccExport { get; set; }Obtient ou définit une valeur indiquant si l’exportation du profil ICC est désactivée (le profil ICC est appliqué au préalable aux pixels source).
Disposed { get; }Obtient une valeur indiquant si cette instance est supprimée.
DocumentName { get; set; }Obtient ou définit le nom du document.
ExifIfd { get; }Obtient ou définit le pointeur sur EXIF IFD.
ExtraSamples { get; }Obtient les valeurs d’échantillons supplémentaires.
FaxT4Options { get; set; }Obtient ou définit les options de télécopie t4.
FileStandard { get; set; }Obtient ou définit la norme de fichier TIFF.
FillOrder { get; set; }Obtient ou définit l’ordre de remplissage des bits d’octet.
FullFrame { get; set; }Obtient ou définit une valeur indiquant si [plein cadre].
HalfToneHints { get; set; }Obtient ou définit les indices de demi-teintes.
IccProfile { get; set; }Obtient ou définit le flux de profil Icc.
ImageDescription { get; set; }Obtient ou définit la description de l’image.
ImageLength { get; set; }Obtient ou définit la longueur de l’image.
ImageWidth { get; set; }Obtient ou définit la largeur de l’image.
InkNames { get; set; }Obtient ou définit les noms d’encre.
IsExtraSamplesPresent { get; }Obtient une valeur indiquant si les échantillons supplémentaires sont présents.
IsTiled { get; }Obtient une valeur indiquant si l’image est en mosaïque.
IsValid { get; }Obtient une valeur indiquant si leTiffOptions ont été correctement configurés. Utilisez la méthode Validate as pour trouver la raison de l’échec.
MaxSampleValue { get; set; }Obtient ou définit la valeur maximale de l’échantillon.
MinSampleValue { get; set; }Obtient ou définit la valeur minimale de l’échantillon.
MultiPageOptions { get; set; }Les options multipages
Orientation { get; set; }Obtient ou définit l’orientation.
PageName { get; set; }Obtient ou définit le nom de la page.
PageNumber { get; set; }Obtient ou définit la balise de numéro de page.
override Palette { get; set; }Obtient ou définit la palette de couleurs.
Photometric { get; set; }Obtient ou définit la photométrie.
PlanarConfiguration { get; set; }Obtient ou définit la configuration planaire.
Predictor { get; set; }Obtient ou définit le prédicteur pour la compression LZW.
PremultiplyComponents { get; set; }Obtient ou définit une valeur indiquant si les composants doivent être prémultipliés.
ProgressEventHandler { get; set; }Obtient ou définit le gestionnaire d’événements de progression.
override ResolutionSettings { get; set; }Obtient ou définit les paramètres de résolution.
ResolutionUnit { get; set; }Obtient ou définit l’unité de résolution.
RowsPerStrip { get; set; }Obtient ou définit les lignes par bande.
SampleFormat { get; set; }Obtient ou définit le format de l’échantillon.
SamplesPerPixel { get; }Obtient les échantillons par pixel. Pour modifier cette valeur de propriété, utilisez leBitsPerSample propriété setter.
ScannerManufacturer { get; set; }Obtient ou définit le fabricant du scanner.
ScannerModel { get; set; }Obtient ou définit le modèle du scanner.
SmaxSampleValue { get; set; }Obtient ou définit la valeur maximale de l’échantillon. La valeur a un type de champ qui correspond le mieux aux exemples de données (type Byte, Short ou Long).
SminSampleValue { get; set; }Obtient ou définit la valeur minimale de l’échantillon. La valeur a un type de champ qui correspond le mieux aux exemples de données (type Byte, Short ou Long).
SoftwareType { get; set; }Obtient ou définit le type de logiciel.
Source { get; set; }Obtient ou définit la source dans laquelle créer l’image.
StripByteCounts { get; set; }Obtient ou définit le nombre d’octets de bande.
StripOffsets { get; set; }Obtient ou définit les décalages de bande.
SubFileType { get; set; }Obtient ou définit une indication générale du type de données contenues dans ce sous-fichier.
Tags { get; set; }Obtient ou définit les balises.
TargetPrinter { get; set; }Obtient ou définit l’imprimante cible.
Threshholding { get; set; }Obtient ou définit le seuil.
TileByteCounts { get; set; }Obtient ou définit le nombre d’octets de mosaïque.
TileLength { get; set; }Obtient ou définit la longueur des tuiles.
TileOffsets { get; set; }Obtient ou définit les décalages de mosaïque.
TileWidth { get; set; }Obtient ou définit la largeur des tuiles.
TotalPages { get; }Obtient le nombre total de pages.
ValidTagCount { get; }Obtient le nombre de balises valides. Il ne s’agit pas du nombre total de balises mais du nombre de balises pouvant être conservées.
VectorRasterizationOptions { get; set; }Obtient ou définit les options de pixellisation vectorielle.
override XmpData { get; set; }Obtient ou définit le conteneur de métadonnées XMP.
XPAuthor { get; set; }Obtient ou définit l’auteur de l’image, qui est utilisé par l’Explorateur Windows.
XPComment { get; set; }Obtient ou définit un commentaire sur l’image, qui est utilisé par l’Explorateur Windows.
XPKeywords { get; set; }Obtient ou définit l’image du sujet, qui est utilisée par l’Explorateur Windows.
Xposition { get; set; }Obtient ou définit la position x.
XPSubject { get; set; }Obtient ou définit des informations sur l’image, utilisées par l’Explorateur Windows.
XPTitle { get; set; }Obtient ou définit des informations sur l’image, utilisées par l’Explorateur Windows.
Xresolution { get; set; }Obtient ou définit la résolution x.
YCbCrCoefficients { get; set; }Obtient ou définit les YCbCrCoefficients.
YCbCrSubsampling { get; set; }Obtient ou définit les facteurs de sous-échantillonnage pour la photométrie YCbCr.
Yposition { get; set; }Obtient ou définit la position y.
Yresolution { get; set; }Obtient ou définit la résolution y.

Méthodes

NomLa description
AddTag(TiffDataType)Ajoute une nouvelle balise.
AddTags(TiffDataType[])Ajoute les balises.
virtual Clone()Clone cette instance.
Dispose()Supprime l’instance actuelle.
GetTagByType(TiffTags)Obtient l’instance de la balise par type.
IsTagPresent(TiffTags)Détermine si le tag est présent ou non dans les options.
RemoveTag(TiffTags)Supprime la balise.
Validate()Valide si les options ont une combinaison valide de balises
static GetValidTagsCount(TiffDataType[])Obtient le nombre de balises valides.

Exemples

Cet exemple illustre l’utilisation de différentes classes de l’espace de noms SaveOptions à des fins d’exportation. Une image de type Gif est chargée dans une instance de Image puis exportée vers plusieurs formats.

[C#]

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

//Charge une image existante (de type Gif) dans une instance de la classe Image
using (Aspose.Imaging.Image image = Aspose.Imaging.Image.Load(dir + "sample.gif"))
{
    // Exporter au format de fichier BMP en utilisant les options par défaut
    image.Save(dir + "output.bmp", new Aspose.Imaging.ImageOptions.BmpOptions());

    // Exporter au format de fichier JPEG en utilisant les options par défaut
    image.Save(dir + "output.jpg", new Aspose.Imaging.ImageOptions.JpegOptions());

    // Exporter au format de fichier PNG en utilisant les options par défaut
    image.Save(dir + "output.png", new Aspose.Imaging.ImageOptions.PngOptions());

    // Exporter au format de fichier TIFF en utilisant les options par défaut
    image.Save(dir + "output.tif", new Aspose.Imaging.ImageOptions.TiffOptions(Aspose.Imaging.FileFormats.Tiff.Enums.TiffExpectedFormat.Default));
}

L’exemple suivant montre comment convertir une image vectorielle multipage au format TIFF de manière générale sans faire référence à un type d’image particulier.

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

    // Exporte uniquement les deux premières pages. Ces pages seront présentées sous forme de cadres dans le fichier TIFF de sortie.
    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);
}

Ces exemples utilisent GraphicsPath et la classe Graphics pour créer et manipuler des figures sur une surface Image. L’exemple crée une nouvelle image (de type Tiff), efface la surface et dessine des chemins à l’aide de la classe GraphicsPath. À la fin, la méthode DrawPath exposée par la classe Graphics est appelée pour restituer les chemins sur la surface.

[C#]

//Créer une instance de FileStream
using (System.IO.FileStream stream = new System.IO.FileStream(@"C:\temp\output.tiff", System.IO.FileMode.Create))
{
    //Créer une instance de TiffOptions et définir ses différentes propriétés
    Aspose.Imaging.ImageOptions.TiffOptions tiffOptions = new Aspose.Imaging.ImageOptions.TiffOptions(Imaging.FileFormats.Tiff.Enums.TiffExpectedFormat.Default);

    //Définir la source de l'instance de ImageOptions
    tiffOptions.Source = new Aspose.Imaging.Sources.StreamSource(stream);

    //Créer une instance de Image 
    using (Aspose.Imaging.Image image = Aspose.Imaging.Image.Create(tiffOptions, 500, 500))
    {
        //Créer et initialiser une instance de la classe Graphics
        Aspose.Imaging.Graphics graphics = new Aspose.Imaging.Graphics(image);

        //Effacer la surface graphique
        graphics.Clear(Color.Wheat);

        //Créer une instance de la classe GraphicsPath
        Aspose.Imaging.GraphicsPath graphicspath = new Aspose.Imaging.GraphicsPath();

        //Créer une instance de la classe Figure
        Aspose.Imaging.Figure figure = new Aspose.Imaging.Figure();

        //Ajouter des formes à l'objet 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));

        //Ajouter un objet Figure à GraphicsPath
        graphicspath.AddFigure(figure);

        // Dessine un chemin avec un objet Pen de couleur noire
        graphics.DrawPath(new Aspose.Imaging.Pen(Aspose.Imaging.Color.Black, 2), graphicspath);

        // Enregistrer toutes les modifications.
        image.Save();
    }
}

Voir également