# Overview (JavaFX 3D Model Importers)
Date: 2014-02-09

#

JavaFX 3D Model Importers

API Specifications

- Early Access -

JavaFX 8 importers for 3D model files.

See: Description

Packages
com.interactivemesh.jfx.importer: Common classes for JavaFX 3D model importers.
com.interactivemesh.jfx.importer.col: ColModelImporterJFX 0.6 - Importer for COLLADA™ 1.4.1 & 1.5.0 files.
com.interactivemesh.jfx.importer.fxml: FxmlModelImporterJFX 0.5 - Importer for 3D FXML files.
com.interactivemesh.jfx.importer.obj: ObjModelImporterJFX 0.8 - Importer for OBJ files.
com.interactivemesh.jfx.importer.stl: StlMeshImporterJFX 0.7 - Importer for STL files.
com.interactivemesh.jfx.importer.tds: 3dsModelImporterJFX 0.7 - Importer for 3ds files.
com.interactivemesh.jfx.importer.x3d: X3dModelImporterJFX 0.4 - Importer for X3D™ files.

JavaFX 8 importers for 3D model files.

3D format | Files | 3D model importer | Archive | Release

3ds
COLLADA 1.4.1 & 1.5.0
FXML 8
OBJ
STL
X3D 3.3

*.3ds
*.dae *.zae
*.fxml
*.obj
*.stl
*.x3d *.x3dz

3dsModelImporterJFX
ColModelImporterJFX
FxmlModelImporterJFX
ObjModelImporterJFX
StlModelImporterJFX
X3dModelImporterJFX

jim3dsModelImporterJFX.jar
jimColModelImporterJFX.jar
jimFxmlModelImporterJFX.jar
jimObjModelImporterJFX.jar
jimStlModelImporterJFX.jar
jimX3dModelImporterJFX.jar

0.7
0.6
0.5
0.8
0.7
0.4

System requirements

JRE 8 - release candidate build b128, February 1, 2014. (http://jdk8.java.net)

JavaFX 8 restrictions/issues

- Rendering of double-sided geometry with culling property set to CullFace.NONE might fail due to not flipped normals (RT-30623).
- Transparency/opacity support is still under development (RT-28874, RT-34356).

See https://javafx-jira.kenai.com

Model importers restrictions/issues

- Converting normals to smoothing groups supports only a single group per face but not multiple groups per face. See javafx.scene.shape.TriangleMesh.getFaceSmoothingGroups() for more details.
- Smoothing groups are generated correctly only if the normals are non-redundant indexed.
- Transparency is not active, see above.

Mapping imported coordinate sytem onto JavaFX 3D coordinate sytem

The imported geometric data will be converted to the JavaFX 3D coordinate sytem: upward axis -Y, right axis +X, and inward axis +Z. For instance, the Y-up right-handed coordinate system will be mapped as follows: +Y -> -Y, +X -> +X, +Z -> -Z.

Correspondingly, all imported transforms will be adapted so that the converted coordinates will be rotated, scaled, and translated correctly. This is also valid for cameras and lights.

Supported image formats for PhongMaterial maps

Type javafx.scene.image.Image

- 'bmp', 'gif', 'jpeg', 'png'

  JavaFX image loader (default)

Type javafx.scene.image.WritableImage

- 'bmp', 'gif', 'jpeg', 'png'

  Java Image I/O API, import option MAP_WRITABLEIMAGE

- 'tga'

  data type 2 - true-color images, 24/32 bit, uncompressed; InteractiveMesh implementation

- 'tif'

  Requires installed Java Advanced Imaging (JAI) or the cross-platform packages "jai_codec.jar" and "jai_core.jar" on the classpath

  JAI 1.3.1 downloads: http://download.java.net/media/jai/builds/release/1_1_3/
  JAI 1.3.1 cross-platform packages: jai-1_1_3-lib.zip

Date

2014/02/09

Copyright (C) 2013-2014 August Lammersdorf, InteractiveMesh e.K.. All rights reserved.

InteractiveMesh e.K.
August Lammersdorf
Hauptstraße 28d
85737 Ismaning
Germany / Munich Area
District court Munich HRA 89887
www.InteractiveMesh.com/org

License Agreement

By installing, copying, or otherwise using the Software, you agree to be bound by the terms of this Agreement. If you do not agree to the terms of this Agreement, do not install or use the Software.

The copyright holder grants to you a non-exclusive, perpetual, irrevocable, and worldwide right to use the Software. It is provided to you free of charge for academic, commercial, and personal use.

You may not remove any copyright, license, or other proprietary notice from the Software.

No parts of the Software may be reproduced in part or in whole. You may not reverse engineer, decompile, or disassemble the Software or prepare derivative works of it.

THIS SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, EIHTER EXPRESS OR IMPLIED, INCLUDING, WITHOUT LIMITATION, ANY WARRANTIES OR CONDITIONS OF TITLE, NON-INFRINGEMENT, MERCHANTABILITY, OR FITNESS FOR A PARTICULAR PURPOSE. YOU ARE SOLELY RESPONSIBLE FOR DETERMINING THE APPROPRIATENESS OF USING THE SOFTWARE AND ASSUME ANY RISKS ASSOCIATED WITH YOUR EXERCISE OF PERMISSIONS UNDER THIS LICENSE.

IN NO EVENT AND UNDER NO LEGAL THEORY, WHETHER IN TORT, CONTRACT, OR OTHERWISE, UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING, SHALL THE COPYRIGHT HOLDER BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES OF ANY CHARACTER ARISING AS A RESULT OF THIS LICENSE OR OUT THE USE OR INABILITY TO USE THE SOFTWARE, EVEN IF THE COPYRIGHT HOLDER HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

Trademarks

COLLADA is a trademark of Sony Computer Entertainment, Inc.
Java and JavaFX are trademarks or registered trademarks of Oracle and/or its affiliates in the United States and other countries.
X3D is a registered trademark of Web3D Consortium, Inc. in the United States and other countries.
All other trademarks mentioned herein are the property of their respective owners.

Copyright (C) 2013-2014 InteractiveMesh e.K.