Baumer Gapi 2 Release Notes: 1/15 Baumer Optronic GMBH Radeberg, Germany
Baumer Gapi 2 Release Notes: 1/15 Baumer Optronic GMBH Radeberg, Germany
Inhalt
1 Release Notes BGAPI 2.4 .................................................................................................................................................. 3
1.1 BGAPI....................................................................................................................................................................................................................... 3
1.1.1 Consumer ............................................................................................................................................................................................................... 3
1.1.2 GigE Interface ....................................................................................................................................................................................................... 4
1.1.3 Image processor .................................................................................................................................................................................................. 4
1.2 Examples ................................................................................................................................................................................................................ 4
1.3 Doc............................................................................................................................................................................................................................. 5
1.4 Tools ......................................................................................................................................................................................................................... 5
1.1.1 Consumer
Enhancements
o Support Windows 10 for USB3 Vision
o Support Windows 10 for GigE Vision – NDIS 6 based Filter driver for Windows 10 added
o API behavior changes
GenICam nodes of type ‘String’ are now supported by functions INode::GetNodeList
and INode::GetNodeTree
Implemented the mechanism behind the mandatory SFNC feature TLParamsLocked.
For backward compatibility with existing BGAPI implementations the Consumer
provides the Device feature DisableTLParamsLocked which bypasses this mechanism.
Confusing behavior of function SystemList::Refresh clarified. The function throws an
exception, if the initialization of at least one GenTL producer fails but the list was
filled with valid producer objects. The new version solved this behavior in the
following way: The Refresh function doesn’t throw an exception when it enumerates
an invalid GenTL producer. This producer will now add to the system list. The
exception is thrown when the user accessing it directly.
Caching type changed from WriteAround to WriteThrough for all node types except
nodes with IFloat interface (see function Node::GetInterface to determine the node
type and table API changes).
Behavior of C++ function Node::GetDoubleInc and C# property Node.Inc changed to
be standard conform. The function throws an exception, if the underlying GenICam
XML description file doesn’t contain the <Inc> element. To avoid the exception use
C++ function Node::HasInc (property Node.HasInc for C# respectively).
o API changes
o C# Interface
Solved a problem with removing initialized objects (refer to clear() functions of
BGAPI2 list classes)
Bugfixes
o A Buffer with faulty chunk data doesn’t deliver a ChunkNodeMap. But the buffer remains in
this error state even if the chunk data is correct within the next image.
o Solved a problem which blocks the image callback, e.g. caused by a corrupted chunk block
o Solved a problem under Linux platform when loading a GenTL producer from the GenICam
path.
o C++ Interface
Solved a problem with assignment operator.
o C# Interface
Solved a problem, which signals DeviceEvents multiple times, when reopen a device.
Access to RemoteNodeList after Device.Close throws now a
BGAPI2.Exceptions.NotInitializedException instead of
System.AccessViolationException.
Solve a problem when calling DataStream::RegisterNewBufferEvent with
EventMode.POLLING and EventMode.UNREGISTERED
1.2 Examples
Enhancements
1.3 Doc
InstallationGuide_Linux.pdf
ProgrammersGuide.pdf
1.4 Tools
CameraExplorer
o Enhancements
Supports loading and saving user sets for LXG cameras series
Improved displaying of images in Baumer Raw Format (.brw)
Supports the image format JPEG2000 for saving images to file
Setup
o Enhancements
Reorganized Startup Menu. Changed to flat style with the new folder name Baumer
GAPI-SDK.
2.1 BGAPI
Information
o All Linux distributions were up to date at the time of creation SP5.
2.1.1 Consumer
Enhancements
o C# interface
Documentation file bgapi2_genicam_dotnet.XML added
Additional Buffer constructor added, which allows the programmer to use his own
memory
Problem solved, function CreateBitmap produces only gray images if the source
image has RGB pixel format
Bugfixes
o Crash fixed: BufferList deletes user allocated Buffer objects
o Crash with multi-thread application fixed
o Device::Close closes the corresponding data stream object
2.2 Examples
Enhancements
o Supports creating project files for Visual Studio 2013 (see new cmake installer)
o Example 005_PixelTransformation extended: now it shows the using of several demosaicing
methods (see image processor feature ‘DemosaicingMethod’).
2.3 Doc
InstallationGuide_Linux.pdf
o Document folder corrected (see chapter 4.2.3)
ProgrammersGuide.pdf
o Hint to C# documentation file bgapi2_genicam_dotnet.xml added (see chapter 4.4.3.1)
o Description added: How to use user allocated buffer (see chapter 5.1.10)
2.4 Tools
IPConfigTool
o Enhancements
Speed up setting persistent IP in multi camera systems
CameraExplorer
o Bugfixes
RGB value in status bar was not refreshed in live view
Correct displaying GigE interfaces when using Asian OS languages
Correct refreshing the received buffer counter in the info view.
Shortcuts doesn’t work after switching to full screen mode and back
3.1 BGAPI
Information
o All Linux distributions were up to date at the time of creation SP4.
o Linux distribution Debian version 8.0 added
o Linux distribution Fedora 21 added
3.1.1 Consumer
Enhancements
o Stacked write now available in C# interface.
o Stacked mode allows writing the same feature more than once.
o All SFNC 1.5 feature names available in bgapi2_featurenames.h.
Bugfixes
o GetImagePresent returns false instead of an exception, if image chunk is not present.
o GetFilledBuffer lost images under certain error situation (faulty chunk format caused by
transmission).
o CreateInstanceFromPath function works now under Linux.
3.2 Examples
No functional changes
3.3 Doc
No Changes
3.4 Tools
IPConfigTool
o Enhancements
IPConfigTool now available for Linux (without Force IP).
o Bugfixes
Invalid input of IP address leads to inadvertent programming.
CameraExplorer
o Bugfixes
4.1 BGAPI
Information
o Linux distribution Debian version 7.6 changed to Debian version 7.7
o Linux distribution Ubuntu 13.04 removed
4.1.1 Consumer
No changes
4.2 Examples
No changes
4.3 Doc
No Changes
4.4 Tools
CameraExplorer
o Improved GUI performance with LXG camera series in Dual Link
5.1 BGAPI
Information
o Linux distribution Debian version 7.5 changed to Debian version 7.6
5.1.1 Consumer
Enhancements
o Stability improved
o Device open error solved, if an interface object was opened before
5.2 Examples
Support for LXG cameras added
5.3 Doc
ProgrammersGuide_BaumerFeatures.pdf
o Added description for the new features DeviceStreamChannelPacketSize,
AllowDeviceSwitchOver,
o Description for feature HeartbeatThreadDisable adjusted
o Description for DevicePresent adjusted
bexplorer_help.pdf
o Info view description changed
5.4 Tools
CameraExplorer
o Correct displaying IP addresses and MAC addresses in the feature tree
o Info view representation changed
o Crash when close the CameraExplorer fixed
IPConfigTool
o Added support for LXG camera series
6.1 BGAPI
6.1.1 Consumer
No changes.
6.2 Examples
No changes.
6.3 Doc
ProgrammersGuide_BaumerFeatures
added 2.1.1 Category: ActionControl
6.4 Tools
CE improve presentation of info view
7.1.1 Consumer
Information
o The function DataStream::GetBufferByIndex is deprecated and will be deleted in the next
version. Please use instead the BufferList class.
Enhancements
o Event handler added.
This offers another way to retrieve images, device events and PnP events via call back
functions in C++ and delegates in C# for easy implementation.
FrameIDMax
FrameIDMin
Enhancements
o GenTL conformity to V1.3
7.2 Examples
Information
o The SDK Examples are divided into common and interface specific examples.
Enhancements
o new examples PnPEventMode_Polling, ImageCaptureMode_Handler,
DeviceEventMode_Handler and PnPEventMode_Handler
o example ImagePolling_TriggerModeOff renamed to ImageCaptureMpde_Polling
o example GEV_HeartbeatTimeout renamed to HeartBeatTimeout
o example GEV_ForceIP renamed to ForceIP
7.3 Doc
Information
o Added some new documents to facilitate the use of Baumer GAPI:
Enhancements
o New chapter: recommended working materials added.
o New diagram added, which displays the communication model used by Baumer GAPI.
o New chapters added to point 5. Application development with Baumer GAPI:
o Representation of code snippets for C++ and C# improved. The code snippets for C++ and
C# are under each other and are highlighted (C++ snippets yellow, C# snippets green)
o Color coding of main classes improved.
7.4 Tools
7.4.1 CameraExplorer
Enhancements
o Simplified handling of Basic View
o Auto Exposure available in Basic View
8.1 BGAPI
8.1.1 Consumer
No changes.
8.2 Examples
No changes.
8.3 Doc
No changes.
8.4 Tools
No changes.
9.1 BGAPI
Enhancements
o Supports versions the following linux distributions: Debian 7.1, Ubuntu 12.04, Ubuntu 12.10,
Ubuntu 13.04 and Ubuntu 13.10
o Stability improved.
Buffer::GetParent
DataStream::GetParent
Device::GetParent
Interface::GetParent
System::IsOpen
Interface::IsOpen
DataStream::IsOpen
o DeviceEvent, Image and ImageProcessor inherits from node interface. The classes DeviceEvent,
Image and ImageProcessor inherits from the node interface (class INode). For the class
DeviceEvent it is possible to access device event features specified in the GenICam XML file of
the device. For the Image and ImageProcessor classes it is possible to extend the functionality
without changing the class definition.
o Node interface extended. The class NodeMap provides now the iterator access like the list
classes and two new find functions for fast node searching. The following new functions were
declared:
The class Node defines a new function to get an increment of floating values:
Node::GetDoubleInc
o Device class extended. The Device class provides the new function GetSerialNumber to get the
serial number of the device. This function can also be used for identifying the device without
opening.
o Image class extended. New histogram function added to specify a ROI.
o Some functions renamed.
9.2 Examples
No changes.
9.3 Doc
No changes.
9.4 Tools
No changes.