このページの一部は機械翻訳であり、まだ人による確認が行われていません。

GPU について

Zivid SDK を最適に実行するには、ホストマシンに GPU が必要です。統合 GPU と専用 GPU はどちらも Zivid で適切に動作しますが、パフォーマンスの違いはキャプチャ時間にあります。

GPU 要件

Windows

最適なパフォーマンスを得るには、専用 GPU または統合 GPU に少なくとも 3 GB の RAM が使用可能である必要があります。さらに、Zivid を使用するには、GPU 用の CUDA (12 以降) または OpenCL ドライバー (1.2 以降) のいずれかが必要です。 Zivid Studio または SDK 内のビジュアライザーを使用するには、GPU 用の OpenGL ドライバー (3.0 以降) も必要です。これは通常 GPU ドライバーと一緒にインストールされますが、古いドライバーでは 3.0 未満のバージョンが使用されている場合があります。お使いの GPU に応じて、以下の手順に従ってください。

Intel

OpenCL ドライバーは通常、グラフィックスドライバーと一緒にインストールされ、Windows にはすでにインストールされているはずです。使用している GPU ドライバーを確認したい場合は、下のドロップダウンを使用してください。そうでない場合は、 Intel から最新のグラフィックスドライバーをダウンロードしてインストールします。

GPU ドライバーの確認

Intel Driver & Support assistant を使用してドライバーのバージョンを自動的に検出するか、以下の手順に従って手動で見つけます。

Intel Driver & Support Assistant のスクリーンショット 「Intel Driver & Support Assistant」のグラフィックスペインのスクリーンショット
  1. Start → Control Panel

  2. リストから Device Manager を選択します (必要に応じて View を Small Icons に切り替えます)

  3. Display Adapter セクションを展開し、 Intel® Display Adapter を右クリックして Properties を選択します。

  4. Driver タブに移動し、表示されている Driver Version を確認します。

    Windows 上の Intel グラフィックスカードのドライバープロパティのスクリーンショット。

グラフィックスドライバーをインストールした後、 Zivid Studio を開き、OpenCL エラーが発生しないことを確認します。

NVIDIA

注釈

CUDA バックエンドには、コンピュートキャパビリティ 6.1 以上の NVIDIA GPU が必要です。この要件が満たされていない場合、SDK は例外をスローします。

検出されたコンピュートキャパビリティ X.Y はサポートされていません。 サポートされているバージョン: (6.1, 7.0, 7.5, 8.0, 8.6)

The listed versions are the compute capabilities the installed package was built for. GPUs with a newer compute capability, such as Ada Lovelace (8.9) or Blackwell (12.0), are also supported. The package includes PTX code that the GPU driver compiles for the local hardware on first use. Setting AllowUnsupported does not make the CUDA backend work below this minimum. The packages contain no code for older architectures, so the capture fails later instead.

OpenCL バックエンドには実質的な制限がありません。OpenCL ドライバーを搭載するのに十分新しい NVIDIA カードであれば、すべて OpenCL 1.2 のサポートを備えています。SDK にはコンピュートキャパビリティ 3.5 という下限がありますが、OpenCL の要件を満たすドライバーでこれを下回るものはありません。したがって、6.1 未満の GPU は OpenCL バックエンドでは動作しますが、CUDA バックエンドでは動作しません。OpenCL 版の SDK は、Config.yml ファイルで サポートされていないコンピューティングデバイス を有効にするまで、コンピュートキャパビリティに関係なくすべての NVIDIA GPU を拒否することに注意してください。

NVIDIA GPU とそれに対応するコンピュート能力の概要については、https://developer.nvidia.com/cuda-gpus を参照してください。

CUDA

The CUDA backend requires an NVIDIA driver that supports CUDA 12 or newer. On Windows, this means driver version 527.41 or newer. For GPUs released after the installed driver, install the latest driver from NVIDIA to ensure the driver recognizes the GPU.

OpenCL

OpenCL ドライバーは通常、グラフィックスドライバーと一緒にインストールされます。

警告

OpenCL 版の SDK は、NVIDIA GPU を サポートされていないコンピューティングデバイス として扱います。OpenCL 版の SDK をインストールした後、これを許可するように Config.yml ファイルを編集する必要があります。そうしないと、SDK はエラーで失敗します。Zivid は、追加の設定が不要な CUDA 版のインストールを推奨します。

