３３
 イメージ 



既に、一般ウィジェット、ダイアログ、テキストウィジェットなどにイメージを表示する方法を簡単に解説しました（この先の章ではキャンバスでもイメージを扱います）。
このセクションでは、それらに共通するイメージデータの生成方法や、イメージの加工、イメージをファイルに出力する方法など、付加的な機能を解説します。
注
イメージを扱うプログラムは起動後の最初にイメージを表示する際、少し待たされます。(一般的なマシンで2秒〜数秒といったところでPCの性能も関係します) ただ、一度でもイメージ表示がおこなわれると次回からは待ちは無くなります。（OS再起動後はまた待ちが生じます）。
恐れ入りますがこの時間待ちはバグではなく、GUIエンジンの特性によるものとしてご承知をお願いします。（将来のGUIエンジンの版によって解消される可能性もありますが現在はまだ未定です）

　
　
イメージデータの生成
　
　

　本マニュアルでは「イメージ」という表現をGUIライブラリ内に格納されているイメージデータという意味で使うことがあります。たとえば「イメージが返されます」というような言い方をします。

■イメージをロード
　イメージデータを内部生成する手段として多く使われるのが、イメージファイルからのロードです。以下のような文法になります。

構文＝ 
＜ファイル名＞で　イメージをロード　→　イメージＩＤ
       プログラム例：
　　　　　　　　イメージ１は　ＩＤ

　　　　"image\MindIcon.png"を　イメージをロードし　イメージ１に 入れ
　指定したイメージファイルを読み込みライブラリ内に格納します。整数のＩＤが返されます。以後のイメージ操作はすべてこのＩＤを使って行います。ＩＤという用語を使いますがウィジェットＩＤではなく、ライブラリ内に存在するイメージデータを指し示すためのＩＤです。
　イメージＩＤを格納する変数はウィジェットＩＤと同様に 「○○は　ＩＤ」 によって宣言してください。
　ビットマップデータのファイルを指定することもできます。元がビットマップであってもＩＤ化した段階で他の形式のイメージと区別はつかなくなります。（ただし「info」など標準ビットマップは別扱いです）


　
　
イメージを扱う解説の一覧
　
　

　イメージを扱うことのできるウィジェットとしては、ボタンやラベルなどの一般ウィジェットのほか、ダイアログ、テキストウィジェット、キャンバスなどがあります。
　いままでのイメージ関連の解説を以下にまとめておきます。
ラベルなどの一般ウィジェット中へのイメージ表示
　　　「ウィジェットの属性指定」−「属性の設定」−
　　　　　　　　「イメージの埋め込み」
　　　　　　　　「イメージ埋め込みの位置揃え」
　　　　　　　　「ビットマップの埋め込み」
テキストウィジェットへのイメージ表示
　　　「テキストウィジェット」−「プログラムによる編集機能」−
　　　　　　　　「イメージの表示」
キャンバスウィジェットへのイメージ表示
　　　「キャンバス」−「イメージの描画」−
　　　　　　　　「図形としてイメージを描く」
　　　　　　　　「図形としてビットマップを描く」
　上記で共通して重要なものが、少し前で解説した「イメージをロード」です。これだけはどのような場面であっても必要となります。


　
　
多くのイメージを表示するサンプル
　
　

　簡単なものとしてはサンプルプログラム "image-photo.exe" があります。
　samplew\image\ 配下にある "music.jpeg" という画像をロードし、テキストボックス内に表示します。
　多くの画像を表示するものとして、サンプルプログラム "image-photo-all.exe" があります。
　このプログラムは samplew\image\ 配下にある多くのイメージファイル（.png、 .jpeg、 .ico、 .bmp など複数種別）をロードし、テキストボックス内に表示します。


　
　
イメージの加工
　
　

■イメージの拡大

構文＝ 
＜旧イメージＩＤ＞を　＜倍数＞で　イメージを拡大
　　　　　　　　　　　　　　　　　　　　　　→　新イメージＩＤ
　指定したイメージを指定した倍数で拡大し、新しいイメージＩＤとして返します。旧イメージは影響を受けません。拡大率は整数倍のみが利用できます。
　実際の動きとしてはサンプル "image-expand.exe" をご覧ください。

■イメージの縮小

