サポート情報
パソコンFAXソフト STARFAX
ConvertFileメソッド

公開日:2012年12月6日

構 文

object.ConvertFile(ExiFileName, NewFileName, Page, Type, TiffComp, Color, Jquality, SaveMode, Paper, FitPage, Rotate, Width, Height, ResoX, ResoY, Dlg)

解 説

指定した画像ファイルを、以下のファイル形式に変換します。
BMP / JPEG / PDF / TIFF / PCX / FAX / DCX

OCXコントロール:SFWDOC Control

引 数

ExiFileName(文字列型:255byte) 変換元の画像ファイルを指定
定  数 説  明
"ファイルパス" 変換元の画像ファイルをフルパスで指定します。

NewFileName (文字列型:255byte) 変換先を指定
定  数 説  明
"ファイルパス" 変換したファイルの保存先を、フルパスで指定します。

Page (整数型) 対象とするページを指定
定  数 説  明
0:全ページ指定(デフォルト) 0(デフォルト):全ページ指定    
1〜32767    :変換するページを指定

Type (整数型) 変換するファイル形式を指定
定  数 説  明
SFWDOC_FileType_BMP (1) BMP
SFWDOC_FileType_TIF (2) TIFF
SFWDOC_FileType_PCX (3) PCX
SFWDOC_FileType_FAX (4) FAX
SFWDOC_FileType_DCX (5) DCX
SFWDOC_FileType_JPG (7) JPEG
SFWDOC_FileType_PDF_SaveOnly (9) PDF

TiffComp (整数型) TIFFファイルの圧縮形式を指定 ※TypeでTIFFを指定の場合のみ
定  数 説  明
SFWDOC_TiffComp_NONE (1) 圧縮なし
SFWDOC_TiffComp_MH (2) 修正CCITT MH 圧縮
SFWDOC_TiffComp_G3MH (3) CCITT G3 MH 圧縮
SFWDOC_TiffComp_G3MR (4) CCITT G3 MR 圧縮
SFWDOC_TiffComp_PACKBITS (5) PackBits 圧縮
SFWDOC_TiffComp_CLASSF (6) Class F 圧縮
SFWDOC_TiffComp_G4 (7) G4 圧縮
SFWDOC_TiffComp_JPEG (8) JPEG 圧縮

Color (整数型) 色指定
定  数 説  明
SFWDOC_Color_NO (0) 色変換をしない
SFWDOC_Color_MONO (1) 白黒
SFWDOC_Color_COLOR8 (2) カラー8色
SFWDOC_Color_COLOR16 (3) カラー16色
SFWDOC_Color_COLOR256 (4) カラー256色
SFWDOC_Color_COLOR1677 (5) カラー1677万色
SFWDOC_Color_GRAY16 (6) グレースケール16階調
SFWDOC_Color_GRAY256 (7) グレースケール256階調

Jquality (整数型) JPEGファイルの品質形式指定 ※TypeでJPEGを指定の場合のみ
定  数 説  明
0:デフォルト(75) 1〜100:任意のJPEG品質

SaveMode(整数型)用紙サイズモード指定
定  数 説  明
SFWDOC_SaveMode_NO (0) サイズを変更しない
SFWDOC_SaveMode_STDSIZE (1) 用紙サイズ指定
SFWDOC_SaveMode_STDWIDTH (2) ページごとに、自動でA4,B4,A3に幅を合わせる
SFWDOC_SaveMode_A4WIDTH (3) 幅をA4に合わせる
SFWDOC_SaveMode_SET (4) 任意設定

Paper(整数型)SaveModeで「用紙サイズ指定」のみ有効
定  数 説  明
SFWDOC_Paper_A4 (0) A4
SFWDOC_Paper_B4 (1) B4
SFWDOC_Paper_A3 (2) A3
SFWDOC_Paper_A5 (3) A5
SFWDOC_Paper_B5 (4) B5
SFWDOC_Paper_11x17 (10) 11×17インチ
SFWDOC_Paper_85x14 (11) 8.5×14インチ
SFWDOC_Paper_85x11 (12) 8.5×11インチ
SFWDOC_Paper_55x85 (13) 5.5×8.5インチ

FitPage (整数型)※SaveModeで「用紙サイズ指定」「任意設定」以外を選択している場合のみ
定  数 説  明
SFWDOC_FitPage_FALSE (0) 白紙部分をカットしない
SFWDOC_FitPage_TRUE (1) 白紙部分をカットする

Rotate (整数型)用紙の向きを指定
定  数 説  明
SFWDOC_RotateMode_NO (0) 回転しない
SFWDOC_RotateMode_90 (1) 右90度
SFWDOC_RotateMode_180 (2) 右180度
SFWDOC_RotateMode_270 (3) 右270度

Width (長整数型) 幅指定※SaveModeが任意設定の場合のみ有効
定  数 説  明
- ピクセルで指定

Height (長整数型) 高さ指定※SaveModeが任意設定の場合のみ有効
定  数 説  明
- ピクセルで指定

ResoX(長整数型)X解像度指定
定  数 説  明
0:デフォルト 0   : X解像度変換をしない
0以外: X解像度を指定して変換する
※STARFAXで送信できる解像度
  ファイン      :X200dpi/Y200dpi
  ノーマル      :X200dpi/Y100dpi
  スーパーファイン:X200dpi/Y400dpi

ResoY(長整数型)Y解像度指定
定  数 説  明
0:デフォルト 0   : Y解像度変換をしない
0以外: Y解像度を指定して変換する
※STARFAXで送信できる解像度
  ファイン      :X200dpi/Y200dpi
  ノーマル      :X200dpi/Y100dpi
  スーパーファイン:X200dpi/Y400dpi

Dlg(整数型)変換中の中断ダイアログの表示有無
定  数 説  明
SFWDOC_Dialog_FALSE (0) 表示しない
SFWDOC_Dialog_TRUE (1) 表示する

戻り値

定  数 戻り値(長整数型) 説  明
SFWDOC_SUCCESS 0 正常終了
SFWDOC_ERR_CF_BADPAGE 60 変換対象指定ページが無効
SFWDOC_ERR_CF_BADFILE 61 ファイル情報を読み出せません
SFWDOC_ERR_CF_OPENFILE 62 ファイルをオープンできません
SFWDOC_ERR_CF_READFILE 63 ファイルの読み込みに失敗しました
SFWDOC_ERR_CF_WRITEFILE 64 ファイルの書き込みに失敗しました
SFWDOC_ERR_CF_CHGSIZE 65 画像のサイズ変換に失敗しました
SFWDOC_ERR_CF_ROTATE 66 画像の回転に失敗しました
SFWDOC_ERR_CF_FITPAGE 67 画像の白紙部分カットに失敗しました
SFWDOC_ERR_CF_USERSTOP 69 処理が中断されました

サンプルプログラム

ConvertFile / DirectFaxEx
一覧に戻る STARFAXシリーズ製品情報