การกำหนดค่าแผนที่ตามความต้องการ

การจัดแนว ขนาด และภาพพื้นหลังสามารถตั้งค่าได้อย่างอิสระสำหรับแผนที่ที่บันทึกไว้แต่ละแผนที่บนอุปกรณ์

การตั้งค่าเหล่านี้สามารถกำหนดได้ในโปรแกรมแก้ไขภาพโดยเลือกแผนที่จากรายการแผนที่ หรือโดยใช้คุณสมบัติ 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

เพื่อเพิ่มประสิทธิภาพของเอฟเฟกต์ 3 มิติ สามารถมี overlay_image เป็นตัวเลือกเพิ่มเติมได้เช่นกัน ภาพซ้อนทับจะถูกวาดโดยตรงบนเส้นทางทำความสะอาดของหุ่นยนต์ และจุดประสงค์หลักของมันคือเพื่อปกปิดเส้นทางที่ผ่านด้านหลังของผนังหรือเฟอร์นิเจอร์ในแผนผังชั้นอย่างชัดเจน การรวมทั้งภาพพื้นหลังและภาพซ้อนทับถือเป็นสิ่งที่แนะนำอย่างยิ่งเพื่อให้ได้ความรู้สึกของมิติที่สมจริงในแดชบอร์ด 3 มิติ

การออกแบบแผนผังชั้น 3 มิติ

เมื่อสร้างกราฟิกแบบกำหนดเองสำหรับแผนผังชั้น 3 มิติ การออกแบบต้องถูกส่งออกเป็นสองภาพแยกกันที่มีพื้นหลังโปร่งใส: ชั้นฐานที่ประกอบด้วยพื้นและเฟอร์นิเจอร์ต่ำ และชั้นบนที่ประกอบด้วยเฉพาะผนังส่วนบน

ตัวอย่างภาพด้านล่างนี้ แสดงบนรูปแบบตารางหมากรุกเพื่อเน้นพื้นที่โปร่งใสของภาพ ถูกสร้างขึ้นโดยใช้แอปพลิเคชันออกแบบตกแต่งภายในฟรี 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