OpenCV 4.13.0
Open Source Computer Vision
読み込み中...
検索中...
見つかりません
🤖 AIによる機械翻訳（非公式） — これは OpenCV 4.13.0 公式リファレンス（英語）を AI (Claude) で自動翻訳したものです。訳に誤りを含む場合があります。正確な情報は 公式英語版（原文） を参照してください。
OpenCV環境変数リファレンス

目次

前のチュートリアル: OpenCVの設定オプションリファレンス
次のチュートリアル: Linuxでのインストール

はじめに

OpenCVは実行時の環境に応じて動作を変えることができる:

  • 追加のデバッグ出力やパフォーマンストレースを有効にする
  • デフォルトの場所や検索パスを変更する
  • 一部のアルゴリズムや全般的な動作を調整する
  • 回避策、安全機能、最適化を有効または無効にする

注意:

  • ⭐ は最もよく使われる変数を示す
  • VAR_${NAME} のような名前の変数は変数のファミリーを表し、${NAME} はあらかじめ定義された値のいずれか、例えば VAR_TBB、VAR_OPENMP などに置き換える必要がある

Windowsでの環境変数の設定

ターミナルまたはcmdファイル(batファイル)で:

set MY_ENV_VARIABLE=true
C:\my_app.exe

GUIで:

  • 「設定 -> システム -> 詳細情報」を開く
  • 右側にある「システムの詳細設定」をクリックする
  • 新しいウィンドウで「環境変数」ボタンをクリックする
  • 「ユーザー環境変数」の一覧にエントリを追加する

Linuxでの環境変数の設定

ターミナルまたはシェルスクリプトで:

export MY_ENV_VARIABLE=true
./my_app

または単一のコマンドとして:

MY_ENV_VARIABLE=true ./my_app

Pythonでの環境変数の設定

import os
os.environ["MY_ENV_VARIABLE"] = "True" # value must be a string
import cv2 # variables set after this may not have effect
覚え書き
この方法はすべてのオペレーティングシステムやPythonディストリビューションで動作するとは限らない。例えば、システムのPythonインタプリタを使うUbuntu Linuxでは動作するが、公式のPythonパッケージを使うWindows 10では動作しない。プロセスが自身の環境を変更できるかどうかに依存する(OpenCVはC++ランタイムの getenv を使って変数を読み取る)。
参照:

型

  • bool - 1, True, true, TRUE / 0, False, false, FALSE
  • number/_size_ - 符号なしの数値、接尾辞 MB, Mb, mb, KB, Kb, kb
  • string - プレーンな文字列、または構造を持つこともできる
  • path - ファイルへのパス、ディレクトリへのパス
  • paths - Windowsでは ; 区切り、その他では : 区切り

全般、コア

名前型デフォルト説明
OPENCV_SKIP_CPU_BASELINE_CHECKboolfalseビルドで使用されるすべての機能を現在のCPUがサポートしているか確認しない (baseline)
OPENCV_CPU_DISABLE, または ; 区切りCPU機能を使用するコードブランチを無効にする (dispatchedコード)
OPENCV_SETUP_TERMINATE_HANDLERbooltrue (Windows)std::set_terminate を使用して独自の終了ハンドラをインストールする
OPENCV_LIBVA_RUNTIMEファイルパスVA相互運用ユーティリティ用の libva
OPENCV_ENABLE_MEMALIGNbooltrue (静的解析、メモリサニタイザ、ファジング、_WIN32? を除く)アラインメントされたメモリ割り当てを有効にする
OPENCV_BUFFER_AREA_ALWAYS_SAFEboolfalseマルチバッファ割り当てのセーフモードを有効にする (各バッファを個別に割り当てる)
OPENCV_KMEANS_PARALLEL_GRANULARITYnum1000 アルゴリズムの並列処理の分配パラメータ parallel_for_(..., ..., ..., granularity) を調整する
OPENCV_DUMP_ERRORSbooltrue (Debug または Android)、false (その他)例外発生時に追加情報を出力する (Androidではログに記録)
OPENCV_DUMP_CONFIGboolfalseビルド構成を stderr に出力する (getBuildInformation)
OPENCV_PYTHON_DEBUGboolfalsePythonバインディングで追加の警告を有効にする
OPENCV_TEMP_PATHpath/tmp/ (Linux)、/data/local/tmp/ (Android)、GetTempPathA (Windows)一時ファイル用のディレクトリ
OPENCV_DATA_PATH_HINTpathsfindDataFile 用のパス
OPENCV_DATA_PATHpathsfindDataFile 用のパス
OPENCV_SAMPLES_DATA_PATH_HINTpathsfindDataFile 用のパス
OPENCV_SAMPLES_DATA_PATHpathsfindDataFile 用のパス

