Class RinearnGraph3D

java.lang.Object
com.rinearn.graph3d.RinearnGraph3D
public class RinearnGraph3D extends Object
リニアングラフ3D (RINEARN Graph 3D) を, Java言語で操作するためのAPIクラスです The API class for controlling RINEARN Graph 3D using the Java programming language .

  • Constructor Summary

    Constructors
    Constructor
    Description
    RinearnGraph3D()
    新しい RINEARN Graph 3D のインスタンスを生成します（新しいグラフ画面が起動します） Creates a new instance of RINEARN Graph 3D (a new graph window will launch) .

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    addKeyListener(KeyListener listener)
    グラフのスクリーン上における, キーイベントのリスナーを追加登録します Adds the listener for receiving key events occurred on the graph screen .
    void
    addMouseListener(MouseListener listener)
    グラフのスクリーン上における, マウスイベントのリスナーを追加登録します Adds the listener for receiving muse events occurred on the graph screen .
    void
    addMouseMotionListener(MouseMotionListener listener)
    グラフのスクリーン上における, マウスモーションイベントのリスナーを追加登録します Adds the listener for receiving muse motion events occurred on the graph screen .
    void
    addMouseWheelListener(MouseWheelListener listener)
    グラフのスクリーン上における, マウスホイールイベントのリスナーを追加登録します Adds the listener for receiving muse wheel events occurred on the graph screen .
    void
    addPlottingListener(RinearnGraph3DPlottingListener listener)
    再プロットが必要になった際に発行される RinearnGraph3DPlottingEvent を受け取る, RinearnGraph3DPlottingListener インタフェースを実装したイベントリスナーを追加登録します Adds the event listener implementing RinearnGraph3DPlottingListener, for receiving RinearnGraph3DPlottingEvent which occurs when plotting/replotting is required.
    void
    addWindowListener(WindowListener listener)
    ウィンドウイベントのリスナーを追加登録します Adds the listener of window events .
    void
    appendData(double[][][] x, double[][][] y, double[][][] z)
    グラフにプロットする座標値データを, 現在の内容を保持したまま追加します Appends the data to be plotted, to the currently plotted data .
    void
    appendData(double[][][] x, double[][][] y, double[][][] z, double[][][] scalarValues)
    グラフにプロットする座標値データを, 現在の内容を保持したまま追加します Appends the data to be plotted, to the currently plotted data .
    void
    appendData(double[][] x, double[][] y, double[][] z)
    グラフにプロットする座標値データを, 現在の内容を保持したまま追加します Appends the data to be plotted, to the currently plotted data .
    void
    appendData(double[][] x, double[][] y, double[][] z, double[][] scalarValues)
    グラフにプロットする座標値データを, 現在の内容を保持したまま追加します Appends the data to be plotted, to the currently plotted data .
    void
    appendData(double[] x, double[] y, double[] z)
    グラフにプロットする座標値データを, 現在の内容を保持したまま追加します Appends the data to be plotted, to the currently plotted data .
    void
    appendData(double[] x, double[] y, double[] z, double[] scalarValues)
    グラフにプロットする座標値データを, 現在の内容を保持したまま追加します Appends the data to be plotted, to the currently plotted data .
    void
    clear()
    現在プロットされているグラフやデータを消去します Clears the currently plotted graph and data .
    void
    dispose()
    このインスタンスのリソースを全て破棄します Disposes all resources of this instance .
    void
    exportImageFile(File file, double quality)
    現在のグラフの描画内容を, 画像ファイルに出力します Exports (saves) the current graph screen to an image file .
    Image
    getImage()
    現在のグラフの描画内容を保持している java.awt.Image インスタンスを返します Returns java.awt.Image instance storing the current graph image Clears the currently plotted graph and data .
    RinearnGraph3DRenderer
    getRenderer()
    グラフ画面を描画するのに使用されている3D描画エンジン（レンダラー）を返します Returns the 3D renderer, which is being used for rendering the graph image in this instance .
    boolean
    isAsynchronousPlottingEnabled()
    非同期プロット機能が有効化されているかどうかを取得します Returns if the asynchronous plotting feature is enabled .
    boolean
    isOptionSelected(RinearnGraph3DOptionItem option)
    指定されたプロットオプションが選択されているかどうかを取得します Returns if the specified plotting option is selected .
    boolean
    isXAutoRangingEnabled()
    X軸方向のグラフ範囲の自動調整機能が有効化されているかどうかを取得します Returns if the the feature to adjust the X-range automatically is enabled .
    boolean
    isYAutoRangingEnabled()
    Y軸方向のグラフ範囲の自動調整機能が有効化されているかどうかを取得します Returns if the the feature to adjust the Y-range automatically is enabled .
    boolean
    isZAutoRangingEnabled()
    Z軸方向のグラフ範囲の自動調整機能が有効化されているかどうかを取得します Returns if the the feature to adjust the Z-range automatically is enabled .
    void
    loadConfigurationFile(File file)
    設定ファイルを読み込みます Loads the configuration file .
    static void
    main(String[] args)
     
    void
    openDataFile(File file)
    座標値データファイルを開き, その内容をグラフにプロットします Opens a data file, and plots the data in it into the graph
    void
    openDataFile(File file, RinearnGraph3DDataFileFormat format)
    座標値データファイルを, 指定された書式で開き, その内容をグラフにプロットします Opens a data file in the specified format, and plots the data in it into the graph
    void
    openDataFiles(File[] files)
    複数の座標値データファイルを開き, その内容をグラフにプロットします Opens multiple data files, and plots the data in them into the graph
    void
    openDataFiles(File[] files, RinearnGraph3DDataFileFormat[] formats)
    複数の座標値データファイルを, 指定された書式で開き, その内容をグラフにプロットします Opens multiple data files in the specified formats, and plots the data in them into the graph
    void
    setAsynchronousPlottingEnabled(boolean enabled)
    非同期プロット機能の有効・無効を設定します Enables/disables the asynchronous plotting feature .
    void
    setAutoDisposingEnabled(boolean enabled)
    グラフウィンドウを閉じた際に, 自動でリソースを破棄する機能の有効/無効を設定します（デフォルトで有効） Enables/disables the automatic resource disposal feature performed when the graph window is closed (enabled by default) .
    void
    setAutoExittingEnabled(boolean enabled)
    グラフウィンドウを閉じた際に, 自動でアプリケーション全体を終了させる機能の有効/無効を設定します（デフォルトで無効） Enables/disables the feature to exit the entier application automatically, performed when the graph window is closed (disabled by default) .
    void
    setCameraDistance(double distance)
    カメラと注視点との間の距離を設定します Sets the distance between the camera and the gaze point .
    void
    setCameraMagnification(double magnification)
    カメラ倍率を設定します Sets the magnification of the camera .
    void
    setCameraPerspectiveEnabled(boolean enabled)
    カメラの遠近感の有効/無効を切り替えます（デフォルトで有効） Enables/disables the perspective of the camera (enabled by default) .
    void
    setColorBarTicks(double[] tickCoordinates, String[] tickLabels)
    Sets the coordinates (locations) and the labels (displayed text) of the scale ticks on the color bar.
    void
    setColorBarTicks(BigDecimal[] tickCoordinates, String[] tickLabels)
    Sets the coordinates (locations) and the labels (displayed text) of the scale ticks on the color bar.
    void
    setData(double[][][] x, double[][][] y, double[][][] z)
    複数系列の座標値データを設定します Set the multiple series data .
    void
    setData(double[][][] x, double[][][] y, double[][][] z, double[][][] scalarValues)
    複数系列の座標値データを, 4次元目の値と共に設定します Set the multiple series data, with 4th dimensional values .
    void
    setData(double[][] x, double[][] y, double[][] z)
    グラフに点群や面をプロットするための座標値データを設定します Set the data for plotting points or a mesh/membrane (surface) .
    void
    setData(double[][] x, double[][] y, double[][] z, double[][] scalarValues)
    グラフに点群や面をプロットするための座標値データを, 4次元目の値と共に設定します Set the data for plotting points or a mesh/membrane (surface), with 4th dimensional values .
    void
    setData(double[] x, double[] y, double[] z)
    グラフに点群や線をプロットするための座標値データを設定します Set the data for plotting points or a line .
    void
    setData(double[] x, double[] y, double[] z, double[] scalarValues)
    グラフに点群や線をプロットするための座標値データを, 4次元目の値と共に設定します Set the data for plotting points or a line, with 4th dimentional values .
    void
    setDefaultMouseListenerEnabled(boolean enabled)
    デフォルトのマウスイベントのリスナーの有効/無効を設定します Enables/disables the default mouse event listener .
    void
    setDefaultMouseMotionListenerEnabled(boolean enabled)
    デフォルトのマウスモーションイベントのリスナーの有効/無効を設定します Enables/disables the default mouse motion event listener .
    void
    setDefaultMouseWheelListenerEnabled(boolean enabled)
    デフォルトのマウスホイールイベントのリスナーの有効/無効を設定します Enables/disables the default mouse wheel event listener .
    void
    setJMenuBar(JMenuBar menuBar)
    グラフ画面のメニューバーを差し替えます Sets the menubar of the graph window .
    void
    setMenuVisible(boolean visible)
    メニューバーや右クリックメニューの表示状態を設定します Sets the visiblity of the menubar and the righ-click menu .
    void
    setOptionParameter(RinearnGraph3DOptionParameter parameter)
    プロットオプションの詳細パラメータを設定します Sets the detailed parameters of plotting options .
    void
    setOptionSelected(RinearnGraph3DOptionItem option, boolean selected)
    プロットオプションの選択状態を設定します Sets the selection status of the plotting option .
    void
    setScreenSideUIVisible(boolean visible)
    スクリーン周辺に並ぶ操作部品（各軸の長さを操作するスクロールバーなど）の表示状態を設定します Sets the visiblity of the operation components located on the side of the screen, (bars used to control the length of each axis, and so on) .
    void
    setScreenSize(int width, int height)
    グラフスクリーンのサイズを設定します Sets the location and the size of the graph window .
    void
    setWindowBounds(int x, int y, int width, int height)
    グラフ表示ウィンドウの位置とサイズを設定します Sets the location and the size of the graph window .
    void
    setWindowTitle(String title)
    グラフウィンドウのタイトルを設定します Sets tht title of the graph window .
    void
    setWindowVisible(boolean visible)
    グラフ表示ウィンドウの表示状態を設定します Gets the current visiblity of the graph window .
    void
    setXAutoRangingEnabled(boolean enabled)
    X軸方向のグラフ範囲の自動調整機能を有効化/無効化します Enables/disables the feature to adjust the X-range automatically .
    void
    setXLabel(String label)
    X軸の表記を設定します Sets the label of the X-axis .
    void
    setXRange(double min, double max)
    X軸方向のグラフ範囲を設定します Sets the X-range of the graph .
    void
    setXTicks(double[] tickCoordinates, String[] tickLabels)
    Sets the coordinates (locations) and the labels (displayed text) of the scale ticks on X axis.
    void
    setXTicks(BigDecimal[] tickCoordinates, String[] tickLabels)
    Sets the coordinates (locations) and the labels (displayed text) of the scale ticks on X axis.
    void
    setXZenithCameraAngle(double horizontalAngle, double verticalAngle)
    X軸を天頂軸見なして, カメラアングルを設定します Sets the camera angles with regarding the X-axis as the zenith axis .
    void
    setYAutoRangingEnabled(boolean enabled)
    Y軸方向のグラフ範囲の自動調整機能を有効化/無効化します Enables/disables the feature to adjust the Y-range automatically .
    void
    setYLabel(String label)
    Y軸の表記を設定します Sets the label of the Y-axis .
    void
    setYRange(double min, double max)
    Y軸方向のグラフ範囲を設定します Sets the Y-range of the graph .
    void
    setYTicks(double[] tickCoordinates, String[] tickLabels)
    Sets the coordinates (locations) and the labels (displayed text) of the scale ticks on Y axis.
    void
    setYTicks(BigDecimal[] tickCoordinates, String[] tickLabels)
    Sets the coordinates (locations) and the labels (displayed text) of the scale ticks on Y axis.
    void
    setYZenithCameraAngle(double horizontalAngle, double verticalAngle)
    Y軸を天頂軸見なして, カメラアングルを設定します Sets the camera angles with regarding the Y-axis as the zenith axis .
    void
    setZAutoRangingEnabled(boolean enabled)
    Z軸方向のグラフ範囲の自動調整機能を有効化/無効化します Enables/disables the feature to adjust the Z-range automatically .
    void
    setZLabel(String label)
    Z軸の表記を設定します Sets the label of the Z-axis .
    void
    setZRange(double min, double max)
    Z軸方向のグラフ範囲を設定します Sets the Z-range of the graph .
    void
    setZTicks(double[] tickCoordinates, String[] tickLabels)
    Sets the coordinates (locations) and the labels (displayed text) of the scale ticks on Z axis.
    void
    setZTicks(BigDecimal[] tickCoordinates, String[] tickLabels)
    Sets the coordinates (locations) and the labels (displayed text) of the scale ticks on Z axis.
    void
    setZZenithCameraAngle(double horizontalAngle, double verticalAngle)
    Z軸を天頂軸見なして, カメラアングルを設定します Sets the camera angles with regarding the Z-axis as the zenith axis .

    Methods inherited from class java.lang.Object

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

  • Constructor Details

    • RinearnGraph3D

      public RinearnGraph3D()
      新しい RINEARN Graph 3D のインスタンスを生成します（新しいグラフ画面が起動します） Creates a new instance of RINEARN Graph 3D (a new graph window will launch) .

  • Method Details

    • main

      public static void main(String[] args)

    • dispose

      public void dispose()
      このインスタンスのリソースを全て破棄します Disposes all resources of this instance . この破棄処理は, 通常, グラフの画面を閉じた時点で自動実行されます. 自動実行したくない場合は, setAutoDisposingEnabled メソッドで false を指定してください. その場合は, リソース破棄したいタイミングで, 明示的にこのメソッドをコールしてください. Normally, this disposal process is performed automatically when a user has closed the graph window of this instance. If you don't want to perform it automatically, specify false to setAutoDisposingEnabled method, and call this method explicitly when you want to dispose resources.

    • getRenderer

      public RinearnGraph3DRenderer getRenderer()
      グラフ画面を描画するのに使用されている3D描画エンジン（レンダラー）を返します Returns the 3D renderer, which is being used for rendering the graph image in this instance .
      Returns:
      3D描画エンジン（レンダラー） 3D renderer

    • openDataFile

      public void openDataFile(File file) throws FileNotFoundException, IOException
      座標値データファイルを開き, その内容をグラフにプロットします Opens a data file, and plots the data in it into the graph
      Parameters:
      file - プロットする座標値データファイル The data file to be plotted
      Throws:
      FileNotFoundException - 指定されたファイルが存在しない場合にスローされます Thrown if the specified file does not exist
      IOException - ファイルの入出力時に問題が発生した場合にスローされる可能性があります(バージョン依存) Thrown if any I/O-related problem occurred (depends on the version)

    • openDataFiles

      public void openDataFiles(File[] files) throws FileNotFoundException, IOException
      複数の座標値データファイルを開き, その内容をグラフにプロットします Opens multiple data files, and plots the data in them into the graph
      Parameters:
      files - プロットする座標値データファイル The data files to be plotted
      Throws:
      FileNotFoundException - 指定されたファイルが存在しない場合にスローされます Thrown if the specified file does not exist
      IOException - ファイルの入出力時に問題が発生した場合にスローされる可能性があります(バージョン依存) Thrown if any I/O-related problem occurred (depends on the version)

    • openDataFile

      public void openDataFile(File file, RinearnGraph3DDataFileFormat format) throws FileNotFoundException, IOException
      座標値データファイルを, 指定された書式で開き, その内容をグラフにプロットします Opens a data file in the specified format, and plots the data in it into the graph
      Parameters:
      file - プロットする座標値データファイル The data file to be plotted
      format - 座標値データファイルの書式 The format of the data file
      Throws:
      FileNotFoundException - 指定されたファイルが存在しない場合にスローされます Thrown if the specified file does not exist
      IOException - ファイルの入出力時に問題が発生した場合にスローされる可能性があります(バージョン依存) Thrown if any I/O-related problem occurred (depends on the version)

    • openDataFiles

      public void openDataFiles(File[] files, RinearnGraph3DDataFileFormat[] formats) throws FileNotFoundException, IOException
      複数の座標値データファイルを, 指定された書式で開き, その内容をグラフにプロットします Opens multiple data files in the specified formats, and plots the data in them into the graph
      Parameters:
      files - プロットする座標値データファイル The data files to be plotted
      formats - 座標値データファイルの書式 The formats of the data files
      Throws:
      FileNotFoundException - 指定されたファイルが存在しない場合にスローされます Thrown if the specified file does not exist
      IOException - ファイルの入出力時に問題が発生した場合にスローされる可能性があります(バージョン依存) Thrown if any I/O-related problem occurred (depends on the version)

    • clear

      public void clear()
      現在プロットされているグラフやデータを消去します Clears the currently plotted graph and data .

    • getImage

      public Image getImage()
      現在のグラフの描画内容を保持している java.awt.Image インスタンスを返します Returns java.awt.Image instance storing the current graph image Clears the currently plotted graph and data .
      Returns:
      現在のグラフ内容を保持するImageインスタンス The Image instance storing the current graph

    • setWindowBounds

      public void setWindowBounds(int x, int y, int width, int height)
      グラフ表示ウィンドウの位置とサイズを設定します Sets the location and the size of the graph window . 変更後のウィンドウのサイズに合わせて, グラフスクリーンのサイズも変更されます. なお, グラフスクリーンのサイズは, ウィンドウのサイズよりも若干小さくなり, その差はバージョンや環境に依存する事に注意してください. 画像出力用途などで, グラフスクリーンのサイズを明示的に指定したい場合は, 代わりに setScreenSize メソッドを使用してください. Note that, the graph screen will be resized automatically, corresponding with the size of the modified graph window. The size of the graph screen will be little smaller than the size of the graph window, and the difference between them depends on your environment and the version of RINEARN Graph 3D. When you want to set the size of the graph screen precisely, use setScreenSize method instead.
      Parameters:
      x - グラフウィンドウ左上のX座標 The X-coordinate of the left-top edge of the graph window
      y - グラフウィンドウ左上のY座標 The Y-coordinate of the left-top edge of the graph window
      width - グラフウィンドウの幅 The width the graph window
      height - グラフウィンドウの高さ The height the graph window

    • setWindowTitle

      public void setWindowTitle(String title)
      グラフウィンドウのタイトルを設定します Sets tht title of the graph window .
      Parameters:
      title - グラフウィンドウのタイトル The title of the graph window

    • setWindowVisible

      public void setWindowVisible(boolean visible)
      グラフ表示ウィンドウの表示状態を設定します Gets the current visiblity of the graph window .
      Parameters:
      visible - ウィンドウの表示状態(falseの場合に表示されない) 表示されていれば true True if the graph window is visible

    • setScreenSize

      public void setScreenSize(int width, int height)
      グラフスクリーンのサイズを設定します Sets the location and the size of the graph window . 変更後のスクリーンサイズに合わせて, グラフウィンドウのサイズも自動で変更されます. グラフウィンドウのサイズを明示的に指定したい場合は, 代わりに setWindowBounds メソッドを使用してください. Note that, the graph window will be resized automatically, corresponding with the size of the modified graph screen. When you want to set the size of the graph window explicitly, use setWindowBounds method instead.
      Parameters:
      width - グラフスクリーンの幅 The width the graph screen
      height - グラフスクリーンの高さ The height the graph screen

    • setAutoDisposingEnabled

      public void setAutoDisposingEnabled(boolean enabled)
      グラフウィンドウを閉じた際に, 自動でリソースを破棄する機能の有効/無効を設定します（デフォルトで有効） Enables/disables the automatic resource disposal feature performed when the graph window is closed (enabled by default) .
      Parameters:
      enabled - 有効化する場合にtrue, 無効化する場合に false を指定 Specify true to enable, false to disable

    • setAutoExittingEnabled

      public void setAutoExittingEnabled(boolean enabled)
      グラフウィンドウを閉じた際に, 自動でアプリケーション全体を終了させる機能の有効/無効を設定します（デフォルトで無効） Enables/disables the feature to exit the entier application automatically, performed when the graph window is closed (disabled by default) .
      Parameters:
      enabled - 有効化する場合にtrue, 無効化する場合に false を指定 Specify true to enable, false to disable

    • setXRange

      public void setXRange(double min, double max)
      X軸方向のグラフ範囲を設定します Sets the X-range of the graph .
      Parameters:
      min - X範囲の下端値 The lower limit of the X-range
      max - X範囲の上端値 The upper limit of the X-range

    • setYRange

      public void setYRange(double min, double max)
      Y軸方向のグラフ範囲を設定します Sets the Y-range of the graph .
      Parameters:
      min - Y範囲の下端値 The lower limit of the Y-range
      max - Y範囲の上端値 The upper limit of the Y-range

    • setZRange

      public void setZRange(double min, double max)
      Z軸方向のグラフ範囲を設定します Sets the Z-range of the graph .
      Parameters:
      min - Z範囲の下端値 The lower limit of the Z-range
      max - Z範囲の上端値 The upper limit of the Z-range

    • setXAutoRangingEnabled

      public void setXAutoRangingEnabled(boolean enabled)
      X軸方向のグラフ範囲の自動調整機能を有効化/無効化します Enables/disables the feature to adjust the X-range automatically .
      Parameters:
      enabled - 有効化する場合にtrue, 無効化する場合に false を指定 Specify true to enable, false to disable

    • setYAutoRangingEnabled

      public void setYAutoRangingEnabled(boolean enabled)
      Y軸方向のグラフ範囲の自動調整機能を有効化/無効化します Enables/disables the feature to adjust the Y-range automatically .
      Parameters:
      enabled - 有効化する場合にtrue, 無効化する場合に false を指定 Specify true to enable, false to disable

    • setZAutoRangingEnabled

      public void setZAutoRangingEnabled(boolean enabled)
      Z軸方向のグラフ範囲の自動調整機能を有効化/無効化します Enables/disables the feature to adjust the Z-range automatically .
      Parameters:
      enabled - 有効化する場合にtrue, 無効化する場合に false を指定 Specify true to enable, false to disable

    • isXAutoRangingEnabled

      public boolean isXAutoRangingEnabled()
      X軸方向のグラフ範囲の自動調整機能が有効化されているかどうかを取得します Returns if the the feature to adjust the X-range automatically is enabled .
      Returns:
      有効化されていれば true Returns true if the feature is enabled

    • isYAutoRangingEnabled

      public boolean isYAutoRangingEnabled()
      Y軸方向のグラフ範囲の自動調整機能が有効化されているかどうかを取得します Returns if the the feature to adjust the Y-range automatically is enabled .
      Returns:
      有効化されていれば true Returns true if the feature is enabled

    • isZAutoRangingEnabled

      public boolean isZAutoRangingEnabled()
      Z軸方向のグラフ範囲の自動調整機能が有効化されているかどうかを取得します Returns if the the feature to adjust the Z-range automatically is enabled .
      Returns:
      有効化されていれば true Returns true if the feature is enabled

    • setXLabel

      public void setXLabel(String label)
      X軸の表記を設定します Sets the label of the X-axis .
      Parameters:
      label - X軸の表記内容 The label of the X-axis

    • setYLabel

      public void setYLabel(String label)
      Y軸の表記を設定します Sets the label of the Y-axis .
      Parameters:
      label - Y軸の表記内容 The label of the Y-axis

    • setZLabel

      public void setZLabel(String label)
      Z軸の表記を設定します Sets the label of the Z-axis .
      Parameters:
      label - Z軸の表記内容 The label of the Z-axis

    • setXZenithCameraAngle

      public void setXZenithCameraAngle(double horizontalAngle, double verticalAngle)
      X軸を天頂軸見なして, カメラアングルを設定します Sets the camera angles with regarding the X-axis as the zenith axis .
      カメラアングルは, カメラが位置する方角を指定する角度の組で, 水平角と垂直角の2つの角度で構成されます. ただし, カメラ自身は常にグラフの中心の方を向いています.
      水平角は, 天頂軸（X軸）まわりのカメラの方角です. 天頂軸の正の方向から見下ろした際に, 反時計回りの回転方向を正とします. 水平角が 0 のとき, カメラはZ軸の負の方向に位置します.
      垂直角は, 天頂軸（X軸）と, カメラの存在する方向とがなす角度です. 垂直角が 0 のとき, カメラは天頂軸上に存在します.
      The camera angles are a couple of angles, the horizontal angle and the vertical angle, for specifying the location of the camera. Note that, the camera always looks to the center of the graph box.
      The horizontal angle is the direction of the camera around the zenith axis (X-axis). Take the anticlockwise rotation angle positive, with looking down from the positive direction of the zenith axis. When the horizontal angle is 0, the camera is located on the negative direction of the Z-axis.
      The vertical angle is the angle formed by a camera direction and the zenith axis (X-axis). When the vertical angle is 0, the camera is located on the positive direction of the zenith axis.
      Parameters:
      horizontalAngle - 水平角（上記参照） The horizontal angle (See the above description)
      verticalAngle - 垂直角（上記参照） The vertical angle (See the above description)

    • setYZenithCameraAngle

      public void setYZenithCameraAngle(double horizontalAngle, double verticalAngle)
      Y軸を天頂軸見なして, カメラアングルを設定します Sets the camera angles with regarding the Y-axis as the zenith axis .
      カメラアングルは, カメラが位置する方角を指定する角度の組で, 水平角と垂直角の2つの角度で構成されます. ただし, カメラ自身は常にグラフの中心の方を向いています.
      水平角は, 天頂軸（Y軸）まわりのカメラの方角です. 天頂軸の正の方向から見下ろした際に, 反時計回りの回転方向を正とします. 水平角が 0 のとき, カメラはX軸の負の方向に位置します.
      垂直角は, 天頂軸（Y軸）と, カメラの存在する方向とがなす角度です. 垂直角が 0 のとき, カメラは天頂軸上に存在します.
      The camera angles are a couple of angles, the horizontal angle and the vertical angle, for specifying the location of the camera. Note that, the camera always looks to the center of the graph box.
      The horizontal angle is the direction of the camera around the zenith axis (Y-axis). Take the anticlockwise rotation angle positive, with looking down from the positive direction of the zenith axis. When the horizontal angle is 0, the camera is located on the negative direction of the X-axis.
      The vertical angle is the angle formed by a camera direction and the zenith axis (Y-axis). When the vertical angle is 0, the camera is located on the positive direction of the zenith axis
      Parameters:
      horizontalAngle - 水平角（上記参照） The horizontal angle (See the above description)
      verticalAngle - 垂直角（上記参照） The vertical angle (See the above description)

    • setZZenithCameraAngle

      public void setZZenithCameraAngle(double horizontalAngle, double verticalAngle)
      Z軸を天頂軸見なして, カメラアングルを設定します Sets the camera angles with regarding the Z-axis as the zenith axis .
      カメラアングルは, カメラが位置する方角を指定する角度の組で, 水平角と垂直角の2つの角度で構成されます. ただし, カメラ自身は常にグラフの中心の方を向いています.
      水平角は, 天頂軸（Z軸）まわりのカメラの方角です. 天頂軸の正の方向から見下ろした際に, 反時計回りの回転方向を正とします. 水平角が 0 のとき, カメラはY軸の負の方向に位置します.
      垂直角は, 天頂軸（Z軸）と, カメラの存在する方向とがなす角度です. 垂直角が 0 のとき, カメラは天頂軸上に存在します.
      The camera angles are a couple of angles, the horizontal angle and the vertical angle, for specifying the location of the camera. Note that, the camera always looks to the center of the graph box.
      The horizontal angle is the direction of the camera around the zenith axis (Z-axis). Take the anticlockwise rotation angle positive, with looking down from the positive direction of the zenith axis. When the horizontal angle is 0, the camera is located on the negative direction of the Y-axis.
      The vertical angle is the angle formed by a camera direction and the zenith axis (Z-axis). When the vertical angle is 0, the camera is located on the positive direction of the zenith axis
      Parameters:
      horizontalAngle - 水平角（上記参照） The horizontal angle (See the above description)
      verticalAngle - 垂直角（上記参照） The vertical angle (See the above description)

    • setCameraMagnification

      public void setCameraMagnification(double magnification)
      カメラ倍率を設定します Sets the magnification of the camera .
      Parameters:
      magnification - カメラ倍率 The magnification of the camera

    • setCameraDistance

      public void setCameraDistance(double distance)
      カメラと注視点との間の距離を設定します Sets the distance between the camera and the gaze point .
      Parameters:
      distance - カメラと注視点との間の距離 The distance between the camera and the gaze point

    • setCameraPerspectiveEnabled

      public void setCameraPerspectiveEnabled(boolean enabled)
      カメラの遠近感の有効/無効を切り替えます（デフォルトで有効） Enables/disables the perspective of the camera (enabled by default) .
      Parameters:
      enabled - 有効化する場合に true, 無効化する場合に false を指定 Specify true to enable, false to disable

    • setXTicks

      public void setXTicks(BigDecimal[] tickCoordinates, String[] tickLabels)
      Sets the coordinates (locations) and the labels (displayed text) of the scale ticks on X axis.
      Parameters:
      tickCoordinates - The coordinates of the scale ticks.
      tickLabels - The labels of the scale ticks.

    • setXTicks

      public void setXTicks(double[] tickCoordinates, String[] tickLabels)
      Sets the coordinates (locations) and the labels (displayed text) of the scale ticks on X axis.
      Parameters:
      tickCoordinates - The coordinates of the scale ticks.
      tickLabels - The labels of the scale ticks.

    • setYTicks

      public void setYTicks(BigDecimal[] tickCoordinates, String[] tickLabels)
      Sets the coordinates (locations) and the labels (displayed text) of the scale ticks on Y axis.
      Parameters:
      tickCoordinates - The coordinates of the scale ticks.
      tickLabels - The labels of the scale ticks.

    • setYTicks

      public void setYTicks(double[] tickCoordinates, String[] tickLabels)
      Sets the coordinates (locations) and the labels (displayed text) of the scale ticks on Y axis.
      Parameters:
      tickCoordinates - The coordinates of the scale ticks.
      tickLabels - The labels of the scale ticks.

    • setZTicks

      public void setZTicks(BigDecimal[] tickCoordinates, String[] tickLabels)
      Sets the coordinates (locations) and the labels (displayed text) of the scale ticks on Z axis.
      Parameters:
      tickCoordinates - The coordinates of the scale ticks.
      tickLabels - The labels of the scale ticks.

    • setZTicks

      public void setZTicks(double[] tickCoordinates, String[] tickLabels)
      Sets the coordinates (locations) and the labels (displayed text) of the scale ticks on Z axis.
      Parameters:
      tickCoordinates - The coordinates of the scale ticks.
      tickLabels - The labels of the scale ticks.

    • setColorBarTicks

      public void setColorBarTicks(BigDecimal[] tickCoordinates, String[] tickLabels)
      Sets the coordinates (locations) and the labels (displayed text) of the scale ticks on the color bar.
      Parameters:
      tickCoordinates - The coordinates of the scale ticks.
      tickLabels - The labels of the scale ticks.

    • setColorBarTicks

      public void setColorBarTicks(double[] tickCoordinates, String[] tickLabels)
      Sets the coordinates (locations) and the labels (displayed text) of the scale ticks on the color bar.
      Parameters:
      tickCoordinates - The coordinates of the scale ticks.
      tickLabels - The labels of the scale ticks.

    • setOptionSelected

      public void setOptionSelected(RinearnGraph3DOptionItem option, boolean selected)
      プロットオプションの選択状態を設定します Sets the selection status of the plotting option .
      Parameters:
      option - 選択/選択解除したいオプション The option to be selected/deselected
      selected - 選択する場合に true, 選択解除する場合に false を指定 Specify true to select, false to deselect

    • isOptionSelected

      public boolean isOptionSelected(RinearnGraph3DOptionItem option)
      指定されたプロットオプションが選択されているかどうかを取得します Returns if the specified plotting option is selected .
      Parameters:
      option - プロットオプション The plotting option
      Returns:
      選択されていれば true Returns true if the option is selected

    • setOptionParameter

      public void setOptionParameter(RinearnGraph3DOptionParameter parameter)
      プロットオプションの詳細パラメータを設定します Sets the detailed parameters of plotting options .
      Parameters:
      parameter - プロットオプションの詳細パラメータ The detailed parameters of plotting options

    • setAsynchronousPlottingEnabled

      public void setAsynchronousPlottingEnabled(boolean enabled)
      非同期プロット機能の有効・無効を設定します Enables/disables the asynchronous plotting feature .
      この機能の有効・無効は, setData(double[], double[], double[]) メソッドなどを連続的に呼び出し続けて, 大量の座標値データをグラフにプロットさせ続ける場合の振る舞いに影響します.
      この機能が無効の場合は, 座標値データを渡した際, それがグラフにプロットされた後に, 呼び出し元に処理が戻ります. 渡したデータが確実にプロットされるため, プロット結果を画像ファイルに出力するような場合に適しています.
      それに対して, この機能が有効の場合は, 座標値データは一時的なバッファ領域に控えられるだけで, すぐに呼び出し元に処理が戻ります. そして, バッファされたデータは, 後の適当なタイミングでグラフにプロットされます.
      そのため, データを繰り返し高頻度で渡して, グラフをアニメーションさせてたいような場合には, この機能を有効化するのが適しています. そうする事で, メインスレッドの負荷を低減させると共に, アニメーションをスムーズにする事ができます.
      If this feature is disabled (default), when you plot the data by calling setData(double[], double[], double[]) method, the processing flow returns to the called-side after when the plotting has competed.
      In the contrast, if this feature is enabled, the processing flow returns from setData(double[], double[], double[]) method to the caller-side immediateltly with storing the data to the buffer. Then, the plotting will be performed asynchronously on the other thread, at a suitable timing.
      This feature is useful when you want to animate the graph by calling setData method repeatedly in high frequency. In such case, with enabling this feature, you can reduce the load of the main thread, and also can make the animation smooth.
      Parameters:
      enabled - 有効化する場合に true, 無効化する場合に false を指定 Specify true to enable, false to disable

    • isAsynchronousPlottingEnabled

      public boolean isAsynchronousPlottingEnabled()
      非同期プロット機能が有効化されているかどうかを取得します Returns if the asynchronous plotting feature is enabled .
      Returns:
      有効化されていれば true Returns true if the feature is enabled

    • setData

      public void setData(double[] x, double[] y, double[] z)
      グラフに点群や線をプロットするための座標値データを設定します Set the data for plotting points or a line .
      Parameters:
      x - 点群や線の節における, X値を格納する配列 X-coordinates of points, or nodes of a line
      y - 点群や線の節における, Y値を格納する配列 Y-coordinates of points, or nodes of a line
      z - 点群や線の節における, Z値を格納する配列 Z-coordinates of points, or nodes of a line

    • setData

      public void setData(double[] x, double[] y, double[] z, double[] scalarValues)
      グラフに点群や線をプロットするための座標値データを, 4次元目の値と共に設定します Set the data for plotting points or a line, with 4th dimentional values .
      Parameters:
      x - 点群や線の節における, X値を格納する配列 X-coordinates of points, or nodes of a line
      y - 点群や線の節における, Y値を格納する配列 Y-coordinates of points, or nodes of a line
      z - 点群や線の節における, Z値を格納する配列 Z-coordinates of points, or nodes of a line
      scalarValues - 点群や線の節における, 4次元目の値を格納する配列 4th dimentional values of points, or nodes of a line

    • setData

      public void setData(double[][] x, double[][] y, double[][] z)
      グラフに点群や面をプロットするための座標値データを設定します Set the data for plotting points or a mesh/membrane (surface) .
      Parameters:
      x - メッシュ格子点における, X値を格納する配列 X-coordinates of grid points of a mesh/membrane
      y - メッシュ格子点における, Y値を格納する配列 Y-coordinates of grid ponts of a mesh/membrane
      z - メッシュ格子点における, Z値を格納する配列 Z-coordinates of grid points of a mesh/membrane

    • setData

      public void setData(double[][] x, double[][] y, double[][] z, double[][] scalarValues)
      グラフに点群や面をプロットするための座標値データを, 4次元目の値と共に設定します Set the data for plotting points or a mesh/membrane (surface), with 4th dimensional values .
      Parameters:
      x - メッシュ格子点における, X値を格納する配列 X-coordinates of grid points of a mesh/membrane
      y - メッシュ格子点における, Y値を格納する配列 Y-coordinates of grid ponts of a mesh/membrane
      z - メッシュ格子点における, Z値を格納する配列 Z-coordinates of grid points of a mesh/membrane
      scalarValues - 点群や線の節における, 4次元目の値を格納する配列 4th dimentional values of points, or nodes of a line

    • setData

      public void setData(double[][][] x, double[][][] y, double[][][] z)
      複数系列の座標値データを設定します Set the multiple series data .
      配列の左端の次元は, 系列のインデックスと解釈されます. 中央の次元が 1 の場合は, 各系列は線状のデータと見なされ, 右端の次元がその節のインデックスとなります. 中央の次元が 2 以上の場合は, 各系列はメッシュ状のデータと見なされ, 中央と右の次元が格子点のインデックスとなります.
      The left-side index is regarded as the series index. If the length of the center dimension equals to 1, the data of each series represents a linear data, and the right-side index is regarded as the node index. If the length of the center dimension is larger than 2, the data of each series represents a mesh data, and the center and the right-side indices are regarded as the grid point indices.
      Parameters:
      x - X値を格納する配列 X-coordinates
      y - Y値を格納する配列 Y-coordinates
      z - Z値を格納する配列 Z-coordinates

    • setData

      public void setData(double[][][] x, double[][][] y, double[][][] z, double[][][] scalarValues)
      複数系列の座標値データを, 4次元目の値と共に設定します Set the multiple series data, with 4th dimensional values .
      配列の左端の次元は, 系列のインデックスと解釈されます. 中央の次元が 1 の場合は, 各系列は線状のデータと見なされ, 右端の次元がその節のインデックスとなります. 中央の次元が 2 以上の場合は, 各系列はメッシュ状のデータと見なされ, 中央と右の次元が格子点のインデックスとなります.
      The left-side index is regarded as the series index. If the length of the center dimension equals to 1, the data of each series represents a linear data, and the right-side index is regarded as the node index. If the length of the center dimension is larger than 2, the data of each series represents a mesh data, and the center and the right-side indices are regarded as the grid point indices.
      Parameters:
      x - X値を格納する配列 X-coordinates
      y - Y値を格納する配列 Y-coordinates
      z - Z値を格納する配列 Z-coordinates
      scalarValues - 4次元目の値を格納する配列 4th dimentional values

    • appendData

      public void appendData(double[] x, double[] y, double[] z)
      グラフにプロットする座標値データを, 現在の内容を保持したまま追加します Appends the data to be plotted, to the currently plotted data .
      なお, この機能は, 現時点では非同期プロットに対応していません.
      Note that, in this version, this feature does not support the asynchronous plotting.
      Parameters:
      x - X値を格納する配列 X-coordinates
      y - Y値を格納する配列 Y-coordinates
      z - Z値を格納する配列 Z-coordinates

    • appendData

      public void appendData(double[] x, double[] y, double[] z, double[] scalarValues)
      グラフにプロットする座標値データを, 現在の内容を保持したまま追加します Appends the data to be plotted, to the currently plotted data .
      なお, この機能は, 現時点では非同期プロットに対応していません.
      Note that, in this version, this feature does not support the asynchronous plotting.
      Parameters:
      x - X値を格納する配列 X-coordinates
      y - Y値を格納する配列 Y-coordinates
      z - Z値を格納する配列 Z-coordinates
      scalarValues - 4次元目の値 4th dimensional values

    • appendData

      public void appendData(double[][] x, double[][] y, double[][] z)
      グラフにプロットする座標値データを, 現在の内容を保持したまま追加します Appends the data to be plotted, to the currently plotted data .
      なお, この機能は, 現時点では非同期プロットに対応していません.
      Note that, in this version, this feature does not support the asynchronous plotting.
      Parameters:
      x - X値を格納する配列 X-coordinates
      y - Y値を格納する配列 Y-coordinates
      z - Z値を格納する配列 Z-coordinates

    • appendData

      public void appendData(double[][] x, double[][] y, double[][] z, double[][] scalarValues)
      グラフにプロットする座標値データを, 現在の内容を保持したまま追加します Appends the data to be plotted, to the currently plotted data .
      なお, この機能は, 現時点では非同期プロットに対応していません.
      Note that, in this version, this feature does not support the asynchronous plotting.
      Parameters:
      x - X値を格納する配列 X-coordinates
      y - Y値を格納する配列 Y-coordinates
      z - Z値を格納する配列 Z-coordinates
      scalarValues - 4次元目の値 4th dimensional values

    • appendData

      public void appendData(double[][][] x, double[][][] y, double[][][] z)
      グラフにプロットする座標値データを, 現在の内容を保持したまま追加します Appends the data to be plotted, to the currently plotted data .
      なお, この機能は, 現時点では非同期プロットに対応していません.
      Note that, in this version, this feature does not support the asynchronous plotting.
      Parameters:
      x - X値を格納する配列 X-coordinates
      y - Y値を格納する配列 Y-coordinates
      z - Z値を格納する配列 Z-coordinates

    • appendData

      public void appendData(double[][][] x, double[][][] y, double[][][] z, double[][][] scalarValues)
      グラフにプロットする座標値データを, 現在の内容を保持したまま追加します Appends the data to be plotted, to the currently plotted data .
      なお, この機能は, 現時点では非同期プロットに対応していません.
      Note that, in this version, this feature does not support the asynchronous plotting.
      Parameters:
      x - X値を格納する配列 X-coordinates
      y - Y値を格納する配列 Y-coordinates
      z - Z値を格納する配列 Z-coordinates
      scalarValues - 4次元目の値 4th dimensional values

    • loadConfigurationFile

      public void loadConfigurationFile(File file) throws FileNotFoundException, IOException
      設定ファイルを読み込みます Loads the configuration file .
      Parameters:
      file - 設定ファイル The configuration file
      Throws:
      FileNotFoundException - 指定されたファイルが存在しない場合にスローされます Thrown if the specified file does not exist
      IOException - ファイルの入出力時に問題が発生した場合にスローされる可能性があります(バージョン依存) Thrown if any I/O-related problem occurred (depends on the version)

    • exportImageFile

      public void exportImageFile(File file, double quality) throws IOException
      現在のグラフの描画内容を, 画像ファイルに出力します Exports (saves) the current graph screen to an image file .
      画像形式は, ファイルの拡張子で判断されます. 現時点では「JPEG(.jpg)」, 「PNG(.png)」, 「BMP(.bmp)」の画像形式のみがサポートされています.
      The image file format is automatically determined from the extension of the file to be saved. In this version, JPEG (.jpg), PNG (.png), and BMP (.bmp) formats are available.
      Parameters:
      file - 保存する画像ファイル The image file to be saved
      quality - 画像の品質（0.0 から 1.0 の範囲で指定） The quality of the image (from 0.0 to 1.0)
      Throws:
      IOException - 出力に失敗した場合にスローされます Thrown if it failed to save the image file

    • setMenuVisible

      public void setMenuVisible(boolean visible)
      メニューバーや右クリックメニューの表示状態を設定します Sets the visiblity of the menubar and the righ-click menu .
      Parameters:
      visible - 表示可能にする場合に true, 非表示にする場合に false を指定 Specify true to set visible, false to set invisible

    • setScreenSideUIVisible

      public void setScreenSideUIVisible(boolean visible)
      スクリーン周辺に並ぶ操作部品（各軸の長さを操作するスクロールバーなど）の表示状態を設定します Sets the visiblity of the operation components located on the side of the screen, (bars used to control the length of each axis, and so on) .
      Parameters:
      visible - 表示可能にする場合に true, 非表示にする場合に false を指定 Specify true to set visible, false to set invisible

    • setJMenuBar

      public void setJMenuBar(JMenuBar menuBar)
      グラフ画面のメニューバーを差し替えます Sets the menubar of the graph window .
      Parameters:
      menuBar - グラフ画面のメニューバー The menubar of the graph window

    • addPlottingListener

      public void addPlottingListener(RinearnGraph3DPlottingListener listener)
      再プロットが必要になった際に発行される RinearnGraph3DPlottingEvent を受け取る, RinearnGraph3DPlottingListener インタフェースを実装したイベントリスナーを追加登録します Adds the event listener implementing RinearnGraph3DPlottingListener, for receiving RinearnGraph3DPlottingEvent which occurs when plotting/replotting is required. .
      Parameters:
      listener - 登録するイベントリスナー The event listener to be added

    • addWindowListener

      public void addWindowListener(WindowListener listener)
      ウィンドウイベントのリスナーを追加登録します Adds the listener of window events .
      ウィンドウイベントのリスナーは, ユーザーがグラフ画面を閉じた際に, 独自の終了時処理を行わせたい場合などに有用です.
      If you want to implement original process to be performed when the graph window is closed, implement it as a window event listener and register it by this method.
      Parameters:
      listener - 登録するイベントリスナー The event listener to be added

    • addKeyListener

      public void addKeyListener(KeyListener listener)
      グラフのスクリーン上における, キーイベントのリスナーを追加登録します Adds the listener for receiving key events occurred on the graph screen .
      Parameters:
      listener - 登録するイベントリスナー The event listener to be added

    • addMouseListener

      public void addMouseListener(MouseListener listener)
      グラフのスクリーン上における, マウスイベントのリスナーを追加登録します Adds the listener for receiving muse events occurred on the graph screen .
      Parameters:
      listener - 登録するイベントリスナー The event listener to be added

    • setDefaultMouseListenerEnabled

      public void setDefaultMouseListenerEnabled(boolean enabled)
      デフォルトのマウスイベントのリスナーの有効/無効を設定します Enables/disables the default mouse event listener .
      Parameters:
      enabled - 有効化する場合は true, 無効化する場合は false を指定 Specify true to enable, false to disable

    • addMouseMotionListener

      public void addMouseMotionListener(MouseMotionListener listener)
      グラフのスクリーン上における, マウスモーションイベントのリスナーを追加登録します Adds the listener for receiving muse motion events occurred on the graph screen .
      Parameters:
      listener - 登録するイベントリスナー The event listener to be added

    • setDefaultMouseMotionListenerEnabled

      public void setDefaultMouseMotionListenerEnabled(boolean enabled)
      デフォルトのマウスモーションイベントのリスナーの有効/無効を設定します Enables/disables the default mouse motion event listener .
      Parameters:
      enabled - 有効化する場合は true, 無効化する場合は false を指定 Specify true to enable, false to disable

    • addMouseWheelListener

      public void addMouseWheelListener(MouseWheelListener listener)
      グラフのスクリーン上における, マウスホイールイベントのリスナーを追加登録します Adds the listener for receiving muse wheel events occurred on the graph screen .
      Parameters:
      listener - 登録するイベントリスナー The event listener to be added

    • setDefaultMouseWheelListenerEnabled

      public void setDefaultMouseWheelListenerEnabled(boolean enabled)
      デフォルトのマウスホイールイベントのリスナーの有効/無効を設定します Enables/disables the default mouse wheel event listener .
      Parameters:
      enabled - 有効化する場合は true, 無効化する場合は false を指定 Specify true to enable, false to disable