3.3 イメージ編集コントロールのメソッド |
メソッド | 機能 | V2.0追加 |
---|---|---|
AboutBox | バージョン情報を表示します。 | |
AddPage | マルチページイメージへページを追加します。 | ○ |
AdjustBrightness | イメージの明るさ・コントラストを調整します。 | |
AdjustColorBalance | イメージの色階調を調整します。 | |
AdjustGamma | イメージの輝度レベルを調整します。 | |
AdjustHue | イメージの色相・彩度・明度を調整します。 | |
Blend | 2つのイメージを合成します。 | |
Blur | イメージをぼかします。 | |
Calculate | 2つのイメージ間で演算を行います。 | |
ChangeColorDepth | イメージの色数を変更します。 | |
ClearRubberBand | 矩形選択枠をクリアします。 | |
ClipRect | イメージの矩形切り取りを行います。 | |
CopyToClipboard | クリップボードにイメージをコピーします。 | ○ |
CreateFromClipboard | クリップボードのデータから新規イメージを作成します。 | ○ |
Delete | 編集中のイメージを削除します。 | |
DeletePage | マルチページイメージからページを削除します。 | ○ |
DistortPinch | イメージをつまんだように変形させます。 | |
DistortSkew | イメージを傾けます。 | |
DistortSphere | イメージを球面状に変形させます。 | |
Emboss | イメージを浮き彫りにします。 | |
EnhanceEdges | イメージの輪郭を強調します。 | |
Equalize | イメージの明るさを均等化します。 | |
FillRect | イメージの矩形塗りつぶしを行います。 | |
FindEdges | イメージの輪郭を抽出します。 | |
Flip | イメージの向きを反転します。 | |
GetDIB | DIBを取得します。 | ○ |
GetErrorCode | メソッドのエラーを通知します。 | |
GetMemHandle | イメージを格納したメモリを取得します。 | |
GetPageCount | マルチページイメージの総ページ数を取得します。 | ○ |
InsertPage | マルチページイメージへページを挿入します。 | ○ |
Invert | イメージの色を反転します。 | |
Load | イメージを読み込みます。 | |
Median | イメージのノイズを除去します。 | |
PasteFromClipboard | クリップボードからデータを貼り付けます。 | ○ |
Refresh | イメージの再描画を行います。 | |
ReplacePage | マルチページイメージのページを置き換えます。 | ○ |
Reset | 編集中のイメージをLoadメソッド実行後の状態に戻します。 | |
Resize | イメージのサイズを変更します。 | |
Rotate | イメージを回転します。(90°単位) | |
RotateArbitrary | イメージを回転します。(1°単位) | |
Save | イメージを保存します。 | |
SelectTwainSource | TWAINデータソース選択ダイアログボックスを表示します。 | |
SetDIB | DIBを設定します。 | ○ |
SetMemHandle | イメージを格納したメモリを設定します。 | |
SetRubberBand | 矩形選択枠を設定します。 | |
Sharpen | イメージをくっきりさせます。 | |
Solarize | イメージの明るさの中間値を境に、濃淡変化を逆転します。 | |
Undo | 編集中のイメージを1つ前の編集状態に戻します。 |
[機能]
コントロールのバージョン情報を表示します。
[書式]
C/C++ | void | AboutBox(); |
Visual Basic | [form.]object.AboutBox |
[パラメータ]
なし
[復帰値]
なし
[機能]
マルチページイメージの最終ページへ、現在編集中のイメージを追加します。
[書式]
C/C++ | BOOL | AddPage(BSTR FileName); |
Visual Basic | [form.]object.AddPage(FileName$) |
[パラメータ]
パラメータ | 型 | 説明 |
---|---|---|
FileName | 文字列型 | マルチページイメージのファイル名を設定します。UNCファイル名も設定可能です。 |
[復帰値]
ブール型 | |
True | 正常 |
False | 異常 |
[備考]
[参照]
SaveMediaFormatプロパティ、DeletePageメソッド、InsertPageメソッド、ReplacePageメソッド
[機能]
イメージの明るさ・コントラストを調整します。
[書式]
C/C++ | BOOL | AdjustBrightness(short Brightness, short Contrast); |
Visual Basic | [form.]object.AdjustBrightness(Brightness%,Contrast%) |
[パラメータ]
パラメータ | 型 | 説明 |
---|---|---|
Brightness | 整数型 | 明るさの割合を-100〜100の範囲で設定します。0の場合は変更されません。 |
Contrast | 整数型 | コントラストの割合を-100〜100の範囲で設定します。0の場合は変更されません。 |
[復帰値]
ブール型 | |
True | 正常 |
False | 異常 |
[備考]
イメージの色数が、16色、256色、256階調グレースケール、1677万色の場合に有効です。
[参照]
[機能]
イメージの色の階調を調整します。
[書式]
C/C++ | BOOL | AdjustColorBalance(short Red, short Green, short Blue); |
Visual Basic | [form.]object.AdjustColorBalance(Red%,Green%,Blue%) |
[パラメータ]
パラメータ | 型 | 説明 |
---|---|---|
Red | 整数型 | 赤の階調値を-100〜100の範囲で設定します。0の場合は変更されません。 |
Green | 整数型 | 緑の階調値を-100〜100の範囲で設定します。0の場合は変更されません。 |
Blue | 整数型 | 青の階調値を-100〜100の範囲で設定します。0の場合は変更されません。 |
[復帰値]
ブール型 | |
True | 正常 |
False | 異常 |
[備考]
イメージの色数が、16色、256色、1677万色の場合に有効です。
[参照]
[機能]
イメージの輝度レベルを調整(ガンマ補正)します。
[書式]
C/C++ | BOOL | AdjustGamma(short Gamma); |
Visual Basic | [form.]object.AdjustGamma(Gamma%) |
[パラメータ]
パラメータ | 型 | 説明 |
---|---|---|
Gamma | 整数型 | 補正値を1〜1000の範囲で設定します。100は1.0として扱われます。 |
[復帰値]
ブール型 | |
True | 正常 |
False | 異常 |
[備考]
イメージの色数が、16色、256色、256階調グレースケール、1677万色の場合に有効です。
[参照]
[機能]
イメージの色相・彩度・明度を調整します。
[書式]
C/C++ | BOOL | AdjustHue(short Hue, short Saturation, short Lightness); |
Visual Basic | [form.]object.AdjustHue(Hue%,Saturation%,Lightness%) |
[パラメータ]
パラメータ | 型 | 説明 |
---|---|---|
Hue | 整数型 | 色相値を-180〜180の範囲で設定します。0の場合は変更されません。 |
Saturation | 整数型 | 彩度値を-100〜100の範囲で設定します。0の場合は変更されません。 |
Lightness | 整数型 | 明度値を-100〜100の範囲で設定します。0の場合は変更されません。 |
[復帰値]
ブール型 | |
True | 正常 |
False | 異常 |
[備考]
[参照]
[機能]
2つのイメージを合成します。
[書式]
C/C++ | BOOL | Blend(short Ratio, long DstLeft, long DstTop, long DstWidth, long DstHeight,BSTR SrcFileName, long SrcLeft, long SrcTop); |
Visual Basic | [form.]object.Blend(Ratio%,DstLeft&,DstTop&,DstWidth&,DstHeight&,SrcFileName$,SrcLeft&,SrcTop&) |
[パラメータ]
パラメータ | 型 | 説明 |
---|---|---|
Ratio | 整数型 | 編集中イメージの合成比率(%)を0〜100の範囲で設定します。100を設定すると合成は行われません。 |
DstLeft | 長整数型 | 編集中イメージの処理対象域の左上位置(X方向)をイメージ左上からの位置で設定します。(単位はピクセル) |
DstTop | 長整数型 | 編集中イメージの処理対象域の左上位置(Y方向)をイメージ左上からの位置で設定します。(単位はピクセル) |
DstWidth | 長整数型 | 編集中イメージの処理対象域の幅を設定します。0を設定した場合、イメージの幅全体が処理対象域となります。合成元イメージの処理対象域も同じ幅となります。(単位はピクセル) |
DstHeight | 長整数型 | 編集中イメージの処理対象域の高さを設定します。0を設定した場合、イメージの高さ全体が処理対象域となります。合成元イメージの処理対象域も同じ幅となります。(単位はピクセル) |
SrcFileName | 文字列型 | 演算対象となる第2のイメージのファイル名を設定します。UNCファイル名やURL名も設定できます。 |
SrcLeft | 長整数型 | 合成するイメージの左上位置(X方向)をイメージ左上からの位置で設定します。(単位はピクセル) |
SrcTop | 長整数型 | 合成するイメージの左上位置(Y方向)をイメージ左上からの位置で設定します。(単位はピクセル) |
[復帰値]
ブール型 | |
True | 正常 |
False | 異常 |
[備考]
[参照]
[機能]
イメージをぼかします。
[書式]
C/C++ | BOOL | Blur(); |
Visual Basic | [form.]object.Blur |
[パラメータ]
なし
[復帰値]
ブール型 | |
True | 正常 |
False | 異常 |
[備考]
イメージの色数が、256階調グレースケール、1677万色の場合に有効です。
[参照]
[機能]
2つのイメージ間で演算を行います。
[書式]
C/C++ | BOOL | Calculate(short CalcOption, long DstLeft, long DstTop, long DstWidth, long DstHeight, BSTR SrcFileName,long SrcLeft, long SrcTop); |
Visual Basic | [form.]object.Calculate(CalcOption%,DstLeft&,DstTop&,DstWidth&,DstHeight&,SrsFileName$,SrcLeft&,SrcTop&) |
[パラメータ]
パラメータ | 型 | 説明 | ||
---|---|---|---|---|
CalcOption | 整数型 | 設定値 | 値 | 意味 |
cwmCalcAdd | 1 | 加算 | ||
cwmCalcSubtract | 2 | 減算 | ||
cwmCalcMultiply | 3 | 乗算 | ||
cwmCalcDivide | 4 | 除算 | ||
cwmCalcOr | 5 | 論理和 | ||
cwmCalcAnd | 6 | 論理積 | ||
cwmCalcNor | 7 | 否定論理和 | ||
cwmCalcNand | 8 | 否定論理積 | ||
cwmCalcXor | 9 | 排他的論理和 | ||
cwmCalcDarker | 10 | 比較(暗) | ||
cwmCalcLighter | 11 | 比較(明) | ||
cwmCalcDifference | 12 | 差の絶対値 | ||
DstLeft | 長整数型 | 編集中イメージの処理対象域の左上位置(X方向)をイメージ左上からの位置で設定します。(単位はピクセル) | ||
DstTop | 長整数型 | 編集中イメージの処理対象域の左上位置(Y方向)をイメージ左上からの位置で設定します。(単位はピクセル) | ||
DstWidth | 長整数型 | 編集中イメージの処理対象域の幅を設定します。0を設定した場合、イメージの幅全体が処理対象域となります。合成元イメージの処理対象域も同じ幅となります。(単位はピクセル) | ||
DstHeight | 長整数型 | 編集中イメージの処理対象域の高さを設定します。0を設定した場合、イメージの高さ全体が処理対象域となります。合成元イメージの処理対象域も同じ幅となります。(単位はピクセル) | ||
SrcFileName | 文字列型 | 演算対象となる第2のイメージのファイル名を設定します。UNCファイル名やURL名も設定可能です。 | ||
SrcLeft | 長整数型 | 変換元イメージの左上位置(X方向)をイメージ左上からの位置で設定します。(単位はピクセル) | ||
SrcTop | 長整数型 | 変換元イメージの左上位置(Y方向)をイメージ左上からの位置で設定します。(単位はピクセル) |
[復帰値]
ブール型 | |
True | 正常 |
False | 異常 |
[備考]
[参照]
[機能]
イメージの色数を変更します。
[書式]
C/C++ | BOOL | ChangeColorDepth(short ColorDepth); |
Visual Basic | [form.]object.ChangeColorDepth(ColorDepth%) |
[パラメータ]
パラメータ | 型 | 説明 | ||
---|---|---|---|---|
ColorDepth | 整数型 | 設定値 | 値 | 意味 |
cwmColorBitmap | 1 | 2色 | ||
cwmColor16 | 4 | 16色 | ||
cwmColor256 | 8 | 256色 | ||
cwmColorGrayscale | 9 | 256階調グレースケール | ||
cwmColorRGB | 12 | 1677万色 |
[復帰値]
ブール型 | |
True | 正常 |
False | 異常 |
[参照]
[機能]
矩形選択枠を消去します。
[書式]
C/C++ | void | ClearRubberBand(); |
Visual Basic | [form.]object.ClearRubberBand |
[パラメータ]
なし
[復帰値]
なし
[参照]
NotifyCancelDragイベント、NotifyDraggedRectイベント、NotifyDraggingRectイベント、SetRubberBandメソッド
[機能]
イメージの矩形切り取りを行います。設定した矩形範囲の内側がイメージとして残り、外側のイメージは切り捨てます。
[書式]
C/C++ | BOOL | ClipRect(long Left, long Top, long Width, long Height); |
Visual Basic | [form.]object.ClipRect(Left&,Top&,Width&,Height&) |
[パラメータ]
パラメータ | 型 | 説明 |
---|---|---|
Left | 長整数型 | 矩形の左上X位置をイメージ左上からのオフセットで設定します。(単位はピクセル) |
Top | 長整数型 | 矩形の左上Y位置をイメージ左上からのオフセットで設定します。(単位はピクセル) |
Width | 長整数型 | 矩形の幅を設定します。(単位はピクセル) |
Height | 長整数型 | 矩形の高さを設定します。(単位はピクセル) |
[復帰値]
ブール型 | |
True | 正常 |
False | 異常 |
[備考]
ClipRectメソッド実行後のイメージの幅、高さはそれぞれImageWidthプロパティ、ImageHeightプロパティに設定します。
[参照]
ImageWidthプロパティ、ImageHeightプロパティ
[機能]
クリップボードにイメージをコピーします。イメージ全体、またはイメージの一部分(矩形で指定した)をコピーすることができます。
[書式]
C/C++ | BOOL | CopyToClipboard(long Left, long Top, long Width, long Height); |
Visual Basic | [form.]object.CopyToClipboard(Left&,Top&,Width&,Height&) |
[パラメータ]
パラメータ | 型 | 説明 |
---|---|---|
Left | 長整数型 | 矩形の左上X位置をイメージ左上からのオフセットで設定します。(単位はピクセル) |
Top | 長整数型 | 矩形の左上Y位置をイメージ左上からのオフセットで設定します。(単位はピクセル) |
Width | 長整数型 | 矩形の幅を設定します。0を設定した場合はイメージの幅全体が処理対象域となります。(単位はピクセル) |
Height | 長整数型 | 矩形の高さを設定します。0を設定した場合はイメージの高さ全体が処理対象域となります。(単位はピクセル) |
[復帰値]
ブール型 | |
True | 正常 |
False | 異常 |
[備考]
クリップボードにコピーされるイメージは、Windowsのデバイス独立型のビットマップ(DIB)の形式です。
[参照]
CreateFromClipboardメソッド、PasteFromClipboardメソッド
[機能]
クリップボードのデータから新規イメージを作成します。
[書式]
C/C++ | BOOL | CreateFromClipboard(); |
Visual Basic | [form.]object.CreateFromClipboard |
[パラメータ]
なし
[復帰値]
ブール型 | |
True | 正常 |
False | 異常 |
[備考]
[参照]
ColorDepthプロパティ、ImageHeightプロパティ、ImageWidthプロパティ、XResolutionプロパティ、YResolutionプロパティ、CopyToClipboardメソッド、PasteFromClipboardメソッド
[機能]
Loadメソッドで読み込み、各種の編集作業を行ったイメージを破棄します。
[書式]
C/C++ | BOOL | Delete(); |
Visual Basic | [form.]object.Delete |
[パラメータ]
なし
[復帰値]
ブール型 | |
True | 正常 |
False | 異常 |
[備考]
Deleteメソッド実行後は、Resetメソッド、Undoメソッドは実行できません。
[参照]
[機能]
マルチページイメージから指定のページを削除します。
[書式]
C/C++ | BOOL | DeletePage(BSTR FileName, short Page); |
Visual Basic | [form.]object.DeletePage(FileName$, Page%) |
[パラメータ]
パラメータ | 型 | 説明 |
---|---|---|
FileName | 文字列型 | マルチページイメージのファイル名を設定します。UNCファイル名も設定可能です。 |
Page | 整数型 | 削除するページ番号を設定します。1以上の数値を設定します。 |
[復帰値]
ブール型 | |
True | 正常 |
False | 異常 |
[備考]
[参照]
SaveMediaFormatプロパティ、AddPageメソッド、InsertPageメソッド、ReplacePageメソッド
[機能]
イメージをつまんだように変形します。
[書式]
C/C++ | BOOL | DistortPinch(short Ratio); |
Visual Basic | [form.]object.DistortPinch(Ratio%) |
[パラメータ]
パラメータ | 型 | 説明 |
---|---|---|
Ratio | 整数型 | 変形の割合を-100〜100の範囲で設定します。0を設定した場合は変形されません。 |
[復帰値]
ブール型 | |
True | 正常 |
False | 異常 |
[機能]
イメージを傾斜させます(平行四辺形に変形します)。
[書式]
C/C++ | BOOL | DistortSkew(short Axis, short Angle); |
Visual Basic | [form.]object .DistortSkew(Axis%,Angle%) |
[パラメータ]
パラメータ | 型 | 説明 | ||
---|---|---|---|---|
Axis | 整数型 | 設定値 | 値 | 意味 |
cwmDirectionHorz | 2 | 水平方向 | ||
cwmDirectionVert | 3 | 垂直方向 | ||
Angle | 整数型 | 傾斜角度を−60°〜60°の範囲で設定します。反時計回りが正方向です。 |
[復帰値]
ブール型 | |
True | 正常 |
False | 異常 |
[備考]
[参照]
ImageWidthプロパティ、ImageHeightプロパティ、FillingColorプロパティ
[機能]
イメージを球面状に変形します。
[書式]
C/C++ | BOOL | DistortSphere(short Direction, short Ratio); |
Visual Basic | [form.]object.DistortSphere(Direction%,Ratio%) |
[パラメータ]
パラメータ | 型 | 説明 | ||
---|---|---|---|---|
Direction | 整数型 | 設定値 | 値 | 意味 |
cwmDirectionBoth | 1 | 両方向 | ||
cwmDirectionHorz | 2 | 水平方向 | ||
cwmDirectionVert | 3 | 垂直方向 | ||
Ratio | 整数型 | 変形の割合を−100〜100の範囲で設定します。0の場合は変形されません。 |
[復帰値]
ブール型 | |
True | 正常 |
False | 異常 |
[機能]
イメージを浮き彫りにします。
[書式]
C/C++ | BOOL | Emboss(); |
Visual Basic | [form.]object.Emboss |
[パラメータ]
なし
[復帰値]
ブール型 | |
True | 正常 |
False | 異常 |
[備考]
イメージの色数が、256階調グレースケール、1677万色の場合に有効です。
[参照]
[機能]
イメージの輪郭を強調します。
[書式]
C/C++ | BOOL | EnhanceEdges(); |
Visual Basic | [form.]object.EnhanceEdges |
[パラメータ]
なし
[復帰値]
ブール型 | |
True | 正常 |
False | 異常 |
[備考]
イメージの色数が、256階調グレースケール、1677万色の場合に有効です。
[参照]
[機能]
イメージ内の明るさの値を、明るさのレベル範囲全体に均等化するよう再配分します。
[書式]
C/C++ | BOOL | Equalize(); |
Visual Basic | [form.]object.Equalize |
[パラメータ]
なし
[復帰値]
ブール型 | |
True | 正常 |
False | 異常 |
[備考]
イメージの色数が、256階調グレースケール、1677万色の場合に有効です。
[参照]
[機能]
イメージの一部を矩形で塗りつぶします。指定した矩形範囲の内側をFillingColorプロパティで設定した色で塗りつぶします。
[書式]
C/C++ | BOOL | FillRect(long Left, long Top, long Width, long Height); |
Visual Basic | [form.]object.FillRect(Left&,Top&,Width&,Height&) |
[パラメータ]
パラメータ | 型 | 説明 |
---|---|---|
Left | 長整数型 | 矩形の左上位置(X方向)をイメージ左上からのオフセットで設定します。(単位はピクセル) |
Top | 長整数型 | 矩形の左上位置(Y方向)をイメージ左上からのオフセットで設定します。(単位はピクセル) |
Width | 長整数型 | 矩形の幅を設定します。(単位はピクセル) |
Height | 長整数型 | 矩形の高さを設定します。(単位はピクセル) |
[復帰値]
ブール型 | |
True | 正常 |
False | 異常 |
[参照]
[機能]
イメージの輪郭を抽出します。イメージ内で明確な色の変化がある部分を識別し、その部分の輪郭を検出します。
[書式]
C/C++ | BOOL | FindEdges(); |
Visual Basic | [form.]object.FindEdges |
[パラメータ]
なし
[復帰値]
ブール型 | |
True | 正常 |
False | 異常 |
[備考]
イメージの色数が、256階調グレースケール、1677万色の場合に有効です。
[参照]
[機能]
イメージの向きを反転します。
[書式]
C/C++ | BOOL | Flip(short Direction); |
Visual Basic | [form.]object.Flip(Direction%) |
[パラメータ]
パラメータ | 型 | 説明 | ||
---|---|---|---|---|
Direction | 整数型 | 設定値 | 値 | 意味 |
cwmDirectionHorz | 2 | 左右方向 | ||
cwmDirectionVert | 3 | 上下方向 |
[復帰値]
ブール型 | |
True | 正常 |
False | 異常 |