Class PoLogAxis

All Implemented Interfaces:
SafeDisposable

public class PoLogAxis extends PoCartesianAxis
Class to build a logarithmic axis. This class builds a logarithmic axis. This axis will be generated between the point start to the point end. The graduations will be in the plane given by the user (cf type field). For instance, it can be used for building a logarithmic axis in the plane XY, with the first decade graduation being 10E3 and the last decade graduation being 10E8. Graduation values are: 10E3, 10E4, 10E5, ...,10E8): gradStart = 3, gradEnd = 8 plane = XY and maxGradNum > 8. If maxGradNum = 4, the graduations values are 10E3, 10E5 and 10E7. If the fields gradStart and gradEnd are equal, the fields start and end are used to define the graduation values.

File format/default:

PoLogAxis {

    gradVisibility VISILITY_DEPEND
    gradPosition GRAD_DEPEND
    gradPath PATH_DEPEND
    gradFontName ""
    gradFontSize 0
    gradDistAxis 0
    gradAddStringVisibility false
    gradAddString ""
    marginType REL_MARGIN
    marginStart 0
    marginEnd 0
    maxGradNum 10
    titleVisibility VISILITY_DEPEND
    titlePosition TITLE_DEPEND
    titlePath PATH_DEPEND
    titleFontName ""
    titleFontSize 0
    titleDistAxis 0
    titleString ""
    gridVisibility VISILITY_DEPEND
    gridLengthGradSide 0
    gridLengthGradOtherSide 1
    arrowVisibility VISIBILITY_DEPEND
    arrowHeight 0.03
    arrowLength 0.05
    tickVisibility VISIBILITY_DEPEND
    tickPosition TICK_GRAD_SIDE
    tickMainLength 0
    tickSubLength 0
    tickSubDef PERIOD_MAIN_TICK
    tickNumOrPeriod 1
    tickFirstGrad 1
    tickLastGrad 1
    reverseFlag AXIS_REVERSE_DEPEND
    start 0 0 0
    end 1
    type XY
    gradStart 0
    gradEnd 0
    decadeListDef DECADE_LIST_AUTO
    decadeList 2
    tenPowerRep TEN_POWER_POW10
    decadeRep DECADE_NONE
    decadeFontName ""
    decadeFontSize 0
    multFactorPosition MULT_FACTOR_END
    multFactorDistAxis 0
}

