Wavetable oscillator with classic waveforms. More...

#include <classicwtcore.h>

Inheritance diagram for SynthLab::ClassicWTCore:

Public Member Functions
	ClassicWTCore ()
	Construction: Cores follow the same construction pattern. More...

virtual	~ClassicWTCore ()

virtual bool	reset (CoreProcData &processInfo) override
	Resets object to initialized state. More...

virtual bool	update (CoreProcData &processInfo) override
	Updates the object for the next block of audio processing. More...

virtual bool	render (CoreProcData &processInfo) override
	Renders the output of the module. More...

virtual bool	doNoteOn (CoreProcData &processInfo) override
	Note-on handler for the ModuleCore. More...

virtual bool	doNoteOff (CoreProcData &processInfo) override
	Note-off handler for the ModuleCore. More...

double	renderSample (SynthClock &clock, double shape=0.5)
	Renders one sample out of the wavetable Core Specific: More...

double	renderHardSyncSample (SynthClock &clock, double shape=0.5)
	Renders one hard-synced sample from the wavetable Core Specific: More...

Public Member Functions inherited from SynthLab::ModuleCore
	ModuleCore ()
	Constructs a ModuleCore. More...

virtual int32_t	getState ()

virtual bool	shutdown ()

virtual void	setSustainOverride (bool sustain)

virtual void	setStandAloneMode (bool b)

bool	startGlideModulation (GlideInfo &glideInfo)

uint32_t	getModuleType ()

const char *	getModuleName ()

void *	getModuleHandle ()

void	setModuleHandle (void *handle)

uint32_t	getModuleIndex ()

void	setModuleIndex (uint32_t index)

int32_t	getPreferredModuleIndex ()

void	setPreferredModuleIndex (uint32_t index)

ModuleCoreData &	getModuleData ()
	provides access to the core data: More...

Protected Member Functions
void	checkAddWavetable (SynthLabTableSet &slTableSet, CoreProcData &processInfo, uint32_t waveIndex)
	helper function to check database for wavetable and add it if the table does not exist More...

Protected Attributes
double	sampleRate = 0.0
	sample rate

double	midiPitch = 0.0
	the midi pitch

double	outputAmplitude = 1.0
	amplitude in dB

double	panLeftGain = 0.707
	left channel gain

double	panRightGain = 0.707
	right channel gain

int32_t	currentWaveIndex = -1
	to minimize dictionary (map) lookup iterating

SynthClock	oscClock
	the oscillator timebase

IWavetableSource *	selectedTableSource = nullptr
	selected table

Synchronizer	hardSyncronizer
	hard sync helper

StaticTableSource	wavetables [MODULE_STRINGS]

Protected Attributes inherited from SynthLab::ModuleCore
uint32_t	moduleType = UNDEFINED_MODULE
	type of module, LFO_MODULE, EG_MODULE, etc...

const char *	moduleName = nullptr
	module name must be set in derived constructor

void *	moduleHandle = nullptr
	used for dynamically loading cores from DLLs

uint32_t	moduleIndex = 0
	index of this core

int32_t	preferredIndex = -1
	preferred index of this DYNAMIC core

ModuleCoreData	coreData
	core strings (16) and mod knob labels (4)

bool	standAloneMode = false
	flag for stand-alone mode of operation outside of SynthLab

std::unique_ptr< GlideModulator >	glideModulator
	built-in glide modulator for oscillators

Detailed Description

Wavetable oscillator with classic waveforms.

demonstrates use of IWavetableSource interface object

Base Class: ModuleCore

Overrides the five (5) common functions plus a special getParameters() method to return a shared pointer to the parameters structure.
NOTE: These functions have identical names as the SynthModules that own them, however the arguments are different. ModuleCores use the CoreProcData structure for passing arguments into the cores because they are thunk-barrier compliant.
This means that the owning SynthModule must prepare this structure and populate it prior to function calls. The large majority of this preparation is done in the SynthModule constructor and is one-time in nature.

GUI Parameters: WTOscParameters

GUI parameters are delivered into the core via the thunk-barrier compliant CoreProcData argument that is passed into each function identically
processInfo.moduleParameters contains a void* version of the GUI parameter structure pointer
the Core function casts the GUI parameter pointer prior to usage

Access to Modulators is done via the thunk-barrier compliant CoreProcData argument

processInfo.modulationInputs
processInfo.modulationOutputs

Access to audio buffers (I/O/FM) is done via the thunk-barrier compliant CoreProcData argument

processInfo.inputBuffers
processInfo.outputBuffers
processInfo.fmBuffers

Construction: Cores follow the same construction pattern

set the Module type and name parameters
expose the 16 module strings
expose the 4 mod knob label strings
intialize any internal variables

Standalone Mode:

These objects are designed to be internal members of the outer SynthModule that owns them. They may be used in standalone mode without modification, and you will use the CoreProcData structure to pass information into the functions.

Module Strings, zero-indexed for your GUI Control:

ana_saw, ana_sqr, fm_bass1, fm_bass2, fm_organ, vs_saw, vs_octsqr, vs_buzz, akwf_br7, akwf_br12, akwf_br17, akwf_br24, akwf_dst15, akwf_dst22, akwf_dst27, akwf_tri11

ModKnob Strings, for fixed GUI controls by index constant

MOD_KNOB_A = "Shape"
MOD_KNOB_B = "HSync"
MOD_KNOB_C = "Phase"
MOD_KNOB_D = "D"

Render:

renders into the output buffer using pointers in the CoreProcData argument to the render function
renders one block of audio per render cycle
renders in mono that is copied to the right channel as dual-mono stereo

Author: Will Pirkle http://www.willpirkle.com

