設定ファイル

Zivid 設定ファイルは、Zivid ソフトウェアを設定するために使用される一連のファイルです。設定ファイルはオプションであり、Zivid ソフトウェアは設定ファイルがなくても動作します。これらのファイルは、Windows では %LOCALAPPDATA%\Zivid\ に、Ubuntu では $HOME/.config/Zivid/ に保存されます。

以下に、各設定ファイルに関する情報を示します。

Config.yml

このファイルは Zivid SDK のメイン設定ファイルとして使用され、以下のことができます。

例えば、上記すべてを有効にした場合、ファイルの内容は次のようになります。

__version__:
    serializer: 1
    data: 19
Configuration:
    APIBreakingBugFixes:
        FileFormats:
            PCD:
                UseOrganizedFormat: yes
    Camera:
        TemperatureStabilization:
            Enabled: yes
        Power:
            Limit: unlimited
    Capture:
        Diagnostics:
            Enabled: CaptureSettingsDependent
    ComputeDevice:
        SelectionFilter: ""
        Type: GPU
        Vendor: Any
        AllowUnsupported: no
    MaintenanceServices:
        CloudIntegration:
            Enabled: yes

ファイルが存在しない場合は、以下の手順に従ってダウンロードしてインストールしてください。

Config.yml ファイルをダウンロードします。
希望する設定に合わせてファイルを編集してください。

ダウンロードした Config ファイルを以下のディレクトリに配置します。

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/

注意

既存の Config ファイルは上書きされます。

Cameras.yml

このファイルは、SDK で表示できる有効なカメラ IP アドレスまたはホスト名を制限するために使用されます。詳細については有効なカメラ IP アドレスを制限するを参照してください。

以下に、IP アドレスとホスト名の例を示します。

サンプル Cameras.yml ファイル (ホスト名)

__version__: 1
Cameras:
    NetworkCameras:
        - NetworkCamera:
              Host: zivid-2152D404.local
        - NetworkCamera:
              Host: zivid-20205M19.local
        - NetworkCamera:
              Host: zivid-21389K63.local

サンプル Cameras.yml ファイル (IP アドレス)

__version__: 1
Cameras:
    NetworkCameras:
        - NetworkCamera:
              Host: 172.28.60.5
        - NetworkCamera:
              Host: 172.28.60.6
        - NetworkCamera:
              Host: 172.28.60.7

注釈

Cameras.yml が Zivid 設定フォルダーにある場合、そのファイルにリストされている IP/ホスト名のみが SDK に表示され、自動検出は実行されません。

ファイルが存在しない場合は、以下の手順に従ってダウンロードしてインストールしてください。

Cameras.yml ファイルをダウンロードします。
制限したい IP アドレスまたはホスト名をファイルに追記してください。

ダウンロードした Cameras ファイルを以下のディレクトリに配置してください。

Windows

mkdir %LOCALAPPDATA%\Zivid\API
move %HOMEPATH%\Downloads\Cameras.yml %LOCALAPPDATA%\Zivid\API\

Ubuntu

mkdir --parents "${XDG_CONFIG_HOME-$HOME/.config}"/Zivid/API
mv ~/Downloads/Cameras.yml "${XDG_CONFIG_HOME-$HOME/.config}"/Zivid/API/

注意

既存の Cameras ファイルは上書きされます。

Preferences.ini

このファイルは、Zivid Studio の設定を構成して保存するために使用され、 Zivid Studio を介してアクセスできます。Zivid Studio のデフォルト設定を変更すると、このファイルは自動的に作成されます。デフォルト設定は次のとおりです。

[SoftwareUpdate]
NotificationEnabled=true

[View]
Reset3DViewWhenOpeningFiles=true
Synchronize3DViewBetweenProcesses=false

Zivid Studio の現在の設定項目は以下のとおりです。

NotificationEnabled: 新しいバージョンが利用可能になったときに Zivid Studio でソフトウェア更新通知を表示しないようにするには、これを無効にします。
Reset3DViewWhenOpenFiles: Zivid Studio で新しいファイルを開くときに 3D ビューをそのまま保持するには、これを無効にします。
Synchronize3DViewBetweenProcesses: 異なる Zivid Studio インスタンス間で 3D ビューを同期するには、これを有効にします。

以下の手順で、希望する設定でファイルを事前にダウンロードしてインストールできます。

Preferences.ini ファイルをダウンロードします。
ご希望の設定に合わせてファイルを編集してください。

ダウンロードした Preferences ファイルを以下のディレクトリに配置してください。

Windows

mkdir %LOCALAPPDATA%\Zivid\Studio
move %HOMEPATH%\Downloads\Preferences.ini %LOCALAPPDATA%\Zivid\Studio\

Ubuntu

mkdir --parents "${XDG_CONFIG_HOME-$HOME/.config}"/Zivid/Studio
mv ~/Downloads/Preferences.ini "${XDG_CONFIG_HOME-$HOME/.config}"/Zivid/Studio/

注意

既存の Preferences ファイルは上書きされます。

バージョン履歴

SDK	変更点
2.15.0	Preferences.ini が追加されました。
2.11.0	AMD は推奨されなくなりました。SDK では公式サポートが削除されました。詳細は Zivid ソフトウェア用にサポートされていないコンピューティングデバイスを有効にするを参照してください。サポートされていない GPU オプションが Config.yml に追加されました。
2.10.1	プロジェクターの明るさの制限が Config.yml に追加されました。
2.9.0	温度安定化が Config.yml に追加されました。
2.8.0	Cameras.yml が追加されました。
2.7.0	クラウドロギングが Config.yml に追加されました。
2.6.0	診断機能が Config.yml に追加されました。
2.5.0	整列された PCD のエクスポートが Config.yml に追加されました。
2.4.0	コンピュートデバイスが Config.yml に追加されました。