core/docs/usecase4.md

Go to the documentation of this file.

# Copyright (c) 2019-2020, NVIDIA CORPORATION.  All rights reserved.

@page core_usecase4 Logging

@note SW Release Applicability: This tutorial is applicable to modules in both **NVIDIA DriveWorks** and **NVIDIA DRIVE Software** releases.

The NVDIA<sup>&reg;</sup> DriveWorks library implements simple logging, by
passing a log message to a user-specified callback.

To initialize a logger instance, pass a callback method to the logger
initialization. The call must occur before SDK context initialization.
For more information, see @ref core_logger_group.

```{.cpp}
// initialize global logger instance to push all logs to the given callback
dwLogger_initialize(myLoggerCallback());

// log everything above WARN level, i.e. WARN and ERROR
dwLogger_setLogLevel(DW_LOG_WARN);

dwContextParameters sdkParams = {};
dwVersion sdkVersion;
dwGetVersion(&sdkVersion);
dwInitialize(&sdk, sdkVersion, &sdkParams);

```
@note Currently, logger is a global instance and is not bound to a specific SDK context.

A callback method that accepts log messages has the following syntax:

```{.cpp}
void myLoggerCallback(dwContextHandle_t context, dwLoggerVerbosity type, const char* msg)
{
   ...
}
```