Персонализирана конфигурация на картата

Подравняването, мащабът и фоновото изображение могат да се конфигурират независимо за всяка запазена карта на устройството.

Тези настройки могат да се конфигурират в визуалния редактор чрез избиране на карта от списъка с карти или чрез използване на свойството map_config в YAML конфигурацията.

Опции за конфигурация на карта

Настройките в map_config се прилагат за всеки индекс на карта, като се използват ключове като map_1, map_2 и т.н. Всяка от следните опции може да бъде дефинирана под конкретна карта:

Предупреждение

Индексите на картите се присвояват въз основа на реда на създаване, като най-старата карта получава най-нисък индекс, започвайки от 1. Въпреки това, ако функцията за многоетажност на картата е деактивирана на устройство, което има няколко карти и техните конфигурации, текущо активната карта автоматично се присвоява на индекс 1. Това означава, че карта, която преди е била конфигурирана под различен индекс, внезапно ще приеме конфигурацията на map_1.

• rotation: Замества ротацията, конфигурирана в данните на картата, за да се нарисува картата с персонализирана ротация, специфична за тази карта, като приема стойности 0, 90, 180 или 270.
• scale: Замества автоматичното изчисляване на мащаба въз основа на разликата между оригиналния размер на картата и размера на картата, като приема стойности между 0.1 и 20.
• object_scale: Замества автоматично изчисления размер на обектите на картата, като икони на стаи и препятствия, позволявайки им да се показват по-големи или по-малки.
• opacity: Глобална прозрачност на нарисуваната карта. Първоначалната стойност е 1 и приема стойности до 0.
• object_opacity: Прозрачност на обектите, нарисувани на картата, като икони на стаи или препятствия. Първоначалната стойност е 1 и приема стойности до 0.
• font_size: Размер на шрифта за текстови балончета, показвани над активирани обекти. Приема стойности между 0 и 12.
• hidden_objects: Замества скритите обекти на картата, дефинирани в глобалния Разширена конфигурация за тази конкретна карта.

Центриране и мащабиране

По-долу посочените параметри се използват за презаписване на размера и централните координати, които картата автоматично изчислява, за да нарисува картата.

Предупреждение

Стойностите, предоставени за тези параметри, са относителни спрямо суровите, несвити размери на картата, а не спрямо абсолютните пиксели на екрана. Поради факта, че ръчното изчисляване на тези относителни координати е много сложно, точните необходими стойности могат да бъдат извлечени чрез секцията Информация за живата карта на визуалния редактор.

• left: Замества автоматично изчисления хоризонтален център на картата. Например, задаването на тази стойност на 0 поставя координатата 0 на картата по X-оста точно в хоризонталния център на картата. Тази точка обикновено се намира точно пред кея.
• top: Замества автоматично изчисления вертикален център на картата. Например, задаването на тази стойност на 0 поставя координатата 0 на картата по Y-оста точно във вертикалния център на картата. Тази точка обикновено се намира точно пред кея.
• width: Замества реалната ширина на картата, използвана за изчисляване на прилягането. Тъй като картата мащабира картата въз основа на най-голямото подходящо измерение, въвеждането на стойност, по-голяма от реалната ширина на картата, ще свие картата вътре в картата, докато по-малка стойност ще я увеличи.
• height: Замества реалната височина на картата, използвана за изчисляване на прилягането. Подобно на свойството width, въвеждането на стойност, по-голяма от реалната височина на картата, ще свие картата вътре в картата, докато по-малка стойност ще я увеличи.

Пример с YAML

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

Фонови и наслагващи се изображения

Картата поддържа рендиране на персонализирано фоново изображение зад картата, което е особено полезно за създаване на завладяващи табла с 3D план на етажа. Това поведение се конфигурира с помощта на свойството background_image.

За да се подобри допълнително 3D ефектът, може да се предостави и по избор overlay_image. Наслоеното изображение се рисува директно върху пътя на почистване на робота и основната му цел е визуално да скрие пътищата, които преминават зад физически стени или мебели във флоплана. Препоръчително е комбинирането на фоново и наслаено изображение за постигане на реалистично усещане за дълбочина в 3D таблата.

