prefuse.util.force
Interface Force

All Known Implementing Classes:

AbstractForce

public interface Force

Interface for force functions in a force simulation.

Author:

jeffrey heer

Method Summary

void	getForce(ForceItem item) Updates the force calculation on the given ForceItem
void	getForce(Spring spring) Updates the force calculation on the given Spring.
float	getMaxValue(int param) Get the suggested maximum value for a parameter.
float	getMinValue(int param) Get the suggested minimum value for a parameter.
float	getParameter(int i) Returns the specified, numbered parameter.
int	getParameterCount() Returns the number of parameters (e.g., gravitational constant or spring force coefficient) affecting this force function.
java.lang.String	getParameterName(int i) Gets the text name of the requested parameter.
void	init(ForceSimulator fsim) Initialize this force function.
boolean	isItemForce() Indicates if this force function will compute forces on ForceItem instances
boolean	isSpringForce() Indicates if this force function will compute forces on Spring instances.
void	setMaxValue(int i, float val) Set the suggested maximum value for a parameter.
void	setMinValue(int i, float val) Set the suggested minimum value for a parameter.
void	setParameter(int i, float val) Sets the specified parameter value.

Method Detail

init

public void init(ForceSimulator fsim)

Initialize this force function.

Parameters:

fsim - the encompassing ForceSimulator

getParameterCount

public int getParameterCount()

Returns the number of parameters (e.g., gravitational constant or spring force coefficient) affecting this force function.

Returns:

the number of parameters

getParameter

public float getParameter(int i)

Returns the specified, numbered parameter.

Parameters:

i - the index of the parameter to return

Returns:

the parameter value

getMinValue

public float getMinValue(int param)

Get the suggested minimum value for a parameter. This value is not strictly enforced, but is used by interface components that allow force parameters to be varied.

Parameters:

param - the parameter index

Returns:

the suggested minimum value.

getMaxValue

public float getMaxValue(int param)

Get the suggested maximum value for a parameter. This value is not strictly enforced, but is used by interface components that allow force parameters to be varied.

Parameters:

param - the parameter index

Returns:

the suggested maximum value.

getParameterName

public java.lang.String getParameterName(int i)

Gets the text name of the requested parameter.

Parameters:

i - the index of the parameter

Returns:

a String containing the name of this parameter

setParameter

public void setParameter(int i,
                         float val)

Sets the specified parameter value.

Parameters:

i - the index of the parameter

val - the new value of the parameter

setMinValue

public void setMinValue(int i,
                        float val)

Set the suggested minimum value for a parameter. This value is not strictly enforced, but is used by interface components that allow force parameters to be varied.

Parameters:

i - the parameter index

val - the suggested minimum value to use

setMaxValue

public void setMaxValue(int i,
                        float val)

Set the suggested maximum value for a parameter. This value is not strictly enforced, but is used by interface components that allow force parameters to be varied.

Parameters:

i - the parameter index

Returns:

the suggested maximum value to use

isSpringForce

public boolean isSpringForce()

Indicates if this force function will compute forces on Spring instances.

Returns:

true if this force function processes Spring instances

isItemForce

public boolean isItemForce()

Indicates if this force function will compute forces on ForceItem instances

Returns:

true if this force function processes Force instances

getForce

public void getForce(ForceItem item)

Updates the force calculation on the given ForceItem

Parameters:

item - the ForceItem on which to compute updated forces

getForce

public void getForce(Spring spring)

Updates the force calculation on the given Spring. The ForceItems attached to Spring will have their force values updated appropriately.

Parameters:

spring - the Spring on which to compute updated forces