MATLAB Function Reference

light

建立一光源物件

Syntax

light('PropertyName',PropertyValue,...)
handle = light(...)

Description

light 在現行軸建立一光源物件。光源僅影響斑駁和表面物件。

light('PropertyName',PropertyValue,...) 使用對名稱屬性定義的值建立一光源物件。MATLAB 將光源放置現行軸除非您使用 Parent 屬性定義另外的軸線。

handle = light(...) 回傳所建立光源物件的握把。

Remarks

您看不見光源物件 per se，但可以看見在班駁和表面物件上光源的效果。也可定義軸範圍的漫射光線色彩其照射物件。然而，漫射光線僅當至少有一個光源物件出現並在軸上可看見時才看得見。

您可以名稱／屬性值，結構陣列，和異質陣列來定義屬性（參考範例中的 set 和 get 如何定義資料型態）。

也可參考 patch 和 surface 的 AmbientStrength, DiffuseStrength, SpecularStrength, SpecularExponent, SpecularColorReflectance, 及 VertexNormals 屬性。也可參考 lighting 和 material 指令。

Examples

照射 peaks 表面使用一放置於無限遠的光源且沿著方向 [1 0 0]，即 x 軸。

h = surf(peaks);
set(h,'FaceLighting','phong','FaceColor','interp',...
      'AmbientStrength',0.5)
light('Position',[1 0 0],'Style','infinite');

Object Hierarchy

Setting Default Properties

您可對軸、圖表及根層級設定預設的光源屬性：

set(0,'DefaultLightProperty',PropertyValue...)
set(gcf,'DefaultLightProperty',PropertyValue...)
set(gca,'DefaultLightProperty',PropertyValue...)

其中 Property 為光線屬性的名稱，而 PropertyValue 則是所定義的值。使用 set 和 get 來存取光線的屬性。

下表列出所有的光線屬性並且對每一項提供簡單的敘述。屬性名稱連結提供屬性擴充的敘述。

屬性名稱	屬性敘述	屬性值
定儀光線
Color	由光線物件產生光線的色彩	值：ColorSpec
Position	軸上光線的位置	值：x-, y-, z-座標軸的單位 預設值：[1 0 1]
Style	平行或發散的光源	值：infinite, local
控制其顯露
SelectionHighlight	此屬性並不被光線物件所使用	值：on, off 預設值：on
Visible	使光線的效果可見或不可見	值：on, off 預設值：on
控制對物件的存取
HandleVisibility	決定是否以及何時線條的握把可被其他的函式看見	值：on, callback, off 預設值：on
HitTest	此屬性不被光線物件所使用	值：on, off 預設值：on
關於光線的一般資訊
Children	光線物件沒有子產物	值：[] （空矩陣）
Parent	光線物件的起源為一 axes 物件	值：軸握把
Selected	此屬性不被光線物件所使用	值：on, off 預設值：on
Tag	使用者定義的標誌	值：任何字串 預設值：'' （空字串）
Type	圖像物件的型態（唯讀）	值：字串 'light'
UserData	使用者定義的資料	值：任何矩陣 預設值：[] （空矩陣）
關於反呼叫程序計算的屬性
BusyAction	定義如何處理反呼叫程序的中止	值：cancel, queue 預設值：queue
ButtonDownFcn	此屬性並不被光線物件所使用	值：字串 預設值：空字串
CreateFcn	定義一反呼叫程序其計算何時光線將被建立	值：字串（指令或 M-檔案的名稱） 預設值：空字串
DeleteFcn	定義一反呼叫程序，當光線被刪除時可執行計算（經由 close 或 delete）	值：字串（指令或 M-檔案的名稱） 預設值：空字串
Interruptible	決定反呼叫程序是否可被中斷	值：on, off 預設值：on（可被中斷）
UIContextMenu	此屬性並不被光線物件所使用	值：Uicontrextmenu 的握把

license

Light Properties