Prilagođena konfiguracija karte

Poravnanje, skaliranje i pozadinska slika mogu se neovisno konfigurirati za svaku spremljenu kartu na uređaju.

Ove postavke mogu se konfigurirati u vizualnom uređivaču odabirom karte s popisa karata ili korištenjem svojstva map_config u YAML konfiguraciji.

Opcije konfiguracije karte

Postavke unutar map_config primjenjuju se po indeksu karte koristeći ključeve kao što su map_1, map_2 itd. Bilo koja od sljedećih opcija može se definirati pod određenom kartom:

Upozorenje

Indeksi karti dodjeljuju se prema redoslijedu njihovog stvaranja, pri čemu najstarija karta dobiva najniži indeks, počevši od 1. Međutim, ako je značajka višespratne karte onemogućena na uređaju koji ima više karata i njihove konfiguracije, trenutno aktivna karta automatski se dodjeljuje indeksu 1. To znači da će karta prethodno konfigurirana pod drugačijim indeksom iznenada preuzeti konfiguraciju map_1.

• rotation: Prepisuje rotaciju konfiguriranu u podacima karte kako bi se karta nacrtala u prilagođenoj rotaciji specifičnoj za ovu karticu, prihvaćajući vrijednosti 0, 90, 180 ili 270.
• scale: Prepisuje automatski izračunatu skalu na temelju razlike između izvorne veličine karte i veličine kartice, prihvaćajući vrijednosti između 0.1 i 20.
• object_scale: Prepisuje automatski izračunatu veličinu objekata na karti, kao što su ikone soba i prepreka, dopuštajući im da se prikazuju veće ili manje.
• opacity: Globalna prozirnost nacrtane karte. Početna vrijednost je 1 i prihvaća vrijednosti do 0.
• object_opacity: Prozirnost objekata nacrtanih na karti, kao što su ikone soba ili prepreka. Početna vrijednost je 1 i prihvaća vrijednosti do 0.
• font_size: Veličina fonta za tekstualne oblačiće prikazane iznad aktivirani objekti. Prihvaća vrijednosti između 0 i 12.
• hidden_objects: Prepisuje skrivene objekte karte definirane u globalnom Napredna konfiguracija za ovu specifičnu kartu.

Centriranje i skaliranje

Parametri u nastavku koriste se za prepisivanje veličine i koordinata centra koje kartica automatski izračunava za crtanje karte.

Upozorenje

Vrijednosti navedene za ove parametre relativne su u odnosu na sirove, neskalirane dimenzije karte, a ne na apsolutne piksele na ekranu. Budući da je ručno računanje ovih relativnih koordinata vrlo složeno, točne vrijednosti koje su potrebne mogu se izdvojiti pomoću odjeljka Informacije o Live Mapu vizualnog uređivača.

• left: Prepisuje automatski izračunati horizontalni centar karte. Na primjer, postavljanje ove vrijednosti na 0 postavlja 0 koordinatu karte na X-osi točno u horizontalni centar kartice. Točka se obično nalazi neposredno ispred pristaništa.
• top: Prepisuje automatski izračunati vertikalni centar karte. Na primjer, postavljanje ove vrijednosti na 0 postavlja 0 koordinatu karte na Y-osi točno u vertikalni centar kartice. Točka se obično nalazi neposredno ispred pristaništa.
• width: Prekida stvarnu širinu karte koja se koristi za izračun prilagodbe. Budući da karta skalira kartu na temelju najveće dimenzije koja stane, unos vrijednosti veće od stvarne širine karte će smanjiti kartu unutar kartice, dok manja vrijednost će je povećati.
• height: Prekida stvarnu visinu karte koja se koristi za izračun prilagodbe. Slično svojstvu width, unos vrijednosti veće od stvarne visine karte će smanjiti kartu unutar kartice, dok manja vrijednost će je povećati.

Primjer YAML-a

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

Pozadinske i slojevite slike

Kartica podržava prikaz prilagođene pozadinske slike iza karte, što je posebno korisno za stvaranje impresivnih 3D nadzorne ploče tlocrta. Ovo ponašanje se konfigurira pomoću svojstva background_image.

Kako bi se dodatno poboljšao 3D efekt, može se također pružiti opcionalni overlay_image. Slika sloja (overlay) crta se izravno preko puta čišćenja robota, a njezina je glavna svrha vizualno zakloniti putove koji prolaze iza fizičkih zidova ili namještaja u tlocrtu. Kombiniranje i pozadinske i slojevite slike toplo se preporučuje za postizanje realističnog dojma dubine u 3D nadzornim pločama.

