Основные понятия

WpfUserInteractionVisualTool - базовый класс для визуальных инструментов, которые выполняют взаимодействие между пользователем и интерактивным объектом в WpfImageViewer с помощью устройств ввода (таких как клавиатура, мышь и т. д.). Класс позволяет реализовать пользовательскую (определяемую пользователем) логику взаимодействия между коллекцией интерактивных объектов и пользователем.Классы, производные от этого класса, являются визуальными инструментами, такими как WpfAnnotationVisualTool, WpfRectangularSelectionTool, WpfCustomSelectionTool.

Основными понятиями модели интерактивного взаимодействия являются:

• Взаимодействие - изменение некоторых свойств объекта (размер, местоположение,...) с помощью устройства ввода (например, клавиатура, мышь и т. д.).
• Интерактивный объект - объект, реализующий интерфейс IInteractiveObject, с которым можно взаимодействовать в интерактивном режиме.
  Интерфейс IInteractiveObject определяет базовые свойства интерактивного объекта, необходимые для организации процесса взаимодействия:
  • Свойство IInteractiveObject.InteractionController определяет контроллер взаимодействия, используемый для текущего интерактивного объекта
  • Свойства IInteractiveObject.GetBoundingBox и IInteractiveObject.GetDrawingBox определяют, соответственно, ограничивающий прямоугольник объекта и прямоугольник, в котором должен быть нарисован текущий объект
  • Метод IInteractiveObject.IsPointOnObject определяет, находится ли указанная точка выше текущего интерактивного объекта
  • Метод IInteractiveObject.GetPointTransform возвращает преобразование точек из системы координат интерактивного объекта в систему координат просмотрщика изображений
  • IInteractiveObject.Draw метод выполняет рисование объекта на указанном объекте System.Drawing.Graphics
  • Событие IInteractiveObject.StateChanged указывает на изменение состояния интерактивного объекта.
• Контроллер взаимодействия - объект, определяющий логику связи между некоторыми наборами областей взаимодействия и интерактивным объектом (например, контроллер типа WpfRectangularObjectTransformer содержит логику преобразования прямоугольных объектов, а также набор областей взаимодействия, с помощью которых преобразуется текущий объект).
  Контроллеры интерактивного взаимодействия реализуют интерфейс IInteractionController, который предоставляет им следующие свойства:
  • Свойство IInteractionController.InteractionAreas определяет набор областей взаимодействия для текущего контроллера
  • Метод IInteractionController.OnInteraction определяет логику связи между областью взаимодействия и интерактивным объектом
  • Метод IInteractionController.UpdateInteractionAreas выполняет обновление областей взаимодействия (их расположение, видимость, состояние и др.).
• Область взаимодействия - некоторая область на объекте, с помощью которой пользователь взаимодействует с интерактивным объектом (например, точка, потянув за которую объект можно растянуть или повернуть). Область взаимодействия может быть как невидимой (например, область, с помощью которой выполняется перемещение объекта), так и видимой (например, точка вращения, помощник вращения).
  Каждая область взаимодействия является производной от класса WpfInteractionArea и имеет следующие особенности:
  • Метод WpfInteractionArea.GetBoundingBox возвращает ограничивающий прямоугольник области взаимодействия
  • Метод WpfInteractionArea.IsViewerPointOnArea определяет, находится ли указанная точка над областью взаимодействия
  • Метод WpfInteractionArea.Render визуализирует область взаимодействия в указанном контексте рисования.
  • WpfInteractionArea.InteractionType свойство определяет тип интерактивного взаимодействия (перемещение, щелчок и т. д.), который влияет на логику инициирования события OnInteraction в контроллере интерактивного взаимодействия
  • WpfInteractionArea.Cursor свойство определяет вид курсора при наведении указателя мыши на область
  • WpfInteractionArea.ActionMouseButton свойство определяет кнопку мыши, на которую реагирует текущая область
