134 lines
		
	
	
		
			4.8 KiB
		
	
	
	
		
			C
		
	
	
	
			
		
		
	
	
			134 lines
		
	
	
		
			4.8 KiB
		
	
	
	
		
			C
		
	
	
	
| /*
 | |
|  * Copyright © 2003 Keith Packard
 | |
|  *
 | |
|  * Permission to use, copy, modify, distribute, and sell this software and its
 | |
|  * documentation for any purpose is hereby granted without fee, provided that
 | |
|  * the above copyright notice appear in all copies and that both that
 | |
|  * copyright notice and this permission notice appear in supporting
 | |
|  * documentation, and that the name of Keith Packard not be used in
 | |
|  * advertising or publicity pertaining to distribution of the software without
 | |
|  * specific, written prior permission.  Keith Packard makes no
 | |
|  * representations about the suitability of this software for any purpose.  It
 | |
|  * is provided "as is" without express or implied warranty.
 | |
|  *
 | |
|  * KEITH PACKARD DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
 | |
|  * INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
 | |
|  * EVENT SHALL KEITH PACKARD BE LIABLE FOR ANY SPECIAL, INDIRECT OR
 | |
|  * CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
 | |
|  * DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
 | |
|  * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
 | |
|  * PERFORMANCE OF THIS SOFTWARE.
 | |
|  */
 | |
| 
 | |
| #ifdef HAVE_DIX_CONFIG_H
 | |
| #include <dix-config.h>
 | |
| #endif
 | |
| 
 | |
| #ifndef _DAMAGE_H_
 | |
| #define _DAMAGE_H_
 | |
| 
 | |
| typedef struct _damage *DamagePtr;
 | |
| 
 | |
| typedef enum _damageReportLevel {
 | |
|     DamageReportRawRegion,
 | |
|     DamageReportDeltaRegion,
 | |
|     DamageReportBoundingBox,
 | |
|     DamageReportNonEmpty,
 | |
|     DamageReportNone
 | |
| } DamageReportLevel;
 | |
| 
 | |
| typedef void (*DamageReportFunc) (DamagePtr pDamage, RegionPtr pRegion,
 | |
|                                   void *closure);
 | |
| typedef void (*DamageDestroyFunc) (DamagePtr pDamage, void *closure);
 | |
| 
 | |
| /* It's the responsibility of the driver to duplicate both regions. */
 | |
| /* At some point DamageRegionRendered() must be called. */
 | |
| typedef void (*DamageMarkerFunc) (DrawablePtr pDrawable, DamagePtr pDamage,
 | |
|                                   RegionPtr pOldDamage, RegionPtr pRegion,
 | |
|                                   void *closure);
 | |
| 
 | |
| typedef void (*DamageScreenCreateFunc) (DamagePtr);
 | |
| typedef void (*DamageScreenRegisterFunc) (DrawablePtr, DamagePtr);
 | |
| typedef void (*DamageScreenUnregisterFunc) (DrawablePtr, DamagePtr);
 | |
| typedef void (*DamageScreenDestroyFunc) (DamagePtr);
 | |
| 
 | |
| typedef struct _damageScreenFuncs {
 | |
|     DamageScreenCreateFunc Create;
 | |
|     DamageScreenRegisterFunc Register;
 | |
|     DamageScreenUnregisterFunc Unregister;
 | |
|     DamageScreenDestroyFunc Destroy;
 | |
| } DamageScreenFuncsRec, *DamageScreenFuncsPtr;
 | |
| 
 | |
| extern _X_EXPORT void miDamageCreate(DamagePtr);
 | |
| extern _X_EXPORT void miDamageRegister(DrawablePtr, DamagePtr);
 | |
| extern _X_EXPORT void miDamageUnregister(DrawablePtr, DamagePtr);
 | |
| extern _X_EXPORT void miDamageDestroy(DamagePtr);
 | |
| 
 | |
| extern _X_EXPORT Bool
 | |
|  DamageSetup(ScreenPtr pScreen);
 | |
| 
 | |
| extern _X_EXPORT DamagePtr
 | |
| DamageCreate(DamageReportFunc damageReport,
 | |
|              DamageDestroyFunc damageDestroy,
 | |
|              DamageReportLevel damageLevel,
 | |
|              Bool isInternal, ScreenPtr pScreen, void *closure);
 | |
| 
 | |
| extern _X_EXPORT void
 | |
|  DamageDrawInternal(ScreenPtr pScreen, Bool enable);
 | |
| 
 | |
| extern _X_EXPORT void
 | |
|  DamageRegister(DrawablePtr pDrawable, DamagePtr pDamage);
 | |
| 
 | |
| extern _X_EXPORT void
 | |
|  DamageUnregister(DrawablePtr pDrawable, DamagePtr pDamage);
 | |
| 
 | |
| extern _X_EXPORT void
 | |
|  DamageDestroy(DamagePtr pDamage);
 | |
| 
 | |
| extern _X_EXPORT Bool
 | |
|  DamageSubtract(DamagePtr pDamage, const RegionPtr pRegion);
 | |
| 
 | |
| extern _X_EXPORT void
 | |
|  DamageEmpty(DamagePtr pDamage);
 | |
| 
 | |
| extern _X_EXPORT RegionPtr
 | |
|  DamageRegion(DamagePtr pDamage);
 | |
| 
 | |
| extern _X_EXPORT RegionPtr
 | |
|  DamagePendingRegion(DamagePtr pDamage);
 | |
| 
 | |
| /* In case of rendering, call this before the submitting the commands. */
 | |
| extern _X_EXPORT void
 | |
|  DamageRegionAppend(DrawablePtr pDrawable, RegionPtr pRegion);
 | |
| 
 | |
| /* Call this directly after the rendering operation has been submitted. */
 | |
| extern _X_EXPORT void
 | |
|  DamageRegionProcessPending(DrawablePtr pDrawable);
 | |
| 
 | |
| /* Call this some time after rendering is done, only relevant when a damageMarker is provided. */
 | |
| extern _X_EXPORT void
 | |
| 
 | |
| DamageRegionRendered(DrawablePtr pDrawable, DamagePtr pDamage,
 | |
|                      RegionPtr pOldDamage, RegionPtr pRegion);
 | |
| 
 | |
| /* Call this when you create a new Damage and you wish to send an initial damage message (to it). */
 | |
| extern _X_EXPORT void
 | |
|  DamageReportDamage(DamagePtr pDamage, RegionPtr pDamageRegion);
 | |
| 
 | |
| /* Avoid using this call, it only exists for API compatibility. */
 | |
| extern _X_EXPORT void
 | |
|  DamageDamageRegion(DrawablePtr pDrawable, const RegionPtr pRegion);
 | |
| 
 | |
| extern _X_EXPORT void
 | |
|  DamageSetReportAfterOp(DamagePtr pDamage, Bool reportAfter);
 | |
| 
 | |
| extern _X_EXPORT void
 | |
| 
 | |
| DamageSetPostRenderingFunctions(DamagePtr pDamage,
 | |
|                                 DamageReportFunc damageReportPostRendering,
 | |
|                                 DamageMarkerFunc damageMarker);
 | |
| 
 | |
| extern _X_EXPORT DamageScreenFuncsPtr DamageGetScreenFuncs(ScreenPtr);
 | |
| 
 | |
| #endif                          /* _DAMAGE_H_ */
 |