loadImage()　画像を読み込む

　PImage型として画像を読み込みます。4種類のフォーマットに対応しており、その拡張子は、.gif、.jpg、.tga、.pngのいずれかです。画像ファイルはスケッチのdataディレクトリに保存されている必要があります。通常、この関数はsetup()内で実行します。draw()内で使うと、実行スピードが遅くなるので注意してください。

【構文】
loadImage(filename)
loadImage(filename, extension)

【パラメータ】
filename 読み込むファイルの名前もしくはURL (String)
extension 画像フォーマットを表す拡張子。png、gif、jpgなど

【戻り値】
PImageまたはnull

　ファイル名の代わりにURLを指定してオンラインのファイルを読み込むことができます。セキュリティー上の制約により、ダウンロードしたスケッチは、そのスケッチが置かれていたサーバからしかファイルを取得することができません。この制約を回避するには、サインされたアプレット(signed applet)が必要です。
　正しい拡張子を持たないファイルを読み込むために、拡張子を第2パラメータとして指定することができます。
　画像の読み込みが正しく行われなかったとき、loadImage()はnullを返し、コンソールにエラーメッセージが表示されます。このエラーメッセージはプログラムを止めませんが、エラー処理を行わずにプログラムを続行するとNullPointerExceptionが発生するかもしれません。

---

[目次へ戻る]