DTtctoframe(3dm)

NAME
     DTtctoframe - convert DAT timecode structure to DAT frame number.

SYNOPSIS
     #include <sys/types.h>
     #include <dmedia/dataudio.h>

     unsigned long DTtctoframe(struct dttimecode* tc)

PARAMETERS
     tc   A pointer to the struct dttimecode to be converted.

RETURNED VALUE
     DTtctoframe returns the desired frame number.

DESCRIPTION
     DTtctotime converts a struct dttimecode representing a time in absolute
     time on a DAT into the corresponding DAT frame number.  Absolute time is
     a continuously incrementing time starting from 0 at the start of the
     tape.  A struct dttimecode is defined as follows in dataudio.h :

              struct dttimecode {
                  unchar hhi:4, hlo:4;
                  unchar mhi:4, mlo:4;
                  unchar shi:4, slo:4;
                  unchar fhi:4, flo:4;
              };


     Frame numbers are much easier to compare than timecodes.

SEE ALSO
     DTintro(3dm), DTaddcallback(3dm), DThmsftoframe(3dm), DTparseframe(3dm),
     DTremovecallback(3dm), DTtcvalid(3dm), datframe(4)

AUTHOR
     Mark Callow