使用している GPU ドライバーを確認したい場合は、下のドロップダウンを使用してください。そうでない場合は、GPU に関連するグラフィックスドライバーを NVIDIA からダウンロードしてインストールします。

GPU ドライバーの確認

NVIDIA Smart Scan を使用してドライバーのバージョンを自動的に検出するか、以下の手順に従って手動で見つけます。

  1. NVIDIA Control Panel を開きます ( Desktop を右クリックします)。

  2. System Information (左下隅) をクリックします。

  3. Details セクションの Driver version を確認します。

    Windows 上の NVIDIA システム情報のスクリーンショット。

グラフィックスドライバーをインストールした後、 Zivid Studio を開き、エラーが発生しないことを確認します。

AMD

警告

SDK 2.10 以降、ドライバーの OpenCL 安定性の問題により AMD のサポートは削除されました。Config.yml ファイルでオプションを有効にすることで、 サポートされていないコンピューティングデバイスで SDK を実行するように選択する ことが可能です。ただし、このような設定では予期しない結果やエラーが発生する可能性があり、Zivid によるテストは行われていません。

警告

Radeon は一部の GPU で SPIR をサポートしなくなりました。Zivid と互換性があるために、GPU ドライバーが SPIR をサポートしていることを確認してください。

OpenCL ドライバーは通常、グラフィックスドライバーと一緒にインストールされます。使用している GPU ドライバーを確認したい場合は、下のドロップダウンを使用してください。そうでない場合は、GPU に関連するグラフィックスドライバーを AMD からダウンロードしてインストールします。

GPU ドライバーの確認

AMD Driver Auto-detect tool を使用してドライバーのバージョンを自動的に検出するか、以下の手順に従って手動で見つけます。

  1. AMD Radeon Settings を開きます ( Desktop を右クリックします)。

  2. System をクリックして、システムの概要、ソフトウェアおよびハードウェアの詳細にアクセスします。

  3. インストールされているグラフィックスドライバーの詳細については Software タブを選択してください。 Driver Packaging Version を確認してください。

Windows 上の AMD システム情報のスクリーンショット。

グラフィックスドライバーをインストールした後、 Zivid Studio を開き、OpenCL エラーが発生しないことを確認します。

上記の OpenCL または CUDA ドライバーに加えて、Zivid Studio と SDK のビジュアライザーには OpenGL ドライバーも必要です。

OpenGL ドライバーの確認
  1. OpenGL Extensions Viewer をダウンロードします。

  2. インストールして起動し、OpenGL のバージョンを確認します。

バージョンが 3.0 未満の場合は、上記の GPU の手順に従って最新の GPU ドライバーをインストールする必要があります。

Ubuntu

最適なパフォーマンスを得るには、専用 GPU または統合 GPU に少なくとも 3 GB の RAM が使用可能である必要があります。さらに、Zivid を使用するには、GPU 用の CUDA (12 以降) または OpenCL ドライバー (1.2 以降) のいずれかが必要です。 Zivid Studio または SDK 内のビジュアライザーを使用するには、GPU 用の OpenGL ドライバー (3.0 以降) も必要です。これは通常 GPU ドライバーと一緒にインストールされますが、古いドライバーでは 3.0 未満のバージョンが使用されている場合があります。お使いの GPU に応じて、以下の手順に従ってください。

Intel

Intel 用のグラフィックスドライバーは Ubuntu にすでにインストールされている必要がありますが、OpenCL ドライバーは必ずしもインストールされている必要はありません。グラフィックスドライバーが存在するかどうかを確認したい場合は、下のドロップダウンを使用してください。

GPU ドライバーの確認

キーボードの Ctrl + Alt + T キーを押してターミナルウィンドウを開き、ドライバーが存在するかどうかを確認します。

lspci -k | grep -EA3 'VGA|3D|Display'

