Configurare Harta Personalizată

Alinierea, scara și imaginea de fundal pot fi configurate independent pentru fiecare hartă salvată pe dispozitiv.

Aceste setări pot fi configurate în editorul vizual selectând o hartă din lista de hărți sau folosind proprietatea map_config în configurația YAML.

Opțiuni de configurare a hărții

Setările din interiorul map_config se aplică pentru fiecare index al hărții folosind chei precum map_1, map_2 etc. Oricare dintre următoarele opțiuni pot fi definite sub o hartă specifică:

Avertisment

Indicii hărților sunt atribuiți pe baza ordinii lor de creare, harta cea mai veche primind cel mai mic index, începând de la 1. Totuși, dacă funcția de hartă pe mai multe etaje este dezactivată pe un dispozitiv care are mai multe hărți și configurațiile lor, harta activă în prezent este automat reasignată la indexul 1. Aceasta înseamnă că o hartă configurată anterior sub un index diferit va adopta brusc configurația map_1.

• rotation: Suprascrie rotația configurată în datele hărții pentru a desena harta într-o rotație personalizată specifică acestei cărți, acceptând valorile 0, 90, 180 sau 270.
• scale: Suprascrie calculul automat al scalei bazat pe diferența dintre dimensiunea originală a hărții și dimensiunea cărții, acceptând valori între 0.1 și 20.
• object_scale: Suprascrie dimensiunea obiectelor de pe hartă calculată automat, cum ar fi pictogramele camerelor și obstacolelor, permițându-le să apară mai mari sau mai mici.
• opacity: Transparența globală a hărții desenate. Valoarea inițială este 1 și acceptă valori până la 0.
• object_opacity: Transparența obiectelor desenate pe hartă, cum ar fi pictogramele camerelor sau obstacolelor. Valoarea inițială este 1 și acceptă valori până la 0.
• font_size: Dimensiunea fontului pentru baloanele de text afișate peste obiecte activate. Acceptă valori între 0 și 12.
• hidden_objects: Suprascrie obiectele ascunse de pe hartă definite în Configurare avansată global pentru această hartă specifică.

Centrare și Scalare

Parametrii de mai jos sunt utilizați pentru a înlocui dimensiunea și coordonatele centrului pe care cardul le calculează automat pentru a desena harta.

Avertisment

Valorile furnizate pentru acești parametri sunt relative la dimensiunile brute, ne-scalate ale hărții, nu la pixelii absoluți de pe ecran. Deoarece calcularea acestor coordonate relative manual este foarte complexă, valorile exacte necesare pot fi extrase folosind secțiunea Informații despre Harta Live a editorului vizual.

• left: Suprascrie centrul orizontal al hărții calculat automat. De exemplu, setarea acestei valori la 0 plasează coordonata 0 a hărții pe axa X exact în centrul orizontal al cardului. Acest punct se află de obicei chiar în fața docului.
• top: Suprascrie centrul vertical al hărții calculat automat. De exemplu, setarea acestei valori la 0 plasează coordonata 0 a hărții pe axa Y exact în centrul vertical al cardului. Acest punct se află de obicei chiar în fața docului.
• width: Suprascrie lățimea reală a hărții utilizată pentru calculul ajustării. Deoarece cardul redimensionează harta în funcție de cea mai mare dimensiune care se potrivește, introducerea unei valori mai mari decât lățimea reală a hărții va micșora harta în interiorul cardului, în timp ce o valoare mai mică o va mări.
• height: Suprascrie înălțimea reală a hărții utilizată pentru calculul ajustării. Similar cu proprietatea width, introducerea unei valori mai mari decât înălțimea reală a hărții va micșora harta în interiorul cardului, în timp ce o valoare mai mică o va mări.

Exemplu 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

Imagini de fundal și suprapunere

Cardul suportă redarea unei imagini de fundal personalizate în spatele hărții, ceea ce este deosebit de util pentru crearea de tablouri de bord 3D pentru planuri de etaj imersive. Acest comportament este configurat folosind proprietatea background_image.

Pentru a spori efectul 3D, poate fi furnizat, de asemenea, un overlay_image opțional. Imaginea suprapusă este desenată direct deasupra traseului de curățare al robotului, iar scopul său principal este de a ascunde vizual traseele care trec în spatele pereților sau mobilei din planul casei. Combinarea atât a unei imagini de fundal, cât și a unei imagini suprapuse este foarte recomandată pentru a obține un sentiment realist de adâncime în tablourile de bord 3D.

