Drawing the plan FR

🇬🇧 English version

Dessiner le plan

De quoi un plan est fait, à quoi ressemble chaque partie et quelles clés elle écrit. Les meubles ont leur propre page : Meubles.

• Coordonnées
• Pièces · Espaces extérieurs · Sous-zones
• Murs · Limites et clôtures
• Ouvertures : types, vantaux et sens d'ouverture, volets, contacts, baies
• Textes et zones d'informations
• Étiquettes des pièces, couleurs et légende
• Cadrage
• Calques et groupes

Coordonnées

Tout est en centimètres. x augmente vers la droite, y augmente vers le bas. Un point s'écrit [x, y], un segment [x1, y1, x2, y2], le contour d'une pièce est une liste de points. L'éditeur les écrit pour vous ; ils ne servent qu'à modifier le YAML à la main.

Nouveau en 0.3.0. Les coordonnées sont bornées à ± 100 000 cm (1 km) : un mur, un sommet de pièce, une ouverture, une pastille, un texte ou un meuble placé plus loin (par exemple 1e12) est ignoré, avec un avertissement dans la console.

Pièces

Une pièce est un polygone, avec des capteurs facultatifs. La toucher ouvre sa vue de pièce.

rooms:
  - name: Séjour
    poly: [[0, 0], [500, 0], [500, 420], [0, 420]]
    label: [250, 210]                 # position de l'étiquette ; pas d'étiquette sans elle
    temperature: sensor.living_room_temperature
    humidity: sensor.living_room_humidity
    area: living_room                 # pièce Home Assistant : appareils, scènes, automatisations
    tap: sensor.living_room_temperature   # entité ouverte depuis l'étiquette dans la vue de pièce

• Teinte : le sol est coloré selon temperature, du bleu (17 °C et moins) au rouge (28 °C et plus), voir plus bas. Sans température, le sol reste neutre.

• Étiquette : nom, température (1 décimale) et humidité (0 décimale). Afficher l'étiquette dans l'éditeur ajoute ou retire label.

• Attributs des capteurs : temperature_attribute / humidity_attribute lisent un attribut au lieu de l'état (une entité weather ou climate) :

  rooms:
    - name: Terrasse
      poly: [[0, 420], [500, 420], [500, 700], [0, 700]]
      label: [250, 560]
      outside: true
      temperature: weather.home
      temperature_attribute: temperature

• area relie une pièce Home Assistant : la vue de pièce liste ses entités, scènes et automatisations, ses Boutons automatiques agissent sur ses lumières et ses volets, et l'éditeur propose ses capteurs. Éditeur : Pièce Home Assistant › Intégrer les appareils de la pièce pose une pastille par appareil principal.

