クラス Image

画像 [詳細]

すべてのメンバ一覧

Public メソッド
	Image (string filename)
	Imageのコンストラクタ(ファイル名から)
	Image (byte[] fileImage)
	Imageのコンストラクタ(ファイルイメージから)
	Image (ImageMode mode, ImageSize size, ImageColor color)
	Imageのコンストラクタ(画像のモードとサイズと色から)
	Image (ImageMode mode, ImageSize size, byte[] buffer)
	Imageのコンストラクタ(画像のモードとサイズとバッファから)
virtual Object	ShallowClone ()
	Imageオブジェクトのコピー
void	Dispose ()
	Image のアンマネージドリソースを解放する
void	Decode ()
	画像をデコードする
byte[]	ToBuffer ()
	画像のメモリイメージを取得する
void	ReadBuffer (byte[] buffer)
	与えられたバッファに画像のメモリイメージを読み出す
Image	Resize (ImageSize size)
	画像をスケールした新しいImageオブジェクトを作成する
Image	Crop (ImageRect rect)
	画像の一部を切り出した新しいImageオブジェクトを作成する
void	DrawImage (Image source, ImagePosition position)
	画像の中に別の画像を貼り付ける
void	DrawRectangle (ImageColor color, ImageRect rect)
	画像の中に単色で矩形を描画する
void	DrawText (string text, ImageColor color, Font font, ImagePosition position)
	画像の中にテキストを描画する (string全体)
void	DrawText (string text, int offset, int len, ImageColor color, Font font, ImagePosition position)
	画像の中にテキストを描画する (stringの一部)
void	Export (string albumname, string filename)
	画像を指定したファイル名で保存する
void	SaveAs (string path)
	画像を指定したファイルパスに保存する
Protected メソッド
	Image (Image image)
	Imageのコンストラクタ(別のImageオブジェクトからコピー)
プロパティ
ImageSize	Size [get]
	画像のサイズ
ImageSize	DecodeSize [set]
	画像のデコード時のサイズ

---

説明

画像

---

コンストラクタとデストラクタ

Image

(

string

filename

)

Imageのコンストラクタ(ファイル名から)

引数:

filename

画像のファイル名

画像ファイルからImageを生成した直後は、画像は実際にはデコードされていません。画像をデコードするには Decode() を呼ぶ必要があります。ただし画像がデコードされていない場合でも、Size などを取得することはできます。 現在対応している画像ファイルのフォーマットは、PNG形式/BMP形式/JPG形式/GIF形式です。

Image

(

byte[]

fileImage

)

Imageのコンストラクタ(ファイルイメージから)

引数:

fileImage

画像のファイルイメージ

画像ファイルからImageを生成した直後は、画像は実際にはデコードされていません。画像をデコードするには Decode() を呼ぶ必要があります。ただし画像がデコードされていない場合でも、Size などを取得することはできます。 現在対応している画像ファイルのフォーマットは、PNG形式/BMP形式/JPG形式/GIF形式です。

Image	(	ImageMode	mode,
		ImageSize	size,
		ImageColor	color
	)

Imageのコンストラクタ(画像のモードとサイズと色から)

引数:

mode	画像のモード
size	画像のサイズ
color	色

引数 size に与える幅と高さは、それぞれ 0～4096 の範囲に収まっている必要があります。

Image	(	ImageMode	mode,
		ImageSize	size,
		byte[]	buffer
	)

Imageのコンストラクタ(画像のモードとサイズとバッファから)

引数:

mode	画像のモード
size	画像のサイズ
buffer	色

引数 size に与える幅と高さは、それぞれ 0～4096 の範囲に収まっている必要があります。

Image

(

Image

image

)

[protected]

Imageのコンストラクタ(別のImageオブジェクトからコピー)

引数:

image

コピー元のImageオブジェクト

別のImageオブジェクトをコピーして、新しいImageオブジェクトを生成します。ただしImageの実体はコピーされず、1つのアンマネージドリソースが共有されます。Imageのアンマネージドリソースを解放するために、コピーされた全てのImageオブジェクトに関して、Dispose() を呼び出す必要があります。

