Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -49,6 +49,7 @@
*
* @author normenhansen
*/
@Deprecated
Comment on lines 51 to +52
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

When using the @deprecated annotation, it is best practice to also include the @deprecated Javadoc tag. This allows you to explain the reason for deprecation and suggest a migration path (e.g., switching to the jme3-bullet module). This is recommended by common Java style guides such as the Google Java Style Guide.

 * @deprecated use the jme3-bullet module instead.
 */
@Deprecated
References
  1. A class or member that is deprecated is annotated with the @deprecated annotation and its Javadoc must include the @deprecated tag. (link)
  2. When identifying missing or incorrect Javadoc, provide a code suggestion to fix it directly.

public class BulletAppState
extends AbstractAppState
implements PhysicsTickListener {
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -101,6 +101,7 @@
* <p>PhysicsSpace - The central jbullet-jme physics space</p>
* @author normenhansen
*/
@Deprecated
public class PhysicsSpace {

/**
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -38,6 +38,7 @@
*
* @author normenhansen
*/
@Deprecated
public interface PhysicsTickListener {

/**
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -58,6 +58,7 @@
*
* Based on KinematicRagdollControl by Normen Hansen and Rémy Bouquet (Nehon).
*/
@Deprecated
public class BoneLink extends PhysicsLink {
// *************************************************************************
// constants and loggers
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -72,6 +72,7 @@
*
* Based on KinematicRagdollControl by Normen Hansen and Rémy Bouquet (Nehon).
*/
@Deprecated
public class DacLinks
extends DacConfiguration
implements PhysicsTickListener {
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -70,6 +70,7 @@
*
* Based on KinematicRagdollControl by Normen Hansen and Rémy Bouquet (Nehon).
*/
@Deprecated
public class DynamicAnimControl
extends DacLinks
implements PhysicsCollisionListener {
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -38,6 +38,7 @@
*
* @author Stephen Gold sgold@sonic.net
*/
@Deprecated
public enum KinematicSubmode {
/**
* driven by animation (if any)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -68,6 +68,7 @@
*
* Based on KinematicRagdollControl by Normen Hansen and Rémy Bouquet (Nehon).
*/
@Deprecated
public class RagUtils {
// *************************************************************************
// constants and loggers
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -42,6 +42,7 @@
*
* @author Nehon
*/
@Deprecated
public interface RagdollCollisionListener {

/**
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -54,6 +54,7 @@
*
* Based on RagdollPreset by Rémy Bouquet (Nehon).
*/
@Deprecated
public class RangeOfMotion implements Savable {
// *************************************************************************
// constants and loggers
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -56,6 +56,7 @@
*
* Based on KinematicRagdollControl by Normen Hansen and Rémy Bouquet (Nehon).
*/
@Deprecated
public class TorsoLink extends PhysicsLink {
// *************************************************************************
// constants and loggers
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -46,6 +46,7 @@
*
* @author Stephen Gold sgold@sonic.net
*/
@Deprecated
public class VectorSet {
// *************************************************************************
// constants and loggers
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -43,6 +43,7 @@
* Get/reference all data you need in the collide method.
* @author normenhansen
*/
@Deprecated
public class PhysicsCollisionEvent extends EventObject {

public static final int TYPE_ADDED = 0;
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -38,6 +38,7 @@
*
* @author normenhansen
*/
@Deprecated
public class PhysicsCollisionEventFactory {

private ConcurrentLinkedQueue<PhysicsCollisionEvent> eventBuffer = new ConcurrentLinkedQueue<>();
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -39,6 +39,7 @@
*
* @author normenhansen
*/
@Deprecated
public interface PhysicsCollisionGroupListener {

/**
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -39,6 +39,7 @@
*
* @author normenhansen
*/
@Deprecated
public interface PhysicsCollisionListener {

/**
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -39,6 +39,7 @@
* Base class for collision objects (PhysicsRigidBody, PhysicsGhostObject)
* @author normenhansen
*/
@Deprecated
public abstract class PhysicsCollisionObject implements Savable {

protected CollisionShape collisionShape;
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -38,6 +38,7 @@
* <b>Read data only in callback method, object is reused</b>
* @author normenhansen
*/
@Deprecated
public class PhysicsRayTestResult {

private PhysicsCollisionObject collisionObject;
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,7 @@
* Contains the results of a PhysicsSpace rayTest
* @author normenhansen
*/
@Deprecated
public class PhysicsSweepTestResult {

private PhysicsCollisionObject collisionObject;
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -41,6 +41,7 @@
*
* @author Nehon
*/
@Deprecated
public interface RagdollCollisionListener {

/**
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -44,6 +44,7 @@
* Basic box collision shape
* @author normenhansen
*/
@Deprecated
public class BoxCollisionShape extends CollisionShape {

private Vector3f halfExtents;
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -45,6 +45,7 @@
* Basic capsule collision shape
* @author normenhansen
*/
@Deprecated
public class CapsuleCollisionShape extends CollisionShape{
protected float radius,height;
protected int axis;
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -42,6 +42,7 @@
* TODO: add static methods to create shapes from nodes (like jbullet-jme constructor)
* @author normenhansen
*/
@Deprecated
public abstract class CollisionShape implements Savable {

/**
Expand All @@ -65,6 +66,7 @@ protected CollisionShape() {
* @param mass the desired mass for the body
* @param vector storage for the result (not null, modified)
*/
@Deprecated
Comment on lines 68 to +69
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

For method-level deprecation, providing a reason and an alternative in the Javadoc is particularly helpful for users to understand how to update their code, especially when the method signature involves external library types like javax.vecmath.

     * @deprecated use jme3-bullet instead.
     */
    @Deprecated
References
  1. A class or member that is deprecated is annotated with the @deprecated annotation and its Javadoc must include the @deprecated tag. (link)
  2. When identifying missing or incorrect Javadoc, provide a code suggestion to fix it directly.

public void calculateLocalInertia(float mass, javax.vecmath.Vector3f vector) {
if (cShape == null) {
return;
Expand All @@ -81,6 +83,7 @@ public void calculateLocalInertia(float mass, javax.vecmath.Vector3f vector) {
*
* @return the pre-existing instance
*/
@Deprecated
public com.bulletphysics.collision.shapes.CollisionShape getCShape() {
return cShape;
}
Expand All @@ -90,6 +93,7 @@ public com.bulletphysics.collision.shapes.CollisionShape getCShape() {
*
* @param cShape the shape to use (alias created)
*/
@Deprecated
public void setCShape(com.bulletphysics.collision.shapes.CollisionShape cShape) {
this.cShape = cShape;
}
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -53,6 +53,7 @@
* to generate a more sophisticated shape.
* @author normenhansen
*/
@Deprecated
public class CompoundCollisionShape extends CollisionShape {

protected ArrayList<ChildCollisionShape> children = new ArrayList<>();
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -47,6 +47,7 @@
*
* @author normenhansen
*/
@Deprecated
public class ConeCollisionShape extends CollisionShape {

protected float radius;
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -48,6 +48,7 @@
* Basic cylinder collision shape
* @author normenhansen
*/
@Deprecated
public class CylinderCollisionShape extends CollisionShape {

protected Vector3f halfExtents;
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -48,6 +48,7 @@
* Basic mesh collision shape
* @author normenhansen
*/
@Deprecated
public class GImpactCollisionShape extends CollisionShape{

protected Vector3f worldScale;
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -53,6 +53,7 @@
*
* @author Brent Owens
*/
@Deprecated
public class HeightfieldCollisionShape extends CollisionShape {

//protected HeightfieldTerrainShape heightfieldShape;
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -44,6 +44,7 @@
import java.nio.FloatBuffer;
import javax.vecmath.Vector3f;

@Deprecated
public class HullCollisionShape extends CollisionShape {

private float[] points;
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -48,6 +48,7 @@
* Basic mesh collision shape
* @author normenhansen
*/
@Deprecated
public class MeshCollisionShape extends CollisionShape {

protected int numVertices, numTriangles, vertexStride, triangleIndexStride;
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -44,6 +44,7 @@
*
* @author normenhansen
*/
@Deprecated
public class PlaneCollisionShape extends CollisionShape{
private Plane plane;

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -44,6 +44,7 @@
* A simple point, line, triangle or quad collisionShape based on one to four points-
* @author normenhansen
*/
@Deprecated
public class SimplexCollisionShape extends CollisionShape {

private Vector3f vector1, vector2, vector3, vector4;
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -43,6 +43,7 @@
* Basic sphere collision shape
* @author normenhansen
*/
@Deprecated
public class SphereCollisionShape extends CollisionShape {

protected float radius;
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -46,6 +46,7 @@
*
* @author normenhansen
*/
@Deprecated
public class ChildCollisionShape implements Savable {

/**
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -54,6 +54,7 @@
*
* @author normenhansen
*/
@Deprecated
public abstract class AbstractPhysicsControl implements PhysicsControl, JmeCloneable {

/**
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -69,6 +69,7 @@
*
* @author normenhansen
*/
@Deprecated
public class BetterCharacterControl extends AbstractPhysicsControl implements PhysicsTickListener, JmeCloneable {

protected static final Logger logger = Logger.getLogger(BetterCharacterControl.class.getName());
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -52,6 +52,7 @@
* You might want to try <code>BetterCharacterControl</code> as well.
* @author normenhansen
*/
@Deprecated
public class CharacterControl extends PhysicsCharacter implements PhysicsControl, JmeCloneable {

protected Spatial spatial;
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -58,6 +58,7 @@
*
* @author normenhansen
*/
@Deprecated
public class GhostControl extends PhysicsGhostObject implements PhysicsControl, JmeCloneable {

/**
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -42,6 +42,7 @@
*
* @author normenhansen
*/
@Deprecated
public interface PhysicsControl extends Control {

/**
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -62,6 +62,7 @@
*
* @author normenhansen
*/
@Deprecated
public class RigidBodyControl extends PhysicsRigidBody implements PhysicsControl, JmeCloneable {

/**
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -57,6 +57,7 @@
*
* @author normenhansen
*/
@Deprecated
public class VehicleControl extends PhysicsVehicle implements PhysicsControl, JmeCloneable {

/**
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -40,6 +40,7 @@
*
* @author Nehon
*/
@Deprecated
public class HumanoidRagdollPreset extends RagdollPreset {

/**
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -41,6 +41,7 @@
*
* @author Nehon
*/
@Deprecated
public abstract class RagdollPreset {

/**
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -56,6 +56,7 @@
*
* @author Nehon
*/
@Deprecated
public class RagdollUtils {

/**
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -45,6 +45,7 @@
*
* @author normenhansen
*/
@Deprecated
public abstract class AbstractPhysicsDebugControl extends AbstractControl {

private final Quaternion tmp_inverseWorldRotation = new Quaternion();
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -48,6 +48,7 @@
*
* @author normenhansen
*/
@Deprecated
public class BulletCharacterDebugControl extends AbstractPhysicsDebugControl {

/**
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -61,6 +61,7 @@
*
* @author normenhansen
*/
@Deprecated
public class BulletDebugAppState extends AbstractAppState {

/**
Expand Down
Loading
Loading