alpha
座標軸内のオブジェクトに透明度を追加
説明
alpha
は、現在の座標軸内にある、透明度をサポートするオブジェクトに面の透明度を設定します。value
value
を 'clear'
、'opaque'
、または [0, 1] の範囲の数値として指定します。0
の値を指定すると、オブジェクトが透明になり、1
の値では、オブジェクトが完全に不透明になります。
alpha
は、座標軸内にあるすべての image、patch、surface および scatter オブジェクトの透明度を変更します。このオプションは、オブジェクトの対応するアルファ データ プロパティを設定します。alphadata
alpha
は、座標軸内の patch、surface、および scatter オブジェクトの面の透明度を制御します。このオプションでは、patch オブジェクトと surface オブジェクトの facealpha
FaceAlpha
を設定します。scatter オブジェクトの場合は、MarkerFaceAlpha
プロパティと MarkerEdgeAlpha
プロパティが設定されます。
alpha
は、座標軸内にあるすべての image、patch、surface および scatter オブジェクトのアルファ データ値の解釈を制御します。このオプションでは、オブジェクトの alphadatamapping
AlphaDataMapping
プロパティを設定します。
例
座標軸内のすべてのグラフィックス オブジェクトの透明度を設定
棒グラフと散布図を作成します。bar series と scatter series の両方のオブジェクトについて、面の透明度を 0.5
に設定します。
bar(1:10) hold on scatter(10*rand(10,1),10*rand(10,1),'filled','SizeData',200) hold off alpha(.5)
特定のグラフィックス オブジェクトの透明度を設定
棒グラフと散布図を作成します。bar series オブジェクトには影響を与えずに、scatter series オブジェクトの透明度を 0.5
に設定します。
b = bar(1:10); hold on s = scatter(10*rand(10,1),10*rand(10,1),'filled','SizeData',200); hold off alpha(s,.5)
z 値を使用して表面の透明度を設定
alphamap へのアルファ データのマッピングを設定
イメージを作成します。色の値に基づいて、イメージ全体で透明度を変化させます。既定では、イメージは 0 ~ 1 の透明度の値に固定されます。0 未満の値は完全な透明、1 より大きい値は完全な不透明になります。その代わりに、alpha scaled
コマンドを使用して alphamap の範囲に合わせて透明度の値を変換します。
imagesc(peaks) alpha color alpha scaled
入力引数
value
— 面の透明度の値
[0, 1] の範囲の数値 | 'clear'
| 'opaque'
面の透明度の値。次の値のいずれかとして指定します。
[0, 1] の範囲の数値 — 面の透明度を指定された値に設定します。値 0 は透明を表します。値 1 は不透明を表します。0 と 1 の間の値は一部透明です。
'clear'
— 面の透明度を 0 (透明) に設定します。'opaque'
— 面の透明度を 1 (不透明) に設定します。
オブジェクトに面がない場合、あるいは面に色がない場合、関数 alpha
はオブジェクトに視覚効果を与えません。たとえば、塗りつぶされていないマーカーや面のないマーカー ('*'
、'+'
、'.'
、'x'
) を使用する scatter オブジェクトには、alpha
は視覚効果を与えません。
次の表に、透明度をサポートするグラフィックス オブジェクトと、それに関連付けられた、指定値へと更新される面の透明度プロパティを示します。
グラフィックス オブジェクト | 面の透明度プロパティ |
---|---|
area オブジェクト | FaceAlpha |
bar オブジェクト | FaceAlpha |
scatter オブジェクト | MarkerFaceAlpha , MarkerEdgeAlpha |
histogram および histogram2 オブジェクト | FaceAlpha |
image オブジェクト | AlphaData |
chart および primitive surface オブジェクト | FaceAlpha |
patch オブジェクト | FaceAlpha |
alphadata
— オブジェクト全体にわたって透明度を変化させるオプション
'x'
| 'y'
| 'z'
| 'color'
| 'rand'
| ベクトルまたは行列
オブジェクト全体にわたって透明度を変化させるオプション。次の表のいずれかの値として指定します。表の列は、座標軸に含まれるオブジェクトに応じて、各オプションがそれぞれの型のオブジェクトに与える効果を示しています。
オプション | surface オブジェクト | scatter オブジェクト | patch オブジェクト | image オブジェクト |
---|---|---|---|---|
'x' | AlphaData プロパティを XData プロパティと同じに設定し、FaceAlpha プロパティを 'flat' に設定します。 | AlphaData プロパティを XData プロパティと同じに設定し、MarkerFaceAlpha プロパティと MarkerEdgeAlpha プロパティを 'flat' に設定します。 | FaceVertexAlphaData プロパティを XData プロパティと同じに設定し、FaceAlpha プロパティを 'flat' に設定します。 | 効果なし。 |
'y' | AlphaData プロパティを YData プロパティと同じに設定し、FaceAlpha プロパティを 'flat' に設定します。 | AlphaData プロパティを YData プロパティと同じに設定し、MarkerFaceAlpha プロパティと MarkerEdgeAlpha プロパティを 'flat' に設定します。 | FaceVertexAlphaData プロパティを YData プロパティと同じに設定し、FaceAlpha プロパティを 'flat' に設定します。 | 効果なし。 |
'z' | AlphaData プロパティを ZData プロパティと同じに設定し、FaceAlpha プロパティを 'flat' に設定します。 | AlphaData プロパティを ZData プロパティと同じに設定し、MarkerFaceAlpha プロパティと MarkerEdgeAlpha プロパティを 'flat' に設定します。 | FaceVertexAlphaData プロパティを ZData プロパティと同じに設定し、FaceAlpha プロパティを 'flat' に設定します。 | 効果なし。 |
'color' | AlphaData プロパティを CData プロパティと同じに設定し、FaceAlpha プロパティを 'flat' に設定します。 | AlphaData プロパティを CData プロパティと同じに設定し、MarkerFaceAlpha プロパティと MarkerEdgeAlpha プロパティを 'flat' に設定します。 | FaceVertexAlphaData プロパティを FaceVertexCData プロパティと同じに設定し、FaceAlpha プロパティを 'flat' に設定します。 | AlphaData データ プロパティを CData プロパティと同じに設定します。 |
'rand' | AlphaData プロパティを ZData プロパティと同じサイズの乱数行列に設定し、FaceAlpha プロパティを 'flat' に設定します。 | AlphaData プロパティを XData プロパティと同じサイズの乱数行列に設定し、MarkerFaceAlpha プロパティと MarkerEdgeAlpha プロパティを 'flat' に設定します。 | FaceVertexAlphaData プロパティを ZData プロパティと同じサイズの乱数行列に設定し、FaceAlpha プロパティを 'flat' に設定します。 | AlphaData データ プロパティを CData プロパティと同じサイズの乱数行列に設定します。 |
ベクトルまたは行列 A = [.1 .2; .3 .4] alpha(A) | A を surface の CData プロパティと同じサイズの行列として指定します。関数 alpha は AlphaData プロパティを A に設定し、FaceAlpha プロパティを 'flat' に設定します。 | A を scatter オブジェクトの XData プロパティと同じサイズのベクトルとして設定します。関数 alpha は AlphaData プロパティを A に設定し、MarkerFaceAlpha プロパティと MarkerEdgeAlpha プロパティを 'flat' に設定します。 | A を patch の FaceVertexCData プロパティと同じサイズの行列として指定します。関数 alpha は FaceVertexAlphaData プロパティを A に設定し、FaceAlpha プロパティを 'flat' に設定します。 | A を image の CData プロパティと同じサイズの行列として指定します。関数 alpha は、AlphaData データ プロパティを A に設定します。 |
facealpha
— フラットな面または内挿された面の透明度のオプション
'flat'
| 'interp'
| 'texture'
フラットな面または内挿された面の透明度のオプション。次の表のいずれかの値として指定します。表の列は、座標軸に含まれるオブジェクトに応じて、各オプションがそれぞれの型のオブジェクトに与える効果を示しています。
オプション | surface オブジェクト | scatter オブジェクト | patch オブジェクト |
---|---|---|---|
'flat' | FaceAlpha プロパティを 'flat' に設定します。AlphaData プロパティは、CData プロパティと同じサイズの配列でなければなりません。FaceColor プロパティは、'flat' に設定しなければなりません。 | MarkerFaceAlpha プロパティと MarkerEdgeAlpha プロパティを 'flat' に設定します。AlphaData プロパティは、XData プロパティと同じサイズのベクトルでなければなりません。MarkerFaceColor プロパティは、'flat' に設定しなければなりません。 | FaceAlpha プロパティを 'flat' に設定します。FaceVertexAlphaData プロパティは、Faces プロパティの面の数と等しい長さの列ベクトルでなければなりません。 |
'interp' | FaceAlpha プロパティを 'interp' に設定します。AlphaData プロパティは、CData プロパティと同じサイズの配列でなければなりません。FaceColor プロパティは、'interp' に設定しなければなりません。 | 効果なし。 | FaceAlpha プロパティを 'interp' に設定します。FaceVertexAlphaData プロパティは、Vertices プロパティの頂点の数と等しい長さの列ベクトルでなければなりません。 |
'texture' | FaceAlpha プロパティを 'texturemap' に設定します。FaceColor プロパティは、'texturemap' に設定しなければなりません。 | 効果なし。 | 効果なし。 |
alphadatamapping
— アルファ データ値の解釈
'none'
| 'direct'
| 'scaled'
アルファ データ値の解釈。'none'
、'direct'
または 'scaled'
として指定します。このオプションでは、座標軸内にある image、patch、surface、および scatter オブジェクトの AlphaDataMapping
プロパティを設定します。
'none'
— アルファ データ値を透明度の値として解釈します。0 以下の値は完全な透明を表します。1 以上の値は不透明を表します。0 と 1 の間の値は半透明です。'direct'
— Figure の alphamap のインデックスとして値を解釈します。小数部のある値は最も近い小さい方の整数に固定されます。Figure のAlphamap
プロパティには alphamap が含まれています。'scaled'
— 座標軸のALim
プロパティで指定されている Figure の alphamap 部分の範囲に合わせて、アルファ データの値を変換します。データ値をアルファ値に線形マッピングします。
obj
— 透明度をサポートするグラフィックス オブジェクト
スカラー | ベクトル
透明度をサポートするグラフィックス オブジェクト。スカラーまたはベクトルとして指定します。alpha
がどのオブジェクトを対象にするかを制御する場合、このオプションを使用します。それ以外の場合、alpha
は座標軸内で透明度をサポートするすべてのオブジェクトを対象にします。
次のオブジェクトのタイプを 1 つ以上指定します。
area オブジェクト
bar series オブジェクト
scatter series オブジェクト
histogram または histogram2 オブジェクト
image オブジェクト
patch オブジェクト
chart または primitive surface オブジェクト
メモ
一部のオブジェクトは、alphadata
、facealpha
および alphadatamapping
の入力引数をサポートしません。各オプションがサポートするオブジェクトのリストは、構文の説明を参照してください。
ax
— axes オブジェクト
axes オブジェクト
axes オブジェクト。座標軸を指定しない場合は、alpha
が現在の座標軸のグラフィックス オブジェクトの透明度を設定します。
バージョン履歴
R2006a より前に導入R2020b: 引数 alphadata
、facealpha
、または alphadatamapping
を指定する場合の scatter オブジェクトの変更
R2020b 以降、変更する座標軸内の特定のオブジェクトを指定せずに、引数 alphadata
、facealpha
、または alphadatamapping
をもつ関数 alpha
を呼び出すと、座標軸内の Scatter
オブジェクトが影響を受けるようになりました。
R2020a 以前のリリースでは、引数 alphadata
、facealpha
、および alphadatamapping
は、座標軸内の Scatter
オブジェクトに影響を与えません。
たとえば、次のコードでは、表面プロットと散布図を作成し、その後に関数 alpha
を呼び出して、x 次元に沿って透明度を変化させます。R2020a では、関数 alpha
を呼び出すと、表面プロットのみが変化します。R2020b では、両方のプロットが影響を受けます。
[X,Y] = meshgrid(-10:10); Z = ones(21,21) * -2; surf(X,Y,Z) hold on scatter([-8 2 4 -5 5 3],[7 4 2 -1 -7 0],200,'filled') alpha('x')
Scatter
オブジェクトが変化しないようにするには、変更するオブジェクトを、関数 alpha
の最初の引数として指定します。たとえば、上記のコードを更新するには、出力引数 s
を指定して関数 surf
を呼び出します。次に、s
を関数 alpha
に渡して、Surface
オブジェクトのみを変更します。
[X,Y] = meshgrid(-10:10); Z = ones(21,21) * -2; s = surf(X,Y,Z) hold on scatter([-8 2 4 -5 5 3],[7 4 2 -1 -7 0],200,'filled') alpha(s,'x')
MATLAB コマンド
次の MATLAB コマンドに対応するリンクがクリックされました。
コマンドを MATLAB コマンド ウィンドウに入力して実行してください。Web ブラウザーは MATLAB コマンドをサポートしていません。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)