Anpassad kartkonfiguration

Justeringen, skalan och bakgrundsbilden kan konfigureras oberoende för varje sparad karta på enheten.

Dessa inställningar kan konfigureras i den visuella redigeraren genom att välja en karta från kartlistan, eller genom att använda map_config-egenskapen i YAML-konfigurationen.

Kartkonfigurationsalternativ

Inställningarna inom map_config tillämpas per kartindex med hjälp av nycklar som map_1, map_2, etc. Något av följande alternativ kan definieras under en specifik karta:

Varning

Kartindex tilldelas baserat på deras skapandeordning, där den äldsta kartan får det lägsta indexet, med start från 1. Men om flervåningskartsfunktionen är inaktiverad på en enhet som har flera kartor och deras konfigurationer, tilldelas den för närvarande aktiva kartan automatiskt index 1. Detta innebär att en karta som tidigare konfigurerats under ett annat index plötsligt kommer att anta konfigurationen av map_1.

• rotation: Åsidosätter rotationen som är konfigurerad i kartdata för att rita kartan i en anpassad rotation specifik för detta kort, och accepterar värdena 0, 90, 180 eller 270.
• scale: Åsidosätter den automatiska skalberäkningen baserat på skillnaden mellan kartans ursprungliga storlek och kortets storlek, och accepterar värden mellan 0.1 och 20.
• object_scale: Åsidosätter den automatiskt beräknade storleken på kartobjekt, såsom rum- och hinderikoner, och tillåter dem att visas större eller mindre.
• opacity: Global transparens för den ritade kartan. Startvärdet är 1 och accepterar värden ner till 0.
• object_opacity: Transparens för objekten som ritas på kartan, såsom rum- eller hinderikoner. Startvärdet är 1 och accepterar värden ner till 0.
• font_size: Teckenstorlek för textbubblor som visas ovanför aktiverade objekt. Det accepterar värden mellan 0 och 12.
• hidden_objects: Åsidosätter de dolda kartobjekten som definieras i den globala Avancerad konfiguration för denna specifika karta.

Centrering och skalning

Parametrarna nedan används för att åsidosätta storleken och centralkoordinaterna som kortet automatiskt beräknar för att rita kartan.

Varning

De värden som anges för dessa parametrar är relativa till kartans råa, obeskalade dimensioner, inte de absoluta pixlarna på skärmen. Eftersom det är mycket komplext att manuellt beräkna dessa relativa koordinater, kan de exakta värden som behövs extraheras med hjälp av Live Map Information-avsnittet i visuella redigeraren.

• left: Åsidosätter det automatiskt beräknade horisontella centrumet av kartan. Till exempel, om detta värde sätts till 0 placeras kartans 0-koordinat på X-axeln exakt i det horisontella centrumet av kortet. Denna punkt ligger vanligtvis precis framför kajen.
• top: Åsidosätter det automatiskt beräknade vertikala centrumet av kartan. Till exempel, om detta värde sätts till 0 placeras kartans 0-koordinat på Y-axeln exakt i det vertikala centrumet av kortet. Denna punkt ligger vanligtvis precis framför kajen.
• width: Överskrider kartans faktiska bredd som används för anpassningsberäkningen. Eftersom kortet skalar kartan baserat på den största passande dimensionen, kommer det att krympa kartan inuti kortet om du anger ett värde som är större än kartans faktiska bredd, medan ett mindre värde kommer att förstora den.
• height: Överskrider kartans faktiska höjd som används för anpassningsberäkningen. Liknande width-egenskapen, kommer en större angiven höjd än kartans faktiska höjd att krympa kartan inuti kortet, medan en mindre höjd förstorar den.

YAML-exempel

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

Bakgrunds- och Overlay-bilder

Kortet stöder rendering av en anpassad bakgrundsbild bakom kartan, vilket är särskilt användbart för att skapa immersiva 3D-planritningsinstrumentpaneler. Detta beteende konfigureras med hjälp av background_image-egenskapen.

För att ytterligare förbättra 3D-effekten kan ett valfritt overlay_image också tillhandahållas. Överläggsbilden ritas direkt ovanpå robotens rengöringsbana och dess huvudsakliga syfte är att visuellt dölja banor som går bakom fysiska väggar eller möbler i planritningen. Att kombinera både en bakgrundsbild och en överläggsbild rekommenderas starkt för att uppnå en realistisk känsla av djup i 3D-instrumentpaneler.

