Digital Synth Editors (Parts 1 & 2)
====================================

The **Digital Synth Editors** provide comprehensive control over the JD-Xi's digital synthesis engines, offering unprecedented access to the synthesizer's multi-partial architecture. These powerful editors transform your JD-Xi's digital synthesis capabilities into a professional-grade sound design workstation.

Built with advanced Qt6 technology and featuring real-time parameter control, the Digital Synth Editors serve as your primary workspace for creating, editing, and managing sophisticated digital sounds with the precision and control of modern software synthesizers.

What are the Digital Synth Editors?
===================================

The Digital Synth Editors are specialized interfaces that provide deep, granular control over the JD-Xi's digital synthesis engines. Unlike the limited hardware interface, these editors offer expansive, visual control over every parameter with real-time feedback, advanced organization tools, and professional-grade editing capabilities.

Each editor represents a dedicated workspace optimized for digital sound design, from basic oscillator control to complex multi-partial synthesis. The editors automatically synchronize with your JD-Xi hardware, ensuring that every change is instantly reflected in your synthesizer's sound.

Core Architecture & Design
===========================

** Multi-Partial Architecture**
   The Digital Synth Editors feature a sophisticated multi-partial system:
   - **3 Partial Control**: Individual control over each of the 3 partials per digital synth
   - **Layer Blending**: Sophisticated mixing and blending of multiple partials
   - **Cross-Modulation**: Advanced modulation routing between partials
   - **Real-time Visualization**: Live display of partial relationships and interactions

** Advanced Parameter Management**
   - **Comprehensive Parameter Mapping**: Every digital synth parameter is accessible through intuitive controls
   - **Real-time Updates**: Instant parameter changes with immediate hardware response
   - **Visual Feedback**: Live parameter displays, value indicators, and status monitoring
   - **Preset Integration**: Seamless loading, saving, and management of your custom sounds

** Professional Workflow Tools**
   - **Multi-Editor Support**: Work with both digital synth parts simultaneously
   - **Advanced Organization**: Categorize, search, and manage your sound library
   - **Project Integration**: Export and import settings for use in your DAW
   - **Performance Optimization**: Low-latency response for live performance and recording

Digital Synth Editor Features
=============================

**Oscillator Control**
   Advanced waveform and frequency control:

   **Waveform Selection**
      - **Multiple Waveforms**: Access to all JD-Xi digital waveforms
      - **Waveform Preview**: Real-time visualization of selected waveforms
      - **Custom Waveforms**: Support for user-defined waveforms
      - **Waveform Morphing**: Smooth transitions between waveforms

   **Frequency Control**
      - **Pitch Control**: Precise pitch adjustment and tuning
      - **Detune Control**: Fine-tuning for detuned effects
      - **Pitch Modulation**: LFO and envelope modulation of pitch
      - **Frequency Modulation**: Advanced FM synthesis capabilities

**Filter Processing**
   Sophisticated filtering with multiple modes:

   **Filter Types**
      - **Low-Pass Filter**: Traditional low-pass filtering
      - **High-Pass Filter**: High-frequency emphasis
      - **Band-Pass Filter**: Frequency band isolation
      - **Multi-Mode Filter**: Switchable filter types

   **Filter Parameters**
      - **Cutoff Frequency**: Real-time cutoff control
      - **Resonance**: Filter emphasis and character
      - **Envelope Modulation**: ADSR control of filter parameters
      - **LFO Modulation**: Low-frequency oscillator modulation

**Envelope Shaping**
   Complete ADSR control with additional stages:

   **ADSR Controls**
      - **Attack**: Initial sound onset control
      - **Decay**: Initial decay after attack
      - **Sustain**: Sustained level control
      - **Release**: Final decay control

   **Additional Envelope Stages**
      - **Hold**: Sustain level holding
      - **Delay**: Pre-attack delay
      - **Additional Decay**: Multi-stage decay
      - **Envelope Scaling**: Time and level scaling

**Effects Processing**
   Built-in effects optimized for digital synthesis:

   **Effect Types**
      - **Distortion**: Harmonic enhancement and saturation
      - **Chorus**: Stereo width and movement
      - **Delay**: Time-based effects and echoes
      - **Reverb**: Spatial effects and ambience

   **Effect Parameters**
      - **Real-time Control**: Live parameter manipulation
      - **Effect Routing**: Flexible effect chain routing
      - **Preset Management**: Save and recall effect settings
      - **Performance Integration**: Optimized for live performance

Partial Management System
=========================

**Individual Partial Control**
   Complete control over each of the 3 partials:

   **Partial Selection**
      - **Active/Inactive**: Enable or disable individual partials
      - **Partial Mixing**: Balance between partials
      - **Partial Routing**: Flexible audio routing options
      - **Partial Effects**: Individual effects per partial

   **Partial Parameters**
      - **Oscillator Settings**: Individual oscillator control per partial
      - **Filter Settings**: Separate filter control per partial
      - **Envelope Settings**: Individual envelope control per partial
      - **Effect Settings**: Separate effects per partial

**Layer Blending**
   Sophisticated mixing and blending:

   **Mixing Controls**
      - **Volume Balance**: Individual partial volume control
      - **Pan Control**: Stereo positioning per partial
      - **Crossfading**: Smooth transitions between partials
      - **Mute/Solo**: Individual partial isolation

   **Blending Modes**
      - **Additive**: Simple addition of partials
      - **Multiplicative**: Complex partial interactions
      - **Modulation**: Partial-to-partial modulation
      - **Cross-Modulation**: Advanced modulation routing

