Özel Harita Konfigürasyonu

Hizalama, ölçek ve arka plan görüntüsü, cihazda kaydedilen her harita için bağımsız olarak yapılandırılabilir.

Bu ayarlar, harita listesinden bir harita seçerek görsel editörde veya YAML yapılandırmasında map_config özelliğini kullanarak yapılandırılabilir.

Harita Yapılandırma Seçenekleri

map_config içindeki ayarlar, map_1, map_2 gibi anahtarlar kullanılarak harita indeksine göre uygulanır. Belirli bir harita altında aşağıdaki seçeneklerden herhangi biri tanımlanabilir:

Uyarı

Harita indeksleri, oluşturulma sırasına göre atanır ve en eski harita en düşük indeks alır, indeks 1'den başlar. Ancak, bir cihazda birden fazla harita ve bunların yapılandırmaları mevcutken çok katlı harita özelliği devre dışı bırakılırsa, o anda aktif olan harita otomatik olarak indeks 1 olarak yeniden atanır. Bu, daha önce farklı bir indeks altında yapılandırılmış bir haritanın aniden başka bir yapılandırmayı benimseyeceği anlamına gelir. map_1.

• rotation: Harita verileri içinde yapılandırılmış olan dönüşü geçersiz kılar ve bu kart için özel bir dönüş ile haritayı çizer, 0, 90, 180 veya 270 değerlerini kabul eder.
• scale: Haritanın orijinal boyutu ile kartın boyutu arasındaki fark temel alınarak yapılan otomatik ölçek hesaplamasını geçersiz kılar, 0.1 ile 20 arasındaki değerleri kabul eder.
• object_scale: Oda ve engel simgeleri gibi harita öğelerinin otomatik olarak hesaplanan boyutunu geçersiz kılar ve bunların daha büyük veya daha küçük görünmesini sağlar.
• opacity: Çizilen haritanın genel şeffaflığı. Başlangıç değeri 1 ve 0 değerine kadar değerleri kabul eder.
• object_opacity: Harita üzerinde çizilen öğelerin şeffaflığı, örneğin oda veya engel simgeleri. Başlangıç değeri 1 ve 0 değerine kadar değerleri kabul eder.
• font_size: etkinleştirilen öğeler üzerine gösterilen metin balonları için yazı tipi boyutu. 0 ile 12 arasındaki değerleri kabul eder.
• hidden_objects: Bu özel harita için global Gelişmiş Yapılandırma içinde tanımlanan gizli harita öğelerini geçersiz kılar.

Ortaya Hizalama ve Ölçekleme

Aşağıdaki parametreler, kartın haritayı çizmek için otomatik olarak hesapladığı boyut ve merkez koordinatlarını geçersiz kılmak için kullanılır.

Uyarı

Bu parametreler için sağlanan değerler, haritanın ham, ölçeklenmemiş boyutlarına göre verilmiştir, ekrandaki mutlak piksellere göre değil. Bu ilişkili koordinatları manuel olarak hesaplamak oldukça karmaşık olduğundan, gereken tam değerler görsel editörün Canlı Harita Bilgisi bölümünden çıkarılabilir.

• left: Haritanın otomatik olarak hesaplanan yatay merkezini geçersiz kılar. Örneğin, bu değeri 0 olarak ayarlamak, haritanın 0 koordinatını X ekseninde kartın yatay merkezine tam olarak yerleştirir. Bu nokta genellikle iskelenin hemen önünde bulunur.
• top: Haritanın otomatik olarak hesaplanan dikey merkezini geçersiz kılar. Örneğin, bu değeri 0 olarak ayarlamak, haritanın 0 koordinatını Y ekseninde kartın dikey merkezine tam olarak yerleştirir. Bu nokta genellikle iskelenin hemen önünde bulunur.
• width: Uyum hesaplamasında kullanılan haritanın gerçek genişliğinin üzerine yazılır. Kart, haritayı en büyük uygun boyuta göre ölçeklendirdiği için, haritanın gerçek genişliğinden daha büyük bir değer girilmesi haritayı kartın içinde küçültürken, daha küçük bir değer haritayı büyütecektir.
• height: Uyum hesaplamasında kullanılan haritanın gerçek yüksekliğinin üzerine yazılır. width özelliğine benzer şekilde, haritanın gerçek yüksekliğinden daha büyük bir değer girilmesi haritayı kartın içinde küçültürken, daha küçük bir değer haritayı büyütecektir.

YAML Örneği

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

Arka Plan ve Kaplama Görselleri

Kart, haritanın arkasına özel bir arka plan resmi çizimini destekler; bu, özellikle sürükleyici 3B kat planı panoları oluşturmak için faydalıdır. Bu davranış background_image özelliği kullanılarak yapılandırılır.

3D etkisini daha da artırmak için, isteğe bağlı bir overlay_image de sağlanabilir. Örtüşen görüntü, robotun temizlik yolunun hemen üzerine çizilir ve temel amacı, kat planında fiziksel duvarların veya mobilyaların arkasından geçen yolları görsel olarak gizlemektir. Hem bir arka plan hem de örtüşen bir görüntü kullanmak, 3D panolarda gerçekçi bir derinlik hissi elde etmek için şiddetle tavsiye edilir.

