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

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

Категории:

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

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

busyaction: "cancel" | {"queue"}

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

interruptible: "off" | {"on"}

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

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

alphadata: scalar | matrix, def. 1

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

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

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

cdata: array, def. 3-by-3 double

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

cdatamapping: "direct" | {"scaled"}

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

cdatasource: string, def. ""

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

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

xdata: matrix, def. [1 2 3]

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

xdatasource: string, def. ""

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

ydata: matrix, def. [1; 2; 3]

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

ydatasource: string, def. ""

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

zdata: matrix, def. 3-by-3 double

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

zdatasource: string, def. ""

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

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

beingdeleted: {"off"} | "on"

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

createfcn: string | function handle, def. [](0x0)

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

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

deletefcn: string | function handle, def. [](0x0)

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

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

Отображение

clipping: "off" | {"on"}

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

visible: "off" | {"on"}

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

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

facealpha: scalar | "flat" | "interp" | "texturemap", def. 1

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

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

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

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

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

facenormals: def. [](0x0)

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

facenormalsmode: {"auto"} | "manual"

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

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

displayname: def. ""

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

Освещение

ambientstrength: scalar, def. 0.3000

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

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

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

diffusestrength: scalar, def. 0.6000

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

specularcolorreflectance: scalar, def. 1

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

specularexponent: scalar, def. 10

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

specularstrength: scalar, def. 0.9000

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

vertexnormals: def. [](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: scalar, def. 6

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

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

buttondownfcn: string | function handle, def. [](0x0)

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

contextmenu: graphics handle, def. [](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: string, def. ""

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

type (read-only): string

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

userdata: Any Octave data, def. [](0x0)

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

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

edgealpha: scalar, def. 1

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

edgecolor: colorspec | "none" | "flat" | "interp", def. [0 0 0]

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

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

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

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

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

linewidth: scalar, def. 0.5000

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

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

Определяет, отображать ли рёбра, соответствующие строкам, столбцам или и строкам, и столбцам данных поверхности.

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

children (read-only): vector of graphics handles, def. [](0x1)

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

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

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

parent: graphics handle

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