From f9be42ee62f7dcdbaa9928458deeb27571101e39 Mon Sep 17 00:00:00 2001 From: jmekaelthas Date: Wed, 8 Apr 2015 20:02:33 +0200 Subject: [PATCH 001/113] Bugfix: fixed problem with ipo curves computin during animations import. --- .../plugins/blender/animations/AnimationHelper.java | 4 ++-- .../plugins/blender/animations/BlenderAction.java | 12 ++++++------ .../plugins/blender/animations/BoneContext.java | 11 +++++++---- .../jme3/scene/plugins/blender/animations/Ipo.java | 13 +++++++++++-- 4 files changed, 26 insertions(+), 14 deletions(-) diff --git a/jme3-blender/src/main/java/com/jme3/scene/plugins/blender/animations/AnimationHelper.java b/jme3-blender/src/main/java/com/jme3/scene/plugins/blender/animations/AnimationHelper.java index f8c1cdad3..1d889f992 100644 --- a/jme3-blender/src/main/java/com/jme3/scene/plugins/blender/animations/AnimationHelper.java +++ b/jme3-blender/src/main/java/com/jme3/scene/plugins/blender/animations/AnimationHelper.java @@ -71,7 +71,7 @@ public class AnimationHelper extends AbstractBlenderHelper { if (actions.size() > 0) { List animations = new ArrayList(); for (BlenderAction action : actions) { - SpatialTrack[] tracks = action.toTracks(node); + SpatialTrack[] tracks = action.toTracks(node, blenderContext); if (tracks != null && tracks.length > 0) { Animation spatialAnimation = new Animation(action.getName(), action.getAnimationTime()); spatialAnimation.setTracks(tracks); @@ -110,7 +110,7 @@ public class AnimationHelper extends AbstractBlenderHelper { if (actions.size() > 0) { List animations = new ArrayList(); for (BlenderAction action : actions) { - BoneTrack[] tracks = action.toTracks(skeleton); + BoneTrack[] tracks = action.toTracks(skeleton, blenderContext); if (tracks != null && tracks.length > 0) { Animation boneAnimation = new Animation(action.getName(), action.getAnimationTime()); boneAnimation.setTracks(tracks); diff --git a/jme3-blender/src/main/java/com/jme3/scene/plugins/blender/animations/BlenderAction.java b/jme3-blender/src/main/java/com/jme3/scene/plugins/blender/animations/BlenderAction.java index aa36c918e..38a437ba0 100644 --- a/jme3-blender/src/main/java/com/jme3/scene/plugins/blender/animations/BlenderAction.java +++ b/jme3-blender/src/main/java/com/jme3/scene/plugins/blender/animations/BlenderAction.java @@ -10,9 +10,8 @@ import java.util.Map.Entry; import com.jme3.animation.BoneTrack; import com.jme3.animation.Skeleton; import com.jme3.animation.SpatialTrack; -import com.jme3.math.Quaternion; -import com.jme3.math.Vector3f; import com.jme3.scene.Node; +import com.jme3.scene.plugins.blender.BlenderContext; /** * An abstract representation of animation. The data stored here is mainly a @@ -69,10 +68,10 @@ public class BlenderAction implements Cloneable { * the node that will be animated * @return the spatial tracks for the node */ - public SpatialTrack[] toTracks(Node node) { + public SpatialTrack[] toTracks(Node node, BlenderContext blenderContext) { List tracks = new ArrayList(featuresTracks.size()); for (Entry entry : featuresTracks.entrySet()) { - tracks.add((SpatialTrack) entry.getValue().calculateTrack(0, node.getLocalTranslation(), node.getLocalRotation(), node.getLocalScale(), 1, stopFrame, fps, true)); + tracks.add((SpatialTrack) entry.getValue().calculateTrack(0, null, node.getLocalTranslation(), node.getLocalRotation(), node.getLocalScale(), 1, stopFrame, fps, true)); } return tracks.toArray(new SpatialTrack[tracks.size()]); } @@ -84,11 +83,12 @@ public class BlenderAction implements Cloneable { * the skeleton that will be animated * @return the bone tracks for the node */ - public BoneTrack[] toTracks(Skeleton skeleton) { + public BoneTrack[] toTracks(Skeleton skeleton, BlenderContext blenderContext) { List tracks = new ArrayList(featuresTracks.size()); for (Entry entry : featuresTracks.entrySet()) { int boneIndex = skeleton.getBoneIndex(entry.getKey()); - tracks.add((BoneTrack) entry.getValue().calculateTrack(boneIndex, Vector3f.ZERO, Quaternion.IDENTITY, Vector3f.UNIT_XYZ, 1, stopFrame, fps, false)); + BoneContext boneContext = blenderContext.getBoneContext(skeleton.getBone(boneIndex)); + tracks.add((BoneTrack) entry.getValue().calculateTrack(boneIndex, boneContext, boneContext.getBone().getBindPosition(), boneContext.getBone().getBindRotation(), boneContext.getBone().getBindScale(), 1, stopFrame, fps, false)); } return tracks.toArray(new BoneTrack[tracks.size()]); } diff --git a/jme3-blender/src/main/java/com/jme3/scene/plugins/blender/animations/BoneContext.java b/jme3-blender/src/main/java/com/jme3/scene/plugins/blender/animations/BoneContext.java index 0eb50fb65..adc0a5c4c 100644 --- a/jme3-blender/src/main/java/com/jme3/scene/plugins/blender/animations/BoneContext.java +++ b/jme3-blender/src/main/java/com/jme3/scene/plugins/blender/animations/BoneContext.java @@ -25,10 +25,13 @@ import com.jme3.scene.plugins.blender.objects.ObjectHelper; */ public class BoneContext { // the flags of the bone - public static final int SELECTED = 0x0001; - public static final int CONNECTED_TO_PARENT = 0x0010; - public static final int DEFORM = 0x1000; - + public static final int SELECTED = 0x000001; + public static final int CONNECTED_TO_PARENT = 0x000010; + public static final int DEFORM = 0x001000; + public static final int NO_LOCAL_LOCATION = 0x400000; + public static final int NO_INHERIT_SCALE = 0x008000; + public static final int NO_INHERIT_ROTATION = 0x000200; + /** * The bones' matrices have, unlike objects', the coordinate system identical to JME's (Y axis is UP, X to the right and Z toward us). * So in order to have them loaded properly we need to transform their armature matrix (which blender sees as rotated) to make sure we get identical results. diff --git a/jme3-blender/src/main/java/com/jme3/scene/plugins/blender/animations/Ipo.java b/jme3-blender/src/main/java/com/jme3/scene/plugins/blender/animations/Ipo.java index f388b703f..f5113129f 100644 --- a/jme3-blender/src/main/java/com/jme3/scene/plugins/blender/animations/Ipo.java +++ b/jme3-blender/src/main/java/com/jme3/scene/plugins/blender/animations/Ipo.java @@ -137,7 +137,7 @@ public class Ipo { * as jme while other features have different one (Z is UP) * @return bone track for the specified bone */ - public Track calculateTrack(int targetIndex, Vector3f localTranslation, Quaternion localRotation, Vector3f localScale, int startFrame, int stopFrame, int fps, boolean spatialTrack) { + public Track calculateTrack(int targetIndex, BoneContext boneContext, Vector3f localTranslation, Quaternion localRotation, Vector3f localScale, int startFrame, int stopFrame, int fps, boolean spatialTrack) { if (calculatedTrack == null) { // preparing data for track int framesAmount = stopFrame - startFrame; @@ -236,6 +236,15 @@ public class Ipo { } } translations[index] = localRotation.multLocal(new Vector3f(translation[0], translation[1], translation[2])); + + if(boneContext != null) { + if(boneContext.getBone().getParent() == null && boneContext.is(BoneContext.NO_LOCAL_LOCATION)) { + float temp = translations[index].z; + translations[index].z = -translations[index].y; + translations[index].y = temp; + } + } + if (queternionRotationUsed) { rotations[index] = new Quaternion(quaternionRotation[0], quaternionRotation[1], quaternionRotation[2], quaternionRotation[3]); } else { @@ -292,7 +301,7 @@ public class Ipo { } @Override - public BoneTrack calculateTrack(int boneIndex, Vector3f localTranslation, Quaternion localRotation, Vector3f localScale, int startFrame, int stopFrame, int fps, boolean boneTrack) { + public BoneTrack calculateTrack(int boneIndex, BoneContext boneContext, Vector3f localTranslation, Quaternion localRotation, Vector3f localScale, int startFrame, int stopFrame, int fps, boolean boneTrack) { throw new IllegalStateException("Constatnt ipo object cannot be used for calculating bone tracks!"); } } From 684c923632b1bedc740067bde125279cb1ad199c Mon Sep 17 00:00:00 2001 From: Maselbas Date: Sun, 12 Apr 2015 15:31:48 +0200 Subject: [PATCH 002/113] Fix issue #255 - scenecomposer : forcedCamera - Now you can't use scenecomposer tool while overiding the camera control - Fixed a tool modificaton not undo/redo able. --- .../ComposerCameraController.java | 20 +++++++++---------- 1 file changed, 9 insertions(+), 11 deletions(-) diff --git a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/ComposerCameraController.java b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/ComposerCameraController.java index c16933f80..c1689b833 100644 --- a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/ComposerCameraController.java +++ b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/ComposerCameraController.java @@ -79,26 +79,24 @@ public class ComposerCameraController extends AbstractCameraController { @Override public void checkClick(int button, boolean pressed) { - if (button == 0) { - if (isEditButtonEnabled() && !forceCameraControls) { + if (!forceCameraControls || !pressed) { // dont call toolController while forceCam but on button release (for UndoRedo) + if (button == 0) { toolController.doEditToolActivatedPrimary(new Vector2f(mouseX, mouseY), pressed, cam); } - } - if (button == 1) { - if (isEditButtonEnabled() && !forceCameraControls) { + if (button == 1) { toolController.doEditToolActivatedSecondary(new Vector2f(mouseX, mouseY), pressed, cam); } } - - } @Override protected void checkDragged(int button, boolean pressed) { - if (button == 0) { - toolController.doEditToolDraggedPrimary(new Vector2f(mouseX, mouseY), pressed, cam); - } else if (button == 1) { - toolController.doEditToolDraggedSecondary(new Vector2f(mouseX, mouseY), pressed, cam); + if (!forceCameraControls || !pressed) { + if (button == 0) { + toolController.doEditToolDraggedPrimary(new Vector2f(mouseX, mouseY), pressed, cam); + } else if (button == 1) { + toolController.doEditToolDraggedSecondary(new Vector2f(mouseX, mouseY), pressed, cam); + } } } From cd97741f9cba08a043a1834c5cbb5be5fb9ab6a2 Mon Sep 17 00:00:00 2001 From: jmekaelthas Date: Sun, 12 Apr 2015 17:39:18 +0200 Subject: [PATCH 003/113] Bugfix: fix for IK constraint: rotation locks are now applied only on boned woning the constraint and not to all that define it as it was before. --- .../definitions/ConstraintDefinitionIK.java | 37 +++++++++++-------- 1 file changed, 21 insertions(+), 16 deletions(-) diff --git a/jme3-blender/src/main/java/com/jme3/scene/plugins/blender/constraints/definitions/ConstraintDefinitionIK.java b/jme3-blender/src/main/java/com/jme3/scene/plugins/blender/constraints/definitions/ConstraintDefinitionIK.java index 1d6139e04..af1367e4a 100644 --- a/jme3-blender/src/main/java/com/jme3/scene/plugins/blender/constraints/definitions/ConstraintDefinitionIK.java +++ b/jme3-blender/src/main/java/com/jme3/scene/plugins/blender/constraints/definitions/ConstraintDefinitionIK.java @@ -88,14 +88,17 @@ public class ConstraintDefinitionIK extends ConstraintDefinition { if (angle != 0) { Vector3d cross = currentDir.crossLocal(target).normalizeLocal(); q.fromAngleAxis(angle, cross); - if (boneContext.isLockX()) { - q.set(0, q.getY(), q.getZ(), q.getW()); - } - if (boneContext.isLockY()) { - q.set(q.getX(), 0, q.getZ(), q.getW()); - } - if (boneContext.isLockZ()) { - q.set(q.getX(), q.getY(), 0, q.getW()); + + if(bone.equals(this.getOwner())) { + if (boneContext.isLockX()) { + q.set(0, q.getY(), q.getZ(), q.getW()); + } + if (boneContext.isLockY()) { + q.set(q.getX(), 0, q.getZ(), q.getW()); + } + if (boneContext.isLockZ()) { + q.set(q.getX(), q.getY(), 0, q.getW()); + } } boneTransform.getRotation().set(q.multLocal(boneTransform.getRotation())); @@ -124,14 +127,16 @@ public class ConstraintDefinitionIK extends ConstraintDefinition { Vector3d cross = currentDir.crossLocal(target).normalizeLocal(); q.fromAngleAxis(angle, cross); - if (boneContext.isLockX()) { - q.set(0, q.getY(), q.getZ(), q.getW()); - } - if (boneContext.isLockY()) { - q.set(q.getX(), 0, q.getZ(), q.getW()); - } - if (boneContext.isLockZ()) { - q.set(q.getX(), q.getY(), 0, q.getW()); + if(bone.equals(this.getOwner())) { + if (boneContext.isLockX()) { + q.set(0, q.getY(), q.getZ(), q.getW()); + } + if (boneContext.isLockY()) { + q.set(q.getX(), 0, q.getZ(), q.getW()); + } + if (boneContext.isLockZ()) { + q.set(q.getX(), q.getY(), 0, q.getW()); + } } boneWorldTransform.getRotation().set(q.multLocal(boneWorldTransform.getRotation())); From d884ecb317a15cea5a765a9e4eecdec009368a93 Mon Sep 17 00:00:00 2001 From: Erlend Sogge Heggen Date: Mon, 13 Apr 2015 12:56:12 +0200 Subject: [PATCH 004/113] Update README.md No v3.1 in Q4 2014. --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 69d2207bd..b3f993569 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,7 @@ jMonkeyEngine ============= -jMonkeyEngine is a 3D game engine for adventurous Java developers. It’s open source, cross platform and cutting edge. And it is all beautifully documented. The 3.0 branch is the latest stable version of the jMonkeyEngine 3 SDK, a complete game development suite. We'll be frequently submitting stable 3.0.x updates until the major 3.1 version arrives in Q4 2014. +jMonkeyEngine is a 3D game engine for adventurous Java developers. It’s open source, cross platform and cutting edge. And it is all beautifully documented. The 3.0 branch is the latest stable version of the jMonkeyEngine 3 SDK, a complete game development suite. We'll be frequently submitting stable 3.0.x updates until the major 3.1 version arrives. The engine is used by several commercial game studios and computer-science courses. Here's a taste: From b27f86a3aec20e12b40f1336bc5dd09b54a0b270 Mon Sep 17 00:00:00 2001 From: Maselbas Date: Wed, 15 Apr 2015 00:34:59 +0200 Subject: [PATCH 005/113] fix SceneEditTool : - axis pick is now available --- .../src/com/jme3/gde/scenecomposer/SceneEditTool.java | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/SceneEditTool.java b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/SceneEditTool.java index d2767781c..461f76c0c 100644 --- a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/SceneEditTool.java +++ b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/SceneEditTool.java @@ -285,7 +285,7 @@ public abstract class SceneEditTool { * what part of the axis was selected. * For example if (1,0,0) is returned, then the X-axis pole was selected. * If (0,1,1) is returned, then the Y-Z plane was selected. - * + * * @return null if it did not intersect the marker */ protected Vector3f pickAxisMarker(Camera cam, Vector2f mouseLoc, AxisMarkerPickType pickType) { @@ -336,7 +336,7 @@ public abstract class SceneEditTool { CollisionResults results = new CollisionResults(); Ray ray = new Ray(); Vector3f pos = cam.getWorldCoordinates(mouseLoc, 0).clone(); - Vector3f dir = cam.getWorldCoordinates(mouseLoc, 0.1f).clone(); + Vector3f dir = cam.getWorldCoordinates(mouseLoc, 0.125f).clone(); dir.subtractLocal(pos).normalizeLocal(); ray.setOrigin(pos); ray.setDirection(dir); @@ -347,7 +347,7 @@ public abstract class SceneEditTool { /** * Show what axis or plane the mouse is currently over and will affect. - * @param axisMarkerPickType + * @param axisMarkerPickType */ protected void highlightAxisMarker(Camera camera, Vector2f screenCoord, AxisMarkerPickType axisMarkerPickType) { highlightAxisMarker(camera, screenCoord, axisMarkerPickType, false); @@ -355,12 +355,12 @@ public abstract class SceneEditTool { /** * Show what axis or plane the mouse is currently over and will affect. - * @param axisMarkerPickType + * @param axisMarkerPickType * @param colorAll highlight all parts of the marker when only one is selected */ protected void highlightAxisMarker(Camera camera, Vector2f screenCoord, AxisMarkerPickType axisMarkerPickType, boolean colorAll) { setDefaultAxisMarkerColors(); - Vector3f picked = pickAxisMarker(camera, screenCoord, axisPickType); + Vector3f picked = pickAxisMarker(camera, screenCoord, axisMarkerPickType); if (picked == null) { return; } @@ -453,6 +453,7 @@ public abstract class SceneEditTool { // axis.attachChild(quadYZ); axis.setModelBound(new BoundingBox()); + axis.updateModelBound(); return axis; } From abb1a69d6f050f811c8b78312fd2d735420b617e Mon Sep 17 00:00:00 2001 From: Maselbas Date: Wed, 15 Apr 2015 20:34:57 +0200 Subject: [PATCH 006/113] SDK : SceneComposer - Added support for Axis X,Y,Z movement into the MoveManager --- .../gde/scenecomposer/tools/MoveTool.java | 63 +++++++++++-------- 1 file changed, 38 insertions(+), 25 deletions(-) diff --git a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/MoveTool.java b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/MoveTool.java index 97f48cc9f..c76258313 100644 --- a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/MoveTool.java +++ b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/MoveTool.java @@ -27,7 +27,8 @@ import org.openide.util.Lookup; */ public class MoveTool extends SceneEditTool { - private Vector3f pickedPlane; + private Vector3f pickedMarker; + private Vector3f constraintAxis; //used for one axis move private boolean wasDragging = false; private MoveManager moveManager; @@ -46,15 +47,7 @@ public class MoveTool extends SceneEditTool { @Override public void actionPrimary(Vector2f screenCoord, boolean pressed, JmeNode rootNode, DataObject dataObject) { - if (!pressed) { - setDefaultAxisMarkerColors(); - pickedPlane = null; // mouse released, reset selection - if (wasDragging) { - actionPerformed(moveManager.makeUndo()); - wasDragging = false; - } - moveManager.reset(); - } + onPrimary(screenCoord, pressed); } @Override @@ -63,20 +56,35 @@ public class MoveTool extends SceneEditTool { @Override public void mouseMoved(Vector2f screenCoord, JmeNode rootNode, DataObject currentDataObject, JmeSpatial selectedSpatial) { - - if (pickedPlane == null) { + + if (pickedMarker == null) { highlightAxisMarker(camera, screenCoord, axisPickType); } else { - pickedPlane = null; + pickedMarker = null; moveManager.reset(); } } @Override public void draggedPrimary(Vector2f screenCoord, boolean pressed, JmeNode rootNode, DataObject currentDataObject) { + onPrimary(screenCoord, pressed); + } + + @Override + public void draggedSecondary(Vector2f screenCoord, boolean pressed, JmeNode rootNode, DataObject currentDataObject) { + } + + /** + * Called by ActionPrimary and draggedPrimay, improve user feedback + * + * @param screenCoord + * @param pressed + */ + private void onPrimary(Vector2f screenCoord, boolean pressed) { if (!pressed) { setDefaultAxisMarkerColors(); - pickedPlane = null; // mouse released, reset selection + pickedMarker = null; // mouse released, reset selection + constraintAxis = Vector3f.UNIT_XYZ; // no constraint if (wasDragging) { actionPerformed(moveManager.makeUndo()); wasDragging = false; @@ -89,29 +97,34 @@ public class MoveTool extends SceneEditTool { return; } - if (pickedPlane == null) { - pickedPlane = pickAxisMarker(camera, screenCoord, axisPickType); - if (pickedPlane == null) { + if (pickedMarker == null) { + pickedMarker = pickAxisMarker(camera, screenCoord, axisPickType); + if (pickedMarker == null) { return; } - if (pickedPlane.equals(new Vector3f(1, 1, 0))) { + if (pickedMarker.equals(QUAD_XY)) { moveManager.initiateMove(toolController.getSelectedSpatial(), MoveManager.XY, true); - } else if (pickedPlane.equals(new Vector3f(1, 0, 1))) { + } else if (pickedMarker.equals(QUAD_XZ)) { moveManager.initiateMove(toolController.getSelectedSpatial(), MoveManager.XZ, true); - } else if (pickedPlane.equals(new Vector3f(0, 1, 1))) { + } else if (pickedMarker.equals(QUAD_YZ)) { + moveManager.initiateMove(toolController.getSelectedSpatial(), MoveManager.YZ, true); + } else if (pickedMarker.equals(ARROW_X)) { + moveManager.initiateMove(toolController.getSelectedSpatial(), MoveManager.XY, true); + constraintAxis = Vector3f.UNIT_X; // move only X + } else if (pickedMarker.equals(ARROW_Y)) { moveManager.initiateMove(toolController.getSelectedSpatial(), MoveManager.YZ, true); + constraintAxis = Vector3f.UNIT_Y; // move only Y + } else if (pickedMarker.equals(ARROW_Z)) { + moveManager.initiateMove(toolController.getSelectedSpatial(), MoveManager.XZ, true); + constraintAxis = Vector3f.UNIT_Z; // move only Z } } - if (!moveManager.move(camera, screenCoord)) { + if (!moveManager.move(camera, screenCoord, constraintAxis, false)) { return; } updateToolsTransformation(); wasDragging = true; } - - @Override - public void draggedSecondary(Vector2f screenCoord, boolean pressed, JmeNode rootNode, DataObject currentDataObject) { - } } From 5ef129248459969de8563731560e32e1a6617d99 Mon Sep 17 00:00:00 2001 From: Maselbas Date: Wed, 15 Apr 2015 23:31:13 +0200 Subject: [PATCH 007/113] SDK : SceneComposer - Added support for Axis X,Y,Z scaling into the ScaleTool, still need some enhancement --- .../gde/scenecomposer/tools/ScaleTool.java | 67 +++++++++++-------- 1 file changed, 39 insertions(+), 28 deletions(-) diff --git a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/ScaleTool.java b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/ScaleTool.java index 862ef2be2..cfac57ae1 100644 --- a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/ScaleTool.java +++ b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/ScaleTool.java @@ -21,107 +21,118 @@ import org.openide.loaders.DataObject; * @author sploreg */ public class ScaleTool extends SceneEditTool { - - private Vector3f pickedPlane; + + private Vector3f pickedMarker; + private Vector3f constraintAxis; //used for one axis scale private Vector2f lastScreenCoord; private Vector3f startScale; private Vector3f lastScale; private boolean wasDragging = false; - + public ScaleTool() { axisPickType = AxisMarkerPickType.axisAndPlane; setOverrideCameraControl(true); } - + @Override public void activate(AssetManager manager, Node toolNode, Node onTopToolNode, Spatial selectedSpatial, SceneComposerToolController toolController) { super.activate(manager, toolNode, onTopToolNode, selectedSpatial, toolController); displayPlanes(); } - + @Override public void actionPrimary(Vector2f screenCoord, boolean pressed, JmeNode rootNode, DataObject dataObject) { if (!pressed) { setDefaultAxisMarkerColors(); - pickedPlane = null; // mouse released, reset selection + pickedMarker = null; // mouse released, reset selection lastScreenCoord = null; + constraintAxis = Vector3f.UNIT_XYZ; // no axis constraint if (wasDragging) { actionPerformed(new ScaleUndo(toolController.getSelectedSpatial(), startScale, lastScale)); wasDragging = false; } } } - + @Override public void actionSecondary(Vector2f screenCoord, boolean pressed, JmeNode rootNode, DataObject dataObject) { - + } @Override public void mouseMoved(Vector2f screenCoord, JmeNode rootNode, DataObject currentDataObject, JmeSpatial selectedSpatial) { - if (pickedPlane == null) { + if (pickedMarker == null) { highlightAxisMarker(camera, screenCoord, axisPickType, true); } /*else { - pickedPlane = null; - lastScreenCoord = null; - }*/ + pickedPlane = null; + lastScreenCoord = null; + }*/ } @Override public void draggedPrimary(Vector2f screenCoord, boolean pressed, JmeNode rootNode, DataObject currentDataObject) { if (!pressed) { setDefaultAxisMarkerColors(); - pickedPlane = null; // mouse released, reset selection + pickedMarker = null; // mouse released, reset selection lastScreenCoord = null; - + constraintAxis = Vector3f.UNIT_XYZ; // no axis constraint if (wasDragging) { actionPerformed(new ScaleUndo(toolController.getSelectedSpatial(), startScale, lastScale)); wasDragging = false; } return; } - - if (toolController.getSelectedSpatial() == null) + + if (toolController.getSelectedSpatial() == null) { return; - if (pickedPlane == null) { - pickedPlane = pickAxisMarker(camera, screenCoord, axisPickType); - if (pickedPlane == null) + } + if (pickedMarker == null) { + pickedMarker = pickAxisMarker(camera, screenCoord, axisPickType); + if (pickedMarker == null) { return; + } + if (pickedMarker.equals(ARROW_X)) { + constraintAxis = Vector3f.UNIT_X; // scale only X + } else if (pickedMarker.equals(ARROW_Y)) { + constraintAxis = Vector3f.UNIT_Y; // scale only Y + } else if (pickedMarker.equals(ARROW_Z)) { + constraintAxis = Vector3f.UNIT_Z; // scale only Z + } startScale = toolController.getSelectedSpatial().getLocalScale().clone(); } - + if (lastScreenCoord == null) { lastScreenCoord = screenCoord; } else { - float diff = screenCoord.y-lastScreenCoord.y; + float diff = screenCoord.y - lastScreenCoord.y; diff *= 0.1f; lastScreenCoord = screenCoord; - Vector3f scale = toolController.getSelectedSpatial().getLocalScale().add(diff, diff, diff); + Vector3f scale = toolController.getSelectedSpatial().getLocalScale().add(new Vector3f(diff, diff, diff).multLocal(constraintAxis)); lastScale = scale; toolController.getSelectedSpatial().setLocalScale(scale); updateToolsTransformation(); } - + wasDragging = true; } @Override public void draggedSecondary(Vector2f screenCoord, boolean pressed, JmeNode rootNode, DataObject currentDataObject) { - + } private class ScaleUndo extends AbstractUndoableSceneEdit { private Spatial spatial; - private Vector3f before,after; - + private Vector3f before, after; + ScaleUndo(Spatial spatial, Vector3f before, Vector3f after) { this.spatial = spatial; this.before = before; this.after = after; } - + @Override public void sceneUndo() { spatial.setLocalScale(before); @@ -133,6 +144,6 @@ public class ScaleTool extends SceneEditTool { spatial.setLocalScale(after); toolController.selectedSpatialTransformed(); } - + } } From 0d95422d53635fab63c0da93c941bfdc647b9bcc Mon Sep 17 00:00:00 2001 From: Maselbas Date: Thu, 16 Apr 2015 18:22:50 +0200 Subject: [PATCH 008/113] revert some changes in MoveTool --- .../gde/scenecomposer/tools/MoveTool.java | 31 +++++++++---------- 1 file changed, 15 insertions(+), 16 deletions(-) diff --git a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/MoveTool.java b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/MoveTool.java index c76258313..478a0f7c6 100644 --- a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/MoveTool.java +++ b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/MoveTool.java @@ -47,7 +47,16 @@ public class MoveTool extends SceneEditTool { @Override public void actionPrimary(Vector2f screenCoord, boolean pressed, JmeNode rootNode, DataObject dataObject) { - onPrimary(screenCoord, pressed); + if (!pressed) { + setDefaultAxisMarkerColors(); + pickedMarker = null; // mouse released, reset selection + constraintAxis = Vector3f.UNIT_XYZ; // no constraint + if (wasDragging) { + actionPerformed(moveManager.makeUndo()); + wasDragging = false; + } + moveManager.reset(); + } } @Override @@ -67,21 +76,7 @@ public class MoveTool extends SceneEditTool { @Override public void draggedPrimary(Vector2f screenCoord, boolean pressed, JmeNode rootNode, DataObject currentDataObject) { - onPrimary(screenCoord, pressed); - } - - @Override - public void draggedSecondary(Vector2f screenCoord, boolean pressed, JmeNode rootNode, DataObject currentDataObject) { - } - - /** - * Called by ActionPrimary and draggedPrimay, improve user feedback - * - * @param screenCoord - * @param pressed - */ - private void onPrimary(Vector2f screenCoord, boolean pressed) { - if (!pressed) { + if (!pressed) { setDefaultAxisMarkerColors(); pickedMarker = null; // mouse released, reset selection constraintAxis = Vector3f.UNIT_XYZ; // no constraint @@ -127,4 +122,8 @@ public class MoveTool extends SceneEditTool { wasDragging = true; } + + @Override + public void draggedSecondary(Vector2f screenCoord, boolean pressed, JmeNode rootNode, DataObject currentDataObject) { + } } From 20ea38e97e64105327708f3a73cc5be17e51a5df Mon Sep 17 00:00:00 2001 From: jmekaelthas Date: Thu, 16 Apr 2015 22:18:36 +0200 Subject: [PATCH 009/113] Bugfix: fixed some of the artifacts (unfortunately no all of them) that appeared after IK constraint computation; the algorithm now selects the best found solution among all iterations. --- .../definitions/ConstraintDefinitionIK.java | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/jme3-blender/src/main/java/com/jme3/scene/plugins/blender/constraints/definitions/ConstraintDefinitionIK.java b/jme3-blender/src/main/java/com/jme3/scene/plugins/blender/constraints/definitions/ConstraintDefinitionIK.java index af1367e4a..35a4e5618 100644 --- a/jme3-blender/src/main/java/com/jme3/scene/plugins/blender/constraints/definitions/ConstraintDefinitionIK.java +++ b/jme3-blender/src/main/java/com/jme3/scene/plugins/blender/constraints/definitions/ConstraintDefinitionIK.java @@ -110,6 +110,8 @@ public class ConstraintDefinitionIK extends ConstraintDefinition { } } + List bestSolution = new ArrayList(bones.size()); + double bestSolutionDistance = Double.MAX_VALUE; BoneContext topBone = bones.get(0); for (int i = 0; i < iterations && distanceFromTarget > MIN_DISTANCE; ++i) { for (BoneContext boneContext : bones) { @@ -150,6 +152,20 @@ public class ConstraintDefinitionIK extends ConstraintDefinition { DTransform topBoneTransform = new DTransform(constraintHelper.getTransform(topBone.getArmatureObjectOMA(), topBone.getBone().getName(), Space.CONSTRAINT_SPACE_WORLD)); Vector3d e = topBoneTransform.getTranslation().addLocal(topBoneTransform.getRotation().mult(Vector3d.UNIT_Y).multLocal(topBone.getLength()));// effector distanceFromTarget = e.distance(t); + + if(distanceFromTarget < bestSolutionDistance) { + bestSolutionDistance = distanceFromTarget; + bestSolution.clear(); + for(BoneContext boneContext : bones) { + bestSolution.add(constraintHelper.getTransform(boneContext.getArmatureObjectOMA(), boneContext.getBone().getName(), Space.CONSTRAINT_SPACE_WORLD)); + } + } + } + + // applying best solution + for(int i=0;i Date: Fri, 17 Apr 2015 16:06:51 +0200 Subject: [PATCH 010/113] Fixed water filter's glsl 100 shader --- .../src/main/resources/Common/MatDefs/Water/Water.frag | 6 +----- .../src/main/resources/Common/MatDefs/Water/Water.j3md | 1 + 2 files changed, 2 insertions(+), 5 deletions(-) diff --git a/jme3-effects/src/main/resources/Common/MatDefs/Water/Water.frag b/jme3-effects/src/main/resources/Common/MatDefs/Water/Water.frag index 07a4c6429..cb393dbaa 100644 --- a/jme3-effects/src/main/resources/Common/MatDefs/Water/Water.frag +++ b/jme3-effects/src/main/resources/Common/MatDefs/Water/Water.frag @@ -413,10 +413,6 @@ void main(){ // to calculate the derivatives for all these pixels by using step()! // That way we won't get pixels around the edges of the terrain, // Where the derivatives are undefined - if(position.y > level){ - color = color2; - } - - gl_FragColor = vec4(color,1.0); + gl_FragColor = vec4(mix(color, color2, step(level, position.y)), 1.0); } \ No newline at end of file diff --git a/jme3-effects/src/main/resources/Common/MatDefs/Water/Water.j3md b/jme3-effects/src/main/resources/Common/MatDefs/Water/Water.j3md index 2f4b2b39c..2f188934b 100644 --- a/jme3-effects/src/main/resources/Common/MatDefs/Water/Water.j3md +++ b/jme3-effects/src/main/resources/Common/MatDefs/Water/Water.j3md @@ -77,6 +77,7 @@ MaterialDef Advanced Water { FragmentShader GLSL120 : Common/MatDefs/Water/Water.frag WorldParameters { + ViewProjectionMatrixInverse } Defines { ENABLE_RIPPLES : UseRipples From 001f3f8f0e788a9df00ebefac9b5eb950e787f20 Mon Sep 17 00:00:00 2001 From: Nehon Date: Fri, 17 Apr 2015 20:17:04 +0200 Subject: [PATCH 011/113] SDK : Fixed an issue where the shader cide template was not generated properly when creating a shader node definition. --- .../gde/shadernodedefinition/wizard/SNDefWizardIterator.java | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sdk/jme3-materialeditor/src/com/jme3/gde/shadernodedefinition/wizard/SNDefWizardIterator.java b/sdk/jme3-materialeditor/src/com/jme3/gde/shadernodedefinition/wizard/SNDefWizardIterator.java index 0fdabe192..6ced1f1f9 100644 --- a/sdk/jme3-materialeditor/src/com/jme3/gde/shadernodedefinition/wizard/SNDefWizardIterator.java +++ b/sdk/jme3-materialeditor/src/com/jme3/gde/shadernodedefinition/wizard/SNDefWizardIterator.java @@ -102,7 +102,7 @@ public final class SNDefWizardIterator implements WizardDescriptor.Instantiating //Get the template and convert it: FileObject tplSnd = Templates.getTemplate(wizard); - FileObject tplShd = tplSnd.getParent().getChildren()[1]; + FileObject tplShd = tplSnd.getParent().getChildren()[0]; DataObject templateSnd = DataObject.find(tplSnd); DataObject templateShd = DataObject.find(tplShd); From 61ba11d872c81ca57266f9ecdbd3275c5e7fd213 Mon Sep 17 00:00:00 2001 From: iwgeric Date: Fri, 17 Apr 2015 19:00:05 -0400 Subject: [PATCH 012/113] Rework of Android input system to support future expansion and gamepad support. Gamepad support is still a work in progress, but functions. --- ...dler.java => AndroidGestureProcessor.java} | 274 +++---- .../com/jme3/input/android/AndroidInput.java | 686 ------------------ .../input/android/AndroidInputHandler.java | 319 ++++---- .../input/android/AndroidInputHandler14.java | 158 ++++ ...InputHandler.java => AndroidJoyInput.java} | 62 +- .../jme3/input/android/AndroidJoyInput14.java | 108 +++ .../android/AndroidJoystickJoyInput14.java | 403 ++++++++++ .../jme3/input/android/AndroidKeyHandler.java | 140 ---- .../jme3/input/android/AndroidKeyMapping.java | 17 +- .../input/android/AndroidSensorJoyInput.java | 48 +- .../input/android/AndroidTouchHandler.java | 257 ------- .../jme3/input/android/AndroidTouchInput.java | 475 ++++++++++++ ...andler14.java => AndroidTouchInput14.java} | 76 +- .../com/jme3/system/android/OGLESContext.java | 23 +- 14 files changed, 1485 insertions(+), 1561 deletions(-) rename jme3-android/src/main/java/com/jme3/input/android/{AndroidGestureHandler.java => AndroidGestureProcessor.java} (51%) delete mode 100644 jme3-android/src/main/java/com/jme3/input/android/AndroidInput.java create mode 100644 jme3-android/src/main/java/com/jme3/input/android/AndroidInputHandler14.java rename jme3-android/src/main/java/com/jme3/input/android/{AndroidJoyInputHandler.java => AndroidJoyInput.java} (84%) create mode 100644 jme3-android/src/main/java/com/jme3/input/android/AndroidJoyInput14.java create mode 100644 jme3-android/src/main/java/com/jme3/input/android/AndroidJoystickJoyInput14.java delete mode 100644 jme3-android/src/main/java/com/jme3/input/android/AndroidKeyHandler.java delete mode 100644 jme3-android/src/main/java/com/jme3/input/android/AndroidTouchHandler.java create mode 100644 jme3-android/src/main/java/com/jme3/input/android/AndroidTouchInput.java rename jme3-android/src/main/java/com/jme3/input/android/{AndroidTouchHandler14.java => AndroidTouchInput14.java} (67%) diff --git a/jme3-android/src/main/java/com/jme3/input/android/AndroidGestureHandler.java b/jme3-android/src/main/java/com/jme3/input/android/AndroidGestureProcessor.java similarity index 51% rename from jme3-android/src/main/java/com/jme3/input/android/AndroidGestureHandler.java rename to jme3-android/src/main/java/com/jme3/input/android/AndroidGestureProcessor.java index d233836a5..2c0367946 100644 --- a/jme3-android/src/main/java/com/jme3/input/android/AndroidGestureHandler.java +++ b/jme3-android/src/main/java/com/jme3/input/android/AndroidGestureProcessor.java @@ -35,314 +35,240 @@ package com.jme3.input.android; import android.view.GestureDetector; import android.view.MotionEvent; import android.view.ScaleGestureDetector; -import android.view.View; -import com.jme3.input.event.InputEvent; -import com.jme3.input.event.MouseMotionEvent; import com.jme3.input.event.TouchEvent; import java.util.logging.Level; import java.util.logging.Logger; /** * AndroidGestureHandler uses Gesture type listeners to create jME TouchEvents - * for gestures. This class is designed to handle the gestures supported + * for gestures. This class is designed to handle the gestures supported * on Android rev 9 (Android 2.3). Extend this class to add functionality * added by Android after rev 9. - * + * * @author iwgeric */ -public class AndroidGestureHandler implements - GestureDetector.OnGestureListener, +public class AndroidGestureProcessor implements + GestureDetector.OnGestureListener, GestureDetector.OnDoubleTapListener, ScaleGestureDetector.OnScaleGestureListener { - private static final Logger logger = Logger.getLogger(AndroidGestureHandler.class.getName()); - private AndroidInputHandler androidInput; - private GestureDetector gestureDetector; - private ScaleGestureDetector scaleDetector; + private static final Logger logger = Logger.getLogger(AndroidGestureProcessor.class.getName()); + + private AndroidTouchInput touchInput; float gestureDownX = -1f; float gestureDownY = -1f; float scaleStartX = -1f; float scaleStartY = -1f; - public AndroidGestureHandler(AndroidInputHandler androidInput) { - this.androidInput = androidInput; - } - - public void initialize() { - } - - public void destroy() { - setView(null); - } - - public void setView(View view) { - if (view != null) { - gestureDetector = new GestureDetector(view.getContext(), this); - scaleDetector = new ScaleGestureDetector(view.getContext(), this); - } else { - gestureDetector = null; - scaleDetector = null; - } - } - - public void detectGesture(MotionEvent event) { - if (gestureDetector != null && scaleDetector != null) { - gestureDetector.onTouchEvent(event); - scaleDetector.onTouchEvent(event); - } - } - - private int getPointerIndex(MotionEvent event) { - return (event.getAction() & MotionEvent.ACTION_POINTER_INDEX_MASK) - >> MotionEvent.ACTION_POINTER_INDEX_SHIFT; - } - - private int getPointerId(MotionEvent event) { - return event.getPointerId(getPointerIndex(event)); + public AndroidGestureProcessor(AndroidTouchInput touchInput) { + this.touchInput = touchInput; } - - private void processEvent(TouchEvent event) { - // Add the touch event - androidInput.addEvent(event); - if (androidInput.isSimulateMouse()) { - InputEvent mouseEvent = generateMouseEvent(event); - if (mouseEvent != null) { - // Add the mouse event - androidInput.addEvent(mouseEvent); - } - } - } - - // TODO: Ring Buffer for mouse events? - private InputEvent generateMouseEvent(TouchEvent event) { - InputEvent inputEvent = null; - int newX; - int newY; - int newDX; - int newDY; - if (androidInput.isMouseEventsInvertX()) { - newX = (int) (androidInput.invertX(event.getX())); - newDX = (int)event.getDeltaX() * -1; - } else { - newX = (int) event.getX(); - newDX = (int)event.getDeltaX(); - } - int wheel = (int) (event.getScaleSpan()); // might need to scale to match mouse wheel - int dWheel = (int) (event.getDeltaScaleSpan()); // might need to scale to match mouse wheel - - if (androidInput.isMouseEventsInvertY()) { - newY = (int) (androidInput.invertY(event.getY())); - newDY = (int)event.getDeltaY() * -1; - } else { - newY = (int) event.getY(); - newDY = (int)event.getDeltaY(); - } - - switch (event.getType()) { - case SCALE_MOVE: - inputEvent = new MouseMotionEvent(newX, newY, newDX, newDY, wheel, dWheel); - inputEvent.setTime(event.getTime()); - break; - } - - return inputEvent; - } - /* Events from onGestureListener */ - + + @Override public boolean onDown(MotionEvent event) { // start of all GestureListeners. Not really a gesture by itself // so we don't create an event. // However, reset the scaleInProgress here since this is the beginning // of a series of gesture events. -// logger.log(Level.INFO, "onDown pointerId: {0}, action: {1}, x: {2}, y: {3}", -// new Object[]{getPointerId(event), getAction(event), event.getX(), event.getY()}); - gestureDownX = androidInput.getJmeX(event.getX()); - gestureDownY = androidInput.invertY(androidInput.getJmeY(event.getY())); +// logger.log(Level.INFO, "onDown pointerId: {0}, action: {1}, x: {2}, y: {3}", +// new Object[]{touchInput.getPointerId(event), touchInput.getAction(event), event.getX(), event.getY()}); + gestureDownX = touchInput.getJmeX(event.getX()); + gestureDownY = touchInput.invertY(touchInput.getJmeY(event.getY())); return true; } + @Override public boolean onSingleTapUp(MotionEvent event) { // Up of single tap. May be followed by a double tap later. // use onSingleTapConfirmed instead. -// logger.log(Level.INFO, "onSingleTapUp pointerId: {0}, action: {1}, x: {2}, y: {3}", -// new Object[]{getPointerId(event), getAction(event), event.getX(), event.getY()}); +// logger.log(Level.INFO, "onSingleTapUp pointerId: {0}, action: {1}, x: {2}, y: {3}", +// new Object[]{touchInput.getPointerId(event), touchInput.getAction(event), event.getX(), event.getY()}); return true; } + @Override public void onShowPress(MotionEvent event) { -// logger.log(Level.INFO, "onShowPress pointerId: {0}, action: {1}, x: {2}, y: {3}", -// new Object[]{getPointerId(event), getAction(event), event.getX(), event.getY()}); - float jmeX = androidInput.getJmeX(event.getX()); - float jmeY = androidInput.invertY(androidInput.getJmeY(event.getY())); - TouchEvent touchEvent = androidInput.getFreeTouchEvent(); +// logger.log(Level.INFO, "onShowPress pointerId: {0}, action: {1}, x: {2}, y: {3}", +// new Object[]{touchInput.getPointerId(event), touchInput.getAction(event), event.getX(), event.getY()}); + float jmeX = touchInput.getJmeX(event.getX()); + float jmeY = touchInput.invertY(touchInput.getJmeY(event.getY())); + TouchEvent touchEvent = touchInput.getFreeTouchEvent(); touchEvent.set(TouchEvent.Type.SHOWPRESS, jmeX, jmeY, 0, 0); - touchEvent.setPointerId(getPointerId(event)); + touchEvent.setPointerId(touchInput.getPointerId(event)); touchEvent.setTime(event.getEventTime()); touchEvent.setPressure(event.getPressure()); - processEvent(touchEvent); + touchInput.addEvent(touchEvent); } + @Override public void onLongPress(MotionEvent event) { -// logger.log(Level.INFO, "onLongPress pointerId: {0}, action: {1}, x: {2}, y: {3}", -// new Object[]{getPointerId(event), getAction(event), event.getX(), event.getY()}); - float jmeX = androidInput.getJmeX(event.getX()); - float jmeY = androidInput.invertY(androidInput.getJmeY(event.getY())); - TouchEvent touchEvent = androidInput.getFreeTouchEvent(); +// logger.log(Level.INFO, "onLongPress pointerId: {0}, action: {1}, x: {2}, y: {3}", +// new Object[]{touchInput.getPointerId(event), touchInput.getAction(event), event.getX(), event.getY()}); + float jmeX = touchInput.getJmeX(event.getX()); + float jmeY = touchInput.invertY(touchInput.getJmeY(event.getY())); + TouchEvent touchEvent = touchInput.getFreeTouchEvent(); touchEvent.set(TouchEvent.Type.LONGPRESSED, jmeX, jmeY, 0, 0); - touchEvent.setPointerId(getPointerId(event)); + touchEvent.setPointerId(touchInput.getPointerId(event)); touchEvent.setTime(event.getEventTime()); touchEvent.setPressure(event.getPressure()); - processEvent(touchEvent); + touchInput.addEvent(touchEvent); } + @Override public boolean onScroll(MotionEvent startEvent, MotionEvent endEvent, float distX, float distY) { // if not scaleInProgess, send scroll events. This is to avoid sending // scroll events when one of the fingers is lifted just before the other one. // Avoids sending the scroll for that brief period of time. // Return true so that the next event doesn't accumulate the distX and distY values. - // Apparantly, both distX and distY are negative. + // Apparantly, both distX and distY are negative. // Negate distX to get the real value, but leave distY negative to compensate // for the fact that jME has y=0 at bottom where Android has y=0 at top. -// if (!scaleInProgress) { - if (!scaleDetector.isInProgress()) { -// logger.log(Level.INFO, "onScroll pointerId: {0}, startAction: {1}, startX: {2}, startY: {3}, endAction: {4}, endX: {5}, endY: {6}, dx: {7}, dy: {8}", -// new Object[]{getPointerId(startEvent), getAction(startEvent), startEvent.getX(), startEvent.getY(), getAction(endEvent), endEvent.getX(), endEvent.getY(), distX, distY}); + if (!touchInput.getScaleDetector().isInProgress()) { +// logger.log(Level.INFO, "onScroll pointerId: {0}, startAction: {1}, startX: {2}, startY: {3}, endAction: {4}, endX: {5}, endY: {6}, dx: {7}, dy: {8}", +// new Object[]{touchInput.getPointerId(startEvent), touchInput.getAction(startEvent), startEvent.getX(), startEvent.getY(), touchInput.getAction(endEvent), endEvent.getX(), endEvent.getY(), distX, distY}); - float jmeX = androidInput.getJmeX(endEvent.getX()); - float jmeY = androidInput.invertY(androidInput.getJmeY(endEvent.getY())); - TouchEvent touchEvent = androidInput.getFreeTouchEvent(); - touchEvent.set(TouchEvent.Type.SCROLL, jmeX, jmeY, androidInput.getJmeX(-distX), androidInput.getJmeY(distY)); - touchEvent.setPointerId(getPointerId(endEvent)); + float jmeX = touchInput.getJmeX(endEvent.getX()); + float jmeY = touchInput.invertY(touchInput.getJmeY(endEvent.getY())); + TouchEvent touchEvent = touchInput.getFreeTouchEvent(); + touchEvent.set(TouchEvent.Type.SCROLL, jmeX, jmeY, touchInput.getJmeX(-distX), touchInput.getJmeY(distY)); + touchEvent.setPointerId(touchInput.getPointerId(endEvent)); touchEvent.setTime(endEvent.getEventTime()); touchEvent.setPressure(endEvent.getPressure()); - processEvent(touchEvent); + touchInput.addEvent(touchEvent); } return true; } + @Override public boolean onFling(MotionEvent startEvent, MotionEvent endEvent, float velocityX, float velocityY) { // Fling happens only once at the end of the gesture (all fingers up). // Fling returns the velocity of the finger movement in pixels/sec. // Therefore, the dX and dY values are actually velocity instead of distance values // Since this does not track the movement, use the start position and velocity values. - -// logger.log(Level.INFO, "onFling pointerId: {0}, startAction: {1}, startX: {2}, startY: {3}, endAction: {4}, endX: {5}, endY: {6}, velocityX: {7}, velocityY: {8}", -// new Object[]{getPointerId(startEvent), getAction(startEvent), startEvent.getX(), startEvent.getY(), getAction(endEvent), endEvent.getX(), endEvent.getY(), velocityX, velocityY}); - float jmeX = androidInput.getJmeX(startEvent.getX()); - float jmeY = androidInput.invertY(androidInput.getJmeY(startEvent.getY())); - TouchEvent touchEvent = androidInput.getFreeTouchEvent(); +// logger.log(Level.INFO, "onFling pointerId: {0}, startAction: {1}, startX: {2}, startY: {3}, endAction: {4}, endX: {5}, endY: {6}, velocityX: {7}, velocityY: {8}", +// new Object[]{touchInput.getPointerId(startEvent), touchInput.getAction(startEvent), startEvent.getX(), startEvent.getY(), touchInput.getAction(endEvent), endEvent.getX(), endEvent.getY(), velocityX, velocityY}); + + float jmeX = touchInput.getJmeX(startEvent.getX()); + float jmeY = touchInput.invertY(touchInput.getJmeY(startEvent.getY())); + TouchEvent touchEvent = touchInput.getFreeTouchEvent(); touchEvent.set(TouchEvent.Type.FLING, jmeX, jmeY, velocityX, velocityY); - touchEvent.setPointerId(getPointerId(endEvent)); + touchEvent.setPointerId(touchInput.getPointerId(endEvent)); touchEvent.setTime(endEvent.getEventTime()); touchEvent.setPressure(endEvent.getPressure()); - processEvent(touchEvent); + touchInput.addEvent(touchEvent); return true; } /* Events from onDoubleTapListener */ - + + @Override public boolean onSingleTapConfirmed(MotionEvent event) { // Up of single tap when no double tap followed. -// logger.log(Level.INFO, "onSingleTapConfirmed pointerId: {0}, action: {1}, x: {2}, y: {3}", -// new Object[]{getPointerId(event), getAction(event), event.getX(), event.getY()}); - float jmeX = androidInput.getJmeX(event.getX()); - float jmeY = androidInput.invertY(androidInput.getJmeY(event.getY())); - TouchEvent touchEvent = androidInput.getFreeTouchEvent(); +// logger.log(Level.INFO, "onSingleTapConfirmed pointerId: {0}, action: {1}, x: {2}, y: {3}", +// new Object[]{touchInput.getPointerId(event), touchInput.getAction(event), event.getX(), event.getY()}); + float jmeX = touchInput.getJmeX(event.getX()); + float jmeY = touchInput.invertY(touchInput.getJmeY(event.getY())); + TouchEvent touchEvent = touchInput.getFreeTouchEvent(); touchEvent.set(TouchEvent.Type.TAP, jmeX, jmeY, 0, 0); - touchEvent.setPointerId(getPointerId(event)); + touchEvent.setPointerId(touchInput.getPointerId(event)); touchEvent.setTime(event.getEventTime()); touchEvent.setPressure(event.getPressure()); - processEvent(touchEvent); + touchInput.addEvent(touchEvent); return true; } + @Override public boolean onDoubleTap(MotionEvent event) { //The down motion event of the first tap of the double-tap - // We could use this event to fire off a double tap event, or use + // We could use this event to fire off a double tap event, or use // DoubleTapEvent with a check for the UP action -// logger.log(Level.INFO, "onDoubleTap pointerId: {0}, action: {1}, x: {2}, y: {3}", -// new Object[]{getPointerId(event), getAction(event), event.getX(), event.getY()}); - float jmeX = androidInput.getJmeX(event.getX()); - float jmeY = androidInput.invertY(androidInput.getJmeY(event.getY())); - TouchEvent touchEvent = androidInput.getFreeTouchEvent(); +// logger.log(Level.INFO, "onDoubleTap pointerId: {0}, action: {1}, x: {2}, y: {3}", +// new Object[]{touchInput.getPointerId(event), touchInput.getAction(event), event.getX(), event.getY()}); + float jmeX = touchInput.getJmeX(event.getX()); + float jmeY = touchInput.invertY(touchInput.getJmeY(event.getY())); + TouchEvent touchEvent = touchInput.getFreeTouchEvent(); touchEvent.set(TouchEvent.Type.DOUBLETAP, jmeX, jmeY, 0, 0); - touchEvent.setPointerId(getPointerId(event)); + touchEvent.setPointerId(touchInput.getPointerId(event)); touchEvent.setTime(event.getEventTime()); touchEvent.setPressure(event.getPressure()); - processEvent(touchEvent); + touchInput.addEvent(touchEvent); return true; } + @Override public boolean onDoubleTapEvent(MotionEvent event) { //Notified when an event within a double-tap gesture occurs, including the down, move(s), and up events. // this means it will get called multiple times for a single double tap -// logger.log(Level.INFO, "onDoubleTapEvent pointerId: {0}, action: {1}, x: {2}, y: {3}", -// new Object[]{getPointerId(event), getAction(event), event.getX(), event.getY()}); -// if (getAction(event) == MotionEvent.ACTION_UP) { -// TouchEvent touchEvent = touchEventPool.getNextFreeEvent(); -// touchEvent.set(TouchEvent.Type.DOUBLETAP, event.getX(), androidInput.invertY(event.getY()), 0, 0); -// touchEvent.setPointerId(getPointerId(event)); -// touchEvent.setTime(event.getEventTime()); -// touchEvent.setPressure(event.getPressure()); -// processEvent(touchEvent); -// } +// logger.log(Level.INFO, "onDoubleTapEvent pointerId: {0}, action: {1}, x: {2}, y: {3}", +// new Object[]{touchInput.getPointerId(event), touchInput.getAction(event), event.getX(), event.getY()}); + if (touchInput.getAction(event) == MotionEvent.ACTION_UP) { + TouchEvent touchEvent = touchInput.getFreeTouchEvent(); + touchEvent.set(TouchEvent.Type.DOUBLETAP, event.getX(), touchInput.invertY(event.getY()), 0, 0); + touchEvent.setPointerId(touchInput.getPointerId(event)); + touchEvent.setTime(event.getEventTime()); + touchEvent.setPressure(event.getPressure()); + touchInput.addEvent(touchEvent); + } return true; } /* Events from ScaleGestureDetector */ - + + @Override public boolean onScaleBegin(ScaleGestureDetector scaleGestureDetector) { // Scale uses a focusX and focusY instead of x and y. Focus is the middle // of the fingers. Therefore, use the x and y values from the Down event // so that the x and y values don't jump to the middle position. // return true or all gestures for this beginning event will be discarded - logger.log(Level.INFO, "onScaleBegin"); +// logger.log(Level.INFO, "onScaleBegin"); scaleStartX = gestureDownX; scaleStartY = gestureDownY; - TouchEvent touchEvent = androidInput.getFreeTouchEvent(); + TouchEvent touchEvent = touchInput.getFreeTouchEvent(); touchEvent.set(TouchEvent.Type.SCALE_START, scaleStartX, scaleStartY, 0f, 0f); touchEvent.setPointerId(0); touchEvent.setTime(scaleGestureDetector.getEventTime()); touchEvent.setScaleSpan(scaleGestureDetector.getCurrentSpan()); touchEvent.setDeltaScaleSpan(0f); touchEvent.setScaleFactor(scaleGestureDetector.getScaleFactor()); - touchEvent.setScaleSpanInProgress(scaleDetector.isInProgress()); - processEvent(touchEvent); - + touchEvent.setScaleSpanInProgress(touchInput.getScaleDetector().isInProgress()); + touchInput.addEvent(touchEvent); + return true; } + @Override public boolean onScale(ScaleGestureDetector scaleGestureDetector) { // return true or all gestures for this event will be accumulated - logger.log(Level.INFO, "onScale"); +// logger.log(Level.INFO, "onScale"); scaleStartX = gestureDownX; scaleStartY = gestureDownY; - TouchEvent touchEvent = androidInput.getFreeTouchEvent(); + TouchEvent touchEvent = touchInput.getFreeTouchEvent(); touchEvent.set(TouchEvent.Type.SCALE_MOVE, scaleStartX, scaleStartY, 0f, 0f); touchEvent.setPointerId(0); touchEvent.setTime(scaleGestureDetector.getEventTime()); touchEvent.setScaleSpan(scaleGestureDetector.getCurrentSpan()); touchEvent.setDeltaScaleSpan(scaleGestureDetector.getCurrentSpan() - scaleGestureDetector.getPreviousSpan()); touchEvent.setScaleFactor(scaleGestureDetector.getScaleFactor()); - touchEvent.setScaleSpanInProgress(scaleDetector.isInProgress()); - processEvent(touchEvent); + touchEvent.setScaleSpanInProgress(touchInput.getScaleDetector().isInProgress()); + touchInput.addEvent(touchEvent); return true; } + @Override public void onScaleEnd(ScaleGestureDetector scaleGestureDetector) { - logger.log(Level.INFO, "onScaleEnd"); +// logger.log(Level.INFO, "onScaleEnd"); scaleStartX = gestureDownX; scaleStartY = gestureDownY; - TouchEvent touchEvent = androidInput.getFreeTouchEvent(); + TouchEvent touchEvent = touchInput.getFreeTouchEvent(); touchEvent.set(TouchEvent.Type.SCALE_END, scaleStartX, scaleStartY, 0f, 0f); touchEvent.setPointerId(0); touchEvent.setTime(scaleGestureDetector.getEventTime()); touchEvent.setScaleSpan(scaleGestureDetector.getCurrentSpan()); touchEvent.setDeltaScaleSpan(scaleGestureDetector.getCurrentSpan() - scaleGestureDetector.getPreviousSpan()); touchEvent.setScaleFactor(scaleGestureDetector.getScaleFactor()); - touchEvent.setScaleSpanInProgress(scaleDetector.isInProgress()); - processEvent(touchEvent); + touchEvent.setScaleSpanInProgress(touchInput.getScaleDetector().isInProgress()); + touchInput.addEvent(touchEvent); } } diff --git a/jme3-android/src/main/java/com/jme3/input/android/AndroidInput.java b/jme3-android/src/main/java/com/jme3/input/android/AndroidInput.java deleted file mode 100644 index 02fef6b0f..000000000 --- a/jme3-android/src/main/java/com/jme3/input/android/AndroidInput.java +++ /dev/null @@ -1,686 +0,0 @@ -package com.jme3.input.android; - -import android.view.*; -import com.jme3.input.KeyInput; -import com.jme3.input.RawInputListener; -import com.jme3.input.TouchInput; -import com.jme3.input.event.MouseButtonEvent; -import com.jme3.input.event.MouseMotionEvent; -import com.jme3.input.event.TouchEvent; -import com.jme3.input.event.TouchEvent.Type; -import com.jme3.math.Vector2f; -import com.jme3.system.AppSettings; -import com.jme3.util.RingBuffer; -import java.util.HashMap; -import java.util.logging.Logger; - -/** - * AndroidInput is one of the main components that connect jme with android. Is derived from GLSurfaceView and handles all Inputs - * @author larynx - * - */ -public class AndroidInput implements - TouchInput, - View.OnTouchListener, - View.OnKeyListener, - GestureDetector.OnGestureListener, - GestureDetector.OnDoubleTapListener, - ScaleGestureDetector.OnScaleGestureListener { - - final private static int MAX_EVENTS = 1024; - // Custom settings - public boolean mouseEventsEnabled = true; - public boolean mouseEventsInvertX = false; - public boolean mouseEventsInvertY = false; - public boolean keyboardEventsEnabled = false; - public boolean dontSendHistory = false; - // Used to transfer events from android thread to GLThread - final private RingBuffer eventQueue = new RingBuffer(MAX_EVENTS); - final private RingBuffer eventPoolUnConsumed = new RingBuffer(MAX_EVENTS); - final private RingBuffer eventPool = new RingBuffer(MAX_EVENTS); - final private HashMap lastPositions = new HashMap(); - // Internal - private View view; - private ScaleGestureDetector scaledetector; - private boolean scaleInProgress = false; - private GestureDetector detector; - private int lastX; - private int lastY; - private final static Logger logger = Logger.getLogger(AndroidInput.class.getName()); - private boolean isInitialized = false; - private RawInputListener listener = null; - private static final int[] ANDROID_TO_JME = { - 0x0, // unknown - 0x0, // key code soft left - 0x0, // key code soft right - KeyInput.KEY_HOME, - KeyInput.KEY_ESCAPE, // key back - 0x0, // key call - 0x0, // key endcall - KeyInput.KEY_0, - KeyInput.KEY_1, - KeyInput.KEY_2, - KeyInput.KEY_3, - KeyInput.KEY_4, - KeyInput.KEY_5, - KeyInput.KEY_6, - KeyInput.KEY_7, - KeyInput.KEY_8, - KeyInput.KEY_9, - KeyInput.KEY_MULTIPLY, - 0x0, // key pound - KeyInput.KEY_UP, - KeyInput.KEY_DOWN, - KeyInput.KEY_LEFT, - KeyInput.KEY_RIGHT, - KeyInput.KEY_RETURN, // dpad center - 0x0, // volume up - 0x0, // volume down - KeyInput.KEY_POWER, // power (?) - 0x0, // camera - 0x0, // clear - KeyInput.KEY_A, - KeyInput.KEY_B, - KeyInput.KEY_C, - KeyInput.KEY_D, - KeyInput.KEY_E, - KeyInput.KEY_F, - KeyInput.KEY_G, - KeyInput.KEY_H, - KeyInput.KEY_I, - KeyInput.KEY_J, - KeyInput.KEY_K, - KeyInput.KEY_L, - KeyInput.KEY_M, - KeyInput.KEY_N, - KeyInput.KEY_O, - KeyInput.KEY_P, - KeyInput.KEY_Q, - KeyInput.KEY_R, - KeyInput.KEY_S, - KeyInput.KEY_T, - KeyInput.KEY_U, - KeyInput.KEY_V, - KeyInput.KEY_W, - KeyInput.KEY_X, - KeyInput.KEY_Y, - KeyInput.KEY_Z, - KeyInput.KEY_COMMA, - KeyInput.KEY_PERIOD, - KeyInput.KEY_LMENU, - KeyInput.KEY_RMENU, - KeyInput.KEY_LSHIFT, - KeyInput.KEY_RSHIFT, - // 0x0, // fn - // 0x0, // cap (?) - - KeyInput.KEY_TAB, - KeyInput.KEY_SPACE, - 0x0, // sym (?) symbol - 0x0, // explorer - 0x0, // envelope - KeyInput.KEY_RETURN, // newline/enter - KeyInput.KEY_DELETE, - KeyInput.KEY_GRAVE, - KeyInput.KEY_MINUS, - KeyInput.KEY_EQUALS, - KeyInput.KEY_LBRACKET, - KeyInput.KEY_RBRACKET, - KeyInput.KEY_BACKSLASH, - KeyInput.KEY_SEMICOLON, - KeyInput.KEY_APOSTROPHE, - KeyInput.KEY_SLASH, - KeyInput.KEY_AT, // at (@) - KeyInput.KEY_NUMLOCK, //0x0, // num - 0x0, //headset hook - 0x0, //focus - KeyInput.KEY_ADD, - KeyInput.KEY_LMETA, //menu - 0x0,//notification - 0x0,//search - 0x0,//media play/pause - 0x0,//media stop - 0x0,//media next - 0x0,//media previous - 0x0,//media rewind - 0x0,//media fastforward - 0x0,//mute - }; - - public AndroidInput() { - } - - public void setView(View view) { - this.view = view; - if (view != null) { - detector = new GestureDetector(null, this, null, false); - scaledetector = new ScaleGestureDetector(view.getContext(), this); - view.setOnTouchListener(this); - view.setOnKeyListener(this); - } - } - - private TouchEvent getNextFreeTouchEvent() { - return getNextFreeTouchEvent(false); - } - - /** - * Fetches a touch event from the reuse pool - * @param wait if true waits for a reusable event to get available/released - * by an other thread, if false returns a new one if needed. - * - * @return a usable TouchEvent - */ - private TouchEvent getNextFreeTouchEvent(boolean wait) { - TouchEvent evt = null; - synchronized (eventPoolUnConsumed) { - int size = eventPoolUnConsumed.size(); - while (size > 0) { - evt = eventPoolUnConsumed.pop(); - if (!evt.isConsumed()) { - eventPoolUnConsumed.push(evt); - evt = null; - } else { - break; - } - size--; - } - } - - if (evt == null) { - if (eventPool.isEmpty() && wait) { - logger.warning("eventPool buffer underrun"); - boolean isEmpty; - do { - synchronized (eventPool) { - isEmpty = eventPool.isEmpty(); - } - try { - Thread.sleep(50); - } catch (InterruptedException e) { - } - } while (isEmpty); - synchronized (eventPool) { - evt = eventPool.pop(); - } - } else if (eventPool.isEmpty()) { - evt = new TouchEvent(); - logger.warning("eventPool buffer underrun"); - } else { - synchronized (eventPool) { - evt = eventPool.pop(); - } - } - } - return evt; - } - - /** - * onTouch gets called from android thread on touchpad events - */ - public boolean onTouch(View view, MotionEvent event) { - if (view != this.view) { - return false; - } - boolean bWasHandled = false; - TouchEvent touch; - // System.out.println("native : " + event.getAction()); - int action = event.getAction() & MotionEvent.ACTION_MASK; - int pointerIndex = (event.getAction() & MotionEvent.ACTION_POINTER_INDEX_MASK) - >> MotionEvent.ACTION_POINTER_INDEX_SHIFT; - int pointerId = event.getPointerId(pointerIndex); - Vector2f lastPos = lastPositions.get(pointerId); - - // final int historySize = event.getHistorySize(); - //final int pointerCount = event.getPointerCount(); - switch (action) { - case MotionEvent.ACTION_POINTER_DOWN: - case MotionEvent.ACTION_DOWN: - touch = getNextFreeTouchEvent(); - touch.set(Type.DOWN, event.getX(pointerIndex), view.getHeight() - event.getY(pointerIndex), 0, 0); - touch.setPointerId(pointerId); - touch.setTime(event.getEventTime()); - touch.setPressure(event.getPressure(pointerIndex)); - processEvent(touch); - - lastPos = new Vector2f(event.getX(pointerIndex), view.getHeight() - event.getY(pointerIndex)); - lastPositions.put(pointerId, lastPos); - - bWasHandled = true; - break; - case MotionEvent.ACTION_POINTER_UP: - case MotionEvent.ACTION_CANCEL: - case MotionEvent.ACTION_UP: - touch = getNextFreeTouchEvent(); - touch.set(Type.UP, event.getX(pointerIndex), view.getHeight() - event.getY(pointerIndex), 0, 0); - touch.setPointerId(pointerId); - touch.setTime(event.getEventTime()); - touch.setPressure(event.getPressure(pointerIndex)); - processEvent(touch); - lastPositions.remove(pointerId); - - bWasHandled = true; - break; - case MotionEvent.ACTION_MOVE: - // Convert all pointers into events - for (int p = 0; p < event.getPointerCount(); p++) { - lastPos = lastPositions.get(event.getPointerId(p)); - if (lastPos == null) { - lastPos = new Vector2f(event.getX(p), view.getHeight() - event.getY(p)); - lastPositions.put(event.getPointerId(p), lastPos); - } - - float dX = event.getX(p) - lastPos.x; - float dY = view.getHeight() - event.getY(p) - lastPos.y; - if (dX != 0 || dY != 0) { - touch = getNextFreeTouchEvent(); - touch.set(Type.MOVE, event.getX(p), view.getHeight() - event.getY(p), dX, dY); - touch.setPointerId(event.getPointerId(p)); - touch.setTime(event.getEventTime()); - touch.setPressure(event.getPressure(p)); - touch.setScaleSpanInProgress(scaleInProgress); - processEvent(touch); - lastPos.set(event.getX(p), view.getHeight() - event.getY(p)); - } - } - bWasHandled = true; - break; - case MotionEvent.ACTION_OUTSIDE: - break; - - } - - // Try to detect gestures - this.detector.onTouchEvent(event); - this.scaledetector.onTouchEvent(event); - - return bWasHandled; - } - - /** - * onKey gets called from android thread on key events - */ - public boolean onKey(View view, int keyCode, KeyEvent event) { - if (view != this.view) { - return false; - } - - if (event.getAction() == KeyEvent.ACTION_DOWN) { - TouchEvent evt; - evt = getNextFreeTouchEvent(); - evt.set(TouchEvent.Type.KEY_DOWN); - evt.setKeyCode(keyCode); - evt.setCharacters(event.getCharacters()); - evt.setTime(event.getEventTime()); - - // Send the event - processEvent(evt); - - // Handle all keys ourself except Volume Up/Down - if ((keyCode == KeyEvent.KEYCODE_VOLUME_UP) || (keyCode == KeyEvent.KEYCODE_VOLUME_DOWN)) { - return false; - } else { - return true; - } - } else if (event.getAction() == KeyEvent.ACTION_UP) { - TouchEvent evt; - evt = getNextFreeTouchEvent(); - evt.set(TouchEvent.Type.KEY_UP); - evt.setKeyCode(keyCode); - evt.setCharacters(event.getCharacters()); - evt.setTime(event.getEventTime()); - - // Send the event - processEvent(evt); - - // Handle all keys ourself except Volume Up/Down - if ((keyCode == KeyEvent.KEYCODE_VOLUME_UP) || (keyCode == KeyEvent.KEYCODE_VOLUME_DOWN)) { - return false; - } else { - return true; - } - } else { - return false; - } - } - - public void loadSettings(AppSettings settings) { - mouseEventsEnabled = settings.isEmulateMouse(); - mouseEventsInvertX = settings.isEmulateMouseFlipX(); - mouseEventsInvertY = settings.isEmulateMouseFlipY(); - } - - // ----------------------------------------- - // JME3 Input interface - @Override - public void initialize() { - TouchEvent item; - for (int i = 0; i < MAX_EVENTS; i++) { - item = new TouchEvent(); - eventPool.push(item); - } - isInitialized = true; - } - - @Override - public void destroy() { - isInitialized = false; - - // Clean up queues - while (!eventPool.isEmpty()) { - eventPool.pop(); - } - while (!eventQueue.isEmpty()) { - eventQueue.pop(); - } - - - this.view = null; - } - - @Override - public boolean isInitialized() { - return isInitialized; - } - - @Override - public void setInputListener(RawInputListener listener) { - this.listener = listener; - } - - @Override - public long getInputTimeNanos() { - return System.nanoTime(); - } - // ----------------------------------------- - - private void processEvent(TouchEvent event) { - synchronized (eventQueue) { - //Discarding events when the ring buffer is full to avoid buffer overflow. - if(eventQueue.size()< MAX_EVENTS){ - eventQueue.push(event); - } - - } - } - - // --------------- INSIDE GLThread --------------- - @Override - public void update() { - generateEvents(); - } - - private void generateEvents() { - if (listener != null) { - TouchEvent event; - MouseButtonEvent btn; - MouseMotionEvent mot; - int newX; - int newY; - - while (!eventQueue.isEmpty()) { - synchronized (eventQueue) { - event = eventQueue.pop(); - } - if (event != null) { - listener.onTouchEvent(event); - - if (mouseEventsEnabled) { - if (mouseEventsInvertX) { - newX = view.getWidth() - (int) event.getX(); - } else { - newX = (int) event.getX(); - } - - if (mouseEventsInvertY) { - newY = view.getHeight() - (int) event.getY(); - } else { - newY = (int) event.getY(); - } - - switch (event.getType()) { - case DOWN: - // Handle mouse down event - btn = new MouseButtonEvent(0, true, newX, newY); - btn.setTime(event.getTime()); - listener.onMouseButtonEvent(btn); - // Store current pos - lastX = -1; - lastY = -1; - break; - - case UP: - // Handle mouse up event - btn = new MouseButtonEvent(0, false, newX, newY); - btn.setTime(event.getTime()); - listener.onMouseButtonEvent(btn); - // Store current pos - lastX = -1; - lastY = -1; - break; - - case SCALE_MOVE: - if (lastX != -1 && lastY != -1) { - newX = lastX; - newY = lastY; - } - int wheel = (int) (event.getScaleSpan() / 4f); // scale to match mouse wheel - int dwheel = (int) (event.getDeltaScaleSpan() / 4f); // scale to match mouse wheel - mot = new MouseMotionEvent(newX, newX, 0, 0, wheel, dwheel); - mot.setTime(event.getTime()); - listener.onMouseMotionEvent(mot); - lastX = newX; - lastY = newY; - - break; - - case MOVE: - if (event.isScaleSpanInProgress()) { - break; - } - - int dx; - int dy; - if (lastX != -1) { - dx = newX - lastX; - dy = newY - lastY; - } else { - dx = 0; - dy = 0; - } - - mot = new MouseMotionEvent(newX, newY, dx, dy, (int)event.getScaleSpan(), (int)event.getDeltaScaleSpan()); - mot.setTime(event.getTime()); - listener.onMouseMotionEvent(mot); - lastX = newX; - lastY = newY; - - break; - } - } - } - - if (event.isConsumed() == false) { - synchronized (eventPoolUnConsumed) { - eventPoolUnConsumed.push(event); - } - - } else { - synchronized (eventPool) { - eventPool.push(event); - } - } - } - - } - } - // --------------- ENDOF INSIDE GLThread --------------- - - // --------------- Gesture detected callback events --------------- - public boolean onDown(MotionEvent event) { - return false; - } - - public void onLongPress(MotionEvent event) { - TouchEvent touch = getNextFreeTouchEvent(); - touch.set(Type.LONGPRESSED, event.getX(), view.getHeight() - event.getY(), 0f, 0f); - touch.setPointerId(0); - touch.setTime(event.getEventTime()); - processEvent(touch); - } - - public boolean onFling(MotionEvent event, MotionEvent event2, float vx, float vy) { - TouchEvent touch = getNextFreeTouchEvent(); - touch.set(Type.FLING, event.getX(), view.getHeight() - event.getY(), vx, vy); - touch.setPointerId(0); - touch.setTime(event.getEventTime()); - processEvent(touch); - - return true; - } - - public boolean onSingleTapConfirmed(MotionEvent event) { - //Nothing to do here the tap has already been detected. - return false; - } - - public boolean onDoubleTap(MotionEvent event) { - TouchEvent touch = getNextFreeTouchEvent(); - touch.set(Type.DOUBLETAP, event.getX(), view.getHeight() - event.getY(), 0f, 0f); - touch.setPointerId(0); - touch.setTime(event.getEventTime()); - processEvent(touch); - return true; - } - - public boolean onDoubleTapEvent(MotionEvent event) { - return false; - } - - public boolean onScaleBegin(ScaleGestureDetector scaleGestureDetector) { - scaleInProgress = true; - TouchEvent touch = getNextFreeTouchEvent(); - touch.set(Type.SCALE_START, scaleGestureDetector.getFocusX(), scaleGestureDetector.getFocusY(), 0f, 0f); - touch.setPointerId(0); - touch.setTime(scaleGestureDetector.getEventTime()); - touch.setScaleSpan(scaleGestureDetector.getCurrentSpan()); - touch.setDeltaScaleSpan(scaleGestureDetector.getCurrentSpan() - scaleGestureDetector.getPreviousSpan()); - touch.setScaleFactor(scaleGestureDetector.getScaleFactor()); - touch.setScaleSpanInProgress(scaleInProgress); - processEvent(touch); - // System.out.println("scaleBegin"); - - return true; - } - - public boolean onScale(ScaleGestureDetector scaleGestureDetector) { - TouchEvent touch = getNextFreeTouchEvent(); - touch.set(Type.SCALE_MOVE, scaleGestureDetector.getFocusX(), view.getHeight() - scaleGestureDetector.getFocusY(), 0f, 0f); - touch.setPointerId(0); - touch.setTime(scaleGestureDetector.getEventTime()); - touch.setScaleSpan(scaleGestureDetector.getCurrentSpan()); - touch.setDeltaScaleSpan(scaleGestureDetector.getCurrentSpan() - scaleGestureDetector.getPreviousSpan()); - touch.setScaleFactor(scaleGestureDetector.getScaleFactor()); - touch.setScaleSpanInProgress(scaleInProgress); - processEvent(touch); - // System.out.println("scale"); - - return false; - } - - public void onScaleEnd(ScaleGestureDetector scaleGestureDetector) { - scaleInProgress = false; - TouchEvent touch = getNextFreeTouchEvent(); - touch.set(Type.SCALE_END, scaleGestureDetector.getFocusX(), view.getHeight() - scaleGestureDetector.getFocusY(), 0f, 0f); - touch.setPointerId(0); - touch.setTime(scaleGestureDetector.getEventTime()); - touch.setScaleSpan(scaleGestureDetector.getCurrentSpan()); - touch.setDeltaScaleSpan(scaleGestureDetector.getCurrentSpan() - scaleGestureDetector.getPreviousSpan()); - touch.setScaleFactor(scaleGestureDetector.getScaleFactor()); - touch.setScaleSpanInProgress(scaleInProgress); - processEvent(touch); - } - - public boolean onScroll(MotionEvent e1, MotionEvent e2, float distanceX, float distanceY) { - TouchEvent touch = getNextFreeTouchEvent(); - touch.set(Type.SCROLL, e1.getX(), view.getHeight() - e1.getY(), distanceX, distanceY * (-1)); - touch.setPointerId(0); - touch.setTime(e1.getEventTime()); - processEvent(touch); - //System.out.println("scroll " + e1.getPointerCount()); - return false; - } - - public void onShowPress(MotionEvent event) { - TouchEvent touch = getNextFreeTouchEvent(); - touch.set(Type.SHOWPRESS, event.getX(), view.getHeight() - event.getY(), 0f, 0f); - touch.setPointerId(0); - touch.setTime(event.getEventTime()); - processEvent(touch); - } - - public boolean onSingleTapUp(MotionEvent event) { - TouchEvent touch = getNextFreeTouchEvent(); - touch.set(Type.TAP, event.getX(), view.getHeight() - event.getY(), 0f, 0f); - touch.setPointerId(0); - touch.setTime(event.getEventTime()); - processEvent(touch); - return true; - } - - @Override - public void setSimulateKeyboard(boolean simulate) { - keyboardEventsEnabled = simulate; - } - - @Override - public void setOmitHistoricEvents(boolean dontSendHistory) { - this.dontSendHistory = dontSendHistory; - } - - /** - * @deprecated Use {@link #getSimulateMouse()}; - */ - @Deprecated - public boolean isMouseEventsEnabled() { - return mouseEventsEnabled; - } - - @Deprecated - public void setMouseEventsEnabled(boolean mouseEventsEnabled) { - this.mouseEventsEnabled = mouseEventsEnabled; - } - - public boolean isMouseEventsInvertY() { - return mouseEventsInvertY; - } - - public void setMouseEventsInvertY(boolean mouseEventsInvertY) { - this.mouseEventsInvertY = mouseEventsInvertY; - } - - public boolean isMouseEventsInvertX() { - return mouseEventsInvertX; - } - - public void setMouseEventsInvertX(boolean mouseEventsInvertX) { - this.mouseEventsInvertX = mouseEventsInvertX; - } - - public void setSimulateMouse(boolean simulate) { - mouseEventsEnabled = simulate; - } - - public boolean getSimulateMouse() { - return isSimulateMouse(); - } - - public boolean isSimulateMouse() { - return mouseEventsEnabled; - } - - public boolean isSimulateKeyboard() { - return keyboardEventsEnabled; - } - -} diff --git a/jme3-android/src/main/java/com/jme3/input/android/AndroidInputHandler.java b/jme3-android/src/main/java/com/jme3/input/android/AndroidInputHandler.java index 202907316..9f4729c66 100644 --- a/jme3-android/src/main/java/com/jme3/input/android/AndroidInputHandler.java +++ b/jme3-android/src/main/java/com/jme3/input/android/AndroidInputHandler.java @@ -33,231 +33,206 @@ package com.jme3.input.android; import android.opengl.GLSurfaceView; -import android.os.Build; +import android.view.GestureDetector; +import android.view.InputDevice; +import android.view.KeyEvent; +import android.view.MotionEvent; +import android.view.ScaleGestureDetector; import android.view.View; -import com.jme3.input.RawInputListener; +import com.jme3.input.JoyInput; import com.jme3.input.TouchInput; -import com.jme3.input.event.InputEvent; -import com.jme3.input.event.KeyInputEvent; -import com.jme3.input.event.MouseButtonEvent; -import com.jme3.input.event.MouseMotionEvent; -import com.jme3.input.event.TouchEvent; import com.jme3.system.AppSettings; -import java.util.concurrent.ConcurrentLinkedQueue; import java.util.logging.Level; import java.util.logging.Logger; /** * AndroidInput is the main class that connects the Android system - * inputs to jME. It serves as the manager that gathers inputs from the various - * Android input methods and provides them to jME's InputManager. + * inputs to jME. It receives the inputs from the Android View and passes them + * to the appropriate classes based on the source of the input.
+ * This class is to be extended when new functionality is released in Android. * * @author iwgeric */ -public class AndroidInputHandler implements TouchInput { - private static final Logger logger = Logger.getLogger(AndroidInputHandler.class.getName()); - - // Custom settings - private boolean mouseEventsEnabled = true; - private boolean mouseEventsInvertX = false; - private boolean mouseEventsInvertY = false; - private boolean keyboardEventsEnabled = false; - private boolean dontSendHistory = false; +public class AndroidInputHandler implements View.OnTouchListener, + View.OnKeyListener { + private static final Logger logger = Logger.getLogger(AndroidInputHandler.class.getName()); - // Internal - private GLSurfaceView view; - private AndroidTouchHandler touchHandler; - private AndroidKeyHandler keyHandler; - private AndroidGestureHandler gestureHandler; - private boolean initialized = false; - private RawInputListener listener = null; - private ConcurrentLinkedQueue inputEventQueue = new ConcurrentLinkedQueue(); - private final static int MAX_TOUCH_EVENTS = 1024; - private final TouchEventPool touchEventPool = new TouchEventPool(MAX_TOUCH_EVENTS); - private float scaleX = 1f; - private float scaleY = 1f; + protected GLSurfaceView view; + protected AndroidTouchInput touchInput; + protected AndroidJoyInput joyInput; public AndroidInputHandler() { - int buildVersion = Build.VERSION.SDK_INT; - logger.log(Level.INFO, "Android Build Version: {0}", buildVersion); - if (buildVersion >= 14) { - // add support for onHover and GenericMotionEvent (ie. gamepads) - gestureHandler = new AndroidGestureHandler(this); - touchHandler = new AndroidTouchHandler14(this, gestureHandler); - keyHandler = new AndroidKeyHandler(this); - } else if (buildVersion >= 8){ - gestureHandler = new AndroidGestureHandler(this); - touchHandler = new AndroidTouchHandler(this, gestureHandler); - keyHandler = new AndroidKeyHandler(this); - } - } - - public AndroidInputHandler(AndroidTouchHandler touchInput, - AndroidKeyHandler keyInput, AndroidGestureHandler gestureHandler) { - this.touchHandler = touchInput; - this.keyHandler = keyInput; - this.gestureHandler = gestureHandler; + touchInput = new AndroidTouchInput(this); + joyInput = new AndroidJoyInput(this); } public void setView(View view) { - if (touchHandler != null) { - touchHandler.setView(view); + if (this.view != null && view != null && this.view.equals(view)) { + return; } - if (keyHandler != null) { - keyHandler.setView(view); - } - if (gestureHandler != null) { - gestureHandler.setView(view); + + if (this.view != null) { + removeListeners(this.view); } + this.view = (GLSurfaceView)view; - } - public View getView() { - return view; - } + if (this.view != null) { + addListeners(this.view); + } - public float invertX(float origX) { - return getJmeX(view.getWidth()) - origX; + joyInput.setView((GLSurfaceView)view); } - public float invertY(float origY) { - return getJmeY(view.getHeight()) - origY; + public View getView() { + return view; } - public float getJmeX(float origX) { - return origX * scaleX; + protected void removeListeners(GLSurfaceView view) { + view.setOnTouchListener(null); + view.setOnKeyListener(null); + touchInput.setGestureDetector(null); + touchInput.setScaleDetector(null); } - public float getJmeY(float origY) { - return origY * scaleY; + protected void addListeners(GLSurfaceView view) { + view.setOnTouchListener(this); + view.setOnKeyListener(this); + AndroidGestureProcessor gestureHandler = new AndroidGestureProcessor(touchInput); + touchInput.setGestureDetector(new GestureDetector( + view.getContext(), gestureHandler)); + touchInput.setScaleDetector(new ScaleGestureDetector( + view.getContext(), gestureHandler)); } public void loadSettings(AppSettings settings) { - keyboardEventsEnabled = settings.isEmulateKeyboard(); - mouseEventsEnabled = settings.isEmulateMouse(); - mouseEventsInvertX = settings.isEmulateMouseFlipX(); - mouseEventsInvertY = settings.isEmulateMouseFlipY(); - - // view width and height are 0 until the view is displayed on the screen - if (view.getWidth() != 0 && view.getHeight() != 0) { - scaleX = (float)settings.getWidth() / (float)view.getWidth(); - scaleY = (float)settings.getHeight() / (float)view.getHeight(); - } - logger.log(Level.FINE, "Setting input scaling, scaleX: {0}, scaleY: {1}", - new Object[]{scaleX, scaleY}); + touchInput.loadSettings(settings); + } + + public TouchInput getTouchInput() { + return touchInput; + } + + public JoyInput getJoyInput() { + return joyInput; + } + + /* + * Android input events include the source from which the input came from. + * We must look at the source of the input event to determine which type + * of jME input it belongs to. + * If the input is from a gamepad or joystick source, the event is sent + * to the JoyInput class to convert the event into jME joystick events. + *
+ * If the input is from a touchscreen source, the event is sent to the + * TouchProcessor to convert the event into touch events. + * The TouchProcessor also converts the events into Mouse and Key events + * if AppSettings is set to simulate Mouse or Keyboard events. + * + * Android reports the source as a bitmask as shown below.
+ * + * InputDevice Sources + * 0000 0000 0000 0000 0000 0000 0000 0000 - 32 bit bitmask + * + * 0000 0000 0000 0000 0000 0000 1111 1111 - SOURCE_CLASS_MASK (0x000000ff) + * 0000 0000 0000 0000 0000 0000 0000 0000 - SOURCE_CLASS_NONE (0x00000000) + * 0000 0000 0000 0000 0000 0000 0000 0001 - SOURCE_CLASS_BUTTON (0x00000001) + * 0000 0000 0000 0000 0000 0000 0000 0010 - SOURCE_CLASS_POINTER (0x00000002) + * 0000 0000 0000 0000 0000 0000 0000 0100 - SOURCE_CLASS_TRACKBALL (0x00000004) + * 0000 0000 0000 0000 0000 0000 0000 1000 - SOURCE_CLASS_POSITION (0x00000008) + * 0000 0000 0000 0000 0000 0000 0001 0000 - SOURCE_CLASS_JOYSTICK (0x00000010) + * + * 1111 1111 1111 1111 1111 1111 0000 0000 - Source_Any (0xffffff00) + * 0000 0000 0000 0000 0000 0000 0000 0000 - SOURCE_UNKNOWN (0x00000000) + * 0000 0000 0000 0000 0000 0001 0000 0001 - SOURCE_KEYBOARD (0x00000101) + * 0000 0000 0000 0000 0000 0010 0000 0001 - SOURCE_DPAD (0x00000201) + * 0000 0000 0000 0000 0000 0100 0000 0001 - SOURCE_GAMEPAD (0x00000401) + * 0000 0000 0000 0000 0001 0000 0000 0010 - SOURCE_TOUCHSCREEN (0x00001002) + * 0000 0000 0000 0000 0010 0000 0000 0010 - SOURCE_MOUSE (0x00002002) + * 0000 0000 0000 0000 0100 0000 0000 0010 - SOURCE_STYLUS (0x00004002) + * 0000 0000 0000 0001 0000 0000 0000 0100 - SOURCE_TRACKBALL (0x00010004) + * 0000 0000 0001 0000 0000 0000 0000 1000 - SOURCE_TOUCHPAD (0x00100008) + * 0000 0000 0010 0000 0000 0000 0000 0000 - SOURCE_TOUCH_NAVIGATION (0x00200000) + * 0000 0001 0000 0000 0000 0000 0001 0000 - SOURCE_JOYSTICK (0x01000010) + * 0000 0010 0000 0000 0000 0000 0000 0001 - SOURCE_HDMI (0x02000001) + * + * Example values reported by Android for Source + * 4,098 = 0x00001002 = + * 0000 0000 0000 0000 0001 0000 0000 0010 - SOURCE_CLASS_POINTER + * SOURCE_TOUCHSCREEN + * 1,281 = 0x00000501 = + * 0000 0000 0000 0000 0000 0101 0000 0001 - SOURCE_CLASS_BUTTON + * SOURCE_KEYBOARD + * SOURCE_GAMEPAD + * 16,777,232 = 0x01000010 = + * 0000 0001 0000 0000 0000 0000 0001 0000 - SOURCE_CLASS_JOYSTICK + * SOURCE_JOYSTICK + * + * 16,778,513 = 0x01000511 = + * 0000 0001 0000 0000 0000 0101 0001 0001 - SOURCE_CLASS_BUTTON + * SOURCE_CLASS_JOYSTICK + * SOURCE_GAMEPAD + * SOURCE_KEYBOARD + * SOURCE_JOYSTICK + * + * 257 = 0x00000101 = + * 0000 0000 0000 0000 0000 0001 0000 0001 - SOURCE_CLASS_BUTTON + * SOURCE_KEYBOARD + * + * + * + */ - } - // ----------------------------------------- - // JME3 Input interface @Override - public void initialize() { - touchEventPool.initialize(); - if (touchHandler != null) { - touchHandler.initialize(); - } - if (keyHandler != null) { - keyHandler.initialize(); - } - if (gestureHandler != null) { - gestureHandler.initialize(); + public boolean onTouch(View view, MotionEvent event) { + if (view != getView()) { + return false; } - initialized = true; - } + boolean consumed = false; - @Override - public void destroy() { - initialized = false; + int source = event.getSource(); +// logger.log(Level.INFO, "onTouch source: {0}", source); - touchEventPool.destroy(); - if (touchHandler != null) { - touchHandler.destroy(); - } - if (keyHandler != null) { - keyHandler.destroy(); - } - if (gestureHandler != null) { - gestureHandler.destroy(); - } - - setView(null); - } - - @Override - public boolean isInitialized() { - return initialized; - } - - @Override - public void setInputListener(RawInputListener listener) { - this.listener = listener; - } - - @Override - public long getInputTimeNanos() { - return System.nanoTime(); - } + boolean isTouch = ((source & InputDevice.SOURCE_TOUCHSCREEN) == InputDevice.SOURCE_TOUCHSCREEN); +// logger.log(Level.INFO, "onTouch source: {0}, isTouch: {1}", +// new Object[]{source, isTouch}); - public void update() { - if (listener != null) { - InputEvent inputEvent; - - while ((inputEvent = inputEventQueue.poll()) != null) { - if (inputEvent instanceof TouchEvent) { - listener.onTouchEvent((TouchEvent)inputEvent); - } else if (inputEvent instanceof MouseButtonEvent) { - listener.onMouseButtonEvent((MouseButtonEvent)inputEvent); - } else if (inputEvent instanceof MouseMotionEvent) { - listener.onMouseMotionEvent((MouseMotionEvent)inputEvent); - } else if (inputEvent instanceof KeyInputEvent) { - listener.onKeyEvent((KeyInputEvent)inputEvent); - } - } + if (isTouch && touchInput != null) { + // send the event to the touch processor + consumed = touchInput.onTouch(event); } - } - // ----------------------------------------- + return consumed; - public TouchEvent getFreeTouchEvent() { - return touchEventPool.getNextFreeEvent(); } - public void addEvent(InputEvent event) { - inputEventQueue.add(event); - if (event instanceof TouchEvent) { - touchEventPool.storeEvent((TouchEvent)event); + @Override + public boolean onKey(View view, int keyCode, KeyEvent event) { + if (view != getView()) { + return false; } - } - public void setSimulateMouse(boolean simulate) { - this.mouseEventsEnabled = simulate; - } + boolean consumed = false; - public boolean isSimulateMouse() { - return mouseEventsEnabled; - } + int source = event.getSource(); +// logger.log(Level.INFO, "onKey source: {0}", source); - public boolean isMouseEventsInvertX() { - return mouseEventsInvertX; - } + boolean isTouch = + ((source & InputDevice.SOURCE_TOUCHSCREEN) == InputDevice.SOURCE_TOUCHSCREEN) || + ((source & InputDevice.SOURCE_KEYBOARD) == InputDevice.SOURCE_KEYBOARD); +// logger.log(Level.INFO, "onKey source: {0}, isTouch: {1}", +// new Object[]{source, isTouch}); - public boolean isMouseEventsInvertY() { - return mouseEventsInvertY; - } - - public void setSimulateKeyboard(boolean simulate) { - this.keyboardEventsEnabled = simulate; - } + if (touchInput != null) { + consumed = touchInput.onKey(event); + } - public boolean isSimulateKeyboard() { - return keyboardEventsEnabled; - } + return consumed; - public void setOmitHistoricEvents(boolean dontSendHistory) { - this.dontSendHistory = dontSendHistory; } } diff --git a/jme3-android/src/main/java/com/jme3/input/android/AndroidInputHandler14.java b/jme3-android/src/main/java/com/jme3/input/android/AndroidInputHandler14.java new file mode 100644 index 000000000..114bb98fd --- /dev/null +++ b/jme3-android/src/main/java/com/jme3/input/android/AndroidInputHandler14.java @@ -0,0 +1,158 @@ +/* + * Copyright (c) 2009-2012 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ + +package com.jme3.input.android; + +import android.opengl.GLSurfaceView; +import android.view.InputDevice; +import android.view.KeyEvent; +import android.view.MotionEvent; +import android.view.View; +import java.util.logging.Level; +import java.util.logging.Logger; + +/** + * AndroidInputHandler14 extends AndroidInputHandler to + * add the onHover and onGenericMotion events that where added in Android rev 14 (Android 4.0).
+ * The onGenericMotion events are the main interface to Joystick axes. They + * were actually released in Android rev 12. + * + * @author iwgeric + */ +public class AndroidInputHandler14 extends AndroidInputHandler implements View.OnHoverListener, + View.OnGenericMotionListener { + + private static final Logger logger = Logger.getLogger(AndroidInputHandler14.class.getName()); + + public AndroidInputHandler14() { + touchInput = new AndroidTouchInput14(this); + joyInput = new AndroidJoyInput14(this); + } + + @Override + protected void removeListeners(GLSurfaceView view) { + super.removeListeners(view); + view.setOnHoverListener(null); + view.setOnGenericMotionListener(null); + } + + @Override + protected void addListeners(GLSurfaceView view) { + super.addListeners(view); + view.setOnHoverListener(this); + view.setOnGenericMotionListener(this); + } + + @Override + public boolean onHover(View view, MotionEvent event) { + if (view != getView()) { + return false; + } + + boolean consumed = false; + + int source = event.getSource(); +// logger.log(Level.INFO, "onTouch source: {0}", source); + + boolean isTouch = ((source & InputDevice.SOURCE_TOUCHSCREEN) == InputDevice.SOURCE_TOUCHSCREEN); +// logger.log(Level.INFO, "onTouch source: {0}, isTouch: {1}", +// new Object[]{source, isTouch}); + + if (isTouch && touchInput != null) { + // send the event to the touch processor + consumed = ((AndroidTouchInput14)touchInput).onHover(event); + } + + return consumed; + } + + @Override + public boolean onGenericMotion(View view, MotionEvent event) { + if (view != getView()) { + return false; + } + + boolean consumed = false; + + int source = event.getSource(); +// logger.log(Level.INFO, "onGenericMotion source: {0}", source); + + boolean isJoystick = + ((source & InputDevice.SOURCE_GAMEPAD) == InputDevice.SOURCE_GAMEPAD) || + ((source & InputDevice.SOURCE_JOYSTICK) == InputDevice.SOURCE_JOYSTICK); + + if (isJoystick && joyInput != null) { +// logger.log(Level.INFO, "onGenericMotion source: {0}, isJoystick: {1}", +// new Object[]{source, isJoystick}); + // send the event to the touch processor + consumed = consumed || ((AndroidJoyInput14)joyInput).onGenericMotion(event); + } + + return consumed; + } + + @Override + public boolean onKey(View view, int keyCode, KeyEvent event) { + if (view != getView()) { + return false; + } + + boolean consumed = false; + +// logger.log(Level.INFO, "onKey keyCode: {0}, action: {1}, event: {2}", +// new Object[]{KeyEvent.keyCodeToString(keyCode), event.getAction(), event}); + int source = event.getSource(); +// logger.log(Level.INFO, "onKey source: {0}", source); + + boolean isTouch = + ((source & InputDevice.SOURCE_TOUCHSCREEN) == InputDevice.SOURCE_TOUCHSCREEN) || + ((source & InputDevice.SOURCE_KEYBOARD) == InputDevice.SOURCE_KEYBOARD); + boolean isJoystick = + ((source & InputDevice.SOURCE_GAMEPAD) == InputDevice.SOURCE_GAMEPAD) || + ((source & InputDevice.SOURCE_JOYSTICK) == InputDevice.SOURCE_JOYSTICK); + + if (isTouch && touchInput != null) { +// logger.log(Level.INFO, "onKey source: {0}, isTouch: {1}", +// new Object[]{source, isTouch}); + consumed = touchInput.onKey(event); + } + if (isJoystick && joyInput != null) { +// logger.log(Level.INFO, "onKey source: {0}, isJoystick: {1}", +// new Object[]{source, isJoystick}); + consumed = consumed || ((AndroidJoyInput14)joyInput).onKey(event); + } + + return consumed; + + } + +} diff --git a/jme3-android/src/main/java/com/jme3/input/android/AndroidJoyInputHandler.java b/jme3-android/src/main/java/com/jme3/input/android/AndroidJoyInput.java similarity index 84% rename from jme3-android/src/main/java/com/jme3/input/android/AndroidJoyInputHandler.java rename to jme3-android/src/main/java/com/jme3/input/android/AndroidJoyInput.java index 2c3a1d74e..e31504520 100644 --- a/jme3-android/src/main/java/com/jme3/input/android/AndroidJoyInputHandler.java +++ b/jme3-android/src/main/java/com/jme3/input/android/AndroidJoyInput.java @@ -33,9 +33,7 @@ package com.jme3.input.android; import android.content.Context; import android.opengl.GLSurfaceView; -import android.os.Build; import android.os.Vibrator; -import android.view.View; import com.jme3.input.InputManager; import com.jme3.input.JoyInput; import com.jme3.input.Joystick; @@ -79,15 +77,15 @@ import java.util.logging.Logger; * * @author iwgeric */ -public class AndroidJoyInputHandler implements JoyInput { - private static final Logger logger = Logger.getLogger(AndroidJoyInputHandler.class.getName()); +public class AndroidJoyInput implements JoyInput { + private static final Logger logger = Logger.getLogger(AndroidJoyInput.class.getName()); - private List joystickList = new ArrayList(); + protected AndroidInputHandler inputHandler; + protected List joystickList = new ArrayList(); // private boolean dontSendHistory = false; // Internal - private GLSurfaceView view; private boolean initialized = false; private RawInputListener listener = null; private ConcurrentLinkedQueue eventQueue = new ConcurrentLinkedQueue(); @@ -96,34 +94,29 @@ public class AndroidJoyInputHandler implements JoyInput { private boolean vibratorActive = false; private long maxRumbleTime = 250; // 250ms - public AndroidJoyInputHandler() { - int buildVersion = Build.VERSION.SDK_INT; - logger.log(Level.INFO, "Android Build Version: {0}", buildVersion); -// if (buildVersion >= 14) { -// touchHandler = new AndroidTouchHandler14(this); -// } else if (buildVersion >= 8){ -// touchHandler = new AndroidTouchHandler(this); -// } + public AndroidJoyInput(AndroidInputHandler inputHandler) { + this.inputHandler = inputHandler; sensorJoyInput = new AndroidSensorJoyInput(this); } public void setView(GLSurfaceView view) { -// if (touchHandler != null) { -// touchHandler.setView(view); -// } + if (view == null) { + vibrator = null; + } else { + // Get instance of Vibrator from current Context + vibrator = (Vibrator) view.getContext().getSystemService(Context.VIBRATOR_SERVICE); + if (vibrator == null) { + logger.log(Level.FINE, "Vibrator Service not found."); + } + } + if (sensorJoyInput != null) { sensorJoyInput.setView(view); } - this.view = (GLSurfaceView)view; - - } - - public View getView() { - return view; } public void loadSettings(AppSettings settings) { -// sensorEventsEnabled = settings.useSensors(); + } public void addEvent(InputEvent event) { @@ -155,20 +148,8 @@ public class AndroidJoyInputHandler implements JoyInput { } - - - - @Override public void initialize() { -// if (sensorJoyInput != null) { -// sensorJoyInput.initialize(); -// } - // Get instance of Vibrator from current Context - vibrator = (Vibrator) view.getContext().getSystemService(Context.VIBRATOR_SERVICE); - if (vibrator == null) { - logger.log(Level.FINE, "Vibrator Service not found."); - } initialized = true; } @@ -211,8 +192,8 @@ public class AndroidJoyInputHandler implements JoyInput { }; final int rumbleRepeatFrom = 0; // index into rumble pattern to repeat from - logger.log(Level.FINE, "Rumble amount: {0}, rumbleOnDur: {1}, rumbleOffDur: {2}", - new Object[]{amount, rumbleOnDur, rumbleOffDur}); +// logger.log(Level.FINE, "Rumble amount: {0}, rumbleOnDur: {1}, rumbleOffDur: {2}", +// new Object[]{amount, rumbleOnDur, rumbleOffDur}); if (rumbleOnDur > 0) { vibrator.vibrate(rumblePattern, rumbleRepeatFrom); @@ -226,9 +207,8 @@ public class AndroidJoyInputHandler implements JoyInput { @Override public Joystick[] loadJoysticks(InputManager inputManager) { + logger.log(Level.INFO, "loading joysticks for {0}", this.getClass().getName()); joystickList.add(sensorJoyInput.loadJoystick(joystickList.size(), inputManager)); - - return joystickList.toArray( new Joystick[joystickList.size()] ); } @@ -252,6 +232,4 @@ public class AndroidJoyInputHandler implements JoyInput { } - - } diff --git a/jme3-android/src/main/java/com/jme3/input/android/AndroidJoyInput14.java b/jme3-android/src/main/java/com/jme3/input/android/AndroidJoyInput14.java new file mode 100644 index 000000000..00478aea1 --- /dev/null +++ b/jme3-android/src/main/java/com/jme3/input/android/AndroidJoyInput14.java @@ -0,0 +1,108 @@ +/* + * Copyright (c) 2009-2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ +package com.jme3.input.android; + +import android.view.KeyEvent; +import android.view.MotionEvent; +import com.jme3.input.InputManager; +import com.jme3.input.Joystick; +import java.util.logging.Logger; + +/** + * AndroidJoyInput14 extends AndroidJoyInput + * to include support for physical joysticks/gamepads.
+ * + * @author iwgeric + */ +public class AndroidJoyInput14 extends AndroidJoyInput { + private static final Logger logger = Logger.getLogger(AndroidJoyInput14.class.getName()); + + private AndroidJoystickJoyInput14 joystickJoyInput; + + public AndroidJoyInput14(AndroidInputHandler inputHandler) { + super(inputHandler); + joystickJoyInput = new AndroidJoystickJoyInput14(this); + } + + /** + * Pauses the joystick device listeners to save battery life if they are not needed. + * Used to pause when the activity pauses + */ + @Override + public void pauseJoysticks() { + super.pauseJoysticks(); + + if (joystickJoyInput != null) { + joystickJoyInput.pauseJoysticks(); + } + } + + /** + * Resumes the joystick device listeners. + * Used to resume when the activity comes to the top of the stack + */ + @Override + public void resumeJoysticks() { + super.resumeJoysticks(); + if (joystickJoyInput != null) { + joystickJoyInput.resumeJoysticks(); + } + + } + + @Override + public void destroy() { + super.destroy(); + if (joystickJoyInput != null) { + joystickJoyInput.destroy(); + } + } + + @Override + public Joystick[] loadJoysticks(InputManager inputManager) { + // load the simulated joystick for device orientation + super.loadJoysticks(inputManager); + // load physical gamepads/joysticks + joystickList.addAll(joystickJoyInput.loadJoysticks(joystickList.size(), inputManager)); + // return the list of joysticks back to InputManager + return joystickList.toArray( new Joystick[joystickList.size()] ); + } + + public boolean onGenericMotion(MotionEvent event) { + return joystickJoyInput.onGenericMotion(event); + } + + public boolean onKey(KeyEvent event) { + return joystickJoyInput.onKey(event); + } + +} diff --git a/jme3-android/src/main/java/com/jme3/input/android/AndroidJoystickJoyInput14.java b/jme3-android/src/main/java/com/jme3/input/android/AndroidJoystickJoyInput14.java new file mode 100644 index 000000000..370db4f10 --- /dev/null +++ b/jme3-android/src/main/java/com/jme3/input/android/AndroidJoystickJoyInput14.java @@ -0,0 +1,403 @@ +/* + * Copyright (c) 2009-2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ +package com.jme3.input.android; + +import android.view.InputDevice; +import android.view.InputDevice.MotionRange; +import android.view.KeyCharacterMap; +import android.view.KeyEvent; +import android.view.MotionEvent; +import com.jme3.input.AbstractJoystick; +import com.jme3.input.DefaultJoystickAxis; +import com.jme3.input.DefaultJoystickButton; +import com.jme3.input.InputManager; +import com.jme3.input.JoyInput; +import com.jme3.input.Joystick; +import com.jme3.input.JoystickAxis; +import com.jme3.input.JoystickButton; +import com.jme3.input.event.JoyAxisEvent; +import com.jme3.input.event.JoyButtonEvent; +import java.util.ArrayList; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.Set; +import java.util.logging.Level; +import java.util.logging.Logger; + +/** + * Main class that creates and manages Android inputs for physical gamepads/joysticks. + * + * @author iwgeric + */ +public class AndroidJoystickJoyInput14 { + private static final Logger logger = Logger.getLogger(AndroidJoystickJoyInput14.class.getName()); + + private boolean loaded = false; + private AndroidJoyInput joyInput; + private Map joystickIndex = new HashMap(); + + private static int[] AndroidGamepadButtons = { + // Dpad buttons + KeyEvent.KEYCODE_DPAD_UP, KeyEvent.KEYCODE_DPAD_DOWN, + KeyEvent.KEYCODE_DPAD_LEFT, KeyEvent.KEYCODE_DPAD_RIGHT, + KeyEvent.KEYCODE_DPAD_CENTER, + + // pressing joystick down + KeyEvent.KEYCODE_BUTTON_THUMBL, KeyEvent.KEYCODE_BUTTON_THUMBR, + + // buttons + KeyEvent.KEYCODE_BUTTON_A, KeyEvent.KEYCODE_BUTTON_B, + KeyEvent.KEYCODE_BUTTON_X, KeyEvent.KEYCODE_BUTTON_Y, + + // buttons on back of device + KeyEvent.KEYCODE_BUTTON_L1, KeyEvent.KEYCODE_BUTTON_R1, + KeyEvent.KEYCODE_BUTTON_L2, KeyEvent.KEYCODE_BUTTON_R2, + + // start / select buttons + KeyEvent.KEYCODE_BUTTON_START, KeyEvent.KEYCODE_BUTTON_SELECT, + KeyEvent.KEYCODE_BUTTON_MODE, + + }; + + public AndroidJoystickJoyInput14(AndroidJoyInput joyInput) { + this.joyInput = joyInput; + } + + + public void pauseJoysticks() { + + } + + public void resumeJoysticks() { + + } + + public void destroy() { + + } + + public List loadJoysticks(int joyId, InputManager inputManager) { + logger.log(Level.INFO, "loading Joystick devices"); + ArrayList joysticks = new ArrayList(); + joysticks.clear(); + joystickIndex.clear(); + + ArrayList gameControllerDeviceIds = new ArrayList(); + int[] deviceIds = InputDevice.getDeviceIds(); + for (int deviceId : deviceIds) { + InputDevice dev = InputDevice.getDevice(deviceId); + int sources = dev.getSources(); + logger.log(Level.FINE, "deviceId[{0}] sources: {1}", new Object[]{deviceId, sources}); + + // Verify that the device has gamepad buttons, control sticks, or both. + if (((sources & InputDevice.SOURCE_GAMEPAD) == InputDevice.SOURCE_GAMEPAD) || + ((sources & InputDevice.SOURCE_JOYSTICK) == InputDevice.SOURCE_JOYSTICK)) { + // This device is a game controller. Store its device ID. + if (!gameControllerDeviceIds.contains(deviceId)) { + gameControllerDeviceIds.add(deviceId); + logger.log(Level.FINE, "Attempting to create joystick for device: {0}", dev); + // Create an AndroidJoystick and store the InputDevice so we + // can later correspond the input from the InputDevice to the + // appropriate jME Joystick event + AndroidJoystick joystick = new AndroidJoystick(inputManager, + joyInput, + dev, + joyId+joysticks.size(), + dev.getName()); + joystickIndex.put(deviceId, joystick); + joysticks.add(joystick); + + // Each analog input is reported as a MotionRange + // The axis number corresponds to the type of axis + // The AndroidJoystick.addAxis(MotionRange) converts the axis + // type reported by Android into the jME Joystick axis + List motionRanges = dev.getMotionRanges(); + for (MotionRange motionRange: motionRanges) { + logger.log(Level.INFO, "motion range: {0}", motionRange.toString()); + logger.log(Level.INFO, "axis: {0}", motionRange.getAxis()); + JoystickAxis axis = joystick.addAxis(motionRange); + logger.log(Level.INFO, "added axis: {0}", axis); + } + + // InputDevice has a method for determining if a keyCode is + // supported (InputDevice public boolean[] hasKeys (int... keys)). + // But this method wasn't added until rev 19 (Android 4.4) + // Therefore, we only can query the entire device and see if + // any InputDevice supports the keyCode. This may result in + // buttons being configured that don't exist on the specific + // device, but I haven't found a better way yet. + for (int keyCode: AndroidGamepadButtons) { + logger.log(Level.INFO, "button[{0}]: {1}", + new Object[]{keyCode, KeyCharacterMap.deviceHasKey(keyCode)}); + if (KeyCharacterMap.deviceHasKey(keyCode)) { + // add button even though we aren't sure if the button + // actually exists on this InputDevice + logger.log(Level.INFO, "button[{0}] exists somewhere", keyCode); + JoystickButton button = joystick.addButton(keyCode); + logger.log(Level.INFO, "added button: {0}", button); + } + } + + } + } + } + + + loaded = true; + return joysticks; + } + + public boolean onGenericMotion(MotionEvent event) { + boolean consumed = false; +// logger.log(Level.INFO, "onGenericMotion event: {0}", event); + event.getDeviceId(); + event.getSource(); +// logger.log(Level.INFO, "deviceId: {0}, source: {1}", new Object[]{event.getDeviceId(), event.getSource()}); + AndroidJoystick joystick = joystickIndex.get(event.getDeviceId()); + if (joystick != null) { + for (int androidAxis: joystick.getAndroidAxes()) { + String axisName = MotionEvent.axisToString(androidAxis); + float value = event.getAxisValue(androidAxis); + int action = event.getAction(); + if (action == MotionEvent.ACTION_MOVE) { +// logger.log(Level.INFO, "MOVE axis num: {0}, axisName: {1}, value: {2}", +// new Object[]{androidAxis, axisName, value}); + JoystickAxis axis = joystick.getAxis(androidAxis); + if (axis != null) { +// logger.log(Level.INFO, "MOVE axis num: {0}, axisName: {1}, value: {2}, deadzone: {3}", +// new Object[]{androidAxis, axisName, value, axis.getDeadZone()}); + JoyAxisEvent axisEvent = new JoyAxisEvent(axis, value); + joyInput.addEvent(axisEvent); + consumed = true; + } else { +// logger.log(Level.INFO, "axis was null for axisName: {0}", axisName); + } + } else { +// logger.log(Level.INFO, "action: {0}", action); + } + } + } + + return consumed; + } + + public boolean onKey(KeyEvent event) { + boolean consumed = false; +// logger.log(Level.INFO, "onKey event: {0}", event); + + event.getDeviceId(); + event.getSource(); + AndroidJoystick joystick = joystickIndex.get(event.getDeviceId()); + if (joystick != null) { + JoystickButton button = joystick.getButton(event.getKeyCode()); + if (button != null) { + boolean pressed = event.getAction() == KeyEvent.ACTION_DOWN; + JoyButtonEvent buttonEvent = new JoyButtonEvent(button, pressed); + joyInput.addEvent(buttonEvent); + consumed = true; + } + } + + return consumed; + } + + protected class AndroidJoystick extends AbstractJoystick { + + private JoystickAxis nullAxis; + private InputDevice device; + private JoystickAxis xAxis; + private JoystickAxis yAxis; + private JoystickAxis povX; + private JoystickAxis povY; + private Map axisIndex = new HashMap(); + private Map buttonIndex = new HashMap(); + + public AndroidJoystick( InputManager inputManager, JoyInput joyInput, InputDevice device, + int joyId, String name ) { + super( inputManager, joyInput, joyId, name ); + + this.device = device; + + this.nullAxis = new DefaultJoystickAxis( getInputManager(), this, -1, + "Null", "null", false, false, 0 ); + this.xAxis = nullAxis; + this.yAxis = nullAxis; + this.povX = nullAxis; + this.povY = nullAxis; + } + + protected JoystickAxis getAxis(int androidAxis) { + return axisIndex.get(androidAxis); + } + + protected Set getAndroidAxes() { + return axisIndex.keySet(); + } + + protected JoystickButton getButton(int keyCode) { + return buttonIndex.get(keyCode); + } + + protected JoystickButton addButton( int keyCode ) { + +// logger.log(Level.FINE, "Adding button: {0}", keyCode); + + String name = KeyEvent.keyCodeToString(keyCode); + String logicalId = KeyEvent.keyCodeToString(keyCode); + // A/B/X/Y buttons + if (keyCode == KeyEvent.KEYCODE_BUTTON_Y) { + logicalId = JoystickButton.BUTTON_0; + } else if (keyCode == KeyEvent.KEYCODE_BUTTON_A) { + logicalId = JoystickButton.BUTTON_2; + } else if (keyCode == KeyEvent.KEYCODE_BUTTON_B) { + logicalId = JoystickButton.BUTTON_1; + } else if (keyCode == KeyEvent.KEYCODE_BUTTON_X) { + logicalId = JoystickButton.BUTTON_3; + // Front buttons Some of these have the top ones and the bottoms ones flipped. + } else if (keyCode == KeyEvent.KEYCODE_BUTTON_L1) { + logicalId = JoystickButton.BUTTON_4; + } else if (keyCode == KeyEvent.KEYCODE_BUTTON_R1) { + logicalId = JoystickButton.BUTTON_5; + } else if (keyCode == KeyEvent.KEYCODE_BUTTON_L2) { + logicalId = JoystickButton.BUTTON_6; + } else if (keyCode == KeyEvent.KEYCODE_BUTTON_R2) { + logicalId = JoystickButton.BUTTON_7; +// // Dpad buttons +// } else if (keyCode == KeyEvent.KEYCODE_DPAD_UP) { +// logicalId = JoystickButton.BUTTON_8; +// } else if (keyCode == KeyEvent.KEYCODE_DPAD_UP) { +// logicalId = JoystickButton.BUTTON_9; +// } else if (keyCode == KeyEvent.KEYCODE_DPAD_UP) { +// logicalId = JoystickButton.BUTTON_8; +// } else if (keyCode == KeyEvent.KEYCODE_DPAD_UP) { +// logicalId = JoystickButton.BUTTON_9; + // Select and start buttons + } else if (keyCode == KeyEvent.KEYCODE_BUTTON_SELECT) { + logicalId = JoystickButton.BUTTON_8; + } else if (keyCode == KeyEvent.KEYCODE_BUTTON_START) { + logicalId = JoystickButton.BUTTON_9; + // Joystick push buttons + } else if (keyCode == KeyEvent.KEYCODE_BUTTON_THUMBL) { + logicalId = JoystickButton.BUTTON_10; + } else if (keyCode == KeyEvent.KEYCODE_BUTTON_THUMBR) { + logicalId = JoystickButton.BUTTON_11; + } + + JoystickButton button = new DefaultJoystickButton( getInputManager(), this, getButtonCount(), + name, logicalId ); + addButton(button); + buttonIndex.put( keyCode, button ); + return button; + } + + protected JoystickAxis addAxis(MotionRange motionRange) { + + String name = MotionEvent.axisToString(motionRange.getAxis()); + + String logicalId = MotionEvent.axisToString(motionRange.getAxis()); + if (motionRange.getAxis() == MotionEvent.AXIS_X) { + logicalId = JoystickAxis.X_AXIS; + } else if (motionRange.getAxis() == MotionEvent.AXIS_Y) { + logicalId = JoystickAxis.Y_AXIS; + } else if (motionRange.getAxis() == MotionEvent.AXIS_Z) { + logicalId = JoystickAxis.Z_AXIS; + } else if (motionRange.getAxis() == MotionEvent.AXIS_RZ) { + logicalId = JoystickAxis.Z_ROTATION; + } else if (motionRange.getAxis() == MotionEvent.AXIS_HAT_X) { + logicalId = JoystickAxis.POV_X; + } else if (motionRange.getAxis() == MotionEvent.AXIS_HAT_Y) { + logicalId = JoystickAxis.POV_Y; + } +// String logicalId = JoystickCompatibilityMappings.remapComponent( controller.getName(), original ); +// if( name != original ) { +// logger.log(Level.FINE, "Remapped:" + original + " to:" + logicalId); +// } + + JoystickAxis axis = new DefaultJoystickAxis(getInputManager(), + this, + getAxisCount(), + name, + logicalId, + true, + true, + motionRange.getFlat()); + + if (motionRange.getAxis() == MotionEvent.AXIS_X) { + xAxis = axis; + } + if (motionRange.getAxis() == MotionEvent.AXIS_Y) { + yAxis = axis; + } + if (motionRange.getAxis() == MotionEvent.AXIS_HAT_X) { + povX = axis; + } + if (motionRange.getAxis() == MotionEvent.AXIS_HAT_Y) { + povY = axis; + } + + addAxis(axis); + axisIndex.put(motionRange.getAxis(), axis); + return axis; + } + + @Override + public JoystickAxis getXAxis() { + return xAxis; + } + + @Override + public JoystickAxis getYAxis() { + return yAxis; + } + + @Override + public JoystickAxis getPovXAxis() { + return povX; + } + + @Override + public JoystickAxis getPovYAxis() { + return povY; + } + + @Override + public int getXAxisIndex(){ + return xAxis.getAxisId(); + } + + @Override + public int getYAxisIndex(){ + return yAxis.getAxisId(); + } + } +} diff --git a/jme3-android/src/main/java/com/jme3/input/android/AndroidKeyHandler.java b/jme3-android/src/main/java/com/jme3/input/android/AndroidKeyHandler.java deleted file mode 100644 index 997974c31..000000000 --- a/jme3-android/src/main/java/com/jme3/input/android/AndroidKeyHandler.java +++ /dev/null @@ -1,140 +0,0 @@ -/* - * Copyright (c) 2009-2012 jMonkeyEngine - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions are - * met: - * - * * Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * * Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in the - * documentation and/or other materials provided with the distribution. - * - * * Neither the name of 'jMonkeyEngine' nor the names of its contributors - * may be used to endorse or promote products derived from this software - * without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED - * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR - * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR - * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, - * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, - * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR - * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF - * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING - * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS - * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. - */ - -package com.jme3.input.android; - -import android.content.Context; -import android.view.KeyEvent; -import android.view.View; -import android.view.inputmethod.InputMethodManager; -import com.jme3.input.event.KeyInputEvent; -import com.jme3.input.event.TouchEvent; -import java.util.logging.Logger; - -/** - * AndroidKeyHandler recieves onKey events from the Android system and creates - * the jME KeyEvents. onKey is used by Android to receive keys from the keyboard - * or device buttons. All key events are consumed by jME except for the Volume - * buttons and menu button. - * - * This class also provides the functionality to display or hide the soft keyboard - * for inputing single key events. Use OGLESContext to display an dialog to type - * in complete strings. - * - * @author iwgeric - */ -public class AndroidKeyHandler implements View.OnKeyListener { - private static final Logger logger = Logger.getLogger(AndroidKeyHandler.class.getName()); - - private AndroidInputHandler androidInput; - private boolean sendKeyEvents = true; - - public AndroidKeyHandler(AndroidInputHandler androidInput) { - this.androidInput = androidInput; - } - - public void initialize() { - } - - public void destroy() { - } - - public void setView(View view) { - if (view != null) { - view.setOnKeyListener(this); - } else { - androidInput.getView().setOnKeyListener(null); - } - } - - /** - * onKey gets called from android thread on key events - */ - public boolean onKey(View view, int keyCode, KeyEvent event) { - if (androidInput.isInitialized() && view != androidInput.getView()) { - return false; - } - - TouchEvent evt; - // TODO: get touch event from pool - if (event.getAction() == KeyEvent.ACTION_DOWN) { - evt = new TouchEvent(); - evt.set(TouchEvent.Type.KEY_DOWN); - evt.setKeyCode(keyCode); - evt.setCharacters(event.getCharacters()); - evt.setTime(event.getEventTime()); - - // Send the event - androidInput.addEvent(evt); - - } else if (event.getAction() == KeyEvent.ACTION_UP) { - evt = new TouchEvent(); - evt.set(TouchEvent.Type.KEY_UP); - evt.setKeyCode(keyCode); - evt.setCharacters(event.getCharacters()); - evt.setTime(event.getEventTime()); - - // Send the event - androidInput.addEvent(evt); - - } - - if (androidInput.isSimulateKeyboard()) { - KeyInputEvent kie; - char unicodeChar = (char)event.getUnicodeChar(); - int jmeKeyCode = AndroidKeyMapping.getJmeKey(keyCode); - - boolean pressed = event.getAction() == KeyEvent.ACTION_DOWN; - boolean repeating = pressed && event.getRepeatCount() > 0; - - kie = new KeyInputEvent(jmeKeyCode, unicodeChar, pressed, repeating); - kie.setTime(event.getEventTime()); - androidInput.addEvent(kie); -// logger.log(Level.FINE, "onKey keyCode: {0}, jmeKeyCode: {1}, pressed: {2}, repeating: {3}", -// new Object[]{keyCode, jmeKeyCode, pressed, repeating}); -// logger.log(Level.FINE, "creating KeyInputEvent: {0}", kie); - } - - // consume all keys ourself except Volume Up/Down and Menu - // Don't do Menu so that typical Android Menus can be created and used - // by the user in MainActivity - if ((keyCode == KeyEvent.KEYCODE_VOLUME_UP) || - (keyCode == KeyEvent.KEYCODE_VOLUME_DOWN) || - (keyCode == KeyEvent.KEYCODE_MENU)) { - return false; - } else { - return true; - } - - } - -} diff --git a/jme3-android/src/main/java/com/jme3/input/android/AndroidKeyMapping.java b/jme3-android/src/main/java/com/jme3/input/android/AndroidKeyMapping.java index e99d8e9fc..32d1e0008 100644 --- a/jme3-android/src/main/java/com/jme3/input/android/AndroidKeyMapping.java +++ b/jme3-android/src/main/java/com/jme3/input/android/AndroidKeyMapping.java @@ -37,13 +37,14 @@ import java.util.logging.Logger; /** * AndroidKeyMapping is just a utility to convert the Android keyCodes into - * jME KeyCodes received in jME's KeyEvent will match between Desktop and Android. - * + * jME KeyCodes so that events received in jME's KeyEvent will match between + * Desktop and Android. + * * @author iwgeric */ public class AndroidKeyMapping { private static final Logger logger = Logger.getLogger(AndroidKeyMapping.class.getName()); - + private static final int[] ANDROID_TO_JME = { 0x0, // unknown 0x0, // key code soft left @@ -141,9 +142,13 @@ public class AndroidKeyMapping { 0x0,//media fastforward 0x0,//mute }; - + public static int getJmeKey(int androidKey) { - return ANDROID_TO_JME[androidKey]; + if (androidKey > ANDROID_TO_JME.length) { + return androidKey; + } else { + return ANDROID_TO_JME[androidKey]; + } } - + } diff --git a/jme3-android/src/main/java/com/jme3/input/android/AndroidSensorJoyInput.java b/jme3-android/src/main/java/com/jme3/input/android/AndroidSensorJoyInput.java index 823aa3d9d..cdd7e6494 100644 --- a/jme3-android/src/main/java/com/jme3/input/android/AndroidSensorJoyInput.java +++ b/jme3-android/src/main/java/com/jme3/input/android/AndroidSensorJoyInput.java @@ -75,15 +75,15 @@ import java.util.logging.Logger; public class AndroidSensorJoyInput implements SensorEventListener { private final static Logger logger = Logger.getLogger(AndroidSensorJoyInput.class.getName()); - private AndroidJoyInputHandler joyHandler; + private AndroidJoyInput joyInput; private SensorManager sensorManager = null; private WindowManager windowManager = null; private IntMap sensors = new IntMap(); private int lastRotation = 0; private boolean loaded = false; - public AndroidSensorJoyInput(AndroidJoyInputHandler joyHandler) { - this.joyHandler = joyHandler; + public AndroidSensorJoyInput(AndroidJoyInput joyInput) { + this.joyInput = joyInput; } /** @@ -96,7 +96,7 @@ public class AndroidSensorJoyInput implements SensorEventListener { int sensorAccuracy = -1; float[] lastValues; final Object valuesLock = new Object(); - ArrayList axes = new ArrayList(); + ArrayList axes = new ArrayList(); boolean enabled = false; boolean haveData = false; @@ -306,7 +306,7 @@ public class AndroidSensorJoyInput implements SensorEventListener { */ private boolean updateOrientation() { SensorData sensorData; - AndroidJoystickAxis axis; + AndroidSensorJoystickAxis axis; final float[] curInclinationMat = new float[16]; final float[] curRotationMat = new float[16]; final float[] rotatedRotationMat = new float[16]; @@ -374,7 +374,7 @@ public class AndroidSensorJoyInput implements SensorEventListener { sensorData.haveData = true; } else { if (axis.isChanged()) { - joyHandler.addEvent(new JoyAxisEvent(axis, axis.getJoystickAxisValue())); + joyInput.addEvent(new JoyAxisEvent(axis, axis.getJoystickAxisValue())); } } } @@ -401,10 +401,10 @@ public class AndroidSensorJoyInput implements SensorEventListener { public Joystick loadJoystick(int joyId, InputManager inputManager) { SensorData sensorData; - AndroidJoystickAxis axis; + AndroidSensorJoystickAxis axis; - AndroidJoystick joystick = new AndroidJoystick(inputManager, - joyHandler, + AndroidSensorJoystick joystick = new AndroidSensorJoystick(inputManager, + joyInput, joyId, "AndroidSensorsJoystick"); @@ -522,15 +522,15 @@ public class AndroidSensorJoyInput implements SensorEventListener { if (!loaded) { return; } - logger.log(Level.FINE, "onSensorChanged for {0}: accuracy: {1}, values: {2}", - new Object[]{se.sensor.getName(), se.accuracy, se.values}); +// logger.log(Level.FINE, "onSensorChanged for {0}: accuracy: {1}, values: {2}", +// new Object[]{se.sensor.getName(), se.accuracy, se.values}); int sensorType = se.sensor.getType(); SensorData sensorData = sensors.get(sensorType); if (sensorData != null) { - logger.log(Level.FINE, "sensorData name: {0}, enabled: {1}, unreliable: {2}", - new Object[]{sensorData.sensor.getName(), sensorData.enabled, sensorData.sensorAccuracy == SensorManager.SENSOR_STATUS_UNRELIABLE}); +// logger.log(Level.FINE, "sensorData name: {0}, enabled: {1}, unreliable: {2}", +// new Object[]{sensorData.sensor.getName(), sensorData.enabled, sensorData.sensorAccuracy == SensorManager.SENSOR_STATUS_UNRELIABLE}); } if (sensorData != null && sensorData.sensor.equals(se.sensor) && sensorData.enabled) { @@ -543,8 +543,8 @@ public class AndroidSensorJoyInput implements SensorEventListener { } } - if (sensorData != null && sensorData.axes.size() > 0) { - AndroidJoystickAxis axis; + if (sensorData.axes.size() > 0) { + AndroidSensorJoystickAxis axis; for (int i=0; i lastPositions = new HashMap(); - - protected int numPointers = 0; - - protected AndroidInputHandler androidInput; - protected AndroidGestureHandler gestureHandler; - - public AndroidTouchHandler(AndroidInputHandler androidInput, AndroidGestureHandler gestureHandler) { - this.androidInput = androidInput; - this.gestureHandler = gestureHandler; - } - - public void initialize() { - } - - public void destroy() { - setView(null); - } - - public void setView(View view) { - if (view != null) { - view.setOnTouchListener(this); - } else { - androidInput.getView().setOnTouchListener(null); - } - } - - protected int getPointerIndex(MotionEvent event) { - return (event.getAction() & MotionEvent.ACTION_POINTER_INDEX_MASK) - >> MotionEvent.ACTION_POINTER_INDEX_SHIFT; - } - - protected int getPointerId(MotionEvent event) { - return event.getPointerId(getPointerIndex(event)); - } - - protected int getAction(MotionEvent event) { - return event.getAction() & MotionEvent.ACTION_MASK; - } - - /** - * onTouch gets called from android thread on touch events - */ - public boolean onTouch(View view, MotionEvent event) { - if (!androidInput.isInitialized() || view != androidInput.getView()) { - return false; - } - - boolean bWasHandled = false; - TouchEvent touch = null; - // System.out.println("native : " + event.getAction()); - int action = getAction(event); - int pointerIndex = getPointerIndex(event); - int pointerId = getPointerId(event); - Vector2f lastPos = lastPositions.get(pointerId); - float jmeX; - float jmeY; - - numPointers = event.getPointerCount(); - - // final int historySize = event.getHistorySize(); - //final int pointerCount = event.getPointerCount(); - switch (getAction(event)) { - case MotionEvent.ACTION_POINTER_DOWN: - case MotionEvent.ACTION_DOWN: - jmeX = androidInput.getJmeX(event.getX(pointerIndex)); - jmeY = androidInput.invertY(androidInput.getJmeY(event.getY(pointerIndex))); - touch = androidInput.getFreeTouchEvent(); - touch.set(TouchEvent.Type.DOWN, jmeX, jmeY, 0, 0); - touch.setPointerId(pointerId); - touch.setTime(event.getEventTime()); - touch.setPressure(event.getPressure(pointerIndex)); - - lastPos = new Vector2f(jmeX, jmeY); - lastPositions.put(pointerId, lastPos); - - processEvent(touch); - - bWasHandled = true; - break; - case MotionEvent.ACTION_POINTER_UP: - case MotionEvent.ACTION_CANCEL: - case MotionEvent.ACTION_UP: - jmeX = androidInput.getJmeX(event.getX(pointerIndex)); - jmeY = androidInput.invertY(androidInput.getJmeY(event.getY(pointerIndex))); - touch = androidInput.getFreeTouchEvent(); - touch.set(TouchEvent.Type.UP, jmeX, jmeY, 0, 0); - touch.setPointerId(pointerId); - touch.setTime(event.getEventTime()); - touch.setPressure(event.getPressure(pointerIndex)); - lastPositions.remove(pointerId); - - processEvent(touch); - - bWasHandled = true; - break; - case MotionEvent.ACTION_MOVE: - // Convert all pointers into events - for (int p = 0; p < event.getPointerCount(); p++) { - jmeX = androidInput.getJmeX(event.getX(p)); - jmeY = androidInput.invertY(androidInput.getJmeY(event.getY(p))); - lastPos = lastPositions.get(event.getPointerId(p)); - if (lastPos == null) { - lastPos = new Vector2f(jmeX, jmeY); - lastPositions.put(event.getPointerId(p), lastPos); - } - - float dX = jmeX - lastPos.x; - float dY = jmeY - lastPos.y; - if (dX != 0 || dY != 0) { - touch = androidInput.getFreeTouchEvent(); - touch.set(TouchEvent.Type.MOVE, jmeX, jmeY, dX, dY); - touch.setPointerId(event.getPointerId(p)); - touch.setTime(event.getEventTime()); - touch.setPressure(event.getPressure(p)); - lastPos.set(jmeX, jmeY); - - processEvent(touch); - - bWasHandled = true; - } - } - break; - case MotionEvent.ACTION_OUTSIDE: - break; - - } - - // Try to detect gestures - if (gestureHandler != null) { - gestureHandler.detectGesture(event); - } - - return bWasHandled; - } - - protected void processEvent(TouchEvent event) { - // Add the touch event - androidInput.addEvent(event); - // MouseEvents do not support multi-touch, so only evaluate 1 finger pointer events - if (androidInput.isSimulateMouse() && numPointers == 1) { - InputEvent mouseEvent = generateMouseEvent(event); - if (mouseEvent != null) { - // Add the mouse event - androidInput.addEvent(mouseEvent); - } - } - - } - - // TODO: Ring Buffer for mouse events? - protected InputEvent generateMouseEvent(TouchEvent event) { - InputEvent inputEvent = null; - int newX; - int newY; - int newDX; - int newDY; - - if (androidInput.isMouseEventsInvertX()) { - newX = (int) (androidInput.invertX(event.getX())); - newDX = (int)event.getDeltaX() * -1; - } else { - newX = (int) event.getX(); - newDX = (int)event.getDeltaX(); - } - - if (androidInput.isMouseEventsInvertY()) { - newY = (int) (androidInput.invertY(event.getY())); - newDY = (int)event.getDeltaY() * -1; - } else { - newY = (int) event.getY(); - newDY = (int)event.getDeltaY(); - } - - switch (event.getType()) { - case DOWN: - // Handle mouse down event - inputEvent = new MouseButtonEvent(0, true, newX, newY); - inputEvent.setTime(event.getTime()); - break; - - case UP: - // Handle mouse up event - inputEvent = new MouseButtonEvent(0, false, newX, newY); - inputEvent.setTime(event.getTime()); - break; - - case HOVER_MOVE: - case MOVE: - inputEvent = new MouseMotionEvent(newX, newY, newDX, newDY, (int)event.getScaleSpan(), (int)event.getDeltaScaleSpan()); - inputEvent.setTime(event.getTime()); - break; - } - - return inputEvent; - } - -} diff --git a/jme3-android/src/main/java/com/jme3/input/android/AndroidTouchInput.java b/jme3-android/src/main/java/com/jme3/input/android/AndroidTouchInput.java new file mode 100644 index 000000000..bddc5fab3 --- /dev/null +++ b/jme3-android/src/main/java/com/jme3/input/android/AndroidTouchInput.java @@ -0,0 +1,475 @@ +/* + * Copyright (c) 2009-2012 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ + +package com.jme3.input.android; + +import android.view.GestureDetector; +import android.view.KeyEvent; +import android.view.MotionEvent; +import android.view.ScaleGestureDetector; +import com.jme3.input.RawInputListener; +import com.jme3.input.TouchInput; +import com.jme3.input.event.InputEvent; +import com.jme3.input.event.KeyInputEvent; +import com.jme3.input.event.MouseButtonEvent; +import com.jme3.input.event.MouseMotionEvent; +import com.jme3.input.event.TouchEvent; +import static com.jme3.input.event.TouchEvent.Type.DOWN; +import static com.jme3.input.event.TouchEvent.Type.MOVE; +import static com.jme3.input.event.TouchEvent.Type.UP; +import com.jme3.math.Vector2f; +import com.jme3.system.AppSettings; +import java.util.HashMap; +import java.util.concurrent.ConcurrentLinkedQueue; +import java.util.logging.Level; +import java.util.logging.Logger; + +/** + * AndroidTouchInput is the base class that receives touch inputs from the + * Android system and creates the TouchEvents for jME. This class is designed + * to handle the base touch events for Android rev 9 (Android 2.3). This is + * extended by other classes to add features that were introducted after + * Android rev 9. + * + * @author iwgeric + */ +public class AndroidTouchInput implements TouchInput { + private static final Logger logger = Logger.getLogger(AndroidTouchInput.class.getName()); + + private boolean mouseEventsEnabled = true; + private boolean mouseEventsInvertX = false; + private boolean mouseEventsInvertY = false; + private boolean keyboardEventsEnabled = false; + private boolean dontSendHistory = false; + + protected int numPointers = 0; + final private HashMap lastPositions = new HashMap(); + final private ConcurrentLinkedQueue inputEventQueue = new ConcurrentLinkedQueue(); + private final static int MAX_TOUCH_EVENTS = 1024; + private final TouchEventPool touchEventPool = new TouchEventPool(MAX_TOUCH_EVENTS); + private float scaleX = 1f; + private float scaleY = 1f; + + private boolean initialized = false; + private RawInputListener listener = null; + + private GestureDetector gestureDetector; + private ScaleGestureDetector scaleDetector; + + protected AndroidInputHandler androidInput; + + public AndroidTouchInput(AndroidInputHandler androidInput) { + this.androidInput = androidInput; + } + + public GestureDetector getGestureDetector() { + return gestureDetector; + } + + public void setGestureDetector(GestureDetector gestureDetector) { + this.gestureDetector = gestureDetector; + } + + public ScaleGestureDetector getScaleDetector() { + return scaleDetector; + } + + public void setScaleDetector(ScaleGestureDetector scaleDetector) { + this.scaleDetector = scaleDetector; + } + + public float invertX(float origX) { + return getJmeX(androidInput.getView().getWidth()) - origX; + } + + public float invertY(float origY) { + return getJmeY(androidInput.getView().getHeight()) - origY; + } + + public float getJmeX(float origX) { + return origX * scaleX; + } + + public float getJmeY(float origY) { + return origY * scaleY; + } + + public void loadSettings(AppSettings settings) { + keyboardEventsEnabled = settings.isEmulateKeyboard(); + mouseEventsEnabled = settings.isEmulateMouse(); + mouseEventsInvertX = settings.isEmulateMouseFlipX(); + mouseEventsInvertY = settings.isEmulateMouseFlipY(); + + // view width and height are 0 until the view is displayed on the screen + if (androidInput.getView().getWidth() != 0 && androidInput.getView().getHeight() != 0) { + scaleX = (float)settings.getWidth() / (float)androidInput.getView().getWidth(); + scaleY = (float)settings.getHeight() / (float)androidInput.getView().getHeight(); + } + logger.log(Level.FINE, "Setting input scaling, scaleX: {0}, scaleY: {1}", + new Object[]{scaleX, scaleY}); + + + } + + + protected int getPointerIndex(MotionEvent event) { + return (event.getAction() & MotionEvent.ACTION_POINTER_INDEX_MASK) + >> MotionEvent.ACTION_POINTER_INDEX_SHIFT; + } + + protected int getPointerId(MotionEvent event) { + return event.getPointerId(getPointerIndex(event)); + } + + protected int getAction(MotionEvent event) { + return event.getAction() & MotionEvent.ACTION_MASK; + } + + public boolean onTouch(MotionEvent event) { + if (!isInitialized()) { + return false; + } + + boolean bWasHandled = false; + TouchEvent touch = null; + // System.out.println("native : " + event.getAction()); + int action = getAction(event); + int pointerIndex = getPointerIndex(event); + int pointerId = getPointerId(event); + Vector2f lastPos = lastPositions.get(pointerId); + float jmeX; + float jmeY; + + numPointers = event.getPointerCount(); + + // final int historySize = event.getHistorySize(); + //final int pointerCount = event.getPointerCount(); + switch (getAction(event)) { + case MotionEvent.ACTION_POINTER_DOWN: + case MotionEvent.ACTION_DOWN: + jmeX = getJmeX(event.getX(pointerIndex)); + jmeY = invertY(getJmeY(event.getY(pointerIndex))); + touch = getFreeTouchEvent(); + touch.set(TouchEvent.Type.DOWN, jmeX, jmeY, 0, 0); + touch.setPointerId(pointerId); + touch.setTime(event.getEventTime()); + touch.setPressure(event.getPressure(pointerIndex)); + + lastPos = new Vector2f(jmeX, jmeY); + lastPositions.put(pointerId, lastPos); + + addEvent(touch); + addEvent(generateMouseEvent(touch)); + + bWasHandled = true; + break; + case MotionEvent.ACTION_POINTER_UP: + case MotionEvent.ACTION_CANCEL: + case MotionEvent.ACTION_UP: + jmeX = getJmeX(event.getX(pointerIndex)); + jmeY = invertY(getJmeY(event.getY(pointerIndex))); + touch = getFreeTouchEvent(); + touch.set(TouchEvent.Type.UP, jmeX, jmeY, 0, 0); + touch.setPointerId(pointerId); + touch.setTime(event.getEventTime()); + touch.setPressure(event.getPressure(pointerIndex)); + lastPositions.remove(pointerId); + + addEvent(touch); + addEvent(generateMouseEvent(touch)); + + bWasHandled = true; + break; + case MotionEvent.ACTION_MOVE: + // Convert all pointers into events + for (int p = 0; p < event.getPointerCount(); p++) { + jmeX = getJmeX(event.getX(p)); + jmeY = invertY(getJmeY(event.getY(p))); + lastPos = lastPositions.get(event.getPointerId(p)); + if (lastPos == null) { + lastPos = new Vector2f(jmeX, jmeY); + lastPositions.put(event.getPointerId(p), lastPos); + } + + float dX = jmeX - lastPos.x; + float dY = jmeY - lastPos.y; + if (dX != 0 || dY != 0) { + touch = getFreeTouchEvent(); + touch.set(TouchEvent.Type.MOVE, jmeX, jmeY, dX, dY); + touch.setPointerId(event.getPointerId(p)); + touch.setTime(event.getEventTime()); + touch.setPressure(event.getPressure(p)); + lastPos.set(jmeX, jmeY); + + addEvent(touch); + addEvent(generateMouseEvent(touch)); + + bWasHandled = true; + } + } + break; + case MotionEvent.ACTION_OUTSIDE: + break; + + } + + // Try to detect gestures + if (gestureDetector != null) { + gestureDetector.onTouchEvent(event); + } + if (scaleDetector != null) { + scaleDetector.onTouchEvent(event); + } + + return bWasHandled; + } + + // TODO: Ring Buffer for mouse events? + public InputEvent generateMouseEvent(TouchEvent event) { + InputEvent inputEvent = null; + int newX; + int newY; + int newDX; + int newDY; + + // MouseEvents do not support multi-touch, so only evaluate 1 finger pointer events + if (!isSimulateMouse() || numPointers > 1) { + return null; + } + + + if (isMouseEventsInvertX()) { + newX = (int) (invertX(event.getX())); + newDX = (int)event.getDeltaX() * -1; + } else { + newX = (int) event.getX(); + newDX = (int)event.getDeltaX(); + } + + if (isMouseEventsInvertY()) { + newY = (int) (invertY(event.getY())); + newDY = (int)event.getDeltaY() * -1; + } else { + newY = (int) event.getY(); + newDY = (int)event.getDeltaY(); + } + + switch (event.getType()) { + case DOWN: + // Handle mouse down event + inputEvent = new MouseButtonEvent(0, true, newX, newY); + inputEvent.setTime(event.getTime()); + break; + + case UP: + // Handle mouse up event + inputEvent = new MouseButtonEvent(0, false, newX, newY); + inputEvent.setTime(event.getTime()); + break; + + case HOVER_MOVE: + case MOVE: + inputEvent = new MouseMotionEvent(newX, newY, newDX, newDY, (int)event.getScaleSpan(), (int)event.getDeltaScaleSpan()); + inputEvent.setTime(event.getTime()); + break; + } + + return inputEvent; + } + + + public boolean onKey(KeyEvent event) { + if (!isInitialized()) { + return false; + } + + TouchEvent evt; + // TODO: get touch event from pool + if (event.getAction() == KeyEvent.ACTION_DOWN) { + evt = new TouchEvent(); + evt.set(TouchEvent.Type.KEY_DOWN); + evt.setKeyCode(event.getKeyCode()); + evt.setCharacters(event.getCharacters()); + evt.setTime(event.getEventTime()); + + // Send the event + addEvent(evt); + + } else if (event.getAction() == KeyEvent.ACTION_UP) { + evt = new TouchEvent(); + evt.set(TouchEvent.Type.KEY_UP); + evt.setKeyCode(event.getKeyCode()); + evt.setCharacters(event.getCharacters()); + evt.setTime(event.getEventTime()); + + // Send the event + addEvent(evt); + + } + + if (isSimulateKeyboard()) { + KeyInputEvent kie; + char unicodeChar = (char)event.getUnicodeChar(); + int jmeKeyCode = AndroidKeyMapping.getJmeKey(event.getKeyCode()); + + boolean pressed = event.getAction() == KeyEvent.ACTION_DOWN; + boolean repeating = pressed && event.getRepeatCount() > 0; + + kie = new KeyInputEvent(jmeKeyCode, unicodeChar, pressed, repeating); + kie.setTime(event.getEventTime()); + addEvent(kie); +// logger.log(Level.FINE, "onKey keyCode: {0}, jmeKeyCode: {1}, pressed: {2}, repeating: {3}", +// new Object[]{event.getKeyCode(), jmeKeyCode, pressed, repeating}); +// logger.log(Level.FINE, "creating KeyInputEvent: {0}", kie); + } + + // consume all keys ourself except Volume Up/Down and Menu + // Don't do Menu so that typical Android Menus can be created and used + // by the user in MainActivity + if ((event.getKeyCode() == KeyEvent.KEYCODE_VOLUME_UP) || + (event.getKeyCode() == KeyEvent.KEYCODE_VOLUME_DOWN) || + (event.getKeyCode() == KeyEvent.KEYCODE_MENU)) { + return false; + } else { + return true; + } + + } + + + + + // ----------------------------------------- + // JME3 Input interface + @Override + public void initialize() { + touchEventPool.initialize(); + + initialized = true; + } + + @Override + public void destroy() { + initialized = false; + + touchEventPool.destroy(); + + } + + @Override + public boolean isInitialized() { + return initialized; + } + + @Override + public void setInputListener(RawInputListener listener) { + this.listener = listener; + } + + @Override + public long getInputTimeNanos() { + return System.nanoTime(); + } + + @Override + public void update() { + if (listener != null) { + InputEvent inputEvent; + + while ((inputEvent = inputEventQueue.poll()) != null) { + if (inputEvent instanceof TouchEvent) { + listener.onTouchEvent((TouchEvent)inputEvent); + } else if (inputEvent instanceof MouseButtonEvent) { + listener.onMouseButtonEvent((MouseButtonEvent)inputEvent); + } else if (inputEvent instanceof MouseMotionEvent) { + listener.onMouseMotionEvent((MouseMotionEvent)inputEvent); + } else if (inputEvent instanceof KeyInputEvent) { + listener.onKeyEvent((KeyInputEvent)inputEvent); + } + } + } + } + + // ----------------------------------------- + + public TouchEvent getFreeTouchEvent() { + return touchEventPool.getNextFreeEvent(); + } + + public void addEvent(InputEvent event) { + if (event == null) { + return; + } + + logger.log(Level.INFO, "event: {0}", event); + + inputEventQueue.add(event); + if (event instanceof TouchEvent) { + touchEventPool.storeEvent((TouchEvent)event); + } + + } + + @Override + public void setSimulateMouse(boolean simulate) { + this.mouseEventsEnabled = simulate; + } + + @Override + public boolean isSimulateMouse() { + return mouseEventsEnabled; + } + + public boolean isMouseEventsInvertX() { + return mouseEventsInvertX; + } + + public boolean isMouseEventsInvertY() { + return mouseEventsInvertY; + } + + @Override + public void setSimulateKeyboard(boolean simulate) { + this.keyboardEventsEnabled = simulate; + } + + @Override + public boolean isSimulateKeyboard() { + return keyboardEventsEnabled; + } + + @Override + public void setOmitHistoricEvents(boolean dontSendHistory) { + this.dontSendHistory = dontSendHistory; + } + +} diff --git a/jme3-android/src/main/java/com/jme3/input/android/AndroidTouchHandler14.java b/jme3-android/src/main/java/com/jme3/input/android/AndroidTouchInput14.java similarity index 67% rename from jme3-android/src/main/java/com/jme3/input/android/AndroidTouchHandler14.java rename to jme3-android/src/main/java/com/jme3/input/android/AndroidTouchInput14.java index 1a785a5e9..617a4b719 100644 --- a/jme3-android/src/main/java/com/jme3/input/android/AndroidTouchHandler14.java +++ b/jme3-android/src/main/java/com/jme3/input/android/AndroidTouchInput14.java @@ -33,7 +33,6 @@ package com.jme3.input.android; import android.view.MotionEvent; -import android.view.View; import com.jme3.input.event.TouchEvent; import com.jme3.math.Vector2f; import java.util.HashMap; @@ -41,36 +40,20 @@ import java.util.logging.Level; import java.util.logging.Logger; /** - * AndroidTouchHandler14 is an extension of AndroidTouchHander that adds the - * Android touch event functionality between Android rev 9 (Android 2.3) and - * Android rev 14 (Android 4.0). - * + * AndroidTouchHandler14 extends AndroidTouchHandler to process the onHover + * events added in Android rev 14 (Android 4.0). + * * @author iwgeric */ -public class AndroidTouchHandler14 extends AndroidTouchHandler implements - View.OnHoverListener { - private static final Logger logger = Logger.getLogger(AndroidTouchHandler14.class.getName()); +public class AndroidTouchInput14 extends AndroidTouchInput { + private static final Logger logger = Logger.getLogger(AndroidTouchInput14.class.getName()); final private HashMap lastHoverPositions = new HashMap(); - - public AndroidTouchHandler14(AndroidInputHandler androidInput, AndroidGestureHandler gestureHandler) { - super(androidInput, gestureHandler); - } - @Override - public void setView(View view) { - if (view != null) { - view.setOnHoverListener(this); - } else { - androidInput.getView().setOnHoverListener(null); - } - super.setView(view); + public AndroidTouchInput14(AndroidInputHandler androidInput) { + super(androidInput); } - - public boolean onHover(View view, MotionEvent event) { - if (view == null || view != androidInput.getView()) { - return false; - } - + + public boolean onHover(MotionEvent event) { boolean consumed = false; int action = getAction(event); int pointerId = getPointerId(event); @@ -78,34 +61,34 @@ public class AndroidTouchHandler14 extends AndroidTouchHandler implements Vector2f lastPos = lastHoverPositions.get(pointerId); float jmeX; float jmeY; - + numPointers = event.getPointerCount(); - - logger.log(Level.INFO, "onHover pointerId: {0}, action: {1}, x: {2}, y: {3}, numPointers: {4}", - new Object[]{pointerId, action, event.getX(), event.getY(), event.getPointerCount()}); + +// logger.log(Level.INFO, "onHover pointerId: {0}, action: {1}, x: {2}, y: {3}, numPointers: {4}", +// new Object[]{pointerId, action, event.getX(), event.getY(), event.getPointerCount()}); TouchEvent touchEvent; switch (action) { case MotionEvent.ACTION_HOVER_ENTER: - jmeX = androidInput.getJmeX(event.getX(pointerIndex)); - jmeY = androidInput.invertY(androidInput.getJmeY(event.getY(pointerIndex))); - touchEvent = androidInput.getFreeTouchEvent(); + jmeX = getJmeX(event.getX(pointerIndex)); + jmeY = invertY(getJmeY(event.getY(pointerIndex))); + touchEvent = getFreeTouchEvent(); touchEvent.set(TouchEvent.Type.HOVER_START, jmeX, jmeY, 0, 0); touchEvent.setPointerId(pointerId); touchEvent.setTime(event.getEventTime()); touchEvent.setPressure(event.getPressure(pointerIndex)); - + lastPos = new Vector2f(jmeX, jmeY); lastHoverPositions.put(pointerId, lastPos); - - processEvent(touchEvent); + + addEvent(touchEvent); consumed = true; break; case MotionEvent.ACTION_HOVER_MOVE: // Convert all pointers into events for (int p = 0; p < event.getPointerCount(); p++) { - jmeX = androidInput.getJmeX(event.getX(p)); - jmeY = androidInput.invertY(androidInput.getJmeY(event.getY(p))); + jmeX = getJmeX(event.getX(p)); + jmeY = invertY(getJmeY(event.getY(p))); lastPos = lastHoverPositions.get(event.getPointerId(p)); if (lastPos == null) { lastPos = new Vector2f(jmeX, jmeY); @@ -115,38 +98,39 @@ public class AndroidTouchHandler14 extends AndroidTouchHandler implements float dX = jmeX - lastPos.x; float dY = jmeY - lastPos.y; if (dX != 0 || dY != 0) { - touchEvent = androidInput.getFreeTouchEvent(); + touchEvent = getFreeTouchEvent(); touchEvent.set(TouchEvent.Type.HOVER_MOVE, jmeX, jmeY, dX, dY); touchEvent.setPointerId(event.getPointerId(p)); touchEvent.setTime(event.getEventTime()); touchEvent.setPressure(event.getPressure(p)); lastPos.set(jmeX, jmeY); - processEvent(touchEvent); + addEvent(touchEvent); } } consumed = true; break; case MotionEvent.ACTION_HOVER_EXIT: - jmeX = androidInput.getJmeX(event.getX(pointerIndex)); - jmeY = androidInput.invertY(androidInput.getJmeY(event.getY(pointerIndex))); - touchEvent = androidInput.getFreeTouchEvent(); + jmeX = getJmeX(event.getX(pointerIndex)); + jmeY = invertY(getJmeY(event.getY(pointerIndex))); + touchEvent = getFreeTouchEvent(); touchEvent.set(TouchEvent.Type.HOVER_END, jmeX, jmeY, 0, 0); touchEvent.setPointerId(pointerId); touchEvent.setTime(event.getEventTime()); touchEvent.setPressure(event.getPressure(pointerIndex)); lastHoverPositions.remove(pointerId); - processEvent(touchEvent); + addEvent(touchEvent); consumed = true; break; default: consumed = false; break; } - + return consumed; + } - + } diff --git a/jme3-android/src/main/java/com/jme3/system/android/OGLESContext.java b/jme3-android/src/main/java/com/jme3/system/android/OGLESContext.java index 5ef866188..9472bff0b 100644 --- a/jme3-android/src/main/java/com/jme3/system/android/OGLESContext.java +++ b/jme3-android/src/main/java/com/jme3/system/android/OGLESContext.java @@ -47,7 +47,7 @@ import android.widget.EditText; import android.widget.FrameLayout; import com.jme3.input.*; import com.jme3.input.android.AndroidInputHandler; -import com.jme3.input.android.AndroidJoyInputHandler; +import com.jme3.input.android.AndroidInputHandler14; import com.jme3.input.controls.SoftTextDialogInputListener; import com.jme3.input.dummy.DummyKeyInput; import com.jme3.input.dummy.DummyMouseInput; @@ -75,7 +75,6 @@ public class OGLESContext implements JmeContext, GLSurfaceView.Renderer, SoftTex protected SystemListener listener; protected boolean autoFlush = true; protected AndroidInputHandler androidInput; - protected AndroidJoyInputHandler androidJoyInput = null; protected long minFrameDuration = 0; // No FPS cap protected long lastUpdateTime = 0; @@ -111,18 +110,17 @@ public class OGLESContext implements JmeContext, GLSurfaceView.Renderer, SoftTex // Start to set up the view GLSurfaceView view = new GLSurfaceView(context); + logger.log(Level.INFO, "Android Build Version: {0}", Build.VERSION.SDK_INT); if (androidInput == null) { - androidInput = new AndroidInputHandler(); + if (Build.VERSION.SDK_INT >= 14) { + androidInput = new AndroidInputHandler14(); + } else if (Build.VERSION.SDK_INT >= 9){ + androidInput = new AndroidInputHandler(); + } } androidInput.setView(view); androidInput.loadSettings(settings); - if (androidJoyInput == null) { - androidJoyInput = new AndroidJoyInputHandler(); - } - androidJoyInput.setView(view); - androidJoyInput.loadSettings(settings); - // setEGLContextClientVersion must be set before calling setRenderer // this means it cannot be set in AndroidConfigChooser (too late) view.setEGLContextClientVersion(2); @@ -235,9 +233,6 @@ public class OGLESContext implements JmeContext, GLSurfaceView.Renderer, SoftTex if (androidInput != null) { androidInput.loadSettings(settings); } - if (androidJoyInput != null) { - androidJoyInput.loadSettings(settings); - } if (settings.getFrameRate() > 0) { minFrameDuration = (long)(1000d / (double)settings.getFrameRate()); // ms @@ -274,12 +269,12 @@ public class OGLESContext implements JmeContext, GLSurfaceView.Renderer, SoftTex @Override public JoyInput getJoyInput() { - return androidJoyInput; + return androidInput.getJoyInput(); } @Override public TouchInput getTouchInput() { - return androidInput; + return androidInput.getTouchInput(); } @Override From 6c24390663873ef2a434443a6c7493da14d18305 Mon Sep 17 00:00:00 2001 From: iwgeric Date: Fri, 17 Apr 2015 19:53:55 -0400 Subject: [PATCH 013/113] Android: Fix issue handling key events that are tied to both keyboard and gamepad --- .../java/com/jme3/input/android/AndroidInputHandler14.java | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/jme3-android/src/main/java/com/jme3/input/android/AndroidInputHandler14.java b/jme3-android/src/main/java/com/jme3/input/android/AndroidInputHandler14.java index 114bb98fd..4b39ed24c 100644 --- a/jme3-android/src/main/java/com/jme3/input/android/AndroidInputHandler14.java +++ b/jme3-android/src/main/java/com/jme3/input/android/AndroidInputHandler14.java @@ -148,7 +148,8 @@ public class AndroidInputHandler14 extends AndroidInputHandler implements View.O if (isJoystick && joyInput != null) { // logger.log(Level.INFO, "onKey source: {0}, isJoystick: {1}", // new Object[]{source, isJoystick}); - consumed = consumed || ((AndroidJoyInput14)joyInput).onKey(event); + // use inclusive OR to make sure the onKey method is called. + consumed = consumed | ((AndroidJoyInput14)joyInput).onKey(event); } return consumed; From d80de0cc5b74f5c8e8a4f77c80a361708d3bf7fa Mon Sep 17 00:00:00 2001 From: iwgeric Date: Sat, 18 Apr 2015 14:48:30 -0400 Subject: [PATCH 014/113] Android: Add static property to disable sensors but still have joysticks. May move this to AppSettings later, but not sure yet. --- .../main/java/com/jme3/input/android/AndroidJoyInput.java | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/jme3-android/src/main/java/com/jme3/input/android/AndroidJoyInput.java b/jme3-android/src/main/java/com/jme3/input/android/AndroidJoyInput.java index e31504520..1e610d24e 100644 --- a/jme3-android/src/main/java/com/jme3/input/android/AndroidJoyInput.java +++ b/jme3-android/src/main/java/com/jme3/input/android/AndroidJoyInput.java @@ -79,6 +79,7 @@ import java.util.logging.Logger; */ public class AndroidJoyInput implements JoyInput { private static final Logger logger = Logger.getLogger(AndroidJoyInput.class.getName()); + public static boolean disableSensors = false; protected AndroidInputHandler inputHandler; protected List joystickList = new ArrayList(); @@ -208,7 +209,9 @@ public class AndroidJoyInput implements JoyInput { @Override public Joystick[] loadJoysticks(InputManager inputManager) { logger.log(Level.INFO, "loading joysticks for {0}", this.getClass().getName()); - joystickList.add(sensorJoyInput.loadJoystick(joystickList.size(), inputManager)); + if (!disableSensors) { + joystickList.add(sensorJoyInput.loadJoystick(joystickList.size(), inputManager)); + } return joystickList.toArray( new Joystick[joystickList.size()] ); } From fecfa8ccd07bbf1b8731387d4cb89fe1ed2806f7 Mon Sep 17 00:00:00 2001 From: iwgeric Date: Sun, 19 Apr 2015 12:38:43 -0400 Subject: [PATCH 015/113] Android: add joystick compatibility mapping for XBOX 360 controller connected to Android device using USB dongle --- .../resources/joystick-mapping.properties | 19 +++++++++++++------ 1 file changed, 13 insertions(+), 6 deletions(-) diff --git a/jme3-core/src/main/resources/joystick-mapping.properties b/jme3-core/src/main/resources/joystick-mapping.properties index 5f29e4105..d7ce2f50a 100644 --- a/jme3-core/src/main/resources/joystick-mapping.properties +++ b/jme3-core/src/main/resources/joystick-mapping.properties @@ -6,7 +6,7 @@ # the new name as it will be reported through the Joystick # interface. # -# Keys with spaces in them should have those spaces escaped. +# Keys with spaces in them should have those spaces escaped. # Values do not need their spaces escaped. For example: # # Some\ Joystick.0=3 @@ -37,22 +37,29 @@ Controller\ (Xbox\ 360\ Wireless\ Receiver\ for\ Windows).ry=rz # requires custom code to support trigger buttons but this # keeps it from confusing the .rx mapping. Controller\ (Xbox\ 360\ Wireless\ Receiver\ for\ Windows).z=trigger - + # Xbox 360 Controller (copied from wireless version) Controller\ (XBOX\ 360\ For\ Windows).0=2 Controller\ (XBOX\ 360\ For\ Windows).1=1 Controller\ (XBOX\ 360\ For\ Windows).2=3 Controller\ (XBOX\ 360\ For\ Windows).3=0 - + Controller\ (XBOX\ 360\ For\ Windows).6=8 Controller\ (XBOX\ 360\ For\ Windows).7=9 - + Controller\ (XBOX\ 360\ For\ Windows).8=10 Controller\ (XBOX\ 360\ For\ Windows).9=11 - + Controller\ (XBOX\ 360\ For\ Windows).rx=z Controller\ (XBOX\ 360\ For\ Windows).ry=rz - + # requires custom code to support trigger buttons but this # keeps it from confusing the .rx mapping. Controller\ (XBOX\ 360\ For\ Windows).z=trigger + +# XBOX 360 Controller connected to Android using +# the USB dongle +Xbox\ 360\ Wireless\ Receiver.AXIS_RX=z +Xbox\ 360\ Wireless\ Receiver.AXIS_RY=rz +Xbox\ 360\ Wireless\ Receiver.z=AXIS_RX +Xbox\ 360\ Wireless\ Receiver.rz=AXIS_RY From 116adbba1f5844a17c38a0e90bb36e58e153c95c Mon Sep 17 00:00:00 2001 From: iwgeric Date: Sun, 19 Apr 2015 12:40:17 -0400 Subject: [PATCH 016/113] Android: Support JoystickCompatibilityMappings for reassigning joystick axes and buttons. Also added ability to add new buttons as events come in due to Android not providing a definitive way to determine which buttons are supported on the device. --- .../android/AndroidJoystickJoyInput14.java | 73 +++++++++++-------- 1 file changed, 43 insertions(+), 30 deletions(-) diff --git a/jme3-android/src/main/java/com/jme3/input/android/AndroidJoystickJoyInput14.java b/jme3-android/src/main/java/com/jme3/input/android/AndroidJoystickJoyInput14.java index 370db4f10..1ed98977c 100644 --- a/jme3-android/src/main/java/com/jme3/input/android/AndroidJoystickJoyInput14.java +++ b/jme3-android/src/main/java/com/jme3/input/android/AndroidJoystickJoyInput14.java @@ -44,6 +44,7 @@ import com.jme3.input.JoyInput; import com.jme3.input.Joystick; import com.jme3.input.JoystickAxis; import com.jme3.input.JoystickButton; +import com.jme3.input.JoystickCompatibilityMappings; import com.jme3.input.event.JoyAxisEvent; import com.jme3.input.event.JoyButtonEvent; import java.util.ArrayList; @@ -220,11 +221,16 @@ public class AndroidJoystickJoyInput14 { AndroidJoystick joystick = joystickIndex.get(event.getDeviceId()); if (joystick != null) { JoystickButton button = joystick.getButton(event.getKeyCode()); + boolean pressed = event.getAction() == KeyEvent.ACTION_DOWN; if (button != null) { - boolean pressed = event.getAction() == KeyEvent.ACTION_DOWN; JoyButtonEvent buttonEvent = new JoyButtonEvent(button, pressed); joyInput.addEvent(buttonEvent); consumed = true; + } else { + JoystickButton newButton = joystick.addButton(event.getKeyCode()); + JoyButtonEvent buttonEvent = new JoyButtonEvent(newButton, pressed); + joyInput.addEvent(buttonEvent); + consumed = true; } } @@ -273,44 +279,50 @@ public class AndroidJoystickJoyInput14 { // logger.log(Level.FINE, "Adding button: {0}", keyCode); String name = KeyEvent.keyCodeToString(keyCode); - String logicalId = KeyEvent.keyCodeToString(keyCode); + String original = KeyEvent.keyCodeToString(keyCode); // A/B/X/Y buttons if (keyCode == KeyEvent.KEYCODE_BUTTON_Y) { - logicalId = JoystickButton.BUTTON_0; - } else if (keyCode == KeyEvent.KEYCODE_BUTTON_A) { - logicalId = JoystickButton.BUTTON_2; + original = JoystickButton.BUTTON_0; } else if (keyCode == KeyEvent.KEYCODE_BUTTON_B) { - logicalId = JoystickButton.BUTTON_1; + original = JoystickButton.BUTTON_1; + } else if (keyCode == KeyEvent.KEYCODE_BUTTON_A) { + original = JoystickButton.BUTTON_2; } else if (keyCode == KeyEvent.KEYCODE_BUTTON_X) { - logicalId = JoystickButton.BUTTON_3; + original = JoystickButton.BUTTON_3; // Front buttons Some of these have the top ones and the bottoms ones flipped. } else if (keyCode == KeyEvent.KEYCODE_BUTTON_L1) { - logicalId = JoystickButton.BUTTON_4; + original = JoystickButton.BUTTON_4; } else if (keyCode == KeyEvent.KEYCODE_BUTTON_R1) { - logicalId = JoystickButton.BUTTON_5; + original = JoystickButton.BUTTON_5; } else if (keyCode == KeyEvent.KEYCODE_BUTTON_L2) { - logicalId = JoystickButton.BUTTON_6; + original = JoystickButton.BUTTON_6; } else if (keyCode == KeyEvent.KEYCODE_BUTTON_R2) { - logicalId = JoystickButton.BUTTON_7; + original = JoystickButton.BUTTON_7; // // Dpad buttons // } else if (keyCode == KeyEvent.KEYCODE_DPAD_UP) { -// logicalId = JoystickButton.BUTTON_8; +// original = JoystickButton.BUTTON_8; // } else if (keyCode == KeyEvent.KEYCODE_DPAD_UP) { -// logicalId = JoystickButton.BUTTON_9; +// original = JoystickButton.BUTTON_9; // } else if (keyCode == KeyEvent.KEYCODE_DPAD_UP) { -// logicalId = JoystickButton.BUTTON_8; +// original = JoystickButton.BUTTON_8; // } else if (keyCode == KeyEvent.KEYCODE_DPAD_UP) { -// logicalId = JoystickButton.BUTTON_9; +// original = JoystickButton.BUTTON_9; // Select and start buttons } else if (keyCode == KeyEvent.KEYCODE_BUTTON_SELECT) { - logicalId = JoystickButton.BUTTON_8; + original = JoystickButton.BUTTON_8; } else if (keyCode == KeyEvent.KEYCODE_BUTTON_START) { - logicalId = JoystickButton.BUTTON_9; + original = JoystickButton.BUTTON_9; // Joystick push buttons } else if (keyCode == KeyEvent.KEYCODE_BUTTON_THUMBL) { - logicalId = JoystickButton.BUTTON_10; + original = JoystickButton.BUTTON_10; } else if (keyCode == KeyEvent.KEYCODE_BUTTON_THUMBR) { - logicalId = JoystickButton.BUTTON_11; + original = JoystickButton.BUTTON_11; + } + + String logicalId = JoystickCompatibilityMappings.remapComponent( getName(), original ); + if( logicalId == null ? original != null : !logicalId.equals(original) ) { + logger.log(Level.FINE, "Remapped: {0} to: {1}", + new Object[]{original, logicalId}); } JoystickButton button = new DefaultJoystickButton( getInputManager(), this, getButtonCount(), @@ -324,24 +336,25 @@ public class AndroidJoystickJoyInput14 { String name = MotionEvent.axisToString(motionRange.getAxis()); - String logicalId = MotionEvent.axisToString(motionRange.getAxis()); + String original = MotionEvent.axisToString(motionRange.getAxis()); if (motionRange.getAxis() == MotionEvent.AXIS_X) { - logicalId = JoystickAxis.X_AXIS; + original = JoystickAxis.X_AXIS; } else if (motionRange.getAxis() == MotionEvent.AXIS_Y) { - logicalId = JoystickAxis.Y_AXIS; + original = JoystickAxis.Y_AXIS; } else if (motionRange.getAxis() == MotionEvent.AXIS_Z) { - logicalId = JoystickAxis.Z_AXIS; + original = JoystickAxis.Z_AXIS; } else if (motionRange.getAxis() == MotionEvent.AXIS_RZ) { - logicalId = JoystickAxis.Z_ROTATION; + original = JoystickAxis.Z_ROTATION; } else if (motionRange.getAxis() == MotionEvent.AXIS_HAT_X) { - logicalId = JoystickAxis.POV_X; + original = JoystickAxis.POV_X; } else if (motionRange.getAxis() == MotionEvent.AXIS_HAT_Y) { - logicalId = JoystickAxis.POV_Y; + original = JoystickAxis.POV_Y; + } + String logicalId = JoystickCompatibilityMappings.remapComponent( getName(), original ); + if( logicalId == null ? original != null : !logicalId.equals(original) ) { + logger.log(Level.FINE, "Remapped: {0} to: {1}", + new Object[]{original, logicalId}); } -// String logicalId = JoystickCompatibilityMappings.remapComponent( controller.getName(), original ); -// if( name != original ) { -// logger.log(Level.FINE, "Remapped:" + original + " to:" + logicalId); -// } JoystickAxis axis = new DefaultJoystickAxis(getInputManager(), this, From ba8349a0cfaa7ec08bb1bcbbc9bb109756d0dfce Mon Sep 17 00:00:00 2001 From: shadowislord Date: Sun, 12 Apr 2015 15:32:41 -0400 Subject: [PATCH 017/113] FBX: ContentTextureKey to disable cache FBXDump remove useless import --- .../com/jme3/scene/plugins/fbx/ContentTextureKey.java | 9 +++++++++ .../java/com/jme3/scene/plugins/fbx/file/FBXDump.java | 1 - 2 files changed, 9 insertions(+), 1 deletion(-) diff --git a/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/ContentTextureKey.java b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/ContentTextureKey.java index 06a4ec795..35375f9c5 100644 --- a/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/ContentTextureKey.java +++ b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/ContentTextureKey.java @@ -32,6 +32,8 @@ package com.jme3.scene.plugins.fbx; import com.jme3.asset.TextureKey; +import com.jme3.asset.cache.AssetCache; +import com.jme3.asset.cache.WeakRefCloneAssetCache; import com.jme3.export.InputCapsule; import com.jme3.export.JmeExporter; import com.jme3.export.JmeImporter; @@ -56,6 +58,13 @@ public class ContentTextureKey extends TextureKey { return content; } + @Override + public Class getCacheType(){ + // Need to override this so that textures embedded in FBX + // don't get cached by the asset manager. + return null; + } + @Override public String toString() { return super.toString() + " " + content.length + " bytes"; diff --git a/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/file/FBXDump.java b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/file/FBXDump.java index f309a5052..718a18b0a 100644 --- a/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/file/FBXDump.java +++ b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/file/FBXDump.java @@ -37,7 +37,6 @@ import java.lang.reflect.Array; import java.text.DecimalFormat; import java.util.HashMap; import java.util.Map; -import static org.omg.IOP.IORHelper.id; /** * Quick n' dirty dumper of FBX binary files. From 0a5b68983e0631d32d30aa83413257e1f1c84d82 Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Sun, 19 Apr 2015 13:33:43 -0400 Subject: [PATCH 018/113] FBX: Rename FBX -> Fbx. Support FBX 6.x IDs in FbxDump. --- .../jme3/scene/plugins/fbx/SceneLoader.java | 84 +++++------ .../fbx/file/{FBXDump.java => FbxDump.java} | 0 .../file/{FBXElement.java => FbxElement.java} | 0 .../fbx/file/{FBXFile.java => FbxFile.java} | 0 .../jme3/scene/plugins/fbx/file/FbxId.java | 130 ++++++++++++++++++ .../file/{FBXReader.java => FbxReader.java} | 0 6 files changed, 172 insertions(+), 42 deletions(-) rename jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/file/{FBXDump.java => FbxDump.java} (100%) rename jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/file/{FBXElement.java => FbxElement.java} (100%) rename jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/file/{FBXFile.java => FbxFile.java} (100%) create mode 100644 jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/file/FbxId.java rename jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/file/{FBXReader.java => FbxReader.java} (100%) diff --git a/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/SceneLoader.java b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/SceneLoader.java index e767763e1..491301c22 100644 --- a/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/SceneLoader.java +++ b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/SceneLoader.java @@ -73,9 +73,9 @@ import com.jme3.scene.Mesh.Mode; import com.jme3.scene.VertexBuffer.Type; import com.jme3.scene.VertexBuffer.Usage; import com.jme3.scene.plugins.fbx.AnimationList.AnimInverval; -import com.jme3.scene.plugins.fbx.file.FBXElement; -import com.jme3.scene.plugins.fbx.file.FBXFile; -import com.jme3.scene.plugins.fbx.file.FBXReader; +import com.jme3.scene.plugins.fbx.file.FbxElement; +import com.jme3.scene.plugins.fbx.file.FbxFile; +import com.jme3.scene.plugins.fbx.file.FbxReader; import com.jme3.texture.Image; import com.jme3.texture.Texture; import com.jme3.texture.Texture2D; @@ -165,8 +165,8 @@ public class SceneLoader implements AssetLoader { private void loadScene(InputStream stream) throws IOException { logger.log(Level.FINE, "Loading scene {0}", sceneFilename); long startTime = System.currentTimeMillis(); - FBXFile scene = FBXReader.readFBX(stream); - for(FBXElement e : scene.rootElements) { + FbxFile scene = FbxReader.readFBX(stream); + for(FbxElement e : scene.rootElements) { if(e.id.equals("GlobalSettings")) loadGlobalSettings(e); else if(e.id.equals("Objects")) @@ -178,10 +178,10 @@ public class SceneLoader implements AssetLoader { logger.log(Level.FINE, "Loading done in {0} ms", estimatedTime); } - private void loadGlobalSettings(FBXElement element) { - for(FBXElement e : element.children) { + private void loadGlobalSettings(FbxElement element) { + for(FbxElement e : element.children) { if(e.id.equals("Properties70")) { - for(FBXElement e2 : e.children) { + for(FbxElement e2 : e.children) { if(e2.id.equals("P")) { String propName = (String) e2.properties.get(0); if(propName.equals("UnitScaleFactor")) @@ -197,8 +197,8 @@ public class SceneLoader implements AssetLoader { } } - private void loadObjects(FBXElement element) { - for(FBXElement e : element.children) { + private void loadObjects(FbxElement element) { + for(FbxElement e : element.children) { if(e.id.equals("Geometry")) loadGeometry(e); else if(e.id.equals("Material")) @@ -222,12 +222,12 @@ public class SceneLoader implements AssetLoader { } } - private void loadGeometry(FBXElement element) { + private void loadGeometry(FbxElement element) { long id = (Long) element.properties.get(0); String type = (String) element.properties.get(2); if(type.equals("Mesh")) { MeshData data = new MeshData(); - for(FBXElement e : element.children) { + for(FbxElement e : element.children) { if(e.id.equals("Vertices")) data.vertices = (double[]) e.properties.get(0); else if(e.id.equals("PolygonVertexIndex")) @@ -236,7 +236,7 @@ public class SceneLoader implements AssetLoader { //else if(e.id.equals("Edges")) // data.edges = (int[]) e.properties.get(0); else if(e.id.equals("LayerElementNormal")) - for(FBXElement e2 : e.children) { + for(FbxElement e2 : e.children) { if(e2.id.equals("MappingInformationType")) { data.normalsMapping = (String) e2.properties.get(0); if(!data.normalsMapping.equals("ByVertice") && !data.normalsMapping.equals("ByPolygonVertex")) @@ -249,7 +249,7 @@ public class SceneLoader implements AssetLoader { data.normals = (double[]) e2.properties.get(0); } else if(e.id.equals("LayerElementTangent")) - for(FBXElement e2 : e.children) { + for(FbxElement e2 : e.children) { if(e2.id.equals("MappingInformationType")) { data.tangentsMapping = (String) e2.properties.get(0); if(!data.tangentsMapping.equals("ByVertice") && !data.tangentsMapping.equals("ByPolygonVertex")) @@ -262,7 +262,7 @@ public class SceneLoader implements AssetLoader { data.tangents = (double[]) e2.properties.get(0); } else if(e.id.equals("LayerElementBinormal")) - for(FBXElement e2 : e.children) { + for(FbxElement e2 : e.children) { if(e2.id.equals("MappingInformationType")) { data.binormalsMapping = (String) e2.properties.get(0); if(!data.binormalsMapping.equals("ByVertice") && !data.binormalsMapping.equals("ByPolygonVertex")) @@ -275,7 +275,7 @@ public class SceneLoader implements AssetLoader { data.binormals = (double[]) e2.properties.get(0); } else if(e.id.equals("LayerElementUV")) - for(FBXElement e2 : e.children) { + for(FbxElement e2 : e.children) { if(e2.id.equals("MappingInformationType")) { data.uvMapping = (String) e2.properties.get(0); if(!data.uvMapping.equals("ByPolygonVertex")) @@ -291,7 +291,7 @@ public class SceneLoader implements AssetLoader { } // TODO smoothing is not used now //else if(e.id.equals("LayerElementSmoothing")) - // for(FBXElement e2 : e.children) { + // for(FbxElement e2 : e.children) { // if(e2.id.equals("MappingInformationType")) { // data.smoothingMapping = (String) e2.properties.get(0); // if(!data.smoothingMapping.equals("ByEdge")) @@ -304,7 +304,7 @@ public class SceneLoader implements AssetLoader { // data.smoothing = (int[]) e2.properties.get(0); // } else if(e.id.equals("LayerElementMaterial")) - for(FBXElement e2 : e.children) { + for(FbxElement e2 : e.children) { if(e2.id.equals("MappingInformationType")) { data.materialsMapping = (String) e2.properties.get(0); if(!data.materialsMapping.equals("AllSame")) @@ -321,18 +321,18 @@ public class SceneLoader implements AssetLoader { } } - private void loadMaterial(FBXElement element) { + private void loadMaterial(FbxElement element) { long id = (Long) element.properties.get(0); String path = (String) element.properties.get(1); String type = (String) element.properties.get(2); if(type.equals("")) { MaterialData data = new MaterialData(); data.name = path.substring(0, path.indexOf(0)); - for(FBXElement e : element.children) { + for(FbxElement e : element.children) { if(e.id.equals("ShadingModel")) { data.shadingModel = (String) e.properties.get(0); } else if(e.id.equals("Properties70")) { - for(FBXElement e2 : e.children) { + for(FbxElement e2 : e.children) { if(e2.id.equals("P")) { String propName = (String) e2.properties.get(0); if(propName.equals("AmbientColor")) { @@ -368,16 +368,16 @@ public class SceneLoader implements AssetLoader { } } - private void loadModel(FBXElement element) { + private void loadModel(FbxElement element) { long id = (Long) element.properties.get(0); String path = (String) element.properties.get(1); String type = (String) element.properties.get(2); ModelData data = new ModelData(); data.name = path.substring(0, path.indexOf(0)); data.type = type; - for(FBXElement e : element.children) { + for(FbxElement e : element.children) { if(e.id.equals("Properties70")) { - for(FBXElement e2 : e.children) { + for(FbxElement e2 : e.children) { if(e2.id.equals("P")) { String propName = (String) e2.properties.get(0); if(propName.equals("Lcl Translation")) { @@ -408,17 +408,17 @@ public class SceneLoader implements AssetLoader { modelDataMap.put(id, data); } - private void loadPose(FBXElement element) { + private void loadPose(FbxElement element) { long id = (Long) element.properties.get(0); String path = (String) element.properties.get(1); String type = (String) element.properties.get(2); if(type.equals("BindPose")) { BindPoseData data = new BindPoseData(); data.name = path.substring(0, path.indexOf(0)); - for(FBXElement e : element.children) { + for(FbxElement e : element.children) { if(e.id.equals("PoseNode")) { NodeTransformData item = new NodeTransformData(); - for(FBXElement e2 : e.children) { + for(FbxElement e2 : e.children) { if(e2.id.equals("Node")) item.nodeId = (Long) e2.properties.get(0); else if(e2.id.equals("Matrix")) @@ -431,14 +431,14 @@ public class SceneLoader implements AssetLoader { } } - private void loadTexture(FBXElement element) { + private void loadTexture(FbxElement element) { long id = (Long) element.properties.get(0); String path = (String) element.properties.get(1); String type = (String) element.properties.get(2); if(type.equals("")) { TextureData data = new TextureData(); data.name = path.substring(0, path.indexOf(0)); - for(FBXElement e : element.children) { + for(FbxElement e : element.children) { if(e.id.equals("Type")) data.bindType = (String) e.properties.get(0); else if(e.id.equals("FileName")) @@ -448,14 +448,14 @@ public class SceneLoader implements AssetLoader { } } - private void loadImage(FBXElement element) { + private void loadImage(FbxElement element) { long id = (Long) element.properties.get(0); String path = (String) element.properties.get(1); String type = (String) element.properties.get(2); if(type.equals("Clip")) { ImageData data = new ImageData(); data.name = path.substring(0, path.indexOf(0)); - for(FBXElement e : element.children) { + for(FbxElement e : element.children) { if(e.id.equals("Type")) data.type = (String) e.properties.get(0); else if(e.id.equals("FileName")) @@ -471,19 +471,19 @@ public class SceneLoader implements AssetLoader { } } - private void loadDeformer(FBXElement element) { + private void loadDeformer(FbxElement element) { long id = (Long) element.properties.get(0); String type = (String) element.properties.get(2); if(type.equals("Skin")) { SkinData skinData = new SkinData(); - for(FBXElement e : element.children) { + for(FbxElement e : element.children) { if(e.id.equals("SkinningType")) skinData.type = (String) e.properties.get(0); } skinMap.put(id, skinData); } else if(type.equals("Cluster")) { ClusterData clusterData = new ClusterData(); - for(FBXElement e : element.children) { + for(FbxElement e : element.children) { if(e.id.equals("Indexes")) clusterData.indexes = (int[]) e.properties.get(0); else if(e.id.equals("Weights")) @@ -497,7 +497,7 @@ public class SceneLoader implements AssetLoader { } } - private void loadAnimLayer(FBXElement element) { + private void loadAnimLayer(FbxElement element) { long id = (Long) element.properties.get(0); String path = (String) element.properties.get(1); String type = (String) element.properties.get(2); @@ -508,12 +508,12 @@ public class SceneLoader implements AssetLoader { } } - private void loadAnimCurve(FBXElement element) { + private void loadAnimCurve(FbxElement element) { long id = (Long) element.properties.get(0); String type = (String) element.properties.get(2); if(type.equals("")) { AnimCurveData data = new AnimCurveData(); - for(FBXElement e : element.children) { + for(FbxElement e : element.children) { if(e.id.equals("KeyTime")) data.keyTimes = (long[]) e.properties.get(0); else if(e.id.equals("KeyValueFloat")) @@ -523,15 +523,15 @@ public class SceneLoader implements AssetLoader { } } - private void loadAnimNode(FBXElement element) { + private void loadAnimNode(FbxElement element) { long id = (Long) element.properties.get(0); String path = (String) element.properties.get(1); String type = (String) element.properties.get(2); if(type.equals("")) { Double x = null, y = null, z = null; - for(FBXElement e : element.children) { + for(FbxElement e : element.children) { if(e.id.equals("Properties70")) { - for(FBXElement e2 : e.children) { + for(FbxElement e2 : e.children) { if(e2.id.equals("P")) { String propName = (String) e2.properties.get(0); if(propName.equals("d|X")) @@ -554,8 +554,8 @@ public class SceneLoader implements AssetLoader { } } - private void loadConnections(FBXElement element) { - for(FBXElement e : element.children) { + private void loadConnections(FbxElement element) { + for(FbxElement e : element.children) { if(e.id.equals("C")) { String type = (String) e.properties.get(0); long objId, refId; diff --git a/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/file/FBXDump.java b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/file/FbxDump.java similarity index 100% rename from jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/file/FBXDump.java rename to jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/file/FbxDump.java diff --git a/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/file/FBXElement.java b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/file/FbxElement.java similarity index 100% rename from jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/file/FBXElement.java rename to jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/file/FbxElement.java diff --git a/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/file/FBXFile.java b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/file/FbxFile.java similarity index 100% rename from jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/file/FBXFile.java rename to jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/file/FbxFile.java diff --git a/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/file/FbxId.java b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/file/FbxId.java new file mode 100644 index 000000000..e3c753052 --- /dev/null +++ b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/file/FbxId.java @@ -0,0 +1,130 @@ +/* + * Copyright (c) 2009-2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ +package com.jme3.scene.plugins.fbx.file; + +public abstract class FbxId { + + public static final FbxId ROOT = new LongFbxId(0); + + protected FbxId() { } + + private static final class StringFbxId extends FbxId { + + private final String id; + + public StringFbxId(String id) { + this.id = id; + } + + @Override + public int hashCode() { + return id.hashCode(); + } + + @Override + public boolean equals(Object obj) { + if (obj == null || obj.getClass() != StringFbxId.class) { + return false; + } + return this.id.equals(((StringFbxId) obj).id); + } + + @Override + public String toString() { + return id; + } + + @Override + public boolean isNull() { + return id.equals("Scene\u0000\u0001Model"); + } + } + + private static final class LongFbxId extends FbxId { + + private final long id; + + public LongFbxId(long id) { + this.id = id; + } + + @Override + public int hashCode() { + return (int) (this.id ^ (this.id >>> 32)); + } + + @Override + public boolean equals(Object obj) { + if (obj == null || obj.getClass() != LongFbxId.class) { + return false; + } + return this.id == ((LongFbxId) obj).id; + } + + @Override + public boolean isNull() { + return id == 0; + } + + @Override + public String toString() { + return Long.toString(id); + } + } + + public abstract boolean isNull(); + + public static FbxId create(Object obj) { + if (obj instanceof Long) { + return new LongFbxId((Long)obj); + } else if (obj instanceof String) { + return new StringFbxId((String)obj); + } else { + throw new UnsupportedOperationException("Unsupported ID object type: " + obj.getClass()); + } + } + + public static FbxId getObjectId(FbxElement el) { + if (el.propertiesTypes.length == 2 + && el.propertiesTypes[0] == 'S' + && el.propertiesTypes[1] == 'S') { + return new StringFbxId((String) el.properties.get(0)); + } else if (el.propertiesTypes.length == 3 + && el.propertiesTypes[0] == 'L' + && el.propertiesTypes[1] == 'S' + && el.propertiesTypes[2] == 'S') { + return new LongFbxId((Long) el.properties.get(0)); + } else { + return null; + } + } +} diff --git a/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/file/FBXReader.java b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/file/FbxReader.java similarity index 100% rename from jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/file/FBXReader.java rename to jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/file/FbxReader.java From 6f29772862ff7644b7dcddb5a458ac8bebca214b Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Sun, 19 Apr 2015 13:42:25 -0400 Subject: [PATCH 019/113] FBX: fix build error due to rename --- .../jme3/scene/plugins/fbx/file/FbxDump.java | 75 +++++++++++-------- .../scene/plugins/fbx/file/FbxElement.java | 70 +++++++++++++++-- .../jme3/scene/plugins/fbx/file/FbxFile.java | 8 +- .../scene/plugins/fbx/file/FbxReader.java | 22 +++--- 4 files changed, 126 insertions(+), 49 deletions(-) diff --git a/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/file/FbxDump.java b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/file/FbxDump.java index 718a18b0a..00619dce7 100644 --- a/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/file/FbxDump.java +++ b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/file/FbxDump.java @@ -37,6 +37,8 @@ import java.lang.reflect.Array; import java.text.DecimalFormat; import java.util.HashMap; import java.util.Map; +import java.util.logging.Level; +import java.util.logging.Logger; /** * Quick n' dirty dumper of FBX binary files. @@ -45,12 +47,14 @@ import java.util.Map; * * @author Kirill Vainer */ -public final class FBXDump { +public final class FbxDump { + + private static final Logger logger = Logger.getLogger(FbxDump.class.getName()); private static final DecimalFormat DECIMAL_FORMAT = new DecimalFormat("0.0000000000"); - private FBXDump() { } + private FbxDump() { } /** * Creates a map between object UIDs and the objects themselves. @@ -58,16 +62,17 @@ public final class FBXDump { * @param file The file to create the mappings for. * @return The UID to object map. */ - private static Map createUidToObjectMap(FBXFile file) { - Map uidToObjectMap = new HashMap(); - for (FBXElement rootElement : file.rootElements) { + private static Map createUidToObjectMap(FbxFile file) { + Map uidToObjectMap = new HashMap(); + for (FbxElement rootElement : file.rootElements) { if (rootElement.id.equals("Objects")) { - for (FBXElement fbxObj : rootElement.children) { - if (fbxObj.propertiesTypes[0] != 'L') { - continue; // error + for (FbxElement fbxObj : rootElement.children) { + FbxId uid = FbxId.getObjectId(fbxObj); + if (uid != null) { + uidToObjectMap.put(uid, fbxObj); + } else { + logger.log(Level.WARNING, "Cannot determine ID for object: {0}", fbxObj); } - Long uid = (Long) fbxObj.properties.get(0); - uidToObjectMap.put(uid, fbxObj); } } } @@ -79,8 +84,8 @@ public final class FBXDump { * * @param file the file to dump. */ - public static void dumpFBX(FBXFile file) { - dumpFBX(file, System.out); + public static void dumpFile(FbxFile file) { + dumpFile(file, System.out); } /** @@ -89,11 +94,11 @@ public final class FBXDump { * @param file the file to dump. * @param out the output stream where to output. */ - public static void dumpFBX(FBXFile file, OutputStream out) { - Map uidToObjectMap = createUidToObjectMap(file); + public static void dumpFile(FbxFile file, OutputStream out) { + Map uidToObjectMap = createUidToObjectMap(file); PrintStream ps = new PrintStream(out); - for (FBXElement rootElement : file.rootElements) { - dumpFBXElement(rootElement, ps, 0, uidToObjectMap); + for (FbxElement rootElement : file.rootElements) { + dumpElement(rootElement, ps, 0, uidToObjectMap); } } @@ -112,9 +117,9 @@ public final class FBXDump { return string.replaceAll("\u0000\u0001", "::"); } - protected static void dumpFBXProperty(String id, char propertyType, + protected static void dumpProperty(String id, char propertyType, Object property, PrintStream ps, - Map uidToObjectMap) { + Map uidToObjectMap) { switch (propertyType) { case 'S': // String @@ -124,13 +129,19 @@ public final class FBXDump { case 'R': // RAW data. byte[] bytes = (byte[]) property; - ps.print("["); - for (int j = 0; j < bytes.length; j++) { + int numToPrint = Math.min(10 * 1024, bytes.length); + ps.print("(size = "); + ps.print(bytes.length); + ps.print(") ["); + for (int j = 0; j < numToPrint; j++) { ps.print(String.format("%02X", bytes[j] & 0xff)); if (j != bytes.length - 1) { ps.print(" "); } } + if (numToPrint < bytes.length) { + ps.print(" ..."); + } ps.print("]"); break; case 'D': @@ -158,7 +169,7 @@ public final class FBXDump { // If this is a connection, decode UID into object name. if (id.equals("C")) { Long uid = (Long) property; - FBXElement element = uidToObjectMap.get(uid); + FbxElement element = uidToObjectMap.get(FbxId.create(uid)); if (element != null) { String name = (String) element.properties.get(1); ps.print("\"" + convertFBXString(name) + "\""); @@ -177,7 +188,7 @@ public final class FBXDump { int length = Array.getLength(property); for (int j = 0; j < length; j++) { Object arrayEntry = Array.get(property, j); - dumpFBXProperty(id, Character.toUpperCase(propertyType), arrayEntry, ps, uidToObjectMap); + dumpProperty(id, Character.toUpperCase(propertyType), arrayEntry, ps, uidToObjectMap); if (j != length - 1) { ps.print(","); } @@ -188,24 +199,24 @@ public final class FBXDump { } } - protected static void dumpFBXElement(FBXElement el, PrintStream ps, - int indent, Map uidToObjectMap) { + protected static void dumpElement(FbxElement el, PrintStream ps, + int indent, Map uidToObjectMap) { // 4 spaces per tab should be OK. String indentStr = indent(indent * 4); String textId = el.id; // Properties are called 'P' and connections are called 'C'. - if (el.id.equals("P")) { - textId = "Property"; - } else if (el.id.equals("C")) { - textId = "Connect"; - } +// if (el.id.equals("P")) { +// textId = "Property"; +// } else if (el.id.equals("C")) { +// textId = "Connect"; +// } ps.print(indentStr + textId + ": "); for (int i = 0; i < el.properties.size(); i++) { Object property = el.properties.get(i); char propertyType = el.propertiesTypes[i]; - dumpFBXProperty(el.id, propertyType, property, ps, uidToObjectMap); + dumpProperty(el.id, propertyType, property, ps, uidToObjectMap); if (i != el.properties.size() - 1) { ps.print(", "); } @@ -214,8 +225,8 @@ public final class FBXDump { ps.println(); } else { ps.println(" {"); - for (FBXElement childElement : el.children) { - dumpFBXElement(childElement, ps, indent + 1, uidToObjectMap); + for (FbxElement childElement : el.children) { + dumpElement(childElement, ps, indent + 1, uidToObjectMap); } ps.println(indentStr + "}"); } diff --git a/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/file/FbxElement.java b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/file/FbxElement.java index eeeee872c..1a4d09d53 100644 --- a/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/file/FbxElement.java +++ b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/file/FbxElement.java @@ -34,7 +34,7 @@ package com.jme3.scene.plugins.fbx.file; import java.util.ArrayList; import java.util.List; -public class FBXElement { +public class FbxElement { public String id; public List properties; @@ -55,10 +55,70 @@ public class FBXElement { * c - array of unsigned bytes (represented as array of ints) */ public char[] propertiesTypes; - public List children = new ArrayList(); + public List children = new ArrayList(); - public FBXElement(int propsCount) { - properties = new ArrayList(propsCount); - propertiesTypes = new char[propsCount]; + public FbxElement(int propsCount) { + this.properties = new ArrayList(propsCount); + this.propertiesTypes = new char[propsCount]; } + + public FbxElement getChildById(String name) { + for (FbxElement element : children) { + if (element.id.equals(name)) { + return element; + } + } + return null; + } + + public List getFbxProperties() { + List props = new ArrayList(); + FbxElement propsElement = null; + boolean legacy = false; + + for (FbxElement element : children) { + if (element.id.equals("Properties70")) { + propsElement = element; + break; + } else if (element.id.equals("Properties60")) { + legacy = true; + propsElement = element; + break; + } + } + + if (propsElement == null) { + return props; + } + + for (FbxElement prop : propsElement.children) { + if (prop.id.equals("P") || prop.id.equals("Property")) { + if (legacy) { + char[] types = new char[prop.propertiesTypes.length + 1]; + types[0] = prop.propertiesTypes[0]; + types[1] = prop.propertiesTypes[0]; + System.arraycopy(prop.propertiesTypes, 1, types, 2, types.length - 2); + + List values = new ArrayList(prop.properties); + values.add(1, values.get(0)); + + FbxElement dummyProp = new FbxElement(types.length); + dummyProp.children = prop.children; + dummyProp.id = prop.id; + dummyProp.propertiesTypes = types; + dummyProp.properties = values; + props.add(dummyProp); + } else { + props.add(prop); + } + } + } + + return props; + } + + @Override + public String toString() { + return "FBXElement[id=" + id + ", numProps=" + properties.size() + ", numChildren=" + children.size() + "]"; + } } diff --git a/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/file/FbxFile.java b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/file/FbxFile.java index ba81f1a74..9435b4c4e 100644 --- a/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/file/FbxFile.java +++ b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/file/FbxFile.java @@ -34,9 +34,13 @@ package com.jme3.scene.plugins.fbx.file; import java.util.ArrayList; import java.util.List; -public class FBXFile { +public class FbxFile { - public List rootElements = new ArrayList(); + public List rootElements = new ArrayList(); public long version; + @Override + public String toString() { + return "FBXFile[version=" + version + ",numElements=" + rootElements.size() + "]"; + } } diff --git a/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/file/FbxReader.java b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/file/FbxReader.java index b39dfef1c..22e93d8db 100644 --- a/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/file/FbxReader.java +++ b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/file/FbxReader.java @@ -40,8 +40,8 @@ import java.nio.ByteOrder; import java.util.Arrays; import java.util.zip.InflaterInputStream; -public class FBXReader { - +public class FbxReader { + public static final int BLOCK_SENTINEL_LENGTH = 13; public static final byte[] BLOCK_SENTINEL_DATA = new byte[BLOCK_SENTINEL_LENGTH]; /** @@ -49,9 +49,9 @@ public class FBXReader { * "Kaydara FBX Binary\x20\x20\x00\x1a\x00" */ public static final byte[] HEAD_MAGIC = new byte[]{0x4b, 0x61, 0x79, 0x64, 0x61, 0x72, 0x61, 0x20, 0x46, 0x42, 0x58, 0x20, 0x42, 0x69, 0x6e, 0x61, 0x72, 0x79, 0x20, 0x20, 0x00, 0x1a, 0x00}; - - public static FBXFile readFBX(InputStream stream) throws IOException { - FBXFile fbxFile = new FBXFile(); + + public static FbxFile readFBX(InputStream stream) throws IOException { + FbxFile fbxFile = new FbxFile(); // Read file to byte buffer so we can know current position in file ByteBuffer byteBuffer = readToByteBuffer(stream); try { @@ -61,27 +61,29 @@ public class FBXReader { // Check majic header byte[] majic = getBytes(byteBuffer, HEAD_MAGIC.length); if(!Arrays.equals(HEAD_MAGIC, majic)) - throw new IOException("Not FBX file"); + throw new IOException("Either ASCII FBX or corrupt file. " + + "Only binary FBX files are supported"); + // Read version fbxFile.version = getUInt(byteBuffer); // Read root elements while(true) { - FBXElement e = readFBXElement(byteBuffer); + FbxElement e = readFBXElement(byteBuffer); if(e == null) break; fbxFile.rootElements.add(e); } return fbxFile; } - - private static FBXElement readFBXElement(ByteBuffer byteBuffer) throws IOException { + + private static FbxElement readFBXElement(ByteBuffer byteBuffer) throws IOException { long endOffset = getUInt(byteBuffer); if(endOffset == 0) return null; long propCount = getUInt(byteBuffer); getUInt(byteBuffer); // Properties length unused - FBXElement element = new FBXElement((int) propCount); + FbxElement element = new FbxElement((int) propCount); element.id = new String(getBytes(byteBuffer, getUByte(byteBuffer))); for(int i = 0; i < propCount; ++i) { From ed2be5e54208d8b8fc21987804f025046e950493 Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Sun, 19 Apr 2015 18:08:28 -0400 Subject: [PATCH 020/113] FBX: new FBX importer (not yet enabled - old importer still used by default) Still needs work: * Skeletal animation (many issues with transform hierarchies) * N-gons triangulation (only quads supported at the moment) * Light & Camera importing * Z-up to Y-up correction * Morph animation --- .../com/jme3/scene/plugins/fbx/FbxLoader.java | 413 ++++++++++++ .../scene/plugins/fbx/anim/FbxAnimCurve.java | 144 ++++ .../plugins/fbx/anim/FbxAnimCurveNode.java | 147 +++++ .../scene/plugins/fbx/anim/FbxAnimLayer.java | 82 +++ .../scene/plugins/fbx/anim/FbxAnimStack.java | 111 ++++ .../scene/plugins/fbx/anim/FbxAnimUtil.java | 44 ++ .../scene/plugins/fbx/anim/FbxBindPose.java | 103 +++ .../scene/plugins/fbx/anim/FbxCluster.java | 98 +++ .../scene/plugins/fbx/anim/FbxLimbNode.java | 94 +++ .../plugins/fbx/anim/FbxSkinDeformer.java | 66 ++ .../scene/plugins/fbx/anim/FbxToJmeTrack.java | 202 ++++++ .../scene/plugins/fbx/material/FbxImage.java | 190 ++++++ .../plugins/fbx/material/FbxMaterial.java | 363 +++++++++++ .../fbx/material/FbxMaterialProperties.java | 234 +++++++ .../plugins/fbx/material/FbxTexture.java | 146 +++++ .../jme3/scene/plugins/fbx/mesh/FbxLayer.java | 107 +++ .../plugins/fbx/mesh/FbxLayerElement.java | 243 +++++++ .../jme3/scene/plugins/fbx/mesh/FbxMesh.java | 316 +++++++++ .../scene/plugins/fbx/mesh/FbxMeshUtil.java | 69 ++ .../scene/plugins/fbx/mesh/FbxPolygon.java | 59 ++ .../plugins/fbx/misc/FbxGlobalSettings.java | 145 ++++ .../jme3/scene/plugins/fbx/node/FbxNode.java | 617 ++++++++++++++++++ .../plugins/fbx/node/FbxNodeAttribute.java | 41 ++ .../scene/plugins/fbx/node/FbxNodeUtil.java | 61 ++ .../plugins/fbx/node/FbxNullAttribute.java | 59 ++ .../scene/plugins/fbx/node/FbxRootNode.java | 45 ++ .../jme3/scene/plugins/fbx/obj/FbxObject.java | 144 ++++ .../plugins/fbx/obj/FbxObjectFactory.java | 209 ++++++ .../plugins/fbx/obj/FbxUnknownObject.java | 54 ++ .../jme3/scene/plugins/IrBoneWeightIndex.java | 89 +++ .../java/com/jme3/scene/plugins/IrMesh.java | 46 ++ .../com/jme3/scene/plugins/IrPolygon.java | 46 ++ .../java/com/jme3/scene/plugins/IrUtils.java | 400 ++++++++++++ .../java/com/jme3/scene/plugins/IrVertex.java | 170 +++++ 34 files changed, 5357 insertions(+) create mode 100644 jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/FbxLoader.java create mode 100644 jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/anim/FbxAnimCurve.java create mode 100644 jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/anim/FbxAnimCurveNode.java create mode 100644 jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/anim/FbxAnimLayer.java create mode 100644 jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/anim/FbxAnimStack.java create mode 100644 jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/anim/FbxAnimUtil.java create mode 100644 jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/anim/FbxBindPose.java create mode 100644 jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/anim/FbxCluster.java create mode 100644 jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/anim/FbxLimbNode.java create mode 100644 jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/anim/FbxSkinDeformer.java create mode 100644 jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/anim/FbxToJmeTrack.java create mode 100644 jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/material/FbxImage.java create mode 100644 jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/material/FbxMaterial.java create mode 100644 jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/material/FbxMaterialProperties.java create mode 100644 jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/material/FbxTexture.java create mode 100644 jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/mesh/FbxLayer.java create mode 100644 jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/mesh/FbxLayerElement.java create mode 100644 jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/mesh/FbxMesh.java create mode 100644 jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/mesh/FbxMeshUtil.java create mode 100644 jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/mesh/FbxPolygon.java create mode 100644 jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/misc/FbxGlobalSettings.java create mode 100644 jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/node/FbxNode.java create mode 100644 jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/node/FbxNodeAttribute.java create mode 100644 jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/node/FbxNodeUtil.java create mode 100644 jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/node/FbxNullAttribute.java create mode 100644 jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/node/FbxRootNode.java create mode 100644 jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/obj/FbxObject.java create mode 100644 jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/obj/FbxObjectFactory.java create mode 100644 jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/obj/FbxUnknownObject.java create mode 100644 jme3-plugins/src/main/java/com/jme3/scene/plugins/IrBoneWeightIndex.java create mode 100644 jme3-plugins/src/main/java/com/jme3/scene/plugins/IrMesh.java create mode 100644 jme3-plugins/src/main/java/com/jme3/scene/plugins/IrPolygon.java create mode 100644 jme3-plugins/src/main/java/com/jme3/scene/plugins/IrUtils.java create mode 100644 jme3-plugins/src/main/java/com/jme3/scene/plugins/IrVertex.java diff --git a/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/FbxLoader.java b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/FbxLoader.java new file mode 100644 index 000000000..fd157cb48 --- /dev/null +++ b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/FbxLoader.java @@ -0,0 +1,413 @@ +/* + * Copyright (c) 2009-2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ +package com.jme3.scene.plugins.fbx; + +import com.jme3.animation.AnimControl; +import com.jme3.animation.Animation; +import com.jme3.animation.Bone; +import com.jme3.animation.BoneTrack; +import com.jme3.animation.Skeleton; +import com.jme3.animation.Track; +import com.jme3.asset.AssetInfo; +import com.jme3.asset.AssetKey; +import com.jme3.asset.AssetLoadException; +import com.jme3.asset.AssetLoader; +import com.jme3.asset.AssetManager; +import com.jme3.asset.ModelKey; +import com.jme3.math.Matrix4f; +import com.jme3.math.Transform; +import com.jme3.scene.Node; +import com.jme3.scene.Spatial; +import com.jme3.scene.plugins.fbx.anim.FbxToJmeTrack; +import com.jme3.scene.plugins.fbx.anim.FbxAnimCurveNode; +import com.jme3.scene.plugins.fbx.anim.FbxAnimLayer; +import com.jme3.scene.plugins.fbx.anim.FbxAnimStack; +import com.jme3.scene.plugins.fbx.anim.FbxBindPose; +import com.jme3.scene.plugins.fbx.anim.FbxLimbNode; +import com.jme3.scene.plugins.fbx.file.FbxDump; +import com.jme3.scene.plugins.fbx.file.FbxElement; +import com.jme3.scene.plugins.fbx.file.FbxFile; +import com.jme3.scene.plugins.fbx.file.FbxReader; +import com.jme3.scene.plugins.fbx.file.FbxId; +import com.jme3.scene.plugins.fbx.misc.FbxGlobalSettings; +import com.jme3.scene.plugins.fbx.node.FbxNode; +import com.jme3.scene.plugins.fbx.node.FbxRootNode; +import com.jme3.scene.plugins.fbx.obj.FbxObjectFactory; +import com.jme3.scene.plugins.fbx.obj.FbxObject; +import java.io.IOException; +import java.io.InputStream; +import java.util.ArrayList; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.logging.Level; +import java.util.logging.Logger; + +public class FbxLoader implements AssetLoader { + + private static final Logger logger = Logger.getLogger(FbxLoader.class.getName()); + + private AssetManager assetManager; + + private String sceneName; + private String sceneFilename; + private String sceneFolderName; + private FbxGlobalSettings globalSettings; + private final Map objectMap = new HashMap(); + + private final List animStacks = new ArrayList(); + private final List bindPoses = new ArrayList(); + + @Override + public Object load(AssetInfo assetInfo) throws IOException { + this.assetManager = assetInfo.getManager(); + AssetKey assetKey = assetInfo.getKey(); + if (!(assetKey instanceof ModelKey)) { + throw new AssetLoadException("Invalid asset key"); + } + + InputStream stream = assetInfo.openStream(); + try { + sceneFilename = assetKey.getName(); + sceneFolderName = assetKey.getFolder(); + String ext = assetKey.getExtension(); + + sceneName = sceneFilename.substring(0, sceneFilename.length() - ext.length() - 1); + if (sceneFolderName != null && sceneFolderName.length() > 0) { + sceneName = sceneName.substring(sceneFolderName.length()); + } + + reset(); + + // Load the data from the stream. + loadData(stream); + + // Bind poses are needed to compute world transforms. + applyBindPoses(); + + // Need world transforms for skeleton creation. + updateWorldTransforms(); + + // Need skeletons for meshs to be created in scene graph construction. + // Mesh bone indices require skeletons to determine bone index. + constructSkeletons(); + + // Create the jME3 scene graph from the FBX scene graph. + // Also creates SkeletonControls based on the constructed skeletons. + Spatial scene = constructSceneGraph(); + + // Load animations into AnimControls + constructAnimations(); + + return scene; + } finally { + releaseObjects(); + if (stream != null) { + stream.close(); + } + } + } + + private void reset() { + globalSettings = new FbxGlobalSettings(); + } + + private void releaseObjects() { + globalSettings = null; + objectMap.clear(); + animStacks.clear(); + } + + private void loadData(InputStream stream) throws IOException { + FbxFile scene = FbxReader.readFBX(stream); + + FbxDump.dumpFile(scene); + + // TODO: Load FBX object templates + + for (FbxElement e : scene.rootElements) { + if (e.id.equals("FBXHeaderExtension")) { + loadHeader(e); + } else if (e.id.equals("GlobalSettings")) { + loadGlobalSettings(e); + } else if (e.id.equals("Objects")) { + loadObjects(e); + } else if (e.id.equals("Connections")) { + connectObjects(e); + } + } + } + + private void loadHeader(FbxElement element) { + for (FbxElement e : element.children) { + if (e.id.equals("FBXVersion")) { + Integer version = (Integer) e.properties.get(0); + if (version < 7100) { + logger.log(Level.WARNING, "FBX file version is older than 7.1. " + + "Some features may not work."); + } + } + } + } + + private void loadGlobalSettings(FbxElement element) { + globalSettings = new FbxGlobalSettings(); + globalSettings.fromElement(element); + } + + private void loadObjects(FbxElement element) { + // Initialize the FBX root element. + objectMap.put(FbxId.ROOT, new FbxRootNode(assetManager, sceneFolderName)); + + for(FbxElement e : element.children) { + if (e.id.equals("GlobalSettings")) { + // Old FBX files seem to have the GlobalSettings element + // under Objects (??) + globalSettings.fromElement(e); + } else { + FbxObject object = FbxObjectFactory.createObject(e, assetManager, sceneFolderName); + if (object != null) { + if (objectMap.containsKey(object.getId())) { + logger.log(Level.WARNING, "An object with ID \"{0}\" has " + + "already been defined. " + + "Ignoring.", + object.getId()); + } + + objectMap.put(object.getId(), object); + + if (object instanceof FbxAnimStack) { + // NOTE: animation stacks are implicitly global. + // Capture them here. + animStacks.add((FbxAnimStack) object); + } else if (object instanceof FbxBindPose) { + bindPoses.add((FbxBindPose) object); + } + } else { + throw new UnsupportedOperationException("Failed to create FBX object of type: " + e.id); + } + } + } + } + + private void removeUnconnectedObjects() { + for (FbxObject object : new ArrayList(objectMap.values())) { + if (!object.isJmeObjectCreated()) { + logger.log(Level.WARNING, "Purging orphan FBX object: {0}", object); + objectMap.remove(object.getId()); + } + } + } + + private void connectObjects(FbxElement element) { + if (objectMap.isEmpty()) { + logger.log(Level.WARNING, "FBX file is missing object information"); + return; + } else if (objectMap.size() == 1) { + // Only root node (automatically added by jME3) + logger.log(Level.WARNING, "FBX file has no objects"); + return; + } + + for (FbxElement el : element.children) { + if (!el.id.equals("C") && !el.id.equals("Connect")) { + continue; + } + String type = (String) el.properties.get(0); + FbxId childId; + FbxId parentId; + if (type.equals("OO")) { + childId = FbxId.create(el.properties.get(1)); + parentId = FbxId.create(el.properties.get(2)); + FbxObject child = objectMap.get(childId); + FbxObject parent; + + if (parentId.isNull()) { + // TODO: maybe clean this up a bit.. + parent = objectMap.get(FbxId.ROOT); + } else { + parent = objectMap.get(parentId); + } + + if (parent == null) { + throw new UnsupportedOperationException("Cannot find parent object ID \"" + parentId + "\""); + } + + parent.connectObject(child); + } else if (type.equals("OP")) { + childId = FbxId.create(el.properties.get(1)); + parentId = FbxId.create(el.properties.get(2)); + String propName = (String) el.properties.get(3); + FbxObject child = objectMap.get(childId); + FbxObject parent = objectMap.get(parentId); + parent.connectObjectProperty(child, propName); + } else { + logger.log(Level.WARNING, "Unknown connection type: {0}. Ignoring.", type); + } + } + } + + /** + * Copies the bind poses from FBX BindPose objects to FBX nodes. + * Must be called prior to {@link #updateWorldTransforms()}. + */ + private void applyBindPoses() { + for (FbxBindPose bindPose : bindPoses) { + Map bindPoseData = bindPose.getJmeObject(); + logger.log(Level.INFO, "Applying {0} bind poses", bindPoseData.size()); + for (Map.Entry entry : bindPoseData.entrySet()) { + FbxObject obj = objectMap.get(entry.getKey()); + if (obj instanceof FbxNode) { + FbxNode node = (FbxNode) obj; + node.setWorldBindPose(entry.getValue()); + } else { + logger.log(Level.WARNING, "Bind pose can only be applied to FBX nodes. Ignoring."); + } + } + } + } + + /** + * Updates world transforms and bind poses for the FBX scene graph. + */ + private void updateWorldTransforms() { + FbxNode fbxRoot = (FbxNode) objectMap.get(FbxId.ROOT); + fbxRoot.updateWorldTransforms(null, null); + } + + private void constructAnimations() { + // In FBX, animation are not attached to any root. + // They are implicitly global. + // So, we need to use hueristics to find which node(s) + // an animation is associated with, so we can create the AnimControl + // in the appropriate location in the scene. + Map pairs = new HashMap(); + for (FbxAnimStack stack : animStacks) { + for (FbxAnimLayer layer : stack.getLayers()) { + for (FbxAnimCurveNode curveNode : layer.getAnimationCurveNodes()) { + for (Map.Entry nodePropertyEntry : curveNode.getInfluencedNodeProperties().entrySet()) { + FbxToJmeTrack lookupPair = new FbxToJmeTrack(); + lookupPair.animStack = stack; + lookupPair.animLayer = layer; + lookupPair.node = nodePropertyEntry.getKey(); + + // Find if this pair is already stored + FbxToJmeTrack storedPair = pairs.get(lookupPair); + if (storedPair == null) { + // If not, store it. + storedPair = lookupPair; + pairs.put(storedPair, storedPair); + } + + String property = nodePropertyEntry.getValue(); + storedPair.animCurves.put(property, curveNode); + } + } + } + } + + // At this point we can construct the animation for all pairs ... + for (FbxToJmeTrack pair : pairs.values()) { + String animName = pair.animStack.getName(); + float duration = pair.animStack.getDuration(); + + System.out.println("ANIMATION: " + animName + ", duration = " + duration); + System.out.println("NODE: " + pair.node.getName()); + + duration = pair.getDuration(); + + if (pair.node instanceof FbxLimbNode) { + // Find the spatial that has the skeleton for this limb. + FbxLimbNode limbNode = (FbxLimbNode) pair.node; + Bone bone = limbNode.getJmeBone(); + Spatial jmeSpatial = limbNode.getSkeletonHolder().getJmeObject(); + Skeleton skeleton = limbNode.getSkeletonHolder().getJmeSkeleton(); + + // Get the animation control (create if missing). + AnimControl animControl = jmeSpatial.getControl(AnimControl.class); + if (animControl.getSkeleton() != skeleton) { + throw new UnsupportedOperationException(); + } + + // Get the animation (create if missing). + Animation anim = animControl.getAnim(animName); + if (anim == null) { + anim = new Animation(animName, duration); + animControl.addAnim(anim); + } + + // Find the bone index from the spatial's skeleton. + int boneIndex = skeleton.getBoneIndex(bone); + + // Generate the bone track. + BoneTrack bt = pair.toJmeBoneTrack(boneIndex, bone.getBindInverseTransform()); + + // Add the bone track to the animation. + anim.addTrack(bt); + } else { + // Create the spatial animation + Animation anim = new Animation(animName, duration); + anim.setTracks(new Track[]{ pair.toJmeSpatialTrack() }); + + // Get the animation control (create if missing). + Spatial jmeSpatial = pair.node.getJmeObject(); + AnimControl animControl = jmeSpatial.getControl(AnimControl.class); + + if (animControl == null) { + animControl = new AnimControl(null); + jmeSpatial.addControl(animControl); + } + + // Add the spatial animation + animControl.addAnim(anim); + } + } + } + + private void constructSkeletons() { + FbxNode fbxRoot = (FbxNode) objectMap.get(FbxId.ROOT); + FbxNode.createSkeletons(fbxRoot); + } + + private Spatial constructSceneGraph() { + // Acquire the implicit root object. + FbxNode fbxRoot = (FbxNode) objectMap.get(FbxId.ROOT); + + // Convert it into a jME3 scene + Node jmeRoot = (Node) FbxNode.createScene(fbxRoot); + + // Fix the name (will probably be set to something like "-node") + jmeRoot.setName(sceneName + "-scene"); + + return jmeRoot; + } +} diff --git a/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/anim/FbxAnimCurve.java b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/anim/FbxAnimCurve.java new file mode 100644 index 000000000..d266dcf95 --- /dev/null +++ b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/anim/FbxAnimCurve.java @@ -0,0 +1,144 @@ +/* + * Copyright (c) 2009-2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ +package com.jme3.scene.plugins.fbx.anim; + +import com.jme3.asset.AssetManager; +import com.jme3.math.FastMath; +import com.jme3.scene.plugins.fbx.file.FbxElement; +import com.jme3.scene.plugins.fbx.obj.FbxObject; + +public class FbxAnimCurve extends FbxObject { + + private long[] keyTimes; + private float[] keyValues; + + public FbxAnimCurve(AssetManager assetManager, String sceneFolderName) { + super(assetManager, sceneFolderName); + } + + @Override + public void fromElement(FbxElement element) { + super.fromElement(element); + + for (FbxElement e : element.children) { + if (e.id.equals("KeyTime")) { + keyTimes = (long[]) e.properties.get(0); + } else if (e.id.equals("KeyValueFloat")) { + keyValues = (float[]) e.properties.get(0); + } + } + + long time = -1; + for (int i = 0; i < keyTimes.length; i++) { + if (time >= keyTimes[i]) { + throw new UnsupportedOperationException("Keyframe times must be sequential, but they are not."); + } + time = keyTimes[i]; + } + } + + /** + * Get the times for the keyframes. + * @return Keyframe times. + */ + public long[] getKeyTimes() { + return keyTimes; + } + + /** + * Retrieve the curve value at the given time. + * If the curve has no data, 0 is returned. + * If the time is outside the curve, then the closest value is returned. + * If the time isn't on an exact keyframe, linear interpolation is used + * to determine the value between the keyframes at the given time. + * @param time The time to get the curve value at (in FBX time units). + * @return The value at the given time. + */ + public float getValueAtTime(long time) { + if (keyTimes.length == 0) { + return 0; + } + + // If the time is outside the range, + // we just return the closest value. (No extrapolation) + if (time <= keyTimes[0]) { + return keyValues[0]; + } else if (time >= keyTimes[keyTimes.length - 1]) { + return keyValues[keyValues.length - 1]; + } + + + + int startFrame = 0; + int endFrame = 1; + int lastFrame = keyTimes.length - 1; + + for (int i = 0; i < lastFrame && keyTimes[i] < time; ++i) { + startFrame = i; + endFrame = i + 1; + } + + long keyTime1 = keyTimes[startFrame]; + float keyValue1 = keyValues[startFrame]; + long keyTime2 = keyTimes[endFrame]; + float keyValue2 = keyValues[endFrame]; + + if (keyTime2 == time) { + return keyValue2; + } + + long prevToNextDelta = keyTime2 - keyTime1; + long prevToCurrentDelta = time - keyTime1; + float lerpAmount = (float)prevToCurrentDelta / prevToNextDelta; + + return FastMath.interpolateLinear(lerpAmount, keyValue1, keyValue2); + } + + @Override + protected Object toJmeObject() { + // An AnimCurve has no jME3 representation. + // The parent AnimCurveNode is responsible to create the jME3 + // representation. + throw new UnsupportedOperationException("No jME3 object conversion available"); + } + + @Override + public void connectObject(FbxObject object) { + unsupportedConnectObject(object); + } + + @Override + public void connectObjectProperty(FbxObject object, String property) { + unsupportedConnectObjectProperty(object, property); + } + +} diff --git a/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/anim/FbxAnimCurveNode.java b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/anim/FbxAnimCurveNode.java new file mode 100644 index 000000000..e8dbe7fc0 --- /dev/null +++ b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/anim/FbxAnimCurveNode.java @@ -0,0 +1,147 @@ +/* + * Copyright (c) 2009-2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ +package com.jme3.scene.plugins.fbx.anim; + +import com.jme3.asset.AssetManager; +import com.jme3.math.FastMath; +import com.jme3.math.Quaternion; +import com.jme3.math.Vector3f; +import com.jme3.scene.plugins.fbx.file.FbxElement; +import com.jme3.scene.plugins.fbx.node.FbxNode; +import com.jme3.scene.plugins.fbx.obj.FbxObject; +import java.util.Collection; +import java.util.HashMap; +import java.util.Map; +import java.util.logging.Level; +import java.util.logging.Logger; + +public class FbxAnimCurveNode extends FbxObject { + + private static final Logger logger = Logger.getLogger(FbxAnimCurveNode.class.getName()); + + private final Map influencedNodePropertiesMap = new HashMap(); + private final Map propertyToCurveMap = new HashMap(); + private final Map propertyToDefaultMap = new HashMap(); + + public FbxAnimCurveNode(AssetManager assetManager, String sceneFolderName) { + super(assetManager, sceneFolderName); + } + + @Override + public void fromElement(FbxElement element) { + super.fromElement(element); + for (FbxElement prop : element.getFbxProperties()) { + String propName = (String) prop.properties.get(0); + String propType = (String) prop.properties.get(1); + if (propType.equals("Number")) { + float propValue = ((Double) prop.properties.get(4)).floatValue(); + propertyToDefaultMap.put(propName, propValue); + } + } + } + + public void addInfluencedNode(FbxNode node, String property) { + influencedNodePropertiesMap.put(node, property); + } + + public Map getInfluencedNodeProperties() { + return influencedNodePropertiesMap; + } + + public Collection getCurves() { + return propertyToCurveMap.values(); + } + + public Vector3f getVector3Value(long time) { + Vector3f value = new Vector3f(); + FbxAnimCurve xCurve = propertyToCurveMap.get(FbxAnimUtil.CURVE_NODE_PROPERTY_X); + FbxAnimCurve yCurve = propertyToCurveMap.get(FbxAnimUtil.CURVE_NODE_PROPERTY_Y); + FbxAnimCurve zCurve = propertyToCurveMap.get(FbxAnimUtil.CURVE_NODE_PROPERTY_Z); + Float xDefault = propertyToDefaultMap.get(FbxAnimUtil.CURVE_NODE_PROPERTY_X); + Float yDefault = propertyToDefaultMap.get(FbxAnimUtil.CURVE_NODE_PROPERTY_Y); + Float zDefault = propertyToDefaultMap.get(FbxAnimUtil.CURVE_NODE_PROPERTY_Z); + value.x = xCurve != null ? xCurve.getValueAtTime(time) : xDefault; + value.y = yCurve != null ? yCurve.getValueAtTime(time) : yDefault; + value.z = zCurve != null ? zCurve.getValueAtTime(time) : zDefault; + return value; + } + + /** + * Converts the euler angles from {@link #getVector3Value(long)} to + * a quaternion rotation. + * @param time Time at which to get the euler angles. + * @return The rotation at time + */ + public Quaternion getQuaternionValue(long time) { + Vector3f eulerAngles = getVector3Value(time); + System.out.println("\tT: " + time + ". Rotation: " + + eulerAngles.x + ", " + + eulerAngles.y + ", " + eulerAngles.z); + Quaternion q = new Quaternion(); + q.fromAngles(eulerAngles.x * FastMath.DEG_TO_RAD, + eulerAngles.y * FastMath.DEG_TO_RAD, + eulerAngles.z * FastMath.DEG_TO_RAD); + return q; + } + + @Override + protected Object toJmeObject() { + throw new UnsupportedOperationException(); + } + + @Override + public void connectObject(FbxObject object) { + unsupportedConnectObject(object); + } + + @Override + public void connectObjectProperty(FbxObject object, String property) { + if (!(object instanceof FbxAnimCurve)) { + unsupportedConnectObjectProperty(object, property); + } + if (!property.equals(FbxAnimUtil.CURVE_NODE_PROPERTY_X) && + !property.equals(FbxAnimUtil.CURVE_NODE_PROPERTY_Y) && + !property.equals(FbxAnimUtil.CURVE_NODE_PROPERTY_Z) && + !property.equals(FbxAnimUtil.CURVE_NODE_PROPERTY_VISIBILITY)) { + logger.log(Level.WARNING, "Animating the dimension ''{0}'' is not " + + "supported yet. Ignoring.", property); + return; + } + + if (propertyToCurveMap.containsKey(property)) { + throw new UnsupportedOperationException("!"); + } + + propertyToCurveMap.put(property, (FbxAnimCurve) object); + } + +} diff --git a/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/anim/FbxAnimLayer.java b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/anim/FbxAnimLayer.java new file mode 100644 index 000000000..872626615 --- /dev/null +++ b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/anim/FbxAnimLayer.java @@ -0,0 +1,82 @@ +/* + * Copyright (c) 2009-2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ +package com.jme3.scene.plugins.fbx.anim; + +import com.jme3.asset.AssetManager; +import com.jme3.scene.plugins.fbx.file.FbxElement; +import com.jme3.scene.plugins.fbx.obj.FbxObject; +import java.util.ArrayList; +import java.util.Collections; +import java.util.List; +import java.util.logging.Logger; + +public class FbxAnimLayer extends FbxObject { + + private static final Logger logger = Logger.getLogger(FbxAnimLayer.class.getName()); + + private final List animCurves = new ArrayList(); + + public FbxAnimLayer(AssetManager assetManager, String sceneFolderName) { + super(assetManager, sceneFolderName); + } + + @Override + public void fromElement(FbxElement element) { + super.fromElement(element); + // No known properties for layers.. + // Also jME3 doesn't support multiple layers anyway. + } + + public List getAnimationCurveNodes() { + return Collections.unmodifiableList(animCurves); + } + + @Override + protected Object toJmeObject() { + throw new UnsupportedOperationException(); + } + + @Override + public void connectObject(FbxObject object) { + if (!(object instanceof FbxAnimCurveNode)) { + unsupportedConnectObject(object); + } + + animCurves.add((FbxAnimCurveNode) object); + } + + @Override + public void connectObjectProperty(FbxObject object, String property) { + unsupportedConnectObjectProperty(object, property); + } +} + \ No newline at end of file diff --git a/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/anim/FbxAnimStack.java b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/anim/FbxAnimStack.java new file mode 100644 index 000000000..ea7dbb814 --- /dev/null +++ b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/anim/FbxAnimStack.java @@ -0,0 +1,111 @@ +/* + * Copyright (c) 2009-2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ +package com.jme3.scene.plugins.fbx.anim; + +import com.jme3.asset.AssetManager; +import com.jme3.scene.plugins.fbx.file.FbxElement; +import com.jme3.scene.plugins.fbx.obj.FbxObject; +import java.util.logging.Level; +import java.util.logging.Logger; + +public class FbxAnimStack extends FbxObject { + + private static final Logger logger = Logger.getLogger(FbxAnimStack.class.getName()); + + private float duration; + private FbxAnimLayer layer0; + + public FbxAnimStack(AssetManager assetManager, String sceneFolderName) { + super(assetManager, sceneFolderName); + } + + @Override + public void fromElement(FbxElement element) { + super.fromElement(element); + for (FbxElement child : element.getFbxProperties()) { + String propName = (String) child.properties.get(0); + if (propName.equals("LocalStop")) { + long durationLong = (Long)child.properties.get(4); + duration = (float) (durationLong * FbxAnimUtil.SECONDS_PER_UNIT); + } + } + } + +// /** +// * Finds out which FBX nodes this animation is going to influence. +// * +// * @return A list of FBX nodes that the stack's curves are influencing. +// */ +// public Set getInfluencedNodes() { +// HashSet influencedNodes = new HashSet(); +// if (layer0 == null) { +// return influencedNodes; +// } +// for (FbxAnimCurveNode curveNode : layer0.getAnimationCurveNodes()) { +// influencedNodes.addAll(curveNode.getInfluencedNodes()); +// } +// return influencedNodes; +// } + + public float getDuration() { + return duration; + } + + public FbxAnimLayer[] getLayers() { + return new FbxAnimLayer[]{ layer0 }; + } + + @Override + protected Object toJmeObject() { + throw new UnsupportedOperationException(); + } + + @Override + public void connectObject(FbxObject object) { + if (!(object instanceof FbxAnimLayer)) { + unsupportedConnectObject(object); + } + + if (layer0 != null) { + logger.log(Level.WARNING, "jME3 does not support layered animation. " + + "Only first layer has been loaded."); + return; + } + + layer0 = (FbxAnimLayer) object; + } + + @Override + public void connectObjectProperty(FbxObject object, String property) { + unsupportedConnectObjectProperty(object, property); + } +} diff --git a/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/anim/FbxAnimUtil.java b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/anim/FbxAnimUtil.java new file mode 100644 index 000000000..c376757de --- /dev/null +++ b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/anim/FbxAnimUtil.java @@ -0,0 +1,44 @@ +/* + * Copyright (c) 2009-2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ +package com.jme3.scene.plugins.fbx.anim; + +public class FbxAnimUtil { + /** + * Conversion factor from FBX animation time unit to seconds. + */ + public static final double SECONDS_PER_UNIT = 1 / 46186158000d; + + public static final String CURVE_NODE_PROPERTY_X = "d|X"; + public static final String CURVE_NODE_PROPERTY_Y = "d|Y"; + public static final String CURVE_NODE_PROPERTY_Z = "d|Z"; + public static final String CURVE_NODE_PROPERTY_VISIBILITY = "d|Visibility"; +} diff --git a/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/anim/FbxBindPose.java b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/anim/FbxBindPose.java new file mode 100644 index 000000000..78d37c74e --- /dev/null +++ b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/anim/FbxBindPose.java @@ -0,0 +1,103 @@ +/* + * Copyright (c) 2009-2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ +package com.jme3.scene.plugins.fbx.anim; + +import com.jme3.asset.AssetManager; +import com.jme3.math.Matrix4f; +import com.jme3.scene.plugins.fbx.file.FbxElement; +import com.jme3.scene.plugins.fbx.file.FbxId; +import com.jme3.scene.plugins.fbx.obj.FbxObject; +import java.util.HashMap; +import java.util.Map; + +public class FbxBindPose extends FbxObject> { + + private final Map bindPose = new HashMap(); + + public FbxBindPose(AssetManager assetManager, String sceneFolderName) { + super(assetManager, sceneFolderName); + } + + @Override + public void fromElement(FbxElement element) { + super.fromElement(element); + for (FbxElement child : element.children) { + if (!child.id.equals("PoseNode")) { + continue; + } + + FbxId node = null; + float[] matData = null; + + for (FbxElement e : child.children) { + if (e.id.equals("Node")) { + node = FbxId.create(e.properties.get(0)); + } else if (e.id.equals("Matrix")) { + double[] matDataDoubles = (double[]) e.properties.get(0); + + if (matDataDoubles.length != 16) { + // corrupt + throw new UnsupportedOperationException("Bind pose matrix " + + "must have 16 doubles, but it has " + + matDataDoubles.length + ". Data is corrupt"); + } + + matData = new float[16]; + for (int i = 0; i < matDataDoubles.length; i++) { + matData[i] = (float) matDataDoubles[i]; + } + } + } + + if (node != null && matData != null) { + Matrix4f matrix = new Matrix4f(matData); + bindPose.put(node, matrix); + } + } + } + + @Override + protected Map toJmeObject() { + return bindPose; + } + + @Override + public void connectObject(FbxObject object) { + unsupportedConnectObject(object); + } + + @Override + public void connectObjectProperty(FbxObject object, String property) { + unsupportedConnectObjectProperty(object, property); + } + +} diff --git a/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/anim/FbxCluster.java b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/anim/FbxCluster.java new file mode 100644 index 000000000..3065ce88c --- /dev/null +++ b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/anim/FbxCluster.java @@ -0,0 +1,98 @@ +/* + * Copyright (c) 2009-2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ +package com.jme3.scene.plugins.fbx.anim; + +import com.jme3.asset.AssetManager; +import com.jme3.scene.plugins.fbx.file.FbxElement; +import com.jme3.scene.plugins.fbx.obj.FbxObject; +import java.util.logging.Level; +import java.util.logging.Logger; + +public class FbxCluster extends FbxObject { + + private static final Logger logger = Logger.getLogger(FbxCluster.class.getName()); + + private int[] indexes; + private double[] weights; + private FbxLimbNode limb; + + public FbxCluster(AssetManager assetManager, String sceneFolderName) { + super(assetManager, sceneFolderName); + } + + @Override + public void fromElement(FbxElement element) { + super.fromElement(element); + for (FbxElement e : element.children) { + if (e.id.equals("Indexes")) { + indexes = (int[]) e.properties.get(0); + } else if (e.id.equals("Weights")) { + weights = (double[]) e.properties.get(0); + } + } + } + + public int[] getVertexIndices() { + return indexes; + } + + public double[] getWeights() { + return weights; + } + + public FbxLimbNode getLimb() { + return limb; + } + + @Override + protected Object toJmeObject() { + throw new UnsupportedOperationException(); + } + + @Override + public void connectObject(FbxObject object) { + if (object instanceof FbxLimbNode) { + if (limb != null) { + logger.log(Level.WARNING, "This cluster already has a limb attached. Ignoring."); + return; + } + limb = (FbxLimbNode) object; + } else { + unsupportedConnectObject(object); + } + } + + @Override + public void connectObjectProperty(FbxObject object, String property) { + unsupportedConnectObjectProperty(object, property); + } +} \ No newline at end of file diff --git a/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/anim/FbxLimbNode.java b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/anim/FbxLimbNode.java new file mode 100644 index 000000000..4b41b4f47 --- /dev/null +++ b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/anim/FbxLimbNode.java @@ -0,0 +1,94 @@ +/* + * Copyright (c) 2009-2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ +package com.jme3.scene.plugins.fbx.anim; + +import com.jme3.animation.Bone; +import com.jme3.animation.Skeleton; +import com.jme3.asset.AssetManager; +import com.jme3.scene.plugins.fbx.node.FbxNode; +import java.util.ArrayList; +import java.util.List; + +public class FbxLimbNode extends FbxNode { + + protected FbxNode skeletonHolder; + protected Bone bone; + + public FbxLimbNode(AssetManager assetManager, String sceneFolderName) { + super(assetManager, sceneFolderName); + } + + private static void createBones(FbxNode skeletonHolderNode, FbxLimbNode limb, List bones) { + limb.skeletonHolder = skeletonHolderNode; + + Bone parentBone = limb.getJmeBone(); + bones.add(parentBone); + + for (FbxNode child : limb.children) { + if (child instanceof FbxLimbNode) { + FbxLimbNode childLimb = (FbxLimbNode) child; + createBones(skeletonHolderNode, childLimb, bones); + parentBone.addChild(childLimb.getJmeBone()); + } + } + } + + public static Skeleton createSkeleton(FbxNode skeletonHolderNode) { + if (skeletonHolderNode instanceof FbxLimbNode) { + throw new UnsupportedOperationException("Limb nodes cannot be skeleton holders"); + } + + List bones = new ArrayList(); + + for (FbxNode child : skeletonHolderNode.getChildren()) { + if (child instanceof FbxLimbNode) { + createBones(skeletonHolderNode, (FbxLimbNode) child, bones); + } + } + + return new Skeleton(bones.toArray(new Bone[0])); + } + + public FbxNode getSkeletonHolder() { + return skeletonHolder; + } + + public Bone getJmeBone() { + if (bone == null) { + bone = new Bone(name); + bone.setBindTransforms(jmeLocalBindPose.getTranslation(), + jmeLocalBindPose.getRotation(), + jmeLocalBindPose.getScale()); + } + return bone; + } +} diff --git a/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/anim/FbxSkinDeformer.java b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/anim/FbxSkinDeformer.java new file mode 100644 index 000000000..7a831cf7f --- /dev/null +++ b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/anim/FbxSkinDeformer.java @@ -0,0 +1,66 @@ +/* + * Copyright (c) 2009-2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ +package com.jme3.scene.plugins.fbx.anim; + +import com.jme3.asset.AssetManager; +import com.jme3.scene.plugins.fbx.obj.FbxObject; +import java.util.ArrayList; +import java.util.List; + +public class FbxSkinDeformer extends FbxObject> { + + private final List clusters = new ArrayList(); + + public FbxSkinDeformer(AssetManager assetManager, String sceneFolderName) { + super(assetManager, sceneFolderName); + } + + @Override + protected List toJmeObject() { + return clusters; + } + + @Override + public void connectObject(FbxObject object) { + if (object instanceof FbxCluster) { + clusters.add((FbxCluster) object); + } else { + unsupportedConnectObject(object); + } + } + + @Override + public void connectObjectProperty(FbxObject object, String property) { + unsupportedConnectObjectProperty(object, property); + } + +} diff --git a/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/anim/FbxToJmeTrack.java b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/anim/FbxToJmeTrack.java new file mode 100644 index 000000000..7b7b5ee5b --- /dev/null +++ b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/anim/FbxToJmeTrack.java @@ -0,0 +1,202 @@ +/* + * Copyright (c) 2009-2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ +package com.jme3.scene.plugins.fbx.anim; + +import com.jme3.animation.BoneTrack; +import com.jme3.animation.SpatialTrack; +import com.jme3.animation.Track; +import com.jme3.math.Quaternion; +import com.jme3.math.Transform; +import com.jme3.math.Vector3f; +import com.jme3.scene.plugins.fbx.node.FbxNode; +import java.util.Arrays; +import java.util.HashMap; +import java.util.HashSet; +import java.util.Map; +import java.util.Set; + +/** + * Maps animation stacks to influenced nodes. + * Will be used later to create jME3 tracks. + */ +public final class FbxToJmeTrack { + + public FbxAnimStack animStack; + public FbxAnimLayer animLayer; + public FbxNode node; + + // These are not used in map lookups. + public transient final Map animCurves = new HashMap(); + + public long[] getKeyTimes() { + Set keyFrameTimesSet = new HashSet(); + for (FbxAnimCurveNode curveNode : animCurves.values()) { + for (FbxAnimCurve curve : curveNode.getCurves()) { + for (long keyTime : curve.getKeyTimes()) { + keyFrameTimesSet.add(keyTime); + } + } + } + long[] keyFrameTimes = new long[keyFrameTimesSet.size()]; + int i = 0; + for (Long keyFrameTime : keyFrameTimesSet) { + keyFrameTimes[i++] = keyFrameTime; + } + Arrays.sort(keyFrameTimes); + return keyFrameTimes; + } + + /** + * Generate a {@link BoneTrack} from the animation data, for the given + * boneIndex. + * + * @param boneIndex The bone index for which track data is generated for. + * @param inverseBindPose Inverse bind pose of the bone (in world space). + * @return A BoneTrack containing the animation data, for the specified + * boneIndex. + */ + public BoneTrack toJmeBoneTrack(int boneIndex, Transform inverseBindPose) { + return (BoneTrack) toJmeTrackInternal(boneIndex, inverseBindPose); + } + + public SpatialTrack toJmeSpatialTrack() { + return (SpatialTrack) toJmeTrackInternal(-1, null); + } + + public float getDuration() { + long[] keyframes = getKeyTimes(); + return (float) (keyframes[keyframes.length - 1] * FbxAnimUtil.SECONDS_PER_UNIT); + } + + private static void applyInverse(Vector3f translation, Quaternion rotation, Vector3f scale, Transform inverseBindPose) { + Transform t = new Transform(); + t.setTranslation(translation); + t.setRotation(rotation); + if (scale != null) { + t.setScale(scale); + } + t.combineWithParent(inverseBindPose); + + t.getTranslation(translation); + t.getRotation(rotation); + if (scale != null) { + t.getScale(scale); + } + } + + private Track toJmeTrackInternal(int boneIndex, Transform inverseBindPose) { + float duration = animStack.getDuration(); + + FbxAnimCurveNode translationCurve = animCurves.get("Lcl Translation"); + FbxAnimCurveNode rotationCurve = animCurves.get("Lcl Rotation"); + FbxAnimCurveNode scalingCurve = animCurves.get("Lcl Scaling"); + + long[] fbxTimes = getKeyTimes(); + float[] times = new float[fbxTimes.length]; + + // Translations / Rotations must be set on all tracks. + // (Required for jME3) + Vector3f[] translations = new Vector3f[fbxTimes.length]; + Quaternion[] rotations = new Quaternion[fbxTimes.length]; + + Vector3f[] scales = null; + if (scalingCurve != null) { + scales = new Vector3f[fbxTimes.length]; + } + + for (int i = 0; i < fbxTimes.length; i++) { + long fbxTime = fbxTimes[i]; + float time = (float) (fbxTime * FbxAnimUtil.SECONDS_PER_UNIT); + + if (time > duration) { + // Expand animation duration to fit the curve. + duration = time; + System.out.println("actual duration: " + duration); + } + + times[i] = time; + if (translationCurve != null) { + translations[i] = translationCurve.getVector3Value(fbxTime); + } else { + translations[i] = new Vector3f(); + } + if (rotationCurve != null) { + rotations[i] = rotationCurve.getQuaternionValue(fbxTime); + if (i > 0) { + if (rotations[i - 1].dot(rotations[i]) < 0) { + System.out.println("rotation will go the long way, oh noes"); + rotations[i - 1].negate(); + } + } + } else { + rotations[i] = new Quaternion(); + } + if (scalingCurve != null) { + scales[i] = scalingCurve.getVector3Value(fbxTime); + } + + if (inverseBindPose != null) { + applyInverse(translations[i], rotations[i], scales != null ? scales[i] : null, inverseBindPose); + } + } + + if (boneIndex == -1) { + return new SpatialTrack(times, translations, rotations, scales); + } else { + if (scales != null) { + return new BoneTrack(boneIndex, times, translations, rotations, scales); + } else { + return new BoneTrack(boneIndex, times, translations, rotations); + } + } + } + + @Override + public int hashCode() { + int hash = 3; + hash = 79 * hash + this.animStack.hashCode(); + hash = 79 * hash + this.animLayer.hashCode(); + hash = 79 * hash + this.node.hashCode(); + return hash; + } + + @Override + public boolean equals(Object obj) { + if (obj == null) { + return false; + } + final FbxToJmeTrack other = (FbxToJmeTrack) obj; + return this.node == other.node + && this.animStack == other.animStack + && this.animLayer == other.animLayer; + } +} diff --git a/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/material/FbxImage.java b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/material/FbxImage.java new file mode 100644 index 000000000..518dd4134 --- /dev/null +++ b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/material/FbxImage.java @@ -0,0 +1,190 @@ +/* + * Copyright (c) 2009-2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ +package com.jme3.scene.plugins.fbx.material; + +import com.jme3.asset.AssetLoadException; +import com.jme3.asset.AssetManager; +import com.jme3.asset.AssetNotFoundException; +import com.jme3.asset.TextureKey; +import com.jme3.scene.plugins.fbx.file.FbxElement; +import com.jme3.scene.plugins.fbx.obj.FbxObject; +import com.jme3.texture.Image; +import com.jme3.util.PlaceholderAssets; +import java.io.ByteArrayInputStream; +import java.io.InputStream; +import java.util.logging.Level; +import java.util.logging.Logger; + +public final class FbxImage extends FbxObject { + + private static final Logger logger = Logger.getLogger(FbxImage.class.getName()); + + protected TextureKey key; + protected String type; // = "Clip" + protected String filePath; // = "C:\Whatever\Blah\Texture.png" + protected String relativeFilePath; // = "..\Blah\Texture.png" + protected byte[] content; // = null, byte[0] OR embedded image data (unknown format?) + + public FbxImage(AssetManager assetManager, String sceneFolderName) { + super(assetManager, sceneFolderName); + } + + @Override + public void fromElement(FbxElement element) { + super.fromElement(element); + if (element.propertiesTypes.length == 3) { + type = (String) element.properties.get(2); + } else { + type = (String) element.properties.get(1); + } + if (type.equals("Clip")) { + for (FbxElement e : element.children) { + if (e.id.equals("Type")) { + type = (String) e.properties.get(0); + } else if (e.id.equals("FileName")) { + filePath = (String) e.properties.get(0); + } else if (e.id.equals("RelativeFilename")) { + relativeFilePath = (String) e.properties.get(0); + } else if (e.id.equals("Content")) { + if (e.properties.size() > 0) { + byte[] storedContent = (byte[]) e.properties.get(0); + if (storedContent.length > 0) { + this.content = storedContent; + } + } + } + } + } + } + + private Image loadImageSafe(AssetManager assetManager, TextureKey texKey) { + try { + return assetManager.loadTexture(texKey).getImage(); + } catch (AssetNotFoundException ex) { + return null; + } catch (AssetLoadException ex) { + logger.log(Level.WARNING, "Error when loading image: " + texKey, ex); + return null; + } + } + + private static String getFileName(String filePath) { + // NOTE: Gotta do it this way because new File().getParent() + // will not strip forward slashes on Linux / Mac OS X. + int fwdSlashIdx = filePath.lastIndexOf("\\"); + int bkSlashIdx = filePath.lastIndexOf("/"); + + if (fwdSlashIdx != -1) { + filePath = filePath.substring(fwdSlashIdx + 1); + } else if (bkSlashIdx != -1) { + filePath = filePath.substring(bkSlashIdx + 1); + } + + return filePath; + } + + /** + * The texture key that was used to load the image. + * Only valid after {@link #getJmeObject()} has been called. + * @return the key that was used to load the image. + */ + public TextureKey getTextureKey() { + return key; + } + + @Override + protected Object toJmeObject() { + Image image = null; + String fileName = null; + String relativeFilePathJme; + + if (filePath != null) { + fileName = getFileName(filePath); + } else if (relativeFilePath != null) { + fileName = getFileName(relativeFilePath); + + } + + if (fileName != null) { + try { + // Try to load filename relative to FBX folder + key = new TextureKey(sceneFolderName + fileName); + key.setGenerateMips(true); + image = loadImageSafe(assetManager, key); + + // Try to load relative filepath relative to FBX folder + if (image == null && relativeFilePath != null) { + // Convert Windows paths to jME3 paths + relativeFilePathJme = relativeFilePath.replace('\\', '/'); + key = new TextureKey(sceneFolderName + relativeFilePathJme); + key.setGenerateMips(true); + image = loadImageSafe(assetManager, key); + } + + // Try to load embedded image + if (image == null && content != null && content.length > 0) { + key = new TextureKey(fileName); + key.setGenerateMips(true); + InputStream is = new ByteArrayInputStream(content); + image = assetManager.loadAssetFromStream(key, is).getImage(); + + // NOTE: embedded texture doesn't exist in the asset manager, + // so the texture key must not be saved. + key = null; + } + } catch (AssetLoadException ex) { + logger.log(Level.WARNING, "Error while attempting to load texture {0}:\n{1}", + new Object[]{name, ex.toString()}); + } + } + + if (image == null) { + logger.log(Level.WARNING, "Cannot locate {0} for texture {1}", new Object[]{fileName, name}); + image = PlaceholderAssets.getPlaceholderImage(assetManager); + } + + // NOTE: At this point, key will be set to the last + // attempted texture key that we attempted to load. + + return image; + } + + @Override + public void connectObject(FbxObject object) { + unsupportedConnectObject(object); + } + + @Override + public void connectObjectProperty(FbxObject object, String property) { + unsupportedConnectObjectProperty(object, property); + } +} diff --git a/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/material/FbxMaterial.java b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/material/FbxMaterial.java new file mode 100644 index 000000000..9be5bf70c --- /dev/null +++ b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/material/FbxMaterial.java @@ -0,0 +1,363 @@ +/* + * Copyright (c) 2009-2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ +package com.jme3.scene.plugins.fbx.material; + +import com.jme3.asset.AssetManager; +import com.jme3.material.Material; +import com.jme3.material.RenderState.BlendMode; +import com.jme3.material.RenderState.FaceCullMode; +import com.jme3.math.ColorRGBA; +import com.jme3.scene.plugins.fbx.file.FbxElement; +import com.jme3.scene.plugins.fbx.obj.FbxObject; +import com.jme3.texture.Texture; +import com.jme3.texture.image.ColorSpace; +import java.util.logging.Level; +import java.util.logging.Logger; + +public class FbxMaterial extends FbxObject { + + private static final Logger logger = Logger.getLogger(FbxMaterial.class.getName()); + + private String shadingModel; // TODO: do we care about this? lambert just has no specular? + private final FbxMaterialProperties properties = new FbxMaterialProperties(); + + public FbxMaterial(AssetManager assetManager, String sceneFolderName) { + super(assetManager, sceneFolderName); + } + + @Override + public void fromElement(FbxElement element) { + super.fromElement(element); + if(!getSubclassName().equals("")) { + return; + } + + FbxElement shadingModelEl = element.getChildById("ShadingModel"); + if (shadingModelEl != null) { + shadingModel = (String) shadingModelEl.properties.get(0); + if (!shadingModel.equals("")) { + if (!shadingModel.equalsIgnoreCase("phong") && + !shadingModel.equalsIgnoreCase("lambert")) { + logger.log(Level.WARNING, "FBX material uses unknown shading model: {0}. " + + "Material may display incorrectly.", shadingModel); + } + } + } + + for (FbxElement child : element.getFbxProperties()) { + properties.setPropertyFromElement(child); + } + } + + @Override + public void connectObject(FbxObject object) { + unsupportedConnectObject(object); + } + + @Override + public void connectObjectProperty(FbxObject object, String property) { + if (!(object instanceof FbxTexture)) { + unsupportedConnectObjectProperty(object, property); + } + + properties.setPropertyTexture(property, (FbxTexture) object); + } + + private static void multRGB(ColorRGBA color, float factor) { + color.r *= factor; + color.g *= factor; + color.b *= factor; + } + + @Override + protected Material toJmeObject() { + ColorRGBA ambient = null; + ColorRGBA diffuse = null; + ColorRGBA specular = null; + ColorRGBA transp = null; + ColorRGBA emissive = null; + float shininess = 1f; + boolean separateTexCoord = false; + + Texture diffuseMap = null; + Texture specularMap = null; + Texture normalMap = null; + Texture transpMap = null; + Texture emitMap = null; + Texture aoMap = null; + + FbxTexture fbxDiffuseMap = null; + + Object diffuseColor = properties.getProperty("DiffuseColor"); + if (diffuseColor != null) { + if (diffuseColor instanceof ColorRGBA) { + diffuse = ((ColorRGBA) diffuseColor).clone(); + } else if (diffuseColor instanceof FbxTexture) { + FbxTexture tex = (FbxTexture) diffuseColor; + fbxDiffuseMap = tex; + diffuseMap = tex.getJmeObject(); + diffuseMap.getImage().setColorSpace(ColorSpace.sRGB); + } + } + + Object diffuseFactor = properties.getProperty("DiffuseFactor"); + if (diffuseFactor != null && diffuseFactor instanceof Float) { + float factor = (Float)diffuseFactor; + if (diffuse != null) { + multRGB(diffuse, factor); + } else { + diffuse = new ColorRGBA(factor, factor, factor, 1f); + } + } + + Object specularColor = properties.getProperty("SpecularColor"); + if (specularColor != null) { + if (specularColor instanceof ColorRGBA) { + specular = ((ColorRGBA) specularColor).clone(); + } else if (specularColor instanceof FbxTexture) { + FbxTexture tex = (FbxTexture) specularColor; + specularMap = tex.getJmeObject(); + specularMap.getImage().setColorSpace(ColorSpace.sRGB); + } + } + + Object specularFactor = properties.getProperty("SpecularFactor"); + if (specularFactor != null && specularFactor instanceof Float) { + float factor = (Float)specularFactor; + if (specular != null) { + multRGB(specular, factor); + } else { + specular = new ColorRGBA(factor, factor, factor, 1f); + } + } + + Object transparentColor = properties.getProperty("TransparentColor"); + if (transparentColor != null) { + if (transparentColor instanceof ColorRGBA) { + transp = ((ColorRGBA) transparentColor).clone(); + } else if (transparentColor instanceof FbxTexture) { + FbxTexture tex = (FbxTexture) transparentColor; + transpMap = tex.getJmeObject(); + transpMap.getImage().setColorSpace(ColorSpace.sRGB); + } + } + + Object transparencyFactor = properties.getProperty("TransparencyFactor"); + if (transparencyFactor != null && transparencyFactor instanceof Float) { + float factor = (Float)transparencyFactor; + if (transp != null) { + transp.a *= factor; + } else { + transp = new ColorRGBA(1f, 1f, 1f, factor); + } + } + + Object emissiveColor = properties.getProperty("EmissiveColor"); + if (emissiveColor != null) { + if (emissiveColor instanceof ColorRGBA) { + emissive = ((ColorRGBA)emissiveColor).clone(); + } else if (emissiveColor instanceof FbxTexture) { + FbxTexture tex = (FbxTexture) emissiveColor; + emitMap = tex.getJmeObject(); + emitMap.getImage().setColorSpace(ColorSpace.sRGB); + } + } + + Object emissiveFactor = properties.getProperty("EmissiveFactor"); + if (emissiveFactor != null && emissiveFactor instanceof Float) { + float factor = (Float)emissiveFactor; + if (emissive != null) { + multRGB(emissive, factor); + } else { + emissive = new ColorRGBA(factor, factor, factor, 1f); + } + } + + Object ambientColor = properties.getProperty("AmbientColor"); + if (ambientColor != null && ambientColor instanceof ColorRGBA) { + ambient = ((ColorRGBA)ambientColor).clone(); + } + + Object ambientFactor = properties.getProperty("AmbientFactor"); + if (ambientFactor != null && ambientFactor instanceof Float) { + float factor = (Float)ambientFactor; + if (ambient != null) { + multRGB(ambient, factor); + } else { + ambient = new ColorRGBA(factor, factor, factor, 1f); + } + } + + Object shininessFactor = properties.getProperty("Shininess"); + if (shininessFactor != null) { + if (shininessFactor instanceof Float) { + shininess = (Float) shininessFactor; + } else if (shininessFactor instanceof FbxTexture) { + // TODO: support shininess textures + } + } + + Object bumpNormal = properties.getProperty("NormalMap"); + if (bumpNormal != null) { + if (bumpNormal instanceof FbxTexture) { + // TODO: check all meshes that use this material have tangents + // otherwise shading errors occur + FbxTexture tex = (FbxTexture) bumpNormal; + normalMap = tex.getJmeObject(); + normalMap.getImage().setColorSpace(ColorSpace.Linear); + } + } + + Object aoColor = properties.getProperty("DiffuseColor2"); + if (aoColor != null) { + if (aoColor instanceof FbxTexture) { + FbxTexture tex = (FbxTexture) aoColor; + if (tex.getUvSet() != null && fbxDiffuseMap != null) { + if (!tex.getUvSet().equals(fbxDiffuseMap.getUvSet())) { + separateTexCoord = true; + } + } + aoMap = tex.getJmeObject(); + aoMap.getImage().setColorSpace(ColorSpace.sRGB); + } + } + + // TODO: how to disable transparency from diffuse map?? Need "UseAlpha" again.. + + assert ambient == null || ambient.a == 1f; + assert diffuse == null || diffuse.a == 1f; + assert specular == null || specular.a == 1f; + assert emissive == null || emissive.a == 1f; + assert transp == null || (transp.r == 1f && transp.g == 1f && transp.b == 1f); + + // If shininess is less than 1.0, the lighting shader won't be able + // to handle it. Gotta disable specularity then. + if (shininess < 1f) { + shininess = 1f; + specular = ColorRGBA.Black; + } + + // Try to guess if we need to enable alpha blending. + // FBX does not specify this explicitly. + boolean useAlphaBlend = false; + + if (diffuseMap != null && diffuseMap == transpMap) { + // jME3 already uses alpha from diffuseMap + // (if alpha blend is enabled) + useAlphaBlend = true; + transpMap = null; + } else if (diffuseMap != null && transpMap != null && diffuseMap != transpMap) { + // TODO: potential bug here. Alpha from diffuse may + // leak unintentionally. + useAlphaBlend = true; + } else if (transpMap != null) { + // We have alpha map but no diffuse map, OK. + useAlphaBlend = true; + } + + if (transp != null && transp.a != 1f) { + // Consolidate transp into diffuse + // (jME3 doesn't use a separate alpha color) + + // TODO: potential bug here. Alpha from diffuse may + // leak unintentionally. + useAlphaBlend = true; + if (diffuse != null) { + diffuse.a = transp.a; + } else { + diffuse = transp; + } + } + + Material mat = new Material(assetManager, "Common/MatDefs/Light/Lighting.j3md"); + mat.setName(name); + + // TODO: load this from FBX material. + mat.setReceivesShadows(true); + + if (useAlphaBlend) { + // No idea if this is a transparent or translucent model, gotta guess.. + mat.setTransparent(true); + mat.setFloat("AlphaDiscardThreshold", 0.01f); + mat.getAdditionalRenderState().setBlendMode(BlendMode.Alpha); + } + + mat.getAdditionalRenderState().setFaceCullMode(FaceCullMode.Off); + + // Set colors. + if (ambient != null || diffuse != null || specular != null) { + // If either of those is set, we have to set them all. + // NOTE: default specular is black, unless it is set explicitly. + mat.setBoolean("UseMaterialColors", true); + mat.setColor("Ambient", /*ambient != null ? ambient :*/ ColorRGBA.White); + mat.setColor("Diffuse", diffuse != null ? diffuse : ColorRGBA.White); + mat.setColor("Specular", specular != null ? specular : ColorRGBA.Black); + } + + if (emissive != null) { + mat.setColor("GlowColor", emissive); + } + + // Set shininess. + if (shininess > 1f) { + // Convert shininess from + // Phong (FBX shading model) to Blinn (jME3 shading model). + float blinnShininess = (shininess * 5.1f) + 1f; + mat.setFloat("Shininess", blinnShininess); + } + + // Set textures. + if (diffuseMap != null) { + mat.setTexture("DiffuseMap", diffuseMap); + } + if (specularMap != null) { + mat.setTexture("SpecularMap", specularMap); + } + if (normalMap != null) { + mat.setTexture("NormalMap", normalMap); + } + if (transpMap != null) { +// mat.setTexture("AlphaMap", transpMap); + } + if (emitMap != null) { + mat.setTexture("GlowMap", emitMap); + } + if (aoMap != null) { + mat.setTexture("LightMap", aoMap); + if (separateTexCoord) { + mat.setBoolean("SeparateTexCoord", true); + } + } + + return mat; + } +} diff --git a/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/material/FbxMaterialProperties.java b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/material/FbxMaterialProperties.java new file mode 100644 index 000000000..14d23900d --- /dev/null +++ b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/material/FbxMaterialProperties.java @@ -0,0 +1,234 @@ +/* + * Copyright (c) 2009-2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ +package com.jme3.scene.plugins.fbx.material; + +import com.jme3.math.ColorRGBA; +import com.jme3.scene.plugins.fbx.file.FbxElement; +import java.util.HashMap; +import java.util.Map; +import java.util.logging.Level; +import java.util.logging.Logger; + +public class FbxMaterialProperties { + + private static final Logger logger = Logger.getLogger(FbxMaterialProperties.class.getName()); + + private static final Map propertyMetaMap = new HashMap(); + + private final Map propertyValueMap = new HashMap(); + + private static enum Type { + Color, + Alpha, + Factor, + Texture2DOrColor, + Texture2DOrAlpha, + Texture2DOrFactor, + Texture2D, + TextureCubeMap, + Ignore; + } + + private static class FBXMaterialProperty { + private final String name; + private final Type type; + + public FBXMaterialProperty(String name, Type type) { + this.name = name; + this.type = type; + } + } + + private static boolean isValueAcceptable(Type type, Object value) { + if (type == Type.Ignore) { + return true; + } + if (value instanceof FbxTexture) { + switch (type) { + case Texture2D: + case Texture2DOrAlpha: + case Texture2DOrColor: + case Texture2DOrFactor: + return true; + } + } else if (value instanceof ColorRGBA) { + switch (type) { + case Color: + case Texture2DOrColor: + return true; + } + } else if (value instanceof Float) { + switch (type) { + case Alpha: + case Factor: + case Texture2DOrAlpha: + case Texture2DOrFactor: + return true; + } + } + + return false; + } + + private static void defineProp(String name, Type type) { + propertyMetaMap.put(name, new FBXMaterialProperty(name, type)); + } + + private static void defineAlias(String alias, String name) { + propertyMetaMap.put(alias, propertyMetaMap.get(name)); + } + + static { + // Lighting->Ambient + // TODO: Add support for AmbientMap?? + defineProp("AmbientColor", Type.Color); + defineProp("AmbientFactor", Type.Factor); + defineAlias("Ambient", "AmbientColor"); + + // Lighting->DiffuseMap/Diffuse + defineProp("DiffuseColor", Type.Texture2DOrColor); + defineProp("DiffuseFactor", Type.Factor); + defineAlias("Diffuse", "DiffuseColor"); + + // Lighting->SpecularMap/Specular + defineProp("SpecularColor", Type.Texture2DOrColor); + defineProp("SpecularFactor", Type.Factor); + defineAlias("Specular", "SpecularColor"); + + // Lighting->AlphaMap/Diffuse + defineProp("TransparentColor", Type.Texture2DOrAlpha); + + // Lighting->Diffuse + defineProp("TransparencyFactor", Type.Alpha); + defineAlias("Opacity", "TransparencyFactor"); + + // Lighting->GlowMap/GlowColor + defineProp("EmissiveColor", Type.Texture2DOrColor); + defineProp("EmissiveFactor", Type.Factor); + defineAlias("Emissive", "EmissiveColor"); + + // Lighting->Shininess + defineProp("Shininess", Type.Factor); + defineAlias("ShininessExponent", "Shininess"); + + // Lighting->NormalMap + defineProp("NormalMap", Type.Texture2D); + defineAlias("Normal", "NormalMap"); + + // Lighting->EnvMap + defineProp("ReflectionColor", Type.Texture2DOrColor); + + // Lighting->FresnelParams + defineProp("Reflectivity", Type.Factor); + defineAlias("ReflectionFactor", "Reflectivity"); + + // ShadingModel is no longer specified under Properties element. + defineProp("ShadingModel", Type.Ignore); + + // MultiLayer materials aren't supported anyway.. + defineProp("MultiLayer", Type.Ignore); + + // Not sure what this is.. NormalMap again?? + defineProp("Bump", Type.Texture2DOrColor); + + defineProp("BumpFactor", Type.Factor); + defineProp("DisplacementColor", Type.Color); + defineProp("DisplacementFactor", Type.Factor); + } + + public void setPropertyTexture(String name, FbxTexture texture) { + FBXMaterialProperty prop = propertyMetaMap.get(name); + + if (prop == null) { + logger.log(Level.WARNING, "Unknown FBX material property '{0}'", name); + return; + } + + if (propertyValueMap.get(name) instanceof FbxTexture) { + // Multiple / layered textures .. + // Just write into 2nd slot for now (maybe will use for lightmaps). + name = name + "2"; + } + + propertyValueMap.put(name, texture); + } + + public void setPropertyFromElement(FbxElement propertyElement) { + String name = (String) propertyElement.properties.get(0); + FBXMaterialProperty prop = propertyMetaMap.get(name); + + if (prop == null) { + logger.log(Level.WARNING, "Unknown FBX material property ''{0}''", name); + return; + } + + // It is either a color, alpha, or factor. + // Textures can only be set via setPropertyTexture. + + // If it is an alias, get the real name of the property. + String realName = prop.name; + + switch (prop.type) { + case Alpha: + case Factor: + case Texture2DOrFactor: + case Texture2DOrAlpha: + double value = (Double) propertyElement.properties.get(4); + propertyValueMap.put(realName, (float)value); + break; + case Color: + case Texture2DOrColor: + double x = (Double) propertyElement.properties.get(4); + double y = (Double) propertyElement.properties.get(5); + double z = (Double) propertyElement.properties.get(6); + ColorRGBA color = new ColorRGBA((float)x, (float)y, (float)z, 1f); + propertyValueMap.put(realName, color); + break; + default: + logger.log(Level.WARNING, "FBX material property ''{0}'' requires a texture.", name); + break; + } + } + + public Object getProperty(String name) { + return propertyValueMap.get(name); + } + + public static Type getPropertyType(String name) { + FBXMaterialProperty prop = propertyMetaMap.get(name); + if (prop == null) { + return null; + } else { + return prop.type; + } + } +} diff --git a/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/material/FbxTexture.java b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/material/FbxTexture.java new file mode 100644 index 000000000..4569dad33 --- /dev/null +++ b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/material/FbxTexture.java @@ -0,0 +1,146 @@ +/* + * Copyright (c) 2009-2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ +package com.jme3.scene.plugins.fbx.material; + +import com.jme3.asset.AssetManager; +import com.jme3.asset.TextureKey; +import com.jme3.math.Vector2f; +import com.jme3.scene.plugins.fbx.file.FbxElement; +import com.jme3.scene.plugins.fbx.obj.FbxObject; +import com.jme3.texture.Image; +import com.jme3.texture.Texture; +import com.jme3.texture.Texture.MagFilter; +import com.jme3.texture.Texture.MinFilter; +import com.jme3.texture.Texture.WrapAxis; +import com.jme3.texture.Texture.WrapMode; +import com.jme3.texture.Texture2D; +import com.jme3.util.PlaceholderAssets; + +public class FbxTexture extends FbxObject { + + private static enum AlphaSource { + None, + FromTextureAlpha, + FromTextureIntensity; + } + + private String type; + private FbxImage media; + + // TODO: not currently used. + private AlphaSource alphaSource = AlphaSource.FromTextureAlpha; + private String uvSet; + private int wrapModeU = 0, wrapModeV = 0; + private final Vector2f uvTranslation = new Vector2f(0, 0); + private final Vector2f uvScaling = new Vector2f(1, 1); + + public FbxTexture(AssetManager assetManager, String sceneFolderName) { + super(assetManager, sceneFolderName); + } + + public String getUvSet() { + return uvSet; + } + + @Override + protected Texture toJmeObject() { + Image image = null; + TextureKey key = null; + if (media != null) { + image = (Image) media.getJmeObject(); + key = media.getTextureKey(); + } + if (image == null) { + image = PlaceholderAssets.getPlaceholderImage(assetManager); + } + Texture2D tex = new Texture2D(image); + if (key != null) { + tex.setKey(key); + tex.setName(key.getName()); + tex.setAnisotropicFilter(key.getAnisotropy()); + } + tex.setMinFilter(MinFilter.Trilinear); + tex.setMagFilter(MagFilter.Bilinear); + if (wrapModeU == 0) { + tex.setWrap(WrapAxis.S, WrapMode.Repeat); + } + if (wrapModeV == 0) { + tex.setWrap(WrapAxis.T, WrapMode.Repeat); + } + return tex; + } + + @Override + public void fromElement(FbxElement element) { + super.fromElement(element); + if (getSubclassName().equals("")) { + for (FbxElement e : element.children) { + if (e.id.equals("Type")) { + type = (String) e.properties.get(0); + } + /*else if (e.id.equals("FileName")) { + filename = (String) e.properties.get(0); + }*/ + } + + for (FbxElement prop : element.getFbxProperties()) { + String propName = (String) prop.properties.get(0); + if (propName.equals("AlphaSource")) { + // ??? + } else if (propName.equals("UVSet")) { + uvSet = (String) prop.properties.get(4); + } else if (propName.equals("WrapModeU")) { + wrapModeU = (Integer) prop.properties.get(4); + } else if (propName.equals("WrapModeV")) { + wrapModeV = (Integer) prop.properties.get(4); + } + } + } + } + + @Override + public void connectObject(FbxObject object) { + if (!(object instanceof FbxImage)) { + unsupportedConnectObject(object); +// } else if (media != null) { +// throw new UnsupportedOperationException("An image is already attached to this texture."); + } + + this.media = (FbxImage) object; + } + + @Override + public void connectObjectProperty(FbxObject object, String property) { + unsupportedConnectObjectProperty(object, property); + } + +} diff --git a/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/mesh/FbxLayer.java b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/mesh/FbxLayer.java new file mode 100644 index 000000000..d1b9d3860 --- /dev/null +++ b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/mesh/FbxLayer.java @@ -0,0 +1,107 @@ +/* + * Copyright (c) 2009-2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ +package com.jme3.scene.plugins.fbx.mesh; + +import com.jme3.scene.plugins.fbx.file.FbxElement; +import java.util.Collection; +import java.util.EnumMap; +import java.util.logging.Level; +import java.util.logging.Logger; + +public final class FbxLayer { + + private static final Logger logger = Logger.getLogger(FbxLayer.class.getName()); + + public static class FbxLayerElementRef { + FbxLayerElement.Type layerElementType; + int layerElementIndex; + FbxLayerElement layerElement; + } + + int layer; + final EnumMap references = + new EnumMap(FbxLayerElement.Type.class); + + private FbxLayer() { } + + public Object getVertexData(FbxLayerElement.Type type, int polygonIndex, + int polygonVertexIndex, int positionIndex, int edgeIndex) { + FbxLayerElementRef reference = references.get(type); + if (reference == null) { + return null; + } else { + return reference.layerElement.getVertexData(polygonIndex, polygonVertexIndex, positionIndex, edgeIndex); + } + } + + public FbxLayerElement.Type[] getLayerElementTypes() { + FbxLayerElement.Type[] types = new FbxLayerElement.Type[references.size()]; + references.keySet().toArray(types); + return types; + } + + public void setLayerElements(Collection layerElements) { + for (FbxLayerElement layerElement : layerElements) { + FbxLayerElementRef reference = references.get(layerElement.type); + if (reference != null && reference.layerElementIndex == layerElement.index) { + reference.layerElement = layerElement; + } + } + } + + public static FbxLayer fromElement(FbxElement element) { + FbxLayer layer = new FbxLayer(); + layer.layer = (Integer)element.properties.get(0); + next_element: for (FbxElement child : element.children) { + if (!child.id.equals("LayerElement")) { + continue; + } + FbxLayerElementRef ref = new FbxLayerElementRef(); + for (FbxElement child2 : child.children) { + if (child2.id.equals("Type")) { + String layerElementTypeStr = (String) child2.properties.get(0); + layerElementTypeStr = layerElementTypeStr.substring("LayerElement".length()); + try { + ref.layerElementType = FbxLayerElement.Type.valueOf(layerElementTypeStr); + } catch (IllegalArgumentException ex) { + logger.log(Level.WARNING, "Unsupported layer type: {0}. Ignoring.", layerElementTypeStr); + continue next_element; + } + } else if (child2.id.equals("TypedIndex")) { + ref.layerElementIndex = (Integer) child2.properties.get(0); + } + } + layer.references.put(ref.layerElementType, ref); + } + return layer; + } +} diff --git a/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/mesh/FbxLayerElement.java b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/mesh/FbxLayerElement.java new file mode 100644 index 000000000..bffd94c65 --- /dev/null +++ b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/mesh/FbxLayerElement.java @@ -0,0 +1,243 @@ +/* + * Copyright (c) 2009-2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ +package com.jme3.scene.plugins.fbx.mesh; + +import com.jme3.math.ColorRGBA; +import com.jme3.math.Vector2f; +import com.jme3.math.Vector3f; +import com.jme3.scene.plugins.fbx.file.FbxElement; +import java.util.HashSet; +import java.util.Set; +import java.util.logging.Level; +import java.util.logging.Logger; + +public class FbxLayerElement { + + private static final Logger logger = Logger.getLogger(FbxLayerElement.class.getName()); + + public enum Type { + Position, // Vector3f (isn't actually defined in FBX) + BoneIndex, // List (isn't actually defined in FBX) + BoneWeight, // List isn't actually defined in FBX) + Normal, // Vector3f + Binormal, // Vector3f + Tangent, // Vector3f + UV, // Vector2f + TransparentUV, // Vector2f + Color, // ColorRGBA + Material, // Integer + Smoothing, // Integer + Visibility, // Integer + Texture, // ??? (FBX 6.x) + PolygonGroup, // ??? (FBX 6.x) + NormalMapTextures, // ??? (FBX 6.x) + SpecularFactorUV, // ??? (FBX 6.x) + NormalMapUV, // ??? (FBX 6.x) + SpecularFactorTextures, // ??? (FBX 6.x) + + } + + public enum MappingInformationType { + NoMappingInformation, + AllSame, + ByPolygonVertex, + ByVertex, + ByPolygon, + ByEdge; + } + + public enum ReferenceInformationType { + Direct, + IndexToDirect; + } + + public enum TextureBlendMode { + Translucent; + } + + private static final Set indexTypes = new HashSet(); + + static { + indexTypes.add("UVIndex"); + indexTypes.add("NormalsIndex"); + indexTypes.add("TangentsIndex"); + indexTypes.add("BinormalsIndex"); + indexTypes.add("Smoothing"); + indexTypes.add("Materials"); + indexTypes.add("TextureId"); + indexTypes.add("ColorIndex"); + indexTypes.add("PolygonGroup"); + } + + int index; + Type type; + ReferenceInformationType refInfoType; + MappingInformationType mapInfoType; + String name = ""; + Object[] data; + int[] dataIndices; + + private FbxLayerElement() { } + + public String toString() { + return "LayerElement[type=" + type + ", layer=" + index + + ", mapInfoType=" + mapInfoType + ", refInfoType=" + refInfoType + "]"; + } + + private Object getVertexDataIndexToDirect(int polygonIndex, int polygonVertexIndex, + int positionIndex, int edgeIndex) { + switch (mapInfoType) { + case AllSame: return data[dataIndices[0]]; + case ByPolygon: return data[dataIndices[polygonIndex]]; + case ByPolygonVertex: return data[dataIndices[polygonVertexIndex]]; + case ByVertex: return data[dataIndices[positionIndex]]; + case ByEdge: return data[dataIndices[edgeIndex]]; + default: throw new UnsupportedOperationException(); + } + } + + private Object getVertexDataDirect(int polygonIndex, int polygonVertexIndex, + int positionIndex, int edgeIndex) { + switch (mapInfoType) { + case AllSame: return data[0]; + case ByPolygon: return data[polygonIndex]; + case ByPolygonVertex: return data[polygonVertexIndex]; + case ByVertex: return data[positionIndex]; + case ByEdge: return data[edgeIndex]; + default: throw new UnsupportedOperationException(); + } + } + + public Object getVertexData(int polygonIndex, int polygonVertexIndex, int positionIndex, int edgeIndex) { + switch (refInfoType) { + case Direct: return getVertexDataDirect(polygonIndex, polygonVertexIndex, positionIndex, edgeIndex); + case IndexToDirect: return getVertexDataIndexToDirect(polygonIndex, polygonVertexIndex, positionIndex, edgeIndex); + default: return null; + } + } + + public static FbxLayerElement fromPositions(double[] positionData) { + FbxLayerElement layerElement = new FbxLayerElement(); + layerElement.index = -1; + layerElement.name = ""; + layerElement.type = Type.Position; + layerElement.mapInfoType = MappingInformationType.ByVertex; + layerElement.refInfoType = ReferenceInformationType.Direct; + layerElement.data = toVector3(positionData); + layerElement.dataIndices = null; + return layerElement; + } + + public static FbxLayerElement fromElement(FbxElement element) { + FbxLayerElement layerElement = new FbxLayerElement(); + if (!element.id.startsWith("LayerElement")) { + throw new IllegalArgumentException("Not a layer element"); + } + layerElement.index = (Integer)element.properties.get(0); + + String elementType = element.id.substring("LayerElement".length()); + try { + layerElement.type = Type.valueOf(elementType); + } catch (IllegalArgumentException ex) { + logger.log(Level.WARNING, "Unsupported layer element: {0}. Ignoring.", elementType); + } + for (FbxElement child : element.children) { + if (child.id.equals("MappingInformationType")) { + String mapInfoTypeVal = (String) child.properties.get(0); + if (mapInfoTypeVal.equals("ByVertice")) { + mapInfoTypeVal = "ByVertex"; + } + layerElement.mapInfoType = MappingInformationType.valueOf(mapInfoTypeVal); + } else if (child.id.equals("ReferenceInformationType")) { + String refInfoTypeVal = (String) child.properties.get(0); + if (refInfoTypeVal.equals("Index")) { + refInfoTypeVal = "IndexToDirect"; + } + layerElement.refInfoType = ReferenceInformationType.valueOf(refInfoTypeVal); + } else if (child.id.equals("Normals") || child.id.equals("Tangents") || child.id.equals("Binormals")) { + layerElement.data = toVector3(FbxMeshUtil.getDoubleArray(child)); + } else if (child.id.equals("Colors")) { + layerElement.data = toColorRGBA(FbxMeshUtil.getDoubleArray(child)); + } else if (child.id.equals("UV")) { + layerElement.data = toVector2(FbxMeshUtil.getDoubleArray(child)); + } else if (indexTypes.contains(child.id)) { + layerElement.dataIndices = FbxMeshUtil.getIntArray(child); + } else if (child.id.equals("Name")) { + layerElement.name = (String) child.properties.get(0); + } + } + if (layerElement.data == null) { + // For Smoothing / Materials, data = dataIndices + layerElement.refInfoType = ReferenceInformationType.Direct; + layerElement.data = new Integer[layerElement.dataIndices.length]; + for (int i = 0; i < layerElement.data.length; i++) { + layerElement.data[i] = layerElement.dataIndices[i]; + } + layerElement.dataIndices = null; + } + return layerElement; + } + + static Vector3f[] toVector3(double[] data) { + Vector3f[] vectors = new Vector3f[data.length / 3]; + for (int i = 0; i < vectors.length; i++) { + float x = (float) data[i * 3]; + float y = (float) data[i * 3 + 1]; + float z = (float) data[i * 3 + 2]; + vectors[i] = new Vector3f(x, y, z); + } + return vectors; + } + + static Vector2f[] toVector2(double[] data) { + Vector2f[] vectors = new Vector2f[data.length / 2]; + for (int i = 0; i < vectors.length; i++) { + float x = (float) data[i * 2]; + float y = (float) data[i * 2 + 1]; + vectors[i] = new Vector2f(x, y); + } + return vectors; + } + + static ColorRGBA[] toColorRGBA(double[] data) { + ColorRGBA[] colors = new ColorRGBA[data.length / 4]; + for (int i = 0; i < colors.length; i++) { + float r = (float) data[i * 4]; + float g = (float) data[i * 4 + 1]; + float b = (float) data[i * 4 + 2]; + float a = (float) data[i * 4 + 3]; + colors[i] = new ColorRGBA(r, g, b, a); + } + return colors; + } +} + diff --git a/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/mesh/FbxMesh.java b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/mesh/FbxMesh.java new file mode 100644 index 000000000..5dd911bed --- /dev/null +++ b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/mesh/FbxMesh.java @@ -0,0 +1,316 @@ +/* + * Copyright (c) 2009-2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ +package com.jme3.scene.plugins.fbx.mesh; + +import com.jme3.animation.Bone; +import com.jme3.animation.Skeleton; +import com.jme3.asset.AssetManager; +import com.jme3.math.ColorRGBA; +import com.jme3.math.Vector2f; +import com.jme3.math.Vector3f; +import com.jme3.scene.Mesh; +import com.jme3.scene.plugins.IrUtils; +import com.jme3.scene.plugins.IrBoneWeightIndex; +import com.jme3.scene.plugins.IrMesh; +import com.jme3.scene.plugins.IrPolygon; +import com.jme3.scene.plugins.IrVertex; +import com.jme3.scene.plugins.fbx.anim.FbxCluster; +import com.jme3.scene.plugins.fbx.anim.FbxLimbNode; +import com.jme3.scene.plugins.fbx.anim.FbxSkinDeformer; +import com.jme3.scene.plugins.fbx.file.FbxElement; +import com.jme3.scene.plugins.fbx.obj.FbxObject; +import com.jme3.scene.plugins.fbx.node.FbxNodeAttribute; +import com.jme3.util.IntMap; +import java.util.ArrayList; +import java.util.List; +import java.util.logging.Level; +import java.util.logging.Logger; + +public final class FbxMesh extends FbxNodeAttribute> { + + private static final Logger logger = Logger.getLogger(FbxMesh.class.getName()); + + private FbxPolygon[] polygons; + private int[] edges; + private FbxLayerElement[] layerElements; + private Vector3f[] positions; + private FbxLayer[] layers; + + private ArrayList[] boneIndices; + private ArrayList[] boneWeights; + + private FbxSkinDeformer skinDeformer; + + public FbxMesh(AssetManager assetManager, String sceneFolderName) { + super(assetManager, sceneFolderName); + } + + @Override + public void fromElement(FbxElement element) { + super.fromElement(element); + + List layerElementsList = new ArrayList(); + List layersList = new ArrayList(); + + for (FbxElement e : element.children) { + if (e.id.equals("Vertices")) { + setPositions(FbxMeshUtil.getDoubleArray(e)); + } else if (e.id.equals("PolygonVertexIndex")) { + setPolygonVertexIndices(FbxMeshUtil.getIntArray(e)); + } else if (e.id.equals("Edges")) { + setEdges(FbxMeshUtil.getIntArray(e)); + } else if (e.id.startsWith("LayerElement")) { + layerElementsList.add(FbxLayerElement.fromElement(e)); + } else if (e.id.equals("Layer")) { + layersList.add(FbxLayer.fromElement(e)); + } + } + + for (FbxLayer layer : layersList) { + layer.setLayerElements(layerElementsList); + } + + layerElements = new FbxLayerElement[layerElementsList.size()]; + layerElementsList.toArray(layerElements); + + layers = new FbxLayer[layersList.size()]; + layersList.toArray(layers); + } + + public FbxSkinDeformer getSkinDeformer() { + return skinDeformer; + } + + public void applyCluster(FbxCluster cluster) { + if (boneIndices == null) { + boneIndices = new ArrayList[positions.length]; + boneWeights = new ArrayList[positions.length]; + } + + FbxLimbNode limb = cluster.getLimb(); + Bone bone = limb.getJmeBone(); + Skeleton skeleton = limb.getSkeletonHolder().getJmeSkeleton(); + int boneIndex = skeleton.getBoneIndex(bone); + + int[] positionIndices = cluster.getVertexIndices(); + double[] weights = cluster.getWeights(); + + for (int i = 0; i < positionIndices.length; i++) { + int positionIndex = positionIndices[i]; + float boneWeight = (float)weights[i]; + + ArrayList boneIndicesForVertex = boneIndices[positionIndex]; + ArrayList boneWeightsForVertex = boneWeights[positionIndex]; + + if (boneIndicesForVertex == null) { + boneIndicesForVertex = new ArrayList(); + boneWeightsForVertex = new ArrayList(); + boneIndices[positionIndex] = boneIndicesForVertex; + boneWeights[positionIndex] = boneWeightsForVertex; + } + + boneIndicesForVertex.add(boneIndex); + boneWeightsForVertex.add(boneWeight); + } + } + + @Override + public void connectObject(FbxObject object) { + if (object instanceof FbxSkinDeformer) { + if (skinDeformer != null) { + logger.log(Level.WARNING, "This mesh already has a skin deformer attached. Ignoring."); + return; + } + skinDeformer = (FbxSkinDeformer) object; + } else { + unsupportedConnectObject(object); + } + } + + @Override + public void connectObjectProperty(FbxObject object, String property) { + unsupportedConnectObjectProperty(object, property); + } + + private void setPositions(double[] positions) { + this.positions = FbxLayerElement.toVector3(positions); + } + + private void setEdges(int[] edges) { + this.edges = edges; + // TODO: ... + } + + private void setPolygonVertexIndices(int[] polygonVertexIndices) { + List polygonList = new ArrayList(); + + boolean finishPolygon = false; + List vertexIndices = new ArrayList(); + + for (int i = 0; i < polygonVertexIndices.length; i++) { + int vertexIndex = polygonVertexIndices[i]; + + if (vertexIndex < 0) { + vertexIndex ^= -1; + finishPolygon = true; + } + + vertexIndices.add(vertexIndex); + + if (finishPolygon) { + finishPolygon = false; + polygonList.add(FbxPolygon.fromIndices(vertexIndices)); + vertexIndices.clear(); + } + } + + polygons = new FbxPolygon[polygonList.size()]; + polygonList.toArray(polygons); + } + + private static IrBoneWeightIndex[] toBoneWeightIndices(List boneIndices, List boneWeights) { + IrBoneWeightIndex[] boneWeightIndices = new IrBoneWeightIndex[boneIndices.size()]; + for (int i = 0; i < boneIndices.size(); i++) { + boneWeightIndices[i] = new IrBoneWeightIndex(boneIndices.get(i), boneWeights.get(i)); + } + return boneWeightIndices; + } + + @Override + protected IntMap toJmeObject() { + // Load clusters from SkinDeformer + if (skinDeformer != null) { + for (FbxCluster cluster : skinDeformer.getJmeObject()) { + applyCluster(cluster); + } + } + + IrMesh irMesh = toIRMesh(); + + // Trim bone weights to 4 weights per vertex. + IrUtils.trimBoneWeights(irMesh); + + // Convert tangents / binormals to tangents with parity. + IrUtils.toTangentsWithParity(irMesh); + + // Triangulate quads. + IrUtils.triangulate(irMesh); + + // Split meshes by material indices. + IntMap irMeshes = IrUtils.splitByMaterial(irMesh); + + // Create a jME3 Mesh for each material index. + IntMap jmeMeshes = new IntMap(); + for (IntMap.Entry irMeshEntry : irMeshes) { + Mesh jmeMesh = IrUtils.convertIrMeshToJmeMesh(irMeshEntry.getValue()); + jmeMeshes.put(irMeshEntry.getKey(), jmeMesh); + } + + if (jmeMeshes.size() == 0) { + // When will this actually happen? Not sure. + logger.log(Level.WARNING, "Empty FBX mesh found (unusual)."); + } + + // IMPORTANT: If we have a -1 entry, those are triangles + // with no material indices. + // It makes sense only if the mesh uses a single material! + if (jmeMeshes.containsKey(-1) && jmeMeshes.size() > 1) { + logger.log(Level.WARNING, "Mesh has polygons with no material " + + "indices (unusual) - they will use material index 0."); + } + + return jmeMeshes; + } + + /** + * Convert FBXMesh to IRMesh. + */ + public IrMesh toIRMesh() { + IrMesh newMesh = new IrMesh(); + newMesh.polygons = new IrPolygon[polygons.length]; + + int polygonVertexIndex = 0; + int positionIndex = 0; + + FbxLayer layer0 = layers[0]; + FbxLayer layer1 = layers.length > 1 ? layers[1] : null; + + for (int i = 0; i < polygons.length; i++) { + FbxPolygon polygon = polygons[i]; + IrPolygon irPolygon = new IrPolygon(); + irPolygon.vertices = new IrVertex[polygon.indices.length]; + + for (int j = 0; j < polygon.indices.length; j++) { + positionIndex = polygon.indices[j]; + + IrVertex irVertex = new IrVertex(); + irVertex.pos = positions[positionIndex]; + + if (layer0 != null) { + irVertex.norm = (Vector3f) layer0.getVertexData(FbxLayerElement.Type.Normal, i, polygonVertexIndex, positionIndex, 0); + irVertex.tang = (Vector3f) layer0.getVertexData(FbxLayerElement.Type.Tangent, i, polygonVertexIndex, positionIndex, 0); + irVertex.bitang = (Vector3f) layer0.getVertexData(FbxLayerElement.Type.Binormal, i, polygonVertexIndex, positionIndex, 0); + irVertex.uv0 = (Vector2f) layer0.getVertexData(FbxLayerElement.Type.UV, i, polygonVertexIndex, positionIndex, 0); + irVertex.color = (ColorRGBA) layer0.getVertexData(FbxLayerElement.Type.Color, i, polygonVertexIndex, positionIndex, 0); + irVertex.material = (Integer) layer0.getVertexData(FbxLayerElement.Type.Material, i, polygonVertexIndex, positionIndex, 0); + irVertex.smoothing = (Integer) layer0.getVertexData(FbxLayerElement.Type.Smoothing, i, polygonVertexIndex, positionIndex, 0); + } + + if (layer1 != null) { + irVertex.uv1 = (Vector2f) layer1.getVertexData(FbxLayerElement.Type.UV, i, + polygonVertexIndex, positionIndex, 0); + } + + if (boneIndices != null) { + ArrayList boneIndicesForVertex = boneIndices[positionIndex]; + ArrayList boneWeightsForVertex = boneWeights[positionIndex]; + if (boneIndicesForVertex != null) { + irVertex.boneWeightsIndices = toBoneWeightIndices(boneIndicesForVertex, boneWeightsForVertex); + } + } + + irPolygon.vertices[j] = irVertex; + + polygonVertexIndex++; + } + + newMesh.polygons[i] = irPolygon; + } + + // Ensure "inspection vertex" specifies that mesh has bone indices / weights + if (boneIndices != null && newMesh.polygons[0].vertices[0] == null) { + newMesh.polygons[0].vertices[0].boneWeightsIndices = new IrBoneWeightIndex[0]; + } + + return newMesh; + } +} diff --git a/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/mesh/FbxMeshUtil.java b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/mesh/FbxMeshUtil.java new file mode 100644 index 000000000..61fb001dd --- /dev/null +++ b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/mesh/FbxMeshUtil.java @@ -0,0 +1,69 @@ +/* + * Copyright (c) 2009-2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ +package com.jme3.scene.plugins.fbx.mesh; + +import com.jme3.scene.plugins.fbx.file.FbxElement; + +public class FbxMeshUtil { + + public static double[] getDoubleArray(FbxElement el) { + if (el.propertiesTypes[0] == 'd') { + // FBX 7.x + return (double[]) el.properties.get(0); + } else if (el.propertiesTypes[0] == 'D') { + // FBX 6.x + double[] doubles = new double[el.propertiesTypes.length]; + for (int i = 0; i < doubles.length; i++) { + doubles[i] = (Double) el.properties.get(i); + } + return doubles; + } else { + return null; + } + } + + public static int[] getIntArray(FbxElement el) { + if (el.propertiesTypes[0] == 'i') { + // FBX 7.x + return (int[]) el.properties.get(0); + } else if (el.propertiesTypes[0] == 'I') { + // FBX 6.x + int[] ints = new int[el.propertiesTypes.length]; + for (int i = 0; i < ints.length; i++) { + ints[i] = (Integer) el.properties.get(i); + } + return ints; + } else { + return null; + } + } +} diff --git a/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/mesh/FbxPolygon.java b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/mesh/FbxPolygon.java new file mode 100644 index 000000000..bb7773785 --- /dev/null +++ b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/mesh/FbxPolygon.java @@ -0,0 +1,59 @@ +/* + * Copyright (c) 2009-2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ +package com.jme3.scene.plugins.fbx.mesh; + +import java.util.Arrays; +import java.util.List; + +public final class FbxPolygon { + + int[] indices; + + @Override + public String toString() { + return Arrays.toString(indices); + } + + private static int[] listToArray(List indices) { + int[] indicesArray = new int[indices.size()]; + for (int i = 0; i < indices.size(); i++) { + indicesArray[i] = indices.get(i); + } + return indicesArray; + } + + public static FbxPolygon fromIndices(List indices) { + FbxPolygon poly = new FbxPolygon(); + poly.indices = listToArray(indices); + return poly; + } +} diff --git a/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/misc/FbxGlobalSettings.java b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/misc/FbxGlobalSettings.java new file mode 100644 index 000000000..3a815df6a --- /dev/null +++ b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/misc/FbxGlobalSettings.java @@ -0,0 +1,145 @@ +/* + * Copyright (c) 2009-2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ +package com.jme3.scene.plugins.fbx.misc; + +import com.jme3.math.ColorRGBA; +import com.jme3.math.Quaternion; +import com.jme3.math.Transform; +import com.jme3.math.Vector3f; +import com.jme3.scene.plugins.fbx.file.FbxElement; +import java.util.HashMap; +import java.util.Map; +import java.util.logging.Level; +import java.util.logging.Logger; + +public class FbxGlobalSettings { + + private static final Logger logger = Logger.getLogger(FbxGlobalSettings.class.getName()); + + private static final Map timeModeToFps = new HashMap(); + + static { + timeModeToFps.put(1, 120f); + timeModeToFps.put(2, 100f); + timeModeToFps.put(3, 60f); + timeModeToFps.put(4, 50f); + timeModeToFps.put(5, 48f); + timeModeToFps.put(6, 30f); + timeModeToFps.put(9, 30f / 1.001f); + timeModeToFps.put(10, 25f); + timeModeToFps.put(11, 24f); + timeModeToFps.put(13, 24f / 1.001f); + timeModeToFps.put(14, -1f); + timeModeToFps.put(15, 96f); + timeModeToFps.put(16, 72f); + timeModeToFps.put(17, 60f / 1.001f); + } + + public float unitScaleFactor = 1.0f; + public ColorRGBA ambientColor = ColorRGBA.Black; + public float frameRate = 25.0f; + + /** + * @return A {@link Transform} that converts from the FBX file coordinate + * system to jME3 coordinate system. + * jME3's coordinate system is: + *
    + *
  • Units are specified in meters.
    • + *
  • Orientation is right-handed with Y-up.
    • + *
+ */ + public Transform getGlobalTransform() { + // Default unit scale factor is 1 (centimeters), + // convert to meters. + float scale = unitScaleFactor / 100.0f; + + // TODO: handle rotation + + return new Transform(Vector3f.ZERO, Quaternion.IDENTITY, new Vector3f(scale, scale, scale)); + } + + public void fromElement(FbxElement element) { + // jME3 uses a +Y up, -Z forward coordinate system (same as OpenGL) + // Luckily enough, this is also the default for FBX models. + + int timeMode = -1; + float customFrameRate = 30.0f; + + for (FbxElement e2 : element.getFbxProperties()) { + String propName = (String) e2.properties.get(0); + if (propName.equals("UnitScaleFactor")) { + unitScaleFactor = ((Double) e2.properties.get(4)).floatValue(); + if (unitScaleFactor != 100.0f) { + logger.log(Level.WARNING, "FBX model isn't using meters for world units. Scale could be incorrect."); + } + } else if (propName.equals("TimeMode")) { + timeMode = (Integer) e2.properties.get(4); + } else if (propName.equals("CustomFrameRate")) { + float framerate = ((Double) e2.properties.get(4)).floatValue(); + if (framerate != -1) { + customFrameRate = framerate; + } + } else if (propName.equals("UpAxis")) { + Integer upAxis = (Integer) e2.properties.get(4); + if (upAxis != 1) { + logger.log(Level.WARNING, "FBX model isn't using Y as up axis. Orientation could be incorrect"); + } + } else if (propName.equals("UpAxisSign")) { + Integer upAxisSign = (Integer) e2.properties.get(4); + if (upAxisSign != 1) { + logger.log(Level.WARNING, "FBX model isn't using correct up axis sign. Orientation could be incorrect"); + } + } else if (propName.equals("FrontAxis")) { + Integer frontAxis = (Integer) e2.properties.get(4); + if (frontAxis != 2) { + logger.log(Level.WARNING, "FBX model isn't using Z as forward axis. Orientation could be incorrect"); + } + } else if (propName.equals("FrontAxisSign")) { + Integer frontAxisSign = (Integer) e2.properties.get(4); + if (frontAxisSign != -1) { + logger.log(Level.WARNING, "FBX model isn't using correct forward axis sign. Orientation could be incorrect"); + } + } + } + + Float fps = timeModeToFps.get(timeMode); + if (fps != null) { + if (fps == -1f) { + // Using custom framerate + frameRate = customFrameRate; + } else { + // Use FPS from time mode. + frameRate = fps; + } + } + } +} diff --git a/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/node/FbxNode.java b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/node/FbxNode.java new file mode 100644 index 000000000..c0ce06d4b --- /dev/null +++ b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/node/FbxNode.java @@ -0,0 +1,617 @@ +/* + * Copyright (c) 2009-2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ +package com.jme3.scene.plugins.fbx.node; + +import com.jme3.animation.AnimControl; +import com.jme3.animation.Skeleton; +import com.jme3.animation.SkeletonControl; +import com.jme3.asset.AssetManager; +import com.jme3.material.Material; +import com.jme3.math.ColorRGBA; +import com.jme3.math.FastMath; +import com.jme3.math.Matrix4f; +import com.jme3.math.Quaternion; +import com.jme3.math.Transform; +import com.jme3.math.Vector3f; +import com.jme3.renderer.queue.RenderQueue.Bucket; +import com.jme3.renderer.queue.RenderQueue.ShadowMode; +import com.jme3.scene.Geometry; +import com.jme3.scene.Mesh; +import com.jme3.scene.Node; +import com.jme3.scene.Spatial; +import com.jme3.scene.Spatial.CullHint; +import com.jme3.scene.debug.SkeletonDebugger; +import com.jme3.scene.plugins.fbx.anim.FbxAnimCurveNode; +import com.jme3.scene.plugins.fbx.anim.FbxCluster; +import com.jme3.scene.plugins.fbx.anim.FbxLimbNode; +import com.jme3.scene.plugins.fbx.anim.FbxSkinDeformer; +import com.jme3.scene.plugins.fbx.file.FbxElement; +import com.jme3.scene.plugins.fbx.material.FbxImage; +import com.jme3.scene.plugins.fbx.material.FbxMaterial; +import com.jme3.scene.plugins.fbx.material.FbxTexture; +import com.jme3.scene.plugins.fbx.mesh.FbxMesh; +import com.jme3.scene.plugins.fbx.obj.FbxObject; +import com.jme3.util.IntMap; +import java.util.ArrayList; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.logging.Level; +import java.util.logging.Logger; + +public class FbxNode extends FbxObject { + + private static final Logger logger = Logger.getLogger(FbxNode.class.getName()); + + private static enum InheritMode { + /** + * Apply parent scale after child rotation. + * This is the only mode correctly supported by jME3. + */ + ScaleAfterChildRotation, + + /** + * Apply parent scale before child rotation. + * Not supported by jME3, will cause distortion with + * non-uniform scale. No way around it. + */ + ScaleBeforeChildRotation, + + /** + * Do not apply parent scale at all. + * Not supported by jME3, will cause distortion. + * Could be worked around by via: + * jmeChildScale = jmeParentScale / fbxChildScale + */ + NoParentScale + } + + private InheritMode inheritMode = InheritMode.ScaleAfterChildRotation; + + protected FbxNode parent; + protected List children = new ArrayList(); + protected List materials = new ArrayList(); + protected Map userData = new HashMap(); + protected Map> propertyToAnimCurveMap = new HashMap>(); + protected FbxNodeAttribute nodeAttribute; + protected double visibility = 1.0; + + /** + * For FBX nodes that contain a skeleton (i.e. FBX limbs). + */ + protected Skeleton skeleton; + + protected final Transform jmeWorldNodeTransform = new Transform(); + protected final Transform jmeLocalNodeTransform = new Transform(); + + // optional - used for limbs / bones / skeletons + protected Transform jmeWorldBindPose; + protected Transform jmeLocalBindPose; + + // used for debugging only + protected Matrix4f cachedWorldBindPose; + + public FbxNode(AssetManager assetManager, String sceneFolderName) { + super(assetManager, sceneFolderName); + } + + public Transform computeFbxLocalTransform() { + // TODO: implement the actual algorithm, which is this: + // Render Local Translation = + // Inv Scale Pivot * Lcl Scale * Scale Pivot * Scale Offset * Inv Rota Pivot * Post Rotation * Rotation * Pre Rotation * Rotation Pivot * Rotation Offset * Translation + + // LclTranslation, + // LclRotation, + // PreRotation, + // PostRotation, + // RotationPivot, + // RotationOffset, + // LclScaling, + // ScalingPivot, + // ScalingOffset + + Matrix4f scaleMat = new Matrix4f(); + scaleMat.setScale(jmeLocalNodeTransform.getScale()); + + Matrix4f rotationMat = new Matrix4f(); + rotationMat.setRotationQuaternion(jmeLocalNodeTransform.getRotation()); + + Matrix4f translationMat = new Matrix4f(); + translationMat.setTranslation(jmeLocalNodeTransform.getTranslation()); + + Matrix4f result = new Matrix4f(); + result.multLocal(scaleMat).multLocal(rotationMat).multLocal(translationMat); + + Transform t = new Transform(); + t.fromTransformMatrix(result); + + return t; + } + + public void setWorldBindPose(Matrix4f worldBindPose) { + if (cachedWorldBindPose != null) { + if (!cachedWorldBindPose.equals(worldBindPose)) { + throw new UnsupportedOperationException("Bind poses don't match"); + } + } + + cachedWorldBindPose = worldBindPose; + + this.jmeWorldBindPose = new Transform(); + this.jmeWorldBindPose.setTranslation(worldBindPose.toTranslationVector()); + this.jmeWorldBindPose.setRotation(worldBindPose.toRotationQuat()); + this.jmeWorldBindPose.setScale(worldBindPose.toScaleVector()); + + System.out.println("\tBind Pose for " + getName()); + System.out.println(jmeWorldBindPose); + + float[] angles = new float[3]; + jmeWorldBindPose.getRotation().toAngles(angles); + System.out.println("Angles: " + angles[0] * FastMath.RAD_TO_DEG + ", " + + angles[1] * FastMath.RAD_TO_DEG + ", " + + angles[2] * FastMath.RAD_TO_DEG); + } + + public void updateWorldTransforms(Transform jmeParentNodeTransform, Transform parentBindPose) { + Transform fbxLocalTransform = computeFbxLocalTransform(); + jmeLocalNodeTransform.set(fbxLocalTransform); + + if (jmeParentNodeTransform != null) { + jmeParentNodeTransform = jmeParentNodeTransform.clone(); + switch (inheritMode) { + case NoParentScale: + case ScaleAfterChildRotation: + case ScaleBeforeChildRotation: + jmeWorldNodeTransform.set(jmeLocalNodeTransform); + jmeWorldNodeTransform.combineWithParent(jmeParentNodeTransform); + break; + } + } else { + jmeWorldNodeTransform.set(jmeLocalNodeTransform); + } + + if (jmeWorldBindPose != null) { + jmeLocalBindPose = new Transform(); + + // Need to derive local bind pose from world bind pose + // (this is to be expected for FBX limbs) + jmeLocalBindPose.set(jmeWorldBindPose); + jmeLocalBindPose.combineWithParent(parentBindPose.invert()); + + // Its somewhat odd for the transforms to differ ... + System.out.println("Bind Pose for: " + getName()); + if (!jmeLocalBindPose.equals(jmeLocalNodeTransform)) { + System.out.println("Local Bind: " + jmeLocalBindPose); + System.out.println("Local Trans: " + jmeLocalNodeTransform); + } + if (!jmeWorldBindPose.equals(jmeWorldNodeTransform)) { + System.out.println("World Bind: " + jmeWorldBindPose); + System.out.println("World Trans: " + jmeWorldNodeTransform); + } + } else { + // World pose derived from local transforms + // (this is to be expected for FBX nodes) + jmeLocalBindPose = new Transform(); + jmeWorldBindPose = new Transform(); + + jmeLocalBindPose.set(jmeLocalNodeTransform); + if (parentBindPose != null) { + jmeWorldBindPose.set(jmeLocalNodeTransform); + jmeWorldBindPose.combineWithParent(parentBindPose); + } else { + jmeWorldBindPose.set(jmeWorldNodeTransform); + } + } + + for (FbxNode child : children) { + child.updateWorldTransforms(jmeWorldNodeTransform, jmeWorldBindPose); + } + } + + @Override + public void fromElement(FbxElement element) { + super.fromElement(element); + + Vector3f localTranslation = new Vector3f(); + Quaternion localRotation = new Quaternion(); + Vector3f localScale = new Vector3f(Vector3f.UNIT_XYZ); + Quaternion preRotation = new Quaternion(); + + for (FbxElement e2 : element.getFbxProperties()) { + String propName = (String) e2.properties.get(0); + String type = (String) e2.properties.get(3); + if (propName.equals("Lcl Translation")) { + double x = (Double) e2.properties.get(4); + double y = (Double) e2.properties.get(5); + double z = (Double) e2.properties.get(6); + localTranslation.set((float) x, (float) y, (float) z); //.divideLocal(unitSize); + } else if (propName.equals("Lcl Rotation")) { + double x = (Double) e2.properties.get(4); + double y = (Double) e2.properties.get(5); + double z = (Double) e2.properties.get(6); + localRotation.fromAngles((float) x * FastMath.DEG_TO_RAD, (float) y * FastMath.DEG_TO_RAD, (float) z * FastMath.DEG_TO_RAD); + } else if (propName.equals("Lcl Scaling")) { + double x = (Double) e2.properties.get(4); + double y = (Double) e2.properties.get(5); + double z = (Double) e2.properties.get(6); + localScale.set((float) x, (float) y, (float) z); //.multLocal(unitSize); + } else if (propName.equals("PreRotation")) { + double x = (Double) e2.properties.get(4); + double y = (Double) e2.properties.get(5); + double z = (Double) e2.properties.get(6); + preRotation.set(FbxNodeUtil.quatFromBoneAngles((float) x * FastMath.DEG_TO_RAD, (float) y * FastMath.DEG_TO_RAD, (float) z * FastMath.DEG_TO_RAD)); + } else if (propName.equals("InheritType")) { + int inheritType = (Integer) e2.properties.get(4); + inheritMode = InheritMode.values()[inheritType]; + } else if (propName.equals("Visibility")) { + visibility = (Double) e2.properties.get(4); + } else if (type.contains("U")) { + String userDataKey = (String) e2.properties.get(0); + String userDataType = (String) e2.properties.get(1); + Object userDataValue; + + if (userDataType.equals("KString")) { + userDataValue = (String) e2.properties.get(4); + } else if (userDataType.equals("int")) { + userDataValue = (Integer) e2.properties.get(4); + } else if (userDataType.equals("double")) { + // NOTE: jME3 does not support doubles in UserData. + // Need to convert to float. + userDataValue = ((Double) e2.properties.get(4)).floatValue(); + } else if (userDataType.equals("Vector")) { + float x = ((Double) e2.properties.get(4)).floatValue(); + float y = ((Double) e2.properties.get(5)).floatValue(); + float z = ((Double) e2.properties.get(6)).floatValue(); + userDataValue = new Vector3f(x, y, z); + } else { + logger.log(Level.WARNING, "Unsupported user data type: {0}. Ignoring.", userDataType); + continue; + } + + userData.put(userDataKey, userDataValue); + } + } + + // Create local transform + // TODO: take into account Maya-style transforms (pre / post rotation ..) + jmeLocalNodeTransform.setTranslation(localTranslation); + jmeLocalNodeTransform.setRotation(localRotation); + jmeLocalNodeTransform.setScale(localScale); + + if (element.getChildById("Vertices") != null) { + // This is an old-style FBX 6.1 + // Meshes could be embedded inside the node.. + + // Inject the mesh into ourselves.. + FbxMesh mesh = new FbxMesh(assetManager, sceneFolderName); + mesh.fromElement(element); + connectObject(mesh); + } + } + + private Spatial tryCreateGeometry(int materialIndex, Mesh jmeMesh, boolean single) { + // Map meshes without material indices to material 0. + if (materialIndex == -1) { + materialIndex = 0; + } + + Material jmeMat; + if (materialIndex >= materials.size()) { + // Material index does not exist. Create default material. + jmeMat = new Material(assetManager, "Common/MatDefs/Light/Lighting.j3md"); + jmeMat.setReceivesShadows(true); + } else { + FbxMaterial fbxMat = materials.get(materialIndex); + jmeMat = fbxMat.getJmeObject(); + } + + String geomName = getName(); + if (single) { + geomName += "-submesh"; + } else { + geomName += "-mat-" + materialIndex + "-submesh"; + } + Spatial spatial = new Geometry(geomName, jmeMesh); + spatial.setMaterial(jmeMat); + if (jmeMat.isTransparent()) { + spatial.setQueueBucket(Bucket.Transparent); + } + if (jmeMat.isReceivesShadows()) { + spatial.setShadowMode(ShadowMode.Receive); + } + spatial.updateModelBound(); + return spatial; + } + + /** + * If this geometry node is deformed by a skeleton, this + * returns the node containing the skeleton. + * + * In jME3, a mesh can be deformed by a skeleton only if it is + * a child of the node containing the skeleton. However, this + * is not a requirement in FBX, so we have to modify the scene graph + * of the loaded model to adjust for this. + * This happens automatically in + * {@link #createScene(com.jme3.scene.plugins.fbx.node.FbxNode)}. + * + * @return The model this node would like to be a child of, or null + * if no preferred parent. + */ + public FbxNode getPreferredParent() { + if (!(nodeAttribute instanceof FbxMesh)) { + return null; + } + + FbxMesh fbxMesh = (FbxMesh) nodeAttribute; + FbxSkinDeformer deformer = fbxMesh.getSkinDeformer(); + FbxNode preferredParent = null; + + if (deformer != null) { + for (FbxCluster cluster : deformer.getJmeObject()) { + FbxLimbNode limb = cluster.getLimb(); + if (preferredParent == null) { + preferredParent = limb.getSkeletonHolder(); + } else if (preferredParent != limb.getSkeletonHolder()) { + logger.log(Level.WARNING, "A mesh is being deformed by multiple skeletons. " + + "Only one skeleton will work, ignoring other skeletons."); + } + } + } + + return preferredParent; + } + + @Override + public Spatial toJmeObject() { + Spatial spatial; + + if (nodeAttribute instanceof FbxMesh) { + FbxMesh fbxMesh = (FbxMesh) nodeAttribute; + IntMap jmeMeshes = fbxMesh.getJmeObject(); + + if (jmeMeshes == null || jmeMeshes.size() == 0) { + // No meshes found on FBXMesh (??) + logger.log(Level.WARNING, "No meshes could be loaded. Creating empty node."); + spatial = new Node(getName() + "-node"); + } else { + // Multiple jME3 geometries required for a single FBXMesh. + String nodeName; + if (children.isEmpty()) { + nodeName = getName() + "-mesh"; + } else { + nodeName = getName() + "-node"; + } + Node node = new Node(nodeName); + boolean singleMesh = jmeMeshes.size() == 1; + for (IntMap.Entry meshInfo : jmeMeshes) { + node.attachChild(tryCreateGeometry(meshInfo.getKey(), meshInfo.getValue(), singleMesh)); + } + spatial = node; + } + } else { + if (nodeAttribute != null) { + // Just specifies that this is a "null" node. + nodeAttribute.getJmeObject(); + } + + // TODO: handle other node attribute types. + // right now everything we don't know about gets converted + // to jME3 Node. + spatial = new Node(getName() + "-node"); + } + + if (!children.isEmpty()) { + // Check uniform scale. + // Although, if inheritType is 0 (eInheritRrSs) + // it might not be a problem. + Vector3f localScale = jmeLocalNodeTransform.getScale(); + if (!FastMath.approximateEquals(localScale.x, localScale.y) || + !FastMath.approximateEquals(localScale.x, localScale.z)) { + logger.log(Level.WARNING, "Non-uniform scale detected on parent node. " + + "The model may appear distorted."); + } + } + + spatial.setLocalTransform(jmeLocalNodeTransform); + + if (visibility == 0.0) { + spatial.setCullHint(CullHint.Always); + } + + for (Map.Entry userDataEntry : userData.entrySet()) { + spatial.setUserData(userDataEntry.getKey(), userDataEntry.getValue()); + } + + return spatial; + } + + /** + * Create jME3 Skeleton objects on the scene. + * + * Goes through the scene graph and finds limbs that are + * attached to FBX nodes, then creates a Skeleton on the node + * based on the child limbs. + * + * Must be called prior to calling + * {@link #createScene(com.jme3.scene.plugins.fbx.node.FbxNode)}. + * + * @param fbxNode The root FBX node. + */ + public static void createSkeletons(FbxNode fbxNode) { + boolean createSkeleton = false; + for (FbxNode fbxChild : fbxNode.children) { + if (fbxChild instanceof FbxLimbNode) { + createSkeleton = true; + } else { + createSkeletons(fbxChild); + } + } + if (createSkeleton) { + if (fbxNode.skeleton != null) { + throw new UnsupportedOperationException(); + } + fbxNode.skeleton = FbxLimbNode.createSkeleton(fbxNode); + System.out.println("created skeleton: " + fbxNode.skeleton); + } + } + + private static void relocateSpatial(Spatial spatial, + Transform originalWorldTransform, Transform newWorldTransform) { + Transform localTransform = new Transform(); + localTransform.set(originalWorldTransform); + localTransform.combineWithParent(newWorldTransform.invert()); + spatial.setLocalTransform(localTransform); + } + + public static Spatial createScene(FbxNode fbxNode) { + Spatial jmeSpatial = fbxNode.getJmeObject(); + + if (jmeSpatial instanceof Node) { + // Attach children to Node + Node jmeNode = (Node) jmeSpatial; + for (FbxNode fbxChild : fbxNode.children) { + if (!(fbxChild instanceof FbxLimbNode)) { + createScene(fbxChild); + + FbxNode preferredParent = fbxChild.getPreferredParent(); + Spatial jmeChild = fbxChild.getJmeObject(); + if (preferredParent != null) { + System.out.println("Preferred parent for " + fbxChild + " is " + preferredParent); + + Node jmePreferredParent = (Node) preferredParent.getJmeObject(); + relocateSpatial(jmeChild, fbxChild.jmeWorldNodeTransform, + preferredParent.jmeWorldNodeTransform); + jmePreferredParent.attachChild(jmeChild); + } else { + jmeNode.attachChild(jmeChild); + } + } + } + } + + if (fbxNode.skeleton != null) { + jmeSpatial.addControl(new AnimControl(fbxNode.skeleton)); + jmeSpatial.addControl(new SkeletonControl(fbxNode.skeleton)); + + SkeletonDebugger sd = new SkeletonDebugger("debug", fbxNode.skeleton); + Material mat = new Material(fbxNode.assetManager, "Common/MatDefs/Misc/Unshaded.j3md"); + mat.getAdditionalRenderState().setWireframe(true); + mat.getAdditionalRenderState().setDepthTest(false); + mat.setColor("Color", ColorRGBA.Green); + sd.setMaterial(mat); + + ((Node)jmeSpatial).attachChild(sd); + } + + return jmeSpatial; + } + +// public SceneLoader.Limb toLimb() { +// SceneLoader.Limb limb = new SceneLoader.Limb(); +// limb.name = getName(); +// Quaternion rotation = preRotation.mult(localRotation); +// limb.bindTransform = new Transform(localTranslation, rotation, localScale); +// return limb; +// } + + public Skeleton getJmeSkeleton() { + return skeleton; + } + + public List getChildren() { + return children; + } + + @Override + public void connectObject(FbxObject object) { + if (object instanceof FbxNode) { + // Scene Graph Object + FbxNode childNode = (FbxNode) object; + if (childNode.parent != null) { + throw new IllegalStateException("Cannot attach " + childNode + + " to " + this + ". It is already " + + "attached to " + childNode.parent); + } + childNode.parent = this; + children.add(childNode); + } else if (object instanceof FbxNodeAttribute) { + // Node Attribute + if (nodeAttribute != null) { + throw new IllegalStateException("An FBXNodeAttribute (" + nodeAttribute + ")" + + " is already attached to " + this + ". " + + "Only one attribute allowed per node."); + } + + nodeAttribute = (FbxNodeAttribute) object; + if (nodeAttribute instanceof FbxNullAttribute) { + nodeAttribute.getJmeObject(); + } + } else if (object instanceof FbxMaterial) { + materials.add((FbxMaterial) object); + } else if (object instanceof FbxImage || object instanceof FbxTexture) { + // Ignore - attaching textures to nodes is legacy feature. + } else { + unsupportedConnectObject(object); + } + } + + @Override + public void connectObjectProperty(FbxObject object, String property) { + // Only allowed to connect local transform properties to object + // (FbxAnimCurveNode) + if (object instanceof FbxAnimCurveNode) { + FbxAnimCurveNode curveNode = (FbxAnimCurveNode) object; + if (property.equals("Lcl Translation") + || property.equals("Lcl Rotation") + || property.equals("Lcl Scaling")) { + + List curveNodes = propertyToAnimCurveMap.get(property); + if (curveNodes == null) { + curveNodes = new ArrayList(); + curveNodes.add(curveNode); + propertyToAnimCurveMap.put(property, curveNodes); + } + curveNodes.add(curveNode); + + // Make sure the curve knows about it animating + // this node as well. + curveNode.addInfluencedNode(this, property); + } else { + logger.log(Level.WARNING, "Animating the property ''{0}'' is not " + + "supported. Ignoring.", property); + } + } else { + unsupportedConnectObjectProperty(object, property); + } + } + +} diff --git a/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/node/FbxNodeAttribute.java b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/node/FbxNodeAttribute.java new file mode 100644 index 000000000..b63e4bc08 --- /dev/null +++ b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/node/FbxNodeAttribute.java @@ -0,0 +1,41 @@ +/* + * Copyright (c) 2009-2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ +package com.jme3.scene.plugins.fbx.node; + +import com.jme3.asset.AssetManager; +import com.jme3.scene.plugins.fbx.obj.FbxObject; + +public abstract class FbxNodeAttribute extends FbxObject { + public FbxNodeAttribute(AssetManager assetManager, String sceneFolderName) { + super(assetManager, sceneFolderName); + } +} diff --git a/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/node/FbxNodeUtil.java b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/node/FbxNodeUtil.java new file mode 100644 index 000000000..8c35e45e9 --- /dev/null +++ b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/node/FbxNodeUtil.java @@ -0,0 +1,61 @@ +/* + * Copyright (c) 2009-2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ +package com.jme3.scene.plugins.fbx.node; + +import com.jme3.math.FastMath; +import com.jme3.math.Quaternion; + +public class FbxNodeUtil { + public static Quaternion quatFromBoneAngles(float xAngle, float yAngle, float zAngle) { + float angle; + float sinY, sinZ, sinX, cosY, cosZ, cosX; + angle = zAngle * 0.5f; + sinZ = FastMath.sin(angle); + cosZ = FastMath.cos(angle); + angle = yAngle * 0.5f; + sinY = FastMath.sin(angle); + cosY = FastMath.cos(angle); + angle = xAngle * 0.5f; + sinX = FastMath.sin(angle); + cosX = FastMath.cos(angle); + float cosYXcosZ = cosY * cosZ; + float sinYXsinZ = sinY * sinZ; + float cosYXsinZ = cosY * sinZ; + float sinYXcosZ = sinY * cosZ; + // For some reason bone space is differ, this is modified formulas + float w = (cosYXcosZ * cosX + sinYXsinZ * sinX); + float x = (cosYXcosZ * sinX - sinYXsinZ * cosX); + float y = (sinYXcosZ * cosX + cosYXsinZ * sinX); + float z = (cosYXsinZ * cosX - sinYXcosZ * sinX); + return new Quaternion(x, y, z, w).normalizeLocal(); + } +} diff --git a/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/node/FbxNullAttribute.java b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/node/FbxNullAttribute.java new file mode 100644 index 000000000..ce95546d8 --- /dev/null +++ b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/node/FbxNullAttribute.java @@ -0,0 +1,59 @@ +/* + * Copyright (c) 2009-2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ +package com.jme3.scene.plugins.fbx.node; + +import com.jme3.asset.AssetManager; +import com.jme3.scene.plugins.fbx.obj.FbxObject; + +public class FbxNullAttribute extends FbxNodeAttribute { + + public FbxNullAttribute(AssetManager assetManager, String sceneFolderName) { + super(assetManager, sceneFolderName); + } + + @Override + protected Object toJmeObject() { + // No data in a "Null" attribute. + return new Object(); + } + + @Override + public void connectObject(FbxObject object) { + throw new UnsupportedOperationException(); + } + + @Override + public void connectObjectProperty(FbxObject object, String property) { + throw new UnsupportedOperationException(); + } + +} diff --git a/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/node/FbxRootNode.java b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/node/FbxRootNode.java new file mode 100644 index 000000000..83db50283 --- /dev/null +++ b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/node/FbxRootNode.java @@ -0,0 +1,45 @@ +/* + * Copyright (c) 2009-2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ +package com.jme3.scene.plugins.fbx.node; + +import com.jme3.asset.AssetManager; +import com.jme3.scene.plugins.fbx.file.FbxId; + +public class FbxRootNode extends FbxNode { + public FbxRootNode(AssetManager assetManager, String sceneFolderName) { + super(assetManager, sceneFolderName); + this.id = FbxId.ROOT; + this.className = "Model"; + this.name = "Scene"; + this.subclassName = ""; + } +} diff --git a/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/obj/FbxObject.java b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/obj/FbxObject.java new file mode 100644 index 000000000..d9439a2d4 --- /dev/null +++ b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/obj/FbxObject.java @@ -0,0 +1,144 @@ +/* + * Copyright (c) 2009-2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ +package com.jme3.scene.plugins.fbx.obj; + +import com.jme3.asset.AssetManager; +import com.jme3.scene.plugins.fbx.file.FbxElement; +import com.jme3.scene.plugins.fbx.file.FbxId; +import java.util.logging.Logger; + +public abstract class FbxObject { + + private static final Logger logger = Logger.getLogger(FbxObject.class.getName()); + + protected AssetManager assetManager; + protected String sceneFolderName; + + protected FbxId id; + protected String name; + protected String className; + protected String subclassName; + + protected JT jmeObject; // lazily initialized + + protected FbxObject(AssetManager assetManager, String sceneFolderName) { + this.assetManager = assetManager; + this.sceneFolderName = sceneFolderName; + } + + public FbxId getId() { + return id; + } + + public String getName() { + return name; + } + + public String getClassName() { + return className; + } + + public String getSubclassName() { + return subclassName; + } + + public String getFullClassName() { + if (subclassName.equals("")) { + return className; + } else { + return subclassName + " : " + className; + } + } + + @Override + public String toString() { + return name + " (" + id + ")"; + } + + protected void fromElement(FbxElement element) { + id = FbxId.getObjectId(element); + String nameAndClass; + if (element.propertiesTypes.length == 3) { + nameAndClass = (String) element.properties.get(1); + subclassName = (String) element.properties.get(2); + } else if (element.propertiesTypes.length == 2) { + nameAndClass = (String) element.properties.get(0); + subclassName = (String) element.properties.get(1); + } else { + throw new UnsupportedOperationException("This is not an FBX object: " + element.id); + } + + int splitter = nameAndClass.indexOf("\u0000\u0001"); + + if (splitter != -1) { + name = nameAndClass.substring(0, splitter); + className = nameAndClass.substring(splitter + 2); + } else { + name = nameAndClass; + className = null; + } + } + + public final JT getJmeObject() { + if (jmeObject == null) { + jmeObject = toJmeObject(); + if (jmeObject == null) { + throw new UnsupportedOperationException("FBX object subclass " + + "failed to resolve to a jME3 object"); + } + } + return jmeObject; + } + + public final boolean isJmeObjectCreated() { + return jmeObject != null; + } + + protected final void unsupportedConnectObject(FbxObject object) { + throw new IllegalArgumentException("Cannot attach objects of this class (" + + object.getFullClassName() + + ") to " + getClass().getSimpleName()); + } + + protected final void unsupportedConnectObjectProperty(FbxObject object, String property) { + throw new IllegalArgumentException("Cannot attach objects of this class (" + + object.getFullClassName() + + ") to property " + getClass().getSimpleName() + + "[\"" + property + "\"]"); + } + + protected abstract JT toJmeObject(); + + public abstract void connectObject(FbxObject object); + + public abstract void connectObjectProperty(FbxObject object, String property); +} diff --git a/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/obj/FbxObjectFactory.java b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/obj/FbxObjectFactory.java new file mode 100644 index 000000000..ec8c1fd67 --- /dev/null +++ b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/obj/FbxObjectFactory.java @@ -0,0 +1,209 @@ +/* + * Copyright (c) 2009-2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ +package com.jme3.scene.plugins.fbx.obj; + +import com.jme3.asset.AssetManager; +import com.jme3.scene.plugins.fbx.anim.FbxAnimCurve; +import com.jme3.scene.plugins.fbx.anim.FbxAnimCurveNode; +import com.jme3.scene.plugins.fbx.anim.FbxAnimLayer; +import com.jme3.scene.plugins.fbx.anim.FbxAnimStack; +import com.jme3.scene.plugins.fbx.anim.FbxBindPose; +import com.jme3.scene.plugins.fbx.anim.FbxCluster; +import com.jme3.scene.plugins.fbx.anim.FbxLimbNode; +import com.jme3.scene.plugins.fbx.anim.FbxSkinDeformer; +import com.jme3.scene.plugins.fbx.file.FbxElement; +import com.jme3.scene.plugins.fbx.material.FbxImage; +import com.jme3.scene.plugins.fbx.material.FbxMaterial; +import com.jme3.scene.plugins.fbx.material.FbxTexture; +import com.jme3.scene.plugins.fbx.mesh.FbxMesh; +import com.jme3.scene.plugins.fbx.node.FbxNode; +import com.jme3.scene.plugins.fbx.node.FbxNullAttribute; +import java.lang.reflect.Constructor; +import java.lang.reflect.InvocationTargetException; +import java.util.logging.Level; +import java.util.logging.Logger; + +/** + * Responsible for producing FBX objects given an FBXElement. + */ +public final class FbxObjectFactory { + + private static final Logger logger = Logger.getLogger(FbxObjectFactory.class.getName()); + + private static Class getImplementingClass(String elementName, String subclassName) { + if (elementName.equals("NodeAttribute")) { + if (subclassName.equals("Root")) { + // Root of skeleton, may not actually be set. + return FbxNullAttribute.class; + } else if (subclassName.equals("LimbNode")) { + // Specifies some limb attributes, optional. + return FbxNullAttribute.class; + } else if (subclassName.equals("Null")) { + // An "Empty" or "Node" without any specific behavior. + return FbxNullAttribute.class; + } else if (subclassName.equals("IKEffector") || + subclassName.equals("FKEffector")) { + // jME3 does not support IK. + return FbxNullAttribute.class; + } else { + // NodeAttribute - Unknown + logger.log(Level.WARNING, "Unknown object subclass: {0}. Ignoring.", subclassName); + return FbxUnknownObject.class; + } + } else if (elementName.equals("Geometry") && subclassName.equals("Mesh")) { + // NodeAttribute - Mesh Data + return FbxMesh.class; + } else if (elementName.equals("Model")) { + // Scene Graph Node + // Determine specific subclass (e.g. Mesh, Null, or LimbNode?) + if (subclassName.equals("LimbNode")) { + return FbxLimbNode.class; // Child Bone of Skeleton? + } else { + return FbxNode.class; + } + } else if (elementName.equals("Pose")) { + if (subclassName.equals("BindPose")) { + // Bind Pose Information + return FbxBindPose.class; + } else { + // Rest Pose Information + // OR + // Other Data (???) + logger.log(Level.WARNING, "Unknown object subclass: {0}. Ignoring.", subclassName); + return FbxUnknownObject.class; + } + } else if (elementName.equals("Material")) { + return FbxMaterial.class; + } else if (elementName.equals("Deformer")) { + // Deformer + if (subclassName.equals("Skin")) { + // FBXSkinDeformer (mapping between FBXMesh & FBXClusters) + return FbxSkinDeformer.class; + } else if (subclassName.equals("Cluster")) { + // Cluster (aka mapping between FBXMesh vertices & weights for bone) + return FbxCluster.class; + } else { + logger.log(Level.WARNING, "Unknown deformer subclass: {0}. Ignoring.", subclassName); + return FbxUnknownObject.class; + } + } else if (elementName.equals("Video")) { + if (subclassName.equals("Clip")) { + return FbxImage.class; + } else { + logger.log(Level.WARNING, "Unknown object subclass: {0}. Ignoring.", subclassName); + return FbxUnknownObject.class; + } + } else if (elementName.equals("Texture")) { + return FbxTexture.class; + } else if (elementName.equals("AnimationStack")) { + // AnimationStack (jME Animation) + return FbxAnimStack.class; + } else if (elementName.equals("AnimationLayer")) { + // AnimationLayer (for blended animation - not supported) + return FbxAnimLayer.class; + } else if (elementName.equals("AnimationCurveNode")) { + // AnimationCurveNode + return FbxAnimCurveNode.class; + } else if (elementName.equals("AnimationCurve")) { + // AnimationCurve (Data) + return FbxAnimCurve.class; + } else if (elementName.equals("SceneInfo")) { + // Old-style FBX 6.1 uses this. Nothing useful here. + return FbxUnknownObject.class; + } else { + logger.log(Level.WARNING, "Unknown object class: {0}. Ignoring.", elementName); + return FbxUnknownObject.class; + } + } + + /** + * Automatically create an FBXObject by inspecting its class / subclass + * properties. + * + * @param element The element from which to create an object. + * @param assetManager AssetManager to load dependent resources + * @param sceneFolderName Folder relative to which resources shall be loaded + * @return The object, or null if not supported (?) + */ + public static FbxObject createObject(FbxElement element, AssetManager assetManager, String sceneFolderName) { + String elementName = element.id; + String subclassName; + + if (element.propertiesTypes.length == 3) { + // FBX 7.x (all objects start with Long ID) + subclassName = (String) element.properties.get(2); + } else if (element.propertiesTypes.length == 2) { + // FBX 6.x (objects only have name and subclass) + subclassName = (String) element.properties.get(1); + } else { + // Not an object or invalid data. + return null; + } + + Class javaFbxClass = getImplementingClass(elementName, subclassName); + + if (javaFbxClass != null) { + try { + // This object is supported by FBX importer, create new instance. + // Import the data into the object from the element, then return it. + Constructor ctor = javaFbxClass.getConstructor(AssetManager.class, String.class); + FbxObject obj = ctor.newInstance(assetManager, sceneFolderName); + obj.fromElement(element); + + String subClassName = elementName + ", " + subclassName; + if (obj.assetManager == null) { + throw new IllegalStateException("FBXObject subclass (" + subClassName + + ") forgot to call super() in their constructor"); + } else if (obj.className == null) { + throw new IllegalStateException("FBXObject subclass (" + subClassName + + ") forgot to call super.fromElement() in their fromElement() implementation"); + } + return obj; + } catch (InvocationTargetException ex) { + // Programmer error. + throw new IllegalStateException(ex); + } catch (NoSuchMethodException ex) { + // Programmer error. + throw new IllegalStateException(ex); + } catch (InstantiationException ex) { + // Programmer error. + throw new IllegalStateException(ex); + } catch (IllegalAccessException ex) { + // Programmer error. + throw new IllegalStateException(ex); + } + } + + // Not supported object. + return null; + } +} diff --git a/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/obj/FbxUnknownObject.java b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/obj/FbxUnknownObject.java new file mode 100644 index 000000000..9a1eaa910 --- /dev/null +++ b/jme3-plugins/src/fbx/java/com/jme3/scene/plugins/fbx/obj/FbxUnknownObject.java @@ -0,0 +1,54 @@ +/* + * Copyright (c) 2009-2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ +package com.jme3.scene.plugins.fbx.obj; + +import com.jme3.asset.AssetManager; + +public class FbxUnknownObject extends FbxObject { + + public FbxUnknownObject(AssetManager assetManager, String sceneFolderName) { + super(assetManager, sceneFolderName); + } + + @Override + protected Void toJmeObject() { + throw new UnsupportedOperationException(); + } + + @Override + public void connectObject(FbxObject object) { + } + + @Override + public void connectObjectProperty(FbxObject object, String property) { + } +} diff --git a/jme3-plugins/src/main/java/com/jme3/scene/plugins/IrBoneWeightIndex.java b/jme3-plugins/src/main/java/com/jme3/scene/plugins/IrBoneWeightIndex.java new file mode 100644 index 000000000..523993f51 --- /dev/null +++ b/jme3-plugins/src/main/java/com/jme3/scene/plugins/IrBoneWeightIndex.java @@ -0,0 +1,89 @@ +/* + * Copyright (c) 2009-2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ +package com.jme3.scene.plugins; + +public class IrBoneWeightIndex implements Cloneable, Comparable { + + int boneIndex; + float boneWeight; + + public IrBoneWeightIndex(int boneIndex, float boneWeight) { + this.boneIndex = boneIndex; + this.boneWeight = boneWeight; + } + + @Override + public Object clone() { + try { + return super.clone(); + } catch (CloneNotSupportedException ex) { + throw new AssertionError(ex); + } + } + + @Override + public int hashCode() { + int hash = 7; + hash = 23 * hash + this.boneIndex; + hash = 23 * hash + Float.floatToIntBits(this.boneWeight); + return hash; + } + + @Override + public boolean equals(Object obj) { + if (obj == null) { + return false; + } + if (getClass() != obj.getClass()) { + return false; + } + final IrBoneWeightIndex other = (IrBoneWeightIndex) obj; + if (this.boneIndex != other.boneIndex) { + return false; + } + if (Float.floatToIntBits(this.boneWeight) != Float.floatToIntBits(other.boneWeight)) { + return false; + } + return true; + } + + @Override + public int compareTo(IrBoneWeightIndex o) { + if (boneWeight < o.boneWeight) { + return 1; + } else if (boneWeight > o.boneWeight) { + return -1; + } else { + return 0; + } + } +} diff --git a/jme3-plugins/src/main/java/com/jme3/scene/plugins/IrMesh.java b/jme3-plugins/src/main/java/com/jme3/scene/plugins/IrMesh.java new file mode 100644 index 000000000..8bb5a6881 --- /dev/null +++ b/jme3-plugins/src/main/java/com/jme3/scene/plugins/IrMesh.java @@ -0,0 +1,46 @@ +/* + * Copyright (c) 2009-2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ +package com.jme3.scene.plugins; + +public class IrMesh { + + public IrPolygon[] polygons; + + public IrMesh deepClone() { + IrMesh m = new IrMesh(); + m.polygons = new IrPolygon[polygons.length]; + for (int i = 0; i < polygons.length; i++) { + m.polygons[i] = polygons[i].deepClone(); + } + return m; + } +} diff --git a/jme3-plugins/src/main/java/com/jme3/scene/plugins/IrPolygon.java b/jme3-plugins/src/main/java/com/jme3/scene/plugins/IrPolygon.java new file mode 100644 index 000000000..7bb47cb54 --- /dev/null +++ b/jme3-plugins/src/main/java/com/jme3/scene/plugins/IrPolygon.java @@ -0,0 +1,46 @@ +/* + * Copyright (c) 2009-2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ +package com.jme3.scene.plugins; + +public class IrPolygon { + + public IrVertex[] vertices; + + public IrPolygon deepClone() { + IrPolygon p = new IrPolygon(); + p.vertices = new IrVertex[vertices.length]; + for (int i = 0; i < vertices.length; i++) { + p.vertices[i] = vertices[i].deepClone(); + } + return p; + } +} diff --git a/jme3-plugins/src/main/java/com/jme3/scene/plugins/IrUtils.java b/jme3-plugins/src/main/java/com/jme3/scene/plugins/IrUtils.java new file mode 100644 index 000000000..7b20e1670 --- /dev/null +++ b/jme3-plugins/src/main/java/com/jme3/scene/plugins/IrUtils.java @@ -0,0 +1,400 @@ +/* + * Copyright (c) 2009-2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ +package com.jme3.scene.plugins; + +import com.jme3.math.Vector4f; +import com.jme3.scene.Mesh; +import com.jme3.scene.VertexBuffer; +import com.jme3.scene.mesh.IndexBuffer; +import com.jme3.scene.mesh.IndexIntBuffer; +import com.jme3.scene.mesh.IndexShortBuffer; +import com.jme3.util.BufferUtils; +import com.jme3.util.IntMap; +import java.nio.ByteBuffer; +import java.nio.FloatBuffer; +import java.nio.IntBuffer; +import java.nio.ShortBuffer; +import java.util.ArrayList; +import java.util.Arrays; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.logging.Level; +import java.util.logging.Logger; + +public final class IrUtils { + + private static final Logger logger = Logger.getLogger(IrUtils.class.getName()); + + private IrUtils() { } + + private static IrPolygon[] quadToTri(IrPolygon quad) { + if (quad.vertices.length == 3) { + throw new IllegalStateException("Already a triangle"); + } + + IrPolygon[] t = new IrPolygon[]{ new IrPolygon(), new IrPolygon() }; + t[0].vertices = new IrVertex[3]; + t[1].vertices = new IrVertex[3]; + + IrVertex v0 = quad.vertices[0]; + IrVertex v1 = quad.vertices[1]; + IrVertex v2 = quad.vertices[2]; + IrVertex v3 = quad.vertices[3]; + + // find the pair of verticies that is closest to each over + // v0 and v2 + // OR + // v1 and v3 + float d1 = v0.pos.distanceSquared(v2.pos); + float d2 = v1.pos.distanceSquared(v3.pos); + if (d1 < d2) { + // v0 is close to v2 + // put an edge in v0, v2 + t[0].vertices[0] = v0; + t[0].vertices[1] = v1; + t[0].vertices[2] = v3; + + t[1].vertices[0] = v1; + t[1].vertices[1] = v2; + t[1].vertices[2] = v3; + } else { + // put an edge in v1, v3 + t[0].vertices[0] = v0; + t[0].vertices[1] = v1; + t[0].vertices[2] = v2; + + t[1].vertices[0] = v0; + t[1].vertices[1] = v2; + t[1].vertices[2] = v3; + } + + return t; + } + + /** + * Applies smoothing groups to vertex normals. + */ + public static IrMesh applySmoothingGroups(IrMesh mesh) { + return null; + } + + private static void toTangentsWithParity(IrVertex vertex) { + if (vertex.tang != null && vertex.bitang != null) { + float wCoord = vertex.norm.cross(vertex.tang).dot(vertex.bitang) < 0f ? -1f : 1f; + vertex.tang4d = new Vector4f(vertex.tang.x, vertex.tang.y, vertex.tang.z, wCoord); + vertex.tang = null; + vertex.bitang = null; + } + } + + public static void toTangentsWithParity(IrMesh mesh) { + for (IrPolygon polygon : mesh.polygons) { + for (IrVertex vertex : polygon.vertices) { + toTangentsWithParity(vertex); + } + } + } + + private static void trimBoneWeights(IrVertex vertex) { + if (vertex.boneWeightsIndices == null) { + return; + } + + IrBoneWeightIndex[] boneWeightsIndices = vertex.boneWeightsIndices; + + if (boneWeightsIndices.length <= 4) { + return; + } + + // Sort by weight + boneWeightsIndices = Arrays.copyOf(boneWeightsIndices, boneWeightsIndices.length); + Arrays.sort(boneWeightsIndices); + + // Trim to four weights at most + boneWeightsIndices = Arrays.copyOf(boneWeightsIndices, 4); + + // Renormalize weights + float sum = 0; + + for (int i = 0; i < boneWeightsIndices.length; i++) { + sum += boneWeightsIndices[i].boneWeight; + } + + if (sum != 1f) { + float sumToB = sum == 0 ? 0 : 1f / sum; + for (int i = 0; i < boneWeightsIndices.length; i++) { + IrBoneWeightIndex original = boneWeightsIndices[i]; + boneWeightsIndices[i] = new IrBoneWeightIndex(original.boneIndex, original.boneWeight * sumToB); + } + } + + vertex.boneWeightsIndices = boneWeightsIndices; + } + + /** + * Removes low bone weights from mesh, leaving only 4 bone weights at max. + */ + public static void trimBoneWeights(IrMesh mesh) { + for (IrPolygon polygon : mesh.polygons) { + for (IrVertex vertex : polygon.vertices) { + trimBoneWeights(vertex); + } + } + } + + /** + * Convert mesh from quads / triangles to triangles only. + */ + public static void triangulate(IrMesh mesh) { + List newPolygons = new ArrayList(mesh.polygons.length); + for (IrPolygon inputPoly : mesh.polygons) { + if (inputPoly.vertices.length == 4) { + IrPolygon[] tris = quadToTri(inputPoly); + newPolygons.add(tris[0]); + newPolygons.add(tris[1]); + } else if (inputPoly.vertices.length == 3) { + newPolygons.add(inputPoly); + } else { + // N-gon. We have to ignore it.. + logger.log(Level.WARNING, "N-gon encountered, ignoring. " + + "The mesh may not appear correctly. " + + "Triangulate your model prior to export."); + } + } + mesh.polygons = new IrPolygon[newPolygons.size()]; + newPolygons.toArray(mesh.polygons); + } + + /** + * Separate mesh with multiple materials into multiple meshes each with + * one material each. + * + * Polygons without a material will be added to key = -1. + */ + public static IntMap splitByMaterial(IrMesh mesh) { + IntMap> materialToPolyList = new IntMap>(); + for (IrPolygon polygon : mesh.polygons) { + int materialIndex = -1; + for (IrVertex vertex : polygon.vertices) { + if (vertex.material == null) { + continue; + } + if (materialIndex == -1) { + materialIndex = vertex.material; + } else if (materialIndex != vertex.material) { + throw new UnsupportedOperationException("Multiple materials " + + "assigned to the same polygon"); + } + } + List polyList = materialToPolyList.get(materialIndex); + if (polyList == null) { + polyList = new ArrayList(); + materialToPolyList.put(materialIndex, polyList); + } + polyList.add(polygon); + } + IntMap materialToMesh = new IntMap(); + for (IntMap.Entry> entry : materialToPolyList) { + int key = entry.getKey(); + List polygons = entry.getValue(); + if (polygons.size() > 0) { + IrMesh newMesh = new IrMesh(); + newMesh.polygons = new IrPolygon[polygons.size()]; + polygons.toArray(newMesh.polygons); + materialToMesh.put(key, newMesh); + } + } + return materialToMesh; + } + + /** + * Convert IrMesh to jME3 mesh. + */ + public static Mesh convertIrMeshToJmeMesh(IrMesh mesh) { + Map vertexToVertexIndex = new HashMap(); + List vertices = new ArrayList(); + List indexes = new ArrayList(); + + int vertexIndex = 0; + for (IrPolygon polygon : mesh.polygons) { + if (polygon.vertices.length != 3) { + throw new UnsupportedOperationException("IrMesh must be triangulated first"); + } + for (IrVertex vertex : polygon.vertices) { + // Is this vertex already indexed? + Integer existingIndex = vertexToVertexIndex.get(vertex); + if (existingIndex == null) { + // Not indexed yet, allocate index. + indexes.add(vertexIndex); + vertexToVertexIndex.put(vertex, vertexIndex); + vertices.add(vertex); + vertexIndex++; + } else { + // Index already allocated for this vertex, reuse it. + indexes.add(existingIndex); + } + } + } + + Mesh jmeMesh = new Mesh(); + jmeMesh.setMode(Mesh.Mode.Triangles); + + FloatBuffer posBuf = null; + FloatBuffer normBuf = null; + FloatBuffer tangBuf = null; + FloatBuffer uv0Buf = null; + FloatBuffer uv1Buf = null; + ByteBuffer colorBuf = null; + ByteBuffer boneIndices = null; + FloatBuffer boneWeights = null; + IndexBuffer indexBuf = null; + + IrVertex inspectionVertex = vertices.get(0); + if (inspectionVertex.pos != null) { + posBuf = BufferUtils.createVector3Buffer(vertices.size()); + jmeMesh.setBuffer(VertexBuffer.Type.Position, 3, posBuf); + } + if (inspectionVertex.norm != null) { + normBuf = BufferUtils.createVector3Buffer(vertices.size()); + jmeMesh.setBuffer(VertexBuffer.Type.Normal, 3, normBuf); + } + if (inspectionVertex.tang4d != null) { + tangBuf = BufferUtils.createFloatBuffer(vertices.size() * 4); + jmeMesh.setBuffer(VertexBuffer.Type.Tangent, 4, tangBuf); + } + if (inspectionVertex.tang != null || inspectionVertex.bitang != null) { + throw new IllegalStateException("Mesh is using 3D tangents, must be converted to 4D tangents first."); + } + if (inspectionVertex.uv0 != null) { + uv0Buf = BufferUtils.createVector2Buffer(vertices.size()); + jmeMesh.setBuffer(VertexBuffer.Type.TexCoord, 2, uv0Buf); + } + if (inspectionVertex.uv1 != null) { + uv1Buf = BufferUtils.createVector2Buffer(vertices.size()); + jmeMesh.setBuffer(VertexBuffer.Type.TexCoord2, 2, uv1Buf); + } + if (inspectionVertex.color != null) { + colorBuf = BufferUtils.createByteBuffer(vertices.size() * 4); + jmeMesh.setBuffer(VertexBuffer.Type.Color, 4, colorBuf); + jmeMesh.getBuffer(VertexBuffer.Type.Color).setNormalized(true); + } + if (inspectionVertex.boneWeightsIndices != null) { + boneIndices = BufferUtils.createByteBuffer(vertices.size() * 4); + boneWeights = BufferUtils.createFloatBuffer(vertices.size() * 4); + jmeMesh.setBuffer(VertexBuffer.Type.BoneIndex, 4, boneIndices); + jmeMesh.setBuffer(VertexBuffer.Type.BoneWeight, 4, boneWeights); + + //creating empty buffers for HW skinning + //the buffers will be setup if ever used. + VertexBuffer weightsHW = new VertexBuffer(VertexBuffer.Type.HWBoneWeight); + VertexBuffer indicesHW = new VertexBuffer(VertexBuffer.Type.HWBoneIndex); + //setting usage to cpuOnly so that the buffer is not send empty to the GPU + indicesHW.setUsage(VertexBuffer.Usage.CpuOnly); + weightsHW.setUsage(VertexBuffer.Usage.CpuOnly); + + jmeMesh.setBuffer(weightsHW); + jmeMesh.setBuffer(indicesHW); + } + if (vertices.size() >= 65536) { + // too many verticies: use intbuffer instead of shortbuffer + IntBuffer ib = BufferUtils.createIntBuffer(indexes.size()); + jmeMesh.setBuffer(VertexBuffer.Type.Index, 3, ib); + indexBuf = new IndexIntBuffer(ib); + } else { + ShortBuffer sb = BufferUtils.createShortBuffer(indexes.size()); + jmeMesh.setBuffer(VertexBuffer.Type.Index, 3, sb); + indexBuf = new IndexShortBuffer(sb); + } + + jmeMesh.setStatic(); + + int maxBonesPerVertex = -1; + + for (IrVertex vertex : vertices) { + if (posBuf != null) { + posBuf.put(vertex.pos.x).put(vertex.pos.y).put(vertex.pos.z); + } + if (normBuf != null) { + normBuf.put(vertex.norm.x).put(vertex.norm.y).put(vertex.norm.z); + } + if (tangBuf != null) { + tangBuf.put(vertex.tang4d.x).put(vertex.tang4d.y).put(vertex.tang4d.z).put(vertex.tang4d.w); + } + if (uv0Buf != null) { + uv0Buf.put(vertex.uv0.x).put(vertex.uv0.y); + } + if (uv1Buf != null) { + uv1Buf.put(vertex.uv1.x).put(vertex.uv1.y); + } + if (colorBuf != null) { + colorBuf.putInt(vertex.color.asIntABGR()); + } + if (boneIndices != null) { + if (vertex.boneWeightsIndices != null) { + if (vertex.boneWeightsIndices.length > 4) { + throw new UnsupportedOperationException("Mesh uses more than 4 weights per bone. " + + "Call trimBoneWeights() to allieviate this"); + } + for (int i = 0; i < vertex.boneWeightsIndices.length; i++) { + boneIndices.put((byte) (vertex.boneWeightsIndices[i].boneIndex & 0xFF)); + boneWeights.put(vertex.boneWeightsIndices[i].boneWeight); + } + for (int i = 0; i < 4 - vertex.boneWeightsIndices.length; i++) { + boneIndices.put((byte)0); + boneWeights.put(0f); + } + } else { + boneIndices.putInt(0); + boneWeights.put(0f).put(0f).put(0f).put(0f); + } + + maxBonesPerVertex = Math.max(maxBonesPerVertex, vertex.boneWeightsIndices.length); + } + } + + for (int i = 0; i < indexes.size(); i++) { + indexBuf.put(i, indexes.get(i)); + } + + jmeMesh.updateCounts(); + jmeMesh.updateBound(); + + if (boneIndices != null) { + jmeMesh.setMaxNumWeights(maxBonesPerVertex); + jmeMesh.prepareForAnim(true); + jmeMesh.generateBindPose(true); + } + + return jmeMesh; + } +} diff --git a/jme3-plugins/src/main/java/com/jme3/scene/plugins/IrVertex.java b/jme3-plugins/src/main/java/com/jme3/scene/plugins/IrVertex.java new file mode 100644 index 000000000..5870846a1 --- /dev/null +++ b/jme3-plugins/src/main/java/com/jme3/scene/plugins/IrVertex.java @@ -0,0 +1,170 @@ +/* + * Copyright (c) 2009-2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ +package com.jme3.scene.plugins; + +import com.jme3.math.ColorRGBA; +import com.jme3.math.Vector2f; +import com.jme3.math.Vector3f; +import com.jme3.math.Vector4f; +import java.util.Arrays; + +public class IrVertex implements Cloneable { + + public Vector3f pos; + public Vector3f norm; + public Vector4f tang4d; + public Vector3f tang; + public Vector3f bitang; + public Vector2f uv0; + public Vector2f uv1; + public ColorRGBA color; + public Integer material; + public Integer smoothing; + public IrBoneWeightIndex[] boneWeightsIndices; + + public IrVertex deepClone() { + IrVertex v = new IrVertex(); + v.pos = pos != null ? pos.clone() : null; + v.norm = norm != null ? norm.clone() : null; + v.tang4d = tang4d != null ? tang4d.clone() : null; + v.tang = tang != null ? tang.clone() : null; + v.bitang = bitang != null ? bitang.clone() : null; + v.uv0 = uv0 != null ? uv0.clone() : null; + v.uv1 = uv1 != null ? uv1.clone() : null; + v.color = color != null ? color.clone() : null; + v.material = material; + v.smoothing = smoothing; + if (boneWeightsIndices != null) { + v.boneWeightsIndices = new IrBoneWeightIndex[boneWeightsIndices.length]; + for (int i = 0; i < boneWeightsIndices.length; i++) { + v.boneWeightsIndices[i] = (IrBoneWeightIndex) boneWeightsIndices[i].clone(); + } + } + return v; + } + + @Override + public int hashCode() { + int hash = 5; + hash = 73 * hash + (this.pos != null ? this.pos.hashCode() : 0); + hash = 73 * hash + (this.norm != null ? this.norm.hashCode() : 0); + hash = 73 * hash + (this.tang4d != null ? this.tang4d.hashCode() : 0); + hash = 73 * hash + (this.tang != null ? this.tang.hashCode() : 0); + hash = 73 * hash + (this.uv0 != null ? this.uv0.hashCode() : 0); + hash = 73 * hash + (this.uv1 != null ? this.uv1.hashCode() : 0); + hash = 73 * hash + (this.color != null ? this.color.hashCode() : 0); + hash = 73 * hash + (this.material != null ? this.material.hashCode() : 0); + hash = 73 * hash + (this.smoothing != null ? this.smoothing.hashCode() : 0); + hash = 73 * hash + Arrays.deepHashCode(this.boneWeightsIndices); + return hash; + } + + @Override + public boolean equals(Object obj) { + if (obj == null) { + return false; + } + if (getClass() != obj.getClass()) { + return false; + } + final IrVertex other = (IrVertex) obj; + if (this.pos != other.pos && (this.pos == null || !this.pos.equals(other.pos))) { + return false; + } + if (this.norm != other.norm && (this.norm == null || !this.norm.equals(other.norm))) { + return false; + } + if (this.tang4d != other.tang4d && (this.tang4d == null || !this.tang4d.equals(other.tang4d))) { + return false; + } + if (this.tang != other.tang && (this.tang == null || !this.tang.equals(other.tang))) { + return false; + } + if (this.uv0 != other.uv0 && (this.uv0 == null || !this.uv0.equals(other.uv0))) { + return false; + } + if (this.uv1 != other.uv1 && (this.uv1 == null || !this.uv1.equals(other.uv1))) { + return false; + } + if (this.color != other.color && (this.color == null || !this.color.equals(other.color))) { + return false; + } + if (this.material != other.material && (this.material == null || !this.material.equals(other.material))) { + return false; + } + if (this.smoothing != other.smoothing && (this.smoothing == null || !this.smoothing.equals(other.smoothing))) { + return false; + } + if (!Arrays.deepEquals(this.boneWeightsIndices, other.boneWeightsIndices)) { + return false; + } + return true; + } + + @Override + public String toString() { + StringBuilder sb = new StringBuilder(); + sb.append("Vertex { "); + + if (pos != null) { + sb.append("pos=").append(pos).append(", "); + } + if (norm != null) { + sb.append("norm=").append(pos).append(", "); + } + if (tang != null) { + sb.append("tang=").append(pos).append(", "); + } + if (uv0 != null) { + sb.append("uv0=").append(pos).append(", "); + } + if (uv1 != null) { + sb.append("uv1=").append(pos).append(", "); + } + if (color != null) { + sb.append("color=").append(pos).append(", "); + } + if (material != null) { + sb.append("material=").append(pos).append(", "); + } + if (smoothing != null) { + sb.append("smoothing=").append(pos).append(", "); + } + + if (sb.toString().endsWith(", ")) { + sb.delete(sb.length() - 2, sb.length()); + } + + sb.append(" }"); + return sb.toString(); + } +} From aeb1b547ced55a9de829faaf194f455d5eef9acc Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Sun, 19 Apr 2015 21:03:51 -0400 Subject: [PATCH 021/113] FBX: fix build errors (missing functions that need to be added) --- .../main/java/com/jme3/animation/Bone.java | 20 +++++++++++++++++++ .../src/main/java/com/jme3/math/FastMath.java | 19 ++++++++++++++++++ .../main/java/com/jme3/math/Transform.java | 20 +++++++++++++++++++ 3 files changed, 59 insertions(+) diff --git a/jme3-core/src/main/java/com/jme3/animation/Bone.java b/jme3-core/src/main/java/com/jme3/animation/Bone.java index 819a77383..a78b4b931 100644 --- a/jme3-core/src/main/java/com/jme3/animation/Bone.java +++ b/jme3-core/src/main/java/com/jme3/animation/Bone.java @@ -313,6 +313,26 @@ public final class Bone implements Savable { return modelBindInverseScale; } + public Transform getModelBindInverseTransform() { + Transform t = new Transform(); + t.setTranslation(modelBindInversePos); + t.setRotation(modelBindInverseRot); + if (modelBindInverseScale != null) { + t.setScale(modelBindInverseScale); + } + return t; + } + + public Transform getBindInverseTransform() { + Transform t = new Transform(); + t.setTranslation(bindPos); + t.setRotation(bindRot); + if (bindScale != null) { + t.setScale(bindScale); + } + return t.invert(); + } + /** * @deprecated use {@link #getBindPosition()} */ diff --git a/jme3-core/src/main/java/com/jme3/math/FastMath.java b/jme3-core/src/main/java/com/jme3/math/FastMath.java index 5e230dabb..d9d944057 100644 --- a/jme3-core/src/main/java/com/jme3/math/FastMath.java +++ b/jme3-core/src/main/java/com/jme3/math/FastMath.java @@ -902,6 +902,25 @@ final public class FastMath { return clamp(input, 0f, 1f); } + /** + * Determine if two floats are approximately equal. + * This takes into account the magnitude of the floats, since + * large numbers will have larger differences be close to each other. + * + * Should return true for a=100000, b=100001, but false for a=10000, b=10001. + * + * @param a The first float to compare + * @param b The second float to compare + * @return True if a and b are approximately equal, false otherwise. + */ + public static boolean approximateEquals(float a, float b) { + if (a == b) { + return true; + } else { + return (abs(a - b) / Math.max(abs(a), abs(b))) <= 0.00001f; + } + } + /** * Converts a single precision (32 bit) floating point value * into half precision (16 bit). diff --git a/jme3-core/src/main/java/com/jme3/math/Transform.java b/jme3-core/src/main/java/com/jme3/math/Transform.java index 79992ed2b..ac7a324d0 100644 --- a/jme3-core/src/main/java/com/jme3/math/Transform.java +++ b/jme3-core/src/main/java/com/jme3/math/Transform.java @@ -259,6 +259,26 @@ public final class Transform implements Savable, Cloneable, java.io.Serializable return store; } + public Matrix4f toTransformMatrix() { + Matrix4f trans = new Matrix4f(); + trans.setTranslation(translation); + trans.setRotationQuaternion(rot); + trans.setScale(scale); + return trans; + } + + public void fromTransformMatrix(Matrix4f mat) { + translation.set(mat.toTranslationVector()); + rot.set(mat.toRotationQuat()); + scale.set(mat.toScaleVector()); + } + + public Transform invert() { + Transform t = new Transform(); + t.fromTransformMatrix(toTransformMatrix().invertLocal()); + return t; + } + /** * Loads the identity. Equal to translation=0,0,0 scale=1,1,1 rot=0,0,0,1. */ From 92b2ec664e7ef50f58b53d6e2b05647fcdbfca58 Mon Sep 17 00:00:00 2001 From: Turakar Date: Mon, 20 Apr 2015 20:01:52 +0200 Subject: [PATCH 022/113] Fixed typo #258 --- .../common/java/com/jme3/bullet/control/RigidBodyControl.java | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/jme3-bullet/src/common/java/com/jme3/bullet/control/RigidBodyControl.java b/jme3-bullet/src/common/java/com/jme3/bullet/control/RigidBodyControl.java index c4c0f3995..baad952a0 100644 --- a/jme3-bullet/src/common/java/com/jme3/bullet/control/RigidBodyControl.java +++ b/jme3-bullet/src/common/java/com/jme3/bullet/control/RigidBodyControl.java @@ -195,7 +195,7 @@ public class RigidBodyControl extends PhysicsRigidBody implements PhysicsControl /** * When set to true, the physics coordinates will be applied to the local - * translation of the Spatial instead of the world traslation. + * translation of the Spatial instead of the world translation. * @param applyPhysicsLocal */ public void setApplyPhysicsLocal(boolean applyPhysicsLocal) { From 7e78651ed45b0dd2b471bda7fb8996aa3e69aafb Mon Sep 17 00:00:00 2001 From: Nehon Date: Wed, 22 Apr 2015 20:55:56 +0200 Subject: [PATCH 023/113] Shader Nodes : fixed an issue in the shader generator that was caussing an error when there was a "//" comment in the declarative section of a node glsl code --- .../src/main/java/com/jme3/shader/Glsl100ShaderGenerator.java | 1 + 1 file changed, 1 insertion(+) diff --git a/jme3-core/src/main/java/com/jme3/shader/Glsl100ShaderGenerator.java b/jme3-core/src/main/java/com/jme3/shader/Glsl100ShaderGenerator.java index ed53e89bc..a7a53b915 100644 --- a/jme3-core/src/main/java/com/jme3/shader/Glsl100ShaderGenerator.java +++ b/jme3-core/src/main/java/com/jme3/shader/Glsl100ShaderGenerator.java @@ -127,6 +127,7 @@ public class Glsl100ShaderGenerator extends ShaderGenerator { unIndent(); startCondition(shaderNode.getCondition(), source); source.append(nodeSource); + source.append("\n"); endCondition(shaderNode.getCondition(), source); indent(); } From 9ba04bed8fa16a7d7fd96ce8afb6d219703e6080 Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Fri, 24 Apr 2015 23:31:52 -0400 Subject: [PATCH 024/113] GLRenderer: Merge Color and Screen BlendModes as they are they same --- .../src/main/java/com/jme3/renderer/opengl/GLRenderer.java | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/jme3-core/src/main/java/com/jme3/renderer/opengl/GLRenderer.java b/jme3-core/src/main/java/com/jme3/renderer/opengl/GLRenderer.java index 9ae1c8cc7..32d8e6b24 100644 --- a/jme3-core/src/main/java/com/jme3/renderer/opengl/GLRenderer.java +++ b/jme3-core/src/main/java/com/jme3/renderer/opengl/GLRenderer.java @@ -704,9 +704,6 @@ public class GLRenderer implements Renderer { case AlphaAdditive: gl.glBlendFunc(GL.GL_SRC_ALPHA, GL.GL_ONE); break; - case Color: - gl.glBlendFunc(GL.GL_ONE, GL.GL_ONE_MINUS_SRC_COLOR); - break; case Alpha: gl.glBlendFunc(GL.GL_SRC_ALPHA, GL.GL_ONE_MINUS_SRC_ALPHA); break; @@ -719,6 +716,7 @@ public class GLRenderer implements Renderer { case ModulateX2: gl.glBlendFunc(GL.GL_DST_COLOR, GL.GL_SRC_COLOR); break; + case Color: case Screen: gl.glBlendFunc(GL.GL_ONE, GL.GL_ONE_MINUS_SRC_COLOR); break; From 73f53931f02e6e9e9a38e6a09affb693523dd72a Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Fri, 24 Apr 2015 23:35:30 -0400 Subject: [PATCH 025/113] Image: fix mipmap generation flags not properly being updated --- .../src/main/java/com/jme3/texture/Image.java | 20 +++++++++++-------- 1 file changed, 12 insertions(+), 8 deletions(-) diff --git a/jme3-core/src/main/java/com/jme3/texture/Image.java b/jme3-core/src/main/java/com/jme3/texture/Image.java index 2bbf746ff..4225da7d3 100644 --- a/jme3-core/src/main/java/com/jme3/texture/Image.java +++ b/jme3-core/src/main/java/com/jme3/texture/Image.java @@ -421,7 +421,8 @@ public class Image extends NativeObject implements Savable /*, Cloneable*/ { /** * @return True if the image needs to have mipmaps generated - * for it (as requested by the texture). + * for it (as requested by the texture). This stays true even + * after mipmaps have been generated. */ public boolean isGeneratedMipmapsRequired() { return needGeneratedMips; @@ -434,8 +435,9 @@ public class Image extends NativeObject implements Savable /*, Cloneable*/ { @Override public void setUpdateNeeded() { super.setUpdateNeeded(); - if (!isGeneratedMipmapsRequired() && !hasMipmaps()) { - setNeedGeneratedMipmaps(); + if (isGeneratedMipmapsRequired() && !hasMipmaps()) { + // Mipmaps are no longer valid, since the image was changed. + setMipmapsGenerated(false); } } @@ -527,11 +529,13 @@ public class Image extends NativeObject implements Savable /*, Cloneable*/ { this(); - if (mipMapSizes != null && mipMapSizes.length <= 1) { - mipMapSizes = null; - } else { - needGeneratedMips = false; - mipsWereGenerated = true; + if (mipMapSizes != null) { + if (mipMapSizes.length <= 1) { + mipMapSizes = null; + } else { + needGeneratedMips = false; + mipsWereGenerated = true; + } } setFormat(format); From ca6b492cea4ab814115b705b869462a2e406abb1 Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Fri, 24 Apr 2015 23:46:56 -0400 Subject: [PATCH 026/113] SSAOFilter: remove excessive GPU mipmap generation (not needed for filters) --- jme3-effects/src/main/java/com/jme3/post/ssao/SSAOFilter.java | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/jme3-effects/src/main/java/com/jme3/post/ssao/SSAOFilter.java b/jme3-effects/src/main/java/com/jme3/post/ssao/SSAOFilter.java index 75d6b1c86..7e9012b6d 100644 --- a/jme3-effects/src/main/java/com/jme3/post/ssao/SSAOFilter.java +++ b/jme3-effects/src/main/java/com/jme3/post/ssao/SSAOFilter.java @@ -162,8 +162,8 @@ public class SSAOFilter extends Filter { }; ssaoPass.init(renderManager.getRenderer(), (int) (screenWidth / downSampleFactor), (int) (screenHeight / downSampleFactor), Format.RGBA8, Format.Depth, 1, ssaoMat); - ssaoPass.getRenderedTexture().setMinFilter(Texture.MinFilter.Trilinear); - ssaoPass.getRenderedTexture().setMagFilter(Texture.MagFilter.Bilinear); +// ssaoPass.getRenderedTexture().setMinFilter(Texture.MinFilter.Trilinear); +// ssaoPass.getRenderedTexture().setMagFilter(Texture.MagFilter.Bilinear); postRenderPasses.add(ssaoPass); material = new Material(manager, "Common/MatDefs/SSAO/ssaoBlur.j3md"); material.setTexture("SSAOMap", ssaoPass.getRenderedTexture()); From 389b117fb64388724f9e25a18bac3ff8ee008fae Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Sat, 25 Apr 2015 12:45:30 -0400 Subject: [PATCH 027/113] IosGL: reset buffer position in fromArray() --- jme3-ios/src/main/java/com/jme3/renderer/ios/IosGL.java | 2 ++ 1 file changed, 2 insertions(+) diff --git a/jme3-ios/src/main/java/com/jme3/renderer/ios/IosGL.java b/jme3-ios/src/main/java/com/jme3/renderer/ios/IosGL.java index d3276972d..a1dfaa757 100644 --- a/jme3-ios/src/main/java/com/jme3/renderer/ios/IosGL.java +++ b/jme3-ios/src/main/java/com/jme3/renderer/ios/IosGL.java @@ -90,7 +90,9 @@ public class IosGL implements GL, GLExt { if (buffer.remaining() < n) { throw new BufferOverflowException(); } + int pos = buffer.position(); buffer.put(array, 0, n); + buffer.position(pos); } private static void checkLimit(Buffer buffer) { From 5b95f8a4b0e70a9ef5839be199f5274a94247f02 Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Sat, 25 Apr 2015 16:57:24 -0400 Subject: [PATCH 028/113] GLRenderer: Improve compatibility with OpenGL 3.2 core profile * Separate GLFbo and GLExt implementations. GLFbo can now be implemented either via vanilla OpenGL3 calls or GL_EXT_framebuffer_*** extensions (OpenGL2.1- only). * Use modern way of getting supported extensions in core profile. * Luminance and Alpha formats are not available when running in core profile. * Bind a dummy vertex array object (VAO) when running in core profile. * Point sprite mode is always enabled. Since both OpenGL ES 2.0 and OpenGL 3.2 core require it, jME3 is no longer capable of rendering regular points. --- .../com/jme3/system/android/OGLESContext.java | 3 +- .../src/main/java/com/jme3/renderer/Caps.java | 14 +- .../java/com/jme3/renderer/opengl/GL.java | 1 - .../java/com/jme3/renderer/opengl/GL3.java | 10 +- .../jme3/renderer/opengl/GLDebugDesktop.java | 19 ++- .../com/jme3/renderer/opengl/GLDebugES.java | 10 +- .../java/com/jme3/renderer/opengl/GLExt.java | 4 +- .../java/com/jme3/renderer/opengl/GLFbo.java | 3 +- .../jme3/renderer/opengl/GLImageFormats.java | 38 +++-- .../com/jme3/renderer/opengl/GLRenderer.java | 160 ++++++++---------- .../com/jme3/renderer/opengl/GLTracer.java | 7 +- .../com/jme3/system/ios/IGLESContext.java | 5 +- .../java/com/jme3/renderer/lwjgl/LwjglGL.java | 12 +- .../com/jme3/renderer/lwjgl/LwjglGLExt.java | 68 +------- .../jme3/renderer/lwjgl/LwjglGLFboEXT.java | 98 +++++++++++ .../jme3/renderer/lwjgl/LwjglGLFboGL3.java | 96 +++++++++++ .../com/jme3/system/lwjgl/LwjglContext.java | 26 ++- 17 files changed, 383 insertions(+), 191 deletions(-) create mode 100644 jme3-lwjgl/src/main/java/com/jme3/renderer/lwjgl/LwjglGLFboEXT.java create mode 100644 jme3-lwjgl/src/main/java/com/jme3/renderer/lwjgl/LwjglGLFboGL3.java diff --git a/jme3-android/src/main/java/com/jme3/system/android/OGLESContext.java b/jme3-android/src/main/java/com/jme3/system/android/OGLESContext.java index 9472bff0b..991ad25c0 100644 --- a/jme3-android/src/main/java/com/jme3/system/android/OGLESContext.java +++ b/jme3-android/src/main/java/com/jme3/system/android/OGLESContext.java @@ -54,6 +54,7 @@ import com.jme3.input.dummy.DummyMouseInput; import com.jme3.renderer.android.AndroidGL; import com.jme3.renderer.opengl.GL; import com.jme3.renderer.opengl.GLExt; +import com.jme3.renderer.opengl.GLFbo; import com.jme3.renderer.opengl.GLRenderer; import com.jme3.system.*; import java.util.concurrent.atomic.AtomicBoolean; @@ -196,7 +197,7 @@ public class OGLESContext implements JmeContext, GLSurfaceView.Renderer, SoftTex Object gl = new AndroidGL(); // gl = GLTracer.createGlesTracer((GL)gl, (GLExt)gl); // gl = new GLDebugES((GL)gl, (GLExt)gl); - renderer = new GLRenderer((GL)gl, (GLExt)gl); + renderer = new GLRenderer((GL)gl, (GLExt)gl, (GLFbo)gl); renderer.initialize(); JmeSystem.setSoftTextDialogInput(this); diff --git a/jme3-core/src/main/java/com/jme3/renderer/Caps.java b/jme3-core/src/main/java/com/jme3/renderer/Caps.java index f0d42c8f2..9387b687e 100644 --- a/jme3-core/src/main/java/com/jme3/renderer/Caps.java +++ b/jme3-core/src/main/java/com/jme3/renderer/Caps.java @@ -337,7 +337,19 @@ public enum Caps { *

* Improves the quality of environment mapping. */ - SeamlessCubemap; + SeamlessCubemap, + + /** + * Running with OpenGL 3.2+ core profile. + * + * Compatibility features will not be available. + */ + CoreProfile, + + /** + * GPU can provide and accept binary shaders. + */ + BinaryShader; /** * Returns true if given the renderer capabilities, the texture diff --git a/jme3-core/src/main/java/com/jme3/renderer/opengl/GL.java b/jme3-core/src/main/java/com/jme3/renderer/opengl/GL.java index 9c73838e2..21ca7a7fa 100644 --- a/jme3-core/src/main/java/com/jme3/renderer/opengl/GL.java +++ b/jme3-core/src/main/java/com/jme3/renderer/opengl/GL.java @@ -32,7 +32,6 @@ package com.jme3.renderer.opengl; import java.nio.ByteBuffer; -import java.nio.DoubleBuffer; import java.nio.FloatBuffer; import java.nio.IntBuffer; import java.nio.ShortBuffer; diff --git a/jme3-core/src/main/java/com/jme3/renderer/opengl/GL3.java b/jme3-core/src/main/java/com/jme3/renderer/opengl/GL3.java index 50eb065ab..190ed4547 100644 --- a/jme3-core/src/main/java/com/jme3/renderer/opengl/GL3.java +++ b/jme3-core/src/main/java/com/jme3/renderer/opengl/GL3.java @@ -35,14 +35,18 @@ import java.nio.IntBuffer; /** * GL functions only available on vanilla desktop OpenGL 3.0. - * + * * @author Kirill Vainer */ public interface GL3 extends GL2 { - + public static final int GL_DEPTH_STENCIL_ATTACHMENT = 0x821A; - public static final int GL_GEOMETRY_SHADER=0x8DD9; + public static final int GL_GEOMETRY_SHADER = 0x8DD9; + public static final int GL_NUM_EXTENSIONS = 0x821D; + public void glBindFragDataLocation(int param1, int param2, String param3); /// GL3+ public void glBindVertexArray(int param1); /// GL3+ + public void glDeleteVertexArrays(IntBuffer arrays); /// GL3+ public void glGenVertexArrays(IntBuffer param1); /// GL3+ + public String glGetString(int param1, int param2); /// GL3+ } diff --git a/jme3-core/src/main/java/com/jme3/renderer/opengl/GLDebugDesktop.java b/jme3-core/src/main/java/com/jme3/renderer/opengl/GLDebugDesktop.java index e13402bd5..5fbaaaa52 100644 --- a/jme3-core/src/main/java/com/jme3/renderer/opengl/GLDebugDesktop.java +++ b/jme3-core/src/main/java/com/jme3/renderer/opengl/GLDebugDesktop.java @@ -3,13 +3,13 @@ package com.jme3.renderer.opengl; import java.nio.ByteBuffer; import java.nio.IntBuffer; -public class GLDebugDesktop extends GLDebugES implements GL2, GL3 { +public class GLDebugDesktop extends GLDebugES implements GL2, GL3, GL4 { private final GL2 gl2; private final GL3 gl3; - public GLDebugDesktop(GL gl, GLFbo glfbo) { - super(gl, glfbo); + public GLDebugDesktop(GL gl, GLExt glext, GLFbo glfbo) { + super(gl, glext, glfbo); this.gl2 = gl instanceof GL2 ? (GL2) gl : null; this.gl3 = gl instanceof GL3 ? (GL3) gl : null; } @@ -73,5 +73,18 @@ public class GLDebugDesktop extends GLDebugES implements GL2, GL3 { gl3.glGenVertexArrays(param1); checkError(); } + + @Override + public String glGetString(int param1, int param2) { + String result = gl3.glGetString(param1, param2); + checkError(); + return result; + } + + @Override + public void glDeleteVertexArrays(IntBuffer arrays) { + gl3.glDeleteVertexArrays(arrays); + checkError(); + } } diff --git a/jme3-core/src/main/java/com/jme3/renderer/opengl/GLDebugES.java b/jme3-core/src/main/java/com/jme3/renderer/opengl/GLDebugES.java index 259c56406..3e8850589 100644 --- a/jme3-core/src/main/java/com/jme3/renderer/opengl/GLDebugES.java +++ b/jme3-core/src/main/java/com/jme3/renderer/opengl/GLDebugES.java @@ -10,12 +10,10 @@ public class GLDebugES extends GLDebug implements GL, GLFbo, GLExt { private final GLFbo glfbo; private final GLExt glext; - public GLDebugES(GL gl, GLFbo glfbo) { + public GLDebugES(GL gl, GLExt glext, GLFbo glfbo) { this.gl = gl; -// this.gl2 = gl instanceof GL2 ? (GL2) gl : null; -// this.gl3 = gl instanceof GL3 ? (GL3) gl : null; + this.glext = glext; this.glfbo = glfbo; - this.glext = glfbo instanceof GLExt ? (GLExt) glfbo : null; } public void glActiveTexture(int texture) { @@ -478,7 +476,7 @@ public class GLDebugES extends GLDebug implements GL, GLFbo, GLExt { } public void glBlitFramebufferEXT(int srcX0, int srcY0, int srcX1, int srcY1, int dstX0, int dstY0, int dstX1, int dstY1, int mask, int filter) { - glext.glBlitFramebufferEXT(srcX0, srcY0, srcX1, srcY1, dstX0, dstY0, dstX1, dstY1, mask, filter); + glfbo.glBlitFramebufferEXT(srcX0, srcY0, srcX1, srcY1, dstX0, dstY0, dstX1, dstY1, mask, filter); checkError(); } @@ -525,7 +523,7 @@ public class GLDebugES extends GLDebug implements GL, GLFbo, GLExt { } public void glRenderbufferStorageMultisampleEXT(int target, int samples, int internalformat, int width, int height) { - glext.glRenderbufferStorageMultisampleEXT(target, samples, internalformat, width, height); + glfbo.glRenderbufferStorageMultisampleEXT(target, samples, internalformat, width, height); checkError(); } diff --git a/jme3-core/src/main/java/com/jme3/renderer/opengl/GLExt.java b/jme3-core/src/main/java/com/jme3/renderer/opengl/GLExt.java index b0e0b5f78..27f0eb8bd 100644 --- a/jme3-core/src/main/java/com/jme3/renderer/opengl/GLExt.java +++ b/jme3-core/src/main/java/com/jme3/renderer/opengl/GLExt.java @@ -41,7 +41,7 @@ import java.nio.IntBuffer; * * @author Kirill Vainer */ -public interface GLExt extends GLFbo { +public interface GLExt { public static final int GL_ALREADY_SIGNALED = 0x911A; public static final int GL_COMPRESSED_RGB8_ETC2 = 0x9274; @@ -100,7 +100,6 @@ public interface GLExt extends GLFbo { public static final int GL_UNSIGNED_INT_5_9_9_9_REV_EXT = 0x8C3E; public static final int GL_WAIT_FAILED = 0x911D; - public void glBlitFramebufferEXT(int srcX0, int srcY0, int srcX1, int srcY1, int dstX0, int dstY0, int dstX1, int dstY1, int mask, int filter); public void glBufferData(int target, IntBuffer data, int usage); public void glBufferSubData(int target, long offset, IntBuffer data); public int glClientWaitSync(Object sync, int flags, long timeout); @@ -110,7 +109,6 @@ public interface GLExt extends GLFbo { public void glDrawElementsInstancedARB(int mode, int indices_count, int type, long indices_buffer_offset, int primcount); public Object glFenceSync(int condition, int flags); public void glGetMultisample(int pname, int index, FloatBuffer val); - public void glRenderbufferStorageMultisampleEXT(int target, int samples, int internalformat, int width, int height); public void glTexImage2DMultisample(int target, int samples, int internalformat, int width, int height, boolean fixedsamplelocations); public void glVertexAttribDivisorARB(int index, int divisor); } diff --git a/jme3-core/src/main/java/com/jme3/renderer/opengl/GLFbo.java b/jme3-core/src/main/java/com/jme3/renderer/opengl/GLFbo.java index 252619db8..737019ce2 100644 --- a/jme3-core/src/main/java/com/jme3/renderer/opengl/GLFbo.java +++ b/jme3-core/src/main/java/com/jme3/renderer/opengl/GLFbo.java @@ -83,6 +83,7 @@ public interface GLFbo { public void glBindFramebufferEXT(int param1, int param2); public void glBindRenderbufferEXT(int param1, int param2); + public void glBlitFramebufferEXT(int srcX0, int srcY0, int srcX1, int srcY1, int dstX0, int dstY0, int dstX1, int dstY1, int mask, int filter); public int glCheckFramebufferStatusEXT(int param1); public void glDeleteFramebuffersEXT(IntBuffer param1); public void glDeleteRenderbuffersEXT(IntBuffer param1); @@ -92,5 +93,5 @@ public interface GLFbo { public void glGenRenderbuffersEXT(IntBuffer param1); public void glGenerateMipmapEXT(int param1); public void glRenderbufferStorageEXT(int param1, int param2, int param3, int param4); - + public void glRenderbufferStorageMultisampleEXT(int target, int samples, int internalformat, int width, int height); } diff --git a/jme3-core/src/main/java/com/jme3/renderer/opengl/GLImageFormats.java b/jme3-core/src/main/java/com/jme3/renderer/opengl/GLImageFormats.java index 423ae909e..a7ef9f52d 100644 --- a/jme3-core/src/main/java/com/jme3/renderer/opengl/GLImageFormats.java +++ b/jme3-core/src/main/java/com/jme3/renderer/opengl/GLImageFormats.java @@ -89,9 +89,11 @@ public final class GLImageFormats { GLImageFormat[][] formatToGL = new GLImageFormat[2][Image.Format.values().length]; if (caps.contains(Caps.OpenGL20)) { - format(formatToGL, Format.Alpha8, GL2.GL_ALPHA8, GL.GL_ALPHA, GL.GL_UNSIGNED_BYTE); - format(formatToGL, Format.Luminance8, GL2.GL_LUMINANCE8, GL.GL_LUMINANCE, GL.GL_UNSIGNED_BYTE); - format(formatToGL, Format.Luminance8Alpha8, GL2.GL_LUMINANCE8_ALPHA8, GL.GL_LUMINANCE_ALPHA, GL.GL_UNSIGNED_BYTE); + if (!caps.contains(Caps.CoreProfile)) { + format(formatToGL, Format.Alpha8, GL2.GL_ALPHA8, GL.GL_ALPHA, GL.GL_UNSIGNED_BYTE); + format(formatToGL, Format.Luminance8, GL2.GL_LUMINANCE8, GL.GL_LUMINANCE, GL.GL_UNSIGNED_BYTE); + format(formatToGL, Format.Luminance8Alpha8, GL2.GL_LUMINANCE8_ALPHA8, GL.GL_LUMINANCE_ALPHA, GL.GL_UNSIGNED_BYTE); + } format(formatToGL, Format.RGB8, GL2.GL_RGB8, GL.GL_RGB, GL.GL_UNSIGNED_BYTE); format(formatToGL, Format.RGBA8, GLExt.GL_RGBA8, GL.GL_RGBA, GL.GL_UNSIGNED_BYTE); format(formatToGL, Format.RGB565, GL2.GL_RGB8, GL.GL_RGB, GL.GL_UNSIGNED_SHORT_5_6_5); @@ -108,8 +110,10 @@ public final class GLImageFormats { formatSrgb(formatToGL, Format.RGB565, GLExt.GL_SRGB8_EXT, GL.GL_RGB, GL.GL_UNSIGNED_SHORT_5_6_5); formatSrgb(formatToGL, Format.RGB5A1, GLExt.GL_SRGB8_ALPHA8_EXT, GL.GL_RGBA, GL.GL_UNSIGNED_SHORT_5_5_5_1); formatSrgb(formatToGL, Format.RGBA8, GLExt.GL_SRGB8_ALPHA8_EXT, GL.GL_RGBA, GL.GL_UNSIGNED_BYTE); - formatSrgb(formatToGL, Format.Luminance8, GLExt.GL_SLUMINANCE8_EXT, GL.GL_LUMINANCE, GL.GL_UNSIGNED_BYTE); - formatSrgb(formatToGL, Format.Luminance8Alpha8, GLExt.GL_SLUMINANCE8_ALPHA8_EXT, GL.GL_LUMINANCE_ALPHA, GL.GL_UNSIGNED_BYTE); + if (!caps.contains(Caps.CoreProfile)) { + formatSrgb(formatToGL, Format.Luminance8, GLExt.GL_SLUMINANCE8_EXT, GL.GL_LUMINANCE, GL.GL_UNSIGNED_BYTE); + formatSrgb(formatToGL, Format.Luminance8Alpha8, GLExt.GL_SLUMINANCE8_ALPHA8_EXT, GL.GL_LUMINANCE_ALPHA, GL.GL_UNSIGNED_BYTE); + } formatSrgb(formatToGL, Format.BGR8, GLExt.GL_SRGB8_EXT, GL2.GL_BGR, GL.GL_UNSIGNED_BYTE); formatSrgb(formatToGL, Format.ABGR8, GLExt.GL_SRGB8_ALPHA8_EXT, GL.GL_RGBA, GL2.GL_UNSIGNED_INT_8_8_8_8); formatSrgb(formatToGL, Format.ARGB8, GLExt.GL_SRGB8_ALPHA8_EXT, GL2.GL_BGRA, GL2.GL_UNSIGNED_INT_8_8_8_8); @@ -124,16 +128,20 @@ public final class GLImageFormats { } } else if (caps.contains(Caps.Rgba8)) { // A more limited form of 32-bit RGBA. Only GL_RGBA8 is available. - format(formatToGL, Format.Alpha8, GLExt.GL_RGBA8, GL.GL_ALPHA, GL.GL_UNSIGNED_BYTE); - format(formatToGL, Format.Luminance8, GLExt.GL_RGBA8, GL.GL_LUMINANCE, GL.GL_UNSIGNED_BYTE); - format(formatToGL, Format.Luminance8Alpha8, GLExt.GL_RGBA8, GL.GL_LUMINANCE_ALPHA, GL.GL_UNSIGNED_BYTE); + if (!caps.contains(Caps.CoreProfile)) { + format(formatToGL, Format.Alpha8, GLExt.GL_RGBA8, GL.GL_ALPHA, GL.GL_UNSIGNED_BYTE); + format(formatToGL, Format.Luminance8, GLExt.GL_RGBA8, GL.GL_LUMINANCE, GL.GL_UNSIGNED_BYTE); + format(formatToGL, Format.Luminance8Alpha8, GLExt.GL_RGBA8, GL.GL_LUMINANCE_ALPHA, GL.GL_UNSIGNED_BYTE); + } format(formatToGL, Format.RGB8, GLExt.GL_RGBA8, GL.GL_RGB, GL.GL_UNSIGNED_BYTE); format(formatToGL, Format.RGBA8, GLExt.GL_RGBA8, GL.GL_RGBA, GL.GL_UNSIGNED_BYTE); } else { // Actually, the internal format isn't used for OpenGL ES 2! This is the same as the above.. - format(formatToGL, Format.Alpha8, GL.GL_RGBA4, GL.GL_ALPHA, GL.GL_UNSIGNED_BYTE); - format(formatToGL, Format.Luminance8, GL.GL_RGB565, GL.GL_LUMINANCE, GL.GL_UNSIGNED_BYTE); - format(formatToGL, Format.Luminance8Alpha8, GL.GL_RGBA4, GL.GL_LUMINANCE_ALPHA, GL.GL_UNSIGNED_BYTE); + if (!caps.contains(Caps.CoreProfile)) { + format(formatToGL, Format.Alpha8, GL.GL_RGBA4, GL.GL_ALPHA, GL.GL_UNSIGNED_BYTE); + format(formatToGL, Format.Luminance8, GL.GL_RGB565, GL.GL_LUMINANCE, GL.GL_UNSIGNED_BYTE); + format(formatToGL, Format.Luminance8Alpha8, GL.GL_RGBA4, GL.GL_LUMINANCE_ALPHA, GL.GL_UNSIGNED_BYTE); + } format(formatToGL, Format.RGB8, GL.GL_RGB565, GL.GL_RGB, GL.GL_UNSIGNED_BYTE); format(formatToGL, Format.RGBA8, GL.GL_RGBA4, GL.GL_RGBA, GL.GL_UNSIGNED_BYTE); } @@ -145,9 +153,11 @@ public final class GLImageFormats { format(formatToGL, Format.RGB5A1, GL.GL_RGB5_A1, GL.GL_RGBA, GL.GL_UNSIGNED_SHORT_5_5_5_1); if (caps.contains(Caps.FloatTexture)) { - format(formatToGL, Format.Luminance16F, GLExt.GL_LUMINANCE16F_ARB, GL.GL_LUMINANCE, GLExt.GL_HALF_FLOAT_ARB); - format(formatToGL, Format.Luminance32F, GLExt.GL_LUMINANCE32F_ARB, GL.GL_LUMINANCE, GL.GL_FLOAT); - format(formatToGL, Format.Luminance16FAlpha16F, GLExt.GL_LUMINANCE_ALPHA16F_ARB, GL.GL_LUMINANCE_ALPHA, GLExt.GL_HALF_FLOAT_ARB); + if (!caps.contains(Caps.CoreProfile)) { + format(formatToGL, Format.Luminance16F, GLExt.GL_LUMINANCE16F_ARB, GL.GL_LUMINANCE, GLExt.GL_HALF_FLOAT_ARB); + format(formatToGL, Format.Luminance32F, GLExt.GL_LUMINANCE32F_ARB, GL.GL_LUMINANCE, GL.GL_FLOAT); + format(formatToGL, Format.Luminance16FAlpha16F, GLExt.GL_LUMINANCE_ALPHA16F_ARB, GL.GL_LUMINANCE_ALPHA, GLExt.GL_HALF_FLOAT_ARB); + } format(formatToGL, Format.RGB16F, GLExt.GL_RGB16F_ARB, GL.GL_RGB, GLExt.GL_HALF_FLOAT_ARB); format(formatToGL, Format.RGB32F, GLExt.GL_RGB32F_ARB, GL.GL_RGB, GL.GL_FLOAT); format(formatToGL, Format.RGBA16F, GLExt.GL_RGBA16F_ARB, GL.GL_RGBA, GLExt.GL_HALF_FLOAT_ARB); diff --git a/jme3-core/src/main/java/com/jme3/renderer/opengl/GLRenderer.java b/jme3-core/src/main/java/com/jme3/renderer/opengl/GLRenderer.java index 32d8e6b24..7b928202f 100644 --- a/jme3-core/src/main/java/com/jme3/renderer/opengl/GLRenderer.java +++ b/jme3-core/src/main/java/com/jme3/renderer/opengl/GLRenderer.java @@ -112,13 +112,13 @@ public class GLRenderer implements Renderer { private final GLFbo glfbo; private final TextureUtil texUtil; - public GLRenderer(GL gl, GLFbo glfbo) { + public GLRenderer(GL gl, GLExt glext, GLFbo glfbo) { this.gl = gl; this.gl2 = gl instanceof GL2 ? (GL2)gl : null; this.gl3 = gl instanceof GL3 ? (GL3)gl : null; this.gl4 = gl instanceof GL4 ? (GL4)gl : null; this.glfbo = glfbo; - this.glext = glfbo instanceof GLExt ? (GLExt)glfbo : null; + this.glext = glext; this.texUtil = new TextureUtil(gl, gl2, glext, context); } @@ -137,10 +137,19 @@ public class GLRenderer implements Renderer { return limits; } - private static HashSet loadExtensions(String extensions) { + private HashSet loadExtensions() { HashSet extensionSet = new HashSet(64); - for (String extension : extensions.split(" ")) { - extensionSet.add(extension); + if (gl3 != null) { + // If OpenGL3+ is available, use the non-deprecated way + // of getting supported extensions. + gl3.glGetInteger(GL3.GL_NUM_EXTENSIONS, intBuf16); + int extensionCount = intBuf16.get(0); + for (int i = 0; i < extensionCount; i++) { + String extension = gl3.glGetString(GL.GL_EXTENSIONS, i); + extensionSet.add(extension); + } + } else { + extensionSet.addAll(Arrays.asList(gl.glGetString(GL.GL_EXTENSIONS).split(" "))); } return extensionSet; } @@ -185,10 +194,12 @@ public class GLRenderer implements Renderer { caps.add(Caps.OpenGL31); if (oglVer >= 320) { caps.add(Caps.OpenGL32); - }if(oglVer>=330){ + } + if (oglVer >= 330) { caps.add(Caps.OpenGL33); caps.add(Caps.GeometryShader); - }if(oglVer>=400){ + } + if (oglVer >= 400) { caps.add(Caps.OpenGL40); caps.add(Caps.TesselationShader); } @@ -243,7 +254,7 @@ public class GLRenderer implements Renderer { } private void loadCapabilitiesCommon() { - extensions = loadExtensions(gl.glGetString(GL.GL_EXTENSIONS)); + extensions = loadExtensions(); limits.put(Limits.VertexTextureUnits, getInteger(GL.GL_MAX_VERTEX_TEXTURE_IMAGE_UNITS)); if (limits.get(Limits.VertexTextureUnits) > 0) { @@ -251,7 +262,7 @@ public class GLRenderer implements Renderer { } limits.put(Limits.FragmentTextureUnits, getInteger(GL.GL_MAX_TEXTURE_IMAGE_UNITS)); - + // gl.glGetInteger(GL.GL_MAX_VERTEX_UNIFORM_COMPONENTS, intBuf16); // vertexUniforms = intBuf16.get(0); // logger.log(Level.FINER, "Vertex Uniforms: {0}", vertexUniforms); @@ -279,7 +290,7 @@ public class GLRenderer implements Renderer { // == texture format extensions == - boolean hasFloatTexture = false; + boolean hasFloatTexture; hasFloatTexture = hasExtension("GL_OES_texture_half_float") && hasExtension("GL_OES_texture_float"); @@ -375,11 +386,11 @@ public class GLRenderer implements Renderer { caps.add(Caps.TextureFilterAnisotropic); } - if (hasExtension("GL_EXT_framebuffer_object")) { + if (hasExtension("GL_EXT_framebuffer_object") || gl3 != null) { caps.add(Caps.FrameBuffer); - limits.put(Limits.RenderBufferSize, getInteger(GLExt.GL_MAX_RENDERBUFFER_SIZE_EXT)); - limits.put(Limits.FrameBufferAttachments, getInteger(GLExt.GL_MAX_COLOR_ATTACHMENTS_EXT)); + limits.put(Limits.RenderBufferSize, getInteger(GLFbo.GL_MAX_RENDERBUFFER_SIZE_EXT)); + limits.put(Limits.FrameBufferAttachments, getInteger(GLFbo.GL_MAX_COLOR_ATTACHMENTS_EXT)); if (hasExtension("GL_EXT_framebuffer_blit")) { caps.add(Caps.FrameBufferBlit); @@ -434,21 +445,30 @@ public class GLRenderer implements Renderer { caps.add(Caps.SeamlessCubemap); } -// if (hasExtension("GL_ARB_get_program_binary")) { -// int binaryFormats = getInteger(GLExt.GL_NUM_PROGRAM_BINARY_FORMATS); -// } + if (caps.contains(Caps.OpenGL32) && !hasExtension("GL_ARB_compatibility")) { + caps.add(Caps.CoreProfile); + } + + if (hasExtension("GL_ARB_get_program_binary")) { + int binaryFormats = getInteger(GLExt.GL_NUM_PROGRAM_BINARY_FORMATS); + if (binaryFormats > 0) { + caps.add(Caps.BinaryShader); + } + } // Print context information logger.log(Level.INFO, "OpenGL Renderer Information\n" + " * Vendor: {0}\n" + " * Renderer: {1}\n" + " * OpenGL Version: {2}\n" + - " * GLSL Version: {3}", + " * GLSL Version: {3}\n" + + " * Profile: {4}", new Object[]{ gl.glGetString(GL.GL_VENDOR), gl.glGetString(GL.GL_RENDERER), gl.glGetString(GL.GL_VERSION), - gl.glGetString(GL.GL_SHADING_LANGUAGE_VERSION) + gl.glGetString(GL.GL_SHADING_LANGUAGE_VERSION), + caps.contains(Caps.CoreProfile) ? "Core" : "Compatibility" }); // Print capabilities (if fine logging is enabled) @@ -491,6 +511,20 @@ public class GLRenderer implements Renderer { // Initialize default state.. gl.glPixelStorei(GL.GL_UNPACK_ALIGNMENT, 1); + + if (caps.contains(Caps.CoreProfile)) { + // Core Profile requires VAO to be bound. + gl3.glGenVertexArrays(intBuf16); + int vaoId = intBuf16.get(0); + gl3.glBindVertexArray(vaoId); + } + if (gl2 != null) { + gl2.glEnable(GL2.GL_VERTEX_PROGRAM_POINT_SIZE); + if (!caps.contains(Caps.CoreProfile)) { + gl2.glEnable(GL2.GL_POINT_SPRITE); + context.pointSprite = true; + } + } } public void invalidateState() { @@ -610,31 +644,6 @@ public class GLRenderer implements Renderer { context.colorWriteEnabled = false; } - if (gl2 != null) { - if (state.isPointSprite() && !context.pointSprite) { - // Only enable/disable sprite - if (context.boundTextures[0] != null) { - if (context.boundTextureUnit != 0) { - gl.glActiveTexture(GL.GL_TEXTURE0); - context.boundTextureUnit = 0; - } - gl2.glEnable(GL2.GL_POINT_SPRITE); - gl2.glEnable(GL2.GL_VERTEX_PROGRAM_POINT_SIZE); - } - context.pointSprite = true; - } else if (!state.isPointSprite() && context.pointSprite) { - if (context.boundTextures[0] != null) { - if (context.boundTextureUnit != 0) { - gl.glActiveTexture(GL.GL_TEXTURE0); - context.boundTextureUnit = 0; - } - gl2.glDisable(GL2.GL_POINT_SPRITE); - gl2.glDisable(GL2.GL_VERTEX_PROGRAM_POINT_SIZE); - context.pointSprite = false; - } - } - } - if (state.isPolyOffset()) { if (!context.polyOffsetEnabled) { gl.glEnable(GL.GL_POLYGON_OFFSET_FILL); @@ -1288,24 +1297,24 @@ public class GLRenderer implements Renderer { } if (src == null) { - glfbo.glBindFramebufferEXT(GLExt.GL_READ_FRAMEBUFFER_EXT, 0); + glfbo.glBindFramebufferEXT(GLFbo.GL_READ_FRAMEBUFFER_EXT, 0); srcX0 = vpX; srcY0 = vpY; srcX1 = vpX + vpW; srcY1 = vpY + vpH; } else { - glfbo.glBindFramebufferEXT(GLExt.GL_READ_FRAMEBUFFER_EXT, src.getId()); + glfbo.glBindFramebufferEXT(GLFbo.GL_READ_FRAMEBUFFER_EXT, src.getId()); srcX1 = src.getWidth(); srcY1 = src.getHeight(); } if (dst == null) { - glfbo.glBindFramebufferEXT(GLExt.GL_DRAW_FRAMEBUFFER_EXT, 0); + glfbo.glBindFramebufferEXT(GLFbo.GL_DRAW_FRAMEBUFFER_EXT, 0); dstX0 = vpX; dstY0 = vpY; dstX1 = vpX + vpW; dstY1 = vpY + vpH; } else { - glfbo.glBindFramebufferEXT(GLExt.GL_DRAW_FRAMEBUFFER_EXT, dst.getId()); + glfbo.glBindFramebufferEXT(GLFbo.GL_DRAW_FRAMEBUFFER_EXT, dst.getId()); dstX1 = dst.getWidth(); dstY1 = dst.getHeight(); } @@ -1313,12 +1322,12 @@ public class GLRenderer implements Renderer { if (copyDepth) { mask |= GL.GL_DEPTH_BUFFER_BIT; } - glext.glBlitFramebufferEXT(srcX0, srcY0, srcX1, srcY1, + glfbo.glBlitFramebufferEXT(srcX0, srcY0, srcX1, srcY1, dstX0, dstY0, dstX1, dstY1, mask, GL.GL_NEAREST); - glfbo.glBindFramebufferEXT(GLExt.GL_FRAMEBUFFER_EXT, prevFBO); + glfbo.glBindFramebufferEXT(GLFbo.GL_FRAMEBUFFER_EXT, prevFBO); } else { throw new RendererException("Framebuffer blitting not supported by the video hardware"); } @@ -1364,7 +1373,7 @@ public class GLRenderer implements Renderer { } if (context.boundRB != id) { - glfbo.glBindRenderbufferEXT(GLExt.GL_RENDERBUFFER_EXT, id); + glfbo.glBindRenderbufferEXT(GLFbo.GL_RENDERBUFFER_EXT, id); context.boundRB = id; } @@ -1382,13 +1391,13 @@ public class GLRenderer implements Renderer { if (maxSamples < samples) { samples = maxSamples; } - glext.glRenderbufferStorageMultisampleEXT(GLExt.GL_RENDERBUFFER_EXT, + glfbo.glRenderbufferStorageMultisampleEXT(GLFbo.GL_RENDERBUFFER_EXT, samples, glFmt.internalFormat, fb.getWidth(), fb.getHeight()); } else { - glfbo.glRenderbufferStorageEXT(GLExt.GL_RENDERBUFFER_EXT, + glfbo.glRenderbufferStorageEXT(GLFbo.GL_RENDERBUFFER_EXT, glFmt.internalFormat, fb.getWidth(), fb.getHeight()); @@ -1398,7 +1407,7 @@ public class GLRenderer implements Renderer { private int convertAttachmentSlot(int attachmentSlot) { // can also add support for stencil here if (attachmentSlot == FrameBuffer.SLOT_DEPTH) { - return GLExt.GL_DEPTH_ATTACHMENT_EXT; + return GLFbo.GL_DEPTH_ATTACHMENT_EXT; } else if (attachmentSlot == FrameBuffer.SLOT_DEPTH_STENCIL) { // NOTE: Using depth stencil format requires GL3, this is already // checked via render caps. @@ -1407,7 +1416,7 @@ public class GLRenderer implements Renderer { throw new UnsupportedOperationException("Invalid FBO attachment slot: " + attachmentSlot); } - return GLExt.GL_COLOR_ATTACHMENT0_EXT + attachmentSlot; + return GLFbo.GL_COLOR_ATTACHMENT0_EXT + attachmentSlot; } public void updateRenderTexture(FrameBuffer fb, RenderBuffer rb) { @@ -1425,7 +1434,7 @@ public class GLRenderer implements Renderer { setupTextureParams(tex); } - glfbo.glFramebufferTexture2DEXT(GLExt.GL_FRAMEBUFFER_EXT, + glfbo.glFramebufferTexture2DEXT(GLFbo.GL_FRAMEBUFFER_EXT, convertAttachmentSlot(rb.getSlot()), convertTextureType(tex.getType(), image.getMultiSamples(), rb.getFace()), image.getId(), @@ -1443,9 +1452,9 @@ public class GLRenderer implements Renderer { updateRenderTexture(fb, rb); } if (needAttach) { - glfbo.glFramebufferRenderbufferEXT(GLExt.GL_FRAMEBUFFER_EXT, + glfbo.glFramebufferRenderbufferEXT(GLFbo.GL_FRAMEBUFFER_EXT, convertAttachmentSlot(rb.getSlot()), - GLExt.GL_RENDERBUFFER_EXT, + GLFbo.GL_RENDERBUFFER_EXT, rb.getId()); } } @@ -1463,7 +1472,7 @@ public class GLRenderer implements Renderer { } if (context.boundFBO != id) { - glfbo.glBindFramebufferEXT(GLExt.GL_FRAMEBUFFER_EXT, id); + glfbo.glBindFramebufferEXT(GLFbo.GL_FRAMEBUFFER_EXT, id); // binding an FBO automatically sets draw buf to GL_COLOR_ATTACHMENT0 context.boundDrawBuf = 0; context.boundFBO = id; @@ -1543,7 +1552,7 @@ public class GLRenderer implements Renderer { if (fb == null) { // unbind any fbos if (context.boundFBO != 0) { - glfbo.glBindFramebufferEXT(GLExt.GL_FRAMEBUFFER_EXT, 0); + glfbo.glBindFramebufferEXT(GLFbo.GL_FRAMEBUFFER_EXT, 0); statistics.onFrameBufferUse(null, true); context.boundFBO = 0; @@ -1575,7 +1584,7 @@ public class GLRenderer implements Renderer { setViewPort(0, 0, fb.getWidth(), fb.getHeight()); if (context.boundFBO != fb.getId()) { - glfbo.glBindFramebufferEXT(GLExt.GL_FRAMEBUFFER_EXT, fb.getId()); + glfbo.glBindFramebufferEXT(GLFbo.GL_FRAMEBUFFER_EXT, fb.getId()); statistics.onFrameBufferUse(fb, true); context.boundFBO = fb.getId(); @@ -1615,7 +1624,7 @@ public class GLRenderer implements Renderer { if (context.boundDrawBuf != 100 + fb.getNumColorBuffers()) { intBuf16.clear(); for (int i = 0; i < fb.getNumColorBuffers(); i++) { - intBuf16.put(GLExt.GL_COLOR_ATTACHMENT0_EXT + i); + intBuf16.put(GLFbo.GL_COLOR_ATTACHMENT0_EXT + i); } intBuf16.flip(); @@ -1627,7 +1636,7 @@ public class GLRenderer implements Renderer { // select this draw buffer if (gl2 != null) { if (context.boundDrawBuf != rb.getSlot()) { - gl2.glDrawBuffer(GLExt.GL_COLOR_ATTACHMENT0_EXT + rb.getSlot()); + gl2.glDrawBuffer(GLFbo.GL_COLOR_ATTACHMENT0_EXT + rb.getSlot()); context.boundDrawBuf = rb.getSlot(); } } @@ -1656,7 +1665,7 @@ public class GLRenderer implements Renderer { setFrameBuffer(fb); if (gl2 != null) { if (context.boundReadBuf != rb.getSlot()) { - gl2.glReadBuffer(GLExt.GL_COLOR_ATTACHMENT0_EXT + rb.getSlot()); + gl2.glReadBuffer(GLFbo.GL_COLOR_ATTACHMENT0_EXT + rb.getSlot()); context.boundReadBuf = rb.getSlot(); } } @@ -1680,7 +1689,7 @@ public class GLRenderer implements Renderer { public void deleteFrameBuffer(FrameBuffer fb) { if (fb.getId() != -1) { if (context.boundFBO == fb.getId()) { - glfbo.glBindFramebufferEXT(GLExt.GL_FRAMEBUFFER_EXT, 0); + glfbo.glBindFramebufferEXT(GLFbo.GL_FRAMEBUFFER_EXT, 0); context.boundFBO = 0; } @@ -2618,32 +2627,13 @@ public class GLRenderer implements Renderer { return; } - if (context.pointSprite && mesh.getMode() != Mode.Points) { - // XXX: Hack, disable point sprite mode if mesh not in point mode - if (context.boundTextures[0] != null) { - if (context.boundTextureUnit != 0) { - gl.glActiveTexture(GL.GL_TEXTURE0); - context.boundTextureUnit = 0; - } - if (gl2 != null) { - gl2.glDisable(GL2.GL_POINT_SPRITE); - gl2.glDisable(GL2.GL_VERTEX_PROGRAM_POINT_SIZE); - } - context.pointSprite = false; - } - } - if (gl2 != null) { - if (context.pointSize != mesh.getPointSize()) { - gl2.glPointSize(mesh.getPointSize()); - context.pointSize = mesh.getPointSize(); - } - } if (context.lineWidth != mesh.getLineWidth()) { gl.glLineWidth(mesh.getLineWidth()); context.lineWidth = mesh.getLineWidth(); } - if(gl4!=null && mesh.getMode().equals(Mode.Patch)){ + + if (gl4 != null && mesh.getMode().equals(Mode.Patch)) { gl4.glPatchParameter(mesh.getPatchVertexCount()); } statistics.onMeshDrawn(mesh, lod, count); diff --git a/jme3-core/src/main/java/com/jme3/renderer/opengl/GLTracer.java b/jme3-core/src/main/java/com/jme3/renderer/opengl/GLTracer.java index b69d524b4..1b0d70749 100644 --- a/jme3-core/src/main/java/com/jme3/renderer/opengl/GLTracer.java +++ b/jme3-core/src/main/java/com/jme3/renderer/opengl/GLTracer.java @@ -64,6 +64,7 @@ public final class GLTracer implements InvocationHandler { noEnumArgs("glScissor", 0, 1, 2, 3); noEnumArgs("glClear", 0); noEnumArgs("glGetInteger", 1); + noEnumArgs("glGetString", 1); noEnumArgs("glBindTexture", 1); noEnumArgs("glPixelStorei", 1); @@ -95,8 +96,6 @@ public final class GLTracer implements InvocationHandler { noEnumArgs("glFramebufferTexture2DEXT", 3, 4); noEnumArgs("glBlitFramebufferEXT", 0, 1, 2, 3, 4, 5, 6, 7, 8); - - noEnumArgs("glCreateProgram", -1); noEnumArgs("glCreateShader", -1); noEnumArgs("glShaderSource", 0); @@ -155,7 +154,7 @@ public final class GLTracer implements InvocationHandler { * @return A tracer that implements the given interface */ public static Object createGlesTracer(Object glInterface, Class glInterfaceClass) { - IntMap constMap = generateConstantMap(GL.class, GLExt.class); + IntMap constMap = generateConstantMap(GL.class, GLFbo.class, GLExt.class); return Proxy.newProxyInstance(glInterface.getClass().getClassLoader(), new Class[] { glInterfaceClass }, new GLTracer(glInterface, constMap)); @@ -169,7 +168,7 @@ public final class GLTracer implements InvocationHandler { * @return A tracer that implements the given interface */ public static Object createDesktopGlTracer(Object glInterface, Class ... glInterfaceClasses) { - IntMap constMap = generateConstantMap(GL2.class, GLExt.class); + IntMap constMap = generateConstantMap(GL2.class, GL3.class, GL4.class, GLFbo.class, GLExt.class); return Proxy.newProxyInstance(glInterface.getClass().getClassLoader(), glInterfaceClasses, new GLTracer(glInterface, constMap)); diff --git a/jme3-ios/src/main/java/com/jme3/system/ios/IGLESContext.java b/jme3-ios/src/main/java/com/jme3/system/ios/IGLESContext.java index 7feaeae5b..2d046550e 100644 --- a/jme3-ios/src/main/java/com/jme3/system/ios/IGLESContext.java +++ b/jme3-ios/src/main/java/com/jme3/system/ios/IGLESContext.java @@ -40,6 +40,7 @@ import com.jme3.renderer.ios.IosGL; import com.jme3.renderer.opengl.GL; import com.jme3.renderer.opengl.GLDebugES; import com.jme3.renderer.opengl.GLExt; +import com.jme3.renderer.opengl.GLFbo; import com.jme3.renderer.opengl.GLRenderer; import java.util.concurrent.atomic.AtomicBoolean; import java.util.logging.Level; @@ -158,11 +159,11 @@ public class IGLESContext implements JmeContext { GLExt glext = (GLExt) gl; // if (settings.getBoolean("GraphicsDebug")) { - gl = new GLDebugES(gl, glext); + gl = new GLDebugES(gl, glext, (GLFbo) glext); glext = (GLExt) gl; // } - renderer = new GLRenderer(gl, glext); + renderer = new GLRenderer(gl, glext, (GLFbo) glext); renderer.initialize(); input = new IosInputHandler(); diff --git a/jme3-lwjgl/src/main/java/com/jme3/renderer/lwjgl/LwjglGL.java b/jme3-lwjgl/src/main/java/com/jme3/renderer/lwjgl/LwjglGL.java index 82b8ee72b..0b55a3a40 100644 --- a/jme3-lwjgl/src/main/java/com/jme3/renderer/lwjgl/LwjglGL.java +++ b/jme3-lwjgl/src/main/java/com/jme3/renderer/lwjgl/LwjglGL.java @@ -13,7 +13,7 @@ import java.nio.ShortBuffer; import com.jme3.renderer.opengl.GL4; import org.lwjgl.opengl.*; -public class LwjglGL implements GL, GL2, GL3,GL4 { +public class LwjglGL implements GL, GL2, GL3, GL4 { private static void checkLimit(Buffer buffer) { if (buffer == null) { @@ -237,6 +237,10 @@ public class LwjglGL implements GL, GL2, GL3,GL4 { public String glGetString(int param1) { return GL11.glGetString(param1); } + + public String glGetString(int param1, int param2) { + return GL30.glGetStringi(param1, param2); + } public boolean glIsEnabled(int param1) { return GL11.glIsEnabled(param1); @@ -444,4 +448,10 @@ public class LwjglGL implements GL, GL2, GL3,GL4 { public void glPatchParameter(int count) { GL40.glPatchParameteri(GL40.GL_PATCH_VERTICES,count); } + + @Override + public void glDeleteVertexArrays(IntBuffer arrays) { + checkLimit(arrays); + ARBVertexArrayObject.glDeleteVertexArrays(arrays); + } } diff --git a/jme3-lwjgl/src/main/java/com/jme3/renderer/lwjgl/LwjglGLExt.java b/jme3-lwjgl/src/main/java/com/jme3/renderer/lwjgl/LwjglGLExt.java index 89139282a..2c6a63fd7 100644 --- a/jme3-lwjgl/src/main/java/com/jme3/renderer/lwjgl/LwjglGLExt.java +++ b/jme3-lwjgl/src/main/java/com/jme3/renderer/lwjgl/LwjglGLExt.java @@ -7,12 +7,8 @@ import java.nio.FloatBuffer; import java.nio.IntBuffer; import org.lwjgl.opengl.ARBDrawInstanced; import org.lwjgl.opengl.ARBInstancedArrays; -import org.lwjgl.opengl.ARBPixelBufferObject; import org.lwjgl.opengl.ARBSync; import org.lwjgl.opengl.ARBTextureMultisample; -import org.lwjgl.opengl.EXTFramebufferBlit; -import org.lwjgl.opengl.EXTFramebufferMultisample; -import org.lwjgl.opengl.EXTFramebufferObject; import org.lwjgl.opengl.GL15; import org.lwjgl.opengl.GL20; import org.lwjgl.opengl.GLSync; @@ -30,99 +26,51 @@ public class LwjglGLExt implements GLExt { throw new RendererException("Attempting to upload empty buffer (remaining = 0), that's an error"); } } - - public void glBlitFramebufferEXT(int srcX0, int srcY0, int srcX1, int srcY1, int dstX0, int dstY0, int dstX1, int dstY1, int mask, int filter) { - EXTFramebufferBlit.glBlitFramebufferEXT(srcX0, srcY0, srcX1, srcY1, dstX0, dstY0, dstX1, dstY1, mask, filter); - } + @Override public void glBufferData(int target, IntBuffer data, int usage) { checkLimit(data); GL15.glBufferData(target, data, usage); } + @Override public void glBufferSubData(int target, long offset, IntBuffer data) { checkLimit(data); GL15.glBufferSubData(target, offset, data); } + @Override public void glDrawArraysInstancedARB(int mode, int first, int count, int primcount) { ARBDrawInstanced.glDrawArraysInstancedARB(mode, first, count, primcount); } + @Override public void glDrawBuffers(IntBuffer bufs) { checkLimit(bufs); GL20.glDrawBuffers(bufs); } + @Override public void glDrawElementsInstancedARB(int mode, int indices_count, int type, long indices_buffer_offset, int primcount) { ARBDrawInstanced.glDrawElementsInstancedARB(mode, indices_count, type, indices_buffer_offset, primcount); } + @Override public void glGetMultisample(int pname, int index, FloatBuffer val) { checkLimit(val); ARBTextureMultisample.glGetMultisample(pname, index, val); } - public void glRenderbufferStorageMultisampleEXT(int target, int samples, int internalformat, int width, int height) { - EXTFramebufferMultisample.glRenderbufferStorageMultisampleEXT(target, samples, internalformat, width, height); - } - + @Override public void glTexImage2DMultisample(int target, int samples, int internalformat, int width, int height, boolean fixedsamplelocations) { ARBTextureMultisample.glTexImage2DMultisample(target, samples, internalformat, width, height, fixedsamplelocations); } + @Override public void glVertexAttribDivisorARB(int index, int divisor) { ARBInstancedArrays.glVertexAttribDivisorARB(index, divisor); } - public void glBindFramebufferEXT(int param1, int param2) { - EXTFramebufferObject.glBindFramebufferEXT(param1, param2); - } - - public void glBindRenderbufferEXT(int param1, int param2) { - EXTFramebufferObject.glBindRenderbufferEXT(param1, param2); - } - - public int glCheckFramebufferStatusEXT(int param1) { - return EXTFramebufferObject.glCheckFramebufferStatusEXT(param1); - } - - public void glDeleteFramebuffersEXT(IntBuffer param1) { - checkLimit(param1); - EXTFramebufferObject.glDeleteFramebuffersEXT(param1); - } - - public void glDeleteRenderbuffersEXT(IntBuffer param1) { - checkLimit(param1); - EXTFramebufferObject.glDeleteRenderbuffersEXT(param1); - } - - public void glFramebufferRenderbufferEXT(int param1, int param2, int param3, int param4) { - EXTFramebufferObject.glFramebufferRenderbufferEXT(param1, param2, param3, param4); - } - - public void glFramebufferTexture2DEXT(int param1, int param2, int param3, int param4, int param5) { - EXTFramebufferObject.glFramebufferTexture2DEXT(param1, param2, param3, param4, param5); - } - - public void glGenFramebuffersEXT(IntBuffer param1) { - checkLimit(param1); - EXTFramebufferObject.glGenFramebuffersEXT(param1); - } - - public void glGenRenderbuffersEXT(IntBuffer param1) { - checkLimit(param1); - EXTFramebufferObject.glGenRenderbuffersEXT(param1); - } - - public void glGenerateMipmapEXT(int param1) { - EXTFramebufferObject.glGenerateMipmapEXT(param1); - } - - public void glRenderbufferStorageEXT(int param1, int param2, int param3, int param4) { - EXTFramebufferObject.glRenderbufferStorageEXT(param1, param2, param3, param4); - } - @Override public Object glFenceSync(int condition, int flags) { return ARBSync.glFenceSync(condition, flags); diff --git a/jme3-lwjgl/src/main/java/com/jme3/renderer/lwjgl/LwjglGLFboEXT.java b/jme3-lwjgl/src/main/java/com/jme3/renderer/lwjgl/LwjglGLFboEXT.java new file mode 100644 index 000000000..159000a6c --- /dev/null +++ b/jme3-lwjgl/src/main/java/com/jme3/renderer/lwjgl/LwjglGLFboEXT.java @@ -0,0 +1,98 @@ +package com.jme3.renderer.lwjgl; + +import com.jme3.renderer.RendererException; +import com.jme3.renderer.opengl.GLFbo; +import java.nio.Buffer; +import java.nio.IntBuffer; +import org.lwjgl.opengl.EXTFramebufferBlit; +import org.lwjgl.opengl.EXTFramebufferMultisample; +import org.lwjgl.opengl.EXTFramebufferObject; + +/** + * Implements GLFbo via GL_EXT_framebuffer_object. + * + * @author Kirill Vainer + */ +public class LwjglGLFboEXT implements GLFbo { + + private static void checkLimit(Buffer buffer) { + if (buffer == null) { + return; + } + if (buffer.limit() == 0) { + throw new RendererException("Attempting to upload empty buffer (limit = 0), that's an error"); + } + if (buffer.remaining() == 0) { + throw new RendererException("Attempting to upload empty buffer (remaining = 0), that's an error"); + } + } + + @Override + public void glBlitFramebufferEXT(int srcX0, int srcY0, int srcX1, int srcY1, int dstX0, int dstY0, int dstX1, int dstY1, int mask, int filter) { + EXTFramebufferBlit.glBlitFramebufferEXT(srcX0, srcY0, srcX1, srcY1, dstX0, dstY0, dstX1, dstY1, mask, filter); + } + + @Override + public void glRenderbufferStorageMultisampleEXT(int target, int samples, int internalformat, int width, int height) { + EXTFramebufferMultisample.glRenderbufferStorageMultisampleEXT(target, samples, internalformat, width, height); + } + + @Override + public void glBindFramebufferEXT(int param1, int param2) { + EXTFramebufferObject.glBindFramebufferEXT(param1, param2); + } + + @Override + public void glBindRenderbufferEXT(int param1, int param2) { + EXTFramebufferObject.glBindRenderbufferEXT(param1, param2); + } + + @Override + public int glCheckFramebufferStatusEXT(int param1) { + return EXTFramebufferObject.glCheckFramebufferStatusEXT(param1); + } + + @Override + public void glDeleteFramebuffersEXT(IntBuffer param1) { + checkLimit(param1); + EXTFramebufferObject.glDeleteFramebuffersEXT(param1); + } + + @Override + public void glDeleteRenderbuffersEXT(IntBuffer param1) { + checkLimit(param1); + EXTFramebufferObject.glDeleteRenderbuffersEXT(param1); + } + + @Override + public void glFramebufferRenderbufferEXT(int param1, int param2, int param3, int param4) { + EXTFramebufferObject.glFramebufferRenderbufferEXT(param1, param2, param3, param4); + } + + @Override + public void glFramebufferTexture2DEXT(int param1, int param2, int param3, int param4, int param5) { + EXTFramebufferObject.glFramebufferTexture2DEXT(param1, param2, param3, param4, param5); + } + + @Override + public void glGenFramebuffersEXT(IntBuffer param1) { + checkLimit(param1); + EXTFramebufferObject.glGenFramebuffersEXT(param1); + } + + @Override + public void glGenRenderbuffersEXT(IntBuffer param1) { + checkLimit(param1); + EXTFramebufferObject.glGenRenderbuffersEXT(param1); + } + + @Override + public void glGenerateMipmapEXT(int param1) { + EXTFramebufferObject.glGenerateMipmapEXT(param1); + } + + @Override + public void glRenderbufferStorageEXT(int param1, int param2, int param3, int param4) { + EXTFramebufferObject.glRenderbufferStorageEXT(param1, param2, param3, param4); + } +} diff --git a/jme3-lwjgl/src/main/java/com/jme3/renderer/lwjgl/LwjglGLFboGL3.java b/jme3-lwjgl/src/main/java/com/jme3/renderer/lwjgl/LwjglGLFboGL3.java new file mode 100644 index 000000000..acc540273 --- /dev/null +++ b/jme3-lwjgl/src/main/java/com/jme3/renderer/lwjgl/LwjglGLFboGL3.java @@ -0,0 +1,96 @@ +package com.jme3.renderer.lwjgl; + +import com.jme3.renderer.RendererException; +import com.jme3.renderer.opengl.GLFbo; +import java.nio.Buffer; +import java.nio.IntBuffer; +import org.lwjgl.opengl.GL30; + +/** + * Implements GLFbo via OpenGL3+. + * + * @author Kirill Vainer + */ +public class LwjglGLFboGL3 implements GLFbo { + + private static void checkLimit(Buffer buffer) { + if (buffer == null) { + return; + } + if (buffer.limit() == 0) { + throw new RendererException("Attempting to upload empty buffer (limit = 0), that's an error"); + } + if (buffer.remaining() == 0) { + throw new RendererException("Attempting to upload empty buffer (remaining = 0), that's an error"); + } + } + + @Override + public void glBlitFramebufferEXT(int srcX0, int srcY0, int srcX1, int srcY1, int dstX0, int dstY0, int dstX1, int dstY1, int mask, int filter) { + GL30.glBlitFramebuffer(srcX0, srcY0, srcX1, srcY1, dstX0, dstY0, dstX1, dstY1, mask, filter); + } + + @Override + public void glRenderbufferStorageMultisampleEXT(int target, int samples, int internalformat, int width, int height) { + GL30.glRenderbufferStorageMultisample(target, samples, internalformat, width, height); + } + + @Override + public void glBindFramebufferEXT(int param1, int param2) { + GL30.glBindFramebuffer(param1, param2); + } + + @Override + public void glBindRenderbufferEXT(int param1, int param2) { + GL30.glBindRenderbuffer(param1, param2); + } + + @Override + public int glCheckFramebufferStatusEXT(int param1) { + return GL30.glCheckFramebufferStatus(param1); + } + + @Override + public void glDeleteFramebuffersEXT(IntBuffer param1) { + checkLimit(param1); + GL30.glDeleteFramebuffers(param1); + } + + @Override + public void glDeleteRenderbuffersEXT(IntBuffer param1) { + checkLimit(param1); + GL30.glDeleteRenderbuffers(param1); + } + + @Override + public void glFramebufferRenderbufferEXT(int param1, int param2, int param3, int param4) { + GL30.glFramebufferRenderbuffer(param1, param2, param3, param4); + } + + @Override + public void glFramebufferTexture2DEXT(int param1, int param2, int param3, int param4, int param5) { + GL30.glFramebufferTexture2D(param1, param2, param3, param4, param5); + } + + @Override + public void glGenFramebuffersEXT(IntBuffer param1) { + checkLimit(param1); + GL30.glGenFramebuffers(param1); + } + + @Override + public void glGenRenderbuffersEXT(IntBuffer param1) { + checkLimit(param1); + GL30.glGenRenderbuffers(param1); + } + + @Override + public void glGenerateMipmapEXT(int param1) { + GL30.glGenerateMipmap(param1); + } + + @Override + public void glRenderbufferStorageEXT(int param1, int param2, int param3, int param4) { + GL30.glRenderbufferStorage(param1, param2, param3, param4); + } +} diff --git a/jme3-lwjgl/src/main/java/com/jme3/system/lwjgl/LwjglContext.java b/jme3-lwjgl/src/main/java/com/jme3/system/lwjgl/LwjglContext.java index 1286323ef..57ef81c0a 100644 --- a/jme3-lwjgl/src/main/java/com/jme3/system/lwjgl/LwjglContext.java +++ b/jme3-lwjgl/src/main/java/com/jme3/system/lwjgl/LwjglContext.java @@ -39,13 +39,18 @@ import com.jme3.renderer.Renderer; import com.jme3.renderer.RendererException; import com.jme3.renderer.lwjgl.LwjglGL; import com.jme3.renderer.lwjgl.LwjglGLExt; +import com.jme3.renderer.lwjgl.LwjglGLFboEXT; +import com.jme3.renderer.lwjgl.LwjglGLFboGL3; import com.jme3.renderer.opengl.GL; import com.jme3.renderer.opengl.GL2; import com.jme3.renderer.opengl.GL3; +import com.jme3.renderer.opengl.GL4; import com.jme3.renderer.opengl.GLDebugDesktop; import com.jme3.renderer.opengl.GLExt; import com.jme3.renderer.opengl.GLFbo; import com.jme3.renderer.opengl.GLRenderer; +import com.jme3.renderer.opengl.GLTiming; +import com.jme3.renderer.opengl.GLTimingState; import com.jme3.renderer.opengl.GLTracer; import com.jme3.system.AppSettings; import com.jme3.system.JmeContext; @@ -203,21 +208,30 @@ public abstract class LwjglContext implements JmeContext { } if (settings.getRenderer().equals(AppSettings.LWJGL_OPENGL2) - || settings.getRenderer().equals(AppSettings.LWJGL_OPENGL3)) { + || settings.getRenderer().equals(AppSettings.LWJGL_OPENGL3)) { GL gl = new LwjglGL(); - GLFbo glfbo = new LwjglGLExt(); + GLExt glext = new LwjglGLExt(); + GLFbo glfbo; + + if (GLContext.getCapabilities().OpenGL30) { + glfbo = new LwjglGLFboGL3(); + } else { + glfbo = new LwjglGLFboEXT(); + } if (settings.getBoolean("GraphicsDebug")) { - gl = new GLDebugDesktop(gl, glfbo); + gl = new GLDebugDesktop(gl, glext, glfbo); + glext = (GLExt) gl; glfbo = (GLFbo) gl; } if (settings.getBoolean("GraphicsTrace")) { - gl = (GL) GLTracer.createDesktopGlTracer(gl, GL.class, GL2.class, GL3.class); - glfbo = (GLFbo) GLTracer.createDesktopGlTracer(glfbo, GLExt.class); + gl = (GL) GLTracer.createDesktopGlTracer(gl, GL.class, GL2.class, GL3.class, GL4.class); + glext = (GLExt) GLTracer.createDesktopGlTracer(glext, GLExt.class); + glfbo = (GLFbo) GLTracer.createDesktopGlTracer(glfbo, GLFbo.class); } - renderer = new GLRenderer(gl, glfbo); + renderer = new GLRenderer(gl, glext, glfbo); renderer.initialize(); } else { throw new UnsupportedOperationException("Unsupported renderer: " + settings.getRenderer()); From a6c71c4f50fe15ff94c335dec5da84d3d08f764c Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Sat, 25 Apr 2015 17:34:29 -0400 Subject: [PATCH 029/113] Fix missing glPatchParameter and another syntax error --- .../main/java/com/jme3/renderer/opengl/GLDebugDesktop.java | 7 +++++++ .../src/main/java/com/jme3/renderer/opengl/GLRenderer.java | 1 + 2 files changed, 8 insertions(+) diff --git a/jme3-core/src/main/java/com/jme3/renderer/opengl/GLDebugDesktop.java b/jme3-core/src/main/java/com/jme3/renderer/opengl/GLDebugDesktop.java index 5fbaaaa52..a0511f6ad 100644 --- a/jme3-core/src/main/java/com/jme3/renderer/opengl/GLDebugDesktop.java +++ b/jme3-core/src/main/java/com/jme3/renderer/opengl/GLDebugDesktop.java @@ -7,11 +7,13 @@ public class GLDebugDesktop extends GLDebugES implements GL2, GL3, GL4 { private final GL2 gl2; private final GL3 gl3; + private final GL4 gl4; public GLDebugDesktop(GL gl, GLExt glext, GLFbo glfbo) { super(gl, glext, glfbo); this.gl2 = gl instanceof GL2 ? (GL2) gl : null; this.gl3 = gl instanceof GL3 ? (GL3) gl : null; + this.gl4 = gl instanceof GL4 ? (GL4) gl : null; } public void glAlphaFunc(int func, float ref) { @@ -87,4 +89,9 @@ public class GLDebugDesktop extends GLDebugES implements GL2, GL3, GL4 { checkError(); } + @Override + public void glPatchParameter(int count) { + gl4.glPatchParameter(count); + checkError(); + } } diff --git a/jme3-core/src/main/java/com/jme3/renderer/opengl/GLRenderer.java b/jme3-core/src/main/java/com/jme3/renderer/opengl/GLRenderer.java index 7b928202f..80abfaf9c 100644 --- a/jme3-core/src/main/java/com/jme3/renderer/opengl/GLRenderer.java +++ b/jme3-core/src/main/java/com/jme3/renderer/opengl/GLRenderer.java @@ -56,6 +56,7 @@ import com.jme3.util.BufferUtils; import com.jme3.util.ListMap; import com.jme3.util.NativeObjectManager; import java.nio.*; +import java.util.Arrays; import java.util.EnumMap; import java.util.EnumSet; import java.util.HashSet; From ed4b70bcad5052ff76b509a3f39e1647102115c7 Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Sat, 25 Apr 2015 17:41:50 -0400 Subject: [PATCH 030/113] GLTiming: new GL wrapper to profile GL calls --- .../com/jme3/renderer/android/AndroidGL.java | 3 + .../java/com/jme3/renderer/opengl/GL.java | 2 + .../com/jme3/renderer/opengl/GLDebugES.java | 4 + .../com/jme3/renderer/opengl/GLRenderer.java | 1 + .../com/jme3/renderer/opengl/GLTiming.java | 122 ++++++++++++++++++ .../jme3/renderer/opengl/GLTimingState.java | 41 ++++++ .../java/com/jme3/renderer/ios/IosGL.java | 3 + .../java/com/jme3/renderer/lwjgl/LwjglGL.java | 3 + .../com/jme3/system/lwjgl/LwjglContext.java | 7 + 9 files changed, 186 insertions(+) create mode 100644 jme3-core/src/main/java/com/jme3/renderer/opengl/GLTiming.java create mode 100644 jme3-core/src/main/java/com/jme3/renderer/opengl/GLTimingState.java diff --git a/jme3-android/src/main/java/com/jme3/renderer/android/AndroidGL.java b/jme3-android/src/main/java/com/jme3/renderer/android/AndroidGL.java index 2a7b54023..62741253a 100644 --- a/jme3-android/src/main/java/com/jme3/renderer/android/AndroidGL.java +++ b/jme3-android/src/main/java/com/jme3/renderer/android/AndroidGL.java @@ -43,6 +43,9 @@ import java.nio.ShortBuffer; public class AndroidGL implements GL, GLExt { + public void resetStats() { + } + private static int getLimitBytes(ByteBuffer buffer) { checkLimit(buffer); return buffer.limit(); diff --git a/jme3-core/src/main/java/com/jme3/renderer/opengl/GL.java b/jme3-core/src/main/java/com/jme3/renderer/opengl/GL.java index 21ca7a7fa..76eedb521 100644 --- a/jme3-core/src/main/java/com/jme3/renderer/opengl/GL.java +++ b/jme3-core/src/main/java/com/jme3/renderer/opengl/GL.java @@ -177,6 +177,8 @@ public interface GL { public static final int GL_VERTEX_SHADER = 0x8B31; public static final int GL_ZERO = 0x0; + public void resetStats(); + public void glActiveTexture(int texture); public void glAttachShader(int program, int shader); public void glBindBuffer(int target, int buffer); diff --git a/jme3-core/src/main/java/com/jme3/renderer/opengl/GLDebugES.java b/jme3-core/src/main/java/com/jme3/renderer/opengl/GLDebugES.java index 3e8850589..2348bd3cd 100644 --- a/jme3-core/src/main/java/com/jme3/renderer/opengl/GLDebugES.java +++ b/jme3-core/src/main/java/com/jme3/renderer/opengl/GLDebugES.java @@ -16,6 +16,10 @@ public class GLDebugES extends GLDebug implements GL, GLFbo, GLExt { this.glfbo = glfbo; } + public void resetStats() { + gl.resetStats(); + } + public void glActiveTexture(int texture) { gl.glActiveTexture(texture); checkError(); diff --git a/jme3-core/src/main/java/com/jme3/renderer/opengl/GLRenderer.java b/jme3-core/src/main/java/com/jme3/renderer/opengl/GLRenderer.java index 80abfaf9c..db9b743f0 100644 --- a/jme3-core/src/main/java/com/jme3/renderer/opengl/GLRenderer.java +++ b/jme3-core/src/main/java/com/jme3/renderer/opengl/GLRenderer.java @@ -870,6 +870,7 @@ public class GLRenderer implements Renderer { public void postFrame() { objManager.deleteUnused(this); + gl.resetStats(); } /*********************************************************************\ diff --git a/jme3-core/src/main/java/com/jme3/renderer/opengl/GLTiming.java b/jme3-core/src/main/java/com/jme3/renderer/opengl/GLTiming.java new file mode 100644 index 000000000..7e6833b8b --- /dev/null +++ b/jme3-core/src/main/java/com/jme3/renderer/opengl/GLTiming.java @@ -0,0 +1,122 @@ +/* + * Copyright (c) 2009-2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ +package com.jme3.renderer.opengl; + +import java.lang.reflect.InvocationHandler; +import java.lang.reflect.Method; +import java.lang.reflect.Proxy; +import java.util.Arrays; +import java.util.Comparator; +import java.util.Map; + +public class GLTiming implements InvocationHandler { + + private final Object obj; + private final GLTimingState state; + + public GLTiming(Object obj, GLTimingState state) { + this.obj = obj; + this.state = state; + } + + public static Object createGLTiming(Object glInterface, GLTimingState state, Class ... glInterfaceClasses) { + return Proxy.newProxyInstance(glInterface.getClass().getClassLoader(), + glInterfaceClasses, + new GLTiming(glInterface, state)); + } + + private static class CallTimingComparator implements Comparator> { + @Override + public int compare(Map.Entry o1, Map.Entry o2) { + return (int) (o2.getValue() - o1.getValue()); + } + } + + @Override + public Object invoke(Object proxy, Method method, Object[] args) throws Throwable { + String methodName = method.getName(); + if (methodName.equals("resetStats")) { + if (state.lastPrintOutTime + 1000000000 <= System.nanoTime() && state.sampleCount > 0) { + state.timeSpentInGL /= state.sampleCount; + System.out.println("--- TOTAL TIME SPENT IN GL CALLS: " + (state.timeSpentInGL/1000) + "us"); + + Map.Entry[] callTimes = new Map.Entry[state.callTiming.size()]; + int i = 0; + for (Map.Entry callTime : state.callTiming.entrySet()) { + callTimes[i++] = callTime; + } + Arrays.sort(callTimes, new CallTimingComparator()); + int limit = 10; + for (Map.Entry callTime : callTimes) { + long val = callTime.getValue() / state.sampleCount; + String name = callTime.getKey(); + String pad = " ".substring(0, 30 - name.length()); + System.out.println("\t" + callTime.getKey() + pad + (val/1000) + "us"); + if (limit-- == 0) break; + } + for (Map.Entry callTime : callTimes) { + state.callTiming.put(callTime.getKey(), Long.valueOf(0)); + } + + state.sampleCount = 0; + state.timeSpentInGL = 0; + state.lastPrintOutTime = System.nanoTime(); + } else { + state.sampleCount++; + } + return null; + } else { + Long currentTimeObj = state.callTiming.get(methodName); + long currentTime = 0; + if (currentTimeObj != null) currentTime = currentTimeObj; + + + long startTime = System.nanoTime(); + Object result = method.invoke(obj, args); + long delta = System.nanoTime() - startTime; + + currentTime += delta; + state.timeSpentInGL += delta; + + state.callTiming.put(methodName, currentTime); + + if (delta > 1000000 && !methodName.equals("glClear")) { + // More than 1ms + // Ignore glClear as it cannot be avoided. + System.out.println("GL call " + methodName + " took " + (delta/1000) + "us to execute!"); + } + + return result; + } + } + +} diff --git a/jme3-core/src/main/java/com/jme3/renderer/opengl/GLTimingState.java b/jme3-core/src/main/java/com/jme3/renderer/opengl/GLTimingState.java new file mode 100644 index 000000000..ca25810d4 --- /dev/null +++ b/jme3-core/src/main/java/com/jme3/renderer/opengl/GLTimingState.java @@ -0,0 +1,41 @@ +/* + * Copyright (c) 2009-2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ +package com.jme3.renderer.opengl; + +import java.util.HashMap; + +public class GLTimingState { + long timeSpentInGL = 0; + int sampleCount = 0; + long lastPrintOutTime = 0; + final HashMap callTiming = new HashMap(); +} \ No newline at end of file diff --git a/jme3-ios/src/main/java/com/jme3/renderer/ios/IosGL.java b/jme3-ios/src/main/java/com/jme3/renderer/ios/IosGL.java index a1dfaa757..bf82fdff3 100644 --- a/jme3-ios/src/main/java/com/jme3/renderer/ios/IosGL.java +++ b/jme3-ios/src/main/java/com/jme3/renderer/ios/IosGL.java @@ -50,6 +50,9 @@ public class IosGL implements GL, GLExt { private final int[] temp_array = new int[16]; + public void resetStats() { + } + private static int getLimitBytes(ByteBuffer buffer) { checkLimit(buffer); return buffer.limit(); diff --git a/jme3-lwjgl/src/main/java/com/jme3/renderer/lwjgl/LwjglGL.java b/jme3-lwjgl/src/main/java/com/jme3/renderer/lwjgl/LwjglGL.java index 0b55a3a40..bf99c84eb 100644 --- a/jme3-lwjgl/src/main/java/com/jme3/renderer/lwjgl/LwjglGL.java +++ b/jme3-lwjgl/src/main/java/com/jme3/renderer/lwjgl/LwjglGL.java @@ -27,6 +27,9 @@ public class LwjglGL implements GL, GL2, GL3, GL4 { } } + public void resetStats() { + } + public void glActiveTexture(int param1) { GL13.glActiveTexture(param1); } diff --git a/jme3-lwjgl/src/main/java/com/jme3/system/lwjgl/LwjglContext.java b/jme3-lwjgl/src/main/java/com/jme3/system/lwjgl/LwjglContext.java index 57ef81c0a..27e36d78f 100644 --- a/jme3-lwjgl/src/main/java/com/jme3/system/lwjgl/LwjglContext.java +++ b/jme3-lwjgl/src/main/java/com/jme3/system/lwjgl/LwjglContext.java @@ -225,6 +225,13 @@ public abstract class LwjglContext implements JmeContext { glfbo = (GLFbo) gl; } + if (settings.getBoolean("GraphicsTiming")) { + GLTimingState timingState = new GLTimingState(); + gl = (GL) GLTiming.createGLTiming(gl, timingState, GL.class, GL2.class, GL3.class, GL4.class); + glext = (GLExt) GLTiming.createGLTiming(glext, timingState, GLExt.class); + glfbo = (GLFbo) GLTiming.createGLTiming(glfbo, timingState, GLFbo.class); + } + if (settings.getBoolean("GraphicsTrace")) { gl = (GL) GLTracer.createDesktopGlTracer(gl, GL.class, GL2.class, GL3.class, GL4.class); glext = (GLExt) GLTracer.createDesktopGlTracer(glext, GLExt.class); From aba48495e12ace8ef7001d22d794a5a39b529d0c Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Sat, 25 Apr 2015 18:25:07 -0400 Subject: [PATCH 031/113] J3MLoader: enforce MaterialKey requirements based on extension --- .../java/com/jme3/material/plugins/J3MLoader.java | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/jme3-core/src/plugins/java/com/jme3/material/plugins/J3MLoader.java b/jme3-core/src/plugins/java/com/jme3/material/plugins/J3MLoader.java index 5d7f5ca8c..0c81c3e14 100644 --- a/jme3-core/src/plugins/java/com/jme3/material/plugins/J3MLoader.java +++ b/jme3-core/src/plugins/java/com/jme3/material/plugins/J3MLoader.java @@ -569,10 +569,15 @@ public class J3MLoader implements AssetLoader { public Object load(AssetInfo info) throws IOException { this.assetManager = info.getManager(); - + InputStream in = info.openStream(); try { - key = info.getKey(); + key = info.getKey(); + if (key.getExtension().equals("j3m") && !(key instanceof MaterialKey)) { + throw new IOException("Material instances must be loaded via MaterialKey"); + } else if (key.getExtension().equals("j3md") && key instanceof MaterialKey) { + throw new IOException("Material definitions must be loaded via AssetKey"); + } loadFromRoot(BlockLanguageParser.parse(in)); } finally { if (in != null){ @@ -581,9 +586,6 @@ public class J3MLoader implements AssetLoader { } if (material != null){ - if (!(info.getKey() instanceof MaterialKey)){ - throw new IOException("Material instances must be loaded via MaterialKey"); - } // material implementation return material; }else{ From 10cde0a4b28ef13fe9504d3f518a48b62e930921 Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Sat, 25 Apr 2015 22:42:20 -0400 Subject: [PATCH 032/113] DXTFlipper: fix incorrect flipping of DXT5 images of size 2x2 For DXT1/3 images, the format for color and alpha blocks is the same, so the bug would not appear. For DXT5 images, the alpha block is formatted differently. The issue is that it flips the color block and then the alpha block for 2x2 images, but the correct order is alpha block then color block. --- .../com/jme3/texture/plugins/DXTFlipper.java | 23 ++++++++++--------- 1 file changed, 12 insertions(+), 11 deletions(-) diff --git a/jme3-core/src/plugins/java/com/jme3/texture/plugins/DXTFlipper.java b/jme3-core/src/plugins/java/com/jme3/texture/plugins/DXTFlipper.java index 9c71aa132..726cf3e19 100644 --- a/jme3-core/src/plugins/java/com/jme3/texture/plugins/DXTFlipper.java +++ b/jme3-core/src/plugins/java/com/jme3/texture/plugins/DXTFlipper.java @@ -242,21 +242,12 @@ public class DXTFlipper { img.position(blockByteOffset); img.limit(blockByteOffset + bpb); - img.get(colorBlock); - if (type == 4 || type == 5) - flipDXT5Block(colorBlock, h); - else - flipDXT1orDXTA3Block(colorBlock, h); - - // write block (no need to flip block indexes, only pixels - // inside block - retImg.put(colorBlock); - if (alphaBlock != null){ img.get(alphaBlock); switch (type){ case 2: - flipDXT3Block(alphaBlock, h); break; + flipDXT3Block(alphaBlock, h); + break; case 3: case 4: flipDXT5Block(alphaBlock, h); @@ -264,6 +255,16 @@ public class DXTFlipper { } retImg.put(alphaBlock); } + + img.get(colorBlock); + if (type == 4 || type == 5) + flipDXT5Block(colorBlock, h); + else + flipDXT1orDXTA3Block(colorBlock, h); + + // write block (no need to flip block indexes, only pixels + // inside block + retImg.put(colorBlock); } retImg.rewind(); }else if (h >= 4){ From 0a3e9a434e84e8c264b4fd143db011d2df67fcdf Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Sat, 25 Apr 2015 23:09:11 -0400 Subject: [PATCH 033/113] Image: treat setMipMapSizes as a request to generate mips --- jme3-core/src/main/java/com/jme3/texture/Image.java | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/jme3-core/src/main/java/com/jme3/texture/Image.java b/jme3-core/src/main/java/com/jme3/texture/Image.java index 4225da7d3..96ab62819 100644 --- a/jme3-core/src/main/java/com/jme3/texture/Image.java +++ b/jme3-core/src/main/java/com/jme3/texture/Image.java @@ -791,8 +791,8 @@ public class Image extends NativeObject implements Savable /*, Cloneable*/ { needGeneratedMips = false; mipsWereGenerated = false; } else { - needGeneratedMips = false; - mipsWereGenerated = true; + needGeneratedMips = true; + mipsWereGenerated = false; } setUpdateNeeded(); From 5cf6b0c9a63229b1dee5ab31821b3bd2bd913386 Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Sat, 25 Apr 2015 23:09:58 -0400 Subject: [PATCH 034/113] LwjglContext: add custom handler for GL debug messages --- .../com/jme3/system/lwjgl/LwjglContext.java | 2 +- .../lwjgl/LwjglGLDebugOutputHandler.java | 78 +++++++++++++++++++ 2 files changed, 79 insertions(+), 1 deletion(-) create mode 100644 jme3-lwjgl/src/main/java/com/jme3/system/lwjgl/LwjglGLDebugOutputHandler.java diff --git a/jme3-lwjgl/src/main/java/com/jme3/system/lwjgl/LwjglContext.java b/jme3-lwjgl/src/main/java/com/jme3/system/lwjgl/LwjglContext.java index 27e36d78f..c88f7b734 100644 --- a/jme3-lwjgl/src/main/java/com/jme3/system/lwjgl/LwjglContext.java +++ b/jme3-lwjgl/src/main/java/com/jme3/system/lwjgl/LwjglContext.java @@ -245,7 +245,7 @@ public abstract class LwjglContext implements JmeContext { } if (GLContext.getCapabilities().GL_ARB_debug_output && settings.getBoolean("GraphicsDebug")) { - ARBDebugOutput.glDebugMessageCallbackARB(new ARBDebugOutputCallback()); + ARBDebugOutput.glDebugMessageCallbackARB(new ARBDebugOutputCallback(new LwjglGLDebugOutputHandler())); } renderer.setMainFrameBufferSrgb(settings.getGammaCorrection()); diff --git a/jme3-lwjgl/src/main/java/com/jme3/system/lwjgl/LwjglGLDebugOutputHandler.java b/jme3-lwjgl/src/main/java/com/jme3/system/lwjgl/LwjglGLDebugOutputHandler.java new file mode 100644 index 000000000..c8f329f13 --- /dev/null +++ b/jme3-lwjgl/src/main/java/com/jme3/system/lwjgl/LwjglGLDebugOutputHandler.java @@ -0,0 +1,78 @@ +/* + * Copyright (c) 2009-2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ +package com.jme3.system.lwjgl; + +import java.util.HashMap; +import org.lwjgl.opengl.ARBDebugOutput; +import org.lwjgl.opengl.ARBDebugOutputCallback; + +class LwjglGLDebugOutputHandler implements ARBDebugOutputCallback.Handler { + + private static final HashMap constMap = new HashMap(); + private static final String MESSAGE_FORMAT = + "[JME3] OpenGL debug message\r\n" + + " ID: %d\r\n" + + " Source: %s\r\n" + + " Type: %s\r\n" + + " Severity: %s\r\n" + + " Message: %s"; + + static { + constMap.put(ARBDebugOutput.GL_DEBUG_SOURCE_API_ARB, "API"); + constMap.put(ARBDebugOutput.GL_DEBUG_SOURCE_APPLICATION_ARB, "APPLICATION"); + constMap.put(ARBDebugOutput.GL_DEBUG_SOURCE_OTHER_ARB, "OTHER"); + constMap.put(ARBDebugOutput.GL_DEBUG_SOURCE_SHADER_COMPILER_ARB, "SHADER_COMPILER"); + constMap.put(ARBDebugOutput.GL_DEBUG_SOURCE_THIRD_PARTY_ARB, "THIRD_PARTY"); + constMap.put(ARBDebugOutput.GL_DEBUG_SOURCE_WINDOW_SYSTEM_ARB, "WINDOW_SYSTEM"); + + constMap.put(ARBDebugOutput.GL_DEBUG_TYPE_DEPRECATED_BEHAVIOR_ARB, "DEPRECATED_BEHAVIOR"); + constMap.put(ARBDebugOutput.GL_DEBUG_TYPE_ERROR_ARB, "ERROR"); + constMap.put(ARBDebugOutput.GL_DEBUG_TYPE_OTHER_ARB, "OTHER"); + constMap.put(ARBDebugOutput.GL_DEBUG_TYPE_PERFORMANCE_ARB, "PERFORMANCE"); + constMap.put(ARBDebugOutput.GL_DEBUG_TYPE_PORTABILITY_ARB, "PORTABILITY"); + constMap.put(ARBDebugOutput.GL_DEBUG_TYPE_UNDEFINED_BEHAVIOR_ARB, "UNDEFINED_BEHAVIOR"); + + constMap.put(ARBDebugOutput.GL_DEBUG_SEVERITY_HIGH_ARB, "HIGH"); + constMap.put(ARBDebugOutput.GL_DEBUG_SEVERITY_MEDIUM_ARB, "MEDIUM"); + constMap.put(ARBDebugOutput.GL_DEBUG_SEVERITY_LOW_ARB, "LOW"); + } + + @Override + public void handleMessage(int source, int type, int id, int severity, String message) { + String sourceStr = constMap.get(source); + String typeStr = constMap.get(type); + String severityStr = constMap.get(severity); + + System.err.println(String.format(MESSAGE_FORMAT, id, sourceStr, typeStr, severityStr, message)); + } + +} From 0c846eaf6a9283ac0957c58605249c5299c66c29 Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Sat, 25 Apr 2015 23:11:10 -0400 Subject: [PATCH 035/113] SPLighting: fix syntax errors with vertex lighting + color ramp --- .../resources/Common/MatDefs/Light/SPLighting.vert | 13 ++++++++----- 1 file changed, 8 insertions(+), 5 deletions(-) diff --git a/jme3-core/src/main/resources/Common/MatDefs/Light/SPLighting.vert b/jme3-core/src/main/resources/Common/MatDefs/Light/SPLighting.vert index 62b206b7e..6ad224d9b 100644 --- a/jme3-core/src/main/resources/Common/MatDefs/Light/SPLighting.vert +++ b/jme3-core/src/main/resources/Common/MatDefs/Light/SPLighting.vert @@ -45,6 +45,9 @@ attribute vec3 inNormal; #else varying vec3 specularAccum; varying vec4 diffuseAccum; + #ifdef COLORRAMP + uniform sampler2D m_ColorRamp; + #endif #endif #ifdef USE_REFLECTION @@ -160,14 +163,14 @@ void main(){ #if __VERSION__ >= 110 } #endif - vec2 v = computeLighting(wvNormal, viewDir, lightDir.xyz, lightDir.w * spotFallOff, m_Shininess); + vec2 light = computeLighting(wvNormal, viewDir, lightDir.xyz, lightDir.w * spotFallOff, m_Shininess); #ifdef COLORRAMP - diffuseAccum += texture2D(m_ColorRamp, vec2(light.x, 0.0)).rgb * diffuseColor; - specularAccum += texture2D(m_ColorRamp, vec2(light.y, 0.0)).rgb * specularColor; + diffuseAccum.rgb += texture2D(m_ColorRamp, vec2(light.x, 0.0)).rgb * diffuseColor.rgb; + specularAccum.rgb += texture2D(m_ColorRamp, vec2(light.y, 0.0)).rgb * specularColor; #else - diffuseAccum += v.x * diffuseColor; - specularAccum += v.y * specularColor; + diffuseAccum.rgb += light.x * diffuseColor.rgb; + specularAccum.rgb += light.y * specularColor; #endif } #endif From 1fec72605f6927f47143146b1047c8d5c60ea94c Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Sat, 25 Apr 2015 23:13:20 -0400 Subject: [PATCH 036/113] SPLighting.frag: fix syntax error with vertex lighting enabled --- .../Common/MatDefs/Light/SPLighting.frag | 20 ++++++++++--------- 1 file changed, 11 insertions(+), 9 deletions(-) diff --git a/jme3-core/src/main/resources/Common/MatDefs/Light/SPLighting.frag b/jme3-core/src/main/resources/Common/MatDefs/Light/SPLighting.frag index 5d207cf83..26b68a533 100644 --- a/jme3-core/src/main/resources/Common/MatDefs/Light/SPLighting.frag +++ b/jme3-core/src/main/resources/Common/MatDefs/Light/SPLighting.frag @@ -72,17 +72,19 @@ uniform float m_Shininess; #endif void main(){ - #ifdef NORMALMAP - mat3 tbnMat = mat3(normalize(vTangent.xyz) , normalize(vBinormal.xyz) , normalize(vNormal.xyz)); + #if !defined(VERTEX_LIGHTING) + #if defined(NORMALMAP) + mat3 tbnMat = mat3(normalize(vTangent.xyz) , normalize(vBinormal.xyz) , normalize(vNormal.xyz)); - if (!gl_FrontFacing) - { - tbnMat[2] = -tbnMat[2]; - } + if (!gl_FrontFacing) + { + tbnMat[2] = -tbnMat[2]; + } - vec3 viewDir = normalize(-vPos.xyz * tbnMat); - #else - vec3 viewDir = normalize(-vPos.xyz); + vec3 viewDir = normalize(-vPos.xyz * tbnMat); + #else + vec3 viewDir = normalize(-vPos.xyz); + #endif #endif vec2 newTexCoord; From c9eaeeea12f68e5d88e4142cc0c9ac51f88ef5ff Mon Sep 17 00:00:00 2001 From: Paul Speed Date: Sat, 25 Apr 2015 23:47:26 -0400 Subject: [PATCH 037/113] Added some message delegator util classes that makes it easier to handle network messages. These delegators can introspect a delegate type to find message-type specific handler methods. This mapping can be done automatically or performed manually. --- .../util/AbstractMessageDelegator.java | 313 ++++++++++++++++++ .../network/util/ObjectMessageDelegator.java | 72 ++++ .../network/util/SessionDataDelegator.java | 103 ++++++ 3 files changed, 488 insertions(+) create mode 100644 jme3-networking/src/main/java/com/jme3/network/util/AbstractMessageDelegator.java create mode 100644 jme3-networking/src/main/java/com/jme3/network/util/ObjectMessageDelegator.java create mode 100644 jme3-networking/src/main/java/com/jme3/network/util/SessionDataDelegator.java diff --git a/jme3-networking/src/main/java/com/jme3/network/util/AbstractMessageDelegator.java b/jme3-networking/src/main/java/com/jme3/network/util/AbstractMessageDelegator.java new file mode 100644 index 000000000..b077f9e01 --- /dev/null +++ b/jme3-networking/src/main/java/com/jme3/network/util/AbstractMessageDelegator.java @@ -0,0 +1,313 @@ +/* + * Copyright (c) 2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ + +package com.jme3.network.util; + +import com.jme3.network.Message; +import com.jme3.network.MessageConnection; +import com.jme3.network.MessageListener; +import java.lang.reflect.InvocationTargetException; +import java.lang.reflect.Method; +import java.util.Arrays; +import java.util.HashMap; +import java.util.HashSet; +import java.util.Map; +import java.util.Set; +import java.util.logging.Level; +import java.util.logging.Logger; + + +/** + * A MessageListener implementation that will forward messages to methods + * of a delegate object. These methods can be automapped or manually + * specified. Subclasses provide specific implementations for how to + * find the actual delegate object. + * + * @author Paul Speed + */ +public abstract class AbstractMessageDelegator + implements MessageListener { + + static final Logger log = Logger.getLogger(AbstractMessageDelegator.class.getName()); + + private Class delegateType; + private Map methods = new HashMap(); + private Class[] messageTypes; + + /** + * Creates an AbstractMessageDelegator that will forward received + * messages to methods of the specified delegate type. If automap + * is true then reflection is used to lookup probably message handling + * methods. + */ + protected AbstractMessageDelegator( Class delegateType, boolean automap ) { + this.delegateType = delegateType; + if( automap ) { + automap(); + } + } + + /** + * Returns the array of messages known to be handled by this message + * delegator. + */ + public Class[] getMessageTypes() { + if( messageTypes == null ) { + messageTypes = methods.keySet().toArray(new Class[methods.size()]); + } + return messageTypes; + } + + /** + * Returns true if the specified method is valid for the specified + * message type. This is used internally during automapping to + * provide implementation specific filting of methods. + * This implementation checks for methods that take either no + * arguments, the connection and message type arguments (in that order), + * or just the message type or connection argument. + */ + protected boolean isValidMethod( Method m, Class messageType ) { + + if( log.isLoggable(Level.FINEST) ) { + log.log(Level.FINEST, "isValidMethod({0}, {1})", new Object[]{m, messageType}); + } + + // Parameters must be S and message type or just message type + Class[] parms = m.getParameterTypes(); + if( parms.length != 2 && parms.length != 1 ) { + log.finest("Parameter count is not 1 or 2"); + return false; + } + int connectionIndex = parms.length > 1 ? 0 : -1; + int messageIndex = parms.length > 1 ? 1 : 0; + + if( connectionIndex > 0 && !MessageConnection.class.isAssignableFrom(parms[connectionIndex]) ) { + log.finest("First paramter is not a MessageConnection or subclass."); + return false; + } + + if( messageType == null && !Message.class.isAssignableFrom(parms[messageIndex]) ) { + log.finest("Second paramter is not a Message or subclass."); + return false; + } + if( messageType != null && !parms[messageIndex].isAssignableFrom(messageType) ) { + log.log(Level.FINEST, "Second paramter is not a {0}", messageType); + return false; + } + return true; + } + + /** + * Convenience method that returns the message type as + * reflecively determined for a particular method. This + * only works with methods that actually have arguments. + * This implementation returns the last element of the method's + * getParameterTypes() array, thus supporting both + * method(connection, messageType) as well as just method(messageType) + * calling forms. + */ + protected Class getMessageType( Method m ) { + Class[] parms = m.getParameterTypes(); + return parms[parms.length-1]; + } + + /** + * Goes through all of the delegate type's methods to find + * a method of the specified name that may take the specified + * message type. + */ + protected Method findDelegate( String name, Class messageType ) { + // We do an exhaustive search because it's easier to + // check for a variety of parameter types and it's all + // that Class would be doing in getMethod() anyway. + for( Method m : delegateType.getDeclaredMethods() ) { + + if( !m.getName().equals(name) ) { + continue; + } + + if( isValidMethod(m, messageType) ) { + return m; + } + } + + return null; + } + + /** + * Returns true if the specified method name is allowed. + * This is used by automapping to determine if a method + * should be rejected purely on name. Default implemention + * always returns true. + */ + protected boolean allowName( String name ) { + return true; + } + + /** + * Calls the map(Set) method with a null argument causing + * all available matching methods to mapped to message types. + */ + protected final void automap() { + map((Set)null); + if( methods.isEmpty() ) { + throw new RuntimeException("No message handling methods found for class:" + delegateType); + } + } + + /** + * Specifically maps the specified methods names, autowiring + * the parameters. + */ + public AbstractMessageDelegator map( String... methodNames ) { + Set names = new HashSet( Arrays.asList(methodNames) ); + map(names); + return this; + } + + /** + * Goes through all of the delegate type's declared methods + * mapping methods that match the current constraints. + * If the constraints set is null then allowName() is + * checked for names otherwise only names in the constraints + * set are allowed. + * For each candidate method that passes the above checks, + * isValidMethod() is called with a null message type argument. + * All methods are made accessible thus supporting non-public + * methods as well as public methods. + */ + protected void map( Set constraints ) { + + if( log.isLoggable(Level.FINEST) ) { + log.log(Level.FINEST, "map({0})", constraints); + } + for( Method m : delegateType.getDeclaredMethods() ) { + if( log.isLoggable(Level.FINEST) ) { + log.log(Level.FINEST, "Checking method:{0}", m); + } + + if( constraints == null && !allowName(m.getName()) ) { + log.finest("Name is not allowed."); + continue; + } + if( constraints != null && !constraints.contains(m.getName()) ) { + log.finest("Name is not in constraints set."); + continue; + } + + if( isValidMethod(m, null) ) { + if( log.isLoggable(Level.FINEST) ) { + log.log(Level.FINEST, "Adding method mapping:{0} = {1}", new Object[]{getMessageType(m), m}); + } + // Make sure we can access the method even if it's not public or + // is in a non-public inner class. + m.setAccessible(true); + methods.put(getMessageType(m), m); + } + } + + messageTypes = null; + } + + /** + * Manually maps a specified method to the specified message type. + */ + public AbstractMessageDelegator map( Class messageType, String methodName ) { + // Lookup the method + Method m = findDelegate( methodName, messageType ); + if( m == null ) { + throw new RuntimeException( "Method:" + methodName + + " not found matching signature (MessageConnection, " + + messageType.getName() + ")" ); + } + + if( log.isLoggable(Level.FINEST) ) { + log.log(Level.FINEST, "Adding method mapping:{0} = {1}", new Object[]{messageType, m}); + } + methods.put( messageType, m ); + messageTypes = null; + return this; + } + + /** + * Returns the mapped method for the specified message type. + */ + protected Method getMethod( Class c ) { + Method m = methods.get(c); + return m; + } + + /** + * Implemented by subclasses to provide the actual delegate object + * against which the mapped message type methods will be called. + */ + protected abstract Object getSourceDelegate( S source ); + + /** + * Implementation of the MessageListener's messageReceived() + * method that will use the current message type mapping to + * find an appropriate message handling method and call it + * on the delegate returned by getSourceDelegate(). + */ + @Override + public void messageReceived( S source, Message msg ) { + if( msg == null ) { + return; + } + + Object delegate = getSourceDelegate(source); + if( delegate == null ) { + // Means ignore this message/source + return; + } + + Method m = getMethod(msg.getClass()); + if( m == null ) { + throw new RuntimeException("Delegate method not found for message class:" + + msg.getClass()); + } + + try { + if( m.getParameterTypes().length > 1 ) { + m.invoke( delegate, source, msg ); + } else { + m.invoke( delegate, msg ); + } + } catch( IllegalAccessException e ) { + throw new RuntimeException("Error executing:" + m, e); + } catch( InvocationTargetException e ) { + throw new RuntimeException("Error executing:" + m, e.getCause()); + } + } +} + + diff --git a/jme3-networking/src/main/java/com/jme3/network/util/ObjectMessageDelegator.java b/jme3-networking/src/main/java/com/jme3/network/util/ObjectMessageDelegator.java new file mode 100644 index 000000000..b92ee09a8 --- /dev/null +++ b/jme3-networking/src/main/java/com/jme3/network/util/ObjectMessageDelegator.java @@ -0,0 +1,72 @@ +/* + * Copyright (c) 2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ + +package com.jme3.network.util; + +import com.jme3.network.MessageConnection; + + +/** + * A MessageListener implementation that will forward messages to methods + * of a specified delegate object. These methods can be automapped or manually + * specified. + * + * @author Paul Speed + */ +public class ObjectMessageDelegator extends AbstractMessageDelegator { + + private Object delegate; + + /** + * Creates a MessageListener that will forward mapped message types + * to methods of the specified object. + * If automap is true then all methods with the proper signature will + * be mapped. + *

Methods of the following signatures are allowed: + *

    + *
  • void someName(S conn, SomeMessage msg) + *
  • void someName(Message msg) + *
+ * Where S is the type of MessageConnection and SomeMessage is some + * specific concreate Message subclass. + */ + public ObjectMessageDelegator( Object delegate, boolean automap ) { + super(delegate.getClass(), automap); + this.delegate = delegate; + } + + @Override + protected Object getSourceDelegate( MessageConnection source ) { + return delegate; + } +} + diff --git a/jme3-networking/src/main/java/com/jme3/network/util/SessionDataDelegator.java b/jme3-networking/src/main/java/com/jme3/network/util/SessionDataDelegator.java new file mode 100644 index 000000000..f2bee3373 --- /dev/null +++ b/jme3-networking/src/main/java/com/jme3/network/util/SessionDataDelegator.java @@ -0,0 +1,103 @@ +/* + * Copyright (c) 2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ + +package com.jme3.network.util; + +import com.jme3.network.HostedConnection; +import java.util.logging.Level; +import java.util.logging.Logger; + + +/** + * A MessageListener implementation that will forward messages to methods + * of a delegate specified as a HostedConnection session attribute. This is + * useful for handling connection-specific messages from clients that must + * delegate to client-specific data objects. + * The delegate methods can be automapped or manually specified. + * + * @author Paul Speed + */ +public class SessionDataDelegator extends AbstractMessageDelegator { + + static final Logger log = Logger.getLogger(SessionDataDelegator.class.getName()); + + private String attributeName; + + /** + * Creates a MessageListener that will forward mapped message types + * to methods of an object specified as a HostedConnection attribute. + * If automap is true then all methods with the proper signature will + * be mapped. + *

Methods of the following signatures are allowed: + *

    + *
  • void someName(S conn, SomeMessage msg) + *
  • void someName(Message msg) + *
+ * Where S is the type of MessageConnection and SomeMessage is some + * specific concreate Message subclass. + */ + public SessionDataDelegator( Class delegateType, String attributeName, boolean automap ) { + super(delegateType, automap); + this.attributeName = attributeName; + } + + /** + * Returns the attribute name that will be used to look up the + * delegate object. + */ + public String getAttributeName() { + return attributeName; + } + + /** + * Called internally when there is no session object + * for the current attribute name attached to the passed source + * HostConnection. Default implementation logs a warning. + */ + protected void miss( HostedConnection source ) { + log.log(Level.WARNING, "Session data is null for:{0} on connection:{1}", new Object[]{attributeName, source}); + } + + /** + * Returns the attributeName attribute of the supplied source + * HostConnection. If there is no value at that attribute then + * the miss() method is called. + */ + protected Object getSourceDelegate( HostedConnection source ) { + Object result = source.getAttribute(attributeName); + if( result == null ) { + miss(source); + } + return result; + } +} + From 9abedf284e5047d5b13ef3df6f230c10d0ab271a Mon Sep 17 00:00:00 2001 From: Paul Speed Date: Sun, 26 Apr 2015 00:09:24 -0400 Subject: [PATCH 038/113] Added a message that can be used to compile and send the serializer registry... and then register them on the other end. --- .../SerializerRegistrationsMessage.java | 188 ++++++++++++++++++ 1 file changed, 188 insertions(+) create mode 100644 jme3-networking/src/main/java/com/jme3/network/message/SerializerRegistrationsMessage.java diff --git a/jme3-networking/src/main/java/com/jme3/network/message/SerializerRegistrationsMessage.java b/jme3-networking/src/main/java/com/jme3/network/message/SerializerRegistrationsMessage.java new file mode 100644 index 000000000..da7f2a7cf --- /dev/null +++ b/jme3-networking/src/main/java/com/jme3/network/message/SerializerRegistrationsMessage.java @@ -0,0 +1,188 @@ +/* + * $Id: SerializerRegistrationsMessage.java 3829 2014-11-24 07:25:43Z pspeed $ + * + * Copyright (c) 2012, Paul Speed + * All rights reserved. + */ + +package com.jme3.network.message; + +import com.jme3.network.AbstractMessage; +import com.jme3.network.serializing.Serializable; +import com.jme3.network.serializing.Serializer; +import com.jme3.network.serializing.SerializerRegistration; +import com.jme3.network.serializing.serializers.FieldSerializer; +import java.util.*; +import java.util.jar.Attributes; +import java.util.logging.Level; +import java.util.logging.Logger; + + +/** + * Holds a compiled set of message registration information that + * can be sent over the wire. The received message can then be + * used to register all of the classes using the same IDs and + * same ordering, etc.. The intent is that the server compiles + * this message once it is sure that all serializable classes have + * been registered. It can then send this to each new client and + * they can use it to register all of the classes without requiring + * exactly reproducing the same calls that the server did to register + * messages. + * + *

Normally, JME recommends that apps have a common utility method + * that they call on both client and server. However, this makes + * pluggable services nearly impossible as some central class has to + * know about all registered serializers. This message implementation + * gets around by only requiring registration on the server.

+ * + * @author Paul Speed + */ +@Serializable +public class SerializerRegistrationsMessage extends AbstractMessage { + + static final Logger log = Logger.getLogger(SerializerRegistrationsMessage.class.getName()); + + public static final Set ignore = new HashSet(); + static { + // We could build this automatically but then we + // risk making a client and server out of date simply because + // their JME versions are out of date. + ignore.add(Boolean.class); + ignore.add(Float.class); + ignore.add(Boolean.class); + ignore.add(Byte.class); + ignore.add(Character.class); + ignore.add(Short.class); + ignore.add(Integer.class); + ignore.add(Long.class); + ignore.add(Float.class); + ignore.add(Double.class); + ignore.add(String.class); + + ignore.add(DisconnectMessage.class); + ignore.add(ClientRegistrationMessage.class); + + ignore.add(Date.class); + ignore.add(AbstractCollection.class); + ignore.add(AbstractList.class); + ignore.add(AbstractSet.class); + ignore.add(ArrayList.class); + ignore.add(HashSet.class); + ignore.add(LinkedHashSet.class); + ignore.add(LinkedList.class); + ignore.add(TreeSet.class); + ignore.add(Vector.class); + ignore.add(AbstractMap.class); + ignore.add(Attributes.class); + ignore.add(HashMap.class); + ignore.add(Hashtable.class); + ignore.add(IdentityHashMap.class); + ignore.add(TreeMap.class); + ignore.add(WeakHashMap.class); + ignore.add(Enum.class); + + ignore.add(GZIPCompressedMessage.class); + ignore.add(ZIPCompressedMessage.class); + + ignore.add(ChannelInfoMessage.class); + + ignore.add(SerializerRegistrationsMessage.class); + ignore.add(SerializerRegistrationsMessage.Registration.class); + } + + public static SerializerRegistrationsMessage INSTANCE; + public static Registration[] compiled; + private static final Serializer fieldSerializer = new FieldSerializer(); + + private Registration[] registrations; + + public SerializerRegistrationsMessage() { + setReliable(true); + } + + public SerializerRegistrationsMessage( Registration... registrations ) { + setReliable(true); + this.registrations = registrations; + } + + public static void compile() { + + // Let's just see what they are here + List list = new ArrayList(); + for( SerializerRegistration reg : Serializer.getSerializerRegistrations() ) { + Class type = reg.getType(); + if( ignore.contains(type) ) + continue; + if( type.isPrimitive() ) + continue; + + list.add(new Registration(reg)); + } + + if( log.isLoggable(Level.FINE) ) { + log.log( Level.FINE, "Number of registered classes:{0}", list.size()); + for( Registration reg : list ) { + log.log( Level.FINE, " {0}", reg); + } + } + compiled = list.toArray(new Registration[list.size()]); + + INSTANCE = new SerializerRegistrationsMessage(compiled); + } + + public void registerAll() { + for( Registration reg : registrations ) { + log.log( Level.INFO, "Registering:{0}", reg); + reg.register(); + } + } + + @Serializable + public static final class Registration { + + private short id; + private String className; + private String serializerClassName; + + public Registration() { + } + + public Registration( SerializerRegistration reg ) { + + this.id = reg.getId(); + this.className = reg.getType().getName(); + if( reg.getSerializer().getClass() != FieldSerializer.class ) { + this.serializerClassName = reg.getSerializer().getClass().getName(); + } + } + + public void register() { + try { + Class type = Class.forName(className); + Serializer serializer; + if( serializerClassName == null ) { + serializer = fieldSerializer; + } else { + Class serializerType = Class.forName(serializerClassName); + serializer = (Serializer)serializerType.newInstance(); + } + SerializerRegistration result = Serializer.registerClassForId(id, type, serializer); + log.log( Level.FINE, " result:{0}", result); + } catch( ClassNotFoundException e ) { + throw new RuntimeException( "Class not found attempting to register:" + this, e ); + } catch( InstantiationException e ) { + throw new RuntimeException( "Error instantiating serializer registering:" + this, e ); + } catch( IllegalAccessException e ) { + throw new RuntimeException( "Error instantiating serializer registering:" + this, e ); + } + } + + @Override + public String toString() { + return "Registration[" + id + " = " + className + ", serializer=" + serializerClassName + "]"; + } + } +} + + + From 1eb2ba72768b355eb4ff6fa6b128be849dea5ef2 Mon Sep 17 00:00:00 2001 From: Paul Speed Date: Sun, 26 Apr 2015 00:24:51 -0400 Subject: [PATCH 039/113] Adding an initial implementation for a service manager module with custom subclasses and service interfaces for client services and server-side services (HostedServices). This code is a copy and refactoring of code I developed for Mythruna... it worked there but I haven't tested it yet in its new form. Things may change as I integrate this more closely with the core Client and Server classes. I wanted to get it into source control first. Also included an RPC service implementation which can serve as the underpinning for other things. Coming soon: serializer registration service and a simple RMI service based on the RPC layer. --- .../service/AbstractClientService.java | 51 ++++ .../service/AbstractHostedService.java | 70 +++++ .../jme3/network/service/AbstractService.java | 111 ++++++++ .../jme3/network/service/ClientService.java | 72 +++++ .../network/service/ClientServiceManager.java | 87 ++++++ .../jme3/network/service/HostedService.java | 74 ++++++ .../network/service/HostedServiceManager.java | 127 +++++++++ .../com/jme3/network/service/Service.java | 67 +++++ .../jme3/network/service/ServiceManager.java | 160 ++++++++++++ .../network/service/rpc/RpcClientService.java | 123 +++++++++ .../network/service/rpc/RpcConnection.java | 247 ++++++++++++++++++ .../jme3/network/service/rpc/RpcHandler.java | 52 ++++ .../network/service/rpc/RpcHostedService.java | 227 ++++++++++++++++ .../service/rpc/msg/RpcCallMessage.java | 98 +++++++ .../service/rpc/msg/RpcResponseMessage.java | 89 +++++++ 15 files changed, 1655 insertions(+) create mode 100644 jme3-networking/src/main/java/com/jme3/network/service/AbstractClientService.java create mode 100644 jme3-networking/src/main/java/com/jme3/network/service/AbstractHostedService.java create mode 100644 jme3-networking/src/main/java/com/jme3/network/service/AbstractService.java create mode 100644 jme3-networking/src/main/java/com/jme3/network/service/ClientService.java create mode 100644 jme3-networking/src/main/java/com/jme3/network/service/ClientServiceManager.java create mode 100644 jme3-networking/src/main/java/com/jme3/network/service/HostedService.java create mode 100644 jme3-networking/src/main/java/com/jme3/network/service/HostedServiceManager.java create mode 100644 jme3-networking/src/main/java/com/jme3/network/service/Service.java create mode 100644 jme3-networking/src/main/java/com/jme3/network/service/ServiceManager.java create mode 100644 jme3-networking/src/main/java/com/jme3/network/service/rpc/RpcClientService.java create mode 100644 jme3-networking/src/main/java/com/jme3/network/service/rpc/RpcConnection.java create mode 100644 jme3-networking/src/main/java/com/jme3/network/service/rpc/RpcHandler.java create mode 100644 jme3-networking/src/main/java/com/jme3/network/service/rpc/RpcHostedService.java create mode 100644 jme3-networking/src/main/java/com/jme3/network/service/rpc/msg/RpcCallMessage.java create mode 100644 jme3-networking/src/main/java/com/jme3/network/service/rpc/msg/RpcResponseMessage.java diff --git a/jme3-networking/src/main/java/com/jme3/network/service/AbstractClientService.java b/jme3-networking/src/main/java/com/jme3/network/service/AbstractClientService.java new file mode 100644 index 000000000..bd1836451 --- /dev/null +++ b/jme3-networking/src/main/java/com/jme3/network/service/AbstractClientService.java @@ -0,0 +1,51 @@ +/* + * Copyright (c) 2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ + +package com.jme3.network.service; + + +/** + * Convenient base class for ClientServices providing some default ClientService + * interface implementations as well as a few convenience methods + * such as getServiceManager() and getService(type). Subclasses + * must at least override the onInitialize() method to handle + * service initialization. + * + * @author Paul Speed + */ +public abstract class AbstractClientService extends AbstractService + implements ClientService { + + protected AbstractClientService() { + } + +} diff --git a/jme3-networking/src/main/java/com/jme3/network/service/AbstractHostedService.java b/jme3-networking/src/main/java/com/jme3/network/service/AbstractHostedService.java new file mode 100644 index 000000000..789767b73 --- /dev/null +++ b/jme3-networking/src/main/java/com/jme3/network/service/AbstractHostedService.java @@ -0,0 +1,70 @@ +/* + * Copyright (c) 2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ + +package com.jme3.network.service; + +import com.jme3.network.HostedConnection; +import com.jme3.network.Server; + + +/** + * Convenient base class for HostedServices providing some default HostedService + * interface implementations as well as a few convenience methods + * such as getServiceManager() and getService(type). Subclasses + * must at least override the onInitialize() method to handle + * service initialization. + * + * @author Paul Speed + */ +public abstract class AbstractHostedService extends AbstractService + implements HostedService { + + protected AbstractHostedService() { + } + + /** + * Default implementation does nothing. Implementations can + * override this to peform custom new connection behavior. + */ + @Override + public void connectionAdded(Server server, HostedConnection hc) { + } + + /** + * Default implementation does nothing. Implementations can + * override this to peform custom leaving connection behavior. + */ + @Override + public void connectionRemoved(Server server, HostedConnection hc) { + } + +} diff --git a/jme3-networking/src/main/java/com/jme3/network/service/AbstractService.java b/jme3-networking/src/main/java/com/jme3/network/service/AbstractService.java new file mode 100644 index 000000000..84df3d81b --- /dev/null +++ b/jme3-networking/src/main/java/com/jme3/network/service/AbstractService.java @@ -0,0 +1,111 @@ +/* + * Copyright (c) 2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ + +package com.jme3.network.service; + + +/** + * Base class providing some default Service interface implementations + * as well as a few convenience methods such as getServiceManager() + * and getService(type). Subclasses must at least override the + * onInitialize() method to handle service initialization. + * + * @author Paul Speed + */ +public abstract class AbstractService implements Service { + + private S serviceManager; + + protected AbstractService() { + } + + /** + * Returns the ServiceManager that was passed to + * initialize() during service initialization. + */ + protected S getServiceManager() { + return serviceManager; + } + + /** + * Retrieves the first sibling service of the specified + * type. + */ + protected > T getService( Class type ) { + return type.cast(serviceManager.getService(type)); + } + + /** + * Initializes this service by keeping a reference to + * the service manager and calling onInitialize(). + */ + @Override + public final void initialize( S serviceManager ) { + this.serviceManager = serviceManager; + onInitialize(serviceManager); + } + + /** + * Called during initialize() for the subclass to perform + * implementation specific initialization. + */ + protected abstract void onInitialize( S serviceManager ); + + /** + * Default implementation does nothing. Implementations can + * override this to peform custom startup behavior. + */ + @Override + public void start() { + } + + /** + * Default implementation does nothing. Implementations can + * override this to peform custom stop behavior. + */ + @Override + public void stop() { + } + + /** + * Default implementation does nothing. Implementations can + * override this to peform custom termination behavior. + */ + @Override + public void terminate( S serviceManager ) { + } + + @Override + public String toString() { + return getClass().getName() + "[serviceManager=" + serviceManager + "]"; + } +} diff --git a/jme3-networking/src/main/java/com/jme3/network/service/ClientService.java b/jme3-networking/src/main/java/com/jme3/network/service/ClientService.java new file mode 100644 index 000000000..c8057cb31 --- /dev/null +++ b/jme3-networking/src/main/java/com/jme3/network/service/ClientService.java @@ -0,0 +1,72 @@ +/* + * Copyright (c) 2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ + +package com.jme3.network.service; + + +/** + * Interface implemented by Client-side services that augment + * a network Client's functionality. + * + * @author Paul Speed + */ +public interface ClientService extends Service { + + /** + * Called when the service is first attached to the service + * manager. + */ + @Override + public void initialize( ClientServiceManager serviceManager ); + + /** + * Called when the service manager is started or if the + * service is added to an already started service manager. + */ + @Override + public void start(); + + /** + * Called when the service is shutting down. All services + * are stopped and any service manager resources are closed + * before the services are terminated. + */ + @Override + public void stop(); + + /** + * The service manager is fully shutting down. All services + * have been stopped and related connections closed. + */ + @Override + public void terminate( ClientServiceManager serviceManager ); +} diff --git a/jme3-networking/src/main/java/com/jme3/network/service/ClientServiceManager.java b/jme3-networking/src/main/java/com/jme3/network/service/ClientServiceManager.java new file mode 100644 index 000000000..df8957201 --- /dev/null +++ b/jme3-networking/src/main/java/com/jme3/network/service/ClientServiceManager.java @@ -0,0 +1,87 @@ +/* + * Copyright (c) 2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ + +package com.jme3.network.service; + +import com.jme3.network.Client; + + +/** + * Manages ClientServices on behalf of a network Client object. + * + * @author Paul Speed + */ +public class ClientServiceManager extends ServiceManager { + + private Client client; + + /** + * Creates a new ClientServiceManager for the specified network Client. + */ + public ClientServiceManager( Client client ) { + this.client = client; + } + + /** + * Returns the network Client associated with this ClientServiceManager. + */ + public Client getClient() { + return client; + } + + /** + * Returns 'this' and is what is passed to ClientService.initialize() + * and ClientService.termnate(); + */ + @Override + protected final ClientServiceManager getParent() { + return this; + } + + /** + * Adds the specified ClientService and initializes it. If the service manager + * has already been started then the service will also be started. + */ + public void addService( ClientService s ) { + super.addService(s); + } + + /** + * Removes the specified ClientService from this service manager, stopping + * and terminating it as required. If this service manager is in a + * started state then the service will be stopped. After removal, + * the service will be terminated. + */ + public void removeService( ClientService s ) { + super.removeService(s); + } +} diff --git a/jme3-networking/src/main/java/com/jme3/network/service/HostedService.java b/jme3-networking/src/main/java/com/jme3/network/service/HostedService.java new file mode 100644 index 000000000..f522b72d6 --- /dev/null +++ b/jme3-networking/src/main/java/com/jme3/network/service/HostedService.java @@ -0,0 +1,74 @@ +/* + * Copyright (c) 2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ + +package com.jme3.network.service; + +import com.jme3.network.ConnectionListener; + + +/** + * Interface implemented by Server-side services that augment + * a network Server's functionality. + * + * @author Paul Speed + */ +public interface HostedService extends Service, ConnectionListener { + + /** + * Called when the service is first attached to the service + * manager. + */ + @Override + public void initialize( HostedServiceManager serviceManager ); + + /** + * Called when the service manager is started or if the + * service is added to an already started service manager. + */ + @Override + public void start(); + + /** + * Called when the service is shutting down. All services + * are stopped and any service manager resources are closed + * before the services are terminated. + */ + @Override + public void stop(); + + /** + * The service manager is fully shutting down. All services + * have been stopped and related connections closed. + */ + @Override + public void terminate( HostedServiceManager serviceManager ); +} diff --git a/jme3-networking/src/main/java/com/jme3/network/service/HostedServiceManager.java b/jme3-networking/src/main/java/com/jme3/network/service/HostedServiceManager.java new file mode 100644 index 000000000..866357852 --- /dev/null +++ b/jme3-networking/src/main/java/com/jme3/network/service/HostedServiceManager.java @@ -0,0 +1,127 @@ +/* + * Copyright (c) 2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ + +package com.jme3.network.service; + +import com.jme3.network.ConnectionListener; +import com.jme3.network.HostedConnection; +import com.jme3.network.Server; + + +/** + * Manages HostedServices on behalf of a network Server object. + * All HostedServices are automatically informed about new and + * leaving connections. + * + * @author Paul Speed + */ +public class HostedServiceManager extends ServiceManager { + + private Server server; + private ConnectionObserver connectionObserver; + + /** + * Creates a HostedServiceManager for the specified network Server. + */ + public HostedServiceManager( Server server ) { + this.server = server; + this.connectionObserver = new ConnectionObserver(); + server.addConnectionListener(connectionObserver); + } + + /** + * Returns the network Server associated with this HostedServiceManager. + */ + public Server getServer() { + return server; + } + + /** + * Returns 'this' and is what is passed to HostedService.initialize() + * and HostedService.termnate(); + */ + @Override + protected final HostedServiceManager getParent() { + return this; + } + + /** + * Adds the specified HostedService and initializes it. If the service manager + * has already been started then the service will also be started. + */ + public void addService( HostedService s ) { + super.addService(s); + } + + /** + * Removes the specified HostedService from this service manager, stopping + * and terminating it as required. If this service manager is in a + * started state then the service will be stopped. After removal, + * the service will be terminated. + */ + public void removeService( HostedService s ) { + super.removeService(s); + } + + /** + * Called internally when a new connection has been added so that the + * services can be notified. + */ + protected void addConnection( HostedConnection hc ) { + for( Service s : getServices() ) { + ((HostedService)s).connectionAdded(server, hc); + } + } + + /** + * Called internally when a connection has been removed so that the + * services can be notified. + */ + protected void removeConnection( HostedConnection hc ) { + for( Service s : getServices() ) { + ((HostedService)s).connectionRemoved(server, hc); + } + } + + protected class ConnectionObserver implements ConnectionListener { + + @Override + public void connectionAdded(Server server, HostedConnection hc) { + addConnection(hc); + } + + @Override + public void connectionRemoved(Server server, HostedConnection hc) { + removeConnection(hc); + } + } +} diff --git a/jme3-networking/src/main/java/com/jme3/network/service/Service.java b/jme3-networking/src/main/java/com/jme3/network/service/Service.java new file mode 100644 index 000000000..530237cea --- /dev/null +++ b/jme3-networking/src/main/java/com/jme3/network/service/Service.java @@ -0,0 +1,67 @@ +/* + * Copyright (c) 2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ + +package com.jme3.network.service; + + +/** + * The base interface for managed services. + * + * @author Paul Speed + */ +public interface Service { + + /** + * Called when the service is first attached to the service + * manager. + */ + public void initialize( S serviceManager ); + + /** + * Called when the service manager is started or if the + * service is added to an already started service manager. + */ + public void start(); + + /** + * Called when the service is shutting down. All services + * are stopped and any service manager resources are closed + * before the services are terminated. + */ + public void stop(); + + /** + * The service manager is fully shutting down. All services + * have been stopped and related connections closed. + */ + public void terminate( S serviceManager ); +} diff --git a/jme3-networking/src/main/java/com/jme3/network/service/ServiceManager.java b/jme3-networking/src/main/java/com/jme3/network/service/ServiceManager.java new file mode 100644 index 000000000..b8ee7d3c4 --- /dev/null +++ b/jme3-networking/src/main/java/com/jme3/network/service/ServiceManager.java @@ -0,0 +1,160 @@ +/* + * Copyright (c) 2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ + +package com.jme3.network.service; + +import java.util.List; +import java.util.concurrent.CopyOnWriteArrayList; + +/** + * The base service manager class from which the HostedServiceManager + * and ClientServiceManager classes are derived. This manages the + * the underlying services and their life cycles. + * + * @author Paul Speed + */ +public abstract class ServiceManager { + + private List> services = new CopyOnWriteArrayList>(); + private volatile boolean started = false; + + protected ServiceManager() { + } + + /** + * Retreives the 'parent' of this service manager, usually + * a more specifically typed version of 'this' but it can be + * anything the seervices are expecting. + */ + protected abstract T getParent(); + + /** + * Returns the complete list of services managed by this + * service manager. This list is thread safe following the + * CopyOnWriteArrayList semantics. + */ + protected List> getServices() { + return services; + } + + /** + * Starts this service manager and all services that it contains. + * Any services added after the service manager has started will have + * their start() methods called. + */ + public void start() { + if( started ) { + return; + } + for( Service s : services ) { + s.start(); + } + started = true; + } + + /** + * Returns true if this service manager has been started. + */ + public boolean isStarted() { + return started; + } + + /** + * Stops all services and puts the service manager into a stopped state. + */ + public void stop() { + if( !started ) { + throw new IllegalStateException(getClass().getSimpleName() + " not started."); + } + for( Service s : services ) { + s.stop(); + } + started = false; + } + + /** + * Adds the specified service and initializes it. If the service manager + * has already been started then the service will also be started. + */ + public > void addService( S s ) { + services.add(s); + s.initialize(getParent()); + if( started ) { + s.start(); + } + } + + /** + * Removes the specified service from this service manager, stopping + * and terminating it as required. If this service manager is in a + * started state then the service will be stopped. After removal, + * the service will be terminated. + */ + public > void removeService( S s ) { + if( started ) { + s.stop(); + } + services.remove(s); + s.terminate(getParent()); + } + + /** + * Terminates all services. If the service manager has not been + * stopped yet then it will be stopped. + */ + public void terminate() { + if( started ) { + stop(); + } + for( Service s : services ) { + s.terminate(getParent()); + } + } + + /** + * Retrieves the first service of the specified type. + */ + public > S getService( Class type ) { + for( Service s : services ) { + if( type.isInstance(s) ) { + return type.cast(s); + } + } + return null; + } + + @Override + public String toString() { + return getClass().getName() + "[services=" + services + "]"; + } +} + diff --git a/jme3-networking/src/main/java/com/jme3/network/service/rpc/RpcClientService.java b/jme3-networking/src/main/java/com/jme3/network/service/rpc/RpcClientService.java new file mode 100644 index 000000000..d9ea134e1 --- /dev/null +++ b/jme3-networking/src/main/java/com/jme3/network/service/rpc/RpcClientService.java @@ -0,0 +1,123 @@ +/* + * Copyright (c) 2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ + +package com.jme3.network.service.rpc; + +import com.jme3.network.Client; +import com.jme3.network.util.ObjectMessageDelegator; +import com.jme3.network.service.AbstractClientService; +import com.jme3.network.service.ClientServiceManager; + + +/** + * RPC service that can be added to a network Client to + * add RPC send/receive capabilities. Remote procedure + * calls can be made to the server and responses retrieved. + * Any remote procedure calls that the server performs for + * this connection will be received by this service and delegated + * to the appropriate RpcHandlers. + * + * @author Paul Speed + */ +public class RpcClientService extends AbstractClientService { + + private RpcConnection rpc; + private ObjectMessageDelegator delegator; + + /** + * Creates a new RpcClientService that can be registered + * with the network Client object. + */ + public RpcClientService() { + } + + /** + * Used internally to setup the RpcConnection and MessageDelegator. + */ + @Override + protected void onInitialize( ClientServiceManager serviceManager ) { + Client client = serviceManager.getClient(); + this.rpc = new RpcConnection(client); + + delegator = new ObjectMessageDelegator(rpc, true); + client.addMessageListener(delegator, delegator.getMessageTypes()); + } + + /** + * Used internally to unregister the RPC MessageDelegator that + * was previously added to the network Client. + */ + @Override + public void terminate( ClientServiceManager serviceManager ) { + Client client = serviceManager.getClient(); + client.removeMessageListener(delegator, delegator.getMessageTypes()); + } + + /** + * Performs a synchronous call on the server against the specified + * object using the specified procedure ID. Both inboud and outbound + * communication is done on the specified channel. + */ + public Object callAndWait( byte channel, short objId, short procId, Object... args ) { + return rpc.callAndWait(channel, objId, procId, args); + } + + /** + * Performs an asynchronous call on the server against the specified + * object using the specified procedure ID. Communication is done + * over the specified channel. No responses are received and none + * are waited for. + */ + public void callAsync( byte channel, short objId, short procId, Object... args ) { + rpc.callAsync(channel, objId, procId, args); + } + + /** + * Register a handler that will be called when the server + * performs a remove procedure call against this client. + * Only one handler per object ID can be registered at any given time, + * though the same handler can be registered for multiple object + * IDs. + */ + public void registerHandler( short objId, RpcHandler handler ) { + rpc.registerHandler(objId, handler); + } + + /** + * Removes a previously registered handler for the specified + * object ID. + */ + public void removeHandler( short objId, RpcHandler handler ) { + rpc.removeHandler(objId, handler); + } + +} diff --git a/jme3-networking/src/main/java/com/jme3/network/service/rpc/RpcConnection.java b/jme3-networking/src/main/java/com/jme3/network/service/rpc/RpcConnection.java new file mode 100644 index 000000000..b5e66c188 --- /dev/null +++ b/jme3-networking/src/main/java/com/jme3/network/service/rpc/RpcConnection.java @@ -0,0 +1,247 @@ +/* + * Copyright (c) 2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ + +package com.jme3.network.service.rpc; + +import com.jme3.network.MessageConnection; +import com.jme3.network.service.rpc.msg.RpcCallMessage; +import com.jme3.network.service.rpc.msg.RpcResponseMessage; +import java.util.Map; +import java.util.concurrent.ConcurrentHashMap; +import java.util.concurrent.atomic.AtomicLong; +import java.util.logging.Level; +import java.util.logging.Logger; + + +/** + * Wraps a message connection to provide RPC call support. This + * is used internally by the RpcClientService and RpcHostedService to manage + * network messaging. + * + * @author Paul Speed + */ +public class RpcConnection { + + static final Logger log = Logger.getLogger(RpcConnection.class.getName()); + + /** + * The underlying connection upon which RPC call messages are sent + * and RPC response messages are received. It can be a Client or + * a HostedConnection depending on the mode of the RPC service. + */ + private MessageConnection connection; + + /** + * The objectId index of RpcHandler objects that are used to perform the + * RPC calls for a particular object. + */ + private Map handlers = new ConcurrentHashMap(); + + /** + * Provides unique messages IDs for outbound synchronous call + * messages. These are then used in the responses index to + * locate the proper ResponseHolder objects. + */ + private AtomicLong sequenceNumber = new AtomicLong(); + + /** + * Tracks the ResponseHolder objects for sent message IDs. When the + * response is received, the appropriate handler is found here and the + * response or error set, thus releasing the waiting caller. + */ + private Map responses = new ConcurrentHashMap(); + + /** + * Creates a new RpcConnection for the specified network connection. + */ + public RpcConnection( MessageConnection connection ) { + this.connection = connection; + } + + /** + * Clears any pending synchronous calls causing them to + * throw an exception with the message "Closing connection". + */ + public void close() { + // Let any pending waits go free + for( ResponseHolder holder : responses.values() ) { + holder.release(); + } + } + + /** + * Performs a remote procedure call with the specified arguments and waits + * for the response. Both the outbound message and inbound response will + * be sent on the specified channel. + */ + public Object callAndWait( byte channel, short objId, short procId, Object... args ) { + + RpcCallMessage msg = new RpcCallMessage(sequenceNumber.getAndIncrement(), + channel, objId, procId, args); + + // Need to register an object so we can wait for the response. + // ...before we send it. Just in case. + ResponseHolder holder = new ResponseHolder(msg); + responses.put(msg.getMessageId(), holder); + + if( log.isLoggable(Level.FINEST) ) { + log.log(Level.FINEST, "Sending:{0} on channel:{1}", new Object[]{msg, channel}); + } + connection.send(channel, msg); + + return holder.getResponse(); + } + + /** + * Performs a remote procedure call with the specified arguments but does + * not wait for a response. The outbound message is sent on the specified channel. + * There is no inbound response message. + */ + public void callAsync( byte channel, short objId, short procId, Object... args ) { + + RpcCallMessage msg = new RpcCallMessage(-1, channel, objId, procId, args); + if( log.isLoggable(Level.FINEST) ) { + log.log(Level.FINEST, "Sending:{0} on channel:{1}", new Object[]{msg, channel}); + } + connection.send(channel, msg); + } + + /** + * Register a handler that can be called by the other end + * of the connection using the specified object ID. Only one + * handler per object ID can be registered at any given time, + * though the same handler can be registered for multiple object + * IDs. + */ + public void registerHandler( short objId, RpcHandler handler ) { + handlers.put(objId, handler); + } + + /** + * Removes a previously registered handler for the specified + * object ID. + */ + public void removeHandler( short objId, RpcHandler handler ) { + RpcHandler removing = handlers.get(objId); + if( handler != removing ) { + throw new IllegalArgumentException("Handler not registered for object ID:" + + objId + ", handler:" + handler ); + } + handlers.remove(objId); + } + + /** + * Called internally when an RpcCallMessage is received from + * the remote connection. + */ + public void handleMessage( RpcCallMessage msg ) { + + if( log.isLoggable(Level.FINEST) ) { + log.log(Level.FINEST, "handleMessage({0})", msg); + } + RpcHandler handler = handlers.get(msg.getObjectId()); + try { + Object result = handler.call(this, msg.getObjectId(), msg.getProcedureId(), msg.getArguments()); + if( !msg.isAsync() ) { + RpcResponseMessage response = new RpcResponseMessage(msg.getMessageId(), result); + connection.send(msg.getChannel(), response); + } + } catch( Exception e ) { + if( !msg.isAsync() ) { + RpcResponseMessage response = new RpcResponseMessage(msg.getMessageId(), e); + connection.send(msg.getChannel(), response); + } else { + log.log(Level.SEVERE, "Error invoking async call for:" + msg, e); + } + } + } + + /** + * Called internally when an RpcResponseMessage is received from + * the remote connection. + */ + public void handleMessage( RpcResponseMessage msg ) { + if( log.isLoggable(Level.FINEST) ) { + log.log(Level.FINEST, "handleMessage({0})", msg); + } + ResponseHolder holder = responses.remove(msg.getMessageId()); + if( holder == null ) { + return; + } + holder.setResponse(msg); + } + + /** + * Sort of like a Future, holds a locked reference to a response + * until the remote call has completed and returned a response. + */ + private class ResponseHolder { + private Object response; + private String error; + private RpcCallMessage msg; + boolean received = false; + + public ResponseHolder( RpcCallMessage msg ) { + this.msg = msg; + } + + public synchronized void setResponse( RpcResponseMessage msg ) { + this.response = msg.getResult(); + this.error = msg.getError(); + this.received = true; + notifyAll(); + } + + public synchronized Object getResponse() { + try { + while(!received) { + wait(); + } + } catch( InterruptedException e ) { + throw new RuntimeException("Interrupted waiting for respone to:" + msg, e); + } + if( error != null ) { + throw new RuntimeException("Error calling remote procedure:" + msg + "\n" + error); + } + return response; + } + + public synchronized void release() { + if( received ) { + return; + } + // Else signal an error for the callers + this.error = "Closing connection"; + this.received = true; + } + } +} diff --git a/jme3-networking/src/main/java/com/jme3/network/service/rpc/RpcHandler.java b/jme3-networking/src/main/java/com/jme3/network/service/rpc/RpcHandler.java new file mode 100644 index 000000000..d7d99981d --- /dev/null +++ b/jme3-networking/src/main/java/com/jme3/network/service/rpc/RpcHandler.java @@ -0,0 +1,52 @@ +/* + * Copyright (c) 2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ + +package com.jme3.network.service.rpc; + + +/** + * Implementations of this interface can be registered with + * the RpcClientService or RpcHostService to handle the + * remote procedure calls for a given object or objects. + * + * @author Paul Speed + */ +public interface RpcHandler { + + /** + * Called when a remote procedure call request is received for a particular + * object from the other end of the network connection. + */ + public Object call( RpcConnection conn, short objectId, short procId, Object... args ); +} + + diff --git a/jme3-networking/src/main/java/com/jme3/network/service/rpc/RpcHostedService.java b/jme3-networking/src/main/java/com/jme3/network/service/rpc/RpcHostedService.java new file mode 100644 index 000000000..4a347b5a3 --- /dev/null +++ b/jme3-networking/src/main/java/com/jme3/network/service/rpc/RpcHostedService.java @@ -0,0 +1,227 @@ +/* + * Copyright (c) 2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ + +package com.jme3.network.service.rpc; + +import com.jme3.network.HostedConnection; +import com.jme3.network.Server; +import com.jme3.network.serializing.Serializer; +import com.jme3.network.util.SessionDataDelegator; +import com.jme3.network.service.AbstractHostedService; +import com.jme3.network.service.HostedServiceManager; +import com.jme3.network.service.rpc.msg.RpcCallMessage; +import com.jme3.network.service.rpc.msg.RpcResponseMessage; +import java.util.Arrays; +import java.util.logging.Level; +import java.util.logging.Logger; + + +/** + * RPC service that can be added to a network Server to + * add RPC send/receive capabilities. For a particular + * HostedConnection, Remote procedure calls can be made to the + * associated Client and responses retrieved. Any remote procedure + * calls that the Client performs for this connection will be + * received by this service and delegated to the appropriate RpcHandlers. + * + * Note: it can be dangerous for a server to perform synchronous + * RPC calls to a client but especially so if not done as part + * of the response to some other message. ie: iterating over all + * or some HostedConnections to perform synchronous RPC calls + * will be slow and potentially block the server's threads in ways + * that can cause deadlocks or odd contention. + * + * @author Paul Speed + */ +public class RpcHostedService extends AbstractHostedService { + + private static final String ATTRIBUTE_NAME = "rpcSession"; + + static final Logger log = Logger.getLogger(RpcHostedService.class.getName()); + + private boolean autoHost; + private SessionDataDelegator delegator; + + /** + * Creates a new RPC host service that can be registered + * with the Network server and will automatically 'host' + * RPC services and each new network connection. + */ + public RpcHostedService() { + this(true); + } + + /** + * Creates a new RPC host service that can be registered + * with the Network server and will optionally 'host' + * RPC services and each new network connection depending + * on the specified 'autoHost' flag. + */ + public RpcHostedService( boolean autoHost ) { + this.autoHost = autoHost; + + // This works for me... has to be different in + // the general case + Serializer.registerClasses(RpcCallMessage.class, RpcResponseMessage.class); + } + + /** + * Used internally to setup the message delegator that will + * handle HostedConnection specific messages and forward them + * to that connection's RpcConnection. + */ + @Override + protected void onInitialize( HostedServiceManager serviceManager ) { + Server server = serviceManager.getServer(); + + // A general listener for forwarding the messages + // to the client-specific handler + this.delegator = new SessionDataDelegator(RpcConnection.class, + ATTRIBUTE_NAME, + true); + server.addMessageListener(delegator, delegator.getMessageTypes()); + + if( log.isLoggable(Level.FINEST) ) { + log.log(Level.FINEST, "Registered delegator for message types:{0}", Arrays.asList(delegator.getMessageTypes())); + } + } + + /** + * When set to true, all new connections will automatically have + * RPC hosting services attached to them, meaning they can send + * and receive RPC calls. If this is set to false then it is up + * to other services to eventually call startHostingOnConnection(). + * + *

Reasons for doing this vary but usually would be because + * the client shouldn't be allowed to perform any RPC calls until + * it has provided more information. In general, this is unnecessary + * because the RpcHandler registries are not shared. Each client + * gets their own and RPC calls will fail until the appropriate + * objects have been registtered.

+ */ + public void setAutoHost( boolean b ) { + this.autoHost = b; + } + + /** + * Returns true if this service automatically attaches RPC + * hosting capabilities to new connections. + */ + public boolean getAutoHost() { + return autoHost; + } + + /** + * Retrieves the RpcConnection for the specified HostedConnection + * if that HostedConnection has had RPC services started using + * startHostingOnConnection() (or via autohosting). Returns null + * if the connection currently doesn't have RPC hosting services + * attached. + */ + public RpcConnection getRpcConnection( HostedConnection hc ) { + return hc.getAttribute(ATTRIBUTE_NAME); + } + + /** + * Sets up RPC hosting services for the hosted connection allowing + * getRpcConnection() to return a valid RPC connection object. + * This method is called automatically for all new connections if + * autohost is set to true. + */ + public void startHostingOnConnection( HostedConnection hc ) { + if( log.isLoggable(Level.FINEST) ) { + log.log(Level.FINEST, "startHostingOnConnection:{0}", hc); + } + hc.setAttribute(ATTRIBUTE_NAME, new RpcConnection(hc)); + } + + /** + * Removes any RPC hosting services associated with the specified + * connection. Calls to getRpcConnection() will return null for + * this connection. The connection's RpcConnection is also closed, + * releasing any waiting synchronous calls with a "Connection closing" + * error. + * This method is called automatically for all leaving connections if + * autohost is set to true. + */ + public void stopHostingOnConnection( HostedConnection hc ) { + RpcConnection rpc = hc.getAttribute(ATTRIBUTE_NAME); + if( rpc == null ) { + return; + } + if( log.isLoggable(Level.FINEST) ) { + log.log(Level.FINEST, "stopHostingOnConnection:{0}", hc); + } + hc.setAttribute(ATTRIBUTE_NAME, null); + rpc.close(); + } + + /** + * Used internally to remove the message delegator from the + * server. + */ + @Override + public void terminate(HostedServiceManager serviceManager) { + Server server = serviceManager.getServer(); + server.removeMessageListener(delegator, delegator.getMessageTypes()); + } + + /** + * Called internally when a new connection is detected for + * the server. If the current autoHost property is true then + * startHostingOnConnection(hc) is called. + */ + @Override + public void connectionAdded(Server server, HostedConnection hc) { + if( log.isLoggable(Level.FINEST) ) { + log.log(Level.FINEST, "connectionAdded({0}, {1})", new Object[]{server, hc}); + } + if( autoHost ) { + startHostingOnConnection(hc); + } + } + + /** + * Called internally when an existing connection is leaving + * the server. If the current autoHost property is true then + * stopHostingOnConnection(hc) is called. + */ + @Override + public void connectionRemoved(Server server, HostedConnection hc) { + if( log.isLoggable(Level.FINEST) ) { + log.log(Level.FINEST, "connectionRemoved({0}, {1})", new Object[]{server, hc}); + } + stopHostingOnConnection(hc); + } + +} + diff --git a/jme3-networking/src/main/java/com/jme3/network/service/rpc/msg/RpcCallMessage.java b/jme3-networking/src/main/java/com/jme3/network/service/rpc/msg/RpcCallMessage.java new file mode 100644 index 000000000..70f12f1e0 --- /dev/null +++ b/jme3-networking/src/main/java/com/jme3/network/service/rpc/msg/RpcCallMessage.java @@ -0,0 +1,98 @@ +/* + * Copyright (c) 2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ + +package com.jme3.network.service.rpc.msg; + +import com.jme3.network.AbstractMessage; +import com.jme3.network.serializing.Serializable; + + +/** + * Used internally to send RPC call information to + * the other end of a connection for execution. + * + * @author Paul Speed + */ +@Serializable +public class RpcCallMessage extends AbstractMessage { + + private long msgId; + private byte channel; + private short objId; + private short procId; + private Object[] args; + + public RpcCallMessage() { + } + + public RpcCallMessage( long msgId, byte channel, short objId, short procId, Object... args ) { + this.msgId = msgId; + this.channel = channel; + this.objId = objId; + this.procId = procId; + this.args = args; + } + + public long getMessageId() { + return msgId; + } + + public byte getChannel() { + return channel; + } + + public boolean isAsync() { + return msgId == -1; + } + + public short getObjectId() { + return objId; + } + + public short getProcedureId() { + return procId; + } + + public Object[] getArguments() { + return args; + } + + @Override + public String toString() { + return getClass().getSimpleName() + "[#" + msgId + ", channel=" + channel + + (isAsync() ? ", async" : ", sync") + + ", objId=" + objId + + ", procId=" + procId + + ", args.length=" + args.length + + "]"; + } +} diff --git a/jme3-networking/src/main/java/com/jme3/network/service/rpc/msg/RpcResponseMessage.java b/jme3-networking/src/main/java/com/jme3/network/service/rpc/msg/RpcResponseMessage.java new file mode 100644 index 000000000..efb0def6a --- /dev/null +++ b/jme3-networking/src/main/java/com/jme3/network/service/rpc/msg/RpcResponseMessage.java @@ -0,0 +1,89 @@ +/* + * Copyright (c) 2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ + +package com.jme3.network.service.rpc.msg; + +import com.jme3.network.AbstractMessage; +import com.jme3.network.serializing.Serializable; +import java.io.PrintWriter; +import java.io.StringWriter; + + +/** + * Used internally to send an RPC call's response back to + * the caller. + * + * @author Paul Speed + */ +@Serializable +public class RpcResponseMessage extends AbstractMessage { + + private long msgId; + private Object result; + private String error; + + public RpcResponseMessage() { + } + + public RpcResponseMessage( long msgId, Object result ) { + this.msgId = msgId; + this.result = result; + } + + public RpcResponseMessage( long msgId, Throwable t ) { + this.msgId = msgId; + + StringWriter sOut = new StringWriter(); + PrintWriter out = new PrintWriter(sOut); + t.printStackTrace(out); + out.close(); + this.error = sOut.toString(); + } + + public long getMessageId() { + return msgId; + } + + public Object getResult() { + return result; + } + + public String getError() { + return error; + } + + @Override + public String toString() { + return getClass().getSimpleName() + "[#" + msgId + ", result=" + result + + "]"; + } +} From 35155c6b5bf282de5d102f2643a8a117dd226d46 Mon Sep 17 00:00:00 2001 From: Paul Speed Date: Sun, 26 Apr 2015 00:57:02 -0400 Subject: [PATCH 040/113] Integrated the new service manager stuff with Client and Server. (Untested at the moment but straight forward.) Also fixed a small but silent bug in DefaultServer when closing out endpoints that were never fully connected. Garbage was left around in the "connecting" data structure. --- .../main/java/com/jme3/network/Client.java | 6 +++ .../main/java/com/jme3/network/Server.java | 8 +++ .../com/jme3/network/base/DefaultClient.java | 23 +++++++- .../com/jme3/network/base/DefaultServer.java | 52 +++++++++++++++++-- .../com/jme3/network/service/Service.java | 2 +- 5 files changed, 83 insertions(+), 8 deletions(-) diff --git a/jme3-networking/src/main/java/com/jme3/network/Client.java b/jme3-networking/src/main/java/com/jme3/network/Client.java index 6837a4d86..ee7aba4d4 100644 --- a/jme3-networking/src/main/java/com/jme3/network/Client.java +++ b/jme3-networking/src/main/java/com/jme3/network/Client.java @@ -72,6 +72,12 @@ public interface Client extends MessageConnection * be able to connect to. */ public int getVersion(); + + /** + * Returns the manager for client services. Client services extend + * the functionality of the client. + */ + public ClientServiceManager getServices(); /** * Sends a message to the server. diff --git a/jme3-networking/src/main/java/com/jme3/network/Server.java b/jme3-networking/src/main/java/com/jme3/network/Server.java index 72926eab7..a52cb33bf 100644 --- a/jme3-networking/src/main/java/com/jme3/network/Server.java +++ b/jme3-networking/src/main/java/com/jme3/network/Server.java @@ -33,6 +33,8 @@ package com.jme3.network; import java.util.Collection; +import com.jme3.network.service.HostedServiceManager; + /** * Represents a host that can send and receive messages to * a set of remote client connections. @@ -54,6 +56,12 @@ public interface Server */ public int getVersion(); + /** + * Returns the manager for hosted services. Hosted services extend + * the functionality of the server. + */ + public HostedServiceManager getServices(); + /** * Sends the specified message to all connected clients. */ diff --git a/jme3-networking/src/main/java/com/jme3/network/base/DefaultClient.java b/jme3-networking/src/main/java/com/jme3/network/base/DefaultClient.java index 54e8fd7f9..3d9ceb149 100644 --- a/jme3-networking/src/main/java/com/jme3/network/base/DefaultClient.java +++ b/jme3-networking/src/main/java/com/jme3/network/base/DefaultClient.java @@ -37,6 +37,7 @@ import com.jme3.network.kernel.Connector; import com.jme3.network.message.ChannelInfoMessage; import com.jme3.network.message.ClientRegistrationMessage; import com.jme3.network.message.DisconnectMessage; +import com.jme3.network.service.ClientServiceManager; import java.io.IOException; import java.nio.ByteBuffer; import java.util.*; @@ -54,7 +55,7 @@ import java.util.logging.Logger; */ public class DefaultClient implements Client { - static Logger log = Logger.getLogger(DefaultClient.class.getName()); + static final Logger log = Logger.getLogger(DefaultClient.class.getName()); // First two channels are reserved for reliable and // unreliable. Note: channels are endpoint specific so these @@ -80,10 +81,13 @@ public class DefaultClient implements Client private ConnectorFactory connectorFactory; + private ClientServiceManager services; + public DefaultClient( String gameName, int version ) { this.gameName = gameName; this.version = version; + this.services = new ClientServiceManager(this); } public DefaultClient( String gameName, int version, Connector reliable, Connector fast, @@ -200,6 +204,11 @@ public class DefaultClient implements Client { return version; } + + public ClientServiceManager getServices() + { + return services; + } public void send( Message message ) { @@ -260,7 +269,7 @@ public class DefaultClient implements Client { checkRunning(); - closeConnections( null ); + closeConnections( null ); } protected void closeConnections( DisconnectInfo info ) @@ -268,6 +277,10 @@ public class DefaultClient implements Client if( !isRunning ) return; + // Let the services get a chance to stop before we + // kill the connection. + services.stop(); + // Send a close message // Tell the thread it's ok to die @@ -285,6 +298,9 @@ public class DefaultClient implements Client fireDisconnected(info); isRunning = false; + + // Terminate the services + services.terminate(); } public void addClientStateListener( ClientStateListener listener ) @@ -329,6 +345,9 @@ public class DefaultClient implements Client protected void fireConnected() { + // Let the services know we are finally started + services.start(); + for( ClientStateListener l : stateListeners ) { l.clientConnected( this ); } diff --git a/jme3-networking/src/main/java/com/jme3/network/base/DefaultServer.java b/jme3-networking/src/main/java/com/jme3/network/base/DefaultServer.java index 3816fbace..a6bd9f763 100644 --- a/jme3-networking/src/main/java/com/jme3/network/base/DefaultServer.java +++ b/jme3-networking/src/main/java/com/jme3/network/base/DefaultServer.java @@ -37,6 +37,7 @@ import com.jme3.network.kernel.Kernel; import com.jme3.network.message.ChannelInfoMessage; import com.jme3.network.message.ClientRegistrationMessage; import com.jme3.network.message.DisconnectMessage; +import com.jme3.network.service.HostedServiceManager; import java.io.IOException; import java.nio.ByteBuffer; import java.util.*; @@ -55,7 +56,7 @@ import java.util.logging.Logger; */ public class DefaultServer implements Server { - static Logger log = Logger.getLogger(DefaultServer.class.getName()); + static final Logger log = Logger.getLogger(DefaultServer.class.getName()); // First two channels are reserved for reliable and // unreliable @@ -85,6 +86,8 @@ public class DefaultServer implements Server = new MessageListenerRegistry(); private List connectionListeners = new CopyOnWriteArrayList(); + private HostedServiceManager services; + public DefaultServer( String gameName, int version, Kernel reliable, Kernel fast ) { if( reliable == null ) @@ -92,6 +95,7 @@ public class DefaultServer implements Server this.gameName = gameName; this.version = version; + this.services = new HostedServiceManager(this); reliableAdapter = new KernelAdapter( this, reliable, dispatcher, true ); channels.add( reliableAdapter ); @@ -110,6 +114,11 @@ public class DefaultServer implements Server { return version; } + + public HostedServiceManager getServices() + { + return services; + } public int addChannel( int port ) { @@ -164,7 +173,10 @@ public class DefaultServer implements Server ka.start(); } - isRunning = true; + isRunning = true; + + // Start the services + services.start(); } public boolean isRunning() @@ -177,13 +189,20 @@ public class DefaultServer implements Server if( !isRunning ) throw new IllegalStateException( "Server is not started." ); + // First stop the services since we are about to + // kill the connections they are using + services.stop(); + try { // Kill the adpaters, they will kill the kernels for( KernelAdapter ka : channels ) { ka.close(); } - isRunning = false; + isRunning = false; + + // Now terminate all of the services + services.terminate(); } catch( InterruptedException e ) { throw new RuntimeException( "Interrupted while closing", e ); } @@ -396,6 +415,18 @@ public class DefaultServer implements Server return endpointConnections.get(endpoint); } + protected void removeConnecting( Endpoint p ) + { + // No easy lookup for connecting Connections + // from endpoint. + for( Map.Entry e : connecting.entrySet() ) { + if( e.getValue().hasEndpoint(p) ) { + connecting.remove(e.getKey()); + return; + } + } + } + protected void connectionClosed( Endpoint p ) { if( p.isConnected() ) { @@ -411,10 +442,10 @@ public class DefaultServer implements Server // Also note: this method will be called multiple times per // HostedConnection if it has multiple endpoints. - Connection removed = null; + Connection removed; synchronized( this ) { // Just in case the endpoint was still connecting - connecting.values().remove(p); + removeConnecting(p); // And the regular management removed = (Connection)endpointConnections.remove(p); @@ -452,6 +483,16 @@ public class DefaultServer implements Server id = nextId.getAndIncrement(); channels = new Endpoint[channelCount]; } + + boolean hasEndpoint( Endpoint p ) + { + for( Endpoint e : channels ) { + if( p == e ) { + return true; + } + } + return false; + } void setChannel( int channel, Endpoint p ) { @@ -557,6 +598,7 @@ public class DefaultServer implements Server return Collections.unmodifiableSet(sessionData.keySet()); } + @Override public String toString() { return "Connection[ id=" + id + ", reliable=" + channels[CH_RELIABLE] diff --git a/jme3-networking/src/main/java/com/jme3/network/service/Service.java b/jme3-networking/src/main/java/com/jme3/network/service/Service.java index 530237cea..f56c90dda 100644 --- a/jme3-networking/src/main/java/com/jme3/network/service/Service.java +++ b/jme3-networking/src/main/java/com/jme3/network/service/Service.java @@ -53,7 +53,7 @@ public interface Service { public void start(); /** - * Called when the service is shutting down. All services + * Called when the service manager is shutting down. All services * are stopped and any service manager resources are closed * before the services are terminated. */ From 1145f99d03d281534f11dc298d6df5d8d32ec6a9 Mon Sep 17 00:00:00 2001 From: Paul Speed Date: Sun, 26 Apr 2015 01:19:38 -0400 Subject: [PATCH 041/113] Added a service that will send the server's serializer registration set to each new client that connects. The client-side version of this service will then register them all. This means that serialized classes need only be registered on the server. I've modified DefaultClient and DefaultServer to register these services by default because they make other services easier to write and because they will save people lots of trouble. I'm 90% sure there are no bad side-effects for people who choose to continue doing things the old way but it may depend on when they register their serializers in relations to creating the client and server objects. --- .../com/jme3/network/base/DefaultClient.java | 6 ++ .../com/jme3/network/base/DefaultServer.java | 8 ++- .../network/service/ClientServiceManager.java | 13 ++++ .../network/service/HostedServiceManager.java | 13 ++++ .../ClientSerializerRegistrationsService.java | 68 ++++++++++++++++++ .../ServerSerializerRegistrationsService.java | 71 +++++++++++++++++++ 6 files changed, 178 insertions(+), 1 deletion(-) create mode 100644 jme3-networking/src/main/java/com/jme3/network/service/serializer/ClientSerializerRegistrationsService.java create mode 100644 jme3-networking/src/main/java/com/jme3/network/service/serializer/ServerSerializerRegistrationsService.java diff --git a/jme3-networking/src/main/java/com/jme3/network/base/DefaultClient.java b/jme3-networking/src/main/java/com/jme3/network/base/DefaultClient.java index 3d9ceb149..c0cc2e616 100644 --- a/jme3-networking/src/main/java/com/jme3/network/base/DefaultClient.java +++ b/jme3-networking/src/main/java/com/jme3/network/base/DefaultClient.java @@ -38,6 +38,7 @@ import com.jme3.network.message.ChannelInfoMessage; import com.jme3.network.message.ClientRegistrationMessage; import com.jme3.network.message.DisconnectMessage; import com.jme3.network.service.ClientServiceManager; +import com.jme3.network.service.serializer.ClientSerializerRegistrationsService; import java.io.IOException; import java.nio.ByteBuffer; import java.util.*; @@ -88,6 +89,7 @@ public class DefaultClient implements Client this.gameName = gameName; this.version = version; this.services = new ClientServiceManager(this); + addStandardServices(); } public DefaultClient( String gameName, int version, Connector reliable, Connector fast, @@ -97,6 +99,10 @@ public class DefaultClient implements Client setPrimaryConnectors( reliable, fast, connectorFactory ); } + protected void addStandardServices() { + services.addService(new ClientSerializerRegistrationsService()); + } + protected void setPrimaryConnectors( Connector reliable, Connector fast, ConnectorFactory connectorFactory ) { if( reliable == null ) diff --git a/jme3-networking/src/main/java/com/jme3/network/base/DefaultServer.java b/jme3-networking/src/main/java/com/jme3/network/base/DefaultServer.java index a6bd9f763..0a9ac0ef1 100644 --- a/jme3-networking/src/main/java/com/jme3/network/base/DefaultServer.java +++ b/jme3-networking/src/main/java/com/jme3/network/base/DefaultServer.java @@ -38,6 +38,7 @@ import com.jme3.network.message.ChannelInfoMessage; import com.jme3.network.message.ClientRegistrationMessage; import com.jme3.network.message.DisconnectMessage; import com.jme3.network.service.HostedServiceManager; +import com.jme3.network.service.serializer.ServerSerializerRegistrationsService; import java.io.IOException; import java.nio.ByteBuffer; import java.util.*; @@ -95,7 +96,8 @@ public class DefaultServer implements Server this.gameName = gameName; this.version = version; - this.services = new HostedServiceManager(this); + this.services = new HostedServiceManager(this); + addStandardServices(); reliableAdapter = new KernelAdapter( this, reliable, dispatcher, true ); channels.add( reliableAdapter ); @@ -105,6 +107,10 @@ public class DefaultServer implements Server } } + protected void addStandardServices() { + services.addService(new ServerSerializerRegistrationsService()); + } + public String getGameName() { return gameName; diff --git a/jme3-networking/src/main/java/com/jme3/network/service/ClientServiceManager.java b/jme3-networking/src/main/java/com/jme3/network/service/ClientServiceManager.java index df8957201..dc204fb2f 100644 --- a/jme3-networking/src/main/java/com/jme3/network/service/ClientServiceManager.java +++ b/jme3-networking/src/main/java/com/jme3/network/service/ClientServiceManager.java @@ -75,6 +75,19 @@ public class ClientServiceManager extends ServiceManager { super.addService(s); } + /** + * Adds all of the specified ClientServices and initializes them. If the service manager + * has already been started then the services will also be started. + * This is a convenience method that delegates to addService(), thus each + * service will be initialized (and possibly started) in sequence rather + * than doing them all at the end. + */ + public void addServices( ClientService... services ) { + for( ClientService s : services ) { + super.addService(s); + } + } + /** * Removes the specified ClientService from this service manager, stopping * and terminating it as required. If this service manager is in a diff --git a/jme3-networking/src/main/java/com/jme3/network/service/HostedServiceManager.java b/jme3-networking/src/main/java/com/jme3/network/service/HostedServiceManager.java index 866357852..3606ba44b 100644 --- a/jme3-networking/src/main/java/com/jme3/network/service/HostedServiceManager.java +++ b/jme3-networking/src/main/java/com/jme3/network/service/HostedServiceManager.java @@ -82,6 +82,19 @@ public class HostedServiceManager extends ServiceManager { super.addService(s); } + /** + * Adds all of the specified HostedServices and initializes them. If the service manager + * has already been started then the services will also be started. + * This is a convenience method that delegates to addService(), thus each + * service will be initialized (and possibly started) in sequence rather + * than doing them all at the end. + */ + public void addServices( HostedService... services ) { + for( HostedService s : services ) { + super.addService(s); + } + } + /** * Removes the specified HostedService from this service manager, stopping * and terminating it as required. If this service manager is in a diff --git a/jme3-networking/src/main/java/com/jme3/network/service/serializer/ClientSerializerRegistrationsService.java b/jme3-networking/src/main/java/com/jme3/network/service/serializer/ClientSerializerRegistrationsService.java new file mode 100644 index 000000000..6705bbc8b --- /dev/null +++ b/jme3-networking/src/main/java/com/jme3/network/service/serializer/ClientSerializerRegistrationsService.java @@ -0,0 +1,68 @@ +/* + * Copyright (c) 2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ + +package com.jme3.network.service.serializer; + +import com.jme3.network.Client; +import com.jme3.network.Message; +import com.jme3.network.MessageListener; +import com.jme3.network.message.SerializerRegistrationsMessage; +import com.jme3.network.serializing.Serializer; +import com.jme3.network.service.AbstractClientService; +import com.jme3.network.service.ClientServiceManager; + + +/** + * + * + * @author Paul Speed + */ +public class ClientSerializerRegistrationsService extends AbstractClientService + implements MessageListener { + + @Override + protected void onInitialize( ClientServiceManager serviceManager ) { + // Make sure our message type is registered + // This is the minimum we'd need just to be able to register + // the rest... otherwise we can't even receive this message. + Serializer.registerClass(SerializerRegistrationsMessage.class); + + // Add our listener for that message type + serviceManager.getClient().addMessageListener(this, SerializerRegistrationsMessage.class); + } + + public void messageReceived( Client source, Message m ) { + // We only wait for one kind of message... + SerializerRegistrationsMessage msg = (SerializerRegistrationsMessage)m; + msg.registerAll(); + } +} diff --git a/jme3-networking/src/main/java/com/jme3/network/service/serializer/ServerSerializerRegistrationsService.java b/jme3-networking/src/main/java/com/jme3/network/service/serializer/ServerSerializerRegistrationsService.java new file mode 100644 index 000000000..8a0cd94f1 --- /dev/null +++ b/jme3-networking/src/main/java/com/jme3/network/service/serializer/ServerSerializerRegistrationsService.java @@ -0,0 +1,71 @@ +/* + * Copyright (c) 2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ + +package com.jme3.network.service.serializer; + +import com.jme3.network.HostedConnection; +import com.jme3.network.Server; +import com.jme3.network.message.SerializerRegistrationsMessage; +import com.jme3.network.serializing.Serializer; +import com.jme3.network.service.AbstractHostedService; +import com.jme3.network.service.HostedServiceManager; + + +/** + * + * + * @author Paul Speed + */ +public class ServerSerializerRegistrationsService extends AbstractHostedService { + + @Override + protected void onInitialize( HostedServiceManager serviceManager ) { + // Make sure our message type is registered + Serializer.registerClass(SerializerRegistrationsMessage.class); + } + + @Override + public void start() { + // Compile the registrations into a message we will + // send to all connecting clients + SerializerRegistrationsMessage.compile(); + } + + @Override + public void connectionAdded(Server server, HostedConnection hc) { + // Just in case + super.connectionAdded(server, hc); + + // Send the client the registration information + hc.send(SerializerRegistrationsMessage.INSTANCE); + } +} From 8b34e4890a8f165bde42edb64e15fa418ece0719 Mon Sep 17 00:00:00 2001 From: Paul Speed Date: Sun, 26 Apr 2015 02:26:47 -0400 Subject: [PATCH 042/113] Fixed a comment to be more accurate with respect to handler method argument types. Fixed a small bug in how auto-detect worked. It was too greedy in looking for two-argument methods and would somehow allow methods that took a first argument that was not a connection type. --- .../util/AbstractMessageDelegator.java | 21 ++++++++++--------- 1 file changed, 11 insertions(+), 10 deletions(-) diff --git a/jme3-networking/src/main/java/com/jme3/network/util/AbstractMessageDelegator.java b/jme3-networking/src/main/java/com/jme3/network/util/AbstractMessageDelegator.java index b077f9e01..a73496ea8 100644 --- a/jme3-networking/src/main/java/com/jme3/network/util/AbstractMessageDelegator.java +++ b/jme3-networking/src/main/java/com/jme3/network/util/AbstractMessageDelegator.java @@ -91,9 +91,8 @@ public abstract class AbstractMessageDelegator * Returns true if the specified method is valid for the specified * message type. This is used internally during automapping to * provide implementation specific filting of methods. - * This implementation checks for methods that take either no - * arguments, the connection and message type arguments (in that order), - * or just the message type or connection argument. + * This implementation checks for methods that take either the connection and message + * type arguments (in that order) or just the message type. */ protected boolean isValidMethod( Method m, Class messageType ) { @@ -106,13 +105,15 @@ public abstract class AbstractMessageDelegator if( parms.length != 2 && parms.length != 1 ) { log.finest("Parameter count is not 1 or 2"); return false; - } - int connectionIndex = parms.length > 1 ? 0 : -1; - int messageIndex = parms.length > 1 ? 1 : 0; - - if( connectionIndex > 0 && !MessageConnection.class.isAssignableFrom(parms[connectionIndex]) ) { - log.finest("First paramter is not a MessageConnection or subclass."); - return false; + } + int messageIndex = 0; + if( parms.length > 1 ) { + if( MessageConnection.class.isAssignableFrom(parms[0]) ) { + messageIndex++; + } else { + log.finest("First paramter is not a MessageConnection or subclass."); + return false; + } } if( messageType == null && !Message.class.isAssignableFrom(parms[messageIndex]) ) { From dd65580bf360cc50bc7a5f93e2fee02ca252a3fe Mon Sep 17 00:00:00 2001 From: Paul Speed Date: Sun, 26 Apr 2015 02:27:27 -0400 Subject: [PATCH 043/113] Pre-register the inner class as well. A cut paste error from my originals. --- .../service/serializer/ClientSerializerRegistrationsService.java | 1 + .../service/serializer/ServerSerializerRegistrationsService.java | 1 + 2 files changed, 2 insertions(+) diff --git a/jme3-networking/src/main/java/com/jme3/network/service/serializer/ClientSerializerRegistrationsService.java b/jme3-networking/src/main/java/com/jme3/network/service/serializer/ClientSerializerRegistrationsService.java index 6705bbc8b..911ce0fb1 100644 --- a/jme3-networking/src/main/java/com/jme3/network/service/serializer/ClientSerializerRegistrationsService.java +++ b/jme3-networking/src/main/java/com/jme3/network/service/serializer/ClientSerializerRegistrationsService.java @@ -55,6 +55,7 @@ public class ClientSerializerRegistrationsService extends AbstractClientService // This is the minimum we'd need just to be able to register // the rest... otherwise we can't even receive this message. Serializer.registerClass(SerializerRegistrationsMessage.class); + Serializer.registerClass(SerializerRegistrationsMessage.Registration.class); // Add our listener for that message type serviceManager.getClient().addMessageListener(this, SerializerRegistrationsMessage.class); diff --git a/jme3-networking/src/main/java/com/jme3/network/service/serializer/ServerSerializerRegistrationsService.java b/jme3-networking/src/main/java/com/jme3/network/service/serializer/ServerSerializerRegistrationsService.java index 8a0cd94f1..b24a8db5f 100644 --- a/jme3-networking/src/main/java/com/jme3/network/service/serializer/ServerSerializerRegistrationsService.java +++ b/jme3-networking/src/main/java/com/jme3/network/service/serializer/ServerSerializerRegistrationsService.java @@ -51,6 +51,7 @@ public class ServerSerializerRegistrationsService extends AbstractHostedService protected void onInitialize( HostedServiceManager serviceManager ) { // Make sure our message type is registered Serializer.registerClass(SerializerRegistrationsMessage.class); + Serializer.registerClass(SerializerRegistrationsMessage.Registration.class); } @Override From 96dab5f5617ba544d05bf3a6e9c0d983a61afb12 Mon Sep 17 00:00:00 2001 From: Paul Speed Date: Sun, 26 Apr 2015 02:28:38 -0400 Subject: [PATCH 044/113] Allow remote calls to be made on the default channel instead of just custom channels. Custom channels are 0-max channel while -1 indicates the default send(). --- .../network/service/rpc/RpcConnection.java | 23 +++++++++++++++---- 1 file changed, 18 insertions(+), 5 deletions(-) diff --git a/jme3-networking/src/main/java/com/jme3/network/service/rpc/RpcConnection.java b/jme3-networking/src/main/java/com/jme3/network/service/rpc/RpcConnection.java index b5e66c188..b78316bf3 100644 --- a/jme3-networking/src/main/java/com/jme3/network/service/rpc/RpcConnection.java +++ b/jme3-networking/src/main/java/com/jme3/network/service/rpc/RpcConnection.java @@ -116,7 +116,11 @@ public class RpcConnection { if( log.isLoggable(Level.FINEST) ) { log.log(Level.FINEST, "Sending:{0} on channel:{1}", new Object[]{msg, channel}); } - connection.send(channel, msg); + if( channel >= 0 ) { + connection.send(channel, msg); + } else { + connection.send(msg); + } return holder.getResponse(); } @@ -159,6 +163,14 @@ public class RpcConnection { handlers.remove(objId); } + protected void send( byte channel, RpcResponseMessage msg ) { + if( channel >= 0 ) { + connection.send(channel, msg); + } else { + connection.send(msg); + } + } + /** * Called internally when an RpcCallMessage is received from * the remote connection. @@ -170,15 +182,16 @@ public class RpcConnection { } RpcHandler handler = handlers.get(msg.getObjectId()); try { + if( handler == null ) { + throw new RuntimeException("Handler not found for objectID:" + msg.getObjectId()); + } Object result = handler.call(this, msg.getObjectId(), msg.getProcedureId(), msg.getArguments()); if( !msg.isAsync() ) { - RpcResponseMessage response = new RpcResponseMessage(msg.getMessageId(), result); - connection.send(msg.getChannel(), response); + send(msg.getChannel(), new RpcResponseMessage(msg.getMessageId(), result)); } } catch( Exception e ) { if( !msg.isAsync() ) { - RpcResponseMessage response = new RpcResponseMessage(msg.getMessageId(), e); - connection.send(msg.getChannel(), response); + send(msg.getChannel(), new RpcResponseMessage(msg.getMessageId(), e)); } else { log.log(Level.SEVERE, "Error invoking async call for:" + msg, e); } From 7bea2cc9c7b0731dda7cbe8ff981dce1aad50386 Mon Sep 17 00:00:00 2001 From: Paul Speed Date: Sun, 26 Apr 2015 03:10:47 -0400 Subject: [PATCH 045/113] Fixed a missing import. --- jme3-networking/src/main/java/com/jme3/network/Client.java | 2 ++ 1 file changed, 2 insertions(+) diff --git a/jme3-networking/src/main/java/com/jme3/network/Client.java b/jme3-networking/src/main/java/com/jme3/network/Client.java index ee7aba4d4..dd9873238 100644 --- a/jme3-networking/src/main/java/com/jme3/network/Client.java +++ b/jme3-networking/src/main/java/com/jme3/network/Client.java @@ -31,6 +31,8 @@ */ package com.jme3.network; +import com.jme3.network.service.ClientServiceManager; + /** * Represents a remote connection to a server that can be used From eba4c4e29a551c4a298584797ed48cd8b3e9cc00 Mon Sep 17 00:00:00 2001 From: Kostyantyn Hushchyn Date: Sun, 26 Apr 2015 11:06:26 +0300 Subject: [PATCH 046/113] Fixed iOS subsystem after transition to common renderer. Added OpenAL audio renderer. Implemented flip y in native iOS image loader --- jme3-ios/src/main/java/com/jme3/asset/IOS.cfg | 4 + .../main/java/com/jme3/audio/android/AL.java | 1054 ----------------- .../jme3/audio/android/AndroidAudioData.java | 67 -- .../main/java/com/jme3/audio/ios/IosAL.java | 53 + .../main/java/com/jme3/audio/ios/IosALC.java | 26 + .../main/java/com/jme3/audio/ios/IosEFX.java | 32 + .../audio/plugins/AndroidAudioLoader.java | 20 - .../java/com/jme3/renderer/ios/IosGL.java | 3 +- .../com/jme3/system/ios/IosImageLoader.java | 15 +- .../com/jme3/system/ios/JmeIosSystem.java | 15 +- .../src/main/resources/com/jme3/asset/IOS.cfg | 8 + 11 files changed, 147 insertions(+), 1150 deletions(-) delete mode 100644 jme3-ios/src/main/java/com/jme3/audio/android/AL.java delete mode 100644 jme3-ios/src/main/java/com/jme3/audio/android/AndroidAudioData.java create mode 100644 jme3-ios/src/main/java/com/jme3/audio/ios/IosAL.java create mode 100644 jme3-ios/src/main/java/com/jme3/audio/ios/IosALC.java create mode 100644 jme3-ios/src/main/java/com/jme3/audio/ios/IosEFX.java delete mode 100644 jme3-ios/src/main/java/com/jme3/audio/plugins/AndroidAudioLoader.java create mode 100644 jme3-ios/src/main/resources/com/jme3/asset/IOS.cfg diff --git a/jme3-ios/src/main/java/com/jme3/asset/IOS.cfg b/jme3-ios/src/main/java/com/jme3/asset/IOS.cfg index 715eab985..4e4052447 100644 --- a/jme3-ios/src/main/java/com/jme3/asset/IOS.cfg +++ b/jme3-ios/src/main/java/com/jme3/asset/IOS.cfg @@ -2,3 +2,7 @@ INCLUDE com/jme3/asset/General.cfg # IOS specific loaders LOADER com.jme3.system.ios.IosImageLoader : jpg, bmp, gif, png, jpeg +LOADER com.jme3.material.plugins.J3MLoader : j3m, j3md +LOADER com.jme3.shader.plugins.GLSLLoader : vert, frag, glsl, glsllib +LOADER com.jme3.export.binary.BinaryImporter : j3o +LOADER com.jme3.font.plugins.BitmapFontLoader : fnt diff --git a/jme3-ios/src/main/java/com/jme3/audio/android/AL.java b/jme3-ios/src/main/java/com/jme3/audio/android/AL.java deleted file mode 100644 index d8fea3933..000000000 --- a/jme3-ios/src/main/java/com/jme3/audio/android/AL.java +++ /dev/null @@ -1,1054 +0,0 @@ -package com.jme3.audio.android; - -/** - * - * @author iwgeric - */ -public class AL { - - - - /* ********** */ - /* FROM ALC.h */ - /* ********** */ - -// typedef struct ALCdevice_struct ALCdevice; -// typedef struct ALCcontext_struct ALCcontext; - - - /** - * No error - */ - static final int ALC_NO_ERROR = 0; - - /** - * No device - */ - static final int ALC_INVALID_DEVICE = 0xA001; - - /** - * invalid context ID - */ - static final int ALC_INVALID_CONTEXT = 0xA002; - - /** - * bad enum - */ - static final int ALC_INVALID_ENUM = 0xA003; - - /** - * bad value - */ - static final int ALC_INVALID_VALUE = 0xA004; - - /** - * Out of memory. - */ - static final int ALC_OUT_OF_MEMORY = 0xA005; - - - /** - * The Specifier string for default device - */ - static final int ALC_DEFAULT_DEVICE_SPECIFIER = 0x1004; - static final int ALC_DEVICE_SPECIFIER = 0x1005; - static final int ALC_EXTENSIONS = 0x1006; - - static final int ALC_MAJOR_VERSION = 0x1000; - static final int ALC_MINOR_VERSION = 0x1001; - - static final int ALC_ATTRIBUTES_SIZE = 0x1002; - static final int ALC_ALL_ATTRIBUTES = 0x1003; - - - /** - * Capture extension - */ - static final int ALC_EXT_CAPTURE = 1; - static final int ALC_CAPTURE_DEVICE_SPECIFIER = 0x310; - static final int ALC_CAPTURE_DEFAULT_DEVICE_SPECIFIER = 0x311; - static final int ALC_CAPTURE_SAMPLES = 0x312; - - - /** - * ALC_ENUMERATE_ALL_EXT enums - */ - static final int ALC_ENUMERATE_ALL_EXT = 1; - static final int ALC_DEFAULT_ALL_DEVICES_SPECIFIER = 0x1012; - static final int ALC_ALL_DEVICES_SPECIFIER = 0x1013; - - - /* ********** */ - /* FROM AL.h */ - /* ********** */ - -/** Boolean False. */ - static final int AL_FALSE = 0; - -/** Boolean True. */ - static final int AL_TRUE = 1; - -/* "no distance model" or "no buffer" */ - static final int AL_NONE = 0; - -/** Indicate Source has relative coordinates. */ - static final int AL_SOURCE_RELATIVE = 0x202; - - - -/** - * Directional source, inner cone angle, in degrees. - * Range: [0-360] - * Default: 360 - */ - static final int AL_CONE_INNER_ANGLE = 0x1001; - -/** - * Directional source, outer cone angle, in degrees. - * Range: [0-360] - * Default: 360 - */ - static final int AL_CONE_OUTER_ANGLE = 0x1002; - -/** - * Specify the pitch to be applied at source. - * Range: [0.5-2.0] - * Default: 1.0 - */ - static final int AL_PITCH = 0x1003; - -/** - * Specify the current location in three dimensional space. - * OpenAL, like OpenGL, uses a right handed coordinate system, - * where in a frontal default view X (thumb) points right, - * Y points up (index finger), and Z points towards the - * viewer/camera (middle finger). - * To switch from a left handed coordinate system, flip the - * sign on the Z coordinate. - * Listener position is always in the world coordinate system. - */ - static final int AL_POSITION = 0x1004; - -/** Specify the current direction. */ - static final int AL_DIRECTION = 0x1005; - -/** Specify the current velocity in three dimensional space. */ - static final int AL_VELOCITY = 0x1006; - -/** - * Indicate whether source is looping. - * Type: ALboolean? - * Range: [AL_TRUE, AL_FALSE] - * Default: FALSE. - */ - static final int AL_LOOPING = 0x1007; - -/** - * Indicate the buffer to provide sound samples. - * Type: ALuint. - * Range: any valid Buffer id. - */ - static final int AL_BUFFER = 0x1009; - -/** - * Indicate the gain (volume amplification) applied. - * Type: ALfloat. - * Range: ]0.0- ] - * A value of 1.0 means un-attenuated/unchanged. - * Each division by 2 equals an attenuation of -6dB. - * Each multiplicaton with 2 equals an amplification of +6dB. - * A value of 0.0 is meaningless with respect to a logarithmic - * scale; it is interpreted as zero volume - the channel - * is effectively disabled. - */ - static final int AL_GAIN = 0x100A; - -/* - * Indicate minimum source attenuation - * Type: ALfloat - * Range: [0.0 - 1.0] - * - * Logarthmic - */ - static final int AL_MIN_GAIN = 0x100D; - -/** - * Indicate maximum source attenuation - * Type: ALfloat - * Range: [0.0 - 1.0] - * - * Logarthmic - */ - static final int AL_MAX_GAIN = 0x100E; - -/** - * Indicate listener orientation. - * - * at/up - */ - static final int AL_ORIENTATION = 0x100F; - -/** - * Source state information. - */ - static final int AL_SOURCE_STATE = 0x1010; - static final int AL_INITIAL = 0x1011; - static final int AL_PLAYING = 0x1012; - static final int AL_PAUSED = 0x1013; - static final int AL_STOPPED = 0x1014; - -/** - * Buffer Queue params - */ - static final int AL_BUFFERS_QUEUED = 0x1015; - static final int AL_BUFFERS_PROCESSED = 0x1016; - -/** - * Source buffer position information - */ - static final int AL_SEC_OFFSET = 0x1024; - static final int AL_SAMPLE_OFFSET = 0x1025; - static final int AL_BYTE_OFFSET = 0x1026; - -/* - * Source type (Static, Streaming or undetermined) - * Source is Static if a Buffer has been attached using AL_BUFFER - * Source is Streaming if one or more Buffers have been attached using alSourceQueueBuffers - * Source is undetermined when it has the NULL buffer attached - */ - static final int AL_SOURCE_TYPE = 0x1027; - static final int AL_STATIC = 0x1028; - static final int AL_STREAMING = 0x1029; - static final int AL_UNDETERMINED = 0x1030; - -/** Sound samples: format specifier. */ - static final int AL_FORMAT_MONO8 = 0x1100; - static final int AL_FORMAT_MONO16 = 0x1101; - static final int AL_FORMAT_STEREO8 = 0x1102; - static final int AL_FORMAT_STEREO16 = 0x1103; - -/** - * source specific reference distance - * Type: ALfloat - * Range: 0.0 - +inf - * - * At 0.0, no distance attenuation occurs. Default is - * 1.0. - */ - static final int AL_REFERENCE_DISTANCE = 0x1020; - -/** - * source specific rolloff factor - * Type: ALfloat - * Range: 0.0 - +inf - * - */ - static final int AL_ROLLOFF_FACTOR = 0x1021; - -/** - * Directional source, outer cone gain. - * - * Default: 0.0 - * Range: [0.0 - 1.0] - * Logarithmic - */ - static final int AL_CONE_OUTER_GAIN = 0x1022; - -/** - * Indicate distance above which sources are not - * attenuated using the inverse clamped distance model. - * - * Default: +inf - * Type: ALfloat - * Range: 0.0 - +inf - */ - static final int AL_MAX_DISTANCE = 0x1023; - -/** - * Sound samples: frequency, in units of Hertz [Hz]. - * This is the number of samples per second. Half of the - * sample frequency marks the maximum significant - * frequency component. - */ - static final int AL_FREQUENCY = 0x2001; - static final int AL_BITS = 0x2002; - static final int AL_CHANNELS = 0x2003; - static final int AL_SIZE = 0x2004; - -/** - * Buffer state. - * - * Not supported for public use (yet). - */ - static final int AL_UNUSED = 0x2010; - static final int AL_PENDING = 0x2011; - static final int AL_PROCESSED = 0x2012; - - -/** Errors: No Error. */ - static final int AL_NO_ERROR = 0; - -/** - * Invalid Name paramater passed to AL call. - */ - static final int AL_INVALID_NAME = 0xA001; - -/** - * Invalid parameter passed to AL call. - */ - static final int AL_INVALID_ENUM = 0xA002; - -/** - * Invalid enum parameter value. - */ - static final int AL_INVALID_VALUE = 0xA003; - -/** - * Illegal call. - */ - static final int AL_INVALID_OPERATION = 0xA004; - - -/** - * No mojo. - */ - static final int AL_OUT_OF_MEMORY = 0xA005; - - -/** Context strings: Vendor Name. */ - static final int AL_VENDOR = 0xB001; - static final int AL_VERSION = 0xB002; - static final int AL_RENDERER = 0xB003; - static final int AL_EXTENSIONS = 0xB004; - -/** Global tweakage. */ - -/** - * Doppler scale. Default 1.0 - */ - static final int AL_DOPPLER_FACTOR = 0xC000; - -/** - * Tweaks speed of propagation. - */ - static final int AL_DOPPLER_VELOCITY = 0xC001; - -/** - * Speed of Sound in units per second - */ - static final int AL_SPEED_OF_SOUND = 0xC003; - -/** - * Distance models - * - * used in conjunction with DistanceModel - * - * implicit: NONE, which disances distance attenuation. - */ - static final int AL_DISTANCE_MODEL = 0xD000; - static final int AL_INVERSE_DISTANCE = 0xD001; - static final int AL_INVERSE_DISTANCE_CLAMPED = 0xD002; - static final int AL_LINEAR_DISTANCE = 0xD003; - static final int AL_LINEAR_DISTANCE_CLAMPED = 0xD004; - static final int AL_EXPONENT_DISTANCE = 0xD005; - static final int AL_EXPONENT_DISTANCE_CLAMPED = 0xD006; - - /* ********** */ - /* FROM efx.h */ - /* ********** */ - - static final String ALC_EXT_EFX_NAME = "ALC_EXT_EFX"; - - static final int ALC_EFX_MAJOR_VERSION = 0x20001; - static final int ALC_EFX_MINOR_VERSION = 0x20002; - static final int ALC_MAX_AUXILIARY_SENDS = 0x20003; - - -///* Listener properties. */ -//#define AL_METERS_PER_UNIT 0x20004 -// -///* Source properties. */ - static final int AL_DIRECT_FILTER = 0x20005; - static final int AL_AUXILIARY_SEND_FILTER = 0x20006; -//#define AL_AIR_ABSORPTION_FACTOR 0x20007 -//#define AL_ROOM_ROLLOFF_FACTOR 0x20008 -//#define AL_CONE_OUTER_GAINHF 0x20009 - static final int AL_DIRECT_FILTER_GAINHF_AUTO = 0x2000A; -//#define AL_AUXILIARY_SEND_FILTER_GAIN_AUTO 0x2000B -//#define AL_AUXILIARY_SEND_FILTER_GAINHF_AUTO 0x2000C -// -// -///* Effect properties. */ -// -///* Reverb effect parameters */ - static final int AL_REVERB_DENSITY = 0x0001; - static final int AL_REVERB_DIFFUSION = 0x0002; - static final int AL_REVERB_GAIN = 0x0003; - static final int AL_REVERB_GAINHF = 0x0004; - static final int AL_REVERB_DECAY_TIME = 0x0005; - static final int AL_REVERB_DECAY_HFRATIO = 0x0006; - static final int AL_REVERB_REFLECTIONS_GAIN = 0x0007; - static final int AL_REVERB_REFLECTIONS_DELAY = 0x0008; - static final int AL_REVERB_LATE_REVERB_GAIN = 0x0009; - static final int AL_REVERB_LATE_REVERB_DELAY = 0x000A; - static final int AL_REVERB_AIR_ABSORPTION_GAINHF = 0x000B; - static final int AL_REVERB_ROOM_ROLLOFF_FACTOR = 0x000C; - static final int AL_REVERB_DECAY_HFLIMIT = 0x000D; - -///* EAX Reverb effect parameters */ -//#define AL_EAXREVERB_DENSITY 0x0001 -//#define AL_EAXREVERB_DIFFUSION 0x0002 -//#define AL_EAXREVERB_GAIN 0x0003 -//#define AL_EAXREVERB_GAINHF 0x0004 -//#define AL_EAXREVERB_GAINLF 0x0005 -//#define AL_EAXREVERB_DECAY_TIME 0x0006 -//#define AL_EAXREVERB_DECAY_HFRATIO 0x0007 -//#define AL_EAXREVERB_DECAY_LFRATIO 0x0008 -//#define AL_EAXREVERB_REFLECTIONS_GAIN 0x0009 -//#define AL_EAXREVERB_REFLECTIONS_DELAY 0x000A -//#define AL_EAXREVERB_REFLECTIONS_PAN 0x000B -//#define AL_EAXREVERB_LATE_REVERB_GAIN 0x000C -//#define AL_EAXREVERB_LATE_REVERB_DELAY 0x000D -//#define AL_EAXREVERB_LATE_REVERB_PAN 0x000E -//#define AL_EAXREVERB_ECHO_TIME 0x000F -//#define AL_EAXREVERB_ECHO_DEPTH 0x0010 -//#define AL_EAXREVERB_MODULATION_TIME 0x0011 -//#define AL_EAXREVERB_MODULATION_DEPTH 0x0012 -//#define AL_EAXREVERB_AIR_ABSORPTION_GAINHF 0x0013 -//#define AL_EAXREVERB_HFREFERENCE 0x0014 -//#define AL_EAXREVERB_LFREFERENCE 0x0015 -//#define AL_EAXREVERB_ROOM_ROLLOFF_FACTOR 0x0016 -//#define AL_EAXREVERB_DECAY_HFLIMIT 0x0017 -// -///* Chorus effect parameters */ -//#define AL_CHORUS_WAVEFORM 0x0001 -//#define AL_CHORUS_PHASE 0x0002 -//#define AL_CHORUS_RATE 0x0003 -//#define AL_CHORUS_DEPTH 0x0004 -//#define AL_CHORUS_FEEDBACK 0x0005 -//#define AL_CHORUS_DELAY 0x0006 -// -///* Distortion effect parameters */ -//#define AL_DISTORTION_EDGE 0x0001 -//#define AL_DISTORTION_GAIN 0x0002 -//#define AL_DISTORTION_LOWPASS_CUTOFF 0x0003 -//#define AL_DISTORTION_EQCENTER 0x0004 -//#define AL_DISTORTION_EQBANDWIDTH 0x0005 -// -///* Echo effect parameters */ -//#define AL_ECHO_DELAY 0x0001 -//#define AL_ECHO_LRDELAY 0x0002 -//#define AL_ECHO_DAMPING 0x0003 -//#define AL_ECHO_FEEDBACK 0x0004 -//#define AL_ECHO_SPREAD 0x0005 -// -///* Flanger effect parameters */ -//#define AL_FLANGER_WAVEFORM 0x0001 -//#define AL_FLANGER_PHASE 0x0002 -//#define AL_FLANGER_RATE 0x0003 -//#define AL_FLANGER_DEPTH 0x0004 -//#define AL_FLANGER_FEEDBACK 0x0005 -//#define AL_FLANGER_DELAY 0x0006 -// -///* Frequency shifter effect parameters */ -//#define AL_FREQUENCY_SHIFTER_FREQUENCY 0x0001 -//#define AL_FREQUENCY_SHIFTER_LEFT_DIRECTION 0x0002 -//#define AL_FREQUENCY_SHIFTER_RIGHT_DIRECTION 0x0003 -// -///* Vocal morpher effect parameters */ -//#define AL_VOCAL_MORPHER_PHONEMEA 0x0001 -//#define AL_VOCAL_MORPHER_PHONEMEA_COARSE_TUNING 0x0002 -//#define AL_VOCAL_MORPHER_PHONEMEB 0x0003 -//#define AL_VOCAL_MORPHER_PHONEMEB_COARSE_TUNING 0x0004 -//#define AL_VOCAL_MORPHER_WAVEFORM 0x0005 -//#define AL_VOCAL_MORPHER_RATE 0x0006 -// -///* Pitchshifter effect parameters */ -//#define AL_PITCH_SHIFTER_COARSE_TUNE 0x0001 -//#define AL_PITCH_SHIFTER_FINE_TUNE 0x0002 -// -///* Ringmodulator effect parameters */ -//#define AL_RING_MODULATOR_FREQUENCY 0x0001 -//#define AL_RING_MODULATOR_HIGHPASS_CUTOFF 0x0002 -//#define AL_RING_MODULATOR_WAVEFORM 0x0003 -// -///* Autowah effect parameters */ -//#define AL_AUTOWAH_ATTACK_TIME 0x0001 -//#define AL_AUTOWAH_RELEASE_TIME 0x0002 -//#define AL_AUTOWAH_RESONANCE 0x0003 -//#define AL_AUTOWAH_PEAK_GAIN 0x0004 -// -///* Compressor effect parameters */ -//#define AL_COMPRESSOR_ONOFF 0x0001 -// -///* Equalizer effect parameters */ -//#define AL_EQUALIZER_LOW_GAIN 0x0001 -//#define AL_EQUALIZER_LOW_CUTOFF 0x0002 -//#define AL_EQUALIZER_MID1_GAIN 0x0003 -//#define AL_EQUALIZER_MID1_CENTER 0x0004 -//#define AL_EQUALIZER_MID1_WIDTH 0x0005 -//#define AL_EQUALIZER_MID2_GAIN 0x0006 -//#define AL_EQUALIZER_MID2_CENTER 0x0007 -//#define AL_EQUALIZER_MID2_WIDTH 0x0008 -//#define AL_EQUALIZER_HIGH_GAIN 0x0009 -//#define AL_EQUALIZER_HIGH_CUTOFF 0x000A -// -///* Effect type */ -//#define AL_EFFECT_FIRST_PARAMETER 0x0000 -//#define AL_EFFECT_LAST_PARAMETER 0x8000 - static final int AL_EFFECT_TYPE = 0x8001; -// -///* Effect types, used with the AL_EFFECT_TYPE property */ -//#define AL_EFFECT_NULL 0x0000 - static final int AL_EFFECT_REVERB = 0x0001; -//#define AL_EFFECT_CHORUS 0x0002 -//#define AL_EFFECT_DISTORTION 0x0003 -//#define AL_EFFECT_ECHO 0x0004 -//#define AL_EFFECT_FLANGER 0x0005 -//#define AL_EFFECT_FREQUENCY_SHIFTER 0x0006 -//#define AL_EFFECT_VOCAL_MORPHER 0x0007 -//#define AL_EFFECT_PITCH_SHIFTER 0x0008 -//#define AL_EFFECT_RING_MODULATOR 0x0009 -//#define AL_EFFECT_AUTOWAH 0x000A -//#define AL_EFFECT_COMPRESSOR 0x000B -//#define AL_EFFECT_EQUALIZER 0x000C -//#define AL_EFFECT_EAXREVERB 0x8000 -// -///* Auxiliary Effect Slot properties. */ - static final int AL_EFFECTSLOT_EFFECT = 0x0001; -//#define AL_EFFECTSLOT_GAIN 0x0002 -//#define AL_EFFECTSLOT_AUXILIARY_SEND_AUTO 0x0003 -// -///* NULL Auxiliary Slot ID to disable a source send. */ -//#define AL_EFFECTSLOT_NULL 0x0000 -// -// -///* Filter properties. */ -// -///* Lowpass filter parameters */ - static final int AL_LOWPASS_GAIN = 0x0001; - static final int AL_LOWPASS_GAINHF = 0x0002; -// -///* Highpass filter parameters */ -//#define AL_HIGHPASS_GAIN 0x0001 -//#define AL_HIGHPASS_GAINLF 0x0002 -// -///* Bandpass filter parameters */ -//#define AL_BANDPASS_GAIN 0x0001 -//#define AL_BANDPASS_GAINLF 0x0002 -//#define AL_BANDPASS_GAINHF 0x0003 -// -///* Filter type */ -//#define AL_FILTER_FIRST_PARAMETER 0x0000 -//#define AL_FILTER_LAST_PARAMETER 0x8000 - static final int AL_FILTER_TYPE = 0x8001; -// -///* Filter types, used with the AL_FILTER_TYPE property */ - static final int AL_FILTER_NULL = 0x0000; - static final int AL_FILTER_LOWPASS = 0x0001; - static final int AL_FILTER_HIGHPASS = 0x0002; -//#define AL_FILTER_BANDPASS 0x0003 -// -///* Filter ranges and defaults. */ -// -///* Lowpass filter */ -//#define AL_LOWPASS_MIN_GAIN (0.0f) -//#define AL_LOWPASS_MAX_GAIN (1.0f) -//#define AL_LOWPASS_DEFAULT_GAIN (1.0f) -// -//#define AL_LOWPASS_MIN_GAINHF (0.0f) -//#define AL_LOWPASS_MAX_GAINHF (1.0f) -//#define AL_LOWPASS_DEFAULT_GAINHF (1.0f) -// -///* Highpass filter */ -//#define AL_HIGHPASS_MIN_GAIN (0.0f) -//#define AL_HIGHPASS_MAX_GAIN (1.0f) -//#define AL_HIGHPASS_DEFAULT_GAIN (1.0f) -// -//#define AL_HIGHPASS_MIN_GAINLF (0.0f) -//#define AL_HIGHPASS_MAX_GAINLF (1.0f) -//#define AL_HIGHPASS_DEFAULT_GAINLF (1.0f) -// -///* Bandpass filter */ -//#define AL_BANDPASS_MIN_GAIN (0.0f) -//#define AL_BANDPASS_MAX_GAIN (1.0f) -//#define AL_BANDPASS_DEFAULT_GAIN (1.0f) -// -//#define AL_BANDPASS_MIN_GAINHF (0.0f) -//#define AL_BANDPASS_MAX_GAINHF (1.0f) -//#define AL_BANDPASS_DEFAULT_GAINHF (1.0f) -// -//#define AL_BANDPASS_MIN_GAINLF (0.0f) -//#define AL_BANDPASS_MAX_GAINLF (1.0f) -//#define AL_BANDPASS_DEFAULT_GAINLF (1.0f) -// -// -///* Effect parameter ranges and defaults. */ -// -///* Standard reverb effect */ -//#define AL_REVERB_MIN_DENSITY (0.0f) -//#define AL_REVERB_MAX_DENSITY (1.0f) -//#define AL_REVERB_DEFAULT_DENSITY (1.0f) -// -//#define AL_REVERB_MIN_DIFFUSION (0.0f) -//#define AL_REVERB_MAX_DIFFUSION (1.0f) -//#define AL_REVERB_DEFAULT_DIFFUSION (1.0f) -// -//#define AL_REVERB_MIN_GAIN (0.0f) -//#define AL_REVERB_MAX_GAIN (1.0f) -//#define AL_REVERB_DEFAULT_GAIN (0.32f) -// -//#define AL_REVERB_MIN_GAINHF (0.0f) -//#define AL_REVERB_MAX_GAINHF (1.0f) -//#define AL_REVERB_DEFAULT_GAINHF (0.89f) -// -//#define AL_REVERB_MIN_DECAY_TIME (0.1f) -//#define AL_REVERB_MAX_DECAY_TIME (20.0f) -//#define AL_REVERB_DEFAULT_DECAY_TIME (1.49f) -// -//#define AL_REVERB_MIN_DECAY_HFRATIO (0.1f) -//#define AL_REVERB_MAX_DECAY_HFRATIO (2.0f) -//#define AL_REVERB_DEFAULT_DECAY_HFRATIO (0.83f) -// -//#define AL_REVERB_MIN_REFLECTIONS_GAIN (0.0f) -//#define AL_REVERB_MAX_REFLECTIONS_GAIN (3.16f) -//#define AL_REVERB_DEFAULT_REFLECTIONS_GAIN (0.05f) -// -//#define AL_REVERB_MIN_REFLECTIONS_DELAY (0.0f) -//#define AL_REVERB_MAX_REFLECTIONS_DELAY (0.3f) -//#define AL_REVERB_DEFAULT_REFLECTIONS_DELAY (0.007f) -// -//#define AL_REVERB_MIN_LATE_REVERB_GAIN (0.0f) -//#define AL_REVERB_MAX_LATE_REVERB_GAIN (10.0f) -//#define AL_REVERB_DEFAULT_LATE_REVERB_GAIN (1.26f) -// -//#define AL_REVERB_MIN_LATE_REVERB_DELAY (0.0f) -//#define AL_REVERB_MAX_LATE_REVERB_DELAY (0.1f) -//#define AL_REVERB_DEFAULT_LATE_REVERB_DELAY (0.011f) -// -//#define AL_REVERB_MIN_AIR_ABSORPTION_GAINHF (0.892f) -//#define AL_REVERB_MAX_AIR_ABSORPTION_GAINHF (1.0f) -//#define AL_REVERB_DEFAULT_AIR_ABSORPTION_GAINHF (0.994f) -// -//#define AL_REVERB_MIN_ROOM_ROLLOFF_FACTOR (0.0f) -//#define AL_REVERB_MAX_ROOM_ROLLOFF_FACTOR (10.0f) -//#define AL_REVERB_DEFAULT_ROOM_ROLLOFF_FACTOR (0.0f) -// -//#define AL_REVERB_MIN_DECAY_HFLIMIT AL_FALSE -//#define AL_REVERB_MAX_DECAY_HFLIMIT AL_TRUE -//#define AL_REVERB_DEFAULT_DECAY_HFLIMIT AL_TRUE -// -///* EAX reverb effect */ -//#define AL_EAXREVERB_MIN_DENSITY (0.0f) -//#define AL_EAXREVERB_MAX_DENSITY (1.0f) -//#define AL_EAXREVERB_DEFAULT_DENSITY (1.0f) -// -//#define AL_EAXREVERB_MIN_DIFFUSION (0.0f) -//#define AL_EAXREVERB_MAX_DIFFUSION (1.0f) -//#define AL_EAXREVERB_DEFAULT_DIFFUSION (1.0f) -// -//#define AL_EAXREVERB_MIN_GAIN (0.0f) -//#define AL_EAXREVERB_MAX_GAIN (1.0f) -//#define AL_EAXREVERB_DEFAULT_GAIN (0.32f) -// -//#define AL_EAXREVERB_MIN_GAINHF (0.0f) -//#define AL_EAXREVERB_MAX_GAINHF (1.0f) -//#define AL_EAXREVERB_DEFAULT_GAINHF (0.89f) -// -//#define AL_EAXREVERB_MIN_GAINLF (0.0f) -//#define AL_EAXREVERB_MAX_GAINLF (1.0f) -//#define AL_EAXREVERB_DEFAULT_GAINLF (1.0f) -// -//#define AL_EAXREVERB_MIN_DECAY_TIME (0.1f) -//#define AL_EAXREVERB_MAX_DECAY_TIME (20.0f) -//#define AL_EAXREVERB_DEFAULT_DECAY_TIME (1.49f) -// -//#define AL_EAXREVERB_MIN_DECAY_HFRATIO (0.1f) -//#define AL_EAXREVERB_MAX_DECAY_HFRATIO (2.0f) -//#define AL_EAXREVERB_DEFAULT_DECAY_HFRATIO (0.83f) -// -//#define AL_EAXREVERB_MIN_DECAY_LFRATIO (0.1f) -//#define AL_EAXREVERB_MAX_DECAY_LFRATIO (2.0f) -//#define AL_EAXREVERB_DEFAULT_DECAY_LFRATIO (1.0f) -// -//#define AL_EAXREVERB_MIN_REFLECTIONS_GAIN (0.0f) -//#define AL_EAXREVERB_MAX_REFLECTIONS_GAIN (3.16f) -//#define AL_EAXREVERB_DEFAULT_REFLECTIONS_GAIN (0.05f) -// -//#define AL_EAXREVERB_MIN_REFLECTIONS_DELAY (0.0f) -//#define AL_EAXREVERB_MAX_REFLECTIONS_DELAY (0.3f) -//#define AL_EAXREVERB_DEFAULT_REFLECTIONS_DELAY (0.007f) -// -//#define AL_EAXREVERB_DEFAULT_REFLECTIONS_PAN_XYZ (0.0f) -// -//#define AL_EAXREVERB_MIN_LATE_REVERB_GAIN (0.0f) -//#define AL_EAXREVERB_MAX_LATE_REVERB_GAIN (10.0f) -//#define AL_EAXREVERB_DEFAULT_LATE_REVERB_GAIN (1.26f) -// -//#define AL_EAXREVERB_MIN_LATE_REVERB_DELAY (0.0f) -//#define AL_EAXREVERB_MAX_LATE_REVERB_DELAY (0.1f) -//#define AL_EAXREVERB_DEFAULT_LATE_REVERB_DELAY (0.011f) -// -//#define AL_EAXREVERB_DEFAULT_LATE_REVERB_PAN_XYZ (0.0f) -// -//#define AL_EAXREVERB_MIN_ECHO_TIME (0.075f) -//#define AL_EAXREVERB_MAX_ECHO_TIME (0.25f) -//#define AL_EAXREVERB_DEFAULT_ECHO_TIME (0.25f) -// -//#define AL_EAXREVERB_MIN_ECHO_DEPTH (0.0f) -//#define AL_EAXREVERB_MAX_ECHO_DEPTH (1.0f) -//#define AL_EAXREVERB_DEFAULT_ECHO_DEPTH (0.0f) -// -//#define AL_EAXREVERB_MIN_MODULATION_TIME (0.04f) -//#define AL_EAXREVERB_MAX_MODULATION_TIME (4.0f) -//#define AL_EAXREVERB_DEFAULT_MODULATION_TIME (0.25f) -// -//#define AL_EAXREVERB_MIN_MODULATION_DEPTH (0.0f) -//#define AL_EAXREVERB_MAX_MODULATION_DEPTH (1.0f) -//#define AL_EAXREVERB_DEFAULT_MODULATION_DEPTH (0.0f) -// -//#define AL_EAXREVERB_MIN_AIR_ABSORPTION_GAINHF (0.892f) -//#define AL_EAXREVERB_MAX_AIR_ABSORPTION_GAINHF (1.0f) -//#define AL_EAXREVERB_DEFAULT_AIR_ABSORPTION_GAINHF (0.994f) -// -//#define AL_EAXREVERB_MIN_HFREFERENCE (1000.0f) -//#define AL_EAXREVERB_MAX_HFREFERENCE (20000.0f) -//#define AL_EAXREVERB_DEFAULT_HFREFERENCE (5000.0f) -// -//#define AL_EAXREVERB_MIN_LFREFERENCE (20.0f) -//#define AL_EAXREVERB_MAX_LFREFERENCE (1000.0f) -//#define AL_EAXREVERB_DEFAULT_LFREFERENCE (250.0f) -// -//#define AL_EAXREVERB_MIN_ROOM_ROLLOFF_FACTOR (0.0f) -//#define AL_EAXREVERB_MAX_ROOM_ROLLOFF_FACTOR (10.0f) -//#define AL_EAXREVERB_DEFAULT_ROOM_ROLLOFF_FACTOR (0.0f) -// -//#define AL_EAXREVERB_MIN_DECAY_HFLIMIT AL_FALSE -//#define AL_EAXREVERB_MAX_DECAY_HFLIMIT AL_TRUE -//#define AL_EAXREVERB_DEFAULT_DECAY_HFLIMIT AL_TRUE -// -///* Chorus effect */ -//#define AL_CHORUS_WAVEFORM_SINUSOID (0) -//#define AL_CHORUS_WAVEFORM_TRIANGLE (1) -// -//#define AL_CHORUS_MIN_WAVEFORM (0) -//#define AL_CHORUS_MAX_WAVEFORM (1) -//#define AL_CHORUS_DEFAULT_WAVEFORM (1) -// -//#define AL_CHORUS_MIN_PHASE (-180) -//#define AL_CHORUS_MAX_PHASE (180) -//#define AL_CHORUS_DEFAULT_PHASE (90) -// -//#define AL_CHORUS_MIN_RATE (0.0f) -//#define AL_CHORUS_MAX_RATE (10.0f) -//#define AL_CHORUS_DEFAULT_RATE (1.1f) -// -//#define AL_CHORUS_MIN_DEPTH (0.0f) -//#define AL_CHORUS_MAX_DEPTH (1.0f) -//#define AL_CHORUS_DEFAULT_DEPTH (0.1f) -// -//#define AL_CHORUS_MIN_FEEDBACK (-1.0f) -//#define AL_CHORUS_MAX_FEEDBACK (1.0f) -//#define AL_CHORUS_DEFAULT_FEEDBACK (0.25f) -// -//#define AL_CHORUS_MIN_DELAY (0.0f) -//#define AL_CHORUS_MAX_DELAY (0.016f) -//#define AL_CHORUS_DEFAULT_DELAY (0.016f) -// -///* Distortion effect */ -//#define AL_DISTORTION_MIN_EDGE (0.0f) -//#define AL_DISTORTION_MAX_EDGE (1.0f) -//#define AL_DISTORTION_DEFAULT_EDGE (0.2f) -// -//#define AL_DISTORTION_MIN_GAIN (0.01f) -//#define AL_DISTORTION_MAX_GAIN (1.0f) -//#define AL_DISTORTION_DEFAULT_GAIN (0.05f) -// -//#define AL_DISTORTION_MIN_LOWPASS_CUTOFF (80.0f) -//#define AL_DISTORTION_MAX_LOWPASS_CUTOFF (24000.0f) -//#define AL_DISTORTION_DEFAULT_LOWPASS_CUTOFF (8000.0f) -// -//#define AL_DISTORTION_MIN_EQCENTER (80.0f) -//#define AL_DISTORTION_MAX_EQCENTER (24000.0f) -//#define AL_DISTORTION_DEFAULT_EQCENTER (3600.0f) -// -//#define AL_DISTORTION_MIN_EQBANDWIDTH (80.0f) -//#define AL_DISTORTION_MAX_EQBANDWIDTH (24000.0f) -//#define AL_DISTORTION_DEFAULT_EQBANDWIDTH (3600.0f) -// -///* Echo effect */ -//#define AL_ECHO_MIN_DELAY (0.0f) -//#define AL_ECHO_MAX_DELAY (0.207f) -//#define AL_ECHO_DEFAULT_DELAY (0.1f) -// -//#define AL_ECHO_MIN_LRDELAY (0.0f) -//#define AL_ECHO_MAX_LRDELAY (0.404f) -//#define AL_ECHO_DEFAULT_LRDELAY (0.1f) -// -//#define AL_ECHO_MIN_DAMPING (0.0f) -//#define AL_ECHO_MAX_DAMPING (0.99f) -//#define AL_ECHO_DEFAULT_DAMPING (0.5f) -// -//#define AL_ECHO_MIN_FEEDBACK (0.0f) -//#define AL_ECHO_MAX_FEEDBACK (1.0f) -//#define AL_ECHO_DEFAULT_FEEDBACK (0.5f) -// -//#define AL_ECHO_MIN_SPREAD (-1.0f) -//#define AL_ECHO_MAX_SPREAD (1.0f) -//#define AL_ECHO_DEFAULT_SPREAD (-1.0f) -// -///* Flanger effect */ -//#define AL_FLANGER_WAVEFORM_SINUSOID (0) -//#define AL_FLANGER_WAVEFORM_TRIANGLE (1) -// -//#define AL_FLANGER_MIN_WAVEFORM (0) -//#define AL_FLANGER_MAX_WAVEFORM (1) -//#define AL_FLANGER_DEFAULT_WAVEFORM (1) -// -//#define AL_FLANGER_MIN_PHASE (-180) -//#define AL_FLANGER_MAX_PHASE (180) -//#define AL_FLANGER_DEFAULT_PHASE (0) -// -//#define AL_FLANGER_MIN_RATE (0.0f) -//#define AL_FLANGER_MAX_RATE (10.0f) -//#define AL_FLANGER_DEFAULT_RATE (0.27f) -// -//#define AL_FLANGER_MIN_DEPTH (0.0f) -//#define AL_FLANGER_MAX_DEPTH (1.0f) -//#define AL_FLANGER_DEFAULT_DEPTH (1.0f) -// -//#define AL_FLANGER_MIN_FEEDBACK (-1.0f) -//#define AL_FLANGER_MAX_FEEDBACK (1.0f) -//#define AL_FLANGER_DEFAULT_FEEDBACK (-0.5f) -// -//#define AL_FLANGER_MIN_DELAY (0.0f) -//#define AL_FLANGER_MAX_DELAY (0.004f) -//#define AL_FLANGER_DEFAULT_DELAY (0.002f) -// -///* Frequency shifter effect */ -//#define AL_FREQUENCY_SHIFTER_MIN_FREQUENCY (0.0f) -//#define AL_FREQUENCY_SHIFTER_MAX_FREQUENCY (24000.0f) -//#define AL_FREQUENCY_SHIFTER_DEFAULT_FREQUENCY (0.0f) -// -//#define AL_FREQUENCY_SHIFTER_MIN_LEFT_DIRECTION (0) -//#define AL_FREQUENCY_SHIFTER_MAX_LEFT_DIRECTION (2) -//#define AL_FREQUENCY_SHIFTER_DEFAULT_LEFT_DIRECTION (0) -// -//#define AL_FREQUENCY_SHIFTER_DIRECTION_DOWN (0) -//#define AL_FREQUENCY_SHIFTER_DIRECTION_UP (1) -//#define AL_FREQUENCY_SHIFTER_DIRECTION_OFF (2) -// -//#define AL_FREQUENCY_SHIFTER_MIN_RIGHT_DIRECTION (0) -//#define AL_FREQUENCY_SHIFTER_MAX_RIGHT_DIRECTION (2) -//#define AL_FREQUENCY_SHIFTER_DEFAULT_RIGHT_DIRECTION (0) -// -///* Vocal morpher effect */ -//#define AL_VOCAL_MORPHER_MIN_PHONEMEA (0) -//#define AL_VOCAL_MORPHER_MAX_PHONEMEA (29) -//#define AL_VOCAL_MORPHER_DEFAULT_PHONEMEA (0) -// -//#define AL_VOCAL_MORPHER_MIN_PHONEMEA_COARSE_TUNING (-24) -//#define AL_VOCAL_MORPHER_MAX_PHONEMEA_COARSE_TUNING (24) -//#define AL_VOCAL_MORPHER_DEFAULT_PHONEMEA_COARSE_TUNING (0) -// -//#define AL_VOCAL_MORPHER_MIN_PHONEMEB (0) -//#define AL_VOCAL_MORPHER_MAX_PHONEMEB (29) -//#define AL_VOCAL_MORPHER_DEFAULT_PHONEMEB (10) -// -//#define AL_VOCAL_MORPHER_MIN_PHONEMEB_COARSE_TUNING (-24) -//#define AL_VOCAL_MORPHER_MAX_PHONEMEB_COARSE_TUNING (24) -//#define AL_VOCAL_MORPHER_DEFAULT_PHONEMEB_COARSE_TUNING (0) -// -//#define AL_VOCAL_MORPHER_PHONEME_A (0) -//#define AL_VOCAL_MORPHER_PHONEME_E (1) -//#define AL_VOCAL_MORPHER_PHONEME_I (2) -//#define AL_VOCAL_MORPHER_PHONEME_O (3) -//#define AL_VOCAL_MORPHER_PHONEME_U (4) -//#define AL_VOCAL_MORPHER_PHONEME_AA (5) -//#define AL_VOCAL_MORPHER_PHONEME_AE (6) -//#define AL_VOCAL_MORPHER_PHONEME_AH (7) -//#define AL_VOCAL_MORPHER_PHONEME_AO (8) -//#define AL_VOCAL_MORPHER_PHONEME_EH (9) -//#define AL_VOCAL_MORPHER_PHONEME_ER (10) -//#define AL_VOCAL_MORPHER_PHONEME_IH (11) -//#define AL_VOCAL_MORPHER_PHONEME_IY (12) -//#define AL_VOCAL_MORPHER_PHONEME_UH (13) -//#define AL_VOCAL_MORPHER_PHONEME_UW (14) -//#define AL_VOCAL_MORPHER_PHONEME_B (15) -//#define AL_VOCAL_MORPHER_PHONEME_D (16) -//#define AL_VOCAL_MORPHER_PHONEME_F (17) -//#define AL_VOCAL_MORPHER_PHONEME_G (18) -//#define AL_VOCAL_MORPHER_PHONEME_J (19) -//#define AL_VOCAL_MORPHER_PHONEME_K (20) -//#define AL_VOCAL_MORPHER_PHONEME_L (21) -//#define AL_VOCAL_MORPHER_PHONEME_M (22) -//#define AL_VOCAL_MORPHER_PHONEME_N (23) -//#define AL_VOCAL_MORPHER_PHONEME_P (24) -//#define AL_VOCAL_MORPHER_PHONEME_R (25) -//#define AL_VOCAL_MORPHER_PHONEME_S (26) -//#define AL_VOCAL_MORPHER_PHONEME_T (27) -//#define AL_VOCAL_MORPHER_PHONEME_V (28) -//#define AL_VOCAL_MORPHER_PHONEME_Z (29) -// -//#define AL_VOCAL_MORPHER_WAVEFORM_SINUSOID (0) -//#define AL_VOCAL_MORPHER_WAVEFORM_TRIANGLE (1) -//#define AL_VOCAL_MORPHER_WAVEFORM_SAWTOOTH (2) -// -//#define AL_VOCAL_MORPHER_MIN_WAVEFORM (0) -//#define AL_VOCAL_MORPHER_MAX_WAVEFORM (2) -//#define AL_VOCAL_MORPHER_DEFAULT_WAVEFORM (0) -// -//#define AL_VOCAL_MORPHER_MIN_RATE (0.0f) -//#define AL_VOCAL_MORPHER_MAX_RATE (10.0f) -//#define AL_VOCAL_MORPHER_DEFAULT_RATE (1.41f) -// -///* Pitch shifter effect */ -//#define AL_PITCH_SHIFTER_MIN_COARSE_TUNE (-12) -//#define AL_PITCH_SHIFTER_MAX_COARSE_TUNE (12) -//#define AL_PITCH_SHIFTER_DEFAULT_COARSE_TUNE (12) -// -//#define AL_PITCH_SHIFTER_MIN_FINE_TUNE (-50) -//#define AL_PITCH_SHIFTER_MAX_FINE_TUNE (50) -//#define AL_PITCH_SHIFTER_DEFAULT_FINE_TUNE (0) -// -///* Ring modulator effect */ -//#define AL_RING_MODULATOR_MIN_FREQUENCY (0.0f) -//#define AL_RING_MODULATOR_MAX_FREQUENCY (8000.0f) -//#define AL_RING_MODULATOR_DEFAULT_FREQUENCY (440.0f) -// -//#define AL_RING_MODULATOR_MIN_HIGHPASS_CUTOFF (0.0f) -//#define AL_RING_MODULATOR_MAX_HIGHPASS_CUTOFF (24000.0f) -//#define AL_RING_MODULATOR_DEFAULT_HIGHPASS_CUTOFF (800.0f) -// -//#define AL_RING_MODULATOR_SINUSOID (0) -//#define AL_RING_MODULATOR_SAWTOOTH (1) -//#define AL_RING_MODULATOR_SQUARE (2) -// -//#define AL_RING_MODULATOR_MIN_WAVEFORM (0) -//#define AL_RING_MODULATOR_MAX_WAVEFORM (2) -//#define AL_RING_MODULATOR_DEFAULT_WAVEFORM (0) -// -///* Autowah effect */ -//#define AL_AUTOWAH_MIN_ATTACK_TIME (0.0001f) -//#define AL_AUTOWAH_MAX_ATTACK_TIME (1.0f) -//#define AL_AUTOWAH_DEFAULT_ATTACK_TIME (0.06f) -// -//#define AL_AUTOWAH_MIN_RELEASE_TIME (0.0001f) -//#define AL_AUTOWAH_MAX_RELEASE_TIME (1.0f) -//#define AL_AUTOWAH_DEFAULT_RELEASE_TIME (0.06f) -// -//#define AL_AUTOWAH_MIN_RESONANCE (2.0f) -//#define AL_AUTOWAH_MAX_RESONANCE (1000.0f) -//#define AL_AUTOWAH_DEFAULT_RESONANCE (1000.0f) -// -//#define AL_AUTOWAH_MIN_PEAK_GAIN (0.00003f) -//#define AL_AUTOWAH_MAX_PEAK_GAIN (31621.0f) -//#define AL_AUTOWAH_DEFAULT_PEAK_GAIN (11.22f) -// -///* Compressor effect */ -//#define AL_COMPRESSOR_MIN_ONOFF (0) -//#define AL_COMPRESSOR_MAX_ONOFF (1) -//#define AL_COMPRESSOR_DEFAULT_ONOFF (1) -// -///* Equalizer effect */ -//#define AL_EQUALIZER_MIN_LOW_GAIN (0.126f) -//#define AL_EQUALIZER_MAX_LOW_GAIN (7.943f) -//#define AL_EQUALIZER_DEFAULT_LOW_GAIN (1.0f) -// -//#define AL_EQUALIZER_MIN_LOW_CUTOFF (50.0f) -//#define AL_EQUALIZER_MAX_LOW_CUTOFF (800.0f) -//#define AL_EQUALIZER_DEFAULT_LOW_CUTOFF (200.0f) -// -//#define AL_EQUALIZER_MIN_MID1_GAIN (0.126f) -//#define AL_EQUALIZER_MAX_MID1_GAIN (7.943f) -//#define AL_EQUALIZER_DEFAULT_MID1_GAIN (1.0f) -// -//#define AL_EQUALIZER_MIN_MID1_CENTER (200.0f) -//#define AL_EQUALIZER_MAX_MID1_CENTER (3000.0f) -//#define AL_EQUALIZER_DEFAULT_MID1_CENTER (500.0f) -// -//#define AL_EQUALIZER_MIN_MID1_WIDTH (0.01f) -//#define AL_EQUALIZER_MAX_MID1_WIDTH (1.0f) -//#define AL_EQUALIZER_DEFAULT_MID1_WIDTH (1.0f) -// -//#define AL_EQUALIZER_MIN_MID2_GAIN (0.126f) -//#define AL_EQUALIZER_MAX_MID2_GAIN (7.943f) -//#define AL_EQUALIZER_DEFAULT_MID2_GAIN (1.0f) -// -//#define AL_EQUALIZER_MIN_MID2_CENTER (1000.0f) -//#define AL_EQUALIZER_MAX_MID2_CENTER (8000.0f) -//#define AL_EQUALIZER_DEFAULT_MID2_CENTER (3000.0f) -// -//#define AL_EQUALIZER_MIN_MID2_WIDTH (0.01f) -//#define AL_EQUALIZER_MAX_MID2_WIDTH (1.0f) -//#define AL_EQUALIZER_DEFAULT_MID2_WIDTH (1.0f) -// -//#define AL_EQUALIZER_MIN_HIGH_GAIN (0.126f) -//#define AL_EQUALIZER_MAX_HIGH_GAIN (7.943f) -//#define AL_EQUALIZER_DEFAULT_HIGH_GAIN (1.0f) -// -//#define AL_EQUALIZER_MIN_HIGH_CUTOFF (4000.0f) -//#define AL_EQUALIZER_MAX_HIGH_CUTOFF (16000.0f) -//#define AL_EQUALIZER_DEFAULT_HIGH_CUTOFF (6000.0f) -// -// -///* Source parameter value ranges and defaults. */ -//#define AL_MIN_AIR_ABSORPTION_FACTOR (0.0f) -//#define AL_MAX_AIR_ABSORPTION_FACTOR (10.0f) -//#define AL_DEFAULT_AIR_ABSORPTION_FACTOR (0.0f) -// -//#define AL_MIN_ROOM_ROLLOFF_FACTOR (0.0f) -//#define AL_MAX_ROOM_ROLLOFF_FACTOR (10.0f) -//#define AL_DEFAULT_ROOM_ROLLOFF_FACTOR (0.0f) -// -//#define AL_MIN_CONE_OUTER_GAINHF (0.0f) -//#define AL_MAX_CONE_OUTER_GAINHF (1.0f) -//#define AL_DEFAULT_CONE_OUTER_GAINHF (1.0f) -// -//#define AL_MIN_DIRECT_FILTER_GAINHF_AUTO AL_FALSE -//#define AL_MAX_DIRECT_FILTER_GAINHF_AUTO AL_TRUE -//#define AL_DEFAULT_DIRECT_FILTER_GAINHF_AUTO AL_TRUE -// -//#define AL_MIN_AUXILIARY_SEND_FILTER_GAIN_AUTO AL_FALSE -//#define AL_MAX_AUXILIARY_SEND_FILTER_GAIN_AUTO AL_TRUE -//#define AL_DEFAULT_AUXILIARY_SEND_FILTER_GAIN_AUTO AL_TRUE -// -//#define AL_MIN_AUXILIARY_SEND_FILTER_GAINHF_AUTO AL_FALSE -//#define AL_MAX_AUXILIARY_SEND_FILTER_GAINHF_AUTO AL_TRUE -//#define AL_DEFAULT_AUXILIARY_SEND_FILTER_GAINHF_AUTO AL_TRUE -// -// -///* Listener parameter value ranges and defaults. */ -//#define AL_MIN_METERS_PER_UNIT FLT_MIN -//#define AL_MAX_METERS_PER_UNIT FLT_MAX -//#define AL_DEFAULT_METERS_PER_UNIT (1.0f) - - - public static String GetALErrorMsg(int errorCode) { - String errorText; - switch (errorCode) { - case AL_NO_ERROR: - errorText = "No Error"; - break; - case AL_INVALID_NAME: - errorText = "Invalid Name"; - break; - case AL_INVALID_ENUM: - errorText = "Invalid Enum"; - break; - case AL_INVALID_VALUE: - errorText = "Invalid Value"; - break; - case AL_INVALID_OPERATION: - errorText = "Invalid Operation"; - break; - case AL_OUT_OF_MEMORY: - errorText = "Out of Memory"; - break; - default: - errorText = "Unknown Error Code: " + String.valueOf(errorCode); - } - return errorText; - } -} - diff --git a/jme3-ios/src/main/java/com/jme3/audio/android/AndroidAudioData.java b/jme3-ios/src/main/java/com/jme3/audio/android/AndroidAudioData.java deleted file mode 100644 index e7f4a0f98..000000000 --- a/jme3-ios/src/main/java/com/jme3/audio/android/AndroidAudioData.java +++ /dev/null @@ -1,67 +0,0 @@ -package com.jme3.audio.android; - -import com.jme3.asset.AssetKey; -import com.jme3.audio.AudioData; -import com.jme3.audio.AudioRenderer; -import com.jme3.util.NativeObject; - -public class AndroidAudioData extends AudioData { - - protected AssetKey assetKey; - protected float currentVolume = 0f; - - public AndroidAudioData(){ - super(); - } - - protected AndroidAudioData(int id){ - super(id); - } - - public AssetKey getAssetKey() { - return assetKey; - } - - public void setAssetKey(AssetKey assetKey) { - this.assetKey = assetKey; - } - - @Override - public DataType getDataType() { - return DataType.Buffer; - } - - @Override - public float getDuration() { - return 0; // TODO: ??? - } - - @Override - public void resetObject() { - this.id = -1; - setUpdateNeeded(); - } - - @Override - public void deleteObject(Object rendererObject) { - ((AudioRenderer)rendererObject).deleteAudioData(this); - } - - public float getCurrentVolume() { - return currentVolume; - } - - public void setCurrentVolume(float currentVolume) { - this.currentVolume = currentVolume; - } - - @Override - public NativeObject createDestructableClone() { - return new AndroidAudioData(id); - } - - @Override - public long getUniqueId() { - return ((long)OBJTYPE_AUDIOBUFFER << 32) | ((long)id); - } -} diff --git a/jme3-ios/src/main/java/com/jme3/audio/ios/IosAL.java b/jme3-ios/src/main/java/com/jme3/audio/ios/IosAL.java new file mode 100644 index 000000000..7812dc748 --- /dev/null +++ b/jme3-ios/src/main/java/com/jme3/audio/ios/IosAL.java @@ -0,0 +1,53 @@ +package com.jme3.audio.ios; + +import com.jme3.audio.openal.AL; +import java.nio.ByteBuffer; +import java.nio.FloatBuffer; +import java.nio.IntBuffer; + +public final class IosAL implements AL { + + public IosAL() { + } + + public native String alGetString(int parameter); + + public native int alGenSources(); + + public native int alGetError(); + + public native void alDeleteSources(int numSources, IntBuffer sources); + + public native void alGenBuffers(int numBuffers, IntBuffer buffers); + + public native void alDeleteBuffers(int numBuffers, IntBuffer buffers); + + public native void alSourceStop(int source); + + public native void alSourcei(int source, int param, int value); + + public native void alBufferData(int buffer, int format, ByteBuffer data, int size, int frequency); + + public native void alSourcePlay(int source); + + public native void alSourcePause(int source); + + public native void alSourcef(int source, int param, float value); + + public native void alSource3f(int source, int param, float value1, float value2, float value3); + + public native int alGetSourcei(int source, int param); + + public native void alSourceUnqueueBuffers(int source, int numBuffers, IntBuffer buffers); + + public native void alSourceQueueBuffers(int source, int numBuffers, IntBuffer buffers); + + public native void alListener(int param, FloatBuffer data); + + public native void alListenerf(int param, float value); + + public native void alListener3f(int param, float value1, float value2, float value3); + + public native void alSource3i(int source, int param, int value1, int value2, int value3); + +} diff --git a/jme3-ios/src/main/java/com/jme3/audio/ios/IosALC.java b/jme3-ios/src/main/java/com/jme3/audio/ios/IosALC.java new file mode 100644 index 000000000..f1579c9e5 --- /dev/null +++ b/jme3-ios/src/main/java/com/jme3/audio/ios/IosALC.java @@ -0,0 +1,26 @@ +package com.jme3.audio.ios; + +import com.jme3.audio.openal.ALC; +import java.nio.IntBuffer; + +public final class IosALC implements ALC { + + public IosALC() { + } + + public native void createALC(); + + public native void destroyALC(); + + public native boolean isCreated(); + + public native String alcGetString(int parameter); + + public native boolean alcIsExtensionPresent(String extension); + + public native void alcGetInteger(int param, IntBuffer buffer, int size); + + public native void alcDevicePauseSOFT(); + + public native void alcDeviceResumeSOFT(); +} diff --git a/jme3-ios/src/main/java/com/jme3/audio/ios/IosEFX.java b/jme3-ios/src/main/java/com/jme3/audio/ios/IosEFX.java new file mode 100644 index 000000000..d7a569c1f --- /dev/null +++ b/jme3-ios/src/main/java/com/jme3/audio/ios/IosEFX.java @@ -0,0 +1,32 @@ +package com.jme3.audio.ios; + +import com.jme3.audio.openal.EFX; +import java.nio.IntBuffer; + +public class IosEFX implements EFX { + + public IosEFX() { + } + + public native void alGenAuxiliaryEffectSlots(int numSlots, IntBuffer buffers); + + public native void alGenEffects(int numEffects, IntBuffer buffers); + + public native void alEffecti(int effect, int param, int value); + + public native void alAuxiliaryEffectSloti(int effectSlot, int param, int value); + + public native void alDeleteEffects(int numEffects, IntBuffer buffers); + + public native void alDeleteAuxiliaryEffectSlots(int numEffectSlots, IntBuffer buffers); + + public native void alGenFilters(int numFilters, IntBuffer buffers); + + public native void alFilteri(int filter, int param, int value); + + public native void alFilterf(int filter, int param, float value); + + public native void alDeleteFilters(int numFilters, IntBuffer buffers); + + public native void alEffectf(int effect, int param, float value); +} diff --git a/jme3-ios/src/main/java/com/jme3/audio/plugins/AndroidAudioLoader.java b/jme3-ios/src/main/java/com/jme3/audio/plugins/AndroidAudioLoader.java deleted file mode 100644 index a11425b23..000000000 --- a/jme3-ios/src/main/java/com/jme3/audio/plugins/AndroidAudioLoader.java +++ /dev/null @@ -1,20 +0,0 @@ -package com.jme3.audio.plugins; - -import com.jme3.asset.AssetInfo; -import com.jme3.asset.AssetLoader; -import com.jme3.audio.android.AndroidAudioData; -import java.io.IOException; - -/** - * AndroidAudioLoader will create an - * {@link AndroidAudioData} object with the specified asset key. - */ -public class AndroidAudioLoader implements AssetLoader { - - @Override - public Object load(AssetInfo assetInfo) throws IOException { - AndroidAudioData result = new AndroidAudioData(); - result.setAssetKey(assetInfo.getKey()); - return result; - } -} diff --git a/jme3-ios/src/main/java/com/jme3/renderer/ios/IosGL.java b/jme3-ios/src/main/java/com/jme3/renderer/ios/IosGL.java index bf82fdff3..a9398f159 100644 --- a/jme3-ios/src/main/java/com/jme3/renderer/ios/IosGL.java +++ b/jme3-ios/src/main/java/com/jme3/renderer/ios/IosGL.java @@ -34,6 +34,7 @@ package com.jme3.renderer.ios; import com.jme3.renderer.RendererException; import com.jme3.renderer.opengl.GL; import com.jme3.renderer.opengl.GLExt; +import com.jme3.renderer.opengl.GLFbo; import java.nio.Buffer; import java.nio.BufferOverflowException; import java.nio.ByteBuffer; @@ -46,7 +47,7 @@ import java.nio.ShortBuffer; * * @author Kirill Vainer */ -public class IosGL implements GL, GLExt { +public class IosGL implements GL, GLExt, GLFbo { private final int[] temp_array = new int[16]; diff --git a/jme3-ios/src/main/java/com/jme3/system/ios/IosImageLoader.java b/jme3-ios/src/main/java/com/jme3/system/ios/IosImageLoader.java index 4ec649086..e47de3a50 100644 --- a/jme3-ios/src/main/java/com/jme3/system/ios/IosImageLoader.java +++ b/jme3-ios/src/main/java/com/jme3/system/ios/IosImageLoader.java @@ -33,6 +33,7 @@ package com.jme3.system.ios; import com.jme3.asset.AssetInfo; import com.jme3.asset.AssetLoader; +import com.jme3.asset.TextureKey; import com.jme3.texture.Image; import com.jme3.texture.Image.Format; import java.io.IOException; @@ -45,14 +46,16 @@ import java.io.InputStream; public class IosImageLoader implements AssetLoader { public Object load(AssetInfo info) throws IOException { - InputStream in = info.openStream(); + boolean flip = ((TextureKey) info.getKey()).isFlipY(); Image img = null; + InputStream in = null; try { - img = loadImageData(Image.Format.RGBA8, in); - } catch (Exception e) { - e.printStackTrace(); + in = info.openStream(); + img = loadImageData(Format.RGBA8, flip, in); } finally { - in.close(); + if (in != null) { + in.close(); + } } return img; } @@ -64,5 +67,5 @@ public class IosImageLoader implements AssetLoader { * @param inputStream the InputStream to load the image data from * @return the loaded Image */ - private static native Image loadImageData(Format format, InputStream inputStream); + private static native Image loadImageData(Format format, boolean flipY, InputStream inputStream); } diff --git a/jme3-ios/src/main/java/com/jme3/system/ios/JmeIosSystem.java b/jme3-ios/src/main/java/com/jme3/system/ios/JmeIosSystem.java index 904db71cf..d29f76f62 100644 --- a/jme3-ios/src/main/java/com/jme3/system/ios/JmeIosSystem.java +++ b/jme3-ios/src/main/java/com/jme3/system/ios/JmeIosSystem.java @@ -36,6 +36,14 @@ import com.jme3.system.AppSettings; import com.jme3.system.JmeContext; import com.jme3.system.JmeSystemDelegate; import com.jme3.system.NullContext; +import com.jme3.audio.AudioRenderer; +import com.jme3.audio.ios.IosAL; +import com.jme3.audio.ios.IosALC; +//import com.jme3.audio.ios.IosEFX; +import com.jme3.audio.openal.AL; +import com.jme3.audio.openal.ALAudioRenderer; +import com.jme3.audio.openal.ALC; +import com.jme3.audio.openal.EFX; import java.io.IOException; import java.io.OutputStream; import java.net.URL; @@ -89,8 +97,11 @@ public class JmeIosSystem extends JmeSystemDelegate { @Override public AudioRenderer newAudioRenderer(AppSettings settings) { - return null; - } + ALC alc = new IosALC(); + AL al = new IosAL(); + //EFX efx = new IosEFX(); + return new ALAudioRenderer(al, alc, null); + } @Override public void initialize(AppSettings settings) { diff --git a/jme3-ios/src/main/resources/com/jme3/asset/IOS.cfg b/jme3-ios/src/main/resources/com/jme3/asset/IOS.cfg new file mode 100644 index 000000000..4e4052447 --- /dev/null +++ b/jme3-ios/src/main/resources/com/jme3/asset/IOS.cfg @@ -0,0 +1,8 @@ +INCLUDE com/jme3/asset/General.cfg + +# IOS specific loaders +LOADER com.jme3.system.ios.IosImageLoader : jpg, bmp, gif, png, jpeg +LOADER com.jme3.material.plugins.J3MLoader : j3m, j3md +LOADER com.jme3.shader.plugins.GLSLLoader : vert, frag, glsl, glsllib +LOADER com.jme3.export.binary.BinaryImporter : j3o +LOADER com.jme3.font.plugins.BitmapFontLoader : fnt From fc8cebe17d45bb3af07127c91d5a3cc603b039e9 Mon Sep 17 00:00:00 2001 From: Maselbas Date: Sun, 26 Apr 2015 21:55:18 +0200 Subject: [PATCH 047/113] GDK SceneComposer : - The colorAll option for highlightAxisMarker will now highlight only all quads (without axis) --- .../jme3/gde/scenecomposer/SceneEditTool.java | 21 ++++++++++--------- 1 file changed, 11 insertions(+), 10 deletions(-) diff --git a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/SceneEditTool.java b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/SceneEditTool.java index 461f76c0c..5409a3603 100644 --- a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/SceneEditTool.java +++ b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/SceneEditTool.java @@ -57,7 +57,7 @@ public abstract class SceneEditTool { protected Node axisMarker; protected Material redMat, blueMat, greenMat, yellowMat, cyanMat, magentaMat, orangeMat; protected Geometry quadXY, quadXZ, quadYZ; - + protected enum AxisMarkerPickType { axisOnly, planeOnly, axisAndPlane @@ -371,16 +371,17 @@ public abstract class SceneEditTool { axisMarker.getChild("arrowY").setMaterial(orangeMat); } else if (picked == ARROW_Z) { axisMarker.getChild("arrowZ").setMaterial(orangeMat); - } + } else { - if (picked == QUAD_XY || colorAll) { - axisMarker.getChild("quadXY").setMaterial(orangeMat); - } - if (picked == QUAD_XZ || colorAll) { - axisMarker.getChild("quadXZ").setMaterial(orangeMat); - } - if (picked == QUAD_YZ || colorAll) { - axisMarker.getChild("quadYZ").setMaterial(orangeMat); + if (picked == QUAD_XY || colorAll) { + axisMarker.getChild("quadXY").setMaterial(orangeMat); + } + if (picked == QUAD_XZ || colorAll) { + axisMarker.getChild("quadXZ").setMaterial(orangeMat); + } + if (picked == QUAD_YZ || colorAll) { + axisMarker.getChild("quadYZ").setMaterial(orangeMat); + } } } From f2a92a13b381cda6d36d2a6c842ebd5e2bff94f4 Mon Sep 17 00:00:00 2001 From: Maselbas Date: Sun, 26 Apr 2015 22:14:15 +0200 Subject: [PATCH 048/113] GDK SceneComposer : - add a new file : PickManager that provide severals informations for tools. - modified the MoveTool, RotateTool and ScaleTool according with the pickManager - now local/global choice for transformations is just a step away --- .../gde/scenecomposer/tools/MoveTool.java | 112 ++++++++--- .../gde/scenecomposer/tools/PickManager.java | 182 ++++++++++++++++++ .../gde/scenecomposer/tools/RotateTool.java | 123 ++++++------ .../gde/scenecomposer/tools/ScaleTool.java | 51 +++-- 4 files changed, 363 insertions(+), 105 deletions(-) create mode 100644 sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/PickManager.java diff --git a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/MoveTool.java b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/MoveTool.java index 478a0f7c6..e0e8d009b 100644 --- a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/MoveTool.java +++ b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/MoveTool.java @@ -5,8 +5,11 @@ package com.jme3.gde.scenecomposer.tools; import com.jme3.asset.AssetManager; +import com.jme3.bullet.control.CharacterControl; +import com.jme3.bullet.control.RigidBodyControl; import com.jme3.gde.core.sceneexplorer.nodes.JmeNode; import com.jme3.gde.core.sceneexplorer.nodes.JmeSpatial; +import com.jme3.gde.core.undoredo.AbstractUndoableSceneEdit; import com.jme3.gde.scenecomposer.SceneComposerToolController; import com.jme3.gde.scenecomposer.SceneEditTool; import com.jme3.math.Vector2f; @@ -17,12 +20,11 @@ import org.openide.loaders.DataObject; import org.openide.util.Lookup; /** - * Move an object. - * When created, it generates a quad that will lie along a plane - * that the user selects for moving on. When the mouse is over - * the axisMarker, it will highlight the plane that it is over: XY,XZ,YZ. - * When clicked and then dragged, the selected object will move along that - * plane. + * Move an object. When created, it generates a quad that will lie along a plane + * that the user selects for moving on. When the mouse is over the axisMarker, + * it will highlight the plane that it is over: XY,XZ,YZ. When clicked and then + * dragged, the selected object will move along that plane. + * * @author Brent Owens */ public class MoveTool extends SceneEditTool { @@ -30,7 +32,9 @@ public class MoveTool extends SceneEditTool { private Vector3f pickedMarker; private Vector3f constraintAxis; //used for one axis move private boolean wasDragging = false; - private MoveManager moveManager; + private Vector3f startPosition; + private Vector3f lastPosition; + private PickManager pickManager; public MoveTool() { axisPickType = AxisMarkerPickType.axisAndPlane; @@ -41,7 +45,7 @@ public class MoveTool extends SceneEditTool { @Override public void activate(AssetManager manager, Node toolNode, Node onTopToolNode, Spatial selectedSpatial, SceneComposerToolController toolController) { super.activate(manager, toolNode, onTopToolNode, selectedSpatial, toolController); - moveManager = Lookup.getDefault().lookup(MoveManager.class); + pickManager = Lookup.getDefault().lookup(PickManager.class); displayPlanes(); } @@ -52,10 +56,10 @@ public class MoveTool extends SceneEditTool { pickedMarker = null; // mouse released, reset selection constraintAxis = Vector3f.UNIT_XYZ; // no constraint if (wasDragging) { - actionPerformed(moveManager.makeUndo()); + actionPerformed(new MoveUndo(toolController.getSelectedSpatial(), startPosition, lastPosition)); wasDragging = false; - } - moveManager.reset(); + } + pickManager.reset(); } } @@ -70,21 +74,21 @@ public class MoveTool extends SceneEditTool { highlightAxisMarker(camera, screenCoord, axisPickType); } else { pickedMarker = null; - moveManager.reset(); + pickManager.reset(); } } @Override public void draggedPrimary(Vector2f screenCoord, boolean pressed, JmeNode rootNode, DataObject currentDataObject) { - if (!pressed) { + if (!pressed) { setDefaultAxisMarkerColors(); pickedMarker = null; // mouse released, reset selection constraintAxis = Vector3f.UNIT_XYZ; // no constraint if (wasDragging) { - actionPerformed(moveManager.makeUndo()); + actionPerformed(new MoveUndo(toolController.getSelectedSpatial(), startPosition, lastPosition)); wasDragging = false; } - moveManager.reset(); + pickManager.reset(); return; } @@ -99,25 +103,43 @@ public class MoveTool extends SceneEditTool { } if (pickedMarker.equals(QUAD_XY)) { - moveManager.initiateMove(toolController.getSelectedSpatial(), MoveManager.XY, true); + pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_XY, + PickManager.TransformationType.local, camera, screenCoord); } else if (pickedMarker.equals(QUAD_XZ)) { - moveManager.initiateMove(toolController.getSelectedSpatial(), MoveManager.XZ, true); + pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_XZ, + PickManager.TransformationType.local, camera, screenCoord); } else if (pickedMarker.equals(QUAD_YZ)) { - moveManager.initiateMove(toolController.getSelectedSpatial(), MoveManager.YZ, true); + pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_YZ, + PickManager.TransformationType.local, camera, screenCoord); } else if (pickedMarker.equals(ARROW_X)) { - moveManager.initiateMove(toolController.getSelectedSpatial(), MoveManager.XY, true); + pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_XY, + PickManager.TransformationType.local, camera, screenCoord); constraintAxis = Vector3f.UNIT_X; // move only X } else if (pickedMarker.equals(ARROW_Y)) { - moveManager.initiateMove(toolController.getSelectedSpatial(), MoveManager.YZ, true); + pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_YZ, + PickManager.TransformationType.local, camera, screenCoord); constraintAxis = Vector3f.UNIT_Y; // move only Y } else if (pickedMarker.equals(ARROW_Z)) { - moveManager.initiateMove(toolController.getSelectedSpatial(), MoveManager.XZ, true); + pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_XZ, + PickManager.TransformationType.local, camera, screenCoord); constraintAxis = Vector3f.UNIT_Z; // move only Z } + startPosition = toolController.getSelectedSpatial().getLocalTranslation().clone(); + } - if (!moveManager.move(camera, screenCoord, constraintAxis, false)) { + if (!pickManager.updatePick(camera, screenCoord)) { return; } + Vector3f diff = Vector3f.ZERO; + if (pickedMarker.equals(QUAD_XY) || pickedMarker.equals(QUAD_XZ) || pickedMarker.equals(QUAD_YZ)) { + diff = pickManager.getTranslation(); + + } else if (pickedMarker.equals(ARROW_X) || pickedMarker.equals(ARROW_Y) || pickedMarker.equals(ARROW_Z)) { + diff = pickManager.getTranslation(constraintAxis); + } + Vector3f position = startPosition.add(diff); + lastPosition = position; + toolController.getSelectedSpatial().setLocalTranslation(position); updateToolsTransformation(); wasDragging = true; @@ -126,4 +148,50 @@ public class MoveTool extends SceneEditTool { @Override public void draggedSecondary(Vector2f screenCoord, boolean pressed, JmeNode rootNode, DataObject currentDataObject) { } + + protected class MoveUndo extends AbstractUndoableSceneEdit { + + private Spatial spatial; + private Vector3f before = new Vector3f(), after = new Vector3f(); + + MoveUndo(Spatial spatial, Vector3f before, Vector3f after) { + this.spatial = spatial; + this.before.set(before); + if (after != null) { + this.after.set(after); + } + } + + @Override + public void sceneUndo() { + spatial.setLocalTranslation(before); + RigidBodyControl control = spatial.getControl(RigidBodyControl.class); + if (control != null) { + control.setPhysicsLocation(spatial.getWorldTranslation()); + } + CharacterControl character = spatial.getControl(CharacterControl.class); + if (character != null) { + character.setPhysicsLocation(spatial.getWorldTranslation()); + } + // toolController.selectedSpatialTransformed(); + } + + @Override + public void sceneRedo() { + spatial.setLocalTranslation(after); + RigidBodyControl control = spatial.getControl(RigidBodyControl.class); + if (control != null) { + control.setPhysicsLocation(spatial.getWorldTranslation()); + } + CharacterControl character = spatial.getControl(CharacterControl.class); + if (character != null) { + character.setPhysicsLocation(spatial.getWorldTranslation()); + } + //toolController.selectedSpatialTransformed(); + } + + public void setAfter(Vector3f after) { + this.after.set(after); + } + } } diff --git a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/PickManager.java b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/PickManager.java new file mode 100644 index 000000000..d7075b9fe --- /dev/null +++ b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/PickManager.java @@ -0,0 +1,182 @@ +/* + * To change this license header, choose License Headers in Project Properties. + * To change this template file, choose Tools | Templates + * and open the template in the editor. + */ +package com.jme3.gde.scenecomposer.tools; + +import com.jme3.gde.scenecomposer.SceneEditTool; +import com.jme3.math.FastMath; +import com.jme3.math.Quaternion; +import com.jme3.math.Vector2f; +import com.jme3.math.Vector3f; +import com.jme3.renderer.Camera; +import com.jme3.scene.Geometry; +import com.jme3.scene.Node; +import com.jme3.scene.Spatial; +import com.jme3.scene.shape.Quad; +import org.openide.util.lookup.ServiceProvider; + +/** + * + * @author dokthar + */ +@ServiceProvider(service = PickManager.class) +public class PickManager { + + private Vector3f startPickLoc; + private Vector3f finalPickLoc; + private Vector3f startSpatialLocation; + private Quaternion origineRotation; + private final Node plane; + private Spatial spatial; + + protected static final Quaternion PLANE_XY = new Quaternion().fromAngleAxis(0, new Vector3f(1, 0, 0)); + protected static final Quaternion PLANE_YZ = new Quaternion().fromAngleAxis(-FastMath.PI / 2, new Vector3f(0, 1, 0));//YAW090 + protected static final Quaternion PLANE_XZ = new Quaternion().fromAngleAxis(FastMath.PI / 2, new Vector3f(1, 0, 0)); //PITCH090 + + public enum TransformationType { + + local, global, camera + } + + public PickManager() { + float size = 1000; + Geometry g = new Geometry("plane", new Quad(size, size)); + g.setLocalTranslation(-size / 2, -size / 2, 0); + plane = new Node(); + plane.attachChild(g); + } + + public void reset() { + startPickLoc = null; + finalPickLoc = null; + startSpatialLocation = null; + spatial = null; + } + + public void initiatePick(Spatial selectedSpatial, Quaternion planeRotation, TransformationType type, Camera camera, Vector2f screenCoord) { + spatial = selectedSpatial; + startSpatialLocation = selectedSpatial.getWorldTranslation().clone(); + + setTransformation(planeRotation, type); + plane.setLocalTranslation(startSpatialLocation); + + startPickLoc = SceneEditTool.pickWorldLocation(camera, screenCoord, plane, null); + } + + public void setTransformation(Quaternion planeRotation, TransformationType type) { + Quaternion rot = new Quaternion(); + if (type == TransformationType.local) { + rot.set(spatial.getWorldRotation()); + rot.multLocal(planeRotation); + origineRotation = spatial.getWorldRotation().clone(); + } else if (type == TransformationType.global) { + rot.set(planeRotation); + origineRotation = new Quaternion(Quaternion.IDENTITY); + } else if (type == TransformationType.camera) { + rot.set(planeRotation); + origineRotation = planeRotation.clone(); + } + plane.setLocalRotation(rot); + } + + public boolean updatePick(Camera camera, Vector2f screenCoord) { + finalPickLoc = SceneEditTool.pickWorldLocation(camera, screenCoord, plane, null); + return finalPickLoc != null; + } + + /** + * + * @return the start location in WorldSpace + */ + public Vector3f getStartLocation() { + return startSpatialLocation; + } + + /** + * + * @return the vector from the tool origin to the start location, in + * WorldSpace + */ + public Vector3f getStartOffset() { + return startPickLoc.subtract(startSpatialLocation); + } + + /** + * + * @return the vector from the tool origin to the final location, in + * WorldSpace + */ + public Vector3f getFinalOffset() { + return finalPickLoc.subtract(startSpatialLocation); + } + + /** + * + * @return the angle between the start location and the final location + */ + public float getAngle() { + Vector3f v1, v2; + v1 = startPickLoc.subtract(startSpatialLocation); + v2 = finalPickLoc.subtract(startSpatialLocation); + return v1.angleBetween(v2); + } + + /** + * + * @return the Quaternion rotation in the WorldSpace + */ + public Quaternion getRotation() { + Vector3f v1, v2; + v1 = startPickLoc.subtract(startSpatialLocation).normalize(); + v2 = finalPickLoc.subtract(startSpatialLocation).normalize(); + Vector3f axis = v1.cross(v2); + float angle = v1.angleBetween(v2); + return new Quaternion().fromAngleAxis(angle, axis); + } + + /** + * + * @return the Quaternion rotation in the ToolSpace + */ + public Quaternion getLocalRotation() { + Vector3f v1, v2; + Quaternion rot = origineRotation.inverse(); + v1 = rot.mult(startPickLoc.subtract(startSpatialLocation).normalize()); + v2 = rot.mult(finalPickLoc.subtract(startSpatialLocation).normalize()); + Vector3f axis = v1.cross(v2); + float angle = v1.angleBetween(v2); + return new Quaternion().fromAngleAxis(angle, axis); + } + + /** + * + * @return the translation in WorldSpace + */ + public Vector3f getTranslation() { + return finalPickLoc.subtract(startPickLoc); + } + + /** + * + * @param axisConstrainte + * @return + */ + public Vector3f getTranslation(Vector3f axisConstrainte) { + Vector3f localConstrainte = (origineRotation.mult(axisConstrainte)).normalize(); // according to the "plane" rotation + Vector3f constrainedTranslation = localConstrainte.mult(getTranslation().dot(localConstrainte)); + return constrainedTranslation; + } + + /** + * + * @param axisConstrainte + * @return + */ + public Vector3f getLocalTranslation(Vector3f axisConstrainte) { + //return plane.getWorldRotation().inverse().mult(getTranslation(axisConstrainte)); + return getTranslation(origineRotation.inverse().mult(axisConstrainte)); + } + +} diff --git a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/RotateTool.java b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/RotateTool.java index 3c4e27b95..343d24818 100644 --- a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/RotateTool.java +++ b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/RotateTool.java @@ -16,35 +16,38 @@ import com.jme3.math.Vector3f; import com.jme3.scene.Node; import com.jme3.scene.Spatial; import org.openide.loaders.DataObject; - +import org.openide.util.Lookup; + /** * * @author kbender */ public class RotateTool extends SceneEditTool { - - private Vector3f pickedPlane; + + private Vector3f pickedMarker; private Vector2f lastScreenCoord; private Quaternion startRotate; private Quaternion lastRotate; private boolean wasDragging = false; - + private PickManager pickManager; + public RotateTool() { - axisPickType = AxisMarkerPickType.axisAndPlane; + axisPickType = AxisMarkerPickType.planeOnly; setOverrideCameraControl(true); } - + @Override public void activate(AssetManager manager, Node toolNode, Node onTopToolNode, Spatial selectedSpatial, SceneComposerToolController toolController) { super.activate(manager, toolNode, onTopToolNode, selectedSpatial, toolController); + pickManager = Lookup.getDefault().lookup(PickManager.class); displayPlanes(); } - + @Override public void actionPrimary(Vector2f screenCoord, boolean pressed, JmeNode rootNode, DataObject dataObject) { if (!pressed) { setDefaultAxisMarkerColors(); - pickedPlane = null; // mouse released, reset selection + pickedMarker = null; // mouse released, reset selection lastScreenCoord = null; if (wasDragging) { actionPerformed(new ScaleUndo(toolController.getSelectedSpatial(), startRotate, lastRotate)); @@ -52,108 +55,94 @@ public class RotateTool extends SceneEditTool { } } } - + @Override public void actionSecondary(Vector2f screenCoord, boolean pressed, JmeNode rootNode, DataObject dataObject) { - + } - + @Override public void mouseMoved(Vector2f screenCoord, JmeNode rootNode, DataObject currentDataObject, JmeSpatial selectedSpatial) { - if (pickedPlane == null) { + if (pickedMarker == null) { highlightAxisMarker(camera, screenCoord, axisPickType); - } - else { - pickedPlane = null; + } else { + pickedMarker = null; } } - + @Override public void draggedPrimary(Vector2f screenCoord, boolean pressed, JmeNode rootNode, DataObject currentDataObject) { - + if (!pressed) { setDefaultAxisMarkerColors(); - pickedPlane = null; // mouse released, reset selection + pickedMarker = null; // mouse released, reset selection lastScreenCoord = null; - + if (wasDragging) { actionPerformed(new ScaleUndo(toolController.getSelectedSpatial(), startRotate, lastRotate)); wasDragging = false; } return; } - - if (toolController.getSelectedSpatial() == null) - { + + if (toolController.getSelectedSpatial() == null) { return; } - - if (pickedPlane == null) - { - pickedPlane = pickAxisMarker(camera, screenCoord, axisPickType); - if (pickedPlane == null) - { + + if (pickedMarker == null) { + pickedMarker = pickAxisMarker(camera, screenCoord, axisPickType); + if (pickedMarker == null) { return; } + + if (pickedMarker.equals(QUAD_XY)) { + pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_XY, + PickManager.TransformationType.local, camera, screenCoord); + } else if (pickedMarker.equals(QUAD_XZ)) { + pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_XZ, + PickManager.TransformationType.local, camera, screenCoord); + } else if (pickedMarker.equals(QUAD_YZ)) { + pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_YZ, + PickManager.TransformationType.local, camera, screenCoord); + } startRotate = toolController.getSelectedSpatial().getLocalRotation().clone(); } - - if (lastScreenCoord == null) { - lastScreenCoord = screenCoord; - } else { - Quaternion rotate = new Quaternion(); - float diff; - if(pickedPlane.equals(QUAD_XY)) - { - diff = -(screenCoord.x-lastScreenCoord.x); - diff *= 0.03f; - rotate = rotate.fromAngleAxis(diff, Vector3f.UNIT_Z); - } - else if(pickedPlane.equals(QUAD_YZ)) - { - diff = -(screenCoord.y-lastScreenCoord.y); - diff *= 0.03f; - rotate = rotate.fromAngleAxis(diff, Vector3f.UNIT_X); - } - else if(pickedPlane.equals(QUAD_XZ)) - { - diff = screenCoord.x-lastScreenCoord.x; - diff *= 0.03f; - rotate = rotate.fromAngleAxis(diff, Vector3f.UNIT_Y); - } - - lastScreenCoord = screenCoord; - Quaternion rotation = toolController.getSelectedSpatial().getLocalRotation().mult(rotate); - lastRotate = rotation; + if (!pickManager.updatePick(camera, screenCoord)) { + return; + } + + if (pickedMarker.equals(QUAD_XY) || pickedMarker.equals(QUAD_XZ) || pickedMarker.equals(QUAD_YZ)) { + Quaternion rotation = startRotate.mult(pickManager.getLocalRotation()); toolController.getSelectedSpatial().setLocalRotation(rotation); - updateToolsTransformation(); + lastRotate = rotation; } - + updateToolsTransformation(); wasDragging = true; } - + @Override - public void draggedSecondary(Vector2f screenCoord, boolean pressed, JmeNode rootNode, DataObject currentDataObject) { - + public + void draggedSecondary(Vector2f screenCoord, boolean pressed, JmeNode rootNode, DataObject currentDataObject) { + } - + private class ScaleUndo extends AbstractUndoableSceneEdit { - + private Spatial spatial; - private Quaternion before,after; - + private Quaternion before, after; + ScaleUndo(Spatial spatial, Quaternion before, Quaternion after) { this.spatial = spatial; this.before = before; this.after = after; } - + @Override public void sceneUndo() { spatial.setLocalRotation(before); toolController.selectedSpatialTransformed(); } - + @Override public void sceneRedo() { spatial.setLocalRotation(after); diff --git a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/ScaleTool.java b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/ScaleTool.java index cfac57ae1..1f0b5387b 100644 --- a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/ScaleTool.java +++ b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/ScaleTool.java @@ -10,11 +10,13 @@ import com.jme3.gde.core.sceneexplorer.nodes.JmeSpatial; import com.jme3.gde.core.undoredo.AbstractUndoableSceneEdit; import com.jme3.gde.scenecomposer.SceneComposerToolController; import com.jme3.gde.scenecomposer.SceneEditTool; +import com.jme3.math.Quaternion; import com.jme3.math.Vector2f; import com.jme3.math.Vector3f; import com.jme3.scene.Node; import com.jme3.scene.Spatial; import org.openide.loaders.DataObject; +import org.openide.util.Lookup; /** * @@ -24,10 +26,10 @@ public class ScaleTool extends SceneEditTool { private Vector3f pickedMarker; private Vector3f constraintAxis; //used for one axis scale - private Vector2f lastScreenCoord; private Vector3f startScale; private Vector3f lastScale; private boolean wasDragging = false; + private PickManager pickManager; public ScaleTool() { axisPickType = AxisMarkerPickType.axisAndPlane; @@ -37,6 +39,7 @@ public class ScaleTool extends SceneEditTool { @Override public void activate(AssetManager manager, Node toolNode, Node onTopToolNode, Spatial selectedSpatial, SceneComposerToolController toolController) { super.activate(manager, toolNode, onTopToolNode, selectedSpatial, toolController); + pickManager = Lookup.getDefault().lookup(PickManager.class); displayPlanes(); } @@ -45,12 +48,12 @@ public class ScaleTool extends SceneEditTool { if (!pressed) { setDefaultAxisMarkerColors(); pickedMarker = null; // mouse released, reset selection - lastScreenCoord = null; constraintAxis = Vector3f.UNIT_XYZ; // no axis constraint if (wasDragging) { actionPerformed(new ScaleUndo(toolController.getSelectedSpatial(), startScale, lastScale)); wasDragging = false; } + pickManager.reset(); } } @@ -63,11 +66,10 @@ public class ScaleTool extends SceneEditTool { public void mouseMoved(Vector2f screenCoord, JmeNode rootNode, DataObject currentDataObject, JmeSpatial selectedSpatial) { if (pickedMarker == null) { highlightAxisMarker(camera, screenCoord, axisPickType, true); + } else { + pickedMarker = null; + pickManager.reset(); } - /*else { - pickedPlane = null; - lastScreenCoord = null; - }*/ } @Override @@ -75,12 +77,12 @@ public class ScaleTool extends SceneEditTool { if (!pressed) { setDefaultAxisMarkerColors(); pickedMarker = null; // mouse released, reset selection - lastScreenCoord = null; constraintAxis = Vector3f.UNIT_XYZ; // no axis constraint if (wasDragging) { actionPerformed(new ScaleUndo(toolController.getSelectedSpatial(), startScale, lastScale)); wasDragging = false; } + pickManager.reset(); return; } @@ -92,27 +94,44 @@ public class ScaleTool extends SceneEditTool { if (pickedMarker == null) { return; } - if (pickedMarker.equals(ARROW_X)) { + + if (pickedMarker.equals(QUAD_XY) || pickedMarker.equals(QUAD_XZ) || pickedMarker.equals(QUAD_YZ)) { + pickManager.initiatePick(toolController.getSelectedSpatial(), camera.getRotation(), + PickManager.TransformationType.camera, camera, screenCoord); + } else if (pickedMarker.equals(ARROW_X)) { + pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_XY, + PickManager.TransformationType.global, camera, screenCoord); constraintAxis = Vector3f.UNIT_X; // scale only X } else if (pickedMarker.equals(ARROW_Y)) { + pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_YZ, + PickManager.TransformationType.global, camera, screenCoord); constraintAxis = Vector3f.UNIT_Y; // scale only Y } else if (pickedMarker.equals(ARROW_Z)) { + pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_XZ, + PickManager.TransformationType.global, camera, screenCoord); constraintAxis = Vector3f.UNIT_Z; // scale only Z } startScale = toolController.getSelectedSpatial().getLocalScale().clone(); } - if (lastScreenCoord == null) { - lastScreenCoord = screenCoord; - } else { - float diff = screenCoord.y - lastScreenCoord.y; - diff *= 0.1f; - lastScreenCoord = screenCoord; - Vector3f scale = toolController.getSelectedSpatial().getLocalScale().add(new Vector3f(diff, diff, diff).multLocal(constraintAxis)); + if (!pickManager.updatePick(camera, screenCoord)) { + return; + } + if (pickedMarker.equals(QUAD_XY) || pickedMarker.equals(QUAD_XZ) || pickedMarker.equals(QUAD_YZ)) { + constraintAxis = pickManager.getStartOffset().normalize(); + float diff = pickManager.getTranslation(constraintAxis).dot(constraintAxis); + diff *= 0.5f; + Vector3f scale = startScale.add(new Vector3f(diff, diff, diff)); + lastScale = scale; + toolController.getSelectedSpatial().setLocalScale(scale); + } else if (pickedMarker.equals(ARROW_X) || pickedMarker.equals(ARROW_Y) || pickedMarker.equals(ARROW_Z)) { + Vector3f diff = pickManager.getLocalTranslation(constraintAxis); + diff.multLocal(0.5f); + Vector3f scale = startScale.add(diff); lastScale = scale; toolController.getSelectedSpatial().setLocalScale(scale); - updateToolsTransformation(); } + updateToolsTransformation(); wasDragging = true; } From b35c5e9820b047ca1dcaaac94de40edb73fad445 Mon Sep 17 00:00:00 2001 From: Kostyantyn Hushchyn Date: Mon, 27 Apr 2015 01:36:15 +0300 Subject: [PATCH 049/113] Remove redundand code. Fixed java/lang/IllegalStateException in com/jme3/asset/DesktopAssetManager.registerAndCloneSmartAsset. Added ogg loader --- jme3-ios/src/main/java/com/jme3/asset/IOS.cfg | 4 +- .../renderer/ios/IGLESShaderRenderer.java | 2573 ----------------- .../com/jme3/renderer/ios/TextureUtil.java | 576 ---- .../src/main/resources/com/jme3/asset/IOS.cfg | 4 +- 4 files changed, 6 insertions(+), 3151 deletions(-) delete mode 100644 jme3-ios/src/main/java/com/jme3/renderer/ios/IGLESShaderRenderer.java delete mode 100644 jme3-ios/src/main/java/com/jme3/renderer/ios/TextureUtil.java diff --git a/jme3-ios/src/main/java/com/jme3/asset/IOS.cfg b/jme3-ios/src/main/java/com/jme3/asset/IOS.cfg index 4e4052447..e9d79a459 100644 --- a/jme3-ios/src/main/java/com/jme3/asset/IOS.cfg +++ b/jme3-ios/src/main/java/com/jme3/asset/IOS.cfg @@ -2,7 +2,9 @@ INCLUDE com/jme3/asset/General.cfg # IOS specific loaders LOADER com.jme3.system.ios.IosImageLoader : jpg, bmp, gif, png, jpeg -LOADER com.jme3.material.plugins.J3MLoader : j3m, j3md +LOADER com.jme3.audio.plugins.OGGLoader : ogg +LOADER com.jme3.material.plugins.J3MLoader : j3m +LOADER com.jme3.material.plugins.J3MLoader : j3md LOADER com.jme3.shader.plugins.GLSLLoader : vert, frag, glsl, glsllib LOADER com.jme3.export.binary.BinaryImporter : j3o LOADER com.jme3.font.plugins.BitmapFontLoader : fnt diff --git a/jme3-ios/src/main/java/com/jme3/renderer/ios/IGLESShaderRenderer.java b/jme3-ios/src/main/java/com/jme3/renderer/ios/IGLESShaderRenderer.java deleted file mode 100644 index 8a59d0be8..000000000 --- a/jme3-ios/src/main/java/com/jme3/renderer/ios/IGLESShaderRenderer.java +++ /dev/null @@ -1,2573 +0,0 @@ -package com.jme3.renderer.ios; - -import com.jme3.light.LightList; -import com.jme3.material.RenderState; -import com.jme3.math.*; -import com.jme3.renderer.*; -import com.jme3.scene.Mesh; -import com.jme3.scene.Mesh.Mode; -import com.jme3.scene.VertexBuffer; -import com.jme3.scene.VertexBuffer.Format; -import com.jme3.scene.VertexBuffer.Type; -import com.jme3.scene.VertexBuffer.Usage; -import com.jme3.shader.Attribute; -import com.jme3.shader.Shader; -import com.jme3.shader.Shader.ShaderSource; -import com.jme3.shader.Shader.ShaderType; -import com.jme3.shader.Uniform; -import com.jme3.texture.FrameBuffer; -import com.jme3.texture.FrameBuffer.RenderBuffer; -import com.jme3.texture.Image; -import com.jme3.texture.Texture; -import com.jme3.texture.Texture.WrapAxis; -import com.jme3.util.BufferUtils; -import com.jme3.util.ListMap; -import com.jme3.util.NativeObjectManager; - -import java.nio.*; -import java.util.EnumSet; -import java.util.List; -import java.util.logging.Level; -import java.util.logging.Logger; -import jme3tools.shader.ShaderDebug; - -/** - * The Renderer is responsible for taking rendering commands and - * executing them on the underlying video hardware. - * - * @author Kirill Vainer - */ -public class IGLESShaderRenderer implements Renderer { - - private static final Logger logger = Logger.getLogger(IGLESShaderRenderer.class.getName()); - private static final boolean VALIDATE_SHADER = false; - - private final NativeObjectManager objManager = new NativeObjectManager(); - private final EnumSet caps = EnumSet.noneOf(Caps.class); - private final Statistics statistics = new Statistics(); - private final StringBuilder stringBuf = new StringBuilder(250); - private final RenderContext context = new RenderContext(); - private final ByteBuffer nameBuf = BufferUtils.createByteBuffer(250); - - private final int maxFBOAttachs = 1; // Only 1 color attachment on ES - private final int maxMRTFBOAttachs = 1; // FIXME for now, not sure if > 1 is needed for ES - - private final int[] intBuf1 = new int[1]; - private final int[] intBuf16 = new int[16]; - - private int glslVer; - private int vertexTextureUnits; - private int fragTextureUnits; - private int vertexUniforms; - private int fragUniforms; - private int vertexAttribs; - private int maxRBSize; - private int maxTexSize; - private int maxCubeTexSize; - - private FrameBuffer lastFb = null; - private FrameBuffer mainFbOverride = null; - private boolean useVBO = true; - private boolean powerVr = false; - private boolean uintIndexSupport = false; - - private Shader boundShader; - - private int vpX, vpY, vpW, vpH; - private int clipX, clipY, clipW, clipH; - - public IGLESShaderRenderer() { - logger.log(Level.FINE, "IGLESShaderRenderer Constructor"); - } - - /** - * Get the capabilities of the renderer. - * @return The capabilities of the renderer. - */ - public EnumSet getCaps() { - logger.log(Level.FINE, "IGLESShaderRenderer getCaps"); - return caps; - } - - /** - * The statistics allow tracking of how data - * per frame, such as number of objects rendered, number of triangles, etc. - * These are updated when the Renderer's methods are used, make sure - * to call {@link Statistics#clearFrame() } at the appropriate time - * to get accurate info per frame. - */ - public Statistics getStatistics() { - logger.log(Level.FINE, "IGLESShaderRenderer getStatistics"); - return statistics; - } - - /** - * Invalidates the current rendering state. Should be called after - * the GL state was changed manually or through an external library. - */ - public void invalidateState() { - logger.log(Level.FINE, "IGLESShaderRenderer invalidateState"); - } - - /** - * Clears certain channels of the currently bound framebuffer. - * - * @param color True if to clear colors (RGBA) - * @param depth True if to clear depth/z - * @param stencil True if to clear stencil buffer (if available, otherwise - * ignored) - */ - public void clearBuffers(boolean color, boolean depth, boolean stencil) { - logger.log(Level.FINE, "IGLESShaderRenderer clearBuffers"); - int bits = 0; - if (color) { - //See explanations of the depth below, we must enable color write to be able to clear the color buffer - if (context.colorWriteEnabled == false) { - JmeIosGLES.glColorMask(true, true, true, true); - context.colorWriteEnabled = true; - } - bits = JmeIosGLES.GL_COLOR_BUFFER_BIT; - } - if (depth) { - //glClear(GL_DEPTH_BUFFER_BIT) seems to not work when glDepthMask is false - //here s some link on openl board - //http://www.opengl.org/discussion_boards/ubbthreads.php?ubb=showflat&Number=257223 - //if depth clear is requested, we enable the depthMask - if (context.depthWriteEnabled == false) { - JmeIosGLES.glDepthMask(true); - context.depthWriteEnabled = true; - } - bits |= JmeIosGLES.GL_DEPTH_BUFFER_BIT; - } - if (stencil) { - bits |= JmeIosGLES.GL_STENCIL_BUFFER_BIT; - } - if (bits != 0) { - JmeIosGLES.glClear(bits); - JmeIosGLES.checkGLError(); - } - } - - /** - * Sets the background (aka clear) color. - * - * @param color The background color to set - */ - public void setBackgroundColor(ColorRGBA color) { - logger.log(Level.FINE, "IGLESShaderRenderer setBackgroundColor"); - JmeIosGLES.glClearColor(color.r, color.g, color.b, color.a); - JmeIosGLES.checkGLError(); - } - - /** - * Applies the given {@link RenderState}, making the necessary - * GL calls so that the state is applied. - */ - public void applyRenderState(RenderState state) { - logger.log(Level.FINE, "IGLESShaderRenderer applyRenderState"); - /* - if (state.isWireframe() && !context.wireframe){ - GLES20.glPolygonMode(GLES20.GL_FRONT_AND_BACK, GLES20.GL_LINE); - context.wireframe = true; - }else if (!state.isWireframe() && context.wireframe){ - GLES20.glPolygonMode(GLES20.GL_FRONT_AND_BACK, GLES20.GL_FILL); - context.wireframe = false; - } - */ - if (state.isDepthTest() && !context.depthTestEnabled) { - JmeIosGLES.glEnable(JmeIosGLES.GL_DEPTH_TEST); - JmeIosGLES.glDepthFunc(convertTestFunction(context.depthFunc)); - JmeIosGLES.checkGLError(); - context.depthTestEnabled = true; - } else if (!state.isDepthTest() && context.depthTestEnabled) { - JmeIosGLES.glDisable(JmeIosGLES.GL_DEPTH_TEST); - JmeIosGLES.checkGLError(); - context.depthTestEnabled = false; - } - if (state.getDepthFunc() != context.depthFunc) { - JmeIosGLES.glDepthFunc(convertTestFunction(state.getDepthFunc())); - context.depthFunc = state.getDepthFunc(); - } - - if (state.isDepthWrite() && !context.depthWriteEnabled) { - JmeIosGLES.glDepthMask(true); - JmeIosGLES.checkGLError(); - context.depthWriteEnabled = true; - } else if (!state.isDepthWrite() && context.depthWriteEnabled) { - JmeIosGLES.glDepthMask(false); - JmeIosGLES.checkGLError(); - context.depthWriteEnabled = false; - } - if (state.isColorWrite() && !context.colorWriteEnabled) { - JmeIosGLES.glColorMask(true, true, true, true); - JmeIosGLES.checkGLError(); - context.colorWriteEnabled = true; - } else if (!state.isColorWrite() && context.colorWriteEnabled) { - JmeIosGLES.glColorMask(false, false, false, false); - JmeIosGLES.checkGLError(); - context.colorWriteEnabled = false; - } -// if (state.isPointSprite() && !context.pointSprite) { -//// GLES20.glEnable(GLES20.GL_POINT_SPRITE); -//// GLES20.glTexEnvi(GLES20.GL_POINT_SPRITE, GLES20.GL_COORD_REPLACE, GLES20.GL_TRUE); -//// GLES20.glEnable(GLES20.GL_VERTEX_PROGRAM_POINT_SIZE); -//// GLES20.glPointParameterf(GLES20.GL_POINT_SIZE_MIN, 1.0f); -// } else if (!state.isPointSprite() && context.pointSprite) { -//// GLES20.glDisable(GLES20.GL_POINT_SPRITE); -// } - - if (state.isPolyOffset()) { - if (!context.polyOffsetEnabled) { - JmeIosGLES.glEnable(JmeIosGLES.GL_POLYGON_OFFSET_FILL); - JmeIosGLES.glPolygonOffset(state.getPolyOffsetFactor(), - state.getPolyOffsetUnits()); - JmeIosGLES.checkGLError(); - - context.polyOffsetEnabled = true; - context.polyOffsetFactor = state.getPolyOffsetFactor(); - context.polyOffsetUnits = state.getPolyOffsetUnits(); - } else { - if (state.getPolyOffsetFactor() != context.polyOffsetFactor - || state.getPolyOffsetUnits() != context.polyOffsetUnits) { - JmeIosGLES.glPolygonOffset(state.getPolyOffsetFactor(), - state.getPolyOffsetUnits()); - JmeIosGLES.checkGLError(); - - context.polyOffsetFactor = state.getPolyOffsetFactor(); - context.polyOffsetUnits = state.getPolyOffsetUnits(); - } - } - } else { - if (context.polyOffsetEnabled) { - JmeIosGLES.glDisable(JmeIosGLES.GL_POLYGON_OFFSET_FILL); - JmeIosGLES.checkGLError(); - - context.polyOffsetEnabled = false; - context.polyOffsetFactor = 0; - context.polyOffsetUnits = 0; - } - } - if (state.getFaceCullMode() != context.cullMode) { - if (state.getFaceCullMode() == RenderState.FaceCullMode.Off) { - JmeIosGLES.glDisable(JmeIosGLES.GL_CULL_FACE); - JmeIosGLES.checkGLError(); - } else { - JmeIosGLES.glEnable(JmeIosGLES.GL_CULL_FACE); - JmeIosGLES.checkGLError(); - } - - switch (state.getFaceCullMode()) { - case Off: - break; - case Back: - JmeIosGLES.glCullFace(JmeIosGLES.GL_BACK); - JmeIosGLES.checkGLError(); - break; - case Front: - JmeIosGLES.glCullFace(JmeIosGLES.GL_FRONT); - JmeIosGLES.checkGLError(); - break; - case FrontAndBack: - JmeIosGLES.glCullFace(JmeIosGLES.GL_FRONT_AND_BACK); - JmeIosGLES.checkGLError(); - break; - default: - throw new UnsupportedOperationException("Unrecognized face cull mode: " - + state.getFaceCullMode()); - } - - context.cullMode = state.getFaceCullMode(); - } - - if (state.getBlendMode() != context.blendMode) { - if (state.getBlendMode() == RenderState.BlendMode.Off) { - JmeIosGLES.glDisable(JmeIosGLES.GL_BLEND); - JmeIosGLES.checkGLError(); - } else { - JmeIosGLES.glEnable(JmeIosGLES.GL_BLEND); - switch (state.getBlendMode()) { - case Off: - break; - case Additive: - JmeIosGLES.glBlendFunc(JmeIosGLES.GL_ONE, JmeIosGLES.GL_ONE); - break; - case AlphaAdditive: - JmeIosGLES.glBlendFunc(JmeIosGLES.GL_SRC_ALPHA, JmeIosGLES.GL_ONE); - break; - case Color: - JmeIosGLES.glBlendFunc(JmeIosGLES.GL_ONE, JmeIosGLES.GL_ONE_MINUS_SRC_COLOR); - break; - case Alpha: - JmeIosGLES.glBlendFunc(JmeIosGLES.GL_SRC_ALPHA, JmeIosGLES.GL_ONE_MINUS_SRC_ALPHA); - break; - case PremultAlpha: - JmeIosGLES.glBlendFunc(JmeIosGLES.GL_ONE, JmeIosGLES.GL_ONE_MINUS_SRC_ALPHA); - break; - case Modulate: - JmeIosGLES.glBlendFunc(JmeIosGLES.GL_DST_COLOR, JmeIosGLES.GL_ZERO); - break; - case ModulateX2: - JmeIosGLES.glBlendFunc(JmeIosGLES.GL_DST_COLOR, JmeIosGLES.GL_SRC_COLOR); - break; - default: - throw new UnsupportedOperationException("Unrecognized blend mode: " - + state.getBlendMode()); - } - JmeIosGLES.checkGLError(); - } - context.blendMode = state.getBlendMode(); - } - } - - /** - * Set the range of the depth values for objects. All rendered - * objects will have their depth clamped to this range. - * - * @param start The range start - * @param end The range end - */ - public void setDepthRange(float start, float end) { - logger.log(Level.FINE, "IGLESShaderRenderer setDepthRange"); - JmeIosGLES.glDepthRangef(start, end); - JmeIosGLES.checkGLError(); - } - - /** - * Called when a new frame has been rendered. - */ - public void postFrame() { - logger.log(Level.FINE, "IGLESShaderRenderer onFrame"); - //JmeIosGLES.checkGLErrorForced(); - JmeIosGLES.checkGLError(); - - objManager.deleteUnused(this); - } - - /** - * Set the world matrix to use. Does nothing if the Renderer is - * shader based. - * - * @param worldMatrix World matrix to use. - */ - public void setWorldMatrix(Matrix4f worldMatrix) { - logger.log(Level.FINE, "IGLESShaderRenderer setWorldMatrix"); - } - - /** - * Sets the view and projection matrices to use. Does nothing if the Renderer - * is shader based. - * - * @param viewMatrix The view matrix to use. - * @param projMatrix The projection matrix to use. - */ - public void setViewProjectionMatrices(Matrix4f viewMatrix, Matrix4f projMatrix) { - logger.log(Level.FINE, "IGLESShaderRenderer setViewProjectionMatrices"); - } - - /** - * Set the viewport location and resolution on the screen. - * - * @param x The x coordinate of the viewport - * @param y The y coordinate of the viewport - * @param width Width of the viewport - * @param height Height of the viewport - */ - public void setViewPort(int x, int y, int width, int height) { - logger.log(Level.FINE, "IGLESShaderRenderer setViewPort"); - if (x != vpX || vpY != y || vpW != width || vpH != height) { - JmeIosGLES.glViewport(x, y, width, height); - JmeIosGLES.checkGLError(); - - vpX = x; - vpY = y; - vpW = width; - vpH = height; - } - } - - /** - * Specifies a clipping rectangle. - * For all future rendering commands, no pixels will be allowed - * to be rendered outside of the clip rectangle. - * - * @param x The x coordinate of the clip rect - * @param y The y coordinate of the clip rect - * @param width Width of the clip rect - * @param height Height of the clip rect - */ - public void setClipRect(int x, int y, int width, int height) { - logger.log(Level.FINE, "IGLESShaderRenderer setClipRect"); - if (!context.clipRectEnabled) { - JmeIosGLES.glEnable(JmeIosGLES.GL_SCISSOR_TEST); - JmeIosGLES.checkGLError(); - context.clipRectEnabled = true; - } - if (clipX != x || clipY != y || clipW != width || clipH != height) { - JmeIosGLES.glScissor(x, y, width, height); - JmeIosGLES.checkGLError(); - clipX = x; - clipY = y; - clipW = width; - clipH = height; - } - } - - /** - * Clears the clipping rectangle set with - * {@link #setClipRect(int, int, int, int) }. - */ - public void clearClipRect() { - logger.log(Level.FINE, "IGLESShaderRenderer clearClipRect"); - if (context.clipRectEnabled) { - JmeIosGLES.glDisable(JmeIosGLES.GL_SCISSOR_TEST); - JmeIosGLES.checkGLError(); - context.clipRectEnabled = false; - - clipX = 0; - clipY = 0; - clipW = 0; - clipH = 0; - } - } - - /** - * Set lighting state. - * Does nothing if the renderer is shader based. - * The lights should be provided in world space. - * Specify null to disable lighting. - * - * @param lights The light list to set. - */ - public void setLighting(LightList lights) { - logger.log(Level.FINE, "IGLESShaderRenderer setLighting"); - } - - /** - * Sets the shader to use for rendering. - * If the shader has not been uploaded yet, it is compiled - * and linked. If it has been uploaded, then the - * uniform data is updated and the shader is set. - * - * @param shader The shader to use for rendering. - */ - public void setShader(Shader shader) { - logger.log(Level.FINE, "IGLESShaderRenderer setShader"); - if (shader == null) { - throw new IllegalArgumentException("Shader cannot be null"); - } else { - if (shader.isUpdateNeeded()) { - updateShaderData(shader); - } - - // NOTE: might want to check if any of the - // sources need an update? - - assert shader.getId() > 0; - - updateShaderUniforms(shader); - bindProgram(shader); - } - } - - /** - * Deletes a shader. This method also deletes - * the attached shader sources. - * - * @param shader Shader to delete. - */ - public void deleteShader(Shader shader) { - logger.log(Level.FINE, "IGLESShaderRenderer deleteShader"); - if (shader.getId() == -1) { - logger.warning("Shader is not uploaded to GPU, cannot delete."); - return; - } - - for (ShaderSource source : shader.getSources()) { - if (source.getId() != -1) { - JmeIosGLES.glDetachShader(shader.getId(), source.getId()); - JmeIosGLES.checkGLError(); - - deleteShaderSource(source); - } - } - - JmeIosGLES.glDeleteProgram(shader.getId()); - JmeIosGLES.checkGLError(); - - statistics.onDeleteShader(); - shader.resetObject(); - } - - /** - * Deletes the provided shader source. - * - * @param source The ShaderSource to delete. - */ - public void deleteShaderSource(ShaderSource source) { - logger.log(Level.FINE, "IGLESShaderRenderer deleteShaderSource"); - if (source.getId() < 0) { - logger.warning("Shader source is not uploaded to GPU, cannot delete."); - return; - } - - source.clearUpdateNeeded(); - - JmeIosGLES.glDeleteShader(source.getId()); - JmeIosGLES.checkGLError(); - - source.resetObject(); - } - - /** - * Copies contents from src to dst, scaling if necessary. - */ - public void copyFrameBuffer(FrameBuffer src, FrameBuffer dst) { - logger.log(Level.FINE, "IGLESShaderRenderer copyFrameBuffer"); - copyFrameBuffer(src, dst, true); - } - - /** - * Copies contents from src to dst, scaling if necessary. - * set copyDepth to false to only copy the color buffers. - */ - public void copyFrameBuffer(FrameBuffer src, FrameBuffer dst, boolean copyDepth) { - logger.warning("IGLESShaderRenderer copyFrameBuffer with depth TODO"); - throw new RendererException("Copy framebuffer not implemented yet."); - } - - /** - * Sets the framebuffer that will be drawn to. - */ - public void setFrameBuffer(FrameBuffer fb) { - logger.log(Level.FINE, "IGLESShaderRenderer setFrameBuffer"); - if (fb == null && mainFbOverride != null) { - fb = mainFbOverride; - } - - if (lastFb == fb) { - if (fb == null || !fb.isUpdateNeeded()) { - return; - } - } - - // generate mipmaps for last FB if needed - if (lastFb != null) { - for (int i = 0; i < lastFb.getNumColorBuffers(); i++) { - RenderBuffer rb = lastFb.getColorBuffer(i); - Texture tex = rb.getTexture(); - if (tex != null - && tex.getMinFilter().usesMipMapLevels()) { - setTexture(0, rb.getTexture()); - -// int textureType = convertTextureType(tex.getType(), tex.getImage().getMultiSamples(), rb.getFace()); - int textureType = convertTextureType(tex.getType()); - JmeIosGLES.glGenerateMipmap(textureType); - JmeIosGLES.checkGLError(); - } - } - } - - if (fb == null) { - // unbind any fbos - if (context.boundFBO != 0) { - JmeIosGLES.glBindFramebuffer(JmeIosGLES.GL_FRAMEBUFFER, 0); - JmeIosGLES.checkGLError(); - - statistics.onFrameBufferUse(null, true); - - context.boundFBO = 0; - } - - /* - // select back buffer - if (context.boundDrawBuf != -1) { - glDrawBuffer(initialDrawBuf); - context.boundDrawBuf = -1; - } - if (context.boundReadBuf != -1) { - glReadBuffer(initialReadBuf); - context.boundReadBuf = -1; - } - */ - - lastFb = null; - } else { - if (fb.getNumColorBuffers() == 0 && fb.getDepthBuffer() == null) { - throw new IllegalArgumentException("The framebuffer: " + fb - + "\nDoesn't have any color/depth buffers"); - } - - if (fb.isUpdateNeeded()) { - updateFrameBuffer(fb); - } - - if (context.boundFBO != fb.getId()) { - JmeIosGLES.glBindFramebuffer(JmeIosGLES.GL_FRAMEBUFFER, fb.getId()); - JmeIosGLES.checkGLError(); - - statistics.onFrameBufferUse(fb, true); - - // update viewport to reflect framebuffer's resolution - setViewPort(0, 0, fb.getWidth(), fb.getHeight()); - - context.boundFBO = fb.getId(); - } else { - statistics.onFrameBufferUse(fb, false); - } - if (fb.getNumColorBuffers() == 0) { -// // make sure to select NONE as draw buf -// // no color buffer attached. select NONE - if (context.boundDrawBuf != -2) { -// glDrawBuffer(GL_NONE); - context.boundDrawBuf = -2; - } - if (context.boundReadBuf != -2) { -// glReadBuffer(GL_NONE); - context.boundReadBuf = -2; - } - } else { - if (fb.getNumColorBuffers() > maxFBOAttachs) { - throw new RendererException("Framebuffer has more color " - + "attachments than are supported" - + " by the video hardware!"); - } - if (fb.isMultiTarget()) { - if (fb.getNumColorBuffers() > maxMRTFBOAttachs) { - throw new RendererException("Framebuffer has more" - + " multi targets than are supported" - + " by the video hardware!"); - } - - if (context.boundDrawBuf != 100 + fb.getNumColorBuffers()) { - //intBuf16.clear(); - for (int i = 0; i < 16; i++) { - intBuf16[i] = i < fb.getNumColorBuffers() ? JmeIosGLES.GL_COLOR_ATTACHMENT0 + i : 0; - } - - //intBuf16.flip();// TODO: flip -// glDrawBuffers(intBuf16); - context.boundDrawBuf = 100 + fb.getNumColorBuffers(); - } - } else { - RenderBuffer rb = fb.getColorBuffer(fb.getTargetIndex()); - // select this draw buffer - if (context.boundDrawBuf != rb.getSlot()) { - JmeIosGLES.glActiveTexture(convertAttachmentSlot(rb.getSlot())); - JmeIosGLES.checkGLError(); - - context.boundDrawBuf = rb.getSlot(); - } - } - } - - assert fb.getId() >= 0; - assert context.boundFBO == fb.getId(); - - lastFb = fb; - - checkFrameBufferStatus(fb); - } - } - - /** - * Set the framebuffer that will be set instead of the main framebuffer - * when a call to setFrameBuffer(null) is made. - * - * @param fb - */ - public void setMainFrameBufferOverride(FrameBuffer fb) { - logger.log(Level.FINE, "IGLESShaderRenderer setMainFrameBufferOverride"); - mainFbOverride = fb; - } - - /** - * Reads the pixels currently stored in the specified framebuffer - * into the given ByteBuffer object. - * Only color pixels are transferred, the format is BGRA with 8 bits - * per component. The given byte buffer should have at least - * fb.getWidth() * fb.getHeight() * 4 bytes remaining. - * - * @param fb The framebuffer to read from - * @param byteBuf The bytebuffer to transfer color data to - */ - public void readFrameBuffer(FrameBuffer fb, ByteBuffer byteBuf) { - logger.log(Level.FINE, "IGLESShaderRenderer readFrameBuffer"); - if (fb != null) { - RenderBuffer rb = fb.getColorBuffer(); - if (rb == null) { - throw new IllegalArgumentException("Specified framebuffer" - + " does not have a colorbuffer"); - } - - setFrameBuffer(fb); - } else { - setFrameBuffer(null); - } - - //JmeIosGLES.glReadPixels2(vpX, vpY, vpW, vpH, JmeIosGLES.GL_RGBA, JmeIosGLES.GL_UNSIGNED_BYTE, byteBuf.array(), 0, vpW * vpH * 4); - JmeIosGLES.glReadPixels(vpX, vpY, vpW, vpH, JmeIosGLES.GL_RGBA, JmeIosGLES.GL_UNSIGNED_BYTE, byteBuf); - JmeIosGLES.checkGLError(); - } - - /** - * Deletes a framebuffer and all attached renderbuffers - */ - public void deleteFrameBuffer(FrameBuffer fb) { - logger.log(Level.FINE, "IGLESShaderRenderer deleteFrameBuffer"); - if (fb.getId() != -1) { - if (context.boundFBO == fb.getId()) { - JmeIosGLES.glBindFramebuffer(JmeIosGLES.GL_FRAMEBUFFER, 0); - JmeIosGLES.checkGLError(); - - context.boundFBO = 0; - } - - if (fb.getDepthBuffer() != null) { - deleteRenderBuffer(fb, fb.getDepthBuffer()); - } - if (fb.getColorBuffer() != null) { - deleteRenderBuffer(fb, fb.getColorBuffer()); - } - - intBuf1[0] = fb.getId(); - JmeIosGLES.glDeleteFramebuffers(1, intBuf1, 0); - JmeIosGLES.checkGLError(); - - fb.resetObject(); - - statistics.onDeleteFrameBuffer(); - } - } - - /** - * Sets the texture to use for the given texture unit. - */ - public void setTexture(int unit, Texture tex) { - logger.log(Level.FINE, "IGLESShaderRenderer setTexture"); - Image image = tex.getImage(); - if (image.isUpdateNeeded() || (image.isGeneratedMipmapsRequired() && !image.isMipmapsGenerated()) ) { - updateTexImageData(image, tex.getType()); - } - - int texId = image.getId(); - assert texId != -1; - - if (texId == -1) { - logger.warning("error: texture image has -1 id"); - } - - Image[] textures = context.boundTextures; - - int type = convertTextureType(tex.getType()); - if (textures[unit] != image) { - if (context.boundTextureUnit != unit) { - JmeIosGLES.glActiveTexture(JmeIosGLES.GL_TEXTURE0 + unit); - context.boundTextureUnit = unit; - } - - JmeIosGLES.glBindTexture(type, texId); - JmeIosGLES.checkGLError(); - - textures[unit] = image; - - statistics.onTextureUse(tex.getImage(), true); - } else { - statistics.onTextureUse(tex.getImage(), false); - } - - setupTextureParams(tex); - } - - /** - * Modify the given Texture tex with the given Image. The image will be put at x and y into the texture. - * - * @param tex the Texture that will be modified - * @param pixels the source Image data to copy data from - * @param x the x position to put the image into the texture - * @param y the y position to put the image into the texture - */ - public void modifyTexture(Texture tex, Image pixels, int x, int y) { - logger.log(Level.FINE, "IGLESShaderRenderer modifyTexture"); - setTexture(0, tex); - TextureUtil.uploadSubTexture(pixels, convertTextureType(tex.getType()), 0, x, y); - } - - /** - * Deletes a texture from the GPU. - */ - public void deleteImage(Image image) { - logger.log(Level.FINE, "IGLESShaderRenderer deleteImage"); - int texId = image.getId(); - if (texId != -1) { - intBuf1[0] = texId; - - JmeIosGLES.glDeleteTextures(1, intBuf1, 0); - JmeIosGLES.checkGLError(); - - image.resetObject(); - - statistics.onDeleteTexture(); - } - } - - /** - * Uploads a vertex buffer to the GPU. - * - * @param vb The vertex buffer to upload - */ - public void updateBufferData(VertexBuffer vb) { - logger.log(Level.FINE, "IGLESShaderRenderer updateBufferData"); - int bufId = vb.getId(); - boolean created = false; - if (bufId == -1) { - // create buffer - JmeIosGLES.glGenBuffers(1, intBuf1, 0); - JmeIosGLES.checkGLError(); - - bufId = intBuf1[0]; - vb.setId(bufId); - objManager.registerObject(vb); - - created = true; - } - - // bind buffer - int target; - if (vb.getBufferType() == VertexBuffer.Type.Index) { - target = JmeIosGLES.GL_ELEMENT_ARRAY_BUFFER; - if (context.boundElementArrayVBO != bufId) { - JmeIosGLES.glBindBuffer(target, bufId); - JmeIosGLES.checkGLError(); - - context.boundElementArrayVBO = bufId; - } - } else { - target = JmeIosGLES.GL_ARRAY_BUFFER; - if (context.boundArrayVBO != bufId) { - JmeIosGLES.glBindBuffer(target, bufId); - JmeIosGLES.checkGLError(); - - context.boundArrayVBO = bufId; - } - } - - int usage = convertUsage(vb.getUsage()); - vb.getData().rewind(); - - if (created || vb.hasDataSizeChanged()) { - // upload data based on format - int size = vb.getData().limit() * vb.getFormat().getComponentSize(); - - switch (vb.getFormat()) { - case Byte: - case UnsignedByte: - JmeIosGLES.glBufferData(target, size, (ByteBuffer) vb.getData(), usage); - JmeIosGLES.checkGLError(); - break; - case Short: - case UnsignedShort: - JmeIosGLES.glBufferData(target, size, (ShortBuffer) vb.getData(), usage); - JmeIosGLES.checkGLError(); - break; - case Int: - case UnsignedInt: - JmeIosGLES.glBufferData(target, size, (IntBuffer) vb.getData(), usage); - JmeIosGLES.checkGLError(); - break; - case Float: - JmeIosGLES.glBufferData(target, size, (FloatBuffer) vb.getData(), usage); - JmeIosGLES.checkGLError(); - break; - default: - throw new RuntimeException("Unknown buffer format."); - } - } else { - int size = vb.getData().limit() * vb.getFormat().getComponentSize(); - - switch (vb.getFormat()) { - case Byte: - case UnsignedByte: - JmeIosGLES.glBufferSubData(target, 0, size, (ByteBuffer) vb.getData()); - JmeIosGLES.checkGLError(); - break; - case Short: - case UnsignedShort: - JmeIosGLES.glBufferSubData(target, 0, size, (ShortBuffer) vb.getData()); - JmeIosGLES.checkGLError(); - break; - case Int: - case UnsignedInt: - JmeIosGLES.glBufferSubData(target, 0, size, (IntBuffer) vb.getData()); - JmeIosGLES.checkGLError(); - break; - case Float: - JmeIosGLES.glBufferSubData(target, 0, size, (FloatBuffer) vb.getData()); - JmeIosGLES.checkGLError(); - break; - default: - throw new RuntimeException("Unknown buffer format."); - } - } - vb.clearUpdateNeeded(); - } - - /** - * Deletes a vertex buffer from the GPU. - * @param vb The vertex buffer to delete - */ - public void deleteBuffer(VertexBuffer vb) { - logger.log(Level.FINE, "IGLESShaderRenderer deleteBuffer"); - int bufId = vb.getId(); - if (bufId != -1) { - // delete buffer - intBuf1[0] = bufId; - - JmeIosGLES.glDeleteBuffers(1, intBuf1, 0); - JmeIosGLES.checkGLError(); - - vb.resetObject(); - } - } - - /** - * Renders count meshes, with the geometry data supplied. - * The shader which is currently set with setShader is - * responsible for transforming the input verticies into clip space - * and shading it based on the given vertex attributes. - * The int variable gl_InstanceID can be used to access the current - * instance of the mesh being rendered inside the vertex shader. - * - * @param mesh The mesh to render - * @param lod The LOD level to use, see {@link Mesh#setLodLevels(com.jme3.scene.VertexBuffer[]) }. - * @param count Number of mesh instances to render - */ - public void renderMesh(Mesh mesh, int lod, int count, VertexBuffer[] instanceData) { - logger.log(Level.FINE, "IGLESShaderRenderer renderMesh"); - if (mesh.getVertexCount() == 0) { - return; - } - /* - * NOTE: not supported in OpenGL ES 2.0. - if (context.pointSize != mesh.getPointSize()) { - GLES10.glPointSize(mesh.getPointSize()); - context.pointSize = mesh.getPointSize(); - } - */ - if (context.lineWidth != mesh.getLineWidth()) { - JmeIosGLES.glLineWidth(mesh.getLineWidth()); - JmeIosGLES.checkGLError(); - context.lineWidth = mesh.getLineWidth(); - } - - statistics.onMeshDrawn(mesh, lod); -// if (GLContext.getCapabilities().GL_ARB_vertex_array_object){ -// renderMeshVertexArray(mesh, lod, count); -// }else{ - - if (useVBO) { - renderMeshDefault(mesh, lod, count); - } else { - renderMeshVertexArray(mesh, lod, count); - } - } - - /** - * Resets all previously used {@link NativeObject Native Objects} on this Renderer. - * The state of the native objects is reset in such way, that using - * them again will cause the renderer to reupload them. - * Call this method when you know the GL context is going to shutdown. - * - * @see NativeObject#resetObject() - */ - public void resetGLObjects() { - logger.log(Level.FINE, "IGLESShaderRenderer resetGLObjects"); - objManager.resetObjects(); - statistics.clearMemory(); - boundShader = null; - lastFb = null; - context.reset(); - } - - /** - * Deletes all previously used {@link NativeObject Native Objects} on this Renderer, and - * then resets the native objects. - * - * @see #resetGLObjects() - * @see NativeObject#deleteObject(java.lang.Object) - */ - public void cleanup() { - logger.log(Level.FINE, "IGLESShaderRenderer cleanup"); - objManager.deleteAllObjects(this); - statistics.clearMemory(); - } - - /** - * Sets the alpha to coverage state. - *

- * When alpha coverage and multi-sampling is enabled, - * each pixel will contain alpha coverage in all - * of its subsamples, which is then combined when - * other future alpha-blended objects are rendered. - *

- *

- * Alpha-to-coverage is useful for rendering transparent objects - * without having to worry about sorting them. - *

- */ - public void setAlphaToCoverage(boolean value) { - logger.log(Level.FINE, "IGLESShaderRenderer setAlphaToCoverage"); - if (value) { - JmeIosGLES.glEnable(JmeIosGLES.GL_SAMPLE_ALPHA_TO_COVERAGE); - JmeIosGLES.checkGLError(); - } else { - JmeIosGLES.glDisable(JmeIosGLES.GL_SAMPLE_ALPHA_TO_COVERAGE); - JmeIosGLES.checkGLError(); - } - } - - - /* ------------------------------------------------------------------------------ */ - - - public void initialize() { - Level store = logger.getLevel(); - logger.setLevel(Level.FINE); - - logger.log(Level.FINE, "Vendor: {0}", JmeIosGLES.glGetString(JmeIosGLES.GL_VENDOR)); - logger.log(Level.FINE, "Renderer: {0}", JmeIosGLES.glGetString(JmeIosGLES.GL_RENDERER)); - logger.log(Level.FINE, "Version: {0}", JmeIosGLES.glGetString(JmeIosGLES.GL_VERSION)); - logger.log(Level.FINE, "Shading Language Version: {0}", JmeIosGLES.glGetString(JmeIosGLES.GL_SHADING_LANGUAGE_VERSION)); - - /* - // Fix issue in TestRenderToMemory when GL_FRONT is the main - // buffer being used. - initialDrawBuf = glGetInteger(GL_DRAW_BUFFER); - initialReadBuf = glGetInteger(GL_READ_BUFFER); - - // XXX: This has to be GL_BACK for canvas on Mac - // Since initialDrawBuf is GL_FRONT for pbuffer, gotta - // change this value later on ... -// initialDrawBuf = GL_BACK; -// initialReadBuf = GL_BACK; - */ - - // Check OpenGL version - int openGlVer = extractVersion("OpenGL ES ", JmeIosGLES.glGetString(JmeIosGLES.GL_VERSION)); - if (openGlVer == -1) { - glslVer = -1; - throw new UnsupportedOperationException("OpenGL ES 2.0+ is required for IGLESShaderRenderer!"); - } - - // Check shader language version - glslVer = extractVersion("OpenGL ES GLSL ES ", JmeIosGLES.glGetString(JmeIosGLES.GL_SHADING_LANGUAGE_VERSION)); - switch (glslVer) { - // TODO: When new versions of OpenGL ES shader language come out, - // update this. - default: - caps.add(Caps.GLSL100); - break; - } - - JmeIosGLES.glGetIntegerv(JmeIosGLES.GL_MAX_VERTEX_TEXTURE_IMAGE_UNITS, intBuf16, 0); - vertexTextureUnits = intBuf16[0]; - logger.log(Level.FINE, "VTF Units: {0}", vertexTextureUnits); - if (vertexTextureUnits > 0) { - caps.add(Caps.VertexTextureFetch); - } - - JmeIosGLES.glGetIntegerv(JmeIosGLES.GL_MAX_TEXTURE_IMAGE_UNITS, intBuf16, 0); - fragTextureUnits = intBuf16[0]; - logger.log(Level.FINE, "Texture Units: {0}", fragTextureUnits); - - // Multiply vector count by 4 to get float count. - JmeIosGLES.glGetIntegerv(JmeIosGLES.GL_MAX_VERTEX_UNIFORM_VECTORS, intBuf16, 0); - vertexUniforms = intBuf16[0] * 4; - logger.log(Level.FINER, "Vertex Uniforms: {0}", vertexUniforms); - - JmeIosGLES.glGetIntegerv(JmeIosGLES.GL_MAX_FRAGMENT_UNIFORM_VECTORS, intBuf16, 0); - fragUniforms = intBuf16[0] * 4; - logger.log(Level.FINER, "Fragment Uniforms: {0}", fragUniforms); - - JmeIosGLES.glGetIntegerv(JmeIosGLES.GL_MAX_VARYING_VECTORS, intBuf16, 0); - int varyingFloats = intBuf16[0] * 4; - logger.log(Level.FINER, "Varying Floats: {0}", varyingFloats); - - JmeIosGLES.glGetIntegerv(JmeIosGLES.GL_MAX_VERTEX_ATTRIBS, intBuf16, 0); - vertexAttribs = intBuf16[0]; - logger.log(Level.FINE, "Vertex Attributes: {0}", vertexAttribs); - - JmeIosGLES.glGetIntegerv(JmeIosGLES.GL_SUBPIXEL_BITS, intBuf16, 0); - int subpixelBits = intBuf16[0]; - logger.log(Level.FINE, "Subpixel Bits: {0}", subpixelBits); - -// GLES10.glGetIntegerv(GLES10.GL_MAX_ELEMENTS_VERTICES, intBuf16); -// maxVertCount = intBuf16.get(0); -// logger.log(Level.FINER, "Preferred Batch Vertex Count: {0}", maxVertCount); -// -// GLES10.glGetIntegerv(GLES10.GL_MAX_ELEMENTS_INDICES, intBuf16); -// maxTriCount = intBuf16.get(0); -// logger.log(Level.FINER, "Preferred Batch Index Count: {0}", maxTriCount); - - JmeIosGLES.glGetIntegerv(JmeIosGLES.GL_MAX_TEXTURE_SIZE, intBuf16, 0); - maxTexSize = intBuf16[0]; - logger.log(Level.FINE, "Maximum Texture Resolution: {0}", maxTexSize); - - JmeIosGLES.glGetIntegerv(JmeIosGLES.GL_MAX_CUBE_MAP_TEXTURE_SIZE, intBuf16, 0); - maxCubeTexSize = intBuf16[0]; - logger.log(Level.FINE, "Maximum CubeMap Resolution: {0}", maxCubeTexSize); - - JmeIosGLES.glGetIntegerv(JmeIosGLES.GL_MAX_RENDERBUFFER_SIZE, intBuf16, 0); - maxRBSize = intBuf16[0]; - logger.log(Level.FINER, "FBO RB Max Size: {0}", maxRBSize); - - /* - if (ctxCaps.GL_ARB_color_buffer_float){ - // XXX: Require both 16 and 32 bit float support for FloatColorBuffer. - if (ctxCaps.GL_ARB_half_float_pixel){ - caps.add(Caps.FloatColorBuffer); - } - } - - if (ctxCaps.GL_ARB_depth_buffer_float){ - caps.add(Caps.FloatDepthBuffer); - } - - if (ctxCaps.GL_ARB_draw_instanced) - caps.add(Caps.MeshInstancing); - - if (ctxCaps.GL_ARB_texture_buffer_object) - caps.add(Caps.TextureBuffer); - - if (ctxCaps.GL_ARB_texture_float){ - if (ctxCaps.GL_ARB_half_float_pixel){ - caps.add(Caps.FloatTexture); - } - } - - if (ctxCaps.GL_EXT_packed_float){ - caps.add(Caps.PackedFloatColorBuffer); - if (ctxCaps.GL_ARB_half_float_pixel){ - // because textures are usually uploaded as RGB16F - // need half-float pixel - caps.add(Caps.PackedFloatTexture); - } - } - - if (ctxCaps.GL_EXT_texture_array) - caps.add(Caps.TextureArray); - - if (ctxCaps.GL_EXT_texture_shared_exponent) - caps.add(Caps.SharedExponentTexture); - - if (ctxCaps.GL_EXT_framebuffer_object){ - caps.add(Caps.FrameBuffer); - - glGetInteger(GL_MAX_RENDERBUFFER_SIZE_EXT, intBuf16); - maxRBSize = intBuf16.get(0); - logger.log(Level.FINER, "FBO RB Max Size: {0}", maxRBSize); - - glGetInteger(GL_MAX_COLOR_ATTACHMENTS_EXT, intBuf16); - maxFBOAttachs = intBuf16.get(0); - logger.log(Level.FINER, "FBO Max renderbuffers: {0}", maxFBOAttachs); - - if (ctxCaps.GL_EXT_framebuffer_multisample){ - caps.add(Caps.FrameBufferMultisample); - - glGetInteger(GL_MAX_SAMPLES_EXT, intBuf16); - maxFBOSamples = intBuf16.get(0); - logger.log(Level.FINER, "FBO Max Samples: {0}", maxFBOSamples); - } - - if (ctxCaps.GL_ARB_draw_buffers){ - caps.add(Caps.FrameBufferMRT); - glGetInteger(ARBDrawBuffers.GL_MAX_DRAW_BUFFERS_ARB, intBuf16); - maxMRTFBOAttachs = intBuf16.get(0); - logger.log(Level.FINER, "FBO Max MRT renderbuffers: {0}", maxMRTFBOAttachs); - } - } - - if (ctxCaps.GL_ARB_multisample){ - glGetInteger(ARBMultisample.GL_SAMPLE_BUFFERS_ARB, intBuf16); - boolean available = intBuf16.get(0) != 0; - glGetInteger(ARBMultisample.GL_SAMPLES_ARB, intBuf16); - int samples = intBuf16.get(0); - logger.log(Level.FINER, "Samples: {0}", samples); - boolean enabled = glIsEnabled(ARBMultisample.GL_MULTISAMPLE_ARB); - if (samples > 0 && available && !enabled){ - glEnable(ARBMultisample.GL_MULTISAMPLE_ARB); - } - } - */ - - String extensions = JmeIosGLES.glGetString(JmeIosGLES.GL_EXTENSIONS); - logger.log(Level.FINE, "GL_EXTENSIONS: {0}", extensions); - - // Get number of compressed formats available. - JmeIosGLES.glGetIntegerv(JmeIosGLES.GL_NUM_COMPRESSED_TEXTURE_FORMATS, intBuf16, 0); - int numCompressedFormats = intBuf16[0]; - - // Allocate buffer for compressed formats. - int[] compressedFormats = new int[numCompressedFormats]; - JmeIosGLES.glGetIntegerv(JmeIosGLES.GL_COMPRESSED_TEXTURE_FORMATS, compressedFormats, 0); - - // Check for errors after all glGet calls. - JmeIosGLES.checkGLError(); - - // Print compressed formats. - for (int i = 0; i < numCompressedFormats; i++) { - logger.log(Level.FINE, "Compressed Texture Formats: {0}", compressedFormats[i]); - } - - TextureUtil.loadTextureFeatures(extensions); - - applyRenderState(RenderState.DEFAULT); - JmeIosGLES.glDisable(JmeIosGLES.GL_DITHER); - JmeIosGLES.checkGLError(); - - logger.log(Level.FINE, "Caps: {0}", caps); - logger.setLevel(store); - - uintIndexSupport = extensions.contains("GL_OES_element_index_uint"); - logger.log(Level.FINE, "Support for UInt index: {0}", uintIndexSupport); - } - - - /* ------------------------------------------------------------------------------ */ - - - private int extractVersion(String prefixStr, String versionStr) { - if (versionStr != null) { - int spaceIdx = versionStr.indexOf(" ", prefixStr.length()); - if (spaceIdx >= 1) { - versionStr = versionStr.substring(prefixStr.length(), spaceIdx).trim(); - } else { - versionStr = versionStr.substring(prefixStr.length()).trim(); - } - float version = Float.parseFloat(versionStr); - return (int) (version * 100); - } else { - return -1; - } - } - - private void deleteRenderBuffer(FrameBuffer fb, RenderBuffer rb) { - intBuf1[0] = rb.getId(); - JmeIosGLES.glDeleteRenderbuffers(1, intBuf1, 0); - JmeIosGLES.checkGLError(); - } - - private int convertUsage(Usage usage) { - switch (usage) { - case Static: - return JmeIosGLES.GL_STATIC_DRAW; - case Dynamic: - return JmeIosGLES.GL_DYNAMIC_DRAW; - case Stream: - return JmeIosGLES.GL_STREAM_DRAW; - default: - throw new RuntimeException("Unknown usage type."); - } - } - - - protected void bindProgram(Shader shader) { - int shaderId = shader.getId(); - if (context.boundShaderProgram != shaderId) { - JmeIosGLES.glUseProgram(shaderId); - JmeIosGLES.checkGLError(); - - statistics.onShaderUse(shader, true); - boundShader = shader; - context.boundShaderProgram = shaderId; - } else { - statistics.onShaderUse(shader, false); - } - } - - protected void updateShaderUniforms(Shader shader) { - ListMap uniforms = shader.getUniformMap(); - for (int i = 0; i < uniforms.size(); i++) { - Uniform uniform = uniforms.getValue(i); - if (uniform.isUpdateNeeded()) { - updateUniform(shader, uniform); - } - } - } - - - protected void updateUniform(Shader shader, Uniform uniform) { - logger.log(Level.FINE, "IGLESShaderRenderer private updateUniform: " + uniform.getVarType()); - int shaderId = shader.getId(); - - assert uniform.getName() != null; - assert shader.getId() > 0; - - if (context.boundShaderProgram != shaderId) { - JmeIosGLES.glUseProgram(shaderId); - JmeIosGLES.checkGLError(); - - statistics.onShaderUse(shader, true); - boundShader = shader; - context.boundShaderProgram = shaderId; - } else { - statistics.onShaderUse(shader, false); - } - - int loc = uniform.getLocation(); - if (loc == -1) { - return; - } - - if (loc == -2) { - // get uniform location - updateUniformLocation(shader, uniform); - if (uniform.getLocation() == -1) { - // not declared, ignore - uniform.clearUpdateNeeded(); - return; - } - loc = uniform.getLocation(); - } - - if (uniform.getVarType() == null) { - // removed logging the warning to avoid flooding the log - // (LWJGL also doesn't post a warning) - //logger.log(Level.FINEST, "Uniform value is not set yet. Shader: {0}, Uniform: {1}", - // new Object[]{shader.toString(), uniform.toString()}); - return; // value not set yet.. - } - - statistics.onUniformSet(); - - uniform.clearUpdateNeeded(); - ByteBuffer bb;//GetPrimitiveArrayCritical - FloatBuffer fb; - IntBuffer ib; - switch (uniform.getVarType()) { - case Float: - Float f = (Float) uniform.getValue(); - JmeIosGLES.glUniform1f(loc, f.floatValue()); - break; - case Vector2: - Vector2f v2 = (Vector2f) uniform.getValue(); - JmeIosGLES.glUniform2f(loc, v2.getX(), v2.getY()); - break; - case Vector3: - Vector3f v3 = (Vector3f) uniform.getValue(); - JmeIosGLES.glUniform3f(loc, v3.getX(), v3.getY(), v3.getZ()); - break; - case Vector4: - Object val = uniform.getValue(); - if (val instanceof ColorRGBA) { - ColorRGBA c = (ColorRGBA) val; - JmeIosGLES.glUniform4f(loc, c.r, c.g, c.b, c.a); - } else if (val instanceof Vector4f) { - Vector4f c = (Vector4f) val; - JmeIosGLES.glUniform4f(loc, c.x, c.y, c.z, c.w); - } else { - Quaternion c = (Quaternion) uniform.getValue(); - JmeIosGLES.glUniform4f(loc, c.getX(), c.getY(), c.getZ(), c.getW()); - } - break; - case Boolean: - Boolean b = (Boolean) uniform.getValue(); - JmeIosGLES.glUniform1i(loc, b.booleanValue() ? JmeIosGLES.GL_TRUE : JmeIosGLES.GL_FALSE); - break; - case Matrix3: - fb = (FloatBuffer) uniform.getValue(); - assert fb.remaining() == 9; - JmeIosGLES.glUniformMatrix3fv(loc, 1, false, fb); - break; - case Matrix4: - fb = (FloatBuffer) uniform.getValue(); - assert fb.remaining() == 16; - JmeIosGLES.glUniformMatrix4fv(loc, 1, false, fb); - break; - case IntArray: - ib = (IntBuffer) uniform.getValue(); - JmeIosGLES.glUniform1iv(loc, ib.limit(), ib); - break; - case FloatArray: - fb = (FloatBuffer) uniform.getValue(); - JmeIosGLES.glUniform1fv(loc, fb.limit(), fb); - break; - case Vector2Array: - fb = (FloatBuffer) uniform.getValue(); - JmeIosGLES.glUniform2fv(loc, fb.limit() / 2, fb); - break; - case Vector3Array: - fb = (FloatBuffer) uniform.getValue(); - JmeIosGLES.glUniform3fv(loc, fb.limit() / 3, fb); - break; - case Vector4Array: - fb = (FloatBuffer) uniform.getValue(); - JmeIosGLES.glUniform4fv(loc, fb.limit() / 4, fb); - break; - case Matrix4Array: - fb = (FloatBuffer) uniform.getValue(); - JmeIosGLES.glUniformMatrix4fv(loc, fb.limit() / 16, false, fb); - break; - case Int: - Integer i = (Integer) uniform.getValue(); - JmeIosGLES.glUniform1i(loc, i.intValue()); - break; - default: - throw new UnsupportedOperationException("Unsupported uniform type: " + uniform.getVarType()); - } - JmeIosGLES.checkGLError(); - } - - protected void updateUniformLocation(Shader shader, Uniform uniform) { - stringBuf.setLength(0); - stringBuf.append(uniform.getName()).append('\0'); - updateNameBuffer(); - int loc = JmeIosGLES.glGetUniformLocation(shader.getId(), uniform.getName()); - JmeIosGLES.checkGLError(); - - if (loc < 0) { - uniform.setLocation(-1); - // uniform is not declared in shader - } else { - uniform.setLocation(loc); - } - } - - protected void updateNameBuffer() { - int len = stringBuf.length(); - - nameBuf.position(0); - nameBuf.limit(len); - for (int i = 0; i < len; i++) { - nameBuf.put((byte) stringBuf.charAt(i)); - } - - nameBuf.rewind(); - } - - - public void updateShaderData(Shader shader) { - int id = shader.getId(); - boolean needRegister = false; - if (id == -1) { - // create program - id = JmeIosGLES.glCreateProgram(); - JmeIosGLES.checkGLError(); - - if (id <= 0) { - throw new RendererException("Invalid ID received when trying to create shader program."); - } - - shader.setId(id); - needRegister = true; - } - - for (ShaderSource source : shader.getSources()) { - if (source.isUpdateNeeded()) { - updateShaderSourceData(source); - } - - JmeIosGLES.glAttachShader(id, source.getId()); - JmeIosGLES.checkGLError(); - } - - // link shaders to program - JmeIosGLES.glLinkProgram(id); - JmeIosGLES.checkGLError(); - - JmeIosGLES.glGetProgramiv(id, JmeIosGLES.GL_LINK_STATUS, intBuf1, 0); - JmeIosGLES.checkGLError(); - - boolean linkOK = intBuf1[0] == JmeIosGLES.GL_TRUE; - String infoLog = null; - - if (VALIDATE_SHADER || !linkOK) { - JmeIosGLES.glGetProgramiv(id, JmeIosGLES.GL_INFO_LOG_LENGTH, intBuf1, 0); - JmeIosGLES.checkGLError(); - - int length = intBuf1[0]; - if (length > 3) { - // get infos - infoLog = JmeIosGLES.glGetProgramInfoLog(id); - JmeIosGLES.checkGLError(); - } - } - - if (linkOK) { - if (infoLog != null) { - logger.log(Level.FINE, "shader link success. \n{0}", infoLog); - } else { - logger.fine("shader link success"); - } - shader.clearUpdateNeeded(); - if (needRegister) { - // Register shader for clean up if it was created in this method. - objManager.registerObject(shader); - statistics.onNewShader(); - } else { - // OpenGL spec: uniform locations may change after re-link - resetUniformLocations(shader); - } - } else { - if (infoLog != null) { - throw new RendererException("Shader link failure, shader:" + shader + "\n" + infoLog); - } else { - throw new RendererException("Shader link failure, shader:" + shader + "\ninfo: "); - } - } - } - - protected void resetUniformLocations(Shader shader) { - ListMap uniforms = shader.getUniformMap(); - for (int i = 0; i < uniforms.size(); i++) { - Uniform uniform = uniforms.getValue(i); - uniform.reset(); // e.g check location again - } - } - - public void updateTexImageData(Image img, Texture.Type type) { - int texId = img.getId(); - if (texId == -1) { - // create texture - JmeIosGLES.glGenTextures(1, intBuf1, 0); - JmeIosGLES.checkGLError(); - - texId = intBuf1[0]; - img.setId(texId); - objManager.registerObject(img); - - statistics.onNewTexture(); - } - - // bind texture - int target = convertTextureType(type); - if (context.boundTextures[0] != img) { - if (context.boundTextureUnit != 0) { - JmeIosGLES.glActiveTexture(JmeIosGLES.GL_TEXTURE0); - JmeIosGLES.checkGLError(); - - context.boundTextureUnit = 0; - } - - JmeIosGLES.glBindTexture(target, texId); - JmeIosGLES.checkGLError(); - - context.boundTextures[0] = img; - } - - boolean needMips = false; - if (img.isGeneratedMipmapsRequired()) { - needMips = true; - img.setMipmapsGenerated(true); - } - - if (target == JmeIosGLES.GL_TEXTURE_CUBE_MAP) { - // Check max texture size before upload - if (img.getWidth() > maxCubeTexSize || img.getHeight() > maxCubeTexSize) { - throw new RendererException("Cannot upload cubemap " + img + ". The maximum supported cubemap resolution is " + maxCubeTexSize); - } - } else { - if (img.getWidth() > maxTexSize || img.getHeight() > maxTexSize) { - throw new RendererException("Cannot upload texture " + img + ". The maximum supported texture resolution is " + maxTexSize); - } - } - - if (target == JmeIosGLES.GL_TEXTURE_CUBE_MAP) { - // Upload a cube map / sky box - /* - @SuppressWarnings("unchecked") - List bmps = (List) img.getEfficentData(); - if (bmps != null) { - // Native android bitmap - if (bmps.size() != 6) { - throw new UnsupportedOperationException("Invalid texture: " + img - + "Cubemap textures must contain 6 data units."); - } - for (int i = 0; i < 6; i++) { - TextureUtil.uploadTextureBitmap(JmeIosGLES.GL_TEXTURE_CUBE_MAP_POSITIVE_X + i, bmps.get(i).getBitmap(), needMips); - bmps.get(i).notifyBitmapUploaded(); - } - } else { - */ - // Standard jme3 image data - List data = img.getData(); - if (data.size() != 6) { - throw new UnsupportedOperationException("Invalid texture: " + img - + "Cubemap textures must contain 6 data units."); - } - for (int i = 0; i < 6; i++) { - TextureUtil.uploadTextureAny(img, JmeIosGLES.GL_TEXTURE_CUBE_MAP_POSITIVE_X + i, i, needMips); - } - //} - } else { - TextureUtil.uploadTextureAny(img, target, 0, needMips); - /* - if (img.getEfficentData() instanceof AndroidImageInfo) { - AndroidImageInfo info = (AndroidImageInfo) img.getEfficentData(); - info.notifyBitmapUploaded(); - } - */ - } - - img.clearUpdateNeeded(); - } - - private void setupTextureParams(Texture tex) { - int target = convertTextureType(tex.getType()); - - // filter things - int minFilter = convertMinFilter(tex.getMinFilter()); - int magFilter = convertMagFilter(tex.getMagFilter()); - - JmeIosGLES.glTexParameteri(target, JmeIosGLES.GL_TEXTURE_MIN_FILTER, minFilter); - JmeIosGLES.checkGLError(); - JmeIosGLES.glTexParameteri(target, JmeIosGLES.GL_TEXTURE_MAG_FILTER, magFilter); - JmeIosGLES.checkGLError(); - - /* - if (tex.getAnisotropicFilter() > 1){ - - if (GLContext.getCapabilities().GL_EXT_texture_filter_anisotropic){ - glTexParameterf(target, - EXTTextureFilterAnisotropic.GL_TEXTURE_MAX_ANISOTROPY_EXT, - tex.getAnisotropicFilter()); - } - - } - */ - // repeat modes - - switch (tex.getType()) { - case ThreeDimensional: - case CubeMap: // cubemaps use 3D coords - // GL_TEXTURE_WRAP_R is not available in api 8 - //GLES20.glTexParameteri(target, GLES20.GL_TEXTURE_WRAP_R, convertWrapMode(tex.getWrap(WrapAxis.R))); - case TwoDimensional: - case TwoDimensionalArray: - JmeIosGLES.glTexParameteri(target, JmeIosGLES.GL_TEXTURE_WRAP_T, convertWrapMode(tex.getWrap(WrapAxis.T))); - - // fall down here is intentional.. -// case OneDimensional: - JmeIosGLES.glTexParameteri(target, JmeIosGLES.GL_TEXTURE_WRAP_S, convertWrapMode(tex.getWrap(WrapAxis.S))); - - JmeIosGLES.checkGLError(); - break; - default: - throw new UnsupportedOperationException("Unknown texture type: " + tex.getType()); - } - - // R to Texture compare mode -/* - if (tex.getShadowCompareMode() != Texture.ShadowCompareMode.Off){ - GLES20.glTexParameteri(target, GLES20.GL_TEXTURE_COMPARE_MODE, GLES20.GL_COMPARE_R_TO_TEXTURE); - GLES20.glTexParameteri(target, GLES20.GL_DEPTH_TEXTURE_MODE, GLES20.GL_INTENSITY); - if (tex.getShadowCompareMode() == Texture.ShadowCompareMode.GreaterOrEqual){ - GLES20.glTexParameteri(target, GLES20.GL_TEXTURE_COMPARE_FUNC, GLES20.GL_GEQUAL); - }else{ - GLES20.glTexParameteri(target, GLES20.GL_TEXTURE_COMPARE_FUNC, GLES20.GL_LEQUAL); - } - } - */ - } - - private int convertTextureType(Texture.Type type) { - switch (type) { - case TwoDimensional: - return JmeIosGLES.GL_TEXTURE_2D; - // case TwoDimensionalArray: - // return EXTTextureArray.GL_TEXTURE_2D_ARRAY_EXT; -// case ThreeDimensional: - // return GLES20.GL_TEXTURE_3D; - case CubeMap: - return JmeIosGLES.GL_TEXTURE_CUBE_MAP; - default: - throw new UnsupportedOperationException("Unknown texture type: " + type); - } - } - - private int convertMagFilter(Texture.MagFilter filter) { - switch (filter) { - case Bilinear: - return JmeIosGLES.GL_LINEAR; - case Nearest: - return JmeIosGLES.GL_NEAREST; - default: - throw new UnsupportedOperationException("Unknown mag filter: " + filter); - } - } - - private int convertMinFilter(Texture.MinFilter filter) { - switch (filter) { - case Trilinear: - return JmeIosGLES.GL_LINEAR_MIPMAP_LINEAR; - case BilinearNearestMipMap: - return JmeIosGLES.GL_LINEAR_MIPMAP_NEAREST; - case NearestLinearMipMap: - return JmeIosGLES.GL_NEAREST_MIPMAP_LINEAR; - case NearestNearestMipMap: - return JmeIosGLES.GL_NEAREST_MIPMAP_NEAREST; - case BilinearNoMipMaps: - return JmeIosGLES.GL_LINEAR; - case NearestNoMipMaps: - return JmeIosGLES.GL_NEAREST; - default: - throw new UnsupportedOperationException("Unknown min filter: " + filter); - } - } - - private int convertWrapMode(Texture.WrapMode mode) { - switch (mode) { - case BorderClamp: - case Clamp: - case EdgeClamp: - return JmeIosGLES.GL_CLAMP_TO_EDGE; - case Repeat: - return JmeIosGLES.GL_REPEAT; - case MirroredRepeat: - return JmeIosGLES.GL_MIRRORED_REPEAT; - default: - throw new UnsupportedOperationException("Unknown wrap mode: " + mode); - } - } - - private void renderMeshVertexArray(Mesh mesh, int lod, int count) { - for (VertexBuffer vb : mesh.getBufferList().getArray()) { - if (vb.getBufferType() == Type.InterleavedData - || vb.getUsage() == Usage.CpuOnly // ignore cpu-only buffers - || vb.getBufferType() == Type.Index) { - continue; - } - - if (vb.getStride() == 0) { - // not interleaved - setVertexAttrib_Array(vb); - } else { - // interleaved - VertexBuffer interleavedData = mesh.getBuffer(Type.InterleavedData); - setVertexAttrib_Array(vb, interleavedData); - } - } - - VertexBuffer indices = null; - if (mesh.getNumLodLevels() > 0) { - indices = mesh.getLodLevel(lod); - } else { - indices = mesh.getBuffer(Type.Index);//buffers.get(Type.Index.ordinal()); - } - if (indices != null) { - drawTriangleList_Array(indices, mesh, count); - } else { - JmeIosGLES.glDrawArrays(convertElementMode(mesh.getMode()), 0, mesh.getVertexCount()); - JmeIosGLES.checkGLError(); - } - clearVertexAttribs(); - } - - private void renderMeshDefault(Mesh mesh, int lod, int count) { - VertexBuffer indices = null; - VertexBuffer interleavedData = mesh.getBuffer(Type.InterleavedData); - if (interleavedData != null && interleavedData.isUpdateNeeded()) { - updateBufferData(interleavedData); - } - - //IntMap buffers = mesh.getBuffers(); ; - if (mesh.getNumLodLevels() > 0) { - indices = mesh.getLodLevel(lod); - } else { - indices = mesh.getBuffer(Type.Index);// buffers.get(Type.Index.ordinal()); - } - for (VertexBuffer vb : mesh.getBufferList().getArray()){ - if (vb.getBufferType() == Type.InterleavedData - || vb.getUsage() == Usage.CpuOnly // ignore cpu-only buffers - || vb.getBufferType() == Type.Index) { - continue; - } - - if (vb.getStride() == 0) { - // not interleaved - setVertexAttrib(vb); - } else { - // interleaved - setVertexAttrib(vb, interleavedData); - } - } - if (indices != null) { - drawTriangleList(indices, mesh, count); - } else { -// throw new UnsupportedOperationException("Cannot render without index buffer"); - JmeIosGLES.glDrawArrays(convertElementMode(mesh.getMode()), 0, mesh.getVertexCount()); - JmeIosGLES.checkGLError(); - } - clearVertexAttribs(); - } - - - public void setVertexAttrib(VertexBuffer vb, VertexBuffer idb) { - if (vb.getBufferType() == VertexBuffer.Type.Index) { - throw new IllegalArgumentException("Index buffers not allowed to be set to vertex attrib"); - } - - if (vb.isUpdateNeeded() && idb == null) { - updateBufferData(vb); - } - - int programId = context.boundShaderProgram; - if (programId > 0) { - Attribute attrib = boundShader.getAttribute(vb.getBufferType()); - int loc = attrib.getLocation(); - if (loc == -1) { - return; // not defined - } - - if (loc == -2) { -// stringBuf.setLength(0); -// stringBuf.append("in").append(vb.getBufferType().name()).append('\0'); -// updateNameBuffer(); - - String attributeName = "in" + vb.getBufferType().name(); - loc = JmeIosGLES.glGetAttribLocation(programId, attributeName); - JmeIosGLES.checkGLError(); - - // not really the name of it in the shader (inPosition\0) but - // the internal name of the enum (Position). - if (loc < 0) { - attrib.setLocation(-1); - return; // not available in shader. - } else { - attrib.setLocation(loc); - } - } - - VertexBuffer[] attribs = context.boundAttribs; - if (!context.attribIndexList.moveToNew(loc)) { - JmeIosGLES.glEnableVertexAttribArray(loc); - JmeIosGLES.checkGLError(); - //System.out.println("Enabled ATTRIB IDX: "+loc); - } - if (attribs[loc] != vb) { - // NOTE: Use id from interleaved buffer if specified - int bufId = idb != null ? idb.getId() : vb.getId(); - assert bufId != -1; - - if (bufId == -1) { - logger.warning("invalid buffer id"); - } - - if (context.boundArrayVBO != bufId) { - JmeIosGLES.glBindBuffer(JmeIosGLES.GL_ARRAY_BUFFER, bufId); - JmeIosGLES.checkGLError(); - - context.boundArrayVBO = bufId; - } - - vb.getData().rewind(); - /* - Android22Workaround.glVertexAttribPointer(loc, - vb.getNumComponents(), - convertVertexBufferFormat(vb.getFormat()), - vb.isNormalized(), - vb.getStride(), - 0); - */ - logger.warning("iTODO Android22Workaround"); - - JmeIosGLES.glVertexAttribPointer(loc, - vb.getNumComponents(), - convertVertexBufferFormat(vb.getFormat()), - vb.isNormalized(), - vb.getStride(), - null); - - JmeIosGLES.checkGLError(); - - attribs[loc] = vb; - } - } else { - throw new IllegalStateException("Cannot render mesh without shader bound"); - } - } - - public void setVertexAttrib(VertexBuffer vb) { - setVertexAttrib(vb, null); - } - - public void drawTriangleArray(Mesh.Mode mode, int count, int vertCount) { - /* if (count > 1){ - ARBDrawInstanced.glDrawArraysInstancedARB(convertElementMode(mode), 0, - vertCount, count); - }else{*/ - JmeIosGLES.glDrawArrays(convertElementMode(mode), 0, vertCount); - JmeIosGLES.checkGLError(); - /* - }*/ - } - - public void drawTriangleList(VertexBuffer indexBuf, Mesh mesh, int count) { - if (indexBuf.getBufferType() != VertexBuffer.Type.Index) { - throw new IllegalArgumentException("Only index buffers are allowed as triangle lists."); - } - - if (indexBuf.isUpdateNeeded()) { - updateBufferData(indexBuf); - } - - int bufId = indexBuf.getId(); - assert bufId != -1; - - if (bufId == -1) { - throw new RendererException("Invalid buffer ID"); - } - - if (context.boundElementArrayVBO != bufId) { - JmeIosGLES.glBindBuffer(JmeIosGLES.GL_ELEMENT_ARRAY_BUFFER, bufId); - JmeIosGLES.checkGLError(); - - context.boundElementArrayVBO = bufId; - } - - int vertCount = mesh.getVertexCount(); - boolean useInstancing = count > 1 && caps.contains(Caps.MeshInstancing); - - Buffer indexData = indexBuf.getData(); - - if (!uintIndexSupport && (indexBuf.getFormat() == Format.UnsignedInt)) { - throw new RendererException("OpenGL ES does not support 32-bit index buffers." + - "Split your models to avoid going over 65536 vertices."); - } - - if (mesh.getMode() == Mode.Hybrid) { - int[] modeStart = mesh.getModeStart(); - int[] elementLengths = mesh.getElementLengths(); - - int elMode = convertElementMode(Mode.Triangles); - int fmt = convertVertexBufferFormat(indexBuf.getFormat()); - int elSize = indexBuf.getFormat().getComponentSize(); - int listStart = modeStart[0]; - int stripStart = modeStart[1]; - int fanStart = modeStart[2]; - int curOffset = 0; - for (int i = 0; i < elementLengths.length; i++) { - if (i == stripStart) { - elMode = convertElementMode(Mode.TriangleStrip); - } else if (i == fanStart) { - elMode = convertElementMode(Mode.TriangleStrip); - } - int elementLength = elementLengths[i]; - - if (useInstancing) { - //ARBDrawInstanced. - throw new IllegalArgumentException("instancing is not supported."); - /* - GLES20.glDrawElementsInstancedARB(elMode, - elementLength, - fmt, - curOffset, - count); - */ - } else { - indexBuf.getData().position(curOffset); - JmeIosGLES.glDrawElements(elMode, elementLength, fmt, indexBuf.getData()); - JmeIosGLES.checkGLError(); - /* - glDrawRangeElements(elMode, - 0, - vertCount, - elementLength, - fmt, - curOffset); - */ - } - - curOffset += elementLength * elSize; - } - } else { - if (useInstancing) { - throw new IllegalArgumentException("instancing is not supported."); - //ARBDrawInstanced. -/* - GLES20.glDrawElementsInstancedARB(convertElementMode(mesh.getMode()), - indexBuf.getData().limit(), - convertVertexBufferFormat(indexBuf.getFormat()), - 0, - count); - */ - } else { - logger.log(Level.FINE, "IGLESShaderRenderer drawTriangleList TODO check"); - indexData.rewind(); - JmeIosGLES.glDrawElementsIndex( - convertElementMode(mesh.getMode()), - indexBuf.getData().limit(), - convertVertexBufferFormat(indexBuf.getFormat()), - 0); - /*TODO: - indexData.rewind(); - JmeIosGLES.glDrawElements( - convertElementMode(mesh.getMode()), - indexBuf.getData().limit(), - convertVertexBufferFormat(indexBuf.getFormat()), - 0); - */ - JmeIosGLES.checkGLError(); - } - } - } - - public int convertElementMode(Mesh.Mode mode) { - switch (mode) { - case Points: - return JmeIosGLES.GL_POINTS; - case Lines: - return JmeIosGLES.GL_LINES; - case LineLoop: - return JmeIosGLES.GL_LINE_LOOP; - case LineStrip: - return JmeIosGLES.GL_LINE_STRIP; - case Triangles: - return JmeIosGLES.GL_TRIANGLES; - case TriangleFan: - return JmeIosGLES.GL_TRIANGLE_FAN; - case TriangleStrip: - return JmeIosGLES.GL_TRIANGLE_STRIP; - default: - throw new UnsupportedOperationException("Unrecognized mesh mode: " + mode); - } - } - - - private int convertVertexBufferFormat(Format format) { - switch (format) { - case Byte: - return JmeIosGLES.GL_BYTE; - case UnsignedByte: - return JmeIosGLES.GL_UNSIGNED_BYTE; - case Short: - return JmeIosGLES.GL_SHORT; - case UnsignedShort: - return JmeIosGLES.GL_UNSIGNED_SHORT; - case Int: - return JmeIosGLES.GL_INT; - case UnsignedInt: - return JmeIosGLES.GL_UNSIGNED_INT; - /* - case Half: - return NVHalfFloat.GL_HALF_FLOAT_NV; - // return ARBHalfFloatVertex.GL_HALF_FLOAT; - */ - case Float: - return JmeIosGLES.GL_FLOAT; -// case Double: -// return JmeIosGLES.GL_DOUBLE; - default: - throw new RuntimeException("Unknown buffer format."); - - } - } - - public void clearVertexAttribs() { - IDList attribList = context.attribIndexList; - for (int i = 0; i < attribList.oldLen; i++) { - int idx = attribList.oldList[i]; - - JmeIosGLES.glDisableVertexAttribArray(idx); - JmeIosGLES.checkGLError(); - - context.boundAttribs[idx] = null; - } - context.attribIndexList.copyNewToOld(); - } - - public void updateFrameBuffer(FrameBuffer fb) { - int id = fb.getId(); - if (id == -1) { - // create FBO - JmeIosGLES.glGenFramebuffers(1, intBuf1, 0); - JmeIosGLES.checkGLError(); - - id = intBuf1[0]; - fb.setId(id); - objManager.registerObject(fb); - - statistics.onNewFrameBuffer(); - } - - if (context.boundFBO != id) { - JmeIosGLES.glBindFramebuffer(JmeIosGLES.GL_FRAMEBUFFER, id); - JmeIosGLES.checkGLError(); - - // binding an FBO automatically sets draw buf to GL_COLOR_ATTACHMENT0 - context.boundDrawBuf = 0; - context.boundFBO = id; - } - - FrameBuffer.RenderBuffer depthBuf = fb.getDepthBuffer(); - if (depthBuf != null) { - updateFrameBufferAttachment(fb, depthBuf); - } - - for (int i = 0; i < fb.getNumColorBuffers(); i++) { - FrameBuffer.RenderBuffer colorBuf = fb.getColorBuffer(i); - updateFrameBufferAttachment(fb, colorBuf); - } - - fb.clearUpdateNeeded(); - } - - - public void updateFrameBufferAttachment(FrameBuffer fb, RenderBuffer rb) { - boolean needAttach; - if (rb.getTexture() == null) { - // if it hasn't been created yet, then attach is required. - needAttach = rb.getId() == -1; - updateRenderBuffer(fb, rb); - } else { - needAttach = false; - updateRenderTexture(fb, rb); - } - if (needAttach) { - JmeIosGLES.glFramebufferRenderbuffer(JmeIosGLES.GL_FRAMEBUFFER, - convertAttachmentSlot(rb.getSlot()), - JmeIosGLES.GL_RENDERBUFFER, - rb.getId()); - - JmeIosGLES.checkGLError(); - } - } - - - public void updateRenderTexture(FrameBuffer fb, RenderBuffer rb) { - Texture tex = rb.getTexture(); - Image image = tex.getImage(); - if (image.isUpdateNeeded()) { - updateTexImageData(image, tex.getType()); - - // NOTE: For depth textures, sets nearest/no-mips mode - // Required to fix "framebuffer unsupported" - // for old NVIDIA drivers! - setupTextureParams(tex); - } - - JmeIosGLES.glFramebufferTexture2D(JmeIosGLES.GL_FRAMEBUFFER, - convertAttachmentSlot(rb.getSlot()), - convertTextureType(tex.getType()), - image.getId(), - 0); - - JmeIosGLES.checkGLError(); - } - - - private void updateRenderBuffer(FrameBuffer fb, RenderBuffer rb) { - int id = rb.getId(); - if (id == -1) { - JmeIosGLES.glGenRenderbuffers(1, intBuf1, 0); - JmeIosGLES.checkGLError(); - - id = intBuf1[0]; - rb.setId(id); - } - - if (context.boundRB != id) { - JmeIosGLES.glBindRenderbuffer(JmeIosGLES.GL_RENDERBUFFER, id); - JmeIosGLES.checkGLError(); - - context.boundRB = id; - } - - if (fb.getWidth() > maxRBSize || fb.getHeight() > maxRBSize) { - throw new RendererException("Resolution " + fb.getWidth() - + ":" + fb.getHeight() + " is not supported."); - } - - TextureUtil.IosGLImageFormat imageFormat = TextureUtil.getImageFormat(rb.getFormat()); - if (imageFormat.renderBufferStorageFormat == 0) { - throw new RendererException("The format '" + rb.getFormat() + "' cannot be used for renderbuffers."); - } - -// if (fb.getSamples() > 1 && GLContext.getCapabilities().GL_EXT_framebuffer_multisample) { - if (fb.getSamples() > 1) { -// // FIXME - throw new RendererException("Multisample FrameBuffer is not supported yet."); -// int samples = fb.getSamples(); -// if (maxFBOSamples < samples) { -// samples = maxFBOSamples; -// } -// glRenderbufferStorageMultisampleEXT(GL_RENDERBUFFER_EXT, -// samples, -// glFmt.internalFormat, -// fb.getWidth(), -// fb.getHeight()); - } else { - JmeIosGLES.glRenderbufferStorage(JmeIosGLES.GL_RENDERBUFFER, - imageFormat.renderBufferStorageFormat, - fb.getWidth(), - fb.getHeight()); - - JmeIosGLES.checkGLError(); - } - } - - - private int convertAttachmentSlot(int attachmentSlot) { - // can also add support for stencil here - if (attachmentSlot == FrameBuffer.SLOT_DEPTH) { - return JmeIosGLES.GL_DEPTH_ATTACHMENT; - } else if (attachmentSlot == 0) { - return JmeIosGLES.GL_COLOR_ATTACHMENT0; - } else { - throw new UnsupportedOperationException("Android does not support multiple color attachments to an FBO"); - } - } - - - private void checkFrameBufferStatus(FrameBuffer fb) { - try { - checkFrameBufferError(); - } catch (IllegalStateException ex) { - logger.log(Level.SEVERE, "=== jMonkeyEngine FBO State ===\n{0}", fb); - printRealFrameBufferInfo(fb); - throw ex; - } - } - - private void checkFrameBufferError() { - int status = JmeIosGLES.glCheckFramebufferStatus(JmeIosGLES.GL_FRAMEBUFFER); - switch (status) { - case JmeIosGLES.GL_FRAMEBUFFER_COMPLETE: - break; - case JmeIosGLES.GL_FRAMEBUFFER_UNSUPPORTED: - //Choose different formats - throw new IllegalStateException("Framebuffer object format is " - + "unsupported by the video hardware."); - case JmeIosGLES.GL_FRAMEBUFFER_INCOMPLETE_ATTACHMENT: - throw new IllegalStateException("Framebuffer has erronous attachment."); - case JmeIosGLES.GL_FRAMEBUFFER_INCOMPLETE_MISSING_ATTACHMENT: - throw new IllegalStateException("Framebuffer doesn't have any renderbuffers attached."); - case JmeIosGLES.GL_FRAMEBUFFER_INCOMPLETE_DIMENSIONS: - throw new IllegalStateException("Framebuffer attachments must have same dimensions."); -// case GLES20.GL_FRAMEBUFFER_INCOMPLETE_FORMATS: -// throw new IllegalStateException("Framebuffer attachments must have same formats."); -// case GLES20.GL_FRAMEBUFFER_INCOMPLETE_DRAW_BUFFER: -// throw new IllegalStateException("Incomplete draw buffer."); -// case GLES20.GL_FRAMEBUFFER_INCOMPLETE_READ_BUFFER_EXT: -// throw new IllegalStateException("Incomplete read buffer."); -// case GLES20.GL_FRAMEBUFFER_INCOMPLETE_MULTISAMPLE_EXT: -// throw new IllegalStateException("Incomplete multisample buffer."); - default: - //Programming error; will fail on all hardware - throw new IllegalStateException("Some video driver error " - + "or programming error occured. " - + "Framebuffer object status is invalid: " + status); - } - } - - private void printRealRenderBufferInfo(FrameBuffer fb, RenderBuffer rb, String name) { - System.out.println("== Renderbuffer " + name + " =="); - System.out.println("RB ID: " + rb.getId()); - System.out.println("Is proper? " + JmeIosGLES.glIsRenderbuffer(rb.getId())); - - int attachment = convertAttachmentSlot(rb.getSlot()); - - //intBuf16.clear(); - JmeIosGLES.glGetFramebufferAttachmentParameteriv(JmeIosGLES.GL_FRAMEBUFFER, - attachment, JmeIosGLES.GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE, intBuf16, 0); - int type = intBuf16[0]; - - //intBuf16.clear(); - JmeIosGLES.glGetFramebufferAttachmentParameteriv(JmeIosGLES.GL_FRAMEBUFFER, - attachment, JmeIosGLES.GL_FRAMEBUFFER_ATTACHMENT_OBJECT_NAME, intBuf16, 0); - int rbName = intBuf16[0]; - - switch (type) { - case JmeIosGLES.GL_NONE: - System.out.println("Type: None"); - break; - case JmeIosGLES.GL_TEXTURE: - System.out.println("Type: Texture"); - break; - case JmeIosGLES.GL_RENDERBUFFER: - System.out.println("Type: Buffer"); - System.out.println("RB ID: " + rbName); - break; - } - } - - private void printRealFrameBufferInfo(FrameBuffer fb) { -// boolean doubleBuffer = GLES20.glGetBooleanv(GLES20.GL_DOUBLEBUFFER); - boolean doubleBuffer = false; // FIXME -// String drawBuf = getTargetBufferName(glGetInteger(GL_DRAW_BUFFER)); -// String readBuf = getTargetBufferName(glGetInteger(GL_READ_BUFFER)); - - int fbId = fb.getId(); - //intBuf16.clear(); -// int curDrawBinding = GLES20.glGetIntegerv(GLES20.GL_DRAW_FRAMEBUFFER_BINDING); -// int curReadBinding = glGetInteger(ARBFramebufferObject.GL_READ_FRAMEBUFFER_BINDING); - - System.out.println("=== OpenGL FBO State ==="); - System.out.println("Context doublebuffered? " + doubleBuffer); - System.out.println("FBO ID: " + fbId); - System.out.println("Is proper? " + JmeIosGLES.glIsFramebuffer(fbId)); -// System.out.println("Is bound to draw? " + (fbId == curDrawBinding)); -// System.out.println("Is bound to read? " + (fbId == curReadBinding)); -// System.out.println("Draw buffer: " + drawBuf); -// System.out.println("Read buffer: " + readBuf); - - if (context.boundFBO != fbId) { - JmeIosGLES.glBindFramebuffer(JmeIosGLES.GL_FRAMEBUFFER, fbId); - context.boundFBO = fbId; - } - - if (fb.getDepthBuffer() != null) { - printRealRenderBufferInfo(fb, fb.getDepthBuffer(), "Depth"); - } - for (int i = 0; i < fb.getNumColorBuffers(); i++) { - printRealRenderBufferInfo(fb, fb.getColorBuffer(i), "Color" + i); - } - - - } - - public void drawTriangleList_Array(VertexBuffer indexBuf, Mesh mesh, int count) { - if (indexBuf.getBufferType() != VertexBuffer.Type.Index) { - throw new IllegalArgumentException("Only index buffers are allowed as triangle lists."); - } - - boolean useInstancing = count > 1 && caps.contains(Caps.MeshInstancing); - if (useInstancing) { - throw new IllegalArgumentException("Caps.MeshInstancing is not supported."); - } - - int vertCount = mesh.getVertexCount(); - Buffer indexData = indexBuf.getData(); - indexData.rewind(); - - if (mesh.getMode() == Mode.Hybrid) { - int[] modeStart = mesh.getModeStart(); - int[] elementLengths = mesh.getElementLengths(); - - int elMode = convertElementMode(Mode.Triangles); - int fmt = convertVertexBufferFormat(indexBuf.getFormat()); - int elSize = indexBuf.getFormat().getComponentSize(); - int listStart = modeStart[0]; - int stripStart = modeStart[1]; - int fanStart = modeStart[2]; - int curOffset = 0; - for (int i = 0; i < elementLengths.length; i++) { - if (i == stripStart) { - elMode = convertElementMode(Mode.TriangleStrip); - } else if (i == fanStart) { - elMode = convertElementMode(Mode.TriangleFan); - } - int elementLength = elementLengths[i]; - - indexBuf.getData().position(curOffset); - JmeIosGLES.glDrawElements(elMode, elementLength, fmt, indexBuf.getData()); - JmeIosGLES.checkGLError(); - - curOffset += elementLength * elSize; - } - } else { - JmeIosGLES.glDrawElements( - convertElementMode(mesh.getMode()), - indexBuf.getData().limit(), - convertVertexBufferFormat(indexBuf.getFormat()), - indexBuf.getData()); - JmeIosGLES.checkGLError(); - } - } - - public void setVertexAttrib_Array(VertexBuffer vb, VertexBuffer idb) { - if (vb.getBufferType() == VertexBuffer.Type.Index) { - throw new IllegalArgumentException("Index buffers not allowed to be set to vertex attrib"); - } - - // Get shader - int programId = context.boundShaderProgram; - if (programId > 0) { - VertexBuffer[] attribs = context.boundAttribs; - - Attribute attrib = boundShader.getAttribute(vb.getBufferType()); - int loc = attrib.getLocation(); - if (loc == -1) { - //throw new IllegalArgumentException("Location is invalid for attrib: [" + vb.getBufferType().name() + "]"); - return; - } else if (loc == -2) { - String attributeName = "in" + vb.getBufferType().name(); - - loc = JmeIosGLES.glGetAttribLocation(programId, attributeName); - JmeIosGLES.checkGLError(); - - if (loc < 0) { - attrib.setLocation(-1); - return; // not available in shader. - } else { - attrib.setLocation(loc); - } - - } // if (loc == -2) - - if ((attribs[loc] != vb) || vb.isUpdateNeeded()) { - // NOTE: Use data from interleaved buffer if specified - VertexBuffer avb = idb != null ? idb : vb; - avb.getData().rewind(); - avb.getData().position(vb.getOffset()); - - // Upload attribute data - JmeIosGLES.glVertexAttribPointer(loc, - vb.getNumComponents(), - convertVertexBufferFormat(vb.getFormat()), - vb.isNormalized(), - vb.getStride(), - avb.getData()); - - JmeIosGLES.checkGLError(); - - JmeIosGLES.glEnableVertexAttribArray(loc); - JmeIosGLES.checkGLError(); - - attribs[loc] = vb; - } // if (attribs[loc] != vb) - } else { - throw new IllegalStateException("Cannot render mesh without shader bound"); - } - } - - public void setVertexAttrib_Array(VertexBuffer vb) { - setVertexAttrib_Array(vb, null); - } - - - public void updateShaderSourceData(ShaderSource source) { - int id = source.getId(); - if (id == -1) { - // Create id - id = JmeIosGLES.glCreateShader(convertShaderType(source.getType())); - JmeIosGLES.checkGLError(); - - if (id <= 0) { - throw new RendererException("Invalid ID received when trying to create shader."); - } - source.setId(id); - } - - if (!source.getLanguage().equals("GLSL100")) { - throw new RendererException("This shader cannot run in OpenGL ES. " - + "Only GLSL 1.0 shaders are supported."); - } - - // upload shader source - // merge the defines and source code - byte[] definesCodeData = source.getDefines().getBytes(); - byte[] sourceCodeData = source.getSource().getBytes(); - ByteBuffer codeBuf = BufferUtils.createByteBuffer(definesCodeData.length - + sourceCodeData.length); - codeBuf.put(definesCodeData); - codeBuf.put(sourceCodeData); - codeBuf.flip(); - - if (powerVr && source.getType() == ShaderType.Vertex) { - // XXX: This is to fix a bug in old PowerVR, remove - // when no longer applicable. - JmeIosGLES.glShaderSource( - id, source.getDefines() - + source.getSource()); - } else { - String precision =""; - if (source.getType() == ShaderType.Fragment) { - precision = "precision mediump float;\n"; - } - JmeIosGLES.glShaderSource( - id, - precision - +source.getDefines() - + source.getSource()); - } -// int range[] = new int[2]; -// int precision[] = new int[1]; -// GLES20.glGetShaderPrecisionFormat(GLES20.GL_VERTEX_SHADER, GLES20.GL_HIGH_FLOAT, range, 0, precision, 0); -// System.out.println("PRECISION HIGH FLOAT VERTEX"); -// System.out.println("range "+range[0]+"," +range[1]); -// System.out.println("precision "+precision[0]); - - JmeIosGLES.glCompileShader(id); - JmeIosGLES.checkGLError(); - - JmeIosGLES.glGetShaderiv(id, JmeIosGLES.GL_COMPILE_STATUS, intBuf1, 0); - JmeIosGLES.checkGLError(); - - boolean compiledOK = intBuf1[0] == JmeIosGLES.GL_TRUE; - String infoLog = null; - - if (VALIDATE_SHADER || !compiledOK) { - // even if compile succeeded, check - // log for warnings - JmeIosGLES.glGetShaderiv(id, JmeIosGLES.GL_INFO_LOG_LENGTH, intBuf1, 0); - JmeIosGLES.checkGLError(); - infoLog = JmeIosGLES.glGetShaderInfoLog(id); - } - - if (compiledOK) { - if (infoLog != null) { - logger.log(Level.FINE, "compile success: {0}, {1}", new Object[]{source.getName(), infoLog}); - } else { - logger.log(Level.FINE, "compile success: {0}", source.getName()); - } - source.clearUpdateNeeded(); - } else { - logger.log(Level.WARNING, "Bad compile of:\n{0}", - new Object[]{ShaderDebug.formatShaderSource(stringBuf.toString() + source.getDefines() + source.getSource())}); - if (infoLog != null) { - throw new RendererException("compile error in: " + source + "\n" + infoLog); - } else { - throw new RendererException("compile error in: " + source + "\nerror: "); - } - } - } - - - public int convertShaderType(ShaderType type) { - switch (type) { - case Fragment: - return JmeIosGLES.GL_FRAGMENT_SHADER; - case Vertex: - return JmeIosGLES.GL_VERTEX_SHADER; -// case Geometry: -// return ARBGeometryShader4.GL_GEOMETRY_SHADER_ARB; - default: - throw new RuntimeException("Unrecognized shader type."); - } - } - - private int convertTestFunction(RenderState.TestFunction testFunc) { - switch (testFunc) { - case Never: - return JmeIosGLES.GL_NEVER; - case Less: - return JmeIosGLES.GL_LESS; - case LessOrEqual: - return JmeIosGLES.GL_LEQUAL; - case Greater: - return JmeIosGLES.GL_GREATER; - case GreaterOrEqual: - return JmeIosGLES.GL_GEQUAL; - case Equal: - return JmeIosGLES.GL_EQUAL; - case NotEqual: - return JmeIosGLES.GL_NOTEQUAL; - case Always: - return JmeIosGLES.GL_ALWAYS; - default: - throw new UnsupportedOperationException("Unrecognized test function: " + testFunc); - } - } - - public void setMainFrameBufferSrgb(boolean srgb) { - - } - - public void setLinearizeSrgbImages(boolean linearize) { - - } - - public void readFrameBufferWithFormat(FrameBuffer fb, ByteBuffer byteBuf, Image.Format format) { - throw new UnsupportedOperationException("Not supported yet. URA will make that work seamlessly"); - } -} \ No newline at end of file diff --git a/jme3-ios/src/main/java/com/jme3/renderer/ios/TextureUtil.java b/jme3-ios/src/main/java/com/jme3/renderer/ios/TextureUtil.java deleted file mode 100644 index d11308c2a..000000000 --- a/jme3-ios/src/main/java/com/jme3/renderer/ios/TextureUtil.java +++ /dev/null @@ -1,576 +0,0 @@ -package com.jme3.renderer.ios; - -//import android.graphics.Bitmap; -//import android.opengl.ETC1; -//import android.opengl.ETC1Util.ETC1Texture; -//import android.opengl.JmeIosGLES; -//import android.opengl.GLUtils; -//import com.jme3.asset.AndroidImageInfo; -import com.jme3.renderer.ios.JmeIosGLES; -import com.jme3.math.FastMath; -import com.jme3.renderer.RendererException; -import com.jme3.texture.Image; -import com.jme3.texture.Image.Format; -import com.jme3.util.BufferUtils; -import java.nio.ByteBuffer; -import java.util.logging.Level; -import java.util.logging.Logger; - -public class TextureUtil { - - private static final Logger logger = Logger.getLogger(TextureUtil.class.getName()); - //TODO Make this configurable through appSettings - public static boolean ENABLE_COMPRESSION = true; - private static boolean NPOT = false; - private static boolean ETC1support = false; - private static boolean DXT1 = false; - private static boolean PVRTC = false; - private static boolean DEPTH24_STENCIL8 = false; - private static boolean DEPTH_TEXTURE = false; - private static boolean RGBA8 = false; - - // Same constant used by both GL_ARM_rgba8 and GL_OES_rgb8_rgba8. - private static final int GL_RGBA8 = 0x8058; - - private static final int GL_DXT1 = 0x83F0; - private static final int GL_DXT1A = 0x83F1; - - private static final int GL_DEPTH_STENCIL_OES = 0x84F9; - private static final int GL_UNSIGNED_INT_24_8_OES = 0x84FA; - private static final int GL_DEPTH24_STENCIL8_OES = 0x88F0; - - public static void loadTextureFeatures(String extensionString) { - ETC1support = extensionString.contains("GL_OES_compressed_ETC1_RGB8_texture"); - DEPTH24_STENCIL8 = extensionString.contains("GL_OES_packed_depth_stencil"); - NPOT = extensionString.contains("GL_IMG_texture_npot") - || extensionString.contains("GL_OES_texture_npot") - || extensionString.contains("GL_NV_texture_npot_2D_mipmap"); - - PVRTC = extensionString.contains("GL_IMG_texture_compression_pvrtc"); - - DXT1 = extensionString.contains("GL_EXT_texture_compression_dxt1"); - DEPTH_TEXTURE = extensionString.contains("GL_OES_depth_texture"); - - RGBA8 = extensionString.contains("GL_ARM_rgba8") || - extensionString.contains("GL_OES_rgb8_rgba8"); - - logger.log(Level.FINE, "Supports ETC1? {0}", ETC1support); - logger.log(Level.FINE, "Supports DEPTH24_STENCIL8? {0}", DEPTH24_STENCIL8); - logger.log(Level.FINE, "Supports NPOT? {0}", NPOT); - logger.log(Level.FINE, "Supports PVRTC? {0}", PVRTC); - logger.log(Level.FINE, "Supports DXT1? {0}", DXT1); - logger.log(Level.FINE, "Supports DEPTH_TEXTURE? {0}", DEPTH_TEXTURE); - logger.log(Level.FINE, "Supports RGBA8? {0}", RGBA8); - } - - /* - private static void buildMipmap(Bitmap bitmap, boolean compress) { - int level = 0; - int height = bitmap.getHeight(); - int width = bitmap.getWidth(); - - logger.log(Level.FINEST, " - Generating mipmaps for bitmap using SOFTWARE"); - - JmeIosGLES.glPixelStorei(JmeIosGLES.GL_UNPACK_ALIGNMENT, 1); - - while (height >= 1 || width >= 1) { - //First of all, generate the texture from our bitmap and set it to the according level - if (compress) { - logger.log(Level.FINEST, " - Uploading LOD level {0} ({1}x{2}) with compression.", new Object[]{level, width, height}); - uploadBitmapAsCompressed(JmeIosGLES.GL_TEXTURE_2D, level, bitmap, false, 0, 0); - } else { - logger.log(Level.FINEST, " - Uploading LOD level {0} ({1}x{2}) directly.", new Object[]{level, width, height}); - GLUtils.texImage2D(JmeIosGLES.GL_TEXTURE_2D, level, bitmap, 0); - } - - if (height == 1 || width == 1) { - break; - } - - //Increase the mipmap level - height /= 2; - width /= 2; - Bitmap bitmap2 = Bitmap.createScaledBitmap(bitmap, width, height, true); - - // Recycle any bitmaps created as a result of scaling the bitmap. - // Do not recycle the original image (mipmap level 0) - if (level != 0) { - bitmap.recycle(); - } - - bitmap = bitmap2; - - level++; - } - } - - private static void uploadBitmapAsCompressed(int target, int level, Bitmap bitmap, boolean subTexture, int x, int y) { - if (bitmap.hasAlpha()) { - logger.log(Level.FINEST, " - Uploading bitmap directly. Cannot compress as alpha present."); - if (subTexture) { - GLUtils.texSubImage2D(target, level, x, y, bitmap); - JmeIosGLES.checkGLError(); - } else { - GLUtils.texImage2D(target, level, bitmap, 0); - JmeIosGLES.checkGLError(); - } - } else { - // Convert to RGB565 - int bytesPerPixel = 2; - Bitmap rgb565 = bitmap.copy(Bitmap.Config.RGB_565, true); - - // Put texture data into ByteBuffer - ByteBuffer inputImage = BufferUtils.createByteBuffer(bitmap.getRowBytes() * bitmap.getHeight()); - rgb565.copyPixelsToBuffer(inputImage); - inputImage.position(0); - - // Delete the copied RGB565 image - rgb565.recycle(); - - // Encode the image into the output bytebuffer - int encodedImageSize = ETC1.getEncodedDataSize(bitmap.getWidth(), bitmap.getHeight()); - ByteBuffer compressedImage = BufferUtils.createByteBuffer(encodedImageSize); - ETC1.encodeImage(inputImage, bitmap.getWidth(), - bitmap.getHeight(), - bytesPerPixel, - bytesPerPixel * bitmap.getWidth(), - compressedImage); - - // Delete the input image buffer - BufferUtils.destroyDirectBuffer(inputImage); - - // Create an ETC1Texture from the compressed image data - ETC1Texture etc1tex = new ETC1Texture(bitmap.getWidth(), bitmap.getHeight(), compressedImage); - - // Upload the ETC1Texture - if (bytesPerPixel == 2) { - int oldSize = (bitmap.getRowBytes() * bitmap.getHeight()); - int newSize = compressedImage.capacity(); - logger.log(Level.FINEST, " - Uploading compressed image to GL, oldSize = {0}, newSize = {1}, ratio = {2}", new Object[]{oldSize, newSize, (float) oldSize / newSize}); - if (subTexture) { - JmeIosGLES.glCompressedTexSubImage2D(target, - level, - x, y, - bitmap.getWidth(), - bitmap.getHeight(), - ETC1.ETC1_RGB8_OES, - etc1tex.getData().capacity(), - etc1tex.getData()); - - JmeIosGLES.checkGLError(); - } else { - JmeIosGLES.glCompressedTexImage2D(target, - level, - ETC1.ETC1_RGB8_OES, - bitmap.getWidth(), - bitmap.getHeight(), - 0, - etc1tex.getData().capacity(), - etc1tex.getData()); - - JmeIosGLES.checkGLError(); - } - -// ETC1Util.loadTexture(target, level, 0, JmeIosGLES.GL_RGB, -// JmeIosGLES.GL_UNSIGNED_SHORT_5_6_5, etc1Texture); -// } else if (bytesPerPixel == 3) { -// ETC1Util.loadTexture(target, level, 0, JmeIosGLES.GL_RGB, -// JmeIosGLES.GL_UNSIGNED_BYTE, etc1Texture); - } - - BufferUtils.destroyDirectBuffer(compressedImage); - } - } - - /** - * uploadTextureBitmap uploads a native android bitmap - */ - /* - public static void uploadTextureBitmap(final int target, Bitmap bitmap, boolean needMips) { - uploadTextureBitmap(target, bitmap, needMips, false, 0, 0); - } - - /** - * uploadTextureBitmap uploads a native android bitmap - */ - /* - public static void uploadTextureBitmap(final int target, Bitmap bitmap, boolean needMips, boolean subTexture, int x, int y) { - boolean recycleBitmap = false; - //TODO, maybe this should raise an exception when NPOT is not supported - - boolean willCompress = ENABLE_COMPRESSION && ETC1support && !bitmap.hasAlpha(); - if (needMips && willCompress) { - // Image is compressed and mipmaps are desired, generate them - // using software. - buildMipmap(bitmap, willCompress); - } else { - if (willCompress) { - // Image is compressed but mipmaps are not desired, upload directly. - logger.log(Level.FINEST, " - Uploading compressed bitmap. Mipmaps are not generated."); - uploadBitmapAsCompressed(target, 0, bitmap, subTexture, x, y); - - } else { - // Image is not compressed, mipmaps may or may not be desired. - logger.log(Level.FINEST, " - Uploading bitmap directly.{0}", - (needMips - ? " Mipmaps will be generated in HARDWARE" - : " Mipmaps are not generated.")); - if (subTexture) { - System.err.println("x : " + x + " y :" + y + " , " + bitmap.getWidth() + "/" + bitmap.getHeight()); - GLUtils.texSubImage2D(target, 0, x, y, bitmap); - JmeIosGLES.checkGLError(); - } else { - GLUtils.texImage2D(target, 0, bitmap, 0); - JmeIosGLES.checkGLError(); - } - - if (needMips) { - // No pregenerated mips available, - // generate from base level if required - JmeIosGLES.glGenerateMipmap(target); - JmeIosGLES.checkGLError(); - } - } - } - - if (recycleBitmap) { - bitmap.recycle(); - } - } - */ - - public static void uploadTextureAny(Image img, int target, int index, boolean needMips) { - /* - if (img.getEfficentData() instanceof AndroidImageInfo) { - logger.log(Level.FINEST, " === Uploading image {0}. Using BITMAP PATH === ", img); - // If image was loaded from asset manager, use fast path - AndroidImageInfo imageInfo = (AndroidImageInfo) img.getEfficentData(); - uploadTextureBitmap(target, imageInfo.getBitmap(), needMips); - } else { - */ - logger.log(Level.FINEST, " === Uploading image {0}. Using BUFFER PATH === ", img); - boolean wantGeneratedMips = needMips && !img.hasMipmaps(); - if (wantGeneratedMips && img.getFormat().isCompressed()) { - logger.log(Level.WARNING, "Generating mipmaps is only" - + " supported for Bitmap based or non-compressed images!"); - } - - // Upload using slower path - logger.log(Level.FINEST, " - Uploading bitmap directly.{0}", - (wantGeneratedMips - ? " Mipmaps will be generated in HARDWARE" - : " Mipmaps are not generated.")); - - uploadTexture(img, target, index); - - // Image was uploaded using slower path, since it is not compressed, - // then compress it - if (wantGeneratedMips) { - // No pregenerated mips available, - // generate from base level if required - JmeIosGLES.glGenerateMipmap(target); - JmeIosGLES.checkGLError(); - } - //} - } - - private static void unsupportedFormat(Format fmt) { - throw new UnsupportedOperationException("The image format '" + fmt + "' is unsupported by the video hardware."); - } - - public static IosGLImageFormat getImageFormat(Format fmt) throws UnsupportedOperationException { - IosGLImageFormat imageFormat = new IosGLImageFormat(); - switch (fmt) { - case Depth32: - case Depth32F: - throw new UnsupportedOperationException("The image format '" - + fmt + "' is not supported by OpenGL ES 2.0 specification."); - case Alpha8: - imageFormat.format = JmeIosGLES.GL_ALPHA; - imageFormat.dataType = JmeIosGLES.GL_UNSIGNED_BYTE; - if (RGBA8) { - imageFormat.renderBufferStorageFormat = GL_RGBA8; - } else { - // Highest precision alpha supported by vanilla OGLES2 - imageFormat.renderBufferStorageFormat = JmeIosGLES.GL_RGBA4; - } - break; - case Luminance8: - imageFormat.format = JmeIosGLES.GL_LUMINANCE; - imageFormat.dataType = JmeIosGLES.GL_UNSIGNED_BYTE; - if (RGBA8) { - imageFormat.renderBufferStorageFormat = GL_RGBA8; - } else { - // Highest precision luminance supported by vanilla OGLES2 - imageFormat.renderBufferStorageFormat = JmeIosGLES.GL_RGB565; - } - break; - case Luminance8Alpha8: - imageFormat.format = JmeIosGLES.GL_LUMINANCE_ALPHA; - imageFormat.dataType = JmeIosGLES.GL_UNSIGNED_BYTE; - if (RGBA8) { - imageFormat.renderBufferStorageFormat = GL_RGBA8; - } else { - imageFormat.renderBufferStorageFormat = JmeIosGLES.GL_RGBA4; - } - break; - case RGB565: - imageFormat.format = JmeIosGLES.GL_RGB; - imageFormat.dataType = JmeIosGLES.GL_UNSIGNED_SHORT_5_6_5; - imageFormat.renderBufferStorageFormat = JmeIosGLES.GL_RGB565; - break; - case RGB5A1: - imageFormat.format = JmeIosGLES.GL_RGBA; - imageFormat.dataType = JmeIosGLES.GL_UNSIGNED_SHORT_5_5_5_1; - imageFormat.renderBufferStorageFormat = JmeIosGLES.GL_RGB5_A1; - break; - case RGB8: - imageFormat.format = JmeIosGLES.GL_RGB; - imageFormat.dataType = JmeIosGLES.GL_UNSIGNED_BYTE; - if (RGBA8) { - imageFormat.renderBufferStorageFormat = GL_RGBA8; - } else { - // Fallback: Use RGB565 if RGBA8 is not available. - imageFormat.renderBufferStorageFormat = JmeIosGLES.GL_RGB565; - } - break; - case BGR8: - imageFormat.format = JmeIosGLES.GL_RGB; - imageFormat.dataType = JmeIosGLES.GL_UNSIGNED_BYTE; - if (RGBA8) { - imageFormat.renderBufferStorageFormat = GL_RGBA8; - } else { - imageFormat.renderBufferStorageFormat = JmeIosGLES.GL_RGB565; - } - break; - case RGBA8: - imageFormat.format = JmeIosGLES.GL_RGBA; - imageFormat.dataType = JmeIosGLES.GL_UNSIGNED_BYTE; - if (RGBA8) { - imageFormat.renderBufferStorageFormat = GL_RGBA8; - } else { - imageFormat.renderBufferStorageFormat = JmeIosGLES.GL_RGBA4; - } - break; - case Depth: - case Depth16: - if (!DEPTH_TEXTURE) { - unsupportedFormat(fmt); - } - imageFormat.format = JmeIosGLES.GL_DEPTH_COMPONENT; - imageFormat.dataType = JmeIosGLES.GL_UNSIGNED_SHORT; - imageFormat.renderBufferStorageFormat = JmeIosGLES.GL_DEPTH_COMPONENT16; - break; - case Depth24: - case Depth24Stencil8: - if (!DEPTH_TEXTURE) { - unsupportedFormat(fmt); - } - if (DEPTH24_STENCIL8) { - // NEW: True Depth24 + Stencil8 format. - imageFormat.format = GL_DEPTH_STENCIL_OES; - imageFormat.dataType = GL_UNSIGNED_INT_24_8_OES; - imageFormat.renderBufferStorageFormat = GL_DEPTH24_STENCIL8_OES; - } else { - // Vanilla OGLES2, only Depth16 available. - imageFormat.format = JmeIosGLES.GL_DEPTH_COMPONENT; - imageFormat.dataType = JmeIosGLES.GL_UNSIGNED_SHORT; - imageFormat.renderBufferStorageFormat = JmeIosGLES.GL_DEPTH_COMPONENT16; - } - break; - case DXT1: - if (!DXT1) { - unsupportedFormat(fmt); - } - imageFormat.format = GL_DXT1; - imageFormat.dataType = JmeIosGLES.GL_UNSIGNED_BYTE; - imageFormat.compress = true; - break; - case DXT1A: - if (!DXT1) { - unsupportedFormat(fmt); - } - imageFormat.format = GL_DXT1A; - imageFormat.dataType = JmeIosGLES.GL_UNSIGNED_BYTE; - imageFormat.compress = true; - break; - default: - throw new UnsupportedOperationException("Unrecognized format: " + fmt); - } - return imageFormat; - } - - public static class IosGLImageFormat { - - boolean compress = false; - int format = -1; - int renderBufferStorageFormat = -1; - int dataType = -1; - } - - private static void uploadTexture(Image img, - int target, - int index) { - - /* - if (img.getEfficentData() instanceof AndroidImageInfo) { - throw new RendererException("This image uses efficient data. " - + "Use uploadTextureBitmap instead."); - } - */ - - // Otherwise upload image directly. - // Prefer to only use power of 2 textures here to avoid errors. - Image.Format fmt = img.getFormat(); - ByteBuffer data; - if (index >= 0 || img.getData() != null && img.getData().size() > 0) { - data = img.getData(index); - } else { - data = null; - } - - int width = img.getWidth(); - int height = img.getHeight(); - - if (!NPOT && img.isNPOT()) { - // Check if texture is POT - throw new RendererException("Non-power-of-2 textures " - + "are not supported by the video hardware " - + "and no scaling path available for image: " + img); - } - IosGLImageFormat imageFormat = getImageFormat(fmt); - - if (data != null) { - JmeIosGLES.glPixelStorei(JmeIosGLES.GL_UNPACK_ALIGNMENT, 1); - JmeIosGLES.checkGLError(); - } - - int[] mipSizes = img.getMipMapSizes(); - int pos = 0; - if (mipSizes == null) { - if (data != null) { - mipSizes = new int[]{data.capacity()}; - } else { - mipSizes = new int[]{width * height * fmt.getBitsPerPixel() / 8}; - } - } - - for (int i = 0; i < mipSizes.length; i++) { - int mipWidth = Math.max(1, width >> i); - int mipHeight = Math.max(1, height >> i); - - if (data != null) { - data.position(pos); - data.limit(pos + mipSizes[i]); - } - - if (imageFormat.compress && data != null) { - JmeIosGLES.glCompressedTexImage2D(target, - i, - imageFormat.format, - mipWidth, - mipHeight, - 0, - data.remaining(), - data); - } else { - JmeIosGLES.glTexImage2D(target, - i, - imageFormat.format, - mipWidth, - mipHeight, - 0, - imageFormat.format, - imageFormat.dataType, - data); - } - JmeIosGLES.checkGLError(); - - pos += mipSizes[i]; - } - } - - /** - * Update the texture currently bound to target at with data from the given - * Image at position x and y. The parameter index is used as the zoffset in - * case a 3d texture or texture 2d array is being updated. - * - * @param image Image with the source data (this data will be put into the - * texture) - * @param target the target texture - * @param index the mipmap level to update - * @param x the x position where to put the image in the texture - * @param y the y position where to put the image in the texture - */ - public static void uploadSubTexture( - Image img, - int target, - int index, - int x, - int y) { - //TODO: - /* - if (img.getEfficentData() instanceof AndroidImageInfo) { - AndroidImageInfo imageInfo = (AndroidImageInfo) img.getEfficentData(); - uploadTextureBitmap(target, imageInfo.getBitmap(), true, true, x, y); - return; - } - */ - - // Otherwise upload image directly. - // Prefer to only use power of 2 textures here to avoid errors. - Image.Format fmt = img.getFormat(); - ByteBuffer data; - if (index >= 0 || img.getData() != null && img.getData().size() > 0) { - data = img.getData(index); - } else { - data = null; - } - - int width = img.getWidth(); - int height = img.getHeight(); - - if (!NPOT && img.isNPOT()) { - // Check if texture is POT - throw new RendererException("Non-power-of-2 textures " - + "are not supported by the video hardware " - + "and no scaling path available for image: " + img); - } - IosGLImageFormat imageFormat = getImageFormat(fmt); - - if (data != null) { - JmeIosGLES.glPixelStorei(JmeIosGLES.GL_UNPACK_ALIGNMENT, 1); - JmeIosGLES.checkGLError(); - } - - int[] mipSizes = img.getMipMapSizes(); - int pos = 0; - if (mipSizes == null) { - if (data != null) { - mipSizes = new int[]{data.capacity()}; - } else { - mipSizes = new int[]{width * height * fmt.getBitsPerPixel() / 8}; - } - } - - for (int i = 0; i < mipSizes.length; i++) { - int mipWidth = Math.max(1, width >> i); - int mipHeight = Math.max(1, height >> i); - - if (data != null) { - data.position(pos); - data.limit(pos + mipSizes[i]); - } - - if (imageFormat.compress && data != null) { - JmeIosGLES.glCompressedTexSubImage2D(target, i, x, y, mipWidth, mipHeight, imageFormat.format, data.remaining(), data); - JmeIosGLES.checkGLError(); - } else { - JmeIosGLES.glTexSubImage2D(target, i, x, y, mipWidth, mipHeight, imageFormat.format, imageFormat.dataType, data); - JmeIosGLES.checkGLError(); - } - - pos += mipSizes[i]; - } - } -} diff --git a/jme3-ios/src/main/resources/com/jme3/asset/IOS.cfg b/jme3-ios/src/main/resources/com/jme3/asset/IOS.cfg index 4e4052447..e9d79a459 100644 --- a/jme3-ios/src/main/resources/com/jme3/asset/IOS.cfg +++ b/jme3-ios/src/main/resources/com/jme3/asset/IOS.cfg @@ -2,7 +2,9 @@ INCLUDE com/jme3/asset/General.cfg # IOS specific loaders LOADER com.jme3.system.ios.IosImageLoader : jpg, bmp, gif, png, jpeg -LOADER com.jme3.material.plugins.J3MLoader : j3m, j3md +LOADER com.jme3.audio.plugins.OGGLoader : ogg +LOADER com.jme3.material.plugins.J3MLoader : j3m +LOADER com.jme3.material.plugins.J3MLoader : j3md LOADER com.jme3.shader.plugins.GLSLLoader : vert, frag, glsl, glsllib LOADER com.jme3.export.binary.BinaryImporter : j3o LOADER com.jme3.font.plugins.BitmapFontLoader : fnt From 70b03ea28a568463dbc942fd123aaba78de6c04e Mon Sep 17 00:00:00 2001 From: iwgeric Date: Sun, 26 Apr 2015 19:20:06 -0400 Subject: [PATCH 050/113] Bullet (and jBullet): Remove deprecated PhysicsSpace.enableDebug method in favor of BulletAppState.setDebugEnabled. --- .../java/com/jme3/bullet/BulletAppState.java | 12 +----- .../java/com/jme3/bullet/PhysicsSpace.java | 36 +++--------------- .../java/com/jme3/bullet/PhysicsSpace.java | 38 ++++--------------- 3 files changed, 14 insertions(+), 72 deletions(-) diff --git a/jme3-bullet/src/common/java/com/jme3/bullet/BulletAppState.java b/jme3-bullet/src/common/java/com/jme3/bullet/BulletAppState.java index 05aa9a926..ae278c871 100644 --- a/jme3-bullet/src/common/java/com/jme3/bullet/BulletAppState.java +++ b/jme3-bullet/src/common/java/com/jme3/bullet/BulletAppState.java @@ -166,7 +166,7 @@ public class BulletAppState implements AppState, PhysicsTickListener { pSpace.addTickListener(this); initialized = true; } - + public void stopPhysics() { if(!initialized){ return; @@ -226,19 +226,9 @@ public class BulletAppState implements AppState, PhysicsTickListener { if (debugEnabled && debugAppState == null && pSpace != null) { debugAppState = new BulletDebugAppState(pSpace); stateManager.attach(debugAppState); - pSpace.enableDebug(app.getAssetManager()); } else if (!debugEnabled && debugAppState != null) { stateManager.detach(debugAppState); debugAppState = null; - if (pSpace != null) { - pSpace.enableDebug(null); - } - } - //TODO: remove when deprecation of PhysicsSpace.enableDebug is through - if (pSpace.getDebugManager() != null && !debugEnabled) { - debugEnabled = true; - } else if (pSpace.getDebugManager() == null && debugEnabled) { - debugEnabled = false; } if (!active) { return; diff --git a/jme3-bullet/src/main/java/com/jme3/bullet/PhysicsSpace.java b/jme3-bullet/src/main/java/com/jme3/bullet/PhysicsSpace.java index 380dc3e16..4485edcd7 100644 --- a/jme3-bullet/src/main/java/com/jme3/bullet/PhysicsSpace.java +++ b/jme3-bullet/src/main/java/com/jme3/bullet/PhysicsSpace.java @@ -102,7 +102,6 @@ public class PhysicsSpace { private Vector3f worldMax = new Vector3f(10000f, 10000f, 10000f); private float accuracy = 1f / 60f; private int maxSubSteps = 4, rayTestFlags = 1 << 2; - private AssetManager debugManager; static { // System.loadLibrary("bulletjme"); @@ -702,7 +701,7 @@ public class PhysicsSpace { public Vector3f getGravity(Vector3f gravity) { return gravity.set(this.gravity); } - + // /** // * applies gravity value to all objects // */ @@ -783,7 +782,7 @@ public class PhysicsSpace { public void SetRayTestFlags(int flags) { rayTestFlags = flags; } - + /** * Gets m_flags for raytest, see https://code.google.com/p/bullet/source/browse/trunk/src/BulletCollision/NarrowPhaseCollision/btRaycastCallback.h * for possible options. @@ -792,7 +791,7 @@ public class PhysicsSpace { public int GetRayTestFlags() { return rayTestFlags; } - + /** * Performs a ray collision test and returns the results as a list of * PhysicsRayTestResults @@ -837,7 +836,7 @@ public class PhysicsSpace { return (List) results; } - public List sweepTest(CollisionShape shape, Transform start, Transform end, List results) { + public List sweepTest(CollisionShape shape, Transform start, Transform end, List results) { return sweepTest(shape, start, end, results, 0.0f); } @@ -849,7 +848,7 @@ public class PhysicsSpace { * collision if it starts INSIDE an object and is moving AWAY from its * center. */ - public List sweepTest(CollisionShape shape, Transform start, Transform end, List results, float allowedCcdPenetration ) { + public List sweepTest(CollisionShape shape, Transform start, Transform end, List results, float allowedCcdPenetration ) { results.clear(); sweepTest_native(shape.getObjectId(), start, end, physicsSpaceId, results, allowedCcdPenetration); return results; @@ -872,7 +871,7 @@ public class PhysicsSpace { } */ - + /** * destroys the current PhysicsSpace so that a new one can be created */ @@ -959,29 +958,6 @@ public class PhysicsSpace { this.worldMax.set(worldMax); } - /** - * Enable debug display for physics. - * - * @deprecated in favor of BulletDebugAppState, use - * BulletAppState.setDebugEnabled(boolean) to add automatically - * @param manager AssetManager to use to create debug materials - */ - @Deprecated - public void enableDebug(AssetManager manager) { - debugManager = manager; - } - - /** - * Disable debug display - */ - public void disableDebug() { - debugManager = null; - } - - public AssetManager getDebugManager() { - return debugManager; - } - public static native void initNativePhysics(); /** diff --git a/jme3-jbullet/src/main/java/com/jme3/bullet/PhysicsSpace.java b/jme3-jbullet/src/main/java/com/jme3/bullet/PhysicsSpace.java index dc61e6c6c..3c8a3b225 100644 --- a/jme3-jbullet/src/main/java/com/jme3/bullet/PhysicsSpace.java +++ b/jme3-jbullet/src/main/java/com/jme3/bullet/PhysicsSpace.java @@ -142,7 +142,6 @@ public class PhysicsSpace { private javax.vecmath.Vector3f rayVec2 = new javax.vecmath.Vector3f(); private com.bulletphysics.linearmath.Transform sweepTrans1 = new com.bulletphysics.linearmath.Transform(new javax.vecmath.Matrix3f()); private com.bulletphysics.linearmath.Transform sweepTrans2 = new com.bulletphysics.linearmath.Transform(new javax.vecmath.Matrix3f()); - private AssetManager debugManager; /** * Get the current PhysicsSpace running on this thread
@@ -362,7 +361,7 @@ public class PhysicsSpace { eventFactory.recycle(physicsCollisionEvent); } } - + public static Future enqueueOnThisThread(Callable callable) { AppTask task = new AppTask(callable); System.out.println("created apptask"); @@ -620,7 +619,7 @@ public class PhysicsSpace { physicsJoints.remove(joint.getObjectId()); dynamicsWorld.removeConstraint(joint.getObjectId()); } - + public Collection getRigidBodyList(){ return new LinkedList(physicsBodies.values()); } @@ -628,19 +627,19 @@ public class PhysicsSpace { public Collection getGhostObjectList(){ return new LinkedList(physicsGhostObjects.values()); } - + public Collection getCharacterList(){ return new LinkedList(physicsCharacters.values()); } - + public Collection getJointList(){ return new LinkedList(physicsJoints.values()); } - + public Collection getVehicleList(){ return new LinkedList(physicsVehicles.values()); } - + /** * Sets the gravity of the PhysicsSpace, set before adding physics objects! * @param gravity @@ -658,7 +657,7 @@ public class PhysicsSpace { dynamicsWorld.getGravity(tempVec); return Converter.convert(tempVec, gravity); } - + /** * applies gravity value to all objects */ @@ -877,29 +876,6 @@ public class PhysicsSpace { this.worldMax.set(worldMax); } - /** - * Enable debug display for physics. - * - * @deprecated in favor of BulletDebugAppState, use - * BulletAppState.setDebugEnabled(boolean) to add automatically - * @param manager AssetManager to use to create debug materials - */ - @Deprecated - public void enableDebug(AssetManager manager) { - debugManager = manager; - } - - /** - * Disable debug display - */ - public void disableDebug() { - debugManager = null; - } - - public AssetManager getDebugManager() { - return debugManager; - } - /** * interface with Broadphase types */ From a52bc0a82c106a4f359daa9f6d6b3aba231551a5 Mon Sep 17 00:00:00 2001 From: iwgeric Date: Sun, 26 Apr 2015 19:21:00 -0400 Subject: [PATCH 051/113] Bullet (and jBullet): Update Test Classes to use BulletAppState.setDebugEnabled instead of PhysicsSpace.enableDebug. --- .../jme3test/bullet/TestAttachDriver.java | 4 +- .../bullet/TestAttachGhostObject.java | 2 +- .../main/java/jme3test/bullet/TestCcd.java | 304 +++++++++--------- .../jme3test/bullet/TestCollisionGroups.java | 4 +- .../bullet/TestCollisionListener.java | 196 +++++------ .../bullet/TestCollisionShapeFactory.java | 2 +- .../java/jme3test/bullet/TestGhostObject.java | 2 +- .../TestKinematicAddToPhysicsSpaceIssue.java | 8 +- .../jme3test/bullet/TestLocalPhysics.java | 2 +- .../java/jme3test/bullet/TestPhysicsCar.java | 2 +- .../bullet/TestPhysicsHingeJoint.java | 4 +- .../jme3test/bullet/TestPhysicsRayCast.java | 18 +- .../jme3test/bullet/TestPhysicsReadWrite.java | 2 +- .../java/jme3test/bullet/TestRagDoll.java | 2 +- .../jme3test/bullet/TestSimplePhysics.java | 2 +- .../java/jme3test/bullet/TestSweepTest.java | 6 +- 16 files changed, 280 insertions(+), 280 deletions(-) diff --git a/jme3-examples/src/main/java/jme3test/bullet/TestAttachDriver.java b/jme3-examples/src/main/java/jme3test/bullet/TestAttachDriver.java index a4b4b92a3..8f9447ea1 100644 --- a/jme3-examples/src/main/java/jme3test/bullet/TestAttachDriver.java +++ b/jme3-examples/src/main/java/jme3test/bullet/TestAttachDriver.java @@ -69,7 +69,7 @@ public class TestAttachDriver extends SimpleApplication implements ActionListene private float accelerationValue = 0; private Vector3f jumpForce = new Vector3f(0, 3000, 0); private BulletAppState bulletAppState; - + public static void main(String[] args) { TestAttachDriver app = new TestAttachDriver(); app.start(); @@ -79,7 +79,7 @@ public class TestAttachDriver extends SimpleApplication implements ActionListene public void simpleInitApp() { bulletAppState = new BulletAppState(); stateManager.attach(bulletAppState); - bulletAppState.getPhysicsSpace().enableDebug(assetManager); + bulletAppState.setDebugEnabled(true); setupKeys(); setupFloor(); buildPlayer(); diff --git a/jme3-examples/src/main/java/jme3test/bullet/TestAttachGhostObject.java b/jme3-examples/src/main/java/jme3test/bullet/TestAttachGhostObject.java index 5b6992f3a..5fac3fc5f 100644 --- a/jme3-examples/src/main/java/jme3test/bullet/TestAttachGhostObject.java +++ b/jme3-examples/src/main/java/jme3test/bullet/TestAttachGhostObject.java @@ -85,7 +85,7 @@ public class TestAttachGhostObject extends SimpleApplication implements AnalogLi public void simpleInitApp() { bulletAppState = new BulletAppState(); stateManager.attach(bulletAppState); - bulletAppState.getPhysicsSpace().enableDebug(assetManager); + bulletAppState.setDebugEnabled(true); setupKeys(); setupJoint(); } diff --git a/jme3-examples/src/main/java/jme3test/bullet/TestCcd.java b/jme3-examples/src/main/java/jme3test/bullet/TestCcd.java index beb57bdec..cda07bc85 100644 --- a/jme3-examples/src/main/java/jme3test/bullet/TestCcd.java +++ b/jme3-examples/src/main/java/jme3test/bullet/TestCcd.java @@ -1,152 +1,152 @@ -/* - * Copyright (c) 2009-2012 jMonkeyEngine - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions are - * met: - * - * * Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * * Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in the - * documentation and/or other materials provided with the distribution. - * - * * Neither the name of 'jMonkeyEngine' nor the names of its contributors - * may be used to endorse or promote products derived from this software - * without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED - * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR - * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR - * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, - * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, - * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR - * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF - * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING - * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS - * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. - */ -package jme3test.bullet; - -import com.jme3.app.SimpleApplication; -import com.jme3.bullet.BulletAppState; -import com.jme3.bullet.PhysicsSpace; -import com.jme3.bullet.collision.shapes.BoxCollisionShape; -import com.jme3.bullet.collision.shapes.MeshCollisionShape; -import com.jme3.bullet.collision.shapes.SphereCollisionShape; -import com.jme3.bullet.control.RigidBodyControl; -import com.jme3.input.MouseInput; -import com.jme3.input.controls.ActionListener; -import com.jme3.input.controls.MouseButtonTrigger; -import com.jme3.material.Material; -import com.jme3.math.ColorRGBA; -import com.jme3.math.Vector3f; -import com.jme3.renderer.RenderManager; -import com.jme3.renderer.queue.RenderQueue.ShadowMode; -import com.jme3.scene.Geometry; -import com.jme3.scene.Node; -import com.jme3.scene.shape.Box; -import com.jme3.scene.shape.Sphere; -import com.jme3.scene.shape.Sphere.TextureMode; - -/** - * - * @author normenhansen - */ -public class TestCcd extends SimpleApplication implements ActionListener { - - private Material mat; - private Material mat2; - private Sphere bullet; - private SphereCollisionShape bulletCollisionShape; - private BulletAppState bulletAppState; - - public static void main(String[] args) { - TestCcd app = new TestCcd(); - app.start(); - } - - private void setupKeys() { - inputManager.addMapping("shoot", new MouseButtonTrigger(MouseInput.BUTTON_LEFT)); - inputManager.addMapping("shoot2", new MouseButtonTrigger(MouseInput.BUTTON_RIGHT)); - inputManager.addListener(this, "shoot"); - inputManager.addListener(this, "shoot2"); - } - - @Override - public void simpleInitApp() { - bulletAppState = new BulletAppState(); - stateManager.attach(bulletAppState); - bulletAppState.getPhysicsSpace().enableDebug(assetManager); - bullet = new Sphere(32, 32, 0.4f, true, false); - bullet.setTextureMode(TextureMode.Projected); - bulletCollisionShape = new SphereCollisionShape(0.1f); - setupKeys(); - - mat = new Material(getAssetManager(), "Common/MatDefs/Misc/Unshaded.j3md"); - mat.getAdditionalRenderState().setWireframe(true); - mat.setColor("Color", ColorRGBA.Green); - - mat2 = new Material(getAssetManager(), "Common/MatDefs/Misc/Unshaded.j3md"); - mat2.getAdditionalRenderState().setWireframe(true); - mat2.setColor("Color", ColorRGBA.Red); - - // An obstacle mesh, does not move (mass=0) - Node node2 = new Node(); - node2.setName("mesh"); - node2.setLocalTranslation(new Vector3f(2.5f, 0, 0f)); - node2.addControl(new RigidBodyControl(new MeshCollisionShape(new Box(Vector3f.ZERO, 4, 4, 0.1f)), 0)); - rootNode.attachChild(node2); - getPhysicsSpace().add(node2); - - // The floor, does not move (mass=0) - Node node3 = new Node(); - node3.setLocalTranslation(new Vector3f(0f, -6, 0f)); - node3.addControl(new RigidBodyControl(new BoxCollisionShape(new Vector3f(100, 1, 100)), 0)); - rootNode.attachChild(node3); - getPhysicsSpace().add(node3); - - } - - private PhysicsSpace getPhysicsSpace() { - return bulletAppState.getPhysicsSpace(); - } - - @Override - public void simpleUpdate(float tpf) { - //TODO: add update code - } - - @Override - public void simpleRender(RenderManager rm) { - //TODO: add render code - } - - public void onAction(String binding, boolean value, float tpf) { - if (binding.equals("shoot") && !value) { - Geometry bulletg = new Geometry("bullet", bullet); - bulletg.setMaterial(mat); - bulletg.setName("bullet"); - bulletg.setLocalTranslation(cam.getLocation()); - bulletg.setShadowMode(ShadowMode.CastAndReceive); - bulletg.addControl(new RigidBodyControl(bulletCollisionShape, 1)); - bulletg.getControl(RigidBodyControl.class).setCcdMotionThreshold(0.1f); - bulletg.getControl(RigidBodyControl.class).setLinearVelocity(cam.getDirection().mult(40)); - rootNode.attachChild(bulletg); - getPhysicsSpace().add(bulletg); - } else if (binding.equals("shoot2") && !value) { - Geometry bulletg = new Geometry("bullet", bullet); - bulletg.setMaterial(mat2); - bulletg.setName("bullet"); - bulletg.setLocalTranslation(cam.getLocation()); - bulletg.setShadowMode(ShadowMode.CastAndReceive); - bulletg.addControl(new RigidBodyControl(bulletCollisionShape, 1)); - bulletg.getControl(RigidBodyControl.class).setLinearVelocity(cam.getDirection().mult(40)); - rootNode.attachChild(bulletg); - getPhysicsSpace().add(bulletg); - } - } -} +/* + * Copyright (c) 2009-2012 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ +package jme3test.bullet; + +import com.jme3.app.SimpleApplication; +import com.jme3.bullet.BulletAppState; +import com.jme3.bullet.PhysicsSpace; +import com.jme3.bullet.collision.shapes.BoxCollisionShape; +import com.jme3.bullet.collision.shapes.MeshCollisionShape; +import com.jme3.bullet.collision.shapes.SphereCollisionShape; +import com.jme3.bullet.control.RigidBodyControl; +import com.jme3.input.MouseInput; +import com.jme3.input.controls.ActionListener; +import com.jme3.input.controls.MouseButtonTrigger; +import com.jme3.material.Material; +import com.jme3.math.ColorRGBA; +import com.jme3.math.Vector3f; +import com.jme3.renderer.RenderManager; +import com.jme3.renderer.queue.RenderQueue.ShadowMode; +import com.jme3.scene.Geometry; +import com.jme3.scene.Node; +import com.jme3.scene.shape.Box; +import com.jme3.scene.shape.Sphere; +import com.jme3.scene.shape.Sphere.TextureMode; + +/** + * + * @author normenhansen + */ +public class TestCcd extends SimpleApplication implements ActionListener { + + private Material mat; + private Material mat2; + private Sphere bullet; + private SphereCollisionShape bulletCollisionShape; + private BulletAppState bulletAppState; + + public static void main(String[] args) { + TestCcd app = new TestCcd(); + app.start(); + } + + private void setupKeys() { + inputManager.addMapping("shoot", new MouseButtonTrigger(MouseInput.BUTTON_LEFT)); + inputManager.addMapping("shoot2", new MouseButtonTrigger(MouseInput.BUTTON_RIGHT)); + inputManager.addListener(this, "shoot"); + inputManager.addListener(this, "shoot2"); + } + + @Override + public void simpleInitApp() { + bulletAppState = new BulletAppState(); + stateManager.attach(bulletAppState); + bulletAppState.setDebugEnabled(true); + bullet = new Sphere(32, 32, 0.4f, true, false); + bullet.setTextureMode(TextureMode.Projected); + bulletCollisionShape = new SphereCollisionShape(0.1f); + setupKeys(); + + mat = new Material(getAssetManager(), "Common/MatDefs/Misc/Unshaded.j3md"); + mat.getAdditionalRenderState().setWireframe(true); + mat.setColor("Color", ColorRGBA.Green); + + mat2 = new Material(getAssetManager(), "Common/MatDefs/Misc/Unshaded.j3md"); + mat2.getAdditionalRenderState().setWireframe(true); + mat2.setColor("Color", ColorRGBA.Red); + + // An obstacle mesh, does not move (mass=0) + Node node2 = new Node(); + node2.setName("mesh"); + node2.setLocalTranslation(new Vector3f(2.5f, 0, 0f)); + node2.addControl(new RigidBodyControl(new MeshCollisionShape(new Box(Vector3f.ZERO, 4, 4, 0.1f)), 0)); + rootNode.attachChild(node2); + getPhysicsSpace().add(node2); + + // The floor, does not move (mass=0) + Node node3 = new Node(); + node3.setLocalTranslation(new Vector3f(0f, -6, 0f)); + node3.addControl(new RigidBodyControl(new BoxCollisionShape(new Vector3f(100, 1, 100)), 0)); + rootNode.attachChild(node3); + getPhysicsSpace().add(node3); + + } + + private PhysicsSpace getPhysicsSpace() { + return bulletAppState.getPhysicsSpace(); + } + + @Override + public void simpleUpdate(float tpf) { + //TODO: add update code + } + + @Override + public void simpleRender(RenderManager rm) { + //TODO: add render code + } + + public void onAction(String binding, boolean value, float tpf) { + if (binding.equals("shoot") && !value) { + Geometry bulletg = new Geometry("bullet", bullet); + bulletg.setMaterial(mat); + bulletg.setName("bullet"); + bulletg.setLocalTranslation(cam.getLocation()); + bulletg.setShadowMode(ShadowMode.CastAndReceive); + bulletg.addControl(new RigidBodyControl(bulletCollisionShape, 1)); + bulletg.getControl(RigidBodyControl.class).setCcdMotionThreshold(0.1f); + bulletg.getControl(RigidBodyControl.class).setLinearVelocity(cam.getDirection().mult(40)); + rootNode.attachChild(bulletg); + getPhysicsSpace().add(bulletg); + } else if (binding.equals("shoot2") && !value) { + Geometry bulletg = new Geometry("bullet", bullet); + bulletg.setMaterial(mat2); + bulletg.setName("bullet"); + bulletg.setLocalTranslation(cam.getLocation()); + bulletg.setShadowMode(ShadowMode.CastAndReceive); + bulletg.addControl(new RigidBodyControl(bulletCollisionShape, 1)); + bulletg.getControl(RigidBodyControl.class).setLinearVelocity(cam.getDirection().mult(40)); + rootNode.attachChild(bulletg); + getPhysicsSpace().add(bulletg); + } + } +} diff --git a/jme3-examples/src/main/java/jme3test/bullet/TestCollisionGroups.java b/jme3-examples/src/main/java/jme3test/bullet/TestCollisionGroups.java index 0bfa9f784..410c125d2 100644 --- a/jme3-examples/src/main/java/jme3test/bullet/TestCollisionGroups.java +++ b/jme3-examples/src/main/java/jme3test/bullet/TestCollisionGroups.java @@ -61,8 +61,8 @@ public class TestCollisionGroups extends SimpleApplication { public void simpleInitApp() { bulletAppState = new BulletAppState(); stateManager.attach(bulletAppState); - bulletAppState.getPhysicsSpace().enableDebug(assetManager); - + bulletAppState.setDebugEnabled(true); + // Add a physics sphere to the world Node physicsSphere = PhysicsTestHelper.createPhysicsTestNode(assetManager, new SphereCollisionShape(1), 1); physicsSphere.getControl(RigidBodyControl.class).setPhysicsLocation(new Vector3f(3, 6, 0)); diff --git a/jme3-examples/src/main/java/jme3test/bullet/TestCollisionListener.java b/jme3-examples/src/main/java/jme3test/bullet/TestCollisionListener.java index 1a13b09fb..3c9450f3d 100644 --- a/jme3-examples/src/main/java/jme3test/bullet/TestCollisionListener.java +++ b/jme3-examples/src/main/java/jme3test/bullet/TestCollisionListener.java @@ -1,98 +1,98 @@ -/* - * Copyright (c) 2009-2012 jMonkeyEngine - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions are - * met: - * - * * Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * * Redistributions in binary form must reproduce the above copyright - * notice, this list of conditions and the following disclaimer in the - * documentation and/or other materials provided with the distribution. - * - * * Neither the name of 'jMonkeyEngine' nor the names of its contributors - * may be used to endorse or promote products derived from this software - * without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED - * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR - * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR - * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, - * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, - * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR - * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF - * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING - * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS - * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. - */ - -package jme3test.bullet; - -import com.jme3.app.SimpleApplication; -import com.jme3.bullet.BulletAppState; -import com.jme3.bullet.PhysicsSpace; -import com.jme3.bullet.collision.PhysicsCollisionEvent; -import com.jme3.bullet.collision.PhysicsCollisionListener; -import com.jme3.bullet.collision.shapes.SphereCollisionShape; -import com.jme3.renderer.RenderManager; -import com.jme3.scene.shape.Sphere; -import com.jme3.scene.shape.Sphere.TextureMode; - -/** - * - * @author normenhansen - */ -public class TestCollisionListener extends SimpleApplication implements PhysicsCollisionListener { - - private BulletAppState bulletAppState; - private Sphere bullet; - private SphereCollisionShape bulletCollisionShape; - - public static void main(String[] args) { - TestCollisionListener app = new TestCollisionListener(); - app.start(); - } - - @Override - public void simpleInitApp() { - bulletAppState = new BulletAppState(); - stateManager.attach(bulletAppState); - bulletAppState.getPhysicsSpace().enableDebug(assetManager); - bullet = new Sphere(32, 32, 0.4f, true, false); - bullet.setTextureMode(TextureMode.Projected); - bulletCollisionShape = new SphereCollisionShape(0.4f); - - PhysicsTestHelper.createPhysicsTestWorld(rootNode, assetManager, bulletAppState.getPhysicsSpace()); - PhysicsTestHelper.createBallShooter(this, rootNode, bulletAppState.getPhysicsSpace()); - - // add ourselves as collision listener - getPhysicsSpace().addCollisionListener(this); - } - - private PhysicsSpace getPhysicsSpace(){ - return bulletAppState.getPhysicsSpace(); - } - - @Override - public void simpleUpdate(float tpf) { - //TODO: add update code - } - - @Override - public void simpleRender(RenderManager rm) { - //TODO: add render code - } - - public void collision(PhysicsCollisionEvent event) { - if ("Box".equals(event.getNodeA().getName()) || "Box".equals(event.getNodeB().getName())) { - if ("bullet".equals(event.getNodeA().getName()) || "bullet".equals(event.getNodeB().getName())) { - fpsText.setText("You hit the box!"); - } - } - } - -} +/* + * Copyright (c) 2009-2012 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ + +package jme3test.bullet; + +import com.jme3.app.SimpleApplication; +import com.jme3.bullet.BulletAppState; +import com.jme3.bullet.PhysicsSpace; +import com.jme3.bullet.collision.PhysicsCollisionEvent; +import com.jme3.bullet.collision.PhysicsCollisionListener; +import com.jme3.bullet.collision.shapes.SphereCollisionShape; +import com.jme3.renderer.RenderManager; +import com.jme3.scene.shape.Sphere; +import com.jme3.scene.shape.Sphere.TextureMode; + +/** + * + * @author normenhansen + */ +public class TestCollisionListener extends SimpleApplication implements PhysicsCollisionListener { + + private BulletAppState bulletAppState; + private Sphere bullet; + private SphereCollisionShape bulletCollisionShape; + + public static void main(String[] args) { + TestCollisionListener app = new TestCollisionListener(); + app.start(); + } + + @Override + public void simpleInitApp() { + bulletAppState = new BulletAppState(); + stateManager.attach(bulletAppState); + bulletAppState.setDebugEnabled(true); + bullet = new Sphere(32, 32, 0.4f, true, false); + bullet.setTextureMode(TextureMode.Projected); + bulletCollisionShape = new SphereCollisionShape(0.4f); + + PhysicsTestHelper.createPhysicsTestWorld(rootNode, assetManager, bulletAppState.getPhysicsSpace()); + PhysicsTestHelper.createBallShooter(this, rootNode, bulletAppState.getPhysicsSpace()); + + // add ourselves as collision listener + getPhysicsSpace().addCollisionListener(this); + } + + private PhysicsSpace getPhysicsSpace(){ + return bulletAppState.getPhysicsSpace(); + } + + @Override + public void simpleUpdate(float tpf) { + //TODO: add update code + } + + @Override + public void simpleRender(RenderManager rm) { + //TODO: add render code + } + + public void collision(PhysicsCollisionEvent event) { + if ("Box".equals(event.getNodeA().getName()) || "Box".equals(event.getNodeB().getName())) { + if ("bullet".equals(event.getNodeA().getName()) || "bullet".equals(event.getNodeB().getName())) { + fpsText.setText("You hit the box!"); + } + } + } + +} diff --git a/jme3-examples/src/main/java/jme3test/bullet/TestCollisionShapeFactory.java b/jme3-examples/src/main/java/jme3test/bullet/TestCollisionShapeFactory.java index b2c44ce4e..2128149d2 100644 --- a/jme3-examples/src/main/java/jme3test/bullet/TestCollisionShapeFactory.java +++ b/jme3-examples/src/main/java/jme3test/bullet/TestCollisionShapeFactory.java @@ -67,7 +67,7 @@ public class TestCollisionShapeFactory extends SimpleApplication { public void simpleInitApp() { bulletAppState = new BulletAppState(); stateManager.attach(bulletAppState); - bulletAppState.getPhysicsSpace().enableDebug(assetManager); + bulletAppState.setDebugEnabled(true); createMaterial(); Node node = new Node("node1"); diff --git a/jme3-examples/src/main/java/jme3test/bullet/TestGhostObject.java b/jme3-examples/src/main/java/jme3test/bullet/TestGhostObject.java index dde9e530c..74a7c1e1e 100644 --- a/jme3-examples/src/main/java/jme3test/bullet/TestGhostObject.java +++ b/jme3-examples/src/main/java/jme3test/bullet/TestGhostObject.java @@ -62,7 +62,7 @@ public class TestGhostObject extends SimpleApplication { public void simpleInitApp() { bulletAppState = new BulletAppState(); stateManager.attach(bulletAppState); - bulletAppState.getPhysicsSpace().enableDebug(assetManager); + bulletAppState.setDebugEnabled(true); // Mesh to be shared across several boxes. Box boxGeom = new Box(Vector3f.ZERO, 1f, 1f, 1f); diff --git a/jme3-examples/src/main/java/jme3test/bullet/TestKinematicAddToPhysicsSpaceIssue.java b/jme3-examples/src/main/java/jme3test/bullet/TestKinematicAddToPhysicsSpaceIssue.java index 636122b4b..e63cd03e5 100644 --- a/jme3-examples/src/main/java/jme3test/bullet/TestKinematicAddToPhysicsSpaceIssue.java +++ b/jme3-examples/src/main/java/jme3test/bullet/TestKinematicAddToPhysicsSpaceIssue.java @@ -60,7 +60,7 @@ public class TestKinematicAddToPhysicsSpaceIssue extends SimpleApplication { bulletAppState = new BulletAppState(); stateManager.attach(bulletAppState); - bulletAppState.getPhysicsSpace().enableDebug(assetManager); + bulletAppState.setDebugEnabled(true); // Add a physics sphere to the world Node physicsSphere = PhysicsTestHelper.createPhysicsTestNode(assetManager, new SphereCollisionShape(1), 1); physicsSphere.getControl(RigidBodyControl.class).setPhysicsLocation(new Vector3f(3, 6, 0)); @@ -69,7 +69,7 @@ public class TestKinematicAddToPhysicsSpaceIssue extends SimpleApplication { //Setting the rigidBody to kinematic before adding it to the physic space physicsSphere.getControl(RigidBodyControl.class).setKinematic(true); //adding it to the physic space - getPhysicsSpace().add(physicsSphere); + getPhysicsSpace().add(physicsSphere); //Making it not kinematic again, it should fall under gravity, it doesn't physicsSphere.getControl(RigidBodyControl.class).setKinematic(false); @@ -77,7 +77,7 @@ public class TestKinematicAddToPhysicsSpaceIssue extends SimpleApplication { Node physicsSphere2 = PhysicsTestHelper.createPhysicsTestNode(assetManager, new SphereCollisionShape(1), 1); physicsSphere2.getControl(RigidBodyControl.class).setPhysicsLocation(new Vector3f(5, 6, 0)); rootNode.attachChild(physicsSphere2); - + //Adding the rigid body to physic space getPhysicsSpace().add(physicsSphere2); //making it kinematic @@ -85,7 +85,7 @@ public class TestKinematicAddToPhysicsSpaceIssue extends SimpleApplication { //Making it not kinematic again, it works properly, the rigidbody is affected by grvity. physicsSphere2.getControl(RigidBodyControl.class).setKinematic(false); - + // an obstacle mesh, does not move (mass=0) Node node2 = PhysicsTestHelper.createPhysicsTestNode(assetManager, new MeshCollisionShape(new Sphere(16, 16, 1.2f)), 0); diff --git a/jme3-examples/src/main/java/jme3test/bullet/TestLocalPhysics.java b/jme3-examples/src/main/java/jme3test/bullet/TestLocalPhysics.java index ed432da47..3835b1ca0 100644 --- a/jme3-examples/src/main/java/jme3test/bullet/TestLocalPhysics.java +++ b/jme3-examples/src/main/java/jme3test/bullet/TestLocalPhysics.java @@ -59,7 +59,7 @@ public class TestLocalPhysics extends SimpleApplication { public void simpleInitApp() { bulletAppState = new BulletAppState(); stateManager.attach(bulletAppState); - bulletAppState.getPhysicsSpace().enableDebug(assetManager); + bulletAppState.setDebugEnabled(true); // Add a physics sphere to the world Node physicsSphere = PhysicsTestHelper.createPhysicsTestNode(assetManager, new SphereCollisionShape(1), 1); diff --git a/jme3-examples/src/main/java/jme3test/bullet/TestPhysicsCar.java b/jme3-examples/src/main/java/jme3test/bullet/TestPhysicsCar.java index 26d7c1a8e..4ba4e060b 100644 --- a/jme3-examples/src/main/java/jme3test/bullet/TestPhysicsCar.java +++ b/jme3-examples/src/main/java/jme3test/bullet/TestPhysicsCar.java @@ -69,7 +69,7 @@ public class TestPhysicsCar extends SimpleApplication implements ActionListener public void simpleInitApp() { bulletAppState = new BulletAppState(); stateManager.attach(bulletAppState); - bulletAppState.getPhysicsSpace().enableDebug(assetManager); + bulletAppState.setDebugEnabled(true); PhysicsTestHelper.createPhysicsTestWorld(rootNode, assetManager, bulletAppState.getPhysicsSpace()); setupKeys(); buildPlayer(); diff --git a/jme3-examples/src/main/java/jme3test/bullet/TestPhysicsHingeJoint.java b/jme3-examples/src/main/java/jme3test/bullet/TestPhysicsHingeJoint.java index f01ad23f9..029892ad9 100644 --- a/jme3-examples/src/main/java/jme3test/bullet/TestPhysicsHingeJoint.java +++ b/jme3-examples/src/main/java/jme3test/bullet/TestPhysicsHingeJoint.java @@ -76,7 +76,7 @@ public class TestPhysicsHingeJoint extends SimpleApplication implements AnalogLi public void simpleInitApp() { bulletAppState = new BulletAppState(); stateManager.attach(bulletAppState); - bulletAppState.getPhysicsSpace().enableDebug(assetManager); + bulletAppState.setDebugEnabled(true); setupKeys(); setupJoint(); } @@ -102,7 +102,7 @@ public class TestPhysicsHingeJoint extends SimpleApplication implements AnalogLi @Override public void simpleUpdate(float tpf) { - + } diff --git a/jme3-examples/src/main/java/jme3test/bullet/TestPhysicsRayCast.java b/jme3-examples/src/main/java/jme3test/bullet/TestPhysicsRayCast.java index c51afd3cc..7a1ea5187 100644 --- a/jme3-examples/src/main/java/jme3test/bullet/TestPhysicsRayCast.java +++ b/jme3-examples/src/main/java/jme3test/bullet/TestPhysicsRayCast.java @@ -1,5 +1,5 @@ package jme3test.bullet; - + import com.jme3.app.SimpleApplication; import com.jme3.bullet.BulletAppState; import com.jme3.bullet.collision.PhysicsCollisionObject; @@ -16,30 +16,30 @@ import java.util.List; * @author @wezrule */ public class TestPhysicsRayCast extends SimpleApplication { - + private BulletAppState bulletAppState = new BulletAppState(); - + public static void main(String[] args) { new TestPhysicsRayCast().start(); } - + @Override public void simpleInitApp() { stateManager.attach(bulletAppState); initCrossHair(); - + Spatial s = assetManager.loadModel("Models/Elephant/Elephant.mesh.xml"); s.setLocalScale(0.1f); - + CollisionShape collisionShape = CollisionShapeFactory.createMeshShape(s); Node n = new Node("elephant"); n.addControl(new RigidBodyControl(collisionShape, 1)); n.getControl(RigidBodyControl.class).setKinematic(true); bulletAppState.getPhysicsSpace().add(n); rootNode.attachChild(n); - bulletAppState.getPhysicsSpace().enableDebug(assetManager); + bulletAppState.setDebugEnabled(true); } - + @Override public void simpleUpdate(float tpf) { List rayTest = bulletAppState.getPhysicsSpace().rayTest(cam.getLocation(), cam.getLocation().add(cam.getDirection())); @@ -50,7 +50,7 @@ public class TestPhysicsRayCast extends SimpleApplication { fpsText.setText(collisionObject.getUserObject().toString()); } } - + private void initCrossHair() { BitmapText bitmapText = new BitmapText(guiFont); bitmapText.setText("+"); diff --git a/jme3-examples/src/main/java/jme3test/bullet/TestPhysicsReadWrite.java b/jme3-examples/src/main/java/jme3test/bullet/TestPhysicsReadWrite.java index 5724f7a16..7d94e0570 100644 --- a/jme3-examples/src/main/java/jme3test/bullet/TestPhysicsReadWrite.java +++ b/jme3-examples/src/main/java/jme3test/bullet/TestPhysicsReadWrite.java @@ -69,7 +69,7 @@ public class TestPhysicsReadWrite extends SimpleApplication{ public void simpleInitApp() { bulletAppState = new BulletAppState(); stateManager.attach(bulletAppState); - bulletAppState.getPhysicsSpace().enableDebug(assetManager); + bulletAppState.setDebugEnabled(true); physicsRootNode=new Node("PhysicsRootNode"); rootNode.attachChild(physicsRootNode); diff --git a/jme3-examples/src/main/java/jme3test/bullet/TestRagDoll.java b/jme3-examples/src/main/java/jme3test/bullet/TestRagDoll.java index 5768bc021..2752ce5a8 100644 --- a/jme3-examples/src/main/java/jme3test/bullet/TestRagDoll.java +++ b/jme3-examples/src/main/java/jme3test/bullet/TestRagDoll.java @@ -64,7 +64,7 @@ public class TestRagDoll extends SimpleApplication implements ActionListener { public void simpleInitApp() { bulletAppState = new BulletAppState(); stateManager.attach(bulletAppState); - bulletAppState.getPhysicsSpace().enableDebug(assetManager); + bulletAppState.setDebugEnabled(true); inputManager.addMapping("Pull ragdoll up", new MouseButtonTrigger(0)); inputManager.addListener(this, "Pull ragdoll up"); PhysicsTestHelper.createPhysicsTestWorld(rootNode, assetManager, bulletAppState.getPhysicsSpace()); diff --git a/jme3-examples/src/main/java/jme3test/bullet/TestSimplePhysics.java b/jme3-examples/src/main/java/jme3test/bullet/TestSimplePhysics.java index 2045e5c77..9cf2808ae 100644 --- a/jme3-examples/src/main/java/jme3test/bullet/TestSimplePhysics.java +++ b/jme3-examples/src/main/java/jme3test/bullet/TestSimplePhysics.java @@ -59,7 +59,7 @@ public class TestSimplePhysics extends SimpleApplication { public void simpleInitApp() { bulletAppState = new BulletAppState(); stateManager.attach(bulletAppState); - bulletAppState.getPhysicsSpace().enableDebug(assetManager); + bulletAppState.setDebugEnabled(true); // Add a physics sphere to the world Node physicsSphere = PhysicsTestHelper.createPhysicsTestNode(assetManager, new SphereCollisionShape(1), 1); diff --git a/jme3-examples/src/main/java/jme3test/bullet/TestSweepTest.java b/jme3-examples/src/main/java/jme3test/bullet/TestSweepTest.java index 0613e5d22..da9089cec 100644 --- a/jme3-examples/src/main/java/jme3test/bullet/TestSweepTest.java +++ b/jme3-examples/src/main/java/jme3test/bullet/TestSweepTest.java @@ -35,7 +35,7 @@ public class TestSweepTest extends SimpleApplication { public void simpleInitApp() { obstacleCollisionShape = new CapsuleCollisionShape(0.3f, 0.5f); capsuleCollisionShape = new CapsuleCollisionShape(1f, 1f); - + stateManager.attach(bulletAppState); capsule = new Node("capsule"); @@ -52,7 +52,7 @@ public class TestSweepTest extends SimpleApplication { bulletAppState.getPhysicsSpace().add(obstacle); rootNode.attachChild(obstacle); - bulletAppState.getPhysicsSpace().enableDebug(assetManager); + bulletAppState.setDebugEnabled(true); } @Override @@ -70,7 +70,7 @@ public class TestSweepTest extends SimpleApplication { colliding = true; } } - + if (!colliding) { // if the sweep is clear then move the spatial capsule.move(move, 0, 0); From ba3e6917c6bf2a729beafec9f71c9157b93e2b50 Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Mon, 27 Apr 2015 11:00:33 -0400 Subject: [PATCH 052/113] GLRenderer: fix modern extension retrieval method GL_NUM_EXTENSIONS and glGetStringi is only available in OpenGL3.0+. The gl3 != null check will always be true for LWJGL backend. --- .../src/main/java/com/jme3/renderer/opengl/GLRenderer.java | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/jme3-core/src/main/java/com/jme3/renderer/opengl/GLRenderer.java b/jme3-core/src/main/java/com/jme3/renderer/opengl/GLRenderer.java index db9b743f0..a6e4f562c 100644 --- a/jme3-core/src/main/java/com/jme3/renderer/opengl/GLRenderer.java +++ b/jme3-core/src/main/java/com/jme3/renderer/opengl/GLRenderer.java @@ -140,7 +140,7 @@ public class GLRenderer implements Renderer { private HashSet loadExtensions() { HashSet extensionSet = new HashSet(64); - if (gl3 != null) { + if (caps.contains(Caps.OpenGL30) { // If OpenGL3+ is available, use the non-deprecated way // of getting supported extensions. gl3.glGetInteger(GL3.GL_NUM_EXTENSIONS, intBuf16); From ab7a45f66c021bad7d9a6d2834b7114cd0b99f2e Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Mon, 27 Apr 2015 11:20:01 -0400 Subject: [PATCH 053/113] GLRenderer: forget an end parenthesis --- .../src/main/java/com/jme3/renderer/opengl/GLRenderer.java | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/jme3-core/src/main/java/com/jme3/renderer/opengl/GLRenderer.java b/jme3-core/src/main/java/com/jme3/renderer/opengl/GLRenderer.java index a6e4f562c..37b7c753f 100644 --- a/jme3-core/src/main/java/com/jme3/renderer/opengl/GLRenderer.java +++ b/jme3-core/src/main/java/com/jme3/renderer/opengl/GLRenderer.java @@ -140,7 +140,7 @@ public class GLRenderer implements Renderer { private HashSet loadExtensions() { HashSet extensionSet = new HashSet(64); - if (caps.contains(Caps.OpenGL30) { + if (caps.contains(Caps.OpenGL30)) { // If OpenGL3+ is available, use the non-deprecated way // of getting supported extensions. gl3.glGetInteger(GL3.GL_NUM_EXTENSIONS, intBuf16); From 03cf96bc04c923ab1a1ce6a9e5846e6d77173486 Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Mon, 27 Apr 2015 11:56:57 -0400 Subject: [PATCH 054/113] Travis-CI: enable container based infrastructure --- .travis.yml | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/.travis.yml b/.travis.yml index 25aedbbe0..93bd5d019 100644 --- a/.travis.yml +++ b/.travis.yml @@ -1,6 +1,5 @@ language: java -# jdk: -# - oraclejdk8 +sudo: false branches: only: From f7d544f45398231e13567f2bd86c5ea9de1d3ab2 Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Mon, 27 Apr 2015 13:00:22 -0400 Subject: [PATCH 055/113] Travis-CI: cache netbeans platform and gradle deps --- .travis.yml | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/.travis.yml b/.travis.yml index 93bd5d019..95bde2086 100644 --- a/.travis.yml +++ b/.travis.yml @@ -1,5 +1,12 @@ language: java sudo: false +env: + - GRADLE_USER_HOME=gradle-cache + +cache: + directories: + - gradle-cache + - netbeans branches: only: From cd1d14500571da1d771b9748d6eda912edeb40bd Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Mon, 27 Apr 2015 19:03:43 -0400 Subject: [PATCH 056/113] PhysicsSpace: add method to set solver iterations Thanks to Seppes (see thread: http://hub.jmonkeyengine.org/t/how-to-access-native-bullets-constraintsolver-numiterations) --- .../cpp/com_jme3_bullet_PhysicsSpace.cpp | 12 +++++++++ .../native/cpp/com_jme3_bullet_PhysicsSpace.h | 8 ++++++ .../java/com/jme3/bullet/PhysicsSpace.java | 26 ++++++++++++++++++- .../java/com/jme3/bullet/PhysicsSpace.java | 15 +++++++++++ 4 files changed, 60 insertions(+), 1 deletion(-) diff --git a/jme3-bullet-native/src/native/cpp/com_jme3_bullet_PhysicsSpace.cpp b/jme3-bullet-native/src/native/cpp/com_jme3_bullet_PhysicsSpace.cpp index f9be6a6ad..3ecf7fd6b 100644 --- a/jme3-bullet-native/src/native/cpp/com_jme3_bullet_PhysicsSpace.cpp +++ b/jme3-bullet-native/src/native/cpp/com_jme3_bullet_PhysicsSpace.cpp @@ -528,6 +528,18 @@ extern "C" { space->getDynamicsWorld()->convexSweepTest((btConvexShape *) shape, native_from, native_to, resultCallback, native_allowed_ccd_penetration); return; } + + JNIEXPORT void JNICALL Java_com_jme3_bullet_PhysicsSpace_setSolverNumIterations + (JNIEnv *env, jobject object, jlong spaceId, jint value) { + jmePhysicsSpace* space = reinterpret_cast(spaceId); + if (space == NULL) { + jclass newExc = env->FindClass("java/lang/NullPointerException"); + env->ThrowNew(newExc, "The physics space does not exist."); + return; + } + + space->getDynamicsWorld()->getSolverInfo().m_numIterations = value; + } #ifdef __cplusplus } diff --git a/jme3-bullet-native/src/native/cpp/com_jme3_bullet_PhysicsSpace.h b/jme3-bullet-native/src/native/cpp/com_jme3_bullet_PhysicsSpace.h index b499ff04c..0380c17b0 100644 --- a/jme3-bullet-native/src/native/cpp/com_jme3_bullet_PhysicsSpace.h +++ b/jme3-bullet-native/src/native/cpp/com_jme3_bullet_PhysicsSpace.h @@ -174,6 +174,14 @@ JNIEXPORT void JNICALL Java_com_jme3_bullet_PhysicsSpace_finalizeNative JNIEXPORT void JNICALL Java_com_jme3_bullet_PhysicsSpace_sweepTest_1native (JNIEnv *, jobject, jlong, jobject, jobject, jlong, jobject, jfloat); +/* + * Class: com_jme3_bullet_PhysicsSpace + * Method: setSolverNumIterations + * Signature: (JI)V + */ +JNIEXPORT void JNICALL Java_com_jme3_bullet_PhysicsSpace_setSolverNumIterations +(JNIEnv *, jobject, jlong, jint); + #ifdef __cplusplus } #endif diff --git a/jme3-bullet/src/main/java/com/jme3/bullet/PhysicsSpace.java b/jme3-bullet/src/main/java/com/jme3/bullet/PhysicsSpace.java index 4485edcd7..edea485ef 100644 --- a/jme3-bullet/src/main/java/com/jme3/bullet/PhysicsSpace.java +++ b/jme3-bullet/src/main/java/com/jme3/bullet/PhysicsSpace.java @@ -102,6 +102,7 @@ public class PhysicsSpace { private Vector3f worldMax = new Vector3f(10000f, 10000f, 10000f); private float accuracy = 1f / 60f; private int maxSubSteps = 4, rayTestFlags = 1 << 2; + private int solverNumIterations = 10; static { // System.loadLibrary("bulletjme"); @@ -871,7 +872,7 @@ public class PhysicsSpace { } */ - + /** * destroys the current PhysicsSpace so that a new one can be created */ @@ -958,6 +959,29 @@ public class PhysicsSpace { this.worldMax.set(worldMax); } + /** + * Set the number of iterations used by the contact solver. + * + * The default is 10. Use 4 for low quality, 20 for high quality. + * + * @param numIterations The number of iterations used by the contact & constraint solver. + */ + public void setSolverNumIterations(int numIterations) { + this.solverNumIterations = numIterations; + setSolverNumIterations(physicsSpaceId, numIterations); + } + + /** + * Get the number of iterations used by the contact solver. + * + * @return The number of iterations used by the contact & constraint solver. + */ + public int getSolverNumIterations() { + return solverNumIterations; + } + + private static native void setSolverNumIterations(long physicsSpaceId, int numIterations); + public static native void initNativePhysics(); /** diff --git a/jme3-jbullet/src/main/java/com/jme3/bullet/PhysicsSpace.java b/jme3-jbullet/src/main/java/com/jme3/bullet/PhysicsSpace.java index 3c8a3b225..016440bf0 100644 --- a/jme3-jbullet/src/main/java/com/jme3/bullet/PhysicsSpace.java +++ b/jme3-jbullet/src/main/java/com/jme3/bullet/PhysicsSpace.java @@ -875,7 +875,22 @@ public class PhysicsSpace { public void setWorldMax(Vector3f worldMax) { this.worldMax.set(worldMax); } + + /** + * Set the number of iterations used by the contact solver. + * + * The default is 10. Use 4 for low quality, 20 for high quality. + * + * @param numIterations The number of iterations used by the contact & constraint solver. + */ + public void setSolverNumIterations(int numIterations) { + dynamicsWorld.getSolverInfo().numIterations = numIterations; + } + public int getSolverNumIterations() { + return dynamicsWorld.getSolverInfo().numIterations; + } + /** * interface with Broadphase types */ From b7af06e41c592e0f2f3f779438c6cb8ede33e3b1 Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Mon, 27 Apr 2015 19:39:50 -0400 Subject: [PATCH 057/113] SDK Build: ensure netbeans folder is not empty For some reason Travis-CI will create folders that were requested to be cached, thus causing the build to fail. --- sdk/build.gradle | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sdk/build.gradle b/sdk/build.gradle index 745b878c6..b70e80b13 100644 --- a/sdk/build.gradle +++ b/sdk/build.gradle @@ -48,7 +48,7 @@ task checkPlatformConfig { def platformFile = file("nbproject/private/platform-private.properties") if(!platformFile.exists()){ def netbeansFolder = file("../netbeans") - if(!netbeansFolder.exists()){ + if(!netbeansFolder.exists() || netbeansFolder.list().length == 0){ println "Downloading NetBeans Platform base, this only has to be done once.." def f = file("netbeans.zip") new URL(netbeansUrl).withInputStream{ i -> f.withOutputStream{ it << i }} From bffdb6cc93ac7c1b09815cf42959d794c01b63d1 Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Mon, 27 Apr 2015 19:45:33 -0400 Subject: [PATCH 058/113] Travis-CI: Add Slack chat notifications --- .travis.yml | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/.travis.yml b/.travis.yml index 95bde2086..2db534d05 100644 --- a/.travis.yml +++ b/.travis.yml @@ -12,6 +12,10 @@ branches: only: - master +notifications: + slack: + secure: "Tuoa63n2iJT/JrdmGggnzJRHo7yPigvoEIObddYU2uw4iAkoGhXO125V4z92bggD5idVX/CNr8SCHTgbomzvtq9VrozW75ta2NDMt0bgR9tuxK12QzZpGtU6togU7S0j/0rUrOFi8B3paIc9SfCX6T+hB+Z2hGz8UMpnFuh6xJc=" + before_install: # required libs for android build tools # sudo apt-get update From 9e84c9f572b0cea977cd464579611f02fbf36fac Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Mon, 27 Apr 2015 19:57:01 -0400 Subject: [PATCH 059/113] Travis-CI: Fix incorrect notification string --- .travis.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.travis.yml b/.travis.yml index 2db534d05..2e93aa23c 100644 --- a/.travis.yml +++ b/.travis.yml @@ -14,7 +14,7 @@ branches: notifications: slack: - secure: "Tuoa63n2iJT/JrdmGggnzJRHo7yPigvoEIObddYU2uw4iAkoGhXO125V4z92bggD5idVX/CNr8SCHTgbomzvtq9VrozW75ta2NDMt0bgR9tuxK12QzZpGtU6togU7S0j/0rUrOFi8B3paIc9SfCX6T+hB+Z2hGz8UMpnFuh6xJc=" + secure: "PWEk4+VL986c3gAjWp12nqyifvxCjBqKoESG9d7zWh1uiTLadTHhZJRMdsye36FCpz/c/Jt7zCRO/5y7FaubQptnRrkrRfjp5f99MJRzQVXnUAM+y385qVkXKRKd/PLpM7XPm4AvjvxHCyvzX2wamRvul/TekaXKB9Ti5FCN87s=" before_install: # required libs for android build tools From 5c6deeb5aba54d87238363c835a42c2b5792d9aa Mon Sep 17 00:00:00 2001 From: iwgeric Date: Mon, 27 Apr 2015 23:23:26 -0400 Subject: [PATCH 060/113] Android: add GLFbo interface to AndroidGL to fix cast exception --- .../com/jme3/renderer/android/AndroidGL.java | 19 ++++++++++--------- 1 file changed, 10 insertions(+), 9 deletions(-) diff --git a/jme3-android/src/main/java/com/jme3/renderer/android/AndroidGL.java b/jme3-android/src/main/java/com/jme3/renderer/android/AndroidGL.java index 62741253a..b77c4a36d 100644 --- a/jme3-android/src/main/java/com/jme3/renderer/android/AndroidGL.java +++ b/jme3-android/src/main/java/com/jme3/renderer/android/AndroidGL.java @@ -35,42 +35,43 @@ import android.opengl.GLES20; import com.jme3.renderer.RendererException; import com.jme3.renderer.opengl.GL; import com.jme3.renderer.opengl.GLExt; +import com.jme3.renderer.opengl.GLFbo; import java.nio.Buffer; import java.nio.ByteBuffer; import java.nio.FloatBuffer; import java.nio.IntBuffer; import java.nio.ShortBuffer; -public class AndroidGL implements GL, GLExt { +public class AndroidGL implements GL, GLExt, GLFbo { public void resetStats() { } - + private static int getLimitBytes(ByteBuffer buffer) { checkLimit(buffer); return buffer.limit(); } - + private static int getLimitBytes(ShortBuffer buffer) { checkLimit(buffer); return buffer.limit() * 2; } - + private static int getLimitBytes(IntBuffer buffer) { checkLimit(buffer); return buffer.limit() * 4; } - + private static int getLimitBytes(FloatBuffer buffer) { checkLimit(buffer); return buffer.limit() * 4; } - + private static int getLimitCount(Buffer buffer, int elementSize) { checkLimit(buffer); return buffer.limit() / elementSize; } - + private static void checkLimit(Buffer buffer) { if (buffer == null) { return; @@ -82,7 +83,7 @@ public class AndroidGL implements GL, GLExt { throw new RendererException("Attempting to upload empty buffer (remaining = 0), that's an error"); } } - + public void glActiveTexture(int texture) { GLES20.glActiveTexture(texture); } @@ -130,7 +131,7 @@ public class AndroidGL implements GL, GLExt { public void glBufferSubData(int target, long offset, ByteBuffer data) { GLES20.glBufferSubData(target, (int) offset, getLimitBytes(data), data); } - + public void glGetBufferSubData(int target, long offset, ByteBuffer data) { throw new UnsupportedOperationException("OpenGL ES 2 does not support glGetBufferSubData"); } From 0eac43786282136cc84b74ccb9d7b5e279d313d6 Mon Sep 17 00:00:00 2001 From: Maselbas Date: Mon, 27 Apr 2015 23:56:23 +0200 Subject: [PATCH 061/113] SDK SceneComposer : - added local, global and camera choice into the scenecomposer, this option is displayed into the SceneComposer Window close to scene edit tool. - the scale tool still only work as local - the camera option still need some enhancement --- .../SceneComposerToolController.java | 41 +++++++++++++++++-- .../SceneComposerTopComponent.java | 22 ++++++++++ .../jme3/gde/scenecomposer/SceneEditTool.java | 26 +++++++++++- .../gde/scenecomposer/tools/MoveTool.java | 18 +++----- .../gde/scenecomposer/tools/PickManager.java | 15 +++---- .../gde/scenecomposer/tools/RotateTool.java | 9 ++-- .../gde/scenecomposer/tools/ScaleTool.java | 11 ++--- 7 files changed, 103 insertions(+), 39 deletions(-) diff --git a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/SceneComposerToolController.java b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/SceneComposerToolController.java index dff940e50..2ad04aa8d 100644 --- a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/SceneComposerToolController.java +++ b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/SceneComposerToolController.java @@ -10,6 +10,7 @@ import com.jme3.gde.core.scene.SceneApplication; import com.jme3.gde.core.scene.controller.SceneToolController; import com.jme3.gde.core.sceneexplorer.nodes.JmeNode; import com.jme3.gde.core.sceneexplorer.nodes.JmeSpatial; +import com.jme3.gde.scenecomposer.tools.PickManager; import com.jme3.input.event.KeyInputEvent; import com.jme3.light.Light; import com.jme3.light.PointLight; @@ -50,7 +51,12 @@ public class SceneComposerToolController extends SceneToolController { private boolean snapToScene = false; private boolean selectTerrain = false; private boolean selectGeometries = false; - + private TransformationType transformationType = TransformationType.local; + + public enum TransformationType { + local, global, camera + } + public SceneComposerToolController(final Node toolsNode, AssetManager manager, JmeNode rootNode) { super(toolsNode, manager); this.rootNode = rootNode; @@ -347,8 +353,37 @@ public class SceneComposerToolController extends SceneToolController { public void setSelectGeometries(boolean selectGeometries) { this.selectGeometries = selectGeometries; } - - + + public void setTransformationType(String type) { + if(type != null){ + if(type.equals("Local")){ + setTransformationType(transformationType.local); + } else if(type.equals("Global")){ + setTransformationType(TransformationType.global); + } else if(type.equals("Camera")){ + setTransformationType(TransformationType.camera); + } + } + } + /** + * @return the transformationType + */ + public TransformationType getTransformationType() { + return transformationType; + } + + /** + * @param transformationType the transformationType to set + */ + public void setTransformationType(TransformationType type) { + if(type != this.transformationType){ + this.transformationType = type; + if(editTool != null){ + //update the transform type of the tool + editTool.setTransformType(transformationType); + } + } + } /** * A marker on the screen that shows where a point light or diff --git a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/SceneComposerTopComponent.java b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/SceneComposerTopComponent.java index 1259d74a9..c7ecb9c87 100644 --- a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/SceneComposerTopComponent.java +++ b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/SceneComposerTopComponent.java @@ -97,6 +97,8 @@ public final class SceneComposerTopComponent extends TopComponent implements Sce sceneInfoLabel1 = new javax.swing.JLabel(); sceneInfoLabel2 = new javax.swing.JLabel(); jToolBar1 = new javax.swing.JToolBar(); + transformationTypeComboBox = new javax.swing.JComboBox(); + jSeparator9 = new javax.swing.JToolBar.Separator(); selectButton = new javax.swing.JToggleButton(); moveButton = new javax.swing.JToggleButton(); rotateButton = new javax.swing.JToggleButton(); @@ -165,6 +167,16 @@ public final class SceneComposerTopComponent extends TopComponent implements Sce jToolBar1.setFloatable(false); jToolBar1.setRollover(true); + transformationTypeComboBox.setModel(new javax.swing.DefaultComboBoxModel(new String[] { "Local", "Global", "Camera" })); + transformationTypeComboBox.setMaximumSize(new java.awt.Dimension(160, 50)); + transformationTypeComboBox.addActionListener(new java.awt.event.ActionListener() { + public void actionPerformed(java.awt.event.ActionEvent evt) { + transformationTypeComboBoxActionPerformed(evt); + } + }); + jToolBar1.add(transformationTypeComboBox); + jToolBar1.add(jSeparator9); + spatialModButtonGroup.add(selectButton); selectButton.setIcon(new javax.swing.ImageIcon(getClass().getResource("/com/jme3/gde/scenecomposer/icon_select.png"))); // NOI18N selectButton.setSelected(true); @@ -207,6 +219,7 @@ public final class SceneComposerTopComponent extends TopComponent implements Sce } }); jToolBar1.add(rotateButton); + rotateButton.getAccessibleContext().setAccessibleDescription(org.openide.util.NbBundle.getMessage(SceneComposerTopComponent.class, "SceneComposerTopComponent.rotateButton.AccessibleContext.accessibleDescription")); // NOI18N spatialModButtonGroup.add(scaleButton); scaleButton.setIcon(new javax.swing.ImageIcon(getClass().getResource("/com/jme3/gde/scenecomposer/icon_arrow_inout.png"))); // NOI18N @@ -221,6 +234,8 @@ public final class SceneComposerTopComponent extends TopComponent implements Sce } }); jToolBar1.add(scaleButton); + scaleButton.getAccessibleContext().setAccessibleDescription(org.openide.util.NbBundle.getMessage(SceneComposerTopComponent.class, "SceneComposerTopComponent.scaleButton.AccessibleContext.accessibleDescription")); // NOI18N + jToolBar1.add(jSeparator5); jToggleScene.setIcon(new javax.swing.ImageIcon(getClass().getResource("/com/jme3/gde/scenecomposer/snapScene.png"))); // NOI18N @@ -644,6 +659,11 @@ private void jToggleSelectTerrainActionPerformed(java.awt.event.ActionEvent evt) private void jToggleSelectGeomActionPerformed(java.awt.event.ActionEvent evt) {//GEN-FIRST:event_jToggleSelectGeomActionPerformed toolController.setSelectGeometries(jToggleSelectGeom.isSelected()); }//GEN-LAST:event_jToggleSelectGeomActionPerformed + + private void transformationTypeComboBoxActionPerformed(java.awt.event.ActionEvent evt) {//GEN-FIRST:event_transformationTypeComboBoxActionPerformed + toolController.setTransformationType((String)transformationTypeComboBox.getSelectedItem()); + }//GEN-LAST:event_transformationTypeComboBoxActionPerformed + // Variables declaration - do not modify//GEN-BEGIN:variables private javax.swing.JButton camToCursorSelectionButton; private javax.swing.JButton createPhysicsMeshButton; @@ -671,6 +691,7 @@ private void jToggleSelectGeomActionPerformed(java.awt.event.ActionEvent evt) {/ private javax.swing.JSeparator jSeparator6; private javax.swing.JToolBar.Separator jSeparator7; private javax.swing.JToolBar.Separator jSeparator8; + private javax.swing.JToolBar.Separator jSeparator9; private javax.swing.JTextField jTextField1; private javax.swing.JToggleButton jToggleGrid; private javax.swing.JToggleButton jToggleScene; @@ -692,6 +713,7 @@ private void jToggleSelectGeomActionPerformed(java.awt.event.ActionEvent evt) {/ private javax.swing.JToggleButton showGridToggleButton; private javax.swing.JToggleButton showSelectionToggleButton; private javax.swing.ButtonGroup spatialModButtonGroup; + private javax.swing.JComboBox transformationTypeComboBox; // End of variables declaration//GEN-END:variables private void emit(Spatial root) { diff --git a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/SceneEditTool.java b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/SceneEditTool.java index 5409a3603..372984f8e 100644 --- a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/SceneEditTool.java +++ b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/SceneEditTool.java @@ -57,7 +57,8 @@ public abstract class SceneEditTool { protected Node axisMarker; protected Material redMat, blueMat, greenMat, yellowMat, cyanMat, magentaMat, orangeMat; protected Geometry quadXY, quadXZ, quadYZ; - + protected SceneComposerToolController.TransformationType transformType; + protected enum AxisMarkerPickType { axisOnly, planeOnly, axisAndPlane @@ -72,6 +73,7 @@ public abstract class SceneEditTool { public void activate(AssetManager manager, Node toolNode, Node onTopToolNode, Spatial selectedSpatial, SceneComposerToolController toolController) { this.manager = manager; this.toolController = toolController; + this.setTransformType(toolController.getTransformationType()); //this.selectedSpatial = selectedSpatial; addMarker(toolNode, onTopToolNode); } @@ -130,7 +132,19 @@ public abstract class SceneEditTool { public void doUpdateToolsTransformation() { if (toolController.getSelectedSpatial() != null) { axisMarker.setLocalTranslation(toolController.getSelectedSpatial().getWorldTranslation()); - axisMarker.setLocalRotation(toolController.getSelectedSpatial().getLocalRotation()); + switch (transformType) { + case local: + axisMarker.setLocalRotation(toolController.getSelectedSpatial().getLocalRotation()); + break; + case global: + axisMarker.setLocalRotation(Quaternion.IDENTITY); + break; + case camera: + if(camera != null){ + axisMarker.setLocalRotation(camera.getRotation()); + } + break; + } setAxisMarkerScale(toolController.getSelectedSpatial()); } else { axisMarker.setLocalTranslation(Vector3f.ZERO); @@ -487,4 +501,12 @@ public abstract class SceneEditTool { public void setCamera(Camera camera) { this.camera = camera; } + + public SceneComposerToolController.TransformationType getTransformType() { + return transformType; + } + + public void setTransformType(SceneComposerToolController.TransformationType transformType) { + this.transformType = transformType; + } } diff --git a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/MoveTool.java b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/MoveTool.java index e0e8d009b..a553f35f2 100644 --- a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/MoveTool.java +++ b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/MoveTool.java @@ -103,25 +103,19 @@ public class MoveTool extends SceneEditTool { } if (pickedMarker.equals(QUAD_XY)) { - pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_XY, - PickManager.TransformationType.local, camera, screenCoord); + pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_XY, getTransformType(), camera, screenCoord); } else if (pickedMarker.equals(QUAD_XZ)) { - pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_XZ, - PickManager.TransformationType.local, camera, screenCoord); + pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_XZ, getTransformType(), camera, screenCoord); } else if (pickedMarker.equals(QUAD_YZ)) { - pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_YZ, - PickManager.TransformationType.local, camera, screenCoord); + pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_YZ, getTransformType(), camera, screenCoord); } else if (pickedMarker.equals(ARROW_X)) { - pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_XY, - PickManager.TransformationType.local, camera, screenCoord); + pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_XY, getTransformType(), camera, screenCoord); constraintAxis = Vector3f.UNIT_X; // move only X } else if (pickedMarker.equals(ARROW_Y)) { - pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_YZ, - PickManager.TransformationType.local, camera, screenCoord); + pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_YZ, getTransformType(), camera, screenCoord); constraintAxis = Vector3f.UNIT_Y; // move only Y } else if (pickedMarker.equals(ARROW_Z)) { - pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_XZ, - PickManager.TransformationType.local, camera, screenCoord); + pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_XZ, getTransformType(), camera, screenCoord); constraintAxis = Vector3f.UNIT_Z; // move only Z } startPosition = toolController.getSelectedSpatial().getLocalTranslation().clone(); diff --git a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/PickManager.java b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/PickManager.java index d7075b9fe..6eeb723a6 100644 --- a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/PickManager.java +++ b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/PickManager.java @@ -5,6 +5,7 @@ */ package com.jme3.gde.scenecomposer.tools; +import com.jme3.gde.scenecomposer.SceneComposerToolController; import com.jme3.gde.scenecomposer.SceneEditTool; import com.jme3.math.FastMath; import com.jme3.math.Quaternion; @@ -35,10 +36,6 @@ public class PickManager { protected static final Quaternion PLANE_YZ = new Quaternion().fromAngleAxis(-FastMath.PI / 2, new Vector3f(0, 1, 0));//YAW090 protected static final Quaternion PLANE_XZ = new Quaternion().fromAngleAxis(FastMath.PI / 2, new Vector3f(1, 0, 0)); //PITCH090 - public enum TransformationType { - - local, global, camera - } public PickManager() { float size = 1000; @@ -55,7 +52,7 @@ public class PickManager { spatial = null; } - public void initiatePick(Spatial selectedSpatial, Quaternion planeRotation, TransformationType type, Camera camera, Vector2f screenCoord) { + public void initiatePick(Spatial selectedSpatial, Quaternion planeRotation, SceneComposerToolController.TransformationType type, Camera camera, Vector2f screenCoord) { spatial = selectedSpatial; startSpatialLocation = selectedSpatial.getWorldTranslation().clone(); @@ -65,16 +62,16 @@ public class PickManager { startPickLoc = SceneEditTool.pickWorldLocation(camera, screenCoord, plane, null); } - public void setTransformation(Quaternion planeRotation, TransformationType type) { + public void setTransformation(Quaternion planeRotation, SceneComposerToolController.TransformationType type) { Quaternion rot = new Quaternion(); - if (type == TransformationType.local) { + if (type == SceneComposerToolController.TransformationType.local) { rot.set(spatial.getWorldRotation()); rot.multLocal(planeRotation); origineRotation = spatial.getWorldRotation().clone(); - } else if (type == TransformationType.global) { + } else if (type == SceneComposerToolController.TransformationType.global) { rot.set(planeRotation); origineRotation = new Quaternion(Quaternion.IDENTITY); - } else if (type == TransformationType.camera) { + } else if (type == SceneComposerToolController.TransformationType.camera) { rot.set(planeRotation); origineRotation = planeRotation.clone(); } diff --git a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/RotateTool.java b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/RotateTool.java index 343d24818..c43ae52d0 100644 --- a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/RotateTool.java +++ b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/RotateTool.java @@ -96,14 +96,11 @@ public class RotateTool extends SceneEditTool { } if (pickedMarker.equals(QUAD_XY)) { - pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_XY, - PickManager.TransformationType.local, camera, screenCoord); + pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_XY, getTransformType(), camera, screenCoord); } else if (pickedMarker.equals(QUAD_XZ)) { - pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_XZ, - PickManager.TransformationType.local, camera, screenCoord); + pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_XZ, getTransformType(), camera, screenCoord); } else if (pickedMarker.equals(QUAD_YZ)) { - pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_YZ, - PickManager.TransformationType.local, camera, screenCoord); + pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_YZ, getTransformType(), camera, screenCoord); } startRotate = toolController.getSelectedSpatial().getLocalRotation().clone(); } diff --git a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/ScaleTool.java b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/ScaleTool.java index 1f0b5387b..69f5bfc9c 100644 --- a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/ScaleTool.java +++ b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/ScaleTool.java @@ -97,18 +97,15 @@ public class ScaleTool extends SceneEditTool { if (pickedMarker.equals(QUAD_XY) || pickedMarker.equals(QUAD_XZ) || pickedMarker.equals(QUAD_YZ)) { pickManager.initiatePick(toolController.getSelectedSpatial(), camera.getRotation(), - PickManager.TransformationType.camera, camera, screenCoord); + SceneComposerToolController.TransformationType.camera, camera, screenCoord); } else if (pickedMarker.equals(ARROW_X)) { - pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_XY, - PickManager.TransformationType.global, camera, screenCoord); + pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_XY, getTransformType(), camera, screenCoord); constraintAxis = Vector3f.UNIT_X; // scale only X } else if (pickedMarker.equals(ARROW_Y)) { - pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_YZ, - PickManager.TransformationType.global, camera, screenCoord); + pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_YZ, getTransformType(), camera, screenCoord); constraintAxis = Vector3f.UNIT_Y; // scale only Y } else if (pickedMarker.equals(ARROW_Z)) { - pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_XZ, - PickManager.TransformationType.global, camera, screenCoord); + pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_XZ, getTransformType(), camera, screenCoord); constraintAxis = Vector3f.UNIT_Z; // scale only Z } startScale = toolController.getSelectedSpatial().getLocalScale().clone(); From 2104edabe407cd81bcd7349c24fb8244a1a223b8 Mon Sep 17 00:00:00 2001 From: Maselbas Date: Tue, 28 Apr 2015 22:00:31 +0200 Subject: [PATCH 062/113] SDK SceneComposer : forget to add .form after the rework of the window --- .../scenecomposer/SceneComposerTopComponent.form | 16 ++++++++++++++++ .../scenecomposer/SceneComposerTopComponent.java | 4 ---- 2 files changed, 16 insertions(+), 4 deletions(-) diff --git a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/SceneComposerTopComponent.form b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/SceneComposerTopComponent.form index 8b21fb202..7893e6c52 100644 --- a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/SceneComposerTopComponent.form +++ b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/SceneComposerTopComponent.form @@ -99,6 +99,22 @@ + + + + + + + + + + + + + + + + diff --git a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/SceneComposerTopComponent.java b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/SceneComposerTopComponent.java index c7ecb9c87..3b8a70836 100644 --- a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/SceneComposerTopComponent.java +++ b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/SceneComposerTopComponent.java @@ -168,7 +168,6 @@ public final class SceneComposerTopComponent extends TopComponent implements Sce jToolBar1.setRollover(true); transformationTypeComboBox.setModel(new javax.swing.DefaultComboBoxModel(new String[] { "Local", "Global", "Camera" })); - transformationTypeComboBox.setMaximumSize(new java.awt.Dimension(160, 50)); transformationTypeComboBox.addActionListener(new java.awt.event.ActionListener() { public void actionPerformed(java.awt.event.ActionEvent evt) { transformationTypeComboBoxActionPerformed(evt); @@ -219,7 +218,6 @@ public final class SceneComposerTopComponent extends TopComponent implements Sce } }); jToolBar1.add(rotateButton); - rotateButton.getAccessibleContext().setAccessibleDescription(org.openide.util.NbBundle.getMessage(SceneComposerTopComponent.class, "SceneComposerTopComponent.rotateButton.AccessibleContext.accessibleDescription")); // NOI18N spatialModButtonGroup.add(scaleButton); scaleButton.setIcon(new javax.swing.ImageIcon(getClass().getResource("/com/jme3/gde/scenecomposer/icon_arrow_inout.png"))); // NOI18N @@ -234,8 +232,6 @@ public final class SceneComposerTopComponent extends TopComponent implements Sce } }); jToolBar1.add(scaleButton); - scaleButton.getAccessibleContext().setAccessibleDescription(org.openide.util.NbBundle.getMessage(SceneComposerTopComponent.class, "SceneComposerTopComponent.scaleButton.AccessibleContext.accessibleDescription")); // NOI18N - jToolBar1.add(jSeparator5); jToggleScene.setIcon(new javax.swing.ImageIcon(getClass().getResource("/com/jme3/gde/scenecomposer/snapScene.png"))); // NOI18N From 5c539f5656fad35c7ced2a380632c470af9f2e93 Mon Sep 17 00:00:00 2001 From: Maselbas Date: Tue, 28 Apr 2015 22:10:07 +0200 Subject: [PATCH 063/113] SDK SceneComposer : fix scale tool, now the global option should work --- .../src/com/jme3/gde/scenecomposer/tools/ScaleTool.java | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/ScaleTool.java b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/ScaleTool.java index 69f5bfc9c..edde41a24 100644 --- a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/ScaleTool.java +++ b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/ScaleTool.java @@ -122,7 +122,9 @@ public class ScaleTool extends SceneEditTool { lastScale = scale; toolController.getSelectedSpatial().setLocalScale(scale); } else if (pickedMarker.equals(ARROW_X) || pickedMarker.equals(ARROW_Y) || pickedMarker.equals(ARROW_Z)) { - Vector3f diff = pickManager.getLocalTranslation(constraintAxis); + // Get the translation in the spatial Space + Quaternion worldToSpatial = toolController.getSelectedSpatial().getWorldRotation().inverse(); + Vector3f diff = pickManager.getTranslation(worldToSpatial.mult(constraintAxis)); diff.multLocal(0.5f); Vector3f scale = startScale.add(diff); lastScale = scale; From a531794c669e34e76c6eec7de431495c095b77f9 Mon Sep 17 00:00:00 2001 From: Maselbas Date: Tue, 28 Apr 2015 22:27:12 +0200 Subject: [PATCH 064/113] SDK SceneComposer : - added tooltip for the new jComboBox - modified tooltip for scale and rotate tools : removed (in-development) --- .../src/com/jme3/gde/scenecomposer/Bundle.properties | 6 ++++-- .../jme3/gde/scenecomposer/SceneComposerTopComponent.form | 8 ++++++++ .../jme3/gde/scenecomposer/SceneComposerTopComponent.java | 3 +++ 3 files changed, 15 insertions(+), 2 deletions(-) diff --git a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/Bundle.properties b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/Bundle.properties index 86f1414f9..43469051d 100644 --- a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/Bundle.properties +++ b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/Bundle.properties @@ -44,8 +44,8 @@ SceneComposerTopComponent.scaleButton.text= SceneComposerTopComponent.selectButton.text= SceneComposerTopComponent.selectButton.toolTipText=Select SceneComposerTopComponent.moveButton.toolTipText=Move -SceneComposerTopComponent.rotateButton.toolTipText=Rotate (in-development) -SceneComposerTopComponent.scaleButton.toolTipText=Scale (in-development) +SceneComposerTopComponent.rotateButton.toolTipText=Rotate +SceneComposerTopComponent.scaleButton.toolTipText=Scale SceneComposerTopComponent.sceneInfoPanel.border.title=no scene loaded SceneComposerTopComponent.jLabel5.text=Effects : SceneComposerTopComponent.emitButton.toolTipText=Emit all particles of all particle emitters from the selected Node @@ -63,3 +63,5 @@ SceneComposerTopComponent.jToggleScene.toolTipText=Snap to Scene SceneComposerTopComponent.jToggleGrid.toolTipText=Snap to Grid SceneComposerTopComponent.jToggleSelectGeom.toolTipText=Select Geometries SceneComposerTopComponent.jToggleSelectTerrain.toolTipText=Select Terrain +SceneComposerTopComponent.scaleButton.AccessibleContext.accessibleDescription=Scale +SceneComposerTopComponent.transformationTypeComboBox.toolTipText=Choose the transformation type used by tools. diff --git a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/SceneComposerTopComponent.form b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/SceneComposerTopComponent.form index 7893e6c52..fd4686f24 100644 --- a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/SceneComposerTopComponent.form +++ b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/SceneComposerTopComponent.form @@ -108,6 +108,9 @@ + + + @@ -200,6 +203,11 @@ + + + + + diff --git a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/SceneComposerTopComponent.java b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/SceneComposerTopComponent.java index 3b8a70836..b06e126dc 100644 --- a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/SceneComposerTopComponent.java +++ b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/SceneComposerTopComponent.java @@ -168,6 +168,7 @@ public final class SceneComposerTopComponent extends TopComponent implements Sce jToolBar1.setRollover(true); transformationTypeComboBox.setModel(new javax.swing.DefaultComboBoxModel(new String[] { "Local", "Global", "Camera" })); + transformationTypeComboBox.setToolTipText(org.openide.util.NbBundle.getMessage(SceneComposerTopComponent.class, "SceneComposerTopComponent.transformationTypeComboBox.toolTipText")); // NOI18N transformationTypeComboBox.addActionListener(new java.awt.event.ActionListener() { public void actionPerformed(java.awt.event.ActionEvent evt) { transformationTypeComboBoxActionPerformed(evt); @@ -232,6 +233,8 @@ public final class SceneComposerTopComponent extends TopComponent implements Sce } }); jToolBar1.add(scaleButton); + scaleButton.getAccessibleContext().setAccessibleDescription(org.openide.util.NbBundle.getMessage(SceneComposerTopComponent.class, "SceneComposerTopComponent.scaleButton.AccessibleContext.accessibleDescription")); // NOI18N + jToolBar1.add(jSeparator5); jToggleScene.setIcon(new javax.swing.ImageIcon(getClass().getResource("/com/jme3/gde/scenecomposer/snapScene.png"))); // NOI18N From 8b8425ba68bbe4f87c580cf8d6171388514b18ac Mon Sep 17 00:00:00 2001 From: Maselbas Date: Tue, 28 Apr 2015 23:55:05 +0200 Subject: [PATCH 065/113] SDK SceneComposer : fixed camera transformation type now works for move and scale tool, but act realy weird with rotate tool. --- .../jme3/gde/scenecomposer/tools/PickManager.java | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/PickManager.java b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/PickManager.java index 6eeb723a6..fc0032edb 100644 --- a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/PickManager.java +++ b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/PickManager.java @@ -31,7 +31,8 @@ public class PickManager { private Quaternion origineRotation; private final Node plane; private Spatial spatial; - + private SceneComposerToolController.TransformationType transformationType; + protected static final Quaternion PLANE_XY = new Quaternion().fromAngleAxis(0, new Vector3f(1, 0, 0)); protected static final Quaternion PLANE_YZ = new Quaternion().fromAngleAxis(-FastMath.PI / 2, new Vector3f(0, 1, 0));//YAW090 protected static final Quaternion PLANE_XZ = new Quaternion().fromAngleAxis(FastMath.PI / 2, new Vector3f(1, 0, 0)); //PITCH090 @@ -64,14 +65,15 @@ public class PickManager { public void setTransformation(Quaternion planeRotation, SceneComposerToolController.TransformationType type) { Quaternion rot = new Quaternion(); - if (type == SceneComposerToolController.TransformationType.local) { + transformationType = type; + if (transformationType == SceneComposerToolController.TransformationType.local) { rot.set(spatial.getWorldRotation()); rot.multLocal(planeRotation); origineRotation = spatial.getWorldRotation().clone(); - } else if (type == SceneComposerToolController.TransformationType.global) { + } else if (transformationType == SceneComposerToolController.TransformationType.global) { rot.set(planeRotation); origineRotation = new Quaternion(Quaternion.IDENTITY); - } else if (type == SceneComposerToolController.TransformationType.camera) { + } else if (transformationType == SceneComposerToolController.TransformationType.camera) { rot.set(planeRotation); origineRotation = planeRotation.clone(); } @@ -79,6 +81,10 @@ public class PickManager { } public boolean updatePick(Camera camera, Vector2f screenCoord) { + if(transformationType == SceneComposerToolController.TransformationType.camera){ + origineRotation = camera.getRotation(); + plane.setLocalRotation(camera.getRotation()); + } finalPickLoc = SceneEditTool.pickWorldLocation(camera, screenCoord, plane, null); return finalPickLoc != null; } From 8797bda5efb63c18b4e8a74d4e54e6357f31f913 Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Tue, 28 Apr 2015 23:51:47 -0400 Subject: [PATCH 066/113] Maven: remove unneeded properties Those are determined automatically by gradle, no need to specify explicitly. --- common.gradle | 19 +++---------------- 1 file changed, 3 insertions(+), 16 deletions(-) diff --git a/common.gradle b/common.gradle index 9d65f7338..0852470e4 100644 --- a/common.gradle +++ b/common.gradle @@ -5,15 +5,15 @@ apply plugin: 'java' apply plugin: 'maven' -String mavenGroupId = 'com.jme3' -String mavenVersion = jmeVersion + '-' + jmeVersionTag //'-SNAPSHOT' +group = 'com.jme3' +version = jmeVersion + '-' + jmeVersionTag sourceCompatibility = '1.6' [compileJava, compileTestJava]*.options*.encoding = 'UTF-8' repositories { mavenCentral() - maven{ + maven { url "http://nifty-gui.sourceforge.net/nifty-maven-repo" } } @@ -23,11 +23,6 @@ dependencies { testCompile group: 'junit', name: 'junit', version: '4.10' } -String mavenArtifactId = name - -group = mavenGroupId -version = mavenVersion - javadoc { failOnError = false options.memberLevel = org.gradle.external.javadoc.JavadocMemberLevel.PROTECTED @@ -60,14 +55,6 @@ artifacts { } } -configure(install.repositories.mavenInstaller) { - pom.project { - groupId = mavenGroupId - artifactId = mavenArtifactId - version = mavenVersion - } -} - task createFolders(description: 'Creates the source folders if they do not exist.') doLast { // sourceSets*.allSource*.srcDirs*.each { File srcDir -> // if (!srcDir.isDirectory()) { From 2bdd4d5a32ba3a6b24984c8917b392688a1b01ce Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Tue, 28 Apr 2015 23:59:49 -0400 Subject: [PATCH 067/113] Maven: enable maven artifact publishing Currently to local repo only. --- common.gradle | 38 ++++++++++++++++++++++++++++++++++++++ gradle.properties | 11 +++++++++++ 2 files changed, 49 insertions(+) diff --git a/common.gradle b/common.gradle index 0852470e4..6af4c664f 100644 --- a/common.gradle +++ b/common.gradle @@ -4,6 +4,7 @@ apply plugin: 'java' apply plugin: 'maven' +apply plugin: 'maven-publish' group = 'com.jme3' version = jmeVersion + '-' + jmeVersionTag @@ -55,6 +56,43 @@ artifacts { } } +publishing { + publications { + maven(MavenPublication) { + from components.java + artifact sourcesJar + artifact javadocJar + + pom.withXml { + asNode().children().last() + { + resolveStrategy = Closure.DELEGATE_FIRST + name POM_NAME + description POM_DESCRIPTION + url POM_URL + scm { + url POM_SCM_URL + connection POM_SCM_CONNECTION + developerConnection POM_SCM_DEVELOPER_CONNECTION + } + licenses { + license { + name POM_LICENSE_NAME + url POM_LICENSE_URL + distribution POM_LICENSE_DISTRIBUTION + } + } + } + } + } + } + + repositories { + maven { + url "${rootProject.buildDir}/repo" // change to point to your repo, e.g. http://my.org/repo + } + } +} + task createFolders(description: 'Creates the source folders if they do not exist.') doLast { // sourceSets*.allSource*.srcDirs*.each { File srcDir -> // if (!srcDir.isDirectory()) { diff --git a/gradle.properties b/gradle.properties index 00429d65a..ccc3ed460 100644 --- a/gradle.properties +++ b/gradle.properties @@ -23,3 +23,14 @@ bulletZipFile = bullet.zip # Path for downloading NetBeans Base netbeansUrl = http://download.netbeans.org/netbeans/8.0.2/final/zip/netbeans-8.0.2-201411181905-javase.zip + +# POM settings +POM_NAME=jMonkeyEngine +POM_DESCRIPTION=jMonkeyEngine is a 3D game engine for adventurous Java developers +POM_URL=http://jmonkeyengine.org +POM_SCM_URL=https://github.com/jMonkeyEngine/jmonkeyengine +POM_SCM_CONNECTION=scm:git:git://github.com/jMonkeyEngine/jmonkeyengine.git +POM_SCM_DEVELOPER_CONNECTION=scm:git:git@github.com:jMonkeyEngine/jmonkeyengine.git +POM_LICENSE_NAME=New BSD (3-clause) License +POM_LICENSE_URL=http://opensource.org/licenses/BSD-3-Clause +POM_LICENSE_DISTRIBUTION=repo From df96ab4f14b6ef2ec4dfcf57d7b74651735e05d1 Mon Sep 17 00:00:00 2001 From: Maselbas Date: Wed, 29 Apr 2015 21:52:25 +0200 Subject: [PATCH 068/113] SDK SceneComposer : fix a warning at the build time --- .../SceneComposerToolController.java | 17 +++++++++-------- 1 file changed, 9 insertions(+), 8 deletions(-) diff --git a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/SceneComposerToolController.java b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/SceneComposerToolController.java index 2ad04aa8d..50b6d5cfe 100644 --- a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/SceneComposerToolController.java +++ b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/SceneComposerToolController.java @@ -357,7 +357,7 @@ public class SceneComposerToolController extends SceneToolController { public void setTransformationType(String type) { if(type != null){ if(type.equals("Local")){ - setTransformationType(transformationType.local); + setTransformationType(TransformationType.local); } else if(type.equals("Global")){ setTransformationType(TransformationType.global); } else if(type.equals("Camera")){ @@ -365,15 +365,9 @@ public class SceneComposerToolController extends SceneToolController { } } } - /** - * @return the transformationType - */ - public TransformationType getTransformationType() { - return transformationType; - } /** - * @param transformationType the transformationType to set + * @param type the transformationType to set */ public void setTransformationType(TransformationType type) { if(type != this.transformationType){ @@ -385,6 +379,13 @@ public class SceneComposerToolController extends SceneToolController { } } + /** + * @return the transformationType + */ + public TransformationType getTransformationType() { + return transformationType; + } + /** * A marker on the screen that shows where a point light or * a spot light is. This marker is not part of the scene, From 7393f7916579cf26b7bbdc060756e37bc2c6d61f Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Wed, 29 Apr 2015 23:56:56 -0400 Subject: [PATCH 069/113] AudioSource: add method to get playback time As was requested on the forum, getting playback time / position is needed to perform proper audio / video synchronization. --- .../AndroidMediaPlayerAudioRenderer.java | 5 ++ .../main/java/com/jme3/audio/AudioNode.java | 8 +++ .../java/com/jme3/audio/AudioRenderer.java | 1 + .../main/java/com/jme3/audio/AudioSource.java | 5 ++ .../main/java/com/jme3/audio/AudioStream.java | 13 ++++ .../jme3/audio/openal/ALAudioRenderer.java | 60 +++++++++++++++++++ 6 files changed, 92 insertions(+) diff --git a/jme3-android/src/main/java/com/jme3/audio/android/AndroidMediaPlayerAudioRenderer.java b/jme3-android/src/main/java/com/jme3/audio/android/AndroidMediaPlayerAudioRenderer.java index 7ed04658e..394cc257b 100644 --- a/jme3-android/src/main/java/com/jme3/audio/android/AndroidMediaPlayerAudioRenderer.java +++ b/jme3-android/src/main/java/com/jme3/audio/android/AndroidMediaPlayerAudioRenderer.java @@ -525,4 +525,9 @@ public class AndroidMediaPlayerAudioRenderer implements AudioRenderer, @Override public void deleteFilter(Filter filter) { } + + @Override + public float getSourcePlaybackTime(AudioSource src) { + throw new UnsupportedOperationException("Not supported yet."); + } } diff --git a/jme3-core/src/main/java/com/jme3/audio/AudioNode.java b/jme3-core/src/main/java/com/jme3/audio/AudioNode.java index 0e75db9fe..c4dcfabf0 100644 --- a/jme3-core/src/main/java/com/jme3/audio/AudioNode.java +++ b/jme3-core/src/main/java/com/jme3/audio/AudioNode.java @@ -409,6 +409,14 @@ public class AudioNode extends Node implements AudioSource { play(); } } + + @Override + public float getPlaybackTime() { + if (channel >= 0) + return getRenderer().getSourcePlaybackTime(this); + else + return 0; + } public Vector3f getPosition() { return getWorldTranslation(); diff --git a/jme3-core/src/main/java/com/jme3/audio/AudioRenderer.java b/jme3-core/src/main/java/com/jme3/audio/AudioRenderer.java index 78ea88e91..695999e48 100644 --- a/jme3-core/src/main/java/com/jme3/audio/AudioRenderer.java +++ b/jme3-core/src/main/java/com/jme3/audio/AudioRenderer.java @@ -59,6 +59,7 @@ public interface AudioRenderer { public void updateSourceParam(AudioSource src, AudioParam param); public void updateListenerParam(Listener listener, ListenerParam param); + public float getSourcePlaybackTime(AudioSource src); public void deleteFilter(Filter filter); public void deleteAudioData(AudioData ad); diff --git a/jme3-core/src/main/java/com/jme3/audio/AudioSource.java b/jme3-core/src/main/java/com/jme3/audio/AudioSource.java index 3aa23b78d..75a4e70f9 100644 --- a/jme3-core/src/main/java/com/jme3/audio/AudioSource.java +++ b/jme3-core/src/main/java/com/jme3/audio/AudioSource.java @@ -95,6 +95,11 @@ public interface AudioSource { * @return the time offset in the sound sample when to start playing. */ public float getTimeOffset(); + + /** + * @return the current playback position of the source in seconds. + */ + public float getPlaybackTime(); /** * @return The velocity of the audio source. diff --git a/jme3-core/src/main/java/com/jme3/audio/AudioStream.java b/jme3-core/src/main/java/com/jme3/audio/AudioStream.java index f7ff4c04b..598ae189c 100644 --- a/jme3-core/src/main/java/com/jme3/audio/AudioStream.java +++ b/jme3-core/src/main/java/com/jme3/audio/AudioStream.java @@ -54,6 +54,8 @@ public class AudioStream extends AudioData implements Closeable { protected boolean eof = false; protected int[] ids; + protected int unqueuedBuffersBytes = 0; + public AudioStream() { super(); } @@ -196,10 +198,21 @@ public class AudioStream extends AudioData implements Closeable { return in instanceof SeekableStream; } + public int getUnqueuedBufferBytes() { + return unqueuedBuffersBytes; + } + + public void setUnqueuedBufferBytes(int unqueuedBuffers) { + this.unqueuedBuffersBytes = unqueuedBuffers; + } + public void setTime(float time) { if (in instanceof SeekableStream) { ((SeekableStream) in).setTime(time); eof = false; + + // TODO: when we actually support seeking, this will need to be properly set. + unqueuedBuffersBytes = 0; } else { throw new IllegalStateException( "Cannot use setTime on a stream that " diff --git a/jme3-core/src/main/java/com/jme3/audio/openal/ALAudioRenderer.java b/jme3-core/src/main/java/com/jme3/audio/openal/ALAudioRenderer.java index c3ccea741..62f04018a 100644 --- a/jme3-core/src/main/java/com/jme3/audio/openal/ALAudioRenderer.java +++ b/jme3-core/src/main/java/com/jme3/audio/openal/ALAudioRenderer.java @@ -301,6 +301,58 @@ public class ALAudioRenderer implements AudioRenderer, Runnable { f.clearUpdateNeeded(); } + @Override + public float getSourcePlaybackTime(AudioSource src) { + checkDead(); + synchronized (threadLock) { + if (audioDisabled) { + return 0; + } + + // See comment in updateSourceParam(). + if (src.getChannel() < 0) { + return 0; + } + + int id = channels[src.getChannel()]; + AudioData data = src.getAudioData(); + int playbackOffsetBytes = 0; + + if (data instanceof AudioStream) { + // Because audio streams are processed in buffer chunks, + // we have to compute the amount of time the stream was already + // been playing based on the number of buffers that were processed. + AudioStream stream = (AudioStream) data; + + // NOTE: the assumption is that all enqueued buffers are the same size. + // this is currently enforced by fillBuffer(). + + // The number of unenqueued bytes that the decoder thread + // keeps track of. + int unqueuedBytes = stream.getUnqueuedBufferBytes(); + + // Additional processed buffers that the decoder thread + // did not unenqueue yet (it only updates 20 times per second). + int unqueuedBytesExtra = al.alGetSourcei(id, AL_BUFFERS_PROCESSED) * BUFFER_SIZE; + + // Total additional bytes that need to be considered. + playbackOffsetBytes = unqueuedBytes; // + unqueuedBytesExtra; + } + + // Add byte offset from source (for both streams and buffers) + playbackOffsetBytes += al.alGetSourcei(id, AL_BYTE_OFFSET); + + // Compute time value from bytes + // E.g. for 44100 source with 2 channels and 16 bits per sample: + // (44100 * 2 * 16 / 8) = 176400 + int bytesPerSecond = (data.getSampleRate() * + data.getChannels() * + data.getBitsPerSample() / 8); + + return (float)playbackOffsetBytes / bytesPerSecond; + } + } + public void updateSourceParam(AudioSource src, AudioParam param) { checkDead(); synchronized (threadLock) { @@ -648,6 +700,7 @@ public class ALAudioRenderer implements AudioRenderer, Runnable { private boolean fillStreamingSource(int sourceId, AudioStream stream, boolean looping) { boolean success = false; int processed = al.alGetSourcei(sourceId, AL_BUFFERS_PROCESSED); + int unqueuedBufferBytes = 0; for (int i = 0; i < processed; i++) { int buffer; @@ -656,6 +709,11 @@ public class ALAudioRenderer implements AudioRenderer, Runnable { al.alSourceUnqueueBuffers(sourceId, 1, ib); buffer = ib.get(0); + // XXX: assume that reading from AudioStream always + // gives BUFFER_SIZE amount of bytes! This might not always + // be the case... + unqueuedBufferBytes += BUFFER_SIZE; + boolean active = fillBuffer(stream, buffer); if (!active && !stream.isEOF()) { @@ -682,6 +740,8 @@ public class ALAudioRenderer implements AudioRenderer, Runnable { break; } } + + stream.setUnqueuedBufferBytes(stream.getUnqueuedBufferBytes() + unqueuedBufferBytes); return success; } From a4e1aa450ddebf6d5b12feb11be6dd82b1ff7c98 Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Thu, 30 Apr 2015 09:57:46 -0400 Subject: [PATCH 070/113] README: Add build status image --- README.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index b3f993569..29161ffa4 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,8 @@ -jMonkeyEngine +jMonkeyEngine ============= +[![Build Status](https://travis-ci.org/jMonkeyEngine/jmonkeyengine.svg?branch=master)](https://travis-ci.org/jMonkeyEngine/jmonkeyengine) + jMonkeyEngine is a 3D game engine for adventurous Java developers. It’s open source, cross platform and cutting edge. And it is all beautifully documented. The 3.0 branch is the latest stable version of the jMonkeyEngine 3 SDK, a complete game development suite. We'll be frequently submitting stable 3.0.x updates until the major 3.1 version arrives. The engine is used by several commercial game studios and computer-science courses. Here's a taste: From a913d8e0c29b6c39a490ad88ac4c1036e9dfccad Mon Sep 17 00:00:00 2001 From: Maselbas Date: Thu, 30 Apr 2015 19:35:39 +0200 Subject: [PATCH 071/113] SDK Scenecomposer : now right clicking will cancel current transformation for the Scale, Rotate and Move Tool, looks like the selectTools shortcut - improved these tool feedback, its easier to begin the tranformation as its start on the first click instead of the first dragg --- .../gde/scenecomposer/tools/MoveTool.java | 101 ++++++++++------- .../gde/scenecomposer/tools/RotateTool.java | 79 +++++++------ .../gde/scenecomposer/tools/ScaleTool.java | 106 ++++++++++-------- 3 files changed, 164 insertions(+), 122 deletions(-) diff --git a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/MoveTool.java b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/MoveTool.java index a553f35f2..b3a48a6f6 100644 --- a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/MoveTool.java +++ b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/MoveTool.java @@ -60,11 +60,44 @@ public class MoveTool extends SceneEditTool { wasDragging = false; } pickManager.reset(); + } else { + if (toolController.getSelectedSpatial() == null) { + return; + } + + if (pickedMarker == null) { + pickedMarker = pickAxisMarker(camera, screenCoord, axisPickType); + if (pickedMarker == null) { + return; + } + + if (pickedMarker.equals(QUAD_XY)) { + pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_XY, getTransformType(), camera, screenCoord); + } else if (pickedMarker.equals(QUAD_XZ)) { + pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_XZ, getTransformType(), camera, screenCoord); + } else if (pickedMarker.equals(QUAD_YZ)) { + pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_YZ, getTransformType(), camera, screenCoord); + } else if (pickedMarker.equals(ARROW_X)) { + pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_XY, getTransformType(), camera, screenCoord); + constraintAxis = Vector3f.UNIT_X; // move only X + } else if (pickedMarker.equals(ARROW_Y)) { + pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_YZ, getTransformType(), camera, screenCoord); + constraintAxis = Vector3f.UNIT_Y; // move only Y + } else if (pickedMarker.equals(ARROW_Z)) { + pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_XZ, getTransformType(), camera, screenCoord); + constraintAxis = Vector3f.UNIT_Z; // move only Z + } + startPosition = toolController.getSelectedSpatial().getLocalTranslation().clone(); + wasDragging = true; + } } } @Override public void actionSecondary(Vector2f screenCoord, boolean pressed, JmeNode rootNode, DataObject dataObject) { + if (pressed) { + cancel(); + } } @Override @@ -89,58 +122,40 @@ public class MoveTool extends SceneEditTool { wasDragging = false; } pickManager.reset(); - return; - } - - if (toolController.getSelectedSpatial() == null) { - return; - } - - if (pickedMarker == null) { - pickedMarker = pickAxisMarker(camera, screenCoord, axisPickType); - if (pickedMarker == null) { + } else if (wasDragging == true) { + if (!pickManager.updatePick(camera, screenCoord)) { return; } + Vector3f diff = Vector3f.ZERO; + if (pickedMarker.equals(QUAD_XY) || pickedMarker.equals(QUAD_XZ) || pickedMarker.equals(QUAD_YZ)) { + diff = pickManager.getTranslation(); - if (pickedMarker.equals(QUAD_XY)) { - pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_XY, getTransformType(), camera, screenCoord); - } else if (pickedMarker.equals(QUAD_XZ)) { - pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_XZ, getTransformType(), camera, screenCoord); - } else if (pickedMarker.equals(QUAD_YZ)) { - pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_YZ, getTransformType(), camera, screenCoord); - } else if (pickedMarker.equals(ARROW_X)) { - pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_XY, getTransformType(), camera, screenCoord); - constraintAxis = Vector3f.UNIT_X; // move only X - } else if (pickedMarker.equals(ARROW_Y)) { - pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_YZ, getTransformType(), camera, screenCoord); - constraintAxis = Vector3f.UNIT_Y; // move only Y - } else if (pickedMarker.equals(ARROW_Z)) { - pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_XZ, getTransformType(), camera, screenCoord); - constraintAxis = Vector3f.UNIT_Z; // move only Z + } else if (pickedMarker.equals(ARROW_X) || pickedMarker.equals(ARROW_Y) || pickedMarker.equals(ARROW_Z)) { + diff = pickManager.getTranslation(constraintAxis); } - startPosition = toolController.getSelectedSpatial().getLocalTranslation().clone(); - - } - if (!pickManager.updatePick(camera, screenCoord)) { - return; - } - Vector3f diff = Vector3f.ZERO; - if (pickedMarker.equals(QUAD_XY) || pickedMarker.equals(QUAD_XZ) || pickedMarker.equals(QUAD_YZ)) { - diff = pickManager.getTranslation(); - - } else if (pickedMarker.equals(ARROW_X) || pickedMarker.equals(ARROW_Y) || pickedMarker.equals(ARROW_Z)) { - diff = pickManager.getTranslation(constraintAxis); + Vector3f position = startPosition.add(diff); + lastPosition = position; + toolController.getSelectedSpatial().setLocalTranslation(position); + updateToolsTransformation(); } - Vector3f position = startPosition.add(diff); - lastPosition = position; - toolController.getSelectedSpatial().setLocalTranslation(position); - updateToolsTransformation(); - - wasDragging = true; } @Override public void draggedSecondary(Vector2f screenCoord, boolean pressed, JmeNode rootNode, DataObject currentDataObject) { + if (pressed) { + cancel(); + } + } + + private void cancel() { + if (wasDragging) { + wasDragging = false; + toolController.getSelectedSpatial().setLocalTranslation(startPosition); + setDefaultAxisMarkerColors(); + pickedMarker = null; // mouse released, reset selection + constraintAxis = Vector3f.UNIT_XYZ; // no constraint + pickManager.reset(); + } } protected class MoveUndo extends AbstractUndoableSceneEdit { diff --git a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/RotateTool.java b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/RotateTool.java index c43ae52d0..58c69f516 100644 --- a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/RotateTool.java +++ b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/RotateTool.java @@ -53,12 +53,36 @@ public class RotateTool extends SceneEditTool { actionPerformed(new ScaleUndo(toolController.getSelectedSpatial(), startRotate, lastRotate)); wasDragging = false; } + pickManager.reset(); + } else { + if (toolController.getSelectedSpatial() == null) { + return; + } + + if (pickedMarker == null) { + pickedMarker = pickAxisMarker(camera, screenCoord, axisPickType); + if (pickedMarker == null) { + return; + } + + if (pickedMarker.equals(QUAD_XY)) { + pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_XY, getTransformType(), camera, screenCoord); + } else if (pickedMarker.equals(QUAD_XZ)) { + pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_XZ, getTransformType(), camera, screenCoord); + } else if (pickedMarker.equals(QUAD_YZ)) { + pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_YZ, getTransformType(), camera, screenCoord); + } + startRotate = toolController.getSelectedSpatial().getLocalRotation().clone(); + wasDragging = true; + } } } @Override public void actionSecondary(Vector2f screenCoord, boolean pressed, JmeNode rootNode, DataObject dataObject) { - + if (pressed) { + cancel(); + } } @Override @@ -67,12 +91,12 @@ public class RotateTool extends SceneEditTool { highlightAxisMarker(camera, screenCoord, axisPickType); } else { pickedMarker = null; + pickManager.reset(); } } @Override public void draggedPrimary(Vector2f screenCoord, boolean pressed, JmeNode rootNode, DataObject currentDataObject) { - if (!pressed) { setDefaultAxisMarkerColors(); pickedMarker = null; // mouse released, reset selection @@ -82,45 +106,36 @@ public class RotateTool extends SceneEditTool { actionPerformed(new ScaleUndo(toolController.getSelectedSpatial(), startRotate, lastRotate)); wasDragging = false; } - return; - } - - if (toolController.getSelectedSpatial() == null) { - return; - } - - if (pickedMarker == null) { - pickedMarker = pickAxisMarker(camera, screenCoord, axisPickType); - if (pickedMarker == null) { + pickManager.reset(); + } else if (wasDragging) { + if (!pickManager.updatePick(camera, screenCoord)) { return; } - if (pickedMarker.equals(QUAD_XY)) { - pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_XY, getTransformType(), camera, screenCoord); - } else if (pickedMarker.equals(QUAD_XZ)) { - pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_XZ, getTransformType(), camera, screenCoord); - } else if (pickedMarker.equals(QUAD_YZ)) { - pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_YZ, getTransformType(), camera, screenCoord); + if (pickedMarker.equals(QUAD_XY) || pickedMarker.equals(QUAD_XZ) || pickedMarker.equals(QUAD_YZ)) { + Quaternion rotation = startRotate.mult(pickManager.getLocalRotation()); + toolController.getSelectedSpatial().setLocalRotation(rotation); + lastRotate = rotation; } - startRotate = toolController.getSelectedSpatial().getLocalRotation().clone(); - } - if (!pickManager.updatePick(camera, screenCoord)) { - return; - } - - if (pickedMarker.equals(QUAD_XY) || pickedMarker.equals(QUAD_XZ) || pickedMarker.equals(QUAD_YZ)) { - Quaternion rotation = startRotate.mult(pickManager.getLocalRotation()); - toolController.getSelectedSpatial().setLocalRotation(rotation); - lastRotate = rotation; + updateToolsTransformation(); } - updateToolsTransformation(); - wasDragging = true; } @Override - public - void draggedSecondary(Vector2f screenCoord, boolean pressed, JmeNode rootNode, DataObject currentDataObject) { + public void draggedSecondary(Vector2f screenCoord, boolean pressed, JmeNode rootNode, DataObject currentDataObject) { + if (pressed) { + cancel(); + } + } + private void cancel() { + if (wasDragging) { + wasDragging = false; + toolController.getSelectedSpatial().setLocalRotation(startRotate); + setDefaultAxisMarkerColors(); + pickedMarker = null; // mouse released, reset selection + pickManager.reset(); + } } private class ScaleUndo extends AbstractUndoableSceneEdit { diff --git a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/ScaleTool.java b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/ScaleTool.java index edde41a24..a34478372 100644 --- a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/ScaleTool.java +++ b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/ScaleTool.java @@ -39,7 +39,7 @@ public class ScaleTool extends SceneEditTool { @Override public void activate(AssetManager manager, Node toolNode, Node onTopToolNode, Spatial selectedSpatial, SceneComposerToolController toolController) { super.activate(manager, toolNode, onTopToolNode, selectedSpatial, toolController); - pickManager = Lookup.getDefault().lookup(PickManager.class); + pickManager = Lookup.getDefault().lookup(PickManager.class); displayPlanes(); } @@ -54,12 +54,40 @@ public class ScaleTool extends SceneEditTool { wasDragging = false; } pickManager.reset(); + } else { + if (toolController.getSelectedSpatial() == null) { + return; + } + if (pickedMarker == null) { + pickedMarker = pickAxisMarker(camera, screenCoord, axisPickType); + if (pickedMarker == null) { + return; + } + + if (pickedMarker.equals(QUAD_XY) || pickedMarker.equals(QUAD_XZ) || pickedMarker.equals(QUAD_YZ)) { + pickManager.initiatePick(toolController.getSelectedSpatial(), camera.getRotation(), + SceneComposerToolController.TransformationType.camera, camera, screenCoord); + } else if (pickedMarker.equals(ARROW_X)) { + pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_XY, getTransformType(), camera, screenCoord); + constraintAxis = Vector3f.UNIT_X; // scale only X + } else if (pickedMarker.equals(ARROW_Y)) { + pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_YZ, getTransformType(), camera, screenCoord); + constraintAxis = Vector3f.UNIT_Y; // scale only Y + } else if (pickedMarker.equals(ARROW_Z)) { + pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_XZ, getTransformType(), camera, screenCoord); + constraintAxis = Vector3f.UNIT_Z; // scale only Z + } + startScale = toolController.getSelectedSpatial().getLocalScale().clone(); + wasDragging = true; + } } } @Override public void actionSecondary(Vector2f screenCoord, boolean pressed, JmeNode rootNode, DataObject dataObject) { - + if (pressed) { + cancel(); + } } @Override @@ -83,61 +111,45 @@ public class ScaleTool extends SceneEditTool { wasDragging = false; } pickManager.reset(); - return; - } - - if (toolController.getSelectedSpatial() == null) { - return; - } - if (pickedMarker == null) { - pickedMarker = pickAxisMarker(camera, screenCoord, axisPickType); - if (pickedMarker == null) { + } else if (wasDragging) { + if (!pickManager.updatePick(camera, screenCoord)) { return; } - if (pickedMarker.equals(QUAD_XY) || pickedMarker.equals(QUAD_XZ) || pickedMarker.equals(QUAD_YZ)) { - pickManager.initiatePick(toolController.getSelectedSpatial(), camera.getRotation(), - SceneComposerToolController.TransformationType.camera, camera, screenCoord); - } else if (pickedMarker.equals(ARROW_X)) { - pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_XY, getTransformType(), camera, screenCoord); - constraintAxis = Vector3f.UNIT_X; // scale only X - } else if (pickedMarker.equals(ARROW_Y)) { - pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_YZ, getTransformType(), camera, screenCoord); - constraintAxis = Vector3f.UNIT_Y; // scale only Y - } else if (pickedMarker.equals(ARROW_Z)) { - pickManager.initiatePick(toolController.getSelectedSpatial(), PickManager.PLANE_XZ, getTransformType(), camera, screenCoord); - constraintAxis = Vector3f.UNIT_Z; // scale only Z + constraintAxis = pickManager.getStartOffset().normalize(); + float diff = pickManager.getTranslation(constraintAxis).dot(constraintAxis); + diff *= 0.5f; + Vector3f scale = startScale.add(new Vector3f(diff, diff, diff)); + lastScale = scale; + toolController.getSelectedSpatial().setLocalScale(scale); + } else if (pickedMarker.equals(ARROW_X) || pickedMarker.equals(ARROW_Y) || pickedMarker.equals(ARROW_Z)) { + // Get the translation in the spatial Space + Quaternion worldToSpatial = toolController.getSelectedSpatial().getWorldRotation().inverse(); + Vector3f diff = pickManager.getTranslation(worldToSpatial.mult(constraintAxis)); + diff.multLocal(0.5f); + Vector3f scale = startScale.add(diff); + lastScale = scale; + toolController.getSelectedSpatial().setLocalScale(scale); } - startScale = toolController.getSelectedSpatial().getLocalScale().clone(); - } - - if (!pickManager.updatePick(camera, screenCoord)) { - return; + updateToolsTransformation(); } - if (pickedMarker.equals(QUAD_XY) || pickedMarker.equals(QUAD_XZ) || pickedMarker.equals(QUAD_YZ)) { - constraintAxis = pickManager.getStartOffset().normalize(); - float diff = pickManager.getTranslation(constraintAxis).dot(constraintAxis); - diff *= 0.5f; - Vector3f scale = startScale.add(new Vector3f(diff, diff, diff)); - lastScale = scale; - toolController.getSelectedSpatial().setLocalScale(scale); - } else if (pickedMarker.equals(ARROW_X) || pickedMarker.equals(ARROW_Y) || pickedMarker.equals(ARROW_Z)) { - // Get the translation in the spatial Space - Quaternion worldToSpatial = toolController.getSelectedSpatial().getWorldRotation().inverse(); - Vector3f diff = pickManager.getTranslation(worldToSpatial.mult(constraintAxis)); - diff.multLocal(0.5f); - Vector3f scale = startScale.add(diff); - lastScale = scale; - toolController.getSelectedSpatial().setLocalScale(scale); - } - updateToolsTransformation(); - - wasDragging = true; } @Override public void draggedSecondary(Vector2f screenCoord, boolean pressed, JmeNode rootNode, DataObject currentDataObject) { + if (pressed) { + cancel(); + } + } + private void cancel() { + if (wasDragging) { + wasDragging = false; + toolController.getSelectedSpatial().setLocalScale(startScale); + setDefaultAxisMarkerColors(); + pickedMarker = null; // mouse released, reset selection + pickManager.reset(); + } } private class ScaleUndo extends AbstractUndoableSceneEdit { From 57dbf384a260aaa83903e76f21f38d87ec997114 Mon Sep 17 00:00:00 2001 From: Paul Speed Date: Fri, 1 May 2015 02:15:41 -0400 Subject: [PATCH 072/113] Modified the DefaultServer to send a second client info message to indicate that all of the local hosted services have been notified about the new connection. Modified DefaultClient to wait to start its services until it has seen this second message. Client services may want to send things to the server during their start() method but it's important that things like the serializer registry service has already processed its messages or any sends might fail. The client generally has the luxury of being able to register handlers/listeners/etc during initialize where as the server must do this when the connection arrives. So it seems reasonable to delay client service start() until all of the server-side hosted services have had a chance to initialize themselves. --- .../com/jme3/network/base/DefaultClient.java | 31 ++++++++++++++----- .../com/jme3/network/base/DefaultServer.java | 9 +++++- 2 files changed, 31 insertions(+), 9 deletions(-) diff --git a/jme3-networking/src/main/java/com/jme3/network/base/DefaultClient.java b/jme3-networking/src/main/java/com/jme3/network/base/DefaultClient.java index c0cc2e616..b297a933b 100644 --- a/jme3-networking/src/main/java/com/jme3/network/base/DefaultClient.java +++ b/jme3-networking/src/main/java/com/jme3/network/base/DefaultClient.java @@ -177,6 +177,10 @@ public class DefaultClient implements Client continue; send(ch, reg, false); } + } + + public boolean isStarted() { + return isRunning; } protected void waitForConnected() @@ -351,13 +355,16 @@ public class DefaultClient implements Client protected void fireConnected() { - // Let the services know we are finally started - services.start(); - for( ClientStateListener l : stateListeners ) { l.clientConnected( this ); } } + + protected void startServices() + { + // Let the services know we are finally started + services.start(); + } protected void fireDisconnected( DisconnectInfo info ) { @@ -416,11 +423,19 @@ public class DefaultClient implements Client // Pull off the connection management messages we're // interested in and then pass on the rest. if( m instanceof ClientRegistrationMessage ) { - // Then we've gotten our real id - this.id = (int)((ClientRegistrationMessage)m).getId(); - log.log( Level.FINE, "Connection established, id:{0}.", this.id ); - connecting.countDown(); - fireConnected(); + ClientRegistrationMessage crm = (ClientRegistrationMessage)m; + // See if it has a real ID + if( crm.getId() >= 0 ) { + // Then we've gotten our real id + this.id = (int)crm.getId(); + log.log( Level.FINE, "Connection established, id:{0}.", this.id ); + connecting.countDown(); + fireConnected(); + } else { + // Else it's a message letting us know that the + // hosted services have been started + startServices(); + } return; } else if( m instanceof ChannelInfoMessage ) { // This is an interum step in the connection process and diff --git a/jme3-networking/src/main/java/com/jme3/network/base/DefaultServer.java b/jme3-networking/src/main/java/com/jme3/network/base/DefaultServer.java index 0a9ac0ef1..97e36134e 100644 --- a/jme3-networking/src/main/java/com/jme3/network/base/DefaultServer.java +++ b/jme3-networking/src/main/java/com/jme3/network/base/DefaultServer.java @@ -412,7 +412,14 @@ public class DefaultServer implements Server // Now we can notify the listeners about the // new connection. - fireConnectionAdded( addedConnection ); + fireConnectionAdded( addedConnection ); + + // Send a second registration message with an invalid ID + // to let the connection know that it can start its services + m = new ClientRegistrationMessage(); + m.setId(-1); + m.setReliable(true); + addedConnection.send(m); } } From e000d83ae7a1bd0976ff36eff48bddac64a811cb Mon Sep 17 00:00:00 2001 From: Paul Speed Date: Fri, 1 May 2015 02:24:16 -0400 Subject: [PATCH 073/113] Fixed a stack overflow exception if one println()'ed a service... since most service managers print their services in their own toString(). --- .../src/main/java/com/jme3/network/service/AbstractService.java | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/jme3-networking/src/main/java/com/jme3/network/service/AbstractService.java b/jme3-networking/src/main/java/com/jme3/network/service/AbstractService.java index 84df3d81b..370b1c5af 100644 --- a/jme3-networking/src/main/java/com/jme3/network/service/AbstractService.java +++ b/jme3-networking/src/main/java/com/jme3/network/service/AbstractService.java @@ -106,6 +106,6 @@ public abstract class AbstractService implements Servi @Override public String toString() { - return getClass().getName() + "[serviceManager=" + serviceManager + "]"; + return getClass().getName() + "[serviceManager.class=" + serviceManager.getClass() + "]"; } } From a77ed5277790ad693cf77c5886baadaa0499309d Mon Sep 17 00:00:00 2001 From: Paul Speed Date: Fri, 1 May 2015 02:24:52 -0400 Subject: [PATCH 074/113] Added getServer() and getClient() convenience methods. --- .../jme3/network/service/AbstractClientService.java | 10 ++++++++++ .../jme3/network/service/AbstractHostedService.java | 9 +++++++++ 2 files changed, 19 insertions(+) diff --git a/jme3-networking/src/main/java/com/jme3/network/service/AbstractClientService.java b/jme3-networking/src/main/java/com/jme3/network/service/AbstractClientService.java index bd1836451..d1a848dac 100644 --- a/jme3-networking/src/main/java/com/jme3/network/service/AbstractClientService.java +++ b/jme3-networking/src/main/java/com/jme3/network/service/AbstractClientService.java @@ -32,6 +32,7 @@ package com.jme3.network.service; +import com.jme3.network.Client; /** * Convenient base class for ClientServices providing some default ClientService @@ -48,4 +49,13 @@ public abstract class AbstractClientService extends AbstractService Date: Fri, 1 May 2015 02:25:24 -0400 Subject: [PATCH 075/113] Added a getRpcConnection() method to expose the underlying RPC support. --- .../com/jme3/network/service/rpc/RpcClientService.java | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/jme3-networking/src/main/java/com/jme3/network/service/rpc/RpcClientService.java b/jme3-networking/src/main/java/com/jme3/network/service/rpc/RpcClientService.java index d9ea134e1..a74a7c7d1 100644 --- a/jme3-networking/src/main/java/com/jme3/network/service/rpc/RpcClientService.java +++ b/jme3-networking/src/main/java/com/jme3/network/service/rpc/RpcClientService.java @@ -60,6 +60,15 @@ public class RpcClientService extends AbstractClientService { public RpcClientService() { } + /** + * Returns the underlying RPC connection for use by other + * services that may require a more generic non-client/server + * specific RPC object with which to interact. + */ + public RpcConnection getRpcConnection() { + return rpc; + } + /** * Used internally to setup the RpcConnection and MessageDelegator. */ From 33d21c2de354374e36f85ba820d8022e79ab4b39 Mon Sep 17 00:00:00 2001 From: Paul Speed Date: Fri, 1 May 2015 02:26:33 -0400 Subject: [PATCH 076/113] Added an isStarted() method to Client. --- jme3-networking/src/main/java/com/jme3/network/Client.java | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/jme3-networking/src/main/java/com/jme3/network/Client.java b/jme3-networking/src/main/java/com/jme3/network/Client.java index dd9873238..3ef9134df 100644 --- a/jme3-networking/src/main/java/com/jme3/network/Client.java +++ b/jme3-networking/src/main/java/com/jme3/network/Client.java @@ -55,6 +55,12 @@ public interface Client extends MessageConnection */ public boolean isConnected(); + /** + * Returns true if this client has been started and is still + * running. + */ + public boolean isStarted(); + /** * Returns a unique ID for this client within the remote * server or -1 if this client isn't fully connected to the From 82f031cdff495d70e81b041e1bbd80c0b9dbd110 Mon Sep 17 00:00:00 2001 From: Maselbas Date: Fri, 1 May 2015 19:25:14 +0200 Subject: [PATCH 077/113] SDK SceneComposer : fixed the rotate tool, now all works fine, Great Success ! --- .../gde/scenecomposer/tools/PickManager.java | 44 +++++++++++-------- .../gde/scenecomposer/tools/RotateTool.java | 2 +- 2 files changed, 27 insertions(+), 19 deletions(-) diff --git a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/PickManager.java b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/PickManager.java index fc0032edb..22fa8478a 100644 --- a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/PickManager.java +++ b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/PickManager.java @@ -32,7 +32,7 @@ public class PickManager { private final Node plane; private Spatial spatial; private SceneComposerToolController.TransformationType transformationType; - + protected static final Quaternion PLANE_XY = new Quaternion().fromAngleAxis(0, new Vector3f(1, 0, 0)); protected static final Quaternion PLANE_YZ = new Quaternion().fromAngleAxis(-FastMath.PI / 2, new Vector3f(0, 1, 0));//YAW090 protected static final Quaternion PLANE_XZ = new Quaternion().fromAngleAxis(FastMath.PI / 2, new Vector3f(1, 0, 0)); //PITCH090 @@ -57,13 +57,13 @@ public class PickManager { spatial = selectedSpatial; startSpatialLocation = selectedSpatial.getWorldTranslation().clone(); - setTransformation(planeRotation, type); + setTransformation(planeRotation, type, camera); plane.setLocalTranslation(startSpatialLocation); startPickLoc = SceneEditTool.pickWorldLocation(camera, screenCoord, plane, null); } - public void setTransformation(Quaternion planeRotation, SceneComposerToolController.TransformationType type) { + public void setTransformation(Quaternion planeRotation, SceneComposerToolController.TransformationType type, Camera camera) { Quaternion rot = new Quaternion(); transformationType = type; if (transformationType == SceneComposerToolController.TransformationType.local) { @@ -74,12 +74,18 @@ public class PickManager { rot.set(planeRotation); origineRotation = new Quaternion(Quaternion.IDENTITY); } else if (transformationType == SceneComposerToolController.TransformationType.camera) { - rot.set(planeRotation); - origineRotation = planeRotation.clone(); + rot.set(camera.getRotation()); + origineRotation = camera.getRotation().clone(); } plane.setLocalRotation(rot); } - + + /** + * + * @param camera + * @param screenCoord + * @return true if the the new picked location is set, else return false. + */ public boolean updatePick(Camera camera, Vector2f screenCoord) { if(transformationType == SceneComposerToolController.TransformationType.camera){ origineRotation = camera.getRotation(); @@ -131,23 +137,26 @@ public class PickManager { * @return the Quaternion rotation in the WorldSpace */ public Quaternion getRotation() { - Vector3f v1, v2; - v1 = startPickLoc.subtract(startSpatialLocation).normalize(); - v2 = finalPickLoc.subtract(startSpatialLocation).normalize(); - Vector3f axis = v1.cross(v2); - float angle = v1.angleBetween(v2); - return new Quaternion().fromAngleAxis(angle, axis); + return getRotation(Quaternion.IDENTITY); } /** - * + * * @return the Quaternion rotation in the ToolSpace */ public Quaternion getLocalRotation() { + return getRotation(origineRotation.inverse()); + } + + /** + * Get the Rotation into a specific custom space. + * @param transforme the rotation to the custom space (World to Custom space) + * @return the Rotation in the custom space + */ + public Quaternion getRotation(Quaternion transforme) { Vector3f v1, v2; - Quaternion rot = origineRotation.inverse(); - v1 = rot.mult(startPickLoc.subtract(startSpatialLocation).normalize()); - v2 = rot.mult(finalPickLoc.subtract(startSpatialLocation).normalize()); + v1 = transforme.mult(startPickLoc.subtract(startSpatialLocation).normalize()); + v2 = transforme.mult(finalPickLoc.subtract(startSpatialLocation).normalize()); Vector3f axis = v1.cross(v2); float angle = v1.angleBetween(v2); return new Quaternion().fromAngleAxis(angle, axis); @@ -178,8 +187,7 @@ public class PickManager { * @return */ public Vector3f getLocalTranslation(Vector3f axisConstrainte) { - //return plane.getWorldRotation().inverse().mult(getTranslation(axisConstrainte)); return getTranslation(origineRotation.inverse().mult(axisConstrainte)); } - + } diff --git a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/RotateTool.java b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/RotateTool.java index 58c69f516..21e9a56d8 100644 --- a/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/RotateTool.java +++ b/sdk/jme3-scenecomposer/src/com/jme3/gde/scenecomposer/tools/RotateTool.java @@ -113,7 +113,7 @@ public class RotateTool extends SceneEditTool { } if (pickedMarker.equals(QUAD_XY) || pickedMarker.equals(QUAD_XZ) || pickedMarker.equals(QUAD_YZ)) { - Quaternion rotation = startRotate.mult(pickManager.getLocalRotation()); + Quaternion rotation = startRotate.mult(pickManager.getRotation(startRotate.inverse())); toolController.getSelectedSpatial().setLocalRotation(rotation); lastRotate = rotation; } From c93c746b8b9715d2daee50c4a4b9d726bb614a31 Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Fri, 1 May 2015 19:50:30 -0400 Subject: [PATCH 078/113] Travis-CI: display success notification on status change --- .travis.yml | 2 ++ 1 file changed, 2 insertions(+) diff --git a/.travis.yml b/.travis.yml index 2e93aa23c..8a29bd1f8 100644 --- a/.travis.yml +++ b/.travis.yml @@ -15,6 +15,8 @@ branches: notifications: slack: secure: "PWEk4+VL986c3gAjWp12nqyifvxCjBqKoESG9d7zWh1uiTLadTHhZJRMdsye36FCpz/c/Jt7zCRO/5y7FaubQptnRrkrRfjp5f99MJRzQVXnUAM+y385qVkXKRKd/PLpM7XPm4AvjvxHCyvzX2wamRvul/TekaXKB9Ti5FCN87s=" + on_success: change + on_failure: always before_install: # required libs for android build tools From c1dc81995334532d2671fe94d5052d0974fb0a44 Mon Sep 17 00:00:00 2001 From: Paul Speed Date: Sat, 2 May 2015 00:35:15 -0400 Subject: [PATCH 079/113] Added the ability to put the serializer registry in "read only" mode. Modified the SerializerRegistrationMessage to put the serializer registry into read only after it compiles the message so that the server won't accidentally register messages after they've been compiled. --- .../SerializerRegistrationsMessage.java | 4 +++- .../jme3/network/serializing/Serializer.java | 22 ++++++++++++++++++- 2 files changed, 24 insertions(+), 2 deletions(-) diff --git a/jme3-networking/src/main/java/com/jme3/network/message/SerializerRegistrationsMessage.java b/jme3-networking/src/main/java/com/jme3/network/message/SerializerRegistrationsMessage.java index da7f2a7cf..9c3896475 100644 --- a/jme3-networking/src/main/java/com/jme3/network/message/SerializerRegistrationsMessage.java +++ b/jme3-networking/src/main/java/com/jme3/network/message/SerializerRegistrationsMessage.java @@ -127,7 +127,9 @@ public class SerializerRegistrationsMessage extends AbstractMessage { } compiled = list.toArray(new Registration[list.size()]); - INSTANCE = new SerializerRegistrationsMessage(compiled); + INSTANCE = new SerializerRegistrationsMessage(compiled); + + Serializer.setReadOnly(true); } public void registerAll() { diff --git a/jme3-networking/src/main/java/com/jme3/network/serializing/Serializer.java b/jme3-networking/src/main/java/com/jme3/network/serializing/Serializer.java index a7d20da54..d4c054403 100644 --- a/jme3-networking/src/main/java/com/jme3/network/serializing/Serializer.java +++ b/jme3-networking/src/main/java/com/jme3/network/serializing/Serializer.java @@ -71,6 +71,8 @@ public abstract class Serializer { private static boolean strictRegistration = true; + private static volatile boolean locked = false; + // Registers the classes we already have serializers for. static { @@ -168,6 +170,20 @@ public abstract class Serializer { return nextAvailableId--; } + /** + * Can put the registry in a read-only state such that additional attempts + * to register classes will fail. This can be used by servers to lock the + * registry to avoid accidentally registering classes after a full registry + * set has been compiled. + */ + public static void setReadOnly( boolean b ) { + locked = b; + } + + public static boolean isReadOnly() { + return locked; + } + /** * Directly registers a class for a specific ID. Generally, use the regular * registerClass() method. This method is intended for framework code that might @@ -175,7 +191,11 @@ public abstract class Serializer { */ public static SerializerRegistration registerClassForId( short id, Class cls, Serializer serializer ) { - SerializerRegistration reg = new SerializerRegistration(serializer, cls, id); + if( locked ) { + throw new RuntimeException("Serializer registry locked trying to register class:" + cls); + } + + SerializerRegistration reg = new SerializerRegistration(serializer, cls, id); idRegistrations.put(id, reg); classRegistrations.put(cls, reg); From 58313c271db3e78c6e1f0470108ba3d095bbbae5 Mon Sep 17 00:00:00 2001 From: Paul Speed Date: Sat, 2 May 2015 00:38:24 -0400 Subject: [PATCH 080/113] Added a better comment as to why we have to check the channels even though the negative channels would pass through as the default channels just fine. The key is avoiding UDP calls... they will get translated into a regular send. --- .../java/com/jme3/network/service/rpc/RpcConnection.java | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/jme3-networking/src/main/java/com/jme3/network/service/rpc/RpcConnection.java b/jme3-networking/src/main/java/com/jme3/network/service/rpc/RpcConnection.java index b78316bf3..f457e426b 100644 --- a/jme3-networking/src/main/java/com/jme3/network/service/rpc/RpcConnection.java +++ b/jme3-networking/src/main/java/com/jme3/network/service/rpc/RpcConnection.java @@ -115,8 +115,13 @@ public class RpcConnection { if( log.isLoggable(Level.FINEST) ) { log.log(Level.FINEST, "Sending:{0} on channel:{1}", new Object[]{msg, channel}); - } - if( channel >= 0 ) { + } + + // Prevent non-async messages from being send as UDP + // because there is a high probabilty that this would block + // forever waiting for a response. For async calls it's ok + // so it doesn't do the check. + if( channel >= 0 ) { connection.send(channel, msg); } else { connection.send(msg); From c1670e75098a1da8c8e5578abe1e611636cbdc8e Mon Sep 17 00:00:00 2001 From: Paul Speed Date: Sat, 2 May 2015 00:39:41 -0400 Subject: [PATCH 081/113] Added the read class ID to the bad deserialize exception. Two things can cause bad reads: 1) bad data in the stream... in which the extra info is useless or confusing. 2) unregistered classes or bad timing, either way, knowing the message type ID might be useful. --- .../src/main/java/com/jme3/network/base/MessageProtocol.java | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/jme3-networking/src/main/java/com/jme3/network/base/MessageProtocol.java b/jme3-networking/src/main/java/com/jme3/network/base/MessageProtocol.java index a8d0d39fd..6751ecc3f 100644 --- a/jme3-networking/src/main/java/com/jme3/network/base/MessageProtocol.java +++ b/jme3-networking/src/main/java/com/jme3/network/base/MessageProtocol.java @@ -181,7 +181,7 @@ public class MessageProtocol Message m = (Message)obj; messages.add(m); } catch( IOException e ) { - throw new RuntimeException( "Error deserializing object", e ); + throw new RuntimeException( "Error deserializing object, clas ID:" + buffer.getShort(0), e ); } } } From 42105f4c4ba8ced7102ae5f30aa43642d359cd0f Mon Sep 17 00:00:00 2001 From: Paul Speed Date: Sat, 2 May 2015 00:41:47 -0400 Subject: [PATCH 082/113] Just some whitespace changes. --- .../src/main/java/com/jme3/network/base/DefaultServer.java | 2 +- .../src/main/java/com/jme3/network/kernel/udp/UdpConnector.java | 2 -- 2 files changed, 1 insertion(+), 3 deletions(-) diff --git a/jme3-networking/src/main/java/com/jme3/network/base/DefaultServer.java b/jme3-networking/src/main/java/com/jme3/network/base/DefaultServer.java index 97e36134e..2b9add2ef 100644 --- a/jme3-networking/src/main/java/com/jme3/network/base/DefaultServer.java +++ b/jme3-networking/src/main/java/com/jme3/network/base/DefaultServer.java @@ -223,7 +223,7 @@ public class DefaultServer implements Server { if( connections.isEmpty() ) return; - + ByteBuffer buffer = MessageProtocol.messageToBuffer(message, null); FilterAdapter adapter = filter == null ? null : new FilterAdapter(filter); diff --git a/jme3-networking/src/main/java/com/jme3/network/kernel/udp/UdpConnector.java b/jme3-networking/src/main/java/com/jme3/network/kernel/udp/UdpConnector.java index 20682ecee..bf0f7ddb1 100644 --- a/jme3-networking/src/main/java/com/jme3/network/kernel/udp/UdpConnector.java +++ b/jme3-networking/src/main/java/com/jme3/network/kernel/udp/UdpConnector.java @@ -113,7 +113,6 @@ public class UdpConnector implements Connector public ByteBuffer read() { checkClosed(); - try { DatagramPacket packet = new DatagramPacket( buffer, buffer.length ); sock.receive(packet); @@ -132,7 +131,6 @@ public class UdpConnector implements Connector public void write( ByteBuffer data ) { checkClosed(); - try { DatagramPacket p = new DatagramPacket( data.array(), data.position(), data.remaining(), remoteAddress ); From 0a0fdca0b4207c788087e355aea8f1bf5559de65 Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Sat, 2 May 2015 15:21:32 -0400 Subject: [PATCH 083/113] ImageRaster: add mipmap access & gamma correction * Remove deprecated image raster methods from JmeSystem * Allow ImageRaster to read / write to arbitrary mipmaps * Allow ImageRaster to perform conversion to / from linear color space as required --- .../main/java/com/jme3/system/JmeSystem.java | 9 ---- .../com/jme3/system/JmeSystemDelegate.java | 5 -- .../texture/image/DefaultImageRaster.java | 51 +++++++++++++++++-- .../com/jme3/texture/image/ImageRaster.java | 25 ++++++++- 4 files changed, 69 insertions(+), 21 deletions(-) diff --git a/jme3-core/src/main/java/com/jme3/system/JmeSystem.java b/jme3-core/src/main/java/com/jme3/system/JmeSystem.java index 1ec695388..51c2173fd 100644 --- a/jme3-core/src/main/java/com/jme3/system/JmeSystem.java +++ b/jme3-core/src/main/java/com/jme3/system/JmeSystem.java @@ -172,15 +172,6 @@ public class JmeSystem { return systemDelegate.getPlatformAssetConfigURL(); } - /** - * @deprecated Directly create an image raster via {@link DefaultImageRaster}. - */ - @Deprecated - public static ImageRaster createImageRaster(Image image, int slice) { - checkDelegate(); - return systemDelegate.createImageRaster(image, slice); - } - /** * Displays an error message to the user in whichever way the context * feels is appropriate. If this is a headless or an offscreen surface diff --git a/jme3-core/src/main/java/com/jme3/system/JmeSystemDelegate.java b/jme3-core/src/main/java/com/jme3/system/JmeSystemDelegate.java index a3f75bd9a..150275d46 100644 --- a/jme3-core/src/main/java/com/jme3/system/JmeSystemDelegate.java +++ b/jme3-core/src/main/java/com/jme3/system/JmeSystemDelegate.java @@ -132,11 +132,6 @@ public abstract class JmeSystemDelegate { return new DesktopAssetManager(null); } - @Deprecated - public final ImageRaster createImageRaster(Image image, int slice) { - return new DefaultImageRaster(image, slice); - } - public abstract void writeImageFile(OutputStream outStream, String format, ByteBuffer imageData, int width, int height) throws IOException; public abstract void showErrorDialog(String message); diff --git a/jme3-core/src/main/java/com/jme3/texture/image/DefaultImageRaster.java b/jme3-core/src/main/java/com/jme3/texture/image/DefaultImageRaster.java index 4cbfc3b57..c79a4675d 100644 --- a/jme3-core/src/main/java/com/jme3/texture/image/DefaultImageRaster.java +++ b/jme3-core/src/main/java/com/jme3/texture/image/DefaultImageRaster.java @@ -44,7 +44,9 @@ public class DefaultImageRaster extends ImageRaster { private final ImageCodec codec; private final int width; private final int height; + private final int offset; private final byte[] temp; + private final boolean convertToLinear; private int slice; private void rangeCheck(int x, int y) { @@ -53,13 +55,40 @@ public class DefaultImageRaster extends ImageRaster { } } - public DefaultImageRaster(Image image, int slice) { + public DefaultImageRaster(Image image, int slice, int mipMapLevel, boolean convertToLinear) { + int[] mipMapSizes = image.getMipMapSizes(); + int availableMips = mipMapSizes != null ? mipMapSizes.length : 1; + + if (mipMapLevel >= availableMips) { + throw new IllegalStateException("Cannot create image raster for mipmap level #" + mipMapLevel + ". " + + "Image only has " + availableMips + " mipmap levels."); + } + + if (image.hasMipmaps()) { + this.width = Math.max(1, image.getWidth() >> mipMapLevel); + this.height = Math.max(1, image.getHeight() >> mipMapLevel); + + int mipOffset = 0; + for (int i = 0; i < mipMapLevel; i++) { + mipOffset += mipMapSizes[i]; + } + + this.offset = mipOffset; + } else { + this.width = image.getWidth(); + this.height = image.getHeight(); + this.offset = 0; + } + this.image = image; this.slice = slice; + + // Conversion to linear only needed if image's color space is sRGB. + this.convertToLinear = convertToLinear && image.getColorSpace() == ColorSpace.sRGB; + this.buffer = image.getData(slice); this.codec = ImageCodec.lookup(image.getFormat()); - this.width = image.getWidth(); - this.height = image.getHeight(); + if (codec instanceof ByteAlignedImageCodec || codec instanceof ByteOffsetImageCodec) { this.temp = new byte[codec.bpp]; } else { @@ -86,6 +115,12 @@ public class DefaultImageRaster extends ImageRaster { public void setPixel(int x, int y, ColorRGBA color) { rangeCheck(x, y); + if (convertToLinear) { + // Input is linear, needs to be converted to sRGB before writing + // into image. + color = color.getAsSrgb(); + } + // Check flags for grayscale if (codec.isGray) { float gray = color.r * 0.27f + color.g * 0.67f + color.b * 0.06f; @@ -113,7 +148,7 @@ public class DefaultImageRaster extends ImageRaster { components[3] = Math.min( (int) (color.b * codec.maxBlue + 0.5f), codec.maxBlue); break; } - codec.writeComponents(getBuffer(), x, y, width, 0, components, temp); + codec.writeComponents(getBuffer(), x, y, width, offset, components, temp); image.setUpdateNeeded(); } @@ -128,7 +163,7 @@ public class DefaultImageRaster extends ImageRaster { public ColorRGBA getPixel(int x, int y, ColorRGBA store) { rangeCheck(x, y); - codec.readComponents(getBuffer(), x, y, width, 0, components, temp); + codec.readComponents(getBuffer(), x, y, width, offset, components, temp); if (store == null) { store = new ColorRGBA(); } @@ -169,6 +204,12 @@ public class DefaultImageRaster extends ImageRaster { store.a = 1; } } + + if (convertToLinear) { + // Input image is sRGB, need to convert to linear. + store.setAsSrgb(store.r, store.g, store.b, store.a); + } + return store; } } diff --git a/jme3-core/src/main/java/com/jme3/texture/image/ImageRaster.java b/jme3-core/src/main/java/com/jme3/texture/image/ImageRaster.java index b4e583c35..92bbb3315 100644 --- a/jme3-core/src/main/java/com/jme3/texture/image/ImageRaster.java +++ b/jme3-core/src/main/java/com/jme3/texture/image/ImageRaster.java @@ -71,21 +71,42 @@ public abstract class ImageRaster { * @param image The image to read / write to. * @param slice Which slice to use. Only applies to 3D images, 2D image * arrays or cubemaps. + * @param mipMapLevel The mipmap level to read / write to. To access levels + * other than 0, the image must have + * {@link Image#setMipMapSizes(int[]) mipmap sizes} set. + * @param convertToLinear If true, the application expects read or written + * colors to be in linear color space (ImageRaster will + * automatically perform a conversion as needed). If false, the application expects + * colors to be in the image's native {@link Image#getColorSpace() color space}. + * @return An ImageRaster to read / write to the image. + */ + public static ImageRaster create(Image image, int slice, int mipMapLevel, boolean convertToLinear) { + return new DefaultImageRaster(image, slice, mipMapLevel, convertToLinear); + } + + /** + * Create new image reader / writer. + * + * @param image The image to read / write to. + * @param slice Which slice to use. Only applies to 3D images, 2D image + * arrays or cubemaps. + * @return An ImageRaster to read / write to the image. */ public static ImageRaster create(Image image, int slice) { - return JmeSystem.createImageRaster(image, slice); + return create(image, slice, 0, false); } /** * Create new image reader / writer for 2D images. * * @param image The image to read / write to. + * @return An ImageRaster to read / write to the image. */ public static ImageRaster create(Image image) { if (image.getData().size() > 1) { throw new IllegalStateException("Use constructor that takes slices argument to read from multislice image"); } - return JmeSystem.createImageRaster(image, 0); + return create(image, 0, 0, false); } public ImageRaster() { From 1f0c83ae7d031efa9854893b64345c176833dd0e Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Sat, 2 May 2015 15:22:11 -0400 Subject: [PATCH 084/113] ColorRGBA: getAsSrgb() to return ColorRGBA --- .../main/java/com/jme3/math/ColorRGBA.java | 36 +++++++++---------- 1 file changed, 18 insertions(+), 18 deletions(-) diff --git a/jme3-core/src/main/java/com/jme3/math/ColorRGBA.java b/jme3-core/src/main/java/com/jme3/math/ColorRGBA.java index 89f82ebbd..89df1bb2b 100644 --- a/jme3-core/src/main/java/com/jme3/math/ColorRGBA.java +++ b/jme3-core/src/main/java/com/jme3/math/ColorRGBA.java @@ -607,28 +607,28 @@ public final class ColorRGBA implements Savable, Cloneable, java.io.Serializable } /** - * Get the color in sRGB color space as a Vector4f + * Get the color in sRGB color space as a ColorRGBA. * * Note that linear values stored in the ColorRGBA will be gamma corrected - * and returned as a Vector4f - * the x atribute will be fed with the r channel in sRGB space - * the y atribute will be fed with the g channel in sRGB space - * the z atribute will be fed with the b channel in sRGB space - * the w atribute will be fed with the a channel + * and returned as a ColorRGBA. * - * Note that no correction will be performed on the alpha channel as it's - * conventionnally doesn't represent a color itself + * The x attribute will be fed with the r channel in sRGB space. + * The y attribute will be fed with the g channel in sRGB space. + * The z attribute will be fed with the b channel in sRGB space. + * The w attribute will be fed with the a channel. * - * @return the color in sRGB color space as a Vector4f - */ - public Vector4f getAsSrgb(){ - Vector4f srgb = new Vector4f(); - float invGama = 1f/GAMMA; - srgb.x = (float)Math.pow(r, invGama); - srgb.y = (float)Math.pow(g, invGama); - srgb.z = (float)Math.pow(b, invGama); - srgb.w = a; - + * Note that no correction will be performed on the alpha channel as it + * conventionally doesn't represent a color itself. + * + * @return the color in sRGB color space as a ColorRGBA. + */ + public ColorRGBA getAsSrgb() { + ColorRGBA srgb = new ColorRGBA(); + float invGama = 1f / GAMMA; + srgb.r = (float) Math.pow(r, invGama); + srgb.g = (float) Math.pow(g, invGama); + srgb.b = (float) Math.pow(b, invGama); + srgb.a = a; return srgb; } From e29988e30cb8ffe60ade1e3c5b2115c896909f6b Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Sat, 2 May 2015 15:24:22 -0400 Subject: [PATCH 085/113] Image: fix cloning for last texture state --- jme3-core/src/main/java/com/jme3/texture/Image.java | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/jme3-core/src/main/java/com/jme3/texture/Image.java b/jme3-core/src/main/java/com/jme3/texture/Image.java index 96ab62819..52f311e98 100644 --- a/jme3-core/src/main/java/com/jme3/texture/Image.java +++ b/jme3-core/src/main/java/com/jme3/texture/Image.java @@ -375,7 +375,7 @@ public class Image extends NativeObject implements Savable /*, Cloneable*/ { // attributes relating to GL object protected boolean mipsWereGenerated = false; protected boolean needGeneratedMips = false; - protected final LastTextureState lastTextureState = new LastTextureState(); + protected LastTextureState lastTextureState = new LastTextureState(); /** * Internal use only. @@ -490,6 +490,7 @@ public class Image extends NativeObject implements Savable /*, Cloneable*/ { Image clone = (Image) super.clone(); clone.mipMapSizes = mipMapSizes != null ? mipMapSizes.clone() : null; clone.data = data != null ? new ArrayList(data) : null; + clone.lastTextureState = new LastTextureState(); clone.setUpdateNeeded(); return clone; } From 02c997b16580a24cd0f03420a07bb365a2eb8a74 Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Sat, 2 May 2015 15:25:07 -0400 Subject: [PATCH 086/113] Image: remove efficient state field --- jme3-core/src/main/java/com/jme3/texture/Image.java | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/jme3-core/src/main/java/com/jme3/texture/Image.java b/jme3-core/src/main/java/com/jme3/texture/Image.java index 52f311e98..ca9404720 100644 --- a/jme3-core/src/main/java/com/jme3/texture/Image.java +++ b/jme3-core/src/main/java/com/jme3/texture/Image.java @@ -367,7 +367,6 @@ public class Image extends NativeObject implements Savable /*, Cloneable*/ { protected int width, height, depth; protected int[] mipMapSizes; protected ArrayList data; - protected transient Object efficientData; protected int multiSamples = 1; protected ColorSpace colorSpace = null; // protected int mipOffset = 0; @@ -761,8 +760,6 @@ public class Image extends NativeObject implements Savable /*, Cloneable*/ { */ @Deprecated public void setEfficentData(Object efficientData){ - this.efficientData = efficientData; - setUpdateNeeded(); } /** @@ -770,7 +767,7 @@ public class Image extends NativeObject implements Savable /*, Cloneable*/ { */ @Deprecated public Object getEfficentData(){ - return efficientData; + return null; } /** From f2e0a15edb1460b7de065f7428c7354fce691517 Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Sat, 2 May 2015 15:26:16 -0400 Subject: [PATCH 087/113] AssetConfig: remove duplicates from Desktop.cfg --- .../main/resources/com/jme3/asset/Desktop.cfg | 22 ------------------- .../main/resources/com/jme3/asset/General.cfg | 2 +- 2 files changed, 1 insertion(+), 23 deletions(-) diff --git a/jme3-core/src/main/resources/com/jme3/asset/Desktop.cfg b/jme3-core/src/main/resources/com/jme3/asset/Desktop.cfg index df72654a1..28727d070 100644 --- a/jme3-core/src/main/resources/com/jme3/asset/Desktop.cfg +++ b/jme3-core/src/main/resources/com/jme3/asset/Desktop.cfg @@ -2,26 +2,4 @@ INCLUDE com/jme3/asset/General.cfg # Desktop-specific loaders LOADER com.jme3.texture.plugins.AWTLoader : jpg, bmp, gif, png, jpeg -LOADER com.jme3.audio.plugins.OGGLoader : oggLOADER com.jme3.audio.plugins.WAVLoader : wav LOADER com.jme3.audio.plugins.OGGLoader : ogg -LOADER com.jme3.cursors.plugins.CursorLoader : ani, cur, ico -LOADER com.jme3.material.plugins.J3MLoader : j3m -LOADER com.jme3.material.plugins.J3MLoader : j3md -LOADER com.jme3.material.plugins.ShaderNodeDefinitionLoader : j3sn -LOADER com.jme3.font.plugins.BitmapFontLoader : fnt -LOADER com.jme3.texture.plugins.DDSLoader : dds -LOADER com.jme3.texture.plugins.PFMLoader : pfm -LOADER com.jme3.texture.plugins.HDRLoader : hdr -LOADER com.jme3.texture.plugins.TGALoader : tga -LOADER com.jme3.export.binary.BinaryImporter : j3o -LOADER com.jme3.export.binary.BinaryImporter : j3f -LOADER com.jme3.scene.plugins.OBJLoader : obj -LOADER com.jme3.scene.plugins.MTLLoader : mtl -LOADER com.jme3.scene.plugins.ogre.MeshLoader : meshxml, mesh.xml -LOADER com.jme3.scene.plugins.ogre.SkeletonLoader : skeletonxml, skeleton.xml -LOADER com.jme3.scene.plugins.ogre.MaterialLoader : material -LOADER com.jme3.scene.plugins.ogre.SceneLoader : scene -LOADER com.jme3.scene.plugins.blender.BlenderModelLoader : blend -LOADER com.jme3.shader.plugins.GLSLLoader : vert, frag,geom,tsctrl,tseval, glsl, glsllib -LOADER com.jme3.scene.plugins.fbx.SceneLoader : fbx -LOADER com.jme3.scene.plugins.fbx.SceneWithAnimationLoader : fba diff --git a/jme3-core/src/main/resources/com/jme3/asset/General.cfg b/jme3-core/src/main/resources/com/jme3/asset/General.cfg index c0098ffe5..c56b62146 100644 --- a/jme3-core/src/main/resources/com/jme3/asset/General.cfg +++ b/jme3-core/src/main/resources/com/jme3/asset/General.cfg @@ -21,6 +21,6 @@ LOADER com.jme3.scene.plugins.ogre.SkeletonLoader : skeletonxml, skeleton.xml LOADER com.jme3.scene.plugins.ogre.MaterialLoader : material LOADER com.jme3.scene.plugins.ogre.SceneLoader : scene LOADER com.jme3.scene.plugins.blender.BlenderModelLoader : blend -LOADER com.jme3.shader.plugins.GLSLLoader : vert, frag, glsl, glsllib +LOADER com.jme3.shader.plugins.GLSLLoader : vert, frag, geom, tsctrl, tseval, glsl, glsllib LOADER com.jme3.scene.plugins.fbx.SceneLoader : fbx LOADER com.jme3.scene.plugins.fbx.SceneWithAnimationLoader : fba From 55d3a5dd1564cfcaad3cade517588e8d1ca57117 Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Sat, 2 May 2015 15:27:28 -0400 Subject: [PATCH 088/113] UnshadedArray: does not require gpu shader extension --- .../src/main/resources/jme3test/texture/UnshadedArray.frag | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/jme3-examples/src/main/resources/jme3test/texture/UnshadedArray.frag b/jme3-examples/src/main/resources/jme3test/texture/UnshadedArray.frag index 4cd92cff9..355cf6092 100644 --- a/jme3-examples/src/main/resources/jme3test/texture/UnshadedArray.frag +++ b/jme3-examples/src/main/resources/jme3test/texture/UnshadedArray.frag @@ -1,5 +1,5 @@ #extension GL_EXT_texture_array : enable -#extension GL_EXT_gpu_shader4 : enable +// #extension GL_EXT_gpu_shader4 : enable uniform vec4 m_Color; @@ -8,7 +8,7 @@ uniform vec4 m_Color; #endif #ifdef HAS_COLORMAP - #if !defined(GL_EXT_texture_array) && !defined(GL_EXT_gpu_shader4) + #if !defined(GL_EXT_texture_array) #error Texture arrays are not supported, but required for this shader. #endif From 682b1f5b585885384b156d7cd1596159b4592396 Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Sat, 2 May 2015 15:28:26 -0400 Subject: [PATCH 089/113] MipMapGenerator: add generator that uses raster The one that uses AWT will be deprecated soon --- .../java/com/jme3/util/MipMapGenerator.java | 143 ++++++++++++++++++ 1 file changed, 143 insertions(+) create mode 100644 jme3-core/src/main/java/com/jme3/util/MipMapGenerator.java diff --git a/jme3-core/src/main/java/com/jme3/util/MipMapGenerator.java b/jme3-core/src/main/java/com/jme3/util/MipMapGenerator.java new file mode 100644 index 000000000..e7a33da3c --- /dev/null +++ b/jme3-core/src/main/java/com/jme3/util/MipMapGenerator.java @@ -0,0 +1,143 @@ +/* + * Copyright (c) 2009-2012 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ +package com.jme3.util; + +import com.jme3.math.ColorRGBA; +import com.jme3.math.FastMath; +import com.jme3.texture.Image; +import com.jme3.texture.Image.Format; +import com.jme3.texture.image.ImageRaster; +import java.nio.ByteBuffer; +import java.util.ArrayList; + +public class MipMapGenerator { + + private MipMapGenerator() { + } + + public static Image scaleImage(Image inputImage, int outputWidth, int outputHeight) { + int size = outputWidth * outputHeight * inputImage.getFormat().getBitsPerPixel() / 8; + ByteBuffer buffer = BufferUtils.createByteBuffer(size); + Image outputImage = new Image(inputImage.getFormat(), + outputWidth, + outputHeight, + buffer, + inputImage.getColorSpace()); + + // Perform scaling in linear colorspace for higher quality. + // However it requires a lot of pow() calls.. + ImageRaster input = ImageRaster.create(inputImage, 0, 0, true); + ImageRaster output = ImageRaster.create(outputImage, 0, 0, true); + + float xRatio = ((float)(input.getWidth() - 1)) / output.getWidth(); + float yRatio = ((float)(input.getHeight() - 1)) / output.getHeight(); + + ColorRGBA outputColor = new ColorRGBA(); + ColorRGBA bottomLeft = new ColorRGBA(); + ColorRGBA bottomRight = new ColorRGBA(); + ColorRGBA topLeft = new ColorRGBA(); + ColorRGBA topRight = new ColorRGBA(); + + for (int y = 0; y < outputHeight; y++) { + for (int x = 0; x < outputWidth; x++) { + float x2f = x * xRatio; + float y2f = y * yRatio; + + int x2 = (int)x2f; + int y2 = (int)y2f; + + float xDiff = x2f - x2; + float yDiff = y2f - y2; + + input.getPixel(x2, y2, bottomLeft); + input.getPixel(x2 + 1, y2, bottomRight); + input.getPixel(x2, y2 + 1, topLeft); + input.getPixel(x2 + 1, y2 + 1, topRight); + + bottomLeft.multLocal( (1f - xDiff) * (1f - yDiff) ); + bottomRight.multLocal( (xDiff) * (1f - yDiff) ); + topLeft.multLocal( (1f - xDiff) * (yDiff) ); + topRight.multLocal( (xDiff) * (yDiff) ); + + outputColor.set(bottomLeft).addLocal(bottomRight) + .addLocal(topLeft).addLocal(topRight); + + output.setPixel(x, y, outputColor); + } + } + return outputImage; + } + + public static Image resizeToPowerOf2(Image original){ + int potWidth = FastMath.nearestPowerOfTwo(original.getWidth()); + int potHeight = FastMath.nearestPowerOfTwo(original.getHeight()); + int potSize = Math.max(potWidth, potHeight); + return scaleImage(original, potSize, potSize); + } + + public static void generateMipMaps(Image image){ + int width = image.getWidth(); + int height = image.getHeight(); + + Image current = image; + ArrayList output = new ArrayList(); + int totalSize = 0; + + while (height >= 1 || width >= 1){ + output.add(current.getData(0)); + totalSize += current.getData(0).capacity(); + + if (height == 1 || width == 1) { + break; + } + + height /= 2; + width /= 2; + + current = scaleImage(current, width, height); + } + + ByteBuffer combinedData = BufferUtils.createByteBuffer(totalSize); + int[] mipSizes = new int[output.size()]; + for (int i = 0; i < output.size(); i++){ + ByteBuffer data = output.get(i); + data.clear(); + combinedData.put(data); + mipSizes[i] = data.capacity(); + } + combinedData.flip(); + + // insert mip data into image + image.setData(0, combinedData); + image.setMipMapSizes(mipSizes); + } +} From 4aa32cd016a408bba9ce84206cba7e9a61a507e2 Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Sat, 2 May 2015 15:53:57 -0400 Subject: [PATCH 090/113] MipMapGen: resize to nearest power of 2 in both dimensions Before it was selecting the largest dimension, but OpenGL does not have such requirement. --- jme3-core/src/main/java/com/jme3/util/MipMapGenerator.java | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/jme3-core/src/main/java/com/jme3/util/MipMapGenerator.java b/jme3-core/src/main/java/com/jme3/util/MipMapGenerator.java index e7a33da3c..6bdfb6e65 100644 --- a/jme3-core/src/main/java/com/jme3/util/MipMapGenerator.java +++ b/jme3-core/src/main/java/com/jme3/util/MipMapGenerator.java @@ -100,8 +100,7 @@ public class MipMapGenerator { public static Image resizeToPowerOf2(Image original){ int potWidth = FastMath.nearestPowerOfTwo(original.getWidth()); int potHeight = FastMath.nearestPowerOfTwo(original.getHeight()); - int potSize = Math.max(potWidth, potHeight); - return scaleImage(original, potSize, potSize); + return scaleImage(original, potWidth, potHeight); } public static void generateMipMaps(Image image){ From ed61979825d5a1aa855c6ff3356afb812ec05fa5 Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Sat, 2 May 2015 15:57:10 -0400 Subject: [PATCH 091/113] GLRenderer: resize images to POT if needed E.g. when using NPOT textures on iOS with mipmapping. --- .../com/jme3/renderer/opengl/GLRenderer.java | 43 ++++++++++++++----- 1 file changed, 33 insertions(+), 10 deletions(-) diff --git a/jme3-core/src/main/java/com/jme3/renderer/opengl/GLRenderer.java b/jme3-core/src/main/java/com/jme3/renderer/opengl/GLRenderer.java index 37b7c753f..5e3eeca90 100644 --- a/jme3-core/src/main/java/com/jme3/renderer/opengl/GLRenderer.java +++ b/jme3-core/src/main/java/com/jme3/renderer/opengl/GLRenderer.java @@ -54,6 +54,7 @@ import com.jme3.texture.Texture; import com.jme3.texture.Texture.WrapAxis; import com.jme3.util.BufferUtils; import com.jme3.util.ListMap; +import com.jme3.util.MipMapGenerator; import com.jme3.util.NativeObjectManager; import java.nio.*; import java.util.Arrays; @@ -1428,7 +1429,7 @@ public class GLRenderer implements Renderer { // Check NPOT requirements checkNonPowerOfTwo(tex); - updateTexImageData(image, tex.getType(), 0); + updateTexImageData(image, tex.getType(), 0, false); // NOTE: For depth textures, sets nearest/no-mips mode // Required to fix "framebuffer unsupported" @@ -1965,8 +1966,10 @@ public class GLRenderer implements Renderer { * @param img The image to upload * @param type How the data in the image argument should be interpreted. * @param unit The texture slot to be used to upload the image, not important + * @param scaleToPot If true, the image will be scaled to power-of-2 dimensions + * before being uploaded. */ - public void updateTexImageData(Image img, Texture.Type type, int unit) { + public void updateTexImageData(Image img, Texture.Type type, int unit, boolean scaleToPot) { int texId = img.getId(); if (texId == -1) { // create texture @@ -2050,33 +2053,39 @@ public class GLRenderer implements Renderer { } } + Image imageForUpload; + if (scaleToPot) { + imageForUpload = MipMapGenerator.resizeToPowerOf2(img); + } else { + imageForUpload = img; + } if (target == GL.GL_TEXTURE_CUBE_MAP) { - List data = img.getData(); + List data = imageForUpload.getData(); if (data.size() != 6) { logger.log(Level.WARNING, "Invalid texture: {0}\n" + "Cubemap textures must contain 6 data units.", img); return; } for (int i = 0; i < 6; i++) { - texUtil.uploadTexture(img, GL.GL_TEXTURE_CUBE_MAP_POSITIVE_X + i, i, linearizeSrgbImages); + texUtil.uploadTexture(imageForUpload, GL.GL_TEXTURE_CUBE_MAP_POSITIVE_X + i, i, linearizeSrgbImages); } } else if (target == GLExt.GL_TEXTURE_2D_ARRAY_EXT) { if (!caps.contains(Caps.TextureArray)) { throw new RendererException("Texture arrays not supported by graphics hardware"); } - List data = img.getData(); + List data = imageForUpload.getData(); // -1 index specifies prepare data for 2D Array - texUtil.uploadTexture(img, target, -1, linearizeSrgbImages); + texUtil.uploadTexture(imageForUpload, target, -1, linearizeSrgbImages); for (int i = 0; i < data.size(); i++) { // upload each slice of 2D array in turn // this time with the appropriate index - texUtil.uploadTexture(img, target, i, linearizeSrgbImages); + texUtil.uploadTexture(imageForUpload, target, i, linearizeSrgbImages); } } else { - texUtil.uploadTexture(img, target, 0, linearizeSrgbImages); + texUtil.uploadTexture(imageForUpload, target, 0, linearizeSrgbImages); } if (img.getMultiSamples() != imageSamples) { @@ -2097,9 +2106,23 @@ public class GLRenderer implements Renderer { Image image = tex.getImage(); if (image.isUpdateNeeded() || (image.isGeneratedMipmapsRequired() && !image.isMipmapsGenerated())) { // Check NPOT requirements - checkNonPowerOfTwo(tex); + boolean scaleToPot = false; + + try { + checkNonPowerOfTwo(tex); + } catch (RendererException ex) { + if (logger.isLoggable(Level.WARNING)) { + int nextWidth = FastMath.nearestPowerOfTwo(tex.getImage().getWidth()); + int nextHeight = FastMath.nearestPowerOfTwo(tex.getImage().getHeight()); + logger.log(Level.WARNING, + "Non-power-of-2 textures are not supported! Scaling texture '" + tex.getName() + + "' of size " + tex.getImage().getWidth() + "x" + tex.getImage().getHeight() + + " to " + nextWidth + "x" + nextHeight); + } + scaleToPot = true; + } - updateTexImageData(image, tex.getType(), unit); + updateTexImageData(image, tex.getType(), unit, scaleToPot); } int texId = image.getId(); From a43a405ca1663cff4008557bfbe7f8980f290077 Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Sun, 3 May 2015 15:01:03 -0400 Subject: [PATCH 092/113] StatsView: render as single object --- .../src/main/java/com/jme3/app/StatsView.java | 24 +++++++++---------- 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/jme3-core/src/main/java/com/jme3/app/StatsView.java b/jme3-core/src/main/java/com/jme3/app/StatsView.java index 9f748fdf4..ae1106f2e 100644 --- a/jme3-core/src/main/java/com/jme3/app/StatsView.java +++ b/jme3-core/src/main/java/com/jme3/app/StatsView.java @@ -60,7 +60,7 @@ import com.jme3.scene.control.Control; */ public class StatsView extends Node implements Control { - private BitmapText[] labels; + private BitmapText statText; private Statistics statistics; private String[] statLabels; @@ -81,20 +81,17 @@ public class StatsView extends Node implements Control { statLabels = statistics.getLabels(); statData = new int[statLabels.length]; - labels = new BitmapText[statLabels.length]; BitmapFont font = manager.loadFont("Interface/Fonts/Console.fnt"); - for (int i = 0; i < labels.length; i++){ - labels[i] = new BitmapText(font); - labels[i].setLocalTranslation(0, labels[i].getLineHeight() * (i+1), 0); - attachChild(labels[i]); - } + statText = new BitmapText(font); + statText.setLocalTranslation(0, statText.getLineHeight() * statLabels.length, 0); + attachChild(statText); addControl(this); } public float getHeight() { - return labels[0].getLineHeight() * statLabels.length; + return statText.getLineHeight() * statText.getLineCount(); // labels[0].getLineHeight() * statLabels.length; } public void update(float tpf) { @@ -103,11 +100,14 @@ public class StatsView extends Node implements Control { return; statistics.getData(statData); - for (int i = 0; i < labels.length; i++) { - stringBuilder.setLength(0); - stringBuilder.append(statLabels[i]).append(" = ").append(statData[i]); - labels[i].setText(stringBuilder); + stringBuilder.setLength(0); + + // Need to walk through it backwards, as the first label + // should appear at the bottom, not the top. + for (int i = statLabels.length - 1; i >= 0; i--) { + stringBuilder.append(statLabels[i]).append(" = ").append(statData[i]).append('\n'); } + statText.setText(stringBuilder); // Moved to ResetStatsState to make sure it is // done even if there is no StatsView or the StatsView From 886bbc08b061c65e37fa1df266fc38df20f8ce8e Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Sun, 3 May 2015 15:19:30 -0400 Subject: [PATCH 093/113] MipMapGenerator: perform scaling in sRGB - Incorrect, but faster. In most cases where it is used, gamma correct pipeline isn't used and performance is of higher priority than quality. --- jme3-core/src/main/java/com/jme3/util/MipMapGenerator.java | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/jme3-core/src/main/java/com/jme3/util/MipMapGenerator.java b/jme3-core/src/main/java/com/jme3/util/MipMapGenerator.java index 6bdfb6e65..3ac6a7ecd 100644 --- a/jme3-core/src/main/java/com/jme3/util/MipMapGenerator.java +++ b/jme3-core/src/main/java/com/jme3/util/MipMapGenerator.java @@ -53,10 +53,8 @@ public class MipMapGenerator { buffer, inputImage.getColorSpace()); - // Perform scaling in linear colorspace for higher quality. - // However it requires a lot of pow() calls.. - ImageRaster input = ImageRaster.create(inputImage, 0, 0, true); - ImageRaster output = ImageRaster.create(outputImage, 0, 0, true); + ImageRaster input = ImageRaster.create(inputImage, 0, 0, false); + ImageRaster output = ImageRaster.create(outputImage, 0, 0, false); float xRatio = ((float)(input.getWidth() - 1)) / output.getWidth(); float yRatio = ((float)(input.getHeight() - 1)) / output.getHeight(); From 6760771b2044b4e0bac4f3ff134a31e4e37ecd0d Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Sun, 3 May 2015 15:22:29 -0400 Subject: [PATCH 094/113] SPLighting: vertex lighting fixes - remove useless varyings - fix alpha from diffuse color --- .../Common/MatDefs/Light/SPLighting.frag | 12 ++++-------- .../Common/MatDefs/Light/SPLighting.vert | 18 +++++++++--------- 2 files changed, 13 insertions(+), 17 deletions(-) diff --git a/jme3-core/src/main/resources/Common/MatDefs/Light/SPLighting.frag b/jme3-core/src/main/resources/Common/MatDefs/Light/SPLighting.frag index 26b68a533..254806d87 100644 --- a/jme3-core/src/main/resources/Common/MatDefs/Light/SPLighting.frag +++ b/jme3-core/src/main/resources/Common/MatDefs/Light/SPLighting.frag @@ -17,10 +17,7 @@ varying vec3 SpecularSum; #ifndef VERTEX_LIGHTING uniform mat4 g_ViewMatrix; uniform vec4 g_LightData[NB_LIGHTS]; - varying vec3 vPos; -#else - varying vec3 specularAccum; - varying vec4 diffuseAccum; + varying vec3 vPos; #endif #ifdef DIFFUSEMAP @@ -167,10 +164,9 @@ void main(){ #endif #ifdef VERTEX_LIGHTING - gl_FragColor.rgb = AmbientSum * diffuseColor.rgb - +diffuseAccum.rgb *diffuseColor.rgb - +specularAccum.rgb * specularColor.rgb; - gl_FragColor.a=1.0; + gl_FragColor.rgb = AmbientSum.rgb * diffuseColor.rgb + + DiffuseSum.rgb * diffuseColor.rgb + + SpecularSum.rgb * specularColor.rgb; #else int i = 0; diff --git a/jme3-core/src/main/resources/Common/MatDefs/Light/SPLighting.vert b/jme3-core/src/main/resources/Common/MatDefs/Light/SPLighting.vert index 6ad224d9b..1fde8e13d 100644 --- a/jme3-core/src/main/resources/Common/MatDefs/Light/SPLighting.vert +++ b/jme3-core/src/main/resources/Common/MatDefs/Light/SPLighting.vert @@ -43,8 +43,6 @@ attribute vec3 inNormal; varying vec3 vBinormal; #endif #else - varying vec3 specularAccum; - varying vec4 diffuseAccum; #ifdef COLORRAMP uniform sampler2D m_ColorRamp; #endif @@ -131,14 +129,13 @@ void main(){ #endif #ifdef VERTEX_LIGHTING int i = 0; - diffuseAccum = vec4(0.0); - specularAccum = vec3(0.0); + vec3 diffuseAccum = vec3(0.0); + vec3 specularAccum = vec3(0.0); vec4 diffuseColor; vec3 specularColor; for (int i =0;i < NB_LIGHTS; i+=3){ vec4 lightColor = g_LightData[i]; vec4 lightData1 = g_LightData[i+1]; - DiffuseSum = vec4(1.0); #ifdef MATERIAL_COLORS diffuseColor = m_Diffuse * vec4(lightColor.rgb, 1.0); specularColor = m_Specular.rgb * lightColor.rgb; @@ -166,13 +163,16 @@ void main(){ vec2 light = computeLighting(wvNormal, viewDir, lightDir.xyz, lightDir.w * spotFallOff, m_Shininess); #ifdef COLORRAMP - diffuseAccum.rgb += texture2D(m_ColorRamp, vec2(light.x, 0.0)).rgb * diffuseColor.rgb; - specularAccum.rgb += texture2D(m_ColorRamp, vec2(light.y, 0.0)).rgb * specularColor; + diffuseAccum += texture2D(m_ColorRamp, vec2(light.x, 0.0)).rgb * diffuseColor.rgb; + specularAccum += texture2D(m_ColorRamp, vec2(light.y, 0.0)).rgb * specularColor; #else - diffuseAccum.rgb += light.x * diffuseColor.rgb; - specularAccum.rgb += light.y * specularColor; + diffuseAccum += light.x * diffuseColor.rgb; + specularAccum += light.y * specularColor; #endif } + + DiffuseSum.rgb *= diffuseAccum.rgb; + SpecularSum.rgb *= specularAccum.rgb; #endif From 17bf0f8ab3222ac21a1d86d168a1dab90efc7b61 Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Sun, 3 May 2015 15:52:31 -0400 Subject: [PATCH 095/113] SkeletonControl: fix #207 --- .../com/jme3/animation/SkeletonControl.java | 17 ++++++++++++++--- 1 file changed, 14 insertions(+), 3 deletions(-) diff --git a/jme3-core/src/main/java/com/jme3/animation/SkeletonControl.java b/jme3-core/src/main/java/com/jme3/animation/SkeletonControl.java index d5ef31939..4d001c365 100644 --- a/jme3-core/src/main/java/com/jme3/animation/SkeletonControl.java +++ b/jme3-core/src/main/java/com/jme3/animation/SkeletonControl.java @@ -347,11 +347,22 @@ public class SkeletonControl extends AbstractControl implements Cloneable { public Control cloneForSpatial(Spatial spatial) { Node clonedNode = (Node) spatial; - AnimControl ctrl = spatial.getControl(AnimControl.class); SkeletonControl clone = new SkeletonControl(); - clone.skeleton = ctrl.getSkeleton(); - + AnimControl ctrl = spatial.getControl(AnimControl.class); + if (ctrl != null) { + // AnimControl is responsible for cloning the skeleton, not + // SkeletonControl. + clone.skeleton = ctrl.getSkeleton(); + } else { + // If there's no AnimControl, create the clone ourselves. + clone.skeleton = new Skeleton(skeleton); + } + clone.hwSkinningDesired = this.hwSkinningDesired; + clone.hwSkinningEnabled = this.hwSkinningEnabled; + clone.hwSkinningSupported = this.hwSkinningSupported; + clone.hwSkinningTested = this.hwSkinningTested; + clone.setSpatial(clonedNode); // Fix attachments for the cloned node From b4baaadc79ab259006ae0fa29469d45fabbc9594 Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Sun, 3 May 2015 15:59:32 -0400 Subject: [PATCH 096/113] JmeExporter: remove useless return --- .../java/com/jme3/export/JmeExporter.java | 8 ++----- .../jme3/export/binary/BinaryExporter.java | 14 +++++------- .../java/com/jme3/export/xml/XMLExporter.java | 22 ++++++++++++------- 3 files changed, 21 insertions(+), 23 deletions(-) diff --git a/jme3-core/src/main/java/com/jme3/export/JmeExporter.java b/jme3-core/src/main/java/com/jme3/export/JmeExporter.java index 0afd170ea..b8c3abc60 100644 --- a/jme3-core/src/main/java/com/jme3/export/JmeExporter.java +++ b/jme3-core/src/main/java/com/jme3/export/JmeExporter.java @@ -46,22 +46,18 @@ public interface JmeExporter { * * @param object The savable to export * @param f The output stream - * @return Always returns true. If an error occurs during export, - * an exception is thrown * @throws IOException If an io exception occurs during export */ - public boolean save(Savable object, OutputStream f) throws IOException; + public void save(Savable object, OutputStream f) throws IOException; /** * Export the {@link Savable} to a file. * * @param object The savable to export * @param f The file to export to - * @return Always returns true. If an error occurs during export, - * an exception is thrown * @throws IOException If an io exception occurs during export */ - public boolean save(Savable object, File f) throws IOException; + public void save(Savable object, File f) throws IOException; /** * Returns the {@link OutputCapsule} for the given savable object. diff --git a/jme3-core/src/plugins/java/com/jme3/export/binary/BinaryExporter.java b/jme3-core/src/plugins/java/com/jme3/export/binary/BinaryExporter.java index c02f7088a..b5f458697 100644 --- a/jme3-core/src/plugins/java/com/jme3/export/binary/BinaryExporter.java +++ b/jme3-core/src/plugins/java/com/jme3/export/binary/BinaryExporter.java @@ -168,7 +168,7 @@ public class BinaryExporter implements JmeExporter { return new BinaryExporter(); } - public boolean save(Savable object, OutputStream os) throws IOException { + public void save(Savable object, OutputStream os) throws IOException { // reset some vars aliasCount = 1; idCount = 1; @@ -286,7 +286,7 @@ public class BinaryExporter implements JmeExporter { out = null; os = null; - if (debug ) { + if (debug) { logger.fine("Stats:"); logger.log(Level.FINE, "classes: {0}", classNum); logger.log(Level.FINE, "class table: {0} bytes", classTableSize); @@ -294,8 +294,6 @@ public class BinaryExporter implements JmeExporter { logger.log(Level.FINE, "location table: {0} bytes", locationTableSize); logger.log(Level.FINE, "data: {0} bytes", location); } - - return true; } protected String getChunk(BinaryIdContentPair pair) { @@ -325,7 +323,7 @@ public class BinaryExporter implements JmeExporter { return bytes; } - public boolean save(Savable object, File f) throws IOException { + public void save(Savable object, File f) throws IOException { File parentDirectory = f.getParentFile(); if (parentDirectory != null && !parentDirectory.exists()) { parentDirectory.mkdirs(); @@ -333,11 +331,9 @@ public class BinaryExporter implements JmeExporter { FileOutputStream fos = new FileOutputStream(f); try { - return save(object, fos); + save(object, fos); } finally { - if (fos != null) { - fos.close(); - } + fos.close(); } } diff --git a/jme3-plugins/src/xml/java/com/jme3/export/xml/XMLExporter.java b/jme3-plugins/src/xml/java/com/jme3/export/xml/XMLExporter.java index 32138270d..0ede52884 100644 --- a/jme3-plugins/src/xml/java/com/jme3/export/xml/XMLExporter.java +++ b/jme3-plugins/src/xml/java/com/jme3/export/xml/XMLExporter.java @@ -40,6 +40,7 @@ import java.io.FileOutputStream; import java.io.IOException; import java.io.OutputStream; import javax.xml.parsers.DocumentBuilderFactory; +import javax.xml.parsers.ParserConfigurationException; /** * Part of the jME XML IO system as introduced in the google code jmexml project. @@ -61,7 +62,8 @@ public class XMLExporter implements JmeExporter { } - public boolean save(Savable object, OutputStream f) throws IOException { + @Override + public void save(Savable object, OutputStream f) throws IOException { try { //Initialize Document when saving so we don't retain state of previous exports this.domOut = new DOMOutputCapsule(DocumentBuilderFactory.newInstance().newDocumentBuilder().newDocument(), this); @@ -69,18 +71,22 @@ public class XMLExporter implements JmeExporter { DOMSerializer serializer = new DOMSerializer(); serializer.serialize(domOut.getDoc(), f); f.flush(); - return true; - } catch (Exception ex) { - IOException e = new IOException(); - e.initCause(ex); - throw e; + } catch (ParserConfigurationException ex) { + throw new IOException(ex); } } - public boolean save(Savable object, File f) throws IOException { - return save(object, new FileOutputStream(f)); + @Override + public void save(Savable object, File f) throws IOException { + FileOutputStream fos = new FileOutputStream(f); + try { + save(object, fos); + } finally { + fos.close(); + } } + @Override public OutputCapsule getCapsule(Savable object) { return domOut; } From 0178029782a35bb21edb6fc9bebc17c896eba663 Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Sun, 3 May 2015 16:02:25 -0400 Subject: [PATCH 097/113] Example to show character model cloning / export --- .../jme3/export/binary/BinaryExporter.java | 26 ++++++ .../effect/TestParticleExportingCloning.java | 23 +---- .../model/anim/TestModelExportingCloning.java | 83 +++++++++++++++++++ 3 files changed, 112 insertions(+), 20 deletions(-) create mode 100644 jme3-examples/src/main/java/jme3test/model/anim/TestModelExportingCloning.java diff --git a/jme3-core/src/plugins/java/com/jme3/export/binary/BinaryExporter.java b/jme3-core/src/plugins/java/com/jme3/export/binary/BinaryExporter.java index b5f458697..eb12bf908 100644 --- a/jme3-core/src/plugins/java/com/jme3/export/binary/BinaryExporter.java +++ b/jme3-core/src/plugins/java/com/jme3/export/binary/BinaryExporter.java @@ -31,6 +31,7 @@ */ package com.jme3.export.binary; +import com.jme3.asset.AssetManager; import com.jme3.export.FormatVersion; import com.jme3.export.JmeExporter; import com.jme3.export.Savable; @@ -167,6 +168,31 @@ public class BinaryExporter implements JmeExporter { public static BinaryExporter getInstance() { return new BinaryExporter(); } + + /** + * Saves the object into memory then loads it from memory. + * + * Used by tests to check if the persistence system is working. + * + * @param The type of savable. + * @param assetManager AssetManager to load assets from. + * @param object The object to save and then load. + * @return A new instance that has been saved and loaded from the + * original object. + */ + public static T saveAndLoad(AssetManager assetManager, T object) { + ByteArrayOutputStream baos = new ByteArrayOutputStream(); + try { + BinaryExporter exporter = new BinaryExporter(); + exporter.save(object, baos); + BinaryImporter importer = new BinaryImporter(); + importer.setAssetManager(assetManager); + return (T) importer.load(baos.toByteArray()); + } catch (IOException ex) { + // Should never happen. + throw new AssertionError(ex); + } + } public void save(Savable object, OutputStream os) throws IOException { // reset some vars diff --git a/jme3-examples/src/main/java/jme3test/effect/TestParticleExportingCloning.java b/jme3-examples/src/main/java/jme3test/effect/TestParticleExportingCloning.java index 552287f75..d245de23f 100644 --- a/jme3-examples/src/main/java/jme3test/effect/TestParticleExportingCloning.java +++ b/jme3-examples/src/main/java/jme3test/effect/TestParticleExportingCloning.java @@ -69,26 +69,9 @@ public class TestParticleExportingCloning extends SimpleApplication { rootNode.attachChild(emit); rootNode.attachChild(emit2); - ByteArrayOutputStream out = new ByteArrayOutputStream(); - try { - BinaryExporter.getInstance().save(emit, out); - - BinaryImporter imp = new BinaryImporter(); - imp.setAssetManager(assetManager); - ParticleEmitter emit3 = (ParticleEmitter) imp.load(out.toByteArray()); - - emit3.move(-3, 0, 0); - rootNode.attachChild(emit3); - } catch (IOException ex) { - ex.printStackTrace(); - } - - // Camera cam2 = cam.clone(); - // cam.setViewPortTop(0.5f); - // cam2.setViewPortBottom(0.5f); - // ViewPort vp = renderManager.createMainView("SecondView", cam2); - // viewPort.setClearEnabled(false); - // vp.attachScene(rootNode); + ParticleEmitter emit3 = BinaryExporter.saveAndLoad(assetManager, emit); + emit3.move(-3, 0, 0); + rootNode.attachChild(emit3); } } diff --git a/jme3-examples/src/main/java/jme3test/model/anim/TestModelExportingCloning.java b/jme3-examples/src/main/java/jme3test/model/anim/TestModelExportingCloning.java new file mode 100644 index 000000000..de162907d --- /dev/null +++ b/jme3-examples/src/main/java/jme3test/model/anim/TestModelExportingCloning.java @@ -0,0 +1,83 @@ +/* + * Copyright (c) 2009-2015 jMonkeyEngine + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of 'jMonkeyEngine' nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ +package jme3test.model.anim; + +import com.jme3.animation.AnimChannel; +import com.jme3.animation.AnimControl; +import com.jme3.app.SimpleApplication; +import com.jme3.export.binary.BinaryExporter; +import com.jme3.light.DirectionalLight; +import com.jme3.math.ColorRGBA; +import com.jme3.math.Vector3f; +import com.jme3.scene.Spatial; + +public class TestModelExportingCloning extends SimpleApplication { + + public static void main(String[] args) { + TestModelExportingCloning app = new TestModelExportingCloning(); + app.start(); + } + + @Override + public void simpleInitApp() { + cam.setLocation(new Vector3f(10f, 3f, 40f)); + cam.lookAtDirection(Vector3f.UNIT_Z.negate(), Vector3f.UNIT_Y); + + DirectionalLight dl = new DirectionalLight(); + dl.setDirection(new Vector3f(-0.1f, -0.7f, -1).normalizeLocal()); + dl.setColor(new ColorRGBA(1f, 1f, 1f, 1.0f)); + rootNode.addLight(dl); + + AnimControl control; + AnimChannel channel; + + Spatial originalModel = assetManager.loadModel("Models/Oto/Oto.mesh.xml"); + control = originalModel.getControl(AnimControl.class); + channel = control.createChannel(); + channel.setAnim("Walk"); + rootNode.attachChild(originalModel); + + Spatial clonedModel = originalModel.clone(); + clonedModel.move(10, 0, 0); + control = clonedModel.getControl(AnimControl.class); + channel = control.createChannel(); + channel.setAnim("push"); + rootNode.attachChild(clonedModel); + + Spatial exportedModel = BinaryExporter.saveAndLoad(assetManager, originalModel); + exportedModel.move(20, 0, 0); + control = exportedModel.getControl(AnimControl.class); + channel = control.createChannel(); + channel.setAnim("pull"); + rootNode.attachChild(exportedModel); + } +} From 0eb8cbfc6c692f4ffe714e493b688e8e9d1a2262 Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Sun, 3 May 2015 16:07:50 -0400 Subject: [PATCH 098/113] StatsView: fix darken effect due to earlier change --- jme3-core/src/main/java/com/jme3/app/StatsView.java | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/jme3-core/src/main/java/com/jme3/app/StatsView.java b/jme3-core/src/main/java/com/jme3/app/StatsView.java index ae1106f2e..a0446e85e 100644 --- a/jme3-core/src/main/java/com/jme3/app/StatsView.java +++ b/jme3-core/src/main/java/com/jme3/app/StatsView.java @@ -91,7 +91,7 @@ public class StatsView extends Node implements Control { } public float getHeight() { - return statText.getLineHeight() * statText.getLineCount(); // labels[0].getLineHeight() * statLabels.length; + return statText.getLineHeight() * statLabels.length; } public void update(float tpf) { From 7057f9a1b71f16c4108a88031fb8a549d5268e33 Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Sun, 3 May 2015 20:22:45 -0400 Subject: [PATCH 099/113] SkeletonControl: enable HW skinning by default --- jme3-core/src/main/java/com/jme3/animation/SkeletonControl.java | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/jme3-core/src/main/java/com/jme3/animation/SkeletonControl.java b/jme3-core/src/main/java/com/jme3/animation/SkeletonControl.java index 4d001c365..b1f3d02df 100644 --- a/jme3-core/src/main/java/com/jme3/animation/SkeletonControl.java +++ b/jme3-core/src/main/java/com/jme3/animation/SkeletonControl.java @@ -82,7 +82,7 @@ public class SkeletonControl extends AbstractControl implements Cloneable { /** * User wishes to use hardware skinning if available. */ - private transient boolean hwSkinningDesired = false; + private transient boolean hwSkinningDesired = true; /** * Hardware skinning is currently being used. From b5d8fc250541d8066cbab4506d10f23e66067b04 Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Sun, 3 May 2015 20:24:52 -0400 Subject: [PATCH 100/113] AbstractBox: make mesh static by default --- jme3-core/src/main/java/com/jme3/scene/shape/AbstractBox.java | 1 + 1 file changed, 1 insertion(+) diff --git a/jme3-core/src/main/java/com/jme3/scene/shape/AbstractBox.java b/jme3-core/src/main/java/com/jme3/scene/shape/AbstractBox.java index 35f078eeb..ab5db2462 100644 --- a/jme3-core/src/main/java/com/jme3/scene/shape/AbstractBox.java +++ b/jme3-core/src/main/java/com/jme3/scene/shape/AbstractBox.java @@ -149,6 +149,7 @@ public abstract class AbstractBox extends Mesh { duUpdateGeometryNormals(); duUpdateGeometryTextures(); duUpdateGeometryIndices(); + setStatic(); } /** From f8dd2542b1d4c4e08f7d97e326814954b681041c Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Sun, 3 May 2015 20:25:20 -0400 Subject: [PATCH 101/113] AudioNode: disable reverb by default --- jme3-core/src/main/java/com/jme3/audio/AudioNode.java | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/jme3-core/src/main/java/com/jme3/audio/AudioNode.java b/jme3-core/src/main/java/com/jme3/audio/AudioNode.java index c4dcfabf0..8664af6c7 100644 --- a/jme3-core/src/main/java/com/jme3/audio/AudioNode.java +++ b/jme3-core/src/main/java/com/jme3/audio/AudioNode.java @@ -77,7 +77,7 @@ public class AudioNode extends Node implements AudioSource { protected transient volatile AudioSource.Status status = AudioSource.Status.Stopped; protected transient volatile int channel = -1; protected Vector3f velocity = new Vector3f(); - protected boolean reverbEnabled = true; + protected boolean reverbEnabled = false; protected float maxDistance = 200; // 200 meters protected float refDistance = 10; // 10 meters protected Filter reverbFilter; From 91cf9e645cab0d156b2039bd7a7789f93f249015 Mon Sep 17 00:00:00 2001 From: Nehon Date: Mon, 4 May 2015 20:28:52 +0200 Subject: [PATCH 102/113] BatchNode safe catch of a crash when the batch node geoms don't have the same buffer types. Added a utility method in GeometryBatchFactory to align the buffers of the subgraph. --- .../main/java/com/jme3/scene/BatchNode.java | 12 +-- .../optimize/GeometryBatchFactory.java | 90 +++++++++++++++++++ 2 files changed, 97 insertions(+), 5 deletions(-) diff --git a/jme3-core/src/main/java/com/jme3/scene/BatchNode.java b/jme3-core/src/main/java/com/jme3/scene/BatchNode.java index 475cfdf71..2d603ac2c 100644 --- a/jme3-core/src/main/java/com/jme3/scene/BatchNode.java +++ b/jme3-core/src/main/java/com/jme3/scene/BatchNode.java @@ -583,11 +583,13 @@ public class BatchNode extends GeometryGroupNode { useTangents = true; } } else { - inBuf.copyElements(0, outBuf, globalVertIndex, geomVertCount); -// for (int vert = 0; vert < geomVertCount; vert++) { -// int curGlobalVertIndex = globalVertIndex + vert; -// inBuf.copyElement(vert, outBuf, curGlobalVertIndex); -// } + if (inBuf == null) { + throw new IllegalArgumentException("Geometry " + geom.getName() + " has no " + outBuf.getBufferType() + " buffer whereas other geoms have. all geometries should have the same types of buffers.\n Try to use GeometryBatchFactory.alignBuffer() on the BatchNode before batching"); + } else if (outBuf == null) { + throw new IllegalArgumentException("Geometry " + geom.getName() + " has a " + outBuf.getBufferType() + " buffer whereas other geoms don't. all geometries should have the same types of buffers.\n Try to use GeometryBatchFactory.alignBuffer() on the BatchNode before batching"); + } else { + inBuf.copyElements(0, outBuf, globalVertIndex, geomVertCount); + } } } diff --git a/jme3-core/src/tools/java/jme3tools/optimize/GeometryBatchFactory.java b/jme3-core/src/tools/java/jme3tools/optimize/GeometryBatchFactory.java index a7668dc56..9904b3283 100644 --- a/jme3-core/src/tools/java/jme3tools/optimize/GeometryBatchFactory.java +++ b/jme3-core/src/tools/java/jme3tools/optimize/GeometryBatchFactory.java @@ -16,6 +16,7 @@ import java.nio.FloatBuffer; import java.nio.IntBuffer; import java.nio.ShortBuffer; import java.util.*; +import java.util.logging.Level; import java.util.logging.Logger; public class GeometryBatchFactory { @@ -453,4 +454,93 @@ public class GeometryBatchFactory { mergeGeometries(geoms, outMesh); printMesh(outMesh); } + + /** + * Options to align the buffers of geometries' meshes of a sub graph + * + */ + public static enum AlignOption { + + /** + * Will remove the buffers of a type that is not on all the geometries + */ + RemoveUnalignedBuffers, + /** + * Will create missing buffers and pad with dummy data + */ + CreateMissingBuffers + } + + /** + * Will ensure that all the geometries' meshes of the n sub graph have the + * same types of buffers + * @param n the node to gather geometries from + * @param option the align options + * @see AlignOption + * + * Very experimental for now. + */ + public static void alignBuffers(Node n, AlignOption option) { + List geoms = new ArrayList(); + gatherGeoms(n, geoms); + + //gather buffer types + Map types = new EnumMap(VertexBuffer.Type.class); + Map typesCount = new EnumMap(VertexBuffer.Type.class); + for (Geometry geom : geoms) { + for (VertexBuffer buffer : geom.getMesh().getBufferList()) { + if (types.get(buffer.getBufferType()) == null) { + types.put(buffer.getBufferType(), buffer); + logger.log(Level.FINE, buffer.getBufferType().toString()); + } + Integer count = typesCount.get(buffer.getBufferType()); + if (count == null) { + count = 0; + } + count++; + typesCount.put(buffer.getBufferType(), count); + } + } + + switch (option) { + case RemoveUnalignedBuffers: + for (Geometry geom : geoms) { + + for (VertexBuffer buffer : geom.getMesh().getBufferList()) { + Integer count = typesCount.get(buffer.getBufferType()); + if (count != null && count < geoms.size()) { + geom.getMesh().clearBuffer(buffer.getBufferType()); + logger.log(Level.FINE, "removing {0} from {1}", new Object[]{buffer.getBufferType(), geom.getName()}); + + } + } + } + break; + case CreateMissingBuffers: + for (Geometry geom : geoms) { + for (VertexBuffer.Type type : types.keySet()) { + if (geom.getMesh().getBuffer(type) == null) { + VertexBuffer vb = new VertexBuffer(type); + Buffer b; + switch (type) { + case Index: + case BoneIndex: + case HWBoneIndex: + b = BufferUtils.createIntBuffer(geom.getMesh().getVertexCount() * types.get(type).getNumComponents()); + break; + case InterleavedData: + b = BufferUtils.createByteBuffer(geom.getMesh().getVertexCount() * types.get(type).getNumComponents()); + break; + default: + b = BufferUtils.createFloatBuffer(geom.getMesh().getVertexCount() * types.get(type).getNumComponents()); + } + vb.setupData(types.get(type).getUsage(), types.get(type).getNumComponents(), types.get(type).getFormat(), b); + geom.getMesh().setBuffer(vb); + logger.log(Level.FINE, "geom {0} misses buffer {1}. Creating", new Object[]{geom.getName(), type}); + } + } + } + break; + } + } } From f733b69f9f46a845645e5e9b3627d8ebd2b46c22 Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Mon, 4 May 2015 11:14:02 -0400 Subject: [PATCH 103/113] Gradle: minor cleanup to build.gradle --- build.gradle | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) diff --git a/build.gradle b/build.gradle index adb31217b..62d4ac841 100644 --- a/build.gradle +++ b/build.gradle @@ -1,14 +1,10 @@ import org.gradle.api.artifacts.* -apply plugin: 'base' // To add "clean" task to the root project. -//apply plugin: 'java-library-distribution' +apply plugin: 'base' // This is applied to all sub projects subprojects { - // Don't add to native builds - // if(!project.name.endsWith('native')){ apply from: rootProject.file('common.gradle') - // } } task run(dependsOn: ':jme3-examples:run') { From f74ae990d481cda5767b91c184fc59c41c28a1ee Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Mon, 4 May 2015 11:17:01 -0400 Subject: [PATCH 104/113] Shadows: make sure to clear all buffers --- .../src/main/java/com/jme3/shadow/AbstractShadowRenderer.java | 2 +- .../src/main/java/com/jme3/shadow/BasicShadowRenderer.java | 2 +- jme3-core/src/main/java/com/jme3/shadow/PssmShadowRenderer.java | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/jme3-core/src/main/java/com/jme3/shadow/AbstractShadowRenderer.java b/jme3-core/src/main/java/com/jme3/shadow/AbstractShadowRenderer.java index 5fac9c834..5ff4ac8a7 100644 --- a/jme3-core/src/main/java/com/jme3/shadow/AbstractShadowRenderer.java +++ b/jme3-core/src/main/java/com/jme3/shadow/AbstractShadowRenderer.java @@ -424,7 +424,7 @@ public abstract class AbstractShadowRenderer implements SceneProcessor, Savable renderManager.setCamera(shadowCam, false); renderManager.getRenderer().setFrameBuffer(shadowFB[shadowMapIndex]); - renderManager.getRenderer().clearBuffers(false, true, false); + renderManager.getRenderer().clearBuffers(true, true, true); // render shadow casters to shadow map viewPort.getQueue().renderShadowQueue(shadowMapOccluders, renderManager, shadowCam, true); diff --git a/jme3-core/src/main/java/com/jme3/shadow/BasicShadowRenderer.java b/jme3-core/src/main/java/com/jme3/shadow/BasicShadowRenderer.java index bc4273db7..1410574ea 100644 --- a/jme3-core/src/main/java/com/jme3/shadow/BasicShadowRenderer.java +++ b/jme3-core/src/main/java/com/jme3/shadow/BasicShadowRenderer.java @@ -190,7 +190,7 @@ public class BasicShadowRenderer implements SceneProcessor { renderManager.setForcedMaterial(preshadowMat); r.setFrameBuffer(shadowFB); - r.clearBuffers(false, true, false); + r.clearBuffers(true, true, true); viewPort.getQueue().renderShadowQueue(shadowOccluders, renderManager, shadowCam, true); r.setFrameBuffer(viewPort.getOutputFrameBuffer()); diff --git a/jme3-core/src/main/java/com/jme3/shadow/PssmShadowRenderer.java b/jme3-core/src/main/java/com/jme3/shadow/PssmShadowRenderer.java index 182052e13..e06b5c337 100644 --- a/jme3-core/src/main/java/com/jme3/shadow/PssmShadowRenderer.java +++ b/jme3-core/src/main/java/com/jme3/shadow/PssmShadowRenderer.java @@ -450,7 +450,7 @@ public class PssmShadowRenderer implements SceneProcessor { } r.setFrameBuffer(shadowFB[i]); - r.clearBuffers(false, true, false); + r.clearBuffers(true, true, true); // render shadow casters to shadow map viewPort.getQueue().renderShadowQueue(splitOccluders, renderManager, shadowCam, true); From 9e4360cd6a3ef68a932296bbccb630167f81ab00 Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Mon, 4 May 2015 11:17:54 -0400 Subject: [PATCH 105/113] Bullet-Native: update windows natives --- .../libs/native/windows/x86/bulletjme.dll | Bin 1404928 -> 1406976 bytes .../libs/native/windows/x86_64/bulletjme.dll | Bin 1772544 -> 1777152 bytes 2 files changed, 0 insertions(+), 0 deletions(-) diff --git a/jme3-bullet-native/libs/native/windows/x86/bulletjme.dll b/jme3-bullet-native/libs/native/windows/x86/bulletjme.dll index 6839705bf73d4eb4a4e0be6d987a3ba17e756555..6874ad53d77e9a640704681ebe24482ffc0dc979 100644 GIT binary patch delta 580121 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%0D) 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Ê-2Z|K;gPb(~_ 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�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≦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%0D~ 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%0DJid7LKd=w#+s#{40*$@df*^~UpeaYgeMb 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 P0)4Zgi;F_w&TMO< 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
>n=yu#kqUWJA@;reKT_wWZUxmv7p9;DH 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 z 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
  • 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

    `e=+qE*Tmohf?m=|c0Q=^290n|GmJd9S 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

    }Y|M9P>F+=-Lge1q)Dn$c`>NSG_c?Oc)HJ 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

    p(>N2l4!j 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�s3KCn7DRD^sFQ<;kIAQOo4dSt=~B7fzz2L5aOm+q_*EDY z7rhJ4O?2^rgO2O*K_fxu(Bn}fO^@lWvR`jL+mM?Gk(NBO>%m84E$F!$Igd#B3#Boh zV0IAk5qYODXi|yKEDlX(p-8Nti2@LJ3ujFh@Ck?0aZMJ)zodz|p{B{Z5;QRp zJ~Sy3nrwJt*Mvt2eUO>jOPxpLj3^gM1=0HsB0eIA8fcn~k>z#+cx~a7AU_4i3YtWV zPAvLGJH_W3Dit(3uF0DEFKJ?9MP?+f{zfP=KvWiSqQ?0FdpJ7>$#IZ#MV*JFh9F82 zM6(=3d`MV*O_9EC7?QfYpl}SyR@9^w6lqRnD*1)8B0H&Qa8hI^szOfZaIScK_LLIW z>y_l_@T!ClCV3(S@BPQF2_F)#IJU5oYz@^Wd}^MHR_QAl^cFi-IwGw*45;F&0Y5ERgdr?N22Kdhy7Lie%lGe(LaN)@q??;zqr6x7m2AjV66rD^i8GBi0znV!tSrvp@ax9$D%F{v*)N#yNfcFhq)sefmA_>w<9zqepjHxdCKxoqFBh&=%!sBJ{+%! zPFzG~$j!Z45ZO4eP<3?>@pf#z$!pxJei)9gu(Q8&h|~;!Nt5rwM2I+-pJN?#T$6i1 zs-VfVFw&$I+h0ZYFz*<_SA9MPk3+0sfE+2WS@oox4GfSYm?hOCBqNT>@n)Av8f~L4 z3jt!B05$>yIsrI|$qtw+K7V@t>I+PIL?#kpffE#*#OF^p>QD z?HhE7SB#c~LUqn>FR(0BCp!VSTxm`KE>~}C4UCUf2C%r_d@Fn5b?Rik$EoT9)~AAG z|Iq7KG@dViAo4g`7OkivZNI`23B$u-szVZN;+KlHy^= zF|i-2;-e&8pR=p@w4x#AIg>->&w`IXqa28OxkCHO2Da}5XV932IR1NIpm^$3SdsdSVZE_arF=;-%w zxt%iW0+~HKl9n-X+kOLn4zU#xasgp8rzD7vA6-coG;( zXX+^7a{QEkMzhI4c=vSrphWX1IiO~m&MG@H6E^pWHo9RSWcrR$3O%-pf64eH!q2~y zv8hqAzx-$!gj*gZM@b6+Du|N(JlOyqF3Ul^IBt4)4BxN}t|@k|{s0stsEydA68K|a zs>6v+oY|Fxu&)L^EGzC{@${|M<>$4EI&UPMRJBIRg#Bpq#x zltVHmoYKrgJ(ITlOO;{$wcrIz?7zpi;OpV|juAGaHFla|Hz1y+5}T|cI7nB7nU-eg znmVm+hfFzI@>iA|1{YquGBj%=@4k+Kx*mZ+Y7uC0V(K(KN_ z3^V>A?)nC(#IUxV;c^UZNY8A$XfKRy&ROUkQBw{x_0{VsbK!4*#lS8}MQ+W8^BqeY`Z| z>TA3yQ{bC>esxeO#%u@wIF^BWTUK<5RDYiD=A17DwfSq`fJ6Fc8#>r9o z`9hp~*OSBb^BFjAS`XhJg5HGR1Lvda$&o>H4h`eDyoKsYQUdK&(Ee3DIl|s9JJgqJ1f9`3NfAu;@<=RH8=`$qeYv{cu3z9y z73~ktl(Fw?A*0b3BiL`Xa6iOuZ`D?hi;NEi?|{PuJY{uq?6 z_O#T%pEWz4`?-uAYamyvEY3IK7qg|;ysmESX#=@#0^iIUx63#jcWL6qt?mK}L-fh} zI3cjw3+gCP4~>^&Jp|l@URXSO5$9L&OTFyx;>HT&JOlTc|AZN-?ez&kSH5Hl+GX(WgWF;m3hj+iO_ z3ENd7$UGBxsw>22Cb$zvdb$fh764^2a+qgT0T>TJOsrhp^Ug`lLhS(PA1g-$?<0Uy z;LImY5IAl?SP?6S2WROB!s)vSgrg@#w0ccW7t{!~( zgw~NBJe!3lMFC+-EjcRqbAg~o&lrJl?F3w}KBDI^ao*(S$|{ z8{1V!P6~c@OzUVIM{o+E9gA3ST{$H9h(Kr|5bQDZ;Ud<(u3XD!nn3smziR76S`dBH z85LPWxn|gfiDII1e8`&5`n!+^)Jv!_nX!>_U;-|p;0BRNDK_8%}C+s4njtg#$o$nC~L@fqam z$%G#bWS^dT<${;21a~e@3^3Tp#`uQc_8-YAqI1+#z&gZECdi>u5%$I|Nsw!Jp(ZZk zp|5@h(DWv9OYc$piHhb{z71`wEXnW14_gP%cx9C%&v?Q}76RXiouKL;qnxPPw#Ukz|Wox`pNI9O3iG~}h)2K87us~pT0Vc{rDEsL7VUn$!#2T@C@Xvz8rEnQp4_2fIrxE+-FIX?NjyoH?5GDIL+ zgp7BxG^NvsI@MXg`&5Dfm@8Nw1Sa!tiBBUc$vgYCl)YW0NNf&1s+AlmJufI@i(1Jw zq%%19feyaH!Sz;hOjz?`XoG>bi7Ry%`i0kJx90_8fXq&xmcs%u_~P0uj&B;yFYxH& z&#Zrl{AqCDV@AD(Z`pM zSUPy1iY!Q!<5)p!xq}=*L}OaZ)eTKLv8Ao$Se6(dd$G-pWV5_uDlu$>wxbN7kiF>e&>1l?O3+* zOOGn->op#}awY)UF8OEIczo;^XUF^zN5~__@6EW~x7MS2z=(PDksN%1$|rjUk11@H ztlIqUv#o1ALj3BD$Hzoy!0k;X%88hMR<3+0LyW7b2`70n5W(Mf~%crA+t^EJwmOYG=tBf zh_I1U*x&~VhuGe^me8=Vu!Pfg+h{LT#~gglb5Goli2<%`;RU0@ibqSn{;{vXWu|8= zVVZ8>qr?3;j@p+ae*s$9z$I?$4 zJy|2JTkjBUcI`~u72m0Nfq4F57nj>#autrVm>f%^x_9tZohDFgDu#>3YN1yYBi~p<<7T!U1jxmWk_y`mXSUg_RnutUB|jDu=oX4 zUq}1OqkzINVBCCL%QR1C?8CdOC||B@x=S^}y@f2nau zaN;0P22NmExt4*_%AZ^ocMA#ghTZtW42nTD^yD&pL_}KO(2d0{v;<0vM;Tf2LQ6fV zHz1h{EeTS5Bbn8cBtKTP&=M{E-B3R}T&c1#N!>86l$|_<&(|kxC}rN?divY;W%A9i z6P&MBX~THf&NMgCjLB)Uxwc{98TNd$InXfS3=7y|t}ks*HL=cH%!B33XRg=-dy6^1 zF!mlhw#A$hTp19u%_LD=Y7-$|<4eEC8g4a@@%;7pUGinw!;w!%Nv;Tg|cEm8ZnAP~CLwZ~I2o0EmT{oOvEaK*y}9?ipTMzAJ!EMiscy z+|Dm(a@x6Ci2TG8jm?N-f3vsq&7smbbTBvH+$en1b+jNLQg>^_M?tJ}Pxi2=Pp`2* z^35&6%>pk)$8(Z`@IJf7+H5oT^dEnMwkF3ewa^HvCZ_q+HICS7WLvhG>qsug?y{@f z%+;i6pWJ1x+s!t~bEJ_)Za0TX6Pw>-N!!iUD>tWo>~Wn&7D43JtuM38?dDX&oqt*N zZ_JI{aWw`lReWtTY=_y;^R=UQkp*eN?l6Z)+m7C4^LL=LQ_JtN zeBes{Xe!)cZsfX;mG3Y|89qKuESp-APs0XThfU~``vQxr=^o~d3rAgnahr^6)i>tG zQlnA#*u`(mHp3f5?CCe=PLf-ZD?9y16+c#Ii`mbEIAD$AqrP}l?JYRsqHoRbnWGhCBkK7HeExpS=`OZ8*IzRX!d;Fa_ z+}C%Ak)p0$B>#c{J7{FJcA8sAZ@g8?M(;F-)H(YeeaB8K-zfBRyxyye6o2BeW>vaE z#D4neud$&2vzs)gM?19KH{b(f%!yTvYJ9w8J*lmuG zE{wz%d3KxMsygogf=T<#RGj7#K?gPGNLP#4nD5Q?q?QNnven?OooFe$>4eRWvO{~!kp{n`J8$kW8(ahK?bAe~N|}2Fb-t;0DUFn+~^JM6=wC<+cX4NtfgLH4xV?A z+VgO(j@e5hVCQ10F~lcnc{1az3x|x>MDCbWeqi)%Am(?pUxAE(ci-eB-KQaN; zXdCC=XCD`s!~N=uCRzd2nrvv=PfeX59#N6uw5BFQO4&aJ=6LBnIB4wy=5#}~1#Hy; zbFj2%zAMY!XZH7|i77RC?m-&yvhoFKx*JjkuE5n zA0&#Vh64xLUkA-~rN2KnvTBFmC*R@gN<6=uIlw+Rg#0q|fXFXb4w<8(mQ$M0W_I`* zo|<(6*a+}304(}2#<#()yE~H)n>}5tjQG`6OBsoXT@WK7ulv-<#vCzEj7j>NA}?FZ zw)hHdHBkf!h>?3X_~xx)-anda_`jJ!2}^HH{1nS7pmDW zfK&MeNum1A7cB8VW@Yr!GJIYIIypYC(rBjU*gQKJ>Fqt@5*I_ol&&bfl0nd*7od{_ zRDJ<^K|t@WW(DZ6-G$Z8>g)I77HxCxHC5c9+q8s6U+;C2fG%6j0t(GBHEwm~6GI{| zUugN-ctJqSRcMZK&10Jj%~cH_U17%y&F$r2av#5==4sO7 zth;R4QS)diri+mokC`JY-&kgJnGi(0Y{dQV&PLYkn7NJIH5*^-%sOTckcUB4_W3b$ z?+ytiZlJJhn3qO?vj_Mz+v`@KJfe2a*Tx?`2H7C)IIGLjw0x>q%E zfHH-9RCj>#1jyJ3MR%%S9Uz;Wp~?3j2MqqiMgGPC(tT;Q1C$Fa ze9&Y;?n`bpI*SIFtE&6dTT$dw9Hcu`F9E_`PowTmZ5?R3FU2`}d?ehfssp6^)UTWD zUFr_??*c8I5PRWGe||=$psX82*^tXKon1a|?kc%-GP1fS%;Ti-7maM)33IeGsH2gc zK4JC?4&TjvFEf*mq_)CCK2iq=t|x&||2GZc;|d7B?!vc%2;q7M4I#Gz!pS~HHiQtq z>!TqouYj-;2nz{era;K6fbdQSBRc>DsTU3|o;3eQy7R$Zw&s+%df?)Gt*pr>RgLY0W3_)Huf^}PV&qKHmO zn*L#Aip#h_s-Zbs*fK?J3eRS?Mfi+Q&}nnSkg*4iF6AjH6w6xI`WPMlKfb;^pvvO= zn|q&omF3O@%D!I^1w;@R6n9iqQZ!UlTvFW9+%+}J1>7pPvRsa7CYEI`scA_r6=r>- zGDAzVEJba3Na2F}8t>=K^ISml_xgv-J#*&FnKNh3oH?^RyB#$Cgspje>GRxKdNo*P zVJ$UZ@3d;!j_axmWJ)cn)5{AB(-XEj%6ME?x_-hoOWE^eIZZxk3sRqbgVoAan?1+u za``ZI{L&+UcAvC)C?kOJDKK*C8yN8tgS$MVS|4J5=f$@KId#jo8g#}`H*+;;mI0~^ z)72TY0u0cVYLHXue+etkang4Vp#8s9Rp}gN?^J{A#>iV)4RSF+bE`qlkv*;& zhrIF2A0^|jwM9^`pUkx>Ww@|VLb=T~jFw|4>R|~it>MLSrEoFQw7JNkeLva8EB~gK zQ^YA-Q?~$;?xjMeaxxZ z$W<2iD5v$OZB0!n^!;huNkxE*w|}-pHK_HR8DqXk`ls6SeqfqwVV#a~nO=wOLX6gF z3T2nr!pQxMO@vyzm*XRn^I};=veT^Gg*-kAwPUL=6*NC%YihoEgvOq+weTC-;*pp& z8<{8QqcgU)Ime#6T6q9vv3C6iu8NE+q}s4;i>t3ZylUo~9+Q7Rt-Pwd`7!zFHRvnV z`TCdY#uwyI{>2t-^1k>5ccH#_&a05R?iSkktF61zrJa@j`PJ4yN&oE@d7rg??33t$ zIc-FKT8r8h+l1v}E-LO-Z1b}ea%ya`ZG&H6N1aJnPH@Nr z66CK_;04<>kBaqd7;!nsw}RGQuyr#x9!2LbU@7l9iE3T6^|HLb1l46-w8feSAE1R7 zZHxSTJ2=VlxXRPXl~d>?jEU=WQR${XZ4E5na_SpS<#B4|CEG#2y$!2Wwt%~51*_~v z%Kigb?~R8^U;2kF-O}JC)cETkw%D)|e9eu;Baxv%Z&cz-<@3KhgR;Yh9;MeV+8R)| zKW+8=_qMIcQi0CW2jeL0k}b&c+H5CJV>rb;iFQaGaAh9wnKGJu$rj+2&0_FojL^Sq zMT%#PE0zCctKY`|1z3`W1ztRKrDicV+J!NY8>#q(;`wq~XuQd}VrU(|cvI$!%zUy&o+vv5jwbqGj|MJXHrX_CV>KpD`qoL=)5L3Gh! z%M83ZrE0Fz*Agk&SdxA@#Y#_>+x*P0l+l=S+Y3r#0RAY)O4b93oTCDtxUH~FiQmYL zl+zL{PYeu|EIod*)y4D0mF&f?SgvnzWDddzJzQa1klB7ID?jc7voLyFDmXy4C~7%t zf)g67Lvf@66!AY8N_&Y(9%1JNipKp@g)MqtrPr@waephmoC>enl9j{v5S6)RYppz) zRYob-Y+c*b%Hm3$1$heiau5f95t_rW)LFOAZ^lmCz!ZGa8gLFbS|>Gwzk1EqR`G09 zvG%&nx80b#_>iph0rA-=@GKcj1cMhRFoQqoAnTc{_|+K1!LtGSy{VP@T(>3HeY+l4 zGvtJ4%(tE~N3?yj9rWgPTcT2s?4Tb|hvofbd=GT^3@;xg_f9!gUbm$v8(%CVdxA9} zdI2wiA*T#hS6^tTaK|c;zsQv3wLGy3eLhDW&kLhD_6}kiPJvVIr$|)qiy@7b| zw1ZYEyRYx3_Q*wCN(P(kEP;~{hoqh6Il%hoTr2&0%N7y0xd(qYbWzk! z*$9bU#Ms{~e7N-UkZOb5wpXk}#zIh(U19U3a9lEhUMw`@cr_7i2 z;rNZ0^?a_Cmfx|BY~NE7T`u1$svhdu2wZ4Qk;Q!Mspcb>`B)mna`CdZ2aWi*!I<@PU(ZbdFsur)&3YT`hf|EW<^~Zf-v0 zT2b3ZPu<6C<_;Juhfae>QDJXm6g96JMT;BiqbNmcW)`<|T0<*+df(QzpLe|q=NXli zEEBY)oLe});xVI&hy7n8YmTblO7v0Hyn0k!h_zC$2N+fF1wAyX^6@3!bq{Qb-M(z> zkbR)@Tz$=LC&M{By;?tO3swr4l||*%tRw=!{12If&l~@13yA@n{JX^*t_xO+{b8n{ z|20gVtpZKzlDK*W)xAV&ARHZG#jK8-lZC#al_VP6y zMbnrk%4!&aV$`p-v>WWEqwdtGboA=1Z0nj0B3*g6d)bD&3sFu9}5UV1uELo7S#Bg}AUH1_bVZ>Tz@CB4od+2tP9d6k8RM zB%0$X#F>7~L02Cul_(<45`dC~!whMj$A-vbN^-v3GQ>)gEyB-Zs}8ho^0v}S3z&=! zEvMTSu{>^Fh_RU*!2^v~ckHJc+sVrYW0!Y80Xj1!8)1dvRuLS>t~J}~?nXh+71-Sd zL>88Qw^2B-JKeB~-($K58#VNLObzV@Np7u4b*yx^mI$|a13;m*MTAo3Wu=a_MPkGb zST(ud-R&_1-Wmw}*K3RSli;wmC6k=@{DsBWUOGJDf)%5=j~ zk+lO*^?ElE5qP3ALQJsc$;_a!;hkk2tXkCKr#8Ba#+HnC;hPt^iyn%}znsE6L{P2ksXT+wlVLvo z)XziIRYq^TP2)U7jPl}HE3NSmEzKEs=(vZd7ZLaT%}Ojv?dT_T6h8OJe`QB=M+(1k zdi4zvOz}3<{%0oY>|qo2%-$6=#U>i@-?wa{f&Y`xO_+o#x0AicEgj0}tWCsP3bC3a zS0S2OPHJ#6+6&QD34p15Nr;9SJxqpQ%sPU`+O-4Y*)VZx*s~m+TP@G5>yW29z|X~W zZ)c;H3s$v5d`=2gXS0*O>$E~9RoFAmx;#qti7KiNeEIxgs-YO$4^!GjL__ej;1hfz~HqhxMu>62e{p28)bsIhMeD z5Qt~|bS$eod~ux$>WE;aqnAT@e(xy_ar=#&Ywp zv#UGbv#>?5p{@w@n}uu%lx`I}=VG+gO5fsUi?Xz}gRI`7afc_Egt6OJ%@i9K?R)hh zM$^D3i;pL6Y@C7JIe`Yduc(sUCgJ0Hf*h8+k2pPEY|GyoTSgbWMX0i?m4i$^VovD! z@p{BpN}?*_`wgHlW)xA|>`x#1hyZ0(%Q8CVBf^xoTa;0$55(OA5FcL==M~zLCk&{Z zr>M zOc{OWC+x|?qj|;pP%Aiwkb~?E527;=xB_HrF4Jcqa1cOBtFky z_?w=iwf>@$ZObTTyHGoP4&!UCmxv)-fM}zfax16q0V34$RT}hqd;t1$1wgL{h$K@N zDhv?u%1a~RRs@KIfc_)(mOo_8UVCtz+6RgRZ!aSk_FT#(rFJ=)gzD{WFTs^o-E*+> za$@H9R(dy3G;>RJgW8bOE=tw+UOBw)H>v$ zd|sk3$5;!cQrlck0d~h9)Q$HF{AIbuGoCTpiO4u)!&347*C1Jw=pIlZD}W4SL)-0^WfO)?kfhKiW`GX^LZU=sqTS4l zWJaa42$T8#LQKa8#nroZqH!M%Y7yrqm?V7uA$laoF?gRPw2hd93ulgPPVC%{^)v zq;>%?wY~`OyX5kKIl|OcsNISNeU814T6@#v(*fX7RgCTg9^+)*cd$2@?YZKx&So{r z5}i~wqiu|K(AD~4U#*wwn_NmB;MpCIfc&Ek#4?j|{0pZCq;ddNnw=5N@z|%Oer+XK6?XH1r*K(uG^lC%lE7rx{ zXZxielBD?)lrZ`sP`D|nw;Xh~p=hW4aj7;1$BCBhzP;&SMd2kNFWmIM%cIWlLg}~< ztRQ++ZnDll!W)M?WAjO#WnNke0y@$Sw`W={l-CwM_O3Yi*iYYdkXLKr=k*{`kCGPf z$e8j)Ih~Iap*XzoAPz2Y5j#_fjo^y!;8Z`Pl=p5p==nw>T=8l5fHpLO&$%NE&OovV z_uvu49aje^YP^VO`kSHtjJ)`~XidbH|&2I^L9 zCBql?fb^kC*^uNzgj$0Ts}W~ZM>J&QYd2`=VN#+*;XTCs-#Vu-?So7k?b-VkqArcC zmvLNeraRU^*uTYbYFADn;o`YJH7ec%KVHV)hj`c);-FehMB~V>TUSY)b(tqQee-i( zRC#5|5G*2SWk*jxn%G2mDVxe2l-mS4x~wtu=iMg4uKXPgi8c{klubx@H5D0cjwR^6 zu?AAr+Q)+h9L!;^UuacTC##x{Sg0KxLmQfkhRWY99#COZ5f;?Kp~s;1peedwWxV2t zx;JkGZC6KsTz*DaWo(CR|fG+Ai1j=%RHXof=-MF z@8}vm*DWm$+l)ujj@+(Yqxx-u4*IJZRuz?{4zf4LT=X4vYL2OATO$bNrRJio=?VIh z0nrR_O9J3)>Y4<=yKw+4OA>>Wt^N+ul0<){7ZM#?U`1Bg5P4%;h_K+9N!6`^c#0&a zg<6O2afM@Z3lUs5r3M0;)cdl7j<*nzZf!w=+jfQ~wh)1V|1^Jy&KZMFvyl|nQq)t9 z{{zF`Qux+++P{Wf`ei??&jq!1h}q3XYg&pY{M!Gct7|TLL3(jT+Td{}+Vq$3CAVa( z%uOH^mJG+VA_h(9kPHLyU^op=7GdV!htvFI;S=&wiNn~km9|K?otQ74Y=+uCOcp_Y zO^{;AkCj}?DdKpA3)T6;Bal3si&|@2!Ib)xILM=w2(9~5)9R){0)J`_YTZh-^4T^M zrxlz7_D%dK*{9Hlt>9_T2g+NmM0CUeEZ`qw#Cha^p_1Uo8*xt*XCvO^J)auF3j7Fc zK;T}?^uojPugi3QCeI+e)QG6cl@;b73ThmMPv7!jrIP)Cv8`>7QvR6@S9r@@4=Ha zkE}_5I_Sf;qOCdHn;dOLOyr*lH985e=dqCV$v^HXlgs5-OZwCBMwnKP{{cm8hd|P6 zNW9VxE7zGwY-@)F&hBmZb>~m*jOoul-9M}%&L>_CTi|P~E65M~2`A6)?&(wA!lX`c+!f3-q2QBIV?wh}JpLQVO-SeW} zUwdG?c@_Bm7KJW$5bZkte!MmSc!&X;9h~>jWUbrbf9yP{jb*qTJyoHt&o4MAJ4Mu2 zqFqe%a*AlGi~!`*6quw0I-er0^z2>y$hga8kE%$ERoPE7jygkIjZrCcv4YXuI3I8q z$&?(8r!^|iz(6W;GgISEqJ@%w-a%tKp{|9rw3B$s)Q_}IqPgM%aCm2ck5R|Y0KY|> zI*Y-kPIQm|{6zy&#nYx7`YcsM)=Ll3+cxXrhC`lk^zaE=WRubbPUok=R_fnHJRjdN zm^U^uWe4bCc^L_AD8aQ2@GN#Rnw_-J{Vq_Z03`goiWikvPrxnfiU{H;B);n^S_efJ z;~o`OcPM}mu#xhzdLci&n+Wzl9f*0g1;cp*ASIjE#OKaisCPFA;_D&{jqN5XeVwy_Fx?$StgHc~&bn?^!_pnhQ8e>TlZA58+(W98A6R9i%OX!2YIB0Yl7V^_* zLz+0mVtPWPg5aA^h|tK9XCB{+ZEESgm}{blJ|fhOJrJ$2Kk6}c7s-}uetIg9y7k14 z;Kc4&Dd#inaCf-vuXo3QnQr{-uK4}zAh#aqwu||3J%nO1Bf6WIE(Vzv(6V$98aVyb zBRuf1hbE=dk#xjzJNkgGBVDwyn2l5*{o7O2rd~ZofaQPQdTt=4^ujn^(i02xr3`zo zCrb3-)So>?dy5;VqI-$u%AKGGw7(Z(S7|>w=;vOdzNP5qb>qUJ&yym`a=i{v+dhey zT-Lzb^xTso*0P*ITb>ln{94sPzoECVg~O{njw5#Z*+QjH3cDqovFc=C?NNE!LWvo0 z{&$~n(3A|}-`x73j8|+n=+P2aXkl}nOJ2q=?ecwgxT*$<(Wf)KK^{)jh6_7*{=B5K!Lv^K4wS-nMC{bTpaDimvqPmT~IcK4OCH-hC9o@MUjJpE8>Ch2e?2TSlY$ig?Qg z0n9ahF-UtKH@GS3D}u~!_w%ipqPt0Hce{-G^aJJx9>84KPc)30d`vEULU;^;8@ATk zWp7>#8-DIN?+0|EA4LDN13mFi1_Fj|$0YSgO74$FuBT`F!z;Ubvy3+O7b!}I?_}-} z7Qz5z#2{nL0FmzT%(v1CH}}MAKJ(LrPi^di;%$uE)V{X}r`rR->D^oOJpX8xg~(^y z8)eit3%13I#L_G=M0xLe8I@$A^T#6*HBdAO{JQWF{gk$>NZUk{28wW>oSSGC`Y)#1 zprzC1fx@?S*Q+KM4DjZag)p+sOODG+%SMyC_t)JCDU5c;52+7{_(A0ZMSyoI)<8_z zY1>yXRVa9n=w&%t3!0rSEqL&dnTf6AFKN7AaO<{4Daf8n5%VF)qg=l36mDZ}yxVLu^1 zTSNvti&S-iY@>jQ_!Z&8fSb>dL90QAjo5)SipJew6p7*@Fg;5;kSc_S!UVl;~;s zcm-r}Xp|VB1nsks?`RPp-oV!irWVO>zF|_#)yE4?X`nUQr<-W_XiRv)308W4G&Z2G z`Iga@(HMre58*J*SQx!dPh%6Q=q@@T`)TY{Cjw#j)0l*Pk@)s$F-%!iQbCQzAjUNV ziSA=WP@Ak0oEIA@cYUzW-4;96T~$7>V0n3FB22grY6cMa!F~vhW%1kpE7v$TD{EAW4rnpsLme;*Vk{mgWed2^+LGNBexqCa-SfY1W&zyP=$VYgNw5$?Mx=NxRgFz=jQF|!oQA#m#Gs(ubgbu zroI0=tEsL52+6r%<^l<dll9Kqz}rAKR>3 z`T_f@tRFdx+D{aIp`S=BoU!1h!*@=5PM%`quWk<;y6Uw!U)%gEyzs$|)rp&H)9Vuv z!0z{vgL0-p9sit&xkOwf(qtJ`vU z_z5(C6%*#+3A^Uf`Zhf|85Ve~r-QamMpVy{UP0xP#WTv$4;?gQ3f8yYzrzu6)pm}O z2T{b9trl7~1(U^SAjpQDngUMRm80HkQ$&-r}BZ zxfSkyARL@Aw+;769*fOdjQ`>5$cWmKv$EbVM#y?`pcDg8_`GMK;A!y1uDxraw$m`P z=i!P6*hsR>Dgy_fOcM+M6go)u3ig&#O*z;qGn8}N%{qjxrcmHQ;~@ZLKXS~49H7z3P7ri+&D?eG8v z`#|el=!CylQ2Xj8^OU6xs;x)ma>0iYl}lv!+qHB_tz-DYBe2LtS}(UU>ODgwnByl? zM31`Rls5zM?S!2Us+b{yeCPixxj8triW|?jEo7f5o^<_S2b`wVs79-XhKA6tBdZvSiAOS884+2d)**Px#D4^9?uDz z<=yK*82p@QZ5hL zzUd4l<%&igJ8-xuZQ-mmm+8?Io+JEBOKD-QXsnFetTT8#7YueS23!B+iWo}}r~Kw4 zv~e+y5rQdezDQ7BJXb+W<|7z95{aGju@Xr{;{1G(8CJ4MdST(x+(10~xg0&R@%uU2 zVXYfT;}*cjU$e=nzh+X6(&rk+DZp95~m;8gJfEEt<{>cIj?=jK}w>M7h+PF*PK zo8F;u3q`uQ|1p}sSTvw>3x&Vg{}|m`h*qDcghe9V^g7L6B-)$$(!oWLS^P$$xL7Re zn}7Y5#xE32>FLEHkheD%1F;ux6O@qQ{CkVN$jTq%W>{++8PIaupCjip+{X@ z@=q=oJ57G=>lno|W${cD&q3@3#p_Z2E26zEzn>g)Sr~IiS6%4sPXVuDQz3PvL*F+` zc~y9ZegC>151rdbpPj9|NWk=DXPc8p6JHgLE!m^dg1lG7Q00|FrDR%(X~FTDgU=u& zC<&jI(eRaU(>^MK5LX5XU#}jQ4FkfP{{NPi(&m+-PrL7UgLHWm&&`^^!Drq4IU%!; z!<4dNVuMn^iVOEXn+;;J_9{*4( zH2j~&)nR|uY1&yXriHNgD~!7+D;VAN4Q)!$Lo-7J)vgPCUpInp>!i9E7vGt3`LW zuk|@S*M$<-2w%VV4}eqj0t9ayvVCtdrkFa1>-f+sYlMfgYJr8`TqDAhPJ9f}Lh32T zOd;iJ`-_3jQ(F3yD?D4|vCv=rtCY&uAgB=VcPT}$#bEmvFRb)l3!}XbiTt%I#tbcYsIdO_#4 z?Lhl@orr9`c%P0o);N9zd+5X&hb#;qxlxWI$yh_k!2~G|v?ly!p*n8}-ySV=q|~S( zo-u_iKopf1$CAgE+QjKEV;;A?rsjPh2!G|Q1T8-r%`0q)y zVwTvO7r8gEb%r0TKe*d)B!-8k_WHgus`$OOH+iiW)|@e!x+l$dA2^C;XAT$agWG_v z%;1*F-pSq1huWP3#qd<)xGd17)DX$74|QoxF?J84|G;l2l|heCDR99>ckR!k< zSbew;c1U8n4jA;#T&h8DFdnF?$yGThXlo@o#EBo4=P-jYglJ@l{8bPt$wkmwvX{bL z9{R0LdkX*X`nHrBZxGD_wqJrUFxX^l0WFcJYd$Ea7dD8Hoc@a-7^p4xnW4@_T)aKt zy4>~mQIMx~XG$}H^~3w}vg4Z9e8pwr6o=T4b})&W68 zNra*LnM?A0Qw$D&^CA<*CN&7NztjkiX2Qjpg`d(}nq25+r`>Og-b%<~!v=(I#F5Xl z)O4d*r}SB5SRf7d$n3tCEN_YBNg?0e=jCb&sz?3U^WeW#VXa9EdAk?cy0e#yOwE1k zb=~Z>U1-$u;4K*UfG=R&=Wm81QoO*ZXwW7RWL*b}Y1F}97jKcT@u^MgHX-6W{Rof` zZ^F*ktez+5FUb>il&d=ty37+Hq0bh`VK7Q+tW;t2l4R%r zP)_FwyhjNX^4cu?+-|DaXPgJYQ|~+&-yd^pa=QC-C#TOj;a_Zq2hogv-7ID*$8rqh ziEj)4(Dy&9t~OiFf9M_b&_L_7R4Z+MTO^413ALR&MlNRh(CY0+SKr1aYyb$=eg_ls zPY8rkqjyA;fY0agDkMG1&dS6qL+H!0M8t!zp&vji-og2o7v~}V@Qw(n+YP0#VnKC? z7$jKJ5tRJ;9TDcSb(?+{!2d@JmA@kbdR+h7iD(U+&T2K3w?%N`L)R%B!-lx9Bq-Dd z=|%M%prFTV zcVVZV1?0-R*uqIe!v8(^FvYkA*5N&o5;^xPea!{q#d^z5M)mxbp`AO0dH+4()ASau z3OPARVLt!&o@^qTg78u@yQVO{TJF1SbPBaI+bZbDUzWhNTZL80#}C)7*gJm>iG;0U zh{wq-I$A>j;x1YOUGpGk%?-cyGv1~5E9f`iHHtFu=Dd%WlMoz{cVN?$BW$FK`6u)% z4}Z16C^71N6iq^6>HA`!?fG}~Do$*zs9aSvCBT}Y?c0hQX%lV!0vu0B!)%?Qy$Vp` zHqq9j{B0dQ4S*|u;??4Y1~Tp3Cft=;_;p~L=wKUV;2nOi0$cEZn*C}snYZ4npor}l zSI;4lwq2ywE!wQpivb>U8)G8VGp^o#My!Tqm1m&bez$_Y-i|Hdu?C<3fXeNnzDKeF zSP4Mm9U{@=L7q;v9{}Ta0ONZDP#=KxJ4CaHoY&df73sav^hcx9Fr{E%6lxt$l~LIa z5!fJUGteNsmFRD6-5%Y4xXlt}&F5H%c6Ek>;&);pvo-e`nwlhh=&7ATD0=~)xD(5o zF`r||ys=Y+g?{w|*g_+9)2kCmfkL;{&gPZTPdh~eWp7J`9_$p6;lB^B8i_^lQE^c| zt|fw}=#6B}G`xZ?d{ifp27G`+i}};BQ~H63$bR-ST}Ls&!SCV!jD6=9rpq`&CLSrs zbn#rY4=--B;of@8Fx+z1M!i%1*<3-Vc8Tx?Y5$X0i{zrW zY95uiJq_G=t41(~ohTx+qxE@{rD}8`0gy^v#XMGzBj?5AP4|5fQB$@JTh~76Dp=d&dT*WO&i~ zgdB2Q7nUsF80A-@e7o=3>E(-2{^3TwW{}_u>#BSL zDVJsj3C=M{WPe{u9X=Fo+I_KsRa$RrHqZauiLA|UG~$!w&I|xtcR-PWkiv?E-&s^n z`5)r`#`Xs^e30txI)!_@d?H$O7cV04k5dzwIQxzIX=e5gE*#@S&{y!tY3g2#>8LkK zY5ZPnr=M6?N}ugTAnz4^!EhfY)IUB!hlK2duDo4XO6~Sx!TVh)W$hD@mIa(OkF$!A zwP~O5jSU#72Zy+>T-nef?I(CTCHQie-VoN_KBFx3`#zBzJO*dXcn*?>0`Z2O-hpe29fTrSA4rkZ!)Rw~CvF$&&8H`)ETRBb4M>VUkuwI^z?Sn7Bu+Y|g(Ja{f zWzD6CByZ=o{d2UGZscS2|3-T-(()4#(Q->$W`sL($^4ZdTk_j=b|~4bxIN8%3>9a! zfKwKW?L#8vv}?U(TY!S7U0LdNW~uz5gxmc;rP_*f9H#$L%mk=5Y&Slu>8X&w6N7P|n0OnZA54(75s;~#5wQQ#qX zXYE%aRB;GFv%OElLLU7xMgMqN`_x!ySpLjJFt-Z+^&_K>`x>w8f81no~2PG7U(9Rd~q!%mQFb=O6OtnUbQBIBR*| zfw(GuNXi@JkMyW0t>UQ)dZhs4z58$nohlF!^=cu^E>Cmu>IK@z+cUYm=>zWn-Nd6m ziwfRw54Q1=Q!3>7Y-}kXL7(Jphy1gTV6Sb%CT!;%LC9?wgEk+5J6V9p%;!g-XxB5Z z(^(`$+95Xg>CC(^o3|5 zevi<#ypgu52STA=h!KkUEiBrP;xzZUjTTDc#6ctm9tFYGNaP$9t1Nf%d^GueDe8Hw z`r{Ta(ZywaY9jSZnCh3Ga?tw!A=0|{OI%&c=9kSdRuM19e?XM`dkJq^=+7_3Gd{2E z2lrqM&&(f5;R&D}qDCXW60Lnw9?fxlQc8Qig0V;+;-DYD!YdRd2oET{dP^?az>(BdUIu8Z5I0HxT0|=9 z$E7s&YY`S!`jM{EZ4ERzBPRpMt;wRIR4*Sp&*$2HhM@^r)!Ma(;X^^`!q=iv&g4Zp zLXGIv6z!l4s4$ZY3-CN;0Y~emuxh#R(0S7cw{U+!D~q%qQW`pXHgka4*eGD<0viVC z9h_}2QPupqBTZ$rq7WOlNp0`aKZV##zMtiwdf#9#?57vei9^1D)gL?ZE@g4QA$7GJ22NY>Q%XI)6S2W#|BK0XODhM$tKW%$mTM3PVg7kU8XQW47K(yt z=u39PQ>ypp^0=DKxutaOJ7Etvx7&%d?1`!lDoJyY-!Tl4k+`YU_87EteLn{+K8DHR z?TGUHPmkeDwX$$mDc%2GM28LB#UyljRjW-gSJNIi9gmCVzW#F=M~cCiZIb#pXz6hg z9qiG^5F|9lxbXp|)3j^79dzut=-_=~Czq9y&t;_;+|b#c)2A4H5# zip+o+acZ0ceC+uFvp{)n1^w`YXx{Oc9i>&TAwg>L@CZM?YpCe2sgBC3Q(|n2d2@+{ zDP^Q>0GZSx^wOvur8K(;gh!`h)N*1b*gn8nj_rtWGNin-gFH_lYJV^T#|%%1q`+zO zKn!|cWld9JU`n%Jwa~s3qF=-5+tFaCOSU!+w*aIL$#XPpcT?~s`>fQcDB!Qawsg~z zVyaK8Z7iS~Coj@EIVk_6Xy|kAeLaUQk{o*5!S9We*b*-8g<11QY(A``89$0%!3Sz! zra;=7mM$aU7dBhy+>avDvVALN-pxM>zdD?o4i=qHpJ7G%6HYYF{0U>P*Va;c?I+mw zj1))y?w^D(HOT!Nqj?3k{;cS`k@NYu)}pACT9ANz>y7=FcIl4%i>Jg;ljZPgM`eEM z&!US-S>}#wDrZERl7+<2XRx{8|AZso^%pVR6nykWImdxfgc_v7BqM-rBX9_K&#%JI z@;VUctzWUae410={t90pnNzm`^RUU{vs_)K_tMcXFGg0EvtoA81f*caU^13Rxq@S3 z_WTnME&O^`#0JIc`4A>PiAf*jFnh`z0|uc?Zx5v(F9|$LJ%R3A!Y=CH)ZhER_#P`A<*}F~n*1%IEkAK;$luuGU;8|mSpT;eYiY=^TAGNn+#7>b z5>oY#A%!hkR+aydoWLY^FzR9ri1tZ|s8E97j%c6Dgn@FK&q{^T)-cqXh|5q&MErz17!3bu(q=G5#fVxlFLQ&+CQ&)Ry^lJ8Y2zE>u(KOE=yN12o-<*&DsEsv zSgs(PL_W7fhwyDk$&)DhG97bd^^osrDW~2Ku=szL(O2Aph3dkoL$^fRaI3SRT%tgg zcpugnQri@x;177+f|}eG-7JeZHRm=)PAD?pzAc(rq8aoHg9>n;xbn7$3_Uwd=SBwc zjAg8DzIxZWrt`8DC^Ya6+B1Vw%kGGFmgbx~b_doy`D>%*f2RUuzAM_E2j=3Ro4e8X2Up5R=)vmsoWEhYVl+p4n?_9AJ^6Hi^#fr44AQ2IRf}lz%6qC zr$zTgS4&e)9lsCReTNIr*Y87|rzQau_W+#9EdP@S zBGDAYOLN2waitrK|T?L%sQeah*!+&7Pc4g|1VY+N+G(S3>pP#P;pTN|E9< zP)E_Tf9qM6zpoM%`38=cB~i(0qY_FlTXS2D^*TFF=I8~6rsLTFlNzbizi6TUCN;(K zG_v#8o75Jjc8#8K)@}zK-Q~fj86^~!7IQedO*{Pru;8lkkE)6N#1ayU+RCyYaSH0L zs4+?zZfeX>)FewE2JKSRD5X=eg-$7If)W^p`;Qhi%zhg;EOAV@NA<|&_=nEw;V~$e zYEc&|{X!k|twnvu@+u+?G}WqRS(jv1foQiMTfAS!wVYGqhn-OR3mHZLN&JMZ!>xq5T=ul7Jv)DfEFI~3=ju%sj-y-fbnymWS7Whc*HKQ?Kr!hk z$2Z*KS1^M7HrL4Ghj>x^E#x&3YP0U^OjSYu0@iZ0SFX|u2C$!tGi(5AeL(=_j2)#a z@NyqsXW(nW1FUt%T4$f@34&@-%G-#ZY){OSL&zxqQ4yYnJsHkc^r9(R$5K&b;Z;HeiRSj>@!az6L?c}aQH5H#R7MC?9YhcI}?W?vrBUx49 zY}u}PAa+4j!;}^Muz>MZeU&w*%oOCQ#s%kB)^hGdO4AGWbGh~Bftd{if0IFy_tc!3 zpSCTfw>{OC(fiuy^`%rr;APG;6IhkU$LzrG`k5@}T&$`Zjwi7IKq zFmMJ-tq6a$hM7!K-!5RFWER2GrazhSx{BH;pzps`4Uq*`uu{&;ETtn}YHY`8Mzx7h zLOYj#pNS4(DEO4G&+4k3qD4>8+Y}>FC7I@JN-4Om8rGn%&O{yxGm%{W3ntQk#5tqt zlY`Xw6|dMp>&OR>;pmmV21g58>(xBW(FBG*%F%P<{=-pf>r#rVqlU(2_IW%@Lry-# z5>7_GcHC@Vb$PX$@3i{{UpSzVhW4dsd3_{P!E~^$sy?&2l^zJlm_TKUB2w9=;9htu_f5 zXybzu94g_u4O*$T3fkeVrYQ%C%yiRRZKHg5w-z<`QOA3I5Q|7OuYxfut+|SYcKcvz z@btjBCm+?oKhB12O$xYuVf`a*oY?-&g|VT!iN)7Knw=;aP$=BN5wGDq`bS3Y0k zhZ$_E@zbBm{nUhnq4=rGKl8j1yFjD|`)_uv%IA;Zfaq6Xm78_R#e%1X)G+rxZgM%@ zW2l9u`>QP@n~XB-u=89LYyBL9aE7+`oFo5xf7RcltQ%QMe+Q`H%1k7hH1+XSc0IU8 z5rL{tX1Cvs+F62-BWjyg7fmo3kWa5k6cY#H#I&DjvPGkynn zF&Eo+pBMke*2dae5J+R|rLMRI7^H?OjYq(M2B{&67ZQ_$RA2wJn&@#l`YfPtVDvAC zm(n4iH-2}xURjNZWg?i-e!o|vvI48D46Ys33RVl1glo0vM6ep!X-T%;5*U(2#xpsq z^^3<+M&mdeEvd3Ih5+8a%ft({akzV$6aw=fm0e1ML)4IZR-*(?E;_%$CC5}dql6VD z)^mx^hm}%6h#KB-<1oDrgy@_la#>oZ?&x)F{6+RM4p!6D9DF_SmFd=6R4)`H{<^Es z6QOEu@X>fC;oLXZH*8tazx$t={s>h&DYbwZ8>Y@xPTQ{0wlFoK@m|}tssI=3ioUaf zsqL5kyy@(fZo!$s!kN6UZ2fkSh3RdORg+UoaT8 zLF3uJp-VHgf3HETGW8|yww{etdk)NeeCc*I!EE=qm|bgN5VbQ=IhHcC5lqxM4|Tyc zR^7a;YO*kbHr}(i(fvB6dafv*q8*4XrPKA))}3A2@lbt*>4NiYeT6Q)s7?V#Jsfjh%~GfL#t@oyuhf<+93nMiCX<%|b;B zznq1mXw-9*dmNpquRhf;diX7ug~g`D1v45hvj*{xLemm!9VAkhSwH(ys+HJ_zxbff zwd`9iT7w9)OFF9ncb(HTi8Gwl16im6FP<%Z$~DrOrKt@o=)(qTkWvSU;|Mw{ckqrD(9 zsP#Y-g!}WpFxAdaYeWGFvsL@~AJ-8+KGI2@ zMEiy*@oN*jed*&H9&uFAP~F@&xV^r|%Xcj_wF!<#FDp1Gdlk&5Xv;mh6JR@J9AtHr zEB}SXzRm5}jSsf*;(}*hb|bmKcM)auQJmUPc?*dPacYC)8Hswls2Er}&W{+PCyKe9 z3uA#Khzy#AvDw@G1e-;RNCa!pXXD*tLG>WxpOD88UHEK}_*udj?0PV`w+m(d3q`Ef-nH_)YWLTe&JzdZKDiq(d zdjtIb+E`5pOf_)wbR6s`aZd~dPDG;mMBv50bP{{??6G?G{g5&Y39$0y8?GM8XXRz| zVWOH8__Tpspd(Mwk#m6@(Lm=rHqc_=6zMp#beu5Y3~vGwe(hXba8}Ch;<>o~UHx=K ziq?_8f4sYiI->9RmNhhPXv0S}?l-8||EY16f9OrAsd2%Fm2W42>IBW@y}<8Jsrs&V5DyoWVzvA>~l_lk8g4{Mw+va2<2 zwSkkTYk;9~yKvc8YFtwz`(cesM|QQwss9)nw_kn|RNr8Qh8r4JggeRA8kcF{Jgjk( zfFm_-f9uC++-uK4ap+OZHv<-rs*f^{HKYsY&BD{30= zHp88H6KfP0J1=B~fFJspdG+bD2 zrAC>*&ZaS~)UY;NvvEnTE_*xD?7t6Aw1rKaRX%|#7Z-TG+Et#*Ut zZr-`SWb^8qhH>k{TZ8zcjl0y+S>c_(9&Oy;)2kXsx#La#?rE5luvUBP$69n`oO_d; ze^M|-LfBKZm7jt?Ohc@~ni7HGF2VR_Pt^flc0DbwI4+%5-{SH@-5ES@TNCkZZW(bI zb-96Fs&l@J7Sk13y0<)MqzLqCWQsKCpd>teOgD9nncn?WLMn$oXKnRZq(S2pzkNShbvwe%V<~! zwNVUiU7RT9vlP+{p`}Jk?)d83xQCf)3+&F5-RoIy#$mlYZnAqDOFpNzO?Ge6a?!t) zm>E+rGuAaOqR2AKaB+&8%u7>VnR#r%tTg{i)_=awkxspz^9k_BS5RZ_%Y_WL6&^8L zgh|iPo)k5_Whn=E(a=P=&lT@*(AQP}X=P?1#O1*c3lZ{o#)f0}JG_F(KF7B%HSMU5 zw0s?j&_<7s&GqPTN40hR7lY7YlB(Rh#a*U)7=i{Mn`Jr*ZvlaZFC}(Tr5eF6xZfoAsQsvdXmsn7vdD;(3N!Syb;n?e3zcgbV4>a(@~9Jjc)3e!0v_ z=&H6?ysQYlbXAj;Qwzhi4OkqxZEn*C5lr8njXeS+ql;r8K>p+A^+AO-`ID|C`T$Dms8RNR`hmbn_%f z7uD7vh3i`mR71D0tUPusZAp5RYudsqShVpd`v51qyQo1lJG8diOKz4IYHh2F6xf+Y zTn#`X1A=M*WG!wr0MbRcjc1#{P9Wu_A!_y2waQgfP6X3;CdDntP;@WJ9Y6J?19;K< zR%>&>kf-g=9$r`gE(^7OH2{)$YIQ07UdGX2XGc_BGTT!PDlp`{F}Rdoe?rYN2jM!; z6Y4teAZIBY-{Xp0>l#d#$9nkroUT*Fn=Xd0>d0(AD(|j(Hi5}?vMxJ+1<*Twf?d4o zFCdRIS5<)4t(p?!s}?wq+^-OA*CUY8L+#io`C>J2(fS&ShaO5!Tat#)seGgN*72cK z&_ivY?Dwi+KEjuJRWXWc9_e7whK8rB^^^CHWJ|0M1leWp)&R&}UR?!%C|=?pJVI6- zKN%4HbXAtIdEBoG0NgYuE`6G84T-MGsv4kmsz3`1#L&YqZib#GT9n18^8 znW1KS?dZ(r1!Zs)Ec`wuln;BWEtS=;nW>4Q_)VcfPp z9>d3pQS=%fkI(F*`kFtuqt8FNebm^h9|g!!Rz+LrOdoYcLiFt`GSHW1Y&~$Bv=K3^ zbv4eiav-HAfP4ebhi@p>q7VA2aZ2WKd}pMu+F#jmznq$9BGD9y6`5+Ra{A^KI*_T( z4lF!SOW$sT{||#K9~&BK4Xclv6aCa6kA8MG+F905zffpeKeeB-Im$xc_EQHcOI|Tk zgZ^q*=TAN{C>VQTkZ6ilk7rw%`lg{Cg}cqHU%|sdG88erbJ_}HWA9A;oAgqD?6drF z?ndQh1+xY_6g>B{LvenEnTq}-4*-ES%~rOLyL!GsR15i1@D^_YAXTA$x`D&uO=ArJ-u7$WjUzgdodX!*1~fn*e2GL@CV~q;|Lbulx$mxO|K^YR(M;o5KLN4_1RR zI`NDS?akv^5+dShU7ProvDuNqYru?}`Pnkxu5Y@aoOAOr8e^Ven0x!*{?r?l?6+z4e*z1 zW?Zd)FbZHzJT^v_#CbXG?tF9p#%y&=Eq6YSCYL{LY4dceFV!2P21fI}7U;=p8T&&b z9T)Eo117Jl;}LeIdaQFPRg6Kf^)NQM-CvL;u&+NvC(~i9>LGKYJN<{&5G~;mTD@=~ z8?+j`Uy%w5GI$h_xdEBLwjb$QiwCNqJ(8PrEf27o+?0Q#Ye4}}xZ#pTkF({pdaT;s zy|t5UY86=zx<6J`{mlQNovM|Y$o`Dl!o1%^S@=7MuM|sZRMnrQ;mf$X*!a+Q4LR{o zm`bg?%pbDIc)uNsE&x~uPP`!fefH__@lV(B7-)5ZZ&1Q`^{JrMu*3LpnVoIbth8l5 zN77cXX}G%z=Pk#p&zeVlMnMzQ3Ch}c@OI|}H7@D)d7g0>$yedzwSX~Gpo$o0xl#-@ zGQ#e%Di&%jdg4P<6VwRbix(;@OXNW~RzGl~WqaME@QG@Gd8b0HCaU4}GS6R;VQNfJ z%Z)1VY*zbghz>v(r)aA$U#Hm<)#gE^$8R{}r2&v9D|8W4Tzs0onW)Bky5Hf-i?~_Y z+NY=R3YZ#c9(aoCPf~|97<++xtmuH9OPtMx2tXX?wdJSJam1LnYPOuBU5#CX>8nYq zr#ZQpPES(fL!NKM1#7fX!*}DjjV|~ib@*g;pMCu~{gR6dlNM4|*b-w7(GkDTFw@n^ zuXa5{5<{E~ZDPAg zy{4+s{?Rt5p%l)Fzx9`#W@!umzD~=hLQKDXTO}qpLrn7S+4Ph2D+-%upCDx#Bs1Uy zODKRkOjElxcv?Q_W{BsPIgb_3+b4AKd_4`~Y4IDKnWnZhPmG~D&%#hHkE@`*&tm@B zW5&k%vugcz>weW)m+kN{+A)P?^e=KQtIMoQeRMOj0Drmj<@HC%?6aw6sxuu!v^@cN68gk?WXR>ZG;!p$jo&4+P%I74w*1B9c}-QuPcGC>G=Ncofk-*O!fu zAokcQu?9ixu}7(`sk6%S!`hQ<(CjOXD zFU+uddnjD@Qm?_XLSKVQ89Bq+z!LEd?%{>rcJZX$z;_??)&p4svBu!-`WD@uVI3q| zH@QX0Gp#SH8+OsxGcg(V+;Y=+l-GHd)f(h{isy2SJ!&JHJE>n?Ziifb&yym0 zVYW5gw?zr$6k=JX>VMQRVy7T>`fO{Bz$Z_Q6=5oOgv%&vDWQgS=)i1iKm%_iVO38K zM>>$uzj(2te~9Gf!qmRJb z$>G$<+%$<;lU+!^rdcDxdzx6sFPT_n-Bfn$o1=c@ z>$;o(HQv2Y!AUiU-koQ)mVweoiAeSOW9oQHZKb$S`%`M`>QT_2=cx^Ij6}nJRBDj( ze5;3-nDaoY)395X^H8EbZ229kJ0Fs&9s;TJA?-gqmQVIg@S3-KzBR&Z=6fWkjUSy3? z;T>rQbD_igpXNLTy~ zeesiPe+pTG1$!i*&6imFQhcVh5#1dnd@bp0^lBR|lF5FgYNBX&qKGaofk|KPL1Teo zH*62VRlNS03FC7c3E0E{gp5;g_I6}gst4e_k-Uz$B#KvaVCZK~Mn&*9`dPE-$(5 ze7spQse_D#$}H6(%DVi)GS2KwFKop7FC>n-_;`I%nlkTGP_(0q#2u#YORcYp_tSB@ zvDBIp@%nP4#WKy1INTWS-(qMWy9tR|{CNd0`?Puo6YSexe+YfPK^J*G!;`QlBzvUfkc!%(>Af#9ZtuRI=MrbjM$u6bjHY{UausdK{@p>DR zmed5>kP0^gS{%@ra<0y=IRV1LOcieRPh9@)xXt-yZ==(Y;}5PI<4Rj z-p6MmAgAK_<<}H_9A6O}*Kxj}L$A5`+N!qzw!UB=Pn1se?*2y;R$Ak?0tUwjFb^TBhuW2ItFTE=?^hIAnXfatL|mx&#J|gQHlc;Q79k2lDtNRmy{9 zMJ3b~D2)#9GZyL)1z3$C&d%dn|CqrnJu+R5LlqwGkSDqNGThT1Ofa%)yb|{V$lBVg z;W|k@#z7%o-vbXmJKw~?QpWufs=Atu6X6RcdbKssxAEeerf4!OypV6M9uNG`g;jiN zcgSF?F(U?LH}9w|{hWJLIs6h#k=d)Q5nhRFpDh?)uo)lZ8t8wYuT-OYD-O*-@*?Dv*0gykQeuB6Iqp#^$~ckLtBTGuUaQ_rK$wl`(X+2z>MF@of) z%9F#4@3#mcyQs0XFt zxsZfLZKpSSbc+;39FCQBCzBQm}jdFBT^|%UjQ+1b8x~Y0#Dcw{( zm3F*u4YNGyfhlp=1&c4`y>IQ(bmaUp9#i#c|CZ-5RZm2$!DFgEXrzP3R6U+vS#OQB zG%uyKbG8gzKw6@)-NNXBm9kdp|R7PtzwaNxxuOvJ8nvreo)b#wkGFr*{zj}FE z$@-Uwb=2Ld5e{0(`Z9Wyjk^1|yIFU)K6SWiF%XBc+MFb|Up(k%1TdkkY3LfSB~WvRM( z3LAn-Yh=S;nLan&R3Ao_!joCzj&;CU077EvYn<>B9R*-g#&nSIJ2r2dtv+JZ z#e7QHYz?#|UW8I~&LB_EwDifPhNrRm@HChc)pN>j&xWPHVo>w;01{z^@vIkWBOO5f zF*1=;e`&O%va&h)5=W!5Mwd-vISltIpH=Z}nU!eV9v5Lgz(tsqzvWZy53GTmrA_#T?sP`)Q>%nf1PHYlP-1QkmB(2IhVB|7p|4?ERi^CD&%7# z^A)c(dZhF5<&9IE9x~Np93~u&6 zvgq?CHa%ro{D&N$&7vog8I;Z=wpxgK3|4=tfVT-pzr^iL0rWQ z#>{q<;UGNSWg~~dSDw$ot6~mc%zC~EuN~tPMy}G;h%Hxy?`Ju32>B4RRl+&7?f=T6 z5Bvg^D}?v|$l_a+-N>SNW`!(nTz5pI!6_g8#aTc(`D|NH9$@$eHrsj%h&+uA#YTY6N&BCc?5weU3D;E+2ZDNDI1&CWX- z2J#hhjA4BWjBaD>3*|m+v~K^2MHX*n=6#pK_B8lcdQh6_bo-)Xu^XQ0bd5iFnR5{V zebvXT1B61X`r>5%esiL+_=1^))KxImSg8MOde)}=l05W6smH)wd8-*!iFb#2&R7F? z0RdSsgMlP^XSXe=@%RnAwq!Y+RlO&S(@e9Scq9Y0T>YEf#wkAokW;R{0{{xYX^X0< zY%jtzgOwm|$V!!XivIq7@W)~U$7!++v-aPj*KXRvJx7@_QASLP-WM?+-n8`Pof^AS|%wOc!*j(B_{u>9m1@GDwsOx(XDgkj=Bl${)&o#QlsqK?V~_qnoTpxqy3_ zamO&OxogqK?ZLrA)(WZis%87zTu(jYb#6N3ZBl9XBV4oGvbFU6;0EhH z46PP#f}EPjvzUF9=H(m~JrEZDvQ2nRFvOL|hHPTPpknYkqr1iG4S%^qfwyf9d`}In zjJ=e6G%!c%^SL_K;Ew&s+qT)-XjzNKZ5pnhl+l9j-?l~jzx5s$D#LU-hz|AOeE`su z@zmqK&6jLDdX=>XJ2qaB0P8XrI>5>WtbT`mSzHh4~t{%%@Rcwo(?E5x&hy~$o4E^D#jE->0X5{rp z8K+kD*N^6x?3eo8T6glP2|)H)@7^j&kS2o(I5_8$$*Pb@d&Xejm{x3S81q&)qq5rU zDy^(^uB@W>o~f)JtMloPVw<-}>}FO@wFju2Cl8;goP3g%6GN{)u(^qy4-09|1KWOW zBN<&ahwB(!b#9DGT_4(7sXtk1@k3jX*KnK&bEm;5;~gSzz--m%n}@bnly@lRk*%rQ zg{HgBClFc5eOq?A$PuyZ$UrC&lu@C~FwS&lQ!) z{@B*2-uY1G38rK#Oq&F^jH9xmc-@e>9Tft8l9@=d{#EA(bh;`WA!a|ewe@#pBOgR! zYBA&pZ@6`>5R2C*k8Q)mH@zy;uqU>((B(WdV0w7az@Nax;`GYXxUzA20HYS=sm&{G zL5_hpySaI@OwL(xdbdPyRuB0Y*VWtxiAp#6$X?1UUS5V&5Fm1q3v!n;m@H>-6fvfj zjF+g1S&Jo-KK>;K#-ynbHijPUGJ7^JMM*MI;`L>TM%Q>_S!wnBWD=9>-mq^V#0^VS zDG8axW$rt!h%n_klXk^xl>CHPnSn1^6Dg>Br^)ezDaY|E+?Zq-^@H+m~t(C*v z{bGMgz01QM1_XItT*hovo&L1}bo#tMHUr#s%+U~8LtXii`%7+Jm++{QMX5e9%0j`4 zyLZg_!Q5zu=tggp3x-_%+frz$L0oHS`BD}4A!0~(=w%gmub`vQsL9Nk`!R=DB$;ir zw%aYbqqx^s^?a(Ky7zUvgiH__503P^F#O0=-2=tvHUFcJRQHbJA_8|+_cl$27-+k> zH2xPceo*_#diG)rHV5h9k~6ddj3Rib4-Z#qoN#|dY+4Mb)xy1{XcualQ^i``qlCrr zHNoQEFnG;Sx%9%j#mB+46b2}=9MVJJ+WU~jJwy1|RZ4VnPo(6-UQRT51bmgZI8@bj zP+TTb@JKJeN;0Yr!(;4y-lrM$DCzYt2Z-nKm{<;w%7CT}FbL8+%`9HkSf38{Tdw~8 zBDfN5;p9Wpj=IbhnYhSZy|Q~9I=<5C?%CtpXB2|=!8hr&zpIxRY-j*O)O4u;wDWJ7 z{;%>vhyL$}H!JA>7UPpM^?WJ`g8|IUQvVlr$k6|_@5LyPNGOL9XXyW0%9Icm&*}fd z5Cc^EB9|LOa9n^=rW{`WLOt)eg#*j0NZ!qN z|Cqt9$;;3Dg7i+@$3Mf-XA z^yROxN<7kC&~Jc*-k+Oaf z{%FD;=M?*ZM;m!Ms^s=XI@WPAStTUXU3#kEp>__`Ax?oI=9E8zN7c<9WihHFW--T{ zEf=E);|<|+N_5rAV2lg%5dg}0B|zMo4l|JRidSvlPx4Cz?-@P_%feYK_|s3XH=Y%} zTn!)JF2e$N$ay8OP0EBa)(Y|P=YP%arvKaUr>C-9E_A|zbSrgMu8qn zY?fm1=7DcX#Z;o7Fj z`j9zrPJui{8w4)>1}?UC5pck#bP@qw?@+soN(1**X@*FY4dZ$hXRmKwRN7b$_Xgu9 zFDiD+uH|T-+ZUCV;?>TAVt-c#iixxGY02+OP0!+@p^M0PG)eb1H2SVHogA#eEQ~3 zWtOE!GD_C^GD;RS8#OrmvU0>SqB~$Qe*u=f1f@;>OKBwzZp){oe<`8j(TDkjn}C6I z<}am|*wjnV~PQ!qgKVF=<9Pbvl{52Go-sC8ATZ~N&JV5|cMLmLA+_Nvm#WhFzCr=Y+e zyTPRWu2Pv!T~%BxUnHRfzg10&qFp| zQsFok9YrqBXKdkk-us(|_iypLTB{RZhR?dJ>REfRtroe7>>Yt=R7k&+#ZP8Dx^LEs zh+F7^JlwjxVk`wDy`;?6Ii-=vF_~LwfSDrRlvn;p!Hc7oj6f zS5iDDL#ZmM^PwuYXQS4FUj9e%7Y%aHtUqItHU4Z6}J_{)vlYH%iC2uO3mIe|;Meq%n_ZlHkoo86?S8%hoF{)T+&0Z730 zY%rUJnS`s(SflQCL6W*iGUtX;w_&Rd27){QHW1D*!u;nG-r`c81m!E7@OKlTT*4e? zCgS;oHf;0taY)$qUu9~7$5~lD&~9+uoNZx#jpMH?C(Wwkg((A?bu|Gt6o3IyT?IY* zSBbX#Iv)F)?CW^m;)OiL!_u-n>aKSl>MrVa)ZMf^WskZ~P;|aBqg&Yx3#wZDp0^VJr0MRYmC2*Jom)`m#u=^}?F5Mu$x|`!eKk zswq`pXn|`a<^;oAAxD_4g?Z@AZYU`94rJQyk@?j9j^ZPZ?-VrV4rV%zee~d{sV^REh0PJ!$iOWkkq|L#(O6I?)ujs0h1R&wfpyVy{`OG_bS<5)Cd^ ze4=t2m(_iQDZ4yjfG_8P7!x4s3R+vNM7uT~hEiY+XQ$iu6`yLKV>`oz@46HUusg*{ zyyuuYW>UO5E$cg_j-ZYYFmudKh2Vam1XX)_&`7lEZ6x~Wfs*981@B|X{05ncR>lab z@=%Fxd2DEDtKQmbw5m}UvsIhohCH`wYX^mKCWX47F!7<%)Y`j@!mO=Wl08%!RQv23 zgM*|c;Nb2mX%NOPcZ93 z|3fKHlmt)VNc6jzs3=O%jwhJ-e_1K$_!FddM(Sdu4rs8rl%*V#B|FbLZ-8p!ryy1X z?y6;LJ~oMYf!JG5L9BR%psi0qtoFcs`sFEz^~rpWSUMA1w>Y0XN|bJHU-5MUyl02; z#%hS=uXgpO`6Y^f^^-xRJKgwdbUW75pN^I&R?EIv42|<87)P7AH6E8JO`49a!5j^V zPrc(dAjd80%*ak|voWf?n*YaLigkbA)r6{F9v-2F;~}B+1+~xH4|Po6ZS$vN7kh^DQ(%lw+s5! zNeyY~3{oura*zbBx!2w@WRheaJ!dJCZJ1&5X`Wm00#KhlKcDJXRy$hwrVQ1M@eE6_ zGjji42ElCx!JCB!L0J~=ii|TKiWw;cOoFKlJd=T=k;>`|A}vIa-C3>Qa(hpM6z|l* zTf9l?GCt)Fic_6~7Nk6>90rDgRF<=vYFQtJv2)v5wfC$FH&UkDan$u?Mm>x?%BQcy z!11QysBf^@e^QNF#59S#xhYx(3mWdCMp-BJ;Pi6lv)&Z6#zn0u2K}qhVHb5wbox#% z0C#lh8DUaQ+z|hL*kc@{;|SwR8*YyV)zpD%MjiUMnras>)~Q79wQ;>Ith(Ak zwbY@p)zub3_kGQ>-FOKK#v7NPmXsJ}y!j!@_-%DH&eGs0xJgcT4f0Z^|z+EGoo4U(# z@(++d?55VStmV*MH+8CI!)1hCwW;ka{WaBLRtmM#p-l|^>mtr>mFio&g-??Ue^RK?wL#+foVarMss;Qy$$Xh*c z+5an&p7T-dmX#cOEwGaQ`~n7>~&gPrP&n@`DC% zb#@j*N}R|&SWU5P5|Cl91gin=EBco!>YMnWHNk3dMB{U~ArH}-!!?kSByZP%i$)Af zXIMrc?jHoJ^V8NgH-|K$G4GnuTTDmB6HKSLH^!l386zI9>LofhE1>gXs$Ffghgx5;1&~*`+Em0r@!UOJ z4U~cL;cAc!ED2W!ST-L=sq(|s9+vJLN{CQWNPDR-~F>tA*1z#^o#1`Zy<*E=H;~Y@$50383yZ)P_Fi+d2A}>_j{cbcq`DLu{2#8NB*(75E92>PD%%Z2h1IW2Pl^fT~hKl)Bgw z&h0jStN^9U|}4!W=!8Lp5q6)RaU05fT<8z};_+-mk3& zrTusq4UOl{WNYDZL*A8f5%xRDbF{4Lqkj<4^J3@0%?X5b6JfOjp&uiREknpQ5vDp2 zIxs?~GK3rxp)U|RvUaR`W5$Ro#eg_p%_GE7_jQ-^*m1lBRW^LK9Ftoa7t|Nsez|fa zZHZRf2e{WYR#X`DDTrYz+1x`u#OAVcj2as7OP%Ks(ivgLkbG(rqrM){@p**HjPNHA z&M<|l&m+ir{wj8v)#`x4teEGr;4!azfx^3WKq29Igjm_^pzv!Qb+o8k2#HWv^@{GG zLa4Fy=1#DUajwNe$?m8l2XGgFG^ef_5;rIsGSdMrRE*R(k~LFjnW=T~!@%84GKEv0 z=hRN+Q?E8t!xF(nY+|P7PG1UCICZ^xNWHUmxx5q1)UXvXQ~z1d;QYLqS{COc0BHfI z?q{Z!Ed5)_;2ZvA&tQxIE{N>+*R8F8`Z% zh&ZxL_nXXB^IU^Sq;p{FyuU29U)##oZ? ze~2ldUt{&5<-h}k`ZQ6SHJpvX$9vy)jw1k+SpQJ&nRs1}?0Gox{&6YC{8@m6hnlFK zX+FGB!yt4-XCs;gMaVM*b2wRNlb{s;jue+UCLIL1#&Ko9aUo!WK10$rvevEO)$qUq zLrW;en4LxKsCQE}O?>}ErC*z>5u)f7JVxDAZC!st7haC`hnfE!w?R%lZ}Jf~j^U#q ztn5EtHV(S`J2k1yShnhQD+_uhPK|2qED;CgxUKauxt zZ*>whzoi=Lxg{A=0&RhQaE9w7MgLBxoQ)pdl)k^R57lg~dRtn5au4sWbb)`Yst+`u zxGH>G5VgX!48eKv049e;E^x;dZb19?!9K-@QmU$ z1y+Z+B&u(`RzP1r(jr<#|5&bI{NUzqA?8+PKd55{!Y2#8Y<%!~j(?4q+uz)z;Ky1W z%a5nfFmg^E^;m1JzPyh%J=W@5ii0sdoPVsvSaLb!@&uvP9E#)6Xbz1=sCpbi+zPS! zH%D&Kh9_E*D1i&KTTirL@dpC#PqkX&MFd(s)dEC21L8xkJ=MHwetrzxvmr^T?Xy9t zdJ30{$8}cq55EvJyTmEf?NYxo;4lE|20DjX%fY4tHsl#teG{hiqdAv7n~D*;6~p0^ zU8(Hp^Z0)_e1c#%FqW2RZ7mnR#ER(6aOaw0_WY8Sis!4M<(D^CzV6vre1;wKo^WSx zkGvsygSgYg?~g*=>c8*5x$aN>R zT+-V6OI0^IqjDNL^i}#2Y9@h(LN4!Ur<)1uUJG>C@F^~fOaG;)8pB|N2F2_9_|-`M4#n|_wf2<6)94A^Ix+Ep(o!S({z z{VIT`v@}-T@rjuW(^&_$(!CNjZ{yKebiGzcueI@L)o8~*1-ywYJy|)&)#pKb^qg6!ptFoeC#@9_&I&W2E8BrQ^r(FF+ z%uRZ|qX!Hjzkoubqer0F^Cr4|M~^{b<0nu@Bzn{mQ$8)B=^SYOSqXiR=+Q~+><@ik zqK6id0;PL9x4n4V1b?{|L049JtbS=f8l0J;^9`M9`_|Uj<6LQMzyU|>*ds3fYH?Ls z(8(j(b;fF065MS6sJ3%N$dHpx4paDa=0D3TNuK6#q350`q$iy`W{V!K`82z;N3e)R zV0~wgku{z1ZVC5hcwM~6y$%~5PK~|U$qnUJ5!CXuh^9-IJzZ#M7Y`@DeJ*GP!$12w zvbIdmE|q9j7mpyX*P0sE!>LU0GIxa3rbV=?i-(V>5&V?C@8Z$QyRwNRml(YE)bBRI z$q+9sf)~f3-LuO4;l=A!en&?FpYgi=bLy6a%D++-`|uooM+WB1mg;k;s6+|?t%<6b)V_R>o4 zI}=aGc11&meIV%Xt{ze1&S0Dzb@ON?(wtz=-VKnm<6#HV%_GJ$(uun%cbIuOXxChQ z^QDLUj+Ymm>E;pc@!@f}ewr%}Sw#l7hpv3D@A_MqIlbYOu#q ztNZY%<9-~FuR??X>>q8yRoco1IEgwXy;pjMCpZ`n}r)zj62xmZsGiQpNQpH2` zak)j!r&I~(*t8sSsmJCi<>>z!YSNEz(6>C3#A*0x?10~>5-83(-=YId^$X`Ru1noB z-}5Qsx{rful!NNLXOcKwIi*t2R8Z{&s&!ml{b=+IxG0Xsm-NS+Hnj?zuvWfh_+$Qs zztZppf6Sw7ztraz#DILT~5uX>Eo)dd{H1p{N zbp*?!c)eCEMBhC4r@%t}1f{p~@}hgaJUZLDw!jRYtA7ENfgu?VuC>;sb&IQbiBq0} zK3`nLu3mwW-Qp@8Jcg>^0)iKtG9JjO`--VvR+Y}`oqIGRtBRct^zn%Bn1wa%ykeKh z&T_V82QBpDKCfD|bd9qmteY>ol4IIT)mxjNm?3zci^pYXnlRTn(YeuaIa$)_*>2Ik zrE~a=jb(HA%C&<2IA{sR-0$LU8@{&uM7|LZP|tI2Dl%3W6YTO>ziL5onNCWx|D?;j z2XX(gJ*F&1e2Lc=6P>7;vwKXyLBQFi-d_C5B9?f~oCs-$D#rAzh0uCu_Xyz!^rO!1 zwZy#%PE_RVo*?!k(8R^PR@;>mB(`t4C3ppgvy)Fk)ESckH$%A#YetRUTc^-Q7xxCj z1r*P@xTlFFuR2kGSNBn?eys-EyTw(Uy5{QDe4z}56kt;~JCE5%@Vn^%NU`uQ1JGAu z^~+U^+ny6xBiuV;n(k&=rrY%+h@uu&5$wObFOPl0&Mux2jaOgviv#G@HeNxLv)!iA zCadsN`p`bBs2%Sw=^G+kuMRo}b*X@4&4=FXH@1H_Wp%#m;}S!AD&sCagcYNk$o6gi zkh{|}$1#nc6w+^QB3O7L@W@TXioftqW?dT~IS6#OiP(s&$AzUb1UsKYrK@vCj^lv2 z$tIeLum`aBw22N~FL)XX+NDV z3~?9z)#1JA2X_%0pnzIpCZ-?Y!5YNHsEc-bt#h}@+e360dkc$bw1)`nI_T}iXopZ+oF*)%?B>Eauxqj6;9O;MoC9DSOKv!1-f0H_5ebblh7cScV;gZoth) z1bM}$8rohwc5d9HtjAFah_YA_MKAh@Grs>8LAar6unNMwyFY?S^<9SDLT6tQswzqJ zqx&?^?gtGYYy~KQ@ zkHi_Y&4djArJX^drgz7?1#EWD{S94$Q_RP$Jjx3ai{chKKPrKw!nR8GmVH3c@3J>( z^cI~zMpZQ8M^TXSTt%j{yyNF3&LXTyZ?r3{Th!VbJw+j#TUGpP}KgOFM)9k`cZ7)9pXtP~t z;ul|7jX$jBna0d~>1&M8(T)*{mV~V`N3BN`H_;^7yoS8eAMPqBF`onF+C9(?oL~sX zBY8QtHk)7`k>*pNjGe_`v^Hb6%cQQMqLs3YGDAgZtldnJS}}#I31%@@j($;F`aM*1 zP#?CTh%gaeXMS6QjcJUA|7PusH^Fv*SRykI1KQH0FwsGIkq(53h&lyrjFc0~p6Rl`?d{L3l|++k0%(V$foEp5t!Bo*qOG{j?njde#x;)NLjw%^(*2uD8peygR$xr zajc~{4$kwDZ@G*L{+1chf8k=PrDQ(_*2DtMK24L7bSup&5smOT8PH|MRt;G@UC}<7o(g= zG1-6XRY$pb_@7akPOcsbr%BYkhNy2j0TnyFS`$;yZVqMFz&!EQS1KK>0jUQ}9d z64s6qUTT*7sOvY_#=-;J9Wc(7Y7o&on7G-D>mxq`=%*;5HUG!W7#y6yp#(Hw*38#ztvm%3ks2rG)_uEBGabde~QBP zuO;dSUHPnlwL`Htw#xIZvI_hj5wsO3mPw5Kdo58%J>0@5TzGA?C7B=HYojg4%Z~t> zQCqZuD}`@ri$II|Cxqi4wMBsXb8}ATN1oAW$fZ()AsaG>8!~540dj!4qD6H-_<3@mDtNw5ge%`uem&t2m%Lb>F8$an z=|l#$QW{e2SkV+`ZsfTMH&$d%&(#CqSRaf8Q&FslP&yE7jU%WeK8Z8rMLyts5i}4CREm zhV1+i4mbLJ&yPaFD?95SAU_-FS3iXj(WM3=L`kJ54TMiM{S~Q>DF(g6bY`9iq1FvW zjF+-q_Go*l_>a=NHK6o{!ppU317j4drkqCTj(Z!5=D`QKj z{bI~Cyh<#`p;vv{-w5-{$yibv3qM7rfW{)qZ&57BAmgPKv0sa&L5)SA)|;ctaye3j zTrwMrx|$}_VdG_p@F-o4r4xn}}#_NEWv=&DQ5pMmal3j~f)ND#bhP%}}_ z#~Y};lCBAUA`Hp`AiC5HL+uLQSFO`rG!okp7|~ob6R#qW&5$?*&N1XMo?O*h0CEI@ z&Mib+%b!qC&^s-JW{EomO50jMUi)$=w}q%1bN!?-{V*e3+8c9ua*zcc7;6Y=S&QB9 zL18ULv?y8PM9D2h8}ZhWB3ju}v`lMp1}Z)%=*J|Y7xA46y%r$l6>3fkNeVzbVdg-o zTn>eGVoonThjJCKe>kYf$Hdw=P#C|NAyYFVx-Z1YV@Q+(ve*RpH~>pcKotjIp9y&I zf#fSA;wuxNf1vJN-%5O>xPN-#5l=DLq45GbagovBU&exoNF+Uqk4dTzE=4b3w>%6ZbbZ{Wt=6#FF zjw7pYGN%kS?gj-Yc~`*_cTqg(k4In+2Ra~d0RgwU8`Vm0)Sev0DaUVAsd|ElO#2u1 zvNHE6o{|PA^>_OEmPwbdYdak?Q5uy;dDnr017DldW)mg0JjzrDN-QsNa?pA7aX*x` z7MH+6dlCfh+(P?&GC@R$00izPh??T|@j?o21ITd%+P48D`*`8rSKEjml;%I>%C6*= z!FL!+`^r~u)6#612s0_hxh8G+3mMU+Sm`VZ$T(1|oe zAfE%?2)HJS6tVp~4Esb;$9D!EHsQG<#jGSbLPsL@!$hoZ;t@E_0e=MUC5j1R>)}Eg z-3gQU0tBKv3qKc`;w5~2)JY5$P6$-#jQDHc%J^V$7=fhDqT5Rzi;GHbyaZodTy+;# zo1-1^NQl(A`Vqh-1pFr2?zpv2VH*&5k=y|-2TnY2 zC?bm-!IL89EUzO)%m?-<`u6L2tc7JBK#C0^AAkoYmP)&?z%1SFsrXf8?F`4Y$Sk0< zJw$|8qq1ZeQhd4e+v|B$y{CA^GWRGfBxm;&em?C92VZ4RLorrQj@;Q(c>DX7i%ez- zmCh0>jN|`6e2l)zk=SuCB@fP+i*XJLB9bh>jzC3`Os7I++P4tU14p(%{p;n>!2 zrhEF`q#?b8-^i7~aErp(CLAX~-tcl3S+l--AQw8T>_9J8?<66tCzA*Rn79n(yoJif z+F^q6IgHOndCg{gHrQWCcKBa*+0Dhd@@XDD=_Puk-741`JotlqgDV2)4Mm0M4O!oD zZ^(#${8lJbhfbtxQq{O@8s={H@BQVM`FgeOZ@6vm{t#XJwfAlzGU|F zh(ulp#Tpp%86(!fsO7-mNeMjz21!uG>0x;0J^3^%MI>7G&QL4SkmDY(#m)27qEq$jJIzsC_F8eg z?*0b+LYdd7ipiy9VGT zxETYWx@cp3Sb-{){=7I3k+5d!wJP-Q01;{X8kz;Ee3ESkhan*Y#Z2G&xMGVYPHg5f zIS83RE6vdXRp`@!qD|~MTuwG(C&d|?Mj6c)nN4u0c~ZiuK6ItXLE<&9#)x)sEeR&- zVXpM?AhFtap^GEs9z2-uL28)2GK8Vfh?kH=#-rm4Y26N@G>$%W+VEcG5cC{N# z`7kxhDLDixmU;XnfKsiBJs9T+x%!lJX{OA_${%s_;>2WE z(6`^f4MZtaFty2PB2_5_9=^a*w~EVS>Newdy`~Kp15Gz?hw$XTwMDrIs$qM zKjWjpKs3u_Y&SEO{%al;4ijFnx#uuAkiMm;&eB6I(bS{kv~ z5fRT3BirFF`)~-ty1zi{HC*^5di-L@Cmgpr6f>8Z%K^+KSWh-tmy-AIv(K^4(qFHG z0&g4+)*EjD>v_XPL(5a#tfH_HqP;kT`yuEmfwW+R_{#F|Q%tiRUJ^O3TPkA*Igd?y z3P*}YzMalLeEucINzF`yv*b}CmU2dkByp=PUP1oO<)vzgn@s}%tbL>t=KjAwecmze zP8{o^ogl?{ba_wZ>p(cUFXtS$h;MGl*y1S#<-O+Cnu>P;WkecY&@g=eUVJ`_&&NV~ zm1QvnM4ruJ?m<58W(HC!X0d3BBa1&bAd5W-I2@i_P_jHwZzlFmE}(4}T^lTaOAoZH zN`MBs${2X9FS=y$wWvTM>mQb8UPmTLfnCA5u0k=h+**pw@i*!HlU4mF17EZ|S~$^5 zqqLY8@~ZI(Bs_QW7&CPv=PJVDdE_4k3{w2YUltyVi{(VG524eev`!-B6KJMJYaP-8 zDkhY(g>yxiBz6bS!k`Drafc2)sg&UH@p6m;bmJZmeq?0hKGkyv*BK7v@qyt2U0V7q zv}HNI*~`v)sBVSx*{j zL?`Q4_GV7j!d2xD+BH?{>6bZ-mx~TlZ!AT)YlDe!@}H&!D0`{NG%Z3~Hj}mp~bi#9b6InD4m<3ja4$K%}gyq8A+pNYEwOS4l2hFxPAH}-I}SL z_x^660hgsfcgW%K;6{JU(t_06!|2H@6e)xJW+R`DCaNQQqQ0}W>FSd{^y6$TTscqo zW^3QLU+7KQRO+{eIrHB(I&YU^sC5w zE80Cr`^{T5!4B4UGwWR`d#)Cw)T3|aYJtkPba5^?pU);dj>bUYe<9y_+UrUJEuM#5 z0%^}Y?KF-N=47CQFW5^N+7d-HU0*;^3$%L5FMCrKXm=I$)?n(kP^+aJp=k@XdgAl7 zco2M{_Mvb^pzk8Bjn{Y5^(~7z>}Go#H_q&PcP!GHSFuFSMd#03u60Jynyk?31)u9= z_9E^*V9giuf`?-=7h){UTcO3fH*0Uiahq@t^P{sXwEFJ%`Iy*|1mJVzy;9rfUe^RW zu&wmxN?_-=t%!YMZ|Ev*t)jH1Z%DJF$NfpDs04b9AMI?1N|o9-gaBk#mNF}7g4Nm} zr9CZNja0rAxkhV-kuY?Pwnf=WmEYA`C@=4A^Dbn8a+UnoYPA9%pk#S4@LpkFgf)&Z zq+?#BTdRdCUu~VUR#TK2GwOI{n^#JkD*z9>UblGK0 znH%xWC@%wxk&-3AXg!XcvbA;rhbQxl0QCTFsu;^6JIjh#{mU^lB3rAcE*e8C`8Q<@ z9nIEagnyfSI<(OvV0rvJ4+`6$^>Ulqo)y}x^gtWEF_1#@Jp;*>s8*%z8?+G76VDT$ z+@Q6HYqZ?hT-k7qpHVHNE9w}f4QShG*r=(K`f7rX>FfH{9`1=Z({NzX~ZV2zWU}!qD@*2 zb?8Vs$iGcT(m$KDHhm5!m=?&B0*|(f=&o=xM4=#h^CQL5Q+xLtk!+BT?iw$9F%*y- z{R6Jca+C9iT?S4;()wN6T3YWjiJO>w3L zA85Iv?%`tUu|;d8K5a%zw`f0z&~J-r$X2Z*y2F;OS{IRdsF?0<)v}bTGvee5kD-_0Kt~D+FinnpJ;eHG;$7M`u zsj#thq=kt;rF{e`*_k%+PYpW8KPu&Y1o>($2FR#8J9nBHd#`NQ5*4gYqIYQif%kDJ#Z6I+I+GJ+nJd7VGz=KZp}jMAfB~fy zW$(o2TsnZCK9r6 z9A5vF9)F5r95efgy*z=}5Zm=L&F;~C{ZqD_bc~G46ACEpGcCgZLJhfCOmxc{SDv?T z;aB?W&$LG3Wgy=DOlu+2u`k^ZrxX_PG}1e}5fcJaM=#W$rLccz6ZV zpPy^7V#m6ty5CF0Wnswg9i4eX04TZS7trU%9@dRK7k`%Gb^Y2N}H-x`riwhT#cAvO4e? zL?aFy;2=pNG%tr>2=kUu)=jUFo6j>iPE#u6woMk7i+Qsf#U9W?)RWz$tZ!DW0-2BS zhLqz(OCD{yRv;snYm%oq-DuqbElB(nq0-j}(0$+FO?yVfdCtf<<-W`f*KT?qJvyNI zN8KN3xSyzmL81Q(uM}+h3q1sn5%hsuNT&~v!`+}Bdo@4m`<3>YxYAK}7=NnywHD&D zYMP-Ih&RcfVe)$-Y4F#YkGd_15)LBW+h1$$zT-N`l<1Nv&$>C!Uq`NyHAjnAgBwzEj^?K}Y)mibX!R`1x?z*PVLx6+{Uis=-z++l zqlF3o4*7I12NIh~c>er5x_^lS^(E!u5gi9-dczt6>n#u6@9dOKoj6c33 z?fzD49vNmgOd8|{&Ny+IrmuUQ*Fb!{Fz>t3d?~EnQs*$Le^?tJ<_vvEOAc%GZBO3j zxx!rK#RGc!ur~FDCO)h(bX&62+|TDQub}|qwbL_!c0FhFunD6h0t@43Txi+hUBV-CX$JyYeo4 zv3%i7e-%pzDcV*bilGwa`vmHfi>tr&9Il) zTlGx~RC4)V3+uA%Pp)I^i@9qVbuTk}3$HF!`KG6E_8tLUv>4jETTK&D|AwC&cKs&zIYKTP${QAAtNc-t!?l7`}ck^J{*eZ{L zj%)2~0qe`vl68GCO+2o}iSX>3^zm_RP=nqB_*g4L9z0=W#g#JFf+NtH@^r>{Sogdy z775Ep83hNn-G0y##ZlbJT=Rn#SEI{tbHZ3?){HFM%5~+kUbwE9?*E|0*!q`;CIQ;; zgw{?txfReGC$vCOl(tLsZdO7UPib9+1%c?(@LIno4yTi+wPrqjI`A0g z0r>J5zR$>tmOWJq=+tS*@&x!evVLCG$8yXE{xUc0vH6hwjMg%CcY9;^!#a5E%yRYh zx_RCq?S)8-K_vGiLf#gCr+sI?_qXB1=CPnw(8khTV8 zzMX^R3a-=wKtKPa-SACq!%@Z|lOr|>Fgp9Q7NumikZGFsNP+9m;-@i~@ zxA)HcOKa*R`s2bZnD?hM*R^;{Qf0Kg=RaDM#m=Glf3#*Qj#Xy-qt&wPa{^@BKU$n+ zCWo#8rtT;tHywK{{C3l|+Wh;5uC;XEV&Nk)IV7`rNcN>;x)$v|whSysD%?BW&|2C) zE=86Lfm76-p*Zn1NyIXVx%A!*tyxSNbOJ-0{lf=Hj@2Yzjl&&QKzP`k{Ni7zBGkw# zbRkdMW&13E+xEfAI}?xNpnHklBEX?ZE}wTecPc<#3$=mAFwR z?#%+NYrq^Bp0oZio)rr5<~{0o{WmFUQG4;V(Q+2 zTUwkd`geOueTy`^@V=2x(~Go#pkh70!r8)&|4<1m0@6IqvxPxjpFdlOWKDXxvjq@& z_H3cSKgQgRvxSOTEYclW{Hfid-9_3A^`CsIb4P38i6prAUg69j6mN6=A6;((AJh5$ zkI&r6Wk@CylKUhfLqtL>Aw)>Tk`PP?qP8IRwe}@Zd+4A^Z%3)}Xp5>=TT5H5C3Yc+ zgjidx*kh^Q7&JwZM$P|y?wy4GKHtBW$vw|G=UMNwoO7P@JlDIOVa%?F+MdD1C*A{v zdm2B(Nr3;C{}_&`FM8_T)-dL$hkWX`8nv>1ed_&=KIDV%Xc`_QF2$2ZTN2#QpIFU} z3*ZB|(1`6T)5PxtKI56UUrhr(2T9{rh9-eM=%;Ojtk0f#&lKn|waM`FE%-?l`?NAQ zAwO{v5|CQ3Gkf(6#e3~~Pmx=1`FI=t@_4|9-STPEG0Q{anxIKG-`2(yV|Q7UK2rmv zB(4IKh;(2}aBbMFq+ZxPhF`qpQ_rViOobB+oGfVJJMo*ISG(=guG1e5ZRgAGx~nal zq8;CX-TybeOrXEOTOP~j2T`iO;4KB3h|eX4zYtXCWEbH}HvVbskBeCQpYR@DyTn73*|=k@;b zWPIlxpW22c)gkcS@oCepn~NArIVCAk{#pwl=-NwHmmmH8*ELtmG+puZFXwT0@%7eA zC9i4ID;xC|&U8{!S}7qCDyTb0DcdTUU8{zg>(ZapW*OOT}w z^#T8vVh6n$8%a?FmrB6eggzVHv9ZiW|E)Vzau$sa!MmSl3-$G}8huJeDf z%F`<7E6v3&{qPwEpL+bKAbpC#GvAHZsIRw#zG{sKsJ=QbWbLChN~34wJB11LgWv+_ z3(Doz4_+Sv*CmcfLj-pah#1~Co55kH=4z5CchjTNu`(1JK6G_F2aXe&6nuuKc z;;>s7(y1$J`i4?64s`^I9;z7iGas4lQ0-a)YH)v zDssZp|2Bda`u{@FA356 z#jb|w#^roKtxaWD72kuCwKB%4Wkg3tIh5bVQiWc>ngOjI@XI0kz=#Mn71+4cVxUqV zXlIhjFa9@scUSiHk$uw!dcPsczyFiHj;inF%HHbAegq+#{6E=mk3jXQ(jdyQZq!Vw zhKUMl7#-i?tfnA`SLx9(4q#s^m z@|)=4F0^0M{ehTp6$#2L4URxs^wEnT0^+hQR{(vrz$r~Uq~~MLiY*LBR_pjDXT>iK z*#J786Pr{Ud{D1*N@EV{`K)tddxH;vUFXDTgK|Kh_2)UUg&sTRdS3qmP;>U{vxZ*~ ze-sSyD|A`j7sV@j{ZantSFxvl25H0p1nx7*3Xs9pOa z(Vqui5(gMgRMGLdm&6usL4^MvkYOlL;IFf`NUYhoExxirrxv72jUkjUs8+ZY+ux`o z=1ikv(BfD<_KB6$IDYG>TV4L)WP?X@Q|Wj&d@bb)h6Mzu@KisohsmZQ!r%D^0#K%S z8n9J1<&Aga_lrbJ<1Iuh#XVKp&2G5a$n+7R!f0 zdxq5PrXLBuh;9vd3&BxHDPLR;kp2N{BWz1`qe4xEu61zzlf_XW(v1>>@g$?q$hUmF z!)Ve8R34*_vKR#dz1=1S@-cefXo^4*@UqqEHCQ>sZ(SD0V@o~ZiWuluA65{R0C~nG z)!^M!16eEk*C%UJdy5a$o;_@7rqzre8= z_Kzu%36+=V(|l@rNL=f{)$pn~Oy7+!zbXd%|7;O-vjfyTaTgud0-RPDB)Sa}__cjC zYw_z>#ZbvW5q~r2%)-|!Epc8nnYhp8F!3wa%9MbWn*Tm4O=PBfVsIq{* z;|X!&Af=#Y)e1}BhXDdFy(an_4h|H!$8|BrvkSOT&R)d)_CYoFr0e2neKUUUx>!s9 zgx|j|b`UNu)l|!swyGZKv4J`NqqO29stGi`Yp?!4H*vUnW8*i;{}bP+Y^w>4pd$MJ z(2;(0D9m|a;0JGra1DEdTNZ^zYKL%j6szq)ly+fWcN_Ie8u-w^0(I!(cIjRyxz$pi zX;tQQuD(^u*1i%wd90h4N1a&QHBxc&8zx+JvM?%F$N>=xJiidBugjU-}ig0`s$ zFu+@z6yr;U8Q;6{thstio0RX|$p5vTM52I~sizt=)zpGg2Q?_+R4!31&DEggsgIE5 zK2P7xY`8yP$ZGVH{=Pn|qpTNw4KGH)E2>c6!7zS^j%RGvw=_LoRFUPJWm=Yo#HDUo ze{9xwG#eW9RippuXK2;d6>)V-9ZxCLFXC6;G6or9hq!U)TgEP?7lUbvAdi))lVF_h zYm7_(2`FXDBqZ<5rpYB~R`q>QsGKG5(St`-z-Qcj zOkhj(cQ;BpdFhf2JRoj6i>>yhu5B07NYwgKKcjC-8#w!5(t&=5{t#@9(LCvAVcrqj zwZ-6pac~oAm59Zkp6Fqh;mbt=fFH>zUyZ>C3?ix*f>`We_BP>GLyXPQxZ=LQv4hb> zp>+s-)8E+H_&6G&o(MheZ%j3QO`!{;bbRUnV|e<;fvC5TKAADM(I-FgltNo6b8CdKp9EELK~MPsj*F6h#d8QXV6?wH;JX7H**O4pBxO7 z#Iy0btb~EaM7`nCTROfj*|qNv?w6@L@TtK9zKr z@LRZE(rv;o=rc(djkmKA&%+2`-5}|T@hr#l2!5{s&%?7Leku3`;I|Gx9nv_6I02vs zApW3@dWq)@GVV3(y77`P7;FsewzDBw+r>tB;GGS_ylS<(CfdJ;;@)yAN~Cy)QuB~1 zj6RyAOZ9)PB9Kz@!J#s~Lxfqbe6Z0yy%wc`?vR0)`;#d8Axa$4N4UE9+t$%y@tK#% z$<(MXy(c%^wgYuu7Eb|7OWScg^W%d%5&|PIS=pb09_)c4?*>Y7V)lp~YMg55Is*4i4mCD4 zd>El-}Wb^OcW#$dx9kWLLZPBJ!Z ziqzoF#oLcC1{h-~bR!ufVuZ1;VIO9itP#fcrVJDt{RML+*89~pd>ZhEBaKn|o_xee zV}ik8)bSl7jbVmgAWmHyX>4cs7(ne&#=3@xwqi5MTs{c@q=vKI z!0`=0$F+RX8%fYVP(LOrTGA-H1=D%jbr^Mv31@d(f*5H4(ZqqW=}v-{t#77y86Yh; zM%1+Ox+}Vc%(oiGB?wWrVm)$K@2L-0?$*(k;}K(xUOce9xn;Vx3n6w!F|67(1T@=_ zLK3b%3zVX-;L%(Wb~)DO{udWZBK6KUaTupj>I7k(UJ)0lSfDbkbKt)d=*nUo^-fx5 zL8T1kK65Co$RIk0OS--TOI!sJr_TdbHBT#?oHR!Xs0}i8d#w#!rN(w6rAnVWKw?oV zaa`YN^iNkah@FFFC3vBKWwF$w4F!tXQsz8?{(8ECkRLnZ%|!EKF(1EfnG>-STvZ@k zENZD$0H4_etaBzoD6VKjZI{?u6O-1wI$&RtORbK6d73YojD!8f9n5utHkOdnbi8^R z0nJgM*eekTEJlC_b~IZJPivR)Ngd5Y4IkGo%PQ<>?yEO+s8z=6#hJVKtR(>%X(VB! z!!lH${O(`I=Ye9_0N{9>In59Pplv7cE+jD>ymT4{M=@~SrC%9e-N_tls1}b~#2AW!7%!>aQkLyO+I0u+3Y4x#~lmv2b$L#e#f3ytz`3TuLTGGeM5NET<#6g z-~7w>CgZNqXK^qMB%5nnisJrb=dRYN!U#Ql3iQZh*WD5fGr?;*!vFQ{k7Ln*O z-9lw+9KABSU$#)u#~>91{y^;5AvuV8(+degRaV`l1LMd?OD%h{qStc#US*IPPIX;j zt5!@|iA0e%MB0>K<3P2LcF_h_`3gK9${;N$)nmEeDXCt%x4TyDH#x^^oEqa}r1dOE zpNbB0PB}wzw4861Q)qbP1`ekxmKabft*Z8()DEVfJ5e#k@y#)p*+suz6f*Up5Hvpx z*+WD28>3-+YS<$xR_vyQc52BaXrU{VcBa@_3pLe3?X^%9EnXXhP$HiCoAh}=LSr{w zS`F*5V_xH) zvmXKoKBDy&FbP)q61|;|lIi~2$nlX^dX2ckMXb877Ls(-$E)iRLT|~#fGIxQY9C^>I?tt6!Kf7rFrLtq@X{X!<5g4+5F~sJ2y4vcnXw>_ z2zBE&fi)3Y59B)q=HIg+gjn>T3jQm$GM|OswqsrjIeeQBO!6~p1IlXeuJ*ejR%ghQ zx@sH?)Jix*wyB(yrpbI@rk@!Jm&_zGrREHg>+1P* z18Y-lBt%=xzwZv`I}I$>%MU@T+}A5!&Ih*oh_!BPXWdr)b-I-iSL1AFoM`#L7)yTk zOWndniKENWNV~H6IX4y{tjXpN-B>4~Pd0BMvRXps0Nzt%{Y{^~gBv$=^oEuB6ZsD! zYwpz;p8ScUv*YYm0YYN#F8)Ylbv-&aanm`fqt)6rapV3~So8F!vn!+i`Zhjkbk4cV znbz1UpH&7!yOE1}%4gxlO_C-0;8{h2o+ZDq%D>UH0)~}@Or^`o^XU!64I4fT6U?%c zscqCbOf@N+-1fZ0y-`jnH$YFzh_8~4Os#T}Q`#m0g+}-g2+VI4lN(PuE8Q0!qx+td z{DjaXKH!|x$Ww$>#=6Xz>IKcW3|}xMT6!=3%{j?Zs~|{Ki1! zYcGD|oYcTG19XaOLfljXuX!HBWaAE=bY8kFlqd2g7ch*X>+zl!r1}9(>$&Ml;34G1 z&=Y+r@U9jJ`$x||xFAIYr9t+ZJqcuKH6Xg|C-lZ+^Pt=KU3qLy4(Y#z-?|`q3%H;C z*#)UpdJwoA@sylyk6t&<+&uT4wg{O7iXD0p(Jq=pkK-XKMgb!}rGR*!s_>vwL%M_=rW(uxe>V^0TYr`s8ZZuckEf`2z)qg| zRH`jFf8bv~l`{KnXmH=z8M^ND%aSgEblu$m_TiU<-#Ps5;`b0gCw?`rNV;bDMd8;2 zzv1{Tz|W4~H~1aL@7@(D%l5bQsUR%hkyZDFv{lbNUP`I`vIR^sChDc%ch%`i%CYL$ z%I+!s)i1%V^z3amO zo?ZCGmr~dIYyob>%(j&|%^R@alG=idA~TT)&S#&21*>U6$~*k)TZG{ZPp5E0oj3K+n}fWx{1M#uQ2r+g~mSV=3C>sMl# zrn1~afAKQS((w;VBvuzqBI^#Lk!Sh#HCS?YzlrI-(pnZ z?ps%`iii0b#GI#!=odY$>h@9}~XV@&w0s%~Ky0N)c3 zkbA3as<`W4y)LgjS)3143Hl@|ST|m$%ll=J_$^4ew=aAre)umY_Ir|FWU9(Ms3`Bw zAk!Rz9Vr*`%Dqg%9s)RT?KjoefUTzL6+oFgb~L3XJ$HkB;i$Z_ex?Hyu`E;y!ZY{w zUt6VWD&pSHxwq$roXY#FUkGKKS9;>4G4G#yC-cgtod?@tl|S#vAWLJECh`xdenLFh z7S>e0n~EjZYuq>#d@1UQ(YAdurd#uYV%@A(RJzGn>+{M76{#g0j{tzJrd}05dw2fD zACh;Z^(D20R=GriU6p%L-Br2g8nD%LqXIZn9b2qYSk0*@0w!~~U!qGVqf39uLltSU z;o?g@->yh4YWg7tUY4tqc!j;F#vdsX^HeY)x?W<~>1w=YiPSc}2zi@rjqxhb4b=Ys z3Nr`bV*J8xtMLEye+SUx%v%3yKi-pMGBo5uQ)x{Js?0IP8|NFjFx5vJ!RJGTA zdz~6q$A`E;gDd;?QY}pJEfZAub>BW;rsu;QQcM3Yu@s|`lXF}>v}{p!yevv6^EQW6 z$3GagF@FdkF;BKE_k+u9sEB8{KsuA^xYk{!CbO*ZcHzq~zdt9>2np;o2b6`YL3VXv+Io z*`k~TxiI0FqgBEZhm#jJX7RlCL+N?csprV|R@tIr*j->hf1yu}p-!EH55HA*>LUoK z_1IDYeC)=%Kay&t7d%7muD&nDsByeZJv6TUrtTH&Eh>OOV!1QuDn{LL)OLSP?(IR1 zq#!B-081t%S2Eyg-mU(Yo&=W-%*ngZ-xNpiUjwuA$_Hnw??^MO+QRX=D#XzPB!=6& z`zc?vBWb8W6^N?2K{L!0tA7pYI#Vp)!p%>l)`17(R7uN}vxT(B!v;NU%B7H!x2s`% zTVw1KsR5lMvp1sk%lqsKjfyQ~s(_9?QL-N*(!$+tP5ZKP^p5^!Xc?WP8%Yvb;5x@f^HATiN3U zO|f`SHaCmB?1`1yBTZe^w{FHV;SFRm*2jwFdlQiR11bKaR{YRusdG@-r2kpIrT$0; z%kghmIHd#&uXjdjJ*?y}^y$#!v?umGK#&V)^**A)gH9oA`nnQMHf^kg2T5x+e#9MC z04MLIwB3LmzV*S2Rlv)VH<9l-BX#$->6 zew*-HgI^|osrc=|?>qdy!Y>`a_4uvAZyA2mA4`09xs>cj!U9dIaMDQ)_QGH6UfJ4L zTg&4wNuvzQOZ9x~B`GLHj2y=(=ylapm z5{L1}*Q6^|am0R`_<{!0nWz4mCPf|`{vhz5Gg`FgV zkd2_zY#Fk!0=P&qo(wvT*~O9p7;Rg_0n{C|ZQh-f%b2Bd^2(Ztsi2wP8;8cE&{PWb zT^_0i2U(_5BIWn)AnS{HWs7d*-Yz*T_9bLlXaVxI319(5d{&-J{wMX;Xp`Gw{!^*cH2voul?v>x z4w#7woQ{cBJHAb%6rG1r$(|Ix9}^T#kzQ~*S1P$G&Kj=NM&;!qWw$GwD4%nwxv|Q5 zBE3*PaYcuwyB7(sR5JdP-c+OqrMC*S-r+-Xc<0AbxNjfY*@gZrDc-M3^|U>I|FP6U z2EO?RC1v9cTGr=C*dhADT!- z$1pwbr)N>M1O9cb`e>4px&= zN!ZJ52=`OtOe57|4q_`?@j|J^y_DvNr+6YWg|-h@5;EP^{=o}_&Y3z}`Fj9Too4$- zNE-$x8z7a2vnXbE+Ta6o+;mlScB@|bH;8{xm3g<_L3A91L^~Ive=yuJG8Wb&r!?!n zW<|kD?qJFk7*$Jt!C_unb;F# zA+^zdUqZFG&JQzYsk=7Nf0vK-Wg$YdyZi%RR#!0H z<=^?Tlz<=Zz$SEs?kI;nc^)EHnu*sOg>p%`L6^$p#RWhu6R*BB=+cZz0UBD}Vi4{;rc_Rj9{8D{I~0&C1)@AxY-h#UlRrk~O$ zoQJuy4+ZP8tRwF1ZN0GJR#qbuOVtZcqWR~ZthVQG(XYApHsuALtc}l_Cr)R==yO*2 zmqdH4-fAdRcI9(#Gixh6zsh@?S&%Sr2A^eS@A!8~f2q@_`YetPPs5Gdee~Mp>PpTD zZt!9W{z*-=t{2<4|A2wkB@Z&FDP*z5Z9dkEHS&J86hTbd-pY$MC~l~7y)pm7i@hcE zU&8*4I-9vRY$Qskjl}Sc7$_xvv!O#!i6L&1ZXK^f+&D?u`h!ODMuKROdu1we`0*LZJ0HQ`|cV^YET@Dny~OYAiBrzZoc9T6Jx~{uHGB)!cNXKm`sd=?xBb{?I=3 z6s1ixUtm(kz^}SrK$>S7L6-S&9FjdgT&o*CUM|i~A5X&zJLNbEW(1-Ng=KL#Ju=1f zV<|+NiJ9U>#LXAC0Ymxbi(dhv!sd(LyCC{Z9_?I`xb`*0%y)wYP^Wv1mrc#C(l@da z-2z?6I@#zRrg{}v#LW9euTvCE&8S)wKkv`R2ON;YkuGlYq2w9 zZ;VrI9b$)@2HiV@97&LrtH6LPo&f%xaD>EQP#jSe`0s(A9YlB!!Z)nIuO)nS!r#3C zylOzc0tohS+hJZefV~hh4{>~ZZ-{`C)3YrsTxbxM^{s_16$Fn9yjdVCHXmt33pWjF zhr9A)BW|h3>Py9!3_AHTgr@}gShN>hwd|%1mwEqsY_4!*cGmfN?55u1uT&DYYth^p>A6Y&Ed~SvfyDMldkI}46@83tz*z;EobiuGw#k^q1VVaoN3-1HPO|(aD`q`jMu(i9PORc((Muub9 z{!l!WF$h?(F@#!}m4@gd{K9A!TDu&+P6?UqZaAtaiQ6H6qe-qI1*fzzpZknqO`97L zvM&mz@}~t`N1wnlICjWOx;V&c_gL&i*yGfJO}O>cn(3~*m&B)yVGV2kbb(s$BwDEe zZR3%T++v5Y<{?W+z|#uRAX+pGeW{yW2Xo83ez3F13hEGJdX&OH9>Tgc-I9VWsjF7G zB+hmgFXoJra+zL`T7h7+XdvS05l@bspTeuAu#s(=LNIhOG@&*}4k8j!b65cHhKd|Y zQGEGwoVnYLxR@Jh$N3jSSY3W3g+(-e=YLaJ0A@9XC)g3LNMZaCUVA8O6s}F1@@4XL z!Rcb@;&E6>PCBLCdFq^p)fuOXTzIGSbsi5Gz(UfefvV1vm0R?($sJRjQxZY3%9cli zsiUH%SIOhX&=x`utSoQFy7SE&u~w+D(hHTd zgq2P2Xwm3_&n0QNAqXhntFb}`5CQ3S)t-e;YfO1+O{=Z_P|U(Q%`d>FMk{nmopPz{ zrdi;{Jlzf)RBn?pN=s|7nucr|GPqL(B|)PkXcX}ynx+a%&Bu&}!nC?bY6%b+5`!<| z5mT7zq4-gROv~Gs_>zIlubLwkZ@*AUj^mpLVxP1bUF|JjCO=_QeZb1suyJGMG0G@i zO+u95ql$PNXQ`F#CXR;!6BdnYTNqz z^!%Kj>NHsfz4Wv?lkn5YY=zgmFGz#jPpeu9F4=JMiGx_veqDiGX>0${KrDaerBzXj zeDOF1z!skonFVm!Rr9hdRCd|4el+#2wZ|w>N{%Aom`NNHuB^_3a=6Gpjm(LCiX8Oh1i?a1}LdJjMqPW-W${%>k#~ z)Bz90LQAP#8l|E75~?~-E4yHvn$^lFHK8UTnARX)96vy-iAE?xUE?qTn4nYO>6A`q z^Lv9?gBp_3pcbuns*Y3Dgh}Su7}hBLkv}1;QG;#3pJgY_8O!jDX@6_vOWmx6su#;m z>#=g^oRO`OldZU}by8_^g6wv~d?Ya(tC&7@AY5LKPl6Ue*k|$Kn7o?+^@R3m$VS^N zTkSX1G1iZw*AND(5)7l|GdOr6n|MzIH5Y-EzGj zR;)nWXI4opS)~?zPFjqm9P|FHDdbutm%~tuVuvL4=dZ@H+QQX|y!JR&FN)%8RaWY0 zNx@A3-6|R7mGd376?az#vtBdyb4TtkzF+}-*Pgf(KsE%?LI7@w0p` z-rh-2I#cb>DNoU&RvDHb>V2^W>K4o8v(6cf@;n;jAwPFl_1BO zKSov_#}ed36MAaiVSZsevj`gx^V0E9<{I?np%dV9@zX>;c>)U+bW{1-36QsMPT^S- zSV#Xwhsdu+p**MSsQ~KPQd7sbxcO};w@HV1>$h2qaJ3Jg^){;~lpf@3-)8-VA1CvN z6kaizdrf35h3b8H{6tpI*W zonSt|-?0Q4>;7+|Jf$u4j;DWdLW565^S$L?k;`G~2k z5x*YC)<>PdWTH#0gQ0vFkn&=Lnyu#nv?Ur7&tnk3%vj`X(4$spx&}bbZwN;GH4_ z8+nLdf;=lQL7pF)Am16PYC@(939umW?Ago*rxr>uZT$p9oP0R}ORoIbDb3%-y<4&I z!l`fgf>v-0AJO?Zdw0QBrk@>@Ape{o zpTZko3vS!(y4GW5V&bGz$%%#!3eGRDsdpH9$^~)H;-b>AK44ji!vMvm-h^zvu{COW zemOtXnvJd#_{djhyJdD5;*i+rPdqb@_2ZdSSrDrRIbr3|WHg9;Dc(M< zfY!Tzuk&M5nWfh4Hdu#N(zJ{7r6gRfig}5NIV`9fe=(KCnym;r4$%-va!Oxr;oYXO z-fiFQ3LR+{3>*na$^Sad0|m75hpGjSm)nm7gX1mhXxMJV!)>wEnCW&tULV%ID?dMt zbr;69auwDOYSp+ zwXS`<39Ox+JskDSM>-pA1+f{Ojft5tP_G`w^RY892h_dF-SNA7)LbbYe3tF{lDsp*sp~UULjL1FJ8{77_)7 z>e8*gENkXuG7+W*`;i;0SHwvOYEJX!e6jjYm_gCd`QpnT_|&0nD;pb)@sIPoFrf|x z=%|Wa`aaP-Y#4e?i)h|+7;EHTg?P*d?)c0~$`^nCz9Na6-}4WLG1edl7%W^!^e`Y# zK(WvA15l@1F)o=D_mwP3{hAfQ)TiiZU zS4-Z)0!0>PxViZ?Vohs2h@gHfmf(SR=!HF+>tQUU>OY9#YMcgH&6~0M`XQfwN;Z}n zRjjZxz)XuBRoDeGkfv(xhN1zr_&BVQE-~fHdo&vt;D@2Bc{uvDBo9YIKq0k#s%l_r zQL-L3WM+Lp>6h3thuv1EbbwXf9D0Iwkw<`kI;;*O`ms7SJ&Q2y_wcihE`4_FUARcL ze9Tw&!#c$t^Bw(IT+=7BE0=&&Pvv(lq)z|tQ1;`Xs$*(_CvKtgb`S2~pS5u7gcNzN z{umA?!ua(5j7hz=7x;5z(tIBS@`1^a=O4*IVrbf+`{OSo*> zj0g}h{zNB0JenrEVREC*9at;TCp2VgOW8C>P5Qi2tg=?@@H9gmol-lbWwl{{2PWI9 zO6xgJXT(+c96W2+@R=`p)0PcRt1Qz)X$pDS)nH#B?rY0bR)Y@vs-I;1S)DEfPvMCfCII5)iW7dkr3n54dcmUlCS^U`ae`!S{7$P24V{y8MsM5UZo+^Xl=emYW}%mWRe; zY1!A6PmG6EbM{)kKAsIQ)p}4lpv!M?XFLn=I*dwSy?XUIL>{|kU?^|Wg^dsrc5r(a z)<_uKg73q#LGu<=NLA)aE7Clnr(^gXB!M;2@FdQ>*HdwC!K-#SF6n2F0`$?=9 z>(@YS%kkD@V>8_3v$5tQHx+9L@6`u8e%speLw&HxuqK%6-(q3Hun->p7PN}QVBY;L zNLD{a^F42|)55tH+}4-%4OtNdK`!QBI%M`622eVJYW<_TEKO4np3PCFjpOBgS(h%0 zQ>cTi*RJkck~(^gmDze_&({;jIYML0j94cC(`iv5pY-syz=OS{~;^N3eht*%j$2bqu?>38^K} zme3hxBxEj1j`GKLr3>4`g}n@ZENzRykJ~>2)k-McqhV~FwEroFgj2FF;lGYxox>J? zOdXbHNSx(~#oR`R=OB~>IwjK*8oxM^hZjJKi#V8f8OfR_H^qQB-6i5AS(bi=utVI6 z@Bf7q{x9T1jN8iSTI4H)(rijte;&(a%EbFwu`}7P`Zm=AAv0kwT!sp3wYOi7cGeml z8OxVWh$}3h!^olTL|J~XiVT+5c))vyk$J`MpS(e6P@wrh`LR#5N@l}9VkHJv$DL(%(& zrP*os?A`RL4<7a`l|{R#+rEI{SLB6KU=lh?hEU^6-QpNsY7#~N0nr!7w6{;!r#7>W zexxd>0rWOIQ{2p|6ltis`TQ%SRb`I{pYaa!3wQ@^%c3!aL^jUUOJlz;Be;KoWg=1u~x^@aT5qyShuG5p`9bdaq|tjRD;!73_vL_C+D#o-(8V&< zkQF9^w-6xxiVn;?nysRGtEfVx)gM{ot@ZLHE9-fU8coy)u`QA0LQtbr>Q5TAiAD{W zmtH{*Qpq1{WQ#_AHMfH5p;BjS)VdnAxRUyeQO3y{wT4DLUP&!hscki?`hnmG@v91I zx_C+@2WVtbi@dyoEbdmRuhP^SJMC(nCR9>4s?=hQTBcFES5h-n>T!))u2Gv-QfI2v z^shAX-x}GolANNFmuu8NHEQXciuUNLQYUEC5{>$EB{f{7cGswPH0th3YAu!8l&BG6 z`Ub+=r5nVhz9%=8?5RcmLyJ78GV&vdnz}SqZ4Xz*gDa^;D)ncL>d@l0tE3)Rsk=4m z?;16|P9=GVN?xmxT^Z{tscTj09F2NQi+uZ?iuTA*se?7@FB&zsk~&JIw$rG28ue?9 znvR~?PbJsU$XOaWqcU;_m8#RITQ%y$N@}P|y-ki#c4@mtO{}EWRH?Zdb&E!AR!M#7 z^HP@%+oDG18riFod=F%&l%Y{qY1GHFD{6dRrB2kSHjR3*l6pX;CK5G5JWOc2w1}A0 zSNxSqZAR4e2=Q|wXNv29B+Y~7GR#}IKy{s2l;JaR1wk1bBHB(j=oeno;Z#K1CZAJ! zNT1RGgIe%Pn-XkBzC-A|Z+kC191!viv{nhc%3{X&OJC+u-SX#Pl|dQI|4C;-P^3)z zYoJWdkjFFBIW*Js357FFpK6cKw8#1yFL{qOETvllByX2`-1rFGmtrAf`4f+9s)AA8s>j)T8L6{mRUV7y$3n&LM9n`#dGiR zJ8N0}T3-X__=Vce4e2FhRzVzclAHJ~59I89Vct5vgEO13CzH2W#~PRyq7a%DH!(t5 zIg^iD#|8;!rtxFz*rbN8d7E}5;f9rJ?1_~zAU;E{Y|nQ(D_n-;1N`$3SrhM>gbPBU z9eFV2o>C1KjXq(`g<7Nd;7?e09N;=dhz@BIGhT0iPd$B;}Mo zc$>Fe#?pn3VSLvzYz4h+%Rt-C_T>i^=ND<}$;GN{s|cMjS<}W#)ToTv_a= zhOqMsBZF!l&@2u0HonoA7r&s0*avc%S@_5Av0$P296#_LYb+#g3|2cme1QQw(#xn*9wA$Xd{(*gDQY2icFPpMa>GVZXJe-L zIRL9{3nbMiQ`|ymc;|^bW|cTI`{B66KjK2kI{K73E53)vxVX%v*5Z{l_0Hpt+wvu% zFZoB0_qNa*Ebqtr`*q4#sxN-!uLA>bo5^YqE_EW1?|}W-)DJ5L6b-l)=$!>rW>Y6% zv@#cWMSU|ZEr2L>8ca?*7MGH?Nbfw5BfVTzUKz{yI@Vg%))45K*o=iWPIRfMQ{4+4eoE{-y!Z9AUwtdLu7YXq`5r!P6-%kHVHynsy7@u%3_a4BUt0z9&(z`k`6Y|x}7|MO#3*D`7gDfwzMlx&98;q+-+NQ<&^n8+itbNCORu=w;{dfhA^ zI{z~P5L^wd=CA_%X?#po&?==7xDJrxHH_*$%JCm7rG_u@SycCYM_1L!uB{RpMXgi_ zi|OEws0UuxD6Z~{($~JAQHe;#fpww>cAT(IC>PuE#@krC$hNOjtc?`mozMU&#->)W zjr7wwN|jEn)j6+FiNq96JFITf0k=jFU*csb9|9{;31LRf5s+L5#c15oi;669R7E?%VKZ~uNpn6iPctKJo_-^ zbq*M1=1!_LS+Ge9CY6x<8%cH>9+so@2US(|77suVC{V^C3~TSNO1lcec#V*_lUM%= zy7S*Z@VKww&Tl%z2YtmF>wo7GL@UQuqJ%RddM5?#_*aO*tBlYZ*v>-h zZbP2x&bH0N;Dj8-l-wQEtmK%Zz-0UDb`}yE1e7gMr@UWDa`eP0#TGH9r6}C2M%Z@7 zx=^g}pdBnIv}n7=9b3t*)cYJQP_flx9en}ZYZX3u2dl%5^dZ4mmHcASpJ~!l_D;sv zdKeBhe#*Rr>1v?OP_(42>=gu^aY$b)praE?(JaO^0xw}!19kITI`juxPd;Y5g)Q|L zqIJ^AWcaNdHy?>N8g0d~I2+TjGP+{Kx{AJow&q`tWer*`*rt{IE}mKrB_E?5kjb1F z%hkuoWcq&`e8T_Wi@spB-44Elb$r7YEHG+*WlTkb1#KHr|L6FC7Xb++= zCcVZ(3Zd5ZP$FB?AT+%i$9L|4toUnhet8GHk4&GjjzJ&8wXZ@9PldeTm}ZsV{3Lt3 z34H2jtaZ)lJuy7nfH_~+nEFxEZ}{HN*nFW!Pad(J)iY%$lF53Wd098~U%u)y=Iy;H z5mCl}?Gov6GN9Wh{Jr(e;;ZQdPBHunz1Pc{^Tohr{NQHRfiKy>d`;&ur@C~eAJ_3M z8(5nlB<7^$HV%8sa2h|Sbdxbql?UA3~LdK(u$Q4a-ybpeIL@P+P8a!?w3%jZAAU=E}d)KQkXxI_{I9c8Gcv#H; z+K4Ms((t<-7M?YJG+sR5s^U~vb zoJ>F$z6Ub;vs0Rac$ik<@<{Q>f$s@6guro8D#S^nK)HQ1T1@U?iOZ+6w7=v^6^NB;eG+PN{~PwCMnm$Q-Hf%Jo}W zg0+{6x0O@c-UYFdQ6uMh)yp^=Uahhz(#7EIl-_qSK(0Bb@xZkcWT!N}3;$><3-Z2L zho+OJbLtLhA z8fKG*@dBp3hFPIul7X3}VHRkZ5x~5yVJ0@<558x0(!0B2D{&g&r$lK$pwe6eLX`#@ z5UyBMz+I6vM6BYW0anGJ0ZGa~A?gcBR{qj}5sIP#6O@}85T*R40n?Q;A?Ygj93@vp zsg0!U(_m^FWrqe+lPH@scpbqXYw#w5Gc@>Hf){A;PJ*XvFsYEr7!A%QI9Y=W2u@Gb z0_Q0ZtHDJCx6kDX)vk#%8Ow2JsJsqpuuEjQHnK~%qz-8 z4Nh0>B?Vf5>?O(}4Gt%Grv^t6{FMgB61+}>tptCd!AS%!*5C;Qr)uzYf+uM39D-9c zcrn3A!D{=<85D@u2rCJW(%=yUH`U-x1P5yHw*>oW@J@n_8VpTQr@XAM);^oyQVlL3 z_^t-8Be+O|&(k!joYn$GM99|QVuE*TutM;+8eB^7dJTR-@JbCPe=B9F2IJxtoiay* zaoZqnjMiX3f=6gD*#(q-fYUMF;Lxj6tQsMl;C32}FX8Bva1EwCR3%u0tpxjNa1y~D z8k|h9PJ>4f{4_{yi3tQN8cdtv$~6t119-G@UJEQHLaqj95WG)=R}#EKgVzzfNrN{L z{ILdqOK^q;?<9DE2Ja(ydJw<&6Ar=N@5Fs};Y60R1OIRrOA(gD@Q1sw;r~Mtueuwy zqFx<%>~2WcchB;1yP*|sILp7=4J+iVw!C~dw9*Z|x&Iy(A-p`pd+lKzS{b2*k$YZ` z(k0Q?ud6$-d+MUT_TH}%UjZSXfFfzMMx0R|Nj!TG><2jmxN{HV!nlrn-Cn3E`(p5A zSnT$8jN;9+P@*Y4c|sOzChTd;=Vr0mZC|K+{Hao++;c=cwl3vgR44tob|?T20KZXy zwHDI%kRJ?XXOv=Z$}fQ5&w~E3yC3)52Qi~=7^ zc6XJdVT=E#9Gerga%@a+m7`B{D#y)kS~+@jQ_B(6O)JOlu5Xs(>#kZknsn95!MbYY zxLAeC5hvUV=axJcZ{o{e%V=}6rsgr`<~N}e3FnVSph3(_J3_RW>j|;+r_NdHPqNJh z!_-%=c-$FC`U^w(k~8d#$Hv8Ql4CTV7VY7K&$34DGk}S+_hHIcd-#g8ETH9E6^Mm< zNVPUE>kWO6K4PKE=xlJ*Lw|6Ciq@(!p#gjNwX=9xaFVHZ4*mX*_F3c4u^^*R|0$O* zvA5H`#>1BJdXqgda}3nD@^SwM^4|Z2yg*2@o%)edGGJib04OGbFpH55*iUIaOH-LP z;_1@MmY}TA%f`l7)*LL?dCeO7reYR(pPO&v;Kl4b-t;!B)vQBhJWUxB@~MmCz{Q@K zTEdn}2IbXQo_d=Fn-foUa$k7}A-e}&t-4*_ew)&2iLH`e?Ba zyk`4sG;ed6C8z(6NdXSny(%ds?nZiz=8Okbarz@hjNM1&x`{x7oZS<;h+WDHfq#5) z-GpQRiaq2H?vrnPBF+JIdOyB}@mrj#`U%WSaOTLFKHFDWs%7vH53S%OTR@hd0PVXm%N5{22nc5%kwNG4zN3h0O zQy*uzn&8Zhv(I?ZH3K}0aSuleS1Per;eAE1HHI><5>MMWD6RS&b*wI3j3Q!Mt&W0p zmp>>`^LmEXSe*KHciE!_yzdq4#!1-c>!Lt`=(l*`2qCQ(b|8xCm%#LtXzzIq@f0-| z`C`1BqsGFfAo`C5^G0{HjO3JJe9#EEt$YfGNTIU??uiDUeI!ST zsVQjXNRThmeGh?@B9uLe*Sp4oJvxKY@K|d!-sc*;{n1X2YphQ2P2_>xFj_=!6`B>j z@LK9rH1pUXYG$=%!>(f}BS!b@EG#DOxYK!n%w6CS!4uU#In~GEQGt3~uf!Rf5drt4 z#F(*)`Q7I*yEy8*vi|8h8|j}^t(GqJE)L`4ki^m&6hZ;KlmnA^(;L_`MLs=mz>Z6; zgH$?Y#J7m1i$7||S4+|6{NEdF8RfF{CaZ7wld_|>#LFw9#)~7d17|IA1+_h$(tAi8 z*?2mo@5}_5mwf^Tw3c}($@SD4{~vE(0v}gZ{r@K2(sY|H$-I|t(~SnoGEkPVw4Jsr z0YL{)h^*5>OMuc2s}Y46R>MAJ=?m}^22hL$IH-__3In)AKpb$33p$`kP|-mJqd$TF z_uTWnlb3PA_WS>SmrptOd+#~to_p?o-^;xD6^~t0YMMXa^b43j@yY{!Zab{04&C}x zscEMbg-3?ndFi}Y-rl(P#|F-69QJ2Q(ymyJH~#D3(B!m>pAd&`M_26eLeq|sUc5(t z$ z{5JkEGwomX2kbt~?+73N%Gdw!*4u&flMajGat}`&7u+XD=UGn<4*uaS|B#oP<~AL= z7HddQLt=0P@}|DrS zzw_m$eWvAcgvK`JW35*m)-w2ytNcH{j7J1p*7%bKoA&mPf4Qk)!47MJs&Pa=7q3lX z?u{Ogr~bQQS@lmJZ1O%@UM-3w`H5j8uR1Jll3tnG8&vXjxWgHIq?Uwv9;h<6t@aax zO_8;ifp1vlB^M;|H@|oQzxiFnKP+Ml{t2%%En94EkyZEP5jw9rOn#^>di*Q9K4glV z{j2z}th|Vd$zbkj*yI&E1G)_P;$Sm&o|7OMr^_Y^y2kCPDc_-txcv$EG8Cqkr*k52Z6(v9uywOL`CK)t9F{GPG zGo&|?-bva=`Xp(|P@FN}U_!%3O8rljcbWNK2%DC#~P6`euGq@5jKYSI#alC~ zX_5RH@)u86x%{`rX%jr6H2SDg^lFnH_p};S`qEBplQKjzWZbMYM#bUBRZ*TalO1mq zW=~VT@P*`0DXl8Nd1s6ImA`b6Qg}9P1haIpr8$c!XkD7!OAS2e;4@O|PCDnX z4QF>8*|9FQA+hePb7U+O=yD8Rqxao9XY|6V-kI223rJMCFmCyn9%tvw?yLOPgNc0< zmrqp#vKJ_g(PO2JGqu9kF+a_Sby+pFuCvs3N=r-D#nxk_)gFvl!$_?MXTgO|!_OAs zj?7tw17;fk-u5ru6!~a6aSZ$KwQ6garj9n!V-X#g3G!8s4?ECPS=AR$D!)VilGU#R zz11nrR0gZaIiU(SD$Y`nKJusMz1cFZ5Msw_9Wq~1*3!<}Q{QVH;^fb;2wMjytL>O% z`hV2n0M1s?9ksy3PD*VZ@)p;wgL7n}?SLZ=@OOT#>DsZk+Te(hAh@P$ahkGHMkw&>t>O~ zpG1;6q4+~rMSeWS|MqoQm4N3N>rNsx8#_ig8W}T@) zlr+9kdz;O-lbFS}#ui(>b{8S}X7RR+g_GF?TeaZQ=aeSDK!f^}#=c1WWu?wdN=vs9 za}jq)Gvv=cr1_PV=OkAb@8bVaf&ClkX_gngJ59@3!|c};+ZvYh#M_i+?@(%MW~r@V zyjSyW4F~DbY^6ZWFWK_a|DOvivxdc=YC)rQK09GxvBqj0_=k+RWOi&+S0$Hgr%O#& znw?2JOKE1d(zvIz*i6dw*c`=S(gbOAo=HzTVU0LHc=}L0<})FK|5yGE(vbLms%W$t zeXw+lzjqT%o}!*89-#(gSCXz$nkP-HQJf>SdJAjGcjQPK9Ril|A3j7g9MTdCOi;io zYVY9iWO|bP158icr^lS)p{nonNhchSf6up{s&a+RnjYVxG=Ef`j{gKAvWd47i=}pg z$sMQp4kw<>v5Ir&C@m33k5_DWpc&?ePa+=;ajXFybsYa2l_7tcQfq*v){t0-=37G& zEnF08XP-IXUg#Dn%;4mdL(t>$Mm3A4I4V)6? zb8l#R=~boKzbP$~CjPECPa1pO;IvcxGc(w0@}#EwiH`;~-%eS{Gt}V3_%X&X+xrHX z9%gz;y02J>na*U&hzH-&wj>r1#m@jTSGrC4!?!Dq9jN0jd8X=%lP|w@jE=9=waS>wD$O86T$j3DX^Av@gJOpT6hBKo z(n1xDZPWY=X^948Xh80^G5!;0M3%&pXQ^eWyHy}cS|Ux7=I&&HpI0hglF*wwHqsSJ z4^U0ML5GudRN`z^U#?1TJBP(`+Z=BhDOaRiY?7vD?$ctE_bbip#$g*VH0|V>k?W;> z-%}bbDb2m0H1(p=#BY@rtRXDO8s2&?4Sb0OB`2DO>0^3qGSki85q&8;Ss7xiQS3a{ zoCkpHcQil#J1sc;iQ4)3mo&fI=2KtzWg1TEb_V37FDIVT0y2M4#-SiXAV2&k&Ch&N z6~x#y$yYT!N9vr<0_d6SGOck}b^4BDxmWy@3Z$s8dN9Q4vTpL_sW`s9Dt14u^7bf| z+ey=NOs_slVQOi?<-&?D-E&WR<>!Cgab!Okvj?bPW*;h8tu%Xx(!>Q?Q1p1k@eeD_ ze@tnSbbx%>l%{7+Ru8vdsPbW^7a!zau|2IB#Vu5187Pn-PMxCpvD1_m&Qv-;`P8M9 zKUZmcM)k&+o;_dFbDvfkO=mPxB4gnVy^(mow<@_SRZr$BrS?YR-ELLV_KM2hs-&(} z1@=ZFd<8LYB}pLfJjdG>7MvvwlV-?gF9~x@&ueZcc;luc=?(NPa6eMGj z3X}I~dWJMdnz~dKTE4{n%9kR|lHzJ+<=@8cv8qh|>~r9g@gM%43M7l9Tlvu)+3Si0j{RaQQpnF*z3(h~Dy zn>9UilG4-$rFM7Mah>Xko~7xDE#yCQBwv|)rE^Vs+DV+P3~^0xtU~PUjFp{PRcvR+ zQd;>(yRVI3t&@_yb53NGKXsW>J3A(?5k8E;ce!+S3fHp0tWrBW7A_*T_q8k_e}$&o z*)hlT3~AvK&Cgy1x(w}*wSuJKYm^~(xzaUTI&qqQdW9c;DB`BWTh$*~o(>C_z4QHb zu3NQ4uTZ{Bm(mjDtv_P-D_@+?Gm6a5+@k4REYeQg*M!o=s;ErH#BD6-cBN~MYWwIB z2e1C{L5Ci2*a1hjInMQJxINY;a>|#fO3!~z)14be^2fd?>1ePFGwcn1{9zS%uRWr~ zn#TBiGWSiD*B&w4A#!gsoqWavGHKiOGV_2k*dCF2kl6N!kxwC!enG_L)d)I)0P3QvP>Zv|WNn z>uxrGG-?N2b$;*}toWuf;5ukPnFd6kQbR^Fpj4!f{;ah0oYD-jH6T{j^c2(cFDcId zhSWT;k^$GR3C=T0*KRo@wdLH+CyS39CwJ%|4a~l#`L<@G8EErIqZI@1hdvo_c1{|_ zMU^YR@HTBKJ2Sl7PCEN9HQ08;6bE9_(KRHG8Ndv<>aDb$8k`Ur`E0NJhAIpXDYY|0 z!s5|phAo@T<~PR**cky8&;d7^D@UtAi8Tn5e((yUwTADd1~MJA`XlGG584D}Yk1m5 zs-6-5Z#2O%sDMlcn{|#h^FX@D8b!ycCt_pR=A5evRj;=cnI9gje5E?2Nh{Ci^Ks^9 zNJr`12Rm^pD6_NKPL*YP#u{V`Bt<>W+t9h&$#%W*6F-T>((T>aK)LB^R_@hzu1;a9 z=G!rn_=DmSgbKPW9vjn|iE-mP;+Pth7CNp0uMenQi&;lrJi)7gkN2{cJ=oeCD#E47vvP9`3u zNo?m#ZB)JtX_hokT1+!iB6VoFc1m1?oFT8@U>?0y+c3(S1qxqKD%b7{<}9LE0znqgg= zw0IQPrdZ(GPi{JO^T`{|`Z#JSq3yF;W4l(qw+dnW+3{;@6#bvo$Vpr{vO-ylYgNc> zXR2ysx6!2!RHOf_Q0yHlbhLC5yLOJ!Moz|#624wlu((!@pbt&tFLxu$(wTVYZEO|3 zlNq~?-C&f}GDkk!C}HB1mFH?%eLSr>^@wxri-8B6kviv-z|QSzQ1%OINb#0;HYk3# z=BG$YpQjwATzm!+2QRhpZlyTD6mFt2ONA*+eZ&P_<%#rWGyBllvX)!>l4B* z8f*t@n5W3m25R6XJDpq$_pm^|;btwilVFtTqs@W#ES2j~J$9f*sn;2$7aVr#q|K*q z`NY|$pL*oEXE^@3--;|xyE*lKrdM^n-!(RNpUUO?lvdZpUf$TZFB1=v-|jYSWlHyJ zhOJEME5xH!=G;x^oO)!cW5ZcyWA5Zxk=(N?_uiiSqC=J_5W7P?VJGPLQ?#@yz3>A~ z-!fy&zS1#bcdDH84;K91yMrE{?3!rT+RMm+P9>=L$lb>OWzA)p?f%|AdJF%4YyOEx(yRRPznY@{zyF1w70b{O z;aR-G8?SV<86i4Z^An^giz#pYP(6j&cNfZy)UShREFP0i@NZ~{te9JWmv%;brJSTj z>8Oss_c4*5rEycavWslxJylUL_Ra?9$yXvxkjC~>xzP-^T{ccWOu4#m%(3_=B9h-g3=i(VcVp9n&SNFN^_e>(o7Y$`Ke8mBXy{^x=mW{Hm=8e`)8`a|5d?- zEm~eCB@}IvS4*7Kg&)k2WT(m%NZ+dmTE74fm`xHNtiIdBgAyMWR6jf@P=2(5S#x)W zz7U2!vnEtOJQ(?;0BoAKQHD#w}-^apXzsaJ)Ii-qoDH zzmvOretVrC>!g*w$OO8@|HmQDt%m7sbST{nw?Zf zn>hZbZwaK|=W7C$w*^--+P)n(dL1v)3jmVJ?eol zp5Dvo$kP)srkA<=s_ZM%JcxT07^D zFYejA>Ql4sKj?+?FI^SQk1Qj8t=g6(&5-8ES8)Pg7PEEeugbUYdf9xu!`KHGq@6Mu zt!?3Fv_P~+&v{QT+b#8g8f0JkvhUr+cWN-LR%U*DN5!@POFO=z@|l|X=#Q51{}&x( zfdv+r+C>eEMwP}%b3#$R6J4MgnT1N7MM`s|$)$?3r1=)b;q8^CzN$5J=n?B7XJ^gd z<6qbA*YLBu_PYr0;4EMM$JKbpb&ca3w`K@(dT75|8SPuMrRx<}d!%?{?R0yil3G7m zo8)V1Q0^#w9XP+2%2~bT{S@a{HpuS{VK{tP6JnPu&3%US8q%#wvziRfBa& z{5i$tA1SqpOM{9te^i?Mm(tXKD~ zXoV)3KU$&A1eFhyqEORiGGjD-{W%BuYiCE6q+9y5mia0Fy9K`d%G@=WS062~Ja+Q^ zox&U~*t)f_onog&sjXq|qcreiP@E&Rieo2} zkJO%MiyJ2SN8TIR$7!3)6{jXl-K+ z`X}D`Q&h&jWS*F+=_%53SaFeZ@7C?#Wvs1sY792h?|16|-m0;i+Tx&(f)+5b?|Vg8 zmn`>o9)!=zkM`!i9_b6Eli$>Olz*@Gzspc|CDC! zYeiLm;9ad(4M^kEWnOpxPn!Q0`}2GBOz{_5vue-ezp3eoN0r*w^^3m&M)^+oLCwfK zth7v;_=e&vX^}KTg{5B2k3T{=riWQj;a8d-dtPaRv_P5x)#E1r$lm!i6_G~8LKv7N z&5~xWr@|YQ#%>|~ENM<@{!XRgFDXq?uf3Yc{cW-yH(MW3SEuM|+g2rZ&KT3fe^y0F z^4kqf?2norXXm=*W^dIkH-CK9FYq_tc%Fj|P5&CaR{t%>i9Uw<;4OwDPCez+lhme9Q9H`tXyE5(G{3sd?Vo5Qm~Y$M{)tAaQRQOkk;B0W zQy^xk%V~o&F^2|uN*&T7X>_ipXGljI4R-Q9Hb=(MMuAP|A1ubGL-Nh?f=18lA&V%2w>z;!YF^Y zv6Nh>o=MJBT4+|9bCte_v1B}(*irejq(z}-mf1-&25rN!DayNR`VgBa8&~Y?r!-HR zSfRM{F>T7&0g8)jlxEf{jqa~>hh4$`oTI7aMy7O^W>der; zIJA3?(e@4%H;>#q{KwXz`~xkk^kb!&pDRuMo-}02^AFk-S&cu=XU&eH5yvPkZ>Kb| zv(oq~Qs!qU_a8qzL_MENU9f87#*J~@{bL4l@LMZ^pG~~U$X5J#(kQ<{!a!w*6>1e)-_YuIX=U-SX?z_P{VT-Nxch@|E9(&+?b8-jm*0Z`umHUuu8h zrsF$WffNmkpP&U6NTVkzj*%uwInkw^EE7tWF{uJsOSxYdWI-|3$nGZXqGe~!j_=YS z@`X3h0R9?Mia2F3exGqfv-6j--m$SWt&v#G-?11?s{B-B*ZpW#;%qgilv3)P$?7s) zI--R4YgJ8y!i^g@oqKl2ZlkEvzMH*05>I!0k7MjYHAntxR3?Y_`bVSTPFClG{n6;o zPMHRztO2CP86UtOemNV-*L2Egtt10Eo$6OVl(y0jS1OHPrL=gp(h_On2J&6c^lOx6 zu2otlja{d>Kt6}^WtJD!^aGs~6~;(&6i9tv4NDSNck43Ki#MX6-XEM7Sr$r{DU*3v z3(wuIG=7KD>c849GM#_5?IdqgKKo}_mfAns4&SBub|^+4P@GV@(#d{}1(7Bmq(aj8 zLyC)}@m|GFA87BJ--(F{YW_7`J}ole^}V`W4mzSr-lrEkB8p> zSh%XsytwRK75v9xJ08CXHvGGL@6_XJR^tDgfGjclJ*BQlT&b=oT%xpO>7|N4=txUv zSb%-T^KNfE6c_%-8xN*U3QwpZ@ADB4E+*!x!qPmx+rbyWQc>b}c-KQFx#9xlE0a1j zFiM&s&64Ix_3g)WVhe5{)^6HzF8{Q^aiUMF%j1t}jdI^6Wx9P1;Cw^VBzlH;w#$_Zg${C(hTOmdS0>A22KL!bdGPupBKn?ZjEIJ#jhL zC_|RCNSeG>(@Vr*(%e=}Pm#V`!DZ?>a?8eZ)@6Xa(p>+2%>V@cDYHiF~$=}GV zu4VX#%AX{Emi%R(M&8Uy*h`fv{=zMqpTEse{QgEx6YMT2TpU?I@(#@}+@&zzG12Da@-eQ~UExw!Mz+XuG%NVO*TG`IS1w-Zf#%4>h=h5YvE zZ`9NL*pF3@P0!k=!&T|U=2>ymwPHURDG+OBK{kD^;___LIZ9DY|At5KBRH|2s)A%p zGv4j8Bf41m>?KlZJH__mFiUJNkup25z}okQ|96)i&aP_6d%o;Q(RGP;xi~D5?;S1< zO;Z)<>GC9fX(J;B$uj}`6d^hi-h%&`Hbr^4T3XyqX`I;pIW>;v`#DY&Pd&f378mB< zbaM0YHMY!&@`lN0j#~)nL|_U ztlFu5czI;k;|8?CC->{SmAQ%fJI?FZog7`aY15XI)}4dDmWZ z|EN`;-*U|=cc=Y7`rixwNjfq9!m4Ax*?aFFBfHo6#a~3+aleo^4|<<}G4fRX!i}4@ zY&lCxVF>?RD^aRf<8u@JL;f5&W!AD-EC!a`g)=Ua?NmGs>fiV0$dCNQn~@g3`0q%j zH~-H_bWCsdFOg_Nx{msgYr0E4ah`Z0ariCGZy-()hlvZs_}qdC(YKX<262XXCUH@5 z+Hsi>bF@MpagMl|xJ*2oI2ls@ImAWcdBo8=&7W`iiKE1^F_MqzbO94`Cc$wQ5@*M$ zf==QgV!K+o<2C<$=C>06oA{%|Zxbhpk8t*MV)$=2XNuF%`{rAbKTd%a8l=f26ql-Q z+d2cp_?CzXCE~HfgT&*Ahls}$J1wej0&zVtTN^JlF~K&sOKh7vN<4`QT8JkT$B3s8 zw-U?in-b#0xZ^RQjaa)6>YreO?LY0rw*MrFZU5;Y#)nW$NDyUP&i2{|wkNJ9-ht&iVJ0jigG;<4ag=x`;uhjvh-1Wi61NiX zMI0w?C2k|$TkDTLzy$ocnF;O0tB8}tapDf*)x;@coYzd~B;KDmLwq1{7x6*H|47U- z;b1a!6CXmHBmNL^5AlbI^TZz^?jx4vRziVTUZ9iEPn0N5!Jqk$5_BiFgKanRq6#vrIiOi#SZ&NE{U`?cc-d=znl_-NuJ@iD|H;tj+Z;?s$<#G8n7#1|Qi@t0>ph+C2Z@mS&_@dV-$ z@kHV>aRafli+W%(ahNzv93`G9SjK;h3A4x$CvGB65H}MiiRTh`67NXdMZ7O@j(8<; zo_H;=lxFBV8Wmk*ii+BtN?NSa(aN+B@V@uzlC@rajWGg zZnONmD}TFS>3CdY}WsV{gq+R zGPEfkviMNN^}Evp3B@k)*iS2NA#NsaCANFTHOl6+a<2$S>iCP3@k}zVEzCT zlEl9tP7yyqoFUE;XNj*P&Jq8RmUBo{i?iMWVe=iey$nbsQKH}?%`-vYW9w7b>@gVWnh=+)ON?gB}daOw70-N^# z5EEL+P#|t4{t&HN7Lx3GyChyII4$0Z3`1l%i#W;rU5V@WQ5Sa-_b`7SVwd?BTX`BVo!H(rt+MNX3k9wqLo4x- z#2qYPH{v$t+Y51r`AeAJ&iqq|hiJfJtB?5`?fT!zglowVqrzpxUCcj&xSRMA;sW_s z5ce?ua^gJm_a*LQ{-wtMNNguVj12u`_$=`N@h6A}iO(e-BK{b02WvcoxPD)4vTejJ zar&c7Xkmg+oT7r6#I4M~hPaCc?@8Ro{0oUYDL;$2o%u%*XEZnUL)>HeX+RTkAM@LZvnC(@k1(O13?H`wtl@sd1I)jSc#!xD#6!gA5!dgh zF8?p$91Ze_UCEdBKb8rDWLQYtLIo!iw-P@>+(!HaaXWFIxP!QlxRdxP;x1sb{(p}N zJv5-1xSImU5!?OzZ!JIbA15vle~Wm4_-^7d@y*2f7OwxZnNYt%U3LqxOME%jrb15%bj*6e1!}h#P<+)5+6w1wX*lDo!k@Z z{MIS%WdG@1-2EqRa5m#5xQ{tU`V(XBDHBg~)&U;kB>V+a+(>UK<`&2J?i4rN8{ge6 zOiTBz)++Rq7D-E_Wm0F2@`XvGq&t$flEz6Bq)F1#NH>voD#dTOFyT_tF4C(>v!pkY zc9Z5v?F-DfN&iGzCjC3<5b3{3 zowe%0v844vWy+h(gfQtWQkQfNX_Ry^X$xs9X&Y&RG)dY?+C`cpEr6OSufzmrf3+}5 z8Yk@_?IO*S7D*;KR?;@oO{AR%aLVgqLN{q2=>Vy7AQh7)NHe54(tgr1 zY4jkKOOV=5m?G{v$W?|OCKO0Z2ldW4$o=s6x%Ro1z4x}ywW9KT%U?ak-K7p+VcI;! zy?9J-@-VlhVO;X>p7}nxpF7%}JSjS**=aq>b?`;-tqVLqe!Dwv4?r7|fw-gzyAAmG z-`f(8<6rAh{ymqtvm20|hX}qOF4{83yJJ`N2UL_0uU084l8_5Y1RgZvsVu84b6h^VC{%HTokE>M~h~RVMVioE=cF*pBik?7R)D4cJE_1a1bBkGj%#WU*oJsJ{=r6=zSadZTEK*0%|t;kw1Kad2Qux(1LDb<-GO3Qgn!-9 z?%YW!2oE3=AMrMBKh_;PyBuJ4KMs32d*4l!2m6?O1m^t`yZHj5lPA8=B zxoA`IZnQ-}VIJ`TQOdRecdfP%4Z+X`zFKYJ9E(yKO|PEm9y=_E!vM2uQgBVM*bkg@Qq|qiT*oo&*O%R4+r8>4Pmz-*tAgLU$x0? zZa{t#GWfKzu@GHrWoJM~7V&DGqOSnCT5d@m=O6PFx(u>Q5XG03Y30~GhXQKrj~_N! z)Rjjuvvi#Qa2o2u@FPUV6kmynP{ zS@^_srEYyvHbZ|PE=j^~L$H9{iT*uXP`ByLj+=BHe34qzMc29GHUiqvhIq9`$*YH0 ztp*iU!4LzV4Z+g8lNDD^%LimqNsNYVZu3OQfyXH%{rfk$^To>WI@iHht8JzCY5}&P zH4vAyg;=dxLzRwU<{4wVKfaXhSRzm$We0Z3w!uzQe!e5!IG~ z2tEOAJ-MnopdycWt(hVYwY5A6T{;0tv8Q5t70~Mf+Ym#%+EmFajG`C1bbW5b;D#(d zJ#CuE4DNv5KE#IycXI;lwfcJIRL&L1uRjgWRCQ)>1KJQrd|2D;u2Hl>gH{^(S%}~( z&=qI)1k@D}ueo!ATrFopmsYw7{ql75%VE7MTYzndBVJ2y0&=zVhEMl*D5C8nFc+d7 zrw7aps4a}5)`46twa}%b6ZzpyFn3t*iWXoS;)vHWH#>^nusK3*bwaeS=E?CcKsP>{fb6eC|4rIhE~LDjZu-T^bhZ-28f%;Wj7%ZB3lebQv2@{+Sb78c3M2K2KrMY;s;>vx;S_phMW69t z3zBSzBd#877VcVA4X4b+F|mmJEZ95z>BkRu#yxui+WG=7Ro&^h4tC+VRpbf2v*BaI$R!eKWzZJGl%!#cKP5KM6fuRymoDamMFp;n!=*TWr z*e}^z6Zbd*t58~AtMcEL< zYE``RZ0@FKk85quY&9vr)( zGoT`ic(qDVCvvr1nDp1JgOSc0+$lg5pH;8ac_^T^{=8v}jdkF+A!ubu)y0tA4iS8O zUDPEn!F&_YkVU*tusMCN74BN|jc5pl68LJ>p(Lg7x@agM!y?Q+x-LA|pLdeG(2uW& zEuR=xoI-rqmT}>^u*E;)BzKod1w;$T#TVc!t{w<~2L< zPS?SQQ>4unp~qE4#SM%YeO>*Q5SL8!($BqRmbZBr<;JTAfYu zSGeOA2lNdfUOg71tb~8ZiEbp+WAsc4FKBjJ&W9D}8>?bnaKAu?B;p+QFe()G&s-1L z7XR6eGW$X{4+ebdzEY$9fbif*;kXLtRX7FV)=yzHe98z*yUzl&A%%El9f-i?DA@H6 zKLy3+AXz|mw@S+DwqhV4T1LFqG$nGi8{VibB0K(RH2kN<|A9NFb|l)+De=mkQ>ds_ ziu>z2+?oESC*1l;R!#2HJhcu%Zy93!qL-)E`U{3twje&dTL=xQ%Ce}OJu$WrGcp+P zRPZ!y=8W9!2E_9t#G6H+R=4TAz<=^)cXmCpoeRyHVfC5q6_RX-Aj}iAgl_+}lif&Nh8l{{Fa(yO)v!$-Bcub?AU^D!X5p_@ zy`c-u-CF%37zBxS|IE|rE~#F3Kw%#79w}|+IN=WY$Di&l@^O(rd14!|lM&|xrST{^ zV2;F37{=CVB3jc^{^~Q(jGbZ^MBDwtH>q7_)7Tx*+=uvZMLm(IRnd$p%p<%0BH2V) zh1ijdn}-w|5{P%=U*L}24;}8#T`QvY{np^xAnJl)0DQG><8v38@sW{-D}4c(s=`cP zmnUoC#W3|^m@0C5MYkWI4XqNd;ZYH*<l&)!~+f$ zfm#mjQhm-6?3yo;U9;7vyJjTW5J%kfoLT-lbazaK3sN!*LNbf2j!P=zyRj!A){pq` zOy&uDEjzNREro3NQd}UZHn|-R1KQArxNeOxC5jbw?xp&eU_0DHAv1NUvBDUi4+!>G z1e>E^t>xM7OLe%PoCzY9B4NQW;+^Qg3$^IL#zh$CLDLGoH5SIeldzx6Cx?2(;?XvgKl zUh4^{Eg-Iwg(s}FG-Xv&UJU#U3=C*$0k$EII5i1tElpv6-Py3oX@O1P?)Xf=rhuk` z)ilcwor!LkRj~xb!d);RAl3qGLmY86Ae1nIe&QT=&ZMlAhOCaRKxqN7LPgBaoawqK z?eKG8WJyZ90;L7ST7YecBhJ!FYG&A9eJ%uJ+oL>Wc3crCFCbW`2ztU=%THO=)QRly zl`tWosRh`EIO6oUu-4KP_8&VBHWkDsaCcl8uqmLaFsw;fYiY`=rtl81=_=S1(9{BK zLmYA1B&@YG!KP2Zrgmg!!QF9H#ikiO0Zj$O!{_?gw(o#8F(O$h{Av^)5NQFnA&z)_ zqrXi=P)a9C>622B+;MfKl<7SIkpkj*IbP26gteBvC|op^r0{D{xN4H+t+55zhBm}2 z+9IB?*O~=k*C(MZybO~CBvRKHyUZCcAJA3^#H9q`w;{Nub*s8KvcuQHI8~>!2e1us ziPuOG&9wjD!czN1b!XuD=fJq^dJlw176m z5f3b9!d=UO_5Nd@g0caz4H6yKscmw7+!N5&KT?~p*U|>lL|b@AtO!}G2mx&|U>g#M z2W%7eTH0KH`UTLIKz0riompcWHZEi5_XV^KN?whfizkA$b}l)icVZ{9Teo6Z_@SG) z`I9|L0!cP>BA&y);TJ$wi&U*`j%W&o9`MzwRKF?BFJ6z`M?hpmDdsdWc~S`~TCRuM z>rKT?H;fBrXh*!(vjUN;)eT$xtrxTmlLhJBApI6K3T z8&L2K6+@Q91zST9uVskizjlE+{vDn{xmjrG0cVC<#My;_mO;b=yH9NXJQ1no>>l4} z>_c|zjcCCeja~82V@nHYLk96GrDjVT>hteNW3SM9qdty;mLgbtREz0fg8?<}O{1tO z88u@dt4}%b`cwVUm@{v(&mVWepn`D6O~Y>M0k)xlc=an;l2`BVdJ)Xa-lY30dBq8@ zGdY7+Zwz`{x1rkGRIll^z&3OuUgby;spZI4|5@DQO=?GWKcsT1(YT-#&=~eH#71g0 zp7cbp))4Dgy%}UDA=~O3OO4)6U>kZy(c3J7we%)^|B#E^c@u^pSTst_0kC^mWeoA* zcbEM9Mef+9TH|oY=k66H;f(CGcN-IP>)f%6x&!)(h!5dkjTvTvAG;VY>WyPJz;grQ$_BnbTTt9+nxU#JPT9n>(c;hJFR+4iUyvUTOcHfN&A8NiA*P)+* zmhi5)4h1JZ&2F`<7z$_!|5t4-B3El7#kHuY%^^DpQGD6ms$JCyY(sVwwIWwbEp(Yz zYZ`Wgxsb&d;VbPs6wn*}Y<2rK#~@N`e3$;qyh&1z>=dNh{ELdX7MpUMJ7Inounm2P zS83(=hG4C6i2JoGaH`HAyZ$!0RZZ|$O_mlz|l86sWHw$;INuuR;eIUFX z7nhL0hrcTg(jU-PMtsD8Yi@=_t@eNx)5P`2kLPfC=r4FuD`=*Gb|l%*g?QCS);5Vj zwwCka{4V`a9%O01u02Vt_n$6~@Vcie@3&j?9>U_%&*k zygoP`DK>N=-g$z*^VQfK;3?^~C@;J_%0qI#A|&N44hYrXIm+rSahaXnC&ktFl9JAW&-Qb@6(gm|EByCG1kZF}zI z0)YJ3U3e?+<;K){g*R7bAl41%t@P%VLEiLH} zNR$w-HD}_1vS`VxmJ+nYJ`cBiUMnQ)VjHjx8N^3fr51Q1Tx(W`p<-eEp4f3g9^Vi76_zOXOvooXUgAy~1HDDv&k4-+l>Z@<0^+2EtI+9;76_+=k z7K=)TK8e@pYCTeKOcgi6cO|H(@4=L-D&%4FVn7>O5wF#_ShB=**jnBMB^`Ug4shb5 zywU*XDm0*^fcWqpD%9aGfP+I_D%%a&@E5TiRavuPY5}$(iTEg&$qPIYuGKNZ{sUrH z0oi%T<3qAySMsOs*roje-Szii;E&$%mUyCIJS_?C$MUMbjO=#kz~@+vetD1yXhRn9 z;d5!IZ0cRteveKREv;CV!GUkQ+Fm<-C?FmFlD({H7S>uTe2J<$ke>uQKKClB%zZ^C zunk>-xTFcc4Z&(*`u5?rJhBHMf{(3uvgn7ak2@t4YLaSvjCu%gAnrC_XW3 zoCU2b0d43SMXQL_(h5~Nx9tsMA)8mVX0ZsUt-lXN)EEOX|02xybp!Y6AIv~WJ2>$* zTVq=a?+Az>LnaWHq$JpF2>K5y^vx{f7a@a>;fgvrY0nr8>bM{M?mmC>4ekzOz^BJO z$Rv=C59ErBX~Pa+8#)7VNh^$EL&87&7PR3Yvil)|@9K&=c`&>PA+dI)_L-*yuTCAOfB9Q z7f=u20!j;#M-ux1+R%o0E%W0Lt5vG&U-Vg&nnHFrL{kqK^UZxsKA^TA@mf#NMXr|G zZdKbS#(o9Hs#;(@rN3A+u!zU=y;+r>4=&O!vA6t-P?MNdFQ0r6^;qE6&$ z8JShJ?tYl{zlvF3)tdcH3$P7sh*LFI+S$ThYo&z>eJKa|-4IEA)mRC23^PJG%ku-3QU$qK;d|7_bcq#Az{#^9Dz$yz8&N1MTgu zz_u9@_@;10TVFuizzA(2*MH$wtmQcsZi8^kLn!(oBWzAd0vVEs4_gvyQ`r{(u{&in zKsFBsd=t1*aDPB}aD=dr`vn(!OC#D1(bisUZ+nfXd4~tkh7{t%#rnlt@Jh|^ZgpqX zwf1Uz_d~t_CVaow^l`ZW83-tF`p~n2O1x$fsdXSL^y>C~B_?x7;RC&*(HzD)fNkiO z_(-jC7@OxpuGU!$kIX)gs}kf6LJFVZ6|H6bHDJ@%hm}SVAFiht19z=4Gbp-nM~Cbb zB=F_kiod%8+ImK66ZTr#QvQOw)v_T7;6uAmCa>7-{&2vsKwLb~1zk1-JM@s~!c!r! z3?lgYu2?3+Z)I0NMGo<309#ceS8K{iJ*;mRBD)MRd|S6t;ree3TiJs6u=|>az+S7u z<%hX_TZLC+MC2RR%5mXKc7HrA6m?~> zr2t!0opk?IExKyMN85grH6=P^~{L^-Q2 zThM(nbVMJ+%19k%Wdyb%fp~RwB`@jU@dY#;ZhY@U4ZEQw2Tpu<(^w)}`T|;tqiE?? zEjiWFFSa}mTLM~Ifo(`2UdxvLiY@oUmLahPoSlzr6h* z;UXMegZ1tS6!}D@A~WKG8QKw#f5o5LgX^sp|L`wEBmt2gBxh7ao|Y{RNDLre>#fm* zzn}-@;z1RZOw3BT-$pt9MR~odh+T;(S5g=ffw&}zgbl$y*W&N`02Jntor6ecMWH!= z^aZr^2jZehL~ICZ%&Eo!WV_$NuB4*TY($Y_Lp%_dG?B0&sL=HvfQggp*P{DE1Ygax zon}f;Km~62A8;d{u+$p4lv{wKRplt3yHT0XIIH zY3-Tb6VOyZyx(Y=og76I#Pzr+Mtu)P4Xaw&0&GJZ@mjAuWk=B){+=#TMKKYw_(G+a zXlAvZfZl$@`8NvEw~PLQFUdol@97Iu`=bH-(SRy!&OCrNv>}ddjfE9j53yQabNy$( zhE|LtyBnhTSfusZihMwAKjPILLv)K=Ew$aMHYLV>AI7R$F*XcnLmT4Ss-AGxQiPX# zAB26~VjsBi%}8tC^n5^5KjPY|p0L)^)UBHO#iS=;l4>%}j{)0|K%9T}B+l>mAGj9- z9Bz6DW(+|%2L^nLvC?vV0pS6}N6bn_IH$s~128*0g_52cu0vcfLp$O;7Yl2xI$*Nu zg&FP0?g2MGQ)tYPOWQ&~(-7jLUfPOqt-CqQVWPVW*={sM0?pMt(nJbE;PEJ;DLCLx^kLoAaY+>VI1M|ADaY2e9u4YF|69gaB%xc z4|W@Zvlmq8>WlmWWV%(Itm^*LUw6Yz)rv$(>_GpoUw3z#l!Q?H89df`rqYuBp%3G= zf8ANuB@gt^dKi3Nq8xnqR-S1m>_8R_0NXGah)bIAJO1kr|SalGLEyCF1u(5zP zbRb^KSO;RYw6+$xl}CObWbvUrabE#GXbPw;BVKvd(ujq8H5T2vzM}q7J!Iq0qKTe0 zvSwG+4s1gP@e$ARyxHv#skNJj8eI;MUxXMwPABG=uJWsIp{vxo$IKq&*FAzR&<~-+ zb2xE6H!O7ABM_>!aP%MKUo1l5Hk1S*e8z6LBnZ_xC-|2?;O^kNkK!H8BDfMig6ba` zE;EyL0Nc=oIA4IpOg2u~>-@_eMdu11jQu@w^C~HKv*CbX{g3SpH(m(b`c+JS_*=4q zJG(A%u)nh4?uqS=yeN;ox@7vff;%^Ku>VLPC#N~slFq3sL+G(#p)!RYbLTc30yBOB zGk#(!V6KP(ZK(fg?d3J*@A{Cj>5j)RUv)r9J2>$vJmV`lwxxh==tg|x_SqAWS`CfY z@E?c9Ze$Na3ZHxvjpjK2vtfl%#E1X(#S`vY=g~n`){pEIB=C7S+muVX0@`wj*X#)BiIapb(2A*&V1@F{3@emO>n?clYAr8+>{mhD-tJ z_007oV(IPr_1qC(Ow6~6Vrlk1$xsY%Ju^g3sHXucDgG{%{9 z@r2a)r2phU+~z$)jdf0AXu9Jq2stzEbWAyMDQC8nyOR@|7ILPE9)qW={>S|pb>5Q4*|aUyc?d58mZ;W)pIZUe|_6sdeZ`L)>v_n z|5(|bHC|j4n(i+e>mA~M|DSGhwXN%%I%iI3HtIaqnHh>0KYB|c_PF|~9ey(SMa4<+ zoA`gdf7JHg4*LZ2IwWs~`qmxlPl&rP7lk#;zQe{99jhn-@T)1u~vj=QKPwJ|#7lx(s{Kf95rJ&)vMmW1JbG z9h^yUhw#KjrbgQEVDk6*r@OIPJ=SPs=|*1=`f9Kn%O43AZmA% zhMs9~mtZ6JbA$8a{kOLBPV%3h=S|o)#)}@|Es_yBY?Ip1=!7ELG+tElhkK2;M0(3G z4w>GH5!yV)X>=Sxe(utioA>=?B8aG2y@{-(PW-1oofMy7+i zgkO>O@Kb_w&Ftg<^iB6fVkUGxCyU{PqK6`Io=#&fnekz$y))i6LiV zrFnFONKZ29{%Z~1tXUk{s_;ltR>oiOI;NC=Vy@Z_QJ+*=0pLZpSqIN^(B=0{v+hC6i$ z(q3lUV}$wF4!KLk1JZ2T`7rgF8hfne6>9ES$N%Hs+@1X^8ZoO(nUCrHzF)dK`Ws$% zTm0jHFt6XiFBoF=J8W5{V-f7AKi zvT-sD*87*w_LidqJv`exdNtIV=Cz~JOhAEVXSyzNOQ{QGWBQF?T89_U`@6eT8*q5s zX^%D8znJCiva9Lr7~4j>j^zx-a!4BXaZuZ!X7ZNq?EiYHw{&|L7ZXRC#bvIeejlD; z0!HlI;zg!`JyQpE zz5mhI-Rb@V|HM3Z?n_uGr$@YK6S8xn%=C+ycEG<&9a=m3~jzt|R*hi=vLel18nL*6ZoojHh9yUp%ya;Oc z9k8vcbZ_S|m=(5j8o3gnnri>W&{e(mLig&~p?ysUD+r@>{`H_TFxJ?@D@&3VUP&YdToOo@f2Np_+-yKwop{o7qMRm3qv(u{bax=y>o?EV&C#@aDo>fvW33#d2!~EXMmnv|=z{Oa|6MJX7e1>dO3t zDw!(2=%0mMv6x@1m~Up3yMNr7F}inBjya9?Esd(+_J1gSxtFu4&5_rZBoQX42CVnOp`8+xzO=f&GDKsV2_#O zeZ-%;$ZL^JY*q$~*)R?-Mh6sg2*g${^UJr_|l+MMc*v-cB2ZoaM=Q!TTauV1x^of#r~Y zxf`dcr#}RYjSIB){>xoGP4zrz60_qR|LuRdyLlX{m7Yu|0!^LgDoPxKu)&l7#u&hz9n z@#lHoDcj2p1N^QNZ$#}BY}=!EpgX(xWmxZ=-m z8K&*tcIPeDm3R@0z+7aSc<)LR=h4&rj^DaJmsx25pY72``K0lMOm3kWQjhsO(8&p% zyL?-`X^Ft8$4nL{8op8;w$^W@EyS7kE;|vQ0Ko9^5##J!^avqeE2&r z^G=tJGdyHgh++3E^Q6B%spJpKaGPW{hW^UGxX1eUy#WiadEMQw0j{w7p^uc^g%h9& z-OKS~O84oS2nCOK3e@*v3)HpfhOh%2pmNAaE zrZF`OYR~z8?{kyA*&*o#ap?2r51*l=#bc6YmIkk~G*q?#qHE`|=0q#ngx^eHrmHQh zbhWrNkV#umNh^!q?Qv?qSSDA;X%^vDNyK-P=VBIt79by%-KR*RkUmUw%m zt9Mq?m*Kw9?2t2C+&B;T&cLR$sy^B|F__HKGJJ&A^izk|Q~5@kuMOGa(fb zLtfN^;C9FChJ)BBkogtsytLaQx#d)TEt;Jg^N8p(3giQ$|ggtnj z#g`Z?FZpTykp^cZ-!$PJqUO04Z?z8$2+1$HE+_-Y*JFed-~;%BvGQ{oS4*~f=lLc5AA z54wbDSHULVwBT^p)^x0yX8v12zj^8qskq?}_|+J?&g7SIt3Za~u@f2_a>lOrn_TaZ z-E`RRQ5ntX3gjPN5IhX1>FcMYCMQiBH;nW4lAAl3HA1fJCKl+_e=$V2mun0;f%@ym zd9tPX#W+k}*k_INPLdWaz+iKEh?dhKI9yT1fqj*kl9tdmf7^IZE)GHF`K9sRWisQy zqCms@=S{$HzzQ?L^Cj2xIy3G~*IiTZEth0C1>;%vY_gX5m)9G;U#Z7Y9`@FIvX0M~ z7}!-A-V22Hkcr;y(xIdpx}*i#!Swgx_SF6zz}ty$0^2`hnfOZ2v|g;vnHLJ26it4> z9qd1Ku;a7_W96L1vUW+67%%QpY2l=_@Dh1=u+BU@fVORu zJahJm%fxAV(_uzULL6mkrJbi!)S4~#3Zu?6B#JQidUxu*o|+-YV$1@(dg#!QKW^Wg?#UJpTW(TQNWnTZXUU}eSih4D3WyoI5#3wuciT`pV zlkHS2HSzC%(cMcMDXub7S7(j~LK-ThZzayNnfnBSYb<_mxCUN>G2wV|c{kCu3U zSRrE@3u?%fyN>y0B{vSa(|TMthUR|bV%}fKUB^O+``^Wrod&Jgxl-S^e&g=xXJ2)n z-cygGv(2n0?>biF%2+hpgt@rlnw5lth5vBRo2E@Kw})oi(EEij4jdno_LMd^lL-8Y zfM#|=i^n^QJFqv|eXx85G*4%Ni*gHCcICsjt4(===r$er9!!uXD!lR+k8QV;%4M8L8>9 za5@pvL>VCJy;=3ntdplYvpzb-nFSBdx;~sT167}O zY9i%aE2|gLZ1R7xc6gM>Rr^8G$4OtVY^EwZBAapIP-Xl4 zcbrVAS6Q7v>rIi$IWv{BIE%3co0U%7sA>0nij6)u=~C=grDgkO(W;rMVl%#0+1rdM z>EvJQ8>fBLxU%}P375E$eYs3kt{_L1YgQ&9uaVqHx5-mk{e?>Z9B$m)l~?{o{PL!i z)n4?=&*6d1UA5);fQJVd;jK+wH#cdLt*RHlud0vOqN*3X#{$1mIeq#;Ktx_x{XeP_ zp3&4*w>dc+O66d#L*R8Nbr=P`Q9E6#E^0V| zrKrCtX1Sbnl|w}t=Knb8^Bp=`Qf5hCgfWYEr=-C^-z2Yz7JgrVkBzsky6e{VF-stSq&< zNmc1nAz3a_HeM$7-;sIAs;sPFWfk~2JfwxIaXWi5HT&;mdSrHG^(;~+bU)|{X8osv z(%MDyDyvV?0)|h4tNMS2)vfa@s~-{Z^9t-|rfUl9$5J~AT=g2K{H>{6)zVd&f{Lol zS^aMIRC0CYrK?hB(*tRKnUCR{TDYpn1DAkwWk#yXC`i#WnnwG-TbesPUs>ISd^Z-C zzg_Oexc}gV$|{MX^qw$VhD}E<&{{9=U6#>PNGd4|hg!NS{-=8H6Y~v<>)DihYA8FxY$6uvPRcVA%RiYy*tuMzkZt1F&PKCOK-)rfrmZ{gq@Ru!J%~)_U zTiFkf+O_&yb8g>MSsg}v#B)L``(e{Ujg6ooIYlXEx&LA6ryZ=UZb7A`P~mS|xvKuB z9s|Cvte!&5{+vP{nhq#*)hTsiC$BE>SJKiIo;WzSk`-;~Qissr|C|yqn|W?*ndBC& zJ~1c%J?)MCNPkb~cj!U&_jJR@ZLoiw_t%cRxW<7-{6m(?Z{<=)Zg;7W*QJ8>*brZb z4`R4ceS8BpG}cmz^+P$ig9aKaI@PQHvvxIoU3ZFnR!u~LR8Tm#aKaJ{piFo9H zkudTT=XsTLR`B#b$iK)+S^))Lp;Uz9{938+brJ|s2t^6Uc5v)n;`w#cz!uKi#Cb7l z_5oT)#%npgojkU2p?5g;HhI3sxf`k6N947YW1Q<|M29w$-v;{M^C2g`&k3K9F(-Q7 zBH^2a|3&y?GTy+&I4QveotzZpf>ACQ<$`f8=%rA8()u_*Kzbhq407Ql7j{#?5EqVd zVLt^5$y6fVLxCb(H~zlG36wa%g(F-z#)aJniQ7-21Dp`&0$*|L-(>J5>GqNNUJ7!E zW2B3bE<(B>VMTnDv`)^6lQu!xBys96$B%ISclfW#<6HO*al|Jr4k#4lK!O874#dAl zlK2-2bAk(@=+7MgiTI<$9VdK@f*}v_QNmu%@&AZOlYl>n-K9FCr_kr9R1cTxi(W*(q1HWJ%0kF09`>Xhq_b%twBeTdzecNLd#JCxrVz`A2c8BK-W>> z2$y;YtwG0-dnDroEwuRe1Pqb5A8vvA9Sg^Q3*PX>Wp)#@n{peirSB-HD>bfW8|2?;6sbhLFArD^P+c9 zdcdW+qvz3&sNqBOA=-gT7crR7%jhI3n8W}^o6$AYv6z-X`%tOLR1(cb@1f*m`oCa` zOHD^x&>yJr!(14>f)1m+sSGmo4EhSyoW^nVCOU^&PIswkXd7}o;!-}e0PRJd8T3Ee zg&dF4m1qXqh%Tb0k6A7?@iCWr3!OoQgr}hoP*#u&qbE@eT}Ry>cd0q(QX-Ge>2hdsNIvyXY>)eh+52H7NFPA z*C=nUOASUP=m%7No=XixOVMsr<|#5nLG%H-gc{GMwa`j*618}m0;28crUfpQc|ZT2 zTd-+)N7ta#P1icR-cAdj=;o>&j`woqg(G*m_{H%%U8nA-$XC#^%9y{xFg{tCUEx;n zSslH=aE;+M!*2}F8eTIjy-=T5%dnYYN5g)G6Ab4Vt}y&i(^6lUi0=%~7+y2Xc}`!b zvSGeqJHvs76AXifiwsv7ZZ`bPFk#c;252I37MTkf)-x}uH0aD?F$!#ReF3|AU% zF^n4?H&lzc9@kfSV)!dC>}EL3aEjqV!>HjQ!-U~^L&p-GUq!=Oh91M#hP|L%Ukx!4 z0mJErvkey-Mhw>*ZZkY!c--)c;Y~8k_^W1^Z)ivI&r+SjcP?^Gta?5Do{_~}ri`3W z%(sB0_Zd0qKcV--UoLXBsMINg1bs&rjT}0{S2Si~(U{_C>bCIBi+PFky^Q`t#}s#+ zSajFqam8Z-<3`>+Z0yM4#goF)gRV!7P)@|g_K!{ox{H^cGV3xTjJ`O@@?2!;;K}mB&F-P$&*G)qK=bC zjT%`rNvYp6`cs6F5*NO>#8tcM`;yna6CNHjVMLdyYG>*lBa81T9?@;+gc0MyRl-ci zeM?;Bn|82^aL<_OBY7GvHR?HZQgN4}qKQTP)S#Sm*TfN%$JyET8ajSte-*wh?0V#Z zb&`3fp@HJbMI$>+oKQS+YO&fNaXlwad~kB0>*NW;i^oiy&}Bk#(KMyD%8`C!ii#%> zH6`LnNXESrMoVEvQoP|K1CpG=7gJ-^CtRV#)g@(U_`VWX)wY3*z9WmqkC`yEc%-jr z;_#7^sO`**zT+m@4X4yB@szaR&~cMTswX5wJ#^@w;kQd%H zRY~3EG{B^Z<7k_!X?IU94ooiYJaX9Nf9Q*m({A1La_PR)0wm)pNvC>@8{J#|RbPhJ z&=Hb1Rk!_ratv>J-gRf#**iD5WT`8#DSDE(NW&w3WpC;iCwOTu=U3N26Um{^B%G6x zbMTcmDdDE4T`lb6VdqlDo9DDEJ)QCGC7%J|HfLNF!<-RsBjcV&-ORb56>3p2$YW6z zHH;hjTI%>4=_Z!{XKQ(GPF8N`>hU>`%Sku>HU*ZtF7>ojQ0MF4U&YR|^gd0w&W)r( zw}~$_^cngM1BOAvkYU8o^L8aWf4^Z=bAocN*9Ss|o_BOOVHkN=hl3k50~<~HO(xxD zP2Uz1e%~DbKr`@>;m1%~yF%D^#^tEhY{mDDp69iLJ%io*M(w|TJ+`p?|JFXSg_~BK zaji=W4>;p;Td99<3%sMGvR$43zgW@apMP36|IH@cP=_s*XCgc%K~)njFyR^|+{T0} zm~dwku4%$OP534g?rXwjOn8t9mo?!Lc9@~yG!f%Wf(#QbHsR_fJi~;`n{d#C-6lNC zgiD+791|{O!XXo`WWps9mZ4b9L_|yieSc7DwF#Fq$D<~kYr>mNxUvbyOt^{(?=s<9 zCLA~6+9tf8a1)t1bxgz|lc25%A2H#2CVb*_mGC3ynbjrz`M5+PCC~n`&eGzX=9fF| z!2e_P|B&E+$mD-W{om;SI%nAZo9jv$_ZdCd@`aoBoOex135PDR?8wLccs-VHwh9kT z&*Pnm-nqBEHt;W3iny}jfmd8#i0iS5xE-lhQsvo`K^mzOa(BzM!*vYv4I3JI3=0ek z4ci!YHuM<|FdS`IY#7wE)O-^WGF)U>Vz|sOVz|<9wc%RBsNuVYn+;=zyA1am9k9-6BrIT*G|B0>eT>uc6OywBd~fe5wftg)%wjn23;JiDATWwPDmS zW*9e27+x}TcGm@V8x|UR4Z9ioAg`nF!{jEyZ#dd8U^vwfXd$2is=o04}78?2tM;MMXoN5>{+-w+Vpz}#)GN{9+FR-7Gq0V>nrW1a) zX4U@}rb0NLlIPCwIqWkk+#KkovsCwJ2K#EdB}@4@Y;)@xx9LSJASdJ;n$!ENz8n32 zrDgt3nS48&eE$zNSN})E|0Ud*LW%53!D3%HFDSo;Pkv|(p;Ou)Xlpo zke(M$O?7`AUh2$iC#+R2Z-_9@kylUnYhGSsJ6u(BY>tlaZo)IG=5>|hpPBHMTk~p# zW0xvtWP807f~AH$D&*yb=R5LBOTwjjI)gRYn)|YK#@{s8%qcJzs!lHyv~)sU0;NbTlXb zH(WpKPN@bb<(Oi2Z>kfoXsFq-nLeq=a7DAc$K)cln&&ML{#u^8&uE-iO#(|B>uT(4 ztPc)rlDAIc%X@Tqg(q*7ga?+njKBLq8hsJW2K|o zxphbNaqGy`nwslt=6xX-vlA_^l~+pw+iK~^g|+iOlyILq`pPp6*Bkz5SiY_<(d9>(bj7+vd3>^XaX1=4)E(gLX;2%gf7=gG(KGjdSc_sz>UN zt#ygU*3~DGlRYcGG2!y{bhWk_(l%AYgIniSmCUwO&?hm1tA^WF)R6-#=C%C$7059^ zyrrTp_>UFydfCOOn^!Zuv{K&95-6(lx5%F=V{iY&Z{Ybft7Xll6Q^p$CdM% z*pU(_S0(QjI}g)W!_0hH(MVtLvqrjzjLOE6uC*CpTe5VxL7r};)@FdgyzttBygHJ2 z=`A{wVTC%e?)dz?@_(=2!a_ZiYu%=~-tcm6p4*|91hOJzuP%1%Ks#DutICw`pu2|O zX}URly@8&x1nl&7aP_>1N`xxL0*>8RJ3&m6kjSd8qU`@hs8%1sP!GX8xrWn>jbA21lW=!C} zx5~^idR0ihDQ~tkWwRVzu!T7~eO_tJnTG32n^nY2Xqwut2)rfyY4yA+l8N2^y*lao z_sRd?NAk>keWlATowJ?zJCpd=PUf z_xLV(6(sW4ECS!==)hT1o9<>_7P)lxYfL!Dtk(M)>iJ*(#+rG%9?yN+=~kWIPM^2l z@N7GMyknL=KGv{VeO-+extc|0fG#x0DV#mZVU6%zRjWAvc28Pw7W6>1jigFZgc++1gN z$m=JCXkhWl&%MD51Cq;dNW{fc>s>VYv6Mosj3%jK$XOJ}%Wjdz zJZ?RNm)#?SQ35Z!Ne-eD_yio)gjWeA9zNz_uNpqsl!Br3+O!Is){KH2B_3`>-s=AcSfa{UZi7!wptp%-;%A2v!)shQ*Lyh4Rs5D--u3SPD z@v?Ww zyNQ>5IQu)(|NG^H&g@?5!nO*$Y|2TZqj=ezQ;bgGWz$aX9n=mln{_O71uvU-YTikA z9H!;q2~-iEgiE^X3rFC;k&KBr%a5@ zxsDDoGTlSi#fK!*Alz$w0+xF~$Gc%$7Bbe@XA&b;jBDyp~HrL$K6iI^GT66;I7#@GoRfGb&Yx#Czd>R6?E!m=|PWD$U4;ZzD?% z_#dZPkklpt<;zX%!3YbHJtp8ZuYt#dVJb6+6dGn@JEev*EY06dIhc-d$-X%6=Vd=S2Y#!;bouR@Ta(s;AOwwz4KWs4qMb7GxKQ{9S+C_zCY0=yjs9u zM$%jX7)H_(5%_`eF?azsiHIqeSpG zv2uD$HBT#g*y5)V%zCtmhl-i~tdvj1`ha^qzm=5~~ikHbN0=`y_R zyWEbvmK?yedz0qC%Rb5t$cLA$jg8mQPk7m^`6}|`Wglhrx9BFk?7du!0(jXDc~g|i z;AO++6DWw6J(Snb9K3AsoQy(v*>h=~;a>>>*&#X-MewqD^E1WcTL+bO|q8RWmj-JHDgT@G<1T%QnUK)bDU0bcgJZa_Y~Y(s7Q0bPKXJ+rSOKVG)8R{xML zz{_^n#VCN6Evh$tL>J&?|LhYeh?gy`*U%iiGe#Gn5I$&O&Y%(k>SG=(pa@>}#r}p? zOZ+yv21O+veup;WWz+7x|Dp@+8JkD^?>?8E&7 zx#irwbQ8+Q%U;}L$b)CEt)+(Sqdy49M%}NF7cU!edwofF;AIoXpTl5p=2^8Xh>=3?& zO7OB{coK@>Ww-EEv>LCz=0PcnN<2J|HcR|BTnNP^9$rGbB>ph*C@%5v5;`RDM`#t< zO`MPe@EAIQPr@PJ(j9o&di)i-gqPjMy}qM660{23jvRQ|dEDrGx&SY`ieo5O;^EQ+ zU4V~3&kuBgq=9kd!CMJTk00p*01%P1)Eu=>yR{~Q9cCwe&w$pKjD1YIB}z$Z`y zFMF#0K&$bx&$Twju%l7DUr|AN``?N)g z2qXx|p6aG&=mNa#t^OD#@v`Z9@^5qjUN&JLMd}AG28Sf+0=(?Q{th`M9^U&qwZ_W^ z?(N8pmyO&l&e8=E54WT977rGZm@4P=E!7SCA$dUIhf9o)z_ZAHq(6L{IIeH3}|vT1wP zCB_6^HgDJYlQDt!z_-x=d<=HD%$UHlTU_l$qw%r>=<8w zf^q<6TxDM3WlQ>G6vE5a^kb+5FFVEOU1Ln(Wyg5C>x>D!Y+3&lMe(xZe4t8EoAG|Q z9mOObwo6G-yCgmQB!zcD<8pvNkJJ=(NKSy;Q9|Nji?kGV0x#R%Uqwm0Y+J9M&JJ?C z?4N%fsUL}lt=Z!4zkK~urGV+{dn11zaNdp%l`ZO*{2`C%YOZn z$eKz(cKMG)K{)`wLUZH<*qhD$A-rtz&*GabO7Kp&2g&opIIQTT<#?pzhV#%B7atCS z=g=S?w)4H7>NzAn0*@j|pDdSRseyc{ot)r@Cy+daPQu1~XN+7RR4GM$iR_2Zup(cb zC|)-I&q5IjB%c!K>Pk_o@$#vGNBDq1RN`SNK2fk4FP|(}SdDRjkHAzuK(Omai`rmj zqPUy@Q~9XDA-sG9VJ1pQJp2Qlz{|%Ff+#8RaGRTPfRDqnHK~j|QGvUVOv@y!SBvhW z&>lF-_z;|8)z-BS!k3YpARk}2tqz0aCk7Gx6glwnQHQ4W7*G-qKSsF{5AV7qMY-|v z@rMH_A1@z==$FrUl6d$5DwOoFTYU(~SWoC&2T47*Ke151IF6K;fP6b|ii5g_Du}`XKxmO(jhnmc5trS=ya& zo$*ol8Iotsad_YXDr9j&0#nD&$i#c#L?kB%;0s7D7J=WJ_yjC9RL48v2PiHVh8e>c zym%+P4JGhiScFdCgK#}c;$zTCAI|8N6JTGYm~wu&5;^cu*klBQ4zEViTF9hGG`#});1nczMl4L1 z=?ny3sZx)S2+08tdP4mL8#{1xG<3n)A4gXwnJZXXpah|26IX@GE4$nhN`_);sor?RCKBm z<6sTbbFHb(ncVO%ne8w)Sd$iaPxc>j4!=!p}CamQd&{bd$rs@N3sUPtG10R8RY}4^R zcj`1n4;F=z3?scuB3<8(N?_kC%LP!HsC|>_M`MG-UpAM z1U?CC9Ao{*d*Ei2#K)jD`#1xPKnNy~I?f5O^14jrYT*XBc1-5BDT#MSKF@cac_^m+`FAP_`zW@E z%L#s!%8S&g_6Z>vPvfiih!-AWPpv#aO+fil23f4!up^QS_~0LCWiAU&R;p@=Wc~2M zsb~iAQMe|XFtv}u)_lo8P+G{sWbti-a|k%$5EQ}(pj9DNmEc2gbj4H^k$BkJm8w?b zz3^kc`6r5x!|8kr<7Rvi?m{t%hw?QybE!zD;sG15HMQnwbQs&SGLoQArwLIvSrG>d*pz^sF#jCORZ^Y#)`T4+a%;~m#|1dRE?NZgFs17~^pKPD1 z8seky_KvBl0Plk(s0}^>t943Mo$($RMLqE`7`}sxNgC+vma6=CH#~nQ-6`q2r>g!I z|E3b~!}K0BCEf{p_GC;*Jlu{#_&6Nbi;Lp}@Es%rFb2!;1zYkszzN$RxlMcFRpcbS zyLYN8L=qo_pY&lI&;?c;lX(v(6L7+=#{1xG<72SRz4`)P_zQ}VX%cqtN7vwe@C6jb zN8!Z#>2G`xeuX~4C*Z@BbxJ(^ zbp*|aPr@l9sXaajH=}gkqKm<;qnOh8IIK0AX^i*4mr*r*6h1$OF2+a3SgET0So)ZN z559^DBoX`zwZVHHOjV0fXE_0;j-z|yA%VBk&%$5RJn};PouFfc7S0doOK7pRFWAV|CyK9A%9WCZ?&?ALz+sj3LcA`^sviDyQrhZy0=euxG; z7$1PQ7wL1o@CuSyqb4!`xAIQ{F<4woMohm1oIE8}t)*~5SodKT6TAnmo<{%Sqj2zy zRJ9);fa7V&Ba&Vir2FtmSo|d2C-Lyg9E5kyO;y(yP|#mk|DDgIs^h5QFPs4Hd6s^{ z`(d-^=qJ1vZdydw;A60GF}0C+SWrUOh=;9~(jDUA!WZZQd;|_zMnUiaSp7ws9q)lF zU!=6N2t)~Vd^=Um$NS)g_fpj&ymJfF z?y?yC6WLw!72S&LZiVyFELtLFVGc+H0r!DawGYX1n}9tI>XUu&3nZ_M#Np&a`eqY^ zyO5-hL)X{ZyWwe+E_XRN{Tp4NAj~?fy%$bFmMo1y%mE~~)C9bWWDuz%e6=#N2Ne7k zN%{nw_Z_W5p+oQkB!e*qJ>TnrCajYn4TbhV_YZpM6^=ntX#bDQ|6@PW)MS)|6Mxb^ z01qL@RhksOew2a3N*9IGj%go+b$-@26%X{E&?{OHeu)lAcfjPYsVae2C%G^>fe*ml zr#beEMIy|$Gu$*d5QmSPOI7MuY6gEorSVDF^Z#P;k&D3+GzcGo zd#^Lv@d>y$B~6VJ51XZ?sbahrKAx7QX5gdn-t;v4eqs4BPa^5#D6E^2X0HbxI26g^ z6M!k1X?Ee9uq%=p_~2~gqi}9knrg!ZLhvC6>E%`qhh}RZfW33H_rropX?&YNRhRNs zN>fwNEKUx>7@Cid!;5GUUR6$0Es;Hi;Gbw2@t!JaYIts%T8R(9y=W~y0q44@3_b+U z*Gf~L;8pE3^LwnZxg$*tz^iU)YU2Df zH5wm)))M~7yWa^|VF8{4Za4-7B@tW{N>g+25jgGHG!?=J;ftsQABFyfX(}S=;Q_Q7 zpMb&V(o_^5g2&Kid=l1MLN}k3*MBh6(Jl@I;cgVi$6;=m3|J@7a1S1Fh`J`=}T#9-OCI{YVTda z3_vIF5qSTr3`~3gmRpskF5%s)m%_EHo>~Dr>Q}B5A3ieO^v|& z;6rcH|KkV*F$31IP~iP=4Vs0I!tf>vf{(yIc2IJ>+L@;A+QpQU^f2dhrWxJ|52H`; zNw{(k-HDIF{4dhfe!K^c{EABB179)!(+@E12soiLLI2_1aQ+W8-Dxfi@BfkSC&dR~ z+n@La9lQ@NM0F$$YzFHcf#eU4L%A3$J112d=UPHdY-mO^fOI}`f|Vr zzeR)affHQd7n%znf!k3rJ`TtKN?+oG@V=9@7Tyo9qWO5|sWkNqT7*x+{-;^2Bn=Fq zmG}s3WSwCI6Y#(n&(RVLt_a+QWK6{2#PfO(#o&E^FsErDKl~EO)2jq*cR_nEd=AMh zh{3B!24L(Wc_Z;jIP6cIj}^dth3tDjtaFX#tIItbmQ78!U$=3>4oFV+!7#F)qQehN zd3=!FO`t6j?}h(D_QPs;6-g~seF}!8W?new z)^xR%?hC zt911VnR;Qv+tPWIiidSuGurVUScHz?gK$X)x(6SDi#ky|@i5sr-F`_X)FoZ*K+@lF znBP?w!ULb`PXDL#x@-t@a}QlJH*ABXC4%r{WG_VU$({^UNe^Rp(KYxuyscNds)P5! z757qbiHC#xkrzGyEB8-Vo$+qiWl*~6DSj~Xzu#b8IzMbWEM1M}fEV^3K_60TKfG-e z1B`edJcFj<)j!hJP!z-mV6Cxq3El(eP2gO76y{B&sqt=j2a4h&a3@Ny&9_FyF_{4~ zGGSNaeQ>t%A-Kc%INbD*UKwLBwMe&+4?Z`EmXQm<2PV_c_yF974&mc)!nAaizz5-5 z7XOk2VzAS6`V8-bbC6=Ngy1tXSP}6NSRu$Pz`Nl<A>Ios{WDz^ zN_sdN$)FCv#($NYcrE&7Z= z0OoJdHTJ+kNM?Z_zJg>HM4^A9u2~Yc*rXRLFMI^q?*+rxkenNZrMEJ8$=?aPB57$K zoGsoW5W?&*2jVdE1D(hTFQUzi3H4#R8XIFkNkQQ}B=?IDTw{C;j{lgO3NPmbVS{aE zuEUeYC*jGV$6<|niMdkKs)2SRYG@iDmas2;I# zcnZnIlCa(}T}uxfWqbgxGCm5A8=r(v949>$3&CnXYwxx&YfT^u+nmq`ym0X^y6+?K z=3ntV330=9NHU7TJ}0&J!&Am5;fzx{J_t9WZqmA^=?WwjaKnDcl78}I)*&B>V(>B= zASawjR}cNph{p%vxwA|~i9g3p2n8h`wm;8Q#QR_zh42a3>JP>Q-V3uXFfH*;*ytkD z67RXl{2xWYUVPvxZ`=#qp-y_rY_zKLueO10v*>W2;K?L zrDmu@c$Jo+9O)VAsKmn~85!zS(qb{e9Lma2=Q)sol^q#&f!uHak{74^a4nLzWTUWF zHs{cC9=H`<;oKPf0omgNF3;g&vKqo3kKL%bVywD{MCfDgt|XM6%) z&CgIh@y_}gYFmR0)fXR!SCCx5cWZ`P+&II2Co2L^HOo*VNRxy&H`j%B!?8%x2jCVY z4_;z0vp{>xiTSq)#9`?cx@KD|iKK^19?wv_B|Y5yI0vQA zVg!c$lL&6L0k{dRB~c8HctX$PD2&X`u-{k|uANK4NfU*0p31O47Z!pyJ)NQU6Yqo{ zE?~g&$R`F@gvkFQ>EYF9sQ{mxQ`W)^^#PK>5`%fqW!Mj=+;AFtS29|}AVsI-VsQ6j z1`a*}Z(l;I;C*l{O6PfF47Ln2Ztz~X2UWx;VC@pd2i^l0BdZ~S2-WF z_z;}1ltl?2gdLYNKJY$R=_R@b?}o?FAbb*bjL>3|26kD=m=F(Fpc(ime04S5Eq*og zzwYa-Rs=k-`aAJEjYQ58m!tP{fbKBQ|% z6N8mLA`RXRyQ6eI@8^Rl+vpCw6Gl))d=&P!{>9uS5P-F|)9iQ;T!=d3BXIIAnjIg6 z`+D_RE{<4C$J3F{rx-UCM&AAm0#AA|QDm-U~M z{m1E>GmK0w7J{9BqkmX#eef3~OK%c3N$QLFV7cE}-AM0-_o3Z*KYSAHmwez3Bn67Y z$`@!cNe_QPNAbxE7IX0;{YSugDMNKY=kY!mM_2F(_}FD?{0EuB!B^-@d;rE!MSL9A zzDl#=J#Z9~3kP7ybt*=D6tX?ZzTr9HQ1KS`;{fJkbAb0*)IcPI%Maf`1)Lm%KchDI zBy5(NsXF7m&_X@&A$Sn+lj$k}tEFYCL3j@=MkDY+xD$=T$04u3agcx$wnQ`VURZ=? z$q8^3nvajduhAlW0#?n)RLk&g*bmt?hTAhU)k@;yutHX*S}SQ_p@WLyy>NVXrrP=k zkN<<19;GtXCmis@OQkc_ZoDd!scNGAcn|E2jz}6<{iaNHRN~=ibP6AX=g@h);qJ=z5YiC96yYE z!AJ}qs7}91BKUxtLf`}N}QDm=@@HbQ}@pXtpGw^=6 zvl;zAOHRg|ZA~9bqT4f7w>I=K-UpvT(sUvC6Oy~7yDeh_#nXs~tC7S<;pfK3VP-qs zqE6V=cpuz}Bz?SHrlnHan?$e&k^?^Y3bJ1)fGJ*G2q)}^r2qV|MhES^@JvVgo8>tP z$9AT0GX3B(5tWI;gJ>l_0Z-h+z`S5FoiIQ2rN23lgw^^nGVvaGYA^#6uZA!!A7C)z z{qPJrBI#j0zpj7}u0qm%QMeaLWfCxLsP-PX1Rdqv2;685<01rN@Qo3SUh#1BC~AXu z|07e~gVK56;D;6}jSoT3SOy*53ooHMc=ceWsz08AhWEhDr~sdUzfGWUl4fG28a9P) z##=#5m4}&|EW>Wt56LWuz>ZVRV4OyGOwUvUI3WtlKa$BFJ_-jbJW653!~0MG?}sPR zRJ?kOd{7YYgLBawdHG_kHvz6O7KDW9*W>&ut$&qhWEkQ|D;Cv5Zp0a`#8*; zr@a@BLGsir0G~HL0)Kdl7ENb-K<|7#y}k3fK>w$?Femuo+69>^$_1kEPZYzeXEN0- zXcyiCuc5g3P^KD%q_tvj!c3LGhv4=_3^sfmPAHe@qXBQi(YR1u+#grfLs91 zKoNWhZbGZ^G5E$ubeVV;5SEUC42%d z`kC7|K4M|I{mR7&_~5ittmpV3?0K4X8}Enn(F{2OoI?(wEXO20+;ffs@eC;r zJD#VhStWh&1tbsAA`*w>zL0>m{-FP*HXh8w$bL@`zJGxwlT2gq0+L#)i#$F+;=OR{ zU-Y3|7`}<*Rgx(D0ZE!9ta(Ly4;+f*!U6aRk{7e$SD61}uIfP%fZ5lycfx(*850S3 z_jSC~20n(Q&@nhwW!Y(hupmWyFFbF&O3hM(k$t~_eagNLt7bk6V=}9f^|gk;+;2E8szRPn|4vf_Ojt0wwVY*r0Bfx`g+@mHAmp zU8cX`N#w)_>u0IAk=;VDW&`a#aFFqS7&6`xQ~y@oEFO4sLtRTZY||)9<&vonzKq=X zC~V$1OXcIea5wVc6L4FTELDh)!zCVSiI2dYsGG#YNlml(Tqp&FZChqp?Ca(NEwj{% zXf!?v>$TEN&wk9g}5`*f?~IrSCb} z36CN57ir+?2RVk1!qMXx2lxPd5#@>>pQVl*8y|!P57FOvFPw@beGqO$(!4R4Tcq=J!|h0R#>e3^lXS&Guzs;!G4}sp zZhx48L#94>33>7Comc%(H@qK4kq;k(<)>w-0eClDID;<4N8q?eX#soy9!B;wh8-W% zJ^)uCDQFZPd5r#-l`BD@99|B%;X6p~R53U`h-c9V!Zwd&#-1;yv)4Cm5Lc7<9~GVB(z?=3%s&KoIUhQG5bA=Q05CZrBFJ@IJT`?ZU_5 zee<%^e!L&HeoC(&UN{9wWrA>{@o`u*pS%te4}U<`5l&8Gsyv;gj^f=ggihfju*?FM zQ;CP4p)2?}Z2JsNdW8bPXHaQ;1YTUs52WJN62=LtgZIKws3AT8SD*rXbP4l6L7)wR zBy@$dRA;;!-j90X{cs7g`wX63nx#e%uU^PfvzO7-_z?UO$z3i18!gwh^uQHJzKSaf ze@60TCJC#&B!iUqf8Ch7kcJE=z62`=I|V zZY1~sEQ+#{;e&Ag+Y|&Jfg{#4vLy{XxPh+3Ct$6Ox-uTqEX>(LGm@zj&WsUXM&5|bQnf$E(*+**sqqO|cAM@#Cv0xK4?eSv z{y$GfAp##D>4F&i4M~3|VTFHb?}oFD55aegkHMaw=z{uSa0gRMMm~HK$t$Z-_&t(5 z6EJP3DbP-f>9&UvF9QVrjHI8EaPAkn|3a|-zqR*3S6tsA{qQ9u6^Ot+NGcGAqxX_0 z@c~$MA5&Rg^M_^kvpVA4aQgvPRf|9zv*{o!AU*~k`kK<=gRtFURzSQDo;^Z0;MKSE z@Ar%ad=mCeu=wEp@L4n!AA#TeKx^QgKXPkEbMSFE<`)Ww4?ydk-xzEJVld+@tsy7C zdFNPg@KJaK*-I%@f9Po@yaP$R56&KJ_>gkABXib9QI>C4;+PL90cI1 z3`+;11df{nNmwsa$9v!?;{$M&@ln_+%V9r?^};NN!+!C>2}fpgaX$SVfbSr=yT+g= z$6-H^5za)?5+MuojR_=Rhf?~04|Xi=u-|O(!6%TcZXvi6Ne$vKt&H|gXd$^F1>s5K zld#%NI*l84Kz5hG5@g9}k6^w;_MH%>l+}rxaJJK7uXG{!9+Hz|uugdgUx~x0hHKFv z3KxY}kknXJaHs`H9(sr1y2=if&$<$Y%lMIJd8fsl>#)@K{4(_+GD^Y~RjGjtI@qbY zL!H3;U_ZBm@BLte!?c1s^^BikuT)E(f0&`@FkRwkHUJr7%X@Xyc-qbeeg*nvmgO48L#ek@Ee@E zE4^@v@k#h@Z(4|RV{rOCbOAmHbMB=JWdDy7bE+Rrj92~X;{kL5J_%dir>Bq?))}a$ zjR)?zpNq+JefaAj`d-q*wnNOK1V2UHh>ydXe!3FxfgdAz6cmS6*P%3#Of$G*ICGgq zQF!ktN{;u#v11%+D?R{!Lc8!uIB6_RDsNiDw~@Uzz{^M$EA=1+L-v9LL&ghdjI-l; z{U5U)$#jar`QsUA_z?UU*|${K@gc?m@jke{h5gJ5;l&dNuUIFtT4Uf%}kL zAOR!O^z;+fpRVIQ@IB*$k2uu7&=skGg-Mygh2_NoI2)D5hv28EB0dfaA9dL8kbB|8 z#~iAF_yAl(1>_-G6s86pYJ}tiYs_Mr;oY$6llng5hBJ_)3Bt1T=zm#@EqYQQ&h^6c$R5>qWvgF%W!pEiBph@% zEkx`3;le(6rg{X{ACPU|jx7&n>mVJ7!FPw~lOqq%T>fl(p>V=2L$g&+Y8iuB!}P_R zu-kAhLc9+?I3in(zz5+*G)~gP>BZT6^9u2BEwUey!|#jff7!d8AaEVoHJD7l&ZO27 z4-Y)ez!48yEnrOG)ic@Z@kL~Y55WqHDLCE@A3SlMtFOmJc4rVOJ(~M47^(9>cH+(Qce@dqCEhOV33fsMst*#L7 zgX(oE#&YX~d*01frSS>)&Bkn1(UJh>kv}MT;73TBItKkJ z#~x6^l}NhDlaiy#rRJ!l8#e9Q?dSjv9bZz&v*j`Ef2>ght~dFt28g3gF$a zs8)`eiVs?tlPE|))y`326p|C*$NZ8*3EqE8j(QBO#)sfR6vcb;bJQ5L86Sn$P)y?M za~$oGc-W~yj=hKl;4&n$ECOG@HAh*8BoSs8k^@OtrJ?q2SZKT#PC>F%2jNEJWAK9U zs!k+?k@T?kY`R9`VY4S`db}5w zpw0LQd}Iz?gAc+v^K#S`Djb66E&fTfyPwKYcOZG#>@w}Vugk6y|yAKX}I!B%2 zWItSv&f}x-II?d}u<-)zJ+M2Hed0bi5y`dUaO*P^jt4ka46`tlqjqOeQg{^E8NuhD zr4UjBxNl*Oeb-XY<*0uz%2Cz$*lrT`Tg=!YjUPUV_Txiv6FP!-F3C}oo+n>?5O#f$ z3gCTk_KWnteeWmGWI3Z#-r0cny+rAFVB&`xk=!n0@Jxg*;d|cH%Q^q6srP}Ca@_y_ zuWGBUo!z~6c4pd|${dnSe+*Vu!Z_+!tc)XCS(=<=9pOe;PMPTsR#JDQS%iE4v^(2w z?VXb>qH%;pH0U@X43c$3gRm%m&-dK-`TV{;9%L}ocXn1CLp*o{ zp3+K#@DMyZVIL<9XSCTKfoq7I%Y-A_=?Urw+M|P2{|@^qgRqN?uN;UA5KbpD+hg!MqElc0jk$8zUWkIQi_}t{gcT~9$ItB;8faa37H!GO*l}r*=^(1g{^Or}p46_{Fe1wHMF84a4))emn{P zIXX`r6o>a8!!fy~RcW3o9FwP9cmUo>Jh%a8mFKDGa5i-0$qVw-I6Mu@!(1sIg1axw zQ&XfI-u~A-Rf)&ob}}7L!Ew{`RJGKH50g2#32(VLPtBA1Fz=E)HDAi%dqgfWFe5Lj zrp&OfJ`BI8vb!h)w_Td27O+DKcFbgG@Fe`>@;tQ~*RIG@Cy-`2DEyXm;A&Q$>NAJq z;6eB{*@~y({rKW_*y?#c7p3UF5XM%%8tDS_vN_k^*_T#pua2owZ1UyxNs4X$zs449Z$i(4RB?@ z`q5$GK-)F=0+Am$CgBf6-ZQRpU8y8#yzy0Y&Nh{5+r_Gg1|qGo#tu5sLiKZ!>b=#Ne)C!im%HBOgweX5fP*F11Ix8h$s-rS{^=?@~t(cd3JT1eT8Ait!-4Vk*ZR z#Kpj2=eU#y55QgLGE{gPMvY3B8pnnSH=OTMWq1<0rn%G<*#RyM(*w8xzrB#F#3O%o zsg)%Af&%Wj$dz5)((vOME>%sP4E(g(rRIpkzhB`}^Kc!$K8qe3BgZy)pR@ADs|vovK`mqdXimj z;l8UG|Lk(h#-tjTnlC%Rc|^)}xQfUQCTzNnIYAu@zN0gKcp8@9=;Gs;*%w|(dT|{- zd9#bZNI{Rn&qywwfhWv&DGd)r5lIOf2HZ&kcp6@IE8~gl@Bvben=t1#8i#9e4XKcF z*jdY+gC}9|c9*KcLoi7qcnThShfCGqLD=~Z&aKN1$Y&&mXW&H(T&fO_z~_m9r{NU~ zU8)|}VKXst3!Z(aOC|6ybkn029)RDIE?mW!l%yNi7P-`a$ZkBni2L8am~Lbv2!FfR zrFvwCWpp)>U#+pAYdKviJHu`wuaZ+Rv%+@a69y;aHKPfST*V3a`Y;IZe89f%WAO9` z>AgG}3P(P|ar1cnA4G;fMtC3yN0{6m;&5LBU5RI4T_Zz)8?cRpa0{N;%n;xq`1^W> z0N2`S42j@L_`wFc9Z$p6mW%a;A%o9E|LIb-QVI5diXp%?`2N$JP^cEk9Jk;;$1`yB zmv)^HtnXp@l}5m~h#8f)!69W|*|R+aH<9e@{hAXI@g&UumWjhvYH-na%o|=A8}KjR zGu|9044)?1Uq*!SADDF1H{o{2Q}Dur_C-cuH1#8sj!J2G;AgrR=RNpp=I^u?kHE#m z#0~fzNl2YPxP4Tq03XTCS3S51YX;@346eg%M9I&B;W2~rRW2TcJw(GZa8_QvD#3O5E(zdicveBa zD#gRFhLlSk_@x%j=X*TttmUg^Mfs`%H=yRu&;ArsIFZ!Sh!CtHGCy>9aWQqMAAy&9 z@>P`_6b|)L4-W{5F6Hn~B^(D2!fsNBtLRX=ju>o2;H#t_Pr>hriHC>ft0t1bEf^Y3 zw@W!3HiE9k1Mo)Djhk@jNV*yi!ns5yX$&?WNsm!(LH|+tDtbsNAvs5r0wx#SH9B9p z@H8BJOuq6+Ih;&}<6-y@G72}~b7UNzg7mX0llpKDnT+eOgG|Ab@EcNzt1w-7av7D^>}8rh78;X<+%H{dq19Z$jYuFh9G@CdYS z%U65wB>eP_e6=6XK;Pngbx`WSElcQKelC!Nuij1X;wd;MdOuyth7L!spd0ZZELll6 z;sJO)nId(hY!x$~Psa_x1rIT~n3yqGPh?`IVgGuDkVQs=>(+9c$#}!54Yr42WeXR^ zXN5$=NQ}sj*@T;jOqL`(H$g>C9EJyo{IDSd?`^Z)fMeF%9)y;-dv7R=?2>)uyP~wLmB~3>9jor$5^%p;i65{=PC`@{Sc<0~(wLQv)ffVN#s2z9! zT4WcVgrR~0wFeJFZ()JjD|O(DL>iQV0jM`0TI(bx;}vFFvwB9l|5GI1^iiG zE)2dxq@n33;y%;f2*67nkHB?~Tku;VZ>!0`2mf54>TnajN(?*&^|K08JsyL;DKrER zz~iPCs01E_bBUZ-he!N{@wemwOAhB{w|lVIGuM zGO&}B;7NGYBTOzl2+v!~fO%&hRj)!L`i=Y8%n<6g0XROWcINKEqhz>RE2xtqcbqfGhq*J*fjf zewE?C)9}P@h69hlwM1516aEr)HiEAesLM(A{XFnq#|`)*k?zgF>No6p5P=6t_UFGl z3e@`~`wa(}db1$AVrJluT?HyBjes}5&#>Y#IC~%U@TiVl(Wg-DWT^eEa5<45R2XndF3znRhTjmmm<+seP+|6VjX~3K;mLyw z?azM;4KC!XRl8CIHaKp<{}4H78V<~}U4z>l&%k0=VYY_?@TQ_dWzpyue1S+KlJF-Y zy{O!Uyri=|mo&JOlqbrcjL&huX1)stganDHG^XJPa=?V;hgaAtx28 zN~r@Y$aFXBe;8Rws(HYKpO86t1|Bo9P|d@G&^)D3&BrZx#i@mADXznZ$!gq$uaUKQ z3Z8LVp=!p%@Gi0$H{iH43e{FT1aGR0GLhJbRWfPLFI2nmB+R>@Q0>7rIEl!d2*Fo~ zydNY5%fe1MT;jL^^$QEtUiKAUc#%C}BXHm)3=`!+IG1FX;V5$H46dHZ6@dnk87q8| zNTn3Kp^7o1js-s^^5fGqj9*GQ<88uIX4+$Kz->f+s+xxPS2IyLu>rp)y|}uZp&?OK z%!!ecuAp^z2yP%6o`m_c3RMXngcp#2)Q5{nDQ>`BB#5Wss7RqIm-=uC2}vFJIjNBH z*<38izRsA<{lDDV$iN|2+7ATa*^cY5g-B0WaG&EDIQnmPc@WNZT!$@=TX3J_88~8& z-MayJA<2IJe+21&6_bT7HQ<=Jb~gs$sH^Q;&VnU1+zDKP4n2Qo!NLRZM-su+wMWRJC{prminkF+2^^(HmG=WdrWg?UMy>EL0!e#9WXa;FOySRXrYt zcN6Ie1HMdTWlX`L^SMK)6M)x{1g^tph=r%%=dfZ!Hr_ z9L`%v3vnI(i-hHQ9rh3zzYH9Gr!xd_uH!mvaomD^7PAk>3Bs$EFd5~TaPtzzUwN2l zY#g(chTuW?(_KtJT-{x$ULqxU3jX;XCLkV$O{5gJVB<0-pg0_NA3cVL;J2g_=QX{0 zjZDYW@PqrAgyQ!{3)RglSa8^g!7s@?JOf9rWWm9M@Cvd3*WqM?#Rm_;{UqBHFu2Ng z;lqxb@I%Mb(D#7dTLE~9xV--}f~;{KNW!lj&%n|L?StxY`)YgLPQl!V>~am3k>%1L z*iKgCN%#jz;MyAI1hH@(y5r0PJOHDg@?VmT4BS}Hq`;H#p@*3hxCy5}!in(+9Qi17 z0uREcNRQNq{nj$BxCYA}W0Ao_u<&tSH}I)h0eB(F#UpUd6AZDJ_1{EJYG90cAOv3~ z0Xzl!HPHjO2Hzqnp;%LVTRP>s;iKj(VG(!-MeDcj!4h3_D0Io`m`D(pz`{j(?vXk~;9x59lF0@&WgM`G<57 z8zDIB7rF@7;SRDLPs7Q-vO3~n_!!xXTktSBh-<&GVjkv>;JY3f_@2^~2T#L?2Wx7S ze9INSl&7gOJO#C4O-&iX>;C|vhG}X#4`{I6uc*3a8wR2$YuRNr05=d>&n9`yS zenJl7Y1njzrd;f7!S9JIK71XmO3t+R4Zxd;l*i!vq=S6}f7Vprv+VK^ypzc5hG-1= zh-{V1r9YU~$$bl^QIccVjHdRxL$ZFhx-;r!1{-UWXNcIBYULwyI893o=jxS%L z!&OAeO?c>REvhQH8ou~f#}j!V1lJNNH{n(1XxYyI*5PsI+8%^=5qW2;0dG4`%YOcI z48B3+)l>@lD>(^YoCM&tM9Oveg_QFqB;Nn8sj25{YCBgGhU*-+;65VvXayNb=0_M_=eQ2z@FOyh1Et~4o9yvU!K-d%_EN6H1j+tn6!titfu*-ekH8@dHI>8z@MhAD$KabJnqni3RNl#$$qsNjy^F{qJLW=Ev>^9JSn;fUsx{b=WrmFCx`=1U^OP z3}yXKA{~#@?L3f#jSbv3xCKv0u%6=~7}&tVga={fS@yxzb2N->l{&DNY{z5p6|w_Q z!NRTF(zph%Byz{;@Z%`|<#11@;mqgl@s7ZSM7k~ppLu~Ufq|Epn6%p5uBq{_GYohT zK0xFICcI|{3m4@EbiL_xJDf>IabXd7-CL{^xDL0I$#@Eeb~64`*a+{`)D5H(kHO7k zI-Z16QjD3@ftS6_nBhA7hRnm&JFNc&MQQdsR{P>UH=Mkzq=~in&Gh5({?| zc{6Jo=F}9aDZE=&gEfCIQj>8V-afBLl||WzA$y2Cxz_%as&3io`cHUXyMO9 z{>p*6p-5d!WSxk>9&$*o23G3!al&x=twm}M$B76R*sjCV78a>dl!st6&VTaB^(LHl zXHoWjyyX{6q;7g9Hdy3T5JYPwH{?c9D93G>>5YHG1hM;sWp;HocK8*mf;P7dK(Pmy|*a%>RnXjtAiCDF1obFroXu z+t=^GO*VgXI|(6Dfze-!ai}4SxSU7lErEiqzGl3fJL(NDZEb zlYT5xwRkjwO!|o~Vj~3aJH&*-O?c~JCJ`Qk!~USV@BloMbl_olhH|UT;&2t&ikt8! zvK?1_-0BCiL%gqBy+n55DR_E6cU0|RBizre-X(kSG(0cIt@h&)xQ!f?9pJ?NZgmI` z!LbEym2(6RYYW}Vg~wpN=2jj&052lL@d!NcXtx?A4ws(cR%N(xM%1lt{fk>oVIv0n zo$XeYxCVbC)5R;?>WOpQsv5W8JAZYnId~d=J(H8;>N2jL)Zs~(d%0T~xCTo}JsyN_ z&T=agPs78r>A5Hykt^N&B@4O^*Wq7ppzEX@&Yn-#NjcPRajQLe01m&E-ok@$`EB$T zZo;eYptqzxELccyNqx9~5xo_lp^M#W0`cG>82yR=hRXv>+{#-=7vTXo_W`#WhwJdb zV{SEB>OAgNgP)*>a1A~{rsF0YZ_-0}2>!f|9+LVkZuM!aTg}5W@UC{ZnvWasw+(K! zARs^g-RM^9H!&tWV8Ml3xFV?p|JLQ^SEy(N9PzAMt;K_IDQT8E@M+S4C*f|g8BfEH zGxR8)f#-ckkKz&d6WM{Q?>WZzQD!3>78^?r(!IC=_x(th;TgE&C%O?&!>vCv(f-6_ zgsXb#IoyP^exbK;9nSuh-V%q$|3+`&A@~@n#x3|0nTPZK8@D=(%x5DEZ#Yc1;4%0+ zS&D1FyH)=_#cH`YJilMDT8&5GZ~co^GaepLtag(QJPqF;SgbaS!}D{CRkzfKX_CS- zFn@3{zyHNX0LjbaK|BWkOM0XdtaTNujFdx@^x_sw5yf+PT9{v~a&Zj?iH3(@gp}Yq zG)Mq9;b){2&*T?J)sqG6#6}YStFYL9IR*P`#r7|s!t)#t!^cTl4g}8`Qml61Vff1k z+ttWo6+VK7@;8NrX25n~{^;WDU)a)MC0X4Qr4rIWge!s$4z+NIC_RRwua$vQU1#wXne7{kcda% z3daq&!Ep;7Il-}dqloHlZL*Ni?c7?0`L;YBXEu5=E+fZ za5mD=SMKZpZ<)kQ=H+$_t~ixR#Opx=o-&!cLtY!g&;QIVC%pyFxu96>qC5<9!|W?R z^M%(C7mc&vY16r*s2_sWRmG}4D&vP3M6ObJ)8)l#E9Eh`Zx;8xoB-y`W+z;OzY&>4 z>dIpE;aqw~>cELtJKYYiBhnK(e9UnZrW_YW`_$N1tidxK55q-{8}KjJu$b`uyD~aGhr`zR0_%V_CX?Wv}c6kiGOXR2JX*lU7#$UdK z4&79&?k3qGfEV0sy9s~2jm3hK@dG?{E0Ov!_&AYlkkohb@=XA44%Bm_7MDo$eRn) zVpdNgo`Nfv*lxhHm)iBi(0!L(9)Q+8jQ_3g|`+7CpeNg$H2qYSsX8cqJKy>u}9u#cCXG!ugN0sNpgA3z;H+ z|4Ti=qCzTpAOvqUX^>QcKQu8MxN2r0BJ=Pde4EV2)9|SlCa~0LWqBqt!-H@xk*^zd z*y6YawiNDXYAnC%R>VsnSDM_-Cfm=UeX5uMW`57m`Bk;o>##QRT z>%V6O#A9&D54=9W4VXH}5aMar?-$nhQJf4;Jj7~n~gABMpC!|KOnoM z5m6nuq9c?y=DNcqvsaA*+^o`heL;dlm)F0)S-gx8Q! zQXe*uakvFbPGbDa*a)0Nmy^l30TX13RD#{45>H9lM30(|hhdad<1zSeB0uX(!<8p{ z)Evr9`1KhcH4o=^c-8G>zSM_BXL{5EJP<`*CrjB#LGPcLkn#Y$;4F_?jYr^mvKF`C z@l!mi84tnysUFoK^?QgwvVKcoGJyxd^EbXU}F>aUD*&ii_AQ4Tdx zBkQ~d$CK=u4__nlESiGXtg>B)mp{P8$h)S64>FY8DG|6aTF-dXq9i=TneK7V=y~!Bk8Z^i#+=S837-QUkx!-at zOC6YhfMLZ0@a$fO6%WHEQiWUahhD~Cx=#J#Q8Rw!WM8s4z;B6kbq1dPo9!XE%5f7G zA7TjP>jJo($dDOu50P6j@ViH?Ao3TI4Y=|Tj?b$j1HPfWs)lm2Pt>da)YqHcIS5-F zx8NT{UhAoTUgalp0v&F5JO#(*c(W%9!uuRI;0HvWveR&6e{c5Ha{w+O+1Hrx2NI6* z`c4h-s>vk#({K0!k(b*^IDDX89)OF8T$usgx!&w&0R`Y1l6|8Ae2+-arJ-+-?E!c` zk=GevxX39tVDzNHUi)P={ESE=GH`XC?S{+ChZ1l#bXNvWDDc{|9bWCY4qqYJD~59m zo!){!InJAX)H0GCCU|9$SB5*v+pE2*jmXXx{L1kRJi%?3$KWQCeKibc`n>$&5i=i- zEb-bO-3U(|>Q!}=hhSuw?ZTMfcHtSrX$12i1iv57_)FKR5ngr7NPBF8@HLXXkKr{( z*lxnr0dMx+HR0+%*{&VwRqIHC6I<}Kqc}O9gny9i92({21&!@t_@Luv6zOp`GVsKs z?Mfk7=ePlTk6})5P~Hxub{y+fTk$kpF_sC5n{e7V9>aC`8QFyg$8-FkSM9;I?E%$$3w7XB9jrfps$?XzysypsCt%-FdIo&d5Tw6;So4=65S}3;47pCPr>cBN5C3WB>XEA(u1U^90QV!oE*#!-{rr39Z2FFI7jUYVF@i3g{ zxDJ;)Zo++}Y&;E}>QyHbnOtFbBavGx1{YPjVxri1$|9kHATwd;B^cw z9)L%*c-3?~2p?-<{HtXLHg=IYcpB!k(gU~#uOjnt9llH!;3@b@%UA5xFau}5DvJ~+ zgZGnNcs=|V**k8i+77=UHRJgHe=jn-n~8JcP&EfWMyl}y{M7OJuW`Q;*?BemnXt3c zUiYfwNSYG_q4oxKaN&Dz((U+excMy_jSDMx+Q%0z*va_IL6@@e6_JDPha*z98*q=~ z!i(SLDvzh3u$APDrJ-=eJFI}X0lVI1UtIVj*;O`F^}^cSEJRWV{`e7V4Bi_>mZoW; zJOEdI!6G9LFWJu`gIB>vi8O94Z25)-hw=p6M&trgaOAgMrSJfppW!yf4fyQ$%qKhv zr~b~fB_4r!e=z<*He5&tsm6u3D_{0=e3!xvL{4DASBNws4fQ?*kHM4s`qX^999~D{ z#fuJo{d}sH@)GzKk)BJ#vvYj>J|Kvb_S+MCOff=pfsN!&}LI_N|3a5UIZzewlUF{|xffV4pg~16^=bo=>@0 zVud@1>>$jLag+fp#BzU*C43TwnE*Wm%DJg3B`P9t)aA$Tv5#w~}J5A|iA3!34B!+dHF z`>uvR4fm;u+*k_czZw|bM)KF(0Jo;#RC`;jGqnS69SHqlR7=MEeL{$*EGT}~=mJ`7H zOMR*fH{f?f=7ejEPu)ijQobAxIM()Dc(3Ejp*EI=23Zf_g(Q0c@b8Y#8yoehC&$?* z-V8q=QfWV2Jl=K#e(3lfIC+BIIN>cs8g0O%gUp-bhN@CHjYuzs;W5XvkCekfC-~GH z+yxJx!d(z$LrwCjPfz8x!S}-VCey`u8cscpG2@CW;9Mfl{WY+O$O)R^hlIDvsXeg$ zbS5hMcEGI_j6LPTzUSB%lLId%<0!9!(f#}pWIdJSPl;h)~$mO@%V;q65+qi-gSTta6t-WXnZz01euZ3TcQoQlhP_6YPh#F0yZ}TDYFb$vWVv zi`;l78L$Hd(@Cckumf||Rk<{U8Dfj=HyPVtUZlBsjmh-@7=)1>m zPzekXIkE70GMR=Z;j}t?-!MFW8A~zcW$;_l!ErLM?0&i(7k;*qJB2!X;T47)hxI># ze30GX7J`?pvQJPAH$K4pV22d+toEttxbPDqy_JTY4>7ZG3*NSdp1@=9{5TUE55s}= z+#z@nhKMC~;IC2slLH-sS3b+jXMV$P;8T2QuLoj`zT`pRg-c!11O}RdS#pe2K^% zu^oCF8E?u1@OC0!kSu@$nz>@ibK!6z3zzT)B6CHD|6IrT%Yinp^Qq@r>?_*}&uq0T zO@W<`?|}6QyIi=N$W;o@YiGgXWR>t`vK8M0_jRzY;5~5q2JR4CIBk<%9^SdIkKVwqiVL0S- zZacgLPWpmlN;#|{(>adNa9kK|b2fx8IWGK< zJ&p@qUuKWP`i~rCZ)AD8Y055Ki!P(Sf0p`t;8*0n|eS{DBeS4OJT=8)`P_8)`SiHq>oU{2RiD zv-9KBM14G(=RYn!t;jz*o-Fa78-Jm{KetbL{Musw5%G`v`iHF<;CIJU#r_F#cfNnZ zvFsWgqWHEipO>3xv)a1al5O2>Dl|lmqb$%-+7aw1?+A5Nbi`Nm@t5#Th#`FLINyA4 zHk#|3&E`b2)!fybY>xkzmc@g4{v+cP2Ku#l!tJk$pIhWVR$4JS-q_ziJbq=dzx01? zaK)`+e|3InW5ves#;T2xjWrwf_!;^BF=eHl!Orr|P-jJFxU;G=(pl4~cg8yFI*rcy zPO~%7X?1pW?(R%?_H<@Cdpr5jo|@Ay{%fKCgo3o$V`j`=lTTl1&>G@aE~ks+_`~t^ zQ2(g-v_XDfe8*t_CGlSe_&ss=K>xUbJ*}D6-c}XgD?nMMBNMHX{>kxqZhu95S_#d2 zpu}IBoksDkef_R%zZ{)v&$Rcp^P!;~|L+tDcT{ymI%+!fj=Bz`qdvZ~*zfP3ovHCZ zT>cB=uhX^>$Tp>6#0k57w5=q8_J-6 zo6jg1ZomG2Lp&`0=VIo7)t^WIcTw8luJ&YmcYCURcl$%8e?dH)?;p%x`52;7G%h|& zV}3KTp1ySr@sVzhcW+*jnGUKDoYoeQJF?#JTvaVr30chU_*o$A3b+a*)47 zy0#>KXNiB9N8ebxF}AU8qp^`1$szpBcPeU{|Aha|o*XUGP}86{)HeL@`r|9y{?p^S z4Ep2!`R{*?9uR-4um4!?=>fiMmv@*Qi4Loyt0URb-I40p-4P!t^WlYltOQI2EmX=W zvpsE=m;p0rmYX57!VH`CEGuaXw3W8;XEw4cLVfmVB^v^=!eoZ9{Ls!?uYZDEpyDSu zvOU-9k2CwV`0rl-_2m^!RZTTbwM}(R^-YPUuBPs$-Az4By-m5zCC#PH<;@k%Rn0Zc zwas-b9tjqX?&jUiJomt_}~)%2`9%Gdy{cbGUn-qOoM9F zn6<&iP-D0;(x^Aa7<-d(Pd26+(~X%%)uc5Anu76beSSW@oRy7t4M-ce_VZU}?}Yv# z-dUq$wW#=CUwh&;xqjD4Dv_Je5+w<$hfDatJ3bq49silU3Yej2KYh7!iH7#q9oIifyK)*MdNLY!kL^9ExNF`(mkf8~-mA3_0^phKU zHk7bt>Ko0CJsV3{Bz2a>BugQ`(yA8FtN?=RncEO-h|q({hSJ6=?h~tVcVli- zuqo1HFf!>TtvSTP9bQ+rF1d~iYc*QS6On`w<+O^^={z5#+Dg`k*6Zs{CU@`p()Mt> z!5yM_PDpoXG)CVTVr`bQ4&#r(&~>KP5Mtt*3|MbNkRhsPXmXn>m=YFKL2FJmD^@;z zU7#h^lG|F|s<&EPdzem3bCIsymN9h62HN{dbpwnf?u+SAh(SYJUONK?An)9ocRrJnn%r=w&;1<%3t z8@g#ykSDP^n$^3pl;h5%F8aE7EjJ0vM?l2EhW ze0n{1MQ?L(T@@o^(ZXO$q@}LKYT3;gm9|zfPTj2 JtA%lW{y%^1$p-)c From bea1601994da22504c669f099cdc17367c45ac77 Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Mon, 4 May 2015 15:23:56 -0400 Subject: [PATCH 106/113] jme3-android-examples: add project for android examples --- build.gradle | 15 ++++++- common-android-app.gradle | 13 ++++++ jme3-android-examples/build.gradle | 40 +++++++++++++++++++ .../src/main/AndroidManifest.xml | 20 ++++++++++ .../jme3test/android/TestChooserAndroid.java | 12 ++++++ .../src/main/res/values/strings.xml | 6 +++ local.properties | 1 + settings.gradle | 1 + 8 files changed, 107 insertions(+), 1 deletion(-) create mode 100644 common-android-app.gradle create mode 100644 jme3-android-examples/build.gradle create mode 100644 jme3-android-examples/src/main/AndroidManifest.xml create mode 100644 jme3-android-examples/src/main/java/jme3test/android/TestChooserAndroid.java create mode 100644 jme3-android-examples/src/main/res/values/strings.xml create mode 100644 local.properties diff --git a/build.gradle b/build.gradle index 62d4ac841..d9f5cd2ea 100644 --- a/build.gradle +++ b/build.gradle @@ -1,10 +1,23 @@ import org.gradle.api.artifacts.* +buildscript { + repositories { + mavenCentral() + } + dependencies { + classpath 'com.android.tools.build:gradle:1.1.0' + } +} + apply plugin: 'base' // This is applied to all sub projects subprojects { - apply from: rootProject.file('common.gradle') + if(!project.name.equals('jme3-android-examples')) { + apply from: rootProject.file('common.gradle') + } else { + apply from: rootProject.file('common-android-app.gradle') + } } task run(dependsOn: ':jme3-examples:run') { diff --git a/common-android-app.gradle b/common-android-app.gradle new file mode 100644 index 000000000..0ec48fbd7 --- /dev/null +++ b/common-android-app.gradle @@ -0,0 +1,13 @@ +apply plugin: 'com.android.application' + +group = 'com.jme3' +version = jmeVersion + '-' + jmeVersionTag + +sourceCompatibility = '1.6' + +repositories { + mavenCentral() + maven { + url "http://nifty-gui.sourceforge.net/nifty-maven-repo" + } +} \ No newline at end of file diff --git a/jme3-android-examples/build.gradle b/jme3-android-examples/build.gradle new file mode 100644 index 000000000..68b4539a0 --- /dev/null +++ b/jme3-android-examples/build.gradle @@ -0,0 +1,40 @@ +dependencies { + compile project(':jme3-core') + compile project(':jme3-android') + compile project(':jme3-effects') + compile project(':jme3-bullet') + compile project(':jme3-bullet-native') + compile project(':jme3-networking') + compile project(':jme3-niftygui') + compile project(':jme3-plugins') + compile project(':jme3-terrain') + compile project(':jme3-testdata') +} + +android { + compileSdkVersion 10 + buildToolsVersion "22.0.1" + + lintOptions { + // Fix nifty gui referencing "java.awt" package. + disable 'InvalidPackage' + } + + defaultConfig { + applicationId "com.jme3.android" + minSdkVersion 10 // Android 2.3 GINGERBREAD + targetSdkVersion 22 // Android 5.1 LOLLIPOP + versionCode 1 + versionName "1.0" // TODO: from settings.gradle + } + + buildTypes { + release { + minifyEnabled false + } + debug { + applicationIdSuffix ".debug" + debuggable true + } + } +} \ No newline at end of file diff --git a/jme3-android-examples/src/main/AndroidManifest.xml b/jme3-android-examples/src/main/AndroidManifest.xml new file mode 100644 index 000000000..ee80b6b28 --- /dev/null +++ b/jme3-android-examples/src/main/AndroidManifest.xml @@ -0,0 +1,20 @@ + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/jme3-android-examples/src/main/java/jme3test/android/TestChooserAndroid.java b/jme3-android-examples/src/main/java/jme3test/android/TestChooserAndroid.java new file mode 100644 index 000000000..e704bc85a --- /dev/null +++ b/jme3-android-examples/src/main/java/jme3test/android/TestChooserAndroid.java @@ -0,0 +1,12 @@ +package jme3test.android; + +import android.content.pm.ActivityInfo; +import android.app.*; +import android.os.Bundle; + +public class TestChooserAndroid extends Activity { + @Override + public void onCreate(Bundle savedInstanceState) { + super.onCreate(savedInstanceState); + } +} \ No newline at end of file diff --git a/jme3-android-examples/src/main/res/values/strings.xml b/jme3-android-examples/src/main/res/values/strings.xml new file mode 100644 index 000000000..b184fa936 --- /dev/null +++ b/jme3-android-examples/src/main/res/values/strings.xml @@ -0,0 +1,6 @@ + + + JMEAndroidTest + About + Quit + \ No newline at end of file diff --git a/local.properties b/local.properties new file mode 100644 index 000000000..27e823fff --- /dev/null +++ b/local.properties @@ -0,0 +1 @@ +sdk.dir=C:\\AndroidSDK \ No newline at end of file diff --git a/settings.gradle b/settings.gradle index 346532460..80d932d64 100644 --- a/settings.gradle +++ b/settings.gradle @@ -34,6 +34,7 @@ include 'jme3-testdata' // Example projects include 'jme3-examples' +include 'jme3-android-examples' if(buildSdkProject == "true"){ include 'sdk' From 58aed8be237f52fcef502e02d0cdbc3281a6027b Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Mon, 4 May 2015 21:49:31 -0400 Subject: [PATCH 107/113] Gradle: dont build android examples by default --- gradle.properties | 1 + settings.gradle | 5 ++++- 2 files changed, 5 insertions(+), 1 deletion(-) diff --git a/gradle.properties b/gradle.properties index ccc3ed460..a00139bdf 100644 --- a/gradle.properties +++ b/gradle.properties @@ -11,6 +11,7 @@ buildJavaDoc = true # specify if SDK and Native libraries get built buildSdkProject = true buildNativeProjects = false +buildAndroidExamples = false # Path to android NDK for building native libraries #ndkPath=/Users/normenhansen/Documents/Code-Import/android-ndk-r7 diff --git a/settings.gradle b/settings.gradle index 80d932d64..89b8fc075 100644 --- a/settings.gradle +++ b/settings.gradle @@ -34,7 +34,10 @@ include 'jme3-testdata' // Example projects include 'jme3-examples' -include 'jme3-android-examples' + +if(buildAndroidExamples == "true"){ + include 'jme3-android-examples' +} if(buildSdkProject == "true"){ include 'sdk' From fe057130a4d432f0e153fac3b7d28e42c07dda69 Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Tue, 5 May 2015 16:00:43 -0400 Subject: [PATCH 108/113] jme3-android-examples: fix incorrect dependency .gitignore: add jme3-android-examples/build folder --- .gitignore | 1 + jme3-android-examples/build.gradle | 2 +- 2 files changed, 2 insertions(+), 1 deletion(-) diff --git a/.gitignore b/.gitignore index 09d505187..6b6f30e2d 100644 --- a/.gitignore +++ b/.gitignore @@ -10,6 +10,7 @@ /jme3-desktop/build/ /jme3-android-native/build/ /jme3-android/build/ +/jme3-android-examples/build/ /jme3-blender/build/ /jme3-effects/build/ /jme3-bullet/build/ diff --git a/jme3-android-examples/build.gradle b/jme3-android-examples/build.gradle index 68b4539a0..f1ee38739 100644 --- a/jme3-android-examples/build.gradle +++ b/jme3-android-examples/build.gradle @@ -3,7 +3,7 @@ dependencies { compile project(':jme3-android') compile project(':jme3-effects') compile project(':jme3-bullet') - compile project(':jme3-bullet-native') + compile project(':jme3-bullet-native-android') compile project(':jme3-networking') compile project(':jme3-niftygui') compile project(':jme3-plugins') From 554cfb8fabf2a5215c63c657875ffb0ce5b7f7b5 Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Thu, 7 May 2015 11:10:32 -0400 Subject: [PATCH 109/113] GLRenderer: remove GL_APPLE_limited_npot That extension doesn't indicate NPOT support, just limited support same as on the level OpenGL ES 2.0. --- jme3-core/src/main/java/com/jme3/renderer/opengl/GLRenderer.java | 1 - 1 file changed, 1 deletion(-) diff --git a/jme3-core/src/main/java/com/jme3/renderer/opengl/GLRenderer.java b/jme3-core/src/main/java/com/jme3/renderer/opengl/GLRenderer.java index 5e3eeca90..776016a2a 100644 --- a/jme3-core/src/main/java/com/jme3/renderer/opengl/GLRenderer.java +++ b/jme3-core/src/main/java/com/jme3/renderer/opengl/GLRenderer.java @@ -366,7 +366,6 @@ public class GLRenderer implements Renderer { if (hasExtension("GL_ARB_texture_non_power_of_two") || hasExtension("GL_OES_texture_npot") || - hasExtension("GL_APPLE_texture_2D_limited_npot") || caps.contains(Caps.OpenGL30)) { caps.add(Caps.NonPowerOfTwoTextures); } else { From 64ba4794e41e012682d423d0e2580bf9b7088fb5 Mon Sep 17 00:00:00 2001 From: jmekaelthas Date: Thu, 7 May 2015 17:47:36 +0200 Subject: [PATCH 110/113] Bugfix: fixed a bug that occured for some users during logging out the name of unknown data block. --- .../plugins/blender/file/FileBlockHeader.java | 25 ++++++++++++++++--- 1 file changed, 22 insertions(+), 3 deletions(-) diff --git a/jme3-blender/src/main/java/com/jme3/scene/plugins/blender/file/FileBlockHeader.java b/jme3-blender/src/main/java/com/jme3/scene/plugins/blender/file/FileBlockHeader.java index 666da7896..6a5222a9c 100644 --- a/jme3-blender/src/main/java/com/jme3/scene/plugins/blender/file/FileBlockHeader.java +++ b/jme3-blender/src/main/java/com/jme3/scene/plugins/blender/file/FileBlockHeader.java @@ -31,6 +31,7 @@ */ package com.jme3.scene.plugins.blender.file; +import java.util.logging.Level; import java.util.logging.Logger; import com.jme3.scene.plugins.blender.BlenderContext; @@ -171,8 +172,21 @@ public class FileBlockHeader { BLOCK_IP00('I' << 24 | 'P' << 16), // ipo BLOCK_AC00('A' << 24 | 'C' << 16), // action BLOCK_IM00('I' << 24 | 'M' << 16), // image - BLOCK_TE00('T' << 24 | 'E' << 16), BLOCK_WM00('W' << 24 | 'M' << 16), BLOCK_SR00('S' << 24 | 'R' << 16), BLOCK_SN00('S' << 24 | 'N' << 16), BLOCK_BR00('B' << 24 | 'R' << 16), BLOCK_LS00('L' << 24 | 'S' << 16), BLOCK_GLOB('G' << 24 | 'L' << 16 | 'O' << 8 | 'B'), BLOCK_REND('R' << 24 | 'E' << 16 | 'N' << 8 | 'D'), BLOCK_DATA('D' << 24 | 'A' << 16 | 'T' << 8 | 'A'), BLOCK_DNA1('D' << 24 | 'N' << 16 | 'A' << 8 | '1'), BLOCK_ENDB('E' << 24 | 'N' << 16 | 'D' << 8 | 'B'), BLOCK_TEST('T' << 24 | 'E' << 16 - | 'S' << 8 | 'T'), BLOCK_UNKN(0); + BLOCK_TE00('T' << 24 | 'E' << 16), + BLOCK_WM00('W' << 24 | 'M' << 16), + BLOCK_SR00('S' << 24 | 'R' << 16), + BLOCK_SN00('S' << 24 | 'N' << 16), + BLOCK_BR00('B' << 24 | 'R' << 16), + BLOCK_LS00('L' << 24 | 'S' << 16), + BLOCK_GR00('G' << 24 | 'R' << 16), + BLOCK_AR00('A' << 24 | 'R' << 16), + BLOCK_GLOB('G' << 24 | 'L' << 16 | 'O' << 8 | 'B'), + BLOCK_REND('R' << 24 | 'E' << 16 | 'N' << 8 | 'D'), + BLOCK_DATA('D' << 24 | 'A' << 16 | 'T' << 8 | 'A'), + BLOCK_DNA1('D' << 24 | 'N' << 16 | 'A' << 8 | '1'), + BLOCK_ENDB('E' << 24 | 'N' << 16 | 'D' << 8 | 'B'), + BLOCK_TEST('T' << 24 | 'E' << 16 | 'S' << 8 | 'T'), + BLOCK_UNKN(0); private int code; @@ -187,7 +201,12 @@ public class FileBlockHeader { } } byte[] codeBytes = new byte[] { (byte) (code >> 24 & 0xFF), (byte) (code >> 16 & 0xFF), (byte) (code >> 8 & 0xFF), (byte) (code & 0xFF) }; - LOGGER.warning("Unknown block header: " + new String(codeBytes)); + for (int i = 0; i < codeBytes.length; ++i) { + if (codeBytes[i] == 0) { + codeBytes[i] = '0'; + } + } + LOGGER.log(Level.WARNING, "Unknown block header: {0}", new String(codeBytes)); return BLOCK_UNKN; } } From 3f3ef99b8693cfab8ebc2e74c766ddb504ca4a16 Mon Sep 17 00:00:00 2001 From: Nehon Date: Fri, 8 May 2015 11:18:27 +0200 Subject: [PATCH 111/113] Fixed an issue where AA was not taken into account when using SSAO filter --- jme3-core/src/main/java/com/jme3/post/Filter.java | 5 +++-- .../src/main/java/com/jme3/post/FilterPostProcessor.java | 4 ++-- 2 files changed, 5 insertions(+), 4 deletions(-) diff --git a/jme3-core/src/main/java/com/jme3/post/Filter.java b/jme3-core/src/main/java/com/jme3/post/Filter.java index a6e2e3c01..a3c136e55 100644 --- a/jme3-core/src/main/java/com/jme3/post/Filter.java +++ b/jme3-core/src/main/java/com/jme3/post/Filter.java @@ -233,11 +233,12 @@ public abstract class Filter implements Savable { * @param vp the viewport * @param w the width * @param h the height + * @param numSamples the number of samples for anti aliasing */ - protected final void init(AssetManager manager, RenderManager renderManager, ViewPort vp, int w, int h) { + protected final void init(AssetManager manager, RenderManager renderManager, ViewPort vp, int w, int h, int numSamples) { // cleanup(renderManager.getRenderer()); defaultPass = new Pass(); - defaultPass.init(renderManager.getRenderer(), w, h, getDefaultPassTextureFormat(), getDefaultPassDepthFormat()); + defaultPass.init(renderManager.getRenderer(), w, h, getDefaultPassTextureFormat(), getDefaultPassDepthFormat(), numSamples); initFilter(manager, renderManager, vp, w, h); } diff --git a/jme3-core/src/main/java/com/jme3/post/FilterPostProcessor.java b/jme3-core/src/main/java/com/jme3/post/FilterPostProcessor.java index 2cd8b83f8..462f03314 100644 --- a/jme3-core/src/main/java/com/jme3/post/FilterPostProcessor.java +++ b/jme3-core/src/main/java/com/jme3/post/FilterPostProcessor.java @@ -170,10 +170,10 @@ public class FilterPostProcessor implements SceneProcessor, Savable { renderFrameBuffer.setDepthTexture(depthTexture); } computeDepth = true; - filter.init(assetManager, renderManager, vp, width, height); + filter.init(assetManager, renderManager, vp, width, height, numSamples); filter.setDepthTexture(depthTexture); } else { - filter.init(assetManager, renderManager, vp, width, height); + filter.init(assetManager, renderManager, vp, width, height, numSamples); } } From ec7432c90c17c0a9abf406a29cb1fe32ab3c6068 Mon Sep 17 00:00:00 2001 From: Nehon Date: Fri, 8 May 2015 15:07:43 +0200 Subject: [PATCH 112/113] Added a graddle.properties to je jme-examples project with an override of buildJavaDoc to false, to not generate the javadoc when building from jme-examples Also added a parameter to enable assertion as executable classes are only in this project anyway. Removed the global assertion setting as it's only needed in jme-examples. --- build.gradle | 16 ++++++++-------- jme3-examples/build.gradle | 5 ++++- jme3-examples/gradle.properties | 5 +++++ 3 files changed, 17 insertions(+), 9 deletions(-) create mode 100644 jme3-examples/gradle.properties diff --git a/build.gradle b/build.gradle index d9f5cd2ea..8e6790230 100644 --- a/build.gradle +++ b/build.gradle @@ -175,11 +175,11 @@ ext { // } //} -allprojects { - tasks.withType(JavaExec) { - enableAssertions = true // false by default - } - tasks.withType(Test) { - enableAssertions = true // true by default - } -} \ No newline at end of file +//allprojects { +// tasks.withType(JavaExec) { +// enableAssertions = true // false by default +// } +// tasks.withType(Test) { +// enableAssertions = true // true by default +// } +//} \ No newline at end of file diff --git a/jme3-examples/build.gradle b/jme3-examples/build.gradle index 186a6bc2d..de1c3931c 100644 --- a/jme3-examples/build.gradle +++ b/jme3-examples/build.gradle @@ -6,7 +6,10 @@ if (!hasProperty('mainClass')) { task run(dependsOn: 'build', type:JavaExec) { main = mainClass - classpath = sourceSets.main.runtimeClasspath + classpath = sourceSets.main.runtimeClasspath + if( assertions == "true" ){ + enableAssertions = true; + } } dependencies { diff --git a/jme3-examples/gradle.properties b/jme3-examples/gradle.properties new file mode 100644 index 000000000..6f0993120 --- /dev/null +++ b/jme3-examples/gradle.properties @@ -0,0 +1,5 @@ +# When running this project we don't need javadoc to be built. +buildJavaDoc = false + +# We want assertions, because this is the test project. +assertions = true From 31fc1d9ac691f219691df19763a56388990ee130 Mon Sep 17 00:00:00 2001 From: Kirill Vainer Date: Fri, 8 May 2015 11:09:20 -0400 Subject: [PATCH 113/113] GLRenderer: fix srgb warning logging Only complain about missing sRGB support if the user wants to enable it, not disable it. --- .../src/main/java/com/jme3/renderer/opengl/GLRenderer.java | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/jme3-core/src/main/java/com/jme3/renderer/opengl/GLRenderer.java b/jme3-core/src/main/java/com/jme3/renderer/opengl/GLRenderer.java index 776016a2a..66f4d66d3 100644 --- a/jme3-core/src/main/java/com/jme3/renderer/opengl/GLRenderer.java +++ b/jme3-core/src/main/java/com/jme3/renderer/opengl/GLRenderer.java @@ -2670,7 +2670,7 @@ public class GLRenderer implements Renderer { public void setMainFrameBufferSrgb(boolean enableSrgb) { // Gamma correction - if (!caps.contains(Caps.Srgb)) { + if (!caps.contains(Caps.Srgb) && enableSrgb) { // Not supported, sorry. logger.warning("sRGB framebuffer is not supported " + "by video hardware, but was requested.");

    L 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

    • ad45fW!rE6;Ix&03(DNd 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