Short:        Realtime multi loop processor editor
Author:       Marc Williams
Uploader:     marc williams hushmail com
Type:         mus/edit
Version:      1.24
Architecture: m68k-amigaos >= 1.3
Distribution: Aminet

FxBox

sample packs, source code and wiki: https://github.com/marc365/fxbox

Imports 16bit, 24bit and 32bit floating point Aif and Wav files, mp2, mp3
files and Octamed modules.

Loads and saves Iff 8bit files, Iff CATs and AMOS sample banks.

Can do mono, stereo, quad and 4, 8, 16 channel multi track.

Render Octamed modules as waveforms.

Record to disk and pipe over the network to a VST host, Win32 plugin
included.

Network BPM sync and Octamed Arexx sync at the same time.

Realtime effects preview and oscilloscope is available on accelerated
machines.

Requires at least 1M ram, and supports up to 2G.

Written in AMOS Basic & compiled with AMOS Professional 365.
https://github.com/marc365/AMOS-Professional-365

-----------------------------------------------------------------------------

Version 1.24

new features
------------
multi track expanded with 8 and 16 channel modes Edit >> Mode >> 4ch 8ch 16ch
accelerated machines use high quality realtime mixing, a1200 with fast ram
can achieve 8 channels @ 12000Hz and 16 @ 4000Hz

VST plugins added fxbox.8ch.VST.dll & fxbox.16ch.VST.dll, both are downward
compatible

macros/mixdown 8ch.asc & macros/mixdown 16ch.asc

macros/pink noise.asc

macros/open rewind.asc

sequences/auto swap.asc

Edit >> Swap >> Last _SWAPLAST

Edit >> Swap >> Previous _SWAPPREVIOUS

Edit >> Swap >> Next _SWAPNEXT

Process >> Repair >> Remove Zero Space if it is larger than the window size

Process >> Convert >> 32bit Float to 8bit Max scans for the maximum volume
and scales during the conversion

Memory >> Last _LAST

Memory >> Insert _INSERT

Memory >> Remove _REMOVE

Utilities >> Sequence >> Clear _CLEARSEQUENCE will stop all sequencer
activity (sequences/clear.asc retired)

Utilities >> Tone >> ... sub menus with new text gadget for the frequency
improved dial with Shift and Ctrl for fine increments, Triangle, Square and
Sawtooth updated, Ramp, Pulse 25%, Bell and Horn added (macros/sawtooth.asc
and macros/triangular.asc retired)

new commands TFREQ= for the tone frequency and TAMP= for its amplitude

Shift key when selecting anything from the menu that processes will now skip
opening its window

Help >> Initialize _INIT restart everything, including reallocating the audio
channels and resetting all the preferences and defaults


updates
-------
improved Octamed rendering with instrument volumes, command $0C volume, and
command $20 reverse

ping ping loop mix _TGLPINGPONG, works with Octamed instruments

keyboard piano added the high notes F-6, F#6 and G-6 keys '[', '=' and ']'

-/+ keys next to backspace _PREVIOUS _NEXT defaults removed, numpad behaviour
updated -/+ action improved, macros/autoexec.asc updated, a600 users will
probably want to override those 3 keys in macros/autoexec.asc to retain the
-/+ functionality as there is no numpad

Help >> About now shows total Used memory instead of free Chip memory 

Edit >> Show All and Edit >> Show Range added and Edit >> Clear Copy was
removed (_CLEARCOPY is still there)

macros/swap 5678.asc and 9101112.asc updated to swap into the current
position, 1234.asc and 13141516.asc added

macros/mixdown multi.asc renamed mixdown 4ch.asc

macros/shimmer.asc updated

macros/silence 1234.asc updated to work on the next 4 channels and renamed
macros/silence x4.asc

Edit >> Mix >> Amplitude doubled the output

Process >> Filter >> Band Pass tweaked

other improvements and optimizations


bug fixes
---------
mute while loading and decoding would not mute under some circumstances

Utilities >> Noise >> ... in stereo and quad would reset the random seed on
each channel

saving a "large" AMOS Sample Bank would "sometimes" cause a delayed crash

tests/ST-01.cat fixed DigiHarp, Heaven, RoomBrass, SlapBass, String6 and
Touch to the best (not truncated, faded out, octaved up or echoed) versions
from a discussion on https://eab.abime.net/showthread.php?t=81432 - in the
.cat file Detune was repeated and DxTom was missing, meta data for every
entry has been added

other display bugs fixed


-----------------------------------------------------------------------------

Version 1.23

new features
------------
open mp2 and mp3 files using mpega.library
https://aminet.net/util/libs/mpega_library.lha

