devpia.dextupload.image
Class ImageTool

java.lang.Object
  devpia.dextupload.ErrorManager
      devpia.dextupload.image.ImageTool

public class ImageTool

extends devpia.dextupload.ErrorManager

このクラスはJREが対応する基本的なイメージフォーマットに対応しています。各種メソッドを使えば簡単に他のイメージフォーマットに変換したり、サムネールイメージを生成したり、または文字やイメージのウォーターマークなどを挿入することができます。 対応するイメージフォーマットについてですが、JRE1.4までのバージョンの場合はJPEGやPNGなどと非常に制限されています。 BMPやGIFなどのイメージフォーマットを使用するためにはJRE1.5以上のバージョンでお使いください。

Constructor Summary

ImageTool()

ImageTool(java.io.File _ImageFile)

ImageTool(java.lang.String _ImageFilePath)

Method Summary

void	DrawImage(java.io.File _File, int x, int y) 現在作業中のイメージに他のイメージを挿入します。
void	DrawImage(java.lang.String _FilePath, int x, int y) 現在作業中のイメージに他のイメージを挿入します。
void	DrawText(java.lang.String _Text, int x, int y) 現在作業中のイメージに文字を挿入します。
java.awt.image.BufferedImage	getBufferedImage() 現在作業中の[BufferedImage]オブジェクトを求めます。
java.awt.Font	getFont() 現在使用中のフォントを求めます。
java.awt.Color	getFontColor() 現在使用中のフォントの色を求めます。
java.lang.String	getFormatName() ロードしたイメージファイルの種類を求めます。
int	getHeight() 現在作業中のイメージの高さを求めます。
static ImageTool	getImageTool(java.io.File _ImageFile) 入力されたイメージファイルを基本とする[ImageTool]オブジェクトを生成します。
static ImageTool	getImageTool(java.lang.String _ImageFilePath) 入力されたイメージファイルを基本とする[ImageTool]オブジェクトを生成します。
float	getTransparency() 現在指定されている透明度を求めます。
int	getWidth() 現在作業中のイメージの幅を求めます。
boolean	IsImage() 現在[ImageTool]オブジェクトを使用できるイメージファイルかどうかを判別します。
static boolean	IsImage(java.io.File _ImageFile) 入力されたファイルがDEXTUploadJで使用できるファイルかどうかを判別します。
static boolean	IsImage(java.lang.String _FilePath) 入力されたパスのファイルがDEXTUploadJで使用できるファイルかどうかを判別します。
boolean	LoadImage(java.io.File _ImageFile) 指定されたファイルをローディングします。
boolean	LoadImage(java.lang.String _ImageFilePath) 指定されたファイルをローディングします。
boolean	SaveImage(java.lang.String _ImageFilePath, java.lang.String _ImageType) 現在まで作業したイメージを指定のフォーマットで保存します。
boolean	SaveImageToBMP(java.lang.String _ImageFilePath) 現在まで作業したイメージをBMPフォーマットで保存します。
boolean	SaveImageToGIF(java.lang.String _ImageFilePath) 現在まで作業したイメージをGIFフォーマットで保存します。
boolean	SaveImageToJPEG(java.lang.String _ImageFilePath) 現在まで作業したイメージをJPEGフォーマットで保存します。
boolean	SaveImageToJPEG(java.lang.String _ImageFilePath, float _Quality) 現在まで作業したイメージをJPEGフォーマットで保存します。
boolean	SaveImageToPNG(java.lang.String _ImageFilePath) 現在まで作業したイメージをPNGフォーマットで保存します。
void	setFont(java.awt.Font _Font) 使用するフォントを設定します。
void	setFont(java.lang.String _FontName, int FontSize) 使用するフォントを設定します。
void	setFont(java.lang.String _FontName, int FontStyle, int FontSize) 使用するフォントを設定します。
void	setFontColor(java.awt.Color _Color) 使用するフォントの色を設定します。
void	setSize(float _ResizeRatio) 入力された比率に従って現在作業中のイメージのサイズを変更します。
void	setSize(int _Width, int _Height) 現在作業中のイメージのサイズを変更します。
void	setTransparency(float _alpha) 透明度を指定します。

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ImageTool

public ImageTool()

ImageTool

public ImageTool(java.lang.String _ImageFilePath)
          throws java.io.IOException,
                 DEXTUploadException

Parameters:

_ImageFilePath - ソースイメージファイルのパス

Throws:

java.io.IOException

DEXTUploadException

ImageTool

public ImageTool(java.io.File _ImageFile)
          throws java.io.IOException,
                 DEXTUploadException

Parameters:

