www.stereoscopie.fr

Galerie d'images stéréoscopiques

piphoto3D

Une visionneuse simple et multiplateforme pour les photos 3D.

Afficher vos photos 3D depuis votre Raspberry Pi ou autre ordinateur dans différents modes 3D

Les images 3D en entrée doivent être dans le format côte-à-côte, pleine largeur.
L'application est multiplateforme et fonctionne avec Windows, Linux, Raspberry Pi,...
C'est une application en ligne de commande avec des paramètres simples à utiliser.
Les images 3D peuvent être affichées en mode parallèle, croisé, demi format pour TV3D, anaglyphe, entrelacé et aussi en 2D.
Le mode 3D peut être changé en cours d'utilisation et la fenêtre stéréoscopique peut être ajustée.
Des diaporamas simples peuvent être réaliser avec un fichier d'index qui spécifie l'ordre des images et un commentaire pour chage image.

: piphoto3D fonctionne sur tout ordinateur disposant d'un environnement d'exécution Java récent.

Installation : Télécharger le fichier "jar" ci-dessous et copiez-le dans le dossier de votre choix. L'application nécessite un environnement Java 6 ou supérieur pour fonctionner.

Cliquer ici pour télécharger piphoto3D v1.5.5 (146 Ko)

Fichier d'aide : piphoto3D_usage_fr.txt

Modes 3D supportés

   - Côte à côte : les images gauche et droite du couple stéréoscopique sont placées l'une à côté de l'autre.
   - Côte à côte ½ largeur : les images gauche et droite du couple stéréoscopique sont placées l'une à côté de l'autre mais sont comprimées horizontalement de moitié. Ce mode est compatible avec les téléviseurs 3D HDMI 1.4.
   - Dessus-dessous ½ hauteur : les images gauche et droite du couple stéréoscopique sont placées l'une au dessus de l'autre mais sont comprimées verticalement de moitié. Ce mode est compatible avec les téléviseurs 3D HDMI 1.4.
   - Anaglyphe Rouge-Cyan : à utiliser avec des lunettes anaglyphe rouge-cyan.
   - Anaglyphe Jaune-Bleu : à utiliser avec des lunettes anaglyphe jaune-bleu.
   - Anaglyphe Vert-Magenta : à utiliser avec des lunettes anaglyphe vert-magenta.
   - Entrelacement horizontal : les deux images sont entrelacées ligne à ligne.
   - Entrelacement vertical : les deux images sont entrelacées colonne à colonne.
   - 2D : seul un côté de l'image 3D est affiché.

Note : Si on souhaite obtenir un affichage parallèle ou croisé ou encore si le relief apparait comme inversé, appuyer sur la touche 'X' du clavier.

Démarrage facile

Vérifier la disponibilité de Java avec la commande "java -version" :
Par exemple avec Windows :


D:\workspace\piphoto3d>java -version

openjdk version "13" 2019-09-17

OpenJDK Runtime Environment (build 13+33)

OpenJDK 64-Bit Server VM (build 13+33, mixed mode, sharing)

ou avec Linux :


pi@raspberrypi4:~ $ java -version

openjdk version "11.0.7" 2020-04-14

OpenJDK Runtime Environment (build 11.0.7+10-post-Raspbian-3deb10u1)

OpenJDK Server VM (build 11.0.7+10-post-Raspbian-3deb10u1, mixed mode)

Afficher les images 3D d'un dossier.
java -jar /home/pi/java-pi/piphoto3d.jar -folder=?

Note : remplacer /home/pi/java-pi/ par le chemin du dossier où vous avez enregistré l'application.
L'application démarre et affiche une fenêtre permettant de sélectionner le dossier où se trouvent les images 3D.
Sélectionner le dossier et cliquer le bouton Ouvrir, la première image s'affiche en plein écran en mode côte-à-côte compressé (pour TV3D).
Pour sélectionner un autre mode 3D, appuyer sur la touche "M" du clavier.
Pour afficher l'image suivante, appuyer sur la barre d'espace ou la flèche droite du clavier ou encore cliquez sur la partie droite de l'image.
Pour afficher les images avec un défilement automatique, appuyer sur la touche "A" du clavier.
Pour quitter l'application, appuyer sur la touche "Echap" du clavier.

Autres exemples.
- Démarre un diaporama automatique de toutes les images 3D trouvées dans le dossier "/home/pi/Images/3D/" :
java -jar /home/pi/java-pi/piphoto3d.jar -folder=/home/pi/Images/3D/ -a
- Indexe les images 3D trouvées dans le dossier "/home/pi/Images/3D/" (et ses sous-dossiers) et créé des fichiers d'index pour chacun des dossiers :
java -jar /home/pi/java-pi/piphoto3d.jar -buildalbums=/home/pi/Images/3D/
- Affiche le menu montrant les albums d'images trouvés dans le dossier "/home/pi/Images/3D/" (indexé dans l'étape précédente):
java -jar /home/pi/java-pi/piphoto3d.jar -albums=/home/pi/Images/3D/

Paramètres de l'application

