Konfigurasi Peta Tersuai

Penjajaran, skala dan imej latar belakang boleh dikonfigurasikan secara bebas untuk setiap peta yang disimpan pada peranti.

Tetapan ini boleh dikonfigurasikan dalam penyunting visual dengan memilih peta dari senarai peta, atau dengan menggunakan sifat map_config dalam konfigurasi YAML.

Pilihan Konfigurasi Peta

Tetapan di dalam map_config diterapkan setiap indeks peta menggunakan kekunci seperti map_1, map_2, dan lain-lain. Mana-mana pilihan berikut boleh ditentukan di bawah peta tertentu:

Amaran

Indeks peta ditetapkan berdasarkan urutan penciptaannya, dengan peta yang tertua menerima indeks terendah, bermula dari 1. Walau bagaimanapun, jika ciri peta berbilang tingkat dinyahaktifkan pada peranti yang mempunyai pelbagai peta dan konfigurasi mereka, peta yang sedang aktif secara automatik akan ditetapkan semula kepada indeks 1. Ini bermakna peta yang sebelumnya dikonfigurasikan di bawah indeks yang berbeza akan tiba-tiba mengguna pakai konfigurasi map_1.

• rotation: Menulis semula putaran yang dikonfigurasikan dalam data peta untuk melukis peta dalam putaran khusus untuk kad ini, menerima nilai 0, 90, 180, atau 270.
• scale: Menulis semula pengiraan skala automatik berdasarkan perbezaan antara saiz asal peta dan saiz kad, menerima nilai antara 0.1 dan 20.
• object_scale: Menulis semula saiz objek peta yang dikira secara automatik, seperti ikon bilik dan halangan, membolehkan mereka muncul lebih besar atau lebih kecil.
• opacity: Ketelusan global peta yang dilukis. Nilai awal ialah 1 dan ia menerima nilai sehingga 0.
• object_opacity: Ketelusan objek yang dilukis pada peta, seperti ikon bilik atau halangan. Nilai awal ialah 1 dan ia menerima nilai sehingga 0.
• font_size: Saiz fon untuk gelembung teks yang dipaparkan di atas objek yang diaktifkan. Ia menerima nilai antara 0 dan 12.
• hidden_objects: Menulis semula objek peta tersembunyi yang ditakrifkan dalam Konfigurasi Lanjutan global untuk peta khusus ini.

Penyelerasan Pusat dan Skala

Parameter di bawah digunakan untuk menimpa saiz dan koordinat pusat yang dikira secara automatik oleh kad untuk melukis peta.

Amaran

Nilai yang diberikan untuk parameter ini adalah relatif kepada dimensi peta yang mentah dan tidak diskala, bukan piksel mutlak pada skrin. Oleh kerana mengira koordinat relatif ini secara manual adalah sangat kompleks, nilai tepat yang diperlukan boleh diekstrak menggunakan bahagian Maklumat Peta Langsung editor visual.

• left: Menimpa pusat mendatar peta yang dikira secara automatik. Sebagai contoh, menetapkan nilai ini kepada 0 meletakkan koordinat 0 peta pada paksi X tepat di tengah mendatar kad. Titik ini biasanya terletak tepat di hadapan jeti.
• top: Menimpa pusat menegak peta yang dikira secara automatik. Sebagai contoh, menetapkan nilai ini kepada 0 meletakkan koordinat 0 peta pada paksi Y tepat di tengah menegak kad. Titik ini biasanya terletak tepat di hadapan jeti.
• width: Menimpa lebar sebenar peta yang digunakan untuk pengiraan kesesuaian. Oleh kerana kad menyesuaikan skala peta berdasarkan dimensi paling besar yang sesuai, memasukkan nilai yang lebih besar daripada lebar sebenar peta akan mengecilkan peta di dalam kad, manakala nilai yang lebih kecil akan membesarkannya.
• height: Menimpa tinggi sebenar peta yang digunakan untuk pengiraan kesesuaian. Sama seperti sifat width, memasukkan nilai yang lebih besar daripada tinggi sebenar peta akan mengecilkan peta di dalam kad, manakala nilai yang lebih kecil akan membesarkannya.

Contoh 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

Imej Latar Belakang dan Lapisan

Kad menyokong rendering imej latar belakang tersuai di belakang peta, yang amat berguna untuk mencipta papan pemuka pelan lantai 3D yang imersif. Perilaku ini dikonfigurasikan menggunakan sifat background_image.

Untuk meningkatkan lagi kesan 3D, overlay_image pilihan juga boleh disediakan. Imej overlay dilukis terus di atas laluan pembersihan robot dan tujuan utamanya adalah untuk menyembunyikan secara visual laluan yang berada di belakang dinding fizikal atau perabot dalam pelan lantai. Menggabungkan kedua-dua imej latar dan imej overlay sangat disyorkan untuk mencapai rasa kedalaman yang realistik dalam papan pemuka 3D.

