Release Notes Merge DICOM Toolkit v4.

7
Merge Healthcare 900 Walnut Ridge Drive Hartland, WI 53029 USA 877.44.MERGE

Copyright 2012 Merge Healthcare Incorporated Unauthorized use, reproduction, or disclosure is prohibited. This document has been prepared by Merge Healthcare Incorporated for its customers. The content of this document is confidential. It may be reproduced only with written permission from Merge Healthcare. Specifications contained herein are subject to change, and these changes will be reported in subsequent revisions or editions. Merge Healthcare is a registered trademark of Merge Healthcare Incorporated. DICOM is a registered trademark of National Electrical Manufacturers Association (NEMA). Merge DICOM Toolkit is a trademark of Merge Healthcare. The names of other products mentioned in this document may be the trademarks or registered trademarks of their respective companies. The Merge DICOM Toolkit v4.7 includes an evaluation version of Accusoft's AIMTools for Android SDK. It is the clients responsibility to license a full version of the AITMTools for Android SDK before deploying products built which use the AIMTools. Please contact Accusoft via www.Accusoft.com or info@accusoft.com to obtain licensing for the full version of the AIMTools for Android SDK. AIMTools is a trademark of Accusoft Corporation." For assistance, please contact Merge Healthcare Customer Support.

In North America, call toll free 1-800-668-7990, then select option 2. International, call Merge Healthcare (in Canada) +1-905-672-7990, then select option 2. Email mdtsupport@merge.com

Part

Date

Revision

Description

COM-625

December 2012

1 2

Initial revision Updated legal page

Chapter 1 Chapter 2 Chapter 3 Chapter 4

About the Application Enhancements Updates Known Issues

iii

Merge DICOM Toolkit v4.7 Release Notes

iv

1 Chapter 1 About the Application

The Merge DICOM Toolkit supplies you with a powerful and simplified interface to DICOM. It lets you focus on the important details of your application and the immediate needs of your end users, rather than the complex details of the DICOM standard. This release includes the following toolkits: Merge DICOM Toolkits Merge DICOM Toolkit C/C++ Toolkit V4.7.0 Target Development Environment 32-Bit Windows - Visual C++ 64-Bit Windows - Visual C++ 32-Bit Windows - Borland 32-Bit - Linux 64-Bit - Linux 32-Bit - Solaris 10 Intel - GCC Compiler 64-Bit - Solaris 10 Intel - GCC Compiler 32-Bit - Solaris 8 Sparc - Sun Compiler 32-Bit - Solaris 8 Sparc - GCC Compiler 32-Bit - MAC OS (Intel and Power PC) 64-Bit - MAC OS (Intel) 32-Bit - Android (ARMv7) Merge DICOM Toolkit .NET/C# Toolkit V4.7.0 Merge DICOM Toolkit Java Toolkit V4.7.0 32-Bit Windows 64-Bit Windows Windows, Solaris, Linux, Android (ARMv7)

This release includes the following:

"Enhancements" on page 3 "Updates" on page 7 "Known Issues" on page 9 1

Merge DICOM Toolkit v4.7 Release Notes

2 Chapter 2 Enhancements

In addition to updating the toolkit to reflect changes to the DICOM standard, this release also contains the following enhancements: Issue # COM-152 Description Support of extended character sets during validation of attribute length. This enhancement applies to all Merge DICOM Toolkits. COM-197 Support of extended character sets while converting DICOM to/from XML. This enhancement applies to the Merge DICOM C/C++ Toolkit. COM-209 Add extended character set encoding/decoding functionality with an optional ICU4C Unicode conversion library. This enhancement improves the Unicode conversion of DICOM defined character sets with and without code extensions. This enhancement applies to the Merge DICOM C/C++ Toolkit. COM-224 Added allowance of MONOCHROME J2K decompression to ignore signed pixel representation. This enhancement applies to the Merge DICOM C/C++ Toolkit. COM-595 Added support for frame level retrieval for COMPOSITE_INSTANCE_ROOT_RET_MOVE and COMPOSITE_INSTANCE_ROOT_RET_GET service classes in sample programs. This enhancement applies to all Merge DICOM Toolkits. COM-609 Support lazy image pixel data reading and frame by frame decoding, i.e. read frame on demand. This enhancement applies to all Merge DICOM Toolkits. COM-627 New API to return offset table of multi-frame image. This enhancement applies to all Merge DICOM Toolkits.

