Photon Focus DR1-D1312(IE)-G2, User Manual

Page: 115 / 133

6.7 MROI
The MROI feature is described in Section 4.3.4. This section describes how to set the MROI
values.
When MROI is enabled, then the camera internally processes the MROI entries sequentially,
starting at
MROI_Index
0. The processing is stopped when either the last
MROI_Index
is reached or
when an entry with MROI_Y =1081 is reached.
Procedure to write MROI entries:
1. Disable MROI by setting MROI_Enable to False. This is mandatory otherwise setting the
MROI entries will be ignored.
2. Set MROI_Index . In the first run it is set to 0 and then incremented in every run.
3. Set
MROI_Y
to the starting row of the MROI.
4. Set
MROI_H
to the height of the MROI.
5. Proceed with step 2, incrementing the MROI_Index . If no more MROI should be set, then
run the steps 2 to 4 again (incrementing MROI_Index ) but set MROI_Y to the value 1081.
6. Enable MROI by setting MROI_Enable to True.
7. Read the property MROI_Htot . Set the property Height (in category ImageFormatControl ) to
the value of MROI_Htot . This is mandatory as this value is not automatically updated.
Example pseudo-code to set two MROI: The resulting total height of the example will be 400.
SetFeature(’MROI_Enable’, false);
SetFeature(’MROI_Index’, 0);
SetFeature(’MROI_Y’, 50);
SetFeature(’MROI_H’, 100);
SetFeature(’MROI_Index’, 1);
SetFeature(’MROI_Y’, 600);
SetFeature(’MROI_H’, 300);
SetFeature(’MROI_Index’, 2);
SetFeature(’MROI_Y’, 1081);
SetFeature(’MROI_H’, 1);
SetFeature(’MROI_Enable’, true);
int heightTot;
GetFeature(’MROI_Htot’, &heightTot);
SetFeature(’Height’, heightTot);
6.8 Permanent Parameter Storage / Factory Reset
The property UserSetSave (in category UserSetControl ) stores the current camera settings in the
non-volatile flash memory. At power-up these values are loaded.
The property UserSetSave (in category UserSetControl ) overwrites the current camera settings
with the settings that are stored in the flash memory.
The command
CameraHeadFactoryReset
(in category
PhotonfocusMain
) restores the settings of the
camera head
The property CameraHeadStoreDefaults (in category PhotonfocusMain ) stores only
the settings of the camera head in the flash memory. It is recommended to use
UserSetSave instead, as all properties are stored.
6.7 MROI 113