วิธีการใช้งาน

โครงหน้าจอ

• แถบบน: ไฟล์ (ชุดตัวอย่าง / เปิด JSON / ดาวน์โหลด / เซฟ / พิมพ์) · Undo/Redo · การทดลอง (เฉพาะ allowlist) · เพิ่มเติม
• ขวาบน: สลับภาษา · เข้าสู่ระบบ / บัญชี
• แถบเครื่องมือ 2D (desktop): ลอยซ้ายล่าง — วาด · เลือก · ย้าย · แทรกจุด · ลบ · เย็บ · จำลอง
• ซ้าย: พารามิเตอร์ · กลาง: แบบ 2D (พื้นดำ) · ขวา: มุมมอง 3D และชั้น (Layers)
• มือถือ/แท็บเล็ต: แท็บ 2D | 3D | พารามิเตอร์ | ชั้น · เครื่องมือเป็น FAB ลอยในช่อง 2D
• ความคืบหน้าจำลองเป็นไดอะล็อกกลางจอ · หลังจำลองเสร็จมี Material · จัดแสง · ล้างผลจำลอง

เริ่มต้นเร็ว

• ไฟล์ → ชุดตัวอย่าง · เปิด JSON (เฉพาะอีเมลใน DEV_MODE_ALLOWED_EMAILS) · ว่างแล้วโหลด tshirt เป็นค่าเริ่มต้น
• โหมด เลือก — คลิกหรือลากคลุม · ครอบเฉพาะจุดให้กดปุ่ม จุด ถัดจาก「เลือก」ก่อน
• โหมด ย้าย — ลากเลื่อน · Shift+ลาก หมุน · หรือใช้ลูกศร
• โหมด เย็บ — คลิกขอบแผง A แล้วขอบ B · เห็นคอร์ดม่วงบนจอ
• เพิ่มเติม → เคลียร์ · ทิ้ง draft · ร่างในเบราว์เซอร์เก็บอัตโนมัติ
• วัสดุผ้า: เปิดจากแถบช่อง 3D · ค่าเริ่มต้นขาว + ลาย `/materials/default.png`
• การทดลอง (เฉพาะ allowlist) → จูนจำลอง · เครื่องมือตรวจหลังจำลอง
• (ทางเลือก) ล็อกอินแล้วเซฟขึ้นเซิร์ฟเวอร์ · เปิดจาก /designs
• Delete ลบของที่เลือก · Ctrl+Z ยกเลิก (ใช้ได้แม้ค้างภาษาไทย)

เลื่อนมุมมอง (Pan · Zoom)

• ปุ่มกลางเมาส์ + ลาก = Pan · Scroll = Zoom
• Space + ลากปุ่มซ้าย = Pan (ทางเลือก)
• สองนิ้วบนจอสัมผัส: เลื่อนคู่กัน = Pan · บีบ/กาง = Zoom

เครื่องมือหลัก

• วาดแผง: คลิกวางจุด ≥3 · Enter หรือคลิกจุดแรกปิดแผง · Escape ยกเลิก
• เลือก: คลิก/ลากคลุม · ไม่ย้าย · Ctrl/Cmd เพิ่ม/สลับใน selection
• ย้าย: ลากแผง/ขอบ/จุด · Shift+ลากหมุน · แผงชิดขอบ same-Z อัตโนมัติ
• แทรกจุด: คลิกใกล้ขอบ · ไม่จัดแนวจุด · ขอบมีตะเข็บ = บล็อก
• ลบ: ตามชิปเลือก (จุด/ขอบ/แผง) · จุดติดตะเข็บระบายเหลือง
• เย็บ: คลิกขอบ A แล้ว B · ขอบเย็บแล้วชี้แล้วห้าม · Escape ยกเลิกขอบแรก
• ตัวกรองถัดจาก「เลือก」: อัตโนมัติ / จุด / ขอบ / แผง — มีผลทั้งคลิกและลากคลุม

จัดแนวจุด · เส้นอ้างอิง · ดึงชิดขอบ

• จัดแนวจุด: checkbox มุมบนขวาช่อง 2D (ค่าเริ่มเปิด) · Alt ค้างตอนลาก = ปลดชั่วคราว
• เส้นอ้างอิง: checkbox มุมบนขวา (ค่าเริ่มปิด) · เทียบระดับ · ไม่ดึงจุด
• ดึงชิดขอบ: ตอนย้ายแผงใกล้แผงหน้า–หน้า/หลัง–หลัง · Alt ค้าง = ปลด · ไม่ทำตอนหมุนหรือย้ายจุด/ขอบ

พารามิเตอร์และคลิกขวา

• พารามิเตอร์ซ้าย: แสดงตามสิ่งที่เลือก (แผง · ขอบ · จุด) · พิมพ์ตัวเลขแล้ว Enter ถึงบันทึก · ▲▼ มีผลทันที
• คลิกขวา: ลบ · แทรกจุด · เย็บ/เลิกเย็บ · คัดลอก · สะท้อน · ดาวน์โหลด · พิมพ์ · เคลียร์จอ
• คัดลอกแผงที่มีตะเข็บ = บล็อกทั้งชุด · สะท้อนซ้าย/ขวา/บน/ล่าง → หน้า/หลัง

