Copy DeploymentによるFramegrabber SDKのインストール#

コピーデプロイメントでは、Framegrabber SDK インストールから個々のコンポーネントを任意のディレクトリにコピーします。これにより、ユーザーアプリケーションとともに配布するパッケージを制御または削減できます。

コピーによって Framegrabber SDK をデプロイする場合、Framegrabber SDK のすべての機能とツールを使用することはできませんのでご注意ください。

前提条件#

Framegrabber SDKをインストールするには、管理者権限を持つPCが必要です。以下の手順では、このPCをソースPCと呼びます。
BaslerウェブサイトからBasler Framegrabber SDKをダウンロードし、ソースPCにインストールします。
ソース PC で Framegrabber SDK ベースのアプリケーションを実行しない場合は、インストール時にすべてのオプションの選択を解除できます。これにより、ドライバーのインストールや、環境変数またはレジストリの変更を回避できます。
コピーデプロイメント用のファイルを準備しているだけなので、Framegrabber SDK のインストール後にソース PC の再起動を求められた場合は無視して構いません。
The installation folder into which you have installed the Framegrabber SDK, is called <SDKRoot> in the following instructions.
MicrosoftからVisual Studio 2015、2017、2019、または2022用のMSVC再頒布可能パッケージをダウンロードし、ソースPCにインストールします。
コピーデプロイメント用のファイルを準備しているだけなので、Visual Code のインストール後にソース PC の再起動を求められた場合は無視して構いません。
ソース PC 上でコピーデプロイメント用の次のフォルダー階層を作成します：
```
FramegrabberSDK
├───bin
├───dll
├───drivers
└───lib
```

This folder structure is called SDK package in the following instructions. Its root folder FramegrabberSDK is called <packageRoot>.

パッケージの作成#

パッケージの主要部分の作成#

このセクションでは、Framegrabber SDK の主要部分、つまりどのフレームグラバーを使用するかにかかわらず常に必要となる部分をコピーする手順について説明します。

Copy the following files from <SDKRoot> into the corresponding folder inside <packageRoot>:

<SDKRoot>
└───bin
    ├───fglib5.dll
    ├───siso_hal.dll
    ├───siso_hw.dll
    ├───haprt.dll
    ├───iolibrt.dll
    └───logging-context.dll

次の場所から次のファイルをコピーします C:\Windows\system32 を \bin:

Windows
└───system32
    ├───vcruntime140.dll
    ├───vcruntime140_1.dll
    └───msvcp140.dll

フレームグラバーのサポートの追加#

mE5 marathon#

Copy the following folders and files from <SDKRoot> to the corresponding folders in <packageRoot>:

<SDKRoot>
├───bin
|   └───GrabberFirmwareFlasher.exe
├───drivers
|   └───me5
│       ├───me5.cat
│       ├───me5.inf
│       ├───me5.sys
│       └───WdfCoInstaller01009.dll
└───lib
    └───siso_hw_me5.dll

Copy the applet folders and files for your application from <SDKRoot>\dll\<board-type> to the corresponding folders in <packageRoot>:

<SDKRoot>
└───dll
    ├───mE5-MA-ACL
    ├───mE5-MA-ACX-DP
    ├───mE5-MA-ACX-QP
    ├───mE5-MA-ACX-SP
    ├───mE5-MA-VCL
    ├───mE5-MA-VCLx
    └───mE5-MA-VCX-QP

Optionally: Copy your applets designed with VisualApplets to <packageRoot>\Hardware Applets<board-type>.

imaFlex / imaWorx / インターフェースカード#

Copy the following folders and files from <SDKRoot> to the corresponding folders in <packageRoot>:

<SDKRoot>
├───bin
|   └───GrabberFirmwareUpdater.exe
├───drivers
|   └───me6
│       ├───basler_ic.cat
│       ├───basler_ic.inf
│       ├───basler_ic.sys
│       └───WdfCoInstaller01009.dll
└───lib
    └───siso_hw_me6.dll

アプリケーションのアプレットフォルダとファイルを次の場所からコピーします \dll<board-type> to the corresponding folders in <packageRoot>:

<SDKRoot>
└───dll
    ├───CXP12-IC-1C
    │   ├───S1.1
    │   └───S1.2
    ├───CXP12-IC-2C
    │   └───S1.0
    ├───CXP12-IC-4C
    │   └───S1.0
    ├───iF-CXP12-P
    │   └───S1.1
    ├───iF-CXP12-Q
    │   └───S2.0
    └───iW-CXP12-Q
        └───S1.0

Optionally: Copy your applets designed with VisualApplets to <packageRoot>\Hardware Applets<board-type>

カメラプロトコルのサポートの追加#

CoaXPress#