リンク:

ロギング

名前型デフォルト説明
⭐ OPENCV_LOG_LEVELstringログレベル (有効な値は下記を参照)
OPENCV_LOG_TIMESTAMPbooltrueタイムスタンプ付きでログを記録する
OPENCV_LOG_TIMESTAMP_NSboolfalseログのタイムスタンプにナノ秒を追加する

レベル

  • 0, O, OFF, S, SILENT, DISABLE, DISABLED
  • F, FATAL
  • E, ERROR
  • W, WARNING, WARN, WARNINGS
  • I, INFO
  • D, DEBUG
  • V, VERBOSE

core/parallel_for

名前型デフォルト説明
⭐ OPENCV_FOR_THREADS_NUMnum0 スレッド数を設定する
OPENCV_THREAD_POOL_ACTIVE_WAIT_PAUSE_LIMITnum16 pthreads parallel_for バックエンドを調整する
OPENCV_THREAD_POOL_ACTIVE_WAIT_WORKERnum2000 pthreads parallel_for バックエンドを調整する
OPENCV_THREAD_POOL_ACTIVE_WAIT_MAINnum10000 pthreads parallel_for バックエンドを調整する
OPENCV_THREAD_POOL_ACTIVE_WAIT_THREADS_LIMITnum0 pthreads parallel_for バックエンドを調整する
OPENCV_FOR_OPENMP_DYNAMIC_DISABLEboolfalse4.13.0 で削除された。代わりに標準の OMP_DYNAMIC を使用する

バックエンド

OPENCV_LEGACY_WAITKEY 一部のモジュールには複数の利用可能なバックエンドがあり、以下の変数によって特定のバックエンドを選択したり、バックエンドが検出されるデフォルトの優先順位を変更したりできる(例: 動画ファイルを開くとき)。

名前型デフォルト説明
OPENCV_PARALLEL_BACKENDstringparallel_for の特定のバックエンドを選択する（TBB, ONETBB, OPENMP のいずれか）
OPENCV_PARALLEL_PRIORITY_${NAME}numバックエンドの優先度を設定する。デフォルトは 1000
OPENCV_PARALLEL_PRIORITY_LIST文字列、, 区切り優先度順のバックエンドのリスト
OPENCV_UI_BACKENDstringウィンドウ描画用の highgui バックエンドを選択する（GTK, GTK3, GTK2, QT, WIN32 のいずれか）
OPENCV_UI_PRIORITY_${NAME}numhighgui バックエンドの優先度を設定する。デフォルトは 1000
OPENCV_UI_PRIORITY_LIST文字列、, 区切り優先度順の highgui バックエンドのリスト
OPENCV_VIDEOIO_PRIORITY_${NAME}numvideoio バックエンドの優先度を設定する。デフォルトは 1000
OPENCV_VIDEOIO_PRIORITY_LIST文字列、, 区切り優先度順の videoio バックエンドのリスト

プラグイン

一部の外部依存関係は動的ライブラリに切り離すことができ、それは実行時に読み込まれる(プラグイン)。以下の変数によって、これらのプラグインのデフォルトの検索場所や命名パターンを変更できる。

名前型デフォルト説明
OPENCV_CORE_PLUGIN_PATHpathscore プラグインを検索するディレクトリ
OPENCV_CORE_PARALLEL_PLUGIN_${NAME}文字列、グロブparallel_for プラグインのライブラリ名（グロブ）。例えば TBB のデフォルトは "opencv_core_parallel_tbb*.so"
OPENCV_DNN_PLUGIN_PATHpathsdnn プラグインを検索するディレクトリ
OPENCV_DNN_PLUGIN_${NAME}文字列、グロブparallel_for プラグインのライブラリ名（グロブ）。例えば TBB のデフォルトは "opencv_core_parallel_tbb*.so"
OPENCV_CORE_PLUGIN_PATHpathshighgui プラグインを検索するディレクトリ（はい、これは CORE である）
OPENCV_UI_PLUGIN_${NAME}文字列、グロブhighgui プラグインのライブラリ名（グロブ）
OPENCV_VIDEOIO_PLUGIN_PATHpathsvideoio プラグインを検索するディレクトリ
OPENCV_VIDEOIO_PLUGIN_${NAME}文字列、グロブvideoio プラグインのライブラリ名（グロブ）

