dextuploadjk.media
Class ImageTool

最小サポートバージョン

1.0.0

最小サポート環境

Java 17

説明

画像処理をサポートするクラスです。

DEXTUploadJK でアップロードされた画像ファイルや、特定の場所のイメージファイルを処理することができる簡単な機能を提供する。

メソッド

getInstance

指定されたパスまたはオブジェクトからImageToolオブジェクトをリターン静的メソッドである。

形式

public static ImageTool getInstance(String filePath)
public static ImageTool getInstance(File file)
public static ImageTool getInstance(BufferedImage image)
public static ImageTool getInstance(FileItem item)

パラメータ

名前	形式	説明
filePath	java.lang.String	イメージファイルのパス
file	java.io.File	イメージjava.io.Fileオブジェクト
image	java.awt.image.BufferedImage	イメージ java.awt.image.BufferedImage オブジェクト
item	dextuploadjk.FileItem	FileItem オブジェクト

リターン

ImageTool オブジェクト

使い方

// 基本形
ImageTool oimg = ImageTool.getInstance(item.getLastSavedFilePath());
// 2
ImageTool oimg = ImageTool.getInstance(new File(item.getLastSavedFilePath()));
// 3
ImageTool oimg = ImageTool.getInstance(buffedimg);
// 4
ImageTool oimg = ImageTool.getInstance(fileItem);

isImage

ファイルがイメージであるかどうかを返します。

形式

public static boolean isImage(String filePath)
public static boolean isImage(File file)
public static boolean isImage(FileItem item)

パラメータ

名前	形式	説明
filePath	java.lang.String	ターゲットファイルのパス
file	java.io.File	ターゲットjava.io.Fileオブジェクト
item	dextuploadjk.FileItem	FileItem オブジェクト

リターン

画像の場合はtrue、またはfalse

使い方

//基本形
boolean isCheck = ImageTool.isImage(item.getLastSavedFilePath());
// 2
boolean isCheck = ImageTool.isImage(new File(item.getLastSavedFilePath()));
// 3
boolean isCheck = ImageTool.isImage(fileItem);

getImage

java.awt.image.BufferedImageオブジェクトを返します。
形式
```
public BufferedImage getImage()
```
リターン

java.awt.image.BufferedImage オブジェクト

使い方

ImageTool oimg = ImageTool.getInstance(item);
BufferedImage img = oimg.getImage();

setImage

java.awt.image.BufferedImageオブジェクトを設定する。

形式

public void setImage(BufferedImage image)

パラメータ

名前	形式	説明
image	java.awt.image.BufferedImage	java.awt.image.BufferedImage オブジェクト

使い方

ImageTool oimg = ImageTool.getInstance(item);
oimg.setImage(buffedImage);

getImageFile

イメージ情報を読み込んだファイルの java.io.File オブジェクトを返します。
形式
```
public File getImageFile()
```
リターン

java.io.File

使い方

ImageTool oimg = ImageTool.getInstance(item);
oimg.getImageFile();

setImageFile

画像情報を読み込んだファイルにjava.io.Fileオブジェクトを設定します。

形式

public void setImageFile(File imageFile)

パラメータ

名前	形式	説明
imageFile	java.io.File	設定する画像ファイル

使い方

ImageTool oimg = ImageTool.getInstance(item);
oimg.setImageFile(imagefile);

getWidth

画像の水平サイズを返します。
形式
```
public int getWidth()
```
リターン

横サイズ(pixel)

使い方

ImageTool oimg = ImageTool.getInstance(item);
oimg.getWidth();

getHeight

画像の垂直方向のサイズをリターンします。
形式
```
public int getHeight()
```
リターン

縦サイズ(pixel)

使い方

ImageTool oimg = ImageTool.getInstance(item);
oimg.getHeight();

resize

サイズが変更された画像情報を持つImageToolオブジェクトを返します。

形式

public ImageTool resize(int width, int height, Object hint, boolean hightQuality)
public ImageTool resize(float widthRatio, float heightRatio, Object hint, boolean hightQuality)

パラメータ

