Deprecate TangentBinormalGenerator

[riccardobl]

The purpose of this PR is to deprecate TangentBinormalGenerator

• Deprecate TangentBinormalGenerator in favor of MikktspaceTangentGenerator
• Add a bit more context to the comment in MikktspaceTangentGenerator
• Remove the part about it being experimental, since at this point it has been tested and patched enought to be considered out of this stage
• Add generate(Mesh) to match TangentBinormalGenerator
• Move debugging utils from TangentBinormalGenerator into TangentUtils to be used with MikktspaceTangentGenerator
• Replaces the usage of TangentBinormalGenerator in all the examples and tests (except the Parallel Tangent test since out mikktspace doesn't have a parallel implementation).

This PR needs to be tested

[codex128]

Just a typo on a javadoc link needs fixing.

[codex128]

Change @{link to {@link.

[capdevon]

Hi guys, what is the status of this PR ? Is it complete ?

[yaRnMcDonuts]

Hi guys, what is the status of this PR ? Is it complete ?

After reviewing the code in regards to its functionality (not for formatting or anything else), I would say it is complete and looks ready to be merged. I have also been using the MikktSpaceTangentGenerator extensively with a fairly wide variety of models in my own project and editor for at least 2 years now, so I am personally confident in its reliability.

I'd also like to try to merge this to get it into the 3.8 alpha release that will be out soon. That way we can get jme users testing these changes as early in the alpha / beta process as possible.

But (since this PR has been sitting for a while) I will wait a few days before merging, in case @riccardobl has anything to add or wants to change anything before the PR is merged.

[yaRnMcDonuts]

I merged this PR so it will be in the first 3.8.0-alpha1 release in the next day or so.

There were many engine examples updated in this PR to use MikktspaceTangentGenerator and there will be a handful of test-cases that will need testing, so I think getting this into the alpha release asap is important.

I took a screenshots showing a list of every test-case / example that was changed in this PR, so that will hopefully make it easier for users to reference this list to test all of these in rapid succession: