3.9 Streaming
3.9.1 Overview
Streaming features are used to transfer previously recorded frames from the
camera internal memory to the host computer. The camera can be configured
to use 1, 2, 4, 8 or 16 different buffers (also called Sequences) for recording.
The camera memory is divided by the number of sequences to record. If only
one buffer is defined the complete camera memory is reserved for this one buf-
fer. If two sequences are defined the memory is divided by 2. So each buffer
gets assigned the half of the camera memory and so on.
One buffer is always the current buffer that gets circularly filled with images, if
the camera is in continuous recording mode. An external or internal trigger
pulse stops recording to the current buffer and switches to the next buffer to
continue with recording. This buffer becomes the new current buffer. If the last
buffers gets a stop signal by the trigger recording stops finally and the camera
enters the idle state. Now the images in the different buffers can be read out
for further processing.
Before reading frames from a buffer it must be selected by its sequence num-
ber (0…16). All streaming commands and setting will refer to this selected buf-
fer from now on. The frames can be read from a buffer as single frames or as
a sequence of frames.
Single frames can be read out randomly by setting its frame number, starting
with 0. The transmission of the frames starts at the moment the frame number
is written to the according feature.
Before starting the transfer from the camera to the host, the host and the cam-
era must be set to a state where they accept respectively transfer image data.
This is done on the camera side by sending the AcquisitionSource(Memory)
command and the AcquisitionStart command to the camera.
Reading a sequence of frames requires two steps. At first the start and the end
number of the frames must be defined by setting the start and the end number
feature. Now, streaming of the frames can be started by executing the
StreamSequenceStart command.
The frame with the number 0 of a sequence is always the oldest frame in the
buffer, even if recording is done in continuous mode (this is organized auto-
matically by the camera). If there was a trailer defined for the current recording
(see RecordTrailer), the frame at which the trigger arises (trigger frame), is the
last frame in the sequence minus the number of trailer frames.
NOTE Starting a new recording will overwrite all previously recorded frames!
Name Type Access
StreamSequenceStart Command WO
StreamSingleFrame Integer RW
Feature description
MikrotronGmbH / mini1 / CAMMC1370/71-RG / 2021 41 - 67