ecasound - Online sa Cloud

PROGRAMA:

NAME

ecasound - sample na editor, multitrack recorder, fx-processor, atbp.

SINOPSIS

ecasound [ general_options ] { [ chain_setup ] [ effect_setup ] [ input_setup ] [
output_setup ] }

DESCRIPTION

Ang Ecasound ay isang software package na idinisenyo para sa multitrack audio processing. Maaari itong gamitin
para sa mga simpleng gawain tulad ng audio playback, pag-record at mga conversion ng format, pati na rin para sa
multitrack effect processing, mixing, recording at signal recycling. Sinusuportahan ng Ecasound a
malawak na hanay ng mga audio input, output at effect algorithm. Maaari ang mga effect at audio object
ay pinagsama sa iba't ibang paraan, at ang kanilang mga parameter ay maaaring kontrolin ng mga bagay ng operator
tulad ng mga oscillator at MIDI-CC. Ang isang versatile console mode user-interface ay kasama sa
Pakete.

Opsyon

Tandaan! Lahat ng mga opsyon maliban sa mga nabanggit sa ecasound pagpipilian at Global pagpipilian, ay maaaring maging
ginagamit sa mga ecasound chainsetup file (.ecs).

ECASOUND Opsyon

Ang mga opsyong ito ay na-parse at pinangangasiwaan ng ecasound frontend binary at hindi
ipinasa sa backend library. Nangangahulugan ito na ang mga opsyong ito ay maaaring hindi gumana sa iba
mga application na gumagamit ng mga ecasound library para sa kanilang functionality.

-c Nagsisimula ang ecasound sa interactive na mode. Sa interactive na mode maaari mong kontrolin ang ecasound
na may mga simpleng utos ("simula", "stop", "pause", atbp.). Tingnan ang ecasound-iam .

-C Hindi pinapagana ang interactive na mode ng ecasound (tingnan ang '-c' at '-K').

-D I-print ang lahat ng impormasyon sa pag-debug sa stderr (unbuffered, plain output na walang ncurses).

-s[:]chainsetup-file
Gumawa ng bagong chainsetup mula sa file na 'chainsetup-file' at idagdag ito sa kasalukuyang
session. Ang mga Chainsetup file ay karaniwang may filename na nagtatapos sa '.ecs' extension.
Ang isang chainsetup ay maaaring maglaman ng mga input, output, chain, effect, controllers -- ibig sabihin
bagay sa isang partikular na configuration ng mga elemento ng pagpoproseso ng audio. Isang session, sa
sa kabilang banda, ay isang koleksyon ng isa o higit pang mga chainsetup. Isa lamang sa mga
ang mga chainsetup ay maaaring konektado (ibig sabihin, maaari itong patakbuhin/iproseso). Ngunit posible na
magkaroon ng isa pang chainsetup piliin (ibig sabihin ay maaaring i-configure) habang ang isa ay kasalukuyang
connteced (ibig sabihin tumatakbo).

-E "cmd1 [[args] ; cmd2 args ; ... ; cmdN]"
Magsagawa ng isang set ng Ecasound Interactive mode (EIAM) na utos sa paglulunsad. Ang mga ito
Ang mga utos ay isinasagawa kaagad pagkatapos magsimula ng ecasound. Kung ang command line
naglalaman ng sapat na mga pagpipilian upang lumikha ng isang wastong chainsetup na isasagawa, ang
ang mga utos ng paglulunsad ay isinasagawa pagkatapos ma-parse ang iba pang mga opsyon sa command line, ngunit
bago simulan ang processing engine. Tandaan na ang utos na ito ay isang tampok ng
ecasound frontend binary at hindi sinusuportahan ng backend ng library. Ibig sabihin nito
maaaring hindi sinusuportahan ng ibang mga kliyente ang '-E' na opsyon, at gayundin ang mga utos ng paglunsad
ay hindi nai-save bilang bahagi ng chainsetup o estado ng session.

--server
Pinapagana ang tinatawag na NetECI mode, kung saan ang ecasound ay maaaring kontrolin nang malayuan
sa isang socket na koneksyon. Kapag na-activate, maaaring kumonekta ang mga kliyente sa pagtakbo
ecasound session, at gumamit ng mga interactive na mode command para kontrolin at obserbahan ang ecasound
pagpoproseso.

Ang NetECI protocol ay tinukoy sa Gabay sa Programmer ng Ecasound

Ang isang halimbawa ng kliyente na gumagamit ng tampok na ito ay ecamonitor(1). Ang utility na ito ay kasama sa
ang pakete ng pamamahagi ng Ecasound (nangangailangan ng isang gumaganang kapaligiran sa Python).

Babala! Kung ang makina na tumatakbo sa ecasound, ay konektado sa isang pampublikong network, siguraduhing
para harangan ang port ng ecasound sa iyong firewall! Dahil walang access control
ipinatupad para sa mga papasok na koneksyon, kahit sino ay maaaring kumonekta, kontrolin at
obserbahan ang iyong mga ecasound session. Pinapalitan ng opsyong ito ang '--daemon' (hindi na ginagamit sa
2.6.0).

--server-tcp-port=NNN
Itakda ang TCP port na ginagamit ng daemon mode. Bilang default, gagamit ang ecasound ng port number
2868. Pinapalitan ng opsyong ito ang '--daemon-port' (hindi na ginagamit sa 2.6.0).

--walang-server
Huwag paganahin ang daemon mode ng ecasound. Ito ang default. Pinapalitan ng pagpipiliang ito
'--nodaemon' (hindi na ginagamit sa 2.6.0).

--osc-udp-port=NNN
Pinapagana ang suporta para sa Open Source Control (OSC). Makikinig ang Ecasound para sa papasok
Mga mensahe ng OSC sa UDP port NNN. Ang OSC interface ng Ecasound ay nakadokumento sa:
<http://ecasound.git.sourceforge.net/git/gitweb.cgi?p=ecasound/ecasound;a=blob;f=Documentation/ecasound_osc_interface.txt;hb=HEAD>

Tandaan na ang suporta sa OSC ay pang-eksperimento pa rin at maaaring magbago ang interface sa ibang pagkakataon
mga bersyon ng Ecasound.

Idinagdag ang opsyong ito sa ecasound 2.7.0.

--patuloy-takbo,-K
Huwag lumabas kapag ang pagproseso ay tapos na/itinigil. Nakakaapekto lamang sa hindi interactive
operating mode (tingnan ang -c/-C). Idinagdag ang opsyon sa ecasound 2.4.2.

--tulong,-h
Ipakita ang tulong na ito.

--bersyon
Impormasyon sa bersyon ng pag-print.

Global Opsyon

-d, -dd, -ddd
Dagdagan ang dami ng mga naka-print na mensahe sa pag-debug. -d nagdadagdag ng ilang verbosity, habang -ddd
nagreresulta sa napakadetalyadong output.

-d:debug_level
Itakda ang debug level mask sa 'debug_level'. Ito ay isang bitmasked na halaga sa
sumusunod na mga klase: mga error (1), impormasyon (2), mga subsystem (4), module_names (8),
user_objects (16), system_objects 32, functions (64), tuloy-tuloy (128) at
eiam_return_values ​​(256). Ang default ay 271 (1+2+4+8+256). Tingnan ang dokumentasyon ng sourcode
para sa klase ng ECA_LOGGER para sa mas detalyadong impormasyon.

-R[:]path-to-file
Gamitin ang ecasound resource file (tingnan ang ecasoundrc man page) 'path-to-file' bilang ang tanging
pinagmulan ng pagtatakda ng halaga ng mapagkukunan. Ang pagtukoy sa opsyong ito ay hindi papaganahin ang normal
patakaran ng pag-query sa parehong global at user (kung mayroon) resource file.

-q Tahimik na mode, walang output. Katulad ng -d:0.

PANGKALAHATAN CHAINSETUP Opsyon

-a:chainname1, chainname2, ...
Pinipili ang mga aktibong chain ng signal. Ang lahat ng mga input at output na sumusunod sa '-a' na opsyon ay
itinalaga sa mga napiling chain (hanggang sa isang bagong -isang opsyon ay tinukoy). Kapag nagdadagdag
effect, controllers at iba pang chain operator, isang chain lang ang mapipili sa a
oras. Kung walang ibinigay na opsyon, chain 'default' ang ginagamit sa halip kapag nagdadagdag
mga bagay. Ang pangalan ng chain na 'lahat' ay nakalaan din. Ito ay magiging sanhi ng lahat ng umiiral na mga kadena
mapili. Sa pamamagitan ng pagbibigay ng maramihang -a na opsyon, makokontrol mo kung aling mga chain
mga epekto, input at output ay itinalaga sa. Tingnan mo ang HALIMBAWA seksyon para sa higit pa
detalyadong impormasyon tungkol sa paggamit ng opsyong ito.