-img=<fichier_image>	Affiche simplement l'image spécifiée (utiliser -img=? pour utiliser la fenêtre de sélection de fichier).
-folder=<dossier_images>	Charge toutes les images trouvées dans le dossier spécifié (utiliser -folder=? pour utiliser la fenêtre de sélection de dossier).
-index=<fichier_index_xml>	Charge les images et leurs descriptions depuis le fichier xml spécifié (utiliser -index=? pour utiliser la fenêtre de sélection de fichier).
-albums=<dossier>	Recherche les albums photo dans le dossier spécifié et ses sous-dossiers puis en affiche la liste permettant d'en sélectionner un (utiliser -albums=? pour utiliser la fenêtre de sélection de dossier).
-buildalbums=<dossier>	Recherche les images dans le dossier spécifié et ses sous-dossiers puis construit ou met à jour les fichiers index (utiliser -buildalbums=? pour utiliser la fenêtre de sélection de dossier).
-screen=<i[,j]>	Affiche les images sur l'écran n°i (le premier est le numéro 0) ou sur les écrans n°i et n°j.
-m=<mode_3D>	Utilise le mode de visualisation 3D indiqué : 0 : Côte-à-côte pleine largeur, 1 : Côte-à-côte demi-largeur, 2 : Dessus-dessous demi-hauteur, 3 : Anaglyphe Dubois pour lunettes rouge-cyan, 4 : Anaglyphe Dubois pour lunettes jaune-bleu, 5 : Anaglyphe Dubois pour lunettes vert-magenta, 6 : Entrelacement horizontal, 7 : Entrelacement vertical, 8 : 2D (image gauche ou droite uniquement).
-x	Traite les images en entrée en mode croisé plutôt qu'en mode parallèle.
-a	Démarre un diaporama automatique.
-r	Diaporama aléatoire (par défaut le diaporama est séquentiel).
-d=<délai>	Intervalle de temps en secondes entre chaque image pour le diaporama automatique (par défaut : 5 secondes).
-b=<couleur_fond>	Couleur du fond (notation hexadécimale, par défaut : gris sombre 404040).
-t	Affiche le titre de l'image (en haut, au centre).
-t=<l\|c\|r\|L\|C\|R>	Affiche le titre de l'image à la position spécifiée.
-p=fldDcgiIMm	Affiche le titre de l'image avec les informations suivantes : nom du 'f'ichier, 'l'ieu, 'd'ate et heure, 'D'ate, 'c'ommentaire, coordonnées 'g'ps, numéro 'i'mage, numéro 'I'mage/nombre d'images, 'M'ois et année, 'm'ois court et année (défaut=ldc).
-c=<couleur_texte>	Couleur du titre de l'image (notation hexadécimale, par défaut : jaune).
-f=<police,taille>	Police à utiliser pour le titre de l'image.
-fm=<police,taille>	Police à utiliser pour le menu.
-menu=<colonnes,lignes>	Nombre de colonnes et de lignes du menu (par défault : 5,6).
-z=<position>	Position en profondeur du titre de l'image (modes 0, 1 et 2).
-sw=<position>	Correction de la position de la fenêtre stéréo (modes 0, 1, 2 et 6. Appuyer sur Maj + flèches G / D pour augmenter / diminuer).
-w=<w\|f\|x>	'w' : Utiliser un affichage dans une fenêtre, 'f' : affichage plein-écran (défaut avec Windows), 'x' : affichage plein-écran exclusif (défaut avec Linux).
-q=<qualité>	Si 1, utilise un rééchantillonnage, si 0, utilise un redimensionnement rapide des images (Défaut=1 si plus de 2 processeurs sinon 0).
-F=<filtre>	Force l'utilisation du filtre de redimensionnement spécifié.
-v=<niveau_messages>	Nombre de messages à afficher dans le terminal (pas de message s: 0, défaut: 1).

Commandes pendant le diaporama

