SharperCV リファレンス日本語訳

Translated by Yuuki Uranishi
mail.png(1071 byte)
Updated on July 28, 2007

はじめに

この文書は，OpenCVをC#で使えるようにするためのラッパライブラリ， SharperCVの関数リファレンスを和訳したものです． C#で，さらにコンピュータビジョンをしたい日本語話者向けというドキュメントにどれだけのニーズがあるか分かりませんが， ニーズにがっちりはまる人に関しては役に立つかもしれません．

翻訳者について

翻訳者はOpenCVについての書籍を分担執筆する程度の知識を持つ（やや宣伝です）情報系大学院生，とお考え下さい．っていうかそのものです． 英語力は推して知るべしなので，内容，翻訳ともに信頼度があまり高くないということになってしまいそうですが．

バグ報告，質問，その他連絡について

このドキュメントにどれだけバグがあるか分かりません． そしてそのバグは，翻訳に起因するものと原文に起因するものがあります． 翻訳によるバグは対応させていただきますが，原文に起因するものはどうしようもありませんのでご了承ください （何せもとのSharperCVの更新が止まっていますから）． 僕がC#にもう少し詳しくなればSharperCVの後継を作成するかもしれません． ちなみに，このドキュメントはCSSの勉強も兼ねているということもあり， 本人としては厳密にCSSを書いたつもりです． 見栄えの問題よりもむしろ，grepとかで関数リストを一発作成したりしたいなあ…という動機が存在します． なお，このスタイルシートが使いたい人（たとえば，何かのリファレンスをどうにかしたい人）は 基本的に自由に使っていただいて結構ですが， ご連絡いただけると嬉しいです． And of course, I accept English questions and comments. But I think there are no questions in English, because this document is Japanese-localised :)

Namespace: SharperCV

AVIWriter クラス

コンストラクタ: AVIWriter (String fileName, int fourcc, double fps, CvSize frameSize)

概要 AVIをファイルに書き出すクラスAVIwriterを生成する．
引数 意味
filename 書き出すファイルの名前
fourcc CODECを指定するための4文字コード
fps 1秒あたりのフレーム数
frameSize 各フレームのサイズ

メソッド: int WriteFrame (CvImage image)

概要 フレーム画像をAVIWriterへ書き込む．
引数 意味
image 書き込みたい画像
戻り値 原語説明なし．

CvCapture クラス

コンストラクタ: CvCapture (String fileName)

概要 カラーAVI画像を開く．
引数 意味
filename 開きたいAVIファイルのフルパスとファイル名

コンストラクタ: CvCapture (String fileName, bool wantsGrey)

概要 AVI画像を開く．
引数 意味
filename 開きたいAVIファイルのフルパスとファイル名
wantsGrey グレースケール画像を得たい場合はtrueとする

コンストラクタ: CvCapture (int cameraIndex)

概要 カメラからカラー画像をキャプチャするためのクラスを生成する．
引数 意味
cameraIndex カメラのインデックス．とくに指定しない場合は`-1'とする

コンストラクタ: CvCapture (int cameraIndex, bool wantsGray)

概要 カメラから画像をキャプチャするためのクラスを作成する．
引数 意味
cameraIndex カメラのインデックス．とくに指定しない場合は`-1'とする
wantsGrey グレースケール画像を得たい場合はtrueとする

メソッド: void Close ()

概要 コンストラクタで指定したAVIあるいはカメラを解放する．
引数 意味
なし
戻り値 なし．

メソッド: void GrabFrame ()

概要 内部的にフレーム画像を取得する，おそらく圧縮されている． これを戻り値としてはならない （訳者注・圧縮されているため，SharperCVにおける画像フォーマットの体を成していないと考えられる）．
引数 意味
なし
戻り値 なし．

メソッド: CvImage QueryFrame ()

概要 フレーム画像を取得，復号の後出力する （訳者注・GrabFrame()の直後にRetrieveFrame()を実行するのと等価）．
引数 意味
なし
戻り値 取得されたフレーム画像．

メソッド: CvImageRetrieveFrame ()

概要 あらかじめ取得された画像について，復号の後出力する．
引数 意味
なし
戻り値 取得されたフレーム画像．

cvContour クラス

メソッド: double ContourArea ()

概要 輪郭の大きさを返す．
引数 意味
なし
戻り値 輪郭の大きさ．

メソッド: ☆void draw (CvImage targetImg, CvColor externalColor, CvColor holeColor, int thickness, int connectivity)

概要 インスタンスが保持している輪郭を描画する．
引数 意味
targetImg 書き込みたい対象画像
externalColor 外郭を表す輪郭線を描画する色
holeColor 穴を表す輪郭線を描画する色
thickness 描画する線の太さ．`-1'とすると塗りつぶす
connectivity （訳者注・要調査）
戻り値 なし．

cvContoursBase クラス

メソッド: void draw (CvImage targetImg, CvColor externalColor, CvColor holeColor, int maxlevel, int thickness, int connectivity)

概要 輪郭線を描画する．
引数 意味
targetImg 輪郭を書き込みたい対象画像
externalColor 外郭を表す輪郭線を描画する色
holeColor 穴を表す輪郭線を描画する色
maxlevel 木構造で表現された輪郭の中で描画される最高のレベル
thickness 描画する線の太さ．`-1'とすると塗りつぶす
connectivity （訳者注・要調査）
戻り値 なし．

CvHistogram クラス

コンストラクタ: CvHistogram (int[] dims, float[][] ranges, bool uniform)

概要 ヒストグラムクラスを生成する． 次元の数はdimsの要素数から推定される．
引数 意味
dims ヒストグラムの次元の数（一般的な横軸方向の要素数）
ranges 各次元がとりうる値の範囲
uniform ヒストグラムが一様に分布するかを示すフラグ． trueならば，ranges[0][0]からranges[0][1]の範囲を等しくdims個に分割する． falseならば，1つ目の次元はranges[0][0]からranges[0][1]まで， 2つ目はranges[1][0]からranges[1][1]まで…のようになる

メソッド: void CalcBackProject (CvImage[] imgs)

概要
引数 意味
imgs
戻り値 なし．

メソッド: CalcBackProjectPatch (CvImage[] imgs, CvImage dest, CvSize patchSize, CvCompareMethod method, double normFactor)

概要 Locates a template within image by histogram comparison
引数 意味
imgs Source images
dest Destination image
patchSize Size of patch slid though the source image
method Compasion method, passed to CompareHist (see description of that function)
normFactor Normalization factor for histograms, will affect normalization scale of destination image, pass 1. if unsure.
戻り値 なし．

Class: CvHistogram

Class: CvImage

Class: CvMat

Class: CvPoint

Class: CvPoint2D32f

Class: CvRect

Class: CvScalar

Class: CvSeq

Class: CvSize

Class: CvTermCriteria

Class: CvWindow

Class: PointSetD

Class: VertexContour

Class: VertexContours

NameSpace: SharperCV.Haar

Class: ClassifierCascade

Class: HiddenClassifierCascade

NameSpace: SharperCV.Trackers

Class: LkTracker