ロギング機能

詳細説明

名前空間
namespace	cv
namespace	cv::utils::logging::internal

クラス
struct	cv::utils::logging::LogTagAuto

マクロ定義
#define	CV_LOG_DEBUG(tag, ...)
#define	CV_LOG_ERROR(tag, ...)
#define	CV_LOG_FATAL(tag, ...)
#define	CV_LOG_IF_DEBUG(tag, logging_cond, ...)
#define	CV_LOG_IF_ERROR(tag, logging_cond, ...)
#define	CV_LOG_IF_FATAL(tag, logging_cond, ...)
#define	CV_LOG_IF_INFO(tag, logging_cond, ...)
#define	CV_LOG_IF_VERBOSE(tag, v, logging_cond, ...)
#define	CV_LOG_IF_VERBOSE(tag, v, logging_cond, ...)
#define	CV_LOG_IF_WARNING(tag, logging_cond, ...)
#define	CV_LOG_INFO(tag, ...)
#define	CV_LOG_LEVEL_DEBUG   5
	デバッグメッセージ。「Release」ビルドでは無効。
#define	CV_LOG_LEVEL_ERROR   2
	エラーメッセージ。
#define	CV_LOG_LEVEL_FATAL   1
	致命的（クリティカル）エラー（回復不能な内部エラー）
#define	CV_LOG_LEVEL_INFO   4
	情報メッセージ。
#define	CV_LOG_LEVEL_SILENT   0
	setLogLevel() 呼び出しで使用するため
#define	CV_LOG_LEVEL_VERBOSE   6
	詳細（トレース）メッセージ。冗長レベルが必要。「Release」ビルドでは無効。
#define	CV_LOG_LEVEL_WARN   3
	警告メッセージ。
#define	CV_LOG_ONCE_DEBUG(tag, ...)
#define	CV_LOG_ONCE_ERROR(tag, ...)
#define	CV_LOG_ONCE_INFO(tag, ...)
#define	CV_LOG_ONCE_VERBOSE(tag, v, ...)
#define	CV_LOG_ONCE_VERBOSE(tag, v, ...)
#define	CV_LOG_ONCE_WARNING(tag, ...)
#define	CV_LOG_STRIP_LEVEL   CV_LOG_LEVEL_VERBOSE
#define	CV_LOG_VERBOSE(tag, v, ...)
#define	CV_LOG_VERBOSE(tag, v, ...)
#define	CV_LOG_WARNING(tag, ...)
#define	CV_LOG_WITH_TAG(tag, msgLevel, extra_check0, extra_check1, ...)
#define	CV_LOGTAG_EXPAND_NAME(tag)
#define	CV_LOGTAG_FALLBACK   nullptr
#define	CV_LOGTAG_GLOBAL   cv::utils::logging::internal::getGlobalLogTag()
#define	CV_LOGTAG_PTR_CAST(expr)
#define	CV_TRACE_ARG(arg_id)
	引数の値をトレースするマクロ。
#define	CV_TRACE_ARG_VALUE(arg_id, arg_name, value)
	引数の値をトレースするマクロ（展開版）
#define	CV_TRACE_FUNCTION()
	関数をトレースするマクロ。
#define	CV_TRACE_FUNCTION_SKIP_NESTED()
#define	CV_TRACE_REGION(name_as_static_string_literal)
#define	CV_TRACE_REGION_NEXT(name_as_static_string_literal)

関数
LogLevel	cv::utils::logging::getLogLevel ()
cv::utils::logging::LogLevel	cv::utils::logging::getLogTagLevel (const char *tag)
void	cv::utils::logging::registerLogTag (cv::utils::logging::LogTag *plogtag)
LogLevel	cv::utils::logging::setLogLevel (LogLevel logLevel)
void	cv::utils::logging::setLogTagLevel (const char *tag, cv::utils::logging::LogLevel level)

マクロ定義詳解

CV_LOG_DEBUG

#define CV_LOG_DEBUG	(		tag,
			... )

#include <opencv2/core/utils/logger.hpp>

Value:

CV_LOG_WITH_TAG(tag, cv::utils::logging::LOG_LEVEL_DEBUG, , , __VA_ARGS__)

CV_LOG_ERROR

#define CV_LOG_ERROR	(		tag,
			... )

#include <opencv2/core/utils/logger.hpp>

Value:

CV_LOG_WITH_TAG(tag, cv::utils::logging::LOG_LEVEL_ERROR, , , __VA_ARGS__)

