15.3.3.8 Свойства поверхности

Свойства объектов surface (см. поверхность):

alphadata: scalar | matrix, def. 1

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

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

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

ambientstrength: scalar, def. 0.30000

Сила рассеянного света. Значение от 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: матрица, по умолчанию 3x3 double

cdatamapping: "direct" | {"scaled"}

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

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

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

clipping: "off" | {"on"}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

facecolor: {"flat"} | "interp" | "none" | "texturemap"

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 присутствует и виден на тех же осях.

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

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

hittest: "off" | {"on"}

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

interruptible: "off" | {"on"}

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

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

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

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

См. свойство line linewidth.

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

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

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

См. свойство line markeredgecolor.

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

См. свойство line markerfacecolor.

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

См. свойство line markersize.

meshstyle: {"both"} | "column" | "row"

parent: графический маркер

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

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

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

selected: {"off"} | "on"

selectionhighlight: "off" | {"on"}

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

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

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

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

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

Сила блика. Значение от 0.0 (нет блика) до 1.0 (полный блик).

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

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

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

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

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

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

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

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

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

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

vertexnormalsmode: {"auto"} | "manual"

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

visible: "off" | {"on"}

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

xdata: матрица, по умолчанию [1 2 3]

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

ydata: матрица, по умолчанию [1; 2; 3]

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

zdata: матрица, по умолчанию 3x3 double

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