explicit_vr_big_endian_codec.h

Go to the documentation of this file.

// BSD 3-Clause License
// Copyright (c) 2021-2025, 🍀☀🌕🌥 🌊
// See the LICENSE file in the project root for full license information.
 
#ifndef PACS_ENCODING_EXPLICIT_VR_BIG_ENDIAN_CODEC_HPP
#define PACS_ENCODING_EXPLICIT_VR_BIG_ENDIAN_CODEC_HPP
 
#include <kcenon/pacs/core/dicom_dataset.h>
#include <kcenon/pacs/core/dicom_element.h>
#include <kcenon/pacs/core/result.h>
 
#include <cstdint>
#include <span>
#include <vector>
 
namespace kcenon::pacs::encoding {
 
class explicit_vr_big_endian_codec {
public:
    template <typename T>
    using result = kcenon::pacs::Result<T>;
 
    // ========================================================================
    // Dataset Encoding/Decoding
    // ========================================================================
 
    [[nodiscard]] static std::vector<uint8_t> encode(
        const core::dicom_dataset& dataset);
 
    [[nodiscard]] static result<core::dicom_dataset> decode(
        std::span<const uint8_t> data);
 
    // ========================================================================
    // Element Encoding/Decoding
    // ========================================================================
 
    [[nodiscard]] static std::vector<uint8_t> encode_element(
        const core::dicom_element& element);
 
    [[nodiscard]] static result<core::dicom_element> decode_element(
        std::span<const uint8_t>& data);
 
    // ========================================================================
    // Byte Order Conversion
    // ========================================================================
 
    [[nodiscard]] static std::vector<uint8_t> to_big_endian(
        vr_type vr, std::span<const uint8_t> data);
 
    [[nodiscard]] static std::vector<uint8_t> from_big_endian(
        vr_type vr, std::span<const uint8_t> data);
 
private:
    // Internal encoding helpers
    static void encode_sequence(std::vector<uint8_t>& buffer,
                                const core::dicom_element& element);
 
    static void encode_sequence_item(std::vector<uint8_t>& buffer,
                                     const core::dicom_dataset& item);
 
    // Internal decoding helpers
    static result<core::dicom_element> decode_undefined_length(
        core::dicom_tag tag, vr_type vr,
        std::span<const uint8_t>& data);
 
    static result<core::dicom_dataset> decode_sequence_item(
        std::span<const uint8_t>& data);
};
 
}  // namespace kcenon::pacs::encoding
 
#endif  // PACS_ENCODING_EXPLICIT_VR_BIG_ENDIAN_CODEC_HPP