CV_LOG_FATAL

#define CV_LOG_FATAL	(		tag,
			... )

#include <opencv2/core/utils/logger.hpp>

Value:

CV_LOG_WITH_TAG(tag, cv::utils::logging::LOG_LEVEL_FATAL, , , __VA_ARGS__)

CV_LOG_IF_DEBUG

#define CV_LOG_IF_DEBUG	(		tag,
			logging_cond,
			... )

#include <opencv2/core/utils/logger.hpp>

Value:

CV_LOG_WITH_TAG(tag, cv::utils::logging::LOG_LEVEL_DEBUG, , CV__LOG_IF_CHECK(logging_cond), __VA_ARGS__)

CV_LOG_IF_ERROR

#define CV_LOG_IF_ERROR	(		tag,
			logging_cond,
			... )

#include <opencv2/core/utils/logger.hpp>

Value:

CV_LOG_WITH_TAG(tag, cv::utils::logging::LOG_LEVEL_ERROR, , CV__LOG_IF_CHECK(logging_cond), __VA_ARGS__)

CV_LOG_IF_FATAL

#define CV_LOG_IF_FATAL	(		tag,
			logging_cond,
			... )

#include <opencv2/core/utils/logger.hpp>

Value:

CV_LOG_WITH_TAG(tag, cv::utils::logging::LOG_LEVEL_FATAL, , CV__LOG_IF_CHECK(logging_cond), __VA_ARGS__)

CV_LOG_IF_INFO

#define CV_LOG_IF_INFO	(		tag,
			logging_cond,
			... )

#include <opencv2/core/utils/logger.hpp>

Value:

CV_LOG_WITH_TAG(tag, cv::utils::logging::LOG_LEVEL_INFO, , CV__LOG_IF_CHECK(logging_cond), __VA_ARGS__)

CV_LOG_IF_VERBOSE [1/2]

#define CV_LOG_IF_VERBOSE	(		tag,
			v,
			logging_cond,
			... )

#include <opencv2/core/utils/logger.hpp>

Value:

CV_LOG_WITH_TAG(tag, (cv::utils::logging::LOG_LEVEL_VERBOSE + (int)(v)), , CV__LOG_IF_CHECK(logging_cond), __VA_ARGS__)

CV_LOG_IF_VERBOSE [2/2]

#define CV_LOG_IF_VERBOSE	(		tag,
			v,
			logging_cond,
			... )

#include <opencv2/core/utils/logger.hpp>

CV_LOG_IF_WARNING

#define CV_LOG_IF_WARNING	(		tag,
			logging_cond,
			... )

#include <opencv2/core/utils/logger.hpp>

Value:

CV_LOG_WITH_TAG(tag, cv::utils::logging::LOG_LEVEL_WARNING, , CV__LOG_IF_CHECK(logging_cond), __VA_ARGS__)

CV_LOG_INFO

#define CV_LOG_INFO	(		tag,
			... )

#include <opencv2/core/utils/logger.hpp>

Value:

CV_LOG_WITH_TAG(tag, cv::utils::logging::LOG_LEVEL_INFO, , , __VA_ARGS__)

CV_LOG_LEVEL_DEBUG

#define CV_LOG_LEVEL_DEBUG   5

#include <opencv2/core/utils/logger.defines.hpp>

デバッグメッセージ。「Release」ビルドでは無効。

CV_LOG_LEVEL_ERROR

#define CV_LOG_LEVEL_ERROR   2

#include <opencv2/core/utils/logger.defines.hpp>

エラーメッセージ。

CV_LOG_LEVEL_FATAL

#define CV_LOG_LEVEL_FATAL   1

#include <opencv2/core/utils/logger.defines.hpp>

致命的（クリティカル）エラー（回復不能な内部エラー）

CV_LOG_LEVEL_INFO

#define CV_LOG_LEVEL_INFO   4

#include <opencv2/core/utils/logger.defines.hpp>

情報メッセージ。

CV_LOG_LEVEL_SILENT

#define CV_LOG_LEVEL_SILENT   0

#include <opencv2/core/utils/logger.defines.hpp>

setLogLevel() 呼び出しで使用するため

CV_LOG_LEVEL_VERBOSE

#define CV_LOG_LEVEL_VERBOSE   6

#include <opencv2/core/utils/logger.defines.hpp>

詳細（トレース）メッセージ。冗長レベルが必要。「Release」ビルドでは無効。

