QSE_tkrPrint.c File Reference

Prints an ASCII display of the TKR tracker data. More...

#include <QSE/QSE_tkrPrint.h>
#include <QSE/QSE_tkr.h>
#include <QSE/QSE_map.h>
#include <stdio.h>

Classes
struct	_PrintCtx
	A structure controlling the strips to be printed. More...
Typedefs
typedef struct _PrintCtx	PrintCtx
	Typedef for struct _PrintCtx.
typedef int(*	Print )(PrintCtx *ctx, int cur, int max)
	Routine to do the actual printing.
Functions
static void	printNoData (QSE_map twrMap, unsigned int requestMap)
	Prints a banner indicating there is no data in the request towers.
static void	printTower (const QSE_tkrTwr *twr, Print print)
	Prints an ASCII display of the tracker data from the TKR Tower Record (ttr).
static void	printLayer (const QSE_tkrLyr *x, const QSE_tkrLyr *y, int lyrNum, Print print)
	Prints an ASCII display of hits strips.
static int	printTots (int left, int hiLo, const unsigned char *tots)
	Prints an ASCII display of the TOTs.
static int	printClusters (PrintCtx *ctx, int cur, int max)
	Callback routine to print the corrected strips as a cluster.
static int	printStrips (PrintCtx *ctx, int cur, int max)
	Callback routine to individually print the strips.
void	QSE_tkrPrint (const QSE_tkr *tkr, unsigned int options)
	Prints an ASCII display of all the towers which have been unpacked.

---

Detailed Description

Prints an ASCII display of the TKR tracker data.

Author:

JJRussell - russell@slac.stanford.edu

    CVS $Id: QSE_tkrPrint.c,v 1.6 2011/03/27 01:45:45 russell Exp $

---

Typedef Documentation

typedef int(* Print)(PrintCtx *ctx, int cur, int max)

Routine to do the actual printing.

Returns:

The number of characters output

Parameters:

	ctx	The current context,
	cur	The current column number to print in
	max	The maximum column number to print in

PrintCtx

Typedef for struct _PrintCtx.

This structure contains which strip is currently being processed and how many strips are remaining.

---

Function Documentation

static int printClusters	(	PrintCtx *	ctx,
		int	col,
		int	max
	)			[static]

Callback routine to print the corrected strips as a cluster.

Returns:

The last column used

Parameters:

	ctx	The print context
	col	The current column number
	max	The maximum column number

References _PrintCtx::cnt, _PrintCtx::split, and _PrintCtx::strips.

Referenced by QSE_tkrPrint().

void printLayer	(	const QSE_tkrLyr *	x,
		const QSE_tkrLyr *	y,
		int	lyrNum,
		Print	print
	)			[static]

Prints an ASCII display of hits strips.

Parameters:

	print	User provided callback to do the actual printing
	lyrNum	The layer number of the strips to be displayed.
	x	The X layer description of the strips (may be NULL if there are none.
	y	The Y layer description of the strips (may be NULL if there are none.

References _QSE_tkrLyr::beg, _PrintCtx::cnt, _QSE_tkrLyr::hiLo, _QSE_tkrLyr::nsplit, _QSE_tkrLyr::nstrips, printTots(), _PrintCtx::split, _PrintCtx::strips, and _QSE_tkrLyr::tots.

Referenced by printTower().

static void printNoData	(	QSE_map	map,
		unsigned int	request
	)			[static]

Prints a banner indicating there is no data in the request towers.

Parameters:

	map	The map of towers with data
	request	The map of towers to print

Referenced by QSE_calPrint(), and QSE_tkrPrint().

static int printStrips	(	PrintCtx *	ctx,
		int	col,
		int	max
	)			[static]

Callback routine to individually print the strips.

Returns:

The last column used

Parameters:

	ctx	The print context
	col	The current column number
	max	The maximum column number

References _PrintCtx::cnt, _PrintCtx::split, and _PrintCtx::strips.

Referenced by QSE_tkrPrint().

static int printTots	(	int	left,
		int	hiLo,
		const unsigned char *	tots
	)			[static]

Prints an ASCII display of the TOTs.

Parameters:

	left	Number of columns before the left margin
	hiLo	A bit mask indicating which TOT(s) are valid, must 0,1,2,3
	tots	The array of (potentially) 2 TOTs

Returns:

The number of columns used to print

Referenced by printLayer().

static void printTower	(	const QSE_tkrTwr *	twr,
		Print	print
	)			[static]

Prints an ASCII display of the tracker data from the TKR Tower Record (ttr).

Parameters:

	twr	The TKR Tower Record to print.
	print	Routine controlling the printing of individual clusters.

References _QSE_tkrTwr::lyrMaps, _QSE_tkrTwr::lyrs, _QSE_tkrTwr::num, printLayer(), QSE_mapMask(), and QSE_mapScanr().

Referenced by QSE_tkrPrint().

void QSE_tkrPrint	(	const QSE_tkr *	tkr,
		unsigned int	options
	)

Prints an ASCII display of all the towers which have been unpacked.

Parameters:

	tkr	The tracker LAT record to be displayed.
	options	A word controlling the print options. The top 16 bits represent a left justified (MSB = Tower 0) of which towers to print. The low 1 bits specify whether you wish the style to be as clusters (bit 0) See the QSE_TKRPRINT_OPTS_M for details

References _QSE_tkr::map, printClusters(), printNoData(), printStrips(), printTower(), QSE_mapRemove(), QSE_mapScanf(), and _QSE_tkr::twrs.