Merge DICOM Toolkit v4.7 Release Notes

Issue # COM-630

Description New API to return a requested frame of multi-frame image. This enhancement applies to all Merge DICOM Toolkits.

COM-635

Support Windows 8 This enhancement applies to all Merge DICOM Toolkits

COM-636

Support Windows Server 2012. This enhancement applies to all Merge DICOM Toolkits.

COM-644

DICOM Update: Add Supplements and Change Proposals as of Sep 30 2012. This enhancement applies to all Merge DICOM Toolkits.

COM-664

Support Japanese Supplementary Kanji character set ISO_IR 159. This enhancement applies to the Merge DICOM .NET/C# Toolkit.

COM-665

Integrate Pegasus library version 2.00.636 into toolkit. This enhancement applies to all Merge DICOM Toolkits.

COM-666

Added samples to show usage of getting a frame from multi-frame image. This enhancement applies to the Merge DICOM Java and .NET/C# Toolkits.

COM-757

Added support for Android platform. This enhancement applies to the Merge DICOM C/C++ and Java Toolkits.

COM-758

Added support for Android compression/decompression with evaluation copy (limited performance) of Accusoft's AIMTools toolkit version 2.00.021. This enhancement applies to the Merge DICOM C/C++ and Java Toolkits.

Enhancements

This release also contains updates to the DICOM standard. It addresses the following change proposals: CP# 739 1077 1105 1123 1137 1138 1148 1171 1175 1176 1177 1178 1179 1181 1182 1183 1184 1185 1186 1187 1188 1190 1191 1192 1193 1194 1195 Title Add View Code Sequence to CT, MR, SC for Cardiac Views Add CR report type to Dose SR and relax content conditions Conformance Claim for SR-CDA Transform Add attributes and codes for dose reports generated during QA scans Structure Set Relationship Sequence Average Beam Dose Parameter Add Pathology Protocol Codes Do not include Encapsulated Document on Retrieve without Bulk Data Structured Display needs creation date & time for instance and DICOMDIR Change CID of Anatomic Region Sequence for X-Ray 3D Angiography Remove inaccurate series entity description Additional Procedure Intents in CID 3629 Correct RWV Map in NM IOD Correct LOINC codes for fetuses Add SOP Classes to CT/MR Media Profiles Clarify meanings for UCUM codes Retire CID 3082 Cardiology Units of Measurement Correct vascular resistance units Remove Concatenation requirement in agreement with Sup 43 Wrong DICOM Tags are referenced in part 2 in HL7/Modality Worklist Attribute Mapping Add Tray ID to Compensator Add Purpose of Reference Code Sequence to Ophthalmic Frame Location Macro Correct tag mismatch between intravascular OCT image module and dictionary Correct tag mismatch between RT Beams Delivery instruction module and dictionary Remove obsolete reference in Pixel Presentation description Clarify dose for breast X-Ray Various correction to PS 3.16 5

Merge DICOM Toolkit v4.7 Release Notes

CP# 1197 1198 1199 1202 1204 1205 1206

Title Unspecified code should be forbidden in extensible context groups for mandatory content items Clarify encoding of Surface Segmentation Point Indices Add Modifier to Processing Parameters Sequence Correct code for Liver Identify specific Source used in RT Plan Device Parameters in CT Images Dose Summation Type Clarification

Change proposals apply to all toolkits. No new DICOM Supplements were added to this release.

3 Chapter 3 Updates

