RoadMarkNet Workflow

Initialization

RoadMarkNet module creates an RoadMarkNet handle ( dwRoadMarkNetHandle_t ) that is owned by the application and must be released by the application when it's not needed anymore.

dwRoadMarkNetParams documents the specs of the RoadMarkNet model to be loaded and initialized. These parameters determine which precision, optimized processor, and type of RoadMarkNet to be loaded and can affect the speed of the inference significantly. To initialize RoadMarkNet parameters with default values:

dwStatus dwRoadMarkNet_initDefaultParams(dwRoadMarkNetParams* roadMarkNetParams,
                                         dwContextHandle_t ctx);

To initialize a pointer to RoadMarkNet handle with the designated values of dwRoadMarkNetParams call:

dwStatus dwRoadMarkNet_initialize(dwRoadMarkNetHandle_t* roadMarkNetHandle,
                                  const dwRoadMarkNetParams* roadMarkNetParams,
                                  dwContextHandle_t ctx);

An example code snippet to initialize a RoadMarkNet module with a customized FP32 RoadMarkNet model that is optimized to perform inference on GPU:

dwRoadMarkNetHandle_t roadMarkNet;
dwRoadMarkNetParams roadMarkNetParams{};
dwRoadMarkNet_initDefaultParams(&roadMarkNetParams, context);
roadMarkNetParams.networkModel = DW_ROADMARKNET_MODEL_CUSTOM;
roadMarkNetParams.networkCustomData = "my_RoadMarkNet_model";
roadMarkNetParams.batchSize = DW_ROADMARKNET_BATCH_SIZE_1;
CHECK_DW_ERROR(dwRoadMarkNet_initialize(&roadMarkNet, &roadMarkNetParams, context));

Note that dwRoadMarkNet_initDefaultParams() set roadMarkNetParams.networkPrecision, roadMarkNetParams.batchSize and roadMarkNetParams.processorType to their default values of DW_PRECISION_FP32, DW_ROADMARKNET_BATCH_SIZE_32 and DW_PROCESSOR_TYPE_GPU, respectively. It is assuming that "my_RoadMarknet_model" file exists in data/resources sub-directory.

Query Network Specs

With the provided APIs, you can query the input blob dimension that the initialized RoadMarkNet expects:

dwStatus dwRoadMarkNet_getInputBlobsize(dwBlobSize* inputBlobsize, dwRoadMarkNetHandle_t obj);

or get the pointer to the label of the provided class output class:

dwStatus dwRoadMarkNet_getClassLabel(const char** classLabel, dwRoadmarkType roadmarkType, dwRoadMarkNetHandle_t obj);

or even the meta data which contains preprocessing configuration of the network:

dwStatus dwRoadMarkNet_getDNNMetaData(dwDNNMetaData* metaData, dwRoadMarkNetHandle_t obj);

Release

Finally, to release the RoadMarkNet module at the end of the application:

dwStatus dwRoadMarkNet_release(dwRoadMarkNetHandle_t obj);