org.jfree.chart.util.Args Java Examples

/**
 * Sets the anchor point used to align a block at its (x, y) location and sends a
 * {@link RendererChangeEvent} to all registered listeners.
 *
 * @param anchor the anchor.
 *
 * @see #getBlockAnchor()
 */
public void setBlockAnchor(RectangleAnchor anchor) {
  Args.nullNotPermitted(anchor, "anchor");
  if (this.blockAnchor.equals(anchor)) {
    return; // no change
  }
  this.blockAnchor = anchor;
  updateOffsets();
  fireChangeEvent();
}
 

/**
 * Paints a chart with scaling options
 *
 * @param chart
 * @param info
 * @param out
 * @param width
 * @param height
 * @param resolution
 * @return BufferedImage of a given chart with scaling to resolution
 * @throws IOException
 */
private static BufferedImage paintScaledChartToBufferedImage(JFreeChart chart,
    ChartRenderingInfo info, OutputStream out, int width, int height, int resolution,
    int bufferedIType) throws IOException {
  Args.nullNotPermitted(out, "out");
  Args.nullNotPermitted(chart, "chart");

  double scaleX = resolution / 72.0;
  double scaleY = resolution / 72.0;

  double desiredWidth = width * scaleX;
  double desiredHeight = height * scaleY;
  double defaultWidth = width;
  double defaultHeight = height;
  boolean scale = false;

  // get desired width and height from somewhere then...
  if ((scaleX != 1) || (scaleY != 1)) {
    scale = true;
  }

  BufferedImage image = new BufferedImage((int) desiredWidth, (int) desiredHeight, bufferedIType);
  Graphics2D g2 = image.createGraphics();

  if (scale) {
    AffineTransform saved = g2.getTransform();
    g2.transform(AffineTransform.getScaleInstance(scaleX, scaleY));
    chart.draw(g2, new Rectangle2D.Double(0, 0, defaultWidth, defaultHeight), info);
    g2.setTransform(saved);
    g2.dispose();
  } else {
    chart.draw(g2, new Rectangle2D.Double(0, 0, defaultWidth, defaultHeight), info);
  }
  return image;
}
 

/**
 * Add an overlay to the canvas.
 *
 * @param overlay  the overlay ({@code null} not permitted).
 */
public void addOverlay(OverlayFX overlay) {
    Args.nullNotPermitted(overlay, "overlay");
    this.overlays.add(overlay);
    overlay.addChangeListener(this);
    draw();
}
 

/**
 * Removes an overlay from the canvas.
 *
 * @param overlay  the overlay to remove ({@code null} not permitted).
 */
public void removeOverlay(OverlayFX overlay) {
    Args.nullNotPermitted(overlay, "overlay");
    boolean removed = this.overlays.remove(overlay);
    if (removed) {
        overlay.removeChangeListener(this);
        draw();
    }
}
 

/**
 * Sets the anchor point used to align a block at its (x, y) location and sends a
 * {@link RendererChangeEvent} to all registered listeners.
 *
 * @param anchor the anchor.
 *
 * @see #getBlockAnchor()
 */
public void setBlockAnchor(RectangleAnchor anchor) {
  Args.nullNotPermitted(anchor, "anchor");
  if (this.blockAnchor.equals(anchor)) {
    return; // no change
  }
  this.blockAnchor = anchor;
  updateOffsets();
  fireChangeEvent();
}
 

/**
 * Paints a chart with scaling options
 * 
 * @param chart
 * @param info
 * @param out
 * @param width
 * @param height
 * @param resolution
 * @return BufferedImage of a given chart with scaling to resolution
 * @throws IOException
 */
