perception/landmarks/camera/docs/usecase_e2e.md

Go to the documentation of this file.

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

@page landmarks_usecase_e2e Landmark Detector End-to-End Init Workflow

The following code snippet demonstrates the general structure of a program utilizing @ref landmarks_mainsection to detect landmarks from a single camera. Error handling is left out for clarity.

### Initializing the End-to-End Network

```{.cpp}
dwMapNetParams mapNetParams{};
dwMapNet_initDefaultParams(&mapNetParams, DW_MAPNET_TYPE_E2E, sdkHandle)
dwMapNet_initialize(&mapNetHandle, &mapNetParams, sdkHandle);
```

### Modifying Additional End-to-End Network Initialization Settings and Initialize Detector

```{.cpp}
uint32_t frameWidth;
uint32_t frameHeight;

// initialize parameters
dwLandmarkDetectorParams params;
dwLandmarkDetector_initializeDefaultParams(&params, frameWidth, frameHeight, sdkHandle));
dwLandmarkDetector_initializeFromMapNet(&landmarkDetectorHandle, mapNetHandle, params, frameWidth, frameHeight, sdkHandle);

// initialize end-to-end post processing parameters
dwLRNPostProcessingParam regressorParam;
dwLandmarkDetector_initializeDefaultRegressorParams(&regressorParam);
dwLandmarkDetector_setPostProcessingParam(regressorParam, landmarkDetectorHandle);
```

### Detecting Landmark Markings from a Video Sequence

```{.cpp}
dwLaneDetection lanes{};
dwLandmarkDetection landmarks{};
while (true)
{
    dwLandmarkDetector_detectLandmarks(&lanes, &landmarks, frame, landmarkDetectorHandle);
}

```

### Releasing the Module Handles when Finished

```{.cpp}
dwLandmarkDetector_release(landmarkDetectorHandle);
dwMapNet_release(mapNetHandle);
```

For a more detailed workflow, please refer to the following samples: 
- @ref dwx_landmark_detection_by_regressor_net_sample.