Mukautetun kartan asetukset

Tasasuuntaus, skaala ja taustakuva voidaan määrittää erikseen jokaiselle laitteeseen tallennetulle kartalle.

Näitä asetuksia voidaan muokata visuaalisessa editorissa valitsemalla kartta karttaluettelosta tai käyttämällä YAML-konfiguraatiossa map_config-ominaisuutta.

Kartan asetusten vaihtoehdot

map_config-sisäiset asetukset sovelletaan karttaindeksikohtaisesti käyttämällä avaimia, kuten map_1, map_2 jne. Joku seuraavista vaihtoehdoista voidaan määritellä tietyn kartan alle:

Varoitus

Karttaindeksit annetaan niiden luontijärjestyksen perusteella, ja vanhin kartta saa matalimman indeksin, alkaen 1:stä. Jos kuitenkin monikerroksinen kartta -ominaisuus on poistettu käytöstä laitteessa, jolla on useita karttoja ja niiden määritykset, aktiivinen kartta asetetaan automaattisesti indeksiksi 1. Tämä tarkoittaa, että aiemmin eri indeksin alla määritetty kartta ottaa äkillisesti käyttöön muiden määritykset map_1.

• rotation: Ohittaa karttatiedoissa määritetyn kierron ja piirtää kartan tässä kortissa käytettävässä mukautetussa kierrossa, jolloin hyväksytään arvot 0, 90, 180 tai 270.
• scale: Ohittaa automaattisen mittakaavan laskennan, joka perustuu kartan alkuperäisen koon ja kortin koon eroon, hyväksyen arvot välillä 0.1 ja 20.
• object_scale: Ohittaa automaattisesti lasketun karttaobjektien koon, kuten huone- ja esteikoneiden, sallien niiden näkyä isompina tai pienempinä.
• opacity: Piirretyn kartan globaali läpinäkyvyys. Alkuarvo on 1 ja hyväksyy arvot alkaen 0.
• object_opacity: Kartalle piirrettyjen objektien, kuten huone- tai esteikoneiden, läpinäkyvyys. Alkuarvo on 1 ja hyväksyy arvot alkaen 0.
• font_size: Tekstikuplien fonttikoko, joka näytetään aktivoidut objektit päällä. Hyväksyy arvot välillä 0 ja 12.
• hidden_objects: Ohittaa globaalissa Kehittynyt konfigurointi määritellyt piilotetut karttaobjektit tätä tiettyä karttaa varten.

Keskitys ja skaalaus

Alla olevia parametreja käytetään ylikirjoittamaan kortin automaattisesti laskemat koon ja keskikoordinaatit kartan piirtämistä varten.

Varoitus

Näille parametreille annettavat arvot ovat suhteellisia kartan raaka-, skaalaamattomiin mittoihin, eivät absoluuttisiin pikseleihin näytöllä. Koska näiden suhteellisten koordinaattien manuaalinen laskeminen on erittäin monimutkaista, tarvittavat tarkat arvot voidaan poimia visuaalisen editorin Live-karttatiedot -osiosta.

• left: Ylikirjoittaa kartan automaattisesti lasketun vaakakeskuksen. Esimerkiksi asettamalla tämän arvon 0 kartan 0-koordinaatti X-akselilla sijoittuu täsmälleen kortin vaakakeskukseen. Tämä piste sijaitsee tyypillisesti aivan laiturin edessä.
• top: Ylikirjoittaa kartan automaattisesti lasketun pystykeskuksen. Esimerkiksi asettamalla tämän arvon 0 kartan 0-koordinaatti Y-akselilla sijoittuu täsmälleen kortin pystykeskukseen. Tämä piste sijaitsee tyypillisesti aivan laiturin edessä.
• width: Ohittaa kartan todellisen leveyden, jota käytetään sovituslaskennassa. Koska kortti skaalauttaa karttaa suurimman sopivan mitan perusteella, suuremman arvon syöttäminen kuin kartan todellinen leveys pienentää karttaa kortin sisällä, kun taas pienempi arvo suurentaa sitä.
• height: Ohittaa kartan todellisen korkeuden, jota käytetään sovituslaskennassa. Samoin kuin width-ominaisuus, suuremman arvon syöttäminen kuin kartan todellinen korkeus pienentää karttaa kortin sisällä, kun taas pienempi arvo suurentaa sitä.

YAML-esimerkki

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

Tausta- ja päällekkäiskuvat

Kortti tukee mukautetun taustakuvan renderöintiä kartan taakse, mikä on erityisen hyödyllistä immersiivisten 3D-pohjapiirroskoontinäyttöjen luomisessa. Tämä käyttäytyminen määritetään background_image-ominaisuutta käyttämällä.

Kolmiulotteisen vaikutelman parantamiseksi voidaan tarjota myös valinnainen overlay_image. Päällekkäiskuva piirretään suoraan robotin puhtaan kulkureitin päälle, ja sen ensisijainen tarkoitus on visuaalisesti peittää polkuja, jotka kulkevat fyysisten seinien tai huonekalujen takana pohjapiirroksessa. Sekä tausta- että päällekkäiskuvan yhdistäminen on erittäin suositeltavaa, jotta 3D-hallintapaneeleihin saadaan realistinen syvyysvaikutelma.