詳細については、公式の Intel pages を参照してください。

  1. キーボードの Ctrl + Alt + T キーを押してターミナルウィンドウを開き、OpenCL ドライバーをインストールします。

    Ubuntu 26.04
    sudo apt update
    sudo apt install intel-opencl-icd
    
    Ubuntu 24.04
    sudo apt update
    sudo apt install intel-opencl-icd
    
    Ubuntu 22.04
    sudo apt update
    sudo apt install intel-opencl-icd
    
    Ubuntu 20.04
    sudo apt update
    sudo apt install intel-opencl-icd
    
    Ubuntu 18.04

    注釈

    Ubuntu 18.04 のサポートは SDK 2.10 以降削除されました。以前の SDK バージョンの Ubuntu 18.04 の手順を確認するには、左上隅にあるナレッジベースのバージョンを変更します。

  2. Zivid Studio を開き、OpenCL エラーが発生しないことを確認します。

注釈

OpenCL エラーが発生した場合は、 ユーザーをグループ Video に追加する 必要がある場合があります。

NVIDIA

注釈

CUDA バックエンドには、コンピュートキャパビリティ 6.1 以上の NVIDIA GPU が必要です。この要件が満たされていない場合、SDK は例外をスローします。

検出されたコンピュートキャパビリティ X.Y はサポートされていません。 サポートされているバージョン: (6.1, 7.0, 7.5, 8.0, 8.6)

The listed versions are the compute capabilities the installed package was built for. GPUs with a newer compute capability, such as Ada Lovelace (8.9) or Blackwell (12.0), are also supported. The package includes PTX code that the GPU driver compiles for the local hardware on first use. Setting AllowUnsupported does not make the CUDA backend work below this minimum. The packages contain no code for older architectures, so the capture fails later instead.

OpenCL バックエンドには実質的な制限がありません。OpenCL ドライバーを搭載するのに十分新しい NVIDIA カードであれば、すべて OpenCL 1.2 のサポートを備えています。SDK にはコンピュートキャパビリティ 3.5 という下限がありますが、OpenCL の要件を満たすドライバーでこれを下回るものはありません。したがって、6.1 未満の GPU は OpenCL バックエンドでは動作しますが、CUDA バックエンドでは動作しません。OpenCL 版の SDK は、Config.yml ファイルで サポートされていないコンピューティングデバイス を有効にするまで、コンピュートキャパビリティに関係なくすべての NVIDIA GPU を拒否することに注意してください。

NVIDIA GPU とそれに対応するコンピュート能力の概要については、https://developer.nvidia.com/cuda-gpus を参照してください。

CUDA

The CUDA backend requires an NVIDIA driver that supports CUDA 12 or newer. For GPUs released after the installed driver, install the latest driver from the PPA below to ensure the driver recognizes the GPU.

OpenCL

NVIDIA 用の OpenCL ドライバーは、グラフィックスドライバーと一緒にインストールされます。

警告

OpenCL 版の SDK は、NVIDIA GPU を サポートされていないコンピューティングデバイス として扱います。OpenCL 版の SDK をインストールした後、これを許可するように Config.yml ファイルを編集する必要があります。そうしないと、SDK はエラーで失敗します。Zivid は、追加の設定が不要な CUDA 版のインストールを推奨します。

使用しているグラフィックスドライバーが存在するかどうかを確認したい場合は、下のドロップダウンを使用してください。または、そのままお使いのシステム用の最新ドライバーをインストールしてください。

GPU ドライバーの確認

キーボードの Ctrl + Alt + T キーを押してターミナルウィンドウを開き、次のコマンドを実行します。

nvidia-smi

これにより、ドライバーのバージョンが出力されます。

  1. NVIDIA GPU ドライバー PPA をシステムに追加します。

    キーボードの Ctrl + Alt + T キーを押してターミナルウィンドウを開き、グラフィックスドライバー PPA を追加します。

    sudo add-apt-repository ppa:graphics-drivers/ppa
    

    これにより、 nvidia-xxx としてパッケージ化された最新の長期サポートドライバーリリースが、次のステップでインストール可能になります。

  2. システムの最新ドライバーをインストールします。

    Ubuntu 26.04
    sudo apt update
    sudo apt install nvidia-driver-xxx
    
    Ubuntu 24.04
    sudo apt update
    sudo apt install nvidia-driver-xxx
    
    Ubuntu 22.04
    sudo apt update
    sudo apt install nvidia-driver-xxx
    
    Ubuntu 20.04
    sudo apt update
    sudo apt install nvidia-driver-xxx
    
    Ubuntu 18.04

    注釈

    Ubuntu 18.04 のサポートは SDK 2.10 以降削除されました。以前の SDK バージョンの Ubuntu 18.04 の手順を確認するには、左上隅にあるナレッジベースのバージョンを変更します。

    ドライバーをインストールした後、システムを再起動します。

    sudo reboot
    
  3. Zivid Studio を開き、OpenCL エラーが発生しないことを確認します。

