15.3.3.11 Свойства источника света

Свойства объектов light (см. источник света):

Категории:

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

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

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: строка | дескриптор функции, по умолчанию [](0x0)

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

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

deletefcn: строка | дескриптор функции, по умолчанию [](0x0)

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

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

Отображение

clipping: "off" | {"on"}

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

visible: "off" | {"on"}

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

Освещение

color: colorspec, по умолчанию [1 1 1]

Цвет источника света. См. colorspec.

position: по умолчанию [1 0 1]

Положение источника света.

style: {"infinite"} | "local"

Эта строка задает, исходит ли свет от источника, находящегося на бесконечном расстоянии ("infinite"), или от локального точечного источника ("local").

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

buttondownfcn: строка | дескриптор функции, по умолчанию [](0x0)

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

contextmenu: графический дескриптор, по умолчанию [](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: строка, по умолчанию ""

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

type (только для чтения): строка

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

userdata: любые данные Octave, по умолчанию [](0x0)

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

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

children (только для чтения): вектор графических дескрипторов, по умолчанию [](0x1)

У объектов источника света нет дочерних объектов. children не используется.

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

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

parent: графический дескриптор

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