名前	形式	説明
width	int	ターゲットイメージ横幅(pixel)
height	int	ターゲットイメージ縦サイズ(pixel)
hint	Object	新しいイメージを描画するときに使用補間。 java.awt.RenderingHints.VALUE_INTERPOLATION_BICUBIC java.awt.RenderingHints.VALUE_INTERPOLATION_BILINEAR java.awt.RenderingHints.VALUE_INTERPOLATION_NEAREST_NEIGHBOR のいずれかを選びます。
hightQuality	boolean	変換品質をアップしようとする場合true、なければfalse 品質をアップする場合は、変換速度が遅くなる。
widthRatio	float	対象画像横の比率(50%の場合0.5f)
heightRatio	float	対象画像のアスペクト比(50%の場合0.5f)

リターン

サイズが変更された画像情報を持つImageToolオブジェクト。
注意1)一般的に変更された画像は、元の画像のコピーである。
注意2)元の画像のサイズと同じである場合のコピーではなく、元の画像のオブジェクトをそのまま参照するImageToolオブジェクトがリターンになる。

使い方

ImageTool dimg = oimg.resize(64, 64, RenderingHints.VALUE_INTERPOLATION_BILINEAR, true);
// または
ImageTool dimg = oimg.resize(0.5f, 0.5f, RenderingHints.VALUE_INTERPOLATION_BILINEAR, true);

ソース (120x84)	フレーム (120x140)	結果 (120x140)

resizeUniform

サイズが変更された画像情報を持つImageToolオブジェクトを返します。

元の画像縦、横サイズの比率を維持し、対象画像縦、横サイズに合わせてサイズが変更される。

最終的に変換された画像は、対象画像のサイズよりも小さいことができる。

形式

public ImageTool resizeUniform(int width, int height, Object hint, boolean hightQuality)
public ImageTool resizeUniform(float widthRatio, float heightRatio, Object hint, boolean hightQuality)

パラメータ

名前	形式	説明
width	int	ターゲットイメージ横幅(pixel)
height	int	ターゲットイメージ縦サイズ(pixel)
hint	java.lang.Object	新しいイメージを描画するときに使用補間。 java.awt.RenderingHints.VALUE_INTERPOLATION_BICUBIC java.awt.RenderingHints.VALUE_INTERPOLATION_BILINEAR java.awt.RenderingHints.VALUE_INTERPOLATION_NEAREST_NEIGHBOR のいずれかを選択。
hightQuality	boolean	変換品質をアップしようとする場合true、なければfalse 品質をアップする場合は、変換速度が遅い。
widthRatio	float	対象画像横の比率(50%の場合0.5f)
heightRatio	float	対象画像のアスペクト比(50%の場合0.5f)

リターン

サイズが変更された画像情報を持つImageToolオブジェクト。
注意1)一般的に変更された画像は、元の画像のコピーである。
注意2)元の画像のサイズと同じである場合のコピーではなく、元の画像のオブジェクトをそのまま参照するImageToolオブジェクトがリターンになる。

使い方

ImageTool dimg = oimg.resizeUniform(300, 200, RenderingHints.VALUE_INTERPOLATION_BILINEAR, true);       
// または
ImageTool dimg = oimg.resizeUniform(0.5f, 0.5f, RenderingHints.VALUE_INTERPOLATION_BILINEAR, true);

ソース (120x84)	フレーム (120x140)	結果 (120x84)

ソース (68x44)	フレーム (120x140)	結果 (68x44)

resizeUniformToFit

サイズが変更された画像情報を持つImageToolオブジェクト。
注意1)一般的に変更された画像は、元の画像のコピーである。
注意2)元の画像のサイズと同じである場合のコピーではなく、元の画像のオブジェクトをそのまま参照するImageToolオブジェクトがリターンになる。

形式

public ImageTool resizeUniformToFit(int width, int height, ImageOption.Position position, Object hint, boolean hightQuality)
public ImageTool resizeUniformToFit(float widthRatio, float heightRatio, ImageOption.Position position, Object hint, boolean hightQuality) 
public ImageTool resizeUniformToFit(int width, int height, ImageOption.Position position, Color bgColor, Object hint, boolean hightQuality)
public ImageTool resizeUniformToFit(float widthRatio, float heightRatio, ImageOption.Position position, Color bgColor, Object hint, boolean hightQuality)