• Vue de pièce : zoom: false la désactive (l'étiquette ouvre toujours tap). auto_actions: false masque les boutons automatiques, automations: false les automatisations liées ; actions ajoute vos propres boutons, panels donne à la pièce ses propres panneaux latéraux. Voir Utiliser la carte › Vue de pièce.

• Une pièce a besoin d'au moins trois points valides, sinon elle est ignorée (et retirée au prochain enregistrement).

Éditeur : R (rectangle avec ses murs, puis Largeur / Hauteur exactes), P (forme libre), Ajouter › Pièces › Pièce Home Assistant ou Toutes mes pièces HA.

Espaces extérieurs

outside: true désigne une terrasse, un jardin, un balcon ou un carport : pas de teinte de température, pas compté dans la puce de température intérieure, une teinte de nuit plus marquée, le soleil du côté du soleil, et c'est le seul endroit où la météo est peinte. Ajoutez zoom: false quand une vue de pièce n'a pas de sens.

Sous-zones

Une pièce avec sub_area: true est un contour nommé à l'intérieur d'une autre pièce (coin cuisine, douche, coin repas) : pointillés, sans teinte, sans murs, pas comptée dans les puces. La toucher ouvre la pièce qui la contient, et elle suit cette pièce dans l'éditeur. N'importe quel polygone convient :

rooms:
  - name: Cuisine
    sub_area: true
    poly: [[10, 10], [230, 10], [230, 90], [90, 90], [90, 170], [10, 170]]
    label: [150, 50]

Éditeur : Ajouter › Meubles › Sous-zones (cuisine, douche…) (Cuisine 300 × 200, Douche 90 × 90, Coin repas…, puis tracée comme un rectangle), ou cochez Sous-zone sur une pièce.

Murs

De simples segments épais, avec un groupe facultatif en 5e valeur.

walls:
  - [0, 0, 500, 0]
  - [500, 0, 500, 420, rez_de_chaussee]

Chaque ouverture coupe le mur sur lequel elle est posée, comme sur un plan d'architecte. Éditeur : M ; un mur sélectionné propose En limite et Couper en deux.

Limites et clôtures

Limites de propriété, clôtures, haies : des segments plus fins, au même format que les murs (fences). Éditeur : L ; En mur transforme une limite en mur.

fences:
  - [-300, -200, 900, -200]

Ouvertures

Fenêtres, portes et portails tracés sur un mur, avec leur contact, leur volet ou leur entité motorisée.

openings:
  - type: window                         # window (fenêtre) | door (porte) | gate (portail)
    seg: [90, 0, 410, 0]                 # ses deux extrémités, sur le mur
    name: Fenêtre du séjour
    contact: binary_sensor.living_room_window   # rouge quand elle est ouverte
    shutter: cover.living_room_shutter          # dessiné dehors, plus sombre quand il est fermé
    outside: [0, -1]                     # dehors est en haut : [-1,0] gauche, [1,0] droite, [0,-1] haut, [0,1] bas
  - type: door
    seg: [500, 100, 500, 190]
    contact: binary_sensor.front_door
    leaves: 1
    swing: right                         # left | right (côté des gonds vu de l'intérieur) | sliding (coulissant)
    outward: false
  - type: gate
    seg: [200, -200, 500, -200]
    entity: cover.gate                   # motorisé : utilisé quand il n'y a pas de contact

À quoi ressemble une ouverture

État	Dessin
Fermée (contact off / closed)	Trait couleur d'accent (« fermé » dans la légende)
Ouverte (on / open)	Trait rouge épais, animé (pulsation par défaut)
En cours d'ouverture ou de fermeture	Trait pointillé jaune qui défile
Indisponible ou inconnue	Trait pointillé gris
Sans capteur	Fenêtre : deux traits fins ; porte ou portail : un trait fin avec de courts tableaux
Volet	Une bande côté extérieur, plus opaque à mesure qu'il se ferme (current_position, sinon closed = 0 %), animée pendant le mouvement

Vantaux et sens d'ouverture

Sans swing, rien de plus n'est dessiné. Avec, chaque vantail et son arc sont tracés en traits fins : left / right est le côté des gonds vu de l'intérieur (face à outside), leaves: 2 dessine deux vantaux, outward: true les ouvre vers l'extérieur, sliding dessine deux panneaux décalés.

Volets, contacts et moteurs

• contact : un binary_sensor (door, window, opening, garage_door) ou toute entité dont l'état est on / open. Nouveau en 0.2.0 : une liste de 8 capteurs au plus (un par vantail) : ouverte dès que l'un l'est, fermée quand l'un répond et qu'aucun n'est ouvert, indisponible seulement quand tous le sont. Comptée une fois dans les puces et les alertes, une ligne par capteur dans sa fiche.
• shutter : un cover ; shutter_only: true ne dessine que le volet (sur un mur sans fenêtre modélisée).
• entity : un cover motorisé (portail, porte de garage), utilisé pour l'état quand il n'y a pas de contact.
• bay : le même nom sur chaque vantail d'une baie : une seule fiche, une seule ligne dans la vue de pièce, comptée une fois dans la puce des ouvertures ouvertes, une seule tache de soleil.

  - type: window
    seg: [600, 0, 840, 0]
    name: Baie de la chambre
    contact: [binary_sensor.chambre_gauche, binary_sensor.chambre_droite]
    leaves: 2
    swing: sliding

Clés de lumière

Nouveau en 0.2.0, utilisées seulement par la lumière de l'ambiance, toutes facultatives :

Clé	Rôle
sill · height	Bas et haut du vitrage (cm). Défaut 90 / 215 ; 180 cm de large ou plus = jusqu'au sol
glazed	Porte seulement : full (porte vitrée) ou top (petite vitre en haut) : laisse entrer le jour comme une fenêtre
overhang · overhang_height	Avancée de toit au-dessus de l'ouverture (cm) : arrête le soleil haut d'été
slats	Avec un volet : tilt (lames orientables, current_tilt_position) ou vented (rais de lumière une fois fermé)

Toucher et fiche

Avec une card (ou tap: card), le toucher ouvre sa fiche ; sinon le plus d'infos de son contact (sinon de son entité, sinon de son volet). Voir Utiliser la carte › Fiches et Recettes.

Dans l'éditeur

Ajouter › Ouvertures propose des préréglages (celui de la Porte-fenêtre est vitré) et Créer une ouverture (Guide de l'éditeur). Quand une ouverture est tracée, ses capteurs sont cherchés parmi les entités libres de la pièce qu'elle borde, et outside est réglé à l'opposé de cette pièce. Un clic l'entoure de sa barre flottante, puis Modifier (ou double-clic) ouvre sa fenêtre d'édition, avec l'aperçu dans sa pièce. Onglets : Général (type, vantaux, sens d'ouverture, côté dehors, baie), Capteurs (contact, Ajouter un capteur, volet, entité motorisée), Lumière (vitrage de la porte, allège, hauteur, avancée de toit, lames), Fiche et Animation. Elle suggère un contact ou un volet libre de la pièce, ou le type qui correspond à la classe d'appareil du contact (« Type d'après le contact : Porte » › Appliquer).

Textes et zones d'informations

Un texte est une étiquette libre (nom de rue, « Jardin ») ; avec info, il devient une zone d'informations, une liste encadrée de valeurs en direct.

texts:
  - text: Rue
    pos: [450, 760]
    size: 1.2                       # facteur de taille, suit le zoom
  - text: Dehors                    # titre du cadre (facultatif)
    pos: [1080, -90]
    style: subtle                   # sans fond
    info:
      - {entity: sensor.outdoor_temperature}           # nom, icône et unité d'après l'entité
      - {entity: sensor.living_room_humidity, name: Séjour, decimals: 0}
      - {entity: climate.thermostat, attribute: current_temperature, unit: "°C", icon: mdi:thermostat}

Chaque ligne affiche une icône (icon, sinon d'après le nom de l'attribut, l'icône de l'entité ou sa classe d'appareil), le nom et la valeur ; la toucher ouvre son plus d'infos. Éditeur : T, ou Ajouter › Zone d'informations, puis + Entité dans sa fenêtre d'édition.

Étiquettes des pièces, couleurs et légende

Options de toute la carte (⚙ Paramètres › Pièces et légende) :

room_labels:
  humidity: false        # name, temperature, humidity : false le retire de toutes les étiquettes
temperature_tint:
  min: 18                # bleu à cette valeur et en dessous (°C)
  max: 26                # rouge à cette valeur et au-dessus
legend: false            # masque la légende sous le plan

temperature_tint: false coupe la teinte (et le dégradé de la légende). La légende montre l'échelle de température, « fermé », « ouvert » et, quand le plan a des volets, « volet baissé ».

Cadrage

La vue est cadrée sur le dessin plus margin (40 cm par défaut), textes et zones d'informations compris. Les visiteurs zooment avec les boutons, Ctrl+molette ou un pincement, et se déplacent en glissant. ⚙ Paramètres › Interaction peut figer la vue (Utiliser la carte).

Calques et groupes

Chaque élément appartient à un calque fixe selon sa nature, en deux groupes ; le groupe du dessus est toujours au-dessus du dessin.

Groupe	Calques, de bas en haut
Dessin (drawing_order)	rooms, sub_areas, halos, furniture, fences, walls, openings
Au-dessus du dessin (overlay_order)	room_labels, area_labels (espaces nommés, sous-zones), badges, texts

L'image de fond (background) reste sous tout le reste ; elle se masque ou se verrouille comme un calque.

layers:
  drawing_order: [rooms, sub_areas, furniture, halos, fences, walls, openings]
  hidden: [fences]          # masqués en vue
  locked: [walls, rooms]    # les clics passent au travers dans l'éditeur
  view_button: true         # un bouton Calques pour les visiteurs (leur choix reste dans leur navigateur)

Par élément : hidden: true le masque en vue (il compte toujours dans les puces) ; level le range dans son calque (plus haut = au-dessus ; tapis et espaces nommés valent -1 par défaut).

Nouveau en 0.2.0 : locked: true sur une pièce, une ouverture, une pastille, un texte ou un meuble l'empêche de bouger ou d'être redimensionné à la souris ou aux flèches (il reste modifiable dans sa fenêtre d'édition ; un clic va à ce qui est dessous). Les murs et les limites se verrouillent par calque (layers.locked).

Les groupes font sélectionner et déplacer des éléments ensemble : groups: [{id, name}], group: <id> sur un élément, une 5e valeur sur un mur ou une limite. Éditeur : sélectionnez plusieurs éléments, Grouper (Ctrl+G).