Tilpasset Kartkonfigurasjon

Justeringen, skalaen og bakgrunnsbildet kan konfigureres uavhengig for hvert lagrede kart på enheten.

Disse innstillingene kan konfigureres i den visuelle editoren ved å velge et kart fra kartlisten, eller ved å bruke map_config-egenskapen i YAML-konfigurasjonen.

Kartkonfigurasjonsalternativer

Innstillingene inne i map_config brukes per kartindeks ved bruk av nøkler som map_1, map_2, osv. Enhver av følgende alternativer kan defineres under et spesifikt kart:

Advarsel

Kartindekser tildeles basert på opprettelsesrekkefølgen, med det eldste kartet som får lavest indeks, startende fra 1. Men hvis funksjonen for kart med flere etasjer er deaktivert på en enhet som har flere kart og deres konfigurasjoner, blir det nåværende aktive kartet automatisk tilordnet indeks 1. Dette betyr at et kart som tidligere var konfigurert under en annen indeks plutselig vil adoptere konfigurasjonen til map_1.

• rotation: Overstyrer rotasjonen konfigurert i kartdataene for å tegne kartet i en egendefinert rotasjon spesifikk for dette kortet, og aksepterer verdier på 0, 90, 180 eller 270.
• scale: Overstyrer den automatiske skalaberegningen basert på forskjellen mellom kartets opprinnelige størrelse og kortets størrelse, og aksepterer verdier mellom 0.1 og 20.
• object_scale: Overstyrer den automatisk beregnede størrelsen på kartobjekter, som rom- og hinderikoner, slik at de kan vises større eller mindre.
• opacity: Global gjennomsiktighet for det tegnete kartet. Startverdien er 1 og den aksepterer verdier ned til 0.
• object_opacity: Gjennomsiktighet for objektene tegnet på kartet, som rom- eller hinderikoner. Startverdien er 1 og den aksepterer verdier ned til 0.
• font_size: Skriftstørrelse for tekstbobler vist over aktiverte objekter. Den aksepterer verdier mellom 0 og 12.
• hidden_objects: Overstyrer de skjulte kartobjektene definert i den globale Avansert konfigurasjon for dette spesifikke kartet.

Sentrering og skalering

Parametrene nedenfor brukes til å overstyre størrelsen og midtkoordinatene som kortet automatisk beregner for å tegne kartet.

Advarsel

Verdiene som gis for disse parameterne er relative til kartets rå, uskalierte dimensjoner, ikke de absolutte pikslene på skjermen. Fordi det er svært komplekst å beregne disse relative koordinatene manuelt, kan de nøyaktige verdiene som trengs hentes fra Live kartinformasjon-delen av den visuelle editoren.

• left: Overstyrer det automatisk beregnede horisontale sentrumet til kartet. For eksempel, ved å sette denne verdien til 0, plasseres kartets 0-koordinat på X-aksen nøyaktig i kortets horisontale sentrum. Dette punktet er vanligvis plassert rett foran kaien.
• top: Overstyrer det automatisk beregnede vertikale sentrumet til kartet. For eksempel, ved å sette denne verdien til 0, plasseres kartets 0-koordinat på Y-aksen nøyaktig i kortets vertikale sentrum. Dette punktet er vanligvis plassert rett foran kaien.
• width: Overstyrer kartets faktiske bredde brukt for tilpasningsberegningen. Fordi kortet skalerer kartet basert på den største tilpassede dimensjonen, vil det å angi en verdi som er større enn kartets faktiske bredde krympe kartet inne i kortet, mens en mindre verdi vil forstørre det.
• height: Overstyrer kartets faktiske høyde brukt for tilpasningsberegningen. På samme måte som width-egenskapen, vil det å angi en verdi som er større enn kartets faktiske høyde krympe kartet inne i kortet, mens en mindre verdi vil forstørre det.

YAML-eksempel

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

Bakgrunns- og Overlay-bilder

Kortet støtter rendering av et egendefinert bakgrunnsbilde bak kartet, noe som er spesielt nyttig for å lage engasjerende 3D-gulvplansdashboards. Denne oppførselen konfigureres ved å bruke background_image-egenskapen.

For å ytterligere forbedre 3D-effekten, kan et valgfritt overlay_image også legges til. Overlegg-bildet tegnes direkte oppå robotens rengjøringsbane, og dets primære formål er å visuelt skjule baner som går bak fysiske vegger eller møbler i plantegningen. Det anbefales på det sterkeste å kombinere både et bakgrunnsbilde og et overlegg-bilde for å oppnå en realistisk følelse av dybde i 3D-dashboards.