Designa en 3D-planritning

När du skapar egen grafik för en 3D-planritning måste designen exporteras som två separata bilder med transparent bakgrund: ett baslager som innehåller golven och låga möbler och ett topplager som endast innehåller övre väggar.

Exempelbilderna nedan, som visas över ett schackbrädesmönster för att framhäva deras genomskinliga områden, skapades med den gratis inredningsapplikationen Sweet Home 3D och bearbetades därefter i standardprogramvara för bildredigering för att ta bort golvytorna och skapa de nödvändiga transparenta delarna.

Bakgrundsbild

Overlay-bild

background_image och overlay_image stöder följande egenskaper för att anpassa planlösningen:

• url: Sökväg till bilden, såsom /local/first_floor_bg.
• opacity: Bildens transparens. Startvärdet är 1 och det accepterar värden ner till 0.

Centrering och skalning av bilder

left, top, width och height egenskaper för bilder fungerar med exakt samma relativa koordinatlogik som kartans egen Centrering och skalning-konfiguration. Dessa egenskaper är helt frivilliga.

Även om den anpassade bilden perfekt matchar kartans storlek, rekommenderas det starkt att åtminstone ange top och left-värden. Detta säkerställer att om kartans totala storlek ändras i framtiden, förblir den anpassade bilden säkert placerad på samma relativa position.

Standardvärden

När dessa värden inte tillhandahålls, jämnar kortet automatiskt ut storleken och centrerar den anpassade bilden med kartdata. Dessa egenskaper är helt valfria och finns enbart för att åsidosätta detta beteende, för att förhindra att den anpassade bilden förskjuts eller att dess skala ändras om kartan expanderar eller krymper över tid.

• left: Definierar den horisontella centern av bilden relativt kartans centrum. Till exempel, att ange detta värde till 0 placerar kartans 0-koordinat på X-axeln exakt i bildens horisontella centrum. Denna punkt är vanligtvis belägen precis framför kajen.
• top: Definierar den vertikala centern av bilden relativt kartans centrum. Till exempel, att ange detta värde till 0 placerar kartans 0-koordinat på Y-axeln exakt i bildens vertikala centrum. Denna punkt är vanligtvis belägen precis framför kajen.
• width: Definierar bildens bredd i förhållande till kartans ursprungliga, icke-skalade koordinatsystem, snarare än absoluta skärm-pixlar. Till exempel, att ställa in detta värde för att matcha kartans råa bredd säkerställer att bilden skalas proportionerligt för att täcka exakt samma horisontella område som kartdata.
• height: Definierar bildens höjd i förhållande till kartans ursprungliga, icke-skalade koordinatsystem. Till exempel, att ställa in detta värde för att matcha kartans råa höjd säkerställer att bilden skalas proportionerligt för att täcka exakt samma vertikala område som kartdata.

Originalrotation

Anpassade bilder har ingen egen, oberoende rotations-egenskap; deras rotation är inneboende kopplad till kartans rotation. För att säkerställa att alla vyer är i linje måste den grundläggande orienteringen på den designade bilden exakt matcha kartans initiala orientering när den är inställd på 0 grader.

Enhets-pixelförhållande (DPR)

Kortet renderar kartan enligt enhetens skärmpixelkvot. För att förhindra att bakgrunds- och överläggsbilder blir suddiga på högupplösta skärmar, såsom mobiltelefoner, rekommenderas det starkt att tillhandahålla dessa bilder med minst dubbla storleken som krävs på skrivbordsinstrumentpanelen.

Bestämma bildstorlek

Kartdata inkluderar en grid_size-egenskap som anger hur många millimeter en enskild pixel representerar i verkligheten. Detta värde kan hittas i Live Map Information-avsnittet. Till exempel betyder en grid_size på 50 att varje pixel motsvarar 50 mm, eller 5 cm. Genom att dividera hemmets verkliga dimensioner med detta grid_size kan de exakta width- och height-värdena som ska anges i konfigurationen beräknas noggrant, vilket säkerställer att en 1:1 planritningsbild skalas perfekt med hemmets verkliga storlek.

YAML-exempel

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