Namespaces
namespace	colors
	ANSI escape codes for terminal colors.

namespace	events

namespace	sop_class

Classes
struct	access_control_config
	Access control configuration. More...

struct	anonymization_config
	Anonymization configuration. More...

class	config_loader

struct	database_config
	Database configuration for index storage. More...

struct	image_params
	Image parameters for test data generation. More...

struct	logging_config
	Logging configuration. More...

class	mini_pacs

struct	mini_pacs_config
	Configuration options for Mini PACS. More...

struct	mini_pacs_statistics
	Runtime statistics for Mini PACS operations. More...

struct	monitoring_config
	Health monitoring configuration. More...

struct	mpps_entry
	MPPS instance for tracking procedure progress. More...

struct	patient_info
	Patient information for test data generation. More...

struct	production_config
	Complete production PACS configuration. More...

class	production_pacs

struct	production_statistics
	Extended statistics for production PACS. More...

struct	rest_api_config
	REST API server configuration. More...

class	scoped_signal_handler

struct	security_config
	Complete security configuration. More...

struct	server_config
	DICOM server configuration. More...

class	signal_handler

struct	storage_config
	File storage configuration. More...

struct	study_info
	Study information for test data generation. More...

class	test_data_generator

struct	tls_config
	TLS security configuration for DICOM connections. More...

struct	worklist_entry
	Worklist item for MWL queries. More...

Functions
auto	supports_color () noexcept -> bool
	Check if the terminal supports ANSI colors.

void	set_color_enabled (bool enabled)
	Enable or disable color output globally.

auto	is_color_enabled () noexcept -> bool
	Check if colors are currently enabled.

void	print_header (std::string_view title)
	Print a header/title with decorative border.

void	print_section (std::string_view title)
	Print a section header.

void	print_success (std::string_view message)
	Print a success message.

void	print_error (std::string_view message)
	Print an error message.

void	print_warning (std::string_view message)
	Print a warning message.

void	print_info (std::string_view message)
	Print an informational message.

void	print_debug (std::string_view message)
	Print a debug message.

void	print_dataset_summary (const core::dicom_dataset &ds)
	Print a summary of a DICOM dataset.

void	print_dataset_elements (const core::dicom_dataset &ds, size_t max_value_length=60)
	Print all elements in a DICOM dataset.

void	print_box (const std::vector< std::string > &lines)
	Print text in a decorative box.

void	print_table (std::string_view title, const std::vector< std::pair< std::string, std::string > > &rows)
	Print a key-value table.

void	print_progress (size_t current, size_t total, int width=40, std::string_view label="Progress")
	Print a progress bar.

void	clear_line ()
	Clear the current line (for updating progress)

auto	format_bytes (uint64_t bytes) -> std::string
	Format a byte size for human-readable display.

auto	format_duration (uint64_t milliseconds) -> std::string
	Format a duration in milliseconds.

auto	center_text (std::string_view text, size_t width) -> std::string
	Center a string within a given width.

auto	truncate (std::string_view text, size_t max_length, std::string_view suffix="...") -> std::string
	Truncate a string to a maximum length.

Function Documentation

◆ center_text()

auto kcenon::pacs::samples::center_text	(	std::string_view	text,
		size_t	width ) -> std::string

nodiscard

Center a string within a given width.

Parameters

text	The text to center
width	The total width

Returns: Centered string with padding

Definition at line 346 of file console_utils.cpp.

                                                                 {
    if (text.length() >= width) {
        return std::string{text.substr(0, width)};
    }
 
    size_t padding = (width - text.length()) / 2;
    return std::string(padding, ' ') + std::string{text} +
           std::string(width - padding - text.length(), ' ');
}

Referenced by print_header().

Here is the caller graph for this function:

◆ clear_line()

void kcenon::pacs::samples::clear_line ( )

Clear the current line (for updating progress)

Definition at line 302 of file console_utils.cpp.

                  {
    std::cout << "\r" << std::string(kDefaultWidth, ' ') << "\r" << std::flush;
}

◆ format_bytes()

auto kcenon::pacs::samples::format_bytes ( uint64_t bytes ) -> std::string

nodiscard

Format a byte size for human-readable display.

