com.openinventor.meshviz.graph

Class PoHistogram

java.lang.Object

com.openinventor.inventor.Inventor

com.openinventor.inventor.misc.SoBase

com.openinventor.inventor.fields.SoFieldContainer

com.openinventor.inventor.nodes.SoNode

com.openinventor.inventor.nodekits.SoBaseKit

com.openinventor.meshviz.graph.PoBase

com.openinventor.meshviz.graph.PoGraphMaster

com.openinventor.meshviz.graph.PoHistogram

All Implemented Interfaces:

SafeDisposable, SoGetView

Direct Known Subclasses:

PoMultipleHistogram, PoSingleHistogram

public class PoHistogram
extends PoGraphMaster

Abstract class for histogram representations. This class handles the start, the end, the values of the bars, the names of the bars and the bars spacing of a histogram.

All histogram texts depend on the current miscellaneous text attributes which define the font name, line length and so on. If the method setMiscTextAttr(textAttr) is called, the current miscellaneous text attributes are defined by "textAttr". Otherwise the current miscellaneous text attributes are specified in the current inherited state (cf property node PoMiscTextAttr).

All histogram numerical values depend on the current numerical display format. If the method setFormat(format) is called, the current numerical display format is "format". Otherwise the current numerical display format is specified in the current inherited state (cf property node PoNumericDisplayFormat).

If coloring = DATA_MAPPING, colors of histogram bars depend on the current data mapping. If the method setDataMapping(dataMapping) is called, the current data mapping is "dataMapping". Otherwise the current data mapping is specified in the current inherited state (cf property node PoDataMapping and its derived classes). If there is no current data-mapping (i.e setDataMapping() not called and no PoDataMapping node traversed before in the scene graph), all bars get the same color which is the inherited color.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	PoHistogram.BarSpaceTypes Type of spacing between bars.
static class	PoHistogram.Colorings Type of coloration of the bars.
static class	PoHistogram.Positions Type of positions relative to a histogram bar.
static class	PoHistogram.TextPaths Type of text path.
static class	PoHistogram.Types Type of orientation of the histogram's bars.
static class	PoHistogram.Visibilities Type of visibility.

Nested classes/interfaces inherited from class com.openinventor.meshviz.graph.PoBase

PoBase.NodeWriteFormats, PoBase.TextTypes, PoBase.UpdateMethodTypes

Nested classes/interfaces inherited from class com.openinventor.inventor.Inventor

Inventor.ConstructorCommand

Field Summary

Fields