パラメータ

名前	形式	説明
width	int	ターゲットイメージ横幅 (pixel)
position	dextuploadjk.media.ImageOption.Position	対象画面の元の画像を配置する位置を示す ImageOption.Position 値
bgColor	java.awt.Color	比率が維持された元の画像がターゲットサイズに合うように調整すると、残った余白を埋める背景色を指定する。
hint	java.lang.Object	新しいイメージを描画するときに使用補間。 java.awt.RenderingHints.VALUE_INTERPOLATION_BICUBIC java.awt.RenderingHints.VALUE_INTERPOLATION_BILINEAR java.awt.RenderingHints.VALUE_INTERPOLATION_NEAREST_NEIGHBOR のいずれかを選択。
hightQuality	boolean	変換品質を上げたい場合はtrue、またはfalseを設定します。品質を上げると変換速度が遅い。
widthRatio	float	対象画像横の比率 (50%の場合0.5f)
heightRatio	float	対象画像のアスペクト比 (50%の場合0.5f)

リターン

サイズが変更された画像情報を持つImageToolオブジェクト。
注意1) 一般的に変更された画像は、元の画像のコピーである。
注意2) 元の画像のサイズと同じである場合のコピーではなく、元の画像のオブジェクトをそのまま参照するImageToolオブジェクトがリターンになる。

使い方

//1
ImageTool dimg = oimg.resizeUniformToFit(300, 200, ImageOption.Position.CenterMiddle, RenderingHints.VALUE_INTERPOLATION_BILINEAR, true);       
//2
ImageTool dimg = oimg.resizeUniformToFit(0.5f, 0.5f,ImageOption.Position.CenterMiddle, RenderingHints.VALUE_INTERPOLATION_BILINEAR, true);
//3
ImageTool dimg = oimg.resizeUniformToFit(300, 200, ImageOption.Position.CenterMiddle, Color.black, RenderingHints.VALUE_INTERPOLATION_BILINEAR, true);
//4
ImageTool dimg = oimg.resizeUniformToFit(0.5f, 0.5f,ImageOption.Position.CenterMiddle, Color.black, RenderingHints.VALUE_INTERPOLATION_BILINEAR, true);

ソース (120x84)	フレーム (120x140)	結果 (120x140)

ソース (68x44)	フレーム (120x140)	結果 (120x140)

resizeUniformToFill

サイズが変更された画像情報を持つImageToolオブジェクトを返します。
元の画像縦、横サイズの比率を維持し、対象画像縦、横サイズに合わせてサイズが変更される。
元の画像の大きさが対象よりも小さい場合、元の画像を拡大させる。

形式

public ImageTool resizeUniformToFill(int width, int height, ImageOption.Position position, Object hint, boolean hightQuality)
public ImageTool resizeUniformToFill(float widthRatio, float heightRatio, ImageOption.Position position, Object hint, boolean hightQuality)

パラメータ

名前	形式	説明
width	int	ターゲットイメージ横幅(pixel)
position	dextuploadjk.media.ImageOption.Position	対象画面の元の画像を配置する位置を示す ImageOption.Position値
hint	java.lang.Object	新しいイメージを描画するときに使用補間。 java.awt.RenderingHints.VALUE_INTERPOLATION_BICUBIC java.awt.RenderingHints.VALUE_INTERPOLATION_BILINEAR java.awt.RenderingHints.VALUE_INTERPOLATION_NEAREST_NEIGHBOR のいずれかを選択。
hightQuality	boolean	変換品質をアップしようとする場合true、なければfalse 品質をアップする場合は、変換速度が遅い。
widthRatio	float	対象画像横の比率 (50%の場合0.5f)
heightRatio	float	対象画像のアスペクト比 (50%の場合0.5f)

リターン

サイズが変更された画像情報を持つImageToolオブジェクト。
注意1) 一般的に変更された画像は、元の画像のコピーである。
注意2) 元の画像のサイズと同じである場合のコピーではなく、元の画像のオブジェクトをそのまま参照するImageToolオブジェクトがリターンになる。

使い方

