arranger_view.h

/*
 * Copyright © 2018-2023 Synthstrom Audible Limited
 *
 * This file is part of The Synthstrom Audible Deluge Firmware.
 *
 * The Synthstrom Audible Deluge Firmware is free software: you can redistribute it and/or modify it under the
 * terms of the GNU General Public License as published by the Free Software Foundation,
 * either version 3 of the License, or (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
 * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
 * See the GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License along with this program.
 * If not, see <https://www.gnu.org/licenses/>.
 */
 
#pragma once
 
#include "definitions_cxx.hpp"
#include "gui/colour/colour.h"
#include "gui/views/timeline_view.h"
 
class ClipInstance;
class InstrumentClip;
class Instrument;
class ParamManagerForTimeline;
class Instrument;
class ArpeggiatorSettings;
class NoteRow;
class Kit;
class Action;
class Drum;
class ModelStack;
class ModelStackWithNoteRow;
 
class ArrangerView final : public TimelineView {
public:
    ArrangerView() = default;
    bool opened() override;
    void focusRegained() override;
    ActionResult padAction(int32_t x, int32_t y, int32_t velocity) override;
    ActionResult handleEditPadAction(int32_t x, int32_t y, int32_t velocity);
    ActionResult handleStatusPadAction(int32_t y, int32_t velocity, UI* ui);
    ActionResult handleAuditionPadAction(int32_t y, int32_t velocity, UI* ui);
    ActionResult buttonAction(deluge::hid::Button b, bool on, bool inCardRoutine) override;
    ActionResult verticalEncoderAction(int32_t offset, bool inCardRoutine) override;
    void selectEncoderAction(int8_t offset) override;
    void modEncoderAction(int32_t whichModEncoder, int32_t offset) override;
 
    void repopulateOutputsOnScreen(bool doRender = true);
    bool renderSidebar(uint32_t whichRows, RGB image[][kDisplayWidth + kSideBarWidth],
                       uint8_t occupancyMask[][kDisplayWidth + kSideBarWidth]) override;
    bool renderMainPads(uint32_t whichRows, RGB image[][kDisplayWidth + kSideBarWidth],
                        uint8_t occupancyMask[][kDisplayWidth + kSideBarWidth], bool drawUndefinedArea = true) override;
    bool renderRow(ModelStack* modelStack, int32_t yDisplay, int32_t xScroll, uint32_t xZoom, RGB* thisImage,
                   uint8_t thisOccupancyMask[], int32_t renderWidth);
    void editPadAction(int32_t x, int32_t y, bool on);
    ActionResult horizontalEncoderAction(int32_t offset) override;
    uint32_t getMaxLength() override;
    uint32_t getMaxZoom() override;
    void graphicsRoutine() override;
    [[nodiscard]] int32_t getNavSysId() const override { return NAVIGATION_ARRANGEMENT; }
    void navigateThroughPresets(int32_t offset);
    void notifyActiveClipChangedOnOutput(Output* output);
    ActionResult timerCallback() override;
    void reassessWhetherDoingAutoScroll(int32_t pos = -1);
    void autoScrollOnPlaybackEnd();
    bool initiateXScroll(int32_t newScrollPos);
    [[nodiscard]] bool supportsTriplets() const override { return false; }
    bool putDraggedClipInstanceInNewPosition(Output* output);
    void tellMatrixDriverWhichRowsContainSomethingZoomable() override;
    void scrollFinished() override;
    void notifyPlaybackBegun() override;
    uint32_t getGreyedOutRowsNotRepresentingOutput(Output* output) override;
    void playbackEnded() override;
    void clipNeedsReRendering(Clip* clip) override;
    void exitSubModeWithoutAction(UI* ui = nullptr);
    bool transitionToArrangementEditor();
    bool getGreyoutColsAndRows(uint32_t* cols, uint32_t* rows) override;
    void setLedStates();
    ActionResult verticalScrollOneSquare(int32_t direction);
    ActionResult horizontalScrollOneSquare(int32_t direction);
 
    void renderOLED(deluge::hid::display::oled_canvas::Canvas& canvas) override;
 
