MATLAB Function Reference

Image Properties

この節は、プロパティ名とそれに設定可能なプロパティ値をリストします。

透明度データ。 イメージデータの中の各要素の透明度を設定するNaNでない値を要素とする行列。AlphaDataは、クラス double、または、uint8のどちらかです。

MATLAB は、つぎの3つの方法で、透明度を決定します。

• AlphaDataの要素を透明度として使用(AlphaDataMappingを、デフォルトで、noneに設定します)。
• AlphaDataの要素をカレントalphamapの中のインデックスとして使用します (AlphaDataMapping をdirectに設定します)。
• AlphaDataの要素をスケーリングして、軸ALimプロパティの最小値と最大値の間に入れます(AlphaDataMapping をscaledに設定します)。

透明度のマッピング手法。 このプロパティは、MATLABがインデックス付きalphaデータをどのように解釈するかを決定します。つぎのいずれかに従います。

• none - AlphaDataの透明度値は、0と1の間の値か、または、この範囲の端の値になります(デフォルト)。
• scaled - AlphaDataを、ALimプロパティで示されるalphamap全体をカバーするように変換し、データ値をalpha値に線形にマッピングします。
• direct - AlphaDataを、alphamapの中に直接インデックスとして使用します。スケーリングしない場合、データは、1からlength(alphamap)までの範囲で、整数単位で変化します。MATLABは、 1より小さいものを、alphamapの最初の値、 length(alphamap)より大きい値をalphamapの最後のalpha値にします。小数部はｍ最近傍の小さい整数に丸めます。AlphaDataが、配列uint8整数の場合、インデックスは、0から始めます(すなわち、MATLAB は、0の値を、alphamapの最初のalpha値にマッピングします)。

コールバックルーチンの割込み。BusyActionプロパティを使って、実行中のコールバックルーチンに割込みを行うイベントの取り扱い方法を制御することができます。実行中のコールバックルーチンがあれば、続いて呼び込まれるコールバックルーチンは、常にそれを中断しようとします。コールバックを実行中のオブジェクトのInterruptibleプロパティがon(デフォルト)に設定されていれば、イベントキューが処理されるつぎの点で割込みが起こります。Interruptibleプロパティがoffならば、(実行中のコールバックをもつオブジェクトの)BusyActionプロパティは、MATLABがイベントを処理する方法を指定します。つぎのような選択があります。

• cancel - 2番目のコールバックルーチンを実行しようとしたイベントを破棄します。
• queue - 現在のコールバックが終了するまで、2番目のコールバックルーチンを実行しようとするイベントを待機させます。

ボタンを押したときのコールバックルーチン。 ポインタがImageオブジェクト上にあるときにマウスボタンを押すと、必ず実行されるコールバックルーチン。このルーチンには、正しいMATLAB表現、または、M-ファイル名を文字列で定義できます。式は、MATLABワークスペース内で実行します。

Imageデータ。Imageを定義している各長方形のカラーを指定する値からなる行列。image(C)は、Cの値をCDataに割り当てます。MATLABは、つぎの3つの方法の中からImageのカラーを決定します。

• カレントのカラーマップへのインデックスとして、CDataの要素を使います（デフォルト）。
• min(get(gca,'CLim'))とmax(get(gca,'CLim'))の値の間に、CDataの要素をスケーリングします(CDataMappingをscaledに設定します)。
• RGB値として直接 CDataの要素を解釈します（トゥルーカラーの仕様）。

C = rand(4,1);
image(C,'CDataMapping','scaled')
axis image

直接、または、スケールされたインデックス付きカラー。このプロパティは、MATLABがCData内の値をFigureのカラーマップへのインデックスとして解釈する(デフォルト)か、あるいは、AxesのCLimプロパティの値に従ってスケーリングするかを指定します。

空行列。Imageオブジェクトは子オブジェクトをもちません。

クリッピングモード。 デフォルトでは、MATLABは長方形のAxesにImageを貼り付けます。Clipping をoffに設定した場合、Imageは長方形のAxesの外側に表示することができます。たとえば、Imageを作り、 holdをonに設定し、軸のスケールを固定し(axis manual)、つぎにそれより大きいImageを作成すると、Axesの範囲を超えて描画します。

オブジェクトの作成中に実行されるコールバックルーチン。 このプロパティは、MATLABがImageオブジェクトを作成するときに実行するコールバックルーチンを定義します。このプロパティは、Imageに対するデフォルト値として定義しなければなりません。たとえば、つぎのステートメント

set(0,'DefaultImageCreateFcn','axis image')

Imageを削除するときのコールバックルーチン。 Imageオブジェクトが削除される (たとえば、 deleteコマンドを実行する、あるいはImageを含むAxes、または、Figureを消去する) ときに実行するコールバックルーチン。MATLABは、オブジェクトのプロパティを壊す前にこのルーチンを実行するので、これらのプロパティ値をコールバックルーチンで利用することができます。

消去モード。このプロパティは、Imageオブジェクトを描いたり、消去するMATLABの機能を制御するものです。消去モードは、連続的に動きを表現するアニメーションの作成に有効なものです。すなわち、アニメーションでは、パフォーマンスを改良したり、希望する効果を得るために、個々のオブジェクトを再描画する方法を制御する必要があります。

