Function Reference


_GDIPlus_BitmapApplyEffect

Alters a Bitmap by applying a specified effect

#include <GDIPlus.au3>
_GDIPlus_BitmapApplyEffect ( $hBitmap, $hEffect [, $tRECT = Null] )

Parameters

$hBitmap Handle to a Bitmap to which the effect is applied.
$hEffect Handle to an Effect to be applied.
$tRECT [optional] a $tagRECT structure that specifies the portion of the input bitmap to which the effect is applied.

Return Value

Success: True.
Failure: False and sets the @error flag to non-zero, @extended may contain GPSTATUS error code ($GPIP_ERR* see GPIPlusConstants.au3).
@error: -1 - GDIPlus.dll does not support this function.
10 - Invalid parameters.

Remarks

Pass Null to the $tRECT parameter to specify that the effect applies to the entire input bitmap (Default).

Related

$tagRECT, _GDIPlus_BitmapApplyEffectEx, _GDIPlus_EffectCreate

See Also

Search GdipBitmapApplyEffect in MSDN Library.

Example

#include <GDIPlus.au3>
#include <GUIConstantsEx.au3>
#include <MsgBoxConstants.au3>

_Example()

Func _Example()
    If Not _GDIPlus_Startup() Or @extended < 6 Then
                MsgBox($MB_SYSTEMMODAL, "ERROR", "GDIPlus.dll v1.1 not available")
                Return
        EndIf

        Local $sFile = FileOpenDialog("Select an image", "", "Images (*.bmp;*.png;*.jpg;*.gif;*.tif)")
        If @error Or Not FileExists($sFile) Then Return

        Local $hImage = _GDIPlus_ImageLoadFromFile($sFile)
        Local $iImgW = _GDIPlus_ImageGetWidth($hImage)
        Local $iImgH = _GDIPlus_ImageGetHeight($hImage)

        Local $iWidth = 600
        Local $iHeight = $iImgH * 600 / $iImgW

        Local $hGui = GUICreate("GDI+ v1.1 (" & @ScriptName & ")", $iWidth, $iHeight)
        Local $hGraphics = _GDIPlus_GraphicsCreateFromHWND($hGui)
        GUISetState(@SW_SHOW)

        Local $hEffect = _GDIPlus_EffectCreateHueSaturationLightness(0, -100, 0)

        Local $tRECT = DllStructCreate($tagRECT)
        $tRECT.Left = $iImgW * 0.25
        $tRECT.Top = $iImgH * 0.25
        $tRECT.Right = $tRECT.Left + $iImgW * 0.5
        $tRECT.Bottom = $tRECT.Top + $iImgH * 0.5

        _GDIPlus_BitmapApplyEffect($hImage, $hEffect, $tRECT)

        _GDIPlus_GraphicsDrawImageRect($hGraphics, $hImage, 0, 0, $iWidth, $iHeight)

        Do
        Until GUIGetMsg() = $GUI_EVENT_CLOSE

        _GDIPlus_EffectDispose($hEffect)
        _GDIPlus_ImageDispose($hImage)
        _GDIPlus_GraphicsDispose($hGraphics)
        _GDIPlus_Shutdown()
EndFunc   ;==>_Example