OpenCL

注意: OpenCLデバイスの指定形式は <Platform>:<CPU|GPU|ACCELERATOR|nothing=GPU/CPU>:<deviceName> である。例: AMD:GPU:

名前型デフォルト説明
OPENCV_OPENCL_RUNTIMEファイルパスまたは disabledOpenCL ランタイムライブラリへのパス（例: OpenCL.dll, libOpenCL.so）
⭐ OPENCV_OPENCL_DEVICE文字列または disabled特定の OpenCL デバイスを選択する。指定フォーマットについては上の注記を参照。詳細は Links セクションを参照。
OPENCV_OPENCL_RAISE_ERRORboolfalseOpenCL カーネルの準備および実行中に何らかの失敗が発生した場合に例外を発生させる（リリースビルドのみ）
OPENCV_OPENCL_ABORT_ON_BUILD_ERRORboolfalseOpenCL カーネルのコンパイルが失敗した場合に中断する
OPENCV_OPENCL_CACHE_ENABLEbooltrueOpenCL カーネルキャッシュを有効にする
OPENCV_OPENCL_CACHE_WRITEbooltrueキャッシュへの書き込みを許可する。許可しない場合キャッシュは読み取り専用になる
OPENCV_OPENCL_CACHE_LOCK_ENABLEbooltrue同じ OpenCL キャッシュを使用する複数のアプリケーション間で同期するために .lock ファイルを使用する（ネットワークドライブでは動作しない場合がある）
OPENCV_OPENCL_CACHE_CLEANUPbooltrueキャッシュから古いエントリ（古い OpenCL ランタイムの残骸）を自動的に削除する
OPENCV_OPENCL_VALIDATE_BINARY_PROGRAMSboolfalseロードされたバイナリ OpenCL カーネルを検証する
OPENCV_OPENCL_DISABLE_BUFFER_RECT_OPERATIONSbooltrue（Apple）、false（その他）非連続なデータダウンロードに対する回避策を有効にする
OPENCV_OPENCL_BUILD_EXTRA_OPTIONSstringOpenCL カーネルのコンパイルに追加オプションを渡す
OPENCV_OPENCL_ENABLE_MEM_USE_HOST_PTRbooltrueバッファ確保の回避策／最適化
OPENCV_OPENCL_ALIGNMENT_MEM_USE_HOST_PTRnum4 OPENCV_OPENCL_ENABLE_MEM_USE_HOST_PTR のパラメータ
OPENCV_OPENCL_DEVICE_MAX_WORK_GROUP_SIZEnum0 maxWorkGroupSize を減らすことを許可する
OPENCV_OPENCL_PROGRAM_CACHEnum0 OpenCL カーネルキャッシュ内のプログラム数を制限する
OPENCV_OPENCL_RAISE_ERROR_REUSE_ASYNC_KERNELboolfalse非同期カーネルが失敗した場合に例外を発生させる
OPENCV_OPENCL_BUFFERPOOL_LIMITnum1 << 27（Intel デバイス）、0（その他）バッファプールが使用するメモリを制限する
OPENCV_OPENCL_HOST_PTR_BUFFERPOOL_LIMITnumOPENCV_OPENCL_BUFFERPOOL_LIMIT と同じだが、HOST_PTR バッファ用
OPENCV_OPENCL_BUFFER_FORCE_MAPPINGboolfalseclEnqueueMapBuffer を強制する
OPENCV_OPENCL_BUFFER_FORCE_COPYINGboolfalseclEnqueueReadBuffer/clEnqueueWriteBuffer を強制する
OPENCV_OPENCL_FORCEboolfalse通常の条件が満たされていなくても(例: dst.isUMat) OpenCL カーネルの実行を強制する
OPENCV_OPENCL_PERF_CHECK_BYPASSboolfalse通常の性能関連の条件が満たされていなくても(例: 画像が非常に小さい) OpenCL カーネルの実行を強制する