Parameters

bytes Number of bytes

Returns: Formatted string (e.g., "1.5 MB", "256 KB")

Definition at line 310 of file console_utils.cpp.

                                               {
    constexpr uint64_t KB = 1024;
    constexpr uint64_t MB = KB * 1024;
    constexpr uint64_t GB = MB * 1024;
 
    std::ostringstream oss;
    oss << std::fixed << std::setprecision(1);
 
    if (bytes >= GB) {
        oss << static_cast<double>(bytes) / static_cast<double>(GB) << " GB";
    } else if (bytes >= MB) {
        oss << static_cast<double>(bytes) / static_cast<double>(MB) << " MB";
    } else if (bytes >= KB) {
        oss << static_cast<double>(bytes) / static_cast<double>(KB) << " KB";
    } else {
        oss << bytes << " B";
    }
 
    return oss.str();
}

◆ format_duration()

auto kcenon::pacs::samples::format_duration ( uint64_t milliseconds ) -> std::string

nodiscard

Format a duration in milliseconds.

Parameters

milliseconds Duration in milliseconds

Returns: Formatted string (e.g., "1.5s", "250ms")

Definition at line 331 of file console_utils.cpp.

                                                         {
    std::ostringstream oss;
    oss << std::fixed << std::setprecision(1);
 
    if (milliseconds >= 60000) {
        oss << static_cast<double>(milliseconds) / 60000.0 << " min";
    } else if (milliseconds >= 1000) {
        oss << static_cast<double>(milliseconds) / 1000.0 << " s";
    } else {
        oss << milliseconds << " ms";
    }
 
    return oss.str();
}

◆ is_color_enabled()

auto kcenon::pacs::samples::is_color_enabled ( ) -> bool

nodiscardnoexcept

Check if colors are currently enabled.

Returns: true if colors are enabled

Definition at line 92 of file console_utils.cpp.

                                         {
    if (!g_color_checked) {
        g_color_enabled = supports_color();
        g_color_checked = true;
    }
    return g_color_enabled;
}

References supports_color().

Here is the call graph for this function:

◆ print_box()

void kcenon::pacs::samples::print_box ( const std::vector< std::string > & lines )

Print text in a decorative box.

Parameters

lines Vector of text lines to display

Example output: ┌─────────────────────────────────┐ │ Line 1 │ │ Line 2 │ └─────────────────────────────────┘

Definition at line 228 of file console_utils.cpp.

                                                  {
    if (lines.empty()) {
        return;
    }
 
    // Find maximum line length
    size_t max_len = 0;
    for (const auto& line : lines) {
        max_len = std::max(max_len, line.length());
    }
    max_len = std::min(max_len, static_cast<size_t>(kDefaultWidth - 4));
 
    std::cout << color(colors::dim);
    std::cout << "+" << std::string(max_len + 2, '-') << "+\n";
    for (const auto& line : lines) {
        std::cout << "| " << std::left << std::setw(static_cast<int>(max_len))
                  << truncate(line, max_len) << " |\n";
    }
    std::cout << "+" << std::string(max_len + 2, '-') << "+\n";
    std::cout << color(colors::reset);
}

References color, kcenon::pacs::samples::colors::dim, kcenon::pacs::samples::colors::reset, and truncate().

Referenced by main(), and main().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ print_dataset_elements()

void kcenon::pacs::samples::print_dataset_elements	(	const core::dicom_dataset &	ds,
		size_t	max_value_length = 60 )

Print all elements in a DICOM dataset.

Parameters

ds	The dataset to display
max_value_length	Maximum length for value display (truncated if longer)

Displays all elements with tag, VR, and value.

Definition at line 201 of file console_utils.cpp.

                                                     {
    std::cout << color(colors::bold)
              << std::left << std::setw(14) << "Tag"
              << std::setw(6) << "VR"
              << "Value"
              << color(colors::reset) << "\n";
    std::cout << std::string(kDefaultWidth, '-') << "\n";
 
    for (const auto& [tag, element] : ds) {
        std::cout << color(colors::cyan) << tag.to_string() << color(colors::reset)
                  << "  ";
 
        std::cout << color(colors::yellow)
                  << std::setw(4) << encoding::to_string(element.vr())
                  << color(colors::reset) << "  ";
 
        auto value_result = element.as_string();
        std::string value = value_result.is_ok() ? value_result.value() : "<binary>";
        std::cout << truncate(value, max_value_length) << "\n";
    }
}

