tapspace/lib/components/Item/rotatable.js

A zoomable user interface lib for web apps

const Pinch = require('../../interaction/Pinch')

module.exports = function (options) {
  // @Item:rotatable(options)
  // @Item:rotateable
  //
  // A rotatable item can be turned around a pivot point.
  //
  // Parameters:
  //   options, various types:
  //     a boolean, set false to disable the ability to rotate.
  //     an optional object with properties:
  //       pivot
  //         optional Point. Specifies a fixed point about which
  //         .. the item can be rotated.
  //         .. If the point is relative to
  //         .. the inner basis of the item, then the rotation center follows
  //         .. possible translations of the item.
  //
  // Return
  //   this, for chaining
  //

  // Find existing interaction
  let pinch = this.getInteraction('pinch')

  // False to disable.
  if (options === false) {
    if (pinch) {
      pinch.disableRotation()
      if (!pinch.hasAnyFreedom()) {
        this.removeInteraction('pinch')
      }
    }
    return this
  }

  // Normalize options
  if (!options) {
    options = {}
  }

  if (pinch) {
    pinch.enableRotation(options.pivot)
  } else {
    pinch = new Pinch(this, this)
    pinch.enableRotation(options.pivot)
    this.addInteraction('pinch', pinch)
  }

  return this
}