Echap ou q	Sortie de l'application (ou retour au menu des albums).
a ou ':'	Démmare ou met en pause le diaporama automatique.
Flèche droite ou Barre d'espace Clic sur la droite de l'image	Affiche l'image suivante.
Flèche gauche Clic sur la gauche de l'image	Affiche l'image précédente.
Page Suiv. / Préc.	Avance / recule de 10 images (en mode Presenter de 1 image).
Maj + Page Suiv. / Préc.	Avance / recule de 50 images.
Maj + Flèches Gauche ou Droite	Ajuste la position de la fenêtre stéréoscopique.
Ctrl + Flèches Gauche ou Droite	Ajuste la position en profondeur du titre de l'image.
Maj + Home	Réinitialise la position de la fenêtre stéréo (sur l'écran) et de la position du titre.
x	Transpose gauche <--> droite.
c	Montre/cache le titre de l'image.
C	Change la position du titre de l'image.
r	Change entre le mode séquentiel et le mode aléatoire.
m	Change le mode de visualisation 3D (M pour aller en arrière).
f	Change le mode de redimensionnement (F pour aller en arrière).
Q	Change la qualité oui/non.
d	Affiche la liste des images.
p	Active/désactive le mode Presenter.
F5	Depuis le menu, lance l'album sélectionné.
F7	Affiche la fenêtre d'édition des informations de l'image.
Ctrl+k	Enregistre la position du commentaire pour l'image en cours (Ctrl+Maj+k : annule).
Ctrl+s	Enregistre l'album en cours.
Ctrl+g	Ouvre la localisation dans Google Maps.
Maj+Ctrl+g	Ouvre la localisation dans OpenStreetMap.
h	Affiche la page d'aide.

Réalisation d'albums d'images

piphoto3D a été conçu pour permettre d'afficher simplement des sélections d'images 3D depuis un Raspberry Pi.
Les images sont organisées en dossiers thématiques avec, pour chaque dossier, un fichier index. L'utilisation de fichiers index autorise plus de souplesse :
- Ordre des images défini par l'utilisateur,
- Ajout d'informations aux images : date, lieu, commentaire,...
Il s'agit d'un fichier XML nommé index.xml enregistré dans le dossier des images.

Pour créer un fichier index :
   - Lancer l'application en spécifiant un dossier d'images 3D :
      Par exemple : java -jar piphoto3d.jar -folder=/home/pi/Images/3D/Paris
   - Appuyer sur Ctrl+S, le fichier index est créé dans le dossier des images
   - Quitter l'application puis la relancer en demandant l'utilisation du fichier index :
      Par exemple : java -jar piphoto3d.jar -index=/home/pi/Images/3D/Paris/index.xml
   - Documenter les images : appuyer sur la touche F7 pour ouvrir la fenêtre Modification des informations de l'image.

- On peut donner un titre à l'image (ou lieu), ajuter un commentaire, une date et heure et indiquer une position GPS.
- Ne pas oublier d'appuyer sur Ctrl+S pour enregistrer les modifications dans l'index !

Pour gérer des dossiers d'images différents :
piphoto3D permet de naviguer dans des dossiers d'images qui ont été au préalable indexés. Ces dossiers doivent être les sous-dossiers d'un dossier maître.
La commande : java -jar piphoto3d.jar -albums=<dossier maître> va lancer l'application en mode albums et charger les différents fichiers d'index présents.
L'application va alors afficher le menu suivant permettant de sélectionner le dossier à afficher :

Utiliser les touches Page Préc / Page Suiv pour afficher les différentes pages du menu.

Notes

Limitations
   - L'application lit les fichiers JPEG (extensions : .jpg, .jpe, .jpeg et .jps), les fichiers PNG et les fichiers MPO.
   - Le positionnement en profondeur des commentaires n'est pas possible dans les modes entrelacés ou les modes anaglyphes.
   - Avec certaines version Java, il faut spécifier la mémoire allouée à l'application, si un message d'erreur survient lors du chargement d'une image, essayer d'augmenter la quantité de mémoire avec le paramètre suivant : -Xmx300m
      Par exemple : java -Xmx300m -jar /home/pi/java-pi/piphoto3d.jar -albums=/home/pi/Images/3D ...

Utilisation sur Raspberry Pi Zero
Ce nano ordinateur est très lent (processeur simple cœur, peu de mémoire) !
Le passage d'une image à l'autre prendra plusieurs secondes, il est donc conseillé de redimensionner au préalable les images à la taille de l'écran.
La nouvelle version V2 du Pi Zero est équipée d'un processeur 4 cœurs et devrait être un peu plus rapide.

Utilisation sur Raspberry Pi 4 avec les deux sorties HDMI
Le Raspberry Pi 4 possède deux sorties HDMI ce qui rend possible la projection 3D avec deux vidéoprojecteurs depuis cet appareil.
Voici les paramètres à utiliser dans cette configuration : -screen=0,1 -m=0 -w=f

Exemple de script pour démarrer l'application

#!/bin/bash

# Script de lancement de piphoto3d pour affichage sur TV3D

# Explication des paramètres :
#  -albums=/home/pi/Images/3D : mode album et chemin d'accès au dossier maître des images 3D
#  -v=1 : affiche les messages lors de l'exécution du programme
#  -b=202020 : couleur du fond
#  -x : traite les images en entrée en mode croisé plutôt qu'en mode parallèle
#  -d=10 : en mode diaporama automatique, délai entre chaque image
#  -t=C : position du titre des images (ici centré, en bas)
#  -m=1 : mode 3D (ici côte-à-côte demi format)
#  -z=5 : position en profondeur du titre de l'image
#  -f=Arial,30 : police des titres des images
#  -fm=Arial,28 : police du menu de sélection des albums
#  -menu=6,8 : taille du menu (ici 6 colonnes x 8 lignes)

java -Xmx300m -jar /home/pi/java-pi/piphoto3d.jar -albums=/home/pi/Images/3D -v=1 -b=202020 -x -d=10 -t=C -m=1 -z=5 -f=Arial,36 -fm=Arial,28 -menu=6,8

Historique des versions

v1.5.5 (2023-03-23) - Correction de petits bugs. Ajout du paramètre "-p=M" pour afficher les dates : "Mois Année".

v1.5.3 (2020-12-08) - Support des fichier MPO.

v1.5.1 (2020-06-13) - Première version publique.