ImageTool dimg = oimg.resizeUniformToFill(300, 200, ImageOption.Position.CenterMiddle, RenderingHints.VALUE_INTERPOLATION_BILINEAR, true);
// or
ImageTool dimg = oimg.resizeUniformToFill(0.5f, 0.5f,ImageOption.Position.CenterMiddle, RenderingHints.VALUE_INTERPOLATION_BILINEAR, true);

ソース (120x84)	フレーム (120x140)	結果 (120x140)

ソース (68x44)	フレーム (120x140)	結果 (120x140)

rotate

回転された画像情報を持つ dextuploadjk.ImageTool オブジェクトを返します。
注意) リターンされているオブジェクトは、元の画像から新たに作成されたものである。

形式

public ImageTool rotate(double degree, Color bgColor, Object hint)

パラメータ

名前	形式	説明
degree	double	回転角（度）です。
bgColor	java.awt.Color	余白を埋める背景色
hint	java.lang.Object	新しいイメージを描画するときに使用補間。 java.awt.RenderingHints.VALUE_INTERPOLATION_BICUBIC java.awt.RenderingHints.VALUE_INTERPOLATION_BILINEAR java.awt.RenderingHints.VALUE_INTERPOLATION_NEAREST_NEIGHBOR のいずれかを選択。

リターン

回転された画像情報を持つImageToolオブジェクト。
注意1) 一般的に変更された画像は、元の画像のコピーである。
注意2) 所定の位置の回転である場合、元の画像のオブジェクトをそのまま参照するImageToolオブジェクトがリターンになる。

使い方

ImageTool dimg = oimg.rotate(30, Color.red, RenderingHints.VALUE_INTERPOLATION_BILINEAR);

rotateAuto

画像に含まれている回転情報に基づいて画像が前方になるように自動的に回転させた画像情報を持つImageToolオブジェクトを返します。
画像の回転情報は、JPGファイルのExif Orientationタグを参照すること。
Exif情報に基づいて回転操作を行うので、getMetadataメソッドリターン値はnullであってはならず、リターンされたImageMetadata オブジェクトは、Orientation情報を持っていなければならない。

形式

public ImageTool rotateAuto(Object hint)

パラメータ

名前	形式	説明
hint	java.lang.Object	新しいイメージを描画するときに使用補間。 java.awt.RenderingHints.VALUE_INTERPOLATION_BICUBIC java.awt.RenderingHints.VALUE_INTERPOLATION_BILINEAR java.awt.RenderingHints.VALUE_INTERPOLATION_NEAREST_NEIGHBORのいずれかを選択。

リターン

回転された画像情報を持つImageToolオブジェクト。
注意1) 一般的に変更された画像は、元の画像のコピーである。
注意2) 所定の位置の回転である場合、元の画像のオブジェクトをそのまま参照するImageToolオブジェクトがリターンになる。
注意3) もしJPG形式ではないかOrientation Exifタグ情報がない場合は、自動回転処理をしていない。

使い方

ImageTool oimg = ImageTool.getInstance(item);                            				            
ImageTool dimg = oimg.rotateAuto(RenderingHints.VALUE_INTERPOLATION_BILINEAR);

rotate90CW

時計回りに90度回転された画像情報を持つImageToolオブジェクトを返します。

形式

public ImageTool rotate90CW(Object hint)

パラメータ

名前	形式	説明
hint	java.lang.Object	新しいイメージを描画するときに使用補間。 java.awt.RenderingHints.VALUE_INTERPOLATION_BICUBIC java.awt.RenderingHints.VALUE_INTERPOLATION_BILINEAR java.awt.RenderingHints.VALUE_INTERPOLATION_NEAREST_NEIGHBORのいずれかを選択。

リターン

回転された画像情報を持つImageToolオブジェクト
注意1) 一般的に変更された画像は、元の画像のコピーである。

使い方

ImageTool oimg = ImageTool.getInstance(item);                            				            
ImageTool dimg = oimg.rotate90CW(RenderingHints.VALUE_INTERPOLATION_BILINEAR);

rotate90CCW

反時計回りに90度回転された画像情報を持つImageToolオブジェクトを返します。

形式

public ImageTool rotate90CCW(Object hint)

パラメータ

