Hướng dẫn sử dụng

Bố cục

• Thanh trên: File (bộ mẫu / Mở JSON / tải xuống / lưu / in) · Undo/Redo · Thử nghiệm (allowlist) · Thêm (material)
• Góc trên phải: ngôn ngữ · đăng nhập / tài khoản
• Thanh công cụ 2D (desktop): nổi góc dưới trái — Vẽ · Chọn · Di chuyển · Chèn · Xóa · May · Mô phỏng
• Trái: Inspector · Giữa: canvas 2D (nền tối) · Phải: khung 3D và Layers
• Điện thoại/máy tính bảng: tab 2D | 3D | Inspector | Layers · công cụ dạng FAB trong khung 2D
• Tiến trình mô phỏng là hộp thoại giữa màn · sau mô phỏng: Material · Ánh sáng · Xóa kết quả mô phỏng

Bắt đầu nhanh

• File → Bộ mẫu · Mở JSON (chỉ admin) · editor trống tải tshirt mặc định
• Chế độ Chọn — click hoặc kéo chọn · chỉ đỉnh thì chọn chip Vertex cạnh Select trước
• Chế độ Di chuyển — kéo để dịch · Shift+kéo để xoay · hoặc phím mũi tên
• Chế độ May — click cạnh mảnh A rồi cạnh B · dây đường may tím trên canvas
• File → Tải JSON lưu mảnh + đường may · bản nháp trình duyệt tự lưu
• (Tùy chọn) Đăng nhập, lưu lên máy chủ · mở lại từ /designs
• Delete xóa lựa chọn · Ctrl+Z hoàn tác (vẫn được dù bàn phím Thái)

Pan và zoom

• Chuột giữa + kéo = pan · Cuộn = zoom
• Space + kéo chuột trái = pan (cách khác)
• Hai ngón cảm ứng: pan cùng lúc · chụm/mở = zoom

Công cụ chính

• Vẽ mảnh: đặt ≥3 điểm · Enter hoặc click điểm đầu để đóng · Escape hủy
• Chọn: click/kéo chọn · không di chuyển · Ctrl/Cmd bật/tắt lựa chọn
• Di chuyển: kéo mảnh/cạnh/đỉnh · Shift+kéo xoay · mảnh cùng Z hút mép
• Chèn đỉnh: click gần cạnh · không hút lưới · cạnh đã may = chặn
• Xóa: theo chip bộ lọc · đỉnh đã may tô hổ phách
• May: cạnh A rồi B · cạnh đã may bị chặn · Escape xóa cạnh đầu
• Chip lọc sau Select: Auto / Vertex / Edge / Panel — ảnh hưởng click và kéo chọn

Hút lưới · đường dẫn · hút mép

• Hút lưới: checkbox góc trên phải 2D (bật mặc định) · Alt khi kéo = tắt tạm
• Đường dẫn: cùng vùng checkbox (tắt mặc định) · chỉ căn chỉnh · không hút đỉnh
• Hút mép: khi di chuyển cả mảnh gần lớp trước/sau cùng · Alt = tắt · không khi xoay hoặc di chuyển đỉnh/cạnh

Inspector và menu ngữ cảnh

• Inspector trái theo lựa chọn (mảnh · cạnh · đỉnh) · một đỉnh: x/y cục bộ + độ sâu z · nhiều đỉnh/cạnh: offset z/x/y từ 0 · gõ số rồi Enter · ▲▼ áp dụng ngay
• Nhiều mảnh: trường vị trí là offset x/y/z (bắt đầu 0) cộng vào mọi mảnh đã chọn
• Click phải: xóa · chèn · may/gỡ may · nhân bản · lật gương · tải xuống · in · xóa canvas
• Nhân bản mảnh có đường may = chặn · một mảnh: lật trái/phải/trên–dưới → trước/sau · nhiều: trước/sau quanh tâm lựa chọn

Đường may

• May → cạnh đầu (tím) → cạnh hai → dây đứt + mũi tên
• Mỗi cạnh một cặp đường may · không có đường may hợp lệ = không mô phỏng được
• Layers → Stitches hiện/ẩn dây · click dây để chọn · click phải gỡ may/đảo hướng
• Chiều dài lệch > ~5% → dây hổ phách · mảnh không tự giãn
• Lưu: Tải JSON · sau đăng nhập, lưu lên máy chủ tại /designs · chia sẻ chỉ đọc từ catalog

Layers · trước/sau

• Checkbox layer = ẩn/hiện · double-click tên = tên hiển thị (id file không đổi)
• Z dương = trước · Z âm = sau · lớp sau lật trái–phải hướng về người xem
• Kéo mảnh lên hình người khác rồi thả = tự chuyển sang hình người đó

Khung 3D · chọn hình người

• Mặc định: 2D trái / 3D phải · kéo để xoay quanh · bánh xe zoom · mảnh nổi đến khi Mô phỏng
• Chọn hình người · tìm theo số đo (~5000) · tải OBJ · tạo MakeHuman (macro / pose)
• Validate / Preview trước mô phỏng · đường tím trong 3D khớp dây đường may 2D

Mô phỏng vải

Trước khi Mô phỏng: mẫu cần ít nhất một cặp đường may · đặt đích chạy và vải/bước trong Cài đặt mô phỏng

• Đích chạy: Server (Python) hoặc Browser trong tab (WebGPU khi có) · lưu trên thiết bị này
• WebGPU cần HTTPS hoặc localhost — http://LAN-IP không chọn được GPU (dùng CPU)
• Cài đặt mô phỏng: preset vải · wrap/release/substeps · độ mềm · preset tùy chỉnh lưu cục bộ
• Mô phỏng chạy hộp thoại · kết quả thay khung 3D bằng vải + hình người
• Material: màu/texture (chỉ nhìn) · mặc định trắng + `/materials/default.png` · dùng được trên mảnh phẳng · không đổi vật lý mô phỏng
• Ánh sáng: sau mô phỏng · xem trực tiếp · không chạy lại mô phỏng
• Xóa mô phỏng: về mảnh phẳng · chạy lại Mô phỏng để thấy thay đổi chỉnh

Lưu · catalog · in

• Tải JSON = mảnh + đường may · Mở JSON / Bộ mẫu · bản nháp trình duyệt
• Đăng nhập để lưu lên máy chủ · mở từ /designs · chia sẻ chỉ đọc từ catalog
• In… / Tải SVG · chọn Actual size 100% trong hộp thoại in (không Fit to page)
• Đăng nhập và đăng xuất có thể ghi IP và thời gian vì bảo mật — xem trang quyền riêng tư
• Undo/Redo ≥50 bước · Ctrl+Z / Ctrl+Y

Ký hiệu trên canvas

• Xanh dương = cạnh mảnh · Đỏ = cạnh cắt nhau (cảnh báo)
• Dây đường may = đường đứt + mũi tên · Cạnh tím = đang chờ cạnh hai (chế độ may)
• Chấm cam + đường mỏng = tay nắm cong · Tô xanh = mảnh đang chọn

Phím tắt thường dùng

• Phím mũi tên di chuyển · Shift+mũi tên xoay · Delete/Backspace xóa
• Ctrl+Z hoàn tác · Ctrl+Y làm lại (phím Z/Y vật lý, không phải chữ Thái)
• Enter đóng mảnh (≥3 điểm) · Escape hủy đường/may
• Alt khi kéo = tắt hút lưới và hút mép