Add support for new APIs for parsing jpeg streams independently from decoder APIs (#24)

* Add support for new APIs for parsing jpeg streams independently from decoder APIs

* Update document and code clean-up

* code clean-up

src/rocjpeg_api_decoder_handle.h

@@ -0,0 +1,47 @@
+/*
+Copyright (c) 2024 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.
+*/
+
+#ifndef ROC_JPEG_DECODER_HANDLE_H
+#define ROC_JPEG_DECODER_HANDLE_H
+
+#pragma once
+
+#include "rocjpeg_decoder.h"
+
+/**
+ * @brief RocJpegDecoderHandle class
+ * This class wraps around RocJpegDecoder to decode a JPEG stream.
+ */
+class RocJpegDecoderHandle {
+    public:
+        explicit RocJpegDecoderHandle(RocJpegBackend backend, int device_id) : rocjpeg_decoder(std::make_shared<RocJpegDecoder>(backend, device_id)) {};
+        ~RocJpegDecoderHandle() { ClearErrors(); }
+        std::shared_ptr<RocJpegDecoder> rocjpeg_decoder;
+        bool NoError() { return error_.empty(); }
+        const char* ErrorMsg() { return error_.c_str(); }
+        void CaptureError(const std::string& err_msg) { error_ = err_msg; }
+    private:
+        void ClearErrors() { error_ = "";}
+        std::string error_;
+};
+
+#endif //ROC_JPEG_DECODER_HANDLE_H