Pielāgota kartes konfigurācija

Pozīcija, mērogs un fona attēls var tikt konfigurēti neatkarīgi katram ierīcē saglabātajam kartes variantam.

Šos iestatījumus var konfigurēt vizuālajā redaktorā, izvēloties karti no karšu saraksta, vai arī, izmantojot map_config īpašumu YAML konfigurācijā.

Karšu konfigurācijas iespējas

Iestatījumi iekš map_config tiek piemēroti katram karšu indeksam, izmantojot atslēgas kā map_1, map_2 utt. Jebkuru no sekojošajām iespējām var definēt konkrētai kartei:

Brīdinājums

Karšu indeksi tiek piešķirti pēc to izveides secības, piešķirot vecākajai kartei zemāko indeksu, sākot no 1. Tomēr, ja ierīcē, kurā ir vairākas kartes un to konfigurācijas, funkcija vairāku stāvu kartes iespējai ir atspējota, pašlaik aktīvā karte automātiski tiek piešķirta indeksam 1. Tas nozīmē, ka karte, kas iepriekš tika konfigurēta zem cita indeksa, pēkšņi pieņems šīs konfigurācijas parādību. map_1.

• rotation: Pārraksta kartes datos konfigurēto rotāciju, lai zīmētu karti ar šo karti specifisku pielāgotu rotāciju, pieņemot vērtības 0, 90, 180 vai 270.
• scale: Pārraksta automātisko mēroga aprēķinu, pamatojoties uz atšķirību starp kartes sākotnējo izmēru un kartes izmēru, pieņemot vērtības no 0.1 līdz 20.
• object_scale: Pārraksta automātiski aprēķināto kartes objektu izmēru, piemēram, telpu un šķēršļu ikonas, ļaujot tām parādīties lielākām vai mazākām.
• opacity: Zīmētās kartes globālā caurspīdīgums. Sākotnējā vērtība ir 1 un tā pieņem vērtības līdz 0.
• object_opacity: Caurspīdīgums objektam, kas zīmēts uz kartes, piemēram, telpas vai šķēršļu ikonas. Sākotnējā vērtība ir 1 un tā pieņem vērtības līdz 0.
• font_size: Teksta burbuļu fonta lielums, kas tiek parādīts virs aktivizētie objekti. Tas pieņem vērtības no 0 līdz 12.
• hidden_objects: Pārraksta slēptos kartes objektus, kas definēti globālajā Paplašinātā konfigurācija šai konkrētajai kartei.

Centrs un mērogošana

Zemāk norādītie parametri tiek izmantoti, lai pārrakstītu kartes automātiski aprēķināto izmēru un centra koordinātas, lai uzzīmētu karti.

Brīdinājums

Šiem parametriem sniegtās vērtības attiecas uz kartes neapstrādātajiem, mērogam nepakļautajiem izmēriem, nevis uz absolūtajiem pikseļiem ekrānā. Tā kā šīs relatīvās koordinātas ir ļoti sarežģīti aprēķināt manuāli, precīzās nepieciešamās vērtības var iegūt, izmantojot vizuālā redaktora Tiešraides kartes informācija sadaļu.

• left: Pārraksta kartes automātiski aprēķināto horizontālo centru. Piemēram, iestatot šo vērtību uz 0, tiek novietota kartes 0 koordināta X asī tieši kartes horizontālajā centrā. Šis punkts parasti atrodas tieši pie piestātnes.
• top: Pārraksta kartes automātiski aprēķināto vertikālo centru. Piemēram, iestatot šo vērtību uz 0, tiek novietota kartes 0 koordināta Y asī tieši kartes vertikālajā centrā. Šis punkts parasti atrodas tieši pie piestātnes.
• width: Pārraksta faktiskās kartes platumu, kas tiek izmantots izmēra piemērošanas aprēķinos. Tā kā karte mērogo karti, pamatojoties uz lielāko piemēroto dimensiju, ievadot vērtību, kas ir lielāka par kartes faktisko platumu, karte tiks samazināta kartes ietvarā, savukārt mazāka vērtība to palielinās.
• height: Pārraksta faktiskos kartes augstumus, kas tiek izmantoti izmēra piemērošanas aprēķinos. Līdzīgi kā īpašums width, ievadot vērtību, kas ir lielāka par kartes faktisko augstumu, karte tiks samazināta kartes ietvarā, savukārt mazāka vērtība to palielinās.

YAML piemērs

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

Fona un pārklājuma attēli

Karte atbalsta pielāgota fona attēla renderēšanu aiz kartes, kas ir īpaši noderīgi, izveidojot ieskaujošus 3D plānojuma informācijas paneļus. Šo uzvedību konfigurē, izmantojot īpašumu background_image.

Lai vēl vairāk uzlabotu 3D efektu, var tikt nodrošināts arī izvēles overlay_image. Pārklājuma attēls tiek zīmēts tieši uz robota tīrīšanas ceļa, un tā galvenais mērķis ir vizuāli aizsegt ceļus, kas ved aiz fiziskām sienām vai mēbelēm grīdas plānā. Ieteicams kombinēt gan fonu, gan pārklājuma attēlu, lai 3D informācijas panelī iegūtu reālistisku dziļuma sajūtu.

