====== SetReadAddress ======

Sets a bitmap's read address.

==== Synopsis ====

''%%Err SetReadAddress (Item bitmapItem,ubyte *buffer,int32 width)%%''

==== Description ====

This call sets the read pointer to the bitmap to the specified buffer that contains the specified pixel width. After calling SetReadAddress''%%()%%'', the specified buffer is used to render cels by reading from a source buffer before writing to the destination buffer.

==== Arguments ====

  * **bitmapItem** Item number of the bitmap structure whose read address is to be set.

  * **buffer** Pointer to the data buffer to be used as the read buffer.

  * **width** Pixel count of the width of the buffer.

==== Return Value ====

The call returns 0 if successful or an error code (a negative value) if an error occurs.

==== Implementation ====

Folio call implemented in Graphics folio V20.

==== Associated Files ====

graphics.h, graphics.lib

==== See Also ====

''%%ResetReadAddress%%''()