object API {

  var selectedMode = Modes.BALANCED
  var currentState = State.NOT_READY

  /**
   * Moves everything at scanner to according positions, then takes picture and returns file of png data.
   * This method blocks until all hardware movements are done and picture taken
   * @return File with png data of new frame or null if scanning was completed or canceled by user or hardware failure
   */
  def nextFrame:File

  /**
   * Call this method before every scan. This method ensures that hardware is in right position and
   * eventually blocks until it gets there. <br>
   * When not called, no exception will be intentionally thrown, but keep in mind that some exceptions like problem with communicating with hardware or so can be thrown. It is your responsibility to ensure machine is ready before every scan!
   * @param mode mode you will use while scanning
   */
  def makeReady(mode: Modes)


  /**
   * Gets rotation of plate.
   * @return Rotation of plate. In degrees.
   */
  def plateRotation: Float

  /**
   * Gets rotation of laser.<br>
   * Value 0 means pointed parallel with camera center ray<br>
   * Value 90 means pointed directly at the camera
   * @return Rotation of plate. In degrees.
   */
  def laserRotation: Float

}