References kcenon::pacs::samples::colors::bold, color, kcenon::pacs::samples::colors::cyan, kcenon::pacs::samples::colors::reset, kcenon::pacs::encoding::to_string(), truncate(), and kcenon::pacs::samples::colors::yellow.

Here is the call graph for this function:

◆ print_dataset_summary()

void kcenon::pacs::samples::print_dataset_summary ( const core::dicom_dataset & ds )

Print a summary of a DICOM dataset.

Parameters

ds	The dataset to summarize

Displays key patient, study, series, and image information in a formatted table.

Definition at line 164 of file console_utils.cpp.

                                                        {
    using namespace core::tags;
 
    std::vector<std::pair<std::string, std::string>> patient_rows = {
        {"Patient Name", ds.get_string(patient_name)},
        {"Patient ID", ds.get_string(patient_id)},
        {"Birth Date", ds.get_string(patient_birth_date)},
        {"Sex", ds.get_string(patient_sex)},
    };
    print_table("Patient", patient_rows);
 
    std::vector<std::pair<std::string, std::string>> study_rows = {
        {"Study UID", truncate(ds.get_string(study_instance_uid), 40)},
        {"Study Date", ds.get_string(study_date)},
        {"Accession #", ds.get_string(accession_number)},
        {"Description", ds.get_string(study_description)},
    };
    print_table("Study", study_rows);
 
    std::vector<std::pair<std::string, std::string>> series_rows = {
        {"Series UID", truncate(ds.get_string(series_instance_uid), 40)},
        {"Modality", ds.get_string(modality)},
        {"Series #", ds.get_string(series_number)},
        {"Description", ds.get_string(series_description)},
    };
    print_table("Series", series_rows);
 
    std::vector<std::pair<std::string, std::string>> image_rows = {
        {"SOP Instance", truncate(ds.get_string(sop_instance_uid), 40)},
        {"Rows", ds.get_string(rows)},
        {"Columns", ds.get_string(columns)},
        {"Bits Allocated", ds.get_string(bits_allocated)},
        {"Photometric", ds.get_string(photometric_interpretation)},
    };
    print_table("Image", image_rows);
}

References kcenon::pacs::core::dicom_dataset::get_string(), print_table(), and truncate().

Here is the call graph for this function:

◆ print_debug()

void kcenon::pacs::samples::print_debug ( std::string_view message )

Print a debug message.

Parameters

message The message text

Prints with dim/gray color.

Definition at line 155 of file console_utils.cpp.

                                         {
    std::cout << color(colors::dim) << "[DEBUG] " << message
              << color(colors::reset) << "\n";
}

References color, kcenon::pacs::samples::colors::dim, and kcenon::pacs::samples::colors::reset.

◆ print_error()

void kcenon::pacs::samples::print_error ( std::string_view message )

Print an error message.

Parameters

message The message text

Prints with red color and X symbol.

Definition at line 140 of file console_utils.cpp.

                                         {
    std::cout << color(colors::red) << "[ERROR] " << color(colors::reset)
              << message << "\n";
}

References color, kcenon::pacs::samples::colors::red, and kcenon::pacs::samples::colors::reset.

Referenced by main(), and main().

Here is the caller graph for this function:

◆ print_header()

void kcenon::pacs::samples::print_header ( std::string_view title )

Print a header/title with decorative border.

Parameters

title The title text

Example output: ╔══════════════════════════════════════════════════════════════════════════╗ ║ PACS System Sample Application ║ ╚══════════════════════════════════════════════════════════════════════════╝

Definition at line 118 of file console_utils.cpp.

                                        {
    std::cout << color(colors::bold) << color(colors::cyan);
    std::cout << "\n";
    std::cout << std::string(kDefaultWidth, '=') << "\n";
    std::cout << center_text(title, kDefaultWidth) << "\n";
    std::cout << std::string(kDefaultWidth, '=') << "\n";
    std::cout << color(colors::reset) << "\n";
}

