Configuració personalitzada del mapa

L'alineació, l'escala i la imatge de fons es poden configurar de manera independent per a cada mapa desat al dispositiu.

Aquestes configuracions es poden ajustar a l'editor visual seleccionant un mapa de la llista de mapes, o bé utilitzant la propietat map_config a la configuració YAML.

Opcions de configuració del mapa

Les configuracions dins de map_config s'apliquen per índex de mapa utilitzant claus com map_1, map_2, etc. Qualsevol de les opcions següents es pot definir sota un mapa específic:

Avís

Els índexs dels mapes s'assignen segons l'ordre de creació, amb el mapa més antic rebent l'índex més baix, començant des de l'1. Tot i això, si la funció de mapa multi-plaques està desactivada en un dispositiu que té múltiples mapes i les seves configuracions, el mapa actiu actual es reasigna automàticament a l'índex 1. Això significa que un mapa configurat anteriorment amb un índex diferent adoptarà sobtadament la configuració de map_1.

• rotation: Sobrescriu la rotació configurada dins de les dades del mapa per dibuixar el mapa en una rotació personalitzada específica d’aquesta carta, acceptant valors de 0, 90, 180 o 270.
• scale: Sobrescriu el càlcul automàtic de l’escala basat en la diferència entre la mida original del mapa i la mida de la carta, acceptant valors entre 0.1 i 20.
• object_scale: Sobrescriu la mida calculada automàticament dels objectes del mapa, com icones d’habitacions i obstacles, permetent que apareguin més grans o més petits.
• opacity: Transparència global del mapa dibuixat. El valor inicial és 1 i accepta valors fins a 0.
• object_opacity: Transparència dels objectes dibuixats al mapa, com icones d’habitacions o obstacles. El valor inicial és 1 i accepta valors fins a 0.
• font_size: Mida de la font per als globus de text mostrats sobre objectes activats. Accepta valors entre 0 i 12.
• hidden_objects: Sobrescriu els objectes del mapa ocults definits al Configuració avançada global per a aquest mapa específic.

Centrat i Escala

Els paràmetres següents s'utilitzen per substituir la mida i les coordenades centrals que la targeta calcula automàticament per dibuixar el mapa.

Avís

Els valors proporcionats per a aquests paràmetres són relatius a les dimensions en brut del mapa, no als píxels absoluts de la pantalla. Com que calcular manualment aquestes coordenades relatives és molt complex, els valors exactes necessaris es poden extreure utilitzant la secció Informació del Mapa en Temps Real de l'editor visual.

• left: Substitueix el centre horitzontal calculat automàticament del mapa. Per exemple, establir aquest valor a 0 col·loca la coordenada 0 del mapa a l'eix X exactament al centre horitzontal de la targeta. Aquest punt normalment es troba just davant de l'amarratge.
• top: Substitueix el centre vertical calculat automàticament del mapa. Per exemple, establir aquest valor a 0 col·loca la coordenada 0 del mapa a l'eix Y exactament al centre vertical de la targeta. Aquest punt normalment es troba just davant de l'amarratge.
• width: Substitueix l'amplada real del mapa que s'utilitza per al càlcul d'ajust. Com que la targeta escala el mapa segons la dimensió més gran que hi cap, introduir un valor més gran que l'amplada real del mapa farà que el mapa es redueixi dins de la targeta, mentre que un valor més petit l'ampliarà.
• height: Substitueix l'altura real del mapa que s'utilitza per al càlcul d'ajust. De manera similar a la propietat width, introduir un valor més gran que l'altura real del mapa farà que el mapa es redueixi dins de la targeta, mentre que un valor més petit l'ampliarà.

Exemple YAML

type: custom:dreame-vacuum-card
entity: vacuum.l10s_gen2
map_config:
  map_1:
    rotation: 90
    scale: 1.2
    object_scale: 1.5
    left: 10
    top: -20
    hidden_objects:
      - name
      - virtual_wall
  map_2:
    rotation: 180
    opacity: 0.8

Imatges de fons i de superposició

La targeta admet renderitzar una imatge de fons personalitzada darrere del mapa, cosa especialment útil per a la creació de taulers immersius de plànols 3D. Aquest comportament es configura utilitzant la propietat background_image.

Per millorar encara més l'efecte 3D, també es pot proporcionar un overlay_image opcional. La imatge superposada es dibuixa directament a sobre del camí de neteja del robot i el seu propòsit principal és ocultar visualment els camins que passen darrere de parets o mobles físics al plànol. Es recomana molt combinar tant una imatge de fons com una imatge superposada per aconseguir una sensació realista de profunditat en els taulers 3D.

Dissenyant un Plànol 3D

Quan es creen gràfics personalitzats per a un plànol 3D, el disseny s'ha d'exportar com a dues imatges separades amb fons transparents: una capa base que contingui els pisos i mobles baixos i una capa superior que contingui només les parets superiors.

