DTtimetoa(3dm)							DTtimetoa(3dm)

NAME    [Toc]    [Back]

     DTtimetoa - convert timecode to ASCII string

SYNOPSIS    [Toc]    [Back]

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

     void DTtimetoa(char* s, struct dttimecode *tc)

PARAMETERS    [Toc]    [Back]

     s	  A pointer to a string	to store the converted value.  The string
	  pointed at by	s must be at least 11 bytes long not counting the
	  terminating null.

     tc	  A pointer to the struct dttimecode to	be converted.

DESCRIPTION    [Toc]    [Back]

     DTtimetoa converts	a struct dttimecode into a printable ASCII string.  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;
	      };


     DTtimetoa converts	the BCD	digits into four fields	in the output string
     with a one	character separator between them.  DTtimetoa does not write
     the separator character.  The caller should pass DTtimetoa	a string with
     the desired separators already loaded.  For example the following code
     fragment will print the time with the fields separated by a ``:''.

	      char *atime = "--:--:--:--";

	      DTtimetoa(atime, timecode);
	      printf(atime);

SEE ALSO    [Toc]    [Back]

     DTintro(3dm), DTatotime(3dm), DTaddcallback(3dm), DTparseframe(3dm),
     datframe(4)

AUTHOR    [Toc]    [Back]

     Mark Callow


									PPPPaaaaggggeeee 1111