GenTL Software Package Release Notes¶

This page covers release notes for the GenTL Viewer and GenTL provider libraries.

Install Package 2.9.1 (2023-12-20)¶

GenTL provider changes¶

• Fixed bug in GenTL DLL related to GigE Protocol Port Access in multi-threaded environment.

GenTL Viewer Application changes¶

• None

Install Package 2.9.0 (2023-10-06)¶

GenTL provider changes¶

• Add simulation support for 10 Bit Monochrome pixel data
• Added support for fetching GigE Timestamps and scaling based on GIGE Frequency tick counter

GenTL Viewer Application changes¶

• Updated logic for computing framerate when using GigE with valid timestamps.
• Added support for cameras presenting multiple ROIS per GenICam SFNC configuration.
• Added support for Mono10p pixel format
• Added additional commands for scripting engine
• Added ROI presets feature
• Misc GUI related bug fixes.

Install Package 2.8.0 (2023-07-11)¶

GenTL provider changes¶

• Fix libusb transfers closing and cleanup. Improves application shutdown and removes a crash that occurred over 10% of the time.

GenTL Viewer Application changes¶

• None

Install Package 2.7.3 (2022-11-18)¶

GenTL provider changes¶

• None

GenTL Viewer Application changes¶

• Added SSL dll files to fix "Check for updates" help menu item being disabled.

Install Package 2.7.2 (2022-11-14)¶

GenTL provider changes¶

• Add support for BUFFER_INFO_CONTAINS_CHUNKDATA: Return false to indicate we aren't sending chunk data

GenTL Viewer Application changes¶

• None

Install Package 2.7.1 (2022-11-13)¶

GenTL provider changes¶

• Corrected XML in GenTL.dll local (vs. device) representation
• supports python/harvesters as of build date

GenTL Viewer Application changes¶

• Present GenICam Enumerations in same order as defined in reference XML
• Added compile time option to enable/disable updater
• Misc cleanup of tab control on video widget.

Install Package 2.7.0 (2022-07-19)¶

GenTL provider changes¶

• Add support for BUFFER_INFO_TLTYPE
• tcBuffer::GetInfo: Handle case where consumer passes null pBuffer to get size of buffer to allocate
• GIGE: Append camera IP Address to DEVICE_INFO_DISPLAYNAME
• GIGE: Release CCP register in port destructor
• GIGE: Set recv buffer size to 256k for stream socket
• GIGE: Don't exit heartbeat thread on error
• U3V: No longer delete list of devices when interface is closed so we can better set &changed when device list is fetched
• U3V: Add reference counting to open/close interface calls so USB interface isn't closed until all open calls have been closed

GenTL Viewer Application changes¶

• Fix mono dng images so they pass dng_validate
• settings: Fix GenTL tab getting marked dirty on load
• open dialog: Properly refresh device list when cameras are removed
• open dialog: Fix invalid ID error for U3V cameras
• open dialog: Show DEVICE_INFO_DISPLAYNAME as tooltip if available
• mainwindow: Show DEVICE_INFO_DISPLAYNAME in title if available
• about: Show which GenTL DLL/CTI path

Install Package 2.6.7 (2022-06-01)¶

Known issue: Breaks U3V connections, installer has been removed until its fixed

GenTL provider changes¶

• Make Buffer Queues Thread Safe
• Improve device polling
• Support Retrieving Interface Displayname and Type
• GIGE: Add code block to disable polling on network interfaces not supporting GigE
• GIGE: Keep discovery socket resources and Device List after Close()

GenTL Viewer Application changes¶

• mainwindow: Add indicator for camera errors
• aqcWorker: Allow line arrays buffer height to be greater than sensor size
• Cap sx/sy scaling factor at 8 (somewhat arbitrary) to prevent scaling line images to ridiculous sizes
• Add more descriptive error message when XML cannot be parsed
• Add support for QImage::Format_RGB32
• GenTL Settings Dialog: Add Interface Enables / Timeouts Config
• Rework scanning logic for refreshing available interface / devices.
• Increase the poll rate a bit.

Install Package 2.6.6 (2022-05-12)¶

GenTL provider changes¶

• GigE: Back off the number of working buffers in the GEV Datastream logic

GenTL Viewer Application changes¶

• Installer: Opens firewall for GigE cameras

Install Package 2.6.5 (2022-04-27)¶

GenTL provider changes¶

• GigE: Implement the GCGetPortInfo for the GEV interface port object.

GenTL Viewer Application changes¶

• None

Install Package 2.6.4 (2022-04-20)¶

GenTL provider changes¶