14bit from mp3.asc macro added, File >> Open As Raw then use the macro

Process >> Distort >> Ring Modulator

Process >> Effects >> Delay

pattern.asc sequence added, synchronization check with FLSHSCR and _REWIND
every 64 beats

new experimental feature, Help >> Options >> Magic - turn on to set the exec
taskpri to -1 for smooth multi-tasking 

new build/Compiler.Lib and build/APCmp fixes the AMOS double _LVOUnLock bug,
better compatibility with AROS and AmigaOS 4.1


updates
-------
KEY <chr code> <script> command added for programmable keys without a
modifier

added Telefonorosso's mute shortcuts as a default and moved all the main
keyboard shortcuts over to programmable in autoexec.asc

Help >> Topics >> Shortcuts updated to show the list of programmed keys

14bit macro names flipped around from xxbit to 14bit.asc
=> 14bit from xxbit.asc

big update and fixes for octamed, tempo to waveform length calculations
improved removing the (incomplete) tempo conversion table. 8 channel,
4 channel and mix mode are now close to perfect, also improved timing
precision on the NOTEs when _RENDERing

sequencer upgraded by using a memory bank and string builder instead of AMOS
strings reducing memory requirements, Set Buffer set back to 50k from 160k

powerpacker.library upgraded, 68000 compatible version 36.10
https://aminet.net/package/util/libs/pplib16 for backward compatibility

file requester new right click menu File List >> Refresh - list sorting
options will be added later

octave up range.asc macro retired

Process >> Effects >> Reverb now has variable feedback and uses dials

Process >> Effects >> Simple Echo retired (circa. 1991), change
Edit >> Frame >> Time Division and use the simple echo.asc macro instead

Process >> Effects >> Tremolo updated

other updates for various reasons


bug fixes
---------
updated the octamed block selection as modules start at block 0, not block 1

finetune discrepancy discovered with the octamed to sequence subroutine

the first note on the first track of a block in an octamed module was not
being rendered due to corruption

SEQ command without a parameter would overflow the direct mode paging system
making it difficult to debug a sequence

previewing the realtime fx on all 4 channels with Caps Lock would jump back
to 1 channel while using Shift on a dial

Process >> Distort >> Alias had extra noise created during its realtime
preview that wasn't in the processed result

Process >> Distort >> Fold slider was logically backwards

windy.asc macro renamed to shimmer.asc, also updated as it broke the ability
to undo

mute with the dial now won't insist on changing if you attempted to
increase/decrease past the limits without actually changing anything

a typo uncrunching powerpacked files caused the file requester to be in the
wrong folder, and File >> Revert was broken

Process >> Bitwise >> Logical shift left is retired, "in the case of a left
shift, arithmetic and logic shift do the same operation"

_TGLCONTROLS did not preserve the highlights on the dials for mute or amihz,
it would also reload the settings from disk

fixes to range selection, shift for chunky no longer skips positions,
flipping over to the other side now shows the correct range positions in the
header and if playing the loop is updated as you move, cancel with esc is
improved

other fixes for various reasons


-----------------------------------------------------------------------------

Version 1.22

new features
------------
accelerated graphics now standardized with FBlit (see wiki)
https://aminet.net/package/util/boot/fblit

Mute function by clicking the Volume Dial and Tab shortcut key that in multi
track toggles the current channel and highlights the view

Utils >> Controls toggles the controls at the bottom, for a larger view of
the waveforms

CALC <bank number> command to set the current waveforms resampling ratio for
_RESAMPLE from the waveform in <bank number>

OFFSET <bank number> command to set the current waveforms playing offset from
what is playing in <bank number>

programmable keyboard shortcuts set with commands: SHIFT, CTRL, AMIGA and ALT
e.g. for Control Escape: CTRL 69 FLSHSCR,QUIT,

added autoexec.asc macro that doesn't show in the menu but is executed just
after startup


updates
-------
Options >> Debug now also shows the character code for each key press

Utilities >> Piano >> Portamento piano mode just changes the FREQ of the
current playback

changed the direct mode screen to show at the top of the screen and is also
draggable by its bottom

removed the waveform redraw limit for running sequences with accelerated
graphics

the screen is NOW reset to Pal or Ntsc when using 50Hz/60Hz in the Options

_STOP no longer happens when loading a file while playing that needs
conversion, it is muted during the process new macros rewind.asc and
windy.asc added

Help >> Topics updated

other improvements and updates for various reasons


bug fixes
---------
error fixed with Edit >> Frame Beat Left/Right if the range selected is
smaller than a time division

the new MUTE system exposed an obscure bug with the gui that only occurred
while running sequences, effects and mouse actions concurrently