SVM (共有仮想メモリ) - デフォルトでは無効

名前型デフォルト説明
OPENCV_OPENCL_SVM_DISABLEboolfalseSVM を無効化する
OPENCV_OPENCL_SVM_FORCE_UMAT_USAGEboolfalse
OPENCV_OPENCL_SVM_DISABLE_UMAT_USAGEboolfalse
OPENCV_OPENCL_SVM_CAPABILITIES_MASKnum
OPENCV_OPENCL_SVM_BUFFERPOOL_LIMITnumOPENCV_OPENCL_BUFFERPOOL_LIMIT と同じだが、SVM バッファ用

リンク:

トレース/プロファイリング

名前型デフォルト説明
⭐ OPENCV_TRACEboolfalseトレースを有効化する
OPENCV_TRACE_LOCATIONstringOpenCVTrace トレースファイル名 ("${name}-$03d.txt")
OPENCV_TRACE_DEPTH_OPENCVnum1
OPENCV_TRACE_MAX_CHILDREN_OPENCVnum1000
OPENCV_TRACE_MAX_CHILDRENnum1000
OPENCV_TRACE_SYNC_OPENCLboolfalseOpenCL カーネルの完了を待つ
OPENCV_TRACE_ITT_ENABLEbooltrue
OPENCV_TRACE_ITT_PARENTboolfalseITT タスクの parentID を設定する
OPENCV_TRACE_ITT_SET_THREAD_NAMEboolfalseOpenCV のスレッドに名前 "OpenCVThread-%03d" を設定する

リンク:

キャッシュ

注意: デフォルトの一時ファイルの場所は TMPDIR% (Windows)、および $XDG_CACHE_HOME、$HOME/.cache、/var/tmp、/tmp (その他) である

名前型デフォルト説明
OPENCV_CACHE_SHOW_CLEANUP_MESSAGEbooltrueキャッシュのクリーンアップメッセージを表示する
OPENCV_DOWNLOAD_CACHE_DIRpathデフォルトの一時ディレクトリの場所ダウンロードしたファイルのキャッシュディレクトリ(サブディレクトリ downloads)
OPENCV_DNN_IE_GPU_CACHE_DIRpathデフォルトの一時ディレクトリの場所OpenVINO OpenCL カーネルのキャッシュディレクトリ(サブディレクトリ dnn_ie_cache_${device})
OPENCV_OPENCL_CACHE_DIRpathデフォルトの一時ディレクトリの場所OpenCL カーネルキャッシュのキャッシュディレクトリ(サブディレクトリ opencl_cache)

dnn

注意: 以下の表において dump_base_name は ocv_dnn_net_%05d_%02d に等しく、第1引数は内部ネットワークID、第2引数はダンプレベルである。

名前型デフォルト説明
OPENCV_DNN_BACKEND_DEFAULTnum3 (OpenCV)デフォルトの DNN バックエンドを設定する。バックエンドの列挙については dnn.hpp を参照
OPENCV_DNN_NETWORK_DUMPnum0 情報ダンプのレベル。0 はダンプなし(デフォルトのファイル名 ${dump_base_name}.dot)
OPENCV_DNN_DISABLE_MEMORY_OPTIMIZATIONSboolfalse
OPENCV_DNN_CHECK_NAN_INFboolfalseレイヤー出力中の NaN をチェックする
OPENCV_DNN_CHECK_NAN_INF_DUMPboolfalseNaN チェックが失敗したときにレイヤーのデータを表示する
OPENCV_DNN_CHECK_NAN_INF_RAISE_ERRORboolfalseNaN チェックが失敗したときに例外も送出する
OPENCV_DNN_ONNX_USE_LEGACY_NAMESboolfalse"onnx_node!${node_name}" の代わりに ONNX のノード名をそのまま使用する
OPENCV_DNN_CUSTOM_ONNX_TYPE_INCLUDE_DOMAIN_NAMEbooltrueレイヤーの型にレイヤードメインを前置する("domain.type")
OPENCV_VULKAN_RUNTIMEファイルパスDNN Vulkan バックエンド用の Vulkan ランタイムライブラリの場所を設定する
OPENCV_DNN_IE_SERIALIZEboolfalse中間の OpenVINO グラフをダンプする(デフォルトのファイル名 ${dump_base_name}_ngraph.xml, ${dump_base_name}_ngraph.bin)
OPENCV_DNN_IE_EXTRA_PLUGIN_PATHpathOpenVINO の追加プラグインへのパス
OPENCV_DNN_IE_VPU_TYPEstring使用する OpenVINO VPU デバイスの種類を強制する("Myriad2" または "MyriadX")
OPENCV_TEST_DNN_IE_VPU_TYPEstringOPENCV_DNN_IE_VPU_TYPE と同じだが、テスト用
OPENCV_DNN_INFERENCE_ENGINE_HOLD_PLUGINSbooltrueアンロード時のクラッシュを避けるため、既存の OpenVINO インスタンスを常に1つ保持する
OPENCV_DNN_INFERENCE_ENGINE_CORE_LIFETIME_WORKAROUNDbooltrue (Windows)、false (その他)もう一つの OpenVINO ライフタイム回避策
OPENCV_DNN_OPENCL_ALLOW_ALL_DEVICESboolfalseCPU デバイスでの実行を許可し、非 Intel デバイスでの FP16 を許可する
OPENCV_OCL4DNN_CONVOLUTION_IGNORE_INPUT_DIMS_4_CHECKboolfalseOpenCL バックエンド向けの回避策。https://github.com/opencv/opencv/issues/20833 を参照
OPENCV_OCL4DNN_WORKAROUND_IDLFbooltrueOpenCL バックエンド向けのもう一つの回避策
OPENCV_OCL4DNN_CONFIG_PATHpath自動チューニング用のカーネル設定キャッシュへのパス(既存のディレクトリである必要がある)。この変数を設定すると自動チューニングが有効になる
OPENCV_OCL4DNN_DISABLE_AUTO_TUNINGboolfalse自動チューニングを無効化する
OPENCV_OCL4DNN_FORCE_AUTO_TUNINGboolfalse自動チューニングを強制する
OPENCV_OCL4DNN_TEST_ALL_KERNELSnum0 畳み込みカーネルをテストする。反復回数(自動チューニング)
OPENCV_OCL4DNN_DUMP_FAILED_RESULTboolfalseエラー時に追加情報をダンプする（自動チューニング）
OPENCV_OCL4DNN_TUNING_RAISE_CHECK_ERRORboolfalseエラー時に例外を送出する（自動チューニング）

テスト

名前型デフォルト説明
⭐ OPENCV_TEST_DATA_PATHディレクトリパステストデータの検索場所を設定する（例: /home/user/opencv_extra/testdata）
⭐ OPENCV_DNN_TEST_DATA_PATHディレクトリパス$OPENCV_TEST_DATA_PATH/dnn テスト用のDNNモデル検索場所を設定する（dnn, gapi, objdetect, video モジュールで使用）
OPENCV_OPEN_MODEL_ZOO_DATA_PATHディレクトリパス$OPENCV_DNN_TEST_DATA_PATH/omz_intel_models テスト用のOpenVINOモデル検索場所を設定する（dnn, gapi モジュールで使用）
INTEL_CVSDK_DIR一部の dnn テストはOpenVINOモデルをここからも検索できる
OPENCV_TEST_DEBUGnum0 テストのデバッグレベル。--test_debug と同じ（0 - デバッグなし（デフォルト）、1 - 基本的なテストデバッグ情報、>1 - 追加のデバッグ情報）
OPENCV_TEST_REQUIRE_DATAboolfalse--test_require_data オプションと同じ（必須でないテストデータが欠落している場合に、スキップではなく失敗とする）
OPENCV_TEST_CHECK_OPTIONAL_DATAboolfalse省略可能なデータが見つからない場合にアサートする
OPENCV_IPP_CHECKboolfalse--test_ipp_check および --perf_ipp_check のデフォルト値
OPENCV_PERF_VALIDATION_DIRディレクトリパス--perf_read_validation_results/--perf_write_validation_results で読み書きされるファイルの場所
⭐ OPENCV_PYTEST_FILTER文字列（glob）Pythonテスト用のテストフィルタ

