Ключевые понятияCore concepts

Screph хранит подтверждённое описание визуальной сцены отдельно от временных результатов распознавания и исполнения. Это различие помогает понять интерфейс и формат проекта.Screph keeps the confirmed description of a visual scene separate from temporary recognition results and execution. This distinction explains both the UI and the project format.

Source, Frame, ROI

Source: Выбранная область/окно/монитор, камера, поток или набор файлов и папок, из которых Screph получает визуальные данные.A selected region/window/monitor, camera, stream or set of files and folders from which Screph acquires visual data.
Frame: Конкретный снимок источника в выбранный момент времени.One concrete source image at a selected point in time.
ROI: Region of interest — область кадра, на которой выполняется разметка или CV-операция.Region of interest: the part of a frame used for markup or a CV operation.

Raw, Material, Display

Raw: Канонические пиксели исходного capture/frame до обработки presentation.Canonical pixels from the captured source or frame before presentation processing.
Material: Типизированный image/mask-результат, которым владеет конкретная canvas presentation. Pixel probe, гистограмма и профиль линии используют material активной presentation; если он недоступен или не сопоставлен с canvas, скрытого fallback к Raw нет.The typed image or mask result owned by a particular canvas presentation. The pixel probe, histogram and line profile use the active presentation's material; if it is unavailable or not mapped to the canvas, there is no silent fallback to Raw.
Display: Итоговый растр, нарисованный в pane после display transform и композиции overlays. Он может быть составным и не обязан быть допустимым material для измерения.The final raster painted in a pane after display transforms and overlay composition. It may be composite and is not necessarily a valid measurement material.

Канонические данные проектаCanonical project data

Канонический проект — сохранённый источник истины: elements/features, annotations, typed relations, markup groups и связанные настройки. Канонические изменения проходят через project history. Общие Undo/Redo направляются в контекст с текущим фокусом: например, измерительные линии используют отдельную локальную историю и не становятся данными проекта.The canonical project is the saved source of truth: elements/features, annotations, typed relations, markup groups and related settings. Canonical changes use project history. Shared Undo/Redo commands route to the focused context; for example, measurement lines use separate local history and do not become project data.

Важно:Important: CV-кандидат не становится каноническим элементом, пока пользователь или разрешённый workflow явно его не применит.A CV candidate does not become a canonical element until the user or an authorized workflow explicitly applies it.

Контейнеры и группыContainers and groups

Selection area: Geometry-only элемент с видимой рамкой. Он автоматически или вручную собирает полностью содержащиеся elements/features в иерархию; вложенность направляет объект в наименьшую подходящую область. Изображения и crop в самой области не хранятся.A geometry-only element with a visible rectangle. It automatically or manually collects fully contained elements/features into hierarchy; nesting routes an object to the smallest matching area. The area itself stores no image or crop.
Image frame: Обычный элемент, используемый как геометрия crop для записи кадров в его Image Series. Это не selection area.An ordinary element used as crop geometry when capturing frames into its Image Series. It is not a selection area.
Markup group: Именованный канонический агрегат ссылок на существующие elements/features, с role, optional sequence index, type и properties. Typed group может появиться через подтверждённый candidate promotion, но отдельного свободного visual CRUD-редактора markup groups в текущем Selector нет.A named canonical aggregate referencing existing elements/features, with a role, optional sequence index, type and properties. A typed group can originate from confirmed candidate promotion, but the current Selector has no separate free-form visual CRUD editor for markup groups.

CV method, pipeline, candidate, evidence

CV method: Одна операция обработки изображения с параметрами и результатом.One parameterized image-processing operation with an output.
Pipeline: Последовательность или граф CV-операций. Method Graph относится к вычислениям, а не к связям элементов интерфейса.A sequence or graph of CV operations. The Method Graph describes computation, not relationships between UI elements.
Candidate: Предложенное распознаванием изменение, которое можно просмотреть, подтвердить или отклонить.A recognition proposal that can be previewed, accepted or rejected.
Evidence: Набор наблюдений, confidence, геометрии и диагностик, объясняющий происхождение кандидата.Observations, confidence, geometry and diagnostics explaining where a candidate came from.

Три разных графаThree different graphs

Relation Graph

Типизированные связи между элементами проекта.Typed relationships between project elements.

Method Graph

Вычислительный граф CV pipeline.The computational graph of a CV pipeline.

Action Trace

Последовательность наблюдаемых или исполняемых действий автоматизации.A sequence of observed or executed automation actions.

В Relation Graph различаются hierarchy parent → child, системная проекция owner → feature и редактируемые user edges. FeatureMatch сохраняется отдельно в feature_matches и не является ребром этого графа.Relation Graph distinguishes parent → child hierarchy, the system owner → feature projection, and editable user edges. A FeatureMatch is persisted separately under feature_matches and is not an edge in this graph.