DTinctime(3dm)

NAME
     DTinctime - increment a DAT time code

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

     void DTinctime(struct dttimecode *tc)

PARAMETER
     tc   A pointer to the struct dttimecode to be incremented

DESCRIPTION
     DTinctime increments a DAT time code stored in a struct dttimecode by one
     frame carrying the result to the seconds, minutes, and hours fields as
     necessary.  A struct dttimecode is defined in dataudio.h as follows:

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


     DTinctime is useful when recording because the time code must be
     incremented for every frame of data recorded.  Incrementing a time code
     is tricky because the maximum value for the frame number depends on the
     value of the seconds field.  For (seconds modulo 3) = 2, the maximum
     value is 33 frames; for any other result, the maximum value is 32 frames.

SEE ALSO
     DTintro(3dm), DTatotime(3dm), DTcreateparser(3dm), DTdeleteparser(3dm),
     DTparseframe(3dm), DTremovecallback(3dm), DTresetparser(3dm),
     DTaddcallback(3dm), DTtimetoa(3dm), datframe(4)

AUTHOR
     Mark Callow