-30-
Numbers (Integer, Float, …)
For numbers (integer, float,
etc…), limits are defined by:
•
All these entries consist in a 4bytes register access.
•
Masked = If a bit mask must be applied when accessing this value
•
Min = Minimum possible value
•
Max = Maximum possible value
•
Inc = Increment
A value X is defined by formula
𝑋 = 𝑀𝑖𝑛𝑉𝑎𝑙𝑢𝑒 + 𝑁 𝑥 𝐼𝑛𝑐
This value must respect
𝑀𝑖𝑛 ≤ 𝑋 ≤ 𝑀𝑎𝑥
Strings
For Strings, the limit is the length
“L”
(number of characters).
Command
A command consists in writing a fixed value = command value
“CV”
in a camera register. All these entries
consist in a 4bytes register access.
Enumeration
XML gives a list of values. Only listed values are valid. All these entries consist in a 4bytes register access.
6.1.5
XML Masked Values
Some XML entries are sharing the same camera registers and use bit masking to access the dedicated bits.
These entries use XML parameters “LSB” and “MSB” to identify the right bits.
Example:
If an XML entry has “Mask: LSB:31
-
MSB:16”, it means that the you access a 4bytes/32bit register and only the
upper 16 bits are used by this entry.
6.1.6
Acquisition/Live Stop Required
Some XML features require to stop image acquisition to be modified. Please be careful and stop camera
image acquisition when it is required.
GenICam XML feature “
TLParamsLocked
” is used to lock access to these
feature during live. Some frame
grabbers do not support “
TLParamsLocked
” feature and it is up to user software to manage accesses.
In XML entries description paragraph, such entries are greyed out as shown in above example to ease their
identification.
Example of greyed out XML entry:
Width
@ 0x6000
RW
Integer
Min: 128
Max: WidthMax
Inc: 128
This feature represents the actual image
width expelled by the camera (in pixels).
If you modify a feature requiring acquisition to be stopped without stopping acquisition,
camera behavior may become unstable and a power cycle may be required.
