MATLAB Function Reference

caxis

色軸範圍

Syntax

caxis([cmin cmax])
caxis auto
caxis manual
caxis(caxis)
v = caxis

Description

caxis控制對應到顏色對應表的值，它影響indexed CData和CDataMapping設定為scaled的曲面、貼片、和影像，它不影響true color CData和CDataMapping設定為direct的曲面、貼片、或影像。

caxis([cmin cmax]) 設定色彩界線來指定最大值和最小值，資料的值比cmin小或比cmax大的個別對應到cmin和 cmax，而值介於cmin和cmax之間的線性對應到目前的色彩對應表。

caxis auto 使MATLAB自動地使用最小值和最大值來計算色彩界線，這是MATLAB預設的行為，色彩值設定為Inf時對應到最大色彩，而設定成-Inf時對應到最小色彩，曲面或邊的色彩值設定成NaN時不會被畫出。

caxis manual和caxis(caxis) 在目前的界線凍結色軸範圍，而當hold是on時，使之後的圖也能夠使相同的界限。

v = caxis 傳回包含目前在使用的[cmin cmax]之二元素列向量。

Remarks

caxis改變軸圖形物件CLim和CLimMode的性質

How Color Axis Scaling Works

曲面，貼片和影像的圖形物件有indexed CData和CDataMapping設定成scaled，對應CData的值每次繪製時影像的顏色對照表中的顏色，CData的值相等或小於min值時對應到顏色對照表的第一個色彩值，當CData的值相等或大於cmax的值時對應到顏色對照表的最後一個色彩值，MATLAB在中間值(被稱為Cbelow)執行隨著而來的線性轉換，將她們對應到顏色對照表的入口(其中顏色對照表的長度為m，而列索引被稱為indexbelow)。

index = fix((C-cmin)/(cmax-cmin)*m)+1

Examples

產生一個球體的資料(X,Y,Z)，且將資料視為曲面

[X,Y,Z] = sphere;
C = Z;
surf(X,Y,Z,C)

C值的範圍為[-1 1]，C值靠近-1時被分派到顏色對照表的最低值，C值靠近1時被指派到顏色對照表的最高值

將曲面一半的頂端對應到顏色表的最高值，使用

caxis([-1 0])

只使用顏色表一半的底端，輸入

caxis([-1 3])

將CData值的最低值對應到顏色對照表的頂端，將最高值對應到顏色對照表的中間值(靠指定一個cmax值，其值等於cmax值再加上CData範圍的兩倍)。

指令為

caxis auto

將軸的範圍重設為auto-ranging則可在曲面上看到所有顏色，在本例中，輸入

caxis

傳回

[-1 1]

當用scaled color data使用影像時，改變色軸是有用的，例如，為Cape Cod，Massachusetts下載影像資料和顏色對照表

load cape

這指令下載影像資料X和影像的顏色對照表map到工作集裡，並將CDataMapping設定為scaled且設置影像顏色對照表，並將影像顯示出來

image(X,'CDataMapping','scaled')
colormap(map)

MATLAB設定顏色的界限來擴展影像資料的範圍，範圍為1到192︰

caxis
ans =
     1   192

海洋蘭為顏色對照表中的第一個顏色，且對應到最低值(1)，可藉著改變較低的顏色界限值來有效地移動sealeve，例如︰

See Also

axes, axis, colormap, get, mesh, pcolor, set, surf

The CLim and CLimMode properties of axes graphics objects.

The Colormap property of figure graphics objects.

Axes Color Limits

catch

cd