uiimage
イメージ コンポーネントの作成
説明
im = uiimage は、イメージ コンポーネントを新しい Figure 内に作成し、Image オブジェクトを返します。MATLAB® は関数 uifigure を呼び出して新しい Figure を作成します。uiimage は、アプリに画像、アイコン、ロゴを表示する場合に使用します。
im = uiimage(___, は、1 つ以上の Name,Value)Name,Value の引数を使用して、Image のプロパティを指定します。このオプションは、前述の構文のすべての入力引数の組み合わせで使用できます。
例
Figure 内にイメージ コンポーネントを作成します。既定のイメージが表示されます。
fig = uifigure; im = uiimage(fig);
次に、イメージ コンポーネントにイメージを追加します。
im.ImageSource = "peppers.png";
イメージを作成し、そのイメージがクリックされたときに新しいブラウザー タブで開く URL を指定します。イメージにカーソルを合わせたときに表示されるツールヒントを指定します。
fig = uifigure; im = uiimage(fig); im.ImageSource = "ngc6543a.jpg"; im.URL = "https://www.mathworks.com/"; im.Tooltip = "Go to www.mathworks.com";
R2022b より前: URL プロパティの代わりに ImageClickedFcn プロパティを使用し、関数ハンドルを使用してコールバックを作成します。
im.ImageClickedFcn = @(src,event)web("https://www.mathworks.com/");イメージの実際のサイズを使用してアニメーション GIF を表示するイメージ コンポーネントを作成します。
fig = uifigure; im = uiimage(fig,"ImageSource","questions.gif"); im.ScaleMethod = "none";
次に、イメージが既定のコンポーネント エリアに収まるように、縦横比は維持してクリッピングなしでスケーリングします。その後、黒の背景を適用してレターボックス (イメージの上下の黒いバー) の外観を作成します。
im.ScaleMethod = "scaledown"; im.BackgroundColor = "black";
道路のイメージを表示するイメージ コンポーネントを作成します。AltText プロパティを使用して代替テキストを指定し、イメージの説明を提供します。スクリーン リーダーは、このテキストを使用してイメージについて説明します。
fig = uifigure; im = uiimage(fig,ImageSource="street1.jpg", ... AltText="City street including cars, signs, and buildings");
入力引数
名前と値の引数
オプションの引数のペアを Name1=Value1,...,NameN=ValueN として指定します。ここで、Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後に指定しなければなりませんが、ペアの順序は重要ではありません。
例: im = uiimage(ScaleMethod="none")
メモ
ここには一部のプロパティのみを示します。完全な一覧については、Image を参照してください。
イメージのソースまたはファイル。ファイル パスまたは m×n×3 のトゥルーカラー イメージ配列として指定します。サポートされているイメージ形式には、JPEG、PNG、GIF、SVG または m×n×3 のトゥルーカラー イメージ配列が含まれます。
トゥルーカラー イメージ配列の詳細については、MATLAB でのイメージ タイプの処理を参照してください。
例: im = uiimage(ImageSource="peppers.png");
例: im.ImageSource = "C:\TEMP\ngc6543a.jpg";
イメージのスケーリング方法。次の表にリストされた値のいずれかとして指定します。この名前と値のペアの引数を使用して、イメージをコンポーネント エリア内にどのようにレンダリングするかを指定します。
次の表では、イメージ例を使用した各スケール方法も示します。レンダリング後のイメージ例では、イメージ コンポーネントの BackgroundColor プロパティは 'magenta' に設定されています。SVG イメージ ファイルのスケーリング動作は、ファイルの定義方法によって異なる場合があります。
| 値 | 説明 | 例 | スケール アップ | スケール ダウン | 縦横比の維持 | クリップ イメージ | |
|---|---|---|---|---|---|---|---|
| 元のイメージ | レンダリング後のイメージ | ||||||
'fit' | 任意の方向にスケーリングしてイメージをコンポーネント エリア内に表示し、クリッピングせずに縦横比を維持します。 |
|
| あり | あり | あり | なし |
'fill' | 任意の方向にスケーリングしてコンポーネント エリアを埋めて、縦横比を維持し、必要に応じてクリッピングします。 |
|
| あり | あり | あり | あり |
'none' | イメージの実際のサイズを使用し、縦横比を維持します。コンポーネント エリアがイメージより小さい場合、イメージはクリップされます。 |
|
| なし | なし | あり | あり |
'scaledown' | スケール ダウンし、クリッピングせずに縦横比を維持します。 元のイメージがコンポーネント エリアより大きい場合、イメージはスケール ダウンされ、 |
|
| なし | あり | あり | なし |
'scaleup' | スケール アップし、クリッピングにより縦横比を維持します。 元のイメージがコンポーネント エリアより小さい場合、イメージはスケール アップされ、 |
|
| あり | なし | あり | あり |
'stretch' | 任意の方向にスケーリングし、縦横比を維持せず、クリッピングせずにコンポーネント エリアを埋めます。 |
|
| あり | あり | なし | なし |
イメージのハイパーリンクの URL。文字ベクトルまたは string スカラーとして指定します。ユーザーがイメージをクリックすると、URL で指定された Web アドレスが新しいブラウザー タブで開きます。ユーザーがアプリを、MATLAB Online™ を使用してブラウザーで実行しているか Web アプリとして実行している場合、新しいタブは現在のブラウザーで開きます。それ以外の場合、新しいタブはユーザーのシステムにおける既定のブラウザーで開きます。
イメージ クリック時のコールバック。次の値のいずれかとして指定します。
関数ハンドル。
最初の要素が関数ハンドルである cell 配列。cell 配列内のその後の要素はコールバック関数に渡される引数です。
有効な MATLAB 式を含む文字ベクトル (非推奨)。MATLAB は、この式をベース ワークスペースで評価します。
このコールバックは、ユーザーがアプリでイメージをクリックしたときに実行されます。URL プロパティを使用して開くリンクを指定した場合、コールバックはリンクが開いた後に実行されます。
このコールバック関数は、ユーザーのイメージ操作に関する特定の情報にアクセスできます。MATLAB は、この情報を ImageClickedData オブジェクトに格納して、2 番目の引数としてコールバック関数に渡します。App Designer では、引数は event と呼ばれます。ドット表記を使用して、オブジェクトのプロパティをクエリできます。たとえば、event.Source は、ユーザーの操作に応じてコールバックをトリガーする Image オブジェクトを返します。ImageClickedData オブジェクトは、文字ベクトルとして指定されているコールバック関数では使用できません。
次の表に、ImageClickedData オブジェクトのプロパティを示します。
| プロパティ | 値 |
|---|---|
EventName | 'ImageClicked' |
Source | コールバックを実行するコンポーネント |
コールバックの記述の詳細については、App Designer のコールバックを参照してください。
親を基準にしたイメージ コンポーネントの位置とサイズ。[left bottom width height] の形式の 4 要素ベクトルとして指定します。次の表で、ベクトルの各要素について説明します。
| 要素 | 説明 |
|---|---|
left | 親コンテナーの内側左端からイメージ コンポーネントの外側左端までの距離 |
bottom | 親コンテナーの内側下端からイメージ コンポーネントの外側下端までの距離 |
width | イメージ コンポーネントの外側の左右の端の間の距離 |
height | イメージ コンポーネントの外側の上下の端の間の距離 |
Position の値の基準は、親コンテナーの "描画可能領域" です。描画可能領域は、コンテナーの境界線の内側にある領域で、メニュー バーやタイトルなどの装飾が占める領域は含まれません。
すべての測定単位はピクセルです。
ヒント
イメージの解析と処理については、グラフィックス関数の
imageとimshowを参照してください。これらの関数は、イメージの解像度や内挿を制御するなど、イメージ表示のための追加オプションを提供します。アプリの実行中にイメージの内容を更新する必要がある場合、ファイル名ではなく、トゥルーカラー イメージ配列として
ImageSourceプロパティを指定します。イメージ配列を使用する場合、ファイル名は同じままでも、内容が変更されるたびにイメージ表示が更新されます。たとえば、myimage.pngファイルの内容が変更されたときに、アプリ内のイメージを更新するには次のコードを使用します。imarray = imread("myimage.png"); im.ImageSource = imarray;
