pnmcut - extrait un rectangle d’un PNM (Portable aNyMap)

pnmcut [-left leftcol] [-right rightcol] [-top toprow] [-bottom bottomrow] [-width width] [-height height] [-pad] [-verbose] [ gauche haut largeur hauteur ] [fichier_pnm]

Toutes les options peuvent être réduites au minimum, tant qu’il n’y a pas d’ambiguïté.

pnmcut lit un PNM (Portable aNyMap) en entrée, extrait le rectangle spécifié, puis génère en sortie une image d’un même type.

Il existe deux façons de spécifier le rectangle à extraire : les arguments ou les options. Les options sont plus faciles à mémoriser et à lire, plus expressives, et vous permettent d’utiliser les valeurs par défaut. Les arguments étaient la seule méthode possible en juillet 2000.

Si vous utilisez les options et les arguments en même temps, le résultat est incertain.

Les options sont : -left, -right, -top, -bottom, -width, et -height. Les valeurs par défaut seront utilisées si vous ne spécifiez pas d’option. Trop d’options peuvent aussi conduire à une erreur, par exemple, spécifier les trois valeurs -left, -right, et -width ou -top, -bottom, et -height.

Les arguments valides sont : gauche, top, largeur, et hauteur. gauche et top ont le même effet que les valeurs des options -left et -top respectivement. width et height ont le même effet que les valeurs des options -width et -height respectivement, quand ils sont positifs. Quand ils ne sont pas positifs, ils ont le même effet que -right et -bottom respectivement. (Par exemple largeur = 0 extrait uniquement le coin droit). Avant juillet 2000, les nombres négatifs n’étaient pas permis pour largeur et largeur.

L’entrée standard est utilisée si vous ne spécifiez pas fichier_pnm.

La sortie est la sortie standard.

-left

Le numéro de la colonne la plus à gauche de l’image extraite. Si le nombre n’est pas négatif, il se réfère à la colonne numérotée 0 à gauche et augmente en allant vers la droite. Sinon, il se réfère aux colonnes numérotées -1 à droite, et baisse en allant vers la gauche.

-right

Le numéro de la colonne la plus à droite de l’image extraite, numérotée de la même façon que pour -left.

-top

Le numéro de la ligne de la plus haute ligne de l’image extraite. Si le nombre n’est pas négatif, il se réfère aux lignes numérotées de 0 en haut, et augmente en allant vers le bas. Sinon, il se réfère aux lignes numérotées -1 en bas, et baisse en allant vers le haut.

-bottom

Le numéro de la ligne de la plus basse ligne de l’image extraite, numérotée de la même façon que pour -top.

-width

Le nombre de colonnes de l’image qui sera extraite. Doit être positif.

-height

Le nombre de lignes de l’image qui sera extraite. Doit être positif.

-pad

Si le rectangle que vous spécifiez ne tient pas entièrement dans l’image d’entrée, pnmcut génère une erreur sauf si vous spécifiez -pad. Dans ce cas, il ajoute des bordures noires à l’image de sortie. vous pouvez utiliser cette option si vous avez besoin d’une image d’un dimension donnée.

pnmpad peut aussi remplir une image pour correspondre à la taille demandée, et vous donne plus d’options pour le faire.

-verbose

Affiche des informations concernant l’exécution du programme sur stderr.

pnmcrop(1), pnmpad(1), pnmcat(1), pgmslice(1), pnm(5)

Copyright (C) 1989 by Jef Poskanzer.

Traduit par François Wendling <frwendling@free.fr>, le 02 novembre 2005.