リンク:

videoio

注意: FFmpegの追加オプションは key;value|key;value|key;value の形式で渡す必要がある。例えば hwaccel;cuvid|video_codec;h264_cuvid|vsync;0 や vcodec;x264|vprofile;high|vlevel;4.0 のように指定する

名前型デフォルト説明
⭐ OPENCV_FFMPEG_CAPTURE_OPTIONS文字列（注記を参照）VideoCapture FFmpegバックエンド用の追加オプション
⭐ OPENCV_FFMPEG_WRITER_OPTIONS文字列（注記を参照）VideoWriter FFmpegバックエンド用の追加オプション
OPENCV_FFMPEG_THREADSnumFFmpegのスレッド数を設定する
OPENCV_FFMPEG_DEBUGboolfalseFFmpegからのログメッセージを有効にする
OPENCV_FFMPEG_LOGLEVELnumFFmpegのログレベルを設定する
OPENCV_FFMPEG_SKIP_LOG_CALLBACKboolfalseOpenCVのFFmpegログコールバックをインストールしない（デフォルト/ユーザーのコールバックを保持する）
OPENCV_FFMPEG_DLL_DIRディレクトリパスFFmpegプラグインを含むディレクトリ（レガシー）
OPENCV_FFMPEG_IS_THREAD_SAFEboolfalseこのオプションを有効にすると、FFmpegバックエンドのスレッドセーフロックが無効になる（FFmpegがスレッド対応でビルドされていることが確実な場合のみ使用すること。Linuxでテスト済み）
OPENCV_FFMPEG_READ_ATTEMPTSnum4096 読み込み処理を失敗とするまでの av_read_frame の失敗試行回数
OPENCV_FFMPEG_DECODE_ATTEMPTSnum64 デコード処理を失敗とするまでの avcodec_receive_frame の失敗試行回数
OPENCV_VIDEOIO_GSTREAMER_CALL_DEINITboolfalse終了時にGStreamerインスタンスを閉じる
OPENCV_VIDEOIO_GSTREAMER_START_MAINLOOPboolfalseGStreamerループを別スレッドで開始する
OPENCV_VIDEOIO_MFX_IMPLnum特定のMFX実装を設定する（列挙値についてはMFXのドキュメントを参照）
OPENCV_VIDEOIO_MFX_EXTRA_SURFACE_NUMnum1 サーフェスプールに追加のサーフェスを加える
OPENCV_VIDEOIO_MFX_POOL_TIMEOUTnum1 プールから空きサーフェスを待機するタイムアウト（秒単位）
OPENCV_VIDEOIO_MFX_BITRATE_DIVISORnum300 このオプションでエンコードのビットレート（動画の品質/サイズ）を調整できる
OPENCV_VIDEOIO_MFX_WRITER_TIMEOUTnum1 エンコード処理のタイムアウト（秒単位）
OPENCV_VIDEOIO_MSMF_ENABLE_HW_TRANSFORMSbooltrueMediaFoundationの処理グラフでHWアクセラレーション変換（DXVA）を許可する（カメラ探索処理が遅くなる場合がある）
OPENCV_DSHOW_DEBUGboolfalseDShowバックエンドで詳細ログを有効にする
OPENCV_DSHOW_SAVEGRAPH_FILENAMEファイルパスDShowバックエンドで処理グラフのダンプを有効にする
OPENCV_VIDEOIO_V4L_RANGE_NORMALIZEDboolfalseプロパティに (0, 1) の範囲を使用する（V4L）
OPENCV_VIDEOIO_V4L_SELECT_TIMEOUTnum10 select呼び出しのタイムアウト（秒単位）（V4L）
OPENCV_VIDEOCAPTURE_DEBUGboolfalseVideoCaptureのデバッグメッセージを有効にする
OPENCV_VIDEOWRITER_DEBUGboolfalseVideoWriterのデバッグメッセージを有効にする
⭐ OPENCV_VIDEOIO_DEBUGboolfalseVideoCaptureとVideoWriterの両方のデバッグメッセージ

videoio テスト

