Kohandatud kaardi konfiguratsioon

Paigutust, skaala ja taustapilti saab seadistada eraldi iga seadmesse salvestatud kaardi jaoks.

Neid seadeid saab kohandada visuaalses redaktoris, valides kaardi kaardiloendist, või kasutades YAML-konfiguratsioonis map_config omadust.

Kaardi konfiguratsiooni valikud

map_config sees olevad sätted rakenduvad iga kaardi indeksi kohta, kasutades võtmeid nagu map_1, map_2 jne. Järgnevatest valikutest saab määrata konkreetse kaardi alla:

Hoiatust

Kaardi indeksid määratakse nende loomise järjekorras, vanim kaart saab madalaima indeksi, alustades 1-st. Kui aga seadmes, millel on mitu kaarti ja nende konfiguratsioonid, on mitme korruse kaardi funktsioon keelatud, siis määratakse praegu aktiivsele kaardile automaatselt indeks 1. See tähendab, et varasemalt erineva indeksi alla konfigureeritud kaart võtab äkki kasutusele teise konfiguratsiooni map_1.

• rotation: Asendab kaardiandmetes seadistatud pöörlemise, et joonistada kaart selle kaardi jaoks kohandatud pöörlemises, aktsepteerides väärtusi 0, 90, 180 või 270.
• scale: Asendab automaatse skaalaarvutuse, mis põhineb kaardi algse suuruse ja kaardi suuruse erinevusel, aktsepteerides väärtusi vahemikus 0.1 kuni 20.
• object_scale: Asendab kaardil objektide, näiteks ruumi ja takistuse ikoonide, automaatselt arvutatud suuruse, võimaldades neil ilmuda suuremana või väiksemana.
• opacity: Joonistatud kaardi globaalne läbipaistvus. Algväärtus on 1 ja aktsepteerib väärtusi kuni 0.
• object_opacity: Kaardile joonistatud objektide, näiteks ruumi või takistuse ikoonide, läbipaistvus. Algväärtus on 1 ja aktsepteerib väärtusi kuni 0.
• font_size: Tekstibubble'i fondi suurus, mis kuvatakse aktiveeritud objektid kohal. Aktsepteerib väärtusi vahemikus 0 kuni 12.
• hidden_objects: Asendab selle konkreetse kaardi jaoks globaalselt määratud peidetud kaardiobjektid Täiustatud konfiguratsioon.

Keskimis- ja skaleerimisfunktsioonid

Allolevaid parameetreid kasutatakse kaardi automaatselt arvutatud suuruse ja keskkoordinatide ülekirjutamiseks, et kaarti joonistada.

Hoiatust

Nende parameetrite jaoks antud väärtused on suhtelised kaardi toore, mitteskaalatud mõõtmete suhtes, mitte ekraani absoluutsete pikslite suhtes. Kuna nende suhteliste koordinaatide käsitsi arvutamine on väga keeruline, saab vajalikke täpseid väärtusi eraldada visuaalse redaktori Reaalajas kaardi teave jaotise kaudu.

• left: Kirjutab üle kaardi automaatselt arvutatud horisontaalse keskkoha. Näiteks, kui seada see väärtus 0, paigutatakse kaardi 0 koordinaat X-teljel täpselt kaardi horisontaalisse keskpunkti. See punkt asub tavaliselt otse doki ees.
• top: Kirjutab üle kaardi automaatselt arvutatud vertikaalse keskkoha. Näiteks, kui seada see väärtus 0, paigutatakse kaardi 0 koordinaat Y-teljel täpselt kaardi vertikaalsesse keskpunkti. See punkt asub tavaliselt otse doki ees.
• width: Tühistab kaardi tegeliku laiuse, mida kasutatakse sobitamise arvutamisel. Kuna kaart skaleerib kaarti suurima sobiva mõõtme põhjal, vähendab kaardi sees kaardi tegelikust laiemast väärtusest suurema väärtuse sisestamine kaardi suurust, samas kui väiksema väärtuse sisestamine suurendab seda.
• height: Tühistab kaardi tegeliku kõrguse, mida kasutatakse sobitamise arvutamisel. Sarnaselt width omadusega vähendab kaardi tegelikust kõrgemast väärtusest suurema väärtuse sisestamine kaardi sees kaardi suurust, samas kui väiksema väärtuse sisestamine suurendab seda.

YAML näide

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 ülekattepildid

Kaart toetab kohandatud taustapildi kuvamist kaardi taga, mis on eriti kasulik kaasahaaravate 3D põrandaplaanide juhtpaneelide loomiseks. Seda käitumist konfigureeritakse background_image omaduse abil.

Veelgi enam 3D-efekti tugevdamiseks võib lisaks pakkuda valikulist overlay_image. Ülekatepilt joonistatakse otse roboti puhastusrada kohale ja selle peamine eesmärk on visuaalselt varjata teid, mis kulgevad füüsiliste seinte või mööbli taga põrandaplaanil. Tausta- ja ülekatepildi kombineerimine on väga soovitatav, et 3D armatuurlaudades saavutada realistlik sügavustunne.

