GRA4 - TheTechnobear/SSP GitHub Wiki

gra4 - 4 track granulator

4 track granulator

note: this is presently early access only, it is not feature complete!

Documentation

Note: This is the primary page for documentation on this modules

Developer: TheTechnobear

I develop these plugins for free, please consider supporting my efforts with a donation. https://ko-fi.com/thetechnobear

Parameters

Recording parameters

Name Desc
Gain recording gain
Monitor monitor level of input

For each layer (1-4)

Name Desc
Start start of grain playback
Length length of grain
Rate playback rate, negative is reverse
Pan Pan position -1 = left, 1 = right, 0 = centre
Gain playback gain
Size Max length of layer in seconds

Inputs

Name Desc
Layer [1-4] Trig trigger grain
Layer [1-4] Start start pos of grain, added to parameter
Layer [1-4] Len length of grain added to parameter
Layer [1-4] Rate playback rate, added to parameter
Layer [1-4] Pan Pan position , added to parameter
Rec Mode Recording gate

Outputs

Name Desc
Sum L/R Sum of all layers
Layer 1-4 L/R layer output 1-4

Buttons

Recording |Record|start/end recording| |Loop|Loop playback|

Layer (1-4)

Name Desc
Load Load wav file into layer
Save Save sample layer to wav file

General Usage

This granulator features 4 (mono) layers (or tracks, if you please :)). Each layer has full independent control, and size etc. A layer can be loaded from a file, or can be recorded live. Recording is done via one input, as will recording into the 'active layer'. This layer is chosen via the LYR+/- buttons, and has a grey border around it.

To record, the user should select recording mode with the REC key, then press Record. (the active layer can still be changed)

as this is a granular engine, to hear anything you must 'trigger' the layer. this will generate a grain, using start/len/rate and pan at the current cv time.

importantly, the grain gets these properties at creation time only!. so we can trigger many grains, and they each have different properties if we are modulating above via cv.

Current limitations, pretty arbitary ;) layer size is limited to 3 mins. (assuming SSP has that memory to spare!) max 32 grains per layer

Tips

Loading/ Saving

may cause audio disturbances.

note: currently entire file is loaded, and then chopped to max layer time, so dont use large files ;)

Layer Size

layer size is the maximum size. changing may cause audio disturbances. for dynamic control, you should use the begin/end playback.

Rate

Rate is not scaled, and so we can use values of > 1.0 and < 1.0 This may change, as whilst easy to remember, its not idiomatic. I may switch this to v/oct?!

Start / Length CV

the CV inputs are added to the respective parameter, and are bipolar!

this can confuse some.... so here are some tips.

first, its advisable to convert your incoming signal to unipolar (0..1 rather than -1.0) do this by scale=0.5 and offset = 0.5, on the input signal.

this works as you'd expect where begin = 0.0. the default is end =1.0, so adding to that will not do anything.

so, we we have now a choice...

one option is to set end to 0, and therefore your CV (0..1 ) will now control end.

the alternative is to leave end as 1.0, and to invert the incoming cv signal. then change the cv input to : scale -0.5 offset 0.5

I prefer the second, as it means if you disconnect the CV the loop plays in full. however, some may find the first option a little easier to understand.

Known issues/limitations

I've implemented recording begin and end, however, there is a bug in RNBO which means this is currently not available. once Cycling 74 have fixed this issue, I will revisit, and add back the functionality.

there are various other limitations imposed by RNBO, that may or may not be addressed.

Change Log

  • 1.0.0 early access release