3D Kat Planı Tasarlamak

3D bir kat planı için özel grafikler oluştururken, tasarımın şeffaf arka planlı iki ayrı görüntü olarak dışa aktarılması gerekir: zeminler ve düşük mobilyaları içeren bir temel katman ve sadece üst duvarları içeren bir üst katman.

Aşağıdaki örnek görüntüler, şeffaf alanlarını vurgulamak için dama tahtası deseni üzerinde gösterilmiş olup, ücretsiz iç tasarım uygulaması Sweet Home 3D kullanılarak oluşturulmuş ve ardından zemin alanlarını kaldırmak ve gereken şeffaf kısımları oluşturmak için standart görüntü düzenleme yazılımında işlenmiştir.

Arkaplan Imajı

Kaplama Imajı

background_image ve overlay_image, kat planını hizalamak için aşağıdaki özellikleri destekler:

• url: Görüntünün yolu, örneğin /local/first_floor_bg.
• opacity: Görüntünün şeffaflığı. Başlangıç değeri 1'dir ve 0'ye kadar değerleri kabul eder.

Görüntülerin Ortalanması ve Ölçeklendirilmesi

Görüntüler için left, top, width ve height özellikleri, haritanın kendi Ortaya Hizalama ve Ölçekleme yapılandırması ile tamamen aynı göreceli koordinat mantığını kullanır. Bu özellikler tamamen isteğe bağlıdır.

Özelleştirilmiş görüntü harita boyutuyla mükemmel şekilde eşleşse bile, en az top ve left değerlerini sağlamak şiddetle tavsiye edilir. Bu, gelecekte haritanın toplam boyutu değişirse, özelleştirilmiş görüntünün aynı göreceli konumda güvenli bir şekilde sabit kalmasını sağlar.

Varsayılan Değerler

Bu değerler sağlanmadığında, kart özel resmin boyutunu ve merkezini harita verileri ile otomatik olarak eşitler. Bu özellikler tamamen isteğe bağlıdır ve yalnızca bu davranışı geçersiz kılmak, özel resmin kaymasını veya ölçeğinin harita zamanla genişleyip küçüldüğünde değişmesini önlemek için vardır.

• left: Görüntünün yatay merkezini haritanın merkezine göre tanımlar. Örneğin, bu değeri 0 olarak ayarlamak, haritanın 0 koordinatını X ekseninde tam olarak görüntünün yatay merkezine yerleştirir. Bu nokta genellikle rıhtımın tam önünde bulunur.
• top: Görüntünün dikey merkezini haritanın merkezine göre tanımlar. Örneğin, bu değeri 0 olarak ayarlamak, haritanın 0 koordinatını Y ekseninde tam olarak görüntünün dikey merkezine yerleştirir. Bu nokta genellikle rıhtımın tam önünde bulunur.
• width: Görüntünün genişliğini, mutlak ekran pikseli yerine haritanın orijinal, ölçeklenmemiş koordinat sistemine göre tanımlar. Örneğin, bu değeri haritanın ham genişliği ile eşleştirmek, görüntünün harita verileri ile tam olarak aynı yatay alanı kapsayacak şekilde orantılı olarak ölçeklenmesini sağlar.
• height: Görüntünün yüksekliğini, haritanın orijinal, ölçeklenmemiş koordinat sistemine göre tanımlar. Örneğin, bu değeri haritanın ham yüksekliği ile eşleştirmek, görüntünün harita verileri ile tam olarak aynı dikey alanı kapsayacak şekilde orantılı olarak ölçeklenmesini sağlar.

Yerel Döndürme

Özel görüntülerin kendi bağımsız döndürme özelliği yoktur; döndürmeleri doğası gereği haritanın döndürmesine bağlıdır. Tüm görünümler arasında hizalamanın sağlanabilmesi için tasarlanan görüntünün temel yönelimi, 0 dereceye ayarlandığında haritanın başlangıç yönelimi ile tam olarak eşleşmelidir.

Cihaz Piksel Oranı (DPR)

Kart, haritayı cihazın ekran piksel oranına göre render eder. Arka plan ve üst üste binen görüntülerin, mobil telefonlar gibi yüksek çözünürlüklü ekranlarda bulanık görünmesini önlemek için, bu görüntülerin masaüstü panosu için gereken boyutun en az iki katı olarak sağlanması şiddetle tavsiye edilir.

Görüntü Boyutunu Belirleme

Harita verileri, bir pikselin gerçek dünyada kaç milimetreyi temsil ettiğini gösteren grid_size özelliğini içerir. Bu değeri Canlı Harita Bilgisi bölümünde bulabilirsiniz. Örneğin, 50 olan bir grid_size, her pikselin 50 mm veya 5 cm'ye karşılık geldiği anlamına gelir. Evlerin gerçek dünya boyutlarını bu grid_size'ya bölerek, yapılandırmaya girilecek doğru width ve height değerleri hassas bir şekilde hesaplanabilir ve 1:1 kat planı görüntüsünün evin gerçek dünya boyutuyla mükemmel şekilde ölçeklenmesini sağlar.

YAML Örneği

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