3D põrandaplaani kujundamine

3D põrandaplaani kohandatud graafika loomisel tuleb kujundus eksportida kahena eraldi pildina läbipaistva taustaga: aluskiht, mis sisaldab põrandaid ja madalat mööblit, ning ülemine kiht, mis sisaldab ainult ülemisi seinu.

Allpool toodud näidispildid, mis on esitatud šahhruudimustriga, et rõhutada nende läbipaistvaid alasid, loodi tasuta sisekujunduse rakendusega Sweet Home 3D ja töötleti seejärel tavalise pilditöötlustarkvaraga, et eemaldada põrandapinnad ja luua vajalikud läbipaistvad osad.

Taustapilt

Ülekate Pilt

background_image ja overlay_image toetavad järgmisi omadusi, et põrandaplaani joondada:

• url: Pildi tee, näiteks /local/first_floor_bg.
• opacity: Pildi läbipaistvus. Algväärtus on 1 ja see aktsepteerib väärtusi kuni 0.

Piltide tsentristamine ja suuruse muutmine

left, top, width ja height pildi omadused toimivad täpselt sama suhtelise koordinaadi loogika järgi nagu kaardi oma Keskimis- ja skaleerimisfunktsioonid konfiguratsioon. Need omadused on täiesti vabatahtlikud.

Isegi kui kohandatud pilt sobib kaardi suurusega ideaalselt, on väga soovitatav määrata vähemalt top ja left väärtused. See tagab, et kui kaardi kogusuurus tulevikus muutub, jääb kohandatud pilt kindlalt samasse suhtelisse asukohta.

Vaikimisi väärtused

Kui neid väärtusi ei anta, kohandab kaart automaatselt kohandatud pildi suuruse ja keskpunkti vastavalt kaardi andmetele. Need omadused on täiesti vabatahtlikud ja eksisteerivad ainult selleks, et selle käitumise üle kirjutada, vältides kohandatud pildi nihkumist või skaala muutumist juhul, kui kaart aja jooksul laieneb või kahaneb.

• left: Määrab pildi horisontaalse keskpunkti kaardi keskpunkti suhtes. Näiteks, selle väärtuse seadmine 0 paigutab kaardi 0 koordinaadi X-teljel täpselt pildi horisontaalsesse keskpunkti. See punkt asub tavaliselt otse kai ees.
• top: Määrab pildi vertikaalse keskpunkti kaardi keskpunkti suhtes. Näiteks, selle väärtuse seadmine 0 paigutab kaardi 0 koordinaadi Y-teljel täpselt pildi vertikaalsesse keskpunkti. See punkt asub tavaliselt otse kai ees.
• width: Määrab pildi laiuse suhtes kaardi algse, skaaleerimata koordinaatsüsteemiga, mitte absoluutsete ekraanipikslite põhjal. Näiteks, kui seada see väärtus kaardi algse laiusega vastavusse, tagab see, et pilt skaleeritakse proportsionaalselt, katmaks täpselt sama horisontaalset ala nagu kaardandmed.
• height: Määrab pildi kõrguse suhtes kaardi algse, skaaleerimata koordinaatsüsteemiga. Näiteks, kui seada see väärtus kaardi algse kõrgusega vastavusse, tagab see, et pilt skaleeritakse proportsionaalselt, katmaks täpselt sama vertikaalset ala nagu kaardandmed.

Algne pööramine

Kohandatud piltidel puudub oma sõltumatu pööramise omadus; nende pööramine on olemuslikult seotud kaardi pööramisega. Kõigi vaadete ühtsuse tagamiseks peab kujundatud pildi baasorientatsioon täpselt ühtima kaardi algse orientatsiooniga, kui see on seatud 0 kraadi.

Seadme pikslisuhe (DPR)

Kaart kuvab kaarti vastavalt seadme ekraani piksli suhtarvule. Selleks, et vältida taustapildi ja ülekatte piltide udusust kõrge eraldusvõimega ekraanidel, nagu mobiiltelefonid, on tungivalt soovitatav esitada need pildid vähemalt kaks korda suuremana kui lauaarvuti juhtpaneelil nõutav suurus.

Pildi suuruse määramine

Kaardil olevad andmed sisaldavad grid_size atribuuti, mis näitab, kui palju millimeetreid vastab üks piksel tegelikus maailmas. Seda väärtust saab leida jaotises Reaalajas kaardi teave. Näiteks grid_size väärtus 50 tähendab, et iga piksel vastab 50 mm-le ehk 5 cm-le. Jagades kodu tegelikud mõõtmed selle grid_size-ga, saab täpselt arvutada width ja height väärtused, mis tuleb konfiguratsiooni sisestada, tagades, et 1:1 põrandaplaanipilt skaleerub täpselt vastavalt kodu tegelikule suurusele.

YAML näide

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