Свойства освещения

Внешний вид и поведение света

Light свойства управляют внешним видом и поведением Light объекты. Изменяя значения свойств, можно изменять некоторые аспекты источника света. Используйте точечную нотацию для запроса и задания свойств.

h = light;
c = h.Color;
h.Style = 'local';

Цвет и стиль

развернуть все

`Color` - Цвет света
`[1 1 1]` (по умолчанию) | триплет RGB | шестнадцатеричный цветовой код | `'r'` | `'g'` | `'b'` | ...

Цвет света, определяемый как триплет RGB, шестнадцатеричный код цвета, имя цвета или короткое имя. Триплет RGB по умолчанию [1 1 1] соответствует белому.

Триплеты RGB и шестнадцатеричные цветовые коды полезны для задания пользовательских цветов.

Триплет RGB - это трехэлементный вектор строки, элементы которого задают интенсивности красной, зеленой и синей составляющих цвета. Интенсивности должны находиться в диапазоне [0,1]; например, [0.4 0.6 0.7].
Шестнадцатеричный цветовой код - это символьный вектор или строковый скаляр, начинающийся с хэш-символа (#), за которыми следуют три или шесть шестнадцатеричных цифр, которые могут варьироваться от 0 кому F. Значения не чувствительны к регистру. Таким образом, цветовые коды '#FF8800', '#ff8800', '#F80', и '#f80' эквивалентны.

Можно также задать некоторые общие цвета по имени. В этой таблице перечислены параметры именованного цвета, эквивалентные триплеты RGB и шестнадцатеричные цветовые коды.

Имя цвета	Краткое имя	Триплет RGB	Шестнадцатеричный цветовой код
`'red'`	`'r'`	`[1 0 0]`	`'#FF0000'`
`'green'`	`'g'`	`[0 1 0]`	`'#00FF00'`
`'blue'`	`'b'`	`[0 0 1]`	`'#0000FF'`
`'cyan'`	`'c'`	`[0 1 1]`	`'#00FFFF'`
`'magenta'`	`'m'`	`[1 0 1]`	`'#FF00FF'`
`'yellow'`	`'y'`	`[1 1 0]`	`'#FFFF00'`
`'black'`	`'k'`	`[0 0 0]`	`'#000000'`
`'white'`	`'w'`	`[1 1 1]`	`'#FFFFFF'`

Вот триплеты RGB и шестнадцатеричные цветовые коды для цветов по умолчанию MATLAB ®, используемых на многих типах графиков.

Триплет RGB	Шестнадцатеричный цветовой код	Внешность
`[0 0.4470 0.7410]`	`'#0072BD'`
`[0.8500 0.3250 0.0980]`	`'#D95319'`
`[0.9290 0.6940 0.1250]`	`'#EDB120'`
`[0.4940 0.1840 0.5560]`	`'#7E2F8E'`
`[0.4660 0.6740 0.1880]`	`'#77AC30'`
`[0.3010 0.7450 0.9330]`	`'#4DBEEE'`
`[0.6350 0.0780 0.1840]`	`'#A2142F'`

Пример: 'green'

`Style` - Тип источника света
`'infinite'` (по умолчанию) | `'local'`

Тип источника света, указанный как одно из следующих значений:

'infinite' - Поместите свет на бесконечность. Используйте Position для указания направления, от которого светится свет параллельными лучами.
'local' - Размещение источника света в месте, указанном Position собственность. Источник света - это точечный источник, который излучает из местоположения во всех направлениях.

`Position` - Расположение источника света
`[1 0 1]` (по умолчанию) | трехэлементный вектор формы `[x y z]`

Расположение источника света, заданного как трехэлементный вектор формы [x y z]. Определите векторные элементы в единицах данных от начала координат осей до координат (x, y, z). Фактическое местоположение источника света зависит от значения Style собственность.

Пример: [-40 -4 140]

Положение

развернуть все

`Position` - Расположение источника света
`[1 0 1]` (по умолчанию) | трехэлементный вектор формы `[x y z]`

Пример: [-40 -4 140]

`Visible` - Видимость света от источника света
`'on'` (по умолчанию) | логическое значение on/off

Видимость света от источника света, указанного как 'on' или 'off'или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.

Отзывы

развернуть все

`CreateFcn` - Функция создания
`''` (по умолчанию) | дескриптор функции | массив ячеек | символьный вектор

Функция создания объекта, заданная как одно из следующих значений:

Дескриптор функции.
Массив ячеек, в котором первый элемент является дескриптором функции. Последующие элементы в массиве ячеек являются аргументами для передачи функции обратного вызова.
Вектор символов, содержащий допустимое выражение MATLAB (не рекомендуется). MATLAB вычисляет это выражение в базовой рабочей области.

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

Это свойство определяет функцию обратного вызова, выполняемую при создании объекта MATLAB. MATLAB инициализирует все значения свойств перед выполнением CreateFcn обратный вызов. Если не указать CreateFcn , то MATLAB выполняет функцию создания по умолчанию.

Установка CreateFcn свойство существующего компонента не оказывает никакого влияния.

Если это свойство указано как дескриптор функции или массив ячеек, можно получить доступ к объекту, создаваемому с помощью первого аргумента функции обратного вызова. В противном случае используйте gcbo для доступа к объекту.

`DeleteFcn` - Функция удаления
`''` (по умолчанию) | дескриптор функции | массив ячеек | символьный вектор

Функция удаления объекта, заданная как одно из следующих значений:

Дескриптор функции.
Массив ячеек, в котором первый элемент является дескриптором функции. Последующие элементы в массиве ячеек являются аргументами для передачи функции обратного вызова.
Вектор символов, содержащий допустимое выражение MATLAB (не рекомендуется). MATLAB вычисляет это выражение в базовой рабочей области.

Это свойство определяет функцию обратного вызова, выполняемую при удалении объекта MATLAB. MATLAB выполняет команду DeleteFcn обратный вызов перед уничтожением свойств объекта. Если не указать DeleteFcn , то MATLAB выполняет функцию удаления по умолчанию.

Если это свойство указано как дескриптор функции или массив ячеек, можно получить доступ к удаляемому объекту с помощью первого аргумента функции обратного вызова. В противном случае используйте gcbo для доступа к объекту.

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

развернуть все

`BeingDeleted` - Статус удаления
логическое значение вкл/выкл

Это свойство доступно только для чтения.

Состояние удаления, возвращаемое как логическое значение включения/выключения типа matlab.lang.OnOffSwitchState.

MATLAB устанавливает BeingDeleted свойство для 'on' когда DeleteFcn обратный вызов начинает выполнение. BeingDeleted свойство остается установленным в значение 'on' до тех пор, пока объект-компонент больше не будет существовать.

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

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

развернуть все

`Parent` - Родительский
`Axes` объект | `Group` объект | `Transform` объект

Родитель, указан как Axes, Group, или Transform объект.

`Children` - Дети
пустой `GraphicsPlaceholder` множество

Объект не имеет дочерних элементов. Невозможно задать это свойство.

`HandleVisibility` - Видимость ручки объекта
`'on'` (по умолчанию) | `'off'` | `'callback'`

Видимость дескриптора объекта в Children свойство родительского объекта, указанное как одно из следующих значений:

'on' - Дескриптор объекта всегда виден.
'off' - Дескриптор объекта всегда невидим. Этот параметр полезен для предотвращения непреднамеренных изменений другой функцией. Установите HandleVisibility кому 'off' для временного скрытия дескриптора во время выполнения этой функции.
'callback' - Дескриптор объекта виден из обратных вызовов или функций, вызываемых обратными вызовами, но не из функций, вызываемых из командной строки. Этот параметр блокирует доступ к объекту в командной строке, но разрешает доступ к нему функциям обратного вызова.

Если объект не указан в списке Children свойства родительского объекта, то функции, которые получают дескрипторы объектов путем поиска в иерархии объектов или запроса свойств дескрипторов, не могут вернуть его. Примеры таких функций включают get, findobj, gca, gcf, gco, newplot, cla, clf, и close функции.

Дескрипторы скрытых объектов по-прежнему действительны. Установка корня ShowHiddenHandles свойство для 'on' перечисление всех дескрипторов объектов независимо от их HandleVisibility параметр свойства.

Идентификаторы

развернуть все

`Type` - Тип графического объекта
`'light'`

Это свойство доступно только для чтения.

Тип графического объекта, возвращаемого как 'light'. Это свойство используется для поиска всех объектов данного типа в иерархии печати, например, для поиска типа с помощью findobj.

`Tag` - Идентификатор объекта
`''` (по умолчанию) | символьный вектор | строковый скаляр

Идентификатор объекта, заданный как вектор символа или скаляр строки. Можно указать уникальный Tag для использования в качестве идентификатора объекта. При необходимости доступа к объекту в другом месте кода можно использовать findobj для поиска объекта на основе Tag значение.

`UserData` - Данные пользователя
`[]` (по умолчанию) | массив

Пользовательские данные, указанные как любой массив MATLAB. Например, можно указать скаляр, вектор, матрицу, массив ячеек, символьный массив, таблицу или структуру. Это свойство используется для хранения произвольных данных объекта.

Если вы работаете в App Designer, создайте открытые или частные свойства в приложении для совместного использования данных вместо использования UserData собственность. Дополнительные сведения см. в разделе Общий доступ к данным в приложениях App Designer.