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

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

Категории: ¶

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

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

busyaction: "cancel" | {"queue"} ¶

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

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

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

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

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

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

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

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

cdata: массив, по умолчанию 3x3 double ¶

Значения данных цвета для вершин поверхности. Данные хранятся либо в 2-мерной матрице того же размера, что и "zdata", где значение каждого элемента определяет цвет этой вершины в соответствии с текущей цветовой палитрой, либо в 3-мерном массиве, где третье измерение содержит отдельные компоненты красного, синего и зеленого цвета для каждой вершины.

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

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

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

Имя переменной в рабочей области, содержащей данные, которые будут использоваться для свойства "cdata". Данные передаются в "cdata" с помощью функции refreshdata.

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

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

Данные для координаты x.

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

Имя переменной в рабочей области, содержащей данные, которые будут использоваться для свойства "xdata". Данные передаются в "xdata" с помощью функции refreshdata.

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

Данные для координаты y.

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

Имя переменной в рабочей области, содержащей данные, которые будут использоваться для свойства "ydata". Данные передаются в "ydata" с помощью функции refreshdata.

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

Данные для координаты z.

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

Имя переменной в рабочей области, содержащей данные, которые будут использоваться для свойства "zdata". Данные передаются в "zdata" с помощью функции refreshdata.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Внешний вид граней ¶

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

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

facecolor: цвет | "none" | {"flat"} | "interp" ¶

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

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

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

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

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

Освещение ¶

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

Сила рассеянного света. Значение от 0,0 до 1,0.

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

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

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

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

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" ¶

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

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

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

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

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

Взаимодействие с мышкой ¶

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

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

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

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

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

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

edgecolor: цветовое задание | "none" | "flat" | "interp", по умолчанию [0 0 0] ¶

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

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

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

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

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

linewidth: скаляр, по умолчанию 0.5000 ¶

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

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

Указывает, отображать ли края, связанные с строками, столбцами или обоими из них поверхностных данных.

Родитель/Потомки ¶

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

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

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

Если handlevisibility — "off", дескриптор поверхности не виден в свойстве "children" родителя.

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

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