名前	形式	説明
hint	java.lang.Object	新しいイメージを描画するときに使用補間。 java.awt.RenderingHints.VALUE_INTERPOLATION_BICUBIC java.awt.RenderingHints.VALUE_INTERPOLATION_BILINEAR java.awt.RenderingHints.VALUE_INTERPOLATION_NEAREST_NEIGHBORのいずれかを選択。

リターン

ImageTool object with rotated image information
注意1) 一般的に変更された画像は、元の画像のコピーである。

使い方

ImageTool oimg = ImageTool.getInstance(item);                            				            
ImageTool dimg = oimg.rotate90CCW(RenderingHints.VALUE_INTERPOLATION_BILINEAR);

rotate180CW

Returns an ImageTool object with image information rotated 180 degrees clockwise.

形式

public ImageTool rotate180CW(Object hint)

パラメータ

名前	形式	説明
hint	java.lang.Object	新しいイメージを描画するときに使用補間。 java.awt.RenderingHints.VALUE_INTERPOLATION_BICUBIC java.awt.RenderingHints.VALUE_INTERPOLATION_BILINEAR java.awt.RenderingHints.VALUE_INTERPOLATION_NEAREST_NEIGHBORのいずれかを選択。

リターン

ImageTool object with rotated image information
注意1) 一般的に変更された画像は、元の画像のコピーである。

使い方

ImageTool oimg = ImageTool.getInstance(item);                            				            
ImageTool dimg = oimg.rotate180CW(RenderingHints.VALUE_INTERPOLATION_BILINEAR);

rotate180CCW

反時計回りに180度回転された画像情報を持つImageToolオブジェクトを返します。

形式

public ImageTool rotate180CCW(Object hint)

パラメータ

名前	形式	説明
hint	java.lang.Object	新しいイメージを描画するときに使用補間。 java.awt.RenderingHints.VALUE_INTERPOLATION_BICUBIC java.awt.RenderingHints.VALUE_INTERPOLATION_BILINEAR java.awt.RenderingHints.VALUE_INTERPOLATION_NEAREST_NEIGHBORのいずれかを選択。

リターン

回転された画像情報を持つImageToolオブジェクト
注意1)一般的に変更された画像は、元の画像のコピーである。

使い方

ImageTool oimg = ImageTool.getInstance(item);                            				            
ImageTool dimg = oimg.rotate180CCW(RenderingHints.VALUE_INTERPOLATION_BILINEAR);

flip

X、Y軸を中心に回転された画像情報を持つImageToolオブジェクトを返します。

形式

public ImageTool flip(ImageOption.Axis axis, Object hint)

パラメータ

名前	形式	説明
axis	dextuploadjk.media.ImageOption.Axis	回転させる軸を示すdextuploadjk.media.ImageOption.Axis値
hint	java.lang.Object	新しいイメージを描画するときに使用補間。 java.awt.RenderingHints.VALUE_INTERPOLATION_BICUBIC java.awt.RenderingHints.VALUE_INTERPOLATION_BILINEAR java.awt.RenderingHints.VALUE_INTERPOLATION_NEAREST_NEIGHBORのいずれかを選択。

リターン

X、Y軸を中心に回転された画像情報を持つImageToolオブジェクト
注意1) 一般的に変更された画像は、元の画像のコピーである。
注意2) X軸に回転をした場合、上下反転画像になる。
注意3) Y軸に回転をした場合、左右が変わったイメージになる。

使い方

ImageTool oimg = ImageTool.getInstance(item);                            				            
ImageTool dimg = oimg.flip(ImageOption.Axis.X, RenderingHints.VALUE_INTERPOLATION_BILINEAR);

flipX

X軸を中心に回転した画像情報を持つImageToolオブジェクトを返します。
形式
```
public ImageTool flipX(Object hint) 
```

パラメータ

名前	形式	説明
hint	java.lang.Object	新しいイメージを描画するときに使用補間。 java.awt.RenderingHints.VALUE_INTERPOLATION_BICUBIC java.awt.RenderingHints.VALUE_INTERPOLATION_BILINEAR java.awt.RenderingHints.VALUE_INTERPOLATION_NEAREST_NEIGHBORのいずれかを選択。

リターン