Проектиране на 3D етажен план

При създаване на персонализирана графика за 3D етажен план, дизайнът трябва да бъде експортиран като две отделни изображения с прозрачни фонове: базов слой съдържащ подовете и ниската мебелировка и горен слой съдържащ само горните стени.

Примерните изображения по-долу, показани върху шахматен фон, за да се подчертаят техните прозрачни области, бяха генерирани с помощта на безплатното приложение за интериорен дизайн Sweet Home 3D и впоследствие обработени в стандартен софтуер за редактиране на изображения, за да се премахнат подовите участъци и да се създадат необходимите прозрачни части.

Фоново изображение

Изображение за наслагване

background_image и overlay_image поддържат следните свойства за подравняване на план на пода:

• url: Път на изображението, като например /local/first_floor_bg.
• opacity: Прозрачност на изображението. Началната стойност е 1 и приема стойности до 0.

Центриране и мащабиране на изображения

Свойствата left, top, width и height за изображения се използват с точно същата логика на относителни координати като собствената конфигурация на картата Центриране и мащабиране. Тези свойства са напълно по избор.

Дори ако персонализираното изображение напълно съвпада с размера на картата, силно се препоръчва да се предоставят поне стойности за top и left. Това гарантира, че ако общият размер на картата се промени в бъдеще, персонализираното изображение остава надеждно закрепено на същото относително място.

Стойности по подразбиране

Когато тези стойности не са предоставени, картата автоматично изравнява размера и центъра на персонализираното изображение с данните на картата. Тези свойства са напълно по избор и съществуват единствено, за да презапишат това поведение, предотвратявайки преместването на персонализираното изображение или промяната на мащаба му в случай че картата се разширява или свива с течение на времето.

• left: Определя хоризонталния център на изображението спрямо центъра на картата. Например, задавайки тази стойност на 0, координатата 0 на картата по оста X се поставя точно в хоризонталния център на изображението. Тази точка обикновено се намира точно пред кея.
• top: Определя вертикалния център на изображението спрямо центъра на картата. Например, задавайки тази стойност на 0, координатата 0 на картата по оста Y се поставя точно в вертикалния център на изображението. Тази точка обикновено се намира точно пред кея.
• width: Определя ширината на изображението спрямо оригиналната, немащабирана координатна система на картата, вместо спрямо абсолютни пиксели на екрана. Например, задаването на тази стойност да съвпада с оригиналната ширина на картата гарантира, че изображението ще бъде мащабирано пропорционално, за да покрие точно същата хоризонтална област като данните на картата.
• height: Определя височината на изображението спрямо оригиналната, немащабирана координатна система на картата. Например, задаването на тази стойност да съвпада с оригиналната височина на картата гарантира, че изображението ще бъде мащабирано пропорционално, за да покрие точно същата вертикална област като данните на картата.

Родно завъртане

Персонализираните изображения нямат собствено независимо свойство за въртене; тяхното въртене е неразривно свързано с въртенето на картата. За да се осигури подравняване във всички изгледи, основната ориентация на проектираното изображение трябва точно да съвпада с началната ориентация на картата, когато е зададена на 0 градуса.

Съотношение на пикселите на устройството (DPR)

Картата се изобразява според съотношението на пикселите на екрана на устройството. За да се предотврати размазването на фоновите и наслагващите се изображения на дисплеи с висока резолюция, като мобилни телефони, силно се препоръчва тези изображения да бъдат предоставени поне с два пъти по-голям размер от необходимия за таблото на десктоп.

Определяне на размера на изображението

Данните за картата включват свойство grid_size, което показва колко милиметра представлява един пиксел в реалния свят. Тази стойност може да бъде намерена в секцията Информация за живата карта. Например, grid_size от 50 означава, че всеки пиксел съответства на 50 мм или 5 см. Като се разделят реалните размери на дома с този grid_size, точните стойности width и height, които трябва да се въведат в конфигурацията, могат да бъдат точно изчислени, гарантирайки, че изображението на план на етажа в мащаб 1:1 се мащабира перфектно с реалния размер на дома.

Пример с YAML

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