devpia.dextuploadnj.media
Class ImageTool

サポートされる最小バージョン

1.0.0

最小サポート環境

JRE 1.6

説明

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

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

メソッド

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	devpia.dextuploadnj.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	devpia.dextuploadnj.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	devpia.dextuploadnj.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	devpia.dextuploadnj.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);
//または
ImageTool dimg = oimg.resizeUniformToFill(0.5f, 0.5f,ImageOption.Position.CenterMiddle, RenderingHints.VALUE_INTERPOLATION_BILINEAR, true);

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

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

rotate

回転された画像情報を持つdevpia.dextuploadnj.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オブジェクト
注意1）一般的に変更された画像は、元の画像のコピーである。

使い方

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

rotate180CW

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

形式

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オブジェクト
注意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	devpia.dextUploadNJ.media.ImageOption.Axis	回転させる軸を示すdevpia.dextuploadnj.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	devpia.dextuploadnj.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("Font Name", Font.PLAIN + Font.BOLD, 24), Color.pink);

save

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

形式

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

パラメータ

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

リターン

保存ファイルへのパス（バージョン2.13.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 void saveToJpeg(File target)
public void saveToJpeg(File target, boolean overwrite)

パラメータ

名前	形式	説明
target	java.io.File	保存するファイルの情報を表すオブジェクト
overwrite	boolean	保存するファイルの情報を表すオブジェクト

リターン

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

使い方

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

saveToPng

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

形式

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

パラメータ

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

リターン

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

使い方

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

saveToGif

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

形式

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

パラメータ

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

リターン

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

使い方

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

saveToBmp

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

形式

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

パラメータ

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

リターン

保存ファイルへのパス（バージョン2.13.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	devpia.dextuploadnj.media.ImageMetadata	Exif、Gps、Thumbnail情報を持つオブジェクト

使い方

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

devpia.dextuploadnj.mediaClass ImageTool

devpia.dextuploadnj.media
Class ImageTool