[Visual Basic] Public Function AppendTiffImage(Val As Newtone.ImageKit.SaveFileType, SaveImage As Image) As Boolean
[C#] public bool AppendTiffImage(Newtone.ImageKit.SaveFileType Val, Image SaveImage);
パラメータ
- Val
- 追加するイメージの種類( Newtone.ImageKit.SaveFileType
値)
- SaveImage
- 追加するイメージ
戻り値
成功の場合は True 、失敗の場合は False を返します。
解説
FileName プロパティに設定した Tiff
ファイルの最後のページに引数の SaveImage の値に応じたイメージを追加して保存します。
FileName プロパティに設定したファイルが存在しないときは、新規のシングルページの Tiff ファイルとして保存します。
引数の Val には、Tiff イメージを設定した場合のみ有効です。作成するマルチ Tiff ファイルの各ページの圧縮形式や引数
Val で設定した圧縮形式は、異なる形式が混在していても有効です。
FileName プロパティに設定したファイルが Tiff ファイル以外の場合や、引数 Val に Tiff
以外の種類を設定した場合は失敗して False を返します。
・引数の SaveImage に有効なイメージを与えた場合:
SaveImage に設定されたイメージを FileName
プロパティに設定されたファイルに保存します。
・引数の SaveImage に null(VisualBasicはNothing) を与えた場合:
ImageKit.LayerNumber
プロパティが示すプロパティ(ImageKit.Image
プロパティ、もしくは ImageKit.Layer(LayerNumber).Imgae
プロパティ)に設定されたイメージを FileName プロパティに設定されたファイルに保存します。
※LayerNumber=-1 であれば Image、LayerNumber=0~99であれば
ImageKit.Layer(LayerNumber).Image
各圧縮形式ごとに保存可能なビット数があります。対象外のビット数を保存しようとするとエラーとなりますので注意してください。
下記に保存可能なビット数を示します。
形式: 保存対象となるイメージのビット数
TIFF(非圧縮): 1,4,8,16(グレーは除く),24,32
TIFF(GROUP3-1D): 1,4,8,16(グレーは除く),24,32(Windows Vista
は1ビットのみ。保存対象は左記のとおりですが、すべて1ビットで保存されます。)
TIFF(GROUP4): 1,4,8,16(グレーは除く),24,32(Windows Vista
は1ビットのみ。保存対象は左記のとおりですが、すべて1ビットで保存されます。)
TIFF(PACKBITS): 1,24
TIFF(LZW): 1,4,8,16(グレーは除く),24,32
GROUP3-1D は MH、GROUP4 は MMRと同じ形式です。
非圧縮、LZW 形式で16ビットイメージを保存すると24ビットイメージに変換されます。
例
ImageKit コントロールに読み込んだ 1ビットの BMP ファイルを G4形式のTiff イメージに変換して、既存の Tiff ファイルの最後のページに追加して保存します。
[Visual Basic.NET] ImagKit1.File.FileName = "1bitBMP.bmp" If ImagKit1.File.LoadImageFromFile() = False Then Exit Sub ImagKit1.File.FileName = "MulitiTiff.tif" '既存の Tif ファイル ImagKit1.File.AppendTiffImage(Newtone.ImageKit.SaveFileType.SaveTIFFGroup4, Nothing) [Visual C#.NET] ImagKit1.File.FileName = "1bitBMP.bmp"; if (!ImagKit1.File.LoadImageFromFile()) return; ImagKit1.File.FileName = "MulitiTiff.tif"; //既存の Tif ファイル ImagKit1.File.AppendTiffImage(Newtone.ImageKit.SaveFileType.SaveTIFFGroup4, null);
参照
ImageKit.File メンバ | Newtone.ImageKit.WPF.ImageKit