---

メソッド

Image Crop

(

ImageRect

rect

)

画像の一部を切り出した新しいImageオブジェクトを作成する

引数:

rect

切り出す矩形の範囲

戻り値:

切りだされた画像

void DrawImage	(	Image	source,
		ImagePosition	position
	)

画像の中に別の画像を貼り付ける

引数:

source	貼り付ける画像
position	貼り付け位置の座標(左上)

void DrawRectangle	(	ImageColor	color,
		ImageRect	rect
	)

画像の中に単色で矩形を描画する

引数:

color	矩形の色
rect	矩形

void DrawText	(	string	text,
		ImageColor	color,
		Font	font,
		ImagePosition	position
	)

画像の中にテキストを描画する (string全体)

引数:

text	文字列
color	文字の色
font	フォント
position	画像の中の座標(文字列の左上)

DrawTextは、透明なImageにテキストを描画することを想定した動作になっています。RGB値は引数 color に与えた色で上書きし、Alpha値はブレンド処理されます。 不透明なImageに対してDrawTextを呼び出した場合は、期待した結果を得ることはできません。

void DrawText	(	string	text,
		int	offset,
		int	len,
		ImageColor	color,
		Font	font,
		ImagePosition	position
	)

画像の中にテキストを描画する (stringの一部)

引数:

text	文字列
offset	文字列の中の描画に使用する位置のオフセット
len	文字列の中の描画に使用する長さ
color	文字の色
font	フォント
position	画像の中の座標(文字列の左上)

DrawTextは、透明なImageにテキストを描画することを想定した動作になっています。RGB値は引数 color に与えた色で上書きし、Alpha値はブレンド処理されます。 不透明なImageに対してDrawTextを呼び出した場合は、期待した結果を得ることはできません。

void Export	(	string	albumname,
		string	filename
	)

画像を指定したファイル名で保存する

引数:

albumname	出力アルバム名
filename	出力ファイル名

引数は A-Za-z0-9!#$%&'()+,-.;=@[]^_`{} 以外の文字を使用することはできません。また64文字以上使用することはできません。 現在保存対象として有効な画像ファイルは、PNG形式(.png)/JPG形式(.jpg)/BMP形式(.bmp)です。引数 filename に保存したい画象フォーマットの拡張子を含めて指定する必要があります。 Windowsシミュレータ上で実行した場合、"My Pictures"フォルダー以下に保存されます。

void ReadBuffer

(

byte[]

buffer

)

与えられたバッファに画像のメモリイメージを読み出す

引数:

buffer

読み出し先のバッファ

Image Resize

(

ImageSize

size

)

画像をスケールした新しいImageオブジェクトを作成する

引数:

size	スケール後の画像のサイズ

戻り値:

スケールされた画像

void SaveAs

(

string

path

)

画像を指定したファイルパスに保存する

引数:

path

出力ファイルパス

引数は / および、A-Za-z0-9!#$%&'()+,-.;=@[]^_`{} 以外の文字を使用することはできません。 現在保存対象として有効な画像ファイルは、PNG形式(.png)/JPG形式(.jpg)/BMP形式(.bmp)です。引数 path に保存したい画象フォーマットの拡張子を含めて指定する必要があります。

virtual Object ShallowClone

(

)

[virtual]

Imageオブジェクトのコピー

別のImageオブジェクトをコピーして、新しいImageオブジェクトを生成します。ただしImageの実体はコピーされず、1つのアンマネージドリソースが共有されます。Imageのアンマネージドリソースを解放するために、コピーされた全てのImageオブジェクトに関して、Dispose() を呼び出す必要があります。

byte [] ToBuffer

(

)

画像のメモリイメージを取得する

戻り値:

画像のメモリイメージ

---

プロパティ

ImageSize DecodeSize [set]

画像のデコード時のサイズ

Decode()を呼び出す前にDecodeSizeを設定しておくことで、画像を拡大・縮小しながらデコードすることができます。