print_scu.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_SERVICES_PRINT_SCU_HPP
#define PACS_SERVICES_PRINT_SCU_HPP
 
#include "print_scp.h"
 
#include "kcenon/pacs/core/dicom_dataset.h"
#include "kcenon/pacs/di/ilogger.h"
#include "kcenon/pacs/network/association.h"
#include "kcenon/pacs/network/dimse/dimse_message.h"
 
#include <atomic>
#include <chrono>
#include <memory>
#include <string>
#include <vector>
 
namespace kcenon::pacs::services {
 
// =============================================================================
// Print SCU Data Structures
// =============================================================================
 
struct print_result {
    std::string sop_instance_uid;
 
    uint16_t status{0};
 
    std::string error_comment;
 
    std::chrono::milliseconds elapsed{0};
 
    core::dicom_dataset response_data;
 
    [[nodiscard]] bool is_success() const noexcept {
        return status == 0x0000;
    }
 
    [[nodiscard]] bool is_warning() const noexcept {
        return (status & 0xF000) == 0xB000;
    }
 
    [[nodiscard]] bool is_error() const noexcept {
        return !is_success() && !is_warning();
    }
};
 
struct print_session_data {
    std::string sop_instance_uid;
 
    uint32_t number_of_copies{1};
 
    std::string print_priority{"MED"};
 
    std::string medium_type{"BLUE FILM"};
 
    std::string film_destination{"MAGAZINE"};
 
    std::string film_session_label;
};
 
struct print_film_box_data {
    std::string image_display_format{"STANDARD\\1,1"};
 
    std::string film_orientation{"PORTRAIT"};
 
    std::string film_size_id{"8INX10IN"};
 
    std::string magnification_type;
 
    std::string film_session_uid;
};
 
struct print_image_data {
    core::dicom_dataset pixel_data;
 
    uint16_t image_position{0};
};
 
struct print_scu_config {
    std::chrono::milliseconds timeout{30000};
 
    bool auto_generate_uid{true};
};
 
// =============================================================================
// Print SCU Class
// =============================================================================
 
class print_scu {
public:
    // =========================================================================
    // Construction
    // =========================================================================
 
    explicit print_scu(std::shared_ptr<di::ILogger> logger = nullptr);
 
    explicit print_scu(const print_scu_config& config,
                       std::shared_ptr<di::ILogger> logger = nullptr);
 
    ~print_scu() = default;
 
    // Non-copyable, non-movable (due to atomic members)
    print_scu(const print_scu&) = delete;
    print_scu& operator=(const print_scu&) = delete;
    print_scu(print_scu&&) = delete;
    print_scu& operator=(print_scu&&) = delete;
 
    // =========================================================================
    // Film Session Operations
    // =========================================================================
 
    [[nodiscard]] network::Result<print_result> create_film_session(
        network::association& assoc,
        const print_session_data& data);
 
    [[nodiscard]] network::Result<print_result> delete_film_session(
        network::association& assoc,
        std::string_view session_uid);
 
    // =========================================================================
    // Film Box Operations
    // =========================================================================
 
    [[nodiscard]] network::Result<print_result> create_film_box(
        network::association& assoc,
        const print_film_box_data& data);
 
    [[nodiscard]] network::Result<print_result> print_film_box(
        network::association& assoc,
        std::string_view film_box_uid);
 
    [[nodiscard]] network::Result<print_result> delete_film_box(
        network::association& assoc,
        std::string_view film_box_uid);
 
    // =========================================================================
    // Image Box Operations
    // =========================================================================
 
    [[nodiscard]] network::Result<print_result> set_image_box(
        network::association& assoc,
        std::string_view image_box_uid,
        const print_image_data& data,
        bool use_color = false);
 
    // =========================================================================
    // Printer Status
    // =========================================================================
 
    [[nodiscard]] network::Result<print_result> query_printer_status(
        network::association& assoc);
 
    // =========================================================================
    // Statistics
    // =========================================================================
 
    [[nodiscard]] size_t sessions_created() const noexcept;
    [[nodiscard]] size_t film_boxes_created() const noexcept;
    [[nodiscard]] size_t images_set() const noexcept;
    [[nodiscard]] size_t prints_executed() const noexcept;
    [[nodiscard]] size_t printer_queries() const noexcept;
    void reset_statistics() noexcept;
 
private:
    // =========================================================================
    // Private Implementation
    // =========================================================================
 
    [[nodiscard]] std::optional<uint8_t> find_print_context(
        network::association& assoc,
        std::string_view sop_class_uid) const;
 
    [[nodiscard]] std::string generate_uid() const;
 
    [[nodiscard]] uint16_t next_message_id() noexcept;
 
    // =========================================================================
    // Private Members
    // =========================================================================
 
    std::shared_ptr<di::ILogger> logger_;
 
    print_scu_config config_;
 
    std::atomic<uint16_t> message_id_counter_{1};
 
    std::atomic<size_t> sessions_created_{0};
    std::atomic<size_t> film_boxes_created_{0};
    std::atomic<size_t> images_set_{0};
    std::atomic<size_t> prints_executed_{0};
    std::atomic<size_t> printer_queries_{0};
};
 
}  // namespace kcenon::pacs::services
 
#endif  // PACS_SERVICES_PRINT_SCU_HPP