rom/graphics/cwait.c

   1 /*
   2     Copyright © 1995-2007, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     Desc: Graphics function CWait()
   6     Lang: english
   7 */
   8 #include <exec/types.h>
   9 #include <graphics/copper.h>
  10 #include "graphics_intern.h"
  11
  12 /*****************************************************************************
  13
  14     NAME */
  15 #include <proto/graphics.h>
  16
  17         AROS_LH3(void, CWait,
  18
  19 /*  SYNOPSIS */
  20         AROS_LHA(struct UCopList *, ucl, A1),
  21         AROS_LHA(WORD             , v,   D0),
  22         AROS_LHA(WORD             , h,   D1),
  23
  24 /*  LOCATION */
  25         struct GfxBase *, GfxBase, 63, Graphics)
  26
  27 /*  FUNCTION
  28         Add a copper wait instruction to the given user copper list.
  29         The copper is told to wait for a vertical beam position v and
  30         a horizontal beam position h.
  31         If you are using CWAIT() a call to CWait() and CBump() will
  32         be made.
  33
  34     INPUTS
  35         ucl - pointer to a UCopList structure
  36         v   - vertical beam position (relative to top of viewport)
  37         h   - horizontal beam position
  38
  39     RESULT
  40
  41     NOTES
  42
  43     EXAMPLE
  44
  45     BUGS
  46         It's illegal to wait for horizontal values greater than 222 decimal!
  47
  48     SEE ALSO
  49         CINIT(), CMOVE(), CEND(), graphics/copper.h
  50
  51     INTERNALS
  52
  53     HISTORY
  54
  55 *****************************************************************************/
  56 {
  57   AROS_LIBFUNC_INIT
  58
  59   struct CopIns * copIns = ucl->CopList->CopPtr;
  60   copIns->OpCode = COPPER_WAIT;
  61   copIns->u3.u4.u1.VWaitPos = v;
  62   copIns->u3.u4.u2.HWaitPos = h;
  63
  64   AROS_LIBFUNC_EXIT
  65 } /* CMove */