mirror of
https://github.com/juce-framework/JUCE.git
synced 2026-01-13 00:04:19 +00:00
134 lines
3.7 KiB
C++
134 lines
3.7 KiB
C++
/*
|
|
==============================================================================
|
|
|
|
This file is part of the JUCE library.
|
|
Copyright (c) 2017 - ROLI Ltd.
|
|
|
|
JUCE is an open source library subject to commercial or open-source
|
|
licensing.
|
|
|
|
The code included in this file is provided under the terms of the ISC license
|
|
http://www.isc.org/downloads/software-support-policy/isc-license. Permission
|
|
To use, copy, modify, and/or distribute this software for any purpose with or
|
|
without fee is hereby granted provided that the above copyright notice and
|
|
this permission notice appear in all copies.
|
|
|
|
JUCE IS PROVIDED "AS IS" WITHOUT ANY WARRANTY, AND ALL WARRANTIES, WHETHER
|
|
EXPRESSED OR IMPLIED, INCLUDING MERCHANTABILITY AND FITNESS FOR PURPOSE, ARE
|
|
DISCLAIMED.
|
|
|
|
==============================================================================
|
|
*/
|
|
|
|
|
|
/**
|
|
Represents a button on a block device.
|
|
*/
|
|
class ControlButton
|
|
{
|
|
public:
|
|
ControlButton (Block&);
|
|
|
|
/** Destructor. */
|
|
virtual ~ControlButton();
|
|
|
|
/** These are all known types of control buttons.
|
|
You can find out which buttons a device has by calling getButtons(),
|
|
and can get the name of a button type with getButtonName().
|
|
*/
|
|
enum ButtonFunction
|
|
{
|
|
mode, // The button on the side of a lightpad block and the first button on a live/loop block
|
|
|
|
volume, // on live + loop blocks
|
|
|
|
// common to all types of block
|
|
up,
|
|
down,
|
|
|
|
// live block buttons
|
|
scale,
|
|
chord,
|
|
arp,
|
|
sustain,
|
|
octave,
|
|
love,
|
|
|
|
// loop block buttons
|
|
click,
|
|
snap,
|
|
back,
|
|
playOrPause,
|
|
record,
|
|
learn,
|
|
|
|
// developer block buttons
|
|
button0,
|
|
button1,
|
|
button2,
|
|
button3,
|
|
button4,
|
|
button5,
|
|
button6,
|
|
button7,
|
|
|
|
// touch block buttons
|
|
velocitySensitivity,
|
|
glideSensitivity,
|
|
slideSensitivity,
|
|
pressSensitivity,
|
|
liftSensitivity,
|
|
fixedVelocity,
|
|
glideLock,
|
|
pianoMode
|
|
};
|
|
|
|
/** Returns the button's type. */
|
|
virtual ButtonFunction getType() const = 0;
|
|
|
|
/** Returns the button's description. */
|
|
virtual juce::String getName() const = 0;
|
|
|
|
/** Returns the position of this button on the device, in device units.
|
|
For buttons that are on the side of the device, this may want to return a value that
|
|
is beyond the phyiscal block size.
|
|
*/
|
|
virtual float getPositionX() const = 0;
|
|
|
|
/** Returns the position of this button on the device, in device units.
|
|
For buttons that are on the side of the device, this may want to return a value that
|
|
is beyond the phyiscal block size.
|
|
*/
|
|
virtual float getPositionY() const = 0;
|
|
|
|
/** Returns true if this button has a controllable light. */
|
|
virtual bool hasLight() const = 0;
|
|
|
|
/** If the button can light-up, this sets its colour. */
|
|
virtual bool setLightColour (LEDColour newColour) = 0;
|
|
|
|
/** A listener that can be attached to a ControlButton object so that it
|
|
gets called when the button is pushed or released.
|
|
*/
|
|
struct Listener
|
|
{
|
|
virtual ~Listener();
|
|
|
|
/** */
|
|
virtual void buttonPressed (ControlButton&, Block::Timestamp) = 0;
|
|
virtual void buttonReleased (ControlButton&, Block::Timestamp) = 0;
|
|
};
|
|
|
|
/** */
|
|
void addListener (Listener*);
|
|
/** */
|
|
void removeListener (Listener*);
|
|
|
|
/** */
|
|
Block& block;
|
|
|
|
protected:
|
|
juce::ListenerList<Listener> listeners;
|
|
|
|
JUCE_DECLARE_NON_COPYABLE_WITH_LEAK_DETECTOR (ControlButton)
|
|
};
|