Removed old docs.

src/docs/asciidoc/choose-jme2-or-jme3.adoc

@@ -1,68 +0,0 @@
-= "Which should I choose? jME2 or jME3?"
-:author:
-:revnumber:
-:revdate: 2016/03/17 20:48
-:keywords: about
-ifdef::env-github,env-browser[:outfilesuffix: .adoc]
-
-
-It is is one of the most common questions on the jME board, hence this wiki page is dedicated to answering it in full. For further insight on features, please refer to this <<compare-jme2-jme3#, comparison between jME2 and jME3>>.
-
-If you are still not sure about your choice, we'll be happy to answer your questions on the forum. Many have asked before though, so please start out with a couple search terms like 'jme2 and jme3' and you might find that your question has been answered already.
-
-
-== Why choose jME3?
-
-
-=== Current- & next-generation graphics
-
-From the beginning, jME3 was designed with modern principles and hardware in mind. Being shader based and only supporting OpenGL 2 or higher, jME3 is meant for the higher end of today's computers, and what's yet to come. OpenGL 1 support is limited to the basics of displaying textured models.
-
-
-=== Actively developed
-
-As opposed to it's legacy counterpart, jME3 is very actively developed by a team of core developers and a huge community of contributors. Any aspect of jME3 can be brought up for debate at any time.
-P.S. The earlier you get involved the greater the chance you can have a changing impact on the project.
-
-
-=== Ever-improving documentation
-
-The majority of new docs created today are documentation for jMonkeyEngine3. While naturally part of a grand community effort, these docs benefit greatly from the added support and continued iteration by core team members.
-
-
-=== jMonkeyEngine SDK
-
-With jMonkeyEngine <<sdk#,SDK>>, jME3 is the first jME version with a dedicated IDE for application development, deployment, asset management and composition tools.
-
-
-=== Broad Featureset
-
-A major design goal for jME3 is "`no`" game-dev essential left behind. Straight out of the box we aim to deliver all the basics you need to practically prototype any type of game: Physics, networking, terrain and so on, all bundled, but not forced. You can always replace any feature that doesn't match your game's requirement with a custom solution of your own making.
-
-
-=== We'll be so happy to have you!
-
-Naturally we are thrilled every time someone has decided to adopt jME3 for their [game-] development needs. Prospectively speaking, this means more testing, more commits, more buzz, more projects, more innovation; better community.
-
-
-== Why choose jME2?
-
-
-=== Stability right now
-
-jME2 has been deemed stable since 2009, with no major feature additions or reworks since 2008. Although there are plans for a final point version release (2.1), jME2 is practically in complete feature freeze.
-
-
-=== Support for low-end computers
-
-jME2 fully supports OpenGL 1, while jME3 does not. Coupled with careful programming this means you can achieve very low hardware requirements for your project.
-
-
-=== Community Tools
-
-Well written utilities like SceneMonitor and SceneWorker greatly enrich the engine's toolset.
-
-
-=== Thoroughly documented
-
-There are literally hundreds of pages of documentation for jMonkeyEngine 2.0, detailing development practices with the engine from beginners' levels through intermediate to advanced. Do note however that as jME3 grows more popular this documentation will be maintained by the community alone (see 'Ever-improving documentation' in the jME3 section below).

src/docs/asciidoc/compare-jme2-jme3.adoc

