<analytics uacct="UA-27707792-1" ></analytics>
= <english>MapIt on phone</english> <french>MapIt sur téléphone</french> =
<english>
<center>{{#ev:youtube|-BTO71JVjX4}}</center>
</english>
<french>
<center>{{#ev:youtube|wPt8xABSsa0}}</center>
</french>

Chaîne YouTube: [[Image:MapIt.png|link=https://www.youtube.com/channel/UC78bYbYPRuCEj4yUkNP07Lw/playlists|MapIt|50px]]

Bonnes pratiques pour augmenter la qualité du modèle final:
# Pour commencer, pointez vers un endroit ayant beaucoup de repères visuels comme une peinture ou une photo sur le mur. Le but est de terminer le scan au même endroit pour que MapIt puisse détecter qu'il est revenu au point initial (une fermeture de boucle est alors détectée). MapIt peut ensuite corriger les erreurs reliées au capteur de mouvement pour optimiser le modèle.
# Balayer de haut en bas/bas en haut en tournant tranquillement (comme un mouvement en serpentin, similaire au "Paint Brush Motion" de ce [https://www.youtube.com/watch?v=XqJbFn5rJfE vidéo]).
# Éviter les mouvements rapides.
# Éviter de pointer la caméra trop près d'une surface, rester à au moins 1 mètre de la surface.
# Pour le bain, essayer au maximum de balayer au dessus du bain pour capter les côtés intérieurs du bain.
# En glissant le doigt sur l'écran de bas en haut, on peut changer le point de vue de la caméra virtuelle pour mieux voir les endroits qui n'ont pas été balayés.
# '''Assurez-vous que le téléphone est chargé à plus de 90% avant de commencer un nouveau scan'''. En bas de 50%, le téléphone tombe en économie d'énergie, diminuant la performance de l'application.

== Installation ==
MapIt est en version prototype: elle est disponible gratuitement en échange de vos commentaires. [https://docs.google.com/forms/d/e/1FAIpQLSfBkeZXw1CboBONpq05WY6mSkpbLsbH63wbaM376SDTwkfNVw/viewform?usp=sf_link Cliquez ici pour donner vos commentaires], merci!
=== Android ===
* Téléphones supportés ('''avec Google Tango'''): Lenovo Phab2Pro, Asus Zenfone AR
* [https://docs.google.com/forms/d/e/1FAIpQLSflyRp4PcJgk6PhW6sk7Pif3KPQXjygG91VXwC9Rq1XrrG9IA/viewform?usp=sf_link Formulaire pour demander l'App].

=== iOS ===
* Téléphones supportés ('''avec LiDAR'''): iPhone 13 Pro / Pro Max, iPhone 12 Pro / Pro Max, iPad Pro 2020-2021
* [https://docs.google.com/forms/d/e/1FAIpQLSflyRp4PcJgk6PhW6sk7Pif3KPQXjygG91VXwC9Rq1XrrG9IA/viewform?usp=sf_link Formulaire pour demander l'App].

== Tags ==
Lorsque l'option "Tag" and le menu "Détection de boucle" est activé, imprimer un tag ci-dessous et l'apposer sur un mur de la pièce. Pour débuter la numérisation, il faut pointer le téléphone vers le tag, puis numériser la pièce comme décrit ci-dessus. À la fin, revenir devant le tag pour le redétecter, ceci va permettre de corriger certaines erreurs dans la numérisation. Il est important de ne pas bouger le tag pendant la numérisation.
* 4 tags par page (à découper sur les pointillés):
** [https://introlab.3it.usherbrooke.ca/mediawiki-introlab/images/2/23/Tags1-4.pdf Tags1-4.pdf]
** [https://introlab.3it.usherbrooke.ca/mediawiki-introlab/images/6/69/Tags5-8.pdf Tags5-8.pdf]
** [https://introlab.3it.usherbrooke.ca/mediawiki-introlab/images/a/ae/Tags9-12.pdf Tags9-12.pdf]
** Ouvrir le fichier dans Microsoft Edge, Google Chrome ou Adobe Reader. Assurez-vous que le logiciel utilisé n'imprime pas les tags avec du flou (Firefox à gauche):
::[[File:impression_tag.jpg|300px]]

Si on veut fusionner plusieurs pièces par la suite, il est important d'utiliser un tag différent pour chaque pièce. Lors de la dernière session de numérisation, il faut parcourir tous les tags pour avoir un scan avec tous les tags référencés un par rapport à l'autre. Pour cette dernière session, il n'est pas nécessaire de balayer l'environment, simplement marcher directement d'un tag à l'autre tout en revenant au tag initial à la fin.

== <english>Privacy Policy</english> <french>Politique de confidentialité</french> ==
<english>
MapIt app on Google Play Store requires access to camera to record images that will be used for creating the map. When saving, a database containing these images is created. That database is saved locally on the device (on the sd-card under MapIt folder). MapIt requires read/write access to MapIt folder only, to save, export and open maps. MapIt doesn’t access any other information outside the MapIt folder. MapIt doesn’t share information over Internet unless the user explicitly clicks on Share button.
</english>
<french>
L'application MapIt sur Google Play Store requiert l'accès à la caméra pour enregistrer les images utilisées pour créer le modèle. Lors de la sauvegarde, une base de données avec ces images est créée. La base de données est sauvegardées sur l'appareil (sur la carte SD sous le dossier MapIt). MapIt requiert l'accès en écriture et lecture au dossier MapIt seulement, pour sauvegarder et ouvrir des modèles. MapIt n'accède pas à d'autres informations en dehors du dossier MapIt. MapIt ne partage pas d'information sur Internet à moins que l'utilisateur appuie explicitement sur le bouton Partager.
</french>

== Vidéos d'auto-apprentissage ==
* Numériser {{#ev:youtube|_BQpaIplOeU}}
* Bonnes pratiques de numérisation {{#ev:youtube|CTAEmElyZaw}}
* Visualiser le modèle 3D sur le téléphone {{#ev:youtube|F-4sU28wgHk}}
* Retrouver/Supprimer/Renommer/Partager un modèle enregistré {{#ev:youtube|sjdB5EDixDk}}

= MapIt sur ordinateur de bureau =
MapIt est en version prototype: elle est disponible gratuitement en échange de vos commentaires. [https://docs.google.com/forms/d/e/1FAIpQLSfBkeZXw1CboBONpq05WY6mSkpbLsbH63wbaM376SDTwkfNVw/viewform?usp=sf_link Cliquez ici pour donner vos commentaires], merci!
== Installation ==
=== Windows ===
Téléchargement:
* Windows 64 bits
** Installateur: [https://docs.google.com/uc?authuser=0&id=1uWXWCfBfoGWScLbcY2UvdBW2axKZ7wpN&export=download MapIt-0.4.4-win64.exe]
*** Requiert [https://www.microsoft.com/en-ca/download/details.aspx?id=48145 Visual C++ Redistributable for Visual Studio 2015]
** Version ZIP: [https://docs.google.com/uc?authuser=0&id=11Kesp1sy3YzPclG22ThegiZleZrrRDfx&export=download MapIt-0.4.4-win64.zip]
** [https://drive.google.com/drive/folders/1pWU4laHNWHYHOQUISk7gSvoRkpZH-ZOH?usp=sharing Anciennes versions]
L'installateur permet d'installer le logiciel comme n'importe quel autre logiciel, mais requiert les droits administrateurs sur l'ordinateur. Pour la version ZIP, exécutez le fichier bin/MapIt.exe pour lancer le logiciel.
<center>[[File:MapItWinInstall2.png|300px]] [[File:MapItWinInstall3.png|300px]]</center>

=== Mac OS X ===
* [https://docs.google.com/uc?authuser=0&id=13UWY67vSTMn02KVq6l-xwFNPA6Lwz_zi&export=download MapIt-0.4.3-Darwin.dmg].
** [https://drive.google.com/drive/folders/1pWU4laHNWHYHOQUISk7gSvoRkpZH-ZOH?usp=sharing Anciennes versions]
* Double-cliquez sur le fichier DMG, puis glissez l'application MapIt dans le dossier Applications. Ceci va extraire et copier MapIt dans votre dossier Applications. Vous pouvez ensuite éjecter le DMG dans Finder. Ensuite avec Spotlight (la loupe en haut à droite du bureau), cherchez MapIt pour trouver l'application dans le dossier Applications.
<center>[[File:MapItMacInstall.jpeg]]</center>

* Si vous avez le message "Impossible d'ouvrir MapIt..." en essayant d'ouvrir MapIt, allez dans les Préférences de Mac OS X, sélectionnez "Sécurité et confidentialité", déverrouiller le cadenas en bas de la fenêtre et cliquez sur "Ouvrir qu'en même" à côté du message référant à MapIt. Réessayez ensuite d'ouvrir MapIt, il devrait y avoir maintenant l'option "Ouvrir" dans la boîte du message pour démarrer MapIt:
<center>[[File:MapItMacInstallRefused.png|400px]] [[File:MapItMacInstallPref.png|400px]]</center>
<center>[[File:MapItMacInstallUnlock.png|400px]]</center>

==== Mac OS X Big Sur ====
Sur '''macOS Big Sur''' (dernière version Mac), il y a un problème de démarrage de MapIt. Il faut le démarrer à partir d'un "Terminal" en écrivant (ou en copiant cette ligne):
* <code>QT_MAC_WANTS_LAYER=1 /Applications/MapIt.app/Contents/MacOS/MapIt</code>

== Importation des modèles du téléphone (Android) ==

Il faut tout d'abord brancher le téléphone par cable USB, puis s'assurer que le téléphone est en mode "Transfert de fichiers" dans menu déroulant en haut du téléphone (glissez un doigt du haut de l'appareil vers le bas pour faire afficher ce menu):
<center>[[File:MapItUsb1.jpg|225px]] --> [[File:MapItUsb2.jpg|225px]] --> [[File:MapItUsb3.jpg|225px]]</center>

Une fois en mode "Transfert de fichiers", il y a deux méthodes pour transférer les fichiers:

1) Lors de la première utilisation de MapIt pour ordinateur de bureau, MapIt crée un répertoire "MapIt" dans votre dossier "Mes Documents". Cliquez sur Fichier->Importer et attendez quelques minutes que les modèles soient copiés dans le dossier "MapIt".
<center>[[File:MapItOpenEnd.jpeg|550px]]</center>

2) La deuxième approche utilise <strike>l'Explorateur de fichiers sur Windows ou</strike> l'[https://www.android.com/filetransfer/ Android File Transfer] sur Mac OS X. Ouvrez le dispositif ASUS_002 puis naviguer jusqu'au dossier MapIt sur le téléphone. Sélectionnez et copiez les fichiers dans un dossier sur l'ordinateur de bureau, préférablement dans le dossier "MapIt" créé dans "Mes Documents" pour que les modèles soient automatiquement chargés lors du démarrage de MapIt.

== Importation des modèles du téléphone (iOS) ==

Il faut tout d'abord brancher le iPhone ou iPad par cable USB, puis s'assurer d'accepter de faire confiance à l'ordinateur dans le dialogue qu'il va s'afficher sur le iPhone ou iPad. Si MapIt pour ordinateur de bureau n'a jamais été ouvert sur l'ordinateur, le faire en premier puis le fermer. Ça va permettre de créer automatiquement le dossier Mapit dans "Mes Documents".

=== Importation sur un ordinateur Windows ===
1) Si vous n'avez pas iTunes pour Windows, installer iTunes à partir du Microsoft Store:
<center>[[File:MapItWindows1.png|600px]]</center>

2) Ouvrir iTunes. Lorsque le iPhone ou iPad est branché, une icône ressemblant à l'image ci-dessous devrait apparaître. Cliquez dessus:
<center>[[File:MapItWindows2.png|600px]]</center>

3) Cliquez ensuite sur le "Fichiers partagés", puis sur l'application MapIt, puis sélectionnez les fichiers *db. Faire un "drag-and-drop" de ces fichiers dans le dossier Mes Documents/MapIt sur l'ordinateur:
<center>[[File:MapItWindows3.png|1000px]]</center>

4) Rouvrir MapIt pour ordinateur de bureau et les scans devraient apparaître:
<center>[[File:MapItWindows4.png|600px]]</center>

=== Importation sur un ordinateur Mac ===
1) Dans Finder, cliquez sur votre iPhone ou votre iPad, puis cliquez sur l'onglet Fichiers. Cliquez ensuite sur le triangle à côté de l'application MapIt pour voir vos fichiers, puis "drag-and-drop" les fichiers dans votre dossier Documents/MapIt:
<center>[[File:MapItMac1.png|1000px]]</center>

2) Rouvrir MapIt pour ordinateur de bureau et les scans devraient apparaître:
<center>[[File:MapItMac2.png|600px]]</center>

== Utilisation de MapIt ==

<center>{{#ev:youtube|BmSAv9sIaek}}</center>

# Ouvrez MapIt. Lors de la première utilisation, l'affichage devrait être vide. Pour importer des modèles du téléphone, voir section Importation ci-dessus. Par défaut MapIt ouvre le dossier "MapIt" dans "Mes Documents" pour afficher les modèles. Si les modèles ont été importés dans un autre dossier, faire Fichier->Ouvrir pour sélectionner le dossier contenant les modèles importés.
#* Si vous n'avez pas le téléphone, téléchargez ce modèle exemple [https://docs.google.com/uc?authuser=0&id=1TjELNu93b7-LrxUv7Mo1mwSxSr03HIGD&export=download marriot_tysons_corner.zip] et dézippez-le dans "Mes Documents/MapIt".
# Double-cliquez sur un modèle dans la liste de gauche. Le modèle devrait s'afficher dans la fenêtre de droite. Vous pouvez cliquer sur "Mesurage Automatique" pour prendre des mesures automatiquement.
# L'application essaie de trouver le maximum de mesures en fonction des plans trouvés dans le modèle. S'il y a trop de mesures, il est possible d'en enlever avec l'action "Enlever une mesure".
# Il est possible d'ajouter des mesures personnalisées avec les autres actions de mesurage. Pour mesure la hauteur des objets, utilisez l'action "Mesurer la hauteur".
# Pour mesurer la distance entre des objets en fonction des axes principaux de la pièce, utilisez l'action "Mesurer entre deux plans".
# Pour sauvegarder les mesures, cliquez Fichier->Sauvegarder ou tout simplement faire le raccourci "ctrl-s".
# Pour changer les unités de mesure dans le système impérial (pieds/pouces), allez dans Édition->Préférences.
# Pour une vue "plan" de la pièce, cliquez sur le bouton "Vue Plan" dans la barre d'actions. Vous pouvez aussi cliquer sur Z dans la barre d'actions pour cacher les mesures en Z.

== Vidéos d'auto-apprentissage ==
* Transférer le fichier du modèle 3D (.db) vers l’ordinateur {{#ev:youtube|PPoNWj-2A1o}}
* Ouvrir un modèle 3D {{#ev:youtube|H_ulPuZAhhs}}
* Visualiser le modèle 3D sur l’ordinateur {{#ev:youtube|1bYBJrO9PLU}}
* Générer des mesures automatiques {{#ev:youtube|PQxfJb1dZUc}}
* Prendre des mesures personnalisées {{#ev:youtube|csiUai4PVxA}}
* Sauvegarder les fichiers de mesure {{#ev:youtube|3Y6IS6BjktE}}

= Quoi de neuf? =
== v0.4.4 ==
17 Février 2022
* Windows/Mac:
** Ajout d'une option pour choisir l'étage à visualiser.
<center>[[File:FloorsOption1.jpg|400px]][[File:FloorsOption2.jpg|400px]]</center>
** Ajout d'une option mettre les mesures en avant-plan ou pas.
<center>[[File:ForegroundOption1.jpg|400px]][[File:ForegroundOption2.jpg|400px]]</center>
<center>[[File:ForegroundOption3.jpg|400px]][[File:ForegroundOption4.jpg|400px]]</center>
* Windows (6 janvier 2022): installateur sans MSVCR100.dll requis pour éviter l'erreur "MSVCR100.dll est introuvable".

== v0.4.3 ==
20 Juin 2020
* Windows/Mac: Ajout de l'option d'unités en "mm" dans le menu Préférences.

== v0.4.2 ==
18 Juin 2019
* Windows: Résolution d'un incompatibilité entre l'application bureau et dernière version sur téléphone suite à l'importation.
== v0.4.1 ==
28 Mai 2019
* Ajout du menu "Détection de boucle" avec options "Visuelle" et "Tag".
* Amélioration de l'optimisation du scan en utilisant aussi la gravité.

12 Mars 2019
* Ajout d'une session de mesure "Original" dans les choix d'ouverture d'un scan (sans mesure par défaut).
* Le nom du scan et la session de mesure ouverte (s'il y a lieu) sont affichés dans le titre de la fenêtre.
* Le terminal noir ne s'affiche plus sur Windows.
* Ajout d'un lien "Aide" qui redirige vers cette page.
* Ajout d'un dialogue "À propos" faisant état de la version de MapIt et d'un lien vers cette page.
* Correction des problèmes de traduction sur certains boutons de dialogues.

== v0.4.0 ==
13 Février 2019
* Ajout vidéo d'explication de l'application de bureau MapIt.
12 Novembre 2018
* Le menu ouvrir affiche maintenant les fichiers compatibles (*.db) avec MapIt
* Ajout du dialogue Édition->Préférences. Tous les paramètres sauvegardés sont maintenant rendus dans ce dialogue. Ajout de nouveaux paramètres pour configurer le nombre de mesures générées par la mesure automatique.
* À l'ouverture d'un modèle, le modèle est auto-aligné avec la grille, ce qui fait que toutes les actions de mesure sont disponibles directement.
* Plusieurs sessions de mesure peuvent être sauvegardées dans le même modèle. Faire Fichier->"Sauvegarder En..." pour sauvegarder les mesures présentes dans une nouvelle session. Lorsqu'un modèle a plus d'une session de mesure, à l'ouverture d'un modèle, une boîte de dialogue va demander qu'elle session ouvrir.
* On peut maintenant zoomer avec les touches du clavier "+" et "-".
* Menu clique-droit:
** Les actions ont été traduites en français
** Seulement les actions utiles à MapIt sont affichées
** Correction de la fonction de changement de couleur de l'arrière-plan
* Le bouton "Enlevez une mesure" reste activé tant qu'on ne ré-appuie pas sur le bouton.
* Ajout d'un bouton "Vue Plan" dans la barre d'actions. Ceci remplace la fonction Camera->Ortho mode.

== v0.3.0 ==
12 Septembre 2018
* Première version bureau!

= Publications et communications scientifiques =
* Guay, M., Labbé, M., Séguin-Tremblay, N., Auger, C., Goyer, G., Veloza, E., Chevalier, N., Polgar, J. and Michaud, F., “Adapting a Person’s Home in 3D Using a Mobile App (MapIt): Participatory Design Framework Investigating the App’s Acceptability,” in ''JMIR rehabilitation and assistive technologies'', vol. 8, no. 2, p.e24669, 2021. ([https://rehab.jmir.org/2021/2/e24669 JMIR])

File:ForegroundOption4.jpg

2022-02-17T16:20:46Z

Labm2414:

File:ForegroundOption3.jpg

2022-02-17T16:20:39Z

Labm2414:

MapIt

2022-02-17T16:20:06Z