注釈

OpenCL エラーが発生した場合は、 ユーザーをグループ Video に追加する 必要がある場合があります。

AMD

警告

SDK 2.10 以降、ドライバーの OpenCL 安定性の問題により AMD のサポートは削除されました。Config.yml ファイルでオプションを有効にすることで、 サポートされていないコンピューティングデバイスで SDK を実行するように選択する ことが可能です。ただし、このような設定では予期しない結果やエラーが発生する可能性があり、Zivid によるテストは行われていません。

警告

Radeon は一部の GPU で SPIR をサポートしなくなりました。Zivid と互換性があるために、GPU ドライバーが SPIR をサポートしていることを確認してください。

  1. 正しい Radeon Software for Linux をダウンロード、解凍、インストールします。

    Ubuntu 22.04

    キーボードの Ctrl + Alt + T キーを押してターミナルウィンドウを開き、一時フォルダーを作成します。

    mkdir amd && cd amd
    

    検証済みの動作バージョンである 22.20.3 のドライバーインストーラーパッケージをダウンロードします。

    wget --referer http://support.amd.com http://repo.radeon.com/amdgpu-install/22.20.3/ubuntu/jammy/amdgpu-install_22.20.50203-1_all.deb
    

    注釈

    AMD の release notes page とその /latest パスは、どちらも壊れたインストーラーにリンクしています。代わりに、Zivid が動作を確認済みの上記の固定バージョンを使用してください。

    このパッケージを apt でインストールします。

    sudo apt update
    sudo apt install ./amdgpu-install_22.20.50203-1_all.deb
    

    AMD 独自の手順

    amdgpu-install --usecase=graphics,opencl --no-32 --no-dkms
    

    注釈

    セキュアブートが必要な場合は、DKMS を含める必要がある場合があります (上記のコマンドの --no-dkms を削除します)。詳細については、 secure-boot-support を参照してください。

    次に、ユーザーを render グループと video グループの両方のメンバーとして追加します。

    sudo gpasswd -a $USER render
    sudo gpasswd -a $USER video
    

    変更を有効にするには、再起動が必要な場合があります。

    sudo reboot
    

    これで、 Zivid Studio を開いてみることができます。失敗する場合は、以下のセキュアブート設定の手順に従ってください。

    Ubuntu 20.04

    キーボードの Ctrl + Alt + T キーを押してターミナルウィンドウを開き、一時フォルダーを作成します。

    mkdir amd && cd amd
    

    Linux カーネルのバージョンを確認します。

    uname -r
    
    カーネル 5.4

    Linux カーネルバージョン 5.4 (Ubuntu LTS) の場合は、Ubuntu 20.04 用の Radeon Software 20.45 をダウンロードします。

    wget --referer http://support.amd.com https://drivers.amd.com/drivers/linux/amdgpu-pro-20.45-1188099-ubuntu-20.04.tar.xz
    

    内容を解凍します。

    tar -Jxvf amdgpu-pro-20.45-1188099-ubuntu-20.04.tar.xz
    cd amdgpu-pro-20.45-1188099-ubuntu-20.04
    
    カーネル 5.8

    Linux カーネルバージョン 5.8 (Ubuntu LTS HWE スタック) の場合は、Linux 20.04 用の Radeon Software 20.50 をダウンロードします。

    wget --referer http://support.amd.com https://drivers.amd.com/drivers/linux/amdgpu-pro-20.50-1234664-ubuntu-20.04.tar.xz
    

    内容を解凍します。

    tar -Jxvf amdgpu-pro-20.50-1234664-ubuntu-20.04.tar.xz
    cd amdgpu-pro-20.50-1234664-ubuntu-20.04
    

    AMD 独自の手順 。

    ./amdgpu-pro-install --opencl=pal
    
    Ubuntu 18.04

    注釈

    Ubuntu 18.04 のサポートは SDK 2.10 以降削除されました。以前の SDK バージョンの Ubuntu 18.04 の手順を確認するには、左上隅にあるナレッジベースのバージョンを変更します。

  2. 手順に従ってセキュアブートを設定します (プロンプトが表示された場合)。

    ../../../_images/secure_boot_1.png
    ../../../_images/secure_boot_2.png
    ../../../_images/secure_boot_3.png

    起動できない場合は、 AMD OpenCL ドライバーのインストール後のシステム起動エラー を確認してください。

  3. Zivid Studio を開き、OpenCL エラーが発生しないことを確認します。

