In This Topic ▼

L_ClearPlaybackUpdateRect

#include "l_bitmap.h"

L_LTDIS_API L_INT L_ClearPlaybackUpdateRect(hPlayback)

Clears the update rectangle used for an animation playback, leaving an empty rectangle.

Parameters

HPLAYBACK hPlayback

Handle that references the animation playback.

Returns

Value	Meaning
SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

Regions are not supported on the Windows CE platform.

Required DLLs and Libraries

LTDIS
For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Win32, x64, Linux.

Functions

Topics

Example

This example uses L_ClearPlaybackUpdateRect to avoid painting odd numbered bitmaps.

L_INT ClearPlaybackUpdateRectExample(L_HWND  hWnd,pBITMAPHANDLE   pTargetBitmap, HBITMAPLIST   hList) 
{ 
   L_INT nRet; 
   HPALETTE    hpalPaint = NULL;  /* Paint palette handle */ 
   HPLAYBACK   hPlayback;         /* Animation playback */ 
   L_UINT      uState;            /* Next state in the playback */ 
   RECT        rcUpdate;          /* Source clipping rectangle used in playback */ 
   RECT        rcDisplay;         /* Display rectangle used in playback */ 
   HDC         hdc;               /* Device context of the current window */ 
   HPALETTE    hPalette = NULL;   /* Temporary copy of the current system palette */ 
   L_UINT      uIndex = 0;        /* Current index to the bitmap list */ 
 
   /* Use the client area as the display rectangle */ 
   GetClientRect(hWnd,&rcDisplay); 
   /* Create and run the playback */ 
   nRet = L_CreatePlayback(&hPlayback, pTargetBitmap, hList); 
   if(nRet != SUCCESS) 
      return nRet; 
   do 
   { 
      nRet = L_ProcessPlayback(hPlayback, &uState); 
      if(nRet != SUCCESS) 
         return nRet; 
      switch(uState) 
      { 
      case PLAYSTATE_POSTRENDER: 
         nRet = L_GetPlaybackIndex(hPlayback, (L_INT*)&uIndex); 
         if(nRet != SUCCESS) 
            return nRet; 
         if(uIndex % 2) 
         { 
            nRet = L_ClearPlaybackUpdateRect(hPlayback); 
            if(nRet != SUCCESS) 
               return nRet; 
         } 
         nRet = L_GetPlaybackUpdateRect(hPlayback, &rcUpdate, TRUE); 
         if(nRet != SUCCESS) 
            return nRet; 
         hdc = GetDC(hWnd); 
         if (hpalPaint) 
         { 
            hPalette = SelectPalette (hdc, hpalPaint, TRUE); 
            RealizePalette(hdc); 
         } 
         nRet = L_PaintDC(hdc, pTargetBitmap, NULL, &rcUpdate, &rcDisplay, &rcDisplay, SRCCOPY); 
         if(nRet != SUCCESS) 
            return nRet; 
         if (hpalPaint) 
            SelectPalette (hdc, hPalette, TRUE); 
         ReleaseDC(hWnd, hdc); 
         break; 
      } 
   } while(uState != PLAYSTATE_END); 
   /* Clean up */ 
   nRet = L_DestroyPlayback(hPlayback, NULL); 
   if(nRet != SUCCESS) 
      return nRet; 
   return SUCCESS; 
}

Download our FREE evaluation

Help Version 21.0.2023.2.15

Products | Support | Contact Us | Intellectual Property Notices
© 1991-2021 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Raster Imaging C API Help

Introduction

Version History

Getting Started

Files To Be Included With Your Application

Document Writers – Files To Be Included With Your Application

LEADTOOLS Raster Imaging Features