ตะเข็บ

• กด เย็บ → คลิกขอบแรก (ม่วง) → คลิกขอบที่สอง → ได้คอร์ดเส้นประ+ลูกศร
• ขอบหนึ่งเย็บได้หนึ่งคู่ · ไม่มีตะเข็บ valid = จำลองไม่ได้
• Layers → Stitches โชว์/ซ่อนคอร์ด · คลิกคอร์ดเลือก · คลิกขวา เลิกเย็บ/สลับทิศ
• ความยาวสองฝั่งต่างเกิน ~5% → คอร์ดสีอำพัน · ไม่ยืดแผงอัตโนมัติ
• เซฟ: ดาวน์โหลด JSON · ขึ้นเซิร์ฟเวอร์หลังล็อกอินที่ /designs · แชร์อ่านอย่างเดียวจากแคตตาล็อก

Layers · หน้า/หลัง

• Checkbox ชื่อแผง = ซ่อน/โชว์ · ดับเบิลคลิกชื่อ = ตั้งชื่อที่เห็น (รหัสในไฟล์ไม่เปลี่ยน)
• Z บวก = มุมหน้า · Z ลบ = มุมหลัง · มุมหลังสะท้อนซ้าย–ขวาให้หันผู้ดู
• ลากแผงข้ามไปทับหุ่นอีกตัวแล้วปล่อย = ย้ายไปหุ่นนั้นอัตโนมัติ

ช่อง 3D · เลือกหุ่น

• ค่าเริ่ม: ซ้าย 2D / ขวา 3D · ลากหมุน · ล้อซูม · แผงลอยตามแบบจนกว่ากดจำลอง
• ปุ่ม เลือกหุ่น · ค้นจากขนาดตัว (~5000) · อัปโหลด OBJ · สร้าง MakeHuman (Macro / Pose)
• ตรวจแบบ / พรีวิว ก่อนจำลอง · เส้นม่วงใน 3D = คอร์ดตะเข็บเดียวกับ 2D

จำลองผ้า

ก่อนกดจำลอง: แบบต้องมีตะเข็บอย่างน้อยหนึ่งคู่ · ปรับที่รันและชนิดผ้า/ก้าวใน「จูนจำลอง」

• ที่รัน: Server (Python) หรือ Browser ในแท็บ (WebGPU เมื่อเปิด) · จำในเครื่องนี้
• WebGPU ต้อง HTTPS หรือ localhost — http://IP ใน LAN เลือก GPU ไม่ได้ (ใช้ CPU)
• จูนจำลอง: ชนิดผ้า · ก้าวห่อ/ปล่อย/ย่อย · พริ้ว · กำหนดค่าผ้าเองและบันทึก preset ได้
• กด จำลอง แล้วรอไดอะล็อก · ผลแทนที่ช่อง 3D ด้วยผ้า+หุ่น
• Material: สี/ลายผ้า (ภาพ) · ค่าเริ่มต้นขาว + `/materials/default.png` · ใช้ได้ตั้งแต่แผงแบน · ไม่เปลี่ยนพฤติกรรมจำลอง
• จัดแสง: หลังจำลองเสร็จ · ปรับแล้วเห็นทันที · ไม่รันจำลองใหม่
• ล้างผลจำลอง: กลับแผงแบน · ต้องกดจำลองใหม่ถึงเห็นผลจากจูน

เซฟ · แคตตาล็อก · พิมพ์

• ดาวน์โหลด JSON = แผง+ตะเข็บ · เปิด JSON / ชุดตัวอย่าง · ร่างในเบราว์เซอร์
• ล็อกอินแล้วเซฟขึ้นเซิร์ฟเวอร์ · เปิดจาก /designs · แชร์อ่านอย่างเดียวจากรายการ
• พิมพ์… / ดาวน์โหลด SVG · ในไดอะล็อกพิมพ์เลือก Actual size 100% (อย่า Fit to page)
• หลังล็อกอิน/ออกจากระบบอาจบันทึก IP และเวลาเพื่อความปลอดภัย — ดูหน้าความเป็นส่วนตัว
• Undo/Redo ≥50 ขั้น · Ctrl+Z / Ctrl+Y

สัญลักษณ์บนจอ

• เส้นน้ำเงิน = ขอบแผง · เส้นแดง = ขอบไขว้ (คำเตือน)
• คอร์ดตะเข็บ = เส้นประ+ลูกศร · ขอบม่วง = รอขอบที่สอง (โหมดเย็บ)
• จุดส้ม+เส้นบาง = มือจับโค้ง · ไฮไลต์ฟ้าในแผง = แผงถูกเลือก

คีย์ลัดที่ใช้บ่อย

• ←↑→↓ ขยับ · Shift+ลูกศร หมุน · Delete/Backspace ลบ
• Ctrl+Z Undo · Ctrl+Y Redo (อ่านปุ่ม Z/Y ไม่ใช่ตัวอักษรไทย)
• Enter ปิดแผง (≥3 จุด) · Escape ยกเลิกเส้น/เย็บ
• Alt ค้างตอนลาก = ปลด snap grid และ edge snap