Modifier and Type	Field and Description
SoSFEnum<PoHistogram.BarSpaceTypes>	barSpaceType Type of bar spacing.
SoSFFloat	barSpaceValue Spacing value.
SoMFColor	color Color list for the histogram bars.
static int	COLOR_LIST Deprecated. Use PoHistogram.Colorings.COLOR_LIST instead.
SoSFEnum<PoHistogram.Colorings>	coloring Specifies how the histogram bars are colored.
static int	DATA_MAPPING Deprecated. Use PoHistogram.Colorings.DATA_MAPPING instead.
SoSFFloat	end Define the end point of the histogram.
static int	FIXED_SPACE Deprecated. Use PoHistogram.BarSpaceTypes.FIXED_SPACE instead.
SoSFString	nameFontName Font name of bars names.
SoSFFloat	nameFontSize Font size of bars names.
SoSFEnum<PoHistogram.TextPaths>	namePath Bars names path.
SoSFEnum<PoHistogram.Positions>	namePosition Bars names position in relation to histograms bars.
SoSFEnum<PoHistogram.Visibilities>	nameVisibility Bars names visibility.
static int	PATH_DEPEND Deprecated. Use PoHistogram.TextPaths.PATH_DEPEND instead.
static int	PATH_DOWN Deprecated. Use PoHistogram.TextPaths.PATH_DOWN instead.
static int	PATH_LEFT Deprecated. Use PoHistogram.TextPaths.PATH_LEFT instead.
static int	PATH_RIGHT Deprecated. Use PoHistogram.TextPaths.PATH_RIGHT instead.
static int	PATH_UP Deprecated. Use PoHistogram.TextPaths.PATH_UP instead.
static int	POS_BOTTOM_IN Deprecated. Use PoHistogram.Positions.POS_BOTTOM_IN instead.
static int	POS_BOTTOM_OUT Deprecated. Use PoHistogram.Positions.POS_BOTTOM_OUT instead.
static int	POS_CENTER Deprecated. Use PoHistogram.Positions.POS_CENTER instead.
static int	POS_DEPEND Deprecated. Use PoHistogram.Positions.POS_DEPEND instead.
static int	POS_LEFT_IN Deprecated. Use PoHistogram.Positions.POS_LEFT_IN instead.
static int	POS_LEFT_OUT Deprecated. Use PoHistogram.Positions.POS_LEFT_OUT instead.
static int	POS_RIGHT_IN Deprecated. Use PoHistogram.Positions.POS_RIGHT_IN instead.
static int	POS_RIGHT_OUT Deprecated. Use PoHistogram.Positions.POS_RIGHT_OUT instead.
static int	POS_TOP_IN Deprecated. Use PoHistogram.Positions.POS_TOP_IN instead.
static int	POS_TOP_OUT Deprecated. Use PoHistogram.Positions.POS_TOP_OUT instead.
static int	REL_SPACE Deprecated. Use PoHistogram.BarSpaceTypes.REL_SPACE instead.
SoSFVec2f	start Define the start point of the histogram.
SoSFEnum<PoHistogram.Types>	type Defines if the histogram is an X histogram (bars are perpendicular to the X- axis) or a Y histogram (bars are perpendicular to the Y-axis).
SoSFString	valueAddString String to be concatenated.
SoSFBool	valueAddStringVisibility Visibility of the string concatenated to the values.
SoSFString	valueFontName Font name of values.
SoSFFloat	valueFontSize Font size of values.
SoSFEnum<PoHistogram.TextPaths>	valuePath Values path.
SoSFEnum<PoHistogram.Positions>	valuePosition Values position in relation to histogram bars.
SoSFEnum<PoHistogram.Visibilities>	valueVisibility Values visibility.
static int	VISIBILITY_OFF Deprecated. Use PoHistogram.Visibilities.VISIBILITY_OFF instead.
static int	VISIBILITY_ON Deprecated. Use PoHistogram.Visibilities.VISIBILITY_ON instead.
static int	X Deprecated. Use PoHistogram.Types.X instead.
static int	Y Deprecated. Use PoHistogram.Types.Y instead.

Fields inherited from class com.openinventor.meshviz.graph.PoBase

FOLD_NODE_WRITE_FORMAT, SO_ANNO_TEXT3, SO_TEXT3, UNFOLD_NODE_WRITE_FORMAT, UPDATE_METHOD_IMMEDIATE, UPDATE_METHOD_ON_ACTION

Fields inherited from class com.openinventor.inventor.nodekits.SoBaseKit

boundingBoxIgnoring

Fields inherited from class com.openinventor.inventor.Inventor

VERBOSE_LEVEL, ZeroHandle

Method Summary

Modifier and Type	Method and Description
static SoNodekitCatalog	getClassNodekitCatalog() Returns the SoNodekitCatalog for this class.
PbDataMapping	getDataMapping() Gets a reference to a PbDataMapping object to the association color-value for coloring the bars.
PbNumericDisplayFormat	getFormat() Gets a reference to a PbNumericDisplayFormat object for the numerical display format of values of the histograms.
PbMiscTextAttr	getMiscTextAttr() Gets a reference to a PbMiscTextAttr for miscellaneous text attributes.
void	setDataMapping(PbDataMapping dataMapping) Sets a reference to a PbDataMapping object to the association color-value for coloring the bars.
void	setFormat(PbNumericDisplayFormat format) Sets a reference to a PbNumericDisplayFormat object for the numerical display format of values of the histograms.
void	setMiscTextAttr(PbMiscTextAttr textAttr) Sets a reference to a PbMiscTextAttr for miscellaneous text attributes.

Methods inherited from class com.openinventor.meshviz.graph.PoBase

addPostRebuildCallback, addPreRebuildCallback, getDomain, getNodeWriteFormat, getTextType, getUpdateMethod, isBuilt, isModified, isVRML2Mode, rebuild, setDomain, setNodeWriteFormat, setTextType, setUpdateMethod, setVRML2Mode, touchKit

Methods inherited from class com.openinventor.inventor.nodekits.SoBaseKit

getNodekitCatalog, getPart, getPart, getPartString, getViewportIsEnabled, getViewportOrigin, getViewportSize, isSearchingChildren, set, set, setPart, setSearchingChildren

Methods inherited from class com.openinventor.inventor.nodes.SoNode

