Vlastná konfigurácia mapy

Zarovnanie, mierka a pozadie obrázka môžu byť nakonfigurované samostatne pre každú uloženú mapu na zariadení.

Tieto nastavenia je možné upraviť vo vizuálnom editore výberom mapy zo zoznamu máp alebo použitím vlastnosti map_config v konfigurácii YAML.

Možnosti konfigurácie mapy

Nastavenia vo map_config sa aplikujú podľa indexu mapy pomocou kľúčov ako map_1, map_2 atď. Ktorákoľvek z nasledujúcich možností môže byť definovaná pre konkrétnu mapu:

Upozornenie

Indexy máp sú priradené podľa poradia ich vytvorenia, pričom najstaršia mapa dostane najnižší index, začínajúc od 1. Ak je však funkcia viacposchodovej mapy na zariadení, ktoré má viac máp a ich konfigurácií, vypnutá, aktuálne aktívna mapa sa automaticky priradí na index 1. To znamená, že mapa predtým nakonfigurovaná pod iným indexom náhle prevezme konfiguráciu map_1.

• rotation: Prepíše rotáciu nastavenú v údajoch mapy, aby sa mapa vykreslila v vlastnej rotácii špecifickej pre túto kartu, pričom akceptuje hodnoty 0, 90, 180 alebo 270.
• scale: Prepíše automatický výpočet mierky založený na rozdiele medzi pôvodnou veľkosťou mapy a veľkosťou karty, pričom akceptuje hodnoty medzi 0.1 a 20.
• object_scale: Prepíše automaticky vypočítanú veľkosť objektov na mape, ako sú ikony miestností a prekážok, čo umožňuje, aby sa zobrazovali väčšie alebo menšie.
• opacity: Globálna priehľadnosť vykreslenej mapy. Počiatočná hodnota je 1 a akceptuje hodnoty až po 0.
• object_opacity: Priehľadnosť objektov vykreslených na mape, ako sú ikony miestností alebo prekážok. Počiatočná hodnota je 1 a akceptuje hodnoty až po 0.
• font_size: Veľkosť písma pre textové bubliny zobrazené nad aktivované objekty. Akceptuje hodnoty medzi 0 a 12.
• hidden_objects: Prepíše skryté objekty mapy definované v globálnom Pokročilá konfigurácia pre túto konkrétnu mapu.

Centrovanie a škálovanie

Nižšie uvedené parametre sa používajú na prepísanie veľkosti a súradníc stredu, ktoré karta automaticky vypočíta na vykreslenie mapy.

Upozornenie

Hodnoty poskytnuté pre tieto parametre sú vzťahované k surovým, nezmenšeným rozmerom mapy, nie k absolútnym pixelom na obrazovke. Pretože manuálne vypočítanie týchto relatívnych súradníc je veľmi zložité, presné potrebné hodnoty je možné získať pomocou sekcie Informácie o mapách v reálnom čase vo vizuálnom editore.

• left: Prepíše automaticky vypočítaný horizontálny stred mapy. Napríklad nastavenie tejto hodnoty na 0 umiestni 0 súradnicu mapy na osi X presne do horizontálneho stredu karty. Tento bod sa obvykle nachádza priamo pred dokom.
• top: Prepíše automaticky vypočítaný vertikálny stred mapy. Napríklad nastavenie tejto hodnoty na 0 umiestni 0 súradnicu mapy na osi Y presne do vertikálneho stredu karty. Tento bod sa obvykle nachádza priamo pred dokom.
• width: Prepisuje skutočnú šírku mapy použitú na výpočet prispôsobenia. Pretože karta škáluje mapu podľa najväčšieho rozmeru, ktorý sa zmestí, zadanie hodnoty väčšej ako skutočná šírka mapy zmenší mapu v karte, zatiaľ čo menšia hodnota ju zväčší.
• height: Prepisuje skutočnú výšku mapy použitú na výpočet prispôsobenia. Podobne ako vlastnosť width, zadanie hodnoty väčšej ako skutočná výška mapy zmenší mapu v karte, zatiaľ čo menšia hodnota ju zväčší.

Príklad 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

Pozadie a prekryvné obrázky

Karta podporuje zobrazenie vlastného pozadia za mapou, čo je obzvlášť užitočné pri vytváraní pohlcujúcich 3D dashboardov pôdorysov. Toto správanie sa konfiguruje pomocou vlastnosti background_image.

Na ďalšie zlepšenie 3D efektu je možné poskytnúť aj voliteľný overlay_image. Prekrývací obrázok sa kreslí priamo na vrch cesty čistenia robota a jeho hlavným účelom je vizuálne zakryť cesty, ktoré prechádzajú za fyzickými stenami alebo nábytkom v pôdoryse. Kombinácia pozadia a prekrývacieho obrázka sa dôrazne odporúča na dosiahnutie realistického pocitu hĺbky v 3D dashboardoch.

Návrh 3D pôdorysu

