OpenCV 4.12.0
开源计算机视觉
加载中...
搜索中...
无匹配项
命名空间 | 类 | 宏 | 函数
日志功能
核心功能 » 实用程序和系统函数与宏

详细描述

命名空间

命名空间  cv
 
命名空间  cv::utils::logging::internal
 

类

结构体  cv::utils::logging::LogTagAuto
 

宏

#define CV_LOG_DEBUG(标签, ...)
 
#define CV_LOG_ERROR(标签, ...)
 
#define CV_LOG_FATAL(标签, ...)
 
#define CV_LOG_IF_DEBUG(标签, 日志条件, ...)
 
#define CV_LOG_IF_ERROR(标签, 日志条件, ...)
 
#define CV_LOG_IF_FATAL(标签, 日志条件, ...)
 
#define CV_LOG_IF_INFO(标签, 日志条件, ...)
 
#define CV_LOG_IF_VERBOSE(标签, v, 日志条件, ...)
 
#define CV_LOG_IF_VERBOSE(标签, v, 日志条件, ...)
 
#define CV_LOG_IF_WARNING(标签, 日志条件, ...)
 
#define CV_LOG_INFO(标签, ...)
 
#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(标签, ...)
 
#define CV_LOG_ONCE_ERROR(标签, ...)
 
#define CV_LOG_ONCE_INFO(标签, ...)
 
#define CV_LOG_ONCE_VERBOSE(标签, v, ...)
 
#define CV_LOG_ONCE_VERBOSE(标签, v, ...)
 
#define CV_LOG_ONCE_WARNING(标签, ...)
 
#define CV_LOG_STRIP_LEVEL   CV_LOG_LEVEL_VERBOSE
 
#define CV_LOG_VERBOSE(标签, v, ...)
 
#define CV_LOG_VERBOSE(标签, v, ...)
 
#define CV_LOG_WARNING(标签, ...)
 
#define CV_LOG_WITH_TAG(标签, 消息级别, 额外检查0, 额外检查1, ...)
 
#define CV_LOGTAG_EXPAND_NAME(标签)
 
#define CV_LOGTAG_FALLBACK   nullptr
 
#define CV_LOGTAG_GLOBAL   cv::utils::logging::internal::getGlobalLogTag()
 
#define CV_LOGTAG_PTR_CAST(表达式)
 
#define CV_TRACE_ARG(参数ID)
 用于跟踪参数值的宏。
 
#define CV_TRACE_ARG_VALUE(参数ID, 参数名, 值)
 用于跟踪参数值的宏（展开版本）
 
#define CV_TRACE_FUNCTION()
 用于跟踪函数的宏。
 
#define CV_TRACE_FUNCTION_SKIP_NESTED()
 
#define CV_TRACE_REGION(作为静态字符串字面量的名称)
 
#define CV_TRACE_REGION_NEXT(作为静态字符串字面量的名称)
 

函数

LogLevel cv::utils::logging::getLogLevel ()
 
cv::utils::logging::LogLevel cv::utils::logging::getLogTagLevel (const char *标签)
 
void cv::utils::logging::registerLogTag (cv::utils::logging::LogTag *plogtag)
 
LogLevel cv::utils::logging::setLogLevel (LogLevel 日志级别)
 
void cv::utils::logging::setLogTagLevel (const char *标签, cv::utils::logging::LogLevel 级别)
 

宏定义文档

◆ CV_LOG_DEBUG

#define CV_LOG_DEBUG ( tag,
... )

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

值
CV_LOG_WITH_TAG(tag, cv::utils::logging::LOG_LEVEL_DEBUG, , , __VA_ARGS__)
CV_LOG_WITH_TAG
#define CV_LOG_WITH_TAG(tag, msgLevel, extra_check0, extra_check1,...)
定义 logger.hpp:145
cv::utils::logging::LOG_LEVEL_DEBUG
@ LOG_LEVEL_DEBUG
调试消息。在“Release”版本中禁用。
定义 logger.defines.hpp:31

◆ CV_LOG_ERROR

#define CV_LOG_ERROR ( tag,
... )

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

值
CV_LOG_WITH_TAG(tag, cv::utils::logging::LOG_LEVEL_ERROR, , , __VA_ARGS__)
cv::utils::logging::LOG_LEVEL_ERROR
@ LOG_LEVEL_ERROR
错误消息。
定义 logger.defines.hpp:28

◆ CV_LOG_FATAL

#define CV_LOG_FATAL ( tag,
... )

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