3D-pohjapiirroksen suunnittelu

Kun luodaan mukautettuja grafiikoita 3D-pohjapiirrokselle, suunnittelu on vietävä kahtena erillisenä kuvana läpinäkyvän taustan kanssa: pohjakerros, joka sisältää lattiat ja matalat huonekalut, ja yläkerros, joka sisältää vain yläseiniä.

Alla olevat esimerkkikuvat, jotka on esitetty ruudutetun kuvion päällä korostamaan niiden läpinäkyviä alueita, on luotu ilmaisella sisustussuunnitteluohjelmalla Sweet Home 3D ja käsitelty sen jälkeen tavallisessa kuvankäsittelyohjelmistossa lattia-alueiden poistamiseksi ja tarvittavien läpinäkyvien osien luomiseksi.

Taustakuva

Peittokuva

background_image ja overlay_image tukevat seuraavia ominaisuuksia pohjapiirroksen kohdistamiseksi:

• url: Kuvan polku, esimerkiksi /local/first_floor_bg.
• opacity: Kuvan läpinäkyvyys. Alkuarvo on 1 ja se hyväksyy arvot aina 0:een saakka.

Kuvien keskittäminen ja skaalaaminen

left, top, width ja height -ominaisuudet kuville toimivat aivan samalla suhteellisten koordinaattien logiikalla kuin kartan oma Keskitys ja skaalaus -asetuksen konfiguraatio. Nämä ominaisuudet ovat täysin valinnaisia.

Vaikka mukautettu kuva sopisi täydellisesti kartan kokoon, on erittäin suositeltavaa antaa vähintään top ja left arvot. Tämä varmistaa, että jos kartan kokonaiskoko muuttuu tulevaisuudessa, mukautettu kuva pysyy turvallisesti kiinni samassa suhteellisessa sijainnissa.

Oletusarvot

Kun näitä arvoja ei ole annettu, kortti tasaa automaattisesti mukautetun kuvan koon ja keskittää sen karttatietojen mukaan. Nämä ominaisuudet ovat täysin valinnaisia ja ovat olemassa ainoastaan tämän käyttäytymisen ohittamiseksi, estäen mukautetun kuvan siirtymisen tai mittasuhteiden muuttumisen, jos kartta laajenee tai kutistuu ajan myötä.

• left: Määrittää kuvan vaakakeskuksen suhteessa kartan keskukseen. Esimerkiksi asettamalla tämä arvo 0, kartan 0-koordinaatti X-akselilla sijoittuu täsmälleen kuvan vaakakeskukseen. Tämä piste sijaitsee tyypillisesti suoraan laiturin edessä.
• top: Määrittää kuvan pystykeskuksen suhteessa kartan keskukseen. Esimerkiksi asettamalla tämä arvo 0, kartan 0-koordinaatti Y-akselilla sijoittuu täsmälleen kuvan pystykeskukseen. Tämä piste sijaitsee tyypillisesti suoraan laiturin edessä.
• width: Määrittää kuvan leveyden suhteessa kartan alkuperäiseen, skaalaamattomaan koordinaatistoon, ei absoluuttisiin näytön pikseleihin. Esimerkiksi asettamalla tämä arvo vastaamaan kartan raakaleveyttä varmistetaan, että kuva skaalautuu suhteessa peittämään täsmälleen saman vaakasuoran alueen kuin karttatiedot.
• height: Määrittää kuvan korkeuden suhteessa kartan alkuperäiseen, skaalaamattomaan koordinaatistoon. Esimerkiksi asettamalla tämä arvo vastaamaan kartan raakahöyhtä varmistetaan, että kuva skaalautuu suhteessa peittämään täsmälleen saman pystysuoran alueen kuin karttatiedot.

Alkukierto

Mukautetuilla kuvilla ei ole omaa itsenäistä kierto-ominaisuutta; niiden kierto on olennaisesti sidottu kartan kiertoon. Varmistaaksesi yhdenmukaisuuden kaikissa näkymissä, suunnitellun kuvan perusorientaation on täsmälleen vastattava kartan alkuperäistä orientaatiota, kun se on asetettu 0 asteeseen.

Laitteen pikselisuhde (DPR)

Kortti renderöi kartan laitteen näytön pikselisuhteen mukaan. Jotta tausta- ja päällekkäiskuvat eivät näyttäisi sumeilta korkearesoluutioisilla näytöillä, kuten matkapuhelimilla, on erittäin suositeltavaa tarjota nämä kuvat vähintään kaksinkertaisina työpöydän kojelaudassa vaadittuun kokoon nähden.

Kuvan koon

määrittäminen Karttatiedot sisältävät grid_size ominaisuuden, joka kertoo, kuinka monta millimetriä yksittäinen pikseli edustaa todellisessa maailmassa. Tämä arvo löytyy Live-karttatiedot-osiosta. Esimerkiksi grid_size 50 tarkoittaa, että jokainen pikseli vastaa 50 mm eli 5 cm. Jakamalla kodin todelliset mitat tällä grid_size, tarkat width ja height arvot voidaan laskea tarkasti, jolloin 1:1 pohjapiirroskuva skaalautuu täydellisesti kodin todellisen koon kanssa.

YAML-esimerkki

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