Захват с прокруткой

Как использовать

Вместо того чтобы делать несколько скриншотов и склеивать их вручную, функция «Захват с прокруткой» делает всю работу за вас. Просто выберите прокручиваемую область, плавно прокручивайте вниз и позвольте Snapzy обработать кадры.

1. Запустите захват с помощью сочетания клавиш ⇧⌘6 или по URL snapzy://capture/scrolling.
2. Перетащите рамку выделения, чтобы она охватывала только прокручиваемую область содержимого. Избегайте статичных заголовков (headers), боковых панелей (sidebars) или подвалов (footers), так как они мешают склеиванию.
3. Нажмите кнопку Начать (Start) на панели HUD.
4. Прокручивайте страницу вниз медленно и плавно. Вы увидите живой предварительный просмотр на экране, показывающий, как растет склеенное изображение.
5. Нажмите кнопку Готово (Done) или клавишу Enter для сохранения.

Автопрокрутка (Auto Scroll)

Для полностью автоматического захвата Snapzy предлагает функцию Автопрокрутки (Auto Scroll), работающую на базе macOS Accessibility API.

Как это работает

1. Как только вы зафиксируете область и нажмете Start, на панели HUD станет доступна кнопка Auto Scroll.
2. Нажмите Auto Scroll для начала. Snapzy начнет автоматически генерировать точные события прокрутки, пролистывая содержимое за вас.
3. Защита указателя (Pointer Guard): Чтобы прокрутка оставалась сфокусированной, курсор мыши должен находиться внутри выбранной области захвата. Если вы переместите курсор за пределы выделения:
   • Автопрокрутка приостановится.
   • На HUD появится предупреждение: Верните курсор мыши в область выделения.
   • Возврат курсора мыши в область выделения автоматически возобновит захват.
4. Автозавершение: Как только Snapzy обнаружит, что достигнут низ страницы или предел высоты, приложение автоматически завершит склейку и сохранит снимок.
5. Безопасная остановка: Если приложению не удастся правильно сопоставить кадры несколько раз подряд (например, из-за всплывающих окон или сдвигов макета), автопрокрутка остановится автоматически, позволяя завершить захват вручную.

[!IMPORTANT] Поскольку автопрокрутка имитирует события прокрутки мыши, Snapzy требуются Разрешения универсального доступа (Accessibility), которые необходимо включить в Системных настройках macOS. Если эти разрешения отсутствуют, вам будет предложено предоставить их.

Под капотом: как работает склеивание

Snapzy использует гибридный конвейер захвата для обеспечения точных результатов даже при сложных макетах:

• Кольцевой буфер кадров (Stream Frame Ring) — высокочастотный захват потока кадров выбранной области, которые удерживаются в кольцевом буфере (ScrollingCaptureFrameRing).
• Резервные статические кадры — если в потоке прокрутки возникают задержки или выпадают кадры, Snapzy мгновенно активирует резервный захват статических кадров, чтобы предотвратить появление пропусков при склеивании.
• Склеивание на базе Vision — локальные алгоритмы фреймворка Vision сравнивают перекрывающиеся разделы, идентифицируют совпадения, проверяют пороговые значения достоверности и игнорируют избыточные кадры.
• Проверки безопасности — если прокрутка происходит слишком быстро или идет в обратном направлении, процесс склеивания приостанавливается и отображается предупреждающее сообщение HUD, чтобы вы могли скорректировать скорость без перезапуска процесса.

Советы для получения качественных снимков

1. Выделяйте область точно

Исключайте непрокручиваемые заголовки, фиксированные меню навигации или закрепленные боковые виджеты. Алгоритм склеивания ожидает, что весь выделенный блок будет прокручиваться равномерно.

2. Прокручивайте плавно

Используйте колесико мыши или трекпад для плавной прокрутки вниз. Избегайте резких скачков по разделам.

3. Избегайте наведения курсора

Держите курсор мыши за пределами выделенной области во время прокрутки, чтобы тени от всплывающих окон или анимация подсказок не нарушали сопоставление перекрывающихся зон.

Диагностика и логи

Если вы столкнулись с проблемами (например, ошибками склеивания или смещением текста), вы можете изучить диагностические логи Snapzy:

Логи захвата с прокруткой записывают временные данные, статистику кольцевого буфера кадров и уровни достоверности Vision в локальный файл логов:

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

Вы можете отфильтровать логи по отладочным сообщениям прокрутки с помощью терминала:

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