Pri vytváraní vlastnej grafiky pre 3D pôdorys musí byť dizajn exportovaný ako dva samostatné obrázky s priehľadným pozadím: základná vrstva obsahujúca podlahy a nízky nábytok a horná vrstva obsahujúca iba horné steny.

Príkladové obrázky nižšie, zobrazené na šachovnicovom vzore na zvýraznenie ich priehľadných oblastí, boli vytvorené pomocou bezplatnej aplikácie na interiérový dizajn Sweet Home 3D a následne spracované v štandardnom softvéri na úpravu obrázkov na odstránenie podlahových oblastí a vytvorenie požadovaných priehľadných častí.

Obrázok na pozadí

Prekrývací obrázok

background_image a overlay_image podporujú nasledujúce vlastnosti na zarovnanie pôdorysu:

• url: Cesta k obrázku, napríklad /local/first_floor_bg.
• opacity: Priehľadnosť obrázku. Počiatočná hodnota je 1 a akceptuje hodnoty až do 0.

Centrovanie a škálovanie obrázkov

Vlastnosti left, top, width a height pre obrázky fungujú pomocou presne rovnakého logického systému relatívnych súradníc ako konfigurácia Centrovanie a škálovanie samotnej mapy. Tieto vlastnosti sú úplne voliteľné.

Aj keď vlastný obrázok presne zodpovedá veľkosti mapy, dôrazne sa odporúča poskytnúť minimálne hodnoty top a left. To zabezpečí, že ak sa celková veľkosť mapy v budúcnosti zmení, vlastný obrázok zostane pevne pripnutý na tom istom relatívnom mieste.

Predvolené hodnoty

Keď tieto hodnoty nie sú poskytnuté, karta automaticky vyrovná veľkosť a stred vlastného obrázka s údajmi mapy. Tieto vlastnosti sú úplne voliteľné a existujú výlučne na to, aby prekonali toto správanie, zabraňujúc posunu vlastného obrázka alebo zmene jeho mierky v prípade, že mapa sa v priebehu času rozšíri alebo zmenší.

• left: Definuje horizontálny stred obrázka vzhľadom na stred mapy. Napríklad nastavenie tejto hodnoty na 0 umiestni súradnicu 0 mapy na osi X presne do horizontálneho stredu obrázka. Tento bod sa typicky nachádza priamo pred dokom.
• top: Definuje vertikálny stred obrázka vzhľadom na stred mapy. Napríklad nastavenie tejto hodnoty na 0 umiestni súradnicu 0 mapy na osi Y presne do vertikálneho stredu obrázka. Tento bod sa typicky nachádza priamo pred dokom.
• width: Definuje šírku obrázka vzhľadom na pôvodný, neskalovaný súradnicový systém mapy, namiesto absolútnych pixelov obrazovky. Napríklad nastavenie tejto hodnoty tak, aby zodpovedala surovej šírke mapy, zabezpečí, že obrázok bude proporčne škálovaný tak, aby pokryl presne rovnakú horizontálnu oblasť ako údaje mapy.
• height: Definuje výšku obrázka vzhľadom na pôvodný, neskalovaný súradnicový systém mapy. Napríklad nastavenie tejto hodnoty tak, aby zodpovedala surovej výške mapy, zabezpečí, že obrázok bude proporčne škálovaný tak, aby pokryl presne rovnakú vertikálnu oblasť ako údaje mapy.

Natívne otáčanie

Vlastné obrázky nemajú svoj vlastný nezávislý parameter rotácie; ich rotácia je inherentne viazaná na rotáciu mapy. Na zabezpečenie zladenia vo všetkých zobrazeniach musí základná orientácia navrhnutého obrázka presne zodpovedať počiatočnej orientácii mapy, keď je nastavená na 0 stupňov.

Pomer pixelov zariadenia (DPR)

Karta vykresľuje mapu podľa pomeru pixelov obrazovky zariadenia. Aby sa zabránilo rozmazaniu pozadia a prekryvných obrázkov na displejoch s vysokým rozlíšením, ako sú mobilné telefóny, dôrazne sa odporúča poskytnúť tieto obrázky minimálne v dvojnásobnej požadovanej veľkosti na desktopovom dashboarde.

Určenie veľkosti obrázka

Dátové údaje mapy obsahujú vlastnosť grid_size, ktorá označuje, koľko milimetrov predstavuje jeden pixel v reálnom svete. Táto hodnota sa nachádza v sekcii Informácie o mapách v reálnom čase. Napríklad grid_size 50 znamená, že každý pixel odpovedá 50 mm, alebo 5 cm. Rozdelením rozmerov domu v reálnom svete touto hodnotou grid_size je možné presne vypočítať hodnoty width a height na zadanie do konfigurácie, čím sa zabezpečí, že obraz pôdorysu v mierke 1:1 sa dokonale zhoduje so skutočnou veľkosťou domu.

Príklad 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