_ImageFile - ソースイメージファイル

Throws:

java.io.IOException

DEXTUploadException

Method Detail

getFormatName

public java.lang.String getFormatName()

ロードしたイメージファイルの種類を求めます。

Returns:

イメージの種類は次のうちの一つです。
JPEG, BMP, GIF, PNG, WBMP

LoadImage

public boolean LoadImage(java.lang.String _ImageFilePath)
                  throws java.io.IOException,
                         DEXTUploadException

指定されたファイルをローディングします。

Parameters:

_ImageFilePath - ソースイメージファイルのパス

Throws:

java.io.IOException

DEXTUploadException

getImageTool

public static ImageTool getImageTool(java.lang.String _ImageFilePath)
                              throws DEXTUploadException,
                                     java.io.IOException

入力されたイメージファイルを基本とする[ImageTool]オブジェクトを生成します。 保存されたファイルが正しくない場合は[null]をリターンします。

Parameters:

_ImageFilePath - 使用するイメージファイルのパス

Returns:

生成された[ImageTool]オブジェクト　正しくないファイルの場合は[null]をリターンします。

Throws:

DEXTUploadException

java.io.IOException

getImageTool

public static ImageTool getImageTool(java.io.File _ImageFile)
                              throws DEXTUploadException,
                                     java.io.IOException

入力されたイメージファイルを基本とする[ImageTool]オブジェクトを生成します。 保存されたファイルが正しくない場合は[null]をリターンします。

Parameters:

_ImageFile - 使用するイメージファイルオブジェクト

Returns:

生成された[ImageTool]オブジェクト　正しくないファイルの場合は[null]をリターンします。

Throws:

DEXTUploadException

java.io.IOException

LoadImage

public boolean LoadImage(java.io.File _ImageFile)
                  throws java.io.IOException,
                         DEXTUploadException

指定されたファイルをローディングします。

Parameters:

_ImageFile - ソースイメージファイル

Throws:

java.io.IOException

DEXTUploadException

IsImage

public static boolean IsImage(java.lang.String _FilePath)
                       throws java.io.IOException

入力されたパスのファイルがDEXTUploadJで使用できるファイルかどうかを判別します。

Parameters:

_FilePath - 判別しようとするイメージファイルのパス

Returns:

使用できるイメージの場合は[true]をリターンします。

Throws:

java.io.IOException

IsImage

public static boolean IsImage(java.io.File _ImageFile)
                       throws java.io.IOException

入力されたパスのファイルがDEXTUploadJで使用できるファイルかどうかを判別します。

Parameters:

_ImageFile - 判別しようとするイメージファイルのパス

Returns:

使用できるイメージの場合は[true]をリターンします。

Throws:

java.io.IOException

IsImage

public boolean IsImage()

現在[ImageTool]オブジェクトを使用できるイメージファイルかどうかを判別します。

Returns:

使用できるイメージの場合は[true]をリターンします。

SaveImageToJPEG

public boolean SaveImageToJPEG(java.lang.String _ImageFilePath)
                        throws java.io.IOException,
                               DEXTUploadException

現在まで作業したイメージをJPEGフォーマットで保存します。

Parameters:

_ImageFilePath - 保存するイメージファイルのパス

Throws:

java.io.IOException

DEXTUploadException

SaveImageToJPEG

public boolean SaveImageToJPEG(java.lang.String _ImageFilePath,
                               float _Quality)
                        throws java.io.IOException,
                               DEXTUploadException

現在まで作業したイメージをJPEGフォーマットで保存します。

Parameters:

_ImageFilePath - 保存するイメージファイルのパス

_Quality - 保存するイメージの品質　0.0から1.0の値で表示します(1.00が最高品質)。

Throws:

java.io.IOException

DEXTUploadException

SaveImage

public boolean SaveImage(java.lang.String _ImageFilePath,
                         java.lang.String _ImageType)
                  throws java.io.IOException,
                         DEXTUploadException

現在まで作業したイメージを指定のフォーマットで保存します。 このメソッドは、[SaveImageToJPEG]と同様、明示的に対応していないフォーマットに対応するためのものです。

Parameters:

_ImageFilePath - 保存するイメージファイルのパス

_ImageType - 保存するイメージフォーマット　イメージの種類は次のうちの一つです。
JPEG, BMP, GIF, PNG, WBMP
バージョンによっては一部フォーマットに対応していない場合もあります。

Throws:

java.io.IOException

DEXTUploadException

SaveImageToPNG

public boolean SaveImageToPNG(java.lang.String _ImageFilePath)
                       throws java.io.IOException,
                              DEXTUploadException

