User`s guide

FUNCTIONS

SDK SECTION 11

Page 241

SetRandomTracks

unsigned int WINAPI SetRandomTracks(int numTracks, int* areas)

Description

This function will set the Random-Track parameters. The positions of the tracks are

validated to ensure that the tracks are in increasing order and do not overlap. The

horizontal binning is set via the

SetCustomTrackHBin function. The vertical binning is set

to the height of each track.

Some cameras need to have at least 1 row in between specified tracks. Ixon+ and the

USB cameras allow tracks with no gaps in between.

Example:

Tracks specified as 20 30 31 40 tells the SDK that the first track starts at row 20 in the

CCD and finishes at row 30. The next track starts at row 31 (no gap between tracks) and

ends at row 40.

Parameters

int numTracks: number tracks

Valid values 1 to number of vertical pixels/2

int* areas: pointer to an array of track positions. The array has the form

bottom1, top1, bottom2, top2 ….. bottomN, topN

Return

unsigned int

DRV_SUCCESS

DRV_NOT_INITIALIZED

DRV_ACQUIRING

DRV_P1INVALID

DRV_P2INVALID

DRV_RANDOM_TRACK_ERROR

Parameters set.

System not initialized.

Acquisition in progress.

Number of tracks invalid.

Track positions invalid.

Invalid combination of tracks, out of memory or

mode not available.