Next release

[mosra]

There's a lot of new stuff which should be made into official release as soon as possible in order to keep the changelog in sane size.

A (hopefully not very growing) list of things to do:

General:

• At least somewhat usable MSVC 2015 support (MSVC 2015 port #96)
• Update Get rid of compatibility branch
• Revive (P)NaCl support as GCC 4.4 support was dropped later
• Publicly available and green CI for all platforms (Publicly available CI #99)
• Code coverage on coveralls.io?
• Put documentation on readthedocs.org (fixed some other way, see Using Sphinx/Breathe/ReadTheDocs for documentation #113)
• Fix currently pending issues and TODOs
• Stabilize new APIs
• Drop stuff that's long deprecated after the release
• Update copyright year to 2017
• Make changelogs part of Doxygen docs

Corrade:

• Add planned --skip-tests, --skip-benchmarks and --no-xfail options to TestSuite tester executables (mosra/corrade@c9208a8, mosra/corrade@00249f2)
• Something's wrong with recent Emscripten builds (Utility::Resource) (mosra/corrade@a330b4a)
• Update TestSuite documentation to mention colored output, instanced tests, repeating and benchmarks (mosra/corrade@f37f624)
• Plugin initialization/finalization is broken by design (e.g. unloading HarfBuzzFont finalizes FreeType library) postponed

Core lib:

• Finish Fix pixel storage support so it passes the tests at least on one platform (Proper pixel storage support #104)
• magnum-imageconverter utility
• "OpenGL 2015" and OpenGL ES 3.2 support (just a few new function aliases) postponed, see OpenGL ES 3.2 / GL 4.6 support #231
• Finish Windows Store/Phone support (a4d3beb)
• WindowlessXEglApplication to be able to run utilities on embedded Linux devices we have WindowlessEglApplication and that should be enough I think
• Compute shader tests fail on NV (ad96241)
• Container::Array instances returned from plugin crash on dangling deleter pointer after a plugin is unloaded (mosra/corrade@43397de)
• Finish unhandled cases in DebugTools::textureImage() postponed
• Implement compressed subimage queries to finally have complete textures (affected by a bug on NVidia) (645edec)
  • which means adding a clean way for driver workarounds and ability to selectively disable them from command-line (356491e)
  • and from environment to have all cases conveniently batch-testable (707d1d0)

Plugins:

• Merge DDS importer ([WIP] DDS import magnum-plugins#7)
• Add AnyImageConverter and AnyAudioImporter
• Make StbImageConverter produce also other image formats (mosra/magnum-plugins@332ba6c)
  • Ability to get alias name from plugin manager (mosra/corrade@834ea41)
• Implement StbDxtImageConverter using stb_dxt and (dynamically) use it in DdsImageConverter (should be easy as the other way around is already done) postponed

Examples:

• Port Audio example to Emscripten (should be fun)
• Check what's new in WebGL 2 land (Porting Object Picking to ES3 / WebGL 2 magnum-examples#12)
• Picking example broken on Mesa (04983da and mosra/magnum-examples@9f05e1c)

Integration:

• Stabilize OvrIntegration API and update to 0.7 (Update LibOvrIntegration to Oculus SDK 0.6.0.1 beta magnum-integration#7) 0.8 (Update to Oculus SDK 0.8.0.0-beta magnum-integration#10, ovr: Adapt to recent OvrIntegration changes. magnum-examples#19) 1.3 (Update to Oculus SDK 1.3.0 magnum-integration#12, ovr: Adapt to recent OvrIntegration changes.  magnum-examples#22), hopefully they will finally stop completely breaking the API with each new release

[mosra]

Windows Phone/Store support done in a4d3beb, another step closer to a release!

[mosra]

More transparent way to handle driver workarounds done in 356491e. Tiny but important feature.

[mosra]

Ability to disable extensions done in 9e4a86c, a counterpart to transparent driver workarounds.

[mosra]

Compressed texture subimage queries done in 645edec, disabling extensions/workarounds from environment done in 707d1d0.

[Squareys]

I would suggest to drop the following items from the list, since the last release has now almost been a year ago (Maybe instead we could open independent issues for them? I'd be glad to do it/help with it):

• magnum-imageconverter utility
• WindowlessXEglApplication to be able to run utilities on embedded Linux devices
• "OpenGL 2015" and OpenGL ES 3.2 support (just a few new function aliases)
• Make StbImageConverter produce also other image formats
• Implement StbDxtImageConverter using stb_dxt and (dynamically) use it in DdsImageConverter
• Port Audio example to Emscripten (should be fun)
• Check what's new in WebGL 2 land (Porting Object Picking to ES3 / WebGL 2 magnum-examples#12)

Or in general, I feel our strategy should be: Don't add new stuff for this release, but fix existing and remove old stuff :)

I know that list is pretty radical, but many simple todos still add up. Also, it's just a suggestion, of course.

Also "Update copyright year" has been done, right?

[mosra]

Agreed.

Currently it's more like "I need this feature right now so I'll implement it" and not much time left for fixing lower priority issues and writing changelogs. The single most important TODO for the snapshot now is just this:

• Making everything working on Windows with MSVC >=2013, Linux with GCC >= 4.7, OSX, iOS, Android, Emscripten and NaCl

If that's achieved, I'll make a snapshot.

Dropping GCC <=4.6 support is I guess sane thing to do, but I need to keep the workarounds that were needed for MSVC 2013. Then, because NaCl had GCC 4.4, I need to switch to PNaCl that has newer compiler, which means more testing and CMake wrangling to make the toolchain working. I didn't test on Android for a while and Emscripten compiler seemed to have issues with Utility::Resource lately, maybe that's fixed now.

[mosra]

"Failing" compute shader tests fixed in ad96241. Of course it was my fault the whole time. 258ab1a added countermeasures to avoid accessing data of rvalue Image* instances so this doesn't happen ever again.

[mosra]

--skip-tests, --skip-benchmarks and --no-xfail options for TestSuite tester executables added in mosra/corrade@c9208a8 and mosra/corrade@00249f2. So little yet so powerful.

[mosra]

Utility::Resource is finally fixed on Emscripten in mosra/corrade@a330b4a. It was (of course) alignment problem. The Emscripten builds are also now being added on AppVeyor CI, so it should result in more stable experience in the future.

cc: @smspillaz

[smspillaz]

Thanks!

Sam Spilsbury

[mosra]

Object Picking Example fixed in 04983da and mosra/magnum-examples@9f05e1c.

[mosra]

Crash in Array destructor with dangling deleter pointer on plugin unload fixed in mosra/corrade@43397de.

[mosra]

Code coverage for all repos done now (except examples, where it does not make much sense).

[mosra]

Image converter utility added in 0e2d281.

[mosra]

As of now, all compatibility branches are dropped and all references to them were removed from the documentation.

[mosra]

Last known bugs with pixel storage were fixed in 1cfd2dc and d998cb0.

[mosra]

Corrade::TestSuite documentation improvements done in mosra/corrade@f37f624.

[mosra]

Ability to get alias name from plugin manager done in mosra/corrade@834ea41 and the StbImageImporter plugin was reworked to handle also other formats in mosra/magnum-plugins@332ba6c.

[mosra]

CIs are done, Audio and other WebGL 2 stuff is on Emscripten now, changelogs were moved to Doxygen. The only remaining thing is some initial support for ES3.2/GL4.6 (so it doesn't advertise stuff that's >3 years old), the rest can be done later.

[mosra]

2018.02 is out, release announcement is at http://blog.magnum.graphics/announcements/2018.02/ .

Don't tell anybody it took me three years 🙈 :D