Vlastní konfigurace mapy

Zarovnání, měřítko a obrázek pozadí lze konfigurovat nezávisle pro každou uloženou mapu v zařízení.

Tyto nastavení lze upravit ve vizuálním editoru výběrem mapy ze seznamu map nebo pomocí vlastnosti map_config v konfiguraci YAML.

Možnosti konfigurace mapy

Nastavení uvnitř map_config se aplikují podle indexu mapy pomocí klíčů jako map_1, map_2 atd. Jakákoli z následujících možností může být definována pro konkrétní mapu:

Varování

Indexy map jsou přiřazovány podle jejich pořadí vytvoření, přičemž nejstarší mapa získává nejnižší index, počínaje 1. Pokud však bude funkce vícepatrové mapy na zařízení, které má více map a jejich konfiguraci, zakázána, aktuálně aktivní mapa je automaticky přiřazena k indexu 1. To znamená, že mapa dříve nakonfigurovaná pod jiným indexem náhle převezme konfiguraci map_1.

• rotation: Přepisuje rotaci nastavenou v datech mapy pro kreslení mapy v vlastní rotaci specifické pro tuto kartu, přijímá hodnoty 0, 90, 180 nebo 270.
• scale: Přepisuje automatický výpočet měřítka na základě rozdílu mezi původní velikostí mapy a velikostí karty, přijímá hodnoty mezi 0.1 a 20.
• object_scale: Přepisuje automaticky vypočtenou velikost objektů na mapě, například ikon místností a překážek, umožňuje jim se zobrazit větší nebo menší.
• opacity: Globální průhlednost kreslené mapy. Počáteční hodnota je 1 a přijímá hodnoty až do 0.
• object_opacity: Průhlednost objektů kreslených na mapě, například ikon místností nebo překážek. Počáteční hodnota je 1 a přijímá hodnoty až do 0.
• font_size: Velikost písma pro textové bubliny zobrazené nad aktivované objekty. Přijímá hodnoty mezi 0 a 12.
• hidden_objects: Přepisuje skryté objekty mapy definované v globálním Pokročilá konfigurace pro tuto konkrétní mapu.

Zarovnání a měřítko

Níže uvedené parametry slouží k přepsání velikosti a souřadnic středu, které karta automaticky vypočítává pro vykreslení mapy.

Varování

Hodnoty poskytované pro tyto parametry jsou vztaženy k surovým, nepřizpůsobeným rozměrům mapy, nikoli k absolutním pixelům na obrazovce. Protože ruční výpočet těchto relativních souřadnic je velmi složitý, přesné potřebné hodnoty lze získat pomocí sekce Informace o živé mapě ve vizuálním editoru.

• left: Přepisuje automaticky vypočítaný vodorovný střed mapy. Například nastavení této hodnoty na 0 umístí souřadnici 0 mapy na ose X přesně do vodorovného středu karty. Tento bod se typicky nachází přímo před přístavištěm.
• top: Přepisuje automaticky vypočítaný svislý střed mapy. Například nastavení této hodnoty na 0 umístí souřadnici 0 mapy na ose Y přesně do svislého středu karty. Tento bod se typicky nachází přímo před přístavištěm.
• width: Přepisuje skutečnou šířku mapy použitou pro výpočet přizpůsobení. Protože karta škáluje mapu na základě největší vhodné dimenze, zadání hodnoty větší než skutečná šířka mapy mapu uvnitř karty zmenší, zatímco menší hodnota ji zvětší.
• height: Přepisuje skutečnou výšku mapy použitou pro výpočet přizpůsobení. Podobně jako vlastnost width, zadání hodnoty větší než skutečná výška mapy mapu uvnitř karty zmenší, zatímco menší hodnota ji zvětší.

Pří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

Pozadí a překryvné obrázky

Karta podporuje vykreslení vlastního pozadí za mapou, což je obzvláště užitečné pro vytváření pohlcujících 3D dashboardů s půdorysy. Toto chování se nastavuje pomocí vlastnosti background_image.

Pro další zvýšení 3D efektu může být volitelně poskytnut také overlay_image. Překryvný obrázek je nakreslen přímo na cestu čištění robota a jeho hlavním účelem je vizuálně zakrýt cesty, které vedou za fyzickými stěnami nebo nábytkem ve půdorysu. Doporučuje se kombinovat jak obrázek pozadí, tak překryvný obrázek pro dosažení realistického pocitu hloubky v 3D dashboardech.

Navrhování 3D půdorysu

