User Guide

5-14 Ampex 1308911-02
Model No.
Running Head
dst_convpos libdd2 API Functions
typedef struct
{
dst_pos_type_en source; /* Source position type */
dst_position_un srcpos; /* Source position */
dst_pos_type_en dest; /* Destination position type */
dst_position_un destpos; /* Destination position */
} dst_convpos_st;
Before calling dst_convpos():
• Initialize the srcpos union with the source position specification. If the specification
is in structure form, set the
valid bit mask to specify which members contain valid
information.
• Initialize the source and dest members of the *pos structure with definitions of the
source and destination position specifications.
On return, the
destpos union contains the converted position specification. If the
specification is in structure form, the
valid bit mask specifies which members contain valid
information.
STRUCTURE MEMBERS
source/dest Source and destination position definitions. You can specify token/
structure or structure/token but not token/token or structure/structure.
The following definitions are valid:
T
oken Structure
DstPosTok DstPosDD2
DstPos600
DstPosDIS
The structure definition specifies the format for the converted position
specification (DD-2, DST600, or DIS). Make sure that the source
element contains appropriate position information for this definition as
the conversion is performed without error checking of the source data.
srcpos A union containing the position token or structure to be converted.
When converting from structure to token, make sure that the
valid bit
is set correctly.
dst_convpos() only converts complete positions. Use the dst_getpos()
function to get the complete form of the current position if necessary.
destpos A union into which this function places the converted position token or
structure.