Remarks: This object is included and described in further detail in Designing Software Synthesizer Plugins in C++ 2nd Ed. by Will Pirkle

Version: Revision : 1.0

Date: Date : 2021 / 04 / 26

Constructor & Destructor Documentation

◆ ClassicWTCore()

SynthLab::ClassicWTCore::ClassicWTCore ( )

Construction: Cores follow the same construction pattern.

simple default constructor

set the Module type and name parameters
expose the 16 module strings
expose the 4 mod knob label strings
intialize any internal variables

Core Specific:

uses SynthLab::SynthLabTableSet structure to describe the wavetables in the #included directories
you are free to create your own custom table descriptions

Returns: the newly constructed object

◆ ~ClassicWTCore()

virtual SynthLab::ClassicWTCore::~ClassicWTCore ( )

inlinevirtual

Destructor is empty: all resources are smart pointers

Member Function Documentation

◆ checkAddWavetable()

void SynthLab::ClassicWTCore::checkAddWavetable	(	SynthLabTableSet &	slTableSet,
		CoreProcData &	processInfo,
		uint32_t	waveIndex
	)

protected

helper function to check database for wavetable and add it if the table does not exist

wavetables are identified with unique waveform name string
uses static table sources since these wavetables are fixed and never re-calculated
sets the unique index of the table in the database for faster parsing; you may still use the unique name string as a means of lookup, but it will slow the update() function a bit

Core Specific:

nothing to do

Parameters

processInfo is the thunk-barrier compliant data structure for passing all needed parameters

Returns: true if successful, false otherwise

◆ doNoteOff()

bool SynthLab::ClassicWTCore::doNoteOff ( CoreProcData & processInfo )

overridevirtual

Note-off handler for the ModuleCore.

parameters are accessed via the processInfo.moduleParameters pointer
MIDI note information is accessed via processInfo.noteEvent

Core Specific:

nothing to do

Parameters

processInfo is the thunk-barrier compliant data structure for passing all needed parameters

Returns: true if successful, false otherwise

Implements SynthLab::ModuleCore.

◆ doNoteOn()

bool SynthLab::ClassicWTCore::doNoteOn ( CoreProcData & processInfo )

overridevirtual

Note-on handler for the ModuleCore.

parameters are accessed via the processInfo.moduleParameters pointer
MIDI note information is accessed via processInfo.noteEvent

Core Specific:

saves MIDI pitch for modulation calculation in update() function
sets wavetable start-read location (aka "Phase")

Parameters

processInfo is the thunk-barrier compliant data structure for passing all needed parameters

Returns: true if successful, false otherwise

Implements SynthLab::ModuleCore.

◆ render()

bool SynthLab::ClassicWTCore::render ( CoreProcData & processInfo )

overridevirtual

Renders the output of the module.

renders to output buffer using pointers in the CoreProcData argument
supports FM via the pmBuffer if avaialble; if pmBuffer is NULL then there is no FM Core Specific:
call rendering sub-function
apply and remove phase offsets for phase modulation (FM)
renders one block of audio per render cycle
renders in mono that is copied to the right channel as dual-mono stereo

Parameters

processInfo the thunk-barrier compliant data structure for passing all needed parameters

Returns: true if successful, false otherwise

Implements SynthLab::ModuleCore.

◆ renderHardSyncSample()

double SynthLab::ClassicWTCore::renderHardSyncSample	(	SynthClock &	clock,
		double	shape = `0.5`
	)

Renders one hard-synced sample from the wavetable Core Specific:

calls renderSample() for the main and reset oscillators as needed
detects new reset signal and restarts synchronizer

Parameters

clock	the current timebase
shape	the shape amount [-1, +1] from GUI and/or modulation

Returns: true if successful, false otherwise

◆ renderSample()

double SynthLab::ClassicWTCore::renderSample	(	SynthClock &	clock,
		double	shape = `0.5`
	)

Renders one sample out of the wavetable Core Specific:

Helper functions for rendering

applies phase distortion for shape modulation

Parameters

clock	the current timebase
shape	the shape amount [-1, +1] from GUI and/or modulation

Returns: true if successful, false otherwise

◆ reset()

bool SynthLab::ClassicWTCore::reset ( CoreProcData & processInfo )

overridevirtual

Resets object to initialized state.

ModuleCore Overrides

parameters are accessed via the processInfo.moduleParameters pointer
initialize timbase and hard synchronizer
check and add wavetables to the database

Parameters

processInfo the thunk-barrier compliant data structure for passing all needed parameters

Returns: true if successful, false otherwise

Implements SynthLab::ModuleCore.

◆ update()

bool SynthLab::ClassicWTCore::update ( CoreProcData & processInfo )

overridevirtual

Updates the object for the next block of audio processing.

parameters are accessed via the processInfo.moduleParameters pointer
modulator inputs are accessied via processInfo.modulationInputs
mod knob values are accessed via parameters->modKnobValue[] Core Specific:
calculates the pitch modulation value from GUI controls, input modulator kBipolarMod, and MIDI pitch bend
selects a wavetable based on modulated frequency to avoid aliasing
sets up hard-sync (this oscillator's unique modulation)
calculates final gain and pan values

Parameters

processInfo the thunk-barrier compliant data structure for passing all needed parameters

Returns: true if successful, false otherwise

Implements SynthLab::ModuleCore.

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

C:/RackAFX Projects/SynthLab_SDK/source/classicwtcore.h
C:/RackAFX Projects/SynthLab_SDK/source/classicwtcore.cpp

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ ClassicWTCore()

◆ ~ClassicWTCore()

Member Function Documentation

◆ checkAddWavetable()

◆ doNoteOff()

◆ doNoteOn()

◆ render()

◆ renderHardSyncSample()

◆ renderSample()

◆ reset()

◆ update()