ControllerHost.java

package com.bitwig.extension.controller.api;

import com.bitwig.extension.api.Host;
import com.bitwig.extension.callback.ConnectionEstablishedCallback;
import com.bitwig.extension.callback.DataReceivedCallback;
import com.bitwig.extension.controller.ControllerExtensionDefinition;
import com.bitwig.extension.controller.HardwareDeviceMatcher;

import jdk.nashorn.api.scripting.JSObject;

@SuppressWarnings("restriction")
public interface ControllerHost extends Host
{
   void restart();

   void loadAPI(int version);

   void useBetaApi();

   boolean shouldFailOnDeprecatedUse();

   void setShouldFailOnDeprecatedUse(boolean value);

   void load(String path);

   boolean platformIsWindows();

   boolean platformIsMac();

   boolean platformIsLinux();

   void defineController(String vendor, String name, String version, String uuid, String author);

   void defineMidiPorts(int numInports, int numOutports);

   MidiIn getMidiInPort(int index);

   MidiOut getMidiOutPort(int index);

   HardwareDevice hardwareDevice(int index);

   void addDeviceNameBasedDiscoveryPair(String[] inputs, String[] outputs);

   @Deprecated
   void defineSysexIdentityReply(String reply);

   Preferences getPreferences();

   DocumentState getDocumentState();

   NotificationSettings getNotificationSettings();

   Project getProject();

   Transport createTransport();

   Groove createGroove();

   Application createApplication();

   Arranger createArranger();

   Arranger createArranger(final int window);

   Mixer createMixer();

   Mixer createMixer(final String panelLayout);

   Mixer createMixer(final int window);

   Mixer createMixer(final String panelLayout, final int window);

   TrackBank createTrackBank(final int numTracks, final int numSends, final int numScenes);

   TrackBank createTrackBank(
      final int numTracks,
      final int numSends,
      final int numScenes,
      final boolean hasFlatTrackList);

   TrackBank createMainTrackBank(final int numTracks, final int numSends, final int numScenes);

   TrackBank createEffectTrackBank(final int numTracks, final int numScenes);

   MasterTrack createMasterTrack(final int numScenes);

   @Deprecated
   CursorTrack createArrangerCursorTrack(final int numSends, final int numScenes);

   @Deprecated
   CursorTrack createCursorTrack(final String name, final int numSends, final int numScenes);

   CursorTrack createCursorTrack(
      final String id,
      String name,
      final int numSends,
      final int numScenes,
      boolean shouldFollowSelection);

   SceneBank createSceneBank(final int numScenes);

   @Deprecated
   CursorDevice createEditorCursorDevice();

   @Deprecated
   CursorDevice createEditorCursorDevice(int numSends);

   @Deprecated
   Clip createCursorClip(final int gridWidth, final int gridHeight);

   Clip createLauncherCursorClip(final int gridWidth, final int gridHeight);

   Clip createArrangerCursorClip(final int gridWidth, final int gridHeight);

   UserControlBank createUserControls(final int numControllers);

   @Deprecated
   void scheduleTask(JSObject callback, Object[] args, long delay);

   void scheduleTask(Runnable callback, long delay);

   void requestFlush();

   void println(String s);

   void errorln(String s);

   void showPopupNotification(String text);

   RemoteSocket createRemoteConnection(String name, int defaultPort);

   void connectToRemoteHost(String host, int port, ConnectionEstablishedCallback callback);

   void sendDatagramPacket(String host, int port, byte[] data);

   boolean addDatagramPacketObserver(String name, int port, DataReceivedCallback callback);

   @Deprecated
   void defineController(String vendor, String name, String version, String uuid);

   @Deprecated
   Transport createTransportSection();

   CursorTrack createCursorTrack(final int numSends, final int numScenes);

   @Deprecated
   Groove createGrooveSection();

   @Deprecated
   Application createApplicationSection();

   @Deprecated
   Arranger createArrangerSection(final int screenIndex);

   @Deprecated
   Mixer createMixerSection(final String perspective, final int screenIndex);

   @Deprecated
   TrackBank createTrackBankSection(final int numTracks, final int numSends, final int numScenes);

   @Deprecated
   TrackBank createMainTrackBankSection(final int numTracks, final int numSends, final int numScenes);

   @Deprecated
   TrackBank createEffectTrackBankSection(final int numTracks, final int numScenes);

   @Deprecated
   CursorTrack createCursorTrackSection(final int numSends, final int numScenes);

   @Deprecated
   Track createMasterTrackSection(final int numScenes);

   @Deprecated
   Clip createCursorClipSection(final int gridWidth, final int gridHeight);

   @Deprecated
   CursorDevice createCursorDeviceSection(final int numControllers);

   @Deprecated
   CursorDevice createCursorDevice();

   @Deprecated
   UserControlBank createUserControlsSection(final int numControllers);

   @Deprecated
   void defineSysexDiscovery(String request, String reply);

   PopupBrowser createPopupBrowser();

   BeatTimeFormatter defaultBeatTimeFormatter();

   void setDefaultBeatTimeFormatter(BeatTimeFormatter formatter);

   BeatTimeFormatter createBeatTimeFormatter(
      final String separator,
      final int barsLen,
      final int beatsLen,
      final int subdivisionLen,
      final int ticksLen);
}