DTtcvalid(3dm)

NAME
     DTtcvalid - check a dat timecode for validity

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

     int DTtcvalid(struct dttimecode* tc)

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

RETURNED VALUE
     DTtcvalid returns non-zero if the timecode structure represents a valid
     timecode otherwise it returns zero.

DESCRIPTION
     DTtctotime checks a struct dttimecode to see if it contains a valid
     timecode.  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;
              };


     Hours, minutes, seconds and frame number are each represented by 2 BCD
     digits.  A timecode is considered valid if all digits have values between
     0 and 9.

SEE ALSO
     DTintro(3dm), DTaddcallback(3dm), DTatotime(3dm), DTatohmsf(3dm),
     DTframetotc(3dm), DTframetohmsf(3dm), DThmsftoframe(3dm),
     DTparseframe(3dm), DTremovecallback(3dm) DTtctoframe(3dm),
     DTtimetoa(3dm), datframe(4)

AUTHOR
     Mark Callow