कस्टम मैप कॉन्फ़िगरेशन

प्रत्येक सहेजे गए मानचित्र के लिए संरेखण, आकार और पृष्ठभूमि छवि को स्वतंत्र रूप से कॉन्फ़िगर किया जा सकता है।

इन सेटिंग्स को दृश्य संपादक में मानचित्र सूची से किसी मानचित्र का चयन करके या YAML कॉन्फ़िगरेशन में map_config गुण का उपयोग करके कॉन्फ़िगर किया जा सकता है।

मानचित्र कॉन्फ़िगरेशन विकल्प

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 फ़्लोरप्लान के लिए कस्टम ग्राफिक्स बनाना होता है, तो डिज़ाइन को दो अलग-अलग पारदर्शी पृष्ठभूमि वाली इमेज के रूप में निर्यात करना चाहिए: एक बेस लेयर जिसमें फर्श और निम्न फर्नीचर शामिल हैं और एक शीर्ष लेयर जिसमें केवल ऊपरी दीवारें शामिल हैं।

नीचे दिए गए उदाहरण चित्र, जिन्हें उनके पारदर्शी क्षेत्रों को हाइलाइट करने के लिए चेकरबोर्ड पैटर्न पर दिखाया गया है, को मुफ्त इंटीरियर डिज़ाइन एप्लिकेशन स्वीट होम 3D का उपयोग करके उत्पन्न किया गया था और बाद में मानक इमेज एडिटिंग सॉफ़्टवेयर में फ़र्श क्षेत्रों को हटाने और आवश्यक पारदर्शी हिस्से बनाने के लिए प्रक्रिया की गई।

पृष्ठभूमि छवि

ओवरले छवि

background_image और overlay_image निम्नलिखित गुणों का समर्थन करते हैं ताकि फ्लोरप्लान को संरेखित किया जा सके:

• url: चित्र का पथ, जैसे /local/first_floor_bg.
• opacity: चित्र की पारदर्शिता। प्रारंभिक मान 1 है और यह 0 तक के मान स्वीकार करता है।

चित्रों को केन्द्रित और स्केल करना

छवियों के लिए left, top, width और height गुण वही सापेक्ष निर्देशांक तर्क (relative coordinate logic) का उपयोग करते हैं जैसा कि मानचित्र के अपने केंद्रित करना और स्केलिंग कॉन्फ़िगरेशन में है। ये गुण पूरी तरह से वैकल्पिक हैं।

भले ही कस्टम चित्र पूरी तरह से मानचित्र के आकार से मेल खाता हो, फिर भी कम से कम 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