3D grīdas plāna izstrāde

Veidojot pielāgotas grafikas 3D grīdas plānam, dizainam jābūt eksportētam kā diviem atsevišķiem attēliem ar caurspīdīgu fonu: pamata slānim, kas satur grīdas un zemas mēbeles, un augšslānim, kas satur tikai augstās sienas.

Zemāk redzamās piemēru attēli, rādot pār šaha dēļa rakstu, lai izceltu to caurspīdīgās zonas, tika ģenerēti, izmantojot bezmaksas interjera dizaina lietotni Sweet Home 3D un pēc tam apstrādāti standarta attēlu rediģēšanas programmatūrā, lai noņemtu grīdas zonas un izveidotu nepieciešamās caurspīdīgās daļas.

Fona attēls

Pārklājuma attēls

background_image un overlay_image atbalsta šādas īpašības, lai saskaņotu grīdas plānu:

• url: Attēla ceļš, piemēram, /local/first_floor_bg.
• opacity: Attēla caurspīdīgums. Sākotnējā vērtība ir 1 un tas pieņem vērtības līdz 0.

Attēlu centrēšana un mērogošana

left, top, width un height attēlu īpašības darbojas, izmantojot tieši to pašu relatīvo koordinātu loģiku kā kartes paša Centrs un mērogošana konfigurācija. Šīs īpašības ir pilnīgi izvēles.

Pat ja pielāgotais attēls perfekti atbilst kartes izmēram, ļoti ieteicams norādīt vismaz top un left vērtības. Tas nodrošina, ka, ja kartes kopējais izmērs nākotnē mainās, pielāgotais attēls paliek droši piesiets pie tās pašas relatīvās vietas.

Noklusējuma vērtības

Kad šīs vērtības nav sniegtas, karte automātiski izlīdzina pielāgotās bildes izmēru un centru ar kartes datiem. Šīs īpašības ir pilnīgi izvēles un pastāv tikai, lai pārrakstītu šo uzvedību, novēršot pielāgotās bildes pārvietošanos vai tās mēroga maiņu gadījumā, ja karte laika gaitā palielinās vai samazinās.

• left: Nosaka bildes horizontālo centru attiecībā pret kartes centru. Piemēram, iestatot šo vērtību uz 0, kartes 0 koordināta X ass atrodas tieši bildes horizontālajā centrā. Šī vieta parasti atrodas tieši pie piestātnes.
• top: Nosaka bildes vertikālo centru attiecībā pret kartes centru. Piemēram, iestatot šo vērtību uz 0, kartes 0 koordināta Y ass atrodas tieši bildes vertikālajā centrā. Šī vieta parasti atrodas tieši pie piestātnes.
• width: Nosaka attēla platumu attiecībā pret kartes sākotnējo, neskaloto koordinātu sistēmu, nevis absolūtajiem ekrāna pikseļiem. Piemēram, iestatot šo vērtību atbilstošu kartes neapstrādātajam platumam, tiek nodrošināta attēla proporcionāla mērogošana, lai tas aizņemtu tieši tādu pašu horizontālo platību kā kartes dati.
• height: Nosaka attēla augstumu attiecībā pret kartes sākotnējo, neskaloto koordinātu sistēmu. Piemēram, iestatot šo vērtību atbilstošu kartes neapstrādātajam augstumam, tiek nodrošināta attēla proporcionāla mērogošana, lai tas aizņemtu tieši tādu pašu vertikālo platību kā kartes dati.

Dabiskā rotācija

Pielāgotajiem attēliem nav sava neatkarīga rotācijas īpašuma; to rotācija ir būtībā saistīta ar kartes rotāciju. Lai nodrošinātu saskaņotību visās skatījumos, dizainētā attēla bāzes orientācijai jāatbilst tieši kartes sākotnējai orientācijai, kad tā ir iestatīta uz 0 grādiem.

Ierīces pikseļu attiecība (DPR)

Karte attēlo karti atbilstoši ierīces ekrāna pikseļu attiecībai. Lai novērstu fona un pārklājuma attēlu izplūšanu augstas izšķirtspējas displejos, piemēram, mobilajos tālruņos, ļoti ieteicams nodrošināt šos attēlus vismaz divkāršā nepieciešamā izmērā darbvirsmas informācijas panelī.

Attēla lieluma noteikšana

Kartes dati ietver grid_size īpašību, kas norāda, cik milimetri atbilst vienam pikselim reālajā pasaulē. Šo vērtību var atrast Tiešraides kartes informācija sadaļā. Piemēram, grid_size ar vērtību 50 nozīmē, ka katrs pikselis atbilst 50 mm jeb 5 cm. Dalot mājas reālās pasaules izmērus ar šo grid_size, var precīzi aprēķināt width un height vērtības, kas jāievada konfigurācijā, nodrošinot, ka 1:1 grīdas plāna attēls perfektā mērogā atbilst mājas reālajiem izmēriem.

YAML piemērs

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