Light 属性

光源的外观和行为

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

以下是 MATLAB^® 在许多类型的绘图中使用的默认颜色的 RGB 三元组和十六进制颜色代码。

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]` 形式的三元素向量

光源位置，指定为 [x y z] 形式的三元素向量。以数据单位定义从坐标区原点到 (x, y, z) 坐标的向量元素。光源的实际位置取决于 Style 属性的值。

示例： [-40 -4 140]

`Visible` — 光源的光可见性
`'on'` （默认） | on/off 逻辑值

光源的光可见性，指定为 'on' 或 'off'，或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 'on' 等效于 true，'off' 等效于 false。因此，您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

回调

全部展开

`CreateFcn` — 创建函数
`''` （默认） | 函数句柄 | 元胞数组 | 字符向量

对象创建函数，指定为下列值之一：

函数句柄。
第一个元素是函数句柄的元胞数组。元胞数组中的后续元素是传递到回调函数的参数。
包含有效 MATLAB 表达式的字符向量（不推荐）。MATLAB 在基础工作区计算此表达式。

有关将回调指定为函数句柄、元胞数组或字符向量的详细信息，请参阅Create Callbacks for Graphics Objects。

此属性指定要在 MATLAB 创建对象时执行的回调函数。MATLAB 将在执行 CreateFcn 回调之前初始化所有属性值。如果不指定 CreateFcn 属性，则 MATLAB 执行默认的创建函数。

对现有组件设置 CreateFcn 属性没有任何作用。

如果将此属性指定为函数句柄或元胞数组，则可以使用回调函数的第一个参数访问正在创建的对象。否则，使用 gcbo 函数访问该对象。

`DeleteFcn` — 删除函数
`''` （默认） | 函数句柄 | 元胞数组 | 字符向量

对象删除函数，指定为下列值之一：

函数句柄。
第一个元素是函数句柄的元胞数组。元胞数组中的后续元素是传递到回调函数的参数。
包含有效 MATLAB 表达式的字符向量（不推荐）。MATLAB 在基础工作区计算此表达式。

有关将回调指定为函数句柄、元胞数组或字符向量的详细信息，请参阅Create Callbacks for Graphics Objects。

此属性指定在 MATLAB 删除对象时要执行的回调函数。MATLAB 在销毁对象的属性之前执行 DeleteFcn 回调。如果不指定 DeleteFcn 属性，则 MATLAB 执行默认的删除函数。

如果将此属性指定为函数句柄或元胞数组，则可以使用回调函数的第一个参数访问要删除的对象。否则，使用 gcbo 函数访问该对象。

回调执行控件

全部展开

`BeingDeleted` — 删除状态
on/off 逻辑值

此属性为只读。

删除状态，以 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值形式返回。

当 DeleteFcn 回调开始执行时，MATLAB 会将 BeingDeleted 属性设置为 'on'。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 设计工具中工作，请在该 App 中创建公共或私有属性以共享数据，而不是使用 UserData 属性。有关详细信息，请参阅在用 App 设计工具创建的 App 内共享数据。

未使用的属性

全部展开

`ButtonDownFcn` — （未使用）鼠标点击回调
`''` （默认） | 函数句柄 | 元胞数组 | 字符向量

Light 对象不使用该属性。

`ContextMenu` — （未使用）上下文菜单
`ContextMenu` 对象

Light 对象不使用该属性。

`Selected` — （未使用）选择状态
`'off'` （默认） | on/off 逻辑值

Light 对象不使用该属性。

`SelectionHighlight` — （未使用）选定时显示所选对象句柄
`'on'` （默认） | on/off 逻辑值

Light 对象不使用该属性。

`PickableParts` — （未使用）捕获鼠标点击的能力
`'visible'` （默认） | `'none'`

Light 对象不使用该属性。

`HitTest` — （未使用）响应捕获的鼠标点击
`'on'` （默认） | on/off 逻辑值

光源对象不使用该属性。

`Interruptible` — （未使用）回调中断
`'on'` （默认） | on/off 逻辑值

Light 对象不使用该属性。

`BusyAction` — （未使用）回调排队
`'queue'` （默认） | `'cancel'`

Light 对象不使用该属性。

版本历史记录

在 R2006a 之前推出

另请参阅

light

Light 属性

颜色和样式

Color — 光的颜色 [1 1 1] （默认） | RGB 三元组 | 十六进制颜色代码 | 'r' | 'g' | 'b' | ...

Style — 光源类型 'infinite' （默认） | 'local'

Position — 光源位置 [1 0 1] （默认） | [x y z] 形式的三元素向量

位置

Position — 光源位置 [1 0 1] （默认） | [x y z] 形式的三元素向量

Visible — 光源的光可见性 'on' （默认） | on/off 逻辑值

回调

CreateFcn — 创建函数 '' （默认） | 函数句柄 | 元胞数组 | 字符向量

DeleteFcn — 删除函数 '' （默认） | 函数句柄 | 元胞数组 | 字符向量

回调执行控件

BeingDeleted — 删除状态 on/off 逻辑值

父级/子级

Parent — 父级 Axes 对象 | Group 对象 | Transform 对象

Children — 子级 空 GraphicsPlaceholder 数组

HandleVisibility — 对象句柄的可见性 'on' （默认） | 'off' | 'callback'

标识符

Type — 图形对象的类型 'light'

Tag — 对象标识符 '' （默认） | 字符向量 | 字符串标量

UserData — 用户数据 [] （默认） | 数组

未使用的属性

ButtonDownFcn — （未使用）鼠标点击回调 '' （默认） | 函数句柄 | 元胞数组 | 字符向量

ContextMenu — （未使用）上下文菜单 ContextMenu 对象

Selected — （未使用）选择状态 'off' （默认） | on/off 逻辑值

SelectionHighlight — （未使用）选定时显示所选对象句柄 'on' （默认） | on/off 逻辑值

PickableParts — （未使用）捕获鼠标点击的能力 'visible' （默认） | 'none'

HitTest — （未使用）响应捕获的鼠标点击 'on' （默认） | on/off 逻辑值

Interruptible — （未使用）回调中断 'on' （默认） | on/off 逻辑值

BusyAction — （未使用）回调排队 'queue' （默认） | 'cancel'

版本历史记录

另请参阅

主题

WeChat

`Color` — 光的颜色
`[1 1 1]` （默认） | RGB 三元组 | 十六进制颜色代码 | `'r'` | `'g'` | `'b'` | ...

`Style` — 光源类型
`'infinite'` （默认） | `'local'`

`Position` — 光源位置
`[1 0 1]` （默认） | `[x y z]` 形式的三元素向量

`Position` — 光源位置
`[1 0 1]` （默认） | `[x y z]` 形式的三元素向量

`Visible` — 光源的光可见性
`'on'` （默认） | on/off 逻辑值

`CreateFcn` — 创建函数
`''` （默认） | 函数句柄 | 元胞数组 | 字符向量

`DeleteFcn` — 删除函数
`''` （默认） | 函数句柄 | 元胞数组 | 字符向量

`BeingDeleted` — 删除状态
on/off 逻辑值

`Parent` — 父级
`Axes` 对象 | `Group` 对象 | `Transform` 对象

`Children` — 子级
空 `GraphicsPlaceholder` 数组

`HandleVisibility` — 对象句柄的可见性
`'on'` （默认） | `'off'` | `'callback'`

`Type` — 图形对象的类型
`'light'`

`Tag` — 对象标识符
`''` （默认） | 字符向量 | 字符串标量

`UserData` — 用户数据
`[]` （默认） | 数组

`ButtonDownFcn` — （未使用）鼠标点击回调
`''` （默认） | 函数句柄 | 元胞数组 | 字符向量

`ContextMenu` — （未使用）上下文菜单
`ContextMenu` 对象

`Selected` — （未使用）选择状态
`'off'` （默认） | on/off 逻辑值

`SelectionHighlight` — （未使用）选定时显示所选对象句柄
`'on'` （默认） | on/off 逻辑值

`PickableParts` — （未使用）捕获鼠标点击的能力
`'visible'` （默认） | `'none'`

`HitTest` — （未使用）响应捕获的鼠标点击
`'on'` （默认） | on/off 逻辑值

`Interruptible` — （未使用）回调中断
`'on'` （默认） | on/off 逻辑值

`BusyAction` — （未使用）回调排队
`'queue'` （默认） | `'cancel'`