RDFMG (3I)     version 4.6.9     March 2022

User Intro    Prog Intro    Liste des programmes    Liste des manuels
Table of Contents


NAME

rdfmg, optfmg - lecture d'un format d'image

SYNOPSIS

subroutine rdfmg(lfmt,iopt)
integer lfmt(18),iopt

integer function optfmt(lfmt,iopt)
integer lfmt(9), iopt

#include <inrimage/image.h>

rdfmg_(gfmt,iopt)
struct nf_fmt *gfmt; Fort_int *iopt;

c_rdfmg(gfmt,iopt)
struct nf_fmt *gfmt; Fort_int iopt;

Fort_int optfmt_(gfmt,iopt)
struct nf_fmt *gfmt; Fort_int *iopt;

Fort_int c_optfmt(gfmt,iopt)
struct nf_fmt *gftm; Fort_int iopt;

DESCRIPTION

optfmt (optfmt_,c_optfmt) lit dans les arguments de lancement tout ou partie d'un format d'image et le range dans lfmt ou gfmt.
rdfmg (rdfmg_,c_rdfmg) réalise le même travail que optfmt mais demande interactivement les options manquantes dans les argmuents de lancement.
Le paramètre iopt est le ou logique de diverses valeurs qui correspondent à 1 bit et indiquent la partie du format à renvoyer :
1 type et taille du codage
2 dimensions
4 maille et origines en X, Y, Z
8 biais et facteur d'échelle.

Si iopt est inférieur ou égal à 3, le premier argument de la fonction peut être de type "Fort_int lfmt[9]" (seule la partie lfmt de gfmt sera affectée).
optfmt retourne une valeur positive s'il a trouvé au moins un des paramètres demandés, 0 sinon. Les parties du format non définies par les options de la commande exécutée sont initialisées à des valeurs par défaut.
Le paramètre iopt a la même signification que pour optfmt.
La syntaxe des options de format dans les arguments de lancement est

-x nn : nombre de pixels par ligne.
-y nn : nombre de lignes.
-z nn : nombre de plans.
-v nn : nombre de composantes du pixel.
-r : codage réel.
-f : codage en virgule fixe non packée.
-p : codage en virgule fixe packée.
-s : image signee.
-o nn : nombre d'octets pour le codage d'un pixel.
-b nn : nombre de bits pour le codage d'un pixel.
-e nn : exposant entre -100 et +100.
-x0 nn : décalage en X du premier pixel de l'image.
-y0 nn : décalage en Y.
-z0 nn : décalage en Z.
-m=maille : type de maillage h pour maille hexagonale, r pour maille rectangulaire.
-imbi nn : biais (en flottant), c'est-à-dire constante à rajouter à chaque pixel (ne concerne que les images en virgule fixe).
-imsc nn : facteur d'échelle (en flottant), c'est-à-dire constante par laquelle il faut multiplier chaque pixel (ne concerne que les images en virgule fixe). Si ce paramètre est non nul, l'exposant (option -e) est forcément 1. L'exposant est considéré comme un cas particulier du facteur d'échelle.

Ces différentes options subissent une vérification de cohérence et ont des valeurs par défaut qui sont :

1 pour les dimensions x,y,z,v, x0,y0,z0.
f pour le type.
non signée.
1 pour o si le type est f, 4 si le type est r.
1 pour b si le type est p.
0 pour l'exposant.
r pour la maille
0. pour bi
1. pour sc

optfmt consulte les arguments de la commande par l'intermédiaire de igetopt.

En mode KHOROS, les options mutuellement exclusives -p, -f, -r sont lues en argument de -codtyp (par exemple -codtyp -r). D'autre part, si le format ne peut être défini à partir des options, rdfmg_ produit une erreur fatale au lieu de demander interactivement les valeurs.

"SEE ALSO"

Intro(3i) , igetopt(3i) , prtnf(3i)

DIAGNOSTICS

optfmg appelle imerror en cas d'incohérences dans le format.