WAVEDLGPARAMS
typedef struct _WAVEDLGPARAMS
{
L_UINT uStructSize;
pBITMAPHANDLE pBitmap;
L_BOOL bZoomToFit;
L_UINT uAmplitude;
L_UINT uWaveLen;
L_INT nAngle;
L_UINT uHorzScale;
L_UINT uVertScale;
COLORREF crFill;
L_UINT uWaveFlags;
L_UINT32 uDlgFlags;
LTCOMMDLGHELPCB pfnHelpCallback;
L_VOID *pHelpCallBackUserData;
} WAVEDLGPARAMS, * LPWAVEDLGPARAMS ;
The WAVEDLGPARAMS structure provides information used to initialize the dialog box created by the LDialogImageEffect::DoModalFreeHandWave function. After the user closes the dialog box, this structure is updated with information about the user's selections.
Member |
Description |
|
uStructSize |
Size of this structure, in bytes. Use the sizeof operator to calculate this value. |
|
pBitmap |
Ignored. |
|
bZoomToFit |
Flag that indicates the initial zoom level for previewing the image. Possible values are: |
|
|
Value |
Meaning |
|
TRUE |
Set the initial zoom level to "Zoom to fit". |
|
FALSE |
Set the initial zoom level to "Normal (1:1)". |
uAmplitude |
Waves magnitude. The values range from 1 to the length of the image's diagonal. |
|
uWaveLen |
Value that represents the wave length, if DIS_PER is set in the uWaveFlags parameter. If DIS_FRQ is set in uWaveFlags, this value is the number of repeated waves. Possible values range from 0 – 100. |
|
nAngle |
Wave’s rotation angle in hundredths of degrees. The valid range is from –18000 to 18000 (The value in degrees is nAngle divided by 100). |
|
uHorzScale |
Size of the horizontal wave, given as a percentage of uAmplitude. The valid range is from 0 to 100. |
|
uVertScale |
Size of the vertical wave, given as a percentage of uAmplitude. The valid range is from 0 to 100. |
|
crFill |
The COLORREF value that specifies the fill color for any exposed areas. You can specify a COLORREF value, such as the return value of the Windows RGB macro, or you can use the PALETTEINDEX macro to specify a palette color. |
|
uWaveFlags |
Flags that indicate how to handle exposed areas, the type of information in the uWaveLength parameter and the wave type. You can use a bitwise OR (|) to specify one flag from each group. The following are the flags that indicate how to handle exposed areas: |
|
|
Value |
Meaning |
|
FILL_CLR |
[0x0000] fill exposed areas with the color in crFill. |
|
FILL_RPT |
[0x0001] stretch the edges of the image to fill the exposed area. |
|
FILL_NOCHG |
[0x0002] do not change exposed areas. |
|
The following are the flags that indicate the type of information in the uWaveLen member: |
|
|
Value |
Meaning |
|
DIS_PER |
[0x0000] The value in uWaveLen is a wavelength given as a percent of the bitmap dimensions. If this value is used, the valid range of uWaveLen is from 0 to 100. |
|
DIS_FRQ |
[0x0010] The value in uWaveLen is the frequency, or the number of times the wave repeats. |
|
The following are the flags that indicate the wave type: |
|
|
Value |
Meaning |
|
WV_SIN |
[0x0000] the wave is a sinusoidal wave. |
|
WV_COS |
[0x0100] the wave is a sinusoidal wave shifted by 90 degrees. |
|
WV_SQUARE |
[0x0200] the wave is a square wave. |
|
WV_TRIANG |
[0x0300] the wave is a triangular wave. |
uDlgFlags |
User interface flags for this dialog, which determine the layout and action of the dialog. Possible values are: |
|
|
Value |
Meaning |
|
DLG_WAVE_SHOW_CONTEXTHELP |
[0x00000002] dialog should contain a context sensitive help icon. |
|
DLG_WAVE_SHOW_APPLY |
[0x00000080] Show the Apply button in the dialog. The dialog will not apply any effect unless the user presses the Apply button. |
pfnHelpCallback |
Ignored. |
|
pHelpCallBackUserData |
Ignored. |