LEADTOOLS DICOM C++ Class Library Help > Classes and Member Functions > LDicomDS > LDicomDS Class Members > LDicomDS::CreateLayer |
#include "Ltdic.h"
L_UINT16 LDicomDS::CreateLayer(pGraphicLayer, pLayerIndex)
pDICOMGRAPHICLAYER pGraphicLayer; |
/* pointer to a Graphic Layer attributes structure */ |
L_UINT * pLayerIndex; |
/* pointer to a variable, which will be updated with the index of the newly created layer.*/ |
Adds a new item under the "Graphic Layer Sequence" (0070,0060) in the Graphic Layer Module".
Parameter |
Description |
pGraphicLayer |
Pointer to a Graphic Layer attributes structure, which holds the attributes of the layer to be created. |
pLayerIndex |
Pointer to a variable, which will be updated with the index of the newly created layer. |
Returns
0 |
SUCCESS |
>0 |
An error occurred. Refer to Return Codes. |
Comments
Before calling this function, initialize pDICOMGRAPHICLAYER->uStructSize to be sizeof(DICOMGRAPHICLAYER) and initialize all the structure members.
If for example there are already 2 items under the "Graphic Layer Sequence" (0070,0060) and we call this function, then the index of the new layer will be 2.
This function will fail and return DICOM_ERROR_PARAMETER if a layer with the same name as the new layer already exists in the dataset.
Required DLLs and Libraries
LTDIC For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application |
Win32, x64
See Also
Example
L_INT LDicomDS_CreateLayerExample(LDicomDS& PresStateDS) { L_INT nRet; DICOMGRAPHICLAYER Layer; memset(&Layer, 0, sizeof(DICOMGRAPHICLAYER)); L_TCHAR szText[256] = TEXT("\0"); L_INT16 RGBColors[3]; L_INT16 pGrayScle[1]; pGrayScle[0] = 32767; RGBColors[0] = 255; RGBColors[1] = 255; RGBColors[2] = 255; Layer.nLayerOrder = 1; Layer.pszLayerDescription = TEXT("First Layer"); Layer.pszLayerName = TEXT("LAYER0"); Layer.puGrayscale = pGrayScle; Layer.pRGBLayerColors = NULL; Layer.uStructSize = sizeof(DICOMGRAPHICLAYER); L_UINT uLayerIndex; nRet = PresStateDS.CreateLayer(&Layer, &uLayerIndex); if (nRet == DICOM_SUCCESS) { wsprintf(szText, TEXT("Index of the new layer is: %u "), uLayerIndex); MessageBox( NULL, szText, TEXT("Note"), MB_OK); } return nRet; }