스크롤 캡처 | Snapzy Docs

사용 방법

여러 장의 스크린샷을 찍어 수동으로 이어 붙일 필요 없이 스크롤 캡처 기능을 통해 해결할 수 있습니다. 스크롤 영역을 선택하고 일정한 속도로 아래로 스크롤하면 Snapzy가 각 프레임을 알아서 합성합니다.

https://snapzy.app/docs/scrolling

📌 Sticky Header (Notice: We exclude this from crop selection box below)

CROP SELECTION

Premium Graphics Card

Stitch algorithm matches image patterns

--- End of scrollable webpage content ---

Stitch Confidence:96.0%

⇧⌘6 단축키를 누르거나 snapzy://capture/scrolling URL을 실행하여 캡처를 시작합니다.
스크롤되는 콘텐츠 영역만 포함하도록 선택 영역 상자를 드래그합니다. 화면에 고정된 헤더, 사이드바 또는 푸터는 프레임 합성을 방해하므로 제외해 주세요.
화면 표시(HUD) 창의 시작(Start) 버튼을 누릅니다.
천천히 그리고 일정한 속도로 아래로 스크롤합니다. 오버레이 화면의 실시간 미리보기를 통해 이미지가 아래로 이어 붙으며 길어지는 모습을 확인할 수 있습니다.
완료(Done) 버튼을 클릭하거나 Enter 키를 눌러 저장합니다.

완전한 자동 캡처 경험을 제공하기 위해, Snapzy는 macOS 접근성 API(Accessibility APIs)로 구동되는 자동 스크롤(Auto Scroll) 기능을 제공합니다.

선택 영역을 지정하고 **시작(Start)**을 클릭하면 HUD에 자동 스크롤(Auto Scroll) 버튼이 활성화됩니다.
자동 스크롤을 클릭하여 시작합니다. Snapzy가 자동으로 정밀한 스크롤 이벤트를 생성하여 콘텐츠를 대신 스크롤합니다.
포인터 가드(Pointer Guard): 스크롤 초점을 유지하기 위해 마우스 포인터는 선택한 캡처 영역 내에 머물러야 합니다. 포인터를 영역 밖으로 이동하면:
- 자동 스크롤이 일시 정지됩니다.
- 안내 HUD에 선택 영역 내부로 마우스 이동 경고가 표시됩니다.
- 포인터를 다시 영역 내부로 가져가면 캡처가 자동으로 재개됩니다.
자동 완료: 페이지 하단에 도달하거나 높이 제한에 도달하면 Snapzy가 이를 자동으로 감지하여 결합을 완료하고 저장합니다.
안전 정지: 동적 팝업이나 레이아웃 변경 등으로 인해 여러 번 연속해서 이미지 정렬에 실패할 경우 자동 스크롤이 자동으로 중지되어 수동으로 캡처를 마칠 수 있도록 합니다.

[!IMPORTANT] 자동 스크롤 기능은 가상의 스크롤 이벤트를 생성하므로, Snapzy는 macOS 시스템 설정에서 접근성(Accessibility) 권한을 활성화해야 합니다. 권한이 없는 경우 권한 허용을 요청하는 안내가 표시됩니다.

Snapzy는 복잡한 레이아웃에서도 정확한 결과물을 보장하기 위해 다음과 같은 하이브리드 캡처 파이프라인을 사용합니다:

스트림 프레임 링 — 선택한 영역을 고프레임 스트림으로 캡처하여 링 버퍼(ScrollingCaptureFrameRing)에 유지합니다.
대체용 정지 프레임 — 스크롤 스트림 중 지연이 생기거나 프레임 드롭이 발생하면, Snapzy는 캡처 공백을 막기 위해 대체용 정지 화면 캡처를 즉시 실행합니다.
Vision 기반 합성 지원 — 기기 내부의 Vision 알고리즘이 겹치는 영역을 분석하고, 일치하는 지점을 식별하고, 신뢰도 기준값을 검사하며, 불필요하게 겹친 프레임을 제거합니다.
안전 감지 기능 — 스크롤이 너무 빠르거나 역방향으로 움직이는 경우, 합성 프로세스를 일시 정지하고 경고 HUD를 띄워 처음부터 다시 캡처하지 않고도 속도를 조절할 수 있도록 돕습니다.

스크롤되지 않는 헤더, 상단 고정 네비게이션 바, 또는 고정된 위젯은 제외하십시오. 합성 엔진은 선택된 전체 영역이 일관되게 스크롤될 것을 전제합니다.

마우스 휠이나 트랙패드를 사용하여 부드러운 단일 동작으로 스크롤하세요. 화면을 빠르게 건너뛰며 스크롤하지 마십시오.

스크롤하는 동안 마우스 커서를 선택 영역 바깥에 두어 호버 카드 그림자나 툴팁 애니메이션이 프레임 겹침 계산을 방해하지 않도록 하십시오.

오류가 발생하거나(예: 합성 에러 또는 정렬되지 않은 텍스트), 문제가 발생하면 Snapzy의 진단 로그를 확인할 수 있습니다:

스크롤 캡처 기능은 타이밍 데이터, 프레임 링 통계, Vision 신뢰 지수를 다음의 로컬 로그 파일에 기록합니다:

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

터미널을 통해 스크롤 디버그 문장만 필터링하여 로그를 확인할 수도 있습니다:

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