Dizajniranje 3D tlocrta

Prilikom izrade prilagođene grafike za 3D tlocrt, dizajn se mora izvesti kao dvije odvojene slike s prozirnim pozadinama: osnovni sloj koji sadrži podove i niski namještaj te gornji sloj koji sadrži samo gornje zidove.

Primjerni prikazi ispod, prikazani preko uzorka šahovnice kako bi se istaknula njihova prozirna područja, generirani su pomoću besplatne aplikacije za dizajn interijera Sweet Home 3D, a zatim obrađeni u standardnom softveru za uređivanje slika kako bi se uklonila područja poda i stvorili potrebni prozirni dijelovi.

Slika pozadine

Slika preko (Overlay)

background_image i overlay_image podržavaju sljedeća svojstva za poravnavanje tlocrta:

• url: Put slike, kao što je /local/first_floor_bg.
• opacity: Prozirnost slike. Početna vrijednost je 1 i prihvaća vrijednosti do 0.

Centriranje i skaliranje slika

Svojstva left, top, width i height za slike funkcioniraju koristeći potpuno istu logiku relativnih koordinata kao i konfiguracija Centriranje i skaliranje same karte. Ova svojstva su potpuno opcionalna.

Čak i ako slika po mjeri savršeno odgovara veličini karte, toplo se preporučuje pružiti barem vrijednosti top i left. To osigurava da, ako se ukupna veličina karte u budućnosti promijeni, slika po mjeri ostane sigurno postavljena na istom relativnom mjestu.

Zadane vrijednosti

Kada ove vrijednosti nisu navedene, kartica automatski izjednačava veličinu i centar prilagođene slike s podacima karte. Ova svojstva su potpuno opcionalna i postoje isključivo kako bi nadjačala ovo ponašanje, sprječavajući pomicanje prilagođene slike ili promjenu njezine skale u slučaju da se karta s vremenom proširi ili smanji.

• left: Definira horizontalni centar slike u odnosu na centar karte. Na primjer, postavljanje ove vrijednosti na 0 postavlja 0 koordinatu karte na X-osi točno u horizontalni centar slike. Ova točka se obično nalazi upravo ispred pristaništa.
• top: Definira vertikalni centar slike u odnosu na centar karte. Na primjer, postavljanje ove vrijednosti na 0 postavlja 0 koordinatu karte na Y-osi točno u vertikalni centar slike. Ova točka se obično nalazi upravo ispred pristaništa.
• width: Definira širinu slike u odnosu na izvorni, neškaliirani koordinatni sustav karte, umjesto relativno prema apsolutnim pikselima zaslona. Na primjer, postavljanje ove vrijednosti tako da odgovara sirovoj širini karte osigurava da je slika proporcionalno skalirana kako bi pokrivala točno istu horizontalnu površinu kao podaci karte.
• height: Definira visinu slike u odnosu na izvorni, neškaliirani koordinatni sustav karte. Na primjer, postavljanje ove vrijednosti tako da odgovara sirovoj visini karte osigurava da je slika proporcionalno skalirana kako bi pokrivala točno istu vertikalnu površinu kao podaci karte.

Izvorna rotacija

Prilagođene slike nemaju svoj vlastiti neovisni svojstvo rotacije; njihova je rotacija inherentno vezana uz rotaciju karte. Kako bi se osigurala usklađenost u svim prikazima, osnovna orijentacija dizajnirane slike mora točno odgovarati početnoj orijentaciji karte kada je postavljena na 0 stupnjeva.

Omjer piksela uređaja (DPR)

Kartica prikazuje kartu prema omjeru piksela zaslona uređaja. Kako bi se spriječilo da pozadinske i prekrivne slike izgledaju mutno na zaslonima visoke razlučivosti, poput mobitela, toplo se preporučuje da se te slike pruže u najmanje dvostruko većoj veličini od potrebne na desktop nadzornoj ploči.

Određivanje veličine slike

Podaci karte uključuju grid_size svojstvo koje pokazuje koliko milimetara odgovara jednom pikselu u stvarnom svijetu. Ova vrijednost može se pronaći u odjeljku Informacije o Live Mapu. Na primjer, grid_size od 50 znači da svaki piksel odgovara 50 mm ili 5 cm. Dijeljenjem dimenzija kuće u stvarnom svijetu s ovom grid_size, točne width i height vrijednosti koje je potrebno unijeti u konfiguraciju mogu se točno izračunati, osiguravajući da se slika tlocrta u razmjeru 1:1 savršeno podudara sa stvarnom veličinom kuće.

Primjer YAML-a

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