Tilpasset kortkonfiguration

Justeringen, skalaen og baggrundsbilledet kan konfigureres uafhængigt for hver gemt kort på enheden.

Disse indstillinger kan konfigureres i den visuelle editor ved at vælge et kort fra kortlisten eller ved at bruge map_config-egenskaben i YAML-konfigurationen.

Kortkonfigurationsmuligheder

Indstillingerne inde i map_config anvendes pr. kortindeks ved hjælp af nøgler som map_1, map_2 osv. Enhver af følgende muligheder kan defineres under et specifikt kort:

Advarsel

Kortindekser tildeles baseret på deres oprettelsesrækkefølge, hvor det ældste kort modtager det laveste indeks, startende fra 1. Hvis multi-etage funktionen dog er deaktiveret på en enhed, der har flere kort og deres konfigurationer, tildeles det aktuelt aktive kort automatisk til indeks 1. Dette betyder, at et kort, som tidligere var konfigureret under et andet indeks, pludselig vil overtage konfigurationen af map_1.

• rotation: Overskriver rotationen, der er konfigureret i kortdataene, for at tegne kortet i en brugerdefineret rotation specifik for dette kort, med værdierne 0, 90, 180 eller 270.
• scale: Overskriver den automatiske skaleringsberegning baseret på forskellen mellem kortets oprindelige størrelse og kortets størrelse, med værdier mellem 0.1 og 20.
• object_scale: Overskriver den automatisk beregnede størrelse af kortobjekter, såsom rum- og forhindringsikoner, så de kan vises større eller mindre.
• opacity: Global gennemsigtighed for det tegnede kort. Startværdien er 1 og den accepterer værdier ned til 0.
• object_opacity: Gennemsigtighed for objekterne, der tegnes på kortet, såsom rum- eller forhindringsikoner. Startværdien er 1 og den accepterer værdier ned til 0.
• font_size: Skriftstørrelse for talebobler vist over aktiverede objekter. Den accepterer værdier mellem 0 og 12.
• hidden_objects: Overskriver de skjulte kortobjekter, der er defineret i den globale Avanceret konfiguration, for dette specifikke kort.

Centrering og skalering

De nedenstående parametre bruges til at tilsidesætte den størrelse og de centerkoordinater, som kortet automatisk beregner for at tegne kortet.

Advarsel

De værdier, der gives for disse parametre, er relative i forhold til kortets rå, uskalede dimensioner og ikke de absolutte pixels på skærmen. Da det er meget komplekst at beregne disse relative koordinater manuelt, kan de nøjagtige værdier, der er nødvendige, udtrækkes ved hjælp af Live kortinformation-sektionen i den visuelle editor.

• left: Tilsidesætter kortets automatisk beregnede horisontale center. For eksempel, hvis denne værdi sættes til 0, placeres kortets 0-koordinat på X-aksen præcist i kortets horisontale center. Dette punkt er typisk placeret lige foran kajen.
• top: Tilsidesætter kortets automatisk beregnede vertikale center. For eksempel, hvis denne værdi sættes til 0, placeres kortets 0-koordinat på Y-aksen præcist i kortets vertikale center. Dette punkt er typisk placeret lige foran kajen.
• width: Overskriver kortets faktiske bredde, der bruges til tilpasningsberegningen. Fordi kortet skalerer kortet baseret på den største passende dimension, vil indtastning af en værdi større end kortets faktiske bredde formindske kortet inde i kortet, mens en mindre værdi vil forstørre det.
• height: Overskriver kortets faktiske højde, der bruges til tilpasningsberegningen. Ligesom width-egenskaben, vil indtastning af en værdi større end kortets faktiske højde formindske kortet inde i kortet, mens en mindre værdi 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

Baggrunds- og overlaybilleder

Kortet understøtter gengivelse af et brugerdefineret baggrundsbillede bag kortet, hvilket er særligt nyttigt til at skabe immersive 3D-gulvplansdashboard. Denne funktion konfigureres ved hjælp af background_image-egenskaben.

For yderligere at forbedre 3D-effekten kan der også leveres et valgfrit overlay_image. Overlay-billedet tegnes direkte oven på robotens rengøringssti, og dets primære formål er visuelt at skjule stier, der går bag fysiske vægge eller møbler i plantegningen. Kombination af både et baggrundsbillede og et overlay-billede anbefales stærkt for at opnå en realistisk følelse af dybde i 3D-dashboard.