CV_LOG_LEVEL_WARN

#define CV_LOG_LEVEL_WARN   3

#include <opencv2/core/utils/logger.defines.hpp>

警告メッセージ。

CV_LOG_ONCE_DEBUG

#define CV_LOG_ONCE_DEBUG	(		tag,
			... )

#include <opencv2/core/utils/logger.hpp>

Value:

CV_LOG_WITH_TAG(tag, cv::utils::logging::LOG_LEVEL_DEBUG, CV__LOG_ONCE_CHECK_PRE, CV__LOG_ONCE_CHECK_POST, __VA_ARGS__)

CV_LOG_ONCE_ERROR

#define CV_LOG_ONCE_ERROR	(		tag,
			... )

#include <opencv2/core/utils/logger.hpp>

Value:

CV_LOG_WITH_TAG(tag, cv::utils::logging::LOG_LEVEL_ERROR, CV__LOG_ONCE_CHECK_PRE, CV__LOG_ONCE_CHECK_POST, __VA_ARGS__)

CV_LOG_ONCE_INFO

#define CV_LOG_ONCE_INFO	(		tag,
			... )

#include <opencv2/core/utils/logger.hpp>

Value:

CV_LOG_WITH_TAG(tag, cv::utils::logging::LOG_LEVEL_INFO, CV__LOG_ONCE_CHECK_PRE, CV__LOG_ONCE_CHECK_POST, __VA_ARGS__)

CV_LOG_ONCE_VERBOSE [1/2]

#define CV_LOG_ONCE_VERBOSE	(		tag,
			v,
			... )

#include <opencv2/core/utils/logger.hpp>

Value:

CV_LOG_WITH_TAG(tag, (cv::utils::logging::LOG_LEVEL_VERBOSE + (int)(v)), CV__LOG_ONCE_CHECK_PRE, CV__LOG_ONCE_CHECK_POST, __VA_ARGS__)

CV_LOG_ONCE_VERBOSE [2/2]

#define CV_LOG_ONCE_VERBOSE	(		tag,
			v,
			... )

#include <opencv2/core/utils/logger.hpp>

CV_LOG_ONCE_WARNING

#define CV_LOG_ONCE_WARNING	(		tag,
			... )

#include <opencv2/core/utils/logger.hpp>

Value:

CV_LOG_WITH_TAG(tag, cv::utils::logging::LOG_LEVEL_WARNING, CV__LOG_ONCE_CHECK_PRE, CV__LOG_ONCE_CHECK_POST, __VA_ARGS__)

CV_LOG_STRIP_LEVEL

#define CV_LOG_STRIP_LEVEL   CV_LOG_LEVEL_VERBOSE

#include <opencv2/core/utils/logger.hpp>

CV_LOG_STRIP_LEVEL=CV_LOG_LEVEL_[DEBUG|INFO|WARN|ERROR|FATAL|SILENT] を定義すると、そのログレベルおよびそれ以前のログレベルのものをコンパイル時に除外する

CV_LOG_VERBOSE [1/2]

#define CV_LOG_VERBOSE	(		tag,
			v,
			... )

#include <opencv2/core/utils/logger.hpp>

Value:

CV_LOG_WITH_TAG(tag, (cv::utils::logging::LOG_LEVEL_VERBOSE + (int)(v)), , , __VA_ARGS__)

CV_LOG_VERBOSE [2/2]

#define CV_LOG_VERBOSE	(		tag,
			v,
			... )

#include <opencv2/core/utils/logger.hpp>

CV_LOG_WARNING

#define CV_LOG_WARNING	(		tag,
			... )

#include <opencv2/core/utils/logger.hpp>

Value:

CV_LOG_WITH_TAG(tag, cv::utils::logging::LOG_LEVEL_WARNING, , , __VA_ARGS__)

CV_LOG_WITH_TAG

#define CV_LOG_WITH_TAG	(		tag,
			msgLevel,
			extra_check0,
			extra_check1,
			... )

#include <opencv2/core/utils/logger.hpp>

