- Remove hardcoded exposure (0.85/1.24ms) and gain (0/52) limits
- Add automatic querying of camera capabilities on startup
- Query current exposure/gain settings from camera on reset
- Add update-interval property for rate limiting (default 100ms)
- Prevent algorithm from running at full framerate (750fps)
- Expand property ranges to support any camera capabilities
- Algorithm now fully automated and adapts to camera limits
Fixed GLib-GObject-CRITICAL errors caused by incorrect enum type
registration in the intervalometer plugin.
The issue was on line 189 where g_param_spec_enum() was being called
with GST_TYPE_INTERVALOMETER (the class type) instead of a proper
enum GType for the ramp-rate property.
Changes:
- Added gst_intervalometer_ramp_rate_get_type() function to properly
register the GstIntervalometerRampRate enum as a GType
- Defined GST_TYPE_INTERVALOMETER_RAMP_RATE macro
- Updated PROP_RAMP_RATE property installation to use the correct
enum type
This fixes the following errors that appeared during pipeline launch:
- g_param_spec_enum: assertion 'G_TYPE_IS_ENUM (enum_type)' failed
- validate_pspec_to_install: assertion 'G_IS_PARAM_SPEC (pspec)' failed
- g_param_spec_ref_sink: assertion 'G_IS_PARAM_SPEC (pspec)' failed
- g_param_spec_unref: assertion 'G_IS_PARAM_SPEC (pspec)' failed
Implements YASS-inspired automatic exposure control for IDS uEye cameras.
The intervalometer filter analyzes video brightness in real-time and
smoothly ramps camera exposure and gain settings during changing light
conditions - ideal for sunset/sunrise time-lapse photography.
Key features:
- Automatic exposure ramping (0.85-1.24ms configurable range)
- Automatic gain control (0-52 configurable range)
- Real-time brightness analysis (GRAY8, GRAY16, RGB, BGR, BGRA)
- YASS-inspired ramping algorithm (exposure priority, then gain)
- Configurable ramp rates (VSlow/Slow/Medium/Fast/VFast)
- Exposure compensation (±4 stops)
- CSV logging of exposure parameters
- Direct GObject property control (no message bus overhead)
Technical implementation:
- GstBaseTransform filter for in-place processing
- Discovers upstream camera element by name
- Controls camera via g_object_set() for synchronous updates
- Frame-by-frame brightness calculation with format support
Files added:
- gst/intervalometer/gstintervalometer.c: Main implementation (734 lines)
- gst/intervalometer/gstintervalometer.h: Header with structure definitions
- gst/intervalometer/CMakeLists.txt: Build configuration
- gst/intervalometer/README.md: Comprehensive documentation
Files modified:
- gst/CMakeLists.txt: Added intervalometer subdirectory
- build.ps1: Added intervalometer to build and deployment pipeline
Usage example:
gst-launch-1.0 idsueyesrc name=cam ! \\
intervalometer enabled=true camera-element=cam \\
exposure-min=0.85 exposure-max=1.24 \\
gain-min=0 gain-max=52 ramp-rate=medium ! \\
autovideosink
Inspired by YASS (Yet Another Sunset Script) for CHDK cameras by
waterwingz, based on work by Fbonomi and soulf2.
- Deleted all subdirectories from sys/ except idsueye/
- Updated sys/CMakeLists.txt to only include idsueye subdirectory
- Updated main CMakeLists.txt to only search for IDSuEye package
- Removed find_package() calls for: Bitflow, NIIMAQ, NIIMAQdx, FreeImage,
OpenCV, Aptina, EDT, Euresys, GigESim, Imperx, ImperxSDI, IOtechDaqX,
KAYA, Matrox, Phoenix, Pleora, Pylon, QCam, Sapera, and XCLIB
The project now exclusively supports IDS uEye cameras in the sys folder.
This commit introduces third-party work by waterwingz, based on scripts
by Fbonomi and soulf2. YASS is an advanced intervalometer script for
CHDK-enabled Canon cameras that automatically adjusts exposure settings
during sunset, sunrise, or other changing light conditions.
Key features:
- Automatic exposure ramping (shutter speed and ISO)
- Intelligent ND filter control
- Focus lock options (AFL/MF at infinity)
- Configurable shot intervals and exposure compensation
- CSV logging of exposure parameters
- Battery-saving display blanking options
Original work released under GPL license.
Requires CHDK 1.2.0 build 3276 or higher (1.3.0+ recommended).
Files added:
- yass/yass4.lua: Main script (v4.8)
- yass/README.md: Documentation and usage guide
Previously, GET_FRAMERATE and GET_EXPOSURE returned only cached values.
Now they query the actual hardware state using:
- is_SetFrameRate() with IS_GET_FRAMERATE for framerate
- is_Exposure() with IS_EXPOSURE_CMD_GET_EXPOSURE for exposure
This matches the pattern used for auto-exposure, auto-gain, and gain-boost
properties, ensuring UDP control commands return real-time hardware values
instead of stale cached values. Critical when auto-exposure is enabled as
the hardware adjusts exposure dynamically.
- Lower minimum exposure from 1.0ms to 0.015ms in launch-ids.py validation
- Add exposure range validation (0.015-30000ms) to camera_control.py
- Update help text to display exposure range for better user guidance
- Adjust camera config: swap binning/subsampling values in nightcolor preset
- Add comment explaining subsampling vs binning behavior
Enhances exposure control granularity and provides clearer validation
feedback while optimizing camera configuration for low-light scenarios.
- Update camera_control.py to support 'property value' syntax
* camera_control.py gain → gets current gain value
* camera_control.py gain 33 → sets gain to 33
* Add --host, --port, and --timeout parameters
* Remove argcomplete dependency to simplify requirements
* Maintain backward compatibility with existing commands
- Update launch-ids.py to support simplified property setting at startup
* launch-ids.py exposure 16 → launches with 16ms exposure
* launch-ids.py framerate 30 → launches with 30fps framerate
* launch-ids.py gain 50 → launches with gain set to 50
* Preserve traditional flag syntax for full backward compatibility
Both scripts now provide intuitive property-based syntax while
maintaining all existing functionality and command-line options.
- Update camera_control.py to support 'property value' syntax
* camera_control.py gain → gets current gain value
* camera_control.py gain 33 → sets gain to 33
* Add --host, --port, and --timeout parameters
* Maintain backward compatibility with existing commands
- Update launch-ids.py to support simplified property setting at startup
* launch-ids.py exposure 16 → launches with 16ms exposure
* launch-ids.py framerate 30 → launches with 30fps framerate
* launch-ids.py gain 50 → launches with gain set to 50
* Preserve traditional flag syntax for full backward compatibility
Both scripts now provide intuitive property-based syntax while
maintaining all existing functionality and command-line options.
- PROP_AUTO_EXPOSURE now queries hardware using IS_GET_ENABLE_AUTO_SHUTTER
- PROP_AUTO_GAIN now queries hardware using IS_GET_ENABLE_AUTO_GAIN
- PROP_GAIN_BOOST now queries hardware using IS_GET_GAINBOOST
This ensures each camera reports its actual hardware state rather than
a shared cached value when properties are queried via camera_control.py
- Add gain-boost property to gstidsueyesrc (boolean)
- Implement is_SetGainBoost() API call in property setter and framerate/exposure function
- Add UDP control commands SET_GAIN_BOOST and GET_GAIN_BOOST
- Add --gain-boost command-line flag to launch-ids.py
- Update camera_control.py with get-gain-boost and set-gain-boost commands
- Change parameter defaults to None (exposure, framerate, gain) to respect INI file defaults
- Only set properties when explicitly provided by user - INI file is source of truth
- Query camera's actual exposure range before setting exposure time
- Validate and clamp exposure values to supported min/max limits
- Log detailed information about range, requested vs actual values
- Add GET_EXPOSURE_RANGE command to UDP control interface
- Update Python control scripts with exposure range query support
This prevents IS_INVALID_EXPOSURE_TIME errors and ensures values are
always within the camera's capabilities. The exposure range varies by
framerate and sensor configuration.
- Added 'gain' property to gstidsueyesrc element (0-100, 0=auto)
- Implemented hardware gain control using is_SetHardwareGain() API
- Added --gain/-g command-line argument to launch-ids.py
- Added SET_GAIN and GET_GAIN UDP control commands
- Updated STATUS command to include gain value
- Added get-gain and set-gain commands to camera_control.py test client
- Gain can be set at startup or adjusted dynamically during runtime
- Replaced garbled is_GetError() output with human-readable error messages
- Added error code mapping for 25+ common IDS errors from uEye.h
- Enhanced camera initialization with detailed logging and context
- Error messages now include error code, name, description, and troubleshooting hints
- Added information about device/camera ID attempted and available camera count
- Example: Error 3 now shows 'IS_CANT_OPEN_DEVICE (3): Cannot open device - check if camera is connected and not in use. Camera/Device ID used: 99, Available cameras: 2'
Fixes issue where camera initialization failures showed cryptic characters instead of useful error information.
- Added --display option for 1/4 sized preview window using autovideosink
- Added --camera-id and --device-id options for camera selection
- Added UDP control commands: SET_CAMERA_ID, GET_CAMERA_ID, SET_DEVICE_ID, GET_DEVICE_ID
- Updated GStreamer idsueyesrc element to support device-id property
- device-id uses IS_USE_DEVICE_ID flag for system enumeration
- camera-id continues to use user-definable ID (0 for first found)
- Updated STATUS command to include camera_id and device_id
- Add full-featured launch-ids.py with command-line argument parsing
- Implement UDP control server for dynamic exposure/framerate adjustment
- Support configurable video streaming (UDP) with optional display preview
- Add exposure control in milliseconds (1.0-1000.0ms, default 10ms)
- Add framerate control (1-20200 Hz, default 750Hz)
- Include video cropping, queue configuration, and verbose/quiet modes
- Integrate argcomplete for tab completion support
- Add comprehensive error handling and validation
- Support custom camera configuration files
- Enable tee-based pipeline for simultaneous UDP streaming and display
Provides complete camera control interface with both CLI configuration
and runtime UDP control for exposure/framerate adjustments.
- Add argparse for individual get/set operations
- Support commands: get-exposure, set-exposure, get-framerate, set-framerate, status
- Add 'test' command to run full test suite (preserves original functionality)
- Show help when no parameters provided
- Add optional tab completion support with argcomplete
- Maintain backward compatibility with existing test functionality
Usage examples:
python scripts/test_exposure_control.py # Show help
python scripts/test_exposure_control.py test # Run full test suite
python scripts/test_exposure_control.py get-exposure # Get current exposure
python scripts/test_exposure_control.py set-exposure 10 # Set exposure to 10ms
python scripts/test_exposure_control.py status # Get pipeline status
```
fix(launch-ids): fix videocrop element error and enhance startup output
- Fix GstAddError caused by duplicate pipeline.add(videocrop) call
The videocrop element was being added to the pipeline twice: once
explicitly when crop was enabled, and again in the element linking loop.
Removed the duplicate add operation.
- Enhance startup configuration display
Display all configured parameters at startup in a formatted summary:
* Camera config file path
* Exposure time (ms)
* Framerate (Hz)
* Crop settings (pixels or disabled)
* Queue buffer size (if configured)
* Video stream destination (UDP host:port)
* Control server port (or disabled status)
* Complete pipeline description
The output is now formatted with separators and aligned labels for
better readability, making it easier to verify settings at startup.
```
- Update idsueyesrc exposure property to use milliseconds (per gst-inspect)
- Fix default exposure value from 0.016 to 10ms
- Update validation range to 1.0-1000.0ms in control server
- Correct all documentation and examples in UDP_CONTROL_PROTOCOL.md
- Update test_exposure_control.py to use millisecond values
Resolves unit mismatch between documented seconds and actual milliseconds
expected by the idsueyesrc GStreamer element.
- Added documentation for launch-ids.py (Python-based camera control)
- Added documentation for test_exposure_control.py (UDP control testing)
- Added documentation for visualize_line_realtime.py (real-time visualization)
- Merged UDP_CONTROL_PROTOCOL.md content into network_guide.md
- Includes architecture diagrams, command reference, client examples
- Complete end-to-end guide for camera control and monitoring
- Added UDP_CONTROL_PROTOCOL.md documenting the UDP control interface
- Added launch-ids.py for IDS camera control
- Added test_exposure_control.py for testing exposure settings
- Added udp_backup.reg for UDP configuration backup
- Added visualize_line_realtime.py for real-time visualization
- Updated .gitignore and ROLLINGSUM_GUIDE.md
- Removed ini/200fps-2456x4pix-cw.ini configuration file
- Add --record-fps parameter for independent recording frame rate control
- Separate display and recording buffers (display_buffer_obj, record_buffer_obj)
- Enable recording without display and vice versa
- Independent throttling for display and recording operations
- Improve code organization and cleanup handling
- Modified recv_raw_rolling.py to handle 2456x1 BGR line format
- Fixed display dimensions (2456 tall x 800 wide)
- Updated 200fps-2456x4pix-cw.ini to start at Y=500
- Added detailed single line transmission docs to network_guide.md
- Updated README.md with quick start example using videocrop
- Re-validate AOI configuration before starting video capture
- Fixes 'Invalid buffer size' error when using Start Y > 0
- Query current AOI and re-set it to force SDK internal state update
- Tested with Start Y=0 and Start Y=500 - both work correctly
- Replace cv2.rotate() with NumPy array indexing for 2x+ speedup
- Add --display-fps argument to throttle display refresh while capturing all UDP frames
- Add --save-mjpeg argument to record rolling display to MJPEG video
- Fix display throttling to capture all frames while only refreshing display at specified rate
- Performance: ~300 FPS no-display, ~100 FPS full display, 150-250+ FPS with throttling
- Replace cv2.rotate() with NumPy array indexing for 2x+ speedup
- Add --display-fps argument to throttle display refresh while capturing all UDP frames
- Add --save-mjpeg argument to record rolling display to MJPEG video
- Fix display throttling to capture all frames while only refreshing display at specified rate
- Performance: ~300 FPS no-display, ~100 FPS full display, 150-250+ FPS with throttling
