Deluge Firmware 1.3.0
Build date: 2025.04.16
Loading...
Searching...
No Matches
deluge::gui::menu_item::UnpatchedParam Class Reference
Inheritance diagram for deluge::gui::menu_item::UnpatchedParam:
Collaboration diagram for deluge::gui::menu_item::UnpatchedParam:

Public Member Functions

 UnpatchedParam (l10n::String newName, l10n::String title, int32_t newP)
 
 UnpatchedParam (l10n::String newName, int32_t newP)
 
bool usesAffectEntire () override
 Claim support for Kit AFFECT_ENTIRE editing.
 
void readCurrentValue () override
 Like readValueAgain, but does not redraw.
 
void writeCurrentValue () override
 
ParamDescriptor getLearningThing () final
 
int32_t getMaxValue () const override
 
int32_t getMinValue () const override
 
MenuItemselectButtonPress () final
 Handle a select button press.
 
ActionResult buttonAction (deluge::hid::Button b, bool on, bool inCardRoutine) final
 Handle an arbitrary button.
 
void horizontalEncoderAction (int32_t offset) final
 Handle horizontal encoder movement.
 
void unlearnAction () final
 Unlearn the parameter controlled by this menu.
 
bool allowsLearnMode () final
 Used by SoundEditor to determine if the current menu item can accept MIDI learning.
 
void learnKnob (MIDICable *cable, int32_t whichKnob, int32_t modKnobMode, int32_t midiChannel) final
 
deluge::modulation::params::Kind getParamKind ()
 
uint32_t getParamIndex ()
 
ParamSetgetParamSet () final
 
ModelStackWithAutoParamgetModelStack (void *memory) final
 
int32_t getParamValue ()
 
- Public Member Functions inherited from deluge::gui::menu_item::Param
 Param (int32_t newP=0)
 
virtual uint8_t getP ()
 
MenuItemselectButtonPress ()
 
ActionResult buttonAction (deluge::hid::Button b, bool on, bool inCardRoutine)
 
void horizontalEncoderAction (int32_t offset)
 
ModelStackWithAutoParamgetModelStackWithParam (void *memory) override
 
- Public Member Functions inherited from deluge::gui::menu_item::Automation
MenuItemselectButtonPress ()
 
ActionResult buttonAction (deluge::hid::Button b, bool on, bool inCardRoutine)
 
virtual PatchSource getPatchSource ()
 
void selectAutomationViewParameter (bool clipMinder)
 
void handleAutomationViewParameterUpdate ()
 MenuItem::updateAutomationViewParameter forwards here when necessary.
 
- Public Member Functions inherited from deluge::gui::menu_item::Integer
void selectEncoderAction (int32_t offset) override
 Handle select encoder movement.
 
- Public Member Functions inherited from deluge::gui::menu_item::Number
void drawBar (int32_t yTop, int32_t marginL, int32_t marginR=-1)
 
void renderInHorizontalMenu (int32_t startX, int32_t width, int32_t startY, int32_t height) override
 
- Public Member Functions inherited from deluge::gui::menu_item::Value< int32_t >
 MenuItem ()
 
 MenuItem (deluge::l10n::String newName, deluge::l10n::String newTitle=deluge::l10n::String::EMPTY_STRING)
 
 MenuItem (const MenuItem &other)=delete
 
 MenuItem (const MenuItem &&other)=delete
 
void beginSession (MenuItem *navigatedBackwardFrom) override
 Begin an editing session with this menu item.
 
void selectEncoderAction (int32_t offset) override
 Handle select encoder movement.
 
void readValueAgain () override
 Re-read the value from the system and redraw the display to match.
 
bool selectEncoderActionEditsInstrument () final
 Used by the sound editor to mark the current instrument as edited when the select encoder is scrolled.
 
void setValue (int32_t value)
 
void setValue (E value)
 
int32_t getValue ()
 
getValue ()
 
 MenuItem ()
 
 MenuItem (deluge::l10n::String newName, deluge::l10n::String newTitle=deluge::l10n::String::EMPTY_STRING)
 
 MenuItem (const MenuItem &other)=delete
 
 MenuItem (const MenuItem &&other)=delete
 
- Public Member Functions inherited from MenuItem
 MenuItem (deluge::l10n::String newName, deluge::l10n::String newTitle=deluge::l10n::String::EMPTY_STRING)
 
 MenuItem (const MenuItem &other)=delete
 
 MenuItem (const MenuItem &&other)=delete
 