• GigE: Update GigE Data Stream protocol to correct bug in packet resend request logic.
• GigE: Corrected bug in decoding of 16 bit vs 64 bit block IDs.
• GigE: Add packet size discover capability (attempts 9000, 4500, 4000, 3800, 1500, 1400, and 1024 packet sizes).
• GigE: General Datastream throughput improvements
• GigE: Dump packets received that aren't from the connected camera IP address.

GenTL Viewer Application changes¶

• Honor the GenTL Producer Datastream STREAM_INFO_BUF_ANNOUNCE_MIN parameter, if provided.

Install Package 2.6.3 (2022-04-07)¶

GenTL provider changes¶

• None

GenTL Viewer Application changes¶

• Fix issue with Bayer packed formats where they all were being debayered as RG

Install Package 2.6.2 (2022-03-25)¶

GenTL provider changes¶

• Fix Bug in GigE discovery logic that might cause an application crash.

GenTL Viewer Application changes¶

• None

Install Package 2.6.1 (2022-03-21)¶

GenTL provider changes¶

• None

GenTL Viewer Application changes¶

• Fix xml cache dir on first install (Fixes View XML button greyed out)

Install Package 2.6.0 (2022-03-21)¶

GenTL provider changes¶

• Add support for GigE ethernet cameras
  • When looking for cameras, the local network will be scanned with broadcast packets
• Honor polling timeout for discovering cameras
• Support Calling IFOpenDevice immediately after calling TLOpenInterface
• Fixup broken iteration in UpdateDeviceList
• U3V: Limit readback request sizes to honor Max Ack Transfer Length
• U3V: Limit command write sizes to honor Max Cmd Transfer Length
• U3V: Ensure we limit usb transfer size to within the max Windows usb transfer size
• U3V: Fix txbuf buffer size allocation
• U3V: Bug: Increment address when breaking write into multiple usb transfers

GenTL Viewer Application changes¶

• DeviceDialog: Only search for cameras when Open Device Dialog is visible
• Try fetching GenICAM payload value if GenTL cannot provide it
• DeviceDialog: Improve GUI lag when Open Device Dialog is visible
• DeviceDialog: Disallow selecting interfaces "categories" in the device dialog

Install Package 2.5.1 (2022-02-17)¶

GenTL provider changes¶

• None

GenTL Viewer Application changes¶

• recorder: Fix issue where "Save one frame" was defaulting to Program Files directory
• recorder: Fix issue where "Save one frame" was updating the file prefix for the regular recorder
• Ensure GenICam based widgets are initialized in the correct order

Install Package 2.5.0 (2022-01-17)¶

GenTL provider changes¶

• None

GenTL Viewer Application changes¶

• plotter: Implement StdDev By Row/Column
• plotter: Remove row/column control for Mean and StdDev ImageStats
• plotter: Update plot stats when enabled or source is changed
• plotter: Use full name for plot types that don't have an index
• plotter: Trigger plot refresh when new temp data is added

Install Package 2.4.5 (2021-12-08)¶

GenTL provider changes¶

• simcamera: Improved fps accuracy. Uses Windows timeBeginPeriod to set scheduler time to 1ms while simcamera is acquiring
• simcamera: Allow changing fps during acquisition
• simcamera: Increase frame gen performance

GenTL Viewer Application changes¶

• BAE: Add Core module support
• BAE: Improve performance for ISelector nodes
• Handle some GenApi exceptions causing GUI crash

Install Package 2.4.4 (2021-09-29)¶

GenTL provider changes¶

• u3v: Populate BUFFER_INFO_SIZE_FILLED for each buffer so we can determine how many bytes were actually written to the buffer
• Add Bayer 10/14/16 pixel formats

GenTL Viewer Application changes¶

• BAE: Update ROI presets to 1440x1100
• Add Bayer 10/14/16 pixel formats

Install Package 2.4.2 (2021-08-09)¶

GenTL provider changes¶

• None

GenTL Viewer Application changes¶

• BAE: Add recommended ROI presets

Install Package 2.4.0 (2021-08-04)¶

GenTL provider changes¶

• Various debug print statement changes
• Changes to support new cameras
• simcamera: Improve debug log ring buffer

GenTL Viewer Application changes¶

• Add Dark theme, auto-enabled if Windows 10 "AppsUseLightTheme = 0" is set
• Dark mode setting added to explicitly set light/dark theme
• recorder: Add record mode options to the recorder. Allows syncing record start/stop with camera acquisition
• recorder: Minimize recorder controls when the camera is closed
• recorder: Add frame and pixelformat info to saved filenames. A new setting was added to disable this feature. Defaults to add extra info.
• recorder: Allow saving raw camera data to raw file formats. A new setting to control if raw data or image data (as shown in UI) is saved. Defaults to using raw camera data, Breaking Change

Install Package 2.3.0 (2021-06-21)¶

GenTL provider changes¶

• simcamera: Add support for mono14/12/10 pixel formats
• simcamera: Reduce code duplication in noise text pattern

GenTL Viewer Application changes¶

• camera settings: Ensure IIntegers, IFloats, IEnumerations are read-only when GenICam says so
• Add support for pixel formats mono14/12/10
• Prevent 0ms frame timeouts to avoid 100% cpu usage when at high framerate
• AqcWorker: Check for DSStartAcquisition errors and stop frame acq on errors
• recorder: Set recorder controls to always on top
• mainwindow: Check plugin for toolbarActions
• mainwindow: Show controls if they are minimized
• recorder: Add record button to toolbar
• recorder: Set recorder controls to always on top (window can still be minimized or closed)

Install Package 2.2.0 (2021-05-04)¶

GenTL provider changes¶

• None

GenTL Viewer Application changes¶

• command console: Add minimize/maximize to console window
• video widget: Fix off by one error with pixel value picker
• ROI: ROI rect selector stops acquisition before changing ROI
• recorder: User can limit the number of frames recorded
• recorder: Captured frames will start the count at 1 and no longer use frame id
• recorder: Captured frames will by default be put in a timestamped subdirectory (configurable in settings)
• recorder: FLF image format added
• recorder: Populate recorder control file formats
• recorder: Remove frame number from camera_regs.ini
• recorder: Stop acquiring before dumping registers
• recorder: Setup recorder control so it auto sizes itself when shown
• geni command: Add additional register save, progress checkpoints
• geni command: Make progress window modal to block user input
• geni command: Allow canceling register save
• Camera Settings: Support enumerating ISelector nodes in tree (can be disabled in settings)
• mainwindow: Ensure GenICam menu options are disabled when no camera is loaded
• mainwindows: Clear fps when camera is closed
• mainwidget: Show videowidget cursor info in status bar

Install Package 2.1.1 (2021-03-03)¶

GenTL provider changes¶

• None

GenTL Viewer Application changes¶

• BAE: Rework look
• BAE: Update Gaussian controls
• BAE: Add controls for sensor binning and CFPN
• Add REGWAIT command
• mainwindow: Show error if XML load from camera fails

Install Package 2.1.0 (2021-02-22)¶

GenTL provider changes¶

• Sim Camera updates

GenTL Viewer Application changes¶

• Add spinner when opening/closing camera
• settings: Autodetecting gentl and plugins paths
• Introduce Sensor Register Editing Tool
• Introduce bae plugin
• Introduce Simple scaling control, like MityViewer, to globally enhance contrast
• Push camera debug buffer onto the standard Log window periodically
• Add option to recorder to save cam registers when recording stops
• settings: On start, load default_gentle.ini if settings are empty
• plotter: Add min/max to tools tab
• plotter: Support plotting average across rows or average across columns
• Add Save/Load Camera Registers action to GenICam menu
• Show <Representation> = HexNumber as base 16
• mainwindow: Ensure window title is consistently set
• mainwindow: Fix case where camera doesn't load but we open video window anyways

Install Package 2.0.0 (2020-10-27)¶

GenTL provider changes¶

• Update to GenICam API 3.2.0

GenTL Viewer Application changes¶

• Include sim_camera.xml in install directory
• Update to build using VS2019
• Update to opencv 4.5.0
• Update libusb
• Update to GenICam API 3.2.0
• Add IR plugin support for Canon 35MMFHDXS

Install Package 1.8.1 (2020-07-29)¶

GenTL provider changes¶

• None

GenTL Viewer Application changes¶

• Introduce basic plugin for sequenced snapshots
• Add option to restart the application when plugins are changed
• Add option to restart the application from menu
• Fix videosettings ComboBox not updating properly
• Add 35MMFHDXS to compatible model list for IR plugin

Install Package 1.7.0 (2020-05-29)¶

GenTL provider changes¶

• None

GenTL Viewer Application changes¶

• Clamp IFloat to fix issue with double spinboxes min/max rounding
• CMV50K/CSG14K: Add support for CSG14K in plugin. Add sensor details...
• videosettings: Setup ROI presets using CSG14K and CMV50k sensor details
• camerainterface: Clear TLParamsLocked and mpCurrentFrame after aquiring event becomes false
• camerainterface: Ensure we set TLParamsLocked after various error cases, and...
• videosettings: Update play/pause and camera aquiring handling
• Cleanup various unused methods and variables
• Introduce simple voltage/temperature tabular display widget
• Properly configured Datastream capture for MultiFrame and Single frame data.

