PamGraph3D.spectrogram3D

Class Surface3D

java.lang.Object

javax.media.j3d.SceneGraphObject

javax.media.j3d.Node

javax.media.j3d.Leaf

javax.media.j3d.Shape3D

PamGraph3D.spectrogram3D.Surface3D

public class Surface3D
extends javax.media.j3d.Shape3D

Produces a 3D view of a spectrogram. Requires FFT data in ArrayList. The option of creating a 2D or 3D spectrogram exists. The 3D spectrogram undergoes a compression algorithm to increase the speed of the 3D display.

Author:

Jamie Macaulay

Field Summary

Fields inherited from class javax.media.j3d.Shape3D

ALLOW_APPEARANCE_OVERRIDE_READ, ALLOW_APPEARANCE_OVERRIDE_WRITE, ALLOW_APPEARANCE_READ, ALLOW_APPEARANCE_WRITE, ALLOW_COLLISION_BOUNDS_READ, ALLOW_COLLISION_BOUNDS_WRITE, ALLOW_GEOMETRY_READ, ALLOW_GEOMETRY_WRITE

Fields inherited from class javax.media.j3d.Node

ALLOW_AUTO_COMPUTE_BOUNDS_READ, ALLOW_AUTO_COMPUTE_BOUNDS_WRITE, ALLOW_BOUNDS_READ, ALLOW_BOUNDS_WRITE, ALLOW_COLLIDABLE_READ, ALLOW_COLLIDABLE_WRITE, ALLOW_LOCAL_TO_VWORLD_READ, ALLOW_LOCALE_READ, ALLOW_PARENT_READ, ALLOW_PICKABLE_READ, ALLOW_PICKABLE_WRITE, ENABLE_COLLISION_REPORTING, ENABLE_PICK_REPORTING

Constructor Summary

Constructors

Constructor and Description
Surface3D(java.util.ArrayList<java.util.ArrayList<java.lang.Float>> surfaceData, boolean threeD)
Surface3D(java.util.ArrayList<java.util.ArrayList<java.lang.Float>> FFTData, boolean threeD, double xSize, double ySize, ColourArray.ColourArrayType colours)

Method Summary

Methods

Modifier and Type	Method and Description
void	compress(javax.vecmath.Point3d[] points, javax.vecmath.Color3b[] colours) Use this function to reduce the number of polygons by around half for large wire frame 3D spectrograms.
javax.media.j3d.QuadArray	createSpectroSurface(boolean threeD) Convert the FFT data to a 3D surface;
static java.util.ArrayList<java.util.ArrayList<java.lang.Float>>	generateTestData(int bins, int fftSize) Generate a spectrogram of random data/noise.
void	setColor(ColourArray.ColourArrayType colour)
void	setSpectrogramX(double X)
void	setSpectrogramY(double Y)

Methods inherited from class javax.media.j3d.Shape3D

addGeometry, cloneNode, duplicateNode, getAllGeometries, getAppearance, getAppearanceOverrideEnable, getBounds, getCollisionBounds, getGeometry, getGeometry, indexOfGeometry, insertGeometry, intersect, intersect, intersect, numGeometries, removeAllGeometries, removeGeometry, removeGeometry, setAppearance, setAppearanceOverrideEnable, setCollisionBounds, setGeometry, setGeometry

Methods inherited from class javax.media.j3d.Node

cloneTree, cloneTree, cloneTree, cloneTree, cloneTree, cloneTree, getBoundsAutoCompute, getCollidable, getLocale, getLocalToVworld, getLocalToVworld, getParent, getPickable, setBounds, setBoundsAutoCompute, setCollidable, setPickable

Methods inherited from class javax.media.j3d.SceneGraphObject

clearCapability, clearCapabilityIsFrequent, getCapability, getCapabilityIsFrequent, getName, getUserData, isCompiled, isLive, setCapability, setCapabilityIsFrequent, setName, setUserData, toString, updateNodeReferences

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

Surface3D

public Surface3D(java.util.ArrayList<java.util.ArrayList<java.lang.Float>> surfaceData,
         boolean threeD)

Parameters:

surfaceData- - NORMALISED data

threeD -

Surface3D

public Surface3D(java.util.ArrayList<java.util.ArrayList<java.lang.Float>> FFTData,
         boolean threeD,
         double xSize,
         double ySize,
         ColourArray.ColourArrayType colours)

Method Detail

generateTestData

public static java.util.ArrayList<java.util.ArrayList<java.lang.Float>> generateTestData(int bins,
                                                                         int fftSize)

Generate a spectrogram of random data/noise. This is purely for testing purposes

Parameters:

bins -

fftSize -

createSpectroSurface

public javax.media.j3d.QuadArray createSpectroSurface(boolean threeD)

Convert the FFT data to a 3D surface;

Returns:

QuadArray, either flat or 3D

compress

public void compress(javax.vecmath.Point3d[] points,
            javax.vecmath.Color3b[] colours)

Use this function to reduce the number of polygons by around half for large wire frame 3D spectrograms. Note do not use for 2D spectrograms as it will appear half the data is missing. Significantly increases the performance of large 3D spectrograms

setSpectrogramY

public void setSpectrogramY(double Y)

setSpectrogramX

public void setSpectrogramX(double X)

setColor

public void setColor(ColourArray.ColourArrayType colour)