» VL: Switch to Xenko Math
This site relies heavily on Javascript. You should enable it if you want the full experience. Learn more.

VL: Switch to Xenko Math

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.:

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

tonfilm, Friday, Aug 23rd 2019 Digg | Tweet | Delicious 4 comments  
domj 27/08/2019 - 12:18

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

tonfilm 27/08/2019 - 13:14

@domj That should all work fine, VL doesn't save a type hint to SharpDX in the files. This was of course tested. Can you describe in a forums thread what you did in order to get SharpDX type hints into your files?

domj 27/08/2019 - 15:18

@tonfilm by building a silly application that seems to explore many VL corner cases :D. I'll post in the forum with details but I think the gist of it is serializing collections of Objects which of course need type hints to be read back.

  • 1

anonymous user login

Shoutbox

~1min ago

skyliner: anyone at usbynight?

~1h ago

joreg: Reminder: This wednesday in #berlin: Getting Started with Data Visualization: https://nodeforum.org/announcements/workshop-getting-started-with-data-visualization/ vvvv #creativecoding #dataviz

~2d ago

joreg: @eglod vvvv is international! wenn du hilfe auf deutsch brauchst, dann komm am besten in unseren deutschen chat: https://riot.im/app/#/room/#vvvv-at:matrix.org

~3d ago

eglod: In allen möglichen Sprachen gibt es VVV. V4 ist deutsch, warum nicht in deutscher Sprache. eglod

~3d ago

eglod: In allen möglichen Sprachen gibt es VVV. V4 ist deutsch, warum nicht in deutscher Sprache. eglod

~4d ago

joreg: Reminder: First #vvvv meetup in #hamburg this friday: vvvv-hamburg-meetup-1 Hope to see some of you there!

~6d ago

AKa-visuals: Hi guys. Everyone guess when xenko engine would be avaliable to play around in vl ... Isnt?

~14d ago

joreg: and right after the intro join us for our second Patching Circle: patching-circle bring your projects and problems and patch along