注釈

OpenCL エラーが発生した場合は、 ユーザーをグループ Video に追加する 必要がある場合があります。

上記の OpenCL または CUDA ドライバーに加えて、Zivid Studio と SDK のビジュアライザーには OpenGL ドライバーも必要です。

OpenGL ドライバーの確認

キーボードの Ctrl + Alt + T キーを押してターミナルウィンドウを開き、次のコマンドを実行します。

sudo apt install mesa-utils
glxinfo | grep "OpenGL version"

これにより、OpenGL のバージョンが出力されます。

../../../_images/opengl_version_ubuntu_screenshot.png

バージョンが 3.0 未満の場合は、上記の GPU の手順に従って最新の GPU ドライバーをインストールする必要があります。

Nvidia Jetson Linux

Nvidia Jetson Orin と Thor には、CUDA 対応の Nvidia GPU が搭載されています。必要な GPU ドライバーはすべてオペレーティングシステムと一緒にインストールされます。

Zivid Studio と SDK のビジュアライザーにも OpenGL ドライバーが必要です。

OpenGL ドライバーの確認

Jetson Linux には互換性のある OpenGL バージョンが付属しているため、特別な操作は必要ありません。

パフォーマンスに関する考慮事項

専用 GPU

専用 GPU は、Zivid で最高のパフォーマンスを発揮します。また、GPU を Zivid の計算以外にも使用する場合に最適な選択肢です。最適なパフォーマンスを得るには、少なくとも 3 GB のメモリを搭載したミドルレンジからハイエンドの NVIDIA GPU が必要です。これが Zivid にとって望ましいソリューションです。

推奨事項:

  • デスクトップ向けには NVIDIA GeForce GTX 1060 以降

  • ノート PC 向けには NVIDIA GeForce MX150 以降

統合 GPU

これは Zivid にとって最もコスト効率の良いソリューションです。統合 GPU の利点は、GPU から CPU へのデータ転送が高速であることです。また、バッテリー駆動のモバイルプラットフォームなど、低消費電力が求められるアプリケーションにも有利です。最適なパフォーマンスを得るには、少なくとも 3 GB の使用可能なメモリを搭載したハイエンドの統合 GPU が必要です。

推奨事項:

  • HD630 以上を搭載した Intel i7

Nvidia Jetson

Zivid は、Zivid SDK と追加のソフトウェアを実行するために、少なくとも 16GB の RAM を搭載した Jetson ボードを推奨します。

Zivid SDK は Jetson Orin Nano をサポートしていますが、Orin Nano の総 RAM はわずか 4GB/8GB であり、これは CPU と GPU 間で共有されます。4GB は Zivid SDK を使用するあらゆるアプリケーションを実行するには一般的に不十分であり、8GB も、特に長時間のキャプチャ、Stripe/Omni Engine、多数のフィルターを組み合わせる場合など、多くのユースケースでは実質的に不十分です。そのため、Orin Nano を使用する場合は、アプリケーションの RAM 使用量を慎重に評価する必要があります。

Jetson Thor モジュール (T4000/T5000) には 64GB または 128GB の RAM が搭載されており、推奨される最小値を大幅に上回っています。

警告

Jetson ボードは、Zivid SDK の点群処理を大幅に遅くする低電力プロファイルで起動する場合があります。 Jetson Linux に Zivid をインストールする に記載されている手順に従って、最大電力プロファイルを設定してください。

