readme - Middleware.txt
changeset 49 1c2834888adc
parent 48 983d7be910c1
equal deleted inserted replaced
48:983d7be910c1 49:1c2834888adc
    23 Néanmoins, par soucis de taille de l'installeur, il vous sera nécessaire d'installer le SDK 1.5 de Microsoft ici :
    23 Néanmoins, par soucis de taille de l'installeur, il vous sera nécessaire d'installer le SDK 1.5 de Microsoft ici :
    24 http://www.microsoft.com/en-us/kinectforwindows/develop/developer-downloads.aspx
    24 http://www.microsoft.com/en-us/kinectforwindows/develop/developer-downloads.aspx
    25 
    25 
    26 II) TraKERS - Structure :
    26 II) TraKERS - Structure :
    27 
    27 
    28 TraKERS v3.0 est composé de trois modules, le Middleware (utilisant la Kinect afin de détecter des gestes et de suivre la position des mains et plusieurs Fronts (développés en Processing et en Javascript), permettant de récupérer les messages OSC du Middleware par Client/Server TUIO ainsi que les WebSockets du Middleware par Client/Server WebSocket. Pour plus d'informations sur les Fronts, veuillez consulter la documentation située à la racine sous les noms Front Processing et Front Web.
    28 TraKERS v3.5 est composé de trois modules, le Middleware (utilisant la Kinect afin de détecter des gestes et de suivre la position des mains et plusieurs Fronts (développés en Processing et en Javascript), permettant de récupérer les messages OSC du Middleware par Client/Server TUIO ainsi que les WebSockets du Middleware par Client/Server WebSocket. Pour plus d'informations sur les Fronts, veuillez consulter la documentation située à la racine sous les noms Front Processing et Front Web.
    29 
    29 
    30 Afin de permettre au Middleware d'envoyer des messages à un Front sous Processing, un client TUIO a été installé dans le Front et un serveur TUIO dans le Middleware.
    30 Afin de permettre au Middleware d'envoyer des messages à un Front sous Processing, un client TUIO a été installé dans le Front et un serveur TUIO dans le Middleware.
    31 Si on souhaite envoyer des données à une page web, un serveur WebSocket ayant un fonctionnement identique a été intégré.
    31 Si on souhaite envoyer des données à une page web, un serveur WebSocket ayant un fonctionnement identique a été intégré.
    32 
    32 
    33 Le middleware dispose d'une interface de debug permettant de connaître en temps réel la position de l'utilisateur à la Kinect. Ces fonctionnalités seront vues plus avant dans la partie Utilisation.
    33 Le middleware dispose d'une interface de debug permettant de connaître en temps réel la position de l'utilisateur à la Kinect. Ces fonctionnalités seront vues plus avant dans la partie Utilisation.
    80 
    80 
    81 Les valeurs nominales min/max définissent la distance min (plus proche) et max (plus éloignée) par rapport à la Kinect et pas à l'utilisateur.
    81 Les valeurs nominales min/max définissent la distance min (plus proche) et max (plus éloignée) par rapport à la Kinect et pas à l'utilisateur.
    82 
    82 
    83 Les variables de types float acceptent les valeurs de type N.Mf ou N,M. N étant un entier relatif et M étant un entier naturel.
    83 Les variables de types float acceptent les valeurs de type N.Mf ou N,M. N étant un entier relatif et M étant un entier naturel.
    84 
    84 
    85 minDistHands:1,0                    Distance min de la zone de recherche pour les mains.                                        Type float.
    85 minDistHands:1,0    Distance min de la zone de recherche pour les mains.    Type float.
    86 minDist:1,0                            Distance min de la zone de détection globale de l'utilisateur.                                 Type float.
    86 minDist:1,0    Distance min de la zone de détection globale de l'utilisateur.    Type float.
    87 takenPoints:10                        Nombre de points pris dans une courbe de recherche. (En développement).                        Type entier.
    87 takenPoints:10    Nombre de points pris dans une courbe de recherche. (En développement).    Type entier.
    88 directionChangeTresholdXY:10        Pixels parcourus avant de segmenter une courbe. (En développement).                            Type entier.
    88 directionChangeTresholdXY:10    Pixels parcourus avant de segmenter une courbe. (En développement).    Type entier.
    89 imagesToShow:20                        Nombre d'images à afficher dans la mosaïque du Front IDILL. (Autre projet).                    Type entier.
    89 imagesToShow:20    Nombre d'images à afficher dans la mosaïque du Front IDILL. (Autre projet).    Type entier.
    90 maxDistHands:1,5                    Distance max de la zone de recherche pour les mains.                                        Type float.
    90 maxDistHands:1,5    Distance max de la zone de recherche pour les mains.    Type float.
    91 maxDist:3,0                            Distance max de la zone de détection globale de l'utilisateur.                                Type float.
    91 maxDist:3,0    Distance max de la zone de détection globale de l'utilisateur.    Type float.
    92 zeroPoint:1,9                        Distance du point d'interaction maximal.                                                    Type float.
    92 zeroPoint:1,9    Distance du point d'interaction maximal.    Type float.
    93 directionChangeTresholdZ:0,1        Nombre de mètres avant de segmenter une courbe en profondeur. (En développement).            Type float.
    93 directionChangeTresholdZ:0,1    Nombre de mètres avant de segmenter une courbe en profondeur. (En développement).    Type float.
    94 tuioConnexionHost:127.0.0.1            Host du serveur TUIO.                                                                        Type string.
    94 tuioConnexionHost:127.0.0.1    Host du serveur TUIO.    Type string.
    95 tuioConnexionPort:8080                Port du serveur TUIO.                                                                        Type entier.
    95 tuioConnexionPort:8080    Port du serveur TUIO.    Type entier.
    96 tuioTimerElapsing:1000                Temps de latence en ms pour l'affichage et l'envoi des notifications de gesture. TUIO.        Type entier.
    96 tuioTimerElapsing:1000    Temps de latence en ms pour l'affichage et l'envoi des notifications de gesture. TUIO.    Type entier.
    97 wsConnexionHost:127.0.0.1            Host du serveur WebSocket.                                                                    Type string.
    97 wsConnexionHost:127.0.0.1    Host du serveur WebSocket.    Type string.
    98 wsConnexionPort:8090                Port du serveur WebSocket.                                                                    Type entier.
    98 wsConnexionPort:8090    Port du serveur WebSocket.    Type entier.
    99 wsTimerElapsing:1000                Temps de latence en ms pour l'affichage et l'envoi des notifications de gesture. WS            Type entier.
    99 wsTimerElapsing:1000    Temps de latence en ms pour l'affichage et l'envoi des notifications de gesture. WebSocket.    Type entier.
       
   100 
       
   101 readmeMiddleware:..\readme - Middleware.txt    Chemin du readme du Middleware.    Type string.    
       
   102 readmeFrontProcessing:..\readme - Front Processing.txt    Chemin du readme du Front Processing. Type string.
       
   103 docFrontProcessing:..\tutorial front processing.html    Chemin de la documentation du Front Processing.    Type string.
       
   104 readmeFrontJS:..\readme - Front Web.txt    Chemin du readme du Front Web.    Type string.
       
   105 docFrontJS:..\tutorial front js et wamp.html    Chemin de la documentation du Front Web.    Type string.
       
   106 exPFMPS:..\Front Processing\src\Fluid_fanipulation\Fluid_manipulation.pde    Chemin du code de l'exemple Processing de la manipulation de fluide.    Type string.
       
   107 exPFMExe:..\Front Processing\src\Fluid_manipulation\application.windows\Fluid_manipulation.exe    Chemin de l'exemple Processing de la manipulation de fluide.    Type string.
       
   108 exPSMPS:..\Front Processing\src\Smoke_manipulation\Smoke_manipulation.pde    Chemin du code de l'exemple Processing de la manipulation de fumée.    Type string.
       
   109 exPSMExe:..\Front Processing\src\Smoke_manipulation\application.windows\Smoke_manipulation.exe    Chemin de l'exemple Processing de la manipulation de fumée.
       
   110 exPTPS:..\Front Processing\src\Trakers\Trakers.pde    Chemin du code de l'exemple Processing de l'affichage des pointeurs.    Type string.
       
   111 exPTExe:..\Front Processing\src\Trakers\application.windows\Trakers.exe    Chemin de l'exemple Processing de l'affichage des pointeurs.    Type string.
       
   112 exPTGPS:..\Front Processing\src\Trakers_gestures\Trakers_gestures.pde    Chemin du code de l'exemple Processing de l'affichage des gestures.    Type string.
       
   113 exPTGExe:..\Front Processing\src\Trakers_gestures\application.windows\Trakers_gestures.exe    Chemin de l'exemple Processing de l'affichage des gestures.    Type string.
       
   114 exPIEHand1DPS:..\Front Processing\src\Interaction_examples\Hands_1D\Hands_1D.pde    Chemin du code de l'exemple Processing de la manipulation 1D de la main.    Type string.
       
   115 exPIEHand1DExe:..\Front Processing\src\Interaction_examples\Hands_1D\application.windows\Hands_1D.exe    Chemin de l'exemple Processing de la manipulation 1D de la main.    Type string.
       
   116 exPIEHand2DPS:..\Front Processing\src\Interaction_examples\Hands_2D\Hands_2D.pde    Chemin du code de l'exemple Processing de la manipulation 2D de la main.    Type string.
       
   117 exPIEHand2DExe:..\Front Processing\src\Interaction_examples\Hands_2D\application.windows\Hands_2D.exe    Chemin de l'exemple Processing de la manipulation 2D de la main.    Type string.
       
   118 exPIEHandPressPS:..\Front Processing\src\Interaction_examples\Hand_press\Hand_press.pde    Chemin du code de l'exemple Processing du press de la main.    Type string.
       
   119 exPIEHandPressExe:..\Front Processing\src\Interaction_examples\Hand_press\application.windows\Hand_press.exe    Chemin de l'exemple Processing du press de la main.    Type string.
       
   120 exPIEHandSignalPS:..\Front Processing\src\Interaction_examples\Hand_signal\Hand_signal.pde    Chemin du code de l'exemple Processing du signal de la main.    Type string.
       
   121 exPIEHandSignalExe:..\Front Processing\src\Interaction_examples\Hand_signal\application.windows\Hand_signal.exe    Chemin de l'exemple Processing du signal de la main.    Type string.
       
   122 exWPointersPS:C:\wamp\www\Front JS\pointers\    Chemin du code de l'exemple Web de l'affichage des pointeurs.    Type string.
       
   123 exWPointersExe:http://localhost/Front%20JS/pointers/    Chemin de l'exemple Web de l'affichage des pointeurs.    Type string.
       
   124 exWGesturesPS:C:\wamp\www\Front JS\pointers\    Chemin du code de l'exemple Web de l'affichage des gestures.    Type string.
       
   125 exWGesturesExe:http://localhost/Front%20JS/gestures/    Chemin de l'exemple Web de l'affichage des gestures.    Type string.
   100 
   126 
   101 Voici les règles à respecter lors de l'affectation des valeurs des paramètres :
   127 Voici les règles à respecter lors de l'affectation des valeurs des paramètres :
   102 
   128 
   103 1) maxDistHands doit être supérieur à 0f.
   129 1) maxDistHands doit être supérieur à 0f.
   104 2) minDistHands doit être supérieur à 0f.
   130 2) minDistHands doit être supérieur à 0f.
   115 13) imagesToShow doit être supérieur ou égal à 1.
   141 13) imagesToShow doit être supérieur ou égal à 1.
   116 14) takenPoints doit être supérieur à 0.
   142 14) takenPoints doit être supérieur à 0.
   117 15) directionChangeTresholdXY doit être supérieur ou égal à 0.
   143 15) directionChangeTresholdXY doit être supérieur ou égal à 0.
   118 16) directionChangeTresholdZ doit être supérieur ou égal à 0.
   144 16) directionChangeTresholdZ doit être supérieur ou égal à 0.
   119 
   145 
       
   146 D) Menu.
       
   147 
       
   148 Via le menu en haut de la fenêtre de debug du Middleware, il est possible d'accéder aux readme et documentations du Middleware, du Front Processing et du Front Web. Le fichier de configuration est également disponible dans ce menu. Une fois un paramètre modifié, il est nécessaire de redémarrer le Middleware pour que les nouveaux paramètres soient pris en compte.
       
   149 Les exemples et leurs code source des deux Fronts sont accessibles dans le menu.
       
   150 - Dans le cas où l'on souhaite accéder aux sources d'un exemple processing, il est nécessaire d'avoir installé Processing et d'avoir lié le type de fichier .pde avec ce programme.
       
   151 - Dans le cas où l'on souhaite lancer les exemples du Front Web, il est nécessaire de placer les exemples présents dans le dossier Front JS dans le répertoire www du dossier wamp (par défaut C:\wamp\www).
       
   152 
   120 IV) Mention(s) importante(s) pour le debug :
   153 IV) Mention(s) importante(s) pour le debug :
   121 
   154 
   122 Il semblerait que l'implémentation actuelle de TUIO dans ce projet ne gère pas le multi-client.
   155 Il semblerait que l'implémentation actuelle de TUIO dans ce projet ne gère pas le multi-client.
   123 Par conséquent, le premier client Processing à se connecter au Middleware est le seul à recevoir des messages.
   156 Par conséquent, le premier client Processing à se connecter au Middleware est le seul à recevoir des messages.
   124 
   157