diff options
| -rw-r--r-- | fbi.c | 37 | ||||
| -rw-r--r-- | fbi.man | 179 | ||||
| -rw-r--r-- | fbi.man.fr | 298 |
3 files changed, 401 insertions, 113 deletions
@@ -162,7 +162,7 @@ version(void) { fprintf(stderr, "fbi version " VERSION ", compiled on %s\n" - "(c) 1999-2006 Gerd Hoffmann <kraxel@bytesex.org> [SUSE Labs]\n", + "(c) 1999-2012 Gerd Hoffmann <kraxel@bytesex.org> [SUSE Labs]\n", __DATE__ ); } @@ -176,8 +176,8 @@ usage(char *name) fprintf(stderr, "\n" "This program displays images using the Linux framebuffer device.\n" - "Supported formats: PhotoCD, jpeg, ppm, gif, tiff, xwd, bmp, png.\n" - "It tries to use ImageMagick's convert for unknown file formats.\n" + "Supported formats: PhotoCD, jpeg, ppm, gif, tiff, xwd, bmp, png,\n" + "webp. It tries to use ImageMagick's convert for unknown file formats.\n" "\n" "usage: %s [ options ] file1 file2 ... fileN\n" "\n", @@ -191,7 +191,7 @@ usage(char *name) "Large images can be scrolled using the cursor keys. Zoom in/out\n" "works with '+' and '-'. Use ESC or 'q' to quit. Space and PgDn\n" "show the next, PgUp shows the previous image. Jumping to a image\n" - "works with <number>g. Return acts like Space but additionally\n" + "works with <i>g. Return acts like Space but additionally prints\n" "prints the filename of the currently displayed image to stdout.\n" "\n"); } @@ -529,23 +529,26 @@ static void show_help(void) static wchar_t *help[] = { L"keyboard commands", L"~~~~~~~~~~~~~~~~~", - L" ESC, Q - quit", - L" pgdn, space - next image", - L" pgup - previous image", - L" +/- - zoom in/out", - L" A - autozoom image", - L" cursor keys - scroll image", + L" cursor keys - scroll image", + L" PgUp, k - previous image", + L" PgDn, SPACE, j - next image", + L" <i>g - jump to image #i", L"", - L" H - show this help text", - L" I - show EXIF info", - L" P - pause slideshow", - L" V - toggle statusline", + L" a - autozoom image", + L" +/- - zoom in/out", + L" <i>s - set zoom to <i>%", + L"", + L" ESC, q - quit", + L" v - toggle statusline", + L" h - show this help text", + L" i - show EXIF info", + L" p - pause slideshow", L"", L"available if started with --edit switch,", L"rotation works for jpeg images only:", - L" shift+D - delete image", - L" R - rotate clockwise", - L" L - rotate counter-clockwise", + L" D, Shift+d - delete image", + L" r - rotate clockwise", + L" l - rotate counter-clockwise", }; shadow_draw_text_box(face, 24, 16, transparency, @@ -10,17 +10,14 @@ fbi - Linux framebuffer imageviewer \# \# .SH DESCRIPTION -.BR fbi -displays the specified file(s) on the linux console using the -framebuffer device. -\fIPhotoCD\fP, \fIjpeg\fP, \fIppm\fP, \fIgif\fP, \fItiff\fP, \fIxwd\fP, -\fIbmp\fP, \fIpng\fP and \fIwebp\fP are supported directly. -For other formats +.BR Fbi +displays the specified file(s) on the linux console using the framebuffer +device. \fIPhotoCD\fP, \fIjpeg\fP, \fIppm\fP, \fIgif\fP, \fItiff\fP, \fIxwd\fP, +\fIbmp\fP, \fIpng\fP and \fIwebp\fP formats are supported natively. For other .BR fbi tries to use -.BR ImageMagick (1) -\'s -.BR convert (1). +.BR "ImageMagick" "(1)\'s" +.BR "convert" "(1)." \# \# .SH OPTIONS @@ -38,21 +35,18 @@ Write command line arguments to config file. Read image filelist from \fIfile\fP. .TP .B -P, --text -Enable textreading mode. -This has the effect that +Enable textreading mode. In this mode .BR fbi -will display large images without vertical offset (default is to center -the images). -Space will first try to scroll down and go to the next image only if it -is already on the bottom of the page. -Useful if the images you are watching text pages, all you have to do to -get the next piece of text is to press space... +will display large images without vertical offset (default is to center the +images). The \fBSPACE\fP command will first try to scroll down and go to the +next image only if it is already on the bottom of the page. Useful if the images +you are watching are text pages, all you have to do to get the next piece of +text is to press space... .TP .B -a, --autozoom Enable autozoom. .BR Fbi -will automagically pick a reasonable zoom factor when loading a new -image. +will automagically pick a reasonable zoom factor when loading a new image. .TP .B --(no)autoup Like autozoom, but scale up only. @@ -70,11 +64,11 @@ Be verbose: enable status line on the bottom of the screen. Randomize the order of the filenames. .TP .B --(no)comments -Display comment tags (if present) instead of the filename. -Probably only useful if you added reasonable comments yourself (using -.BR wrjpgcom (1) -for example), otherwise you likely just find texts pointing to the -software which created the image. +Display comment tags (if present) instead of the filename. Probably only useful +if you added reasonable comments yourself (using +.BR "wrjpgcom" "(1)" +for example), otherwise you likely just find texts pointing to the software +which created the image. .TP .B -e, --(no)edit Enable editing commands. @@ -94,8 +88,8 @@ Image cache \fIsize\fP in megabytes (MB). .BI "--blend" "\ time" Image blend \fItime\fP in miliseconds. .TP -.BI "-T" "\ <arg>" ", --vt" "\ <arg> -Start on virtual console \fI<arg>\fP. +.BI "-T" "\ n" ", --vt" "\ n" +Start on virtual console \fIn\fP. .TP .BI "-s" "\ steps" ", --scroll" "\ steps" Set scroll \fIsteps\fP in pixels (default is 50). @@ -114,24 +108,22 @@ Gamma correction. Default is 1.0. Requires \fIPseudocolor\fP or \fIDirectcolor\fP visual, doesn't work for \fITruecolor\fP. .TP .BI "-f" "\ <arg>" ", --font" "\ <arg>" -Set font. This can be anything fontconfig accepts (see -.BR fonts-conf (5) -). Try -.BR fc-list (1) -for a list of known fonts on your system. -The fontconfig config file is evaluated as well, so any generic stuff -defined there (such as mono, sans) will work as well. -It is recommended to use monospaced fonts, the textboxes (help text, -exif info) look better then. -.TP -.BI "-d" "\ fbdevice" ", --device" "\ fbdevice" -Use \fIfbdevice\fP framebuffer. -Default is the one your vc is mapped to. +Set font. This \fI<arg>\fP can be anything fontconfig accepts (see +.BR "fonts\-conf" "(5))." +Try +.BR "fc\-list" "(1)" +for a list of known fonts on your system. The fontconfig config file is +evaluated as well, so any generic stuff defined there (such as mono, sans) will +work as well. It is recommended to use monospaced fonts, the textboxes (help +text, exif info) look better then. +.TP +.BI "-d" "\ /dev/fbN" ", --device" "\ /dev/fbN" +Use \fI/dev/fbN\fP device framebuffer. Default is the one your virtual console +is mapped to. .TP .BI "-m" "\ videomode" ", --mode" "\ videomode" Name of the video mode to use (video mode must be listed in -\fI/etc/fb.modes\fP). -Default is not to change the video mode. +\fI/etc/fb.modes\fP). Default is not to change the video mode. \# \# .SH ENVIRONMENT @@ -143,8 +135,8 @@ This variable may be used to specify a default gamma correction. \# \# .SH "COMMAND USAGE" -The commands take effect immediately; it is not necessary to type a -carriage return. +The commands take effect immediately; it is not necessary to type a carriage +return. .PP In the following commands, \fIi\fP is a numerical argument. .SS Scrolling @@ -158,20 +150,16 @@ Previous image. \fBNEXT_SCREEN\fP, \fBSPACE\fP, \fBj\fP Next image. .TP -\fBRETURN\fP -Write the filename of the current image to -.BR stdout (3) -, then go to the next image. -.TP \fIi\fP\fBg\fP Jump to image #\fIi\fP. .TP -\fBp\fP -Pause the slideshow (if started with \fB-t\fP, toggle). +\fBRETURN\fP +Write the filename of the current image to +.BR "stdout" "(3)," +then go to the next image. .P -The \fBRETURN\fP vs. \fBSPACE\fP key thing can be used to create a file -list while reviewing the images and use the list for batch processing -later on: +The \fBRETURN\fP vs. \fBSPACE\fP key thing can be used to create a file list +while reviewing the images and use the list for batch processing later on: .P .in +4n \fIfbi\ file1.gif\ file2.jpg\ file3.jpg >\ fileimagelist.lst\fP @@ -185,6 +173,9 @@ some \fBRETURN\fP and \fBSPACE\fP... .in .SS Zoom .TP +\fBa\fP +Autozoom. +.TP \fB+\fP In. .TP @@ -205,15 +196,18 @@ Toggle status line. Display textbox with brief help. .TP \fBi\fP -Display textbox with some EXIF \fIEXIF\fP info. +Display textbox with some \fIEXIF\fP info. +.TP +\fBp\fP +Pause the slideshow (if started with \fB-t\fP, toggle). .SS Edit mode .BR Fbi -also provides some very basic image editing facilities. -You have to start +also provides some very basic image editing facilities. You have to +start .BR fbi with the \fI-e\fP switch to use them. .TP -\fBD\fP +\fBD\fP, \fBShift+d\fP Delete image. .TP \fBr\fP @@ -222,46 +216,35 @@ Rotate 90 degrees clockwise. \fBl\fP Rotate 90 degrees counter-clock wise. .P -The delete function actually wants a capital letter 'D', thus you have -to type \fBShift+d\fP. -This is done to avoid deleting images by mistake because there are no -safety bells: -If you ask fbi to delete the image, it will be deleted without questions -asked. +The delete function actually wants a capital letter \fBD\fP, thus you have to type +\fBShift+d\fP. This is done to avoid deleting images by mistake because there +are no safety bells: If you ask +.BR fbi +to delete the image, it will be deleted without questions asked. .P -The rotate function actually works for \fIJPEG\fP images only. -It does a lossless transformation of the image. +The rotate function actually works for \fIJPEG\fP images only. It does a +lossless transformation of the image. \# \# .SH BUGS .BR Fbi -needs rw access to the framebuffer devices (\fI/dev/fbN\fP), i.e you (our -your admin) have to make sure +needs rw access to the framebuffer devices (\fI/dev/fbN\fP), i.e you (our your +admin) have to make sure .BR fbi -can open the devices in rw mode. -The IMHO most elegant way is to use +can open the devices in rw mode. The IMHO most elegant way is to use .BR PAM (7) -to chown the devices to the user -logged in on the console. -Another way is to create some group, chown the special files to that -group and put the users which are allowed to use the framebuffer device -into the group. -You can also make the special files world writable, but be aware of the -security implications this has. -On a private box it might be fine to handle it this way though. +to chown the devices to the user logged in on the console. Another way is to +create some group, chown the special files to that group and put the users which +are allowed to use the framebuffer device into the group. You can also make the +special files world writable, but be aware of the security implications this +has. On a private box it might be fine to handle it this way though. .P .BR Fbi -also needs access to the linux console (\fI/dev/ttyN\fP) for sane -console switch handling. -That is obviously no problem for console logins, but any kind of a +also needs access to the linux console (\fI/dev/ttyN\fP) for sane console switch +handling. That is obviously no problem for console logins, but any kind of a pseudo tty (xterm, ssh, screen, ...) will \fBnot\fP work. \# \# -.SH AUTHOR -Gerd Knorr -.BR <kraxel@bytesex.org> -\# -\# .SH "SEE ALSO" .BR convert (1), .BR fbset (1), @@ -272,19 +255,23 @@ Gerd Knorr .BR PAM (7) \# \# +.SH AUTHOR +Gerd Knorr +.BR <kraxel@bytesex.org> +\# +\# .SH COPYRIGHT Copyright (c) 1999-2012 Gerd Knorr <kraxel@bytesex.org> .P -This program is free software; you can redistribute it and/or modify -it under the terms of the GNU General Public License as published by -the Free Software Foundation; either version 2 of the License, or -(at your option) any later version. +This program is free software; you can redistribute it and/or modify it under +the terms of the GNU General Public License as published by the Free Software +Foundation; either version 2 of the License, or (at your option) any later +version. .P -This program is distributed in the hope that it will be useful, -but WITHOUT ANY WARRANTY; without even the implied warranty of -MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -GNU General Public License for more details. +This program is distributed in the hope that it will be useful, but WITHOUT ANY +WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A +PARTICULAR PURPOSE. See the GNU General Public License for more details. .P -You should have received a copy of the GNU General Public License -along with this program; if not, write to the Free Software -Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. +You should have received a copy of the GNU General Public License along with +this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, +Cambridge, MA 02139, USA. diff --git a/fbi.man.fr b/fbi.man.fr new file mode 100644 index 0000000..2569b79 --- /dev/null +++ b/fbi.man.fr @@ -0,0 +1,298 @@ +\# Traduction de la version du commit 92744db63979c75138779e816a9290057fa92f11 +\# du manuel fbi.man +.TH FBI 1 "(c) 1999-2012 Gerd Knorr" "FBI 2.08" "Visionneuse d'image pour le framebuffer Linux" +\# +\# +.SH NOM +\# +\# +fbi - Visionneuse d'image pour le framebuffer Linux +.SH SYNOPSIS +\fBfbi\fP [\fIoptions\fP] \fIfichier …\fP +\# +\# +.SH DESCRIPTION +.BR Fbi +affiche les fichiers indiqués dans une console linux en utilisant le +framebuffer. Les formats \fIPhotoCD\fP, \fIjpeg\fP, \fIppm\fP, \fIgif\fP, +\fItiff\fP, \fIxwd\fP, \fIbmp\fP, \fIpng\fP and \fIwebp\fP sont pris en charge +nativement. Pour les autres, +.BR fbi +essaye d'utiliser l'utilitaire +.BR "convert" "(1)" +.BR "" "d'" "ImageMagick" "(1)." +\# +\# +.SH OPTIONS +.TP +.B -h, --help +Afficher le résumé des commandes +.TP +.B -V, --version +Afficher le numéro de version de \fBfbi\fP. +.TP +.B --store +Sauvegader les arguments de la ligne de commande dans le fichier de +configuration. +.TP +.BI "-l" "\ fichier" ", --list" "\ fichier" +Lit une liste de fichiers image depuis un \fIfichier\fP. +.TP +.B -P, --text +Activer le mode de rendu de texte. Dans ce mode +.BR fbi +affichera les images de grande taille sans marge vertical (par défaut l'image +est centrée). La commande \fBESPACE\fP essayera d'abord de faire défiler +l'écran vers le bas et ira à l'image suivante seulement s'il est déjà en +bas de la page. Très utile pour visualiser des images qui sont des pages de +texte, tout ce dont vous avez besoin pour lire la suite du texte est de presser +espace… +.TP +.B -a, --autozoom +Activer le zoom autommatique. +.BR Fbi +choisira automatiquement le facteur de zoom le plus adapté lors du argement +chd'une nouvelle image. +.TP +.B --(no)autoup +Comme autozoom, mais n'accepte que l'agrandissement. +.TP +.B --(no)autodown +Comme autozoom, mais n'accepte que la réduction. +.TP +.B --(no)fitwidth +Utiliser seulement la largeur pour la mise à l'échelle automatique. +.TP +.B -v, --(no)verbose +Être loquace : activer la barre d'état en bas de l'écran. +.TP +.B -u, --(no)random +Mélanger l'ordre des noms de fichier. +.TP +.B --(no)comments +Afficher les balises de commentaire (s'il en existe) au lieu du nom de fichier. +Probablement utile si vous avez ajouté des commentaires raisonnables par +vous-même (en utilisant +.BR "wrjpgcom" "(1)" +par exemple), autrement \fIa priori\fP vous verrez seulement les noms des +logiciels qui ont servi à créer l'image. +.TP +.B -e, --(no)edit +Activer les commandes d'édition. +.TP +.B --(no)backup +Créer une sauvegarde des fichiers (lors de la modification des images). +.TP +.B -p, --(no)preserve +Conserver l'horodatage (lors de la modification des images). +.TP +.B --(no)readahead +Mettre en cache les entêtes des images. +.TP +.BI "--cachemem" "\ taille" +\fITaille\fP du cache des images en mégaoctets (Mo) +.TP +.BI "--blend" "\ durée" +\fIDurée\fP de mélange des images en millisecondes. +.TP +.BI "-T" "\ n" ", --vt" "\ n" +Démarrer dans la console virtuelle \fIn\fP. +.TP +.BI "-s" "\ n" ", --scroll" "\ n" +Définir un pas de défilement de \fIn\fP pixels (50 par défaut). +.TP +.BI "-t" "\ n" ", --timeout" "\ n" +Charger l'image suivante après \fIn\fP secondes sans presser aucune +touche (c-à-d un diaporama). +.TP +.B -1, --(no)once +Ne pas boucler (utiliser seulement avec \fB-t\fP). +.TP +.BI "-r" "\ n" ", --resolution" "\ n" +Sélectionner la résolution, \fIn = 1..5\fP (seulement pour \fIPhotoCD\fP). +.TP +.BI "-g" "\ n" ", --gamma" "\ n" +Correction gamma. La valeur par défaut est 1.0. Nécessite un visuel en +\fIPseudocolor\fP ou \fIDirectcolor\fP, ne fonctionne pas en \fITruecolor\fP. +.TP +.BI "-f" "\ <arg>" ", --font" "\ <arg>" +Sélectionner une police. \fI<arg>\fP peut prendre n'importe quelle valeur +acceptée par fontconfig (voir +.BR "fonts\-conf" "(5))." +Essayez +.BR "fc\-list" "(1)" +pour obtenir une liste des polices connues du système. Le fichier de +configuration de fontconfig est évalué autant que possible, de sorte que +toutes les définitions génériques (tel que mono, sans) fonctionneront +parfaitement. Il est recommandé d'utiliser des polices à espacement fixe, les +zones de texte (aide, données exif) n'en seront que plus agréables à lire. +.TP +.BI "-d" "\ /dev/fbN" ", --device" "\ /dev/fbN" +Utiliser le framebuffer \fI/dev/fbN\fP. Par défaut, celui sur lequel la console +virtuelle est attachée. +.TP +.BI "-m" "\ videomode" ", --mode" "\ videomode" +Nom du mode vidéo à utiliser (le mode vidéo doit être présent dans +\fI/etc/fb.modes\fP). Par défaut le mode vidéo reste inchangé. +\# +\# +.SH ENVIRONMENT +.BR Fbi +utilise les variables d'environnement suivantes : +.TP +.BR FBGAMMA +Cette variable peut être utilisée pour définir une correction gamma par +défaut. +\# +\# +.SH "USAGE DES COMMANDES" +Les commandes prennent effet immédiatement ; il n'est pas nécessaire de taper +entrée. +.PP +Pour les commandes suivantes, \fIi\fP est un argument numérique. +.SS Défilement +.TP +\fBFLÈCHE_GAUCHE\fP, \fBFLÈCHE_DROITE\fP, \fBFLÈCHE_HAUT\fP, \fBFLÈCHE_BAS\fP +Faire défiler les grandes images. +.TP +\fBÉCRAN_PRÉCÉDENT\fP, \fBk\fP +Image précédente. +.TP +\fBÉCRAN_SUIVANT\fP, \fBSPACE\fP, \fBj\fP +Image suivante. +.TP +\fIi\fP\fBg\fP +Atteindre l'image n°\fIi\fP. +.TP +\fBENTRÉE\fP +Écrire le nom du fichier de l'image courante vers +.BR "stdout" "(3)," +puis aller à l'image suivante. +.P +Les touches \fBENTRÉE\fP et \fBESPACE\fP peuvent être utilisées pour créer +une liste de fichiers pendant la visualisation des images et utiliser plus tard +cette liste pour un traitement par lot : +.P +.in +4n +\fIfbi\ fichier1.gif\ fichier2.jpg\ fichier3.jpg >\ listefichierimage.lst\fP +.in +.P +.in +4n +quelques \fBENTRÉE\fP et \fBESPACE\fP… +.P +.in +4n +\fIfbi\ -l\ listefichierimage.lst\fP +.in +.SS Zoom +.TP +\fBa\fP +Zoom autommatique. +.TP +\fB+\fP +Avant. +.TP +\fB-\fP +Arrière. +.TP +\fIi\fP\fBs\fP +Positionner le facteur de zoom à \fIi\fP%. +.SS Autres +.TP +\fBESQ\fP, \fBq\fP +Quitter. +.TP +\fBv\fP +Basculer l'affichage de la barre d'état. +.TP +\fBh\fP +Afficher une zone de texte contenant un bref message d'aide. +.TP +\fBi\fP +Afficher une zone de texte avec quelques informations \fIEXIF\fP. +.TP +\fBp\fP +Mettre en pause le diaporama (si démarré avec \fB-t\fP, basculer). +.SS Mode Édition +.BR Fbi +offre aussi quelques fonctionnalités très basiques de modification d'image. +Vous devez lancer +.BR fbi +avec l'option \fI-e\fP pour pouvoir les utiliser. +.TP +\fBD\fP, \fBShift+d\fP +Supprimer l'image. +.TP +\fBr\fP +Rotation de 90 degrés dans le sens des aiguilles d'une montre. +.TP +\fBl\fP +Rotation de 90 degrés dans le sens contraire des aiguilles d'une montre. +.P +La fonction de suppression actuelle nécessite une lettre \fBD\fP en capitale, ainsi +vous devez taper \fBShift+d\fP. Ceci évite de supprimer des images par erreur +en l'absence d'un système d'alerte correcte : Si vous demander à +.BR fbi +de supprimer une image, il la supprimera sans confirmation. +.P +La fonction de rotation actuelle marche pour les images \fIJPEG\fP uniquement. +Elle effectue une transformation sans perte de données de l'image. +\# +\# +.SH BOGUES +.BR Fbi +nécessite un accès en lecture/écriture aux framebuffers (\fI/dev/fbN\fP), +c-à-d que vous devez vous assurer que +.BR fbi +peut ouvrir les périphériques en mode lecture/écriture. À mon humble avis, +la manière la plus élégante consiste à utiliser +.BR PAM (7) +pour affecter la propriété des périphériques à l'utilisateur connecté sur +la console. Une alternative est de créer un groupe, affecter la propriété +des fichiers spéciaux de ce groupe et ajouter les utilisateurs autorisés +à utiliser le framebuffer dans ce groupe. Vous pouvez également rendre +les fichiers spéciaux accessibles en écriture au monde entier, mais soyez +conscient des implications pour la sécurité. Toutefois, sur un ordinateur +personnel, c'est peut-être la meilleure solution. +.P +.BR Fbi +doit également pouvoir accéder à la console linux (\fI/dev/ttyN\fP) pour +manipuler correctement les commutateurs de console. Ce n'est évidemment pas un +problème pour les consoles de connexion, mais il \fBne\fP fonctionnera avec +aucun des pseudo-terminaux (xterm, ssh, screen, …). +\# +\# +.SH "VOIR AUSSI" +.BR convert (1), +.BR fbset (1), +.BR fc-list (1), +.BR imagemagick (1), +.BR wrjpgcom (1), +.BR fonts-conf (5), +.BR PAM (7) +\# +\# +.SH TRADUCTEUR +Stéphane Aulery +.BR <lkppo@free.fr> +\# +\# +.SH AUTEUR +Gerd Knorr +.BR <kraxel@bytesex.org> +\# +\# +.SH COPYRIGHT +Copyright (c) 1999-2012 Gerd Knorr <kraxel@bytesex.org> +.P +This program is free software; you can redistribute it and/or modify it under +the terms of the GNU General Public License as published by the Free Software +Foundation; either version 2 of the License, or (at your option) any later +version. +.P +This program is distributed in the hope that it will be useful, but WITHOUT ANY +WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A +PARTICULAR PURPOSE. See the GNU General Public License for more details. +.P +You should have received a copy of the GNU General Public License along with +this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, +Cambridge, MA 02139, USA. |