MenuItemoperator= (const MenuItem &other)=delete
 
MenuItemoperator= (const MenuItem &&other)=delete
 
virtual void verticalEncoderAction (int32_t offset)
 Handle vertical encoder movement.
 
virtual ActionResult timerCallback ()
 Handle a TimerName::UI_SPECIFIC event.
 
virtual MenuPermission checkPermissionToBeginSession (ModControllableAudio *modControllable, int32_t whichThing, MultiRange **currentRange)
 Double-check that this MenuItem will work with the currently selected sound range.
 
virtual uint8_t getIndexOfPatchedParamToBlink ()
 
virtual uint8_t shouldBlinkPatchingSourceShortcut (PatchSource s, uint8_t *colour)
 
virtual MenuItempatchingSourceShortcutPress (PatchSource s, bool previousPressStillActive=false)
 Action to take when a source shortcut is pressed.
 
virtual bool learnNoteOn (MIDICable &cable, int32_t channel, int32_t noteCode)
 Attempt to bind this menu item to a note code.
 
virtual void learnProgramChange (MIDICable &cable, int32_t channel, int32_t programNumber)
 
virtual void learnCC (MIDICable &cable, int32_t channel, int32_t ccNumber, int32_t value)
 
virtual bool shouldBlinkLearnLed ()
 
virtual bool isRangeDependent ()
 Returns true if this parameter is only relevant to some note ranges.
 
virtual void renderOLED ()
 Root rendering routine for OLED.
 
virtual std::string_view getTitle () const
 Get the title to be used when rendering on OLED, both as a deluge::gui::menu_item::Submenu and when displaying ourselves (using the default renderOLED implementation).
 
virtual uint8_t shouldDrawDotOnName ()
 Get the "draw dot state".
 
virtual void drawName ()
 Draw the name we want to use when selecting this in a deluge::gui::menu_item::Submenu to the 7SEG.
 
virtual std::string_view getName () const
 Get the actual name for use on OLED for deluge::gui::menu_item::Submenu s.
 
virtual void getColumnLabel (StringBuf &label)
 Get the name for use on horizontal menus.
 
virtual bool isRelevant (ModControllableAudio *modControllable, int32_t whichThing)
 Check if this MenuItem should show up in a containing deluge::gui::menu_item::Submenu.
 
virtual bool shouldEnterSubmenu ()
 Check if selecting this menu item (with select encoder) should enter a submenu.
 
virtual int32_t getSubmenuItemTypeRenderLength ()
 Handle rendering of submenu item types.
 
virtual int32_t getSubmenuItemTypeRenderIconStart ()
 
virtual void renderSubmenuItemTypeForOled (int32_t yPixel)
 
virtual bool isSubmenu ()
 
virtual void setupNumberEditor ()
 
virtual void updatePadLights ()
 
virtual void updateAutomationViewParameter ()
 
void renderColumnLabel (int32_t startX, int32_t width, int32_t startY)
 
- Public Member Functions inherited from MenuItemWithCCLearning
void unlearnAction ()
 
bool allowsLearnMode () const
 
void learnKnob (MIDICable *cable, int32_t whichKnob, int32_t modKnobMode, int32_t midiChannel)
 

Protected Member Functions

virtual int32_t getFinalValue ()
 
- Protected Member Functions inherited from deluge::gui::menu_item::IntegerContinuous
void drawPixelsForOled ()
 Paints the pixels below the standard title block.
 
- Protected Member Functions inherited from deluge::gui::menu_item::Integer
virtual int32_t getDisplayValue ()
 
virtual const char * getUnit ()
 
virtual void drawInteger (int32_t textWidth, int32_t textHeight, int32_t yPixel)
 
void drawValue () override
 

Additional Inherited Members

static void drawItemsForOled (std::span< std::string_view > options, int32_t selectedOption, int32_t offset=0)
 Internal helper which can draw the standard deluge::gui::menu_item::Submenu layout.
 
- Public Attributes inherited from deluge::gui::menu_item::Param
uint8_t p
 
deluge::l10n::String title
 Can get overridden by getTitle(). Actual max num chars for OLED display is 14.
 
const deluge::l10n::String name
 Default name for use on OLED for deluge::gui::menu_item::Submenu s.
 

Member Function Documentation

◆ allowsLearnMode()

