MultiStateImage

入力値を反映するイメージを表示する

ライブラリ:
Simulink / Dashboard

説明

MultiStateImage ブロックは、入力信号の値を示すイメージを表示します。MultiStateImage ブロックをその他の Dashboard ブロックと共に使用し、モデル用にコントロールおよびインジケーターの対話型のダッシュボードを作成できます。シミュレーション中に必要な情報を提供する、入力値とイメージの組み合わせを指定できます。

Dashboard ブロックの接続

Dashboard ブロックはモデル要素への接続に端子を使用しません。Dashboard ブロックを接続するには、接続モードを使用します。接続されていないブロックで接続モードに切り替えるには、接続するブロックをポイントし、[接続] ボタンをクリックします。接続されているブロックで接続モードに切り替えるには、ブロックを選択すると表示される省略記号 (…) をポイントし、展開されるアクションメニューで [接続] ボタンをクリックします。

Display ブロックをモデル内の信号に接続したり Display ブロックの接続を変更したりするには、接続モードに切り替えます。接続する信号線を選択します。表示されるリストから、接続する信号を選択します。次に、Dashboard ブロックをポイントし、[接続完了] ボタンをクリックします。接続されたブロックの値を Dashboard ブロックに表示するには、シミュレーションを実行します。

Dashboard ブロックの接続の詳細については、Connect Dashboard Blocks to Simulink Modelを参照してください。

Dashboard ブロックは Stateflow^® チャートにも接続できます。詳細については、Dashboard ブロックと Stateflow との接続 (Stateflow)を参照してください。

次のアニメーションは、MultiStateImage ブロックをモデルに接続する方法を示しています。

An unconnected MultiStateImage block connects to the signal that a Pulse Generator block sends to a Display block.

例

すべて展開する

MultiStateImage ブロックを使用した信号値の表示

ライブスクリプトを開く

モデル MultiStateImagePulse には、Display ブロックに接続されている Pulse Generator ブロックが含まれています。Pulse Generator ブロックは、振幅 1 の矩形波パルスを 1 秒おきに生成します。MultiStateImage ブロックは pulseSig 信号に接続されています。このブロックは、信号の値が 1 の場合は上矢印のイメージを表示し、信号の値が 0 の場合は下矢印のイメージを表示するように構成されています。

The Block Parameters dialog box for the MultiStateImage

モデルのシミュレーションを実行します。シミュレーション中、MultiStateImage ブロックは、Pulse Generator ブロックがパルスを生成すると上矢印を表示し、パルスが発生していない場合は下矢印を表示します。

Animation of the MultiStateImagePulse model during simulation

拡張例

Circular Gauge ブロックを使用して現実的なダッシュボードを作成する

Custom Gauge ブロックと MultiStateImage ブロックを使用して、モデルに現実的なダッシュボードを作成する。

モデルを開く

制限

Dashboard Scope ブロックおよび Display ブロックを除き、Dashboard ブロックは実数のスカラー信号にのみ接続できます。
コメントアウトされたブロックには、ブロックダイアログの [接続] テーブルを使用して Dashboard ブロックを接続することはできません。コメント化されたブロックに接続モードを使用して Dashboard ブロックを接続した場合、ブロックのコメントを解除するまでは Dashboard ブロックに接続された値が表示されません。
Dashboard ブロックは参照モデル内のモデル要素には接続できません。
モデルの階層構造をシミュレーションすると、参照モデル内の Dashboard ブロックで更新は実行されません。
Dashboard ブロックは、ラピッドアクセラレータシミュレーションをサポートしていません。

シミュレーション中に Stateflow のチャートデータやステートアクティビティに Dashboard ブロックを接続することはできません。
プログラムで Stateflow のチャートデータやステートアクティビティに Dashboard ブロックを接続することはできません。
アクセラレータモードシミュレーションのためのブロックの削減または最適化により、一部の信号にはシミュレーションで使用できるデータが含まれないことがあります。Dashboard ブロックを使用してこのような信号を表示するには、信号をログ記録用にマークします。

パラメーター

すべて展開する

接続 — 接続して表示する信号
信号の接続オプション

Dashboard ブロックはモデル要素への接続に端子を使用しません。モデル内のパラメーター値に Dashboard ブロックを接続するには、接続モード、Simulink^® ツールストリップ、または [ブロックパラメーター] ダイアログボックスの [接続] テーブルを使用します。接続モードの詳細とツールストリップを使用した接続方法の詳細については、Connect Dashboard Blocks to Simulink Modelを参照してください。

[接続] テーブルを使用して Display ブロックを接続したり Display ブロックの接続を変更したりするには、次のようにします。

ブロックを選択します。
ブロックを接続するには、プロパティインスペクターの [パラメーター] タブで [接続] をクリックします。ブロックの接続を変更するには、代わりに [変更] をクリックします。
接続する信号線を選択します。
テーブルで接続する信号を選択します。
[適用] をクリックします。

Dashboard ブロックは Stateflow チャートにも接続できます。詳細については、Dashboard ブロックと Stateflow との接続 (Stateflow)を参照してください。

プログラムでの使用

ブロックパラメーター: Binding

型: Simulink.HMI.SignalSpecification

既定の設定: []

