Skip to content

Egyéni térkép konfiguráció ​

Az igazítás, a méretarány és a háttérkép minden mentett térképen a készüléken függetlenül konfigurálható.

Ezek a beállítások a vizuális szerkesztőben konfigurálhatók a térképlistából történő térkép kiválasztásával, vagy a map_config tulajdonság használatával a YAML konfigurációban.

Térkép konfigTérkép konfigTérkép konfig

Térkép Konfigurációs Opciók ​

A map_config belső beállításai térképenkénti index szerint alkalmazhatók olyan kulcsokkal, mint map_1, map_2, stb. Bármelyik alábbi opció meghatározható egy adott térképhez:

Figyelmeztetés

A térképi indexeket létrehozási sorrendjük alapján rendelik, a legrégebbi térkép kapja a legalacsonyabb indexet, 1-től kezdve. Ha azonban a többemeletes térkép funkció ki van kapcsolva olyan készüléken, amelyen több térkép és azok konfigurációi találhatók, az aktuálisan aktív térkép automatikusan az 1-es indexhez lesz rendelve. Ez azt jelenti, hogy egy korábban más index alatt konfigurált térkép hirtelen a következő konfigurációt fogja átvállalni map_1.

  • rotation: Felülírja a térképadatokban beállított elforgatást, hogy a térképet ezen a kártyán egyedi elforgatással rajzolja ki, 0, 90, 180 vagy 270 értékeket elfogadva.
  • scale: Felülírja az automatikus méretarány számítást a térkép eredeti mérete és a kártya mérete közötti különbség alapján, 0.1 és 20 közötti értékeket elfogadva.
  • object_scale: Felülírja a térképi objektumok, például a szoba- és akadályikonok automatikusan számított méretét, lehetővé téve, hogy nagyobbak vagy kisebbek legyenek.
  • opacity: A rajzolt térkép globális átlátszósága. A kezdeti érték 1 és 0-ig terjedő értékeket fogad.
  • object_opacity: A térképen rajzolt objektumok, például szoba- vagy akadályikonok átlátszósága. A kezdeti érték 1 és 0-ig terjedő értékeket fogad.
  • font_size: A aktivált objektumok fölött megjelenő szövegbuborékok betűmérete. 0 és 12 közötti értékeket fogad.
  • hidden_objects: Felülírja az ezen a specifikus térképen a globális Haladó konfiguráció-ban meghatározott rejtett térképi objektumokat.

Központosítás és méretezés ​

Az alábbi paramétereket a kártya által automatikusan kiszámított térképméret és középpont koordinátáinak felülírására használják.

Figyelmeztetés

E paraméterekhez megadott értékek a térkép nyers, méretezés nélküli dimenzióihoz viszonyítottak, nem a képernyőn lévő abszolút pixelekhez. Mivel ezen relatív koordináták kézi kiszámítása rendkívül bonyolult, a szükséges pontos értékek a vizuális szerkesztő Élő Térkép Információ szakaszából nyerhetők ki.

  • left: Felülírja a térkép automatikusan kiszámított vízszintes középpontját. Például, ha ezt az értéket 0-re állítja, a térkép 0 koordinátája az X tengelyen pontosan a kártya vízszintes közepén lesz. Ez a pont általában közvetlenül a dokk előtt található.
  • top: Felülírja a térkép automatikusan kiszámított függőleges középpontját. Például, ha ezt az értéket 0-re állítja, a térkép 0 koordinátája az Y tengelyen pontosan a kártya függőleges közepén lesz. Ez a pont általában közvetlenül a dokk előtt található.
  • width: Felülírja a térkép tényleges szélességét, amelyet az illesztési számításhoz használnak. Mivel a kártya a térképet a legnagyobb illeszkedő dimenzió alapján méretezi, egy a térkép tényleges szélességénél nagyobb érték beírása a térképet a kártyán belül összezsugorítja, míg egy kisebb érték megnagyobbítja azt.
  • height: Felülírja a térkép tényleges magasságát, amelyet az illesztési számításhoz használnak. Hasonlóan a width tulajdonsághoz, egy a térkép tényleges magasságánál nagyobb érték beírása a térképet a kártyán belül összezsugorítja, míg egy kisebb érték megnagyobbítja azt.

YAML példa ​

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

Háttér- és réteges képek ​

A kártya támogatja egyéni háttérkép megjelenítését a térkép mögött, ami különösen hasznos lenyűgöző 3D-s alaprajz irányítópultok létrehozásához. Ez a viselkedés a background_image tulajdonság használatával konfigurálható.

Térkép konfiguráció háttérképTérkép konfiguráció háttérkép

A 3D hatás további fokozása érdekében opcionálisan egy overlay_image is biztosítható. A felülre helyezett kép közvetlenül a robot tisztítási útvonala fölé kerül rajzolásra, és elsődleges célja, hogy vizuálisan elfedje azokat az útvonalakat, amelyek fizikai falak vagy bútorok mögött haladnak a padlóterven. Mind háttérképet, mind felülre helyezett képet kombinálni erősen ajánlott a valósághű 3D mélység érzet eléréséhez a műszerfalakon.