名前型デフォルト説明
OPENCV_TEST_VIDEOIO_BACKEND_REQUIRE_FFMPEGboolfalseFFmpegバックエンドが利用できない場合、テストアプリを終了する
OPENCV_TEST_V4L2_VIVID_DEVICEファイルパスV4L2テスト用のVIVID仮想カメラデバイスへのパス (例: /dev/video5)
OPENCV_TEST_PERF_CAMERA_LISTpathsパフォーマンステスト (waitAny_V4L テスト) で使用するカメラ
OPENCV_TEST_CAMERA_d_FPSnumN番目のカメラ (0始まりのインデックス) に設定するfps (waitAny_V4L テスト)

gapi

名前型デフォルト説明
⭐ GRAPH_DUMP_PATHファイルパスグラフをダンプする (dot形式)
PIPELINE_MODELS_PATHディレクトリパスpipeline_modeling_tool サンプルアプリケーションがこの変数を使用する
OPENCV_GAPI_INFERENCE_ENGINE_CORE_LIFETIME_WORKAROUNDbooltrue (Windows, Apple)、false (その他)OPENCV_DNN_INFERENCE_ENGINE_CORE_LIFETIME_WORKAROUND と同様

gapi テスト/サンプル

名前型デフォルト説明
PLAIDML_DEVICEstringPlaidMLバックエンドのテストに固有
PLAIDML_TARGETstringPlaidMLバックエンドのテストに固有
OPENCV_GAPI_ONNX_MODEL_PATHディレクトリパスONNXモデルのテスト用の検索場所
OPENCV_TEST_FREETYPE_FONT_PATHファイルパス一部のテスト用のTrueTypeフォントの場所

リンク:

highgui

名前型デフォルト説明
OPENCV_LEGACY_WAITKEYboolfalsewaitKey の戻り値を切り替える (デフォルト動作: return code & 0xff (または -1)、レガシー動作: return code)
$XDG_RUNTIME_DIRWaylandバックエンド固有 - プロセス間通信用の共有メモリマップトファイル (名前 opencv-shared-??????) を作成する
OPENCV_HIGHGUI_FB_MODEstringFB フレームバッファバックエンドの出力モードを選択する (FB - 通常のフレームバッファ、EMU - エミュレーション、内部チェックを行うが何もしない、XVFB - xvfb 仮想フレームバッファと互換)
OPENCV_HIGHGUI_FB_DEVICEファイルパス使用するフレームバッファデバイスへのパス (最初にチェックされる)
FRAMEBUFFERファイルパス/dev/fb0 OPENCV_HIGHGUI_FB_DEVICE と同じく、同じ目的でよく使われる変数 (2番目にチェックされる)

imgproc

名前型デフォルト説明
OPENCV_OPENCL_IMGPROC_MORPH_SPECIAL_KERNELbooltrue（Apple）、false（その他）小さなモルフォロジーカーネルに専用のOpenCLカーネルを使用する (Intelデバイス)
OPENCV_GAUSSIANBLUR_CHECK_BITEXACT_KERNELSboolfalse実行前にガウシアンカーネルを検証する (src が CV_16U、ビット完全版)

imgcodecs

名前型デフォルト説明
OPENCV_IMGCODECS_AVIF_MAX_FILE_SIZEnum64MB入力AVIFのサイズを制限する
OPENCV_IMGCODECS_WEBP_MAX_FILE_SIZEnum64MB入力WEBMのサイズを制限する
OPENCV_IO_MAX_IMAGE_PARAMSnum50 imwrite および imencode で許可される引数の最大数を制限する
OPENCV_IO_MAX_IMAGE_WIDTHnum1 << 20、大きなメモリ確保を避けるため入力画像のサイズを制限する
OPENCV_IO_MAX_IMAGE_HEIGHTnum1 << 20
OPENCV_IO_MAX_IMAGE_PIXELSnum1 << 30
OPENCV_IO_ENABLE_OPENEXRbooltrue (ビルドオプション OPENCV_IO_FORCE_OPENEXR を設定するか外部のOpenEXRを使用する場合)、false (それ以外)OpenEXRバックエンドを有効にする
OPENCV_IO_ENABLE_JASPERbooltrue (ビルドオプション OPENCV_IO_FORCE_JASPER を設定する場合)、false (それ以外)Jasperバックエンドを有効にする
Generated on Wed Dec 31 2025 07:26:22 for OpenCV by doxygen 1.12.0