affectsState, callback, copy, copy, distribute, doAction, getAlternateRep, getBoundingBox, getByName, getMatrix, getPrimitiveCount, getRenderUnitID, GLRender, GLRenderBelowPath, GLRenderInPath, GLRenderOffPath, grabEventsCleanup, grabEventsSetup, handleEvent, isBoundingBoxIgnoring, isOverride, pick, rayPick, search, setOverride, touch, write

Methods inherited from class com.openinventor.inventor.fields.SoFieldContainer

copyFieldValues, copyFieldValues, enableNotify, fieldsAreEqual, get, getAllFields, getEventIn, getEventOut, getField, getFieldName, hasDefaultValues, isNotifyEnabled, setToDefaults

Methods inherited from class com.openinventor.inventor.misc.SoBase

dispose, getEXTERNPROTO, getName, getPROTO, isDisposable, isSynchronizable, setName, setSynchronizable

Methods inherited from class com.openinventor.inventor.Inventor

getAddress, getNativeResourceHandle, startInternalThreads, stopInternalThreads

Methods inherited from class java.lang.Object

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

Field Detail

X

@Deprecated
public static final int X

Deprecated. Use PoHistogram.Types.X instead.

Y

@Deprecated
public static final int Y

Deprecated. Use PoHistogram.Types.Y instead.

POS_TOP_OUT

@Deprecated
public static final int POS_TOP_OUT

Deprecated. Use PoHistogram.Positions.POS_TOP_OUT instead.

POS_TOP_IN

@Deprecated
public static final int POS_TOP_IN

Deprecated. Use PoHistogram.Positions.POS_TOP_IN instead.

POS_BOTTOM_OUT

@Deprecated
public static final int POS_BOTTOM_OUT

Deprecated. Use PoHistogram.Positions.POS_BOTTOM_OUT instead.

POS_BOTTOM_IN

@Deprecated
public static final int POS_BOTTOM_IN

Deprecated. Use PoHistogram.Positions.POS_BOTTOM_IN instead.

POS_RIGHT_OUT

@Deprecated
public static final int POS_RIGHT_OUT

Deprecated. Use PoHistogram.Positions.POS_RIGHT_OUT instead.

POS_RIGHT_IN

@Deprecated
public static final int POS_RIGHT_IN

Deprecated. Use PoHistogram.Positions.POS_RIGHT_IN instead.

POS_LEFT_OUT

@Deprecated
public static final int POS_LEFT_OUT

Deprecated. Use PoHistogram.Positions.POS_LEFT_OUT instead.

POS_LEFT_IN

@Deprecated
public static final int POS_LEFT_IN

Deprecated. Use PoHistogram.Positions.POS_LEFT_IN instead.

POS_CENTER

@Deprecated
public static final int POS_CENTER

Deprecated. Use PoHistogram.Positions.POS_CENTER instead.

POS_DEPEND

@Deprecated
public static final int POS_DEPEND

Deprecated. Use PoHistogram.Positions.POS_DEPEND instead.

VISIBILITY_OFF

@Deprecated
public static final int VISIBILITY_OFF

Deprecated. Use PoHistogram.Visibilities.VISIBILITY_OFF instead.

VISIBILITY_ON

@Deprecated
public static final int VISIBILITY_ON

Deprecated. Use PoHistogram.Visibilities.VISIBILITY_ON instead.

PATH_RIGHT

@Deprecated
public static final int PATH_RIGHT

Deprecated. Use PoHistogram.TextPaths.PATH_RIGHT instead.

PATH_LEFT

@Deprecated
public static final int PATH_LEFT

Deprecated. Use PoHistogram.TextPaths.PATH_LEFT instead.

PATH_UP

@Deprecated
public static final int PATH_UP

Deprecated. Use PoHistogram.TextPaths.PATH_UP instead.

PATH_DOWN

@Deprecated
public static final int PATH_DOWN

Deprecated. Use PoHistogram.TextPaths.PATH_DOWN instead.

PATH_DEPEND

@Deprecated
public static final int PATH_DEPEND

Deprecated. Use PoHistogram.TextPaths.PATH_DEPEND instead.

REL_SPACE

@Deprecated
public static final int REL_SPACE

Deprecated. Use PoHistogram.BarSpaceTypes.REL_SPACE instead.

FIXED_SPACE

@Deprecated
public static final int FIXED_SPACE

Deprecated. Use PoHistogram.BarSpaceTypes.FIXED_SPACE instead.

COLOR_LIST

@Deprecated
public static final int COLOR_LIST

Deprecated. Use PoHistogram.Colorings.COLOR_LIST instead.

DATA_MAPPING

@Deprecated
public static final int DATA_MAPPING

