Orca é uma linguagem de programação esotérica e editor ao vivo projetado para criar sequenciadores procedurais rapidamente. Cada letra do alfabeto é uma operação, letras minúsculas são executadas em *bang*
e letras maiúsculas executam cada quadro.
Esta é a implementação C da linguagem ORCΛ e do ambiente de livecoding do terminal. Ele foi projetado para ser eficiente em termos de energia. Ele pode lidar com arquivos grandes, mesmo que seu terminal seja pequeno.
Orca não é um sintetizador, mas um ambiente de livecoding flexível capaz de enviar MIDI, OSC e UDP para suas interfaces audiovisuais como Ableton, Renoise, VCV Rack ou SuperCollider.
Repositório git principal | Espelho GitHub |
---|---|
git.sr.ht/~rabbits/orca | github.com/hundredrabbits/Orca-c |
sudo apt-get install git libncurses5-dev libncursesw5-dev libportmidi-dev
git clone https://github.com/hundredrabbits/Orca-c.git
cd Orca-c
make # Compile orca
build/orca # Run orca
Para escolher seu dispositivo de saída MIDI, pressione F1
(ou Ctrl+D
) para abrir o menu principal e selecione MIDI Output...
┌ ORCA ───────────────┐┌ PortMidi Device Selection ─────┐
│ New ││ > (*) #0 - Midi Through Port-0 │
│ Open... ││ ( ) #2 - ES1371 │
│ Save │└────────────────────────────────┘
│ Save As... │
│ │
│ Set BPM... │
│ Set Grid Size... │
│ Auto-fit Grid │
│ │
│ OSC Output... │
│ > MIDI Output... │
│ │
│ Clock & Timing... │
│.....................│
Biblioteca principal: um compilador C99 (sem necessidade de VLAs), além de libc suficiente para malloc
, realloc
, free
, memcpy
, memset
e memmove
. (Além disso, #pragma once
deve ser suportado.)
Intérprete de linha de comando: O acima, mais POSIX e libc suficiente para operações de string comuns ( strlen
, strcmp
, etc.)
UI do terminal de codificação ao vivo: acima, além de ncurses (ou biblioteca de Curses compatível) e suporte de ponto flutuante (para temporização). Opcionalmente, PortMidi pode ser usado para ativar a saída MIDI direta.
O script de construção, chamado simplesmente tool
, é escrito em POSIX sh
. Ele deve funcionar com gcc
(incluindo o wrapper musl-gcc
), tcc
e clang
e detectará automaticamente seu compilador. Você pode especificar manualmente um compilador com a opção -c
.
Atualmente conhecido por ser compilado em macOS ( gcc
, clang
, tcc
) e Linux ( gcc
, musl-gcc
, tcc
e clang
, opcionalmente com LLD
) e Windows via cygwin ou WSL ( gcc
ou clang
, tcc
não testado).
Há um wrapper make
do tipo "dispare e esqueça" em torno do script de construção.
PortMidi é uma dependência opcional. Ele pode ser habilitado adicionando a opção --portmidi
ao executar o script de construção tool
.
O reconhecimento do mouse pode ser desativado adicionando a opção --no-mouse
.
tool
Execute ./tool help
para ver informações de uso. Exemplos:
./tool build -c clang-7 --portmidi orca
# Build the livecoding environment with a compiler
# named clang-7, with optimizations enabled, and
# with PortMidi enabled for MIDI output.
# Binary placed at build/orca
./tool build -d orca
# Debug build of the livecoding environment.
# Binary placed at build/debug/orca
./tool build -d cli
# Debug build of the headless CLI interpreter.
# Binary placed at build/debug/cli
./tool clean
# Same as make clean. Removes build/
make
make release # optimized build, binary placed at build/orca
make debug # debugging build, binary placed at build/debug/orca
make clean # removes build/
O wrapper make
ativará --portmidi
por padrão. Se você executar o script de construção tool
sozinho, --portmidi
não será habilitado por padrão.
orca
Livecoding Usage: orca [options] [file]
General options:
--undo-limit <number> Set the maximum number of undo steps.
If you plan to work with large files,
set this to a low number.
Default: 100
--initial-size <nxn> When creating a new grid file, use these
starting dimensions.
--bpm <number> Set the tempo (beats per minute).
Default: 120
--seed <number> Set the seed for the random function.
Default: 1
-h or --help Print this message and exit.
OSC/MIDI options:
--strict-timing
Reduce the timing jitter of outgoing MIDI and OSC messages.
Uses more CPU time.
--osc-midi-bidule <path>
Set MIDI to be sent via OSC formatted for Plogue Bidule.
The path argument is the path of the Plogue OSC MIDI device.
Example: /OSC_MIDI_0/MIDI
orca
com saída MIDI $ ./tool build --portmidi orca # compile orca using build script
$ build/orca # run orca
orca
Livecoding ┌ Controls ───────────────────────────────────────────┐
│ Ctrl+Q Quit │
│ Arrow Keys Move Cursor │
│ Ctrl+D or F1 Open Main Menu │
│ 0-9, A-Z, a-z, Insert Character │
│ ! : % / = # * │
│ Spacebar Play/Pause │
│ Ctrl+Z or Ctrl+U Undo │
│ Ctrl+X Cut │
│ Ctrl+C Copy │
│ Ctrl+V Paste │
│ Ctrl+S Save │
│ Ctrl+F Frame Step Forward │
│ Ctrl+R Reset Frame Number │
│ Ctrl+I or Insert Append/Overwrite Mode │
│ ' (quote) Rectangle Selection Mode │
│ Shift+Arrow Keys Adjust Rectangle Selection │
│ Alt+Arrow Keys Slide Selection │
│ ` (grave) or ~ Slide Selection Mode │
│ Escape Return to Normal Mode or Deselect │
│ ( ) _ + [ ] { } Adjust Grid Size and Rulers │
│ < and > Adjust BPM │
│ ? Controls (this message) │
└─────────────────────────────────────────────────────┘
cli
A CLI (binário cli
) lê um arquivo e executa a simulação orca por 1 timestep (padrão) ou um número especificado (opção -t
) e grava o estado resultante da grade em stdout.
cli [-t timesteps] infile
Você também pode fazer com que cli
seja lido no stdin:
echo -e " ...na34n... " | cli /dev/stdin