rocDecode api defintions added for decoder and parser (#6)

* rocDecode api defintions added for decoder and parser

* addressed review comments and changed struct names to CamelCase

* minot reformatting

src/parser/parser_handle.h

@@ -0,0 +1,61 @@
+/*
+Copyright (c) 2023 - 2023 Advanced Micro Devices, Inc. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+*/
+#pragma once
+
+#include <memory>
+#include <string>
+#include "rocparser.h"
+
+class RocVideoParser {
+public:
+    RocVideoParser() {};    // default constructor
+    RocVideoParser(RocdecParserParams *pParams): parser_params_(*pParams) {};
+    ~RocVideoParser();
+    void SetParserParams(RocdecParserParams *pParams) { parser_params_ = *pParams; };
+    RocdecParserParams *GetParserParams() {return &parser_params_;};
+    rocDecStatus ParseVideoData(RocdecSourceDataPacket *pData);
+
+private:
+    RocdecParserParams parser_params_;
+};
+
+struct RocParserHandle {
+public:    
+    explicit RocParserHandle() {};   // default constructor
+    ~RocParserHandle() { clear_errors(); }
+    std::shared_ptr<RocVideoParser> roc_parser;    // class instantiation
+    bool no_error() { return error.empty(); }
+    const char* error_msg() { return error.c_str(); }
+    void capture_error(const std::string& err_msg) { error = err_msg; }
+    bool set_parser_params(RocdecParserParams *pParams) {
+      if(roc_parser) {
+        roc_parser->SetParserParams(pParams); 
+        return true;
+      } else {
+         return false;
+      }
+    }
+
+private:
+    void clear_errors() { error = "";}
+    std::string error;
+};

src/parser/roc_video_parser.cpp

@@ -0,0 +1,36 @@
+/*
+Copyright (c) 2023 - 2023 Advanced Micro Devices, Inc. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+*/
+#include "rocparser.h"
+#include "parser_handle.h"
+
+
+
+/**
+ * @brief 
+ * 
+ * @param pData 
+ * @return rocDecodeStatus 
+ */
+rocDecStatus RocVideoParser::ParseVideoData(RocdecSourceDataPacket *pData) {  
+    // todo:
+    return ROCDEC_SUCCESS;
+}

src/parser/rocparser_api.cpp

@@ -0,0 +1,71 @@
+/*
+Copyright (c) 2023 - 2023 Advanced Micro Devices, Inc. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+*/
+#include "parser_handle.h"
+#include "../commons.h"
+
+
+/************************************************************************************************/
+//! \ingroup FUNCTS
+//! \fn rocParserStatus ROCDECAPI rocDecCreateVideoParser(RocdecVideoParser *pHandle, RocdecParserParams *pParams)
+//! Create video parser object and initialize
+/************************************************************************************************/
+rocDecStatus ROCDECAPI 
+rocDecCreateVideoParser(RocdecVideoParser *pHandle, RocdecParserParams *pParams) {
+    RocdecVideoParser handle = nullptr;
+    try {
+        handle = new RocParserHandle();
+    } 
+    catch(const std::exception& e) {
+        ERR( STR("Failed to init the rocDecode handle, ") + STR(e.what()))
+    }
+    //set params for the handle
+    auto parser_handle = static_cast<RocParserHandle *> (handle);
+    if (!parser_handle->set_parser_params(pParams))
+        return ROCDEC_INVALID_PARAMETER;
+    *pHandle = handle;
+    return rocDecStatus::ROCDEC_SUCCESS;
+}
+
+/************************************************************************************************/
+//! \ingroup FUNCTS
+//! \fn rocParserStatus ROCDECAPI rocDecParseVideoData(RocdecVideoParser handle, RocdecSourceDataPacket *pPacket)
+//! Parse the video data from source data packet in pPacket 
+//! Extracts parameter sets like SPS, PPS, bitstream etc. from pPacket and 
+//! calls back pfnDecodePicture with RocdecPicParams data for kicking of HW decoding
+//! calls back pfnSequenceCallback with RocdecVideoFormat data for initial sequence header or when
+//! the decoder encounters a video format change
+//! calls back pfnDisplayPicture with ROCDECPARSERDISPINFO data to display a video frame
+/************************************************************************************************/
+rocDecStatus ROCDECAPI
+rocDecParseVideoData(RocdecVideoParser handle, RocdecSourceDataPacket *pPacket) {
+    auto parser_hdl = static_cast<RocParserHandle *> (handle);
+    rocDecStatus ret;
+    try {
+        ret = parser_hdl->roc_parser->ParseVideoData(pPacket);
+    }
+    catch(const std::exception& e) {
+        parser_hdl->capture_error(e.what());
+        ERR(e.what())
+        return ROCDEC_RUNTIME_ERROR;
+    }
+    return ret;  
+}