Mereka Bentuk Pelan Lantai 3D

Apabila mencipta grafik khusus untuk pelan lantai 3D, reka bentuk mesti dieksport sebagai dua imej berasingan dengan latar telus: lapisan asas yang mengandungi lantai dan perabot rendah, dan lapisan atas yang mengandungi hanya dinding atas.

Imej contoh di bawah, ditunjukkan di atas corak papan catur untuk menonjolkan kawasan lut sinarnya, telah dijana menggunakan aplikasi reka bentuk dalaman percuma Sweet Home 3D dan kemudian diproses dalam perisian suntingan imej standard untuk menghapuskan kawasan lantai dan menghasilkan bahagian lut sinar yang dikehendaki.

Imej Latar Belakang

Imej Tindanan

background_image dan overlay_image menyokong ciri berikut untuk menyelaraskan pelan lantai:

• url: Laluan imej, seperti /local/first_floor_bg.
• opacity: Ketelusan imej. Nilai awal adalah 1 dan ia menerima nilai sehingga 0.

Menyelaraskan dan Menyukarkan Imej

Ciri left, top, width dan height untuk imej beroperasi menggunakan logik koordinat relatif yang sama seperti konfigurasi Penyelerasan Pusat dan Skala peta itu sendiri. Ciri-ciri ini adalah sepenuhnya pilihan.

Walaupun imej tersuai sesuai dengan saiz peta dengan sempurna, amat disyorkan untuk menyediakan sekurang-kurangnya nilai top dan left. Ini memastikan bahawa jika jumlah saiz peta berubah pada masa hadapan, imej tersuai tetap terpaut dengan selamat pada lokasi relatif yang sama.

Nilai Lalai

Apabila nilai-nilai ini tidak diberikan, kad secara automatik menyamakan saiz dan pusat imej tersuai dengan data peta. Sifat-sifat ini sepenuhnya pilihan dan wujud semata-mata untuk menggantikan tingkah laku ini, menghalang imej tersuai daripada bergerak atau skala berubah sekiranya peta berkembang atau menyusut dari semasa ke semasa.

• left: Mentakrifkan pusat mendatar imej berbanding pusat peta. Sebagai contoh, menetapkan nilai ini kepada 0 meletakkan koordinat 0 peta pada paksi X tepat di tengah mendatar imej. Titik ini biasanya terletak tepat di hadapan dok.
• top: Mentakrifkan pusat menegak imej berbanding pusat peta. Sebagai contoh, menetapkan nilai ini kepada 0 meletakkan koordinat 0 peta pada paksi Y tepat di tengah menegak imej. Titik ini biasanya terletak tepat di hadapan dok.
• width: Menentukan lebar imej relatif kepada sistem koordinat asal peta yang tidak berskala, dan bukannya piksel skrin mutlak. Contohnya, menetapkan nilai ini untuk sepadan dengan lebar mentah peta memastikan imej diskala secara seimbang untuk menutupi kawasan mendatar yang sama tepat dengan data peta.
• height: Menentukan ketinggian imej relatif kepada sistem koordinat asal peta yang tidak berskala. Contohnya, menetapkan nilai ini untuk sepadan dengan ketinggian mentah peta memastikan imej diskala secara seimbang untuk menutupi kawasan menegak yang sama tepat dengan data peta.

Putaran Asal

Imej tersuai tidak mempunyai sifat putaran sendiri yang bebas; putarannya secara inheren terikat kepada putaran peta. Untuk memastikan penjajaran merentasi semua paparan, orientasi asas imej yang direka mesti sepadan dengan tepat dengan orientasi awal peta apabila ditetapkan kepada 0 darjah.

Nisbah Piksel Peranti (DPR)

Kad tersebut memaparkan peta mengikut nisbah piksel skrin peranti. Untuk mengelakkan imej latar belakang dan lapisan daripada kelihatan kabur pada skrin beresolusi tinggi seperti telefon bimbit, adalah sangat disyorkan untuk menyediakan imej-imej ini sekurang-kurangnya dua kali ganda saiz yang diperlukan pada papan pemuka desktop.

Menentukan Saiz Imej

Data peta termasuk sifat grid_size yang menunjukkan berapa milimeter yang diwakili oleh satu piksel dalam dunia nyata. Nilai ini boleh didapati di bahagian Maklumat Peta Langsung. Sebagai contoh, grid_size sebesar 50 bermaksud setiap piksel bersamaan dengan 50mm, atau 5cm. Dengan membahagikan dimensi sebenar rumah dengan grid_size ini, nilai tepat width dan height untuk dimasukkan dalam konfigurasi boleh dikira dengan tepat, memastikan imej pelan lantai 1:1 berskala sempurna dengan saiz sebenar rumah.

Contoh 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