• Interaction visual tool - класс, производный от класса WpfUserInteractionVisualTool и предоставляющий следующую функциональность:
  • хранение коллекции интерактивных объектов
  • отображение интерактивных объектов в просмотрщике изображений
  • выбор активного объекта (в данный момент идет взаимодействие)
  • отображение областей взаимодействия контроллера активного взаимодействия
  • определение активной области и конвертация событий из устройства ввода (например, мышь и т. д.) в события взаимодействия для передачи контроллеру взаимодействия активного объекта.

Основные принципы работы модели взаимодействия

Работу модели взаимодействия можно разделить на 5 этапов:

1. Визуальный инструмент взаимодействия получает выбранный объект и считает его активным объектом, визуальный инструмент взаимодействия получает контроллер взаимодействия из активного объекта и считает его активным контроллером взаимодействия.
2. Визуальный инструмент взаимодействия выполняет вызов метода UpdateInteractionAreas для активного контроллера взаимодействия и получает список областей взаимодействия, используя свойство InteractionAreas контроллера взаимодействия. Визуальный инструмент взаимодействия отображает области взаимодействия поверх других интерактивных объектов в средстве просмотра изображений.
3. Визуальный инструмент взаимодействия анализирует события, поступающие от устройств ввода (например, нажатие кнопки мыши, перемещение указателя мыши), и определяет область взаимодействия, с которой работает пользователь. События от устройств ввода преобразуются в события взаимодействия в соответствии с типом области взаимодействия, а затем направляются в активный контроллер взаимодействия с помощью метода IInteractionController.OnInteraction(InteractionEventArgs).
4. Контроллер взаимодействия в методе OnInteraction выполняет логику взаимодействия между областью взаимодействия и интерактивным объектом. Например: Интерактивный объект поддерживает вращение, реализуя интерфейс интерактивного объекта, в котором существует свойство RotationAngle. После получения контроллером события взаимодействия с точкой вращения (точка вращения - область взаимодействия) он вычислит угол поворота, на который необходимо повернуть объект, и изменит свойство RotationAngle объекта на необходимый угол.
5. Когда контроллер взаимодействия изменяет какое-либо свойство, которое изменяет состояние объекта (например, угол поворота), объект генерирует событие StateChanged, на которое подписывается визуальный инструмент взаимодействия. Визуальный инструмент взаимодействия будет выполнять обновление интерактивных областей в контроллере активного взаимодействия, а затем перерисовывать интерактивный объект и интерактивные области в просмотрщике изображений.

Иерархия интерфейсов интерактивных объектов

IInteractiveObject - базовый интерфейс, определяющий общие характеристики всех интерактивных объектов.

IRectangularInteractiveObject - определяет прямоугольный объект, поддерживающий вращение.

IPointBasedInteractiveObject - определяет объект, состоящий из набора точек.

Примечание: Тот факт, что свойства интерактивных объектов описываются иерархией интерфейсов, позволил создать интерактивные объекты, которые могли бы реализовывать сразу несколько интерфейсов интерактивных объектов. Например, объект может поддерживать изменение своих базовых точек (IPointBasedInteractiveObject), а также изменение его формы (растяжение, сжатие, поворот) с использованием прямоугольного интерфейса объекта (IRectangularInteractiveObject).

Иерархия контроллеров взаимодействия

Контроллеры взаимодействия для удобства разделены на 2 группы:

• построители - выполняют первоначальную постройку нового объекта
• трансформеры - выполяют трансформацию существующего объекта

IInteractionController - базовый интерфейс, определяющий общие характеристики всех интерактивных контроллеров взаимодействия.

WpfRectangularObjectBuilder - конструктор объектов, реализующий интерфейс IRectangularInteractiveObject.

WpfRectangularObjectTransformer - преобразователь объектов, реализующий интерфейс IRectangularInteractiveObject. Предоставляет возможность перемещать, растягивать, сжимать, вращать объект.

WpfPointBasedObjectPointBuilder - конструктор объектов, реализующий интерфейс IPointBasedInteractiveObject. Предоставляет возможность конструировать объект, добавляя к нему новые точки щелчком мыши.

