15.3.3.8 Свойства Patch

Свойства объектов patch (см. patch):

Категории:

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

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

busyaction: "cancel" | {"queue"}

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

interruptible: "off" | {"on"}

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

Цвет и прозрачность

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

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

cdata: скаляр | матрица | массив, по умолч. [](0x0)

Данные, определяющие цвет объекта patch относительно данных его координат x/y/z. Цвет patch можно задать с помощью индексов в текущей цветовой карте или в виде RGB-троек, где цвета RGB определяются вдоль третьего измерения. Эти цвета можно задавать отдельно для всего объекта patch, отдельных граней или отдельных вершин; способ задания определяется формой "cdata" следующим образом:

Если "cdata" — скалярный индекс в текущей цветовой карте или RGB-тройка размером 1 на 1 на 3, он задаёт цвет всех граней и рёбер.

Если объект patch имеет N граней, а "cdata" — вектор размером 1 на N с индексами цветовой карты или RGB-массив размером 1 на N на 3, он задаёт цвет каждой грани.

Если объект patch имеет N граней и M вершин на грань, а cdata — матрица размером M на N с индексами цветовой карты или RGB-массив размером M на N на 3, он задаёт цвет каждой вершины. (Форма "cdata" должна совпадать с формой "xdata", "ydata" и "zdata".)

cdatamapping: "direct" | {"scaled"}

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

facealpha: скаляр | "flat" | "interp", по умолч. 1

Уровень прозрачности граней объекта patch. В настоящее время поддерживаются только значения типа double: значение 0 означает полную прозрачность, а значение 1 — сплошные непрозрачные грани. Если задать свойству значение "flat" или "interp", грани не будут отображаться. Кроме того, грани не сортируются в порядке от задних к передним, что может привести к неожиданным результатам при отображении наложенных друг на друга прозрачных граней.

facecolor: {colorspec} | "none" | "flat" | "interp", по умолч. [0 0 0]

Цвет граней объекта patch, задаваемый допустимой спецификацией цвета или одним из значений "none", "flat" или "interp". Значения "flat" и "interp" задают либо один цвет для каждой грани, либо цвет, интерполированный между вершинами грани с использованием данных о цвете, хранящихся в свойстве "cdata" или "facevertexcdata". См. colorspec.

facelighting: {"flat"} | "gouraud" | "none" | "phong"

Если задано значение, отличное от "none", грани объекта отображаются с эффектами света и тени. Поддерживаются значения "none" (без эффектов освещения), "flat" (гранёный вид) и "gouraud" (линейная интерполяция эффектов освещения между вершинами). Значение "phong" устарело и действует так же, как "gouraud".

facevertexalphadata: по умолч. [](0x0)

Управление прозрачностью отдельных вершин граней для объектов patch пока не реализовано. facevertexalphadata не используется.

facevertexcdata: скаляр | матрица, по умолч. [](0x0)

Данные, определяющие цвет объекта patch относительно данных его граней и вершин. Цвет patch можно задать с помощью индексов в текущей цветовой карте или в виде RGB-троек, где цвета RGB определяются в строках "facevertexcdata". Эти цвета можно задавать отдельно для всего объекта patch, отдельных граней или отдельных вершин; способ задания определяется формой "facevertexcdata" следующим образом:

Если facevertexcdata — скалярный индекс в текущей цветовой карте или RGB-тройка размером 1 на 3, он задаёт цвет всех граней и рёбер.

Если объект patch имеет N граней, а facevertexcdata — вектор-столбец размером N на 1 с индексами или RGB-матрица размером N на 3, он задаёт цвет каждой из N граней.

Если объект patch имеет M вершин, а facevertexcdata — вектор-столбец размером M на 1 с индексами или RGB-матрица размером M на 3, он задаёт цвет каждой вершины.

Данные координат

faces: вектор | матрица, по умолч. [1 2 3]

Список связности граней patch, хранящийся в виде матрицы M x N; каждая из M граней задаётся строкой, содержащей до N вершин, а каждый элемент содержит индекс строки вершины, хранящейся в свойстве вершины. Для заполнения пустых элементов строк граней, в которых меньше N вершин, используются значения NaN.

vertices: вектор | матрица, по умолч. double размером 3 на 2

Список вершин patch, хранящийся в виде матрицы N x 3; каждая строка содержит координаты x, y и z вектора и используется вместе со свойством граней для определения структуры patch.

xdata: вектор | матрица, по умолч. [0; 1; 0]

Координаты x вершин patch.

ydata: вектор | матрица, по умолч. [1; 1; 0]