現在まで作業したイメージを PNGフォーマットで保存します。

Parameters:

_ImageFilePath - 保存するイメージファイルのパス

Throws:

java.io.IOException

DEXTUploadException

SaveImageToGIF

public boolean SaveImageToGIF(java.lang.String _ImageFilePath)
                       throws java.io.IOException,
                              DEXTUploadException

現在まで作業したイメージを GIFフォーマットで保存します。 JRE1.6以上で対応しています。

Parameters:

_ImageFilePath - 保存するイメージファイルのパス

Throws:

java.io.IOException

DEXTUploadException

SaveImageToBMP

public boolean SaveImageToBMP(java.lang.String _ImageFilePath)
                       throws java.io.IOException,
                              DEXTUploadException

現在まで作業したイメージを BMPフォーマットで保存します。 JRE1.5以上で対応しています。

Parameters:

_ImageFilePath - 保存するイメージファイルのパス

Throws:

java.io.IOException

DEXTUploadException

setTransparency

public void setTransparency(float _alpha)

透明度を指定します。

Parameters:

_alpha - 透明度　0.0から1.0の値で表示します。値が小さいほど透明度が増します。

getTransparency

public float getTransparency()

現在指定されている透明度を求めます。

Returns:

現在指定されている透明度

getWidth

public int getWidth()

現在作業中のイメージの幅を求めます。(単位はPixel)

Returns:

ロードされたイメージファルの幅

getHeight

public int getHeight()

現在作業中のイメージの高さを求めます。(単位はPixel)

Returns:

ロードされたイメージファイルの高さ

setSize

public void setSize(float _ResizeRatio)

入力された比率に従って現在作業中のイメージのサイズを変更します。

Parameters:

_ResizeRatio - 保存するイメージのサイズ比率　0より大きくなければなりません。(1.0はそのままのサイズ。2.0は2倍に拡大。0.5は半分のサイズ。)

setSize

public void setSize(int _Width,
                    int _Height)

現在作業中のイメージのサイズを変更します。

Parameters:

_Width - イメージの幅

_Height - イメージの高さ

getFont

public java.awt.Font getFont()

現在使用中のフォントを求めます。

Returns:

現在使用中のフォント

setFont

public void setFont(java.awt.Font _Font)

使用するフォントを設定します。

Parameters:

_Font - 使用するフォント

setFont

public void setFont(java.lang.String _FontName,
                    int FontSize)

使用するフォントを設定します。

Parameters:

_FontName - フォント名及び

FontSize - フォントのサイズ

setFont

public void setFont(java.lang.String _FontName,
                    int FontStyle,
                    int FontSize)

使用するフォントを設定します。

Parameters:

_FontName - フォント名及び

FontStyle - フォントのスタイルや[Font]クラスに定義されたスタイルと同一です。

FontSize - フォントのサイズ

See Also:

Font

getFontColor

public java.awt.Color getFontColor()

現在使用中のフォントの色を求めます。

Returns:

現在指定されているフォントの色

setFontColor

public void setFontColor(java.awt.Color _Color)

使用するフォントの色を設定します。

Parameters:

_Color - 使用するフォントの色

getBufferedImage

public java.awt.image.BufferedImage getBufferedImage()

現在作業中の[BufferedImage]オブジェクトを求めます。

Returns:

現在作業中の[BufferedImage]オブジェクト

DrawText

public void DrawText(java.lang.String _Text,
                     int x,
                     int y)

現在作業中のイメージに文字を挿入します。

Parameters:

_Text - イメージに挿入する文字列

x - イメージに挿入する横軸の位置(単位 Pixel)

y - イメージに挿入する縦軸の位置(単位 Pixel)

DrawImage

public void DrawImage(java.lang.String _FilePath,
                      int x,
                      int y)
               throws java.io.IOException,
                      DEXTUploadException

現在作業中のイメージに他のイメージを挿入します。

Parameters:

_FilePath - イメージに挿入するイメージのパス

x - イメージに挿入する横軸の位置(単位 Pixel)

y - イメージに挿入する縦軸の位置(単位 Pixel)

Throws:

java.io.IOException

DEXTUploadException

DrawImage

public void DrawImage(java.io.File _File,
                      int x,
                      int y)
               throws java.io.IOException,
                      DEXTUploadException

現在作業中のイメージに他のイメージを挿入します。

Parameters:

_File - イメージに挿入するイメージファイル

x - イメージに挿入する横軸の位置(単位 Pixel)

y - イメージに挿入する縦軸の位置(単位 Pixel)

Throws:

java.io.IOException

DEXTUploadException