Value:

 for(;;) { \
        extra_check0; \
 const auto cv_temp_msglevel = (cv::utils::logging::LogLevel)(msgLevel); \
        if (cv_temp_msglevel >= (CV_LOG_STRIP_LEVEL)) break; \
 auto cv_temp_logtagptr = CV_LOGTAG_PTR_CAST(CV_LOGTAG_EXPAND_NAME(tag)); \
        if (!cv_temp_logtagptr) cv_temp_logtagptr = CV_LOGTAG_PTR_CAST(CV_LOGTAG_FALLBACK); \
        if (!cv_temp_logtagptr) cv_temp_logtagptr = CV_LOGTAG_PTR_CAST(CV_LOGTAG_GLOBAL); \
        if (cv_temp_logtagptr && (cv_temp_msglevel > cv_temp_logtagptr->level)) break; \
        extra_check1; \
 std::stringstream cv_temp_logstream; \
        cv_temp_logstream << __VA_ARGS__; \
 cv::utils::logging::internal::writeLogMessageEx( \
            cv_temp_msglevel, \
            (cv_temp_logtagptr ? cv_temp_logtagptr->name : nullptr), \
            __FILE__, \
            __LINE__, \
            CV_Func, \
            cv_temp_logstream.str().c_str()); \
        break; \
    }

CV_LOGTAG_EXPAND_NAME

#define CV_LOGTAG_EXPAND_NAME

(

tag

)

#include <opencv2/core/utils/logger.hpp>

Value:

tag

CV_LOGTAG_FALLBACK

#define CV_LOGTAG_FALLBACK   nullptr

#include <opencv2/core/utils/logger.hpp>

CV_LOGTAG_GLOBAL

#define CV_LOGTAG_GLOBAL   cv::utils::logging::internal::getGlobalLogTag()

#include <opencv2/core/utils/logger.hpp>

CV_LOGTAG_PTR_CAST

#define CV_LOGTAG_PTR_CAST

(

expr

)

#include <opencv2/core/utils/logger.hpp>

Value:

static_cast<const cv::utils::logging::LogTag*>(expr)

CV_TRACE_ARG

#define CV_TRACE_ARG

(

arg_id

)

#include <opencv2/core/utils/trace.hpp>

引数の値をトレースするマクロ。

CV_TRACE_ARG_VALUE

#define CV_TRACE_ARG_VALUE	(		arg_id,
			arg_name,
			value )

#include <opencv2/core/utils/trace.hpp>

引数の値をトレースするマクロ（展開版）

CV_TRACE_FUNCTION

#define CV_TRACE_FUNCTION

(

)

#include <opencv2/core/utils/trace.hpp>

関数をトレースするマクロ。

CV_TRACE_FUNCTION_SKIP_NESTED

#define CV_TRACE_FUNCTION_SKIP_NESTED

(

)

#include <opencv2/core/utils/trace.hpp>

CV_TRACE_REGION

#define CV_TRACE_REGION

(

name_as_static_string_literal

)

#include <opencv2/core/utils/trace.hpp>

コードのスコープをトレースする。

覚え書き

このマクロでは（スタック上やヒープ上の）動的な名前はサポートされない。ここでは "initialize" のような文字列リテラルのみを使用すること。

CV_TRACE_REGION_NEXT

#define CV_TRACE_REGION_NEXT

(

name_as_static_string_literal

)

#include <opencv2/core/utils/trace.hpp>

現在開いている領域を完了とマークし、新しい領域を作成する

覚え書き

このマクロでは（スタック上やヒープ上の）動的な名前はサポートされない。ここでは "step1" のような文字列リテラルのみを使用すること。

関数詳解

getLogLevel()

LogLevel cv::utils::logging::getLogLevel

(

)

Python:
	cv.utils.logging.getLogLevel(		) ->	retval

#include <opencv2/core/utils/logger.hpp>

グローバルなロギングレベルを取得する

getLogTagLevel()

cv::utils::logging::LogLevel cv::utils::logging::getLogTagLevel

(

const char *

tag

)

#include <opencv2/core/utils/logger.hpp>

registerLogTag()

void cv::utils::logging::registerLogTag

(

cv::utils::logging::LogTag *

plogtag

)

#include <opencv2/core/utils/logger.hpp>

setLogLevel()

LogLevel cv::utils::logging::setLogLevel

(

LogLevel

logLevel

)

Python:
	cv.utils.logging.setLogLevel(	logLevel	) ->	retval

#include <opencv2/core/utils/logger.hpp>

グローバルなロギングレベルを設定する

戻り値

以前のロギングレベル

setLogTagLevel()

void cv::utils::logging::setLogTagLevel	(	const char *	tag,
		cv::utils::logging::LogLevel	level )

#include <opencv2/core/utils/logger.hpp>