15.3.3.7 Свойства изображения

Свойства объектов image (см. изображение):

Категории:

Выполнение обратного вызова | Создание/удаление | Отображение | Данные изображения | Взаимодействие с мышью | Идентификация объекта | Родительские/дочерние объекты

Выполнение обратного вызова

busyaction: "cancel" | {"queue"}

Определяет, как Octave обрабатывает выполнение свойств обратного вызова этого объекта, если не может прервать выполняющийся обратный вызов другого объекта. Это имеет значение только в том случае, если для свойства interruptible объекта, выполняющего обратный вызов, установлено значение "off". Свойство busyaction объекта, прерывающего выполнение, указывает, будет ли его обратный вызов поставлен в очередь ("queue" (по умолчанию)) или отброшен ("cancel"). См. раздел Обратные вызовы.

interruptible: "off" | {"on"}

Указывает, могут ли функции обратного вызова этого объекта прерываться другими обратными вызовами. По умолчанию значение interruptible равно "on", и обратные вызовы, использующие функции drawnow, figure, waitfor, getframe или pause, в конечном итоге прерываются. См. раздел Обратные вызовы.

Создание/удаление

beingdeleted: {"off"} | "on"

Свойство указывает, что функция инициировала удаление объекта. Значение beingdeleted равно true, пока объект не будет удалён.

createfcn: string | function handle, def. [](0x0)

Функция обратного вызова, выполняемая сразу после создания изображения. Функция задаётся с помощью свойства по умолчанию корневого объекта, например set (groot, "defaultimagecreatefcn", 'disp ("image created!")').

Сведения о написании функций-слушателей графических объектов см. в разделе Обратные вызовы.

deletefcn: string | function handle, def. [](0x0)

Функция обратного вызова, выполняемая непосредственно перед удалением изображения.

Сведения о написании функций-слушателей графических объектов см. в разделе Обратные вызовы.

Отображение

clipping: "off" | {"on"}

Если clipping равно "on", изображение обрезается по пределам родительских осей.

visible: "off" | {"on"}

Если visible равно "off", изображение не отображается на экране.

Данные изображения

alphadata: scalar | matrix, def. 1

Прозрачность для объектов изображений пока не реализована. alphadata не используется.

alphadatamapping: "direct" | {"none"} | "scaled"

Прозрачность для объектов изображений пока не реализована. alphadatamapping не используется.

cdata: array, def. 64-by-64 double

Данные о цвете объекта изображения. Данные хранятся либо в виде двумерной матрицы, в которой значение каждого элемента определяет цвет соответствующего пикселя согласно текущей цветовой карте, либо в виде трёхмерного массива, третье измерение которого содержит отдельные компоненты красного, синего и зелёного цветов для каждого пикселя. Для массивов RGB значения, соответствующие минимальному и максимальному цветам, зависят от класса "cdata". Значения с плавающей точкой и логические значения находятся в диапазоне от 0 до 1, а значения целых чисел — в диапазоне от intmin до intmax для соответствующего класса целых чисел.

cdatamapping: {"direct"} | "scaled"

Задаёт метод сопоставления данных из свойства "cdata" с текущей цветовой картой. При сопоставлении "Direct" цвет выбирается с использованием значения "cdata" в качестве индекса в текущей цветовой карте. При сопоставлении "Scaled" значения "cdata" масштабируются в диапазон, заданный свойством осей "clim".

xdata: two-element vector, def. [1 64]

Двухэлементный вектор [xfirst xlast] задаёт координаты x центров первого и последнего столбцов изображения.

Если присвоить xdata пустую матрицу ([]), будет восстановлено значение по умолчанию [1 columns(image)].

ydata: two-element vector, def. [1 64]

Двухэлементный вектор [yfirst ylast] задаёт координаты y центров первой и последней строк изображения.

Если присвоить ydata пустую матрицу ([]), будет восстановлено значение по умолчанию [1 rows(image)].

Взаимодействие с мышью

buttondownfcn: string | function handle, def. [](0x0)

Сведения о написании функций-слушателей графических объектов см. в разделе Обратные вызовы.

contextmenu: graphics handle, def. [](0x0)

Графический дескриптор объекта uicontextmenu, связанного в данный момент с этим объектом изображения.

hittest: "off" | {"on"}

Указывает, обрабатывает ли изображение события мыши или передаёт их родительским объектам. Если это свойство включено, объект может реагировать на щелчки мышью, выполняя "buttondownfcn", отображая uicontextmenu и, в конечном итоге, становясь корневым "currentobject". Это свойство имеет значение, только если объект может принимать щелчки мышью; это определяется свойством "pickableparts". См. свойство pickableparts.

pickableparts: "all" | "none" | {"visible"}

Указывает, будет ли изображение принимать щелчки мышью. По умолчанию pickableparts равно "visible", и на щелчки мышью могут реагировать только видимые части изображения или его дочерние объекты. Если pickableparts равно "all", на щелчки мышью могут реагировать как видимые, так и невидимые части (или дочерние объекты). Если pickableparts равно "none", щелчки мышью по объекту игнорируются и передаются любым объектам под ним. Когда объект настроен на приём щелчков мышью, способ их обработки определяется свойством "hittest". См. свойство hittest.

selected: {"off"} | "on"

Свойство указывает, выбрано ли это изображение.

selectionhighlight: "off" | {"on"}

Если selectionhighlight равно "on", состояние выбора изображения визуально подсвечивается.

Идентификация объекта

tag: string, def. ""

Пользовательская строка для обозначения графического объекта.

type (read-only): string

Имя класса графического объекта. Значение type всегда равно "image".

userdata: Any Octave data, def. [](0x0)

Пользовательские данные, связанные с графическим объектом.

Родительские/дочерние объекты

children (read-only): vector of graphics handles, def. [](0x1)

Дочерние объекты изображений для объектов изображений пока не реализованы. children не используется.

handlevisibility: "callback" | "off" | {"on"}

Если handlevisibility равно "off", дескриптор изображения не отображается в свойстве "children" родительского объекта.

parent: graphics handle

Дескриптор родительского графического объекта.