ライブラリの使用方法、VisualStudioの設定方法

メインページ＞ C++/CLI プログラミング

最近、OpenCVやOpenGL、DirectShowなどのライブラリを使う機会が増えてきたので、ライブラリの使い方をまとめておきます。

ライブラリと一言いっても、スタティックライブラリ、ダイナミックライブラリ、.NETのクラスライブラリなどとあるのですが、比較的一般的？なダイナミックライブラリの使用方法を紹介します。

ダイナミックライブラリを使用するには、下記の３点セットが必要となります。

ダイナミックリンクライブラリファイル(*.dll)
ライブラリファイル(*.lib)
ヘッダファイル（インクルードファイル）(*.h)

各ライブラリで何のファイルが必要かは調べて置いて下さい。
*.dllファイルはプログラムの実行時、*.lib、*.hファイルはプログラミング中に必要となります。
また、ライブラリのバージョン、Release用/Debug用とでファイルが異なる場合もあります。

ライブラリを使用するための設定方法もいくつかあるので、私の思う一般的な方法は以下の通りです。

ダイナミックライブラリファイル(*.dll)の参照設定方法

ライブラリをインストールし、*.dllファイルがインストールされたパスを環境変数のPathに設定します。
※このPathの設定はライブラリのインストーラにより自動的に設定される場合もあります。

設定方法は、スタートメニューから、コンピュータを右クリックし、プロパティを選択します。

ライブラリの使用方法、Visual Studioの設定方法

次に表示されたウィンドウのシステムの詳細設定をクリック

ライブラリの使用方法、Visual Studioの設定方法

詳細設定のタブを選択し、右下の環境変数のボタンをクリック

ライブラリの使用方法、Visual Studioの設定方法

すると下図のように××のユーザー環境変数とシステム環境変数と２種類表示され、両方ともにPathの項目があるのですが、××のユーザー環境変数のPathを設定するとWindowsにログインしたときのユーザーのみでPathの設定が有効となり、システム環境変数のPathを設定すると全ユーザーでPathの設定が有効となります。
私は『ログインしたユーザーを変えるとプログラムが起動しないんだけど？！』とか言われたく無いので、システム環境変数のPathを設定するようにしています。
そして、Pathの項目を選択し、編集ボタンをクリックします。

ライブラリの使用方法、Visual Studioの設定方法

そして、編集値の欄に*.dllファイルがインストールされているパス（フォルダ名のフルパス）をセミコロン（;）に続けて記載します。

（例）
;C:\Program Files\OpenCV\lib

ライブラリの使用方法、Visual Studioの設定方法

また、この*.dllファイルのパスは必ずしも設定する必要はなく、プログラム（*.exe）のある同一フォルダやC:\Windows\System32フォルダ内に*.dllファイルを入れておくだけでも大丈夫なのですが、プログラムから*.dllファイルを参照するときの優先順位は下記のようになっています。

アプリケーション(*.exe)と同じフォルダ
カレントディレクトリ
システムディレクトリ（C:\Windows\System32 など）
16Bitシステムディレクトリ（C:\Windows\System など）
Windowsディレクトリ（C:\Windows など）
PATH環境変数に列挙されているディレクトリ

ライブラリファイル(*.lib)の参照設定方法

各ライブラリにおいて、どの*.libファイルが必要なのかは調べておき、それぞれのファイルの参照設定を行います。

まずは、*.libファイルが入っているパスの参照設定を行います。
メニューのプロジェクト→（プロジェクト名）のプロパティをクリックします。

ライブラリの使用方法、Visual Studioの設定方法

開いたウィンドウの構成のプロパティ→リンカ→全般を選択し、追加のライブラリディレクトリにそのまま、*.libファイルのあるパスを設定するか、右側にある・・・のボタンをクリックします。

ライブラリの使用方法、Visual Studioの設定方法

すると追加のライブラリディレクトリのウィンドウが表示されるので、・・・のボタンをクリックし、フォルダのボタンをクリックして*.libファイルのあるフォルダを指定します。

ライブラリの使用方法、Visual Studioの設定方法

ライブラリによっては、参照する順番を指定しなければならない物もあるので、その場合は右上にある　↓　↑　ボタンで順番を入れ替えます。

次に実際に使用する*.libファイルを設定します。
構成のプロパティ→リンカ→入力の追加の依存ファイルの部分に*.libファイルを入力します。
必要な*.libファイルがある場合は、空白（スペース）で区切って入力します。

ライブラリの使用方法、Visual Studioの設定方法

他にもプログラム中で*.libファイルを直接していする事もできます。

例）
#pragma comment(lib,"C:\\Program Files\\OpenCV\\lib\\cv.lib")

インクルードファイル(*.h)の参照設定方法

インクルードファイル（ヘッダファイル）(*.h)のあるパスを設定します。
設定方法は
メニューのプロジェクト→（プロジェクト名）のプロパティをクリックします。

構成プロパティ→C/C++→全般の追加のインクルードディレクトリの欄の右側にある・・・ボタンをクリックします。

