Audio-Nama

 view release on metacpan or  search on metacpan

lib/Audio/Nama.pm  view on Meta::CPAN

    set the current sysex bank, i.e. the one that will be recorded. The current sysex back is the one affected by all sysex editing functions. 
getx
    return the current sysex bank or ``nil'' if none 
ci channame
    set the current (named) input channel. All input channel editing functions will act on it. 
geti
    return the name of the current input channel or ``nil'' if none 
co channame
    set the current (named) output channel. All output channel editing functions will act on it. 
geto
    return the name of the current output channel or ``nil'' if none 
setunit ticks_per_unit
    set the time resolution of the sequencer to ``tpu'' ticks in a whole note (1 unit note = 4 quarter notes). The default is 96 ticks, which is the default of the MIDI standard. 
getunit
    return the number of ticks in a whole note 
fac tempo_factor
    set the tempo factor for play and record to the given integer value. The tempo factor must be between 50 (play half of the real tempo) and 200 (play at twice the real tempo). 
getfac
    return the current tempo factor 
t beats_per_minute
    set the tempo at the current song position 
mins amount {num denom}
    insert ``amount'' blank measures at the current song position. The time signature used is num/denom. If the time signature is an empty list (i.e. ``{}'') then the time signature at the current position is used. 
mcut
    cut the current selection of all tracks, including the time structure. 
mdup where
    duplicate the current selection inserting a copy of it at the position given by the ``where'' parameter. The target position is a measure number relative to the current selection to be copied. If ``where'' is positive it's relative to the end of ...
minfo
    print the meta-track (tempo changes, time signature changes. 
mtempo
    Return the tempo at the current song position. The unit is beats per minute. 
msig
    Return the time signature at the current song position. The result is a two number list: numerator and denominator. 
mend
    Return the ending measure of the song (i.e. its size in measures). 
ls
    list all tracks, channels, filters and various default values 
save filename
    save the song into the given file. The ``filename'' is a quoted string. 
load filename
    load the song from a file named ``filename''. the current song is destroyed, even if the load command fails. 
reset
    destroy completely the song, useful to start a new song without restarting the program 
export filename
    save the song into a standard MIDI file, ``filename'' is a quoted string. 
import filename
    load the song from a standard MIDI file, ``filename'' is a quoted string. Only MIDI file ``type 1'' and ``type 0'' are supported. 
dlist
    return the list of attached devices (list of numbers) 
dnew devnum filename mode
    attach MIDI device ``filename'' as device number ``devnum''; ``filename'' is a quoted string. The ``mode'' argument is the name of the mode, it can be on if the following:

        ``ro'' - read-only, for input only devices
        ``wo'' - write-only, for output only devices
        ``rw'' - read and write. 

    If midish is configured to use ALSA (default on Linux systems) then ``filename'' should contain the ALSA sequencer port, as listed by ``aseqdump -l'', (eg. ``28:0'', ``FLUID Synth (qsynth)''). If ``nil'' is given instead of the path, then the por...
ddel devnum
    detach device number ``devnum'' 
dmtcrx devnum
    use device number ``devnum'' as MTC source. In this case, midish will relocate, start and stop according to incoming MTC messages. Midish will generate its clock ticks from MTC, meaning that it will run at the same speed as the MTC device. This i...
dmmctx { devnum1 devnum2 ... }
    Configure the given devices to transmit MMC start, stop and relocate messages. Useful to control MMC-capable audio applications from midish. By default, devices transmit MMC. 
dclktx { devnum1 devnum2 ... }
    Configure the given devices to transmit MIDI clock information (MIDI ticks, MIDI start and MIDI stop events). Useful to synchronize an external sequencer to midish. 
dclkrx devnum
    set device number ``devnum'' to be the master MIDI clock source. It will give midish MIDI ticks, MIDI start and MIDI stop events. This useful to synchronize midish to an external sequencer. If ``devnum'' is ``nil'', then the internal clock will b...
dclkrate devnum ticrate
    set the number of ticks in a whole note that are transmitted to the MIDI device (if dclktx was called for it). Default value is 96 ticks. This is the standard MIDI value and its not recommended to change it. 
dinfo devnum
    Print some information about the MIDI device. 
dixctl devnum list
    Setup the list of controllers that are expected to be received as 14-bit numbers (i.e. both coarse and fine MIDI controller messages will be expected). By default only coarse values are used, if unsure let this list empty. 
devoxctl devnum list
    Setup the list of controllers that will be transmitted as 14-bit numbers (both coarse and fine MIDI controller messages). 
diev devnum list
    Configure the device to process as a single event the following patterns of input MIDI messages.

        ``xpc'' - group bank select controllers (0 and 32) with program changes into a signle ``xpc'' event.
        ``nrpn'' - group NRPN controllers (98 and 99) with data entry controllers (6 and 38) into a single ``nrpn'' event.
        ``rpn'' - same as ``nrpn'', but for RPN controllers (100 and 101). 

    By default all of the above are enabled, which allows banks, NRPNs and RPNs to be handled by midish the standard way. It makes sense to disable grouping of above messages on rare hardware that maps above-mentioned controller numbers (0, 6, 32, 38...
doev devnum list
    Same as diev but for output MIDI messages. 
ctlconf ctlname ctlnumber defval
    Configure controller number ``ctlnumber'' with name ``ctlname'', and default value ``defval''. If defval is ``nil'' then there is no default value and corresponding controller events are not grouped into frames. See sec. Controller frames. 
ctlconfx ctlname ctlnumber defval
    Same as ctlconf function, but for 14-bit controllers. Thus defval is in the range 0..16383. 
ctlconf ctlname
    Unconfigure the given controller. ``ctlname'' is the identifier that was used with ctlconf 
ctlinfo
    Print the list of configured controllers 
evpat name sysex_pattern
    Define a new event type corresponding to the given system exclusive message pattern. The pattern is a list of bytes or event parameter identifiers (aka atoms). The following atoms are supported: v0, v0_lo, v0_hi, v1, v1_lo, v1_hi. They correspond...

    evpat master {0xf0 0x7f 0x7f 0x04 0x01 v0_lo v0_hi 0xf7}

    defines a new event type for the standard master volume system exclusive message. 
evinfo
    Print the list of event patterns. 
m mode
    Set the mode of the metronome. The following modes are available:

        ``on'' - turned on for both playback and record
        ``rec'' - turned on for record only
        ``off'' - turned off 

metrocf eventhi eventlo
    select the notes that the metronome plays. The pair of events must be note-ons 
info
    display the list of built-in and user-defined procedures and global variables 
print expression
    display the value of the expression 
err string
    display the given string and abort the statement being executed. 
h funcname
    display list of arguments function ``funcname'' 
exec filename
    read and executes the script from a file, ``filename'' is a quoted string. The execution of the script is aborted on error. If the script executes an exit statement, only the script is terminated. 
debug flag val
    set debug-flag ``flag'' to (integer) value ``val''. It's a developer knob. If ``val=0'' the corresponding debug-info are turned off. ``flag'' can be:

        ``filt'' - show events passing through the current filter
        ``mididev'' - show raw MIDI traffic on stderr
        ``mixout'' - show conflicts in the output MIDI merger
        ``norm'' - show events in the input normalizer



( run in 1.069 second using v1.01-cache-2.11-cpan-0bb4e1dffa6 )