a1200   NEWS   APPS   DOCS   ABOUT
a1200
----
a1200
----
Autodocs
 Libraries:
 layers.library
  BeginUpdate
  BehindLayer
  CreateBehindHookLayer
  CreateBehindLayer
  CreateUpfrontHookLayer
  CreateUpfrontLayer
  DeleteLayer
  DisposeLayerInfo
  DoHookClipRects
  EndUpdate
  FattenLayerInfo
  InitLayers
  InstallClipRegion
  InstallLayerHook
  InstallLayerInfoHook
  LockLayer
  LockLayerInfo
  LockLayers
  MoveLayer
  MoveLayerInFrontOf
  MoveSizeLayer
  NewLayerInfo
  ScrollLayer
  SizeLayer
  SwapBitsRastPortClipRect
  ThinLayerInfo
  UnlockLayer
  UnlockLayerInfo
  UnlockLayers
  UpfrontLayer
  WhichLayer
Include
GuruMeditation
Docs » Autodocs » layers.library » BeginUpdate

NAME

	BeginUpdate -- Prepare to repair damaged layer.

SYNOPSIS

	result = BeginUpdate( l )
d0 a0
LONG BeginUpdate( struct Layer *);

FUNCTION

	Convert damage list to ClipRect list and swap in for
programmer to redraw through. This routine simulates
the ROM library environment. The idea is to only render in the
"damaged" areas, saving time over redrawing all of the layer.
The layer is locked against changes made by the layer library.

INPUTS

	l - pointer to a layer

RESULT

	result - TRUE if damage list converted to ClipRect list successfully.
FALSE if list conversion aborted. (probably out of memory)

BUGS

	If BeginUpdate returns FALSE, programmer must abort the attempt to
refresh this layer and instead call EndUpdate( l, FALSE ) to restore
original ClipRect and damage list.

SEE ALSO

EndUpdate(), <graphics/layers.h>, <graphics/clip.h>

Comments

Name:
E-mail: Use this if you want a message if you get a response, will not be shown.
Comment:
Select correct short for:

Abyss

AOA
AYS
SNT
HZ

Comments:

$VER: d0.se 1.14 Copyright © 2011-2024 Tobias Geijersson support at d0 dot se