If you use a CoaXPress frame grabber in your project, copy the following files from <SDKRoot> to the corresponding folders in <packageRoot>:

    <SDKRoot>
    └───bin
        ├───GCBase_MD_VC141_v3_1_Basler_pylon_v3.dll
        ├───GenApi_MD_VC141_v3_1_Basler_pylon_v3.dll
        ├───Log_MD_VC141_v3_1_Basler_pylon_v3.dll
        ├───MathParser_MD_VC141_v3_1_Basler_pylon_v3.dll
        ├───NodeMapData_MD_VC141_v3_1_Basler_pylon_v3.dll
        ├───siso_genicam.dll
        └───XmlParser_MD_VC141_v3_1_Basler_pylon_v3.dll

Camera Link#

If you use a Camera Link frame grabber in your project, copy the following files from <SDKRoot> to the corresponding folders in <packageRoot>:

    <SDKRoot>
    └───bin
        ├───clsersis.dll
        └───clshell.exe

GenTL#

To use the GenTL producer, copy the following files from <SDKRoot> to the corresponding folders in <packageRoot>:

<SDKRoot>
└───bin
    ├───GCBase_MD_VC141_v3_1_Basler_pylon_v3.dll
    ├───GenApi_MD_VC141_v3_1_Basler_pylon_v3.dll
    ├───Log_MD_VC141_v3_1_Basler_pylon_v3.dll
    ├───MathParser_MD_VC141_v3_1_Basler_pylon_v3.dll
    ├───NodeMapData_MD_VC141_v3_1_Basler_pylon_v3.dll
    └───XmlParser_MD_VC141_v3_1_Basler_pylon_v3.dll

To use the CXP GenTL producer, copy the following files from <SDKRoot> to the corresponding folders in <packageRoot>:
```
<SDKRoot>
└───bin
    ├───ProducerCXP.cti
    └───siso_genicam.dll
```

To use the Camera Link GenTL producer, copy the following files from <SDKRoot> to the corresponding folders in <packageRoot>:

<SDKRoot>
└───bin
    ├───BaslerCLProtocol.dll
    ├───CLAllSerial_MD_VC141_v3_1_Basler_pylon_v3.dll
    ├───CLProtocol_MD_VC141_v3_1_Basler_pylon_v3.dll
    ├───clsercom.dll
    ├───clsersis.dll
    ├───GenCP_MD_VC141_v3_1_Basler_pylon_v3.dll
    └───ProducerCL.cti

ツールの追加#

gpioTool#

If you want to use the gpioTool in your project, copy the following files from <SDKRoot> to the corresponding folders in <packageRoot>:

    <SDKRoot>
    └───bin
        ├───siso_auxport.dll
        └───gpioTool.exe

ロギング#

To get logging output from a running Framegrabber SDK application, e.g. in log files or by attaching the pylon Event Logger, copy the following files from <SDKRoot> to the corresponding folders in <packageRoot>:

<SDKRoot>
└───bin
    ├───common-logging-dispatcher.dll
    ├───common-logging-log4cpp.dll
    ├───BaslerFgSdkLogging.properties
    ├───GCBase_MD_VC141_v3_1_Basler_pylon_v3.dll
    ├───Log_MD_VC141_v3_1_Basler_pylon_v3.dll
    └───log4cpp_MD_VC141_v3_1_Basler_pylon_v3.dll

最後の2つのライブラリについては、デプロイするFramegrabber SDKのバージョンに応じて、バージョンサフィックス（ここでは_v3）が異なる場合や省略されている場合があることに注意してください。

ログの設定方法の詳細については、ログメッセージシステムを参照してください。

Cognex VisionPro#

Basler グラバーカードで Cognex VisionPro Adapter を使用するには、次の手順に従います。

Framegrabber Runtime 5.7をダウンロードし、ソースPCにインストールします。
インストーラーを実行するときは、次のオプションを選択またはオフにしてください:
- [コンポーネントの選択]ダイアログで、Cognex Adapterを選択します。
- ペインの 追加タスクの選択 ダイアログ:
  - [デバイスドライバの更新]と[環境変数の更新]のチェックを外します。
- レジストリが変更されていないことを確認します:
  - [Select Start Menu Folder]ダイアログで、[Don't create a start menu folder]を選択します。
  - [Select Additional Tasks]ダイアログで、[Desktop icon]、[Activate Virtual COM Port]、および[Always Run COMWrapper Autorun at System Start]のチェックを外します。
Copy the file SisoCognexAdapter.dll from the bin folder of the Runtime 5.7 installation to <packageRoot>\bin.

パッケージのデプロイ#

必須コンポーネントのデプロイ#

コピーしたバージョンの Framegrabber SDK をターゲットPCに展開するには:

SDKパッケージをターゲットPCにコピーします。
Framegrabber SDKのドライバーをインストールします。
環境変数を設定します BASLER_FG_SDK_DIR to the full path of the <packageRoot> folder.
SDKパッケージの bin フォルダーを次の場所に追加します: PATH 環境変数に追加します。

Cognex VisionPro Adapterのデプロイ#

ターゲットPCでCognex VisionPro Adapterを使用するには、Cognex VisionPro Adapterのマニュアルの「Installing the Adapter Manually」の章を参照してください。