opening a stereo/quad file in multi mode incorrectly set _CHANNELS as more
than 1, which could affect how an IFF CAT was then created, breaking the
header and seemingly truncating the files - OPENASRAW can recover the data

better recovery when loading multi-file formats if a low memory failure
occurs

increased file header buffer size and improved error recovery when loading

not all subroutines were showing in Help >> Topics >> Subroutines

OPEN in direct mode returned to the direct mode screen too early

refactored legacy BGPLYING state variable

regression - random pop up messages after opening files

regression - it should not zoom out after processing a range

regression - pasting while zoomed in should not zoom out

other fixes and optimizations for various reasons

-----------------------------------------------------------------------------

Version 1.21

new features
------------
optional Windowed-Sinc interpolation implemented for resampling 
Help >> Options >> Interpolation

improved quality in the floating point routines and tone generators

new 14bit macros - 32bit to 14bit, 24bit to 14bit and 16bit to 14bit
use Open As Raw, then use the macros

shift Play All now acts as an unpause/restart function

Process >> Decode >> Deinterleave 24bit

Process >> Convert >> 16bit Flip - flips the byte order of a 16bit waveform

Process >> Filter >> Limit Noise - works like Contract but only on the lowest
dither level


updates
-------
transpose and finetune for octamed modules is now working

FINE= command to set the finetune (-8 to +7) for the next NOTE= command

NOTE= command expanded to allow note number or note name
NOTE=60 does the same as NOTE=C-6

the calculator fits underneath the oscilloscope and has an exit button

file requester support for gigabyte sized files

new saved files and recordings will appear in the file list sorted to the
correct position without a cache refresh

folder selection waits for mouse up and clicking can be cancelled by moving
off the item

mouse sets the position of the text cursor when editing the filename

the behaviour for using Range while Range Play is active has changed - it now
sets the range after mouse up instead of instantly on mouse down, also the
action can be cancelled by pressing the escape key before releasing the mouse

when opening in multi mode only position 1 will set the main frequency, other
modes always set the main frequency

other optimizations and edits for various reasons


bug fixes
---------
Process >> Resample >> By Rate had the from and to frequencies logically the
wrong way around

Repeat now works for the Resample subroutines without reopening their windows
 
the floppy distribution's powerpacker library was not compatible with 68000
for a500

the previous version source code, not the current version was included in the
lha distribution

removed need for _COPYSWAP _WORKSWAP in macros - demo2, triangular and
sawtooth macros updated

under some circumstances saving a stereo or quad iff had missing channels

***some 16SV files have a HI_LENGTH of half of what it should be, the BODY
size is used instead

opening octamed files will no longer purge the file list cache

fixed an interaction in the file requester when editing the text filename
then using other buttons

_REVERB and _PHASE can now be safely used in macros and sequences

_OPENASRAW no longer _STOPs and sets the mode to mono if the waveform is
loaded out-of-view

quad to multi macro updated to _NEW any existing waveforms in position 2, 3
and 4

other fixes and improvements for various reasons

-----------------------------------------------------------------------------

Version 1.20

new features
------------
File >> Open ... octamed modules can be rendered into waveforms

NOTE=C=1..B-6 command that lets macros and sequences set the piano note

Power Packer file decompression support


updates
-------
for the octamed rendering the variable buffer has increased to 160K, the
fxbox binary is around 340K

the system no longer stops play if a decoding is required after loading into
a bank that is out of view

improved quality of 32bit floating point conversion

Process >> Resample >> By Time in seconds

clickable Dither setting is now available Help >> Options

_PLAYALL is now just _PLAY

_ERASE is now just _NEW

added keyboard shortcut for _NEW, Amiga n

updated circle.asc, mixdown multi.asc and multi to quad.asc macros

new macro silence 1234.asc

new macro simple reverb.asc

new sequence shuttle.asc

SEQ command with no option can now print the sequence in direct mode

Help >> Flush Buffers to flush the sequence, variable buffers, arrays and
caches but not the waveforms

Mouse Zones are organized and allocated more efficiently

Library opening is now delayed until first use

_PLAYALL is now just _PLAY

_ERASE is now just _NEW

Resize renamed back to Size as it didn't "look" right

other source code updates and optimizations for various reasons


bug fixes
---------
Size by Time had problems parsing some time values only in the compiled
version

calculator now works when an fx window is open

_REWIND made the metronome go out of sync

a sequencer optimization means a500 can now play Demo1, but has a delayed
start

Demo2 seems to lockup on a500 and a1200 but can be stopped by holding the
spacebar

highlighting the time divisions sometimes had corruption with the colours