-n: pangalan
Itinatakda ang pangalan ng chainsetup sa 'pangalan'. Kung hindi tinukoy, ang default ay sa
"command-line-setup" o sa pangalan ng file kung saan na-load ang chainsetup.
Hindi pinapayagan ang mga whitespace.

-x Putulin ang mga output. Ang lahat ng output object ay binuksan sa overwrite mode. Anumang umiiral
puputulin ang mga file.

-X Buksan ang mga output para sa pag-update. Binubuksan ng Ecasound ang lahat ng mga output - kung pinapayagan ito ng target na format
- sa readwrite mode.

-z: tampok
Pinapagana ang 'feature'. Maaaring i-disable ang karamihan sa mga feature gamit ang notation -z: walang feature.
'-z:db,dbsize' ay nagbibigay-daan sa double-buffering para sa mga audio object na sumusuporta dito (dbsize=0
para sa default, kung hindi, laki ng buffer sa mga sample na frame). Hindi pinapagana ang '-z:nodb'
double-buffering. Kinokontrol ng '-z:intbuf' at '-z:nointbuf' kung extra internal
pinapayagan ang buffering para sa mga realtime na device. Ang hindi pagpapagana nito ay maaaring mabawasan ang mga oras ng latency
sa ilang sitwasyon. Gamit ang '-z:xruns', ihihinto ang pagpoproseso kung may under/overrun
nangyayari. Maaaring gamitin ang '-z:multitrack' at 'z:nomultitrack' upang pilitin ang ecasound
paganahin o huwag paganahin ang multitrack-mode. Sa mga bihirang kaso maaaring gusto mong tahasang tukuyin
ang recording offset na may '-z:multitrack,offset-in-samples'. Ang offset ay ang
dami ng mga sample na nilaktawan kapag nagre-record mula sa mga real-time na input. '-z:psr' ay nagbibigay-daan
ang tumpak-sample-rate mode para sa mga OSS-device. '-z:mixmode,sum' ay nagbibigay-daan sa mixing mode
kung saan pinaghalo ang mga channel sa pamamagitan ng pagsusuma ng lahat ng channel. Ang default ay '-z:mixmode,avg',
kung saan ang mga channel ay pinaghalo sa pamamagitan ng pag-average. Ang pagpili ng Mixmode ay unang idinagdag sa
ecasound 2.4.0. Tingnan ang ecasoundrc man page.

CHAINSETUP BUFFERING AT PAGGANAP Opsyon

-B:buffering_mode
Pinipili ang default na buffering mode. Ang mode ay isa sa: 'auto' (default), 'nonrt',
'rt', 'rtlowlatency'.

-b:buffer_size
Itinatakda ang laki ng buffer ng processing engine sa mga sample. Ang laki ay dapat na isang exponent ng
2, at ito ay independiyente sa bilang ng channel (hal -b:1024 sa 48kHz ay ​​magreresulta sa
21.333ms buffer haba kung mono, stereo o 5.1 ang input).

Ito ay isang mahalagang opsyon dahil tinutukoy nito ang haba ng isang processing engine
pag-ulit at nakakaapekto sa pag-uugali ng ecasound sa maraming paraan. Kung hindi tahasang tinukoy,
susubukan ng ecasound na pumili ng pinakamainam na halaga batay sa kasalukuyang buffering mode (tingnan ang
-B opsyon). Para sa real-time na pagpoproseso, maaari mong subukang itakda ito sa pinakamababa hangga't maaari
bawasan ang pagkaantala sa pagproseso. Ang ilang mga makina ay maaaring humawak ng mga halaga ng buffer na kasingbaba ng 64
at 128. Sa ilang mga pagkakataon (halimbawa kapag gumagamit ng mga sobre ng oscillator) maliit
Ang mga laki ng buffer ay gagawing mas maayos ang pagkilos ng mga sobre. Kapag hindi pinoproseso sa
real-time (lahat ng mga input at output ay normal na mga file), maaaring makatulong ang mas malalaking halaga
maiwasan ang mga buffer overrun, babaan ang paggamit ng CPU at/o kung hindi man ay mapabuti ang performance.

Tandaan na kapag ginamit ang anumang JACK input/output, ang setting ng laki ng buffer ay
na-override at nakatakda sa tagal/laki ng buffer na iniulat ng JACK server (hal. jackd's '-p'
opsyon). Hindi posibleng i-off ang gawi na ito.

Kung hindi tahasang tinukoy, ang default na laki ng buffer ay pipiliin batay sa kasalukuyang
buffering mode (tingnan -B).

-r:sched_priority
Gumamit ng realtime na patakaran sa pag-iiskedyul (SCHED_FIFO). Ito ay imposible kung ang ecasound ay hindi
may mga pribilehiyong ugat. Mag-ingat! Nagbibigay ito ng mas mahusay na pagganap, ngunit maaaring maging sanhi ng kabuuan
lock-up kung may nangyaring mali. Ang 'sched_priority' ay maaaring alisin (0=omitted).
Kung ibinigay, ito ang static na priyoridad sa pinakamataas na priyoridad na ecasound thread.
Ang iba pang mga ecasound thread ay tumatakbo na may priyoridad na 'sched_priority-1...n'. Ang halagang '-1' ay maaaring
ginamit upang huwag paganahin ang mode na nakataas na priyoridad.

-z: tampok
Ang mga nauugnay na feature ay -z:db,xxx (-z:nodb) at -z:intbuf (-z:nointbuf). Tingnan ang seksyon
Pangkalahatan chainsetup pagpipilian para sa mga detalye.

PAMAMARAAN Kontrol

-t: segundo
Itinatakda ang oras ng pagproseso sa mga segundo (hindi kailangang maging isang integer na halaga). Kung
hindi nakatakda ang oras ng pagpoproseso, hihinto ang makina kapag natapos na ang lahat ng input. Ang pagpipiliang ito
ay katumbas ng 'cs-set-length' na utos ng EIAM. Isang espesyal na case na halaga ng '-1'
itatakda ang haba ng chainsetup ayon sa pinakamahabang input object.

-tl Pinapagana ang pag-loop. Kapag natapos na ang pagproseso, magsisimula muli ang makina mula sa
simula. Ang opsyong ito ay katumbas ng 'cs-loop' na EIAM na utos.

INPUT / OUTPUT SETUP

Tingnan ang gabay ng gumagamit ng ecasound para sa mas detalyadong dokumentasyon.

-G:mgrtype,optstring
Nagtatakda ng mga opsyon para sa uri ng audio object manager na 'mgrtype'. Para sa mga available na opsyon, tingnan
"Mga Tiyak na URI NG BAGAY NA TALA" sa ibaba.

-f:sample_format,channel,sample-rate,interleaving
Itinatakda ang mga parameter ng audio stream para sa mga kasunod na audio object. Upang magtakda ng iba
mga parameter para sa iba't ibang audio object, kailangang tukuyin ang maraming '-f' na opsyon
(tandaan ang pag-order, ang '-f' na mga opsyon ay dapat mauna sa mga audio object para sa kanila
magkaroon ng anumang epekto). Tingnan ang dokumentasyon para sa '-i' at '-o' na mga opsyon.

Kapag ang isang audio object ay binuksan (hal. isang file o sound device ay binuksan, o
ang koneksyon ay ginawa sa isang sound server), ang mga parameter ng audio stream ay ipinapasa sa
ang bagay. Dapat tandaan na hindi lahat ng audio object ay nagpapahintulot sa isa na magtakda ng anuman o
lahat ng mga parameter. Halimbawa kapag binubuksan ang mga umiiral nang audio file, maraming file
ang mga format ay may header na naglalarawan sa mga parameter ng audio ng file. Sa mga kasong ito ang
Ino-override ng header ng audio file ang mga parameter na ipinasa gamit ang '-f' na opsyon. Katulad noong
paglikha ng mga input at output ng JACK, ipinag-uutos ng server ng JACK ang sampling rate at
sample na format.

Kung walang '-f' na opsyon na tinukoy, o ang ilan sa mga field ng argumento ay naiwang walang laman (hal
'-f:,2,44100'), gagamit ang ecasound ng mga default na halaga. Ang mga default na halaga ay tinukoy
sa ecasoundrc configuration file. Tingnan mo ecasoundrc(5) manu-manong pahina.

Tandaan na ang ecasound ay nagbubukas ng mga file bilang default sa update mode. Maliban kung opsyon '-x'
(I-overwrite ang mga output) na opsyon ay ibinigay, mga parameter ng audio ng isang umiiral na audio file
kunin ang kagustuhan sa mga params na itinakda na may '-f'.

