GPU について
Zivid SDK を最適に実行するには、ホストマシンに GPU が必要です。統合 GPU と専用 GPU はどちらも Zivid で適切に動作しますが、パフォーマンスの違いはキャプチャ時間にあります。
OS と GPU ベンダーごとのドライバー要件については、 GPU 要件 を参照してください。
専用 GPU と統合 GPU の推奨事項については、 パフォーマンスに関する考慮事項 を参照してください。
特定の GPU を対象とする場合、またはサポートされていないコンピューティングデバイスで実行する場合は、 コンピューティングデバイスの選択 を参照してください。
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 を使用してドライバーのバージョンを自動的に検出するか、以下の手順に従って手動で見つけます。
Start → Control Panel
リストから Device Manager を選択します (必要に応じて View を Small Icons に切り替えます)
Display Adapter セクションを展開し、 Intel® Display Adapter を右クリックして Properties を選択します。
Driver タブに移動し、表示されている Driver Version を確認します。
グラフィックスドライバーをインストールした後、 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 を使用してドライバーのバージョンを自動的に検出するか、以下の手順に従って手動で見つけます。
NVIDIA Control Panel を開きます ( Desktop を右クリックします)。
System Information (左下隅) をクリックします。
Details セクションの Driver version を確認します。
グラフィックスドライバーをインストールした後、 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 を使用してドライバーのバージョンを自動的に検出するか、以下の手順に従って手動で見つけます。
AMD Radeon Settings を開きます ( Desktop を右クリックします)。
System をクリックして、システムの概要、ソフトウェアおよびハードウェアの詳細にアクセスします。
インストールされているグラフィックスドライバーの詳細については Software タブを選択してください。 Driver Packaging Version を確認してください。
グラフィックスドライバーをインストールした後、 Zivid Studio を開き、OpenCL エラーが発生しないことを確認します。
上記の OpenCL または CUDA ドライバーに加えて、Zivid Studio と SDK のビジュアライザーには OpenGL ドライバーも必要です。
OpenGL ドライバーの確認
OpenGL Extensions Viewer をダウンロードします。
インストールして起動し、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 を参照してください。
キーボードの 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 の手順を確認するには、左上隅にあるナレッジベースのバージョンを変更します。
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
AllowUnsupporteddoes 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
これにより、ドライバーのバージョンが出力されます。
NVIDIA GPU ドライバー PPA をシステムに追加します。
キーボードの Ctrl + Alt + T キーを押してターミナルウィンドウを開き、グラフィックスドライバー PPA を追加します。
sudo add-apt-repository ppa:graphics-drivers/ppa
これにより、
nvidia-xxxとしてパッケージ化された最新の長期サポートドライバーリリースが、次のステップでインストール可能になります。システムの最新ドライバーをインストールします。
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 rebootZivid Studio を開き、OpenCL エラーが発生しないことを確認します。
注釈
OpenCL エラーが発生した場合は、 ユーザーをグループ Video に追加する 必要がある場合があります。
AMD
警告
SDK 2.10 以降、ドライバーの OpenCL 安定性の問題により AMD のサポートは削除されました。Config.yml ファイルでオプションを有効にすることで、 サポートされていないコンピューティングデバイスで SDK を実行するように選択する ことが可能です。ただし、このような設定では予期しない結果やエラーが発生する可能性があり、Zivid によるテストは行われていません。
警告
Radeon は一部の GPU で SPIR をサポートしなくなりました。Zivid と互換性があるために、GPU ドライバーが SPIR をサポートしていることを確認してください。
正しい 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
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
./amdgpu-pro-install --opencl=pal
Ubuntu 18.04
注釈
Ubuntu 18.04 のサポートは SDK 2.10 以降削除されました。以前の SDK バージョンの Ubuntu 18.04 の手順を確認するには、左上隅にあるナレッジベースのバージョンを変更します。
手順に従ってセキュアブートを設定します (プロンプトが表示された場合)。
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 のバージョンが出力されます。
バージョンが 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
clinfo Windows バイナリファイルをダウンロードします。
キーボードの Win + R キーを押してコマンドプロンプトを起動し、次に
cmdと入力して Enter を押します。ダウンロードしたファイル (clinfo.exe) が含まれるディレクトリに移動し、次のコマンドを実行します。
clinfo.exe -l
これにより、システム上のすべての OpenCL プラットフォームと、それらが公開するデバイスに関する利用可能な情報がすべて出力されます。
GPU がリストにない場合は OpenCL ドライバーやグラフィックスドライバーをインストールする 必要がある場合があります。
OpenCL ドライバーのバージョンを確認するには、
clinfoを使用して OpenCL プラットフォームのバージョンを検索します。clinfo.exe | findstr "Platform\ Version"
バージョンが OpenCL 1.2 より低い場合は、 グラフィックスドライバーを更新する 必要があります。
Ubuntu
キーボードの Ctrl + Alt + T キーを押してターミナルウィンドウを開き、
clinfoをインストールします。sudo apt install -y clinfo
clinfo -lを実行して、すべての OpenCL プラットフォームをリストします。sudo /usr/bin/clinfo -l
これにより、システム上のすべての OpenCL プラットフォームと、それらが公開するデバイスに関する利用可能な情報がすべて出力されます。
GPU がリストにない場合は OpenCL ドライバーやグラフィックスドライバーをインストールする 必要がある場合があります。
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 の場合、
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 のサポートを追加しました。 |