Les imatges d'exemple següents, mostrades sobre un patró de tauler de dòmino per ressaltar les seves àrees transparents, es van generar utilitzant l'aplicació gratuïta de disseny d'interiors Sweet Home 3D i posteriorment es van processar en un programari d'edició d'imatges estàndard per eliminar les àrees del terra i crear les parts transparents requerides.

Imatge fons

Imatge superposada

background_image i overlay_image admeten les següents propietats per alinear el plànol:

• url: Ruta de la imatge, com ara /local/first_floor_bg.
• opacity: Transparència de la imatge. El valor inicial és 1 i accepta valors fins a 0.

Centratge i escalat d'imatges

Les propietats left, top, width i height per a imatges funcionen utilitzant la mateixa lògica de coordenades relatives que la configuració pròpia Centrat i Escala del mapa. Aquestes propietats són completament opcionals.

Encara que la imatge personalitzada coincideixi perfectament amb la mida del mapa, es recomana molt proporcionar almenys els valors top i left. Això garanteix que si la mida total del mapa canvia en el futur, la imatge personalitzada romangui fermament fixada a la mateixa ubicació relativa.

Valors predeterminats

Quan aquests valors no es proporcionen, la targeta iguala automàticament la mida i el centre de la imatge personalitzada amb les dades del mapa. Aquestes propietats són completament opcionals i existeixen només per anul·lar aquest comportament, evitant que la imatge personalitzada es desplaci o que la seva escala canviï en cas que el mapa s'expandeixi o es redueixi amb el temps.

• left: Defineix el centre horitzontal de la imatge en relació amb el centre del mapa. Per exemple, establir aquest valor a 0 col·loca la coordenada 0 del mapa a l'eix X exactament al centre horitzontal de la imatge. Aquest punt normalment està situat just davant del moll.
• top: Defineix el centre vertical de la imatge en relació amb el centre del mapa. Per exemple, establir aquest valor a 0 col·loca la coordenada 0 del mapa a l'eix Y exactament al centre vertical de la imatge. Aquest punt normalment està situat just davant del moll.
• width: Defineix l'amplada de la imatge en relació amb el sistema de coordenades original i sense escalar del mapa, en lloc de en píxels de pantalla absoluts. Per exemple, establir aquest valor per coincidir amb l'amplada bruta del mapa garanteix que la imatge es redimensioni proporcionalment per cobrir exactament la mateixa àrea horitzontal que les dades del mapa.
• height: Defineix l'altura de la imatge en relació amb el sistema de coordenades original i sense escalar del mapa. Per exemple, establir aquest valor per coincidir amb l'altura bruta del mapa garanteix que la imatge es redimensioni proporcionalment per cobrir exactament la mateixa àrea vertical que les dades del mapa.

Rotació nativa

Les imatges personalitzades no tenen una propietat de rotació independent; la seva rotació està inherentment vinculada a la rotació del mapa. Per assegurar l'alineació a totes les vistes, l'orientació base de la imatge dissenyada ha de coincidir exactament amb l'orientació inicial del mapa quan es configura a 0 graus.

Relació de píxels del dispositiu (DPR)

La targeta mostra el mapa segons la proporció de píxels de la pantalla del dispositiu. Per evitar que les imatges de fons i superposició apareguin borroses en pantalles d'alta resolució com els telèfons mòbils, es recomana molt proporcionar aquestes imatges almenys al doble de la mida requerida a l'escriptori del tauler.

Determinació de la mida de la imatge

Les dades del mapa inclouen una propietat grid_size que indica quants mil·límetres representa un sol píxel al món real. Aquest valor es pot trobar a la secció Informació del Mapa en Temps Real. Per exemple, un grid_size de 50 significa que cada píxel correspon a 50 mm, o 5 cm. Dividint les dimensions del món real de la llar per aquest grid_size, es poden calcular amb precisió els valors exactes de width i height que cal introduir a la configuració, assegurant que una imatge del plànol de planta 1:1 tingui l'escala perfecta amb la mida real de la llar.

Exemple YAML

type: custom:dreame-vacuum-card
entity: vacuum.l10s_gen2

map_config:
  map_1:
    object_scale: 7
    width: 250
    height: 183
    opacity: 0.45
    hidden_objects:
      - customized_cleaning
      - floor
      - name
      - name_background
      - no_go
      - no_mop
      - order
      - walls
    background_image:
      url: /local/home.png
      left: 77
      top: 10.3
      width: 250
      height: 183
      opacity: 0.75
    overlay_image:
      url: /local/home_overlay.png
      opacity: 0.9
  map_2:
    left: 41
    top: -12
    width: 269
    height: 171
    background_image:
      url: /local/second_floor_bg.png