Orthanc Client
Documentation of the client library of Orthanc
OrthancCppClient.h
Go to the documentation of this file.
1 
37 #pragma once
38 
39 #include <stdexcept>
40 #include <memory>
41 #include <string>
42 #include <string.h>
43 
44 #if defined(_WIN32)
45 
46 /********************************************************************
47  ** This is the Windows-specific section
48  ********************************************************************/
49 
50 #include <windows.h>
51 
52 /* cf. http://sourceforge.net/p/predef/wiki/Architectures/ */
53 #ifdef _M_X64
54 /* 64 bits target */
55 #define LAAW_ORTHANC_CLIENT_CALL_CONV __fastcall
56 #define LAAW_ORTHANC_CLIENT_CALL_DECORATION(Name, StdCallSuffix) Name
57 #define LAAW_ORTHANC_CLIENT_DEFAULT_PATH "OrthancClient_Windows64.dll"
58 #else
59 /* 32 bits target */
60 #define LAAW_ORTHANC_CLIENT_CALL_CONV __stdcall
61 #define LAAW_ORTHANC_CLIENT_CALL_DECORATION(Name, StdCallSuffix) "_" Name "@" StdCallSuffix
62 #define LAAW_ORTHANC_CLIENT_DEFAULT_PATH "OrthancClient_Windows32.dll"
63 #endif
64 
65 #define LAAW_ORTHANC_CLIENT_HANDLE_TYPE HINSTANCE
66 #define LAAW_ORTHANC_CLIENT_HANDLE_NULL 0
67 #define LAAW_ORTHANC_CLIENT_FUNCTION_TYPE FARPROC
68 #define LAAW_ORTHANC_CLIENT_LOADER(path) LoadLibraryA(path)
69 #define LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle, name, decoration) GetProcAddress(handle, LAAW_ORTHANC_CLIENT_CALL_DECORATION(name, decoration))
70 #define LAAW_ORTHANC_CLIENT_CLOSER(handle) FreeLibrary(handle)
71 
72 
73 /********************************************************************
74  ** This is the Linux-specific section
75  ********************************************************************/
76 
77 #elif defined (__linux)
78 
79 #include <stdlib.h>
80 #include <dlfcn.h>
81 
82 /* cf. http://sourceforge.net/p/predef/wiki/Architectures/ */
83 #ifdef __amd64__
84 #define LAAW_ORTHANC_CLIENT_DEFAULT_PATH "libOrthancClient.so.0.7"
85 #else
86 #define LAAW_ORTHANC_CLIENT_DEFAULT_PATH "libOrthancClient.so.0.7"
87 #endif
88 
89 #define LAAW_ORTHANC_CLIENT_CALL_CONV
90 #define LAAW_ORTHANC_CLIENT_HANDLE_TYPE void*
91 #define LAAW_ORTHANC_CLIENT_HANDLE_NULL NULL
92 #define LAAW_ORTHANC_CLIENT_FUNCTION_TYPE intptr_t
93 #define LAAW_ORTHANC_CLIENT_LOADER(path) dlopen(path, RTLD_LAZY)
94 #define LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle, name, decoration) (LAAW_ORTHANC_CLIENT_FUNCTION_TYPE) dlsym(handle, name)
95 #define LAAW_ORTHANC_CLIENT_CLOSER(handle) dlclose(handle)
96 
97 
98 #else
99 #error Please support your platform here
100 #endif
101 
102 
103 /********************************************************************
104  ** Definition of the integer types
105  ********************************************************************/
106 
107 #ifndef LAAW_INT8 // Only define the integer types once
108 
109 #if defined(__GNUC__)
110 
111 // Under GCC (including MinGW), the stdint.h standard header is used.
112 
113 #include <stdint.h>
114 
115 #define LAAW_INT8 int8_t
116 #define LAAW_UINT8 uint8_t
117 #define LAAW_INT16 int16_t
118 #define LAAW_UINT16 uint16_t
119 #define LAAW_INT32 int32_t
120 #define LAAW_UINT32 uint32_t
121 #define LAAW_INT64 int64_t
122 #define LAAW_UINT64 uint64_t
123 
124 #elif defined(_MSC_VER)
125 
126 // Under Visual Studio, it is required to define the various integer
127 // types by hand.
128 
129 #if (_MSC_VER < 1300)
130 typedef signed char LAAW_INT8;
131 typedef signed short LAAW_INT16;
132 typedef signed int LAAW_INT32;
133 typedef unsigned char LAAW_UINT8;
134 typedef unsigned short LAAW_UINT16;
135 typedef unsigned int LAAW_UINT32;
136 #else
137 typedef signed __int8 LAAW_INT8;
138 typedef signed __int16 LAAW_INT16;
139 typedef signed __int32 LAAW_INT32;
140 typedef unsigned __int8 LAAW_UINT8;
141 typedef unsigned __int16 LAAW_UINT16;
142 typedef unsigned __int32 LAAW_UINT32;
143 #endif
144 
145 typedef signed __int64 LAAW_INT64;
146 typedef unsigned __int64 LAAW_UINT64;
147 
148 #else
149 #error "Please support your compiler here"
150 #endif
151 
152 #endif
153 
154 
155 
156 
157 
158 /********************************************************************
159  ** This is a shared section between Windows and Linux
160  ********************************************************************/
161 
162 namespace OrthancClient {
166 class OrthancClientException : public std::exception
167  {
168  private:
169  std::string message_;
170 
171  public:
176  OrthancClientException(std::string message) : message_(message)
177  {
178  }
179 
180  ~OrthancClientException() throw()
181  {
182  }
183 
188  const std::string& What() const throw()
189  {
190  return message_;
191  }
192 };
193 }
194 
195 
196 namespace OrthancClient { namespace Internals {
202 class Library
203  {
204  private:
205  LAAW_ORTHANC_CLIENT_HANDLE_TYPE handle_;
206  LAAW_ORTHANC_CLIENT_FUNCTION_TYPE functionsIndex_[62 + 1];
207 
208 
209 
210  void Load(const char* sharedLibraryPath)
211  {
212 
213  if (handle_ != LAAW_ORTHANC_CLIENT_HANDLE_NULL)
214  {
215  // Do nothing if the library is already loaded
216  return;
217  }
218 
219  /* Setup the path to the default shared library if not provided */
220  if (sharedLibraryPath == NULL)
221  {
222  sharedLibraryPath = LAAW_ORTHANC_CLIENT_DEFAULT_PATH;
223  }
224 
225  /* Load the shared library */
226  handle_ = LAAW_ORTHANC_CLIENT_LOADER(sharedLibraryPath);
227 
228 
229  if (handle_ == LAAW_ORTHANC_CLIENT_HANDLE_NULL)
230  {
231  throw ::OrthancClient::OrthancClientException("Error loading shared library");
232  }
233 
234  LoadFunctions();
235  }
236 
237  inline void LoadFunctions();
238 
239  void FreeString(char* str)
240  {
241  typedef void (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (char*);
242  Function function = (Function) GetFunction(62);
243  function(str);
244  }
245 
246  Library()
247  {
248  handle_ = LAAW_ORTHANC_CLIENT_HANDLE_NULL;
249  }
250 
251  ~Library()
252  {
253  Finalize();
254  }
255 
256  public:
257  LAAW_ORTHANC_CLIENT_FUNCTION_TYPE GetFunction(unsigned int index)
258  {
264  if (handle_ == NULL)
265  {
266  Load(NULL);
267  }
268 
269  return functionsIndex_[index];
270  }
271 
272  void ThrowExceptionIfNeeded(char* message)
273  {
274  if (message != NULL)
275  {
276  std::string tmp(message);
277  FreeString(message);
278  throw ::OrthancClient::OrthancClientException(tmp);
279  }
280  }
281 
282  static inline Library& GetInstance()
283  {
292  static Library singleton;
293  return singleton;
294  }
295 
296  static void Initialize(const char* sharedLibraryPath)
297  {
298  GetInstance().Load(sharedLibraryPath);
299  }
300 
301  void Finalize()
302  {
303  if (handle_ != LAAW_ORTHANC_CLIENT_HANDLE_NULL)
304  {
305  LAAW_ORTHANC_CLIENT_CLOSER(handle_);
306  handle_ = LAAW_ORTHANC_CLIENT_HANDLE_NULL;
307  }
308  }
309 };
310 }}
311 
312 
320 namespace OrthancClient {
334 inline void Initialize()
335 {
337 }
338 
350 inline void Initialize(const std::string& sharedLibraryPath)
351 {
352  ::OrthancClient::Internals::Library::Initialize(sharedLibraryPath.c_str());
353 }
354 
363 inline void Finalize()
364 {
365  ::OrthancClient::Internals::Library::GetInstance().Finalize();
366 }
367 
368 
372 }
373 
374 
375 namespace OrthancClient { namespace Internals {
376 inline void Library::LoadFunctions()
377 {
378  typedef const char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) ();
379  Function getVersion = (Function) LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_GetVersion", "0");
380  if (getVersion == NULL)
381  {
382  throw ::OrthancClient::OrthancClientException("Unable to get the library version");
383  }
384 
389  if (strcmp(getVersion(), "0.7"))
390  {
391  throw ::OrthancClient::OrthancClientException("Mismatch between the C++ header and the library version");
392  }
393 
394  functionsIndex_[62] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_FreeString", "4");
395  functionsIndex_[3] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_557aee7b61817292a0f31269d3c35db7", "8");
396  functionsIndex_[4] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_0b8dff0ce67f10954a49b059e348837e", "8");
397  functionsIndex_[5] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_e05097c153f676e5a5ee54dcfc78256f", "4");
398  functionsIndex_[6] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_e840242bf58d17d3c1d722da09ce88e0", "8");
399  functionsIndex_[7] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_c9af31433001b5dfc012a552dc6d0050", "8");
400  functionsIndex_[8] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_3fba4d6b818180a44cd1cae6046334dc", "12");
401  functionsIndex_[9] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_aeb20dc75b9246188db857317e5e0ce7", "8");
402  functionsIndex_[10] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_62689803d9871e4d9c51a648640b320b", "8");
403  functionsIndex_[11] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_2fb64c9e5a67eccd413b0e913469a421", "16");
404  functionsIndex_[0] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_1f1acb322ea4d0aad65172824607673c", "8");
405  functionsIndex_[1] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_f3fd272e4636f6a531aabb72ee01cd5b", "16");
406  functionsIndex_[2] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_12d3de0a96e9efb11136a9811bb9ed38", "4");
407  functionsIndex_[14] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_f756172daf04516eec3a566adabb4335", "4");
408  functionsIndex_[15] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_ddb68763ec902a97d579666a73a20118", "8");
409  functionsIndex_[16] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_fba3c68b4be7558dbc65f7ce1ab57d63", "12");
410  functionsIndex_[17] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_b4ca99d958f843493e58d1ef967340e1", "8");
411  functionsIndex_[18] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_78d5cc76d282437b6f93ec3b82c35701", "16");
412  functionsIndex_[12] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_6cf0d7268667f9b0aa4511bacf184919", "12");
413  functionsIndex_[13] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_7d81cd502ee27e859735d0ea7112b5a1", "4");
414  functionsIndex_[21] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_48a2a1a9d68c047e22bfba23014643d2", "4");
415  functionsIndex_[22] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_852bf8296ca21c5fde5ec565cc10721d", "8");
416  functionsIndex_[23] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_efd04574e0779faa83df1f2d8f9888db", "12");
417  functionsIndex_[24] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_736247ff5e8036dac38163da6f666ed5", "8");
418  functionsIndex_[25] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_d82d2598a7a73f4b6fcc0c09c25b08ca", "8");
419  functionsIndex_[26] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_88134b978f9acb2aecdadf54aeab3c64", "16");
420  functionsIndex_[27] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_152cb1b704c053d24b0dab7461ba6ea3", "8");
421  functionsIndex_[28] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_eee03f337ec81d9f1783cd41e5238757", "8");
422  functionsIndex_[29] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_006f08237bd7611636fc721baebfb4c5", "8");
423  functionsIndex_[30] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_b794f5cd3dad7d7b575dd1fd902afdd0", "8");
424  functionsIndex_[31] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_8ee2e50dd9df8f66a3c1766090dd03ab", "8");
425  functionsIndex_[32] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_046aed35bbe4751691f4c34cc249a61d", "8");
426  functionsIndex_[33] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_4dcc7a0fd025efba251ac6e9b701c2c5", "28");
427  functionsIndex_[34] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_b2601a161c24ad0a1d3586246f87452c", "32");
428  functionsIndex_[19] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_193599b9e345384fcdfcd47c29c55342", "12");
429  functionsIndex_[20] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_7c97f17063a357d38c5fab1136ad12a0", "4");
430  functionsIndex_[37] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_e65b20b7e0170b67544cd6664a4639b7", "4");
431  functionsIndex_[38] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_470e981b0e41f17231ba0ae6f3033321", "8");
432  functionsIndex_[39] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_04cefd138b6ea15ad909858f2a0a8f05", "12");
433  functionsIndex_[40] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_aee5b1f6f0c082f2c3b0986f9f6a18c7", "8");
434  functionsIndex_[41] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_93965682bace75491413e1f0b8d5a654", "16");
435  functionsIndex_[35] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_b01c6003238eb46c8db5dc823d7ca678", "12");
436  functionsIndex_[36] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_0147007fb99bad8cd95a139ec8795376", "4");
437  functionsIndex_[44] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_236ee8b403bc99535a8a4695c0cd45cb", "8");
438  functionsIndex_[45] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_2a437b7aba6bb01e81113835be8f0146", "8");
439  functionsIndex_[46] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_2bcbcb850934ae0bb4c6f0cc940e6cda", "8");
440  functionsIndex_[47] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_8d415c3a78a48e7e61d9fd24e7c79484", "12");
441  functionsIndex_[48] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_70d2f8398bbc63b5f792b69b4ad5fecb", "12");
442  functionsIndex_[49] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_1729a067d902771517388eedd7346b23", "12");
443  functionsIndex_[50] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_72e2aeee66cd3abd8ab7e987321c3745", "8");
444  functionsIndex_[51] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_1ea3df5a1ac1a1a687fe7325adddb6f0", "8");
445  functionsIndex_[52] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_99b4f370e4f532d8b763e2cb49db92f8", "8");
446  functionsIndex_[53] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_c41c742b68617f1c0590577a0a5ebc0c", "8");
447  functionsIndex_[54] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_142dd2feba0fc1d262bbd0baeb441a8b", "8");
448  functionsIndex_[55] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_5f5c9f81a4dff8daa6c359f1d0488fef", "12");
449  functionsIndex_[56] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_9ca979fffd08fa256306d4e68d8b0e91", "8");
450  functionsIndex_[57] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_6f2d77a26edc91c28d89408dbc3c271e", "8");
451  functionsIndex_[58] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_c0f494b80d4ff8b232df7a75baa0700a", "4");
452  functionsIndex_[59] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_d604f44bd5195e082e745e9cbc164f4c", "4");
453  functionsIndex_[60] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_1710299d1c5f3b1f2b7cf3962deebbfd", "8");
454  functionsIndex_[61] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_bb55aaf772ddceaadee36f4e54136bcb", "8");
455  functionsIndex_[42] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_6c5ad02f91b583e29cebd0bd319ce21d", "12");
456  functionsIndex_[43] = LAAW_ORTHANC_CLIENT_GET_FUNCTION(handle_, "LAAW_EXTERNC_4068241c44a9c1367fe0e57be523f207", "4");
457 
458  /* Check whether the functions were properly loaded */
459  for (unsigned int i = 0; i <= 62; i++)
460  {
461  if (functionsIndex_[i] == (LAAW_ORTHANC_CLIENT_FUNCTION_TYPE) NULL)
462  {
463  throw ::OrthancClient::OrthancClientException("Unable to load the functions of the shared library");
464  }
465  }
466 }
467 }}
468 namespace OrthancClient
469 {
470  class OrthancConnection;
471 }
472 
473 namespace OrthancClient
474 {
475  class Patient;
476 }
477 
478 namespace OrthancClient
479 {
480  class Series;
481 }
482 
483 namespace OrthancClient
484 {
485  class Study;
486 }
487 
488 namespace OrthancClient
489 {
490  class Instance;
491 }
492 
493 namespace Orthanc
494 {
503  {
539  };
540 }
541 
542 namespace Orthanc
543 {
552  {
581  };
582 }
583 
584 namespace OrthancClient
585 {
593  {
594  friend class ::OrthancClient::Patient;
595  friend class ::OrthancClient::Series;
596  friend class ::OrthancClient::Study;
597  friend class ::OrthancClient::Instance;
598  private:
599  bool isReference_;
600  OrthancConnection& operator= (const OrthancConnection&); // Assignment is forbidden
601  void* pimpl_;
602  OrthancConnection(void* pimpl) : isReference_(true), pimpl_(pimpl) {}
603  public:
611  OrthancConnection(const OrthancConnection& other) : isReference_(true), pimpl_(other.pimpl_) { }
612  inline OrthancConnection(const ::std::string& orthancUrl);
613  inline OrthancConnection(const ::std::string& orthancUrl, const ::std::string& username, const ::std::string& password);
614  inline ~OrthancConnection();
615  inline LAAW_UINT32 GetThreadCount() const;
616  inline void SetThreadCount(LAAW_UINT32 threadCount);
617  inline void Reload();
618  inline ::std::string GetOrthancUrl() const;
619  inline LAAW_UINT32 GetPatientCount();
620  inline ::OrthancClient::Patient GetPatient(LAAW_UINT32 index);
621  inline void DeletePatient(LAAW_UINT32 index);
622  inline void StoreFile(const ::std::string& filename);
623  inline void Store(const void* dicom, LAAW_UINT64 size);
624  };
625 }
626 
627 namespace OrthancClient
628 {
635  class Patient
636  {
637  friend class ::OrthancClient::OrthancConnection;
638  friend class ::OrthancClient::Series;
639  friend class ::OrthancClient::Study;
640  friend class ::OrthancClient::Instance;
641  private:
642  bool isReference_;
643  Patient& operator= (const Patient&); // Assignment is forbidden
644  void* pimpl_;
645  Patient(void* pimpl) : isReference_(true), pimpl_(pimpl) {}
646  public:
654  Patient(const Patient& other) : isReference_(true), pimpl_(other.pimpl_) { }
655  inline Patient(::OrthancClient::OrthancConnection& connection, const ::std::string& id);
656  inline ~Patient();
657  inline void Reload();
658  inline LAAW_UINT32 GetStudyCount();
659  inline ::OrthancClient::Study GetStudy(LAAW_UINT32 index);
660  inline ::std::string GetId() const;
661  inline ::std::string GetMainDicomTag(const ::std::string& tag, const ::std::string& defaultValue) const;
662  };
663 }
664 
665 namespace OrthancClient
666 {
673  class Series
674  {
675  friend class ::OrthancClient::OrthancConnection;
676  friend class ::OrthancClient::Patient;
677  friend class ::OrthancClient::Study;
678  friend class ::OrthancClient::Instance;
679  private:
680  bool isReference_;
681  Series& operator= (const Series&); // Assignment is forbidden
682  void* pimpl_;
683  Series(void* pimpl) : isReference_(true), pimpl_(pimpl) {}
684  public:
692  Series(const Series& other) : isReference_(true), pimpl_(other.pimpl_) { }
693  inline Series(::OrthancClient::OrthancConnection& connection, const ::std::string& id);
694  inline ~Series();
695  inline void Reload();
696  inline LAAW_UINT32 GetInstanceCount();
697  inline ::OrthancClient::Instance GetInstance(LAAW_UINT32 index);
698  inline ::std::string GetId() const;
699  inline ::std::string GetUrl() const;
700  inline ::std::string GetMainDicomTag(const ::std::string& tag, const ::std::string& defaultValue) const;
701  inline bool Is3DImage();
702  inline LAAW_UINT32 GetWidth();
703  inline LAAW_UINT32 GetHeight();
704  inline float GetVoxelSizeX();
705  inline float GetVoxelSizeY();
706  inline float GetVoxelSizeZ();
707  inline void Load3DImage(void* target, ::Orthanc::PixelFormat format, LAAW_INT64 lineStride, LAAW_INT64 stackStride);
708  inline void Load3DImage(void* target, ::Orthanc::PixelFormat format, LAAW_INT64 lineStride, LAAW_INT64 stackStride, float progress[]);
709  };
710 }
711 
712 namespace OrthancClient
713 {
720  class Study
721  {
722  friend class ::OrthancClient::OrthancConnection;
723  friend class ::OrthancClient::Patient;
724  friend class ::OrthancClient::Series;
725  friend class ::OrthancClient::Instance;
726  private:
727  bool isReference_;
728  Study& operator= (const Study&); // Assignment is forbidden
729  void* pimpl_;
730  Study(void* pimpl) : isReference_(true), pimpl_(pimpl) {}
731  public:
739  Study(const Study& other) : isReference_(true), pimpl_(other.pimpl_) { }
740  inline Study(::OrthancClient::OrthancConnection& connection, const ::std::string& id);
741  inline ~Study();
742  inline void Reload();
743  inline LAAW_UINT32 GetSeriesCount();
744  inline ::OrthancClient::Series GetSeries(LAAW_UINT32 index);
745  inline ::std::string GetId() const;
746  inline ::std::string GetMainDicomTag(const ::std::string& tag, const ::std::string& defaultValue) const;
747  };
748 }
749 
750 namespace OrthancClient
751 {
758  class Instance
759  {
760  friend class ::OrthancClient::OrthancConnection;
761  friend class ::OrthancClient::Patient;
762  friend class ::OrthancClient::Series;
763  friend class ::OrthancClient::Study;
764  private:
765  bool isReference_;
766  Instance& operator= (const Instance&); // Assignment is forbidden
767  void* pimpl_;
768  Instance(void* pimpl) : isReference_(true), pimpl_(pimpl) {}
769  public:
777  Instance(const Instance& other) : isReference_(true), pimpl_(other.pimpl_) { }
778  inline Instance(::OrthancClient::OrthancConnection& connection, const ::std::string& id);
779  inline ~Instance();
780  inline ::std::string GetId() const;
783  inline ::std::string GetTagAsString(const ::std::string& tag) const;
784  inline float GetTagAsFloat(const ::std::string& tag) const;
785  inline LAAW_INT32 GetTagAsInt(const ::std::string& tag) const;
786  inline LAAW_UINT32 GetWidth();
787  inline LAAW_UINT32 GetHeight();
788  inline LAAW_UINT32 GetPitch();
790  inline const void* GetBuffer();
791  inline const void* GetBuffer(LAAW_UINT32 y);
792  inline LAAW_UINT64 GetDicomSize();
793  inline const void* GetDicom();
794  inline void DiscardImage();
795  inline void DiscardDicom();
796  inline void LoadTagContent(const ::std::string& path);
797  inline ::std::string GetLoadedTagContent() const;
798  };
799 }
800 
801 namespace OrthancClient
802 {
810  inline OrthancConnection::OrthancConnection(const ::std::string& orthancUrl)
811  {
812  isReference_ = false;
813  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (void**, const char*);
814  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(0);
815  char* error = function(&pimpl_, orthancUrl.c_str());
816  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
817  }
827  inline OrthancConnection::OrthancConnection(const ::std::string& orthancUrl, const ::std::string& username, const ::std::string& password)
828  {
829  isReference_ = false;
830  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (void**, const char*, const char*, const char*);
831  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(1);
832  char* error = function(&pimpl_, orthancUrl.c_str(), username.c_str(), password.c_str());
833  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
834  }
842  {
843  if (isReference_) return;
844  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (void*);
845  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(2);
846  char* error = function(pimpl_);
847  error = error; // Remove warning about unused variable
848  }
856  inline LAAW_UINT32 OrthancConnection::GetThreadCount() const
857  {
858  LAAW_UINT32 result_;
859  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (const void*, LAAW_UINT32*);
860  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(3);
861  char* error = function(pimpl_, &result_);
862  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
863  return result_;
864  }
872  inline void OrthancConnection::SetThreadCount(LAAW_UINT32 threadCount)
873  {
874  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (void*, LAAW_UINT32);
875  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(4);
876  char* error = function(pimpl_, threadCount);
877  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
878  }
886  {
887  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (void*);
888  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(5);
889  char* error = function(pimpl_);
890  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
891  }
899  inline ::std::string OrthancConnection::GetOrthancUrl() const
900  {
901  const char* result_;
902  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (const void*, const char**);
903  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(6);
904  char* error = function(pimpl_, &result_);
905  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
906  return std::string(result_);
907  }
916  {
917  LAAW_UINT32 result_;
918  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (void*, LAAW_UINT32*);
919  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(7);
920  char* error = function(pimpl_, &result_);
921  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
922  return result_;
923  }
932  inline ::OrthancClient::Patient OrthancConnection::GetPatient(LAAW_UINT32 index)
933  {
934  void* result_;
935  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (void*, void**, LAAW_UINT32);
936  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(8);
937  char* error = function(pimpl_, &result_, index);
938  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
939  return ::OrthancClient::Patient(result_);
940  }
949  inline void OrthancConnection::DeletePatient(LAAW_UINT32 index)
950  {
951  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (void*, LAAW_UINT32);
952  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(9);
953  char* error = function(pimpl_, index);
954  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
955  }
963  inline void OrthancConnection::StoreFile(const ::std::string& filename)
964  {
965  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (void*, const char*);
966  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(10);
967  char* error = function(pimpl_, filename.c_str());
968  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
969  }
978  inline void OrthancConnection::Store(const void* dicom, LAAW_UINT64 size)
979  {
980  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (void*, const void*, LAAW_UINT64);
981  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(11);
982  char* error = function(pimpl_, dicom, size);
983  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
984  }
985 }
986 
987 namespace OrthancClient
988 {
997  inline Patient::Patient(::OrthancClient::OrthancConnection& connection, const ::std::string& id)
998  {
999  isReference_ = false;
1000  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (void**, void*, const char*);
1001  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(12);
1002  char* error = function(&pimpl_, connection.pimpl_, id.c_str());
1003  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
1004  }
1012  {
1013  if (isReference_) return;
1014  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (void*);
1015  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(13);
1016  char* error = function(pimpl_);
1017  error = error; // Remove warning about unused variable
1018  }
1025  inline void Patient::Reload()
1026  {
1027  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (void*);
1028  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(14);
1029  char* error = function(pimpl_);
1030  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
1031  }
1039  inline LAAW_UINT32 Patient::GetStudyCount()
1040  {
1041  LAAW_UINT32 result_;
1042  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (void*, LAAW_UINT32*);
1043  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(15);
1044  char* error = function(pimpl_, &result_);
1045  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
1046  return result_;
1047  }
1056  inline ::OrthancClient::Study Patient::GetStudy(LAAW_UINT32 index)
1057  {
1058  void* result_;
1059  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (void*, void**, LAAW_UINT32);
1060  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(16);
1061  char* error = function(pimpl_, &result_, index);
1062  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
1063  return ::OrthancClient::Study(result_);
1064  }
1072  inline ::std::string Patient::GetId() const
1073  {
1074  const char* result_;
1075  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (const void*, const char**);
1076  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(17);
1077  char* error = function(pimpl_, &result_);
1078  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
1079  return std::string(result_);
1080  }
1090  inline ::std::string Patient::GetMainDicomTag(const ::std::string& tag, const ::std::string& defaultValue) const
1091  {
1092  const char* result_;
1093  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (const void*, const char**, const char*, const char*);
1094  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(18);
1095  char* error = function(pimpl_, &result_, tag.c_str(), defaultValue.c_str());
1096  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
1097  return std::string(result_);
1098  }
1099 }
1100 
1101 namespace OrthancClient
1102 {
1111  inline Series::Series(::OrthancClient::OrthancConnection& connection, const ::std::string& id)
1112  {
1113  isReference_ = false;
1114  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (void**, void*, const char*);
1115  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(19);
1116  char* error = function(&pimpl_, connection.pimpl_, id.c_str());
1117  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
1118  }
1126  {
1127  if (isReference_) return;
1128  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (void*);
1129  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(20);
1130  char* error = function(pimpl_);
1131  error = error; // Remove warning about unused variable
1132  }
1139  inline void Series::Reload()
1140  {
1141  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (void*);
1142  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(21);
1143  char* error = function(pimpl_);
1144  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
1145  }
1153  inline LAAW_UINT32 Series::GetInstanceCount()
1154  {
1155  LAAW_UINT32 result_;
1156  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (void*, LAAW_UINT32*);
1157  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(22);
1158  char* error = function(pimpl_, &result_);
1159  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
1160  return result_;
1161  }
1170  inline ::OrthancClient::Instance Series::GetInstance(LAAW_UINT32 index)
1171  {
1172  void* result_;
1173  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (void*, void**, LAAW_UINT32);
1174  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(23);
1175  char* error = function(pimpl_, &result_, index);
1176  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
1177  return ::OrthancClient::Instance(result_);
1178  }
1186  inline ::std::string Series::GetId() const
1187  {
1188  const char* result_;
1189  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (const void*, const char**);
1190  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(24);
1191  char* error = function(pimpl_, &result_);
1192  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
1193  return std::string(result_);
1194  }
1202  inline ::std::string Series::GetUrl() const
1203  {
1204  const char* result_;
1205  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (const void*, const char**);
1206  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(25);
1207  char* error = function(pimpl_, &result_);
1208  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
1209  return std::string(result_);
1210  }
1220  inline ::std::string Series::GetMainDicomTag(const ::std::string& tag, const ::std::string& defaultValue) const
1221  {
1222  const char* result_;
1223  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (const void*, const char**, const char*, const char*);
1224  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(26);
1225  char* error = function(pimpl_, &result_, tag.c_str(), defaultValue.c_str());
1226  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
1227  return std::string(result_);
1228  }
1236  inline bool Series::Is3DImage()
1237  {
1238  LAAW_INT32 result_;
1239  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (void*, LAAW_INT32*);
1240  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(27);
1241  char* error = function(pimpl_, &result_);
1242  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
1243  return result_ != 0;
1244  }
1252  inline LAAW_UINT32 Series::GetWidth()
1253  {
1254  LAAW_UINT32 result_;
1255  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (void*, LAAW_UINT32*);
1256  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(28);
1257  char* error = function(pimpl_, &result_);
1258  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
1259  return result_;
1260  }
1268  inline LAAW_UINT32 Series::GetHeight()
1269  {
1270  LAAW_UINT32 result_;
1271  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (void*, LAAW_UINT32*);
1272  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(29);
1273  char* error = function(pimpl_, &result_);
1274  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
1275  return result_;
1276  }
1284  inline float Series::GetVoxelSizeX()
1285  {
1286  float result_;
1287  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (void*, float*);
1288  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(30);
1289  char* error = function(pimpl_, &result_);
1290  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
1291  return result_;
1292  }
1300  inline float Series::GetVoxelSizeY()
1301  {
1302  float result_;
1303  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (void*, float*);
1304  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(31);
1305  char* error = function(pimpl_, &result_);
1306  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
1307  return result_;
1308  }
1316  inline float Series::GetVoxelSizeZ()
1317  {
1318  float result_;
1319  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (void*, float*);
1320  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(32);
1321  char* error = function(pimpl_, &result_);
1322  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
1323  return result_;
1324  }
1335  inline void Series::Load3DImage(void* target, ::Orthanc::PixelFormat format, LAAW_INT64 lineStride, LAAW_INT64 stackStride)
1336  {
1337  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (void*, void*, LAAW_INT32, LAAW_INT64, LAAW_INT64);
1338  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(33);
1339  char* error = function(pimpl_, target, format, lineStride, stackStride);
1340  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
1341  }
1353  inline void Series::Load3DImage(void* target, ::Orthanc::PixelFormat format, LAAW_INT64 lineStride, LAAW_INT64 stackStride, float progress[])
1354  {
1355  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (void*, void*, LAAW_INT32, LAAW_INT64, LAAW_INT64, float*);
1356  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(34);
1357  char* error = function(pimpl_, target, format, lineStride, stackStride, progress);
1358  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
1359  }
1360 }
1361 
1362 namespace OrthancClient
1363 {
1372  inline Study::Study(::OrthancClient::OrthancConnection& connection, const ::std::string& id)
1373  {
1374  isReference_ = false;
1375  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (void**, void*, const char*);
1376  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(35);
1377  char* error = function(&pimpl_, connection.pimpl_, id.c_str());
1378  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
1379  }
1386  inline Study::~Study()
1387  {
1388  if (isReference_) return;
1389  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (void*);
1390  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(36);
1391  char* error = function(pimpl_);
1392  error = error; // Remove warning about unused variable
1393  }
1400  inline void Study::Reload()
1401  {
1402  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (void*);
1403  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(37);
1404  char* error = function(pimpl_);
1405  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
1406  }
1414  inline LAAW_UINT32 Study::GetSeriesCount()
1415  {
1416  LAAW_UINT32 result_;
1417  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (void*, LAAW_UINT32*);
1418  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(38);
1419  char* error = function(pimpl_, &result_);
1420  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
1421  return result_;
1422  }
1431  inline ::OrthancClient::Series Study::GetSeries(LAAW_UINT32 index)
1432  {
1433  void* result_;
1434  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (void*, void**, LAAW_UINT32);
1435  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(39);
1436  char* error = function(pimpl_, &result_, index);
1437  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
1438  return ::OrthancClient::Series(result_);
1439  }
1447  inline ::std::string Study::GetId() const
1448  {
1449  const char* result_;
1450  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (const void*, const char**);
1451  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(40);
1452  char* error = function(pimpl_, &result_);
1453  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
1454  return std::string(result_);
1455  }
1465  inline ::std::string Study::GetMainDicomTag(const ::std::string& tag, const ::std::string& defaultValue) const
1466  {
1467  const char* result_;
1468  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (const void*, const char**, const char*, const char*);
1469  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(41);
1470  char* error = function(pimpl_, &result_, tag.c_str(), defaultValue.c_str());
1471  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
1472  return std::string(result_);
1473  }
1474 }
1475 
1476 namespace OrthancClient
1477 {
1486  inline Instance::Instance(::OrthancClient::OrthancConnection& connection, const ::std::string& id)
1487  {
1488  isReference_ = false;
1489  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (void**, void*, const char*);
1490  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(42);
1491  char* error = function(&pimpl_, connection.pimpl_, id.c_str());
1492  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
1493  }
1501  {
1502  if (isReference_) return;
1503  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (void*);
1504  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(43);
1505  char* error = function(pimpl_);
1506  error = error; // Remove warning about unused variable
1507  }
1515  inline ::std::string Instance::GetId() const
1516  {
1517  const char* result_;
1518  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (const void*, const char**);
1519  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(44);
1520  char* error = function(pimpl_, &result_);
1521  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
1522  return std::string(result_);
1523  }
1532  {
1533  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (void*, LAAW_INT32);
1534  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(45);
1535  char* error = function(pimpl_, mode);
1536  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
1537  }
1546  {
1547  LAAW_INT32 result_;
1548  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (const void*, LAAW_INT32*);
1549  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(46);
1550  char* error = function(pimpl_, &result_);
1551  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
1552  return static_cast< ::Orthanc::ImageExtractionMode >(result_);
1553  }
1562  inline ::std::string Instance::GetTagAsString(const ::std::string& tag) const
1563  {
1564  const char* result_;
1565  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (const void*, const char**, const char*);
1566  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(47);
1567  char* error = function(pimpl_, &result_, tag.c_str());
1568  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
1569  return std::string(result_);
1570  }
1579  inline float Instance::GetTagAsFloat(const ::std::string& tag) const
1580  {
1581  float result_;
1582  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (const void*, float*, const char*);
1583  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(48);
1584  char* error = function(pimpl_, &result_, tag.c_str());
1585  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
1586  return result_;
1587  }
1596  inline LAAW_INT32 Instance::GetTagAsInt(const ::std::string& tag) const
1597  {
1598  LAAW_INT32 result_;
1599  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (const void*, LAAW_INT32*, const char*);
1600  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(49);
1601  char* error = function(pimpl_, &result_, tag.c_str());
1602  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
1603  return result_;
1604  }
1612  inline LAAW_UINT32 Instance::GetWidth()
1613  {
1614  LAAW_UINT32 result_;
1615  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (void*, LAAW_UINT32*);
1616  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(50);
1617  char* error = function(pimpl_, &result_);
1618  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
1619  return result_;
1620  }
1628  inline LAAW_UINT32 Instance::GetHeight()
1629  {
1630  LAAW_UINT32 result_;
1631  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (void*, LAAW_UINT32*);
1632  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(51);
1633  char* error = function(pimpl_, &result_);
1634  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
1635  return result_;
1636  }
1644  inline LAAW_UINT32 Instance::GetPitch()
1645  {
1646  LAAW_UINT32 result_;
1647  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (void*, LAAW_UINT32*);
1648  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(52);
1649  char* error = function(pimpl_, &result_);
1650  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
1651  return result_;
1652  }
1661  {
1662  LAAW_INT32 result_;
1663  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (void*, LAAW_INT32*);
1664  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(53);
1665  char* error = function(pimpl_, &result_);
1666  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
1667  return static_cast< ::Orthanc::PixelFormat >(result_);
1668  }
1676  inline const void* Instance::GetBuffer()
1677  {
1678  const void* result_;
1679  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (void*, const void**);
1680  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(54);
1681  char* error = function(pimpl_, &result_);
1682  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
1683  return reinterpret_cast< const void* >(result_);
1684  }
1693  inline const void* Instance::GetBuffer(LAAW_UINT32 y)
1694  {
1695  const void* result_;
1696  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (void*, const void**, LAAW_UINT32);
1697  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(55);
1698  char* error = function(pimpl_, &result_, y);
1699  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
1700  return reinterpret_cast< const void* >(result_);
1701  }
1709  inline LAAW_UINT64 Instance::GetDicomSize()
1710  {
1711  LAAW_UINT64 result_;
1712  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (void*, LAAW_UINT64*);
1713  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(56);
1714  char* error = function(pimpl_, &result_);
1715  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
1716  return result_;
1717  }
1725  inline const void* Instance::GetDicom()
1726  {
1727  const void* result_;
1728  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (void*, const void**);
1729  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(57);
1730  char* error = function(pimpl_, &result_);
1731  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
1732  return reinterpret_cast< const void* >(result_);
1733  }
1741  {
1742  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (void*);
1743  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(58);
1744  char* error = function(pimpl_);
1745  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
1746  }
1754  {
1755  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (void*);
1756  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(59);
1757  char* error = function(pimpl_);
1758  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
1759  }
1767  inline void Instance::LoadTagContent(const ::std::string& path)
1768  {
1769  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (void*, const char*);
1770  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(60);
1771  char* error = function(pimpl_, path.c_str());
1772  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
1773  }
1781  inline ::std::string Instance::GetLoadedTagContent() const
1782  {
1783  const char* result_;
1784  typedef char* (LAAW_ORTHANC_CLIENT_CALL_CONV* Function) (const void*, const char**);
1785  Function function = (Function) ::OrthancClient::Internals::Library::GetInstance().GetFunction(61);
1786  char* error = function(pimpl_, &result_);
1787  ::OrthancClient::Internals::Library::GetInstance().ThrowExceptionIfNeeded(error);
1788  return std::string(result_);
1789  }
1790 }
1791 
float GetVoxelSizeX()
Get the physical size of a voxel along the X-axis.
Definition: OrthancCppClient.h:1284
float GetVoxelSizeZ()
Get the physical size of a voxel along the Z-axis.
Definition: OrthancCppClient.h:1316
Connection to a study stored in Orthanc.
Definition: OrthancCppClient.h:720
LAAW_UINT32 GetHeight()
Get the height of the 3D image.
Definition: OrthancCppClient.h:1268
LAAW_UINT32 GetPatientCount()
Returns the number of patients.
Definition: OrthancCppClient.h:915
~Series()
Destructs the object.
Definition: OrthancCppClient.h:1125
LAAW_UINT32 GetInstanceCount()
Return the number of instances for this series.
Definition: OrthancCppClient.h:1153
void Store(const void *dicom, LAAW_UINT64 size)
Send a DICOM file that is contained inside a memory buffer.
Definition: OrthancCppClient.h:978
Graylevel, signed 16bpp image.
Definition: OrthancCppClient.h:510
Graylevel, unsigned 16bpp image.
Definition: OrthancCppClient.h:538
bool Is3DImage()
Test whether this series encodes a 3D image that can be downloaded from Orthanc.
Definition: OrthancCppClient.h:1236
const void * GetBuffer()
Access the memory buffer in which the raw pixels of the 2D image are stored.
Definition: OrthancCppClient.h:1676
PixelFormat
The memory layout of the pixels (resp. voxels) of a 2D (resp. 3D) image.
Definition: OrthancCppClient.h:502
Instance(const Instance &other)
Construct a new reference to this object.
Definition: OrthancCppClient.h:777
inline::std::string GetMainDicomTag(const ::std::string &tag, const ::std::string &defaultValue) const
Get the value of one of the main DICOM tags for this series.
Definition: OrthancCppClient.h:1220
Connection to an instance stored in Orthanc.
Definition: OrthancCppClient.h:758
inline::std::string GetId() const
Get the Orthanc identifier of this study.
Definition: OrthancCppClient.h:1447
Patient(const Patient &other)
Construct a new reference to this object.
Definition: OrthancCppClient.h:654
void SetImageExtractionMode(::Orthanc::ImageExtractionMode mode)
Set the extraction mode for the 2D image corresponding to this instance.
Definition: OrthancCppClient.h:1531
Truncation to the [0, 65535] range.
Definition: OrthancCppClient.h:580
inline::std::string GetUrl() const
Returns the URL to this series.
Definition: OrthancCppClient.h:1202
Truncation to the [-32768, 32767] range.
Definition: OrthancCppClient.h:559
inline::std::string GetLoadedTagContent() const
Return the value of the raw tag that was loaded by LoadContent.
Definition: OrthancCppClient.h:1781
inline::std::string GetId() const
Get the Orthanc identifier of this patient.
Definition: OrthancCppClient.h:1072
void Load3DImage(void *target,::Orthanc::PixelFormat format, LAAW_INT64 lineStride, LAAW_INT64 stackStride)
Load the 3D image into a memory buffer.
Definition: OrthancCppClient.h:1335
LAAW_UINT64 GetDicomSize()
Get the size of the DICOM file corresponding to this instance.
Definition: OrthancCppClient.h:1709
LAAW_UINT32 GetWidth()
Get the width of the 2D image.
Definition: OrthancCppClient.h:1612
const std::string & What() const
Get the error message associated with this exception.
Definition: OrthancCppClient.h:188
Connection to a patient stored in Orthanc.
Definition: OrthancCppClient.h:635
inline::OrthancClient::Instance GetInstance(LAAW_UINT32 index)
Get some instance of this series.
Definition: OrthancCppClient.h:1170
inline::std::string GetId() const
Get the Orthanc identifier of this series.
Definition: OrthancCppClient.h:1186
void Reload()
Reload the instances of this series.
Definition: OrthancCppClient.h:1139
LAAW_UINT32 GetThreadCount() const
Returns the number of threads for this connection.
Definition: OrthancCppClient.h:856
inline::OrthancClient::Patient GetPatient(LAAW_UINT32 index)
Get some patient.
Definition: OrthancCppClient.h:932
void LoadTagContent(const ::std::string &path)
Load a raw tag from the DICOM file.
Definition: OrthancCppClient.h:1767
inline::std::string GetMainDicomTag(const ::std::string &tag, const ::std::string &defaultValue) const
Get the value of one of the main DICOM tags for this study.
Definition: OrthancCppClient.h:1465
~Instance()
Destructs the object.
Definition: OrthancCppClient.h:1500
void DiscardImage()
Discard the downloaded 2D image, so as to make room in memory.
Definition: OrthancCppClient.h:1740
void DeletePatient(LAAW_UINT32 index)
Delete some patient.
Definition: OrthancCppClient.h:949
void DiscardDicom()
Discard the downloaded DICOM file, so as to make room in memory.
Definition: OrthancCppClient.h:1753
LAAW_UINT32 GetStudyCount()
Return the number of studies for this patient.
Definition: OrthancCppClient.h:1039
Exception class that is thrown by the functions of this shared library.
Definition: OrthancCppClient.h:166
LAAW_UINT32 GetSeriesCount()
Return the number of series for this study.
Definition: OrthancCppClient.h:1414
inline::Orthanc::ImageExtractionMode GetImageExtractionMode() const
Get the extraction mode for the 2D image corresponding to this instance.
Definition: OrthancCppClient.h:1545
void Finalize()
Manually finalize the shared library.
Definition: OrthancCppClient.h:363
inline::OrthancClient::Series GetSeries(LAAW_UINT32 index)
Get some series of this study.
Definition: OrthancCppClient.h:1431
Color image in RGB24 format.
Definition: OrthancCppClient.h:517
Color image in RGBA32 format.
Definition: OrthancCppClient.h:524
Truncation to the [0, 255] range.
Definition: OrthancCppClient.h:573
float GetTagAsFloat(const ::std::string &tag) const
Get the floating point value that is stored in some DICOM tag of this instance.
Definition: OrthancCppClient.h:1579
Graylevel 8bpp image.
Definition: OrthancCppClient.h:531
inline::Orthanc::PixelFormat GetPixelFormat()
Get the format of the pixels of the 2D image.
Definition: OrthancCppClient.h:1660
inline::std::string GetTagAsString(const ::std::string &tag) const
Get the string value of some DICOM tag of this instance.
Definition: OrthancCppClient.h:1562
Series(const Series &other)
Construct a new reference to this object.
Definition: OrthancCppClient.h:692
LAAW_UINT32 GetPitch()
Get the number of bytes between two lines of the image (pitch).
Definition: OrthancCppClient.h:1644
OrthancConnection(const OrthancConnection &other)
Construct a new reference to this object.
Definition: OrthancCppClient.h:611
ImageExtractionMode
The extraction mode specifies the way the values of the pixels are scaled when downloading a 2D image...
Definition: OrthancCppClient.h:551
~OrthancConnection()
Destructs the object.
Definition: OrthancCppClient.h:841
LAAW_UINT32 GetHeight()
Get the height of the 2D image.
Definition: OrthancCppClient.h:1628
OrthancClientException(std::string message)
Constructs an exception.
Definition: OrthancCppClient.h:176
void Initialize(const std::string &sharedLibraryPath)
Manually initialize the shared library.
Definition: OrthancCppClient.h:350
~Patient()
Destructs the object.
Definition: OrthancCppClient.h:1011
void SetThreadCount(LAAW_UINT32 threadCount)
Sets the number of threads for this connection.
Definition: OrthancCppClient.h:872
~Study()
Destructs the object.
Definition: OrthancCppClient.h:1386
Connection to a series stored in Orthanc.
Definition: OrthancCppClient.h:673
void StoreFile(const ::std::string &filename)
Send a DICOM file.
Definition: OrthancCppClient.h:963
inline::std::string GetId() const
Get the Orthanc identifier of this identifier.
Definition: OrthancCppClient.h:1515
LAAW_INT32 GetTagAsInt(const ::std::string &tag) const
Get the integer value that is stored in some DICOM tag of this instance.
Definition: OrthancCppClient.h:1596
void Reload()
Reload the list of the patients.
Definition: OrthancCppClient.h:885
LAAW_UINT32 GetWidth()
Get the width of the 3D image.
Definition: OrthancCppClient.h:1252
Rescaled to 8bpp.
Definition: OrthancCppClient.h:566
inline::std::string GetOrthancUrl() const
Returns the URL of this instance of Orthanc.
Definition: OrthancCppClient.h:899
float GetVoxelSizeY()
Get the physical size of a voxel along the Y-axis.
Definition: OrthancCppClient.h:1300
inline::OrthancClient::Study GetStudy(LAAW_UINT32 index)
Get some study of this patient.
Definition: OrthancCppClient.h:1056
inline::std::string GetMainDicomTag(const ::std::string &tag, const ::std::string &defaultValue) const
Get the value of one of the main DICOM tags for this patient.
Definition: OrthancCppClient.h:1090
Connection to an instance of Orthanc.
Definition: OrthancCppClient.h:592
const void * GetDicom()
Get a pointer to the content of the DICOM file corresponding to this instance.
Definition: OrthancCppClient.h:1725
Study(const Study &other)
Construct a new reference to this object.
Definition: OrthancCppClient.h:739
void Reload()
Reload the studies of this patient.
Definition: OrthancCppClient.h:1025
void Reload()
Reload the series of this study.
Definition: OrthancCppClient.h:1400