dcmtk-3.6.4-win32-dynamic.zip_DCMTKToolkit_dcmseg_dcmtk_dicom_di

=================================== DCMTK COMPILE TIME FLAGS AND MACROS =================================== The behavior of several DCMTK tools and libraries can be modified by a number of compile time flags (macros), which are explained below. Most of these macros enable experimental or rarely needed features in DCMTK, others disable certain functions. So please, use with care! ALLOW_ILLUMINATION_OVERRIDE Affected: dcmprscu Type of modification: Activates experimental or rarely used feature Explanation: Allows the settings for Illumination and Reflected Ambient Light, which are stored in a Stored Print object, to be overridden from the print job command file. BUGGY_IMPLEMENTATION_CLASS_UID_PREFIX Affected: storescp Type of modification: Activates workaround for known bug in other product Explanation: The dcmnet module contains a workaround that allows to communicate with some buggy Storage SCUs. If the global flag dcmPeerRequiresExactUIDCopy is enabled, an illegal space padding in the Affected SOP Instance UID field of the C-STORE-RQ message is retained in the corresponding C-STORE-RSP message. When this preprocessor macro is defined, it should contain the prefix of an implementation class UID of an implementation known to exhibit the buggy behavior. The workaround is then activated in storescp whenever a Storage SCU with the given implementation class UID root connects. DCMTK_BUILD_DATE Affected: dcmdata Type of modification: Toolkit customization Explanation: When this macro is defined (typically in config/Makefile.def), the given date is used instead of the official DCMTK release data. This allows for example to specify the date of a current development snapshot. DCMTK_BUILD_IN_PROGRESS Affected: all modules Type of modification: Toolkit customization Explanation: When building DLLs, exported symbols must be marked differently if the DLL itself is built or when the DLL shall be used. This macro is defined when the DCMTK gets built and should not be defined when user code that just uses the DCMTK is built. Based on this, the correct annotation gets selected and is used in the code. There should be no valid reasons to define this macro yourself since this is done automatically by the build system. DCMTK_ENABLE_UNSAFE_VSNPRINTF Affected: ofstd Type of modification: Activates feature Explanation: DCMTK requires the snprintf(3)/vsnprintf(3) function, which was introduced with C99 and may not be supported by very old compilers. As a "last resort", an implementation interally using sprintf/vsprintf can be enabled with this macro, which allows the user to compile DCMTK on platforms that do not have the new functions. The implementation allocates a buffer that is 1 kByte larger than the "size" parameter, formats the string into that buffer, and then uses strlcpy() to copy the formatted string into the output buffer, truncating if necessary. This will work in most cases, since few snprintf calls should overrun their buffer by more than 1K, but it can be easily abused by a malicious attacker to cause a buffer overrun. Therefore, this implementation should only be used as a "last resort" and we strongly advise against using it in production code. DCMTK_GUI Affected: all modules Type of modification: Activates experimental or rarely used feature Explanation: When this macro is defined, DCMTK re-assigns the standard output and error streams maintained by ofConsole to string streams. This will allow a GUI based application to extract the messages and either present them to the user or store them in a log file. See comments in ofstd/include/dcmtk/ofstd/ofconsol.h. DICOMDIR_WITHOUT_BACKUP Affected: dcmdata Type of modification: Disables feature Explanation: By default, DCMTK creates a backup of an existing DICOMDIR (using the name DICOMDIR.$$$) when a DcmDicomDir object is written to file. The creation of the backup can be disabled with this macro. DISABLE_COMPRESSION_EXTENSION Affected: dcmqrdb Type of modification: Disables feature Explanation: Disables the support of compression (various transfer syntaxes) in dcmqrdb, a feature which is still experimental. DISABLE_FF_JPEG_BITSTREAM_PADDING Affected: dcmjpeg, dcmjpls Type of modification: Disables feature Explanation: Starting with release 3.6.2, DCMTK pads JPEG and JPEG-LS bitstreams that have odd length with an "extended" end of image (EOI) marker, writing ff/ff/d9 instead of adding a zero byte after the EOI marker, i.e. writing ff/d9/00. The old behaviour can be restored by defining this macro. DISABLE_NAGLE_ALGORITHM Affected: dcmnet Type of modification: Disables feature Explanation: By default, DCMTK does not disable the so-called Nagle algorithm, which allows for improving the efficiency of TCP/IP networks by reducing the number of packets that need to be sent over the network. When compiled with this macro, the Nagle algorithm is disabled for each DICOM transport connection. This was the default in earlier versions of the DCMTK but does not seem to be appropriate anymore for most modern operating systems. The default behavior can be changed by setting the environment variable TCP_NODELAY accordingly (see config/docs/envvars.txt or /usr/local/share/doc/dcmtk/envvars.txt). DISABLE_OFSTD_ATOF Affected: all modules Type of modification: Disables feature Explanation: By default, DCMTK uses its own implementation of atof() to convert strings to double numbers in a locale-independent manner. This flag forces DCMTK to use the standard sscanf() function instead, which is normally much faster and gives a higher precision than DCMTK's built in code, but is locale dependent, i.e. cannot be used with locales such as German since DICOM decimal strings always use the Posix locale. DISABLE_OFSTD_FTOA Affected: all modules Type of modification: Disables feature Explanation: By default, DCMTK uses its own implementation to convert double numbers to strings to in a locale-independent manner. This flag forces DCMTK to use the standard sprintf() function instead, which is locale dependent, i.e. cannot be used with locales such as German since DICOM decimal strings always use the Posix locale. DISABLE_PORT_PERMISSION_CHECK Affected: most/all network server tools Type of modification: Disables feature Explanation: By default, most network server tools (e.g. storescp) check for sufficient privileges to listen on the specified port (if geteuid() is available on the particular system). For examples, on Unix systems listening on port < 1024 usually requires root privileges. However, the port permission check might prevent the tool from being run on such ports on systems with fine-grained permission control (e.g. Linux). Therefore, this check can be disabled using this flag. DISABLE_RECV_TIMEOUT This macro is not supported anymore since the timeout for the recv() function is now configurable at runtime. See global variable dcmSocketReceiveTimeout. DISABLE_SEND_TIMEOUT This macro is not supported anymore since the timeout for the send() function is now configurable at runtime. See global variable dcmSocketSendTimeout. DONT_DISABLE_NAGLE_ALGORITHM This macro is not supported anymore since the Nagle algorithm is no longer disabled by default. See DISABLE_NAGLE_ALGORITHM for details. DONT_LOAD_EXTERNAL_DICTIONARIES This macro is not supported anymore since it has been superseded by macro ENABLE_EXTERNAL_DICTIONARY. See ENABLE_EXTERNAL_DICTIONARY for details. DOXYGEN Affected: everything Type of modification: Hides complexity from Doxygen Explanation: Doxygen is unable to parse some complex statements correctly and it is sometimes