Rr/roc video decode class (#20)

* WIP: class implementation

* add more definitions

* rocvideodecode implementation

* formatting fixes

* address review comments

[ROCm/rocdecode commit: d0e6743872]

projects/rocdecode/src/parser/h264_parser.cpp

@@ -49,4 +49,14 @@ rocDecStatus H264VideoParser::Initialize(RocdecParserParams *pParams) {
  */
 rocDecStatus H264VideoParser::ParseVideoData(RocdecSourceDataPacket *pData) {
     return ROCDEC_NOT_IMPLEMENTED;
-}
+}
+
+/**
+ * @brief function to uninitialize h264 parser
+ * 
+ * @return rocDecStatus 
+ */
+rocDecStatus H264VideoParser::UnInitialize() {
+  //todo::
+    return ROCDEC_NOT_IMPLEMENTED;
+}

projects/rocdecode/src/parser/h264_parser.h

@@ -45,6 +45,13 @@ public:
      * @return rocDecStatus: returns success on completion, else error_code for failure
      */
     virtual rocDecStatus ParseVideoData(RocdecSourceDataPacket *pData);
+    /**
+     * @brief function to uninitialize h264 parser
+     * 
+     * @return rocDecStatus 
+     */
+    virtual rocDecStatus UnInitialize();     // derived method
+
 
 private:    
 

projects/rocdecode/src/parser/hevc_parser.cpp

@@ -43,6 +43,17 @@ rocDecStatus HEVCVideoParser::Initialize(RocdecParserParams *p_params) {
     return ROCDEC_SUCCESS;
 }
 
+/**
+ * @brief function to uninitialize hevc parser
+ * 
+ * @return rocDecStatus 
+ */
+rocDecStatus HEVCVideoParser::UnInitialize() {
+    //todo:: do any uninitialization here
+    return ROCDEC_SUCCESS;
+}
+
+
 rocDecStatus HEVCVideoParser::ParseVideoData(RocdecSourceDataPacket *p_data) {
     bool status = ParseFrameData(p_data->payload, p_data->payload_size);
     if (!status) {

projects/rocdecode/src/parser/hevc_parser.h

@@ -59,12 +59,20 @@ public:
      */
     virtual rocDecStatus ParseVideoData(RocdecSourceDataPacket *p_data);
 
-    /*! \brief HEVCParser object destructor
+    /**
+     * @brief function to uninitialize hevc parser
+     * 
+     * @return rocDecStatus 
+     */
+    virtual rocDecStatus UnInitialize();     // derived method
+
+    /**
+     * @brief HEVCParser object destructor
      */
     virtual ~HEVCVideoParser();
 
 protected:
-    /*! \brief Enumerator for the NAL Unit types - ISO-IEC 14496-15-2004.pdf, page 14, table 1 " NAL unit types in elementary streams.
+    /*! \brief Enumerator for the NAL Unit types - ISO-IEC 14496-15-2004.pdf, page 14, table 1 " NAL unit types in elementary streams
      */
     enum NalUnitType {
         NAL_UNIT_CODED_SLICE_TRAIL_N = 0, // 0

projects/rocdecode/src/parser/parser_handle.h

@@ -36,6 +36,7 @@ public:
     const char* error_msg() { return error.c_str(); }
     void capture_error(const std::string& err_msg) { error = err_msg; }
     rocDecStatus ParseVideoData(RocdecSourceDataPacket *pPacket) { return roc_parser_->ParseVideoData(pPacket); }
+    rocDecStatus DestroyParser() { return destroy_parser(); };
 
 private:
     std::shared_ptr<RocVideoParser> roc_parser_ = nullptr;    // class instantiation
@@ -59,5 +60,15 @@ private:
                 THROW("rocParser Initialization failed with error: "+ TOSTR(ret));
         }
     }
+    rocDecStatus destroy_parser() {
+      rocDecStatus ret = ROCDEC_NOT_INITIALIZED;
+        if (roc_parser_ ) {
+            ret = roc_parser_->UnInitialize();
+            if (ret != ROCDEC_SUCCESS)
+                THROW("rocParser UnInitialization failed with error: "+ TOSTR(ret));
+        }
+        return ret;
+    }
+
     std::string error;
 };

projects/rocdecode/src/parser/roc_video_parser.h

@@ -39,6 +39,7 @@ public:
     RocdecParserParams *GetParserParams() {return parser_params_;};
     virtual rocDecStatus Initialize(RocdecParserParams *pParams);
     virtual rocDecStatus ParseVideoData(RocdecSourceDataPacket *pData) = 0;     // pure virtual: implemented by derived class
+    virtual rocDecStatus UnInitialize() = 0;     // pure virtual: implemented by derived class
 
 protected:
     RocdecParserParams *parser_params_ = nullptr;

projects/rocdecode/src/parser/rocparser_api.cpp

@@ -65,3 +65,23 @@ rocDecParseVideoData(RocdecVideoParser handle, RocdecSourceDataPacket *pPacket)
     }
     return ret;  
 }
+
+/************************************************************************************************/
+//! \ingroup FUNCTS
+//! \fn rocDecStatus ROCDECAPI rocDecDestroyVideoParser(RocdecVideoParser handle)
+//! Destroy the video parser object
+/************************************************************************************************/
+extern rocDecStatus ROCDECAPI
+rocDecDestroyVideoParser(RocdecVideoParser handle) {
+    auto parser_hdl = static_cast<RocParserHandle *> (handle);
+    rocDecStatus ret;
+    try {
+        ret = parser_hdl->DestroyParser();
+    }
+    catch(const std::exception& e) {
+        parser_hdl->capture_error(e.what());
+        ERR(e.what())
+        return ROCDEC_RUNTIME_ERROR;
+    }
+    return ret;
+}