Lage en 3D-plantegning

Når man lager tilpasset grafikk for en 3D-plantegning, må designet eksporteres som to separate bilder med transparente bakgrunner: et baselag som inneholder gulvene og lave møbler, og et toppslag som kun inneholder de øvre veggene.

Eksempelbildene nedenfor, vist over et sjakkbrettmønster for å fremheve deres gjennomsiktige områder, ble generert ved hjelp av den gratis interiørdesignapplikasjonen Sweet Home 3D og deretter behandlet i standard bildebehandlingsprogramvare for å fjerne gulvområdene og lage de nødvendige gjennomsiktige delene.

Bakgrunnsbilde

Overleggsbilde

background_image og overlay_image støtter følgende egenskaper for å justere plantegningen:

• url: Bane til bildet, slik som /local/first_floor_bg.
• opacity: Gjennomsiktighet i bildet. Startverdien er 1 og aksepterer verdier ned til 0.

Sentrering og skalering av bilder

left, top, width og height egenskaper for bilder fungerer ved å bruke nøyaktig samme relative koordinatlogikk som kartets egen Sentrering og skalering-konfigurasjon. Disse egenskapene er helt valgfrie.

Selv om det tilpassede bildet passer perfekt til kartstørrelsen, anbefales det sterkt å oppgi minst top og left-verdier. Dette sikrer at hvis kartets totale størrelse endres i fremtiden, forblir det tilpassede bildet trygt festet til samme relative posisjon.

Standardverdier

Når disse verdiene ikke oppgis, balanserer kortet automatisk størrelsen og midten av det tilpassede bildet med kartdataene. Disse egenskapene er helt valgfrie og finnes kun for å overstyre denne oppførselen, og forhindrer at det tilpassede bildet flytter seg eller at skalaen endres hvis kartet utvider eller krymper over tid.

• left: Definerer det horisontale sentrum av bildet i forhold til kartets sentrum. For eksempel, ved å sette denne verdien til 0 plasseres kartets 0-koordinat på X-aksen nøyaktig i det horisontale sentrum av bildet. Dette punktet er vanligvis plassert rett foran kaien.
• top: Definerer det vertikale sentrum av bildet i forhold til kartets sentrum. For eksempel, ved å sette denne verdien til 0 plasseres kartets 0-koordinat på Y-aksen nøyaktig i det vertikale sentrum av bildet. Dette punktet er vanligvis plassert rett foran kaien.
• width: Definerer bredden på bildet i forhold til kartets opprinnelige, ikke-skalerte koordinatsystem, snarere enn absolutte skjermpiksler. For eksempel, ved å sette denne verdien til å matche kartets råbredde, sikrer man at bildet skaleres proporsjonalt for å dekke nøyaktig samme horisontale område som kartdataene.
• height: Definerer høyden på bildet i forhold til kartets opprinnelige, ikke-skalerte koordinatsystem. For eksempel, ved å sette denne verdien til å matche kartets råhøyde, sikrer man at bildet skaleres proporsjonalt for å dekke nøyaktig samme vertikale område som kartdataene.

Native rotasjon

Egendefinerte bilder har ikke sin egen uavhengige rotasjonsegenskap; deres rotasjon er iboende knyttet til kartets rotasjon. For å sikre samsvar på tvers av alle visninger, må basisorienteringen til det designede bildet nøyaktig matche kartets opprinnelige orientering når den settes til 0 grader.

Enhets pikselforhold (DPR)

Kortet gjengir kartet i henhold til enhetens skjermpiksel-forhold. For å forhindre at bakgrunns- og overlegg-bilder blir uklare på høyoppløselige skjermer som mobiltelefoner, anbefales det på det sterkeste å levere disse bildene med minst dobbelt så stor størrelse som på skrivebordsdashbordet.

Bestemme bildestørrelse

Kartdataene inkluderer en grid_size-egenskap som angir hvor mange millimeter en enkelt piksel representerer i den virkelige verden. Denne verdien kan finnes i Live kartinformasjon-seksjonen. For eksempel betyr en grid_size på 50 at hver piksel tilsvarer 50 mm, eller 5 cm. Ved å dele de faktiske dimensjonene til hjemmet med denne grid_size, kan de nøyaktige width og height-verdiene som skal tastes inn i konfigurasjonen beregnes nøyaktig, og sikrer at et 1:1 gulvplansbilde skaleres perfekt med den virkelige størrelsen på hjemmet.

YAML-eksempel

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