ControllerHost.java

package com.bitwig.extension.controller.api;

import java.util.UUID;
import java.util.function.DoubleConsumer;
import java.util.function.Supplier;

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;

@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);

   DetailEditor createDetailEditor();

   DetailEditor createDetailEditor(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(Object 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);

   HardwareSurface createHardwareSurface();

   HardwareActionMatcher createOrHardwareActionMatcher(
      HardwareActionMatcher matcher1,
      HardwareActionMatcher matcher2);

   RelativeHardwareValueMatcher createOrRelativeHardwareValueMatcher(
      RelativeHardwareValueMatcher matcher1,
      RelativeHardwareValueMatcher matcher2);

   AbsoluteHardwareValueMatcher createOrAbsoluteHardwareValueMatcher(
      AbsoluteHardwareValueMatcher matcher1,
      AbsoluteHardwareValueMatcher matcher2);

   MidiExpressions midiExpressions();

   HardwareActionBindable createAction(Runnable runnable, Supplier<String> descriptionProvider);

   HardwareActionBindable createAction(
      DoubleConsumer actionPressureConsumer,
      Supplier<String> descriptionProvider);

   RelativeHardwarControlBindable createRelativeHardwareControlStepTarget(
      HardwareActionBindable stepForwardsAction,
      HardwareActionBindable stepBackwardsAction);

   RelativeHardwarControlBindable createRelativeHardwareControlAdjustmentTarget(
      DoubleConsumer adjustmentConsumer);

   AbsoluteHardwarControlBindable createAbsoluteHardwareControlAdjustmentTarget(
      DoubleConsumer adjustmentConsumer);

   void deleteObjects(String undoName, DeleteableObject... objects);

   void deleteObjects(DeleteableObject... objects);

   DeviceMatcher createInstrumentMatcher();

   DeviceMatcher createAudioEffectMatcher();

   DeviceMatcher createNoteEffectMatcher();

   DeviceMatcher createBitwigDeviceMatcher(UUID id);

   DeviceMatcher createVST2DeviceMatcher(int id);

   DeviceMatcher createVST3DeviceMatcher(String id);

   DeviceMatcher createActiveDeviceMatcher();

   DeviceMatcher createFirstDeviceInChainMatcher();

   DeviceMatcher createLastDeviceInChainMatcher();

   DeviceMatcher createOrDeviceMatcher(DeviceMatcher... deviceMatchers);

   DeviceMatcher createAndDeviceMatcher(DeviceMatcher... deviceMatchers);

   DeviceMatcher createNotDeviceMatcher(DeviceMatcher deviceMatcher);
}