[Contents] [Index] [Help] [Retrace] [Browse <] [Browse >]


   NAME
        SetConductorState -- change the play state of a player's
                             conductor. (V37)

   SYNOPSIS
        result = SetConductorState(player, state, time);
        D0                         A0      D0     D1

        long setconductorstate(struct player *, ulong, long);

   FUNCTION
        Changes the play state of the conductor referenced by the
        player. The states can be CONDSTATE_STOPPED, CONDSTATE_PAUSED,
        CONDSTATE_LOCATE, CONDSTATE_RUNNING, or the special value
        CONDSTATE_METRIC which asks the highest priority conducted node
        to do a CONDSTATE_LOCATE, or the special value CONDSTATE_SHUTTLE
        which informs the players that the clock value is changing, but the
        clock isn't actually running. Note that going from CONDSTATE_PAUSED
        to CONDSTATE_RUNNING does not reset the cdt_ClockTime of the
        conductor.

   INPUTS
        player - player referencing the conductor to change
        state - new play state of conductor
        time - start time offset in realtime.library heartbeat units

   RESULTS
        result - 0 if everything went OK, or a realtime.library error code
                 if an error occured. These currently include RTE_PLAYING
                 and RTE_NOCONDUCTOR.