    Output* outputsOnScreen[kDisplayHeight]{};
    int8_t yPressedEffective{};
    int8_t yPressedActual{};
    int8_t xPressed{};
    bool actionOnDepress{};
    uint32_t pressTime{};
    int32_t desiredLength{};
    int32_t originallyPressedClipActualLength{};
    bool pressedHead{};
 
    int32_t pressedClipInstanceIndex{};
    Output* pressedClipInstanceOutput{};
    int32_t pressedClipInstanceXScrollWhenLastInValidPosition{};
    bool pressedClipInstanceIsInValidPosition{};
 
    bool blinkOn{};
 
    bool doingAutoScrollNow = false;
    bool mustRedrawTickSquares{};
 
    int32_t autoScrollNumSquaresBehind{};
 
    int32_t lastInteractedOutputIndex = 0;
    int32_t lastInteractedPos = -1;
    uint8_t lastInteractedSection = 0;
    ClipInstance* lastInteractedClipInstance = nullptr;
 
    int32_t lastInteractedArrangementPos = -1;
 
    int32_t lastTickSquare{};
 
    int32_t xScrollWhenPlaybackStarted{};
 
    // ui
    UIType getUIType() override { return UIType::ARRANGER; }
 
    Clip* getClipForSelection();
 
    void requestRendering(UI* ui, uint32_t whichMainRows = 0xFFFFFFFF, uint32_t whichSideRows = 0xFFFFFFFF);
 
private:
    RGB getMutePadColor(int32_t yDisplay);
    RGB getAuditionPadColor(int32_t yDisplay);
 
    void changeOutputType(OutputType newOutputType);
    void moveClipToSession();
    void auditionPadAction(bool on, int32_t y, UI* ui);
    void beginAudition(Output* output);
    void endAudition(Output* output, bool evenIfPlaying = false);
    ModelStackWithNoteRow* getNoteRowForAudition(ModelStack* modelStack, Kit* kit);
    Drum* getDrumForAudition(Kit* kit);
    void setNoSubMode();
    void outputActivated(Output* output);
    void outputDeactivated(Output* output);
    void transitionToClipView(ClipInstance* clipInstance);
    void deleteClipInstance(Output* output, int32_t clipInstanceIndex, ClipInstance* clipInstance, Action* action,
                            bool clearingWholeArrangement = false);
    void clearArrangement();
    void interactWithClipInstance(Output* output, int32_t yDisplay, ClipInstance* clipInstance);
    void rememberInteractionWithClipInstance(int32_t yDisplay, ClipInstance* clipInstance);
    void deleteOutput();
    void auditionEnded();
    void goToSongView();
    void changeOutputToAudio();
    bool renderRowForOutput(ModelStack* modelStack, Output* output, int32_t xScroll, uint32_t xZoom, RGB* image,
                            uint8_t occupancyMask[], int32_t renderWidth, int32_t ignoreI);
    Instrument* createNewInstrument(OutputType newOutputType, bool* instrumentAlreadyInSong);
    uint32_t doActualRender(int32_t xScroll, uint32_t xZoom, uint32_t whichRows, RGB* image,
                            uint8_t occupancyMask[][kDisplayWidth + kSideBarWidth], int32_t renderWidth,
                            int32_t imageWidth);
    void renderDisplay();
 
    // edit pad actions
    void cloneClipInstanceToWhite(Output* output, int32_t x, int32_t y, int32_t xScroll);
    void createNewClipInstance(Output* output, int32_t x, int32_t y, int32_t squareStart, int32_t squareEnd,
                               int32_t xScroll);
    ClipInstance* createClipInstance(Output* output, int32_t y, int32_t squareStart);
    Clip* getClipForNewClipInstance(Output* output, Output* lastOutputInteractedWith, ClipInstance* lastClipInstance);
    Clip* getClipFromSection(Output* output);
    void adjustClipInstanceLength(Output* output, int32_t x, int32_t y, int32_t squareStart, int32_t squareEnd);
    void deleteClipInstance(Output* output, ClipInstance* clipInstance);
    void createNewClipForClipInstance(Output* output, ClipInstance* clipInstance);
    void recordEditPadPress(Output* output, ClipInstance* clipInstance, int32_t x, int32_t y, int32_t xScroll);
};
 
extern ArrangerView arrangerView;