スケールモード — イメージのスケーリング方法を指定する
`Fill with fixed aspect ratio` (既定値) | `Fixed` | `Fill`

イメージのスケーリング方法を指定します。

[縦横比を固定して埋め込む] は、元の縦横比を保ちながら、ブロックのサイズに合わせてイメージをスケーリングします。

[固定] は、イメージを固定された真のサイズで表示します。

[埋め込み] は、イメージをブロックに合わせて埋め込みます。

プログラムでの使用

ブロックパラメーター: ScaleMode

型: string または文字ベクトル

値: 'Fill with fixed aspect ratio' | 'Fixed' | 'Fill'

既定の設定: 'Fill with fixed aspect ratio'

状態 — 値を表示するイメージに一致させる
スカラーおよびイメージ

状態は、表示するイメージを接続している変数またはパラメーターの値に一致させます。各状態は [状態] およびイメージから構成され、MultiStateImage ブロックの [状態] テーブルに [サムネイル] として表示されます。

状態 — MultiStateImage ブロックに対応するイメージを表示させる、接続している変数またはパラメーターの値。
サムネイル — 接続している変数またはパラメーターの値が対応する [状態] に一致する場合に表示されるイメージ。

[+] ボタンをクリックして、別の状態を追加します。

プログラムでの使用

MultiStateImage ブロックの State および Thumbnail パラメーターの値をプログラムで設定するには、States パラメーターを使用します。次のフィールドをもつ構造体の配列として、States パラメーターの値を指定します。

State — 状態値。
Size — イメージの幅と高さをこの順で含む 1 行 2 列のベクトル (ピクセル)。uint64 として指定します。
Image — Base64 エンコードされたイメージデータの文字配列。
Thumbnail — ブロックダイアログの [状態] テーブルに表示するサムネイルイメージの Base64 エンコードされたイメージデータの文字配列。

ブロックに指定する各状態の構造体を配列に含めます。この例では、変数 myBase64Image および myBase64Thumbnail には、ブロックイメージおよびサムネイルの Base64 イメージデータの文字ベクトルが含まれます。

state1.State = 1;
state1.Size = [uint64(400) uint64(400)];
state1.Image = myBase64Image;
state1.Thumbnail = myBase64Thumbnail;
state2.State = 2;
state2.Size = uint64(400) uint64(400)];
state1.Image = myBase64Image2;
state1.Thumbnail = myBase64Thumbnail2;
msiStates = [state1 state2];

ブロックパラメーター: States

型: 構造体配列

接続している信号の値が指定されたどの状態にも一致しない場合、ブロックには既定のイメージが表示されます。DefaultImage パラメーターを次のフィールドを含む構造体として指定します。

Size — イメージの幅と高さをこの順で含む 1 行 2 列のベクトル (ピクセル)。uint64 として指定します。
Image — Base64 エンコードされたイメージデータの文字配列。
Thumbnail — ブロックダイアログの [状態] テーブルに表示するサムネイルイメージの Base64 エンコードされたイメージデータの文字配列。

ブロックパラメーター: DefaultImage

タイプ: 構造体

ラベル — ブロックラベルの位置
`Top` (既定値) | `Bottom` | `Hide`

ブロックラベルの位置。ブロックがモデル内の要素に接続されている場合、ラベルは接続された要素の名前です。

プログラムでの使用

ブロックパラメーター: LabelPosition

型: 文字ベクトル

値: 'Top' | 'Bottom' | 'Hide'

既定の設定: 'Top'

ブロックの特性

データ型	`Boolean` \| `double` \| `enumerated` \| `fixed point` \| `half` \| `integer` \| `single`
直達	`いいえ`
多次元信号	`いいえ`
可変サイズの信号	`いいえ`
ゼロクロッシング検出	`いいえ`

拡張機能

C/C++ コード生成
Simulink® Coder™ を使用して C および C++ コードを生成します。

Dashboard ブロックはコード生成時に無視されます。

バージョン履歴

R2016b で導入

参考

Lamp

MultiStateImage

説明

Dashboard ブロックの接続

例

MultiStateImage ブロックを使用した信号値の表示

拡張例

Circular Gauge ブロックを使用して現実的なダッシュボードを作成する

制限

パラメーター

接続 — 接続して表示する信号 信号の接続オプション

プログラムでの使用

スケール モード — イメージのスケーリング方法を指定する Fill with fixed aspect ratio (既定値) | Fixed | Fill

プログラムでの使用

状態 — 値を表示するイメージに一致させる スカラーおよびイメージ

プログラムでの使用

ラベル — ブロック ラベルの位置 Top (既定値) | Bottom | Hide

プログラムでの使用

ブロックの特性

拡張機能

C/C++ コード生成 Simulink® Coder™ を使用して C および C++ コードを生成します。

バージョン履歴

参考

トピック

接続 — 接続して表示する信号
信号の接続オプション

スケールモード — イメージのスケーリング方法を指定する
`Fill with fixed aspect ratio` (既定値) | `Fixed` | `Fill`

状態 — 値を表示するイメージに一致させる
スカラーおよびイメージ

ラベル — ブロックラベルの位置
`Top` (既定値) | `Bottom` | `Hide`

C/C++ コード生成
Simulink® Coder™ を使用して C および C++ コードを生成します。