構文＝ 
＜旧イメージＩＤ＞を　＜倍数＞で　イメージを縮小
　　　　　　　　　　　　　　　　　　　　　　→　新イメージＩＤ
　指定したイメージを指定した倍数で縮小し、新しいイメージＩＤとして返します。旧イメージは影響を受けません。
　整数分の１にすることのみとなります。たとえば２を指定すると ２分の１に、 ３を指定すると３分の１になります。
　実際の動きとしてはサンプル "image-expand.exe" をご覧ください。


　
　
イメージの出力
　
　

　どのようなウィジェットであっても（テキストウィジェット、キャンバスウィジェット、ウィンドウといった大掛かりなものも）、
　　　　”ウィジェットがウィンドウ内に表示されている状態のイメージデータ”
を取得することができます。もちろんウィンドウ自体もです。デスクトップにおけるスクリーンショットのようなものです。
　この ”スクリーンショットのようなもの” は、メモリ上のデータとしてまずは保持されます。ファイルへの出力が必要な場合はそのための処理単語を別に実行することで行うことができます。

■ウィジェットのイメージを取得

構文＝ 
＜ウィジェットＩＤ＞の　ウィジェットのイメージを取得　→　イメージＩＤ
       プログラム例１：
　　　　　　　　ラベル１は　　　　ＩＤ
　　　　　　　　ラベルイメージは　ＩＤ

　　　　ラベル１の　ウィジェットのイメージを取得し　ラベルイメージに　入れ
       プログラム例２：
　　　　　　　　ウィンドウのイメージは　ＩＤ

　　　　メインウィンドウの　ウィジェットのイメージを取得し
　　　　　　　　　　　　　　　　　　　ウィンドウのイメージに　入れ
　指定したウィジェットのイメージを取得し、それを指すイメージＩＤを返します。見た目の変化はありませんが内部データとして記憶されています。
記：ウィジェットのイメージは個々のウィジェットの囲み線などが省かれ中身だけとなるため、画面で見るウィジットに比べると質素な感じがしますが、そのような仕様であるとご承知ください。（ウィンドウのイメージではタイトルバーも省かれます）

■イメージをファイルに出力

構文＝ 
＜イメージＩＤ＞を
　　＜フォーマット＞と　＜ファイル名＞で　イメージをファイルに出力　→　・

　　　　　　フォーマットとして以下のいずれかの文字列を与える
　　　　　　　　　　　　"gif"
　　　　　　　　　　　　"jpeg"
　　　　　　　　　　　　"png"
　　　　　　　　　　　　"bmp"
       プログラム例：
　　　　　　　　ラベルイメージは　ＩＤ

　　　　ラベル１の　ウィジェットのイメージを取得し　ラベルイメージに　入れ

　　　　ラベルイメージを
　　　　　　　　"png"と　"c:\temp\image-of-label.png"で
　　　　　　　　　　　　　　　　　イメージをファイルに出力する
　イメージＩＤで指定したイメージをファイルに出力します。
　出力する際のフォーマットを指定できます。
注
指定したファイル名の有意性検査はMindレベルでおこなっていますがその後のファイルアクセスに伴うエラー発生はMind側からは関与できないため、誤ったファイル名を与えたり、既存ファイルへの出力、出力先のフォルダがReadOnlyなどの場合、GUIエンジン（Tcl/Tk）レベルでエラーが発生することかありますが、そのような仕様であるとご承知ください。
注
GUIエンジンの特性上、ファイル名に空白を含んだり、ファイル名やディレクトリ名に日本語が使われていると誤動作することがあります。
　サンプルプログラム "image-get-widgetimages.exe" を実行してみてください。
　ボタンを押すと、このプログラム自身のラベル、ボタン、ウィンドウの３つについてイメージを取得し、"c:\temp" ディレクトリに次の３つのファイルを生成します。
　　　　　　image-of-label.png
　　　　　　image-of-button.png
　　　　　　image-of-window.png
注： "image-get-widgetimages.exe" を起動する前に、 "c:\temp" というディレクトリを（もし無ければ）作成しておいてください。

■イメージのフォーマット変換への応用
　「イメージをロード」と「イメージをファイルに出力」をコンビネーションで使うことで、ウィンドウへのイメージの描画とは関係なく、アプリケーシプログラムとしてイメージファイルを別のフォーマットに変換するプログラムを作ることができます。
　たとえば、.pngのファイルを読み込み、.jpegのファイルとして出力すれば、png→jpegのフォーマット変換をおこなったことになります。
注： 透明色の扱いが無いなど、細かなところでは専用の変換ツールのようにいかないものがあるかも知れませんがご了承ください。