L_DlgHistogram
#include "l_bitmap.h"
L_LTDLG_API L_INT L_DlgHistogram(hWndOwner, pDlgParams)
|
L_HWND hWndOwner; |
/* owner of dialog */ |
|
LPHISTOGRAMDLGPARAMS pDlgParams; |
/* pointer to a HISTOGRAMDLGPARAMS structure */ |
Displays the Histogram dialog box.
|
Parameter |
Description |
|
hWndOwner |
Handle of the window which owns the dialog. |
|
pDlgParams |
Pointer to a HISTOGRAMDLGPARAMS structure to be updated with the values entered by the user, through the dialog. Set members of this structure, before calling this function, to set the dialogs initial values. |
Returns
|
SUCCESS_DLG_CLOSE |
The dialog exits successfully after pressing the "Close" button. |
|
< 1 |
An error occurred. Refer to Return Codes. |
Comments
Required DLLs and Libraries
|
LTDLGIMG For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application |
See Also
|
Functions: |
|
|
Topics: |
|
|
|
Example
// Example 1
// Example to illustrate using a bitmap to show histogram charts
L_INT DlgHistogramFirstExample(HWND hWnd,pBITMAPHANDLE pBitmap)
{
L_INT nRet;
HISTOGRAMDLGPARAMS DlgParam ;
memset ( &DlgParam, 0, sizeof ( HISTOGRAMDLGPARAMS ) ) ;
DlgParam.uStructSize = sizeof ( HISTOGRAMDLGPARAMS ) ;
DlgParam.pBitmap = pBitmap ;
DlgParam.crBlueChannelPen = RGB ( 0, 0, 255 ) ;
DlgParam.crGreenChannelPen = RGB ( 0, 255, 0 ) ;
DlgParam.crRedChannelPen = RGB ( 255, 0, 0 ) ;
DlgParam.crMasterPen = RGB ( 0, 0, 0 ) ;
DlgParam.uDlgFlags = DLG_HISTOGRAM_SHOW_VIEWSTYLE |
DLG_HISTOGRAM_USERPENCOLORS ;
nRet = L_DlgInit ( DLG_INIT_COLOR ) ;
if(nRet != SUCCESS && nRet != ERROR_DLG_ALREADYINITIATED)
return nRet;
nRet = L_DlgHistogram ( hWnd, &DlgParam ) ;
if(nRet < 1)
return nRet;
nRet = L_DlgFree () ;
if(nRet != SUCCESS)
return nRet;
return SUCCESS;
}
// Example 2
// Example to illustrate using histogram tables to show histogram charts
L_VOID GetBitmapHistogram(pBITMAPHANDLE pBitmap,
L_UINT uChannel,
L_UINT uCount,
L_UINT32** lppHistogram
)
{
// allocate histogram array
if ( ISGRAY( pBitmap ) )
{
switch ( pBitmap->BitsPerPixel )
{
case 1:
case 4:
case 8 :
{
uCount = 256 ;
}
break ;
case 12:
{
uCount = 4096 ;// maximum
// is there any way to decrease buffer size?
if ( !L_IsSupportLocked( L_SUPPORT_MEDICAL ) )
{
L_INT LowBit, HighBit ;
if ( SUCCESS == L_GetMinMaxBits( pBitmap, &LowBit, &HighBit ) )
{
uCount = (DWORD)1 << ( HighBit - LowBit + 1 ) ;
}
}
else
{
return ;
}
}
break ;
case 16:
{
uCount = 65536 ;
// is there any way to decrease buffer size?
if ( !L_IsSupportLocked( L_SUPPORT_MEDICAL ) )
{
L_INT LowBit, HighBit ;
if ( SUCCESS == L_GetMinMaxBits( pBitmap, &LowBit, &HighBit ) )
{
uCount = (DWORD)1 << ( HighBit - LowBit + 1 ) ;
}
}
else
{
return ;
}
}
break ;
default:
return ;
}
}
else
{
switch ( pBitmap->BitsPerPixel )
{
case 1:
case 2:
case 3:
case 4:
case 5:
case 6:
case 7:
case 8:
case 16:
case 24:
case 32:
{
uCount = 256 ;
}
break ;
case 48:
case 64:
{
uCount = 65536 ;
}
break ;
default:
return ;
}
}
*lppHistogram = (L_UINT32 *)malloc ( uCount * sizeof ( L_UINT32 ) ) ;
// read histogram
L_GetBitmapHistogram( pBitmap, *lppHistogram, uCount, uChannel ) ;
}
L_INT DlgHistogramSecondExample(HWND hWnd, pBITMAPHANDLE pBitmap)
{
L_INT nRet;
HISTOGRAMDLGPARAMS DlgParam ;
L_UINT32* pTempPtr = NULL;
memset ( &DlgParam, 0, sizeof ( HISTOGRAMDLGPARAMS ) ) ;
DlgParam.uStructSize = sizeof ( HISTOGRAMDLGPARAMS ) ;
pTempPtr = DlgParam.puMasterHistogram;
GetBitmapHistogram(pBitmap,
CHANNEL_MASTER,
DlgParam.uMasterHistogramLen,
&pTempPtr) ;
pTempPtr = DlgParam.puRedHistogram ;
GetBitmapHistogram(pBitmap,
CHANNEL_RED,
DlgParam.uRedHistogramLen,
&pTempPtr) ;
pTempPtr = DlgParam.puGreenHistogram;
GetBitmapHistogram(pBitmap,
CHANNEL_GREEN,
DlgParam.uGreenHistogramLen,
&pTempPtr) ;
pTempPtr = DlgParam.puBlueHistogram;
GetBitmapHistogram(pBitmap,
CHANNEL_BLUE,
DlgParam.uBlueHistogramLen,
&pTempPtr) ;
DlgParam.pBitmap = pBitmap ;
DlgParam.crBlueChannelPen = RGB ( 0, 0, 255 ) ;
DlgParam.crGreenChannelPen = RGB ( 0, 255, 0 ) ;
DlgParam.crRedChannelPen = RGB ( 255, 0, 0 ) ;
DlgParam.crMasterPen = RGB ( 0, 0, 0 ) ;
DlgParam.uDlgFlags = DLG_HISTOGRAM_SHOW_VIEWSTYLE |
DLG_HISTOGRAM_USERPENCOLORS ;
nRet = L_DlgInit ( DLG_INIT_COLOR ) ;
if(nRet != SUCCESS && nRet != ERROR_DLG_ALREADYINITIATED)
return nRet;
nRet = L_DlgHistogram ( hWnd, &DlgParam ) ;
if(nRet < 1)
return nRet;
nRet = L_DlgFree () ;
if(nRet != SUCCESS)
return nRet;
free ( DlgParam.puMasterHistogram ) ;
free ( DlgParam.puRedHistogram ) ;
free ( DlgParam.puGreenHistogram ) ;
free ( DlgParam.puBlueHistogram ) ;
return SUCCESS;
}