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

Source, Frame, ROI

Source

Выбранная область/окно/монитор, камера, поток или набор файлов и папок, из которых Screph получает визуальные данные.

Frame

Конкретный снимок источника в выбранный момент времени.

ROI

Region of interest — область кадра, на которой выполняется разметка или CV-операция.

Raw, Material, Display

Raw

Канонические пиксели исходного capture/frame до обработки presentation.

Material

Типизированный image/mask-результат, которым владеет конкретная canvas presentation. Pixel probe, гистограмма и профиль линии используют material активной presentation; если он недоступен или не сопоставлен с canvas, скрытого fallback к Raw нет.

Display

Итоговый растр, нарисованный в pane после display transform и композиции overlays. Он может быть составным и не обязан быть допустимым material для измерения.

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

Канонический проект — сохранённый источник истины: elements/features, annotations, typed relations, markup groups и связанные настройки. Канонические изменения проходят через project history. Общие Undo/Redo направляются в контекст с текущим фокусом: например, измерительные линии используют отдельную локальную историю и не становятся данными проекта.

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

Selection area

Geometry-only элемент с видимой рамкой. Он автоматически или вручную собирает полностью содержащиеся elements/features в иерархию; вложенность направляет объект в наименьшую подходящую область. Изображения и crop в самой области не хранятся.

Image frame

Обычный элемент, используемый как геометрия crop для записи кадров в его Image Series. Это не selection area.

Markup group

Именованный канонический агрегат ссылок на существующие elements/features, с role, optional sequence index, type и properties. Typed group может появиться через подтверждённый candidate promotion, но отдельного свободного visual CRUD-редактора markup groups в текущем Selector нет.

CV method, pipeline, candidate, evidence

CV method

Одна операция обработки изображения с параметрами и результатом.

Pipeline

Последовательность или граф CV-операций. Method Graph относится к вычислениям, а не к связям элементов интерфейса.

Candidate

Предложенное распознаванием изменение, которое можно просмотреть, подтвердить или отклонить.

Evidence

Набор наблюдений, confidence, геометрии и диагностик, объясняющий происхождение кандидата.

Три разных графа

В Relation Graph различаются hierarchy parent → child, системная проекция owner → feature и редактируемые user edges. FeatureMatch сохраняется отдельно в feature_matches и не является ребром этого графа.