private static BufferedImage paintScaledChartToBufferedImage(JFreeChart chart,
    ChartRenderingInfo info, OutputStream out, int width, int height, int resolution,
    int bufferedIType) throws IOException {
  Args.nullNotPermitted(out, "out");
  Args.nullNotPermitted(chart, "chart");

  double scaleX = resolution / 72.0;
  double scaleY = resolution / 72.0;

  double desiredWidth = width * scaleX;
  double desiredHeight = height * scaleY;
  double defaultWidth = width;
  double defaultHeight = height;
  boolean scale = false;

  // get desired width and height from somewhere then...
  if ((scaleX != 1) || (scaleY != 1)) {
    scale = true;
  }

  BufferedImage image = new BufferedImage((int) desiredWidth, (int) desiredHeight, bufferedIType);
  Graphics2D g2 = image.createGraphics();

  if (scale) {
    AffineTransform saved = g2.getTransform();
    g2.transform(AffineTransform.getScaleInstance(scaleX, scaleY));
    chart.draw(g2, new Rectangle2D.Double(0, 0, defaultWidth, defaultHeight), info);
    g2.setTransform(saved);
    g2.dispose();
  } else {
    chart.draw(g2, new Rectangle2D.Double(0, 0, defaultWidth, defaultHeight), info);
  }
  return image;
}
 

/**
 * Paints a chart with scaling options
 * 
 * @param chart
 * @param info
 * @param out
 * @param width
 * @param height
 * @param resolution
 * @return BufferedImage of a given chart with scaling to resolution
 * @throws IOException
 */
private static BufferedImage paintScaledChartToBufferedImage(JFreeChart chart,
    ChartRenderingInfo info, OutputStream out, int width, int height, int resolution,
    int bufferedIType) throws IOException {
  Args.nullNotPermitted(out, "out");
  Args.nullNotPermitted(chart, "chart");

  double scaleX = resolution / 72.0;
  double scaleY = resolution / 72.0;

  double desiredWidth = width * scaleX;
  double desiredHeight = height * scaleY;
  double defaultWidth = width;
  double defaultHeight = height;
  boolean scale = false;

  // get desired width and height from somewhere then...
  if ((scaleX != 1) || (scaleY != 1)) {
    scale = true;
  }

  BufferedImage image = new BufferedImage((int) desiredWidth, (int) desiredHeight, bufferedIType);
  Graphics2D g2 = image.createGraphics();

  if (scale) {
    AffineTransform saved = g2.getTransform();
    g2.transform(AffineTransform.getScaleInstance(scaleX, scaleY));
    chart.draw(g2, new Rectangle2D.Double(0, 0, defaultWidth, defaultHeight), info);
    g2.setTransform(saved);
    g2.dispose();
  } else {
    chart.draw(g2, new Rectangle2D.Double(0, 0, defaultWidth, defaultHeight), info);
  }
  return image;
}
 

/**
 * Removes an overlay from the canvas.
 *
 * @param overlay  the overlay to remove ({@code null} not permitted).
 *
 * @since 1.0.20
 */
public void removeOverlay(TaOverlayFX overlay) {
    Args.nullNotPermitted(overlay, "overlay");
    boolean removed = this.overlays.remove(overlay);
    if (removed) {
        overlay.removeChangeListener(this);
        draw();
    }
}
 

/**
 * Creates a new instance.  The modifier keys are used to select a 
 * mouse handler to be the current "live" handler (when a handler is
 * used as an auxiliary handler, the modifier keys are not relevant).
 * 
 * @param id  the handler id ({@code null} not permitted).
 * @param altKey  require ALT key modifier?
 * @param ctrlKey  require ALT key modifier?
 * @param metaKey  require ALT key modifier?
 * @param shiftKey   require ALT key modifier?
 */
public AbstractMouseHandlerFX(String id, boolean altKey, boolean ctrlKey, 
        boolean metaKey, boolean shiftKey) {
    Args.nullNotPermitted(id, "id");
    this.id = id;
    this.enabled = true;
    this.altKey = altKey;
    this.ctrlKey = ctrlKey;
    this.metaKey = metaKey;
    this.shiftKey = shiftKey;
}
 

