/*
 *
 *  Copyright (C) 2015-2025, J. Riesmeier, Oldenburg, Germany
 *  All rights reserved.  See COPYRIGHT file for details.
 *
 *  Source file for class CID7551_GenericPurposeOfReferenceToImagesAndCoordinatesInMeasurement
 *
 *  Generated automatically from DICOM PS 3.16-2025e
 *  File created on 2025-11-21 12:16:56 by J. Riesmeier
 *
 */


#include "dcmtk/config/osconfig.h"    /* make sure OS specific configuration is included first */

#include "dcmtk/dcmsr/cmr/cid7551.h"


// general information on CID 7551 (Generic Purpose of Reference to Images and Coordinates in Measurement)
#define CONTEXT_GROUP_NUMBER  "7551"
#define CONTEXT_GROUP_KEYWORD "GenericPurposeOfReferenceToImagesAndCoordinatesInMeasurement"
#define CONTEXT_GROUP_VERSION "20200920"
#define CONTEXT_GROUP_UID     "1.2.840.10008.6.1.1343"
#define CONTEXT_GROUP_TYPE    OFTrue  /* extensible */

// initialize global/static variable
CID7551_GenericPurposeOfReferenceToImagesAndCoordinatesInMeasurement::CodeList *CID7551_GenericPurposeOfReferenceToImagesAndCoordinatesInMeasurement::Codes = NULL;


CID7551_GenericPurposeOfReferenceToImagesAndCoordinatesInMeasurement::CID7551_GenericPurposeOfReferenceToImagesAndCoordinatesInMeasurement(const DSRCodedEntryValue &selectedValue)
  : DSRContextGroup(CONTEXT_GROUP_NUMBER, "DCMR", CONTEXT_GROUP_KEYWORD, CONTEXT_GROUP_VERSION, CONTEXT_GROUP_UID, selectedValue)
{
    setExtensible(CONTEXT_GROUP_TYPE);
}


CID7551_GenericPurposeOfReferenceToImagesAndCoordinatesInMeasurement::CID7551_GenericPurposeOfReferenceToImagesAndCoordinatesInMeasurement(const EnumType selectedValue,
                                                                                                                                           const OFBool enhancedEncodingMode)
  : DSRContextGroup(CONTEXT_GROUP_NUMBER, "DCMR", CONTEXT_GROUP_KEYWORD, CONTEXT_GROUP_VERSION, CONTEXT_GROUP_UID, getCodedEntry(selectedValue, enhancedEncodingMode))
{
    setExtensible(CONTEXT_GROUP_TYPE);
}


OFCondition CID7551_GenericPurposeOfReferenceToImagesAndCoordinatesInMeasurement::selectValue(const EnumType selectedValue,
                                                                                              const OFBool enhancedEncodingMode)
{
    /* never check the coded entry */
    return DSRContextGroup::selectValue(getCodedEntry(selectedValue, enhancedEncodingMode), OFFalse /*check*/, OFFalse /*definedContextGroup*/);
}


OFCondition CID7551_GenericPurposeOfReferenceToImagesAndCoordinatesInMeasurement::findCodedEntry(const DSRCodedEntryValue &searchForCodedEntry,
                                                                                                 DSRCodedEntryValue *foundCodedEntry,
                                                                                                 const OFBool enhancedEncodingMode) const
{
    OFCondition result = SR_EC_CodedEntryNotInContextGroup;
    /* first, search for standard codes */
    CodeList::const_iterator iter = getCodes().begin();
    CodeList::const_iterator last = getCodes().end();
    /* iterate over coded entry list */
    while (iter != last)
    {
        /* if found, exit loop */
        if (searchForCodedEntry == iter->second)
        {
            /* return coded entry (if requested) */
            if (foundCodedEntry != NULL)
            {
                *foundCodedEntry = iter->second;
                /* also set enhanced encoding mode (if enabled) */
                if (!foundCodedEntry->isEmpty() && enhancedEncodingMode)
                    setEnhancedEncodingMode(*foundCodedEntry);
            }
            result = SR_EC_CodedEntryInStandardContextGroup;
            break;
        }
        ++iter;
    }
    /* if not, continue with extended codes */
    if (result.bad())
    {
        result = DSRContextGroup::findCodedEntry(searchForCodedEntry, foundCodedEntry);
        /* tbd: set "enhanced encoding mode" to mark a local/extended version? */
    }
    return result;
}


void CID7551_GenericPurposeOfReferenceToImagesAndCoordinatesInMeasurement::printCodes(STD_NAMESPACE ostream &stream) const
{
    /* print standard codes */
    stream << "Standard codes:" << OFendl;
    CodeList::const_iterator iter = getCodes().begin();
    CodeList::const_iterator last = getCodes().end();
    /* iterate over coded entry list */
    while (iter != last)
    {
        stream << "  ";
        /* print coded entry */
        DSRCodedEntryValue(iter->second).print(stream);
        stream << OFendl;
        ++iter;
    }
    /* print extended codes */
    DSRContextGroup::printCodes(stream);
}


// static functions

void CID7551_GenericPurposeOfReferenceToImagesAndCoordinatesInMeasurement::initialize()
{
    /* create and initialize code list */
    getCodes();
}


void CID7551_GenericPurposeOfReferenceToImagesAndCoordinatesInMeasurement::cleanup()
{
    /* delete code list, it will be recreated automatically when needed */
    delete Codes;
    Codes = NULL;
}


DSRCodedEntryValue CID7551_GenericPurposeOfReferenceToImagesAndCoordinatesInMeasurement::getCodedEntry(const EnumType value,
                                                                                                       const OFBool enhancedEncodingMode)
{
    DSRCodedEntryValue codedEntry;
    /* search for given enumerated value */
    CodeList::iterator iter = getCodes().find(value);
    /* if found, set the coded entry */
    if (iter != getCodes().end())
    {
        codedEntry = iter->second;
        /* also set enhanced encoding mode (if enabled) */
        if (!codedEntry.isEmpty() && enhancedEncodingMode)
            setEnhancedEncodingMode(codedEntry);
    }
    return codedEntry;
}


CID7551_GenericPurposeOfReferenceToImagesAndCoordinatesInMeasurement::CodeList &CID7551_GenericPurposeOfReferenceToImagesAndCoordinatesInMeasurement::getCodes()
{
    /* check whether code list has already been created and initialized */
    if (Codes == NULL)
    {
        /* create a new code list (should never fail) */
        Codes = new CodeList();
        /* and initialize it by adding the coded entries */
        Codes->insert(OFMake_pair(SourceOfMeasurement, DSRBasicCodedEntry("121112", "DCM", "Source of Measurement")));
        Codes->insert(OFMake_pair(ArmOfAngle, DSRBasicCodedEntry("121223", "DCM", "Arm of angle")));
        Codes->insert(OFMake_pair(Vector, DSRBasicCodedEntry("121225", "DCM", "Vector")));
        Codes->insert(OFMake_pair(ApproximateSpatialLocation, DSRBasicCodedEntry("121226", "DCM", "Approximate spatial location")));
    }
    /* should never be NULL */
    return *Codes;
}


OFCondition CID7551_GenericPurposeOfReferenceToImagesAndCoordinatesInMeasurement::setEnhancedEncodingMode(DSRCodedEntryValue &codedEntryValue)
{
    return codedEntryValue.setEnhancedEncodingMode(CONTEXT_GROUP_NUMBER, "DCMR", CONTEXT_GROUP_VERSION, CONTEXT_GROUP_UID);
}
