Prilagojena konfiguracija zemljevida

Poravnava, merilo in ozadje slike se lahko neodvisno konfigurirajo za vsako shranjeno karto na napravi.

Te nastavitve lahko konfigurirate v vizualnem urejevalniku tako, da izberete karto s seznama kart ali z uporabo lastnosti map_config v YAML konfiguraciji.

Možnosti konfiguracije kart

Nastavitve znotraj map_config se uporabljajo po indeksu karte z uporabo ključev, kot so map_1, map_2 itd. Katero koli izmed naslednjih možnosti lahko določite za določeno karto:

Opozorilo

Indeksi kart se dodelijo glede na vrstni red ustvarjanja, pri čemer najstarejša karta dobi najnižji indeks, začetek s 1. Vendar, če je funkcija za večnadstropne karte onemogočena na napravi, ki ima več kart in njihove konfiguracije, se trenutno aktivna karta samodejno dodeli indeksa 1. To pomeni, da bo karta, prej konfigurirana pod drugačnim indeksom, nenadoma prevzela konfiguracijo map_1.

• rotation: Prepiše rotacijo, določeno v podatkih zemljevida, za risanje zemljevida z lastno rotacijo, specifično za to karto, pri čemer sprejema vrednosti 0, 90, 180 ali 270.
• scale: Prepiše samodejno izračunano merilo glede na razliko med prvotno velikostjo zemljevida in velikostjo karte, pri čemer sprejema vrednosti med 0.1 in 20.
• object_scale: Prepiše samodejno izračunano velikost predmetov na zemljevidu, kot so ikone sob in ovir, kar omogoča, da se pojavijo večje ali manjše.
• opacity: Globalna preglednost narisanega zemljevida. Začetna vrednost je 1 in sprejema vrednosti do 0.
• object_opacity: Preglednost predmetov, narisanih na zemljevidu, kot so ikone sob ali ovir. Začetna vrednost je 1 in sprejema vrednosti do 0.
• font_size: Velikost pisave za besedne mehurčke, ki se prikazujejo nad aktivirani predmeti. Sprejema vrednosti med 0 in 12.
• hidden_objects: Prepiše skrite predmete na zemljevidu, določene v globalnem Napredna konfiguracija, za ta specifični zemljevid.

Poravnava in merilo

Spodnji parametri se uporabljajo za prepisovanje velikosti in središčnih koordinat, ki jih kartica samodejno izračuna za risanje zemljevida.

Opozorilo

Vrednosti, podane za te parametre, so relativne glede na surove, neskalirane dimenzije zemljevida, ne na absolutne piksle na zaslonu. Ker je ročno izračunavanje teh relativnih koordinat zelo zapleteno, je mogoče natančne potrebne vrednosti pridobiti s pomočjo Informacije o živem zemljevidu razdelka vizualnega urejevalnika.

• left: Prepiše samodejno izračunan horizontalni center zemljevida. Na primer, nastavitev te vrednosti na 0 postavi 0 koordinato zemljevida na X-osi točno v horizontalno središče kartice. Ta točka se običajno nahaja tik pred pristaniščem.
• top: Prepiše samodejno izračunan vertikalni center zemljevida. Na primer, nastavitev te vrednosti na 0 postavi 0 koordinato zemljevida na Y-osi točno v vertikalno središče kartice. Ta točka se običajno nahaja tik pred pristaniščem.
• width: Prepiše dejansko širino zemljevida, uporabljeno za izračun prileganja. Ker karta prilagaja velikost zemljevida glede na največjo dimenzijo, ki se prilega, bo vnos vrednosti, večje od dejanske širine zemljevida, pomanjšal zemljevid znotraj karte, medtem ko bo manjša vrednost zemljevid povečala.
• height: Prepiše dejansko višino zemljevida, uporabljeno za izračun prileganja. Podobno kot lastnost width, bo vnos vrednosti, večje od dejanske višine zemljevida, pomanjšal zemljevid znotraj karte, medtem ko bo manjša vrednost zemljevid povečala.

Primer 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

Ozadje in prekrivne slike

Karta podpira prikaz po meri izbrane ozadne slike za zemljevid, kar je še posebej uporabno za ustvarjanje virtualnih 3D nadstropnih pregledov nadzornih plošč. To vedenje se konfigurira z lastnostjo background_image.

Za dodatno izboljšanje 3D učinka je mogoče zagotoviti tudi dodatni overlay_image. Prekrivna slika se nariše neposredno na pot čiščenja robota, njen glavni namen pa je vizualno zakriti poti, ki potekajo za fizičnimi stenami ali pohištvom v tlorisu. Združevanje tako ozadja kot prekrivne slike je močno priporočljivo za dosego realističnega občutka globine v 3D nadzornih ploščah.