**Cross-Modulation**
   Advanced modulation routing between partials:

   **Modulation Sources**
      - **LFO**: Low-frequency oscillator modulation
      - **Envelope**: Envelope follower modulation
      - **External**: MIDI controller modulation
      - **Internal**: Partial-to-partial modulation

   **Modulation Destinations**
      - **Pitch**: Frequency modulation
      - **Filter**: Cutoff and resonance modulation
      - **Amplitude**: Volume modulation
      - **Effects**: Effect parameter modulation

Performance Features
====================

**Live Parameter Control**
   Real-time manipulation of all synthesis parameters:

   **Real-time Updates**
      - **Instant Response**: Immediate parameter changes
      - **Smooth Transitions**: Gradual parameter changes
      - **MIDI Control**: External controller integration
      - **Automation**: Parameter automation support

   **Performance Modes**
      - **Live Mode**: Optimized for real-time performance
      - **Edit Mode**: Detailed parameter editing
      - **Preset Mode**: Quick preset switching
      - **Learn Mode**: MIDI controller learning

**Preset Management**
   Advanced organization and recall of your custom sounds:

   **Preset Organization**
      - **Categories**: Organize presets by type or style
      - **Tags**: Add custom tags for easy searching
      - **Favorites**: Mark frequently used presets
      - **Recent**: Quick access to recently used presets

   **Preset Operations**
      - **Save**: Save current settings as preset
      - **Load**: Load existing presets
      - **Copy**: Duplicate existing presets
      - **Delete**: Remove unwanted presets

**MIDI Integration**
   Full support for external MIDI controllers and keyboards:

   **Controller Support**
      - **MIDI Learn**: Assign any parameter to any controller
      - **Controller Mapping**: Save and recall controller mappings
      - **Multiple Controllers**: Support for multiple MIDI controllers
      - **Controller Profiles**: Different profiles for different setups

   **Keyboard Integration**
      - **Note Input**: Play notes using MIDI keyboard
      - **Velocity Sensitivity**: Respond to playing dynamics
      - **Aftertouch**: Support for pressure sensitivity
      - **Pitch Bend**: Pitch bend wheel support

Visual Feedback & Monitoring
============================

**Real-time Visualization**
   Live display of waveforms, envelopes, and parameter relationships:

   **Waveform Display**
      - **Live Waveforms**: Real-time waveform visualization
      - **Spectrum Analysis**: Frequency domain display
      - **Waveform Comparison**: Compare different waveforms
      - **Custom Waveforms**: Display user-defined waveforms

   **Envelope Visualization**
      - **ADSR Display**: Visual representation of envelope stages
      - **Envelope Editing**: Graphical envelope editing
      - **Envelope Comparison**: Compare different envelopes
      - **Envelope Automation**: Visual automation display

**Parameter Monitoring**
   Comprehensive display of current settings and parameter relationships:

   **Value Displays**
      - **Numerical Values**: Precise parameter values
      - **Bar Graphs**: Visual parameter levels
      - **Meters**: Real-time level monitoring
      - **Status Indicators**: Parameter state indicators

   **Relationship Display**
      - **Modulation Matrix**: Visual modulation routing
      - **Signal Flow**: Audio signal path display
      - **Parameter Dependencies**: Show parameter relationships
      - **Effect Chain**: Visual effects routing

Getting Started with Digital Synth Editors
==========================================

**Initial Setup**
   1. **Launch Digital Synth Editor**: Open the Digital Synth Editor from the main interface
   2. **Select Part**: Choose Digital Synth Part 1 or Part 2
   3. **Load a Preset**: Start with a factory preset to understand the interface
   4. **Explore Controls**: Familiarize yourself with the available parameters and controls

**Basic Workflow**
   1. **Choose a Partial**: Select which partial to edit (1, 2, or 3)
   2. **Adjust Parameters**: Use sliders, knobs, and controls to modify settings
   3. **Test Your Changes**: Play notes using the virtual keyboard or MIDI controller
   4. **Save Your Work**: Use the preset management system to save your creations

**Advanced Techniques**
   - **Multi-Partial Workflow**: Use multiple partials for complex sound design
   - **Cross-Modulation**: Create complex modulation relationships between partials
   - **Layer Blending**: Blend multiple partials for rich, complex sounds
   - **Performance Integration**: Optimize the interface for live performance

**Tips for Effective Sound Design**
   - **Start Simple**: Begin with basic waveforms and simple envelopes
   - **Layer Gradually**: Add complexity by layering multiple partials
   - **Use Modulation**: Experiment with LFO and envelope modulation
   - **Save Frequently**: Save your work regularly to avoid losing changes

The Digital Synth Editors transform your Roland JD-Xi's digital synthesis capabilities into a professional-grade sound design workstation, providing the tools and interface you need to create, edit, and manage sophisticated digital sounds with the precision and control of modern software synthesizers.

.. figure:: images/jdxi-digital-synth1.png
   :alt: Digital Synth 1 - Multi-Partial Interface
   :width: 60%

   Digital Synth 1 - Multi-Partial Interface