Deprecated. Use PoHistogram.Colorings.DATA_MAPPING instead.

start

public final SoSFVec2f start

Define the start point of the histogram.

end

public final SoSFFloat end

Define the end point of the histogram.

type

public final SoSFEnum<PoHistogram.Types> type

Defines if the histogram is an X histogram (bars are perpendicular to the X- axis) or a Y histogram (bars are perpendicular to the Y-axis).

color

public final SoMFColor color

Color list for the histogram bars. This field is used only if coloring = COLOR_LIST. If the number of colors is less than the number of bars, all the bars get the same color which is the inherited color.

coloring

public final SoSFEnum<PoHistogram.Colorings> coloring

Specifies how the histogram bars are colored. if coloring = COLOR_LIST, the bars are colored using the color list field color, otherwise the bars are colored according to their values (see the current data mapping for the association color-value at the header description).

valueVisibility

public final SoSFEnum<PoHistogram.Visibilities> valueVisibility

Values visibility.

valuePosition

public final SoSFEnum<PoHistogram.Positions> valuePosition

Values position in relation to histogram bars.

valuePath

public final SoSFEnum<PoHistogram.TextPaths> valuePath

Values path. .

valueFontSize

public final SoSFFloat valueFontSize

Font size of values. if this value is less or equal to 0, the font size is fixed at 0.04. This value is a percentage of the current domain (cf PoBase description).

valueFontName

public final SoSFString valueFontName

Font name of values. If the font is equal to its default value, the font used is the font of the current miscellaneous text attributes.

valueAddStringVisibility

public final SoSFBool valueAddStringVisibility

Visibility of the string concatenated to the values.

valueAddString

public final SoSFString valueAddString

String to be concatenated.

nameVisibility

public final SoSFEnum<PoHistogram.Visibilities> nameVisibility

Bars names visibility.

namePosition

public final SoSFEnum<PoHistogram.Positions> namePosition

Bars names position in relation to histograms bars.

namePath

public final SoSFEnum<PoHistogram.TextPaths> namePath

Bars names path. .

nameFontSize

public final SoSFFloat nameFontSize

Font size of bars names. if this value is less or equal to 0, the font size is fixed at 0.04. This value is a percentage of the current domain (cf PoBase description).

nameFontName

public final SoSFString nameFontName

Font name of bars names. If the font is equal to its default value, the font used is the font of the current miscellaneous text attributes.

barSpaceType

public final SoSFEnum<PoHistogram.BarSpaceTypes> barSpaceType

Type of bar spacing. The spacing between bars modifies the thickness of the histogram bars.

barSpaceValue

public final SoSFFloat barSpaceValue

Spacing value. If barSpaceType = REL_SPACE, real_spacing = barSpaceValue * width_bar, where width_bar is the distance between the histogram origin and the end point divided by the number of main bars. If barSpaceType = FIXED_SPACE, the real spacing is equal to barSpaceValue.

Method Detail

getFormat

public PbNumericDisplayFormat getFormat()

Gets a reference to a PbNumericDisplayFormat object for the numerical display format of values of the histograms.

getClassNodekitCatalog

public static SoNodekitCatalog getClassNodekitCatalog()

Returns the SoNodekitCatalog for this class.

setDataMapping

public void setDataMapping(PbDataMapping dataMapping)

Sets a reference to a PbDataMapping object to the association color-value for coloring the bars. If this method is not called (or called passing NULL as argument), this is the data mapping defined in the current inherited state (defined with the property node PoDataMapping and its derived classes) which is used. This method is ignored if coloring = COLOR_LIST.

setFormat

public void setFormat(PbNumericDisplayFormat format)

Sets a reference to a PbNumericDisplayFormat object for the numerical display format of values of the histograms. If this method is not called (or called passing NULL as argument), this is the numerical display format defined in the current inherited state (defined with the property node PoNumericDisplayFormat) which is used.

getDataMapping

public PbDataMapping getDataMapping()

Gets a reference to a PbDataMapping object to the association color-value for coloring the bars.

getMiscTextAttr

public PbMiscTextAttr getMiscTextAttr()

Gets a reference to a PbMiscTextAttr for miscellaneous text attributes.

setMiscTextAttr

public void setMiscTextAttr(PbMiscTextAttr textAttr)

Sets a reference to a PbMiscTextAttr for miscellaneous text attributes. If this method is not called (or called passing NULL as argument), this is the miscellaneous text attributes defined in the current inherited state (defined with the property node PoMiscTextAttr) which are used.