Oblikovanje 3D tlorisa

Pri ustvarjanju prilagojenih grafičnih vsebin za 3D tloris mora biti oblikovanje izvoženo kot dve ločeni sliki s prosojnim ozadjem: osnovna plast, ki vsebuje tla in nizko pohištvo, ter zgornja plast, ki vsebuje samo zgornje stene.

Primer slike spodaj, prikazane na vzorcu šahovnice, da poudarimo njihove prosojne dele, so bile ustvarjene z brezplačno aplikacijo za notranje oblikovanje Sweet Home 3D in nato obdelane v standardni programski opremi za urejanje slik, da so bili odstranjeni talni predeli in ustvarjeni zahtevani prosojni deli.

Slikovno ozadje

Slikovni prekrivnik

background_image in overlay_image podpirata naslednje lastnosti za uskladitev tlorisa:

• url: Pot do slike, kot je /local/first_floor_bg.
• opacity: Prosojnost slike. Začetna vrednost je 1 in sprejema vrednosti do 0.

Centriranje in skaliranje slik

Lastnosti left, top, width in height za slike delujejo z uporabo iste logike relativnih koordinat kot nastavitve Poravnava in merilo same karte. Te lastnosti so popolnoma neobvezne.

Tudi če po meri narejena slika popolnoma ustreza velikosti karte, je močno priporočeno, da se zagotovita vsaj top in left. To zagotavlja, da bo po morebitni spremembi celotne velikosti karte v prihodnosti po meri narejena slika ostala varno pritrjena na enako relativno mesto.

Privzete vrednosti

Ko te vrednosti niso podane, kartica samodejno izenači velikost in središče prilagojene slike z zemljevidom. Te lastnosti so popolnoma neobvezne in obstajajo zgolj za preglasitev tega vedenja, da preprečijo premikanje prilagojene slike ali spreminjanje njene mere v primeru, da se zemljevid sčasoma razširi ali skrči.

• left: Določa horizontalno središče slike v primerjavi s središčem zemljevida. Na primer, nastavitev te vrednosti na 0 postavi 0 koordinato zemljevida na X-osi točno na horizontalno središče slike. Ta točka se običajno nahaja neposredno pred pristaniščem.
• top: Določa vertikalno središče slike v primerjavi s središčem zemljevida. Na primer, nastavitev te vrednosti na 0 postavi 0 koordinato zemljevida na Y-osi točno na vertikalno središče slike. Ta točka se običajno nahaja neposredno pred pristaniščem.
• width: Določa širino slike glede na izvorni, neškalan koordinatni sistem zemljevida, namesto na absolutne piksle zaslona. Na primer, nastavitev te vrednosti, da se ujema z surovo širino zemljevida, zagotavlja, da je slika sorazmerno povečana in pokriva tako horizontalno površino kot podatki zemljevida.
• height: Določa višino slike glede na izvorni, neškalan koordinatni sistem zemljevida. Na primer, nastavitev te vrednosti, da se ujema z surovo višino zemljevida, zagotavlja, da je slika sorazmerno povečana in pokriva tako vertikalno površino kot podatki zemljevida.

Izvorna rotacija

Prilagojene slike nimajo lastne neodvisne lastnosti rotacije; njihova rotacija je inherentno vezana na rotacijo zemljevida. Za zagotovitev usklajenosti v vseh pogledih mora osnovna orientacija zasnovane slike natančno sovpadati z začetno orientacijo zemljevida, ko je nastavljena na 0 stopinj.

Razmerje pikslov naprave (DPR)

Kartica upodablja zemljevid glede na razmerje pikslov zaslona naprave. Da bi preprečili, da bi bile ozadje in prekrivne slike zamegljene na zaslonih z visoko ločljivostjo, kot so mobilni telefoni, je toplo priporočljivo, da te slike zagotovite vsaj v dvakratni velikosti, kot je zahtevano na namizni nadzorni plošči.

Določanje velikosti slike

Podatki zemljevida vključujejo lastnost grid_size, ki označuje, koliko milimetrov predstavlja en piksel v resničnem svetu. To vrednost najdete v razdelku Informacije o živem zemljevidu. Na primer, grid_size vrednosti 50 pomeni, da vsak piksel ustreza 50 mm ali 5 cm. Z deljenjem realnih dimenzij doma s tem grid_size je mogoče natančno izračunati točne vrednosti width in height, ki jih je treba vnesti v konfiguracijo, s čimer zagotovimo, da se slika tlorisa 1:1 popolnoma prilega dejanski velikosti doma.

Primer 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