画像の操作は、画像を処理するアプリケーションにおいてごく一般的なタスクです。一般的なアクションとして、サイズ変更、拡大縮小、回転、クロッピング、横方向/縦方向へのフリップなどがあります。
画像に対してこうしたアクションを実行できるように、GeneXus では、Image データタイプに特定の関数が追加されています。

プロパティ

ImageWidth: Numeric

読み取り専用のプロパティです。画像の幅をピクセル単位で返します。

&width = &image.ImageWidth

 

ImageHeight: Numeric

読み取り専用のプロパティです。画像の高さをピクセル単位で返します。

&height = &image.ImageHeight

 

FileSize: Numeric

読み取り専用のプロパティです。画像のファイルサイズをバイト数で返します。

&fileSize = &image.FileSize

メソッド

以下のメソッドは元の画像に変更を加えるものではなく、常に修正が加わった新しい画像を返します。

Resize

元の画像のサイズを変更して新しい画像を返します。
パラメーター:

• Width: 数値 - 新しい画像の幅です。
• Height: 数値 - 新しい画像の高さです。
• KeepAspect: ブール値: True に設定すると、fill keeping aspect を使用して画像のサイズが変更されます。そうでない場合は、"fill" が使用されます。

&resizedImage = &image.Resize(100, 100, true)

Scale

指定したパーセント値で元の画像を拡大/縮小し、新しい画像を返します。
パラメーター:

• Percentage: 数値です。

&scaledImage = &image.Scale(80)

Rotate

指定した角度で元の画像を回転し、新しい画像を返します。有効な角度は 90、180、270 度です。それ以外の角度は無視されます。
パラメーター:

• Angle: 数値です。

&rotatedImage = &image.Rotate(90)

Crop

元の画像の一部をクロッピングして新しい画像を返します。新しい画像のサイズはパラメーターで指定した四角形になります。
パラメーター:

• Left: 数値 - クロッピングを開始する左の座標をピクセルで指定します。
• Top: 数値 - クロッピングを開始する上の座標をピクセルで指定します。
• Width: 数値 - 新しい画像の幅をピクセルで指定します。
• Height: 数値 - 新しい画像の高さをピクセルで指定します。

&croppedImage = &image.Crop(0, 0, 50, 50)

FlipHorizontally

元の画像を水平に回転させた新しい画像を返します。

&hFlippedImage = &image.FlipHorizontally()

FlipVertically

元の画像を垂直に回転させた新しい画像を返します。

&vFlippedImage = &image.FlipVertically()

RoundBorders

元の画像と同一ではあるもののエッジに丸みのある新しい画像を返します。
パラメーター:

• topLeftRadius: 数値 - 左上隅湾曲部の半径を定義するピクセル数。
• topRightRadius: 数値 - 右上隅湾曲部の半径を定義するピクセル数。
• bottomLeftRadius: 数値 - 左下隅湾曲部の半径を定義するピクセル数。 
• bottomRightRadius: 数値 - 右下隅湾曲部の半径を定義するピクセル数。

たとえば、RoundBorders を使用すると円形の画像を取得できます。これを行うには、正方形の画像 (幅と長さが同じ) を使って以下の設定を行います: 

&radius=&image.ImageWidth/2 
&image.RoundBorder(&radius, &radius, &radius, &radius)

使用可能バージョン 

RoundBorders メソッドは GeneXus 18 Upgrade 6 以降 .NET、.NET Framework、Java で利用可能です。

適用範囲

参考情報 

Image データタイプ