15.3.3.8 Свойства патча

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

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

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

ambientstrength: скаляр, по умолчанию 0.3000

Сила окружающего света. Значение от 0.0 до 1.0

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

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

beingdeleted: {"off"} | "on"

busyaction: "cancel" | {"queue"}

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

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

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

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

Данные, определяющие цвет объекта patch. Цвет patch можно определить для граней или для вершин.

Если cdata является скалярным индексом в текущей цветовой карте или тройкой RGB, это определяет цвет всех граней.

Если cdata является N-элементным вектором индексов или N-на-3 матрицей (RGB), это определяет цвет каждой из N граней.

Если cdata является N-на-M или N-на-M-на-3 (RGB) матрицей, это определяет цвет каждой вершины.

cdatamapping: "direct" | {"scaled"}

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

children не используется.

clipping: "off" | {"on"}

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

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

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

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

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

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

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

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

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

diffusestrength: скаляр, по умолчанию 0.6000

Сила рассеянного отражения. Значение от 0.0 (нет рассеянного отражения) до 1.0 (полное рассеянное отражение).

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

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

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

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

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

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

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

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

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

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

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

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

facenormals: по умолчанию [](0x0)

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

facenormalsmode: {"auto"} | "manual"

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

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

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

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

facevertexcdata: по умолчанию [](0x0)

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

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

hittest: "off" | {"on"}

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

interruptible: "off" | {"on"}

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

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

linewidth: по умолчанию 0.5000

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

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

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

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

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

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

markersize: скаляр, по умолчанию 6

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

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

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

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

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

selected: {"off"} | "on"

selectionhighlight: "off" | {"on"}

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

Отражение для цветной засветки. Значение от 0,0 (цвет базовой поверхности) до 1,0 (цвет источника света).

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

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

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

Сила засветки. Значение от 0,0 (нет засветки) до 1,0 (полная засветка).

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

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

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

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

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

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

vertexnormals: знач. по умолчанию [](0x0)

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

vertexnormalsmode: {"auto"} | "manual"

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

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

visible: "off" | {"on"}

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

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

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

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