Home / Autodocs / graphics.library
NAME
- UCopperListInit
-
Initialize user copperlist to accept intermedidate user copper instructions.
SYNOPSIS
cl = CINIT( ucl , n )
cl = UCopperListInit( ucl , n )
struct CopList *UCopperListInit( struct UCopList *, UWORD );
cl = UCopperListInit( ucl , n )
a0 d0
FUNCTION
Allocates and/or initialize copperlist structures/buffers internal to a UCopList structure.
This is a macro that calls UCopListInit. You must pass a (non-initialized) UCopList to UCopperListInit. It will then initialize the intermediate data buffers internal to a UCopList.
The maximum number of intermediate copper list instructions that these internal CopList data buffers contain is specified as the parameter n.
The CINIT macro is identical to this function
This is a macro that calls UCopListInit. You must pass a (non-initialized) UCopList to UCopperListInit. It will then initialize the intermediate data buffers internal to a UCopList.
The maximum number of intermediate copper list instructions that these internal CopList data buffers contain is specified as the parameter n.
The CINIT macro is identical to this function
INPUTS
- ucl
-
pointer to UCopList structure or NULL
- n
-
number of instructions buffer must be able to hold
RESULT
cl- a pointer to a buffer which will accept n intermediate copper
instructions.
- NOTE:
-
this is NOT a UCopList pointer, rather a pointer to the UCopList's->FirstCopList sub-structure.
BUGS
This function does not actually allocate a new UCopList if ucl==0, instead it fails if the argument is NULL. You have to allocate a block MEMF_PUBLIC|MEMF_CLEAR of sizeof(struct UCopList) bytes and pass it to this function.
The system's FreeVPortCopLists function will take care of deallocating it if they are called.
Prior to release V36 the CINIT macro had { } braces surrounding the definition, preventing the proper return of the result value. These braces have been removed for the V36 include definitions.
The system's FreeVPortCopLists function will take care of deallocating it if they are called.
Prior to release V36 the CINIT macro had { } braces surrounding the definition, preventing the proper return of the result value. These braces have been removed for the V36 include definitions.