ライブラリの使用方法、Visual Studioの設定方法

ヘッダファイルのパスを追加設定するには右上のフォルダのアイコンをクリックします。

ライブラリの使用方法、Visual Studioの設定方法

ボタンをクリックすると、・・・のボタンをクリックすると、ディレクトリの選択のウィンドウが表示されるので、*.hファイルが入っているパスを設定します。

ライブラリの使用方法、Visual Studioの設定方法

そして、プログラム中では

#include <cv.h>

のように設定します。

C++/CLIからライブラリを使用する場合

.NETで作られたライブラリでは無いライブラリを使う場合は、メニューのプロジェクト→（プロジェクト名）のプロパティをクリック、構成プロパティ→全般の共通言語ランタイムサポートの欄を

純粋MSIL共通言語ランタイムサポート（/clr:pure）
から
共通言語ランタイムサポート（/clr）
に変更します。

ライブラリの使用方法、Visual Studioの設定方法

その他

*.libファイル、*.hファイルの設定にはDebug用とRelease用の設定がそれぞれありますので、両方設定して下さい。
DebugとReleaseとで設定するファイル名が異なる場合もあるのでご注意下さい。

ライブラリの使用方法、Visual Studioの設定方法

また、メニューのツール→オプションで表示されたウィンドウのプロジェクトおよびソリューション→VC++ディレクトリで、インクルードファイル（*.h）、ライブラリファイル(*.lib)の参照ディレクトリの設定が可能です。（VS2010は非推奨）
逆に言うと、ここに設定されているフォルダにインクルードファイル（*.h）やライブラリファイル(*.lib)を置いても参照する事が可能です。（個人的にはあまりやりませんが．．．）

ライブラリの使用方法、Visual Studioの設定方法

トラブルシューティング

LINK : fatal error LNK1104: ファイル '×××.lib' を開くことができません。
fatal error C1083: include ファイルを開けません。'cv.h': No such file or directory
*.libファイル、*.hファイルが指定したフォルダに存在しているか？
また、*.libファイル、*.hのファイル名が正しいか？
確認してみて下さい。
fatal error C1189: #error : ERROR: EMM intrinsics not supported in the pure mode!
共通言語ランタイムサポートの設定を/clr:pureから/clrに変更して下さい。

【2010/06/13 01:20】 | C++/CLI | TRACKBACK(1) | COMMENT(4) |

<<【C++/CLI】大文字/小文字、全角/半角、ひらがな/カタカナ変換 | BLOG TOP | Visual Studio 2010 パッケージ版　6月18日発売！>>

この記事に対するコメント

いつも、関数上で右ボタン→『定義へ移動』でソースを見てました。
F12の方が速い！！！
参考になりました。

【2010/06/15 23:30】 URL | Akira #- [ 編集]

たしかに「正しい」というのは語弊があったかもしれません。
好みや効率がいいものが採用されるのが望ましいですね。
人によってインストールディレクトリなどが異なる場合やバッチで環境変数などを設定するルールになっているプロジェクトなどでは[ツール]-[オプション]..の必要はないわけで。

余談ですが、一応「プロジェクトおよびソリューション」でDLL、LIB、ヘッダ、ソースのディレクトリは設定できるはずです。F12でOpenCVのソースまで飛べるようになります。。。

【2010/06/15 23:16】 URL | alt-native #- [ 編集]

コメント頂きありがとうございます。
alt-nativeさんのHPも拝見させて頂いております。
ライブラリパスの設定ですが、いろんな流儀があって、私も、どの設定が正しいのかは分かっていませんが、『プロジェクトおよびソリューション』での設定が正しいのですか…
個人的にはプロジェクトファイルを他の人に渡した時でもパスの設定をしなくても済むようにプロジェクトに設定した方が良いのではないか？と思っています。
と言っても*.dllファイルのパスの設定も必要になったりもするので、結局は好みじゃないでしょうかね？

【2010/06/15 21:11】 URL | Akira #- [ 編集]

ライブラリパスの設定について
Visual Studio 2005/2008では
[ツール]-[オプション]-[プロジェクトおよびソリューション]-[ディレクトリ]で設定するのが正しい手続きかと思われます。
Visual Studio 2010ではプロジェクト自体に設定するようですが

【2010/06/15 08:43】 URL | alt-native #- [ 編集]

この記事に対するコメントの投稿

| BLOG TOP |

この記事に対するトラックバック

トラックバックURL
→http://imagingsolution.blog107.fc2.com/tb.php/231-75dea508
この記事にトラックバックする(FC2ブログユーザー)

[思った]Jun. 19, Sat. 久しぶりの更新

昨日、仕事が終わって一日で書いたソースコードをステップ数カウンタにかけたら２キロステップ(C++)あった。それでも見積もりどおりならあと１０キロコーディングしなきゃ。あと５日で。納期まで時間が足りないとき、皆さんはどうしますか？新しい「MS Office クリップア alt-ctrl-today【2010/06/19 15:16】