workbench/libs/realtime/externalsync.c

   1 /*
   2     Copyright © 1995-2001, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     Desc:
   6     Lang: English
   7 */
   8
   9 #include <proto/exec.h>
  10
  11 /*****************************************************************************
  12
  13     NAME */
  14
  15 #include <libraries/realtime.h>
  16
  17     AROS_LH3(BOOL, ExternalSync,
  18
  19 /*  SYNOPSIS */
  20
  21         AROS_LHA(struct Player *, player , A0),
  22         AROS_LHA(LONG           , minTime, D0),
  23         AROS_LHA(LONG           , maxTime, D1),
  24
  25 /*  LOCATION */
  26
  27         struct Library *, RealTimeBase, 11, RealTime)
  28
  29 /*  FUNCTION
  30
  31     Constrain conductor time between 'minTime' and 'maxTime' (however, time
  32     can never run backwards). If the specified player isn't the current
  33     external synchronizing source, this function does nothing.
  34
  35     INPUTS
  36
  37     player   --  The player in question
  38     minTime  --  Lower time bound
  39     maxTime  --  Upper time bound
  40
  41     RESULT
  42
  43     A BOOL specifying if the success of this function; FALSE means that the
  44     player was not the external source or that no conductor was found for
  45     the player.
  46
  47     NOTES
  48
  49     EXAMPLE
  50
  51     BUGS
  52
  53     SEE ALSO
  54
  55     INTERNALS
  56
  57     HISTORY
  58
  59     27.7.99  SDuvan  implemented
  60
  61 ******************************************************************************/
  62
  63 {
  64     AROS_LIBFUNC_INIT
  65
  66     if ((player == NULL) || (player->pl_Source == NULL) ||
  67         !(player->pl_Flags & PLAYERF_EXTSYNC))
  68     {
  69         return FALSE;
  70     }
  71
  72     player->pl_Source->cdt_ExternalTime    = minTime;
  73     player->pl_Source->cdt_MaxExternalTime = maxTime;
  74     player->pl_Source->cdt_Flags |= CONDUCTF_GOTTICK;
  75
  76     return TRUE;
  77
  78     AROS_LIBFUNC_EXIT
  79 } /* ExternalSync */