Virtual Console Widgets

​

Widget Types

​

Control Widgets

​

Advanced Controls

​

Organization Widgets

​

Special Widgets

​

Widget Type Enumeration

enum WidgetType
{
    UnknownWidget,
    ButtonWidget,
    SliderWidget,
    XYPadWidget,
    FrameWidget,
    SoloFrameWidget,
    SpeedDialWidget,
    CueListWidget,
    LabelWidget,
    AudioTriggersWidget,
    AnimationWidget,
    ClockWidget
};

​

Common Widget Properties

​

Identification

• ID: Unique identifier assigned by Virtual Console
• Caption: Text label displayed on the widget
• Page: Page number for multi-page layouts (0-based)

​

Appearance

• Background Color: Custom background color or system default
• Background Image: Optional image for widget background
• Foreground Color: Text and icon color
• Font: Custom font for caption text
• Frame Style: Border appearance (None, Sunken, Raised)

​

Behavior

• Allow Children: Whether widget can contain other widgets (frames only)
• Allow Resize: Whether widget can be resized in design mode
• Disable State: Disabled widgets don’t respond to input in operate mode

​

External Control

• Input Sources: External control mappings (MIDI, OSC, etc.)
• Key Sequence: Keyboard shortcut for activation
• Feedback: Send status updates to external controllers

​

Intensity

• Intensity: Master intensity value (0.0 - 1.0)
• Submaster: Control intensity of multiple functions together

​

Widget Lifecycle

​

Creation

1. User selects widget type from toolbar
2. Virtual Console calls corresponding slotAdd*() method
3. Widget is instantiated with default properties
4. Widget receives unique ID from newWidgetId()
5. Widget is added to parent frame or contents area
6. Widget appears in design mode with resize handles

public slots:
    void slotAddButton();
    void slotAddButtonMatrix();
    void slotAddSlider();
    void slotAddSliderMatrix();
    void slotAddKnob();
    void slotAddSpeedDial();
    void slotAddXYPad();
    void slotAddCueList();
    void slotAddFrame();
    void slotAddSoloFrame();
    void slotAddLabel();
    void slotAddAudioTriggers();
    void slotAddClock();
    void slotAddAnimation();

​

Configuration

• Accessed by right-clicking and selecting “Edit Properties”
• Implemented as separate dialog class (e.g., VCButtonProperties)
• Allows configuration of widget-specific settings
• Changes are applied immediately in design mode

​

Operation

1. Widget monitors for user interaction (mouse, keyboard)
2. External input sources are processed
3. Widget performs its specific action (start function, adjust value, etc.)
4. Feedback is sent to external controllers
5. Widget state is updated visually

​

Persistence

• saveXML() writes widget properties to workspace file
• loadXML() restores widget from workspace file
• postLoad() performs post-loading initialization
• Common properties are handled by saveXMLCommon() / loadXMLCommon()

​

Widget Selection

• Single Selection: Click widget to select it
• Multiple Selection: Ctrl+Click to add widgets to selection
• Group Operations: Selected widgets can be moved, copied, or deleted together
• Selection Indicators: Selected widgets show resize handles

const QList<VCWidget*> selectedWidgets() const;
void setWidgetSelected(VCWidget* widget, bool selected);
bool isWidgetSelected(VCWidget* widget) const;
void clearWidgetSelection();

​

Widget Clipboard

• Cut (Ctrl+X): Remove selected widgets to clipboard
• Copy (Ctrl+C): Copy selected widgets to clipboard
• Paste (Ctrl+V): Create copies of clipboard widgets

virtual VCWidget* createCopy(VCWidget* parent) const = 0;
virtual bool copyFrom(const VCWidget* widget);

​

Input Source Management

• Each input source has a unique ID (0-255)
• Sources include universe, channel, and value range
• Widgets check incoming input against configured sources
• Matching input triggers widget action

void setInputSource(QSharedPointer<QLCInputSource> const& source, quint8 id = 0);
QSharedPointer<QLCInputSource> inputSource(quint8 id = 0) const;
bool checkInputSource(quint32 universe, quint32 channel, uchar value, QObject *sender, quint32 id = 0);
void sendFeedback(int value, quint8 id = 0);

​

Widget States

​

Disable State

• Disabled widgets are grayed out in operate mode
• They don’t respond to input
• Can be controlled by parent frames
• Useful for temporarily deactivating controls

virtual void setDisableState(bool disable);
virtual void enableWidgetUI(bool enable);
bool isDisabled() const;

​

Live Edit State

• Allows limited editing in operate mode
• Widget positions can be adjusted
• Properties cannot be changed
• Functions continue running

virtual void setLiveEdit(bool liveEdit);
void cancelLiveEdit();

​

Widget Interactions

• Solo Frames: Stop sibling functions when new function starts
• Submasters: Control intensity of multiple widgets
• Multipage Frames: Show/hide widgets based on current page
• Function Notifications: Widgets notify parents when starting functions

​

Next Steps