このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。
alpha
座標軸内のオブジェクトに透明度を追加
説明
alpha は、現在の座標軸内にある、透明度をサポートするオブジェクトに面の透明度を設定します。valuevalue を 'clear'、'opaque'、または [0, 1] の範囲の数値として指定します。0 の値を指定すると、オブジェクトが透明になり、1 の値では、オブジェクトが完全に不透明になります。
alpha は、座標軸内の patch、surface、および scatter オブジェクトの面の透明度を制御します。このオプションでは、patch オブジェクトと surface オブジェクトの facealphaFaceAlpha を設定します。scatter オブジェクトの場合は、MarkerFaceAlpha プロパティと MarkerEdgeAlpha プロパティが設定されます。
alpha は、座標軸内にあるすべての image、patch、surface および scatter オブジェクトのアルファ データ値の解釈を制御します。このオプションでは、オブジェクトの alphadatamappingAlphaDataMapping プロパティを設定します。
例
棒グラフと散布図を作成します。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 値に基づいて、表面全体で透明度を変化させます。
s = surf(peaks);
alpha(s,'z')
イメージを作成します。色の値に基づいて、イメージ全体で透明度を変化させます。既定では、イメージは 0 ～ 1 の透明度の値に固定されます。0 未満の値は完全な透明、1 より大きい値は完全な不透明になります。その代わりに、alpha scaled コマンドを使用して alphamap の範囲に合わせて透明度の値を変換します。
imagesc(peaks) alpha color alpha scaled
入力引数
バージョン履歴
R2006a より前に導入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')
