✎ sweet_home_3d [Wiki ubuntu-fr]

Vous affichez une ancienne révision du document ! Si vous l'enregistrez, vous créerez une nouvelle version avec ce contenu.

----
====== Sweet Home 3D ======

{{ image:sh3d_04.png?325x275|copie écran - interface- sh3d}}
===== Introduction =====

**Sweet Home 3D** (SH3D en abrégé) est un logiciel d'architecture qui permet à la fois de faire un plan simple de votre appartement, maison ou palais des mille et une nuits, de voir le résultat en [[wpfr>Perspective_conique|perspective conique]] sous forme de vue aérienne ou de visite virtuelle.

C'est un logiciel libre sous licence **[[wpfr>Licence_publique_générale_GNU|GNU GPL]]**, écrit par Emmanuel Puybaret en [[:Java]] (il est donc multi plate-forme ).

A ce jour c'est le seul logiciel de ce type sous GNU/linux.

Les autres applications sont des produits professionnels, longs à prendre en main pour qui ne maîtrise pas déjà la [[CAO]] ou l'architecture (voir [[SigCAD]], [[Cycas]] ou [[Octree]]).

**Sweet Home 3D** est un logiciel pleinement exploitable, stable et en développement permanent, avec un forum très réactif.

Testé sous : 
  * Ubuntu 8.04 avec Java 6 (1.6), SH3D-2.2 et 2.3
  * Ubuntu 8.10 avec Java 6 (1.6)
  * Ubuntu 9.04 avec Java 6 (1.6)
  * Ubuntu 9.10 avec Java 6 (1.6)
  * Ubuntu 10.04 avec Java 6 (1.6), SH3D-2.3