X軸を中心に回転した画像情報を持つImageToolオブジェクト
注意1) 一般的に変更された画像は、元の画像のコピーである。
注意2) X軸で回転をする場合、上下に反転したイメージになる。

使い方

ImageTool oimg = ImageTool.getInstance(item);                            				            
ImageTool dimg = oimg.flipX(RenderingHints.VALUE_INTERPOLATION_BILINEAR);

flipY

Y軸に基づいて回転した画像情報を持つImageToolオブジェクトを返します。
形式
```
public ImageTool flipY(Object hint) 
```

パラメータ

名前	形式	説明
hint	java.lang.Object	新しいイメージを描画するときに使用補間。 java.awt.RenderingHints.VALUE_INTERPOLATION_BICUBIC java.awt.RenderingHints.VALUE_INTERPOLATION_BILINEAR java.awt.RenderingHints.VALUE_INTERPOLATION_NEAREST_NEIGHBORのいずれかを選択。

リターン

Y軸を中心に回転した画像情報を持つImageToolオブジェクト
注意1) 一般的に変更された画像は、元の画像のコピーである。
注意2) Y軸に回転をした場合、左右が変わったイメージになる。

使い方

ImageTool oimg = ImageTool.getInstance(item);                            				            
ImageTool dimg = oimg.flipY(RenderingHints.VALUE_INTERPOLATION_BILINEAR);

crop

元の画像の一部の領域をコピーした画像情報を持つImageToolオブジェクトを返します。

形式

public ImageTool crop(int x, int y, int width, int height)

パラメータ

名前	形式	説明
x	int	元の画像のX軸座標
y	int	元の画像のY軸座標
width	int	コピーする領域の水平サイズ(pixel)
heigth	int	コピーする領域の縦サイズ(pixel)

リターン

一部の領域をコピーした画像情報を持つImageToolオブジェクト

使い方

ImageTool oimg = ImageTool.getInstance(item);                            				            
ImageTool dimg = oimg.crop(5, 10, 200, 400);

overlay

元の画像に対象画像や文字をオーバーレイした画像情報を持つImageToolオブジェクトを返します。

形式

public ImageTool overlay(BufferedImage over, int x, int y, float alpha)
public ImageTool overlay(BufferedImage over, ImageOption.Position position, float alpha)
public ImageTool overlay(String text, int x, int y, float alpha, Font font, Color fontColo)

パラメータ

名前	形式	説明
over	java.awt.image.BufferedImage	オーバーレイターゲットイメージオブジェクト
x	int	元の画像のX軸のオーバーレイ座標
y	int	元の画像のY軸のオーバーレイ座標
alpha	float	ターゲットイメージ(over)の透明度(0.0f〜1.0f)
position	dextuploadjk.media.ImageOption.Position	オーバーレイする位置を示す値
text	java.lang.String	オーバーレイする文字列
font	java.awt.font	レンダリングするjava.awt.Fontオブジェクト。注意) システムでサポートが不可能なフォントは適用されない。
fontColor	java.awt.Color	文字色

リターン

元の画像に対象画像（over）をオーバーレイした画像情報を持つImageToolオブジェクト
注意1) 一般的に変更された画像は、元の画像のコピーである。

使い方

ImageTool oimg = ImageTool.getInstance(item);    
//1                        				            
ImageTool dimg = bimg.overlay(oimg.getImage(), 20, 40, 0.25f);
//2
ImageTool cimg = bimg.overlay(oimg.getImage(), ImageOption.Position.CenterMiddle, 0.25f); 
//3
ImageTool cimg = bimg.overlay(overText, bimg.getWidth() / 4, bimg.getHeight() / 2, 0.25f, new Font("Arial", Font.PLAIN + Font.BOLD, 24), Color.pink);

save

画像オブジェクトをファイルに保存する。

形式

public String save(File target, ImageOption.Format format)
public String save(File target, ImageOption.Format format, boolean overwrite)

パラメータ

名前	形式	説明
target	java.io.File	保存するファイルの情報を表すオブジェクト
format	dextuploadjk.media.ImageOption.Format	保存するファイル形式を示す値
overwrite	boolean	すでにファイルが存在する場合、上書きするか否かどうかを設定する。デフォルト値はtrueである。

リターン

