BIN: set
binning factors
This page is part of the ING document
INS-DAS-24:
client-server interface for control of cameras
 
Purpose: establish binning factors for subsequent readouts.
Actors: udas_bin client; udas_camera server.
Outline: the client invokes the BIN action on the server. The
server rememebrs the binning factors and applies them to all subsequent
readouts.
Normal course of events:
- 
Client invokes the BIN action on the server with the following arguments:
 
- 
Argument1: the binning factor in the x direction (numbers 1..10
are valid).
 
- 
Argument2: the binning factor in the y direction (numbers 1..10
are valid).
 
- 
Server validates the arguments.
 
- 
Server adds the binning to the current readout format, and reprogrammes
the camera to suit.
 
- 
Server returns good status to the client.
 
- 
Server applies the revised format to all subsequent readouts.
 
Variations:
- 
At step 1, one or both of the binning factors is out of range. Server does
not apply the binning, returns an error message to the client and returns
status UDAS__BADBINNING for the action to the client.