Proiectarea unui Plan de Etaj 3D

Când creați grafică personalizată pentru un plan de etaj 3D, designul trebuie exportat ca două imagini separate cu fundal transparent: un strat de bază care conține podelele și mobilierul inferior și un strat superior care conține doar pereții superiori.

Imaginile de exemplu de mai jos, afișate peste un model de tablă de șah pentru a evidenția zonele lor transparente, au fost generate folosind aplicația gratuită de design interior Sweet Home 3D și ulterior procesate în software standard de editare a imaginilor pentru a elimina zonele de pardoseală și a crea părțile transparente necesare.

Imagine fundal

Imagine suprapusă

background_image și overlay_image suportă următoarele proprietăți pentru alinierea planului de pardoseală:

• url: Calea imaginii, cum ar fi /local/first_floor_bg.
• opacity: Transparența imaginii. Valoarea inițială este 1 și acceptă valori până la 0.

Centrarea și redimensionarea imaginilor

Proprietățile left, top, width și height pentru imagini funcționează folosind exact aceeași logică de coordonate relative ca și configurația Centrare și Scalare a hărții. Aceste proprietăți sunt complet opționale.

Chiar dacă imaginea personalizată se potrivește perfect cu dimensiunea hărții, este foarte recomandat să furnizați cel puțin valorile top și left. Acest lucru asigură că, în cazul în care dimensiunea totală a hărții se schimbă în viitor, imaginea personalizată rămâne fixată în siguranță în aceeași locație relativă.

Valori implicite

Când aceste valori nu sunt furnizate, cardul egalizează automat dimensiunea și centrul imaginii personalizate cu datele hărții. Aceste proprietăți sunt complet opționale și există exclusiv pentru a suprascrie acest comportament, prevenind deplasarea imaginii personalizate sau schimbarea scalei acesteia în cazul în care harta se extinde sau se micșorează în timp.

• left: Definește centrul orizontal al imaginii relativ la centrul hărții. De exemplu, setarea acestei valori la 0 plasează coordonata 0 a hărții pe axa X exact în centrul orizontal al imaginii. Acest punct se află de obicei chiar în fața docului.
• top: Definește centrul vertical al imaginii relativ la centrul hărții. De exemplu, setarea acestei valori la 0 plasează coordonata 0 a hărții pe axa Y exact în centrul vertical al imaginii. Acest punct se află de obicei chiar în fața docului.
• width: Definește lățimea imaginii în raport cu sistemul de coordonate original, nescalesat, al hărții, mai degrabă decât în pixeli absoluți de pe ecran. De exemplu, setarea acestei valori astfel încât să corespundă lățimii brute a hărții asigură scalarea proporțională a imaginii pentru a acoperi exact aceeași zonă orizontală ca datele hărții.
• height: Definește înălțimea imaginii în raport cu sistemul de coordonate original, nescalesat, al hărții. De exemplu, setarea acestei valori astfel încât să corespundă înălțimii brute a hărții asigură scalarea proporțională a imaginii pentru a acoperi exact aceeași zonă verticală ca datele hărții.

Rotire Nativă

Imaginile personalizate nu au o proprietate de rotație independentă; rotația lor este inerent legată de rotația hărții. Pentru a asigura alinierea în toate vizualizările, orientarea de bază a imaginii proiectate trebuie să corespundă exact orientării inițiale a hărții când este setată la 0 grade.

Raport de pixeli al dispozitivului (DPR)

Cardul redă harta conform raportului de pixeli al ecranului dispozitivului. Pentru a preveni ca imaginile de fundal și suprapunere să apară neclare pe afișaje de înaltă rezoluție, precum telefoanele mobile, se recomandă foarte mult furnizarea acestor imagini la cel puțin dublul dimensiunii necesare pe tabloul de bord pentru desktop.

Determinarea dimensiunii imaginii

Datele hărții includ o proprietate grid_size care indică câți milimetri reprezintă un singur pixel în lumea reală. Această valoare poate fi găsită în secțiunea Informații despre Harta Live. De exemplu, un grid_size de 50 înseamnă că fiecare pixel corespunde la 50 mm, sau 5 cm. Prin împărțirea dimensiunilor reale ale casei la acest grid_size, valorile exacte width și height de introdus în configurație pot fi calculate cu precizie, asigurând că o imagine a planului etajului la scară 1:1 se potrivește perfect cu dimensiunea reală a casei.

Exemplu 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