References kcenon::pacs::samples::colors::bold, center_text(), color, kcenon::pacs::samples::colors::cyan, and kcenon::pacs::samples::colors::reset.

Referenced by main(), and main().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ print_info()

void kcenon::pacs::samples::print_info ( std::string_view message )

Print an informational message.

Parameters

message The message text

Prints with cyan color and info symbol.

Definition at line 150 of file console_utils.cpp.

                                        {
    std::cout << color(colors::cyan) << "[INFO] " << color(colors::reset)
              << message << "\n";
}

References color, kcenon::pacs::samples::colors::cyan, and kcenon::pacs::samples::colors::reset.

Referenced by main().

Here is the caller graph for this function:

◆ print_progress()

void kcenon::pacs::samples::print_progress	(	size_t	current,
		size_t	total,
		int	width = 40,
		std::string_view	label = "Progress" )

Print a progress bar.

Parameters

current	Current value
total	Total value
width	Width of the progress bar in characters
label	Optional label to display

Example output: Processing: [████████████░░░░░░░░] 60% (6/10)

Definition at line 278 of file console_utils.cpp.

                                          {
    if (total == 0) {
        return;
    }
 
    double progress = static_cast<double>(current) / static_cast<double>(total);
    int filled = static_cast<int>(progress * width);
    int percent = static_cast<int>(progress * 100.0);
 
    std::cout << "\r" << label << ": [";
    std::cout << color(colors::green);
    for (int i = 0; i < filled; ++i) {
        std::cout << "#";
    }
    std::cout << color(colors::dim);
    for (int i = filled; i < width; ++i) {
        std::cout << "-";
    }
    std::cout << color(colors::reset);
    std::cout << "] " << std::setw(3) << percent << "% ("
              << current << "/" << total << ")" << std::flush;
}

References color, kcenon::pacs::samples::colors::dim, kcenon::pacs::samples::colors::green, and kcenon::pacs::samples::colors::reset.

◆ print_section()

void kcenon::pacs::samples::print_section ( std::string_view title )

Print a section header.

Parameters

title The section title

Example output: ─── Configuration ───────────────────────────────────────────────────────────

Definition at line 127 of file console_utils.cpp.

                                         {
    std::string line = "--- " + std::string(title) + " ";
    line += std::string(kDefaultWidth - line.length(), '-');
 
    std::cout << "\n" << color(colors::bold) << color(colors::blue)
              << line << color(colors::reset) << "\n\n";
}

References kcenon::pacs::samples::colors::blue, kcenon::pacs::samples::colors::bold, color, and kcenon::pacs::samples::colors::reset.

Referenced by main(), and main().

Here is the caller graph for this function:

◆ print_success()

void kcenon::pacs::samples::print_success ( std::string_view message )

Print a success message.

Parameters

message The message text

Prints with green color and checkmark symbol.

Definition at line 135 of file console_utils.cpp.

                                           {
    std::cout << color(colors::green) << "[OK] " << color(colors::reset)
              << message << "\n";
}

References color, kcenon::pacs::samples::colors::green, and kcenon::pacs::samples::colors::reset.

Referenced by main(), and main().

Here is the caller graph for this function:

◆ print_table()

void kcenon::pacs::samples::print_table	(	std::string_view	title,
		const std::vector< std::pair< std::string, std::string > > &	rows )

Print a key-value table.

Parameters

title	Table title
rows	Vector of {key, value} pairs

Example output: ┌─ Patient Information ───────────┐ │ Name: DOE^JOHN │ │ ID: PAT001 │ │ Sex: M │ └─────────────────────────────────┘

Definition at line 250 of file console_utils.cpp.

                                                                       {
    if (rows.empty()) {
        return;
    }
 
    // Find maximum key length
    size_t max_key_len = 0;
    for (const auto& [key, _] : rows) {
        max_key_len = std::max(max_key_len, key.length());
    }
 
    std::cout << color(colors::bold) << color(colors::magenta)
              << title << ":" << color(colors::reset) << "\n";
 
    for (const auto& [key, value] : rows) {
        std::cout << "  " << color(colors::dim)
                  << std::right << std::setw(static_cast<int>(max_key_len)) << key
                  << color(colors::reset) << ": "
                  << value << "\n";
    }
    std::cout << "\n";
}

