artisynth.core.fields

Class VectorVertexField<T extends VectorObject<T>>

java.lang.Object

artisynth.core.modelbase.ModelComponentBase

artisynth.core.fields.MeshFieldComp

artisynth.core.fields.VectorMeshField<T>

artisynth.core.fields.VectorVertexField<T>

All Implemented Interfaces:

FieldComponent, ModelComponent, PostScannable, RenderableComponent, VectorFieldComponent<T>, java.lang.Cloneable, HasProperties, HierarchyNode, HasRenderProps, IsRenderable, IsSelectable, Renderable, ParameterizedClass, Scannable

Direct Known Subclasses:

MatrixNdVertexField, Vector3dVertexField, VectorNdVertexField

public class VectorVertexField<T extends VectorObject<T>>
extends VectorMeshField<T>

A vector field defined over a triangular polygonal mesh, using values set at the mesh's vertices. Values at other points are obtained by barycentric interpolation on the faces nearest to those points. Values at vertices for which no explicit value has been set are given by the field's default value. Vectors are of type T, which must be an instance of VectorObject.

Nested Class Summary

Nested classes/interfaces inherited from interface artisynth.core.modelbase.ModelComponent

ModelComponent.NavpanelVisibility

Field Summary

Fields inherited from class artisynth.core.fields.VectorMeshField

myProps

Fields inherited from class artisynth.core.modelbase.ModelComponentBase

enforceUniqueCompositeNames, enforceUniqueNames, myNumber, NULL_OBJ, useCompactPathNames

Fields inherited from interface maspack.render.IsRenderable

TRANSPARENT, TWO_DIMENSIONAL

Constructor Summary

Constructors

Constructor and Description
VectorVertexField(java.lang.Class<T> type) This constructor should not be called by applications, unless ModelComponentBase.scan(maspack.util.ReaderTokenizer, java.lang.Object) is called immediately after.
VectorVertexField(java.lang.Class<T> type, MeshComponent mcomp) Constructs a field for a given mesh, with a default value of 0.
VectorVertexField(java.lang.Class<T> type, MeshComponent mcomp, T defaultValue) Constructs a field for a given mesh and default value.
VectorVertexField(java.lang.String name, java.lang.Class<T> type, MeshComponent mcomp) Constructs a named field for a given mesh, with a default value of 0.
VectorVertexField(java.lang.String name, java.lang.Class<T> type, MeshComponent mcomp, T defaultValue) Constructs a named field for a given mesh and default value.

Method Summary

Modifier and Type	Method and Description
void	clearAllValues() Clear all values defined for the features (e.g., vertices, faces) associated with this field.
void	clearValue(Vertex3d vtx) Clears the value at a given vertex.
T	getValue(int vidx) Returns the value at the vertex specified by a given index.
T	getValue(MeshFieldPoint fp) Returns the value of the this field at a specified mesh field point.
T	getValue(Point3d pos) Returns the value of the this field at a specified spatial position.
T	getValue(Vertex3d vtx) Returns the value at a vertex.
boolean	isValueSet(Vertex3d vtx) Queries whether a value has been seen at a given vertex.
void	postscan(java.util.Deque<ScanToken> tokens, CompositeComponent ancestor) Performs any required post-scanning for this component.
void	setValue(Vertex3d vtx, T value) Sets the value at a vertex.

Methods inherited from class artisynth.core.fields.VectorMeshField

createDefaultRenderProps, createRenderProps, createTypeInstance, getAllPropertyInfo, getDefaultValue, getParameterType, getRenderScale, getValue, hasParameterizedType, prerender, render, setDefaultValue, setRenderScale

Methods inherited from class artisynth.core.fields.MeshFieldComp

clearCacheIfNecessary, createFieldPoint, getHardReferences, getMesh, getMeshComp, getRenderHints, getRenderProps, getSelection, isSelectable, numSelectionQueriesNeeded, setRenderProps, updateBounds

Methods inherited from class artisynth.core.modelbase.ModelComponentBase

checkFlag, checkName, checkNameUniqueness, clearFlag, clone, connectToHierarchy, copy, createTempFlag, disconnectFromHierarchy, getChildren, getGrandParent, getName, getNameRange, getNavpanelVisibility, getNavpanelVisibility, getNumber, getParent, getProperty, getSoftReferences, hasChildren, hasState, isFixed, isMarked, isScanning, isSelected, isWritable, makeValidName, makeValidName, notifyParentOfChange, printReferences, recursivelyContained, recursivelyContains, removeTempFlag, scan, setFixed, setFlag, setMarked, setName, setNavpanelVisibility, setNavpanelVisibility, setNumber, setParent, setScanning, setSelected, setWritable, updateReferences, write

Methods inherited from class java.lang.Object

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

Methods inherited from interface artisynth.core.modelbase.FieldComponent

clearCacheIfNecessary

Methods inherited from interface artisynth.core.modelbase.ModelComponent

