vtkDICOMUtilities.h

/*=========================================================================
 
  Program: DICOM for VTK
 
  Copyright (c) 2012-2024 David Gobbi
  All rights reserved.
  See Copyright.txt or http://dgobbi.github.io/bsd3.txt for details.
 
     This software is distributed WITHOUT ANY WARRANTY; without even
     the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
     PURPOSE.  See the above copyright notice for more information.
 
=========================================================================*/
#ifndef vtkDICOMUtilities_h
#define vtkDICOMUtilities_h
 
#include "vtkObject.h"
#include "vtkStdString.h" // For std::string
#include "vtkDICOMModule.h" // For export macro
#include "vtkDICOMConfig.h" // For configuration details
#include "vtkDICOMTag.h" // For method parameter
 
// Declare VTK classes within VTK's optional namespace
#if defined(VTK_ABI_NAMESPACE_BEGIN)
VTK_ABI_NAMESPACE_BEGIN
#endif
 
class vtkStringArray;
 
#if defined(VTK_ABI_NAMESPACE_BEGIN)
VTK_ABI_NAMESPACE_END
#endif
 
class VTKDICOM_EXPORT vtkDICOMUtilities : public vtkObject
{
public:
  static vtkDICOMUtilities *New();
 
  vtkTypeMacro(vtkDICOMUtilities, vtkObject);
 
  void PrintSelf(ostream& os, vtkIndent indent) VTK_DICOM_OVERRIDE;
 
 
  static void SetUIDPrefix(const char *prefix);
  static const char *GetUIDPrefix();
 
  static std::string GenerateUID(vtkDICOMTag tag);
 
 
  static void GenerateUIDs(vtkDICOMTag tag, vtkStringArray *uids);
 
  static int CompareUIDs(const char *u1, const char *u2);
 
 
  static std::string GenerateDateTime(const char *zone);
 
 
  static std::string GenerateDateTime(long long microsecs, const char *zone);
 
 
  static long long ConvertDateTime(const char *datetime);
 
 
  static long long GetUniversalTime();
 
  static long long GetUTC(long long *offset);
 
 
  static bool IsDICOMFile(const char *filename);
 
  static const char *GetImplementationClassUID();
 
 
  static void SetImplementationClassUID(const char *uid);
 
  static const char *GetImplementationVersionName();
 
 
  static void SetImplementationVersionName(const char *name);
 
 
  static unsigned int UnpackUnsignedInt(const unsigned char *cp) {
    return cp[0] + (cp[1] << 8) + (cp[2] << 16) + (cp[3] << 24); }
 
 
  static void PackUnsignedInt(unsigned int i, unsigned char *cp) {
    cp[0] = static_cast<unsigned char>(i);
    cp[1] = static_cast<unsigned char>(i >> 8);
    cp[2] = static_cast<unsigned char>(i >> 16);
    cp[3] = static_cast<unsigned char>(i >> 24); }
 
 
  static bool PatternMatches(const char *pattern, const char *val);
 
  static bool PatternMatches(
    const char *pattern, size_t pl, const char *val, size_t vl);
 
 
  static bool IsValidUTF8(const char *text, size_t l);
 
  static const char *GetUIDName(const char *uid);
 
  unsigned short GetCIDFromUID(const char *uid);
 
protected:
  vtkDICOMUtilities() {}
  ~vtkDICOMUtilities() VTK_DICOM_OVERRIDE {}
 
  static long long GetLocalOffset(long long t);
 
  static char UIDPrefix[64];
  static char ImplementationClassUID[65];
  static char ImplementationVersionName[17];
 
private:
#ifdef VTK_DICOM_DELETE
  vtkDICOMUtilities(const vtkDICOMUtilities&) VTK_DICOM_DELETE;
  void operator=(const vtkDICOMUtilities&) VTK_DICOM_DELETE;
#else
  vtkDICOMUtilities(const vtkDICOMUtilities&) = delete;
  void operator=(const vtkDICOMUtilities&) = delete;
#endif
};
 
#endif /* vtkDICOMUtilities_h */