Руководство по вкладке Захват Capture Tab Guide

1. Что делает вкладка Захват 1. What the Capture Tab Does

Вкладка нужна, когда вам нужен не один статичный фон, а управляемая последовательность кадров. Это удобно для многошаговых сценариев, динамических интерфейсов, CV-анализа по кадрам, а также для загрузки готового видео или папки скриншотов. Use this tab when you need a managed frame sequence instead of a single static background. It is useful for multi-step scenarios, dynamic interfaces, frame-by-frame CV analysis, and loading an existing video or screenshot folder.

• Экран: запись текущего экрана встроенным захватом Screph. Screen: record the current screen using Screph’s built-in capture pipeline.
• Камера и поток: live-источники через OpenCV VideoCapture. Camera and stream: live sources through OpenCV VideoCapture.
• Видеофайл и папка кадров: импорт внешней последовательности для навигации и playback. Video file and image-sequence folder: import an external sequence for navigation and playback.
• Превью: открывается отдельным окном, чтобы не раздувать основную вкладку. Preview: opens in a separate window so the main tab stays compact.

2. Поддерживаемые источники 2. Supported Sources

• ЭкранScreen: стандартный сценарий записи экрана. Доступны запись, пауза, стоп и последующее воспроизведение кадров. the standard screen-recording workflow. Recording, pause, stop, and later playback are available.
• КамераCamera: выберите индекс камеры, backend OpenCV и при необходимости включите автостарт. choose the camera index, an OpenCV backend, and optionally enable auto-start.
• Видео файлVideo File: откройте локальный файл и используйте верхнюю навигацию для перемотки и playback. open a local file and use the top navigation block for scrubbing and playback.
• Папка кадровImage Sequence Folder: загрузите директорию с PNG, JPG, JPEG или BMP и работайте с ней как с последовательностью кадров. load a directory with PNG, JPG, JPEG, or BMP files and work with it as a frame sequence.
• Поток / URLStream / URL: RTSP, HTTP и другие URL, которые умеет открыть выбранный backend OpenCV. RTSP, HTTP, and other URLs that the selected OpenCV backend can open.

Важно:Important: запись доступна для экрана, камеры и URL-потока. Для видеофайла и папки кадров доступно воспроизведение и навигация, а не повторная запись источника. recording is available for screen, camera, and URL stream sources. A video file or image-sequence folder is meant for playback and navigation, not for recording the source again.

3. Как устроена вкладка 3. Tab Layout

• НавигацияNavigation: верхний блок со слайдером, номером текущего кадра и общим числом кадров. the top block with the scrubber, current frame number, and total frame count.
• ИсточникSource: компактная строка выбора источника, кнопка превью, backend, путь/URL и действия открытия или старта live-потока. a compact row for source selection, the preview button, backend, path/URL, and open/start actions for live sources.
• ПараметрыParameters: FPS, режим хранения кадров, буфер и расширенные настройки. FPS, frame-storage mode, buffer settings, and advanced settings.
• УправлениеControls: запись, стоп, пошаговая навигация, playback, скорость и loop. recording, stop, step navigation, playback, speed, and loop.
• Информация и экспортInfo and Export: статистика по кадрам, памяти, длительности, текущему пути и экспорт в PNG. frame, memory, duration, current-path statistics, and PNG export.

4. Типовые сценарии работы 4. Typical Workflows

Запись экрана Screen Recording

1. Выберите источник Экран. Select the Screen source.
2. Проверьте FPS и режим хранения кадров. Check the FPS and frame-storage mode.
3. Нажмите запись, затем при необходимости паузу или стоп. Press record, then pause or stop when needed.
4. Используйте верхний scrubber и playback-кнопки для просмотра результата. Use the top scrubber and playback buttons to review the result.

Камера или URL-поток Camera or URL Stream

1. Выберите Камера или Поток / URL. Select Camera or Stream / URL.
2. Укажите индекс камеры или URL, затем backend OpenCV. Set the camera index or URL, then choose an OpenCV backend.
3. Нажмите Старт для live-просмотра или запись для сохранения кадров в буфер. Press Start for live viewing or record to save frames into the buffer.
4. Останавливайте поток кнопкой Стоп; последний набор кадров останется доступен для playback. Stop the stream with Stop; the last captured frames remain available for playback.

Видеофайл или папка кадров Video File or Image Sequence

1. Выберите Видео файл или Папка кадров. Select Video File or Image Sequence Folder.
2. Нажмите Обзор и откройте источник. Press Browse and open the source.
3. После загрузки используйте верхний слайдер, переходы по кадрам и playback. After loading, use the top slider, frame-stepping buttons, and playback.

5. Превью и отдельное окно 5. Preview and the Detached Window

Превью открывается отдельным окном по кнопке Превью. Это окно построено на Qt/PySide и получает кадры уже как QPixmap; OpenCV используется для чтения live-источников и декодирования кадров, а не для показа собственного HighGUI-окна. The preview opens in a separate window with the Preview button. This window is built with Qt/PySide and receives frames as QPixmap; OpenCV is used for reading live sources and decoding frames, not for showing its own HighGUI window.

Такой подход сохраняет основную вкладку компактной и уменьшает риск конфликтов между окном OpenCV и Qt-интерфейсом. This keeps the main tab compact and reduces the risk of conflicts between an OpenCV window and the Qt UI.

6. Вкладка настроек захвата 6. Capture Settings Tab

В CV Settings добавлена отдельная вкладка Настройки захвата. Она синхронизируется с runtime-настройками capture-модуля и позволяет заранее задать источник, backend, FPS, режим хранения, playback speed, loop и автостарт live-источников. A dedicated Capture Settings tab has been added to CV Settings. It syncs with the capture module’s runtime settings and lets you preconfigure the source, backend, FPS, storage mode, playback speed, loop mode, and live-source auto-start.

• Эти настройки полезны, если вы часто повторяете один и тот же сценарий захвата. These settings are useful if you often repeat the same capture workflow.
• Если вкладка Захват уже открыта, изменения применяются к ее рабочему состоянию. If the Capture tab is already open, changes apply to its working state.

7. Частые проблемы и решения 7. Common Problems and Fixes

• Пустое превьюEmpty Preview: убедитесь, что источник открыт, а для камеры или URL-потока нажата кнопка Старт. make sure the source is loaded and that Start was pressed for a camera or URL stream.
• Кнопка записи недоступнаRecord Button Is Disabled: запись разрешена только для экрана, камеры и live-потока. Видеофайл и папка кадров предназначены для playback. recording is only available for screen, camera, and live-stream sources. A video file or frame folder is meant for playback.
• Источник не открываетсяSource Cannot Be Opened: попробуйте другой backend OpenCV, проверьте индекс камеры или доступность URL. try another OpenCV backend and verify the camera index or URL availability.
• Слишком много памятиHigh Memory Usage: уменьшите FPS, сократите длину записи или переключитесь на режим хранения кадров на диске. reduce FPS, shorten the recording, or switch to the disk-based frame-storage mode.
• Нужен результат вне ScrephYou Need Output Outside Screph: используйте PNG export или авто-сохранение кадров. use PNG export or automatic frame saving.