Chụp cuộn trang

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

Thay vì phải chụp nhiều ảnh màn hình rồi ghép lại một cách thủ công, Chụp cuộn trang sẽ làm điều đó giúp bạn. Chỉ cần chọn khu vực có thể cuộn, cuộn xuống với tốc độ ổn định và để Snapzy xử lý ghép các khung hình.

1. Kích hoạt chụp bằng phím tắt ⇧⌘6 hoặc URL snapzy://capture/scrolling.
2. Kéo hộp lựa chọn chỉ bao phủ khu vực nội dung có thể cuộn. Tránh chọn các thanh tiêu đề (headers), thanh bên (sidebars) hoặc chân trang (footers) cố định vì chúng sẽ gây nhiễu cho quá trình ghép ảnh.
3. Nhấn Bắt đầu (Start) trên bảng điều khiển HUD.
4. Cuộn xuống chậm và đều tay. Bạn sẽ thấy bản xem trước trực tiếp trên lớp phủ hiển thị hình ảnh ghép đang dài ra.
5. Nhấn Hoàn tất (Done) hoặc phím Enter để lưu.

Tự động cuộn (Auto Scroll)

Để mang lại trải nghiệm chụp ảnh hoàn toàn tự động, Snapzy tích hợp tính năng Tự động cuộn (Auto Scroll) được hỗ trợ bởi các API Trợ năng (Accessibility APIs) của macOS.

Cơ chế hoạt động

1. Sau khi bạn khoá vùng chọn và nhấn Bắt đầu (Start), nút Auto Scroll sẽ xuất hiện trên bảng điều khiển HUD.
2. Nhấn Auto Scroll để bắt đầu. Snapzy sẽ tự động gửi các sự kiện cuộn chính xác để tự động cuộn nội dung cho bạn.
3. Bảo vệ con trỏ (Pointer Guard): Để giữ cho quá trình cuộn luôn được tập trung, con trỏ chuột phải nằm trong khu vực chụp đã chọn. Nếu bạn di chuyển con trỏ ra ngoài vùng chọn:
   • Tính năng Tự động cuộn sẽ tạm dừng.
   • Một hướng dẫn cảnh báo trên HUD sẽ nhắc bạn Di chuyển chuột vào trong vùng chọn.
   • Khi bạn di chuyển con trỏ chuột trở lại vùng chọn, quá trình chụp sẽ tự động tiếp tục.
4. Tự động hoàn tất: Khi Snapzy phát hiện bạn đã cuộn đến cuối trang hoặc đạt giới hạn chiều cao, nó sẽ tự động hoàn thành việc ghép ảnh và lưu lại.
5. Dừng an toàn: Nếu nội dung không thể ghép khớp sau một số lần thử liên tiếp (ví dụ: do cửa sổ bật lên động hoặc thay đổi bố cục), Auto Scroll sẽ tự động dừng, cho phép bạn tiếp tục chụp thủ công.

[!IMPORTANT] Vì Auto Scroll tạo ra các sự kiện cuộn mô phỏng, Snapzy yêu cầu quyền Trợ năng (Accessibility) được bật trong Cài đặt hệ thống macOS. Nếu thiếu quyền này, ứng dụng sẽ nhắc bạn cấp quyền.

Cơ chế kỹ thuật: Ghép ảnh hoạt động như thế nào

Snapzy sử dụng một quy trình chụp ảnh lai (hybrid capture pipeline) để đảm bảo kết quả chính xác ngay cả với các bố cục phức tạp:

• Vòng lặp Khung hình Luồng (Stream Frame Ring) — Ghi lại khu vực được chọn với tốc độ khung hình cao và lưu giữ trong bộ đệm vòng (ScrollingCaptureFrameRing).
• Khung hình Tĩnh dự phòng — Nếu luồng cuộn gặp hiện tượng giật lag hoặc rớt khung hình, Snapzy sẽ ngay lập tức kích hoạt chụp ảnh tĩnh dự phòng để tránh xuất hiện các khoảng trống trên ảnh ghép.
• Ghép ảnh Hỗ trợ bởi thị giác máy tính (Vision) — Các thuật toán Vision cục bộ sẽ so sánh các phần chồng lên nhau, xác định các điểm khớp, kiểm tra ngưỡng tin cậy và loại bỏ các khung hình thừa.
• Kiểm tra An toàn — Nếu bạn cuộn quá nhanh hoặc cuộn ngược lên, trình ghép ảnh sẽ tạm dừng và hiển thị cảnh báo trên màn hình HUD để bạn điều chỉnh lại tốc độ mà không cần phải thực hiện lại từ đầu.

Kinh nghiệm chụp ảnh cuộn đẹp

1. Giới hạn vùng chọn chuẩn xác

Loại bỏ các tiêu đề không cuộn, thanh điều hướng dính hoặc các widget cố định ở bên cạnh. Trình ghép ảnh yêu cầu toàn bộ khối được chọn phải di chuyển cuộn một cách đồng đều.

2. Cuộn mượt mà

Sử dụng con lăn chuột hoặc bàn di chuột để cuộn xuống theo chuyển động đều đặn. Tránh cuộn nhảy đoạn quá nhanh.

3. Tránh di chuột lên nội dung

Giữ con trỏ chuột của bạn tránh xa khu vực lựa chọn trong khi cuộn để tránh bóng của thẻ hover hoặc hoạt ảnh của tooltip làm ảnh hưởng đến việc tính toán độ khớp của các khung hình.

Chẩn đoán & Nhật ký

Nếu bạn gặp sự cố (ví dụ: lỗi ghép ảnh hoặc chữ bị lệch), bạn có thể kiểm tra nhật ký chẩn đoán của Snapzy:

Nhật ký chụp cuộn lưu trữ dữ liệu thời gian, thống kê vòng khung hình và mức độ tin cậy của thuật toán Vision vào tệp nhật ký cục bộ của bạn:

~/Library/Logs/Snapzy/snapzy_YYYY-MM-DD.txt

Bạn có thể lọc nhật ký cho các dòng gỡ lỗi chụp cuộn bằng terminal:

grep 'ScrollingCaptureDebug' "$HOME/Library/Logs/Snapzy/snapzy_$(date +%F).txt"