值
CV_LOG_WITH_TAG(tag, cv::utils::logging::LOG_LEVEL_FATAL, , , __VA_ARGS__)
cv::utils::logging::LOG_LEVEL_FATAL
@ LOG_LEVEL_FATAL
致命（严重）错误（无法恢复的内部错误）
定义 logger.defines.hpp:27

◆ CV_LOG_IF_DEBUG

#define CV_LOG_IF_DEBUG ( tag,
日志条件,
... )

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

值
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,
日志条件,
... )

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

值
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,
日志条件,
... )

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

值
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,
日志条件,
... )

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

值
CV_LOG_WITH_TAG(tag, cv::utils::logging::LOG_LEVEL_INFO, , CV__LOG_IF_CHECK(logging_cond), __VA_ARGS__)
cv::utils::logging::LOG_LEVEL_INFO
@ LOG_LEVEL_INFO
信息消息。
定义 logger.defines.hpp:30

◆ CV_LOG_IF_VERBOSE [1/2]

#define CV_LOG_IF_VERBOSE ( tag,
v,
日志条件,
... )

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

值
CV_LOG_WITH_TAG(tag, (cv::utils::logging::LOG_LEVEL_VERBOSE + (int)(v)), , CV__LOG_IF_CHECK(logging_cond), __VA_ARGS__)
cv::utils::logging::LOG_LEVEL_VERBOSE
@ LOG_LEVEL_VERBOSE
详细（跟踪）消息。需要详细级别。在“Release”构建中禁用。
定义 logger.defines.hpp:32

◆ CV_LOG_IF_VERBOSE [2/2]

#define CV_LOG_IF_VERBOSE ( tag,
v,
日志条件,
... )

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

◆ CV_LOG_IF_WARNING

#define CV_LOG_IF_WARNING ( tag,
日志条件,
... )

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

值
CV_LOG_WITH_TAG(tag, cv::utils::logging::LOG_LEVEL_WARNING, , CV__LOG_IF_CHECK(logging_cond), __VA_ARGS__)
cv::utils::logging::LOG_LEVEL_WARNING
@ LOG_LEVEL_WARNING
警告消息。
定义 logger.defines.hpp:29

◆ CV_LOG_INFO

#define CV_LOG_INFO ( tag,
... )

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

值
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>

值
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>

值
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>

值
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>

值
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>

值
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>

值
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>

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

◆ CV_LOG_WITH_TAG

#define CV_LOG_WITH_TAG ( tag,
消息级别,
额外检查0,
额外检查1,
... )

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

值
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_PTR_CAST
#define CV_LOGTAG_PTR_CAST(表达式)
定义 logger.hpp:109
CV_LOGTAG_EXPAND_NAME
#define CV_LOGTAG_EXPAND_NAME(标签)
定义 logger.hpp:131
CV_LOGTAG_GLOBAL
#define CV_LOGTAG_GLOBAL
定义 logger.hpp:143
CV_LOG_STRIP_LEVEL
#define CV_LOG_STRIP_LEVEL
定义 logger.hpp:105
CV_LOGTAG_FALLBACK
#define CV_LOGTAG_FALLBACK
定义 logger.hpp:137
cv::utils::logging::LogLevel
LogLevel
支持的日志级别及其语义。
定义 logger.defines.hpp:25
cv
定义 core.hpp:107
std
STL 命名空间。

◆ CV_LOGTAG_EXPAND_NAME

#define CV_LOGTAG_EXPAND_NAME ( tag)

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

值
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>

值
static_cast<const cv::utils::logging::LogTag*>(表达式)
cv::utils::logging::LogTag
定义 logtag.hpp:16

◆ CV_TRACE_ARG

#define CV_TRACE_ARG ( 参数ID)

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

用于跟踪参数值的宏。

◆ CV_TRACE_ARG_VALUE

#define CV_TRACE_ARG_VALUE ( 参数ID,
参数名,
值 )

#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 ( 作为静态字符串字面量的名称)

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

跟踪代码范围。

注意
此宏不支持动态名称（在栈或堆上）。此处仅使用字符串字面量，例如“initialize”。

◆ CV_TRACE_REGION_NEXT

#define CV_TRACE_REGION_NEXT ( 作为静态字符串字面量的名称)

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

标记当前已打开区域的完成并创建新区域

注意
此宏不支持动态名称（在栈或堆上）。此处仅使用字符串字面量，例如“step1”。

函数文档

◆ getLogLevel()

LogLevel cv::utils::logging::getLogLevel ( )

#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)

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

设置全局日志级别

返回
之前的日志级别

◆ setLogTagLevel()

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

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

生成于 2025 年 7 月 3 日星期四 12:14:36，由 OpenCV 通过 doxygen 1.12.0 生成