Opentrack Versions Save

Notes

Workaround Windows Defender false positive by compiling the release with Visual Studio 2022 (#1371).

Features

Add another slider to the PT point filter. Setting it to a low value prevents sawtooth-like motion. The point filter greatly reduces the need for using Accela or any other generic filter.

The point filter hasn't yet been implemented for the Aruco tracker. If you're using the Aruco tracker and want it done, send a note.

Bug reports & discussion

Discuss the release in its discussion thread (https://github.com/opentrack/opentrack/discussions/1381). Send bug reports to the bug tracker (https://github.com/opentrack/opentrack/issues).

Features

• tracker/neuralnet: add a face tracker, by @DaWelter.
• new centering modes that fix the long-standing problem with yaw affecting pitch and vice versa. By @GO63-samara.
• tracker/pt: add MJPEG support
• proto/freetrack: add an easier method for dealing with Elite Dangerous library location problem, in the freetrack output settings.
• proto/freetrack: add back in the option for ephemeral freetrackclient/npclient library location
• [hotfix 3] tracker/pt: add point filter feature. this is arguably more effective than filtering after pose estimation via opentrack's regular filters. similar filter should be added to Aruco.

Fixes

• fix the Zero keybinding when using a custom center offset
• video/ps3eye: hopefully fix LED staying alight with the open driver
• [hotfix 1]: fix crash with the new PS3 Eye driver used with trackers other than PT
• [hotfix 2]: fix freetrack output not working for some users
• [hotfix 2]: tracker/pt: use color output from the open PS3 Eye driver when in color key mode
• [hotfix 3]: fix freezes on saving settings in the PT tracker while it's running
• [hotfix 3]: fix for non-zero values when deadzones are used in the mapping dialog
• [hotfix 3]: video/ps3eye: fix freeze with the open driver
• [hotfix 3]: tracker/pt: fix broken formula for point radius. you have to adjust your threshold sliders and min/max point sizes.

---

PS3 Eye open driver

opentrack now has a standalone driver for the PS3 Eye, and it's mature enough for its existence to be advertised more widely. Now you don't have to pay for (or pirate, for that matter) the CL Eye driver that's buggy, slow, unmaintained and broken with every other Windows 10 update. The crashes are gone and there's less CPU usage. It's also free as in beer.

• Uninstall any previous driver.
• Use the zadig program <https://zadig.akeo.ie/> to install the libusb-win32 driver onto interface 0 of the camera. Don't use the WinUSB driver!
• If it fails to work, try connecting the camera onto a USB 2.0 or a USB 3.0 controller that you haven't used yet. Then run zadig again.
• In Device Manager, make sure the driver is assigned to the device. If it's not, use the "update driver" button to select libusb (it's its own category).

Features

• Easy Tracker: Adding support for Clip models where three vertices are arranged from top to bottom (by @Slion).
• Apply dark theme on Windows if user enabled it in system settings (by @Slion).
• Now the Octopus pose is fully consistent with the aircraft pilot head pose. Also You can now see the mirror Octopus pose if set the Mirror checkbox to ON (by @GO63-samara).
• More compact size of the main window, as in Opentrack-2.3.10.

Bugs fixed

• Again, WiiPointTracker now appears in the input trackers list.
• Updated PS3 Eye open driver (by @sthalik).
• Easy Tracker: Disable Kinect distortion coefficients usage thus notably fixing badly broken Z component in translation vector (by @Slion).

Known bugs

• PS3 Eye open driver neglects to turn off the red LED after stopping tracking.

Features

• Experimental support for the PS3 Eye open driver! To use it, install libusb as the driver for "interface 0" of the camera device.
• Add color keying support for the PT tracker: you can now track plain colors (by @a1k0n).
• Switch RealSense SDK to 2016 R3 for newer camera support.
• Linux joystick tracker (by @russell).
• Some improvements to the Linux Proton output method (by @jp7677, @russell).

Bugs fixed

• Fix .csv logging crash when cancel pressed in dialog.
• Fix "start in tray" condition inverted.
• Allow dynamic pose for caps.
• Support F13-F24 as valid shortcuts on Windows on some gaming keyboards.
• Fix game detector "enabled" checkbox not reverting when cancel pressed in dialog.
• Fix yaw/roll jumping when crossing the +-180 border (by @GO63-samara).
• Add Hamilton filter (by @GO63-samara).
• Fix vjoystick again (for real this time!).
• Fix stuck keyboard shortcuts with modifiers when depressing the modifier key first.
• Update OVR SDK to 1.43.0. Now using the official binary release.

• tracker/easy: add new tracker for Kinect.
• tracker/wiimote: Fix crashes.
• camera: add Kinect video source, by @Slion.
• OSX now supports building .dmg installers, by @rvt.

See the top post of #778 for a partial changelog. There's no full changelog available at this moment, sorry. Please report old and new bugs by creating new issues on the issue tracker. It can be used as a forum as well.

I'm sorry for not crediting bug reporters at this moment. They'll be credited in 2.3.11 final. Also, hopefully this is the last beta for this release.

BETA3

• 🍰 implement Kinect tracker (by @Slion)
• 🔧 main: fix freeze in mapping window while tracking
• 🔧 tracker/pt: fix tracking for caps
• 🔧 proto/simconnect: fix it (didn't work at all)
• 🔧 proto/vjoystick: fix it (didn't work at all)
• 🔧 🍰 main: change center method

More BETA3 changes

• 🔧 main: show more ruler lines in mapping dialog
• 🔧 tracker/wii: fix crash and logic error on startup
• 🔧 main: fix camera/octopus freezes on HiDPI
• 🍰 tracker/aruco: add 50 Hz to framerate options
• 🍰 tracker/pt: scale the camera feed UI better on 320x240
• 🔧 proto/wine: more robust Wine detection in CMake
• 🔧 proto/win32-mouse: add legacy mouse move method (drifts a lot)
• 🔧 main: fix build with Qt 5.11 and above
• 🔧 main: build faster with GNU Make
• 🔧 main: show source line in debug messages
• 🔧 main: disable modules that don't work on Linux
• 🔧 main: disable modules that only work on Intel

Intro

Here's a new release after a long while. The more experimental features and rewrites were pushed into 2.4.0. This 2.3.10 release however, is intended as stable prior to any big breaking changes.

Developers needed

We need more core developers. If you're interested, send a few pull requests and you'll be granted a commit bit.

Several areas are neglected:

• The module-agnostic core code needs another hand badly.
• Linux support isn't continuously tested, breaks often, and lags behind in features
• OSX-specific code is close to nonexistent. Keybindings don't work.
• The project's bus number has been one since 2012 and this needs to change.

Compatibility issues

• Windows XP isn't supported anymore (in official builds).
• CPUs are expected to have SSE3 (in official builds). It's been a decade or so.

New features

• tracker/wiimote: by Wei Shuai @cpuwolf. Thanks for continuing development and great collaborative spirit.
• tracker/wiimote: implement automatic pairing with the Wiimote device (@cpuwolf)
• tracker/pt: the camera settings dialog now works!!! Thanks to @opencv for accepting the patch so quickly.
• tracker/pt: show brightness slider value and improve auto threshold
• tracker/pt: dynamic pose will fix itself when centering (for cap users)
• filter/accela: euthanize nonlinearity and smoothing options (confusing and useless for almost everyone)
• tracker/hatire: it's confirmed to work, and not necessary to use 2.3.1.5 anymore
• tracker/hatire: workaround bad input range on some devices
• fully portable mode (create portable.txt in program dir)
• mappings: default max pitch output to 90 in graph. show more scales with lower max input selection.
• modules: errors during tracking start are now more clear, with messages specific to each error
• reltrans: add a mode that disables reltrans when close to center (for WW2 sim users).
• gui: fix on HiDPI screens, even when changing resolution
• tray: close button must always exit the whole program (reported by @albertolg)

Deferred features

• Reorganizing some core code that is too messy to understand. Done for 2.4.0 but needs heavy testing.
• proto/freetrack: fix heavily-reported bug. Needs lots of heavy testing before release. Postponed till 2.4.0.
• tracker/tobii: initial version postponed till 2.4.0.

Future features

• Support plugins for obscure functionality (partially implemented)
• Support Linux joystick input tracker (Linux-specific, low priority, pull requests welcome)

Technical details

• this is the same version as the experimental build published some time ago
• Linux build fixes (reported by Artem Sobolev @ljgdasfhk)
• Improvements in keyboard/joystick code on Windows.
• Changes in how UI translation is handled.
• It should all work slightly faster now.
• You can test a translation by setting the OTR_FORCE_LANG environment variable to the appropriate value, e.g. zh_CN or ru_RU. This overrides your operating system's locale as well as "use English only.
• Lots of boring code changes only programmers understand. See commit log.

Thanks

Issue tracker

• @MathijsG, @Len62, @kzfr, @albertolg, @MrCapone, @cpuwolf -- bug reports
• @MathijsG, @Len62 -- answering user questions on the issue tracker

Translations

• Chinese translation -- (Wei Shuai @cpuwolf).
• updates to the Russian translation (Alex Orohovatski @mrsanchos).
• partial NL translation (Mathijs Groothuis @MathijsG).

Epilogue

Now, that was a mouthful. Please report bugs on either the issue tracker or via email, send to sthalik at misaki pl. Please use email in cases where you don't want to register on Github.

Software dedication

The software is dedicated to my late cat, Koszka. He loved sleeping on my chest, and his gentle purring made opentrack development that much more pleasant. He was a darling to all of our family and a great friend. You can see Koszka on the photo album <https://goo.gl/photos/jw7uckRKRLF1Yio97>.

Stability status

No important issues raised for 3 weeks as of 20170907.

Fixes

This is a bugfix release.

• fix sliders from 2.3.7-and-before configs being reset
• filter/accela: revert gain value changes -- reported by @petsild, #665
• tracker/pt: contours are inaccurate, revert them entirely

Non-fixes

• tracker/pt: auto threshold slider now scales point size to lower resolutions
• tracker/s2bot: new tracker interacting with the Smalltalk Squeak environment -- submitted by @achipa, #650
• fix Linux and OSX builds -- submitted by @MrCapone, #668, #669

---

THE BUILD IS VERY BUGGY AND WAS PULLED. DON'T BUILD FROM SOURCE!

See #664 for 2.3.9 prereleases. Again, don't use 2.3.8.

Build the unstable git branch from source directly. Don't build point releases since they have no bugfixes.

---

Changes

• Fix hatire tracker
• Accela: use less sluggish gain function.
• Accela: make nonlinearity useful, not resulting in microstutter anymore.
• Camera angle rotation is gone now. It didn't work right. Use the current center pose to transform position value. Only happens with camera center mode.
• Change the method PT tracker uses to extract LED centers. Change the video overlay somewhat.
• In PT and Aruco, we were using RGB weights rather than BGR for transforming into grayscale. The colors were wrong. This bug was with us since the very beginning. :beer:
• Prevent mapping from having negative values or over the graph's maximum value. -- reported as #628 by @Forsaken-Player, as #651 by @unhappytroll, and as #641 by @Qiler
• Russian translations for the calibration and game detector controls -- by @mrsanchos
• PT: show separate calibration sample counts for yaw and pitch, as well as hints in case of low sample counts.
• Allow for binding Caps Lock and Tab -- issue #646 reported by @BA1-Templar
• Fix for Prepar3d 4.0 and overall SimConnect version mislabelling -- issue #627 by @ArnieWe; correct versions supplied by @ronh991.
• PT: warn in UI not to turn on dynamic pose for clips
• New tracker interfacing with embedded controllers supported by the Smalltalk Squeak environment -- by @achipa
• reorder code in the compat/shm functionality to avoid false positive in braindead antivirus software such as Avira or Bitdefender -- issue #654 reported by @cofilippo to also affect Bitdefender.
• spline/widget: prevent drawing the mapping past the graph's end. Ugly but didn't lead to bugs.

Thanks

Thanks to @Len62 for pointing people to nightly builds after it was found that previous 2.3.7 had few serious bugs.

Trivia

• Don't try access Qt's install prefix where it was installed on the build machine.
• Use higher timer resolution during tracking again.
• Reduce CPU usage with mapping window open during tracking.
• Workaround Falcon BMS in-game "bump" when pitching to exactly 90 degrees.
• Speed up spline redraw when dragging a control point.
• Tweak PT meanshift CPU usage in PT
• Code cleanups, see actual git log. Idem for CMake module code.
• We're not using Intel IPP anymore so remove the notice.
• Fix 32-bit build on Visual Studio 2015 -- issue #640 reported by @ronh991
• Don't call _Exit(2) on Linux or OSX.
• pose-widget: fix use-after-free on Linux, found with Valgrind. Also fix one unitialized memory read, by Clang asan.

THE BUILD IS VERY BUGGY AND WAS PULLED. DON'T BUILD FROM SOURCE!

Stability status

Has multiple bugs, breaking trackers and other basic functionality.

Changes

• The SteamVR tracker for HTC Vive now works. Big thanks to @KydDynoMyte for testing multiple builds in a row, and soliciting outside testing. It was ascertained that yaw works +-180 deg, pitch works +-180 deg, and roll works +-90 as it should be.
• The "Fusion" tracker allows for receiving rotation and position data from two trackers. This was requested over a few years by multiple users.
• The "Test" tracker allows for crashing the application on demand. Truly a feature of the year!
• Mapping: fix points disappearing when moved close together in a particular way.
• Mostly fix keyboard shortcuts on Linux. Thanks to @miniskipper for starting the work. -- issue #577
• Fix bitrot in the X-Plane plugin, by @miniskipper -- issue #623
• After pressing "toggle", "toggle while held" will enable the tracker while held. Previously it always disabled while held.

Misc

• Install debug information along with the program. Because of this, it's way easier for users to report hard-to-find crashes.
• Don't rebuild every single module if core library has only unit file .cpp changes, and no header changes. Greatly speeds up release builds.
• tracker/hatire: try detect 100% cpu serial bug automatically.
• Fix forcefully unloading QLibrary. It should now work on Linux also without _Exit(2).