[Visual Basic] Public Function InsertPageIntoMultipageTiff(Val As Newtone.ImageKit.SaveFileType, SaveImage As Image, insertPage As Integer) As Boolean
[C#] public bool InsertPageIntoMultipageTiff(Newtone.ImageKit.SaveFileType Val, Image SaveImage, , int insertPage);
パラメータ
- Val
- 挿入するイメージの種類（ Newtone.ImageKit.SaveFileType
値）
- SaveImage
- 挿入するイメージ
- insertPage
- 挿入するページ
戻り値
成功の場合は True 、失敗の場合は False を返します。
解説
FileName プロパティに設定した Tiff
ファイルの、引数 insertPage で設定したページに引数の SaveImage
の値に応じたイメージを挿入して保存します。
引数 insertPage は1以上が有効となり、設定した値が FileName
プロパティに設定したファイルのページ数よりも大きい場合は、最後のページに追加します。
引数の Val には、Tiff イメージを設定した場合のみ有効です。作成するマルチ Tiff ファイルの各ページの圧縮形式や引数
Val で設定した圧縮形式は、異なる形式が混在していても有効です。
FileName プロパティに設定したファイルが存在しない場合や Tiff ファイル以外の場合、引数 Val に Tiff
以外の種類を設定した場合、引数 insertPage に0以下の値を設定した場合は失敗して 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 ファイルの3ページ目に挿入して保存します。
[Visual Basic.NET] ImagKit1.File.FileName = "1bitBMP.bmp" If ImagKit1.File.LoadImageFromFile() = False Then Exit Sub ImagKit1.File.FileName = "MulitiTiff.tif" '既存の Tif ファイル ImagKit1.File.InsertPageIntoMultipageTiff(Newtone.ImageKit.SaveFileType.SaveTIFFGroup4, Nothing, 3) [Visual C#.NET] ImagKit1.File.FileName = "1bitBMP.bmp"; if (!ImagKit1.File.LoadImageFromFile()) return; ImagKit1.File.FileName = "MulitiTiff.tif"; //既存の Tif ファイル ImagKit1.File.InsertPageIntoMultipageTiff(Newtone.ImageKit.SaveFileType.SaveTIFFGroup4, null, 3);
参照
ImageKit.File メンバ | Newtone.ImageKit.WPF.ImageKit