保存ファイルへのパス（バージョン1.1.0から対応）
例外: IOException

使い方

ImageTool oimg = ImageTool.getInstance(item);   
ImageTool dimg = oimg.resize(64, 64, RenderingHints.VALUE_INTERPOLATION_BILINEAR, true);                         				            
dimg.save(new File(repositoryDir, String.format("%s.%s", item.getFilenameWithoutExtension(), fmt.name().toLowerCase())), oimg.getFormat());

saveToJpeg

画像オブジェクトをJPGファイルとして保存する。

形式

public String saveToJpeg(File target)
public String saveToJpeg(File target, boolean overwrite)

パラメータ

名前	形式	説明
target	java.io.File	保存するファイルの情報を表すオブジェクト
overwrite	boolean	すでにファイルが存在する場合は、上書きするかどうかを設定します。デフォルトはtrueです。

リターン

保存ファイルへのパス（バージョン1.1.0から対応）
例外: IOException

使い方

ImageTool oimg = ImageTool.getInstance(item);
oimg.saveToJpeg(new File(repositoryDir, item.getFilenameWithoutExtension().concat(".jpg")));

saveToPng

画像オブジェクトをPNGファイルとして保存する。

形式

public String saveToPng(File target)
public String saveToPng(File target, boolean overwrite)

パラメータ

名前	形式	説明
target	java.io.File	保存するファイルの情報を表すオブジェクト
overwrite	boolean	すでにファイルが存在する場合、上書きするか否かどうかを設定する。デフォルト値はtrueである。

リターン

保存ファイルへのパス（バージョン1.1.0から対応）
例外: IOException

使い方

ImageTool oimg = ImageTool.getInstance(item);
oimg.saveToPng(new File(repositoryDir, item.getFilenameWithoutExtension().concat(".png")));

saveToGif

画像オブジェクトをGIFファイルとして保存する

形式

public String saveToGif(File target)
public String saveToGif(File target, boolean overwrite)

パラメータ

名前	形式	説明
target	java.io.File	保存するファイルの情報を表すオブジェクト
overwrite	boolean	すでにファイルが存在する場合、上書きするか否かどうかを設定する。デフォルト値はtrueである。

リターン

保存ファイルへのパス（バージョン1.1.0から対応）
例外: IOException

使い方

ImageTool oimg = ImageTool.getInstance(item);
oimg.saveToGif(new File(repositoryDir, item.getFilenameWithoutExtension().concat(".gif")));

saveToBmp

画像オブジェクトをBMPファイルに保存します。

形式

public String saveToBmp(File target)
public String saveToBmp(File target, boolean overwrite)

パラメータ

名前	形式	説明
target	java.io.File	保存するファイルの情報を表すオブジェクト
overwrite	boolean	すでにファイルが存在する場合、上書きするか否かどうかを設定する。デフォルト値はtrueである。

リターン

保存ファイルへのパス（バージョン1.1.0から対応）
例外: IOException

使い方

ImageTool oimg = ImageTool.getInstance(item);
oimg.saveToBmp(new File(repositoryDir, item.getFilenameWithoutExtension().concat(".bmp")));

getMetadata

の画像の対象となるファイルがあり、対象のファイルがJPG形式であれば、ファイルに記録されたExif、Gps、Thumbnail情報を持つ ImageMetadata オブジェクトを返します。
形式
```
public ImageMetadata getMetadata()
```
リターン

Exif、Gps、Thumbnail情報を持つImageMetadata オブジェクト、元の画像がない場合、またはリンク先のファイルがJPG形式でない場合はnullを返します。

使い方

ImageTool oimg = ImageTool.getInstance(item);
ImageMetadata metadata = oimg.getMetadata();

setMetadata

Exif、Gps、Thumbnail情報を持 ImageMetadata オブジェクトを設定する。

形式

public void setMetadata(ImageMetadata metadata)

パラメータ

名前	形式	説明
metadata	dextuploadjk.media.ImageMetadata	Exif、Gps、Thumbnail情報を持つオブジェクト

使い方

ImageTool oimg = ImageTool.getInstance(item);
oimg.setMetadata(metadate);

dextuploadjk.mediaClass ImageTool

dextuploadjk.media
Class ImageTool