8197a611fa
Co-authored-by: Gordon MacPherson <gordon@gordonite.tech> Co-authored-by: Andrea Catania <info@andreacatania.com> Co-authored-by: K. S. Ernest (iFire) Lee <ernest.lee@chibifire.com> This is a complete rewrite of the importer. It will give more deterministic behaviour and has been sponsored by IMVU inc, over 1 year has gone into the development of this importer to remove the burden of the FBX SDK. This was my project for 1 entire year and I really enjoyed the opportunity to add to Godot. Along the road of implementing fixes we implemented fbx pivots, animations and inheritance type handling, which in most cases works properly. We have implemented animation and mesh skinning too this should work out of the box, if there are issues let us know. It's designed so that you can expand this with ease, and fix bugs easily too. It can import from Autodesk Maya and import into Godot, with pivots. There are bits we could polish but for now this is good enough. Additional fixes made before upstreaming: - fixed memory leaks - ensure consistent ordering on mac linux and windows for fbx tree. (very important for material import to be deterministic) - disabled incorrect warnings for fbx_material - added compatibility code for /RootNode/ so compat is not broken - Optimise FBX - directly import triangles - remove debug messages - add messages for mesh id, mesh re-import is sometimes slow and we need to know what mesh is being worked on - Document no longer uses unordered maps - Removed some usages of &GetRequiredToken replaced with safe *GetRequiredToken() function - Added parser debugging - Added ERR_FAIL_CONDS for unsupported mesh formats (we can add these later super easy to do now) - Add memory debugging for the Tokens and the TokenParser to make it safe - Add memory initialisation to mesh.cpp surface_tool.h and mesh.h - Initialise boolean flags properly - Refactored to correct naming for the fbx_mesh_data.h so you know what data you are working on - Disabled corruption caused by the FIXME: - Fixed document reading indexes and index_to_direct vs indexes mode - Fixed UV1 and UV2 coordinates - Fixed importer failing to import version 7700 files - Replaced memory handling in the FBX Document with pointers, before it was dereferencing invalid memory. - Fixed typed properties - Improved Document API - Fixed bug with ProcessDOMConnection() not working with the bool flag set to true. - Fixed FBX skinning not deforming for more than one single mesh - Fixed FBX skeleton mapping and skin mapping not being applied properly (now retrieved from document skin list) - Fixed set_bone_pose being used in final version() - Fixed material properties exceeding 1.0. - FBX Document parser revamped to use safe memory practices, and with graceful error messages. - ScopePtr, TokenPtr and various internal types have been fleshed out to use proper typedefs across the codebase. - Fixed memory leaks caused by token cleanup failing (now explicit cleanup step, no shared_ptr, etc) - Fixed bug with PropertyTable not reading all properties and not cleaning up properly. - Fixed smoothing groups not working - Fixed normal duplications - Fixed duplication check for pre-existing coordinates. - Fixed performance of vertex lookup in large meshes being slow, using lookup table separate to the data for indexing, this reduces import time from 10 minutes of bistro down to 30 seconds. - Fixed includes requiring absolute path in headers and cpp files using CPPPath. Bugs/Features wish list: - locator bones - quat anim key interpolation (most fbx maya files have euler rotations from blender and maya, nobody uses this) - some rigs skins scale up when SSC enabled inconsistently per bone - some skins can disappear entirely - material mapping needs expanded, but this will be done for 4.0 as it requires rewrite. Workarounds for issues found until we patch them: - mesh -> clear skin can resolve most of the bugs above. - locators can be worked around by removing them before exporting your rig. - some material properties wont always import, this is okay to override in the material properties. **If you are having issues or need support fear not!** Please provide minimal rigs which can reproduce issues as we can't spend a lot of time investigating each rig. We need a small example which breaks and we can then sort the problem. In some cases this is not possible so its okay to privately send models to us via IRC or a ticket and we can provide an email address, we won't reveal or disclose privately sent rig files to any companies, or to companies I work for, they will not be shared, only tested and bugs will be drawn up from the conclusions. Also include identifying information about what you did and how it didn't work. Please file each file separately in a bug report, unless the problem is the same. This was sponsored by IMVU, and a special thanks to everyone who supported this project. Signed-off-by: Gordon MacPherson <gordon@gordonite.tech> |
||
---|---|---|
.. | ||
bullet | ||
certs | ||
cvtt | ||
enet | ||
etc2comp | ||
fonts | ||
freetype | ||
glad | ||
jpeg-compressor | ||
libogg | ||
libpng | ||
libsimplewebm | ||
libtheora | ||
libvorbis | ||
libvpx | ||
libwebp | ||
mbedtls | ||
miniupnpc | ||
minizip | ||
misc | ||
nanosvg | ||
opus | ||
pcre2 | ||
pvrtccompressor | ||
recastnavigation | ||
squish | ||
tinyexr | ||
vhacd | ||
wslay | ||
xatlas | ||
zlib | ||
zstd | ||
README.md |
Third party libraries
bullet
- Upstream: https://github.com/bulletphysics/bullet3
- Version: 2.89 (2019)
- License: zlib
Files extracted from upstream source:
- src/* apart from CMakeLists.txt and premake4.lua files
- LICENSE.txt
certs
- Upstream: Mozilla, via https://apps.fedoraproject.org/packages/ca-certificates
- Version: 2018.2.26 (2018)
- License: MPL 2.0
File extracted from a recent Fedora install: /etc/pki/ca-trust/extracted/pem/tls-ca-bundle.pem (It can't be extracted directly from the package, as it's generated on the user's system.)
cvtt
- Upstream: https://github.com/elasota/cvtt
- Version: 1.0.0-beta4 (2018)
- License: MIT
Files extracted from upstream source:
- all .cpp, .h, and .txt files in ConvectionKernels/
enet
- Upstream: http://enet.bespin.org
- Version: 1.3.15 (224f31101fc60939c02f6bbe8e8fc810a7db306b, 2020)
- License: MIT
Files extracted from upstream source:
- all .c files in the main directory (except unix.c win32.c)
- the include/enet/ folder as enet/ (except unix.h win32.h)
- LICENSE file
Important: enet.h, host.c, protocol.c have been slightly modified
to be usable by godot socket implementation and allow IPv6 and DTLS.
Apply the patches in the patches/
folder when syncing on newer upstream
commits.
Two files (godot.cpp and enet/godot.h) have been added to provide enet socket implementation using Godot classes.
It is still possible to build against a system wide ENet but doing so will limit its functionality to IPv4 only.
etc2comp
- Upstream: https://github.com/google/etc2comp
- Version: git (9cd0f9cae0f32338943699bb418107db61bb66f2, 2017)
- License: Apache 2.0
Files extracted from upstream source:
- all .cpp and .h files in EtcLib/
- README.md, LICENSE, AUTHORS
Important: Some files have Godot-made changes.
They are marked with // -- GODOT start --
and // -- GODOT end --
comments.
fonts
Noto Sans
- Upstream: https://github.com/googlei18n/noto-fonts
- Version: 1.06 (2017)
- License: OFL-1.1
Use UI font variant if available, because it has tight vertical metrics and good for UI.
Hack Regular
- Upstream: https://github.com/source-foundry/Hack
- Version: 3.003 (2018)
- License: MIT + Bitstream Vera License
DroidSans*.ttf
- Upstream: https://android.googlesource.com/platform/frameworks/base/+/master/data/fonts/
- Version: ? (pre-2014 commit when DroidSansJapanese.ttf was obsoleted)
- License: Apache 2.0
freetype
- Upstream: https://www.freetype.org
- Version: 2.10.1 (2019)
- License: FreeType License (BSD-like)
Files extracted from upstream source:
- the
src/
folder, stripped of theJamfile
files and thetools
subfolder - the
include/
folder docs/{FTL.TXT,LICENSE.TXT}
glad
- Upstream: https://github.com/Dav1dde/glad
- Version: 0.1.33 (2019)
- License: MIT
The files we package are automatically generated. See the header of glad.c for instructions on how to generate them for the GLES version Godot targets.
jpeg-compressor
- Upstream: https://github.com/richgel999/jpeg-compressor
- Version: 2.00 (aeb7d3b463aa8228b87a28013c15ee50a7e6fcf3, 2020)
- License: Public domain
Files extracted from upstream source:
jpgd*.{c,h}
libogg
- Upstream: https://www.xiph.org/ogg
- Version: git (c8fca6b4a02d695b1ceea39b330d4406001c03ed, 2019)
- License: BSD-3-Clause
Files extracted from upstream source:
src/*.{c,h}
include/ogg/*.h
in ogg/- COPYING
libpng
- Upstream: http://libpng.org/pub/png/libpng.html
- Version: 1.6.37 (2019)
- License: libpng/zlib
Files extracted from upstream source:
- all .c and .h files of the main directory, except from
example.c
andpngtest.c
- the arm/ folder
scripts/pnglibconf.h.prebuilt
aspnglibconf.h
LICENSE
libsimplewebm
- Upstream: https://github.com/zaps166/libsimplewebm
- Version: git (fe57fd3cfe6c0af4c6af110b1f84a90cf191d943, 2019)
- License: MIT (main), BSD-3-Clause (libwebm)
This contains libwebm, but the version in use is updated from the one used by libsimplewebm, and may have unmarked alterations from that.
Files extracted from upstream source:
- all the .cpp, .hpp files in the main folder except
example.cpp
- LICENSE
Important: Some files have Godot-made changes.
They are marked with // -- GODOT start --
and // -- GODOT end --
comments.
libtheora
- Upstream: https://www.theora.org
- Version: 1.1.1 (2010)
- License: BSD-3-Clause
Files extracted from upstream source:
- all .c, .h in lib/
- all .h files in include/theora/ as theora/
- COPYING and LICENSE
Upstream patches included in the patches
directory have been applied
on top of the 1.1.1 source (not included in any stable release yet).
libvorbis
- Upstream: https://www.xiph.org/vorbis
- Version: 1.3.6 (2018)
- License: BSD-3-Clause
Files extracted from upstream source:
src/*
except from:lookups.pl
,Makefile.*
include/vorbis/*.h
as vorbis/- COPYING
libvpx
- Upstream: https://chromium.googlesource.com/webm/libvpx/
- Version: 1.6.0 (2016)
- License: BSD-3-Clause
Files extracted from upstream source:
TODO.
Important: File libvpx/vpx_dsp/x86/vpx_subpixel_8t_intrin_avx2.c
has
Godot-made change marked with // -- GODOT --
comments.
The files libvpx/third_party/android/cpu-features.{c,h}
were copied
from the Android NDK r18.
libwebp
- Upstream: https://chromium.googlesource.com/webm/libwebp/
- Version: 1.1.0 (2020)
- License: BSD-3-Clause
Files extracted from upstream source:
src/*
except from: .am, .rc and .in files- AUTHORS, COPYING, PATENTS
Important: The files utils/bit_reader_utils.{c,h}
have Godot-made
changes to ensure they build for Javascript/HTML5. Those
changes are marked with // -- GODOT --
comments.
mbedtls
- Upstream: https://tls.mbed.org/
- Version: 2.16.8 (2020)
- License: Apache 2.0
File extracted from upstream release tarball:
- All
*.h
frominclude/mbedtls/
tothirdparty/mbedtls/include/mbedtls/
- All
*.c
fromlibrary/
tothirdparty/mbedtls/library/
- LICENSE and apache-2.0.txt files
- Applied the patch in
thirdparty/mbedtls/patches/1453.diff
(PR 1453). Soon to be merged upstream. Check it out at next update. - Applied the patch in
thirdparty/mbedtls/patches/padlock.diff
. This disables VIA padlock support which defines a symbolunsupported
which clashes with a pre-defined symbol. - Added 2 files
godot_core_mbedtls_platform.{c,h}
providing configuration for light bundling with core.
miniupnpc
- Upstream: https://github.com/miniupnp/miniupnp/tree/master/miniupnpc
- Version: git (44366328661826603982d1e0d7ebb4062c5f2bfc, 2020)
- License: BSD-3-Clause
Files extracted from upstream source:
- All
*.c
and*.h
files fromminiupnpc
tothirdparty/miniupnpc/miniupnpc
- Remove
test*
,minihttptestserver.c
andwingenminiupnpcstrings.c
The patch windows_fix.diff
is applied to minissdpc.c
to fix an upstream issue.
The only modified file is miniupnpcstrings.h, which was created for Godot
(it is usually autogenerated by cmake).
minizip
- Upstream: http://www.zlib.net
- Version: 1.2.11 (zlib contrib, 2017)
- License: zlib
Files extracted from the upstream source:
- contrib/minizip/{crypt.h,ioapi.{c,h},zip.{c,h},unzip.{c,h}}
Important: Some files have Godot-made changes for use in core/io.
They are marked with /* GODOT start */
and /* GODOT end */
comments and a patch is provided in the minizip/ folder.
misc
Collection of single-file libraries used in Godot components.
core
clipper.{cpp,hpp}
- Upstream: https://sourceforge.net/projects/polyclipping
- Version: 6.4.2 (2017) + Godot changes (added optional exceptions handling)
- License: BSL-1.0
fastlz.{c,h}
- Upstream: https://github.com/ariya/FastLZ
- Version: 0.5.0 (4f20f54d46f5a6dd4fae4def134933369b7602d2, 2020)
- License: MIT
hq2x.{cpp,h}
- Upstream: https://github.com/brunexgeek/hqx
- Version: TBD, file structure differs
- License: Apache 2.0
open-simplex-noise.{c,h}
- Upstream: https://github.com/smcameron/open-simplex-noise-in-c
- Version: git (0d555e7f40527d0870906fe9469a3b1bb4020b7f, 2015) + custom changes
- License: Unlicense
pcg.{cpp,h}
- Upstream: http://www.pcg-random.org
- Version: minimal C implementation, http://www.pcg-random.org/download.html
- License: Apache 2.0
smaz.{c,h}
- Upstream: https://github.com/antirez/smaz
- Version: git (150e125cbae2e8fd20dd332432776ce13395d4d4, 2009)
- License: BSD-3-Clause
- Modifications: use
const char*
instead ofchar*
for input string
triangulator.{cpp,h}
- Upstream: https://github.com/ivanfratric/polypartition (
src/polypartition.cpp
) - Version: TBD, class was renamed
- License: MIT
- Upstream: https://github.com/ivanfratric/polypartition (
modules
yuv2rgb.h
- Upstream: http://wss.co.uk/pinknoise/yuv2rgb/ (to check)
- Version: ?
- License: BSD
platform
ifaddrs-android.{cc,h}
- Upstream: https://chromium.googlesource.com/external/webrtc/stable/talk/+/master/base/ifaddrs-android.h
- Version: git (5976650443d68ccfadf1dea24999ee459dd2819d, 2013)
- License: BSD-3-Clause
scene
easing_equations.cpp
- Upstream: http://robertpenner.com/easing/ via https://github.com/jesusgollonet/ofpennereasing (modified to fit Godot types)
- Version: git (af72c147c3a74e7e872aa28c7e2abfcced04fdce, 2008) + Godot types and style changes
- License: BSD-3-Clause
mikktspace.{c,h}
- Upstream: https://archive.blender.org/wiki/index.php/Dev:Shading/Tangent_Space_Normal_Maps/
- Version: 1.0 (2011)
- License: zlib
stb_vorbis.c
- Upstream: https://github.com/nothings/stb
- Version: 1.20
- License: Public Domain (Unlicense) or MIT
nanosvg
- Upstream: https://github.com/memononen/nanosvg
- Version: git (25241c5a8f8451d41ab1b02ab2d865b01600d949, 2019)
- License: zlib
Files extracted from the upstream source:
- All .h files in
src/
- LICENSE.txt
opus
- Upstream: https://opus-codec.org
- Version: 1.1.5 (opus) and 0.8 (opusfile) (2017)
- License: BSD-3-Clause
Files extracted from upstream source:
- all .c and .h files in src/ (both opus and opusfile)
- all .h files in include/ (both opus and opusfile) as opus/
- remove unused
opus_demo.c
, - remove
http.c
,wincerts.c
andwinerrno.h
(part of unused libopusurl) - celt/ and silk/ subfolders
- COPYING
pcre2
- Upstream: http://www.pcre.org
- Version: 10.34 (2019)
- License: BSD-3-Clause
Files extracted from upstream source:
- Files listed in the file NON-AUTOTOOLS-BUILD steps 1-4
- All .h files in src/ apart from pcre2posix.h
- src/pcre2_jit_match.c
- src/pcre2_jit_misc.c
- src/sljit/*
- AUTHORS and LICENCE
pvrtccompressor
- Upstream: https://bitbucket.org/jthlim/pvrtccompressor
- Version: hg (cf7177748ee0dcdccfe89716dc11a47d2dc81af5, 2015)
- License: BSD-3-Clause
Files extracted from upstream source:
- all .cpp and .h files apart from
main.cpp
- LICENSE.TXT
recastnavigation
- Upstream: https://github.com/recastnavigation/recastnavigation
- Version: git (57610fa6ef31b39020231906f8c5d40eaa8294ae, 2019)
- License: zlib
Files extracted from upstream source:
Recast/
folder withoutCMakeLists.txt
- License.txt
squish
- Upstream: https://sourceforge.net/projects/libsquish
- Version: 1.15 (2017)
- License: MIT
Files extracted from upstream source:
- all .cpp, .h and .inl files
Important: Some files have Godot-made changes.
They are marked with // -- GODOT start --
and // -- GODOT end --
comments and a patch is provided in the squish/ folder.
tinyexr
- Upstream: https://github.com/syoyo/tinyexr
- Version: 1.0.0 (e4b7840d9448b7d57a88384ce26143004f3c0c71, 2020)
- License: BSD-3-Clause
Files extracted from upstream source:
tinyexr.{cc,h}
vhacd
- Upstream: https://github.com/kmammou/v-hacd
- Version: git (b07958e18e01d504e3af80eeaeb9f033226533d7, 2019)
- License: BSD-3-Clause
Files extracted from upstream source:
- From
src/VHACD_Lib/
:inc
,public
andsrc
LICENSE
Some downstream changes have been made and are identified by
// -- GODOT start --
and // -- GODOT end --
comments.
They can be reapplied using the patches included in the vhacd
folder.
wslay
- Upstream: https://github.com/tatsuhiro-t/wslay
- Version: 1.1.1 (2020)
- License: MIT
File extracted from upstream release tarball:
- All
*.c
and*.h
inlib/
andlib/includes/
wslay.h
has a small Godot addition to fix MSVC build. Seethirdparty/wslay/msvcfix.diff
xatlas
- Upstream: https://github.com/jpcy/xatlas
- Version: git (470576d3516f7e6d8b4554e7c941194a935969fd, 2020)
- License: MIT
Files extracted from upstream source:
xatlas.{cpp,h}
LICENSE
zlib
- Upstream: http://www.zlib.net
- Version: 1.2.11 (2017)
- License: zlib
Files extracted from upstream source:
- all .c and .h files
zstd
- Upstream: https://github.com/facebook/zstd
- Version: 1.4.5 (2020)
- License: BSD-3-Clause
Files extracted from upstream source:
- lib/{common/,compress/,decompress/,zstd.h}
- LICENSE