Ibinibigay ang sample na format bilang na-format na string. Ang unang titik ay alinman sa "u", "s"
at "f" (unsigned, signed, floating point). Ang sumusunod na numero ay tumutukoy sa sample
laki sa bits. Kung maliit na endian ang sample, idinaragdag ang "_le" sa dulo. Katulad din kung
malaking endian, "_be" ay idinagdag. Kung ang endianness ay hindi tinukoy, ang host byte-order ay
ginamit. Ang mga kasalukuyang sinusuportahang format ay "u8" (kapareho ng "8"), "s16_le" (kapareho ng "16"),
"s16_be", "s24_le", "s24_be", "s32_le", "s32_be", "f32_le" at "f32_be". Isang walang laman
Pinipili ng string "" ang default na sample na format ng system.

Tinutukoy ng ika-4 na parameter ang layout ng channel. Ang mga magagamit na opsyon ay 'i'
(interleaved' at 'n' (noninterleaved). Gamit ang noninterleaved setting, ecasound
ay magpoproseso ng mga sample ng isang channel sa isang pagkakataon, at ang blocksize ay nakatakda sa '-b'.
Ang default na setting ay 'i'.

-y: segundo
Itinatakda ang panimulang posisyon para sa huling tinukoy na input/output. Kung kailangan mo ng mas flexible
kontrol sa mga audio object, dapat mong gamitin ang .ewf format.

-i[:]input-file-o-device[,params]
Tumutukoy ng bagong input source na konektado sa lahat ng napiling chain (chain ay
pinili gamit ang '-a:...'). Ang pagkonekta ng maraming input sa parehong chain ay hindi
posible, ngunit ang isang input ay maaaring konektado sa maraming chain. Ang input ay maaaring isang file,
device o iba pang audio object (tingnan sa ibaba). Kung ang input ay isang file, ang uri nito ay
tinutukoy gamit ang extension ng pangalan ng file. Kung ang pangalan ng bagay ay naglalaman ng anumang mga kuwit,
ang pangalan ay dapat na nakapaloob sa backquotes upang maiwasang malito ang parser. Kasalukuyan
ang mga sinusuportahang format ay RIFF WAVE file (.wav), audio-cd track (.cdr), ecasound EWF
file (.ewf), RAW audio data (.raw) at MPEG audio file (.mp2,.mp3). Higit pang audio
ang mga format ay sinusuportahan sa pamamagitan ng libaudiofile at libsndfile na mga aklatan (tingnan ang dokumentasyon
sa ibaba). Sinusuportahan din ang MikMod (.xm, .mod, .s3m, .it, atbp). Ang mga MIDI file (.mid) ay
suportado gamit ang Timidity++. Katulad nito, ang Ogg Vorbis (.ogg) ay maaaring basahin, at isulat
kung naka-install ang ogg123 at vorbize tool; FLAC file (.flac) na may flac
command-line tool o paggamit ng libsndfile; at AAC file (.aac/.m4a/.mp4) na may
faad2/faac tool. Ang mga sinusuportahang realtime na device ay mga OSS audio device (/dev/dsp*),
ALSA audio at loopback device at JACK audio subsystem. Kung walang input ay
tinukoy, ang unang hindi opsyon (hindi nagsisimula sa '-') command line argument ay
itinuturing na isang input.

-o[:]output-file-o-device[,params]
Gumagana sa parehong paraan tulad ng -i na opsyon. Kung walang mga output na tinukoy, ang default
ginagamit ang output device (tingnan ~/.ecasoundrc). Kung ang pangalan ng bagay ay naglalaman ng anumang mga kuwit,
ang pangalan ay dapat na nakapaloob sa backquotes upang maiwasang malito ang parser. Tandaan, marami
Ang mga uri ng bagay ay hindi sumusuporta sa output (hal. MikMod, MIDI at marami pang iba).

LAYUNIN TYPE TIYAK NOTA

Mga ALSA device - 'alsa'
Kapag gumagamit ng mga driver ng ALSA, sa halip na isang filename ng device, kailangan mong gamitin ang
sumusunod na pagpipiliang syntax: -i[:]alsa,pcm_device_name.

ALSA direct-hw at plugin access - 'alsahw', 'alsaplugin'
Posible ring gumamit ng partikular na kumbinasyon ng card at device gamit ang
sumusunod na notasyon: -i[:]alsahw,card_number,device_number,subdevice_number.
Ang isa pang pagpipilian ay ang layer ng plugin ng ALSA PCM. Gumagana ito tulad ng normal na ALSA
pcm-device, ngunit may awtomatikong bilang ng channel at mga conversion ng sample na format. Pagpipilian
ang syntax ay -i[:]alsaplugin,card_number,device_number,subdevice_number.

aRts input/output - 'arts'
Kung pinagana sa oras ng pag-compile, sinusuportahan ng ecasound ang audio input at output gamit ang mga aRts
server ng audio. Ang pagpipiliang syntax ay -i: sining, -o: sining.

Pagkakasunod-sunod ng audio file - 'audioloop', 'select', 'playat'
Nagbibigay ang Ecasound ng isang hanay ng mga espesyal na uri ng audio object na maaaring magamit para sa temporal
pagkakasunud-sunod ng mga audio file - ibig sabihin, pag-loop, paglalaro lamang ng isang piling bahagi ng isang file,
paglalaro ng file sa isang tiyak na oras, at iba pang ganoong operasyon.

Ang pag-looping ay posible sa -i:audioloop,file.ext,params. Ang pangalan ng file (o anumang bagay
uri na naiintindihan ng Ecasound) na ibinigay bilang ang pangalawang parameter ay nilalaro pabalik
patuloy na pag-loop pabalik sa simula kapag naabot na ang dulo ng file. Anuman
Ang mga karagdagang parameter na ibinigay ay ipinasa nang hindi nababago sa object ng file. Mga Parameter
3...N ay ipinapasa gaya ng sa child object (ibig sabihin "-i audioloop,foo.wav,bar1,bar2"
ay ipapasa ang mga parameter na "bar1,bar2" sa object na "foo.wav".

Upang pumili at gumamit lamang ng isang partikular na segment ng isang audio object, ang
-i:select,start-time,duration,file.ext,params maaaring gamitin. Maglalaro ito
"tagal" ng "file.ext", simula sa "oras ng pagsisimula". Ang mga halaga ng oras ay dapat ibigay
bilang mga segundo (hal. "2.25", o bilang mga sample (hal. "25000sa"). Ang mga Parameter 4...N ay
naipasa bilang ay sa bata object.

Upang i-play ang isang audio object sa isang naibigay na sandali sa oras, ang
-i:playat,play-at-time,file.ext,params maaaring gamitin. Ipe-play nito ang "file.ext" pagkatapos
ang posisyon ay umabot sa "play-at-time". Ang mga halaga ng oras ay dapat ibigay bilang mga segundo (hal
"2.25", o bilang mga sample (hal. "25000sa"). Ang mga parameter 2...N ay ipinasa gaya ng sa
bagay na bata.

Ecasound Wave Files (EWF) - '*.ewf'
Isang espesyal na format ng file na nagbibigay-daan sa isa na maghiwa at mag-loop ng buo (o mga segment) ng audio
mga file. Ang format na ito ay partikular sa Ecasound. Tingnan ang gabay ng gumagamit ng ecasound para sa higit pa
Detalyadong impormasyon.

Tingnan din ang mga uri ng audio object na 'audioloop', 'select' at 'playat'.

JACK input/outputs - Pangkalahatang-ideya
Ang JACK ay isang low-latency na audio server na maaaring magamit upang kumonekta sa maramihang independyente
audio application sa bawat isa. Ito ay naiiba sa iba pang pagsisikap ng server ng audio
dahil ito ay idinisenyo mula sa simula upang maging angkop para sa mababang latency
propesyonal na audio work.

JACK input/outputs - 'jack'
Nagbibigay ang Ecasound ng maraming paraan para makipag-ugnayan sa mga server ng JACK. Upang lumikha ng isang JACK
input o output object, dapat gamitin ng isa -i diyak at -o diyak. Lumilikha ito ng JACK
client port "ecasound:in_N" at "ecasound:out_n" ayon sa pagkakabanggit ('N' ay pinalitan ng
ang numero ng channel). Awtomatikong gumagawa ang Ecasound ng isang JACK port para sa bawat channel
(nakatakda ang bilang ng mga channel sa -f:bits,channels,rate pagpipilian).

Mahalagang tandaan na bilang default ang mga JACK port ay hindi konektado kahit saan (hal
sa soundcard input/outputs, o sa iba pang app). Ang isa sa gayon ay kailangang ikonekta ang mga port
na may panlabas na programa (hal. "QJackCtl" o "jack_connect").

JACK input/outputs - 'jack,clientname,portprefix'
"jack, pangalan ng kliyente" Para sa simpleng paggamit ng mga scanerios, ang ecasound ay nagbibigay ng paraan para mag-autoconnect
ang mga ecasound port. Magagawa ito sa pamamagitan ng pagbibigay ng pangalan ng peer client bilang ang
pangalawang parameter sa object na "jack", hal -o jack, pangalan ng kliyente. Bilang halimbawa, -o
jack, sistema ay lilikha ng isang output na awtomatikong konektado sa mga output ng
default na soundcard ng system. Maaaring tanggalin ang parameter ng kliyente, kung saan hindi
ang mga awtomatikong koneksyon ay ginawa.

Kung kailangan ng isa na baguhin ang port prefix (hal. "in" sa pangalan ng kliyente na "ecasound:in_N"),
maaaring tukuyin ang prefix bilang pangatlong parameter sa bagay na "jack", hal -o
jack,,fxout. Gayundin ang ikatlong parameter ay maaaring tanggalin, kung saan ang default
ginagamit ang mga prefix na "in" at "out".

JACK input/outputs - 'jack_multi'
Ang isang variant ng 'jack' na uri ng bagay ay 'jack_multi'. Ang buong object syntax ay
jack_multi,destport1,...,destportN. Kapag ang isang 'jack_multi' na bagay ay konektado sa a
JACK server, unang channel ng object ay konektado sa JACK port 'destport1',
pangalawa sa 'destport2' at iba pa. Halimbawa "-f:32,2,44100 -o
jack_multi,foo:in,bar:in" ay lumilikha ng stereo ecasound output object, sa kaliwa nito
at mga tamang channel na na-ruta sa dalawang magkaibang mga kliyente ng JACK. Ang mga destinasyong port
dapat na aktibo kapag ang ecasound engine ay inilunsad, o kung hindi man ang mga koneksyon
hindi maitatag. Kung hindi tinukoy ang mga destinasyong port para sa lahat ng channel, o
zero ang haba na mga string ay ibinibigay, ang mga port na iyon ay hindi konektado sa paglulunsad ng ecasound.

JACK input/outputs - 'jack_alsa', 'jack_auto', 'jack_generic' (**deprecated since 2.6.0**)
Sinusuportahan ng Ecasound 2.5 at mas luma ang object na "jack_alsa", "jack_auto" at "jack_generic"
mga uri, ngunit ang mga ito ay pinalitan na ngayon ng isang mas generic na "jack" na interface, at sa gayon ay
hindi na ginagamit ngayon (gumagana sila ngunit hindi na dokumentado).

JACK input/outputs - mga opsyon ng kliyente
Bilang karagdagan, ang mga opsyon sa global na JACK ay maaaring itakda gamit
-G:jack,client_name, operation_mode opsyon. 'client_name' ay ang pangalang ginamit kapag
pagrerehistro ng ecasound sa JACK system. Kung ang 'operation_mode' ay "notransport",
babalewalain ng ecasound ang anumang pagbabago sa estado ng transportasyon sa JACK-system; nasa mode na "send"
ipapadala nito ang lahat ng kaganapan sa pagsisimula, paghinto at pagbabago ng posisyon sa iba pang mga kliyente ng JACK; sa
mode na "recv" ecasound ay susundan ng JACK start, stop at position-change event; at
mode "sendrecv" na isang kumbinasyon ng dalawang nakaraang mga mode.

Kung hindi tahasang itinakda, sa interactive na mode ('-c' opsyon), ang default na mode ay
"sendrecv", habang nasa batchmode ang default ay "notransport". Sa parehong mga kaso ang mode ay maaaring
mapalitan ng -G opsyon tulad ng inilarawan sa itaas.

Higit pang mga detalye tungkol sa suporta sa JACK ng ecasound ay matatagpuan mula sa Gabay ng Gumagamit ng Ecasound.

Libaudiofile - 'audiofile'
Kung pinagana ang suporta sa libaudiofile sa oras ng pag-compile, pinapayagan ka ng opsyong ito
pilitin ang Ecasound na gumamit ng libaudiofile para sa pagbabasa/pagsusulat ng isang partikular na audio file. Pagpipilian
ang syntax ay -i:audiofile,foobar.ext (pareho para sa -o).

Libsndfile - 'sndfile'
Kung pinagana ang suporta sa libsndfile sa oras ng pag-compile, pinapayagan ka ng opsyong ito na pilitin
Ecasound na gumamit ng libsndfile para sa pagbabasa/pagsusulat ng isang partikular na audio file. Syntax ng opsyon
is -i:sndfile,foobar.ext[,.format-ext] (pareho para sa -o). Ang opsyonal na ikatlong parameter
Maaaring gamitin ang "format" upang i-override ang format ng audio (halimbawa, maaari kang lumikha ng isang
AIFF file na may filename na "foo.wav").

Loop device - 'loop'
Ginagawang posible ng mga loop device na iruta (pabalik ang) data sa pagitan ng mga chain. Pagpipilian
ang syntax ay -[io][:]loop,tag. Kung magdaragdag ka ng loop na output na may tag na '1', nakasulat ang lahat ng data
sa output na ito ay iruruta sa anumang loop input na may tag na '1'. Ang tag ay maaaring alinman
numerical (hal. '-i:loop,1') o isang string (hal. "-i:loop, vocals"). Tulad ng iba
input/output object, maaari mong ilakip ang parehong loop device sa maraming chain at
sa ganitong paraan hatiin/halo ang signal.

Tandaan: ang 'loop' na device na ito ay iba sa 'audioloop' (idinagdag ang huli sa ecasound
v2.5.0).

Mikmod - 'mikmod'
Kung pinagana ang suporta sa mikmod sa oras ng pag-compile, pinapayagan ka ng opsyong ito na pilitin
Ecasound upang gamitin ang Mikmod para sa pagbabasa/pagsusulat ng isang partikular na module file. Ang pagpipiliang syntax ay
-i:mikmod,foobar.ext.

Null inputs/outputs - 'null'
Kung tinukoy mo ang "null" o "/dev/null" bilang input o output, ang isang null na audio device ay
nilikha. Ito ay kapaki-pakinabang kung gusto mo lang suriin ang sample na data nang hindi ito isinulat
sa isang file. Mayroon ding realtime na variant, "rtnull", na kumikilos tulad ng
"null" na mga bagay, maliban sa lahat ng i/o ay ginagawa sa realtime na bilis.

Resample - 'resample'
Maaaring gamitin ang uri ng object na 'resample' para i-resample ang audio data ng audio object upang tumugma
ang sampling rate na ginamit sa aktibong chainsetup. Halimbawa, ecasound
-f:16,2,44100 -i resample,22050,foo.wav -o /dev/dsp, ay magsasample ng file mula sa
22.05kHz hanggang 44.1kHz at isulat ang resulta sa soundcard device. Pagsa-sample ng bata
rate ay maaaring mapalitan ng keyword na 'auto'. Sa kasong ito, susubukan ng ecasound na mag-query
tumutol ang bata para sa sampling rate nito. Gumagana ito sa mga format ng file gaya ng .wav
na nag-iimbak ng meta impormasyon tungkol sa format ng audio file. Upang gamitin ang 'auto' sa
nakaraang halimbawa, ecasound -f:16,2,44100 -i resample,auto,foo.wav -o /dev/dsp.

Ang mga parameter 4...N ay ipinapasa gaya ng sa child object (ibig sabihin, "-i
ipapasa ng resample,22050,foo.wav,bar1,bar2" ang mga parameter na "bar1,bar2" sa "foo.wav"
bagay.

Kung ang ecasound ay pinagsama-sama na may suporta para sa libsamplerate, maaari mong gamitin ang 'resample-hq'
upang gamitin ang pinakamataas na kalidad ng resampling algorithm na magagamit. Upang pilitin ang ecasound na gamitin
ang panloob na resampler, 'resampler-lq' (mababang kalidad) ay maaaring gamitin.

Baliktarin - 'baligtad'
Maaaring gamitin ang uri ng bagay na 'reverse' para i-reverse ang data ng audio na nagmumula sa isang audio
bagay. Bilang halimbawa, ecasound -i baligtarin, foo.wav -o /dev/dsp maglalaro ng 'foo.wav'
paurong. Ang pag-reverse ng mga output object ay hindi suportado. Tandaan! Sinusubukang i-reverse ang audio
mga uri ng bagay na may napakabagal na operasyon ng paghahanap (tulad ng mp3), gumagana nang labis na masama.
Subukan munang mag-convert sa isang hindi naka-compress na format (wav o raw), at pagkatapos ay gawin
pagbaliktad.

Ang mga parameter 3...N ay ipinapasa gaya ng sa child object (ibig sabihin, "-i
reverse,foo.wav,bar1,bar2" ay magpapasa ng mga parameter na "bar1,bar2" sa "foo.wav"
bagay.

Mga karaniwang stream ng system at pinangalanang mga tubo - 'stdin', 'stdout'
Maaari kang gumamit ng mga karaniwang stream (stdin at stdout) sa pamamagitan ng pagbibigay si stdin or stdout bilang
pangalan ng file. Ang data ng audio ay ipinapalagay na nasa raw/headerless (.raw) na format. Kung gusto mo
para gumamit ng mga pinangalanang pipe, likhain ang mga ito gamit ang tamang extension ng pangalan ng file bago gamitin.

Generator ng tono - 'tono'
Upang makabuo ng tono ng pagsubok, i-input -i: tono, uri, dalas, tagal-seg maaaring magamit.
Tinutukoy ng 'uri' ng parameter ang uri ng tono: kasalukuyang 'sine' lang ang sinusuportahan. Ang
Itinatakda ng parameter na 'freq' ang dalas ng nabuong tono at 'duration-sec' ang
haba ng nabuong stream. Pagtukoy ng zero, o isang negatibong halaga, bilang ang
ang tagal ay magbubunga ng isang walang katapusang stream. Ang tampok na ito ay unang idinagdag sa Ecasound
2.4.7.

Typeselect - 'typeselect'
Ang espesyal na 'typeselect' na uri ng bagay ay maaaring gamitin upang i-override kung paano ecasound ang mga mapa
mga extension ng filename at mga uri ng bagay. Halimbawa ecasound -i
typeselect,.mp3,an_mp3_file.wav -o /dev/dsp. ipe-play ang file na 'an_mp3_file.wav'
bilang isang mp3-file at hindi bilang isang wav-file gaya ng mangyayari nang walang mga typeelect.

Ang mga parameter 4...N ay ipinapasa gaya ng sa child object (ibig sabihin, "-i
ipapasa ng typeselect,.au,foo.wav,bar1,bar2" ang mga parameter na "bar1,bar2" sa "foo.wav"
bagay.

Midi SETUP

MIDI I/O device - pangkalahatan
Kung walang MIDI-device na tinukoy, ang default na MIDI-device ay ginagamit (tingnan
ecasoundrc(5)).

-Md:rawmidi,device_name
Magdagdag ng rawmidi MIDI I/O device sa setup. Ang 'device_name' ay maaaring kahit ano
ma-access gamit ang normal na UNIX file operations at gumagawa ng raw MIDI bytes.
Ang mga wastong device ay halimbawa ng mga OSS rawmidi device (/dev/midi00), ALSA rawmidi
mga device (/dev/snd/midiC2D0), pinangalanang pipe (tingnan ang mkfifo man page), at mga normal na file.

-Md:alsaseq,sequencer-port
Nagdaragdag ng ALSA MIDI sequencer port sa setup. Tinutukoy ng 'sequencer-port' ang isang port sa
kumonekta sa. Maaari itong numero (hal. 128:1), o pangalan ng kliyente (hal. "KMidimon").

-Mms:device_id
Nagpapadala ng pagsisimula ng MMC ("Ipinaliban ang Paglalaro") at paghinto ("Ihinto") gamit ang device ID na 'device_id'.

Habang hindi direktang sinusuportahan ng Ecasound ang pag-sync ng estado ng transportasyon sa papasok na MMC
mga mensahe, ito ay maaaring makamit sa pamamagitan ng pagkonekta sa Ecasound sa JACK input/outputs, at
gamit ang isang tool tulad ng JackMMC at JackCtlMMC (tingnan
<http://jackctlmmc.sourceforge.net/>) para i-convert ang mga mensahe ng MMC sa JACK transport
baguhin ang mga kaganapan.

-Mss Nagpapadala ng MIDI-sync (ibig sabihin, "MIDI Start" at "MIDI Stop" system realtime na mga mensahe) .to
ang napiling MIDI-device. Pansinin na dahil hindi magpapadala ang Ecasound MIDI-orasan, Ngunit
lamang ang simula at itigil mga mensahe.

EPEKTO SETUP

MGA PRESETS

Ang Ecasound ay may makapangyarihang effect preset system na nagbibigay-daan sa iyong lumikha ng mga bagong effect sa pamamagitan ng
pagsasama-sama ng mga pangunahing epekto at controllers. Tingnan ang gabay ng gumagamit ng ecasound para sa mas detalyado
impormasyon.

-pf:preset_file.eep
Ginagamit ang unang preset na nakita mula sa file na 'preset_file.eep' bilang isang chain operator.

-pn:preset_name
Maghanap ng preset na 'preset_name' mula sa global preset database at gamitin ito bilang isang chain
operator. Tingnan ang ecasoundrc man page para sa impormasyon tungkol sa preset na database.

SINYAL PAGSUSURI

-ev Sinusuri ang sample na data upang malaman kung gaano kalaki ang signal na maaaring palakasin nang wala
clipping. Ang resultang porsyento na halaga ay maaaring gamitin bilang isang parameter sa '-ea'
(palakasin). Isang buod ng istatistika, na naglalaman ng impormasyon tungkol sa stereo-image at
pamamahagi ng mga sample value, ay naka-print sa dulo ng pagproseso.

-evp Peak amplitude watcher. Pinapanatili ang pinakamataas na impormasyon para sa bawat naprosesong channel.
Ang pinakamataas na impormasyon ay nire-reset sa bawat pagbasa.

-ezf Hinahanap ang pinakamainam na halaga para sa DC-adjusting. Maaari mong gamitin ang resulta bilang isang parameter sa
-ezx effect.

PANGKALAHATAN SINYAL PAMAMARAAN ALGORITHMS

-eS:stamp-id
Audio stamp. Kumukuha ng snapshot ng pagpasa ng audio data at iniimbak ito gamit ang id
'stamp-id' (integer number). Ang data na ito ay maaaring magamit sa ibang pagkakataon ng mga controller at iba pa
mga operator.

-ea:amplify%
Inaayos ang amplitude ng signal sa 'amplify%' na porsyento (linear scale, ibig sabihin, indibidwal
ang mga sample ay pinarami ng 'amplify%/100'). Tingnan din ang '-eadb'.

-eac:amplify%,channel
Pinapalakas ang signal ng 'channel' ng channel sa pamamagitan ng amplify-% percent (linear scale, ie
ang mga indibidwal na sample ay pinarami ng 'amplify%/100'). Ang 'channel' ay mula sa 1...n
kung saan ang n ay ang kabuuang bilang ng mga channel. Tingnan din ang '-eadb'.

-eadb:gain-dB[,channel]
Inaayos ang antas ng signal sa pamamagitan ng 'gain-dB', na may gain na 0dB na walang epekto sa
signal, negatibong mga nadagdag na nagpapalakas sa signal at positibong mga halaga ng nakuha
ito. Ang parameter na 'channel' (1...n) ay opsyonal. Kung ang parameter ng 'channel' ay
tinukoy, at ang halaga nito ay nonzero, ang pakinabang ay inilalapat lamang sa ibinigay na channel
(1...n).

-eaw:amplify%,max-clipped-samples
Pinapalakas ang signal sa pamamagitan ng amplify-% na porsyento (linear scale, ibig sabihin, ang mga indibidwal na sample ay
pinarami ng 'amplify%/100'). Kung ang bilang ng magkakasunod na na-cut na sample (nagreresulta
ang sample value ay nasa labas ng nominal [-1,1] na hanay), isang babala ang ibibigay.

-eal:limitasyon-%
Limitasyon epekto. Nililimitahan ang antas ng audio sa 'limit-%' (linear scale) na may mga halagang katumbas o
higit sa 100% na nagreresulta sa walang pagbabago sa signal.

-ec:rate, threshold-%
Compressor (isang simple). Ang 'rate' ay ang compression rate sa decibels ('rate' dB
ang pagbabago sa input signal ay nagdudulot ng 1dB na pagbabago sa output). Ang 'threshold' ay nag-iiba sa pagitan ng 0.0
(katahimikan) at 1.0 (max amplitude).

-eca:peak-level-%, release-time-sec, fast-crate, crate
Isang mas advanced na compressor (orihinal na algorithm ni John S. Dyson). Kung magbibigay ka ng a
halaga ng 0 sa anumang parameter, ang default ay ginagamit. 'peak-level-%' talaga
Tinutukoy kung gaano kalakas itinulak ang peak limiter. Ang default na 69% ay mabuti.
Ang 'release_time' ay ibinibigay sa ilang segundo. Ang compressor na ito ay napaka sopistikado, at
actually complex ang release time. Ito ay isa sa nangingibabaw na oras ng pagpapalabas
mga kontrol, ngunit ang aktwal na oras ng paglabas ay nakadepende sa maraming mga salik hinggil sa
ang dynamics ng audio in. 'fastrate' ay ang compression ratio para sa mabilis
tagapiga. Hindi talaga ito ang compression ratio. Ang halaga ng 1.0 ay infinity hanggang
isa, habang ang default na 0.50 ay 2:1. Ang isa pang talagang magandang halaga ay espesyal na cased in
ang code: 0.25 ay medyo mas mababa sa 2:1, at napakakinis ng tunog. 'rate' ay ang
ratio ng compression para sa buong chain ng compressor. Ang default ay 1.0, at humahawak
ang lakas ng tunog ay napaka pare-pareho nang walang maraming masamang epekto. Gayunpaman ang dynamics sa
mahigpit na pinaghihigpitan ang musika, at ang halagang 0.5 ay maaaring panatilihing mas buo ang musika.

-enm:threshold-level-%,pre-hold-time-msec,attack-time-msec,post-hold-time-msec,release-time-msec
Gate ng ingay. Sinusuportahan ang multichannel processing (bawat channel ay pinoproseso nang hiwalay).
Kapag bumaba ang signal amplitude sa ibaba ng 'threshold_level_%' na porsyento (100% ay nangangahulugang maximum
amplitude), ang gate ay isinaaktibo. Kung mananatili ang signal sa ibaba ng threshold para sa
'th_time' ms, nawala ito sa yugto ng pag-atake ng 'attack' ms. Kung ang signal
tumataas sa itaas ng 'threshold_level' at mananatili doon sa ibabaw ng 'hold' ms ang gate ay
inilabas noong 'release' si ms.

-ei:pitch-shift-%
Pitch shifter. Binabago ang pitch ng audio sa pamamagitan ng pagbabago sa haba nito.

-epp: tama-%
Stereo panner. Binabago ang relatibong balanse sa pagitan ng unang dalawang channel. Kailan
Ang 'right-%' ay 0, tanging signal sa kaliwa (1st) channel ang dinadaanan. Ganun din
kung ito ay '100', tamang (ika-2) channel lang ang papasukin.

-ezx:channel-count,delta-ch1,...,delta-chN
Inaayos ang signal DC sa pamamagitan ng 'delta-chX', kung saan ang X ay ang channel number. Gamitin ang -ezf sa
hanapin ang pinakamainam na mga halaga ng delta.

PAGTATAYA PAGPAPAKITA

-eemb:bpm, on-time-%
Pulse gate (pulse frequency na ibinigay bilang beats-per-minute).

-eemp:freq-Hz, on-time-%
Pulse gate.

-eemt:bpm,depth-%
Tremolo effect (tremolo speed na ibinigay bilang beats-per-minute).

FILTER EPEKTO

-ef1:center_freq, lapad
Resonant bandpass filter. Ang 'center_freq' ay ang center frequency. Tinukoy ang lapad
sa Hz.

-ef3:cutoff_freq, reso, gain
Resonant lowpass filter. Ang 'cutoffr_freq' ay ang filter cutoff frequency. 'reso'
nangangahulugan ng resonance. Karaniwan ang pinakamahusay na mga halaga para sa resonance ay nasa pagitan ng 1.0 at 2.0, ngunit
maaari kang gumamit ng mas malalaking halaga. Ang 'gain' ay ang pangkalahatang gain-factor. Ito ay isang simple
multiplier (1.0 ang normal na antas). Sa mataas na mga halaga ng resonance madalas itong kapaki-pakinabang
para mabawasan ang gain value.

-ef4: cutoff, resonance
Resonant lowpass filter (3rd-order, 36dB, orihinal na algorithm ni Stefan M. Fendt).
Ginagaya ang isang analog na aktibong RC-lowpass na disenyo. Ang cutoff ay isang halaga sa pagitan ng [0,1],
habang ang resonance ay nasa pagitan ng [0,infinity).

-efa:delay-samples,feedback-%
Allpass filter. Ipinapasa ang lahat ng mga frequency na walang pagbabago sa amplitude. Gayunpaman, sa
sa parehong oras na ito ay nagpapataw ng isang frequency-dependent phase-shift.

-efc:delay-samples,radius
Filter ng suklay. Pinapayagan ang mga spike ng suklay na dumaan. Halaga ng 'radius'
dapat nasa pagitan ng [0, 1.0).

-efb: center-freq, lapad
Filter ng bandpass. Ang 'center_freq' ay ang center frequency. Ang lapad ay tinukoy sa Hz.

-efh:cutoff-freq
HIGH pass filter. Tanging ang mga frequency sa itaas ng 'cutoff_freq' lang ang dinadaanan.

-efi:delay-samples,radius
Inverse comb filter. Sinasala ang mga spike ng suklay. meron
'delay_in_samples-2' spikes. Ang halaga ng 'radius' ay dapat nasa pagitan ng [0, 1.0). Ang
mas malapit ito sa pinakamataas na halaga, mas malalim ang mga dips ng suklay.

-efl:cutoff-freq
Lowpass filter. Tanging ang mga frequency sa ibaba ng 'cutoff_freq' lang ang dinadaanan.

-efr: center-freq, lapad
Bandreject na filter. Ang 'center_freq' ay ang center frequency. Ang lapad ay tinukoy sa Hz.

-efs: center-freq, lapad
Resonator. Ang 'center_freq' ay ang center frequency. Ang lapad ay tinukoy sa Hz.
Karaniwang isa lamang resonating bandpass filter.

CHANNEL Paghahalo / PAGBABALIK

-chcopy:mula sa-channel, sa-channel
Kopyahin ang channel na 'from_channel' sa 'to_channel'. Kung ang 'to_channel' ay wala, ito ay
nilikha. Ang pag-index ng channel ay nagsisimula sa 1. Idinagdag ang opsyon sa ecasound 2.4.5.

-chmove:mula sa-channel, sa-channel
Kopyahin ang channel na 'from_channel' sa 'to_channel', at i-mute ang source channel
'mula sa_channel'. Ang pag-index ng channel ay nagsisimula sa 1. Idinagdag ang opsyon sa ecasound 2.4.5.

-chorder:ch1,...,chN
Muling ayusin, alisin at/r i-duplicate ang mga channel ng chain. Ang resultang audio stream ay may kabuuan
ng 'N' na mga channel. Tinutukoy ng bawat parameter ang source channel na gagamitin para sa ibinigay
channel ng output. Bilang halimbawa, babaligtarin ng '-chorder:2,1' ang mga channel ng a
stereo stream ('out1,out2' = 'in2,in1'). Pagtukoy sa parehong pinagmulang channel
pinapayagan ang maraming beses. Halimbawa, ang '-chorder:2,2' ay iruruta ang pangalawa
channel sa parehong dalawang output channel ('out1,out2' = 'in2,in2'). Kung ang 'chX' ay zero,
ang ibinigay na channel na 'X' ay imu-mute sa output stream. Idinagdag ang opsyon sa ecasound
2.7.0.

-chmix:sa-channel
Paghaluin ang lahat ng pinagmulang channel sa channel na 'to_channel'. Kung walang 'to_channel', ito
ay nilikha. Ang pag-index ng channel ay nagsisimula sa 1. Idinagdag ang opsyon sa ecasound 2.4.5.

-chmute:channel
I-mute ang 'channel' ng channel. Ang pag-index ng channel ay nagsisimula sa 1. Idinagdag ang opsyon sa
ecasound 2.4.5.

-erc:mula-channel,to-channel
Hindi na ginagamit, tingnan mo -chcopy.

-erm:sa-channel
Hindi na ginagamit, tingnan mo -chmix.

BATAY SA PANAHON EPEKTO

-etc:delay-time-msec,variance-time-samples,feedback-%,lfo-freq
Koro.

-etd:delay-time-msec,surround-mode,bilang-ng-delay,mix-%,feedback-%
Epekto ng pagkaantala. Ang 'oras ng pagkaantala' ay ang oras ng pagkaantala sa mga millisecond. Ang 'surround-mode' ay isang
integer na may mga sumusunod na kahulugan: 0 = normal, 1 = surround, 2 = stereo-spread.
Ang 'number_of_delays' ay dapat na halata. Mag-ingat na malaking bilang ng mga pagkaantala at malaki
Ang mga oras ng pagkaantala ay nangangailangan ng maraming lakas ng CPU. 'mix-%' ay nagpapahayag ng mix balance sa pagitan ng
orihinal at naantala na signal, na may 0 na nangangahulugang walang naantalang signal, 100 na nangangahulugang hindi
orihinal na signal, at 50 (ang default) na nakakamit ng pantay na balanse. 'feedback-%'
kumakatawan sa kung gaano karami ng signal ang nire-recycle sa bawat pagkaantala o, kung gusto mo, sa
anong rate ang paulit-ulit na snippet ng naantalang audio ay lumalabo. Tandaan na sapat na mababa
ang mga halaga ng feedback ay maaaring magresulta sa ilang mga naririnig na pag-uulit na mas mababa kaysa sa kung ano ang sa iyo
ay tinukoy para sa 'number_of_delays', lalo na kung nagtakda ka ng mababang halaga para sa
'halo-%'. Bilang default, ang halaga para sa parameter na ito ay 100% (Walang pagkawala ng signal.).

-ete:room_size,feedback-%,wet-%
Isang mas advanced na reverb effect (orihinal na algorithm ni Stefan M. Fendt). 'laki_ng kwarto'
ay ibinibigay sa metro, ang 'feedback-%' ay ang feedback level na ibinigay sa porsyento at
Ang 'wet-%' ay ang dami ng reverbed signal na idinagdag sa orihinal na signal.

-etf:delay-time-msec
Fake-stereo effect. Ang input signal ay summed sa mono. Ang orihinal na signal ay papunta sa
ang mga kaliwang channel habang isang naantalang bersyon (na may pagkaantala ng 'oras ng pagkaantala' na millisecond)
ay papunta sa kanan. Sa oras ng pagkaantala na 1-40 millisecond, nagdaragdag ito ng a
stereo-feel sa mono-signal.

-etl:delay-time-msec,variance-time-samples,feedback-%,lfo-freq
Flanger.

-etm:delay-time-msec,bilang-ng-delay,mix-%
Multitap delay. Ang 'oras ng pagkaantala' ay ang oras ng pagkaantala sa mga millisecond. 'number_of_delays'
dapat halata. Tinutukoy ng 'mix-%' kung gaano kalaki ang epekto (basa) na signal
ang orihinal.

-etp:delay-time-msec,variance-time-samples,feedback-%,lfo-freq
Phaser.

-etr:delay-time, surround-mode, feedback-%
Reverb effect. Ang 'oras ng pagkaantala' ay ang oras ng pagkaantala sa mga millisecond. Kung 'surround-mode'
ay 'surround', gumagalaw ang reverbed signal sa paligid ng stereo image. 'feedback-%'
tinutukoy kung gaano kalaki ang epekto (basa) na signal na ibinabalik sa reverb.

LADSPA-PLUGINS

-el:plugin_unique_name,param-1,...,param-N
Sinusuportahan ng Ecasound ang mga plugin na may epekto sa LADSPA (Simple Plugin ng Developer ng Linux Audio
API). Ang mga Parameter 1..N ay itinakda bilang mga halaga ng mga control port ng plugin.

Kung ang plugin ay may higit sa isang audio input at/o output port, isa lang ang plugin
ginawa ang instance, at ang mga chain channel ay ipapakain sa parehong instance ng plugin. Kung
Ang plugin ay may hindi hihigit sa isang input at higit sa isang output audio port, isang hiwalay na plugin
instance ay nilikha para sa bawat channel ng ecasound chain (hal para sa isang stereo audio
channel, dalawang LADSPA plugin ng parehong uri ang nilikha, na may isa sa bawat channel).

Ang mga plugin ay matatagpuan sa nakabahaging library (.so) na mga file. Naghahanap ang Ecasound ng mga plugin sa
@prefix@/lib/ladspa (hal. "/usr/local/lib/ladspa"), mga direktoryo na nakalista sa
variable ng kapaligiran LADSPA_PATH. Ang landas sa paghahanap ng plugin ay maaari ding i-configure sa pamamagitan ng
ecasoundrc, Tingnan ang ecasoundrc(5) man page. Maaaring maglaman ang isang shared library file
maramihang mga bagay ng plugin, ngunit ang bawat plugin ay may natatanging pangalan ng plugin. Ang pangalan na ito ay
ginagamit para sa pagpili ng mga plugin.

Tingnan ang LAD mailing list web site para sa karagdagang impormasyon tungkol sa LADSPA. Ang iba pang mga kapaki-pakinabang na site ay
LADSPA home page at LADSPA na dokumentasyon.

-eli:plugin_unique_number,param-1,...,param-N
Katulad ng nasa itaas (-he) inaasahan na ang natatanging id-number ng plugin ay ginagamit. Ito ay ginagarantiyahan na
ang mga id-number na ito ay natatangi sa lahat ng LADSPA plugin.

LV2 PLUGINS

-elv2:plugin-id-uri,param-1,...,param-N
Sinusuportahan din ng Ecasound ang mga LV2 audio plugin. Ang mga LV2 plugin ay kinilala ng isang globally
natatangi, case-sensitive na identifier.

Kung ang plugin ay may higit sa isang audio input at/o output port, isa lang ang plugin
ginawa ang instance, at ang mga chain channel ay ipapakain sa parehong instance ng plugin. Kung
Ang plugin ay may hindi hihigit sa isang input at higit sa isang output audio port, isang hiwalay na plugin
instance ay nilikha para sa bawat channel ng ecasound chain (hal para sa isang stereo audio
channel, dalawang LV2 na plugin ng parehong uri ang nilikha, na may isa bawat channel).

Ang LV2 ay isang pamantayan ng plugin para sa mga audio system.

GATE SETUP

-gc:start-time,len
Time crop gate. Sa una ay sarado ang gate. Matapos lumipas ang mga segundo ng 'start-time',
bumukas ang gate at nananatiling bukas ng 'len' na segundo. Kapag sarado, nagpapasa ng mga buffer ng audio
ay trucated sa zero haba.

-ge:open-threshold-%,close-thold-%,volume-mode,reopen-count
Threshold gate. Sa una ay sarado ang gate. Binubuksan ito kapag lumampas ang volume
porsyento ng 'othreshold'. Pagkatapos nito, kung bumaba ang volume sa ibaba ng porsyento ng 'cthold', ang gate ay
sarado at hindi na bubuksan muli, maliban kung ang 'reopen-count' ay nakatakda sa kahit ano
maliban sa zero. Kung ang 'value_mode' ay 'rms', ginagamit ang average na dami ng RMS. Kung hindi
peak average ang ginagamit. Kapag isinara, ang pagpasa ng mga buffer ng audio ay itinatakda sa zero
haba. Kung ang 'reopen-count' ay nakatakda sa isang positibong numero, ang gate ay gagawin
i-restart ang operasyon nito nang maraming beses. Kaya halimbawa, isang muling pagbubukas ng bilang ng 1 kalooban
maging sanhi ng hanggang 2 openings ng gate. Magreresulta ang negatibong halaga para sa 'reopen-count'
sa gate na muling nagbubukas nang walang katapusan. Ang 'reopen-count' ay napakahalaga sa pagre-record
vinyl at mga teyp, kung saan maaari mong i-set up ang mga bagay at pagkatapos ay magsisimula ang pag-record sa tuwing ang
Ang karayom ​​ay nasa vinyl, at humihinto kapag ito ay patay. Kahit gaano karaming panig ang gusto mo
naitala sa isang sesyon. Kakailanganin mong mag-eksperimento sa mga haba ng buffer at
mga antas ng pagsisimula/paghinto upang makakuha ng maaasahang mga setting para sa iyong kagamitan.

-gm: estado
Manu-manong gate. Kung ang 'estado' ay 1, ang gate ay bukas at lahat ng mga sample ay dumaan. Kung
Ang 'estado' ay zero, ang gate ay sarado at walang mga sample na pinapasok. Ang chain operator na ito
ay kapaki-pakinabang kapag ang pagsulat sa isang output ay kailangang ihinto nang pabago-bago (nang walang
pagpapahinto ng buong makina).

Kontrol PAGTATAYA SETUP

Maaaring gamitin ang mga controller upang dynamic na baguhin ang mga parameter ng epekto sa panahon ng pagproseso.
Ang lahat ng mga controller ay naka-attach sa napili (=karaniwang ang huling tinukoy
effect/controller) epekto. Ang unang tatlong parameter ay karaniwan para sa lahat
mga controllers. Tinutukoy ng 'fx_param' ang parameter na kinokontrol. Ang ibig sabihin ng value na '1'
ang unang parameter, '2' ang pangalawa at iba pa. 'start_value' at 'end_value' set
ang hanay ng halaga. Para sa mga halimbawa, tingnan ang HALIMBAWA seksyon.

-kos:fx-param,start-value,end-value,freq,i-phase
Sine oscillator na may dalas ng 'freq' Hz at paunang yugto ng 'i_phase' na beses
pi

-kog:fx-param,start-value,end-value,freq,mode,point-pairs,first-value,last-value,pos1,value1,...
Generic na oscillator. Frequency 'freq' Hz, mode alinman sa '0' para sa mga static na halaga o '1'
para sa linear interpolation. Tinutukoy ng 'point-pairs' ang bilang ng 'posN' - 'valueN'
pares na isasama. Ang 'first-value' at 'last-value' ay ginagamit bilang mga halaga ng hangganan (mga halaga
para sa posisyon 0.0/una at posisyon 1.0/huling). Lahat ng 'posN' at 'valueN' ay dapat
sa pagitan ng 0.0 at 1.0. Gayundin, para sa lahat ng mga halaga ng 'posN' 'pos1 < pos2 < ... < posN' ay dapat
totoo.

-kf:fx-param,start-value,end-value,freq,mode,genosc-number
Generic na oscillator. Ang 'genosc_number' ay ang numero ng magiging preset ng oscillator
puno. Ang mode ay alinman sa '0' para sa mga static na halaga o '1' para sa linear interpolation. Ang
ang lokasyon para sa preset na file ay kinuha mula sa ./ecasoundrc (tingnan ecasoundrc lalaki pahina).

-kl:fx-param,start-value,end-value,time-segundo
Linear na sobre na nagsisimula sa 'start_value' at linearly na nagbabago sa 'end_value'
sa panahon ng 'time_in_seconds'. Maaaring gamitin para sa fadeins at fadeouts.

-kl2:fx-param,start-value,end-value,1st-stage-length-sec,2nd-stage-length-sec
Two-stage linear envelope, isang mas maraming gamit na tool para sa paggawa ng fade-in at fade-out.
Nananatili sa 'start_value' para sa '1st_stage_length' na segundo at pagkatapos ay linearly na nagbabago
patungo sa 'end_value' sa panahon ng '2nd_stage_length' na mga segundo.

-klg:fx-param,low-value,high-value,point_count,pos1,value1,...,posN,valueN
Generic na linear na sobre. Magagamit ang source ng controller na ito para mag-map ng mga custom na sobre
sa mga parameter ng operator ng chain. Ang bilang ng mga punto ng sobre ay tinukoy sa
'point_count'. Ang bawat punto ng sobre ay binubuo ng isang posisyon at isang katumbas na halaga.
Ang bilang ng mga pares ay dapat tumugma sa 'point_count' (ibig sabihin, 'N==point_count'). Ang 'posX'
ang mga parameter ay ibinibigay bilang mga segundo (mula sa simula ng stream). Ang mga punto ng sobre ay
tinukoy bilang mga float value sa hanay na '[0,1]'. Bago ang mga halaga ng sobre ay imapa sa
mga parameter ng operator, sila ay nakamapa sa target na hanay ng
'[low-value,high-value]'. Hal. ang isang halaga ng '0' ay magtatakda ng parameter ng operator sa
Itatakda ito ng 'low-value' at value na '1' sa 'high-value'. Para sa paunang segment
'[0,pos1]', ang sobre ay maglalabas ng halaga ng 'value1' (hal. 'low-value').

-km:fx-param,start-value,end-value,controller,channel
MIDI tuloy-tuloy na controller (kontrol ng pagbabago ng mga mensahe). Mga mensahe sa MIDI-channel
Ang 'channel' na nagmumula sa controller number na 'controller' ay ginagamit bilang ang
pinagmulan ng controller. Gaya ng inirerekomenda ng MIDI-specification, napupunta ang channel numbering
mula 1 hanggang 16. Ang mga posibleng numero ng controller ay mga halaga mula 0 hanggang 127. Ang MIDI-device
kung saan ang mga byte ay nabasa mula ay maaaring tukuyin gamit -Md opsyon. Kung hindi man ang default
Ginagamit ang MIDI-device gaya ng tinukoy sa ~ecasound/ecasoundrc (Tingnan ang ecasoundrc lalaki pahina).
Default sa /dev/midi.

-ksv:fx-param,start-value,end-value,stamp-id,rms-toggle
Volume analysis controller. Sinusuri ang audio na nakaimbak sa stamp na 'stamp-id' (tingnan
'-eS:id' docs), at gumagawa ng control data batay sa mga resulta. Kung ang 'rms-toggle' ay
non-zero, RMS-volume ang ginagamit para kalkulahin ang control value. Kung hindi, karaniwan
peak-amplitude ang ginagamit.

-kx Ito ay isang espesyal na switch na maaaring gamitin kapag kailangan mong kontrolin ang controller
mga parameter sa isa pang controller. Kapag tinukoy mo -kx, ang huling tinukoy
ang controller ay itatakda bilang control target. Pagkatapos ay magdagdag ka lamang ng isa pang controller
gaya ng dati.

INTERAKTIBONG MODE

Tingnan ecasound-iam(1) pahina ng tao.

Kapaligiran

ECASOUND
Kung tinukoy, gagamitin ng ilang utility program at script ang ECASOUND kapaligiran bilang
ang default na path sa ecasound executable.

ECASOUND_LOGFILE
I-output ang lahat ng mga mensahe sa pag-debug sa isang hiwalay na log file. Kung tinukoy, ECASOUND_LOGFILE
tumutukoy sa landas ng logfile. Ito ay isang mahusay na tool para sa pag-debug ng mga script ng ECI/EIAM at
mga application.

ECASOUND_LOGLEVEL
Piliin kung aling mga mensahe ang isinulat sa logfile na tinukoy ng ECASOUND_LOGFILE. ang
syntax para sa -d:level Ginagamit. Kung hindi tinukoy, ang lahat ng mga mensahe ay nakasulat. Default sa
-d:319 (lahat ng iba pa maliban sa 'functions (64)' at 'continuous (128)' na klase
mga mensahe).

COLUMNS
Pinararangalan ng Ecasound ang COLUMNS variable ng kapaligiran kapag nag-format ng naka-print na bakas
mga mensahe. Kung COLUMNS ay hindi nakatakda, isang default na 74 ang ginagamit.

TMPDIR Ang ilang mga function ng Ecasound (hal. "cs-edit" interactive command) ay nangangailangan ng paglikha ng
pansamantalang mga file. Bilang default, ang mga file na ito ay nilikha sa ilalim ng "/ Tmp", ngunit ito ay maaaring
na-override sa pamamagitan ng pagtatakda ng TMPDIR variable ng kapaligiran.

RETURN Mga halaga

Sa interactive na mode, palaging nagbabalik ng zero ang ecasound.

Sa non-interactive (batch) mode, isang hindi-zero na halaga ang ibinabalik para sa mga sumusunod
mga error:

1 Hindi makagawa ng wastong chainsetup na may ibinigay na mga parameter. Maaaring sanhi ng
di-wastong syntax ng opsyon, atbp.

2 Hindi masimulan ang pagproseso. Ito ay maaaring sanhi ng hindi sapat na mga pahintulot ng file,
kawalan ng kakayahang ma-access ang ilang mapagkukunan ng system, atbp.

3 Error sa panahon ng pagproseso. Mga posibleng dahilan: ang output object ay naubusan ng libreng disk
espasyo, atbp.

4 Error sa panahon ng pagwawakas ng proseso at/o paglilinis. Tingnan ang seksyon sa 'SIGNALS' para sa
karagdagang mga detalye.

Mga TANDA

Kapag natanggap ng ecasound ang alinman sa mga signal ng POSIX SIGINT (ctrl-c), SIGHUP, SIGTERM o
Ang SIGQUIT, normal na paglilinis at pamamaraan ng paglabas ay sinisimulan. Dito ang ibig sabihin ng normal na paglabas ay hal
Ang mga header ng file ay ina-update bago isara, ang mga proseso ng helper ay tinapos sa normal na paraan,
at iba pa.

Kung, habang ginagawa ang paglilinis na inilarawan sa itaas, ang ecasound ay tumatanggap ng isa pang signal (ng pareho
set ng mga signal ng POSIX), lalaktawan ng ecasound ang normal na pamamaraan ng paglilinis, at magwawakas
kaagad. Ang anumang natitirang gawain sa paglilinis ay lalaktawan. Depende sa estado ng runtime
at configuration, ang brute force na exit na ito ay maaaring may ilang side-effects. Babalik ang Ecasound
exit code ng '4' kung nilaktawan ang normal na paglilinis.

Ang espesyal na paghawak ng kaso ay inilalapat sa signal ng SIGINT (ctrl-c). Kung ang isang SIGINT signal ay
natanggap sa panahon ng pamamaraan ng paglilinis, babalewalain ng ecasound ang signal nang isang beses, at maglalabas ng a
paunawa sa 'stderr' na ang paglilinis ay isinasagawa na. Anumang kasunod na mga signal ng SIGINT ay
hindi na nakakakuha ng espesyal na paghawak, at sa halip ay matatapos kaagad ang proseso (at
posibleng walang wastong paglilinis).

Gumamit ng ecasound online gamit ang mga serbisyo ng onworks.net