sequences no longer skip when using the scrolling macros menu

_OCTAVEUP and _OCTAVEDOWN now stay "in time" again after use

after a shift click Play Range to turn it off, the range was broken and
couldn't restart Range Play

failed _OPTIONS no longer exit the _OPTIONS window

various other bug fixes

-----------------------------------------------------------------------------

Version 1.19

new features
------------
Utilities >> Piano >> ... for live "playing" or "painting" sound into the
current waveform, see wiki

Edit >> Mix >> Amplitude maps the rms amplitude of the copy buffer onto the
waveform

Process >> Volume >> DC Halve removes the bottom half of the waveform

Process >> Encode/Decode >> Exponential Delta iff compression support

new macros - "Swap 5678" and "Swap 9101112" will swap all 4 in one move with
1234. Always Draw off for instant swap.

Edit >> Size updated Edit >> Resize >> By Size and By Time

Edit >> Swap >> ... new sub menu for quick swapping

sequencer now uses a dispatch queue for running background tasks


updates
-------
a sequence that repeats by reloading itself is now cached

extended the keyboard piano up a further 5 semi tones on both the lower and
upper decks

help updated and now accessible through Help >> Topics >> ...

main volume is no longer set when loading an iff

iff 'T','E','X','T' comment support and TEXT= command

_OPENASRAW now preserves the compression meta status if detected in header

shift click on Play Range and Play Display will deselect without resetting
the play position

other source code updates for various reasons


bug fixes
---------
build/make file updated due to the necessity of apcmp needing the memtrailer
patch running, see wiki

with range play, repositioning the single line play marker only worked when
loop was turned on

Edit >> Size didn't work in stereo or quad

the previous fudgy menu fix was incorrect, it created a problem with the
File >> sub menus, now resolved correctly

Show Range wasn't full screen on the left side

amos bank and octamed module loading now sets the meta NAME from the filename

meta data now cleared from memory using File >> New and Memory >> Erase All

with octamed modules not all 16 bit samples were converted automaticaly if
in multi track with a selected range !#$%

under some circumstances, running the command sequencer would cause errors
when using the menus

the tone generator window would also error if a certain type of sequence was
running

many TOAST notifications for subroutines were dependent on a previous
positive setting from an Ok button

-----------------------------------------------------------------------------

Version 1.18 (first aminet release)

new features
------------
File >> Save As >> Iff

File >> Save All >> Iff CAT concatenated iff file

Process >> Encode >> Fibonacci Delta

Process >> Decode >> Fibonacci Delta

iff parsing/loading improvements with meta data, multi octave, CATs, 16SVs,
24SVs and IESVs

File >> Properties window shows the meta data

NAME= (c)= AUTH= ANNO= commands to set the meta data for the current waveform

updates
-------
FREQ={1-96000} command to set the main frequency

VOL={0..64} command to set the main volume

SIZE={1..2147483647} command to set the size of the current waveform

expanded ea.iff.85.CHAN to include QUAD (RIGHT 4L LEFT 2L STEREO 6L QUAD 30L)

_WORKSWAP subroutine adds access to the work buffer for macros

triangular and sawtooth macros now store the user copy buffer in the work
buffer, restoring it when complete

interleave with the copy buffer is discontinued

interleave and deinterleave menu items moved to Process >> Encode/Decode >>

network config now defaults to the broadcast address 127.0.0.255

fxbox.cfg updated

other source code updates for various reasons

bug fixes
---------
new issue created in 1.17 fixed where the sample name and sizes in the header
were the previously selected details

_NOTEUP and _NOTEDOWN finished showing an incorrect frequency, the actual
frequency was correct

progress bar was left hanging at the end if running the subroutine from
direct mode

macros that used _COPY without a range left the full range selected after
completion

the filename in the header was not updated if a macro created a new "Unnamed"
filename

range select just a single line failed when the file was very big, selecting
a small chunk

if the time became over 99 hours due to very low frequency on very big files
the mix loop button graphic was corrupted

lag in the oscilloscope fixed

Piano would always switch to Range Play even if Display Play was active

switching to and from mode 4 with some empty banks carried over some
repeating distortion

setting the frequency in mode 4 with some empty banks corrupted the empty
play buffers causing repeating distortion

playing with looping turned off created the cyclical buffer without needing
to, playing a fraction of the start at the end

the Process >> menu had some fudgyness with its >> sub menus

resample _BYRATE _BYSIZE _BYBPM can now modify just a range in stereo and
quad

interleave range issues resolved

fixed typo in net sync NETWORK=TRU

-----------------------------------------------------------------------------

https://github.com/marc365/fxbox