• normal (デフォルト) -- すべてのオブジェクトが正しく描画されることを保証するために必要な3次元解析を行い、表示範囲を再描画します。このモードは、最も正確に図を表示することができますが、非常に時間のかかるものです。他のモードは、かなり時間の短縮にはなりますが、完全な図を再表示することはできず、精度は悪くなります。
• none - Imageは移動したり、変更したりしても消去されません。 EraseMode noneを使って消去した後で、スクリーン上でオブジェクトが視覚可能であっても、MATLABは以前の位置に関する情報を格納しないので、印刷できません。
• xor - オブジェクトは、その下のスクリーンのカラーとの排他的論理和(XOR)により表示され、そして消去されます。このモードはImageの下のオブジェクトのカラーに影響を与えませんが、Imageのカラーは、その下のスクリーンのカラーに依存します。
• background - Axesの Colorがnoneに設定されている場合は、AxesのバックグランドのColorに描画するか、または、FigureのバックグランドのColorに描画することにより、消去します。これは、消去されたImageの下にあるオブジェクトに影響を与えますが、Imageは常に適切に色付けされています。
  非標準の消去モードを使って印刷を行う

コマンドラインユーザとGUIによるオブジェクトのハンドルへのアクセスの制御。このプロパティは、オブジェクトのハンドルが、その子オブジェクトの親のリスト内で視覚可能であるときを決定します。このプロパティは、(ダイアログボックスのような)ユーザインタフェースデバイスのみを含んでいるFigure内に、コマンドラインから誤って書き込むことや削除することを防ぐために有効です。

マウスクリックによる選択。HitTest は、Image上でのマウスクリックの結果、Imageがカレントのオブジェクト(gcoコマンドとFigureのCurrentObjectプロパティにより出力される)になり得るかどうかを指定します。HiTestがoffならば、Imageをクリックすると、その下のオブジェクト(このオブジェクトを含むAxesかもしれません)を選択します。

コールバックルーチンの中断モード。 Interruptible プロパティは、Imageのコールバックルーチンが、連続的に呼び込まれるコールバックルーチンによって、中断されるかどうかを制御します。ButtonDownFcnに対して定義されたコールバックルーチンのみが、Interruptibleプロパティにより影 響を受けます。MATLABは、ルーチン内でdrawnow, figure, getframe,pauseコマンドが実行されるときのみ、コールバックルーチンを中断できるイベントを確認します。

Imageの親オブジェクト。 Imageオブジェクトの親オブジェクトであるAxesのハンドル番号。このプロパティを新しいAxesのハンドル番号に変更することにより、Imageオブジェクトを別のAxesに移動できます。

オブジェクトの選択状態。このプロパティをonにし、SelectionHighlightプロパティもonならば、MATLABは選択状態を示すハンドルを表示します。たとえば、ButtonDownFcnで、このプロパティを設定するように定義すると、マウスを使ってオブジェクトを選択することができます。

選択時のオブジェクトの強調。 Selectedプロパティがonの場合、MATLAB は、4辺と4隅に選択状態を示すハンドルを描画します。SelectionHighlightがoffの場合、MATLABはハンドルを表示しません。

ユーザ指定のオブジェクトラベル。Tag プロパティは、ユーザ設定のラベルをもつグラフィックスオブジェクトを識別する方法を与えます。これは、オブジェクトのハンドル番号をグローバル変数として定義したり、コールバックルーチン間の引数としてそれらを受け渡したりする必要がある対話型のグラフィックプログラムを構築するときに、特に有効です。Tag は、任意の文字列で定義できます。

グラフィックスオブジェクトのタイプ。 このプロパティは、グラフィックスオブジェクトのクラスを識別する文字列を含みます。Imageオブジェクトに対しては、Type は、常に'image'です。

コンテキストメニューとImageの対応付け。このプロパティは、Imageと同様に同じFigure内で作成したUicontextmenuオブジェクトのハンドル番号を割り当てます。コンテキストメニューを作成するためには、関数 uicontextmenuを使用してください。MATLABは、Figure上で右マウスボタンをクリックしたときに、コンテキストメニューを表示します。

ユーザ指定データ。このプロパティは、Imageオブジェクトと関連付けたい任意のデータです。Imageは、このプロパティを使いませんが、関数set,getを使ってアクセスすることができます。

Imageの可視化。デフォルトでは、Imageオブジェクトは視覚可能です。このプロパティをoff に設定すると、Imageは表示されません。しかし、オブジェクトは存在するので、プロパティの参照や設定ができます。

x軸に沿ってのイメージの配置の制御。要素 CData(1,1)とCData(m,n)の中心位置を指定するベクトルです。ここで、CDataはm行n列です。要素CData(1,1)は、XData とYDataの1番目の要素によって定義された座標です。要素CData(m,n) は、XDataとYDataの最後の要素によって定義された座標です。CData の残りの要素の中心は、2点の間に等間隔で分布します。

(XData(2)-XData(1))/(size(CData,2)-1)

y軸に沿っての配置の制御。要素CData(1,1)とCData(m,n)の中心位置を指定するベクトルです。ここで、CDataはm行n列です。要素 CData(1,1)は、XDataと YDataの1番目の要素によって定義された座標です。要素CData(m,n) は、XDataとYDataの最後の要素によって定義された座標です。CDataの残りの要素の中心は、2点の間に等間隔で分布します。

(YData(2)-YData(1))/(size(CData,1)-1)

参考：

image

imagesc