Class StyleKeys

java.lang.Object
uk.ac.starlink.ttools.plot2.config.StyleKeys

public class StyleKeys extends Object
Contains many common config keys and associated utility methods.
Since:
25 Feb 2013
Author:
Mark Taylor
  • Field Details

    • MARKER_SHAPE

      public static final ConfigKey<MarkerShape> MARKER_SHAPE
      Config key for marker shape.
    • SIZE

      public static final ConfigKey<Integer> SIZE
      Config key for marker size.
    • XYSHAPE

      public static final ConfigKey<BasicXYShape> XYSHAPE
      Config key for XY shape.
    • COLOR

      public static final ConfigKey<Color> COLOR
      Config key for style colour.
    • AUX_OPAQUE

      public static final ConfigKey<Double> AUX_OPAQUE
      Config key for the opacity limit of auxiliary shaded plots.
    • TRANSPARENT_LEVEL

      public static final ConfigKey<Double> TRANSPARENT_LEVEL
      Config key for transparency level of adaptive transparent plots.
    • TRANSPARENCY

      public static final ConfigKey<Double> TRANSPARENCY
      Config key for "normal" transparency - it's just 1-alpha.
    • DASH

      public static final ConfigKey<float[]> DASH
      Config key for line dash style.
    • GRID_COLOR

      public static final ConfigKey<Color> GRID_COLOR
      Config key for axis grid colour.
    • AXLABEL_COLOR

      public static final ConfigKey<Color> AXLABEL_COLOR
      Config key for axis label colour.
    • BAR_FORM

      public static final ConfigKey<BarStyle.Form> BAR_FORM
      Config key for histogram bar style.
    • FILL

      public static final ConfigKey<FillMode> FILL
      Config key for KDE fill mode.
    • CUMULATIVE

      public static final ConfigKey<Cumulation> CUMULATIVE
      Config key for cumulative histogram mode.
    • NORMALISE

      public static final ConfigKey<Normalisation> NORMALISE
      Config key for histogram normalisation mode on generic axis.
    • ANTIALIAS

      public static final ConfigKey<Boolean> ANTIALIAS
      Config key for line antialiasing.
    • GRID_ANTIALIAS

      public static final ConfigKey<Boolean> GRID_ANTIALIAS
      Config key for axis grid antialiasing.
    • ANCHOR

      public static final ConfigKey<Anchor> ANCHOR
      Config key for text anchor positioning.
    • LEVEL_MODE

      public static final ConfigKey<LevelMode> LEVEL_MODE
      Config key for scaling level mode.
    • VECTOR_SHAPE

      public static final MultiPointConfigKey VECTOR_SHAPE
      Config key for vector marker style.
    • ELLIPSE_SHAPE

      public static final MultiPointConfigKey ELLIPSE_SHAPE
      Config key for ellipse marker style.
    • ERROR_SHAPE_1D

      public static final MultiPointConfigKey ERROR_SHAPE_1D
      Config key for 1d (vertical) error marker style.
    • ERROR_SHAPE_2D

      public static final MultiPointConfigKey ERROR_SHAPE_2D
      Config key for 2d error marker style.
    • ERROR_SHAPE_3D

      public static final MultiPointConfigKey ERROR_SHAPE_3D
      Config key for 3d error marker style.
    • AUX_CROWD

      public static final ConfigKey<Double> AUX_CROWD
      Config key for aux axis tick crowding.
    • SHADE_LOW

      public static final ConfigKey<Double> SHADE_LOW
      Config key for aux shader lower limit.
    • SHADE_HIGH

      public static final ConfigKey<Double> SHADE_HIGH
      Config key for aux shader upper limit.
    • SHADE_SUBRANGE

      public static final ConfigKey<Subrange> SHADE_SUBRANGE
      Config key for aux shader subrange.
    • AUX_NULLCOLOR

      public static final ConfigKey<Color> AUX_NULLCOLOR
      Config key for aux null colour.
    • SCALE

      public static final ConfigKey<Double> SCALE
      Config key for scaling of markers in data space.
    • SCALE_PIX

      public static final ConfigKey<Double> SCALE_PIX
      Config key for scaling of markers in pixel space.
    • AUTOSCALE

      public static final ConfigKey<Boolean> AUTOSCALE
      Config key for autoscale flag for markers in data space.
    • AUTOSCALE_PIX

      public static final ConfigKey<Boolean> AUTOSCALE_PIX
      Config key for autoscale flag for markers in pixel space.
    • LABEL

      public static final ConfigKey<String> LABEL
      Config key for a layer label string.
    • SHOW_LABEL

      public static final ConfigKey<Boolean> SHOW_LABEL
      Config key for legend inclusion flag.
    • MINOR_TICKS

      public static final ConfigKey<Boolean> MINOR_TICKS
      Config key for minor tick drawing key.
    • ZOOM_FACTOR

      public static final ConfigKey<Double> ZOOM_FACTOR
      Config key for zoom factor.
    • CAPTIONER

      public static final CaptionerKeySet CAPTIONER
      Config key set for axis and general captioner.
    • AUX_RAMP

      public static final RampKeySet AUX_RAMP
      Config key set for global Aux axis colour ramp.
    • DENSITY_RAMP

      public static final RampKeySet DENSITY_RAMP
      Config key set for density point shading.
  • Method Details

    • getStrokeKeys

      public static ConfigKey<?>[] getStrokeKeys()
      Returns a list of config keys for configuring a line-drawing stroke. Pass a map with values for these to the createStroke method.
      Returns:
      stroke key list
      See Also:
    • createStroke

      public static Stroke createStroke(ConfigMap config, int cap, int join)
      Obtains a line drawing stroke based on a config map. The keys used are those returned by getStrokeKeys. The line join and cap policy must be provided.
      Parameters:
      config - config map
      cap - one of BasicStroke's CAP_* constants
      join - one of BasicStroke's JOIN_* constants
      Returns:
      stroke
    • createMarkerShapeKey

      public static ConfigKey<MarkerShape> createMarkerShapeKey(ConfigMeta meta, MarkerShape dflt)
      Returns a config key for choosing marker shape.
      Parameters:
      meta - metadata
      dflt - default shape value
      Returns:
      new key
    • createMarkSizeKey

      public static ConfigKey<Integer> createMarkSizeKey(ConfigMeta meta, int dflt)
      Returns a config key for choosing marker size in pixels.
      Parameters:
      meta - metadata
      dflt - default size value
      Returns:
      new key
    • createCrowdKey

      public static ConfigKey<Double> createCrowdKey(ConfigMeta meta)
      Returns an axis tick mark crowding config key.
      Parameters:
      meta - metadata
      Returns:
      new key
    • createAxisLabelKey

      public static ConfigKey<String> createAxisLabelKey(String axName)
      Returns an axis labelling config key.
      Parameters:
      axName - axis name
      Returns:
      new key
    • createNullColorKey

      public static ConfigKey<Color> createNullColorKey(String axname, String axName)
      Returns a key for acquiring a colour used in place of a shading ramp colour in case that the input data is null.
      Parameters:
      axname - short form of axis name, used in text parameter names
      axName - long form of axis name, used in descriptions
      Returns:
      new key
    • createOpaqueKey

      public static ConfigKey<Double> createOpaqueKey(int dfltValue)
      Returns a key for acquiring an opacity value; the value is the number of pixels that have to be overplotted on a given position to completely obscure the background.
      Parameters:
      dfltValue - default opacity; the lowest sensible value is 1 (no transparency)
      Returns:
      new key
    • createThicknessKey

      public static ConfigKey<Integer> createThicknessKey(int dfltThick)
      Returns a config key for line thickness with a given default value.
      Parameters:
      dfltThick - default value for line width in pixels
      Returns:
      new config key
    • createPaintThicknessKey

      public static ConfigKey<Integer> createPaintThicknessKey(ConfigMeta meta, int max)
      Returns a config key for painting stroke thickness. Zero corresponds to one pixel wide.
      Parameters:
      meta - metadata
      max - maximum value
      Returns:
      config key
    • getAlphaColor

      public static Color getAlphaColor(ConfigMap config, ConfigKey<Color> colorKey, ConfigKey<Double> transparencyKey)
      Returns a colour specified by a basic colour key and a transparency key.
      Parameters:
      config - config map
      colorKey - key for colour, for instance COLOR
      transparencyKey - key for 1-alpha, for instance TRANSPARENCY
    • createAuxShaders

      public static ClippedShader[] createAuxShaders()
      Returns a list of shaders suitable for aux axis shading.
      Returns:
      shaders