Координаты y вершин patch.

zdata: вектор | матрица, по умолч. [](0x0)

Координаты z вершин patch.

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

beingdeleted: {"off"} | "on"

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

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

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

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

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

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

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

Отображение

clipping: "off" | {"on"}

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

visible: "off" | {"on"}

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

Параметры легенды

displayname: по умолч. ""

Текст записи легенды, соответствующей этому объекту patch.

Освещение

ambientstrength: скаляр, по умолч. 0.3000

Интенсивность фонового освещения. Значение от 0.0 до 1.0.

backfacelighting: "lit" | {"reverselit"} | "unlit"

"lit": Нормали используются для освещения без изменений. "reverselit": Нормали всегда направлены к точке наблюдения. "unlit": Грани с нормалями, направленными в сторону от точки наблюдения, не освещаются.

diffusestrength: скаляр, по умолч. 0.6000

Интенсивность диффузного отражения. Значение от 0.0 (нет диффузного отражения) до 1.0 (полное диффузное отражение).

facenormals: по умолч. [](0x0)

Нормали граней используются для освещения рёбер или граней, если для свойств edgelighting или facelighting задано значение "flat". Установка facenormals также принудительно устанавливает для свойства facenormalsmode значение "manual".

facenormalsmode: {"auto"} | "manual"

Если для этого свойства задано значение "auto", facenormals вычисляются автоматически, если для свойства edgelighting или facelighting задано значение "flat" и в тех же осях присутствует хотя бы один видимый объект light.

specularcolorreflectance: скаляр, по умолч. 1

Коэффициент отражения для зеркального цвета. Значение от 0.0 (цвет нижележащей грани) до 1.0 (цвет источника света).

specularexponent: скаляр, по умолч. 10

Показатель степени для зеркального отражения. Чем меньше значение, тем более рассеянным становится отражение.

specularstrength: скаляр, по умолч. 0.9000

Интенсивность зеркального отражения. Значение от 0.0 (нет зеркального отражения) до 1.0 (полное зеркальное отражение).

vertexnormals: по умолч. [](0x0)

Нормали вершин используются для освещения рёбер или граней, если для свойств edgelighting или facelighting задано значение "gouraud". Установка vertexnormals также принудительно устанавливает для свойства vertexnormalsmode значение "manual".

vertexnormalsmode: {"auto"} | "manual"

Если для этого свойства задано значение "auto", vertexnormals вычисляются автоматически, если для свойства edgelighting или facelighting задано значение "gouraud" и в тех же осях присутствует хотя бы один видимый объект light.

Внешний вид маркера

marker: "*" | "+" | "." | "<" | ">" | "^" | "_" | "d" | "diamond" | "h" | "hexagram" | {"none"} | "o" | "p" | "pentagram" | "s" | "square" | "v" | "x" | "|"

См. свойство маркера линии.

markeredgecolor: {"auto"} | "flat" | "none"

См. свойство цвета края маркера линии.

markerfacecolor: "auto" | "flat" | {"none"}

См. свойство цвета заливки маркера линии.

markersize: скаляр, по умолч. 6

См. свойство размера маркера линии.

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

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

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

contextmenu: графический дескриптор, по умолч. [](0x0)

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

hittest: "off" | {"on"}

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

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

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

selected: {"off"} | "on"

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

selectionhighlight: "off" | {"on"}

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

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

tag: строка, по умолч. ""

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

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

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

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

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

Внешний вид контура

edgealpha: скаляр | матрица, по умолч. 1

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

edgecolor: colorspec | "none" | "flat" | "interp", по умолч. [0 0 0]

Цвет рёбер объекта patch, задаваемый допустимой спецификацией цвета или одним из значений "none", "flat" или "interp". Значения "flat" и "interp" задают либо один цвет для каждого ребра, либо цвет, интерполированный между вершинами ребра с использованием данных о цвете, хранящихся в свойстве "cdata". См. colorspec.

edgelighting: "flat" | "gouraud" | {"none"} | "phong"

Если задано значение, отличное от "none", рёбра объекта отображаются с эффектами света и тени. Поддерживаются значения "none" (без эффектов освещения), "flat" (гранёный вид) и "gouraud" (линейная интерполяция эффектов освещения между вершинами). Значение "phong" устарело и действует так же, как "gouraud".

linestyle: {"-"} | "--" | "-." | ":" | "none"

См. стили линий.

linewidth: скаляр, по умолч. 0.5000

См. свойство толщины линии.

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

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

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

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

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

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

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