/**
     * Creates a new instance.  The modifier keys are used to select a
     * mouse handler to be the current "live" handler (when a handler is
     * used as an auxiliary handler, the modifier keys are not relevant).
     *
     * @param id  the handler id ({@code null} not permitted).
     * @param altKey  require ALT key modifier?
     * @param ctrlKey  require ALT key modifier?
     * @param metaKey  require ALT key modifier?
     * @param shiftKey   require ALT key modifier?
     */
public TaAbstractMouseHandlerFX(String id, boolean altKey, boolean ctrlKey,
    boolean metaKey, boolean shiftKey) {
    Args.nullNotPermitted(id, "id");
    this.id = id;
    this.enabled = true;
    this.altKey = altKey;
    this.ctrlKey = ctrlKey;
    this.metaKey = metaKey;
    this.shiftKey = shiftKey;
}
 

/**
 * Add an overlay to the canvas.
 *
 * @param overlay  the overlay ({@code null} not permitted).
 *
 * @since 1.0.20
 */
public void addOverlay(TaOverlayFX overlay) {
    Args.nullNotPermitted(overlay, "overlay");
    this.overlays.add(overlay);
    overlay.addChangeListener(this);
    draw();
}
 

/**
 * Sets the paint scale used by the renderer and sends a {@link RendererChangeEvent} to all
 * registered listeners.
 *
 * @param scale the scale ({@code null} not permitted).
 *
 * @see #getPaintScale()
 * @since 1.0.4
 */
public void setPaintScale(PaintScale scale) {
  Args.nullNotPermitted(scale, "scale");
  this.paintScale = scale;
  fireChangeEvent();
}
 

/**
 * Sets the org.sjwimmer.tacharting.chart to be displayed by this viewer.
 *
 * @param chart  the org.sjwimmer.tacharting.chart ({@code null} not permitted).
 */
public void setChart(JFreeChart chart) {
    Args.nullNotPermitted(chart, "org/sjwimmer/tacharting/chart");
    this.canvas.setChart(chart);
}
 

/**
 * Registers a listener to receive {@link ChartMouseEvent} notifications.
 *
 * @param listener  the listener ({@code null} not permitted).
 */
public void addChartMouseListener(ChartMouseListenerFX listener) {
    Args.nullNotPermitted(listener, "listener");
    this.chartMouseListeners.add(listener);
}
 

/**
 * Removes a listener from the list of objects listening for chart mouse
 * events.
 *
 * @param listener  the listener.
 */
public void removeChartMouseListener(ChartMouseListenerFX listener) {
    Args.nullNotPermitted(listener, "listener");
    this.canvas.removeChartMouseListener(listener);
}
 

/**
 * Registers a listener to receive {@link ChartMouseEvent} notifications
 * from the canvas embedded in this viewer.
 *
 * @param listener  the listener ({@code null} not permitted).
 */
public void addChartMouseListener(ChartMouseListenerFX listener) {
    Args.nullNotPermitted(listener, "listener");
    this.canvas.addChartMouseListener(listener);
}
 

/**
 * Sets the chart to be displayed by this viewer.
 * 
 * @param chart  the chart ({@code null} not permitted). 
 */
public void setChart(JFreeChart chart) {
    Args.nullNotPermitted(chart, "chart");
    this.canvas.setChart(chart);
}
 

/**
 * Registers a listener to receive {@link ChartMouseEvent} notifications.
 *
 * @param listener  the listener ({@code null} not permitted).
 */
public void addChartMouseListener(ChartMouseListenerFX listener) {
    Args.nullNotPermitted(listener, "listener");
    this.chartMouseListeners.add(listener);
}
 

/**
 * Sets the paint scale used by the renderer and sends a {@link RendererChangeEvent} to all
 * registered listeners.
 *
 * @param scale the scale ({@code null} not permitted).
 *
 * @see #getPaintScale()
 * @since 1.0.4
 */
public void setPaintScale(PaintScale scale) {
  Args.nullNotPermitted(scale, "scale");
  this.paintScale = scale;
  fireChangeEvent();
}