#include "Ltdic.h"
L_UINT16 LDicomDS::DeleteImage(pElement, nIndex, nCount)
Deletes one or more images from a Pixel Data element.
Pointer to a DICOMELEMENT structure within the Data Set.
Position of the first frame to delete. Use zero-based indexing. For example, if there are 10 bitmaps in a list, the index of the last one is 9.
Number of frames to delete from the Pixel Data Element.
Value | Meaning |
---|---|
0 | SUCCESS |
>0 | An error occurred. Refer to Return Codes. |
As an example, if you wish to delete 50 images starting with the 50th frame in the Pixel Data, call this function with nIndex set to 49 (the 50th frame in a zero-based index) and nCount set to 50.
Most DICOM files will only have one Data Element of type TAG_PIXEL_DATA. Therefore, in most instances you can set pElement to NULL, since the function will automatically delete the image(s) from the only Pixel Data Element in the file. If pElement is not NULL, it must point to the Pixel Data Element itself.
If the DICOM file is CLASS_BASIC_DIRECTORY, the file may contain more than one Pixel Data Element. In this case you must specify in pElement the Pixel Data Element from to delete the image(s).
If the DICOM dataset has a Multi-frame Functional Groups module that contains an item that has a Per-frame Functional Groups Sequence item, the corresponding item is removed from the dataset. If there is a Shared Functional Groups Sequence item, it will not be removed.
For a detailed discussion of Multi-frame Functional Groups and how the DICOM_SET_IMAGE_MFG flags are used, refer to Multi-frame Functional Groups.
Required DLLs and Libraries
Win32, x64
This example deletes all images from Data Set.
L_INT LDicomDS_DeleteImageExample()
{
L_INT nRet;
LDicomDS* pDS;
pDS = new LDicomDS(NULL);
nRet = pDS->LoadDS(MAKE_IMAGE_PATH(TEXT("image1.dcm")), 0);
if(nRet != DICOM_SUCCESS)
return nRet;
nRet = pDS->DeleteImage(NULL, 0, ELEMENT_INDEX_MAX);
if(nRet != DICOM_SUCCESS)
return nRet;
delete pDS;
return DICOM_SUCCESS;
}
Help Collections
Raster .NET | C API | C++ Class Library | HTML5 JavaScript
Document .NET | C API | C++ Class Library | HTML5 JavaScript
Medical .NET | C API | C++ Class Library | HTML5 JavaScript
Medical Web Viewer .NET
Multimedia
Direct Show .NET | C API | Filters
Media Foundation .NET | C API | Transforms
Supported Platforms
.NET, Java, Android, and iOS/macOS Assemblies
Imaging, Medical, and Document
C API/C++ Class Libraries
Imaging, Medical, and Document
HTML5 JavaScript Libraries
Imaging, Medical, and Document