<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN"> <html> <head> <link REL="stylesheet" TYPE="text/css" HREF="../../stylesheet.css" TITLE="Style"> <title></title> </head> <BODY> <h1></h1> <h4> <A NAME="Heading553">CATALOG PARTS</A></h4> <ul><b>PoLogAxis</b> {</ul> <ul><ul><b>Separator</b> <tt>alternateRep</tt> (from PoBase) {<br> </ul></ul> <ul><ul><ul><b>AppearanceKit</b> <tt>appearance</tt> (from PoBase)</ul></ul></ul> <ul><ul><ul><i>Specifies the appearance of all the kit. By default lightModel.model=BASE_COLOR.</i></ul></ul></ul> <ul><ul><ul><b>MatrixTransform</b> <tt>domainTransform</tt> (from PoBase)</ul></ul></ul> <ul><ul><ul><i>Corresponds to the domain transformation.</i></ul></ul></ul> <ul><ul><ul><b>MatrixTransform</b> <tt>transform</tt> (from PoAxis)</ul></ul></ul> <ul><ul><ul><i>Corresponds to the axis plane orientation matrix.</i></ul></ul></ul> <ul><ul><ul><ul></ul></ul></ul></ul> <ul><ul><ul><b>Separator</b> <tt>bodySep</tt> (from PoAxis) {</ul></ul></ul> <ul><ul><ul><i>Contains properties and shapes to draw the body of the axis.</i></ul></ul></ul> <ul><ul><ul><ul><b>AppearanceKit</b> <tt>bodyApp </tt>(from PoAxis)</ul></ul></ul></ul> <ul><ul><ul><ul><i>Specifies the appearance of the body of the axis.</i></ul></ul></ul></ul> <ul><ul><ul><ul><b>Group</b> <tt>body </tt>(from PoAxis)</ul></ul></ul></ul> <ul><ul><ul><ul><i>Contains a SoLineSet shape to draw the body of the axis.</i></ul></ul></ul></ul> <ul><ul><ul>}<br> <br> <b>Separator</b> <tt>arrowSep</tt> (from PoAxis) {</ul></ul></ul> <ul><ul><ul><i>Contains properties and shapes to draw the arrow.</i></ul></ul></ul> <ul><ul><ul><ul><b>AppearanceKit</b> <tt>arrowApp </tt>(from PoAxis)</ul></ul></ul></ul> <ul><ul><ul><ul><i>Specifies the appearance of the arrow.</i></ul></ul></ul></ul> <ul><ul><ul><ul><b>Group</b> <tt>arrow </tt>(from PoAxis)</ul></ul></ul></ul> <ul><ul><ul><ul><i>Contains a SoFaceSet shape to draw the arrow.</i></ul></ul></ul></ul> <ul><ul><ul>}<br> <br> <b>Separator</b> <tt>subGradTickSep</tt> (from PoAxis) {</ul></ul></ul> <ul><ul><ul><i>Contains properties and shapes to draw sub-graduation tick.</i></ul></ul></ul> <ul><ul><ul><ul><b>AppearanceKit</b> <tt>subGradTickApp </tt>(from PoAxis)</ul></ul></ul></ul> <ul><ul><ul><ul><i>Specifies the appearance of sub-graduation tick.</i></ul></ul></ul></ul> <ul><ul><ul><ul><b>Group</b> <tt>subGradTick </tt>(from PoAxis)</ul></ul></ul></ul> <ul><ul><ul><ul><i>Contains a SoLineSet shape to draw sub-graduation tick.</i></ul></ul></ul></ul> <ul><ul><ul>}<br> <br> <b>Separator</b> <tt>subGradGridSep</tt> (from PoAxis){</ul></ul></ul> <ul><ul><ul><i>Contains properties and shapes to draw sub-graduation grid.</i></ul></ul></ul> <ul><ul><ul><ul><b>AppearanceKit</b> <tt>subGradGridApp </tt>(from PoAxis)</ul></ul></ul></ul> <ul><ul><ul><ul><i>Specifies the appearance of sub-graduation grid.</i></ul></ul></ul></ul> <ul><ul><ul><ul><b>Group</b> <tt>subGradGrid </tt>(from PoAxis)</ul></ul></ul></ul> <ul><ul><ul><ul><i>Contains a SoLineSet shape to draw sub-graduation grid.</i></ul></ul></ul></ul> <ul><ul><ul>}<br> <br> <b>Separator</b> <tt>mainGradTickSep</tt> (from PoAxis){</ul></ul></ul> <ul><ul><ul><i>Contains properties and shapes to draw main-graduation tick.</i></ul></ul></ul> <ul><ul><ul><ul><b>AppearanceKit</b> <tt>mainGradTickApp </tt>(from PoAxis)</ul></ul></ul></ul> <ul><ul><ul><ul><i>Specifies the appearance of main-graduation tick.</i></ul></ul></ul></ul> <ul><ul><ul><ul><b>Group</b> <tt>mainGradTick </tt>(from PoAxis)</ul></ul></ul></ul> <ul><ul><ul><ul><i>Contains a SoLineSet shape to draw main-graduation tick.</i></ul></ul></ul></ul> <ul><ul><ul>}<br> <br> <b>Separator</b> <tt>mainGradGridSep</tt> (from PoAxis){</ul></ul></ul> <ul><ul><ul><i>Contains properties and shapes to draw main-graduation grid.</i></ul></ul></ul> <ul><ul><ul><ul><b>AppearanceKit</b> <tt>mainGradGridApp </tt>(from PoAxis)</ul></ul></ul></ul> <ul><ul><ul><ul><i>Specifies the appearance of main-graduation grid.</i></ul></ul></ul></ul> <ul><ul><ul><ul><b>Group</b> <tt>mainGradGrid </tt>(from PoAxis)</ul></ul></ul></ul> <ul><ul><ul><ul><i>Contains a SoLineSet shape to draw main-graduation grid.</i></ul></ul></ul></ul> <ul><ul><ul>}<br> <br> <b>Separator</b> <tt>mainGradTextSep</tt> (from PoAxis) {</ul></ul></ul> <ul><ul><ul><i>Contains properties and shapes to draw main-graduation text.</i></ul></ul></ul> <ul><ul><ul><ul><b>AppearanceKit</b> <tt>mainGradTextApp </tt>(from PoAxis)</ul></ul></ul></ul> <ul><ul><ul><ul><i>Specifies the appearance of main-graduation text. By default drawStyle.style=LINES. font.size and font.name are set when the kit is rebuilt.</i></ul></ul></ul></ul> <ul><ul><ul><ul><b>Group</b> <tt>mainGradText </tt>(from PoAxis)</ul></ul></ul></ul> <ul><ul><ul><ul><i>Contains a list of SoAnnoText3 shapes to draw main-graduation text.</i></ul></ul></ul></ul> <ul><ul><ul>}<br> <br> <b>Separator</b> <tt>titleSep</tt> (from PoAxis) {</ul></ul></ul> <ul><ul><ul><i>Contains properties and shapes to draw title text.</i></ul></ul></ul> <ul><ul><ul><ul><b>AppearanceKit</b> <tt>titleApp </tt>(from PoAxis)</ul></ul></ul></ul> <ul><ul><ul><ul><i>Specifies the appearance of title text. By default drawStyle.style=LINES. font.size and font.name are set when the kit is rebuilt.</i></ul></ul></ul></ul> <ul><ul><ul><ul><b>Group</b> <tt>title </tt>(from PoAxis)</ul></ul></ul></ul> <ul><ul><ul><ul><i>Contains a SoAnnoText3 shape to draw title.</i></ul></ul></ul></ul> <ul><ul><ul>}<br> <br> <b>Separator</b> <tt>multFactorSep</tt> {</ul></ul></ul> <ul><ul><ul><i>Contains properties and shapes to draw multiplicative factor.</i></ul></ul></ul> <ul><ul><ul><ul><b>AppearanceKit</b> <tt>multFactorApp</tt></ul></ul></ul></ul> <ul><ul><ul><ul><i>Specifies the appearance of multiplicative factor. By default drawStyle.style=LINES. font.size and font.name are set when the kit is rebuilt.</i></ul></ul></ul></ul> <ul><ul><ul><ul><b>Group</b> <tt>multFactor</tt></ul></ul></ul></ul> <ul><ul><ul><ul><i>Contains a list of SoAnnoText3 shape to draw multiplicative factor.</i></ul></ul></ul></ul> <ul><ul><ul>}<br> <br> <b>Separator</b> <tt>decadeTextSep </tt>{</ul></ul></ul> <ul><ul><ul><i>Contains properties and shapes to draw decade text.</i></ul></ul></ul> <ul><ul><ul><ul><b>AppearanceKit</b> <tt>decadeTextApp</tt></ul></ul></ul></ul> <ul><ul><ul><ul><i>Specifies the appearance of decade text. By default drawStyle.style=LINES. font.size and font.name are set when the kit is rebuilt.</i></ul></ul></ul></ul> <ul><ul><ul><ul><b>Group</b> <tt>decadeText</tt></ul></ul></ul></ul> <ul><ul><ul><ul><i>Contains a list of SoAnnoText3 shape to draw decade text.</i></ul></ul></ul></ul> <ul><ul><ul>}</ul></ul></ul> <ul><ul>}</ul></ul> <ul>}</ul> <ul><ul><br> </ul></ul> </body> </html>

  • Field Details

    • decadeList

      public final SoMFUShort decadeList
      List of graduations between two power of ten graduations (decade graduations). For each integer value i of decadeList, 2 <= i <= 9, only the 8 first values of decadeList are used. This field is used to build the axis only if decadeListDef = DECADE_LIST_NON_AUTO.
    • decadeListDef

      public final SoSFEnum<PoLogAxis.DecadeListDefs> decadeListDef
      Specifies if the list of decade graduations is given by the user or is automatically computed.
    • tenPowerRep

      public final SoSFEnum<PoLogAxis.TenPowGradReps> tenPowerRep
      Defines the representation of power of ten graduations. .
    • decadeRep

      public final SoSFEnum<PoLogAxis.DecadeReps> decadeRep
      Defines the representation of the decade graduations between two power of ten graduations.
    • decadeFontName

      public final SoSFString decadeFontName
      Decade font name. If the font is equal to its default value, the font used is the font of the current miscellaneous text attributes (cf PoAxis description).
    • decadeFontSize

      public final SoSFFloat decadeFontSize
      Decade graduations font size. If this value is <= 0, the font size is fixed at 0.04 if the graduations do not cross each other. This value is a percentage of the current domain (cf PoBase description).
    • multFactorPosition

      public final SoSFEnum<PoLogAxis.MultFactorPositions> multFactorPosition
      Position of the multiplicative factor.
    • multFactorDistAxis

      public final SoSFFloat multFactorDistAxis
      Distance from the multiplicative factor to the axis. This value is a percentage of the current domain (cf PoBase description). If this value is <= 0, the distance is automatically calculated.
    • maxGradNum

      public final SoSFUShort maxGradNum
      Maximum number of logarithmic graduations displayed. For example, a logarithmic axis with range 0 to 100 will have 101 graduations if this value is > 100. But that would generate an axis with too many small illegible graduations. If maxGradNum is set to 10, less than 10 logarithmic graduations are displayed like 10E0, 10E10, 10E20, ... 10E90.

      In order to make the axis as legible as possible, when some main logarithmic graduations are filtered out by this field, no decade graduations are displayed.

      Default value is 10.

  • Constructor Details

    • PoLogAxis

      public PoLogAxis(SbVec3f _start, float _end, PoCartesianAxis.Types _type, float _gradStart, float _gradEnd)
      Calls PoLogAxis(_start, _end, _type, _gradStart, _gradEnd, PoLogAxis.DecadeListDefs.valueOf( PoLogAxis.DecadeListDefs.DECADE_LIST_AUTO.getValue() ), (short[])null).
    • PoLogAxis

      public PoLogAxis(SbVec3f _start, float _end, PoCartesianAxis.Types _type, float _gradStart, float _gradEnd, PoLogAxis.DecadeListDefs _decadeListDef)
      Calls PoLogAxis(_start, _end, _type, _gradStart, _gradEnd, _decadeListDef, (short[])null).
    • PoLogAxis

      public PoLogAxis(SbVec3f _start, float _end, PoCartesianAxis.Types _type)
      Calls PoLogAxis(_start, _end, _type, PoLogAxis.DecadeListDefs.valueOf( PoLogAxis.DecadeListDefs.DECADE_LIST_AUTO.getValue() ), (short[])null).
    • PoLogAxis

      public PoLogAxis(SbVec3f _start, float _end, PoCartesianAxis.Types _type, PoLogAxis.DecadeListDefs _decadeListDef)
      Calls PoLogAxis(_start, _end, _type, _decadeListDef, (short[])null).
    • PoLogAxis

      public PoLogAxis(SbVec3f _start, float _end, PoCartesianAxis.Types _type, float _gradStart, float _gradEnd, PoLogAxis.DecadeListDefs _decadeListDef, short[] _decadeList)
      Constructor.

      Since:
      Open Inventor 9.5.1

    • PoLogAxis

      public PoLogAxis()
      Constructor.
    • PoLogAxis

      public PoLogAxis(SbVec3f _start, float _end, PoCartesianAxis.Types _type, PoLogAxis.DecadeListDefs _decadeListDef, short[] _decadeList)
      Constructor.
  • Method Details

    • getMultFactor

      public PoLogAxis.MultFactor getMultFactor()
      Returns the current multiplicative factor attributes (those computed can be different from the associated fields).
    • getLogGrad

      public PoLogAxis.GradAttributes getLogGrad()
      Returns the current logarithmic graduations attributes (those computed can be different from the associated fields).
    • getClassNodekitCatalog

      public static SoNodekitCatalog getClassNodekitCatalog()
      Returns the SoNodekitCatalog for this class.