@@ -1,150 +0,0 @@
-= Technical comparison between jME2 and jME3
-:author: 
-:revnumber: 
-:revdate: 2016/03/17 20:48
-ifdef::env-github,env-browser[:outfilesuffix: .adoc]
-
-
-
-== Shaders?
-
-*  jME3: Shaders are integrated in the core and material system. JME3 supports shader libraries and permutations through defines. User-friendly post-processor filters, scene processors, and <<jme3/advanced/jme3_shadernodes#,shader node system>> (you don't need to know shaders to be able to use them).
-*  jME2: Full access to shader support through a RenderState, requires user to know and understand shaders. No support for libraries or permutations.
-
-
-== Resource management?
-
-*  jME3: Integrated in core. All data loaded from files is cached inside AssetManager. User customizable. Supports threaded loading. Can load from ZIP/JAR files on the local harddrive and on an HTTP server.
-*  jME2: Only textures are managed in TextureManager. ResourceLocatorTool is used for locating resources.
-
-
-== Input handling?
-
-*  jME3: Designed for games. Abstracting keyboard, mouse and joystick into a single, binding based interface. Low level interface available for +++<abbr title="Graphical User Interface">GUI</abbr>+++ access.
-*  jME2: Layer over keyboard, mouse and joystick. Main input interface (InputManager) can cause bloat in user code. Binding system available separately through darkfrog's input binding system.
-
-
-== GL Object handling?
-
-*  jME3:  Unused GL objects are deleted when they are garbage collected by Java.
-*  jME2:  All objects are leaked unless manually cleaned up by the user.
-
-
-== Collision/Picking?
-
-*  jME3:  BIH (Bounding interleaved hierarchy) for static mesh picking and collision. Supports Volume vs. Tri collision.
-*  jME2:  Red-black tree over entire mesh data, less efficient collision than BIH but faster generation for animated objects. Supports Tri vs. Tri collision but not Volume vs. Tri which is more commonly used.
-
-
-== Native library handling?
-
-*  jME3:  Copies natives and loads them at runtime.
-*  jME2:  None, requires user to specify java.library.path property.
-
-
-== Post processing?
-
-*  jME3:  HDR/Tonemapping, SSAO, Bloom, Radial Blur, Light Scattering, CartoonEdge.
-*  jME2:  Bloom, Basic Motion Blur
-
-
-== Shadow effects?
-
-*  jME3:  Built in the core. Customizable shadow map method, supports basic and PSSM methods.
-*  jME2:  ShadowedRenderPass for stencil shadows, issues if camera goes inside shadow volume. DirectionalShadowMapPass for basic shadow mapping.
-
-
-== Geometry handling?
-
-*  jME3:  Geometry is a scene graph element, contains a Mesh object. Meshes contain VertexBuffers which specify # of components, type, float/int buffer. This allows a single mesh to be shared along many scene graph elements. Supports features like Level of Detail and animation internally.
-*  jME2:  Geometry/TriMesh a scene graph element contains float buffers and int buffers, VBO only supports static models, custom attributes are specified manually via GLSLShaderDataLogic and do not work if VBO is used.
-
-
-== Scene graph updates?
-
-*  jME3:  Refresh flags prevent unneeded scene updates.
-*  jME2:  All data updated in updateGeometricState. Every call updates entire scene graph, locking mechanism is used to reduce unneeded updates but requires used intervention.
-
-
-== RenderState/Material
-
-*  jME3:  Only at leafs. Scriptable material system is used. materials contain techniques which contain shader &amp; render state. Shader is customized with defines specified in material instance (by user). This is a data-driven approach to materials.
-*  jME2:  Each scene graph element contains an array of RenderStates. They are combined and stored in the leafs. No data-driven solution.
-
-
-== Support for fixed-function/old gpus?
-
-*  jME3:  Supported via FixedFunc bindings in shader source.
-*  jME2:  Full support.
-
-
-== Renderer capabilities?
-
-*  jME3:  Queriable through cap system.
-*  jME2:  Queriable through the Renderer and the various renderstates.
-
-
-== Math object pooling (Vector, Matrix, etc)?
-
-*  jME3:  ThreadLocal-based system, defined as instance variables accessible by any class. Assertion-based “locking is used to prevent data corruption.
-*  jME2:  static declarations (kills multithreading in these classes) or no pooling at all.
-
-
-== Text?
-
-*  jME3:  AngelCode bitmap text
-*  jME2:  Fixed-length font, 3D text, AngelCode bitmap text
-
-
-== User interface?
-
-*  jME3:  Simple text and ortho built-in, NiftyGui integration can be used for more advanced user interface.
-*  jME2:  Only simple text and ortho. jME-desktop (not working well under MacOS X), external libs available (FengGUI, GBUI, NiftyGui).
-
-
-== Animation?
-
-*  jME3:  OgreXML-based animation system with many features. Software skinning and hardware skinning are supported.
-*  jME2:  Too many systems, creating a big mess. jME-xml and collada use one system, md2/md3 use another, milkshape models use another, ogrexml uses another and md5 uses another.
-
-
-== Spatial partitioning?
-
-*  jME3:  None.
-*  jME2:  None.
-
-
-== Model formats?
-
-*  jME3:  Ogre3D Mesh.XML and OBJ.
-*  jME2:  Static/VertexAnim: ase, obj, 3ds, md2, md3, ms3d, x3d. Skeleton: (broken) collada, ogre3d, jme-xml (md5 as a seperate lib)
-
-
-== Import/Export?
-
-*  jME3:  Same as jME2. Don't fix what's not broken.
-*  jME2:  Input/Output capsules and Savable. Binary and XML.
-
-
-== Physics?
-
-*  jME3:  Full JBullet integration.
-*  jME2:  External libs available: jME-physics, jbullet-jme, SimplePhysics.
-
-
-== Canvas support?
-
-*  jME3:  Yes.
-*  jME2:  Yes, although the +++<abbr title="Application Programming Interface">API</abbr>+++ could have been a little less convoluted.
-
-
-== Particles?
-
-*  jME3:  Yes.
-*  jME2:  Yes but +++<abbr title="Application Programming Interface">API</abbr>+++ could be a little less convoluted.
-
-
-== Terrain?
-
-*  jME3:  Image based heightmap, supports dynamic terrain loading, geomipmapping (LOD), and texture splatting. Can import Ogre3D dotScene files for non-heightmap terrain.
-*  jME2:  Image based or randomly generated heightmap. Quadtree support.