===== Pré-requis =====
  * Disposer d'une connexion à Internet configurée et activée (pour l'installation et la 1ère exécution)
  * Avoir un JRE en version >= 5, voir la page [[java]] pour l'installation de paquets adéquats. 
  * sur un système 64 bits, il faut aussi le paquet **[[apt://ia32-sun-java6-bin|ia32-sun-java6-bin]]** pour avoir la commande ''javaws''

''which javaws'',  vous donnera l'emplacement du lanceur java webstart

''javaws --version'' confirmera la version installé

===== Installation =====
 
Il est possible soit 
   * télécharger Sweet Home 3D pour l'installer sur votre ordinateur (et avoir la possibilité de travailler hors-ligne),
   * et/ou l'utiliser en ligne au sein de votre navigateur

Si les pré-requis sont remplis, il n'y a pas d'autres actions à faire que de cliquer sur le lien **Lancer Sweet Home 3D avec Java Web Start**, puis sélectionner "ouvrir avec **javaws**" (téléchargement, installation et lancement se font automatiquement à la suite).

Pour l'installation sur votre ordinateur, tout est bien décrit à la page [[http://www.sweethome3d.eu/fr/download.html|téléchargement]] du site.

En cas de problème avec ce lien ((vu avec konqueror  3.5.10, et certaine configuration java par ex)), il est possible de forcer en ligne de commande le lancement avec:

/usr/bin/javaws http://www.sweethome3d.eu/SweetHome3D.jnlp

Pour l'installation et une utilisation hors-ligne

Dans un répertoire de votre choix, télécharger le fichier de lancement de SweetHome3D.jnlp, par exemple comme ceci
    wget http://www.sweethome3d.eu/SweetHome3D.jnlp

Et pour lancer la version locale
    /usr/bin/javaws ./SweetHome3D.jnlp

==== Java Web Start ====
//[[wpfr>Java_Web_Start|Java Web Start]] est un outil informatique de déploiement de logiciels fondés sur la technologie Java// (cf. la source [[wpfr>Java_Web_Start|Wikipédia]] pour plus d'information). Il va automatiquement télécharger l'application, l'installer et la lancer.

''javaws'' est l'exécutable de Java Web Start. On le trouvera dans le répertoire ''bin'' du JRE. (''$ which javaws'' vous donnera sa localisation)

Le principe est de télécharger le fichier ''SweetHome3D.jnlp'' et de l'exécuter avec ''javaws''. Tout ceci est fait automatiquement dans le navigateur en cliquant sur le lien "Lancer Sweet Home 3D avec Java Web Start" de la page [[http://www.sweethome3d.eu/fr/download.html|téléchargement]] du site.

L'avantage de Java Web Start c'est qu'il vérifie à chaque exécution s'il n'y a pas une mise à jour du logiciel et l'installe si besoin. A noter que l'on peut exécuter un logiciel sans avoir de connexion internet.

Toute configuration de Java Web Start ce fait dans le menu //Système->Préférence->Sun Java6 Plugin Control Panel//

On peut aussi télécharger le fichier ''SweetHome3D.jnlp'' dans un répertoire et le lancer avec ''javaws'' dans un [[terminal]]

=== En cas de problème  ===

* Si, une fois lancé, le téléchargement des fichiers de Sweet Home 3D par Java Web Start s'interrompt (message du genre "Téléchargement annulé"), merci de patienter quelques instants, le temps qu'il reprenne.
  * Si, au lancement de Java Web Start, vous avez l'erreur suivante: "java.net.MalformedURLException: unknown protocol: socket", configurez Java Web Start (menu //Système->Préférence->Sun Java6 Plugin Control Panel//): sous l'onglet "Général", cliquez sur "Paramètres réseau" et choisissez "Connexion directe à Internet". Ainsi il se connectera directement à internet.
  * Si le raccourci ne peut se créer sur le bureau, il suffit de créer un lien symbolique Desktop -> Bureau

==== SweetHome3D et son installateur ====
La méthode Java Web Start est préconisée. Toutefois, si des problèmes java bloquent le démarrage, on peut aussi télécharger "l'installateur Linux" de la page [[http://www.sweethome3d.eu/fr/download.html|téléchargement]] du site.

Cet installateur n'est autre qu'une archive à décompresser.

Il suffit ensuite de décompresser ce fichier et d'exécuter l'application ''SweetHome3D'' situé dans le répertoire décompressé.

A noter que ce paquet contient un JRE intégré.
==== Compilation ====
Si les 2 méthodes d'exécution ne fonctionnent pas on peut toujours compiler le logiciel à partir des sources.

On les télécharge sur [[http://sourceforge.net/projects/sweethome3d|SourceForge]].

Décompresser le fichier téléchargé et exécuter ant dans le répertoire où se trouve le fichier build.xml. En théorie, après la compilation réussie, il suffit de charger la page SweetHome3DApplet.html du répertoire deploy pour démarrer Sweet Home 3D. Malheureusement, l'application Java Web Start résultant de ce processus de compilation ne s'exécutait pas du tout, ne parvenant pas à localiser les ressources dont elle avait besoin. Il se peut qu'un système 64 bits en soit la cause, pour lequel les plug-ins Java sont moins matures.

Pour contourner ce nouveau problème sans réinstaller Linux en version 32 bits, on peut exécuter ''ant jarExecutable'' afin de créer le répertoire install contenant une archive JAR exécutable indépendante, ne reposant pas sur Java Web Start. 
Pour exécuter le programme, il suffit ensuite de taper :

java -jar install/SweetHome3D-2.3.jar

voire même mieux, si vous voulez attribuer un maximum 512 Mo au programme  :

java -Xmx512m -jar install/SweetHome3D-2.3.jar

Comme Sweet Home 3D supporte Linux 64 bits depuis [[http://www.sweethome3d.eu/fr/history.jsp#version2point2|la version 2.2]], cette solution fonctionne sous Linux 32 et 64 bits.

===== Configuration =====
Il n'y a rien de particulier à faire pour configurer le programme.

Allez toutefois simplement vérifier dans le menu //Fichier->Préférences//, que vous êtes bien en mesure métrique (unités cm).

==== Raccourci dans la barre de menu Ubuntu ====

On pourra créer un raccourci en utilisant le [[:raccourci-lanceur|mini-tutoriel]]. Attention à la commande à exécuter qui dépend de votre installation: Java Web Start ou paquet.

On pourra aussi utiliser l'icône du site pour notre raccourci/lanceur en copiant cette [[http://sweethome3d.sourceforge.net/SweetHome3DIcon.gif|image]] gif.

Par exemple:
  * Créer un [[:dossiers_et_fichiers_caches|dossier caché]] **.SweetHome3D** dans votre [[initiation#comment_est_organise_mon_disque_dur_avec_ubuntu|home]]
  * Copier l'image dans ce dossier

[[:raccourci-lanceur|Créez un raccourci]] en utilisant la commande selon votre installation :
  * Java Web Start: si ''sh3D_repertoire'' et le répertoire où est stocké le fichier **SweetHome3D.jnlp**

dans le [[:dossiers_et_fichiers_caches|dossier caché]] **.SweetHome3D**. La commande sera donc

/usr/bin/javaws sh3D_repertoire/SweetHome3D.jnlp

ou (pour avoir travailler avec la version en ligne

/usr/bin/javaws http://www.sweethome3d.eu/SweetHome3D.jnlp

Autre exemple:

* utilisation du raccourci crée sur le bureau : il suffit de cliquer avec le bouton droit sur l'icône du raccourci, de choisir le menu propriétés; ensuite copier la ligne située dans le champ commande de l'onglet général.

/usr/lib/jvm/java-6-sun-1.6.0.15/jre/bin/javaws -localfile -offline /home/trucmachin/.java/deployment/cache/6.0/17/6db71e91-3ea004fa

* Créer le raccourci de la manière classique en collant la commande précédemment copiée.

<note tip>
Cette méthode à la différence du fichier .jnlp, à l'avantage de ne pas créer une instance dans le cache Java, à chaque fois que l'application est lancée par ce raccourci.
</note>

===== Utilisation =====

L'utilisation est très intuitive, le dessin des murs s'effectue aisément, tout comme le positionnement des éléments mobiles, c'est à dire les portes, fenêtres, escaliers et le mobilier lui même.

On utilise le glisser-déposer pour les éléments, à partir de la bibliothèque, vers le plan. Chaque élément est éditable soit directement à la souris pour les dimensions, soit en double-cliquant dessus pour les paramètres plus avancés.

On peut faire des sélections multiples d'objet, murs inclus.

Lisez [[http://www.sweethome3d.eu/fr/userGuide.html|la documentation]] à laquelle cette page renvoie pour plus d'informations.

Le logiciel dispose aussi d'une aide intégrée très complète, un vrai manuel en fait.
Voir plus bas une copie d'écran de cette aide.

On peut [[http://sweethome3d.sourceforge.net/fr/importModels.html|importer des modèles de meuble]] (formats OBJ, LWS ou 3DS) à partir de sites qui permettent cela, mais il faut trier entre modèles en téléchargement libre et les autres.

Les formes de base, boite et cylindre permettent, en jouant sur les dimensions, l'épaisseur et l'élévation, de créer des éléments de mobilier directement (voir sur la copie d'écran en 3D la table de la cuisine circulaire au bout).

===== Copies d'écran =====
Vue générale de l'application :

Un exemple de plan :

Une vue aérienne de ce plan :

{{image:sh3d_02.png?650x550|copie écran - vue axonométrique- sh3d}}

Et la même maison vue de l'intérieur :

{{image:sh3d_03.png?650x550|copie écran - visite virtuelle- sh3d}}

L'aide en ligne :

===== Fonctionnalités attendues=====

Sweet Home 3D ne dispose pas encore de certaines options qui peuvent faire défaut selon l'usage que l'on veut en faire, à savoir :
  * pas de possibilité de modifier la texture des meubles, mais les possibilités d'importation de bibliothèque de mobilier sont presque sans limite. Si vous savez travailler avec Blender, vous pourrez fabriquez vous même n'importe quel meuble ou objet.
  * pas de calque (façon The gimp) pour le mobilier, ce qui permettrait d'un clic de faciliter la lecture du plan.
  * pas de gestion des étages prévu. Il faut passer par une astuce décrite dans la [[http://www.sweethome3d.eu/fr/faq.html|FAQ]] pour contourner ça.
  * lignes de cote non attachées à la géométrie (en dynamique)

Il faut noter la réactivité du développeur, qui, quelques semaines après la rédaction de cette page a ajouté les fonctions d'impression et celle d'exportation en format PDF.
Depuis la liste des fonctionnalités et améliorations est impressionnante.

==== Liens =====

* [[http://www.sweethome3d.eu/fr/|sweethome3d.eu]] site officiel de Sweet Home 3D.
  * [[http://www.sweethome3d.eu/fr/userGuide.html|Le guide utilisateur de Sweet Home 3D]].
  * [[http://www.sweethome3d.eu/fr/guideUtilisateurSweetHome3D.pdf|Un autre (vieux) guide en PDF]].
  * [[http://www.sweethome3d.eu/fr/creerMeubleSweetHome3D.pdf|Documentation pour créer un meuble pour Sweet Home 3D]].
  * [[http://www.framasoft.net/article4491.html|Sur Framasoft]] une notice.
  
La version 0.10 de ce logiciel est l'étude de cas du [[http://www.eteks.com/services/cahierswing.html|Cahier du programmeur Swing]] écrit par Emmanuel Puybaret et publié aux [[http://www.editions-eyrolles.com/Livre/9782212120196|Editions Eyrolles]].

----

//Contributeurs : [[utilisateurs:sx1]], [[utilisateurs:nlcf]], [[utilisateurs:jahwork]]//

Merci de recopier le code ci-contre pour prouver que vous êtes humain : V Z D I I Merci de laisser ce champ vide :

Résumé

Note : En modifiant cette page, vous acceptez que le contenu soit placé sous les termes de la licence suivante : CC Paternité-Partage des Conditions Initiales à l'Identique 3.0 Unported