{{tag>BROUILLON}}

----
====== Wiimote Whiteboard  ======

Wiimote Whiteboard est un logiciel libre écrit en Java, permettant d'utiliser une Wiimote pour créer un tableau blanc interactif (TBI). Il propose plusieurs fonctions intéressantes, dont: interface disponible en français, support de plusieurs Wiimotes, lissage, calibration simple et rapide, et "mode touchpad".


===== Pré-requis =====

  * Matériel: une ou plusieurs Wiimote, un vidéo-projecteur, un adaptateur [[Bluetooth]], un stylet infra-rouge.
  * Disposer d'une [[java|machine virtuelle Java]]  (testé avec [[apt://openjdk-6-jre]] et [[apt://sun-java6-jre]])

===== Installation (Méthode manuelle)=====

  * Récupérer sur le [[http://www.uweschmidt.org/wiimote-whiteboard|site de l'auteur]] la dernière version ([[http://www.uweschmidt.org/files/WiimoteWhiteboard.zip|Celle-ci à l'heure où j'écris]]) et décompresser l'archive zip.
  * Aller dans le dossier WiimoteWhiteboard qui vient d'être créé, et y rajouter un sous-dossier nommé ''lib''
  * Télécharger la dernière version stable de BlueCove-GPL (Probablement [[http://bluecove.googlecode.com/files/bluecove-gpl-2.1.0.jar|celle-ci]])et la placer dans le dossier ''lib''.
  * Executez maintenant ces commandes (à adapter bien sur):
  <code>
  cd /chemin/vers/le_dossier/WiimoteWhiteboard
  zip WiimoteWhiteboard.jar lib/bluecove-gpl*.jar
  </code>
  * Le programme peut maintenant se lancer avec cette commande:
  <code>java -jar WiimoteWhiteboard.jar</code>
  * Pour plus de simplicité, vous pouvez vous [[raccourci-lanceur|créer un lanceur]] contenant cette commande (avec le chemin complet vers WiimoteWhiteboard.jar).
  * Il se peut que le logiciel ne trouve pas la librairie bluetooth de votre système. La commande à lancer dépend de la version de la librairie bluetooth, donc de la version d'Ubuntu:
<note>Sur la 12.04, pour la 32 bits,  
<code>sudo ln -s /usr/lib/i386-linux-gnu/libbluetooth.so.3.11.5  /usr/lib/libbluetooth.so</code>
pour la 64 bits,
<code>sudo ln -s /usr/lib/x86_64-linux-gnu/libbluetooth.so.3.11.5  /usr/lib/libbluetooth.so</code>
 </note>
<note>Sur la 13.04, ainsi que pour la 13.10 et la 14.04 la librairie bluetooth est passée en version 3.13.0, le lien se transforme pour la 32 bits en  
<code>sudo ln -s /usr/lib/i386-linux-gnu/libbluetooth.so.3.13.0  /usr/lib/libbluetooth.so</code>
et pour la 64 bits
<code>sudo ln -s /usr/lib/x86_64-linux-gnu/libbluetooth.so.3.13.0 /usr/lib/libbluetooth.so</code>
Pour la 14.04, il pourra être nécessaire de rendre le fichier correspondant exécutable, ce qui donne (pour la version 32 bits)
<code>sudo chmod a+x /usr/lib/i386-linux-gnu/libbluetooth.so.3.13.0</code>
 </note>
===== Installation (Méthode automatisée)=====

Cette méthode télécharge et installe automatiquement les fichiers nécessaires dans votre dossier personnel, et crée un lanceur dans le menu. Testé sous Ubuntu 9.10 et 12.04.

Créer un fichier texte et y coller le contenu de ce bloc:

<code bash>
#!/bin/bash

#1 Vérifier la configuration du bluetooth
libbluetooth=`ls -l /usr/lib | grep libbluetooth.so | grep -v ">"`
libbluetooth=${libbluetooth#*lib}

if [ ${#libbluetooth} -lt 3 ]
then
    echo "\n##### WARNING #####\nAucune librairie bluetooth ne semble installée sur votre ordinateur. Cette librairie est nécessaire au fonctionnement du logiciel."
    echo "Continuer l'installation?\n o=oui, n=non"

    #Interrompre l'installation
    clavier="n"
    read clavier
    if [ "$clavier" != "o" ]
    then
        echo "Installation interrompue"
        exit 0
    fi
else
    echo "\n##### OK #####\nLibrairie installée: lib$libbluetooth\n"
    if [ ! -e /usr/lib/libbluetooth.so ]
    then
        echo "\n##### WARNING #####\nLe programme risque de ne pas trouver votre librairie bluetooth. En cas de problème, lancer cette commande avec les privilèges administrateur peut résoudre le problème:"
        echo "    ln -s /usr/lib/lib$libbluetooth /usr/lib/libbluetooth.so"
        echo "Continuer l'installation?\n o=oui, n=non"
    
        #Interrompre l'installation
        clavier="n"
        read clavier
        if [ "$clavier" != "o" ]
        then
            echo "Installation interrompue"
            exit 0
        fi
    fi
fi

#2 Vérifier ancienne installation
if [ -d "$HOME/WiimoteWhiteboard" ]
then
    echo "Le programme est déja installé. Souhaitez vous le désinstaller?"
    echo "o=oui, n=non"
    clavier="n"
    read clavier
    if [ "$clavier" = "o" ] #Désinstallation
    then
        rm -r "$HOME/WiimoteWhiteboard"
        rm "$HOME/.local/share/applications/wiimotewhiteboard.desktop"
        echo "\nOpération effectuée"
    fi
    exit 0
fi

#3 Voulez vous continuer?
echo "Ce script est livré tel quel en espérant qu'il vous soit utile, sans aucune garantie. Vous l'utilisez à vos propres risques.
Une connexion internet est nécéssaire pour télécharger les divers composants nécessaires à Wiimote Whiteboard.
Voulez-vous continuer? o=oui, n=non"

clavier="n"
read clavier

#4 Installation
if [ "$clavier" = "o" ]
then
    #téléchargement et décompression du logiciel
    cd "$HOME"
    wget http://www.uweschmidt.org/files/WiimoteWhiteboard.zip 
    unzip WiimoteWhiteboard.zip 
    rm WiimoteWhiteboard.zip
    #ajout librairie manquante
    cd WiimoteWhiteboard
    mkdir lib
    wget -P lib http://bluecove.googlecode.com/files/bluecove-gpl-2.1.0.jar 
    zip WiimoteWhiteboard.jar lib/bluecove-gpl*.jar
    rm -r ./lib
    #creation d'un lanceur dans le menu
    echo "[Desktop Entry]
Type=Application
Encoding=UTF-8
Name=WiimoteWhiteboard
GenericName=WiimoteWhiteboard
Comment=Créez un tableau blanc intéractif avec une Wiimote
Icon=$HOME/WiimoteWhiteboard/Help/pub/WiimoteWhiteboard_128.png
Exec=java -jar \"$HOME/WiimoteWhiteboard/WiimoteWhiteboard.jar\"
Terminal=false 
StartupNotify=false
Categories=Application;Utility" > "$HOME/.local/share/applications/wiimotewhiteboard.desktop"

echo "\n##################
Le logiciel est installé dans $HOME/WiimoteWhiteboard
Un raccourci a été créé dans le menu Applications/Accessoires
Vous pourrez désinstaller le logiciel en relançant ce script
\nAppuyez sur Entrée pour quitter."
read clavier
fi
</code>

Rendre le fichier executable, puis lancer le script.




===== Utilisation=====

Lancer l'application. Le logiciel recherche directement les Wiimotes en mode découvrables: appuyer sur les boutons 1 et 2 de celles-ci pour qu'elles soient trouvées.

Placer les wiimotes convenablement, et lancer le calibrage. Celui-ci consiste à pointer avec le stylet les cibles s'affichant à l'écran. Le bouton "Détail de la calibration" permet de voir la représentation de l'écran vu par la wiimote: il faut s'arranger pour que celui-ci soit le plus grand possible (sans dépasser), pour avoir une meilleure précision. Le "Moniteur de caméra IR" montre en temps réél ce que voit la Wiimote, et est donc très utile pour placer celle-ci.

Pour utiliser le TNI, il suffit maintenant de cocher les cases dans la section "Contrôle de la souris".

Le menu ''editer > préférences'' permet de modifier la langue de l'interface, et de changer le mode de gestion du pointeur (mode pavé tactile, clic droit par maintient prolongé...).

===== Désinstallation =====

Pour supprimer cette application, il suffit de supprimer son répertoire d'installation. Il faudra aussi supprimer le lanceur si vous en avez créé un ou que vous avez utilisé le script d'installation.\\
Si vous avez installé le logiciel à partir du script, vous pouvez également l'utiliser pour procéder à la désinstallation.

===== Voir aussi =====

  * **(en)** [[http://www.uweschmidt.org/wiimote-whiteboard|Site du projet]]
  * **(en)** [[http://johnnylee.net/projects/wii/| Le site de Johnny chung Lee]]

----

//Contributeurs principaux : [[utilisateurs:kimented|kimented]], ... //

//Basé sur [[http://www.schlossgul.org/doku.php?id=documentation:tableaublanc|« Tableau Blanc Interactif »]] par kimented.//