Home| base |src.lib|graphic|fbuffer| FrameBufferMakeDash Index

FrameBufferMakeDash

Syntax
struct FrameBufferDash *FrameBufferMakeDash(int *p,int phase,int sze);
Header
base/rfbuffer.h
Library
rfbuf
Description

The FrameBufferMakeDash function makes a dash pattern for a frame buffer.

The array pointed to by the argument p is interpreted as distances along the line that alternately specify dashes and gaps. The argument sze give the number of elements in the array.

When a dashed line is plotted an element is read from the array and a dash of length equal to that value is drawn. A gap equal to the value of the next element is then left and the process is repeated until the end of the line is reached, cycling through the array as necessary.

The argument phase specifies the initial element to use from the array.

Returns
Returns a pointer to the dash structure on success. On error, a NULL pointer is returned.
Errors
On error, a NULL pointer is returned.
Example
None