MED_DCM_DS_Window_Level_get

This function has been deprecated and will be removed from the public API in a future release. Use MED_DCM_DS_Window_Level_get_double instead.

This function searches the Data Set of the HIGEAR image for the Window Width and Window Center Data Elements.

Declaration:

	Copy Code
AT_ERRCOUNT ACCUAPI MED_DCM_DS_Window_Level_get_64( const HIGEAR hIGear, LPAT_INT64 lpWindow_Width, LPAT_INT64 lpWindow_Center, LPBOOL lpFound );

Arguments:

Name	Type	Description
hIGear	const HIGEAR	HIGEAR handle to the image from which you would like to retrieve the Window Level values.
lpWindow_Width	LPAT_INT64	Returns the value of the Window Level Width Data Element (0028,1051) as 64 bit integer.
lpWindow_Center	LPAT_INT64	Returns the value of the Window Level Center Data Element (0028,1050) as 64 bit integer.
lpFound	LPBOOL	Returns TRUE if both of these DEs are found in the Data Set; returns FALSE if one or the other is missing from the Data Set. Set to NULL if you do not need this information.

Return Value:

Returns the number of ImageGear errors that occurred during the function call.

Supported Raster Image Formats:

This function does not process image pixels.

The image must have a DICOM DataSet attached to it. Use MED_DCM_DS_exists to check whether the image contains a DataSet.

Example:

	Copy Code
AT_ERRCOUNT nErrcount; HIGEAR hIGear; AT_INT64 lWindow_min, lWindow_max; nErrcount = MED_DCM_DS_Window_Level_get_64(hIGear, &lWindow_min, &lWindow_max, NULL);

Remarks:

Use this function for 17-32 bits per pixel images. Although you can use this function for 8-16 bit images, it may impact performance in 32 bit operation systems. This function is a shortcut that was created because the values of these Data Elements are often sought after. You could perform this same operation, as you would for getting the information from any DE, by using MED_DCM_DS_move_find() and MED_DCM_DS_curr_data_get().

If both are found they are returned and lpFound is set to TRUE. If one or both of these DEs are not found, lpFound is set to FALSE and ImageGear attempts to calculate adequate values for both Width and Center to display all pixels in the image.