rom/graphics/ucopperlistinit.c

   1 /*
   2     Copyright © 1995-2007, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     Desc: Graphics function UCopperListInit()
   6     Lang: english
   7 */
   8 #include <graphics/copper.h>
   9 #include <exec/types.h>
  10 #include <exec/memory.h>
  11 #include <proto/exec.h>
  12 #include "graphics_intern.h"
  13
  14 /*****************************************************************************
  15
  16     NAME */
  17 #include <proto/graphics.h>
  18
  19         AROS_LH2(struct CopList *, UCopperListInit,
  20
  21 /*  SYNOPSIS */
  22         AROS_LHA(struct UCopList *, ucl, A0),
  23         AROS_LHA(WORD             , n  , D0),
  24
  25 /*  LOCATION */
  26         struct GfxBase *, GfxBase, 99, Graphics)
  27
  28 /*  FUNCTION
  29         Allocates and initializes copperlist structures and buffers
  30         internal to UCopList structure.
  31
  32     INPUTS
  33         ucl - pointer to a UCopList structure. Must not be NULL!
  34         n   - number of instructions the buffer must be able to hold
  35
  36     RESULT
  37         cl - pointer to a buffer that will accept n intermediate
  38              copper instructions
  39
  40         NOTE: this is a pointer to UCopList->FirstCopList!
  41
  42     NOTES
  43
  44     EXAMPLE
  45
  46     BUGS
  47
  48     SEE ALSO
  49         CINIT(), CMOVE(), CWAIT(), CEND(), graphics/copper.h
  50
  51     INTERNALS
  52
  53     HISTORY
  54
  55 *****************************************************************************/
  56 {
  57   AROS_LIBFUNC_INIT
  58
  59   /* has this structure previously been initialized? */
  60
  61   if (ucl->FirstCopList != NULL &&
  62       ucl->FirstCopList->MaxCount != 0 &&
  63       ucl->FirstCopList->CopIns != NULL )
  64   {
  65     ucl->FirstCopList->Count  = ucl->FirstCopList->MaxCount;
  66     ucl->FirstCopList->CopPtr = ucl->FirstCopList->CopIns;
  67    return ucl->FirstCopList;
  68   }
  69
  70
  71   if (NULL != (ucl->FirstCopList =
  72                  (struct CopList *)AllocMem(sizeof(struct CopList),
  73                                             MEMF_CLEAR|MEMF_PUBLIC)))
  74   {
  75   /* if we were successful with the memory allocation then let's get
  76    * the buffer for the instructions
  77    */
  78     ucl->CopList = ucl->FirstCopList;
  79     /* further init the coplist structure */
  80     ucl->FirstCopList->MaxCount = n;
  81
  82     ucl->FirstCopList->CopIns = (struct CopIns *)AllocMem(n*sizeof(struct CopIns), MEMF_CLEAR|MEMF_PUBLIC);
  83     ucl->FirstCopList->CopPtr = ucl->FirstCopList->CopIns;
  84
  85     /* did we get the memory? */
  86     if (NULL == ucl->FirstCopList->CopIns)
  87       return (NULL);
  88   }
  89   return (ucl->FirstCopList);
  90   AROS_LIBFUNC_EXIT
  91 } /* UCopperListInit */