Háttérkép FőoldalHáttérkép Főoldal
Háttérkép TérképekHáttérkép Térképek
Háttérkép Mentett térképHáttérkép Mentett térkép

3D padlóterv tervezése

Amikor egyedi grafikát hoz létre egy 3D padlótervhez, a tervet két különálló, átlátszó háttérrel rendelkező képként kell exportálni: egy alapréteg, amely a padlót és az alacsony bútorokat tartalmazza, illetve egy felső réteg, amely csak a felső falakat tartalmazza.

Az alábbi példa képeket sakktábla mintázatra helyezve, hogy kiemeljük átlátszó részeiket, az ingyenes belsőépítészeti alkalmazás, a Sweet Home 3D segítségével hozták létre, majd szabványos képszerkesztő szoftverben dolgozták fel, hogy eltávolítsák a padlórészeket és létrehozzák a szükséges átlátszó részeket.

HáttérképHáttérkép
Háttérkép
Rátét képRátét kép
Rátét kép

A background_image és overlay_image az alábbi tulajdonságokat támogatják a padlóterv igazításához:

  • url: A kép útvonala, például /local/first_floor_bg.
  • opacity: A kép átlátszósága. A kezdeti érték 1, és értékek elfogadására alkalmas egészen 0-ig.

Képek középre igazítása és méretezése ​

A képekhez tartozó left, top, width és height tulajdonságok ugyanazt a relatív koordináta logikát használják, mint a térkép saját Központosítás és méretezés konfigurációja. Ezek a tulajdonságok teljesen opcionálisak.

Még akkor is, ha a testreszabott kép tökéletesen illeszkedik a térkép méretéhez, erősen ajánlott legalább top és left értékek megadása. Ez biztosítja, hogy ha a térkép teljes mérete a jövőben megváltozik, a testreszabott kép ugyanahhoz a relatív helyhez rögzített maradjon.

Alapértelmezett értékek

Ha ezeket az értékeket nem adják meg, a kártya automatikusan kiegyenlíti a méretet és a testreszabott kép közepét a térképadatokkal. Ezek a tulajdonságok teljesen opcionálisak, és kizárólag arra szolgálnak, hogy felülírják ezt a viselkedést, megakadályozva a testreszabott kép elmozdulását vagy méretének változását abban az esetben, ha a térkép idővel kibővül vagy összezsugorodik.

  • left: Meghatározza a kép vízszintes közepét a térkép közepéhez képest. Például, ha ezt az értéket 0-re állítjuk, a térkép 0 koordinátája az X-tengelyen pontosan a kép vízszintes közepén lesz. Ez a pont általában közvetlenül a dokk előtt található.
  • top: Meghatározza a kép függőleges közepét a térkép közepéhez képest. Például, ha ezt az értéket 0-re állítjuk, a térkép 0 koordinátája az Y-tengelyen pontosan a kép függőleges közepén lesz. Ez a pont általában közvetlenül a dokk előtt található.
  • width: Meghatározza a kép szélességét a térkép eredeti, nem skálázott koordinátarendszeréhez viszonyítva, nem pedig abszolút képernyőképpixelekben. Például, ha ezt az értéket a térkép nyers szélességéhez állítjuk, a kép arányosan lesz skálázva, hogy pontosan lefedje ugyanazt a vízszintes területet, mint a térképadatok.
  • height: Meghatározza a kép magasságát a térkép eredeti, nem skálázott koordinátarendszeréhez viszonyítva. Például, ha ezt az értéket a térkép nyers magasságához állítjuk, a kép arányosan lesz skálázva, hogy pontosan lefedje ugyanazt a függőleges területet, mint a térképadatok.

Alap forgatás

A saját képeknek nincs önálló forgatási tulajdonságuk; forgatásuk szorosan kapcsolódik a térkép forgatásához. Annak érdekében, hogy minden nézet összehangolt legyen, a tervezett kép alapirányának pontosan meg kell egyeznie a térkép kezdeti orientációjával, amikor 0 fokra van állítva.

Eszközképpickal ratio (DPR)

A kártya a térképet a készülék képernyőjének pixelarányához igazítva jeleníti meg. Annak érdekében, hogy a háttér- és réteges képek ne jelenjenek homályosan nagy felbontású kijelzőkön, például mobiltelefonokon, erősen javasolt, hogy ezeket a képeket legalább kétszeres méretben biztosítsuk az asztali vezérlőpanelen.

Kép méretének meghatározása

A térképadatok tartalmaznak egy grid_size tulajdonságot, amely megmutatja, hogy a valóságban egy pixel hány millimétert képvisel. Ez az érték megtalálható a Élő Térkép Információ szakaszban. Például egy grid_size érték 50 azt jelenti, hogy minden pixel 50 mm-nek, vagyis 5 cm-nek felel meg. A ház valós méreteinek elosztásával ezzel a grid_size-tal a konfigurációban megadandó pontos width és height értékek pontosan kiszámíthatók, biztosítva, hogy az 1:1 méretarányú alaprajz tökéletesen arányos legyen a ház valós méretével.

YAML példa ​

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