In preparation for the Xenko game engine integration we decided to change the default math library of VL from SharpDX to Xenko. The decision was particularly easy since both math libraries have the same origin and most types and methods are identical. And thanks to the VL import layer it’s easy to switch out the types, without any noticeable changes for the VL user.
What you get:
- Existing VL patches will continue to work as before
- No conversion needed when working with Xenko
- Faster matrix uploads to GPU (see below)
Trivia
We are (again) in luck with Xenko since it just so happened that Alexandre Mutel, who developed SharpDX, was a core developer at Xenko. We actually didn’t know that at the time we started to work on the VL core library. We chose SharpDX mainly because it was well established, complete and open source. So it was quite a nice surprise when we browsed the Xenko source code for the first time and saw that they basically use the same math code.
Download
Here are direct links to the latest preview versions: vvvv gamma 2019.1 preview 624 vvvv_50alpha38.2_x64 addons_50alpha38.2_x64
Technical Details
This section is only relevant for library developers.
Transposed Matrix Memory Layout
Xenko’s 4x4 matrices have a transposed memory layout compared to SharpDX. This is not to be confused with transposed matrix elements (M11, M12, M13 etc.), it is only relevant when doing low-level operations with memory and pointers, such as uploading them to the GPU. The big advantage of it is, that Xenko’s matrices can directly be uploaded to the GPU without the overhead of transposing them.
Changes on C# Projects
Most C# projects written for VL don’t need to be changed. Only if they use the SharpDX.Mathematics nuget to work with vectors, matrices, rectangles etc.:
- Must switch to Xenko math
- Must use the new SDK style project format
In order to transition your C# project to Xenko, remove the SharpDX.Mathematics nuget and install Xenko.Core.Mathematics instead. Then change the using statements in the C# files:
//old:
using SharpDX;
//new:
using Xenko.Core.Mathematics;
If you then get an error on compilation, your project might be in the old format. Upgrading is quite easy, it just involves changing the header and deleting most lines in the project file. Follow this guide or join our chat if you need help.
Please give the new version a spin and send us a report if anything doesn’t work as before. Happy calculations!
Yours, devvvvs
Comments:
Comments are no longer accepted for this post.
I’m sure this is the right way going forward in preparation for Xenko but it might not be as smooth a transition for old patches as you might think.
The issue I’m having is with Deserialization. I have loads of files with serialized data which also use the SharpDX data types. Now VL has no idea what those types are.
Do I have to find and replace all the references (possibly automated) in the XML files, implement my own serializers or is there some way to add some sort of type alias so that VL would automatically recognize the old types and load them as Xenko types?
Thanks
chances are that this will not affect anyone else at this point in time. however, if you do have to upgrade, plan in a little more time.
as the first post stated, only csproj files adhering to the new sdk-style will work. this is 100% true. however, the upgrade process is definitely not an easy one, like fixing the first line and being done. after manual tinkering the file for a few hours with little effect but frustration, I ended up making a new folder, creating a new .net standard 2.0 project and reimporting all used files, nugets, and other dependencies.
because it is missing in the original post: as of vvvv beta39 you have to use Xenko.Core.Mathematics 3.1.0.1-beta02-0741. it is available only from nuget.org, vvvv.org seems to have rolled over it long ago.
the good thing that came from it: the csproj is now only a tenth of its former size, and no packages.config at all.
@velcrome yes, making a new project file is the easiest. most vvvv/vl projects are tiny and you only need to set the dependencies. c# files get listed automatically with the new project format.
about the Xenko.Core.Mathematics reference, you can use the official release one, the specific version shouldn’t have an impact: https://www.nuget.org/packages/Xenko.Core.Mathematics/3.1.0.1