Design af en 3D-plantegning

Når man opretter brugerdefinerede grafik til en 3D-plantegning, skal designet eksporteres som to separate billeder med transparente baggrunde: et bundlag, der indeholder gulve og lave møbler, og et top lag, der kun indeholder de øvre vægge.

Eksempelbillederne nedenfor, vist over et skakternet mønster for at fremhæve deres gennemsigtige områder, blev genereret ved hjælp af den gratis indretningsapplikation Sweet Home 3D og efterfølgende behandlet i standard billedredigeringssoftware for at fjerne gulvområderne og skabe de nødvendige gennemsigtige dele.

Baggrundsbillede

Overlejringsbillede

background_image og overlay_image understøtter følgende egenskaber for at justere plantegningen:

• url: Billedets sti, såsom /local/first_floor_bg.
• opacity: Billedets gennemsigtighed. Startværdien er 1, og den accepterer værdier ned til 0.

Centrering og skalering af billeder

left, top, width og height egenskaberne for billeder fungerer ved hjælp af den samme relative koordinatlogik som kortets egne Centrering og skalering-indstillinger. Disse egenskaber er helt valgfrie.

Selvom det tilpassede billede perfekt matcher kortets størrelse, anbefales det kraftigt at angive mindst top og left værdier. Dette sikrer, at hvis kortets samlede størrelse ændres i fremtiden, forbliver det tilpassede billede sikkert fastgjort til den samme relative placering.

Standardværdier

Når disse værdier ikke angives, udligner kortet automatisk størrelsen og centrum af det tilpassede billede med kortdataene. Disse egenskaber er fuldstændigt valgfrie og eksisterer udelukkende for at tilsidesætte denne adfærd, hvilket forhindrer det tilpassede billede i at flytte sig eller ændre størrelse, hvis kortet udvider eller skrumper over tid.

• left: Definerer det vandrette centrum af billedet i forhold til kortets centrum. For eksempel placerer indstilling af denne værdi til 0 kortets 0-koordinat på X-aksen præcist i billedets vandrette centrum. Dette punkt er typisk placeret lige foran kajen.
• top: Definerer det lodrette centrum af billedet i forhold til kortets centrum. For eksempel placerer indstilling af denne værdi til 0 kortets 0-koordinat på Y-aksen præcist i billedets lodrette centrum. Dette punkt er typisk placeret lige foran kajen.
• width: Definerer bredden af billedet i forhold til kortets oprindelige, ikke-skalerede koordinatsystem, snarere end absolutte skærmpixels. For eksempel sikrer det at sætte denne værdi til at matche kortets rå bredde, at billedet bliver skaleret proportionalt for at dække præcis det samme horisontale område som kortdataene.
• height: Definerer højden af billedet i forhold til kortets oprindelige, ikke-skalerede koordinatsystem. For eksempel sikrer det at sætte denne værdi til at matche kortets rå højde, at billedet bliver skaleret proportionalt for at dække præcis det samme vertikale område som kortdataene.

Original Rotation

Tilpassede billeder har ikke deres egen uafhængige rotationsfunktion; deres rotation er iboende knyttet til kortets rotation. For at sikre justering på tværs af alle visninger, skal grundorienteringen af det designede billede nøjagtigt matche kortets oprindelige orientering, når den er sat til 0 grader.

Enheds Pixel Ratio (DPR)

Kortet gengiver kortet i henhold til enhedens skærmpixelratio. For at forhindre, at baggrunds- og overlaybilleder fremstår slørede på højopløsningsskærme såsom mobiltelefoner, anbefales det kraftigt at levere disse billeder i mindst dobbelt størrelse af den krævede størrelse på skrivebordsdashboardet.

Bestemmelse af billedstørrelse

Kortdataene inkluderer en grid_size-egenskab, der angiver, hvor mange millimeter en enkelt pixel repræsenterer i den virkelige verden. Denne værdi kan findes i Live kortinformation-sektionen. For eksempel betyder en grid_size på 50, at hver pixel svarer til 50 mm eller 5 cm. Ved at dividere hjemmets virkelige dimensioner med denne grid_size, kan de præcise width og height-værdier, der skal indtastes i konfigurationen, beregnes nøjagtigt, hvilket sikrer, at et 1:1-gulvplanbillede skaleres perfekt med hjemmets faktiske størrelse.

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