TVscaler.h

/* $Id: TVscaler.h,v 1.4 2008/06/03 08:32:32 vlad Exp $ */

#ifndef __TVscaler_h

#define __TVscaler_h

#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */

typedef struct
{
  /* o - origin */
  int oCnt;          /* count of o and Amax == trCnt */
  float Mt;          /* time scaling {ms/points} */
  int Ma;            /* amplitude scaling {points for an amplitude} */
  int o[1];          /* dynamic array of left down corner y-coordinates */

}  TraceScale;

/* Tunes box for each trace.
  Out:
   *ppts - pointer on the result structure; must be released by free();
   Returns:
     0 - OK;
    -1 - bad parameters;
    -2 - memory allocation fault;
  In:
    trCnt - count of trace to visualize in window;
    tPoint - count of points for the time dimention - width;
    aPoints - count of points for the depth dimension - height;
    _Tl - {ms} left time of the visualized trace;
    _Tr - {ms} right time of the visualized trace;
    _overlapping - {0..1} persent of usage other trace area;
*/
int TVscaler (TraceScale** ppts, unsigned long trCnt,
              unsigned int tPoints, float _Tl, float _Tr,
              unsigned int aPoints, float _overlapping);

float TransformTrCntToMa (unsigned int aPoints, float overlapping,
                          unsigned int trCnt);
unsigned int TransformMaToTrCnt (unsigned int aPoints, float overlapping,
                                 unsigned int Ma);

#ifdef __cplusplus
};
#endif /* __cplusplus */

#endif  /* TVscaler.h */