コンピューティングデバイスの選択

複数の GPU があり、Zivid SDK で特定の GPU を使用したい場合は、 設定ファイル でコンピューティングデバイスを指定できます。Zivid SDK を CPU で実行するように構成することもできますが、CPU は サポートされていないコンピューティングデバイスモード です。

CUDA と OpenCL

Zivid SDK には、CUDA 版と OpenCL 版の 2 つのバージョンがあります。バージョンは設定ファイルではなく、SDK をインストールするときに選択します。

CUDA 版は NVIDIA GPU でのみ動作します。OpenCL 版は Intel GPU で動作し、 サポートされていないコンピューティングデバイス として NVIDIA GPU でも動作させることができます。NVIDIA GPU をサポートされているコンピューティングデバイスとして使用するには、SDK の CUDA 版をインストールしてください。

設定ファイル

ファイルがまだ存在しない場合は、 Config.yml ファイルをダウンロードして、次のディレクトリに配置します。

Windows
mkdir %LOCALAPPDATA%\Zivid\API
move %HOMEPATH%\Downloads\Config.yml %LOCALAPPDATA%\Zivid\API\
Ubuntu
mkdir --parents "${XDG_CONFIG_HOME-$HOME/.config}"/Zivid/API
mv ~/Downloads/Config.yml "${XDG_CONFIG_HOME-$HOME/.config}"/Zivid/API/

目的の GPU は、設定ファイル内の ComputeDevice パラメーターを変更することで割り当てられます。

単一ベンダー

単一ベンダーの複数の GPU (例: 2 つの Nvidia GPU) がある場合、 SelectionFilter でどの GPU を使用するかを指定する必要があります。 clinfo を使用してすべてのコンピューティングデバイスをリストします。 clinfo の詳細、インストール方法、使用方法については、以下のドロップダウンに従ってください。

clinfo
Windows
  1. clinfo Windows バイナリファイルをダウンロードします。

  2. キーボードの Win + R キーを押してコマンドプロンプトを起動し、次に cmd と入力して Enter を押します。

  3. ダウンロードしたファイル (clinfo.exe) が含まれるディレクトリに移動し、次のコマンドを実行します。

    clinfo.exe -l
    

    これにより、システム上のすべての OpenCL プラットフォームと、それらが公開するデバイスに関する利用可能な情報がすべて出力されます。

    ../../../_images/cmd_cl_windows.png

    GPU がリストにない場合は OpenCL ドライバーやグラフィックスドライバーをインストールする 必要がある場合があります。

  4. OpenCL ドライバーのバージョンを確認するには、 clinfo を使用して OpenCL プラットフォームのバージョンを検索します。

    clinfo.exe | findstr "Platform\ Version"
    

    バージョンが OpenCL 1.2 より低い場合は、 グラフィックスドライバーを更新する 必要があります。

Ubuntu
  1. キーボードの Ctrl + Alt + T キーを押してターミナルウィンドウを開き、 clinfo をインストールします。

    sudo apt install -y clinfo
    
  2. clinfo -l を実行して、すべての OpenCL プラットフォームをリストします。

    sudo /usr/bin/clinfo -l
    

    これにより、システム上のすべての OpenCL プラットフォームと、それらが公開するデバイスに関する利用可能な情報がすべて出力されます。

    GPU がリストにない場合は OpenCL ドライバーやグラフィックスドライバーをインストールする 必要がある場合があります。

    ../../../_images/no-platforms-ubuntu.png
  3. OpenCL ドライバーのバージョンを確認するには、 clinfo を使用して OpenCL プラットフォームのバージョンを検索します。

    sudo /usr/bin/clinfo | grep "Platform Version"
    

    バージョンが OpenCL 1.2 より低い場合は、 OpenCL ドライバーやグラフィックスドライバーを更新する 必要があります。

特定の GPU 名を見つけるには、 clinfo を実行してコンピューティングデバイスを一覧表示します。

clinfo -l

注釈

clinfo は OpenCL デバイスを一覧表示し、SDK の OpenCL 版に適用されます。CUDA 版の場合は、代わりにターミナルで nvidia-smi -L を実行し、CUDA デバイス名の一意な部分を使用してください。どちらのコマンドも Windows と Ubuntu で実行できます。Windows では、 clinfo はデフォルトではインストールされておらず、 nvidia-smi が PATH に含まれていない場合もあります。

