This function has been deprecated and will be removed from the public API in a future release. Use
MED_IP_contrast_auto_double instead.
This function converts a 16-bit grayscale image to an 8-bit grayscale image using the same function as MED_display_contrast_auto() except that this function permanently alters the pixel values.
Declaration:
|
Copy Code
|
AT_ERRCOUNT ACCUAPI MED_IP_contrast_auto(
const HIGEAR hIGear,
const LPAT_RECT lpRect,
const DOUBLE rescale_slope,
const DOUBLE rescale_intercept,
const DOUBLE gamma,
const LONG lReserved_option,
LPLONG lpWindow_center,
LPLONG lpWindow_width
);
|
Arguments:
Name |
Type |
Description |
hIGear |
const HIGEAR |
The HIGEAR handle to the image to convert. |
lpRect |
const AT_RECT |
Use this AT_RECT structure to specify the rectangular portion of the image for which to optimize the contrast on; set to NULL for the whole image. Please see the ImageGear User's Manual if you are unfamiliar with this structure. |
rescale_slope |
const DOUBLE |
Set to the value of the Data Element, Rescale Slope (0028,1053). You can use MED_DCM_DS_Rescale_get() to obtain this value. If this Data Element is not present in the Data Set, please set this value to 1.0. |
rescale_intercept |
const DOUBLE |
Set to the value of the Data Element, Rescale Intercept (0028,1054). You can use MED_DCM_DS_Rescale_get() to obtain this value. If this Data Element is not present in the Data Set, please set this value to 0.0. |
gamma |
const DOUBLE |
Non-linear method to adjust the contrast of DICOM image. In this method, the amount a pixel's intensity changes depends on its original intensity. Usual range is 0.75 to 3.0. |
lReserved_option |
const LONG |
Reserved for future use; please set to 0 for now. |
lpWindow_center |
LPLONG |
A far pointer that returns a LONG for the Window Center; set to NULL if you don't need this information. |
lpWindow_width |
LPLONG |
A far pointer that returns a LONG for the Window Width; set to NULL if you don't need this information. |
Supported Raster Image Formats:
Grayscale – 9…16 bpp.
Return Value:
Returns the number of ImageGear errors that occurred during the function call.
See Also
MED_display_contrast_auto()
MED_IP_reduce_depth_with_downshift()