Skip to main content

Source code browse

Revision: 234

Fixed build files to properly use tools.dir variable where appropriate as required by RE.
» Project Revision History

» Checkout URL

svn / trunk

FilenameAuthorRevisionModifiedLog Entry
..
trembovetski 232 about 7 years ago Fixed build files to properly us...
campbell 221 over 7 years ago - Updated project files after up...
campbell 200 over 7 years ago - Decora-D3D.dll should not be i...
trembovetski 234 almost 7 years ago Fixed build files to properly us...
trembovetski 234 almost 7 years ago Fixed build files to properly us...
campbell 221 over 7 years ago - Updated project files after up...
kcr 230 about 7 years ago Added svn:ignore properties
kcr 230 about 7 years ago Added svn:ignore properties
trembovetski 234 almost 7 years ago Fixed build files to properly us...
trembovetski 234 almost 7 years ago Fixed build files to properly us...
campbell 221 over 7 years ago - Updated project files after up...
campbell 220 over 7 years ago - Crank up optimization settings...
campbell 46 over 7 years ago - Removed Decora-D3D from the li...
campbell 140 over 7 years ago - Playing with applet sizes.
The Basics
----------

This is the NetBeans project for the Effects Framework implementation.  The
core components can be built with JDK 5 and above, but some optional pieces
need to be built with JDK 6u10 or above (see below for more details).

The Effects Framework project is hosted at:
https://scenegraph-effects.dev.java.net

The SVN repository for the project is located at:
https://scenegraph-effects.dev.java.net/svn/scenegraph-effects/trunk


The Components
--------------

The Effects Framework is composed of a number of NetBeans subprojects
(listed in the order in which they are typically built):

  Decora-Compiler
    Requires: JDK 5+, ANTLR 3+ (automatically downloaded into "tools")
    Provides: A compiler that takes JSL (something like a shading language)
              files as input and produces a few outputs: a pure-Java (CPU)
              effect implementation, a GLSL (OpenGL) pixel shader, and an
              HLSL (Direct3D) pixel shader.
  
  Decora-Runtime
    Requires: JDK 5+
    Depends:  Decora-Compiler
    Provides: The core Effect classes (e.g. GaussianBlur, Blend) and their
              basic, software implementations.  The EffectPeer implementations
              are generated from the JSL files in the "jsl" subdirectory using
              the JSLC compiler.

  Decora-HW
    Requires: JDK 6u10+
    Depends:  Decora-Runtime
    Provides: The shared implementation code for the GPU backends.

  Decora-OGL
    Requires: JDK 6u10+
    Depends:  Decora-HW, JOGL
    Provides: The OpenGL backend classes, and the GLSL versions of the
              effects to be used when the OpenGL-based Java 2D pipeline
              is available (JDK 6u10 and later, on Windows, Linux, and
              Solaris; Mac OS X coming soon).

  Decora-D3D
    Requires: JDK 6u10+
    Depends:  Decora-HW
    Provides: The Direct3D backend classes, and the HLSL versions of the
              effects to be used when the Direct3D-based Java 2D pipeline
              is available (JDK 6u10 and later, on Windows only).

  Decora-D3D-Native
    Requires: JDK 6u10+, MSVC 2003
    Depends:  Decora-D3D
    Provides: A small amount of native code for rendering textures and
              using shaders with Direct3D.

  Decora-Dist
    Requires: JDK 6u10+
    Depends:  All of the above
    Provides: JNLP extension descriptors and signed versions of the
              above binaries.

  Decora-Demo
    Requires: JDK 6+ for CPU backend, JDK 6u10+ for GPU backends
    Depends:  Decora-Runtime
    Optional: Decora-OGL, JOGL (automatically downloaded into "tools")
              Decora-D3D
    Provides: A number of simple Swing applications that demonstrate
              the features of the various Effect classes.


How to Build and Run
--------------------

[Currently, building Decora-D3D and Decora-D3D-Native requires access
to a JDK 6u10 source workspace.  We are working to get this dependency
removed in the next few days.]

The easiest way to get started is to right-click on the Decora-Demo
project in NetBeans and select "Build".  This will build all the required
projects, as well as Decora-OGL (the optional GPU-accelerated backend).
You can select one of the many demo configurations from the drop-down list
of run targets (assumes NetBeans 6.0 or above).  For example, select
the "Phong SW" and click "Run" to run the Phong Lighting demo with
GPU acceleration disabled; select "Phong OGL" to run the same demo with
OpenGL acceleration enabled, and so on.


Relationship to the Scene Graph Project
---------------------------------------

The main "consumer" of the Effects Framework is the Scene Graph project,
hosted at:
https://scenegraph.dev.java.net

When using the Effects Framework in an application that uses the
Scene Graph project, Scenario.jar is all you need.  That single jar file
contains the scenegraph and animation packages, as well as all the core
effects classes that are developed as part of the Effects Framework.


Using the Effects Framework outside of the Scene Graph
------------------------------------------------------

While the Effects Framework is an integral part of the Scene Graph project,
it can also be used on its own, for example in a basic Swing or Java 2D
application, simply by adding Decora-Runtime.jar to the classpath.  The
Decora-Demo project contains a number of simple Swing applications that
demonstrate how the Effects Framework can be used on its own.
 
 
Close
loading
Please Confirm
Close