Při vytváření vlastních grafických prvků pro 3D půdorys musí být návrh exportován jako dva samostatné obrázky s průhledným pozadím: základní vrstva obsahující podlahy a nízký nábytek a horní vrstva obsahující pouze horní stěny.

Níže uvedené příkladové obrázky, zobrazené přes šachovnicový vzor, aby byly zvýrazněny jejich průhledné oblasti, byly vytvořeny pomocí bezplatné aplikace pro interiérový design Sweet Home 3D a následně zpracovány ve standardním softwaru pro úpravu obrázků, aby byly odstraněny plochy podlahy a vytvořeny požadované průhledné části.

Obrázek na pozadí

Překryvný obrázek

background_image a overlay_image podporují následující vlastnosti pro zarovnání plánu podlahy:

• url: Cesta k obrázku, například /local/first_floor_bg.
• opacity: Průhlednost obrázku. Počáteční hodnota je 1 a přijímá hodnoty až do 0.

Zarovnání a škálování obrázků

Vlastnosti left, top, width a height pro obrázky fungují podle zcela stejné logiky relativních souřadnic jako vlastní konfigurace mapy Zarovnání a měřítko. Tyto vlastnosti jsou zcela volitelné.

I když vlastní obrázek přesně odpovídá velikosti mapy, důrazně se doporučuje poskytnout alespoň hodnoty top a left. To zajistí, že pokud se celková velikost mapy v budoucnu změní, vlastní obrázek zůstane bezpečně připevněn na stejném relativním místě.

Výchozí hodnoty

Když tyto hodnoty nejsou zadány, karta automaticky vyrovná velikost a střed vlastní obrázku s daty mapy. Tyto vlastnosti jsou zcela volitelné a existují pouze k tomu, aby přepsaly toto chování, zabránily posunu vlastního obrázku nebo změně jeho měřítka v případě, že se mapa časem zvětší nebo zmenší.

• left: Definuje horizontální střed obrázku vzhledem ke středu mapy. Například nastavením této hodnoty na 0 se souřadnice mapy 0 na ose X umístí přesně do horizontálního středu obrázku. Tento bod se obvykle nachází přímo před dokem.
• top: Definuje vertikální střed obrázku vzhledem ke středu mapy. Například nastavením této hodnoty na 0 se souřadnice mapy 0 na ose Y umístí přesně do vertikálního středu obrázku. Tento bod se obvykle nachází přímo před dokem.
• width: Definuje šířku obrázku vzhledem k původnímu, neskálovanému souřadnicovému systému mapy, nikoli vůči absolutním pixelům obrazovky. Například nastavení této hodnoty tak, aby odpovídala surové šířce mapy, zajistí, že obrázek bude měřítkován proporčně tak, aby pokryl přesně stejnou horizontální oblast jako data mapy.
• height: Definuje výšku obrázku vzhledem k původnímu, neskálovanému souřadnicovému systému mapy. Například nastavení této hodnoty tak, aby odpovídala surové výšce mapy, zajistí, že obrázek bude měřítkován proporčně tak, aby pokryl přesně stejnou vertikální oblast jako data mapy.

Nativní rotace

Vlastní obrázky nemají vlastní nezávislou vlastnost rotace; jejich rotace je inherentně vázána na rotaci mapy. Aby byla zajištěna zarovnání ve všech pohledech, základní orientace navrženého obrázku musí přesně odpovídat počáteční orientaci mapy při nastavení na 0 stupňů.

Poměr pixelů zařízení (DPR)

Karta vykresluje mapu podle poměru pixelů obrazovky zařízení. Aby se zabránilo rozmazání pozadí a překryvných obrázků na displejích s vysokým rozlišením, například na mobilních telefonech, je vysoce doporučeno poskytovat tyto obrázky alespoň dvojnásobné velikosti požadované na desktopovém panelu.

Určení velikosti obrázku

Mapová data obsahují vlastnost grid_size, která udává, kolik milimetrů představuje jeden pixel ve skutečném světě. Tuto hodnotu lze najít v sekci Informace o živé mapě. Například grid_size s hodnotou 50 znamená, že každý pixel odpovídá 50 mm, tedy 5 cm. Vydělením skutečných rozměrů domu touto hodnotou grid_size lze přesně vypočítat hodnoty width a height, které je třeba zadat do konfigurace, čímž se zajistí, že obrázek půdorysu v měřítku 1:1 bude dokonale odpovídat skutečné velikosti domu.

Pří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