bool deluge::gui::menu_item::UnpatchedParam::allowsLearnMode ( )
inlinefinalvirtual

Used by SoundEditor to determine if the current menu item can accept MIDI learning.

Reimplemented from MenuItem.

◆ buttonAction()

ActionResult deluge::gui::menu_item::UnpatchedParam::buttonAction ( deluge::hid::Button b,
bool on,
bool inCardRoutine )
inlinefinalvirtual

Handle an arbitrary button.

The returned result is forwarded up the View stack, so returning ActionResult::DEALT_WITH will suppress buttons going to the current View.

This is called with (b == SELECT_ENC && on) immediately after the menu is entered, or after selectButtonPress is called and returns NO_NAVIGATION.

Reimplemented from MenuItem.

◆ getLearningThing()

ParamDescriptor deluge::gui::menu_item::UnpatchedParam::getLearningThing ( )
finalvirtual

◆ getMaxValue()

int32_t deluge::gui::menu_item::UnpatchedParam::getMaxValue ( ) const
inlinenodiscardoverridevirtual

Reimplemented from deluge::gui::menu_item::Param.

◆ getMinValue()

int32_t deluge::gui::menu_item::UnpatchedParam::getMinValue ( ) const
inlinenodiscardoverridevirtual

Reimplemented from deluge::gui::menu_item::Param.

◆ getModelStack()

ModelStackWithAutoParam * deluge::gui::menu_item::UnpatchedParam::getModelStack ( void * memory)
finalvirtual

◆ getParamIndex()

uint32_t deluge::gui::menu_item::UnpatchedParam::getParamIndex ( )
virtual
Returns
the parameter index (deluge::modulation::params) we edit if we're a patched param, otherwise 255.

Reimplemented from MenuItem.

◆ getParamKind()

deluge::modulation::params::Kind deluge::gui::menu_item::UnpatchedParam::getParamKind ( )
virtual

Declares which parameter we intend to edit. SoundEditor uses this to find which shortcut pad to blink based on paramShortcutsForSounds.

Returns
the parameter kind (deluge::modulation::params::Kind) we edit if we're a patched param, otherwise Kind::NONE

Reimplemented from MenuItem.

◆ getParamSet()

ParamSet * deluge::gui::menu_item::UnpatchedParam::getParamSet ( )
finalvirtual

◆ horizontalEncoderAction()

void deluge::gui::menu_item::UnpatchedParam::horizontalEncoderAction ( int32_t offset)
inlinefinalvirtual

Handle horizontal encoder movement.

Parameters
offsetmust be either -1 or 1, jumping is not supported by many children.

Reimplemented from MenuItem.

◆ learnKnob()

void deluge::gui::menu_item::UnpatchedParam::learnKnob ( MIDICable * cable,
int32_t whichKnob,
int32_t modKnobMode,
int32_t midiChannel )
inlinefinalvirtual

Learn a mod knob to the parameter edited by this menu.

Parameters
cableThe MIDI cable to learn from, or null if a mod knob is to be learned.

Reimplemented from MenuItem.

◆ readCurrentValue()

void deluge::gui::menu_item::UnpatchedParam::readCurrentValue ( )
overridevirtual

Like readValueAgain, but does not redraw.

Reimplemented from MenuItem.

◆ selectButtonPress()

MenuItem * deluge::gui::menu_item::UnpatchedParam::selectButtonPress ( )
inlinefinalvirtual

Handle a select button press.

Returns
  • NO_NAVIGATION if the SoundEditor should stay on the current menu.
  • nullptr if the SoundEditor should go up one level in the menu stack.
  • otherwise, enter the returned menu.

Reimplemented from MenuItem.

◆ unlearnAction()

void deluge::gui::menu_item::UnpatchedParam::unlearnAction ( )
inlinefinalvirtual

Unlearn the parameter controlled by this menu.

Reimplemented from MenuItem.

◆ usesAffectEntire()

bool deluge::gui::menu_item::UnpatchedParam::usesAffectEntire ( )
inlineoverridevirtual

Claim support for Kit AFFECT_ENTIRE editing.

Returns
true if this Menu can edit parameters across an entire kit if changed with AFFECT_ENTIRE held down.

Reimplemented from MenuItem.

◆ writeCurrentValue()

void deluge::gui::menu_item::UnpatchedParam::writeCurrentValue ( )
overridevirtual

The documentation for this class was generated from the following files: