15.3.3.8 Свойства области ¶

Свойства объектов 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. Цвет области можно определить, используя индексы в текущей цветовой карте или как RGB-тройки, где RGB-цвета определены вдоль третьей размерности. Эти цвета можно определить отдельно для всего объекта области, для отдельных граней или для отдельных вершин, и это определяется формой "cdata" следующим образом:

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

Если у объекта области N граней, а "cdata" — это вектор 1xN цветовых индексов или RGB-массив 1xNx3, он определяет цвет каждой грани.

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

cdatamapping: "direct" | {"scaled"} ¶

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

facealpha: скаляр | "flat" | "interp", по умолчанию 1 ¶

Уровень прозрачности граней объекта patch. В настоящее время поддерживаются только двойные значения, где значение 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 относительно данных его вершин граней. Цвет области можно определить, используя индексы в текущей цветовой карте или как RGB-тройки, где RGB-цвета определены в строках "facevertexcdata". Эти цвета можно определять отдельно для всего объекта patch, для отдельных граней или для отдельных вершин, и это определяется формой "facevertexcdata" следующим образом:

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

Если у объекта области N граней, а facevertexcdata — это вектор Nx1 столбцов индексов или RGB-матрица Nx3, он определяет цвет каждой из N граней.

Если у объекта области M вершин, а facevertexcdata — это вектор Mx1 столбцов индексов или RGB-матрица Mx3, он определяет цвет каждой вершины.

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

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

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

vertices: вектор | матрица, по умолчанию 3x2 double ¶

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

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

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

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

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

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

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

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

beingdeleted: {"off"} | "on" ¶

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

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

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

Дополнительную информацию о написании функций графических обработчиков см. в разделе Обработчики.

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

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

Дополнительную информацию о написании функций графических обработчиков см. в разделе Обработчики.

Отображение ¶

clipping: "off" | {"on"} ¶

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

visible: "off" | {"on"} ¶

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

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

displayname: по умолчанию "" ¶

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

Освещение ¶

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", нормали граней автоматически рассчитываются, если свойства 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", нормали вершин автоматически рассчитываются, если свойства 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, который в данный момент связан с этим объектом.

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 всегда "patch".

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

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

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

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

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

edgecolor: цветовое задание | "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: графический маркер ¶

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