DTinctime(3dm)							DTinctime(3dm)

NAME    [Toc]    [Back]

     DTinctime - increment a DAT time code

SYNOPSIS    [Toc]    [Back]

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

     void DTinctime(struct dttimecode *tc)

PARAMETER    [Toc]    [Back]

     tc	  A pointer to the struct dttimecode to	be incremented

DESCRIPTION    [Toc]    [Back]

     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    [Toc]    [Back]

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

AUTHOR    [Toc]    [Back]

     Mark Callow


									PPPPaaaaggggeeee 1111