Aangepaste Kaartconfiguratie

De uitlijning, schaal en achtergrondafbeelding kunnen onafhankelijk worden ingesteld voor elke opgeslagen kaart op het apparaat.

Deze instellingen kunnen worden geconfigureerd in de visuele editor door een kaart te selecteren uit de kaartlijst, of door de map_config-eigenschap in de YAML-configuratie te gebruiken.

Kaartconfiguratie-opties

De instellingen in map_config worden per kaartindex toegepast met sleutels zoals map_1, map_2, enz. Een van de volgende opties kan worden gedefinieerd onder een specifieke kaart:

Waarschuwing

Kaartindexen worden toegewezen op basis van de volgorde van aanmaak, waarbij de oudste kaart de laagste index krijgt, beginnend vanaf 1. Als echter de multi-verdiepingkaartenfunctie is uitgeschakeld op een apparaat dat meerdere kaarten en hun configuraties bevat, wordt de momenteel actieve kaart automatisch opnieuw toegewezen aan index 1. Dit betekent dat een kaart die eerder onder een andere index was geconfigureerd, plotseling de configuratie van map_1.

• rotation: Overschrijft de rotatie die is ingesteld in de kaartgegevens om de kaart te tekenen in een aangepaste rotatie specifiek voor deze kaart, met waarden 0, 90, 180 of 270.
• scale: Overschrijft de automatische schaalberekening op basis van het verschil tussen de oorspronkelijke grootte van de kaart en de grootte van de kaart, met waarden tussen 0.1 en 20.
• object_scale: Overschrijft de automatisch berekende grootte van kaartobjecten, zoals kamer- en obstakelpictogrammen, zodat deze groter of kleiner kunnen verschijnen.
• opacity: Globale transparantie van de getekende kaart. De beginwaarde is 1 en het accepteert waarden tot 0.
• object_opacity: Transparantie van de objecten die op de kaart zijn getekend, zoals kamer- of obstakelpictogrammen. De beginwaarde is 1 en het accepteert waarden tot 0.
• font_size: Lettergrootte voor tekstballonnen die worden weergegeven boven geactiveerde objecten. Het accepteert waarden tussen 0 en 12.
• hidden_objects: Overschrijft de verborgen kaartobjecten die zijn gedefinieerd in de globale Geavanceerde Configuratie voor deze specifieke kaart.

Centreren en Schalen

De onderstaande parameters worden gebruikt om de grootte en de middencoördinaten te overschrijven die de kaart automatisch berekent om de kaart te tekenen.

Waarschuwing

De waarden die voor deze parameters worden opgegeven, zijn relatief ten opzichte van de ruwe, niet-geschaalde afmetingen van de kaart, niet de absolute pixels op het scherm. Omdat het handmatig berekenen van deze relatieve coördinaten zeer complex is, kunnen de exacte benodigde waarden worden geëxtraheerd met behulp van de Live Kaart Informatie-sectie van de visuele editor.

• left: Overschrijft het automatisch berekende horizontale midden van de kaart. Bijvoorbeeld, het instellen van deze waarde op 0 plaatst de 0-coördinaat van de kaart op de X-as precies in het horizontale midden van de kaart. Dit punt bevindt zich meestal direct voor de steiger.
• top: Overschrijft het automatisch berekende verticale midden van de kaart. Bijvoorbeeld, het instellen van deze waarde op 0 plaatst de 0-coördinaat van de kaart op de Y-as precies in het verticale midden van de kaart. Dit punt bevindt zich meestal direct voor de steiger.
• width: Overschrijft de werkelijke breedte van de kaart die wordt gebruikt voor de pasberekening. Omdat de kaart de kaart schaalt op basis van de grootste passende dimensie, zal het invoeren van een waarde die groter is dan de werkelijke breedte van de kaart de kaart in de kaart verkleinen, terwijl een kleinere waarde deze zal vergroten.
• height: Overschrijft de werkelijke hoogte van de kaart die wordt gebruikt voor de pasberekening. Net als bij de width-eigenschap zal het invoeren van een waarde die groter is dan de werkelijke hoogte van de kaart de kaart in de kaart verkleinen, terwijl een kleinere waarde deze zal vergroten.

YAML Voorbeeld

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

Achtergrond- en overlayafbeeldingen

De kaart ondersteunt het weergeven van een aangepaste achtergrondafbeelding achter de kaart, wat vooral handig is voor het creëren van meeslepende 3D-vloerplan dashboards. Dit gedrag wordt geconfigureerd met behulp van de background_image-eigenschap.

Om het 3D-effect verder te verbeteren, kan ook optioneel een overlay_image worden toegevoegd. De overlay-afbeelding wordt direct op het schoonmaakpad van de robot getekend en het belangrijkste doel is om visueel paden te verbergen die achter fysieke muren of meubels in de plattegrond lopen. Het combineren van zowel een achtergrond- als een overlay-afbeelding wordt sterk aanbevolen om een realistisch dieptegevoel in 3D-dashboards te bereiken.

Een 3D-plattegrond ontwerpen