Install Package 1.6.0 (2020-04-07)¶

GenTL provider changes¶

• None

GenTL Viewer Application changes¶

• Add control to sync HDMI Gamma and White Balance terms for cameras supporting HDMI outputs.
• Misc bug-fixes in ROI handling.
• Added support for internal test fixture framework.

Install Package 1.5.0 (2020-02-25)¶

GenTL provider changes¶

• None

GenTL Viewer Application changes¶

• Fixed default recording dir settings
• Change exposure time to microseconds to match GenTL register.
• recorder: Handle saving images using multiple threads. Allows multiple images to be compressed/encoded simultaneously. Improves framerate when recorder is active.
• Speedup 12bit to 16bit unpack algorithm
• Don't subtract IR if any of the pixels are saturated. Fixes scenes with overexposed spots with an IR camera.

Known issues¶

• Application crashes if camera physically disconnected while application is using it.
• ROI rectangle selection is incorrect if an ROI is already set

Installer Package 1.4.1 (2020-01-28)¶

GenTL provider changes¶

• None

GenTL Viewer Application change¶

• Fix reported version

Known issues¶

• Application crashes if camera physically disconnected while application is using it.
• ROI rectangle selection is incorrect if an ROI is already set

Installer Package 1.4.0 (2020-01-27)¶

GenTL provider changes¶

• Add grid test pattern to simulated camera

GenTL Viewer Application change¶

• Add menu entries for user manual and release notes.
• Update application icon
• Add additional display filter to support Mirroring in X/Y on PC side.
• Add (optional) Zoom Navigation overlay to Display View.
• Scroll zoom updates
  • Don't support zooming out beyond "full image"
  • Allow zooming down to 0.01 size to support larger sensors
  • Save / restore click-and-drag zoom operation button when not scroll zooming
• Fix access error when saving plot data with unequal length plot vectors.
• Save State of Zoom Navigation, Pixel Interpolation Mode, and 1:1 checkbox.
• Fix up panning logic and properly display pixel coordinates when zoomed.
• Add ROI image rectangle selection to video settings plugin, so you can drag a rectangle to set ROI
• Add ROI preset combo box
• Disable ROI buttons when camera is acquiring

Known issues¶

• Application crashes if camera physically disconnected while application is using it.
• ROI rectangle selection is incorrect if an ROI is already set

Installer Package 1.3.0 (2019-12-04)¶

GenTL provider changes¶

• Internal updates

GenTL Viewer Application change¶

• Fix memory leak
• Reset zoom when image size changes
• Updates to installer to provide smoother update installation
• Update to IR plugin to subtract IR value from RGB pixels

Known issues¶

• Application crashes if camera physically disconnected while application is using it.

Installer Package 1.2.0 (2019-10-14)¶

GenTL provider changes¶

• Simulated camera updates for testing

GenTL Viewer Application change¶

• Improve error handling in XML parser
• Corrected PNG data format for high bit depth images.
• Add support for monochrome images to DNG export.
• Add support for Canon IR pixel format
• Add White Balance control to UI
• Minor user interface fixes

Known issues¶

• Application crashes if camera physically disconnected while application is using it.

Installer Package 1.1.2 (2019-08-05)¶

GenTL provider changes¶

• Advanced libusb to include changes from 1.0.22 release. Needed to support very large image transfer.

GenTL Viewer Application change¶

• Updated histogram to support plotting 2^N bins for a given color bit-depth
• Updated histogram to center pins properly when plotting
• Fixed misc issues around exception handling for exceptions thrown by GenICAM

Installer Package 1.1.1 (2019-01-11)¶

GenTL provider changes¶

• Fix misc bugs encountered with data streaming.
• Add XML / Port accessors for interface and system modules in the GenTL layer.
• Simulated camera support added with bug fixes.

GenTL Viewer Application change¶

• Handle proper model numbering for plugin matching with CMV and CSG based cameras.

Installer Package 1.1.0 (2018-11-12)¶

GenTL provider changes¶

• Several fixes made to support utilizing python harvester bindings.
• Fixed Error in Revoke Buffer method when buffer was allocated by external application (vs. with the Library).
• Return GC_ERR_NOT_IMPLEMENTED for GetPortURL related methods for non-Port Handles vs. unexpected behavior.
• Fixed some system handle GetInfo() routines returning strings to include null termination character in returned string and size calculation.

GenTL Viewer Application change¶

• Added support for digital raw negative file format for saving images.

Installer Package 1.0.0¶

Installer Package 0.9.0¶

Installer Package 0.8.0¶