connectToHierarchy, disconnectFromHierarchy, getHardReferences, getName, getNavpanelVisibility, getNumber, getParent, getSoftReferences, hasState, isFixed, isMarked, isSelected, notifyParentOfChange, scan, setFixed, setMarked, setName, setNumber, setParent, setSelected, setWritable, updateReferences

Methods inherited from interface maspack.properties.HasProperties

getProperty

Methods inherited from interface maspack.properties.HierarchyNode

getChildren, hasChildren

Methods inherited from interface maspack.util.Scannable

isWritable, write

Methods inherited from interface maspack.render.IsSelectable

getSelection, isSelectable, numSelectionQueriesNeeded

Methods inherited from interface maspack.render.IsRenderable

getRenderHints, updateBounds

Methods inherited from interface maspack.render.HasRenderProps

getRenderProps, setRenderProps

Constructor Detail

VectorVertexField

public VectorVertexField(java.lang.Class<T> type)

This constructor should not be called by applications, unless ModelComponentBase.scan(maspack.util.ReaderTokenizer, java.lang.Object) is called immediately after.

VectorVertexField

public VectorVertexField(java.lang.Class<T> type,
                         MeshComponent mcomp)

Constructs a field for a given mesh, with a default value of 0. At present, the mesh must be a triangular PolygonalMesh.

Parameters:

type - class type of the VectorObject describing the field's values

mcomp - component containing the mesh associated with the field

VectorVertexField

public VectorVertexField(java.lang.Class<T> type,
                         MeshComponent mcomp,
                         T defaultValue)

Constructs a field for a given mesh and default value. At present, the mesh must be a triangular PolygonalMesh.

Parameters:

type - class type of the VectorObject describing the field's values

mcomp - component containing the mesh associated with the field

defaultValue - default value for vertices which don't have explicitly set values

VectorVertexField

public VectorVertexField(java.lang.String name,
                         java.lang.Class<T> type,
                         MeshComponent mcomp)

Constructs a named field for a given mesh, with a default value of 0. At present, the mesh must be a triangular PolygonalMesh.

Parameters:

name - name of the field

type - class type of the VectorObject describing the field's values

mcomp - component containing the mesh associated with the field

VectorVertexField

public VectorVertexField(java.lang.String name,
                         java.lang.Class<T> type,
                         MeshComponent mcomp,
                         T defaultValue)

Constructs a named field for a given mesh and default value. At present, the mesh must be a triangular PolygonalMesh.

Parameters:

name - name of the field

type - class type of the VectorObject describing the field's values

mcomp - component containing the mesh associated with the field

defaultValue - default value for vertices which don't have explicitly set values

Method Detail

getValue

public T getValue(int vidx)

Returns the value at the vertex specified by a given index. The default value is returned if a value has not been explicitly set for that vertex.

Parameters:

vidx - vertex index

Returns:

value at the vertex

getValue

public T getValue(Vertex3d vtx)

Returns the value at a vertex. The default value is returned if a value has not been explicitly set for that vertex.

Parameters:

vtx - vertex for which the value is requested

Returns:

value at the vertex

getValue

public T getValue(Point3d pos)

Returns the value of the this field at a specified spatial position.

Specified by:

getValue in interface VectorFieldComponent<T extends VectorObject<T>>

Specified by:

getValue in class VectorMeshField<T extends VectorObject<T>>

Parameters:

pos - position at which value is requested

Returns:

value at the position

getValue

public T getValue(MeshFieldPoint fp)

Returns the value of the this field at a specified mesh field point.

Parameters:

fp - point at which value is requested

Returns:

value at the point

setValue

public void setValue(Vertex3d vtx,
                     T value)

Sets the value at a vertex.

Parameters:

vtx - vertex for which the value is to be set

value - new value for the vertex

isValueSet

public boolean isValueSet(Vertex3d vtx)

Queries whether a value has been seen at a given vertex.

Parameters:

vtx - vertex being queried

Returns:

true if a value has been set at the vertex

clearValue

public void clearValue(Vertex3d vtx)

Clears the value at a given vertex. After this call, the vertex will be associated with the default value.

Parameters:

vtx - vertex whose value is to be cleared

clearAllValues

public void clearAllValues()

Clear all values defined for the features (e.g., vertices, faces) associated with this field. After this call, the field will have a uniform value defined by its defaultValue.

Specified by:

clearAllValues in class VectorMeshField<T extends VectorObject<T>>

postscan

public void postscan(java.util.Deque<ScanToken> tokens,
                     CompositeComponent ancestor)
              throws java.io.IOException

Performs any required post-scanning for this component. This involves handling any information whose processing was deferred during the scan() method and stored in the token queue. The most common use of this method is to resolve the paths of component references, which may not have been created at the time of the initial scan() call.

Specified by:

postscan in interface PostScannable

Overrides:

postscan in class ModelComponentBase

Parameters:

tokens - token information that was stored during scan().

ancestor - ancestor component with respect to which reference component paths are defined.

Throws:

java.io.IOException - if an error is encountered (such as a reference to a non-existent component)