Introduction à Inrimage INRIA

Introduction à l'utilisation Introduction à la programmation
Liste des commandes Liste des programmes
Manuels des commandes Manuels des programmes
Documentation complémentaire
Page officielle d'Inrimage

Ce document est encore très incomplet.

Vous y trouverez des informations sur Inrimage, en particulier :

Introduction

Inrimage fournit un ensemble d'outils de base pour le traitement d'images, d'une part sous formes de bibliothèques de programmes, d'autre part sous forme de commandes Unix.
Ce logiciel utilise un format spécifique de fichiers, mais accepte, en lecture, dans la majorité des cas d'autres formats tels que GIF, JPEG, etc (il suffit de disposer de la bonne commande de conversion). On trouvera des informations détaillées sur le format Inrimage et sur l'accès aux autres formats dans Inrimage(1i)

Les commandes fournies correspondent, dans la majorité des cas à des algorithmes simples, mais bien utiles : opérations arithmétiques et logiques, transformations diverses, conversions de formats, etc. Pour plus de détails, se reporter à la liste des commandes.
La plupart des commandes Inrimage peuvent être utilisées en filtre, et donc assemblées par des pipes pour effectuer des opérations complexes.

Les bibliothèques proposées sont de 2 types :

L'historique des principales nouveautés

Distribution 4.6.9 (décembre 2020)
Distribution 4.6.8 (décembre 2017)
Distribution 4.6.7 (mai 2016)
Distribution 4.6.6 (février 2015)
Distribution 4.6.5 (mars 2012)
Distribution 4.6.4 (juin 2010)

Distribution 4.6.3 (avril 2009)

Distribution 4.6.2 (mars 2008)

Distribution 4.6.1 (avril 2007)

Distribution 4.6.0 (janvier 2007)

Distributions 4.5-10, 4.5-9, 4.5-8

Distribution 4.5-4 (janvier 1999)

Distribution 4.5-3

Distribution 4.5-2 (30 avril 1998)

1997
1996
1995

Juin-Novembre 1994
Janvier-Juin 1994

L'historique des principales corrections

Distribution 4.6.9 (décembre 2020)
Distribution 4.6.8 (décembre 2017)
Distribution 4.6.7 (mai 2016)
Distribution 4.6.6 (février 2015)
Distribution 4.6.5 (mars 2012)
Distribution 4.6.4 (juin 2010)

Distribution 4.6.3 (avril 2009)
Distribution 4.6.2 (mars 2008)

Distribution 4.6.1 (mars 2007)

Distribution 4.6.0 (janvier 2007)

1999
1997
1995/1996
1994

Quelques exemples d'utilisation

Utilisation pour des "imagemap" html..

Par exemple

Images composées.

Juste une page d'exemples (contient environ 150k d'images gif).

Fabrication d'animations mpeg.

Il existe une commande Inrimage, inr2ppm permettant de transformer une image Inrimage (ou gif, etc.) en image PPM, format utilisé par mpeg_encode.
Cependant, pour fabriquer une séquence MPEG à partir d'images, on pourra utiliser la commande inr2mpg (script perl), qui permet de fabriquer plus simplement le fichier de paramètres de mpeg_encode.

Ci-dessous le help de la commande. Voir aussi des exemples détaillés. 

Usage: inr2mpg [-C] [-e][-s] [-f out-name][-d dir][-rep facteur][-pipe "commande"] file [ ... file]
        -C : images couleurs si NDIMV==3 ou NDIMZ== 3
        -e : executer mpeg_encode
        -s : short format: supp comments in file .param
        -f: choix des noms pour .param et .mpg (defaut mpeg)
        -d: choix de INPUT_DIR (defaut '.')
        -rep: facteur de repetition de chaque plan
        -pipe: appliquer la commande "commande" a l'image avant conversion

   Si file est de la forme 'xx*yy [i1-i2]' on fabrique un fichier classique
   Sinon on suppose qu'il s'agit d'un fichier multiplans, dont chaque
   plan représente une image de l'animation
Exemples:
         inr2mpg image -C -e 
         inr2mpg 'im1-*.gif [001-010]' 'im2.* [1-8]' -s 
         inr2mpg image -s -pipe 'ext -iz \$iz -z 1 -x 256 -y 256 | izoom -sc .5'

Quelques informations sur les programmes

Comment retrouver les sources d'un programme ?

Les sources sont dans le répertoire nommé src/. Ce répertoire contient :
h/
les fichiers .h, le plus important est image.h
bin-src/
pour la fabrication des commandes Inrimage.
scripts/
source pour les commandes définies sous forme de scripts.
inrimage/
source de libinrimage.a, les fonctions de base.
imaglb7/
sources de libimaglb7.a, programmes de traitement d'images.
mthlib7/
sources de libmthlib7.a, quelques fonctions de calcul, utilisées essentiellement pour la FFT.
contlib7/
sources de libcontlib.a, programmes de contours.
enstsorl7/
sources de libentsorl7.a, programmes d'E/S (graphiques).
inrgraph/
sources de libinrgraph.a, quelques fonctions graphiques (tektro, PostScript).
extra-conv/
sources de quelques programmes de conversion vers d'autres formats d'image (gif, tiff)
xvis/
sources de xvis, commande de visualisation d'images
libxvis/
sources de libxvis.a, fonctions pour le graphique xvis
gvis/
sources de gvis et libgvis.a.

Pour retrouver les fonctions utilisées par une commande :

  1. Trouver les fichiers de bin-src/ utilisés par la commande en consultant Makefile.am/ On trouvera probablement un fichier k*.c/ et un fichier s*.c/ ou s*.f/. En général ces fichiers n'effectuent que les initialisations de paramètres et l'ouverture des images.
  2. À l'aide de la liste de librairies utilisées, trouver dans quel répertoire se trouve la fonction de calcul (il y en a souvent une seule, appelée par l'intermédiaire de exec ou imexec
Seules les fonctions de base, c'est-à-dire celles de libinrimage.a sont documentées. Pour les autres il faut se reporter au code source. Pour appeler une fonction Fortran dans un programme C, on se reportera au paragraphe PROGRAMMATION du manuel Intro(3i)