設定ファイル内の SelectionFilter を、目的のデバイスの名前の一意の部分に変更します。たとえば、次の出力の NVIDIA GeForce RTX 3060 の場合、

../../../_images/clinfo_multiple_gpu_single_vendor.png

SelectionFilter を次のように設定します

ComputeDevice:
    SelectionFilter: "RTX 3060"
    Type: Any
    Vendor: Any
複数のベンダー

複数のベンダーの GPU (たとえば、統合 Intel GPU と専用 NVIDIA GPU) がある場合は、 Type を GPU に、 Vendor を Nvidia または Intel に変更します。例:

ComputeDevice:
    SelectionFilter: ""
    Type: GPU
    Vendor: Nvidia

サポートされていないコンピューティングデバイスの有効化

サポートされていないコンピューティングデバイスを有効にするには、 設定ファイル でオプションを有効にします。ただし、このような設定では予期しない結果やエラーが発生する可能性があり、Zivid によるテストは行われていません。現在、サポートされていないコンピューティングデバイスは、AMD GPU、OpenCL 版の SDK における NVIDIA GPU、および CPU です。お使いのコンピューティングデバイス用の Config.yml ファイルを以下からダウンロードしてください。

AMD の有効化

以下の情報を含む Config.yml ファイルをダウンロードしてください。ここで、 AllowUnsupported: yes はサポートされていないコンピューティングデバイスを有効にします。

__version__:
    serializer: 1
    data: 19
Configuration:
    ComputeDevice:
        AllowUnsupported: yes
OpenCL 版で NVIDIA を有効化

OpenCL 版の SDK は、NVIDIA GPU をサポートされていないコンピューティングデバイスとして扱います。これを有効にせずに NVIDIA GPU に OpenCL 版をインストールすると、SDK は NVIDIA のコンピューティングデバイスがサポートされていないというエラーで失敗します (正確なエラーメッセージについては NVIDIA コンピュートデバイスは OpenCL バージョンではサポートされていません を参照してください)。 Vendor が Nvidia に、 AllowUnsupported が yes に設定された以下の Config.yml ファイルをダウンロードしてください。NVIDIA GPU でサポートされているセットアップにするには、代わりに SDK の CUDA 版をインストールしてください。

__version__:
    serializer: 1
    data: 19
Configuration:
    ComputeDevice:
        Type: GPU
        Vendor: Nvidia
        AllowUnsupported: yes
CPU の有効化

Intel の CPU Runtime for OpenCL を使用して、Intel チップセット上で Zivid SDK を実行することが可能です。コンピューティングデバイスの Type が CPU に、 Vendor が Intel に設定された以下の Config.yml ファイルをダウンロードしてください。

__version__:
    serializer: 1
    data: 19
Configuration:
    ComputeDevice:
        Type: CPU
        Vendor: Intel
        AllowUnsupported: yes

警告

CPU はサポートされていないコンピューティングデバイスモードです。CPU を使用するとキャプチャ時間が大幅に増加するため、ほとんどのアプリケーションではこの設定は推奨されません。また、OpenCL プラットフォームが混在する環境では、CPU を選択するとクラッシュなどの不安定な動作を引き起こす可能性があります。

ダウンロードしたら、 Config.yml ファイルを次のディレクトリに配置してください。

Windows
mkdir %LOCALAPPDATA%\Zivid\API
move %HOMEPATH%\Downloads\Config.yml %LOCALAPPDATA%\Zivid\API\
Ubuntu
mkdir --parents "${XDG_CONFIG_HOME-$HOME/.config}"/Zivid/API
mv ~/Downloads/Config.yml "${XDG_CONFIG_HOME-$HOME/.config}"/Zivid/API/

Version History

SDK

変更点

2.18.0

NVIDIA GPU 向けの CUDA コンピュートバックエンドのサポートを追加しました。Jetson Thor のサポートを追加しました。Ubuntu 26.04 のサポートを追加しました。

2.12.0

Jetson Orin のサポートを追加しました。