Bij het maken van aangepaste grafische afbeeldingen voor een 3D-plattegrond, moet het ontwerp worden geëxporteerd als twee afzonderlijke afbeeldingen met transparante achtergronden: een basismalaag met de vloeren en lage meubels en een bovenlaag met alleen de bovenmuren.

De voorbeeldafbeeldingen hieronder, weergegeven over een dambordpatroon om hun transparante gebieden te benadrukken, zijn gegenereerd met de gratis interieurontwerpapplicatie Sweet Home 3D en vervolgens verwerkt in standaard beeldbewerkingssoftware om de vloergebieden te verwijderen en de vereiste transparante delen te maken.

Achtergrondafb.

Overlay-afbeelding

De background_image en overlay_image ondersteunen de volgende eigenschappen om het vloerplan uit te lijnen:

• url: Pad van de afbeelding, zoals /local/first_floor_bg.
• opacity: Transparantie van de afbeelding. De initiële waarde is 1 en accepteert waarden tot 0.

Afbeeldingen centreren en schalen

De left, top, width en height eigenschappen voor afbeeldingen werken met exact dezelfde relatieve coördinatenlogica als de Centreren en Schalen-configuratie van de kaart zelf. Deze eigenschappen zijn volledig optioneel.

Zelfs als de aangepaste afbeelding perfect overeenkomt met de grootte van de kaart, wordt het sterk aanbevolen om ten minste top en left waarden op te geven. Dit zorgt ervoor dat als de totale grootte van de kaart in de toekomst verandert, de aangepaste afbeelding veilig op dezelfde relatieve locatie blijft verankerd.

Standaardwaarden

Wanneer deze waarden niet worden opgegeven, past de kaart automatisch de grootte en het midden van de aangepaste afbeelding aan op de kaartgegevens. Deze eigenschappen zijn volledig optioneel en bestaan uitsluitend om dit gedrag te overschrijven, zodat de aangepaste afbeelding niet verschuift of de schaal verandert in het geval dat de kaart in de loop van de tijd groter of kleiner wordt.

• left: Bepaalt het horizontale midden van de afbeelding ten opzichte van het midden van de kaart. Bijvoorbeeld, het instellen van deze waarde op 0 plaatst de 0-coördinaat van de kaart op de X-as precies in het horizontale midden van de afbeelding. Dit punt bevindt zich meestal recht voor de aanlegsteiger.
• top: Bepaalt het verticale midden van de afbeelding ten opzichte van het midden van de kaart. Bijvoorbeeld, het instellen van deze waarde op 0 plaatst de 0-coördinaat van de kaart op de Y-as precies in het verticale midden van de afbeelding. Dit punt bevindt zich meestal recht voor de aanlegsteiger.
• width: Bepaalt de breedte van de afbeelding in verhouding tot het originele, niet-geschaalde coördinatensysteem van de kaart, in plaats van absolute schermpixels. Bijvoorbeeld, door deze waarde in te stellen zodat deze overeenkomt met de ruwe breedte van de kaart, wordt ervoor gezorgd dat de afbeelding proportioneel wordt geschaald om exact hetzelfde horizontale gebied als de kaartgegevens te beslaan.
• height: Bepaalt de hoogte van de afbeelding in verhouding tot het originele, niet-geschaalde coördinatensysteem van de kaart. Bijvoorbeeld, door deze waarde in te stellen zodat deze overeenkomt met de ruwe hoogte van de kaart, wordt ervoor gezorgd dat de afbeelding proportioneel wordt geschaald om exact hetzelfde verticale gebied als de kaartgegevens te beslaan.

Natuurlijke Rotatie

Aangepaste afbeeldingen hebben geen eigen onafhankelijke rotatie-eigenschap; hun rotatie is inherente verbonden met de rotatie van de kaart. Om uitlijning over alle weergaven te garanderen, moet de basisoriëntatie van de ontworpen afbeelding exact overeenkomen met de initiële oriëntatie van de kaart wanneer deze is ingesteld op 0 graden.

Apparaten Pixelverhouding (DPR)

De kaart rendert de kaart volgens de schermpixelverhouding van het apparaat. Om te voorkomen dat de achtergrond- en overlay-afbeeldingen wazig verschijnen op schermen met hoge resolutie, zoals mobiele telefoons, wordt sterk aanbevolen om deze afbeeldingen op zijn minst dubbel zo groot te leveren als vereist op het desktopdashboard.

Bepalen van afbeeldingsgrootte

De kaartgegevens bevatten een grid_size-eigenschap die aangeeft hoeveel millimeter een enkele pixel in de echte wereld vertegenwoordigt. Deze waarde is te vinden in de Live Kaart Informatie-sectie. Bijvoorbeeld, een grid_size van 50 betekent dat elke pixel overeenkomt met 50 mm, of 5 cm. Door de afmetingen van de woning in de echte wereld door dit grid_size te delen, kunnen de exacte width- en height-waarden die in de configuratie moeten worden ingevoerd nauwkeurig berekend worden, zodat een 1:1 plattegrondafbeelding perfect schaalt met de werkelijke afmetingen van de woning.

YAML Voorbeeld

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