References kcenon::pacs::samples::colors::bold, color, kcenon::pacs::samples::colors::dim, kcenon::pacs::samples::colors::magenta, and kcenon::pacs::samples::colors::reset.

Referenced by main(), main(), and print_dataset_summary().

Here is the caller graph for this function:

◆ print_warning()

void kcenon::pacs::samples::print_warning ( std::string_view message )

Print a warning message.

Parameters

message The message text

Prints with yellow color and warning symbol.

Definition at line 145 of file console_utils.cpp.

                                           {
    std::cout << color(colors::yellow) << "[WARN] " << color(colors::reset)
              << message << "\n";
}

References color, kcenon::pacs::samples::colors::reset, and kcenon::pacs::samples::colors::yellow.

◆ set_color_enabled()

void kcenon::pacs::samples::set_color_enabled ( bool enabled )

Enable or disable color output globally.

Parameters

enabled Whether to enable colors

When disabled, all color functions will output plain text.

Definition at line 87 of file console_utils.cpp.

                                     {
    g_color_enabled = enabled;
    g_color_checked = true;
}

◆ supports_color()

auto kcenon::pacs::samples::supports_color ( ) -> bool

nodiscardnoexcept

Check if the terminal supports ANSI colors.

Returns: true if ANSI colors are supported

Checks environment variables and terminal type to determine support.

Definition at line 41 of file console_utils.cpp.

                                       {
    // Check if stdout is a terminal
    if (!isatty(fileno(stdout))) {
        return false;
    }
 
#ifdef _WIN32
    // Enable virtual terminal processing on Windows 10+
    HANDLE hOut = GetStdHandle(STD_OUTPUT_HANDLE);
    if (hOut == INVALID_HANDLE_VALUE) {
        return false;
    }
 
    DWORD dwMode = 0;
    if (!GetConsoleMode(hOut, &dwMode)) {
        return false;
    }
 
    dwMode |= ENABLE_VIRTUAL_TERMINAL_PROCESSING;
    if (!SetConsoleMode(hOut, dwMode)) {
        // Fallback: check if TERM is set (e.g., running in mintty)
        const char* term = std::getenv("TERM");
        return term != nullptr;
    }
    return true;
#else
    // Check common environment variables
    const char* term = std::getenv("TERM");
    if (term == nullptr) {
        return false;
    }
 
    // Check for dumb terminal
    if (std::string_view{term} == "dumb") {
        return false;
    }
 
    // Check for NO_COLOR environment variable
    if (std::getenv("NO_COLOR") != nullptr) {
        return false;
    }
 
    return true;
#endif
}

Referenced by is_color_enabled().

Here is the caller graph for this function:

◆ truncate()

auto kcenon::pacs::samples::truncate	(	std::string_view	text,
		size_t	max_length,
		std::string_view	suffix = "..." ) -> std::string

nodiscard

Truncate a string to a maximum length.

Parameters

text	The text to truncate
max_length	Maximum length
suffix	Suffix to add when truncated (default: "...")

Returns: Truncated string

Definition at line 356 of file console_utils.cpp.

                                                  {
    if (text.length() <= max_length) {
        return std::string{text};
    }
 
    if (max_length <= suffix.length()) {
        return std::string{suffix.substr(0, max_length)};
    }
 
    return std::string{text.substr(0, max_length - suffix.length())} +
           std::string{suffix};
}

Referenced by print_box(), print_dataset_elements(), and print_dataset_summary().

Here is the caller graph for this function:

Namespaces

Classes

Functions

Function Documentation

◆ center_text()

◆ clear_line()

◆ format_bytes()

◆ format_duration()

◆ is_color_enabled()

◆ print_box()

◆ print_dataset_elements()

◆ print_dataset_summary()

◆ print_debug()

◆ print_error()

◆ print_header()

◆ print_info()

◆ print_progress()

◆ print_section()

◆ print_success()

◆ print_table()

◆ print_warning()

◆ set_color_enabled()

◆ supports_color()

◆ truncate()