*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->IRIX man pages -> dmedia/dmTCFramesBetween (3d)              


dmTCFramesBetween(3dm)					dmTCFramesBetween(3dm)

NAME    [Toc]    [Back]

     dmTCFramesBetween - digital media timecode	mathematics

SYNOPSIS    [Toc]    [Back]

     #include <dmedia/dm_timecode.h>

     DMstatus dmTCFramesBetween    [Toc]    [Back]
	 ( int *result,
	   const DMtimecode *a,
	   const DMtimecode *b )

TYPES    [Toc]    [Back]

     DMtimecode	  A structure containing a representation of SMPTE time	code
		  on which certain mathematical	and utility functions can be
		  performed.  Can be used with:	 dmTCAddTC(3dm),
		  dmTCAddFrames(3dm), dmTCToString(3dm), dmTCFromSeconds(3dm),
		  dmTCToSeconds(3dm), dmTCFromString(3dm),
		  dmTCFramesPerDay(3dm), and dmTCFramesBetween(3dm).  Can also
		  be used with the dmLTC(3dm) and dmVITC(3dm) routines.	 See
		  also DMtimecode(3dm).

ARGUMENTS    [Toc]    [Back]

     result The	result of calculating the difference (b-a), measured
	      in frames.

     a,	b     The two operands of the differencing operation.

DESCRIPTION    [Toc]    [Back]

     dmFramesBetween is	used to	determine the number of	frames between two
     timecodes.	It returns (b -	a), as measured	in frames.  The	result of the
     difference	operation may be negative; this	is not an error	condition.

     Note that the operands a and b must have the same tc_type as each other.

RETURN VALUE    [Toc]    [Back]

     If	a DMtimecode operand (a	or b) contains an illegal timecode value
     (e.g., a negative entry, invalid frame number, etc.), these functions
     will return DM_FAILURE, and the contents of result	will be	undefined.

     If	the tc_type's of a and b do not	match, dmTCFramesBetween will return
     DM_FAILURE, and the contents of result will be undefined.

     dmTCFramesBetween returns DM_SUCCESS upon successful completion of	the
     subtraction operation.

									Page 1

dmTCFramesBetween(3dm)					dmTCFramesBetween(3dm)

SEE ALSO    [Toc]    [Back]

     dmTCFromSeconds(3dm), dmTCToSeconds(3dm), dmTCFromString(3dm),
     dmTCFromString(3dm), dmTCFramesPerDay(3dm), dmTCFramesBetween(3dm),
     dmLTC(3dm), dmVITC(3dm)

									PPPPaaaaggggeeee 2222
[ Back ]
 Similar pages
Name OS Title
dmSetAudioDefaults IRIX parameters for digital-media audio
dmSetImageDefaults IRIX parameters for digital-media images
annotator IRIX 3D Annotation with Digital Media Notes
dmnet IRIX Digital Media Network Library
dminfo IRIX display information about digital media files
dmic IRIX Digital Media image conversion and compression
dmconvert IRIX digital media file conversion utility
dmrb IRIX digital media ring buffer device
dmParamsGetInt IRIX get values from digital media parameter/value lists
dmbuffer IRIX Digital Media data transport subsystem
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service