The following updates have been made to the toolkit to reflect changes to the DICOM standard: Issue # COM-227 Description Fixed PN value representation length validation to respect multiple component groups. This update applies to the Merge DICOM C/C++ Toolkit. COM-361 Fixed MC_Free_File/MC_Free_Message to report error when an SR object cannot be freed. This update applies to the Merge DICOM C/C++ Toolkit. COM-587 Fixed validation code that fails to catch ISO-IR 6 character out of range issue. This update applies to the Merge DICOM C/C++ Toolkit. COM-602 Fixed internal reallocation of a 40 byte block to a 64 block that causes memory corruption when triggered by MC_Reset_Filename. This update applies to the Merge DICOM C/C++ Toolkit. COM-603 Fixed MCattributeSet.list to dispose nested sequence item that can cause out of memory in native code. This update applies to Merge Java Toolkit. COM-605 Fixed memory leak when LARGE_DATA_STORE is set to FILE and data set is big endian. This update applies to all Merge DICOM Toolkits.

Merge DICOM Toolkit v4.7 Release Notes

Issue # COM-641

Description Fixed implementation of Supplement 74. This update applies to the Merge DICOM C/C++ Toolkit.

COM-642

Fixed mc3icomb that fails to merge new attributes into an existing item. This update applies to all Merge DICOM Toolkits.

COM-670

Fixed implementation of Supplement 96. This update applies to the Merge DICOM C/C++ Toolkit.

COM-730

Fixed validation code error in some cases that are conditional on other attribute's value. This update applies to all Merge DICOM Toolkits.

4 Chapter 4 Known Issues

The following table lists the issues that have been identified but not fixed in this release: Issue # COM-369 Description Decompressing single frame JPEG image calls registered decompression callback function with isLast=true twice. Impact This defect applies to Merge DICOM C/C++ Toolkit. Registered decompressing function will receive the second isLast=true callback with data length, data pointer being NULL. This defect applies to Merge DICOM C/C++ Toolkit. This only happens when there is no offset table for multi-frame image. User that needs to receive the entire pixel data before invoking a custom decompressor would not notice the end of data event. That means user does not know when to start decompressing. Note: As stated in User's Manual, Toolkit requires user's registered decompressing function to incrementally decompress and returns data constantly. If user must gather all pixel data before decompressing, then it is already breaking the protocol. Nevertheless, the toolkit may wish to revise this behaviour. Workaround When seeing isLast = true, data length = 0 and data pointer = NULL, just return MC_NORMAL_COMPLE TION.

COM-628

When user registers a decompression function and starts retrieving encapsulated data from a multi-frame image without offset table, the toolkit doesn't set isLast flag at the end of pixel data when calling the registered decompression callback.

Use MC_Register_Callback_F unction to receive the pixel data in user space. User can then trigger decompression with all data in user space.

Merge DICOM Toolkit v4.7 Release Notes

Issue # COM-631

Description C toolkit opens/closes temp file too often that impacts performance when LARGE_DATA_STORE is set to FILE

Impact This defect applies to Merge DICOM C/C++ Toolkit. When using temporary file as pixel data storage, large streaming file (gigabytes) can cause the writing of a chunk of data to be very slow due to the seeking operation to end of file after every fopen call.

Workaround 1. Set LARGE_DATA_STORE = MEM, or 2. Use MC_Register_Callback_F unction for pixel data tag and manage the pixel data by saving each chunk in a user controlled temporary file. User needs to close the temporary file only after the last chunk of data is written. User can pad the last MCdata buffer to even to match the setValue() parameter.

COM-645

Toolkit fails to pad odd size pixel data when total number of MCdata bytes are odd

This defect applies to Merge .NET/C+ Toolkit. When total number of bytes is odd, user is calling MCattribute.setValue(MCdata Source, length) with a rounded up even length. However, user's MCdataSource.providData can return MCdata with odd size each time. At the end, the toolkit may receive odd size total bytes. When streamed out, the toolkit does not pad and results in even attribute length but odd size value. This defect applies to Merge DICOM C/C++ Toolkit. Cannot compress an image using JPEG-LS transfer syntax.

COM-669

Missing JPEG-LS compressor opcode from Pegasus.

Receive a copy of the JPEG-LS opcode .dll/.so after purchasing license from Pegasus. Manually edit mergecom.pro to insert license information for JPEG-LS. None. Do not unplug network cable.

COM-719

Solaris Sparc 8 toolkit hangs in MC_Read_Message when network cable is unplugged.

This defect applies to Merge DICOM C/C++ Toolkit. When network cable is unplugged for testing, MC_Read_Message is not returning after timeout period.

10