이 번역 페이지는 최신 내용을 담고 있지 않습니다. 최신 내용을 영문으로 보려면 여기를 클릭하십시오.

light

R2026a

light 객체 생성

구문

light

light(Name,Value)

light(ax,___)

lt = light(___)

설명

light는 현재 좌표축에 Light 객체를 만듭니다.

Light 객체 자체는 볼 수는 없지만, 조명이 포함된 좌표축에 있는 patch 객체와 surface 객체에 미치는 Light 객체의 영향을 볼 수 있습니다. surface, patch, surf, mesh, pcolor, fill, fill3 함수 등 여러 가지 함수가 patch 객체와 surface 객체를 생성합니다.

light(Name,Value)는 하나 이상의 이름-값 인수를 사용하여 조명 속성을 지정합니다. 예를 들어, light("Color","green")을 사용하여 조명 색을 녹색으로 지정할 수 있습니다. 속성 목록은 Light 속성 항목을 참조하십시오.

light(ax,___)는 현재 좌표축(gca) 대신 ax로 지정된 좌표축에 조명을 만듭니다. ax를 첫 번째 입력 인수로 지정한 후 위에 열거된 구문에서 임의의 입력 인수 조합을 인수로 지정합니다.

lt = light(___)는 Light 객체를 반환합니다. 조명 속성을 생성한 후에 수정하려면 lt를 사용하십시오. 속성 목록은 Light 속성 항목을 참조하십시오.

예제

광원 생성하기

구를 만들고 Light 객체를 사용하여 구에서 빛이 나게 합니다.

sphere
axis equal
light

로컬 광원 만들기

구를 만들고, x축과 y축의 음의 코너에서 구를 똑바로 향하는 로컬 광원으로 구에서 빛이 나게 합니다.

sphere
axis equal

light("Style","local","Position",[-10 -10 0]);

대상 좌표축 및 조명 사용자 지정하기

tiledlayout 함수와 nexttile 함수를 사용하여 플롯을 타일 형식 배열로 표시할 수 있습니다. tiledlayout 함수를 호출하여 1×2 타일 형식 차트 레이아웃을 만듭니다. nexttile 함수를 호출하여 axes 객체 ax1과 ax2를 만듭니다. 구를 만들고 sphere와 light에 대한 첫 번째 인수로 각 axes 객체를 지정하여 각 플롯에 해당 조명을 만듭니다.

왼쪽 좌표축에서 구를 만들고 Color 속성을 지정하여 빨간색 조명으로 구를 비춥니다. 오른쪽 좌표축에서 구를 만들고 녹색 조명으로 구를 비춥니다.

colormap([1 1 1])
tiledlayout(1,2)
 
% Left sphere
ax1 = nexttile;
sphere(ax1)
axis equal
lt1 = light(ax1);
lt1.Color = "r";
 
% Right sphere
ax2 = nexttile;
sphere(ax2)
axis equal
lt2 = light(ax2);
lt2.Color = "g";

입력 인수

ax — axes 객체

axes 객체

axes 객체입니다. axes 객체를 지정하지 않으면 light는 현재 좌표축에 Light 객체를 만듭니다.

이름-값 인수

선택적 인수 쌍을 Name1=Value1,...,NameN=ValueN으로 지정합니다. 여기서 Name은 인수 이름이고 Value는 대응값입니다. 이름-값 인수는 다른 인수 뒤에 와야 하지만, 인수 쌍의 순서는 상관없습니다.

예: light(Position=[-1 0 0],Style="local")

R2021a 이전 릴리스에서는 쉼표를 사용하여 각 이름과 값을 구분하고 Name을 따옴표로 묶으십시오.

예: light("Position",[-1 0 0],"Style","local")

Color — 조명 색

[1 1 1] (디폴트 값) | RGB 3색 | 16진수 색 코드 | 'r' | 'g' | 'b' | ...

조명 색으로, RGB 3색, 16진수 색 코드, 색 이름 또는 짧은 이름으로 지정됩니다. 디폴트 RGB 3색인 [1 1 1]은 흰색에 대응됩니다.

RGB 3색과 16진수 색 코드는 사용자 지정 색을 지정할 때 유용합니다.

• RGB 3색은 요소를 3개 가진 행 벡터로, 각 요소는 색을 구성하는 빨간색, 녹색, 파란색의 농도를 지정합니다. 농도의 범위는 [0,1]이어야 합니다(예: [0.4 0.6 0.7]).

• 16진수 색 코드는 문자형 벡터 또는 string형 스칼라로, 해시 기호(#)로 시작하고 그 뒤에 3자리 또는 6자리의 16진수 숫자(0에서 F 사이일 수 있음)가 옵니다. 이 값은 대/소문자를 구분하지 않습니다. 따라서 색 코드 "#FF8800", "#ff8800", "#F80" 및 "#f80"은 모두 동일합니다.

몇몇의 흔한 색은 이름으로 지정할 수도 있습니다. 다음 표에는 명명된 색 옵션과 그에 해당하는 RGB 3색 및 16진수 색 코드가 나와 있습니다.

색 이름	짧은 이름	RGB 3색	16진수 색 코드	모양
"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"

다음 표에는 라이트 테마와 다크 테마에서 플롯의 디폴트 색 팔레트가 나열되어 있습니다.

팔레트	팔레트 색
"gem" — 라이트 테마 디폴트 값 R2025a 이전: 대부분의 플롯은 기본적으로 이 색을 사용합니다.
"glow" — 다크 테마 디폴트 값

orderedcolors 함수와 rgb2hex 함수를 사용하여 이러한 팔레트의 RGB 3색과 16진수 색 코드를 가져올 수 있습니다. 예를 들어, "gem" 팔레트의 RGB 3색을 가져와서 16진수 색 코드로 변환해 보겠습니다.

RGB = orderedcolors("gem");
H = rgb2hex(RGB);

R2023b 이전: RGB = get(groot,"FactoryAxesColorOrder")를 사용하여 RGB 3색을 가져옵니다.

R2024a 이전: H = compose("#%02X%02X%02X",round(RGB*255))를 사용하여 16진수 색 코드를 가져옵니다.

예: 'green'

Style — 광원의 유형

"infinite" (디폴트 값) | "local"

광원의 유형으로, 다음 값 중 하나로 지정됩니다.

• "infinite" — 조명을 무한대에 배치합니다. Position 속성을 사용하여 조명이 평행 광선으로 비추는 방향을 지정합니다.

• "local" — 조명을 Position 속성으로 지정된 위치에 배치합니다. 조명이 해당 위치에서 모든 방향으로 비추는 점 광원입니다.

Position — 광원의 위치

[1 0 1] (디폴트 값) | [x y z] 형식의, 요소를 3개 가진 벡터

광원의 위치로, [x y z] 형식의, 요소를 3개 가진 벡터로 지정됩니다. 좌표축 원점에서 (x, y, z) 좌표까지의 벡터 요소를 데이터 단위로 정의합니다. 조명의 실제 위치는 Style 속성값에 따라 달라집니다.

예: [-40 -4 140]

버전 내역

R2006a 이전에 개발됨

참고 항목

lighting | material | patch | surface

도움말 항목

• 조명 개요