WpfPointBasedObjectFreehandBuilder - конструктор объектов, реализующий интерфейс IPointBasedInteractiveObject. Предоставляет возможность конструировать объект, добавляя к нему новые точки движением мыши.

WpfPointBasedObjectLineBuilder - конструктор объектов, реализующий интерфейс IPointBasedInteractiveObject. Предоставляет возможность конструировать объект, состоящий из двух точек (линии).

WpfPointBasedObjectRectangularBuilder - конструктор объектов, реализующий интерфейс IPointBasedInteractiveObject. Предоставляет возможность конструировать объект путем масштабирования всех его точек.

WpfPointBasedObjectPointTransformer - преобразователь объектов, реализующий интерфейс IPointBasedInteractiveObject. Предоставляет возможность отмечать, перемещать, удалять, добавлять точки объекта.

WpfPointBasedObjectRectangularTransformer - преобразователь объектов, реализующий интерфейс IPointBasedInteractiveObject. Предоставляет возможность перемещать, растягивать, сжимать, вращать объект.

WpfPointBasedObjectDistortionTransformer - преобразователь объектов, реализующий интерфейс IPointBasedInteractiveObject. Предоставляет возможность применять искажение и перекос.

WpfCompositeInteractionController - составной контроллер взаимодействия, который может объединять работу нескольких контроллеров взаимодействия и используется для:

• интегрирования функциональности нескольких контроллеров взаимодействия, которые работают с одним интерактивным объектом
• объединения несколько контроллеров, которые работают с разными интерактивными объектами и таким образом организовать взаимодействие с составным интерактивным объектом.

Иерархия областей взаимодействия

Базовым классом для всех областей взаимодействия является класс WpfInteractionArea.

Области взаимодействия для удобства разделены на 3 группы:

• Точки интерактивного объекта:
  • WpfInteractionPoint - точка взаимодействия в форме круга, характеризующаяся положением и радиусом. Эта область используется как точка изменения размера объекта в большинстве контроллеров взаимодействия.
  • WpfInteractionRectangularPoint - точка взаимодействия в форме прямоугольника, характеризующаяся позицией и радиусом.
  • WpfInteractionPolygonPoint - точка взаимодействия в форме прямоугольника (производная от WpfInteractionRectangularPoint), характеризующаяся индексом точки объекта, с которой она связана. Эта область используется в контроллерах объектов IPointBasedInteractiveObject для взаимодействия с точками объекта.
  • WpfRotationPoint - область взаимодействия, которая производная от WpfInteractionPoint и используется для выполнения поворота объекта.
  • WpfRotationAssistantArea - область взаимодействия, определяющая "помощника вращения" - область в форме круга, разделенного на сектора, с помощью которых можно выполнить поворот объекта на определенный угол.
• Области взаимодействия, связанные с интерактивным объектом:
  • WpfInteractiveObjectArea - область взаимодействия, совпадающая с областью интерактивного объекта, которая определяется методом IInteractiveObject.IsPointOnObject(X,Y). Эта область используется в некоторых контроллерах взаимодействия для назначения области, с помощью которой реализуется изменение положения объекта.
  • WpfInteractiveObjectBoundingBoxArea - область взаимодействия, совпадающая с ограничивающим прямоугольником интерактивного объекта. Эта область используется в некоторых контроллерах взаимодействия для назначения области, с помощью которой реализуется изменение положения объекта.
  • WpfInteractiveObjectBoundingBoxSelection - область взаимодействия, которая является производной от WpfInteractiveObjectBoundingBoxArea. Эта область используется в некоторых контроллерах взаимодействия для обозначения области ограничивающего прямоугольника объекта.
• Области взаимодействия, связанные с просмотрщиком изображений:
  • WpfImageViewerArea - область, охватывающая весь просмотрщик изображений. Эта область используется в конструкторах для назначения области построения объекта.