mainkan - Online di Awan

PROGRAM:

NAMA

SoX - Sound eXchange, pisau manipulasi audio Swiss Army

RINGKASAN

sox [opsi global] [format-opsi] file1
[[format-opsi] file2] ... [format-opsi] file keluar
[efek [efek-opsi]] ...

bermain [opsi global] [format-opsi] file1
[[format-opsi] file2] ... [format-opsi]
[efek [efek-opsi]] ...

rec [opsi global] [format-opsi] file keluar
[efek [efek-opsi]] ...

DESKRIPSI

Pengantar
SoX membaca dan menulis file audio dalam format paling populer dan secara opsional dapat menerapkan efek
ke mereka. Ini dapat menggabungkan beberapa sumber input, mensintesis audio, dan, pada banyak sistem,
bertindak sebagai pemutar audio tujuan umum atau perekam audio multi-track. Ini juga memiliki keterbatasan
kemampuan untuk membagi input menjadi beberapa file output.

Semua fungsi SoX tersedia hanya dengan menggunakan sox memerintah. Untuk menyederhanakan bermain dan
merekam audio, jika SoX dipanggil sebagai bermain, file output secara otomatis diatur menjadi
perangkat suara default, dan jika dipanggil sebagai rec, perangkat suara default digunakan sebagai input
sumber. Selain itu, soksi(1) perintah menyediakan cara mudah untuk hanya menanyakan audio
informasi judul file.

Inti dari SoX adalah perpustakaan yang disebut libSoX. Mereka yang tertarik untuk memperluas SoX atau menggunakan
itu di program lain harus merujuk ke halaman manual libSoX: libsox(3).

SoX adalah alat pemrosesan audio baris perintah, sangat cocok untuk membuat cepat, sederhana
pengeditan dan pemrosesan batch. Jika Anda membutuhkan editor audio grafis interaktif, gunakan
keberanian(1).

* * *

Keseluruhan rantai pemrosesan SoX dapat diringkas sebagai berikut:

Input → Penggabung → Efek → Output

Namun perhatikan, bahwa pada baris perintah SoX, posisi Output dan Efek
ditukar dengan aliran logis yang baru saja ditampilkan. Perhatikan juga bahwa sementara opsi yang berkaitan
ke file ditempatkan sebelum nama file masing-masing, sebaliknya berlaku untuk efek.
Untuk menunjukkan bagaimana ini bekerja dalam praktik, berikut adalah pilihan contoh bagaimana SoX mungkin
digunakan. Sederhana
sox resital.au resital.wav
menerjemahkan file audio dalam format Sun AU ke file Microsoft WAV, sementara
sox recital.au -b 16 recital.wav channel 1 rate 16k fade 3 norm
melakukan terjemahan format yang sama, tetapi juga menerapkan empat efek (campuran bawah menjadi satu)
saluran, perubahan laju sampel, fade-in, nomalize), dan menyimpan hasilnya pada kedalaman
16.
sox -r 16k -e ditandatangani -b 8 -c 1 voice-memo.raw voice-memo.wav
mengonversi audio `mentah' (alias `headerless') ke format file yang menggambarkan diri sendiri,
sox lambat.aiff tetap.aiff kecepatan 1.027
menyesuaikan kecepatan audio,
sox pendek.wav panjang.wav lebih panjang.wav
menggabungkan dua file audio, dan
sox -m musik.mp3 suara.wav campuran.flac
menggabungkan dua file audio.
mainkan bass "The Moonbeams/Greatest/*.ogg" +3
memainkan kumpulan file audio sambil menerapkan efek penguat bass,
mainkan -n -c1 synth sin %-12 sin %-9 sin %-5 sin %-2 fade h 0.1 1 0.1
memainkan akord `A minor ketujuh' yang disintesis dengan suara organ pipa,
rec -c 2 radio.aiff trim 0 30:00
merekam setengah jam audio stereo, dan
mainkan -q take1.aiff & rec -M take1.aiff take1-dub.aiff
(dengan POSIX shell dan jika didukung oleh perangkat keras) merekam trek baru dalam multi-track
rekaman. Akhirnya,
rec -r 44100 -b 16 -s -p diam 1 0.50 0.1% 1 10:00 0.1% | \
sox -p song.ogg keheningan 1 0.50 0.1% 1 2.0 0.1% : \
file baru : restart
merekam aliran audio seperti LP/kaset dan membaginya menjadi beberapa file audio di
poin dengan 2 detik hening. Juga, itu tidak mulai merekam sampai mendeteksi
audio diputar dan berhenti setelah diam selama 10 menit.

NB Di atas hanyalah gambaran umum dari kemampuan SoX; penjelasan rinci tentang cara
menggunakan semua Parameter SoX, format file, dan efek dapat ditemukan di bawah dalam manual ini, di
format sox(7), dan dalam soksi(1).

File dibentuk jenis
SoX dapat bekerja dengan file audio `self-describing' dan `raw'. format 'menggambarkan diri sendiri'
(misalnya WAV, FLAC, MP3) memiliki header yang sepenuhnya menggambarkan sinyal dan encoding
atribut data audio berikut. Format `mentah' atau `tanpa header' tidak mengandung
informasi ini, jadi karakteristik audio ini harus dijelaskan di SoX
baris perintah atau disimpulkan dari file input.

Empat karakteristik berikut digunakan untuk menggambarkan format data audio sedemikian rupa sehingga:
itu dapat diproses dengan SoX:

tingkat sampel
Laju sampel dalam sampel per detik (`Hertz' atau `Hz'). Telepon digital
tradisional menggunakan laju sampel 8000 Hz (8 kHz), meskipun hari ini, 16 dan bahkan
32 kHz menjadi lebih umum. Audio Compact Disc menggunakan 44100 Hz (44.1 kHz).
Pita Audio Digital dan banyak sistem komputer menggunakan 48 kHz. Sistem audio profesional
sering menggunakan 96 kHz.

ukuran sampel
Jumlah bit yang digunakan untuk menyimpan setiap sampel. Saat ini, 16-bit umum digunakan.
8-bit sangat populer di hari-hari awal audio komputer. 24-bit digunakan dalam
arena audio profesional. Ukuran lain juga digunakan.

pengkodean data
Cara setiap sampel audio direpresentasikan (atau `dikodekan'). Beberapa pengkodean
memiliki varian dengan urutan byte atau urutan bit yang berbeda. Beberapa kompres
data audio sehingga data audio yang disimpan memakan lebih sedikit ruang (yaitu ruang disk atau
bandwidth transmisi) daripada parameter format lain dan jumlah sampel
akan menyiratkan. Jenis pengkodean yang umum digunakan termasuk floating-point, -law, ADPCM,
PCM integer bertanda, MP3, dan FLAC.

saluran
Jumlah saluran audio yang terdapat dalam file. Satu (`mono') dan dua
(`stereo') banyak digunakan. Audio `surround sound' biasanya berisi enam atau lebih
Saluran.

Istilah `bit-rate' adalah ukuran jumlah penyimpanan yang ditempati oleh audio yang dikodekan
sinyal dalam satu satuan waktu. Itu dapat bergantung pada semua hal di atas dan biasanya dilambangkan sebagai
sejumlah kilo-bit per detik (kbps). Sinyal telepon A-law memiliki bit-rate 64
kbps. Musik stereo yang dikodekan MP3 biasanya memiliki bit-rate 128-196 kbps. FLAC-encoded
musik stereo biasanya memiliki bit-rate 550-760 kbps.

Sebagian besar format yang menggambarkan diri sendiri juga memungkinkan `komentar' tekstual untuk disematkan dalam file yang
dapat digunakan untuk menggambarkan audio dalam beberapa cara, misalnya untuk musik, judul, penulis, dll.

Salah satu kegunaan penting dari komentar file audio adalah untuk menyampaikan informasi `Replay Gain'. SoX
mendukung penerapan informasi Replay Gain, tetapi tidak menghasilkannya. Perhatikan bahwa secara default,
SoX menyalin komentar file input ke file output yang mendukung komentar, sehingga file output dapat
berisi informasi Replay Gain jika beberapa ada di file input. Dalam hal ini, jika
apa pun selain konversi format sederhana dilakukan kemudian file output Putar Ulang
Memperoleh informasi kemungkinan salah dan karenanya harus dihitung ulang menggunakan alat yang
mendukung ini (bukan SoX).

soksi(1) perintah dapat digunakan untuk menampilkan informasi dari header file audio.

Menentukan & Pengaturan File dibentuk
Ada beberapa mekanisme yang tersedia untuk digunakan SoX untuk menentukan atau mengatur format
karakteristik file audio. Tergantung pada keadaan, individu
karakteristik dapat ditentukan atau diatur menggunakan mekanisme yang berbeda.

Untuk menentukan format file input, SoX akan menggunakan, dalam urutan prioritas dan sebagai
diberikan atau tersedia:

1. Opsi format baris perintah.

2. Isi dari file header.

3. Ekstensi nama file.

Untuk mengatur format file output, SoX akan menggunakan, dalam urutan prioritas dan seperti yang diberikan atau
tersedia:

1. Opsi format baris perintah.

2. Ekstensi nama file.

3. Karakteristik format file input, atau yang paling dekat yang didukung oleh output
jenis berkas.

Untuk semua file, SoX akan keluar dengan kesalahan jika jenis file tidak dapat ditentukan. Memerintah-
opsi format baris mungkin perlu ditambahkan atau diubah untuk mengatasi masalah.

Bermain & Rekaman Audio
bermain dan rec perintah disediakan sehingga pemutaran dan perekaman dasar sesederhana
mainkan file yang ada.wav
dan
rek file baru.wav
Kedua perintah ini secara fungsional setara dengan
sox file yang ada.wav -d
dan
sox -d file baru.wav
Tentu saja, opsi dan efek lebih lanjut (seperti yang dijelaskan di bawah) dapat ditambahkan ke perintah
dalam bentuk apapun.

* * *

Beberapa sistem menyediakan lebih dari satu jenis driver audio (kompatibel dengan SoX), misalnya ALSA & OSS,
atau SUNAU & AO. Sistem juga dapat memiliki lebih dari satu perangkat audio (alias `kartu suara').
Jika lebih dari satu driver audio telah terpasang di SoX, dan default dipilih oleh SoX
saat merekam atau memutar bukan yang diinginkan, maka AUDIODRIVE lingkungan Hidup
variabel dapat digunakan untuk mengganti default. Misalnya (pada banyak sistem):
atur AUDIODRIVE=oss
bermain ...
AUDIODEV variabel lingkungan dapat digunakan untuk mengganti perangkat audio default, misalnya
atur AUDIODEV=/dev/dsp2
bermain ...
sox... -t oss
or
atur AUDIODEV=hw:gelombang suara,1,2
bermain ...
sox... -t juga
Perhatikan bahwa cara mengatur variabel lingkungan bervariasi dari sistem ke sistem - untuk beberapa
contoh spesifik, lihat `SOX_OPTS' di bawah.

Saat memutar file dengan laju sampel yang tidak didukung oleh perangkat output audio,
SoX akan secara otomatis memanggil tarif efek untuk melakukan laju sampel yang diperlukan
konversi. Untuk kompatibilitas dengan perangkat keras lama, default tarif tingkat kualitas diatur ke
'rendah'. Ini dapat diubah dengan secara eksplisit menentukan tarif efek dengan yang berbeda
tingkat kualitas, misalnya
mainkan ... nilai -m
atau dengan menggunakan --kecepatan bermain-arg pilihan (lihat di bawah).

* * *

Pada beberapa sistem, SoX memungkinkan volume pemutaran audio disesuaikan saat menggunakan bermain. Dimana
didukung, ini dicapai dengan mengetuk tombol `v' & `V' selama pemutaran.

Untuk membantu mengatur tingkat perekaman yang sesuai, SoX menyertakan pengukur tingkat puncak yang dapat
dipanggil (sebelum membuat rekaman yang sebenarnya) sebagai berikut:
rek -n
Level perekaman harus disesuaikan (menggunakan program mixer yang disediakan sistem, bukan SoX)
sehingga meterannya adalah at paling kadang skala penuh, dan tidak pernah `dalam merah' (an
tanda seru ditampilkan). Lihat juga -S di bawah.

Ketepatan
Banyak format file yang memampatkan audio membuang beberapa informasi sinyal audio sementara
melakukannya. Mengonversi ke format seperti itu dan kemudian mengonversinya kembali tidak akan menghasilkan
salinan persis dari audio asli. Ini adalah kasus untuk banyak format yang digunakan dalam telepon
(misalnya A-law, GSM) di mana bandwidth sinyal rendah lebih penting daripada kesetiaan audio yang tinggi,
dan untuk banyak format yang digunakan dalam pemutar musik portabel (mis. MP3, Vorbis) jika memadai
kesetiaan dapat dipertahankan bahkan dengan rasio kompresi besar yang diperlukan untuk membuat
pemain portabel praktis.

Format yang membuang informasi sinyal audio disebut `lossy'. Format yang tidak
disebut 'tanpa kerugian'. Istilah `kualitas' digunakan sebagai ukuran seberapa dekat aslinya
sinyal audio dapat direproduksi saat menggunakan format lossy.

Konversi file audio dengan SoX adalah lossless ketika bisa, yaitu saat tidak menggunakan lossy
kompresi, ketika tidak mengurangi laju pengambilan sampel atau jumlah saluran, dan ketika
jumlah bit yang digunakan dalam format tujuan tidak kurang dari pada format sumber. Misalnya
mengonversi dari format PCM 8-bit ke format PCM 16-bit tidak rugi tetapi mengonversi dari
format PCM 8-bit ke (8-bit) A-law tidak.

NB SoX mengonversi semua file audio ke format internal yang tidak terkompresi sebelum tampil
pemrosesan audio apa pun. Ini berarti memanipulasi file yang disimpan dalam format lossy
dapat menyebabkan kerugian lebih lanjut dalam kesetiaan audio. Misalnya dengan
sox panjang.mp3 pendek.mp3 trim 10
SoX pertama-tama mendekompres file MP3 input, lalu menerapkan memangkas efek, dan akhirnya
membuat file MP3 keluaran dengan mengompresi ulang audio - dengan kemungkinan pengurangan
fidelitas di atas yang terjadi saat file input dibuat. Oleh karena itu, jika apa
akhirnya diinginkan adalah audio terkompresi lossily, sangat disarankan untuk melakukan semua
pemrosesan audio menggunakan format file lossless dan kemudian dikonversi ke format lossy hanya di
tahap akhir.

NB Menerapkan banyak efek dengan satu permintaan SoX akan, secara umum, menghasilkan
hasil yang lebih akurat daripada yang dihasilkan menggunakan beberapa pemanggilan SoX.

dithering
Dithering adalah teknik yang digunakan untuk memaksimalkan rentang dinamis audio yang disimpan di a
kedalaman bit tertentu. Setiap distorsi yang ditimbulkan oleh kuantisasi didekorasi dengan menambahkan
sejumlah kecil white noise pada sinyal. Dalam kebanyakan kasus, SoX dapat menentukan apakah
pemrosesan yang dipilih membutuhkan gentar dan akan menambahkannya selama pemformatan output jika
sesuai.

Secara khusus, secara default, SoX secara otomatis menambahkan gentar TPDF ketika kedalaman bit keluaran adalah
kurang dari 24 dan salah satu dari berikut ini benar:

· Pengurangan kedalaman bit telah ditentukan secara eksplisit menggunakan opsi baris perintah

· format file output hanya mendukung kedalaman bit lebih rendah dari file input
format

· sebuah efek telah meningkatkan kedalaman bit efektif dalam rantai pemrosesan internal

Misalnya, menyesuaikan volume dengan vol 0.25 membutuhkan dua bit tambahan untuk
menyimpan hasilnya tanpa kehilangan (karena 0.25 desimal sama dengan 0.01 biner). Jadi jika masukan
kedalaman bit file adalah 16, maka representasi internal SoX akan menggunakan 18 bit setelahnya
memproses perubahan volume ini. Untuk menyimpan output pada kedalaman yang sama dengan
input, dithering digunakan untuk menghapus bit tambahan.

Gunakan -V opsi untuk melihat pemrosesan apa yang ditambahkan SoX secara otomatis. NS -D pilihan mungkin
diberikan untuk mengesampingkan dithering otomatis. Untuk memanggil dithering secara manual (misalnya untuk memilih a
kurva pembentukan kebisingan), lihat gentar efek.

Guntingan
Kliping adalah distorsi yang terjadi ketika level sinyal audio (atau `volume') melebihi
jangkauan representasi yang dipilih. Dalam kebanyakan kasus, kliping tidak diinginkan dan begitu juga seharusnya
dikoreksi dengan menyesuaikan level sebelum titik (dalam rantai pemrosesan) di mana
ini terjadi.

Di SoX, kliping dapat terjadi, seperti yang Anda harapkan, saat menggunakan vol or mendapatkan efek ke
meningkatkan volume audio. Kliping juga dapat terjadi dengan banyak efek lainnya, ketika
mengonversi satu format ke format lain, dan bahkan saat hanya memutar audio.

Memutar file audio sering kali melibatkan pengambilan sampel ulang, dan pemrosesan oleh komponen analog dapat
memperkenalkan offset dan/atau amplifikasi DC kecil, yang semuanya dapat menghasilkan distorsi jika
tingkat sinyal audio awalnya terlalu dekat dengan titik kliping.

Untuk alasan ini, biasanya untuk memastikan bahwa level sinyal file audio memiliki beberapa:
`ruang kepala', yaitu tidak melebihi tingkat tertentu di bawah tingkat maksimum yang mungkin
untuk representasi yang diberikan. Beberapa badan standar merekomendasikan sebanyak 9dB ruang kepala,
tetapi dalam kebanyakan kasus, 3dB (≈ 70% linier) sudah cukup. Perhatikan bahwa kebijaksanaan ini tampaknya telah
hilang dalam produksi musik modern; kenyataannya, banyak CD, MP3, dll. sekarang dikuasai di level
atas 0dBFS yaitu audio terpotong saat dikirim.

SoX's Stat dan statistik efek dapat membantu dalam menentukan tingkat sinyal dalam file audio.
mendapatkan or vol efek dapat digunakan untuk mencegah kliping, mis
sox kusam.wav terang.wav dapatkan -6 treble +6
menjamin bahwa treble boost tidak akan terputus.

Jika kliping terjadi pada titik mana pun selama pemrosesan, SoX akan menampilkan pesan peringatan untuk
efek itu.

Lihat juga -G dan mendapatkan dan norma efek.

Memasukkan File Menggabungkan
Penggabung input SoX dapat dikonfigurasi (lihat OPSI di bawah) untuk menggabungkan beberapa file menggunakan
salah satu metode berikut: `concatenate', `sequence', `mix', `mix-power', `merge', atau
'berlipat ganda'. Metode default adalah `urutan' untuk bermain, dan `menggabungkan' untuk rec dan sox.

Untuk semua metode selain `sequence', beberapa file input harus memiliki sampling yang sama
kecepatan. Jika perlu, pemanggilan SoX terpisah dapat digunakan untuk membuat penyesuaian laju pengambilan sampel
sebelum digabungkan.

Jika metode penggabungan `concatenate' dipilih (biasanya, ini akan menjadi default) maka
file input juga harus memiliki jumlah saluran yang sama. Audio dari setiap masukan
akan digabungkan dalam urutan yang diberikan untuk membentuk file output.

Metode penggabungan `urutan' dipilih secara otomatis untuk bermain. Ini mirip dengan
`concatenate' di mana audio dari setiap file input dikirim secara serial ke file output.
Namun, di sini file keluaran dapat ditutup dan dibuka kembali pada transisi yang sesuai
antara file masukan. Ini mungkin yang diperlukan saat mengirim berbagai jenis audio
ke perangkat output, tetapi umumnya tidak berguna ketika output adalah file normal.

Jika metode penggabungan `mix' atau `mix-power' dipilih, maka dua atau lebih input
file harus diberikan dan akan dicampur bersama untuk membentuk file output. Jumlah
saluran di setiap file input tidak harus sama, tetapi SoX akan mengeluarkan peringatan jika ada
tidak dan beberapa saluran dalam file output tidak akan berisi audio dari setiap file input. A
file audio campuran tidak dapat dipisahkan tanpa referensi ke file input asli.

Jika metode penggabungan `merge' dipilih maka dua atau lebih file input harus diberikan dan
akan digabungkan bersama untuk membentuk file output. Jumlah saluran di setiap input
file tidak harus sama. File audio gabungan terdiri dari semua saluran dari semua
file masukan. Pembatalan penggabungan dimungkinkan menggunakan beberapa pemanggilan SoX dengan remix
memengaruhi. Misalnya, dua file mono dapat digabungkan untuk membentuk satu file stereo. Pertama
dan file mono kedua akan menjadi saluran kiri dan kanan dari file stereo.

Metode penggabungan `multiply' mengalikan nilai sampel dari saluran yang sesuai
(diperlakukan sebagai angka dalam interval -1 hingga +1). Jika jumlah saluran di input
file tidak sama, saluran yang hilang dianggap berisi semua nol.

Saat menggabungkan file input, SoX menerapkan efek tertentu (termasuk, misalnya,
vol efek penyesuaian volume) setelah audio digabungkan. Namun, seringkali
berguna untuk dapat mengatur volume (yaitu `balance') input secara individual, sebelum
penggabungan berlangsung.

Untuk semua metode penggabungan, penyesuaian volume file input dapat dilakukan secara manual menggunakan -v
opsi (di bawah) yang dapat diberikan untuk satu atau lebih file input. Jika hanya diberikan
beberapa file input maka yang lain tidak menerima penyesuaian volume. Dalam beberapa
keadaan, penyesuaian volume otomatis dapat diterapkan (lihat di bawah).

-V option (bawah) dapat digunakan untuk menampilkan penyesuaian volume file input yang telah
dipilih (baik secara manual atau otomatis).

Ada beberapa pertimbangan khusus yang perlu dilakukan saat mencampur file input:

Berbeda dengan metode lain, penggabungan `campuran' berpotensi menyebabkan kliping di
penggabung jika tidak ada penyeimbangan yang dilakukan. Dalam hal ini, jika penyesuaian volume manual tidak
diberikan, SoX akan mencoba untuk memastikan bahwa kliping tidak terjadi dengan secara otomatis menyesuaikan
volume (amplitudo) dari setiap sinyal input dengan faktor /n, di mana n adalah jumlah input
file. Jika ini menghasilkan audio yang terlalu sunyi atau tidak seimbang, maka input
volume file dapat diatur secara manual seperti dijelaskan di atas. Menggunakan norma efek pada campuran adalah
alternatif lain.

Jika audio campuran tampak cukup keras di beberapa titik tetapi terlalu sunyi di titik lain, maka rentang dinamis
kompresi harus diterapkan untuk memperbaiki ini - lihat teman efek.

Dengan metode kombinasi `mix-power', volume campuran kira-kira sama dengan volume
salah satu sinyal masukan. Ini dicapai dengan menyeimbangkan menggunakan faktor /√n alih-alih
/n. Perhatikan bahwa faktor penyeimbang ini tidak menjamin bahwa kliping tidak akan terjadi, tetapi
jumlah klip biasanya akan rendah dan distorsi yang dihasilkan umumnya
tak kelihatan.

Keluaran File
Perilaku default SoX adalah mengambil satu atau lebih file input dan menulisnya ke satu file
berkas keluaran.

Perilaku ini dapat diubah dengan menentukan efek semu `file baru' di dalam efek
Daftar. SoX kemudian akan masuk ke beberapa mode keluaran.

Dalam beberapa mode keluaran, file baru dibuat ketika efek sebelum `file baru'
menunjukkan mereka selesai. Rantai efek yang terdaftar setelah `file baru' kemudian dimulai dan
outputnya disimpan ke file baru.

Dalam beberapa mode keluaran, nomor unik akan secara otomatis ditambahkan ke akhir semua
nama file. Jika nama file memiliki ekstensi maka nomor dimasukkan sebelum
perpanjangan. Perilaku ini dapat disesuaikan dengan menempatkan %n di mana saja di nama file
di mana nomor harus diganti. Nomor opsional dapat ditempatkan setelah % to
menunjukkan lebar tetap minimum untuk nomor tersebut.

Mode keluaran ganda tidak terlalu berguna kecuali efek yang akan menghentikan rantai efek
awal ditentukan sebelum `file baru'. Jika akhir file tercapai sebelum efek
rantai berhenti sendiri maka tidak ada file baru yang akan dibuat karena akan kosong.

Berikut ini adalah contoh pemisahan 60 detik pertama dari file input menjadi dua 30
file kedua dan mengabaikan sisanya.
sox song.wav ringtone%1n.wav trim 0 30 : file baru : trim 0 30

Henti sox
Biasanya SoX akan menyelesaikan pemrosesannya dan keluar secara otomatis setelah membaca semua
data audio yang tersedia dari file input.

Jika diinginkan, dapat diakhiri lebih awal dengan mengirimkan sinyal interupsi ke proses
(biasanya dengan menekan tombol interupsi keyboard yang biasanya Ctrl-C). Ini adalah sebuah
persyaratan alami dalam beberapa keadaan, misalnya saat menggunakan SoX untuk membuat rekaman. Catatan
bahwa saat menggunakan SoX untuk memutar banyak file, Ctrl-C berperilaku sedikit berbeda: menekan
sekali menyebabkan SoX melompat ke file berikutnya; menekannya dua kali secara berurutan menyebabkan
SoX untuk keluar.

Pilihan lain untuk menghentikan pemrosesan lebih awal adalah dengan menggunakan efek yang memiliki jangka waktu atau
jumlah sampel untuk menentukan titik pemberhentian. Efek trim adalah contohnya. Satu kali
semua rantai efek telah berhenti maka SoX juga akan berhenti.

NAMA FILE

Nama file dapat berupa nama file sederhana, nama jalur absolut atau relatif, atau URL (file input
hanya). Perhatikan bahwa dukungan URL memerlukan itu wget(1) tersedia.

Catatan: Memberi SoX nama file input atau output yang sama dengan nama efek SoX akan
tidak berfungsi karena SoX akan memperlakukannya sebagai spesifikasi efek. Satu-satunya solusi untuk ini
adalah untuk menghindari nama file seperti itu. Ini umumnya tidak sulit karena sebagian besar nama file audio
memiliki nama file `ekstensi', sedangkan nama efek tidak.

Khusus Nama file
Nama file khusus berikut dapat digunakan dalam keadaan tertentu sebagai pengganti file normal
nama file pada baris perintah:

- SoX dapat digunakan dalam operasi pipa sederhana dengan menggunakan nama file khusus `-'
yang, jika digunakan sebagai nama file input, akan menyebabkan SoX akan membaca data audio dari
`standard input' (stdin), dan yang jika digunakan sebagai nama file output, akan menyebabkan SoX
akan mengirim data audio ke `output standar' (stdout). Perhatikan bahwa saat menggunakan ini
opsi untuk file output, dan terkadang saat menggunakannya untuk file input,
tipe file (lihat -t bawah) juga harus diberikan.

"|program [Pilihan] ..."
Ini dapat digunakan sebagai pengganti nama file input untuk menentukan program yang diberikan
output standar (stdout) digunakan sebagai file input. Tidak seperti - (atas), ini bisa menjadi
digunakan untuk beberapa input ke satu perintah SoX. Misalnya, jika `genw' menghasilkan mono
Sinyal berformat WAV ke output standarnya, maka perintah berikut membuat:
file stereo dari dua sinyal yang dihasilkan:
sox -M "|genw --imd -" "|genw --thd -" out.wav
Untuk audio tanpa header (mentah), -t (dan mungkin opsi format lainnya) perlu
diberikan, sebelum perintah input.

"wildcard-nama file"
Menentukan bahwa nama file `globbing' (pencocokan wild-card) harus dilakukan oleh SoX
bukannya oleh cangkangnya. Ini memungkinkan satu set opsi file diterapkan ke
sekelompok file. Misalnya, jika direktori saat ini berisi tiga `vox'
file, file1.vox, file2.vox, dan file3.vox, lalu
mainkan --rate 6k *.vox
akan diperluas oleh `shell' (di sebagian besar lingkungan) untuk
mainkan --rate 6k file1.vox file2.vox file3.vox
yang hanya akan memperlakukan file vox pertama yang memiliki laju sampel 6k. Dengan
mainkan --rate 6k "*.vox"
opsi laju sampel yang diberikan akan diterapkan ke ketiga file vox.

-p, --sox-pipa
Ini dapat digunakan sebagai pengganti nama file keluaran untuk menentukan bahwa perintah SoX
harus digunakan seperti pada pipa input ke perintah SoX lainnya. Misalnya, perintah:
mainkan "|sox -n -p synth 2" "|sox -n -p synth 2 tremolo 10" stat
memainkan dua `file' berturut-turut, masing-masing dengan efek yang berbeda.

-p sebenarnya adalah alias untuk `-t sox -'.

-d, --perangkat-default
Ini dapat digunakan sebagai pengganti nama file input atau output untuk menentukan bahwa
perangkat audio default (jika ada yang terpasang di SoX) akan digunakan. Ini mirip
untuk memohon rec or bermain (seperti yang dijelaskan di atas).

-n, --batal
Ini dapat digunakan sebagai pengganti nama file input atau output untuk menentukan bahwa `null
file' yang akan digunakan. Perhatikan bahwa di sini, `file null' mengacu pada SoX-spesifik
mekanisme dan tidak terkait dengan mekanisme sistem operasi apa pun dengan nama yang mirip.

Menggunakan file null untuk memasukkan audio sama dengan menggunakan file audio normal yang
berisi keheningan yang tak terbatas, dan karena itu umumnya tidak berguna kecuali
digunakan dengan efek yang menentukan panjang waktu yang terbatas (seperti memangkas or synth).

Menggunakan file null untuk mengeluarkan audio sama dengan membuang audio dan berguna
terutama dengan efek yang menghasilkan informasi tentang audio alih-alih memengaruhi
itu (seperti kebisinganprof or Stat).

Kecepatan pengambilan sampel yang terkait dengan file nol secara default adalah 48 kHz, tetapi, seperti halnya a
file normal, ini dapat diganti jika diinginkan menggunakan opsi format baris perintah
(Lihat di bawah).

Didukung File & Audio alat jenis
Lihat format sox(7) untuk daftar dan deskripsi format file dan perangkat audio yang didukung
driver.

PILIHAN

Aksi Opsi
Opsi ini dapat ditentukan pada baris perintah kapan saja sebelum efek pertama
Nama.

SOX_OPTS variabel lingkungan dapat digunakan untuk memberikan nilai default alternatif untuk
Opsi global SoX. Sebagai contoh:
SOX_OPTS="--buffer 20000 --play-rate-arg -hs --temp /mnt/temp"
Perhatikan bahwa pengaturan SOX_OPTS berpotensi membuat perubahan yang tidak diinginkan dalam perilaku
skrip atau program lain yang memanggil SoX. SOX_OPTS mungkin paling baik digunakan untuk hal-hal (seperti
seperti pada contoh yang diberikan) yang mencerminkan lingkungan tempat SoX dijalankan. Mengaktifkan
opsi seperti --tidak ada pemukul sebagai default mungkin ditangani lebih baik menggunakan alias shell karena
alias shell tidak akan memengaruhi operasi dalam skrip, dll.

Salah satu cara untuk memastikan bahwa skrip tidak dapat dipengaruhi oleh SOX_OPTS adalah dengan menghapus SOX_OPTS di
awal skrip, tetapi ini tentu saja kehilangan manfaat dari SOX_OPTS membawa beberapa
opsi default seluruh sistem. Pendekatan alternatif adalah secara eksplisit memanggil SoX dengan
nilai opsi default, mis
SOX_OPTS="-V --no-clobber"
...
sox -V2 --clobber $masukan $keluaran ...
Perhatikan bahwa cara mengatur variabel lingkungan bervariasi dari sistem ke sistem. Berikut adalah beberapa
contoh:

Pesta Unix:
ekspor SOX_OPTS="-V --no-clobber"
Csh Unix:
setenv SOX_OPTS "-V --no-clobber"
MS-DOS/MS-Windows:
atur SOX_OPTS=-V --no-clobber
GUI MS-Windows: melalui Panel Kontrol: Sistem: Tingkat Lanjut: Variabel Lingkungan

GUI Mac OS X: Lihat dokumen Q&A QA1067 Teknis Apple.

--penyangga BYTE, --masukan-buffer BYTE
Atur ukuran dalam byte buffer yang digunakan untuk memproses audio (default 8192).
--penyangga berlaku untuk input, efek, dan pemrosesan output; --masukan-buffer berlaku
hanya untuk pemrosesan input (yang menimpanya --penyangga jika keduanya diberikan).

Sadarilah bahwa nilai besar untuk --penyangga akan menyebabkan SoX menjadi lambat untuk merespon
untuk permintaan untuk menghentikan atau melewatkan file input saat ini.

--mengkritik
Jangan meminta sebelum menimpa file yang ada dengan nama yang sama seperti yang diberikan
untuk file keluaran. Ini adalah perilaku default.

--menggabungkan menggabungkan|bergabung|mencampur|kekuatan campuran|mengalikan|urutan
Pilih metode penggabungan file input; untuk beberapa di antaranya, opsi singkatnya adalah
tersedia: -m memilih `campuran', -M memilih `gabungkan', dan -T memilih `kalikan'.

Lihat Memasukkan File Menggabungkan di atas untuk deskripsi kombinasi yang berbeda
metode.

-D, --tidak gentar
Nonaktifkan gentar otomatis - lihat `Dithering' di atas. Contoh mengapa ini mungkin
kadang-kadang berguna adalah jika file telah dikonversi dari 16 menjadi 24 bit dengan
niat untuk melakukan beberapa pemrosesan di atasnya, tetapi sebenarnya tidak ada pemrosesan yang diperlukan setelahnya
semua dan file 16 bit asli telah hilang, maka, sebenarnya, tidak ada gentar
diperlukan jika mengonversi file kembali ke 16 bit. Lihat juga statistik efek untuk bagaimana
untuk menentukan kedalaman bit sebenarnya dari audio dalam file.

--efek-file NAMA FILE
Gunakan FILENAME untuk mendapatkan semua efek dan argumennya. File diuraikan seolah-olah
nilai-nilai yang ditentukan pada baris perintah. Baris baru dapat digunakan sebagai pengganti
yang spesial : penanda untuk memisahkan rantai efek. Untuk kenyamanan, penanda seperti di
akhir file biasanya diabaikan; jika Anda ingin menentukan yang terakhir kosong
rantai efek, gunakan eksplisit : dengan sendirinya pada baris terakhir file. Ini
opsi menyebabkan efek apa pun yang ditentukan pada baris perintah akan dibuang.

-G, --penjaga
Secara otomatis memanggil mendapatkan efek untuk menjaga terhadap kliping. Misalnya
sox -G infile -b 16 outfile rate 44100 gentar -s
adalah singkatan
sox infile -b 16 outfile gain -h rate 44100 gain -rh gentar -s
Lihat juga -V, --norma, dan mendapatkan efek.

-h, --membantu
Tampilkan nomor versi dan informasi penggunaan.

--bantuan-efek NAMA
Tampilkan informasi penggunaan pada efek yang ditentukan. Nama semua dapat digunakan untuk menunjukkan
penggunaan pada semua efek.

--membantu-format NAMA
Menampilkan informasi tentang format file yang ditentukan. Nama semua dapat digunakan untuk menunjukkan
informasi pada semua format.

--Saya, --info
Hanya jika diberikan sebagai parameter pertama untuk sox, berperilaku sebagai soksi(1).

-m|-M Setara dengan --menggabungkan mencampur dan --menggabungkan bergabung, Masing-masing.

--sihir
Jika SoX telah dibuat dengan pustaka `libmagic' opsional, maka opsi ini dapat
diberikan untuk memungkinkan penggunaannya dalam membantu mendeteksi jenis file audio.

--multi-utas | --berulir tunggal
Secara default, SoX adalah `single threaded'. jika --multi-utas pilihan diberikan
namun kemudian SoX akan memproses saluran audio untuk sebagian besar efek multi-saluran di
paralel pada arsitektur hyper-threading/multi-core. Ini dapat mengurangi pemrosesan
waktu, meskipun kadang-kadang mungkin perlu menggunakan opsi ini bersama dengan a
ukuran buffer yang lebih besar daripada default untuk mendapatkan manfaat apa pun dari multi-utas
pemrosesan (misalnya 131072; lihat --penyangga atas).

--tidak ada pemukul
Konfirmasi sebelum menimpa file yang ada dengan nama yang sama seperti yang diberikan untuk
berkas keluaran.

NB Secara tidak sengaja menimpa file lebih mudah dari yang Anda kira, karena
contoh, jika Anda tidak sengaja masuk
sox file1 file2 efek1 efek2 ...
ketika apa yang Anda maksud sebenarnya adalah
mainkan file1 file2 efek1 efek2 ...
kemudian, tanpa opsi ini, file2 akan ditimpa. Oleh karena itu, menggunakan opsi ini adalah
direkomendasikan. SOX_OPTS (di atas), alias `shell', skrip, atau file batch dapat berupa
cara yang tepat untuk mengaktifkannya secara permanen.

--norma[=tingkat dB]
Secara otomatis memanggil mendapatkan efek untuk menjaga terhadap kliping dan untuk menormalkan
audio. Misalnya
sox --norm infile -b 16 outfile rate 44100 gentar -s
adalah singkatan
sox infile -b 16 outfile gain -h rate 44100 gain -nh gentar -s
Secara opsional, audio dapat dinormalisasi ke tingkat tertentu (biasanya) di bawah 0 dBFS:
sox --norm=-3 file keluar file

Lihat juga -V, -G, dan mendapatkan efek.

--kecepatan bermain-arg ARG
Memilih opsi kualitas yang akan digunakan ketika efek `rate' secara otomatis dipanggil
saat memutar audio. Opsi ini biasanya diatur melalui SOX_OPTS lingkungan Hidup
variabel (lihat di atas).

--merencanakan gnuplot.dll|oktaf|lepas
Jika tidak disetel ke lepas (default jika --merencanakan tidak diberikan), jalankan dalam mode yang dapat
digunakan, bersama dengan program gnuplot atau program Oktaf GNU, untuk membantu
dengan pemilihan dan konfigurasi banyak dari fungsi transfer berbasis
efek. Untuk efek yang diberikan pertama yang mendukung program plot yang dipilih,
SoX akan menampilkan perintah untuk memplot fungsi transfer efek, dan kemudian keluar
tanpa benar-benar memproses audio apa pun. Misalnya
sox --plot oktaf input-file -n highpass 1320 > highpass.plt
oktaf highpass.plt

-q, --tidak ada kemajuan-pertunjukan
Jalankan dalam mode senyap ketika SoX tidak melakukannya. Ini adalah kebalikan dari
-S .

-R Jalankan dalam mode 'dapat diulang'. Ketika opsi ini diberikan, jika berlaku, SoX akan
menyematkan stempel waktu tetap dalam file keluaran (mis AIFF) dan akan `seed' pseudo
generator angka acak (mis gentar) dengan nomor tetap, sehingga memastikan bahwa
pemanggilan SoX berturut-turut dengan input yang sama dan parameter yang sama menghasilkan
keluaran yang sama.

--putar ulang-mendapatkan jalur|album|lepas
Pilih apakah akan menerapkan penyesuaian gain replay ke file input atau tidak. Standarnya
is lepas untuk sox dan rec, album untuk bermain di mana (setidaknya) dua file input pertama
ditandai dengan Artis dan Nama Album yang sama, dan jalur untuk bermain jika tidak.

-S, --tampilkan-kemajuan
Tampilkan informasi format/tajuk file input, dan kemajuan pemrosesan sebagai input
file(s) persentase selesai, waktu yang telah berlalu, dan waktu yang tersisa (jika diketahui; ditunjukkan dalam
kurung), dan jumlah sampel yang ditulis ke file output. Juga ditampilkan adalah
pengukur tingkat puncak, dan indikasi jika kliping telah terjadi. Pengukur level puncak
menampilkan hingga dua saluran dan dikalibrasi untuk audio digital sebagai berikut (kanan
saluran yang ditampilkan):

dB FSD Display dB FSD Display
-25 - -11 ====
-23 = -9 ====-
-21 =- -7 =====
-19 == -5 =====-
-17 ==- -3 ======

-15 === -1 =====!
-13 ===-

Nilai ruang kepala yang ditahan selama tiga detik dalam dB akan ditampilkan di sebelah kanan
meter jika ini di bawah 6dB.

Opsi ini diaktifkan secara default saat menggunakan SoX untuk memutar atau merekam audio.

-T Setara dengan --menggabungkan mengalikan.

--temp DIREKTORI
Tentukan bahwa file-file sementara harus dibuat dalam yang diberikan DIREKTORI. Ini
dapat berguna jika ada masalah izin atau ruang kosong dengan default
lokasi. Dalam hal ini, menggunakan `--temp .' (untuk menggunakan direktori saat ini) sering kali
solusi yang baik.

--Versi: kapan
Tunjukkan nomor versi SoX dan keluar.

-V[tingkat]
Tetapkan verbositas. Ini sangat berguna untuk melihat bagaimana efek otomatis
telah dipanggil oleh SoX.

SoX menampilkan pesan di konsol (stderr) sesuai dengan verbositas berikut:
level:

0 Tidak ada pesan yang ditampilkan sama sekali; gunakan status keluar untuk menentukan apakah ada kesalahan
telah terjadi.

1 Hanya pesan kesalahan yang ditampilkan. Ini dihasilkan jika SoX tidak dapat menyelesaikan
perintah-perintah yang diminta.

2 Pesan peringatan juga ditampilkan. Ini dihasilkan jika SoX dapat menyelesaikan
perintah yang diminta, tetapi tidak persis sesuai dengan perintah yang diminta
parameter, atau jika kliping terjadi.

3 Deskripsi fase pemrosesan SoX juga ditampilkan. Berguna untuk melihat
persis bagaimana SoX memproses audio Anda.

4 dan diatasnya
Pesan untuk membantu men-debug SoX juga ditampilkan.

Secara default, tingkat verbositas diatur ke 2 (menunjukkan kesalahan dan peringatan). Setiap
terjadinya -V opsi meningkatkan tingkat verbositas sebesar 1. Atau,
tingkat verbositas dapat diatur ke angka absolut dengan menentukannya segera setelah
itu -V, misalnya -V0 set ke 0.

Memasukkan File Opsi
Opsi ini hanya berlaku untuk file input dan mungkin hanya mendahului nama file input pada
garis komando.

--abaikan-panjang
Ganti panjang audio (salah) yang diberikan di header file audio. Jika ini
opsi diberikan maka SoX akan terus membaca audio hingga mencapai akhir
berkas masukan.

-v, --volume FAKTOR
Ditujukan untuk digunakan saat menggabungkan beberapa file input, opsi ini menyesuaikan
volume file yang mengikutinya pada baris perintah dengan faktor FAKTOR. Ini
memungkinkannya untuk `seimbang' dengan file input lainnya. Ini adalah linier
(amplitudo) penyesuaian, jadi angka kurang dari 1 mengurangi volume dan angka
lebih besar dari 1 meningkatkannya. Jika diberikan bilangan negatif maka selain
penyesuaian volume, sinyal audio akan dibalik.

Lihat juga norma, vol, dan mendapatkan efek, dan lihat Memasukkan File Balancing atas.

Memasukkan & Keluaran File dibentuk Opsi
Opsi ini berlaku untuk file input atau output yang namanya langsung didahului pada
baris perintah dan digunakan terutama saat bekerja dengan format file tanpa header atau ketika
menentukan format untuk file output yang berbeda dengan file input.

-b BITS, --bit BITS
Jumlah bit (alias kedalaman bit atau terkadang panjang kata) di setiap yang dikodekan
Sampel. Tidak berlaku untuk pengkodean kompleks seperti MP3 atau GSM. Tidak perlu
dengan pengkodean yang memiliki jumlah bit tetap, misalnya A/μ-law, ADPCM.

Untuk file input, penggunaan paling umum untuk opsi ini adalah untuk memberi tahu SoX tentang
jumlah bit per sampel dalam file audio `mentah' (`tanpa header'). Sebagai contoh
sox -r 16k -e ditandatangani -b 8 input.raw output.wav
mengonversi file `mentah' tertentu menjadi file `WAV' yang menggambarkan dirinya sendiri.

Untuk file keluaran, opsi ini dapat digunakan (mungkin bersama dengan -e) untuk mengatur
ukuran pengkodean keluaran. Secara default (yaitu jika opsi ini tidak diberikan), output
ukuran pengkodean akan (asalkan didukung oleh jenis file keluaran) diatur ke
ukuran pengkodean masukan. Sebagai contoh
sox masukan.cdda -b 24 keluaran.wav
mengonversi audio digital CD mentah (16-bit, integer bertanda) menjadi 24-bit (integer bertanda)
berkas 'WAV'.

-1/-2/-3/-4/-8
Jumlah byte dalam setiap sampel yang dikodekan. Alias ​​​​tidak digunakan lagi untuk -b 8, -b 16, -b
24, -b 32, -b 64 masing.

-c SALURAN, --saluran SALURAN
Jumlah saluran audio dalam file audio. Ini bisa berupa angka apa pun yang lebih besar dari
nol.

Untuk file input, penggunaan paling umum untuk opsi ini adalah untuk memberi tahu SoX tentang
jumlah saluran dalam file audio `mentah' (`tanpa header'). Kadang-kadang, mungkin saja
berguna untuk menggunakan opsi ini dengan file `header', untuk menimpa
(mungkin salah) nilai di header - perhatikan bahwa ini hanya didukung dengan
jenis file tertentu. Contoh:
sox -r 48k -e float -b 32 -c 2 masukan.output mentah.wav
mengonversi file `mentah' tertentu menjadi file `WAV' yang menggambarkan dirinya sendiri.
putar -c 1 music.wav
menginterpretasikan data file sebagai milik satu saluran terlepas dari apa itu
ditunjukkan di header file. Perhatikan bahwa jika file tersebut sebenarnya memiliki dua
saluran, ini akan mengakibatkan file diputar dengan kecepatan setengah.

Untuk file keluaran, opsi ini menyediakan singkatan untuk menentukan bahwa:
saluran efek harus dipanggil untuk mengubah (jika perlu) jumlah
saluran dalam sinyal audio ke nomor yang diberikan. Misalnya, dua berikut ini
perintah setara:
sox masukan.wav -c 1 keluaran.wav bass -b 24
sox input.wav output.wav bass -b 24 saluran 1
meskipun bentuk kedua lebih fleksibel karena memungkinkan efek untuk dipesan
semena-mena.

-e pengkodean, --pengkodean pengkodean
Jenis pengkodean audio. Terkadang dibutuhkan dengan tipe file yang mendukung lebih dari
satu jenis pengkodean. Misalnya, dengan mentah, WAV, atau AU (tetapi tidak, misalnya, dengan
MP3 atau FLAC). Jenis pengkodean yang tersedia adalah sebagai berikut:

bilangan bulat bertanda tangan
Data PCM disimpan sebagai bilangan bulat bertanda (`pelengkap dua'). Biasa digunakan dengan
ukuran pengkodean 16 atau 24-bit. Nilai 0 mewakili sinyal minimum
kekuasaan.

unsigned-integer
Data PCM disimpan sebagai bilangan bulat yang tidak ditandatangani. Umumnya digunakan dengan pengkodean 8-bit
ukuran. Nilai 0 mewakili kekuatan sinyal maksimum.

titik apung
Data PCM disimpan sebagai presisi tunggal IEEE 753 (32-bit) atau presisi ganda
(64-bit) angka floating-point (`nyata'). Nilai 0 mewakili minimum
kekuatan sinyal.

hukum Standar telepon internasional untuk pengkodean logaritmik hingga 8 bit per
Sampel. Ini memiliki presisi yang setara dengan kira-kira 13-bit PCM dan
terkadang dikodekan dengan urutan bit terbalik (lihat -X pilihan).

u-hukum, mertua
Standar telepon Amerika Utara untuk pengkodean logaritmik hingga 8 bit per
Sampel. Alias ​​-hukum. Ini memiliki presisi yang setara dengan kira-kira 14-bit PCM
dan kadang-kadang dikodekan dengan urutan bit terbalik (lihat -X pilihan).

oke-adpcm
OKI (alias VOX, Dialogic, atau Intel) 4-bit ADPCM; memiliki presisi
setara dengan kira-kira 12-bit PCM. ADPCM adalah bentuk kompresi audio yang
memiliki kompromi yang baik antara kualitas audio dan kecepatan encoding/decoding.

ima-adpcm
IMA (alias DVI) 4-bit ADPCM; itu memiliki presisi yang setara dengan kira-kira
PCM 13-bit.

ms-adpcm
Microsoft 4-bit ADPCM; ia memiliki presisi yang setara dengan kira-kira 14-bit PCM.

tarif penuh gsm
GSM saat ini digunakan untuk sebagian besar nirkabel digital dunia
panggilan telepon. Ini menggunakan beberapa format audio dengan bit-rate yang berbeda
dan kualitas bicara yang terkait. SoX memiliki dukungan untuk 13kbps asli GSM
format audio 'Rasio Penuh'. Biasanya CPU-intensif untuk bekerja dengan GSM
Audio.

Nama pengkodean dapat disingkat di mana ini tidak akan ambigu; misalnya
`unsigned-integer' dapat diberikan sebagai `un', tetapi bukan `u' (ambigu dengan `u-law').

Untuk file input, penggunaan paling umum untuk opsi ini adalah untuk memberi tahu SoX tentang
encoding file audio `mentah' (`headerless') (lihat contoh di -b dan -c
atas).

Untuk file keluaran, opsi ini dapat digunakan (mungkin bersama dengan -b) untuk mengatur
jenis pengkodean keluaran Misalnya
sox masukan.cdda -e float keluaran1.wav

sox masukan.cdda -b 64 -e float keluaran2.wav
mengonversi audio digital CD mentah (16-bit, integer bertanda) ke file `WAV' titik-mengambang
(masing-masing presisi tunggal & ganda).

Secara default (yaitu jika opsi ini tidak diberikan), jenis pengkodean keluaran akan
(asalkan didukung oleh jenis file output) diatur ke pengkodean input
mengetik.

-s/-u/-f/-A/-U/-o/-i/-a/-g
Alias ​​​​yang tidak digunakan lagi untuk menentukan jenis penyandian bilangan bulat bertanda tangan, tidak ditandatangani-
bilangan bulat, titik apung, hukum, mertua, oke-adpcm, ima-adpcm, ms-adpcm, gsm-penuh-
tarif masing-masing (lihat -e atas).

--tidak ada gumpalan
Menentukan bahwa nama file `globbing' (pencocokan wild-card) tidak boleh dilakukan oleh
SoX pada nama file berikut. Misalnya, jika direktori saat ini berisi
dua file `five-seconds.wav' dan `five*.wav', lalu
mainkan --no-glob "five*.wav"
dapat digunakan untuk memutar file tunggal `five*.wav'.

-R, --kecepatan MENILAI[k]
Memberikan laju sampel dalam Hz (atau kHz jika ditambahkan dengan `k') file.

Untuk file input, penggunaan paling umum untuk opsi ini adalah untuk memberi tahu SoX tentang
sample rate file audio `mentah' (`headerless') (lihat contoh di -b dan -c
di atas). Kadang-kadang mungkin berguna untuk menggunakan opsi ini dengan file `headed',
untuk mengganti nilai (mungkin salah) di header - perhatikan bahwa
ini hanya didukung dengan jenis file tertentu. Misalnya, jika audio direkam
dengan tingkat sampel katakanlah 48k dari sumber yang memutar ulang sedikit, katakanlah 1.5%,
terlalu lambat, lalu
sox -r 48720 masukan.wav keluaran.wav
secara efektif memperbaiki kecepatan dengan hanya mengubah header file (tetapi lihat juga:
kecepatan efek untuk solusi yang lebih biasa untuk masalah ini).

Untuk file keluaran, opsi ini menyediakan singkatan untuk menentukan bahwa: tarif
efek harus dipanggil untuk mengubah (jika perlu) laju sampel dari
sinyal audio ke nilai yang diberikan. Misalnya, dua perintah berikut adalah
setara:
sox masukan.wav -r 48k keluaran.wav bass -b 24
sox input.wav output.wav bass -b 24 kecepatan 48k
meskipun bentuk kedua lebih fleksibel karena memungkinkan tarif pilihan yang akan diberikan, dan
memungkinkan efek untuk dipesan secara sewenang-wenang.

-t, --Tipe JENIS FILE
Memberikan jenis file audio. Untuk file input dan output, opsi ini adalah
biasanya digunakan untuk menginformasikan SoX tentang jenis file audio `tanpa header' (misalnya mentah, mp3)
di mana tipe aktual/diinginkan tidak dapat ditentukan dari ekstensi nama file yang diberikan.
Sebagai contoh:
perintah lain | sox -t mp3 - output.wav

sox input.wav -t output mentah.bin
Itu juga dapat digunakan untuk mengganti tipe yang tersirat oleh ekstensi nama file input,
tetapi jika mengganti dengan tipe yang memiliki header, SoX akan keluar dengan yang sesuai
pesan kesalahan jika tajuk seperti itu tidak benar-benar ada.

Lihat format sox(7) untuk daftar jenis file yang didukung.

-L, --endian sedikit
-B, --endian besar
-x, --endian menukar
Opsi ini menentukan apakah urutan byte data audio, masing-masing,
`little endian', `big endian', atau kebalikan dari sistem di mana SoX
sedang dipakai. Endianness hanya berlaku untuk data yang dikodekan sebagai floating-point, atau sebagai
bilangan bulat bertanda atau tidak bertanda dari 16 bit atau lebih. Seringkali perlu untuk menentukan
salah satu opsi ini untuk file tanpa header, dan terkadang diperlukan untuk (jika tidak)
file yang menggambarkan diri sendiri. Opsi pengaturan endian yang diberikan dapat diabaikan untuk input
file yang headernya berisi pengenal endianness tertentu, atau untuk file output
yang sebenarnya adalah perangkat audio.

NB Tidak seperti karakteristik format lainnya, endianness (byte, nibble, & bit
pemesanan) dari file input tidak secara otomatis digunakan untuk file output; jadi untuk
contoh, ketika berikut ini dijalankan pada sistem little-endian:
sox -B audio.s16 dipangkas.s16 trim 2
trimmed.s16 akan dibuat sebagai little-endian;
sox -B audio.s16 -B dipangkas.s16 trim 2
harus digunakan untuk mempertahankan big-endianness dalam file output.

-V pilihan dapat digunakan untuk memeriksa pemesanan yang dipilih.

-N, --reverse-camilan
Menentukan bahwa urutan gigitan (yaitu 2 bagian byte) dari sampel
harus dibalik; terkadang berguna dengan format berbasis ADPCM.

NB Lihat juga NB di bagian -x atas.

-X, --reverse-bit
Menentukan bahwa urutan bit sampel harus dibalik; kadang berguna
dengan beberapa format (kebanyakan tanpa header).

NB Lihat juga NB di bagian -x atas.

Keluaran File dibentuk Opsi
Opsi ini hanya berlaku untuk file keluaran dan mungkin hanya mendahului nama file keluaran pada
baris perintah.

--Tambahkan komentar TEKS
Tambahkan komentar di header file output (jika ada).

--komentar TEKS
Tentukan teks komentar untuk disimpan di header file output (jika ada).

SoX akan memberikan komentar default jika opsi ini (atau --komentar-file) tidak diberikan.
Untuk menentukan bahwa tidak ada komentar yang harus disimpan dalam file output, gunakan --komentar "" .

--komentar-file NAMA FILE
Tentukan file yang berisi teks komentar untuk disimpan di header file output
(mana yang berlaku).

-C, --kompresi FAKTOR
Faktor kompresi untuk mengompresi format file keluaran secara bervariasi. Jika ini
pilihan tidak diberikan maka faktor kompresi default akan berlaku. Kompresi
faktor ditafsirkan secara berbeda untuk format file kompresi yang berbeda. Lihat
deskripsi format file yang menggunakan opsi ini di format sox(7) untuk lebih
informasi.

EFEK

Selain mengonversi, memutar, dan merekam file audio, SoX dapat digunakan untuk memanggil a
jumlah `efek' audio. Beberapa efek dapat diterapkan dengan menentukannya satu demi satu
lain di akhir baris perintah SoX, membentuk `rantai efek'. Perhatikan bahwa
menerapkan beberapa efek secara real-time (yaitu saat memutar audio) kemungkinan akan memerlukan
komputer kinerja tinggi. Menghentikan aplikasi lain dapat mengurangi masalah kinerja
haruskah mereka terjadi.

Beberapa efek SoX terutama dimaksudkan untuk diterapkan pada instrumen tunggal atau
'suara'. Untuk memfasilitasi hal tersebut, remix efek dan opsi SoX global -M dapat digunakan untuk
mengisolasi kemudian menggabungkan kembali trek dari rekaman multi-track.

kelipatan efek Rantai
Rantai efek tunggal terdiri dari satu atau lebih efek. Audio dari input berjalan
melalui rantai sampai akhir file input tercapai atau efek di
rantai permintaan untuk mengakhiri rantai.

SoX mendukung menjalankan beberapa rantai efek melalui audio input. Dalam hal ini, ketika seseorang
rantai menunjukkan itu selesai memproses audio, data audio kemudian dikirim melalui yang berikutnya
rantai efek. Ini berlanjut sampai tidak ada lagi rantai efek atau input memiliki
mencapai akhir file.

Rantai efek diakhiri dengan menempatkan : (usus besar) setelah efek. Berikut ini
efek adalah bagian dari rantai efek baru.

Penting untuk menempatkan efek yang akan menghentikan rantai sebagai efek pertama di
rantai. Ini karena setiap sampel yang disangga oleh efek di sebelah kiri
efek penghentian akan dibuang. Jumlah sampel yang dibuang berhubungan dengan
--penyangga opsi dan harus dijaga tetap kecil, relatif terhadap laju sampel, jika
efek penghentian tidak bisa menjadi yang pertama. Informasi lebih lanjut tentang efek penghentian dapat ditemukan
dalam Henti sox bagian.

Ada beberapa efek semu yang membantu menggunakan rantai efek ganda. Ini termasuk
file baru yang akan mulai menulis ke file keluaran baru sebelum pindah ke efek berikutnya
rantai dan Restart yang akan kembali ke rantai efek pertama. Efek semu harus
ditentukan sebagai efek pertama dalam rantai dan sebagai satu-satunya efek dalam rantai (mereka harus memiliki
a : sebelum dan sesudah ditentukan).

Berikut ini adalah contoh rantai efek ganda. Ini akan membagi file input menjadi
beberapa file berdurasi 30 detik. Setiap nama file keluaran akan memiliki nomor unik di
namanya seperti yang didokumentasikan dalam Keluaran File bagian.
sox infile.wav output.wav trim 0 30 : file baru : restart

Umum catatan Dan Parameters
Dalam uraian berikut, tanda kurung [ ] digunakan untuk menunjukkan parameter yang
opsional, kurung kurawal {} untuk menunjukkan yang opsional dan dapat diulang, dan sudut
kurung < > untuk menunjukkan yang dapat diulang tetapi tidak opsional. Mana yang berlaku,
nilai default untuk parameter opsional ditunjukkan dalam tanda kurung ( ).

Parameter berikut digunakan dengan, dan memiliki arti yang sama untuk, beberapa efek:

pusat[k]
Lihat frekuensi.

frekuensi[k]
Frekuensi dalam Hz, atau, jika ditambahkan dengan `k', kHz.

mendapatkan Penguatan daya dalam dB. Nol tidak memberikan keuntungan; kurang dari nol memberikan redaman.

lebar[h|k|o|q]
Digunakan untuk menentukan lebar pita filter. Sejumlah metode berbeda untuk
tentukan lebar yang tersedia (meskipun tidak semua untuk setiap efek). salah satu dari
karakter yang ditampilkan dapat ditambahkan untuk memilih metode yang diinginkan sebagai berikut:

metode Catatan
h Hz
k kHz
o Oktaf
q Q-faktor Lihat [2]

Untuk setiap efek yang menggunakan parameter ini, metode default (yaitu jika tidak ada karakter
ditambahkan) adalah salah satu yang terdaftar pertama di baris pertama dari efek
deskripsi.

Untuk melihat apakah SoX memiliki dukungan untuk efek opsional, masukkan sox -h dan cari namanya di bawah
daftar: 'EFEK'.

Didukung efek
Catatan: daftar efek yang dikategorikan dapat ditemukan di file `README' yang menyertainya.

lulus frekuensi[k] lebar[h|k|o|q]
Terapkan filter all-pass dua kutub dengan frekuensi pusat (dalam Hz) frekuensi, dan
lebar filter lebar. Filter all-pass mengubah frekuensi audio ke fase
hubungan tanpa mengubah frekuensi ke hubungan amplitudo. Filternya
dijelaskan secara rinci dalam [1].

Efek ini mendukung --merencanakan pilihan global.

pita [-n] pusat[k] [lebar[h|k|o|q]]
Terapkan filter band-pass. Respons frekuensi turun secara logaritmik di sekitar
pusat frekuensi. NS lebar parameter memberikan kemiringan penurunan. NS
frekuensi di pusat + lebar dan pusat - lebar akan menjadi setengah dari aslinya
amplitudo. pita default ke mode yang berorientasi ke audio bernada, yaitu suara,
nyanyian, atau musik instrumental. NS -n (untuk noise) opsi menggunakan mode alternatif
untuk audio yang tidak bernada (misalnya perkusi). Peringatan: -n memperkenalkan power-gain dari
sekitar 11dB di filter, jadi waspadalah terhadap kliping keluaran. pita memperkenalkan kebisingan di
bentuk filter, yaitu memuncak pada pusat frekuensi dan menetap di sekitar
.

Efek ini mendukung --merencanakan pilihan global.

Lihat juga tulus untuk filter bandpass dengan bahu yang lebih curam.

bandpass|penolakan band [-c] frekuensi[k] lebar[h|k|o|q]
Terapkan filter band-pass atau band-reject Butterworth dua kutub dengan frekuensi pusat
frekuensi, dan lebar pita (3dB-point) lebar. itu -c pilihan hanya berlaku untuk
bandpass dan memilih penguatan skirt konstan (gain puncak = Q) alih-alih default:
gain puncak 0dB konstan. Filter meluncur pada 6dB per oktaf (20dB per dekade)
dan dijelaskan secara rinci dalam [1].

Efek ini mendukung --merencanakan pilihan global.

Lihat juga tulus untuk filter bandpass dengan bahu yang lebih curam.

penolakan band frekuensi[k] lebar[h|k|o|q]
Terapkan filter band-reject. Lihat deskripsi bandpass efek untuk
rincian.

bas|tiga kali lipat mendapatkan [frekuensi[k] [lebar[s|h|k|o|q]]]
Tingkatkan atau potong frekuensi bass (bawah) atau treble (atas) audio menggunakan a
filter rak dua kutub dengan respons yang mirip dengan respons hi-fi standar
kontrol nada. Ini juga dikenal sebagai pemerataan rak (EQ).

mendapatkan memberikan keuntungan pada 0 Hz (untuk bas), atau mana yang lebih rendah dari 22 kHz dan
frekuensi Nyquist (untuk tiga kali lipat). Rentang kegunaannya adalah sekitar -20 (untuk ukuran besar
potong) menjadi +20 (untuk dorongan besar). Hati-hati terhadap Guntingan saat menggunakan positif mendapatkan.

Jika diinginkan, filter dapat disesuaikan menggunakan parameter opsional berikut:

frekuensi menyetel frekuensi pusat filter sehingga dapat digunakan untuk memperpanjang atau
mengurangi rentang frekuensi yang akan ditingkatkan atau dipotong. Nilai default adalah 100 Hz (untuk
bas) atau 3 kHz (untuk tiga kali lipat).

lebar menentukan seberapa curam transisi rak filter. Selain itu
metode spesifikasi lebar umum yang dijelaskan di atas, `slope' (default, atau jika
ditambahkan dengan `s') dapat digunakan. Rentang `kemiringan' yang berguna adalah sekitar 0.3, untuk a
kemiringan landai, sampai 1 (maksimum), untuk kemiringan curam; nilai defaultnya adalah 0.5.

Filter dijelaskan secara rinci dalam [1].

Efek ini mendukung --merencanakan pilihan global.

Lihat juga equalizer untuk efek pemerataan memuncak.

membungkuk [-f kecepatan bingkai(25)] [-o sampel berlebih(16)] { menunda,sen,lamanya }
Mengubah nada dengan jumlah tertentu pada waktu tertentu. Setiap rangkap tiga yang diberikan:
menunda,sen,lamanya menentukan satu tikungan. menunda adalah jumlah waktu setelah
awal aliran audio, atau akhir tikungan sebelumnya, di mana untuk memulai
menekuk lapangan; sen adalah jumlah sen (100 sen = 1 seminada) dimana
untuk menekuk nada, dan lamanya lamanya waktu di mana nada akan menjadi
adalah.

Algoritma pitch-bending menggunakan Discrete Fourier Transform (DFT) pada a
frame rate tertentu dan over-sampling rate. NS -f dan -o parameter dapat digunakan
untuk menyesuaikan parameter ini dan dengan demikian mengontrol kelancaran perubahan nada.

Misalnya, nada awal yang dihasilkan, kemudian ditekuk tiga kali, menghasilkan empat
catatan yang berbeda secara total:
mainkan -n synth 2.5 sin 667 gain 1 \
bend .35,180,.25 .15,740,.53 0,-520,.3
Perhatikan bahwa kliping yang dihasilkan dalam contoh ini disengaja; untuk menghapus
itu, gunakan mendapatkan -5 di tempat mendapatkan 1.

Lihat juga nada.

biquad b0 b1 b2 a0 a1 a2
Terapkan filter biquad IIR dengan koefisien yang diberikan. Dimana b* dan a* adalah
koefisien pembilang dan penyebut masing-masing.

Lihat http://en.wikipedia.org/wiki/Digital_biquad_filter (dimana a0 = 1).

Efek ini mendukung --merencanakan pilihan global.

saluran SALURAN
Panggil algoritme sederhana untuk mengubah jumlah saluran dalam sinyal audio menjadi
nomor yang diberikan SALURAN: pencampuran jika mengurangi jumlah saluran atau
menggandakan jika menambah jumlah saluran.

saluran efek dipanggil secara otomatis jika SoX's -c opsi menentukan nomor
saluran yang berbeda dengan file input. Atau, jika ini
efek diberikan secara eksplisit, maka SoX's -c pilihan tidak perlu diberikan. Sebagai contoh,
dua perintah berikut ini setara:
sox masukan.wav -c 1 keluaran.wav bass -b 24
sox input.wav output.wav bass -b 24 saluran 1
meskipun bentuk kedua lebih fleksibel karena memungkinkan efek untuk dipesan
semena-mena.

Lihat juga remix untuk efek yang memungkinkan saluran dicampur/dipilih secara sewenang-wenang.

paduan suara keuntungan keuntungan <menunda kerusakan kecepatan kedalaman -s|-t>
Tambahkan efek paduan suara ke audio. Ini dapat membuat suara vokal tunggal seperti
paduan suara, tetapi juga dapat diterapkan pada instrumentasi.

Chorus menyerupai efek gema dengan penundaan singkat, tetapi sedangkan dengan gema penundaan
konstan, dengan paduan suara, bervariasi menggunakan modulasi sinusoidal atau segitiga.
Kedalaman modulasi menentukan rentang penundaan termodulasi yang dimainkan sebelum atau
setelah penundaan. Oleh karena itu suara yang tertunda akan terdengar lebih lambat atau lebih cepat, yaitu
suara tertunda disetel di sekitar yang asli, seperti dalam paduan suara di mana beberapa vokal berada
sedikit lepas kunci. Lihat [3] untuk diskusi lebih lanjut tentang efek chorus.

Setiap penundaan/peluruhan/kecepatan/kedalaman parameter empat tupel memberikan penundaan dalam milidetik
dan peluruhan (relatif terhadap gain-in) dengan kecepatan modulasi dalam Hz menggunakan depth in
milidetik. Modulasinya berupa sinusoidal (-s) atau segitiga (-t). Memperoleh-
keluar adalah volume keluaran.

Penundaan tipikal adalah sekitar 40ms hingga 60ms; kecepatan modulasi terbaik mendekati 0.25Hz
dan kedalaman modulasi sekitar 2ms. Misalnya, penundaan tunggal:
main guitar1.wav chorus 0.7 0.9 55 0.4 0.25 2 -t
Dua penundaan dari sampel asli:
main guitar1.wav chorus 0.6 0.9 50 0.4 0.25 2 -t \
60 0.32 0.4 1.3 -s
Paduan suara yang terdengar lebih lengkap (dengan tiga penundaan tambahan):
main guitar1.wav chorus 0.5 0.9 50 0.4 0.25 2 -t \
60 0.32 0.4 2.3 -t 40 0.3 0.3 1.3 -s

teman serang1,peluruhan1{,serang2,peluruhan2}
[lutut-lunak-dB:]di-dB1[,keluar-dB1]{,di-dB2,keluar-dB2}
[mendapatkan [volume awal-dB [menunda]]]

Compand (kompres atau perluas) rentang dinamis audio.

menyerang dan kerusakan parameter (dalam detik) menentukan waktu di mana
level sesaat dari sinyal input dirata-ratakan untuk menentukan volumenya;
serangan mengacu pada peningkatan volume dan peluruhan mengacu pada penurunan. Untuk kebanyakan
situasi, waktu serangan (respon terhadap musik semakin keras) harus
lebih pendek dari waktu pembusukan karena telinga manusia lebih sensitif terhadap suara keras yang tiba-tiba
musik daripada musik lembut yang tiba-tiba. Di mana lebih dari satu pasang parameter serangan/peluruhan
ditentukan, setiap saluran input disusun secara terpisah dan jumlah pasangan
harus setuju dengan jumlah saluran input. Nilai tipikal adalah 0.3,0.8 detik.

Parameter kedua adalah daftar poin pada fungsi transfer compander
ditentukan dalam dB relatif terhadap amplitudo sinyal maksimum yang mungkin. masukan
nilai harus dalam urutan yang benar-benar meningkat tetapi fungsi transfer tidak
harus naik secara monoton. Jika dihilangkan, nilai keluar-dB1 default ke
nilai yang sama dengan di-dB1; level di bawah di-dB1 tidak dipaksa (tetapi mungkin memiliki keuntungan
diterapkan pada mereka). Inti nya 0,0 diasumsikan tetapi dapat diganti (oleh 0,keluar-dBn).
Jika daftar didahului oleh lutut-lunak-dB nilai, maka titik-titik di mana berdekatan
segmen garis pada fungsi transfer bertemu akan dibulatkan dengan jumlah yang diberikan.
Nilai khas untuk fungsi transfer adalah 6:-70,-60,-20.

Parameter ketiga (opsional) adalah penguatan tambahan dalam dB untuk diterapkan sama sekali
poin pada fungsi transfer dan memungkinkan penyesuaian gain secara keseluruhan dengan mudah.

Parameter keempat (opsional) adalah level awal yang diasumsikan untuk setiap saluran
saat penyusunan dimulai. Ini memungkinkan pengguna untuk memasok tingkat nominal pada awalnya,
sehingga, misalnya, penguatan yang sangat besar tidak diterapkan pada level sinyal awal
sebelum tindakan pendampingan mulai beroperasi: sangat mungkin bahwa dalam
peristiwa seperti itu, output akan sangat terpotong sementara kompander mendapatkan
menyesuaikan diri dengan benar. Nilai tipikal (untuk audio yang awalnya senyap) adalah
-90 dB.

Parameter kelima (opsional) adalah penundaan dalam hitungan detik. Sinyal input dianalisis
segera untuk mengontrol compander, tetapi ditunda sebelum diumpankan ke
pengatur volume. Menentukan penundaan yang kira-kira sama dengan waktu serangan/peluruhan
memungkinkan compander untuk beroperasi secara efektif dalam `prediktif' daripada a
modus reaktif. Nilai tipikal adalah 0.2 detik.

* * *

Contoh berikut dapat digunakan untuk membuat karya musik dengan tenang dan
bagian keras yang cocok untuk mendengarkan di lingkungan yang bising seperti bergerak
kendaraan:
sox asz.wav asz-car.wav compand 0.3,1 6:-70,-60,-20 -5 -90 0.2
Fungsi transfer (`6:-70,...') mengatakan bahwa suara yang sangat lembut (di bawah -70dB) akan
tetap tidak berubah. Ini akan menghentikan compander dari meningkatkan volume pada
bagian `diam' seperti di antara gerakan. Namun, suara dalam kisaran -60dB hingga
0dB (volume maksimum) akan ditingkatkan sehingga rentang dinamis 60dB dari aslinya
musik akan dikompresi 3-ke-1 menjadi rentang 20dB, yang cukup lebar untuk dinikmati
musik tetapi cukup sempit untuk mengatasi kebisingan jalan. `6:' memilih 6dB
companding lutut lunak. Penguatan keluaran -5 (dB) diperlukan untuk menghindari kliping (
jumlahnya tidak tepat, dan diturunkan dengan eksperimen). -90 (dB) untuk
volume awal akan berfungsi dengan baik untuk klip yang dimulai dengan hampir hening, dan
penundaan 0.2 (detik) memiliki efek menyebabkan kompander bereaksi sedikit lebih banyak
cepat hingga perubahan volume mendadak.

Dalam contoh berikutnya, compand digunakan sebagai gerbang kebisingan ketika kebisingan berada di
tingkat yang lebih rendah dari sinyal:
mainkan infile compand .1,.2 -inf,-50.1,-inf,-50,-50 0 -90 .1
Inilah gerbang kebisingan lainnya, kali ini ketika kebisingan berada pada tingkat yang lebih tinggi dari
sinyal (membuatnya, dalam beberapa hal, mirip dengan memadamkan):
mainkan infile compand .1,.1 -45.1,-45,-inf,0,-inf 45 -90 .1
Efek ini mendukung --merencanakan opsi global (untuk fungsi transfer).

Lihat juga compand untuk efek penggabungan beberapa pita.

kontras [peningkatan-jumlah(75)]
Sebanding dengan kompresi, efek ini memodifikasi sinyal audio untuk membuatnya terdengar
lebih keras. peningkatan-jumlah mengontrol jumlah peningkatan dan merupakan angka
dalam kisaran 0-100. Perhatikan bahwa peningkatan-jumlah = 0 masih memberikan signifikan
peningkatan kontras.

Lihat juga teman dan compand efek.

pergeseran dc bergeser [pembatas keuntungan]
Terapkan pergeseran DC ke audio. Ini berguna untuk menghilangkan offset DC (disebabkan
mungkin oleh masalah perangkat keras dalam rantai rekaman) dari audio. Efeknya
offset DC berkurang ruang kepala dan karenanya volume. NS Stat or statistik efek bisa
digunakan untuk menentukan apakah sinyal memiliki offset DC.

Pemberian pergeseran dc nilai adalah angka floating point dalam kisaran ±2 itu
menunjukkan jumlah pergeseran audio (yang berada dalam kisaran ±1).

Opsional pembatas keuntungan dapat ditentukan juga. Itu harus memiliki nilai yang jauh lebih sedikit
dari 1 (misalnya 0.05 atau 0.02) dan hanya digunakan pada puncak untuk mencegah kliping.

* * *

Pendekatan alternatif untuk menghilangkan offset DC (walaupun dengan penundaan singkat) adalah dengan
gunakan jalan raya efek filter pada frekuensi katakanlah 10Hz, seperti yang diilustrasikan pada
contoh berikut:
sox -n dc.wav synth 5 sin %0 50
sox dc.wav fixed.wav jalan pintas 10

mendalam Terapkan pengurangan penekanan Compact Disc (IEC 60908) (filter rak redaman treble).

Pre-emphasis diterapkan dalam mastering beberapa CD yang dikeluarkan pada awal 1980-an.
Ini termasuk banyak album musik klasik, serta masalah yang sekarang banyak dicari dari
album oleh The Beatles, Pink Floyd dan lain-lain. Pra-penekanan harus dihilangkan pada
waktu pemutaran dengan filter de-emphasis di perangkat pemutaran. Namun, tidak semua
pemutar CD modern memiliki filter ini, dan sangat sedikit drive CD PC yang memilikinya; bermain pra-
audio yang ditekankan tanpa filter de-penekanan yang benar menghasilkan audio yang
terdengar kasar dan jauh dari apa yang dimaksudkan penciptanya.

Dengan mendalam efeknya, dimungkinkan untuk menerapkan penekanan yang diperlukan pada audio
yang telah diekstraksi dari CD yang telah ditekankan sebelumnya, dan kemudian membakar de-
audio yang ditekankan ke CD baru (yang kemudian akan diputar dengan benar di pemutar CD mana pun), atau
cukup putar file audio yang dihilangkan penekanannya dengan benar di PC. Sebagai contoh:
sox track1.wav track1-deemph.wav deemph
lalu bakar track1-deemph.wav ke CD, atau
putar track1-deemph.wav
atau hanya
mainkan track1.wav deemph
Filter de-emphasis diimplementasikan sebagai biquad; simpangan maksimumnya dari
respon ideal hanya 0.06dB (hingga 20kHz).

Efek ini mendukung --merencanakan pilihan global.

Lihat juga bas dan tiga kali lipat efek pemerataan rak.

menunda {panjangnya}
Tunda satu atau lebih saluran audio. panjangnya dapat menentukan waktu atau, jika ditambahkan dengan
sebuah `s', sejumlah sampel. Jangan tentukan penundaan waktu dan sampel dalam
perintah yang sama. Sebagai contoh, menunda 1.5 0 0.5 menunda saluran pertama sebesar 1.5
detik, saluran ketiga sebesar 0.5 detik, dan meninggalkan saluran kedua (dan setiap
saluran lain yang mungkin ada) tidak tertunda. Perintah berikut (satu panjang)
memainkan suara lonceng:
mainkan -n synth -j 3 sin %3 sin %-2 sin %-5 sin %-9 \
sin %-14 sin %-21 fade h .01 2 1.5 tunda \
1.3 1 .76 .54 remix - fade h 27 0 2.7 norma -2.5
dan ini memainkan akord gitar:
mainkan -n synth pl G2 pl B2 pl D3 pl G3 pl D4 pl G4 \
delay 0 .05 .1 .15 .2 .25 remix - fade 0 4 .1 norma -1

gentar [-S|-s|-f menyaring] [-a] [-p ketelitian]
Terapkan dithering ke audio. Dithering dengan sengaja menambahkan sedikit noise
ke sinyal untuk menutupi efek kuantisasi terdengar yang dapat terjadi jika
ukuran sampel keluaran kurang dari 24 bit. Tanpa opsi, efek ini akan menambahkan
derau putih segitiga (TPDF). Pembentukan kebisingan (hanya untuk tingkat sampel tertentu) dapat
dipilih dengan -s. Dengan -f pilihan, adalah mungkin untuk memilih tertentu
filter pembentuk kebisingan dari daftar berikut: lipshitz, f-weighted, modified-e-
tertimbang, ditingkatkan-e-tertimbang, gesemann, shibata, shibata rendah, shibata tinggi. Catatan
bahwa sebagian besar jenis filter hanya tersedia dengan laju sampel 44100Hz. Filternya
jenis dibedakan oleh sifat-sifat berikut: audibilitas kebisingan, tingkat
(tidak terdengar, tetapi dalam beberapa keadaan, jika tidak bermasalah) berbentuk frekuensi tinggi
kebisingan, dan kecepatan pemrosesan.
Lihat http://sox.sourceforge.net/SoX/NoiseShaping untuk grafik kebisingan yang berbeda-
membentuk kurva.

-S opsi memilih TPDF yang sedikit `miring', bias ke frekuensi yang lebih tinggi.
Ini dapat digunakan pada laju pengambilan sampel apa pun tetapi di bawah 22k, TPDF biasa mungkin lebih baik,
dan di atas 37k, noise-shaped mungkin lebih baik.

-a opsi mengaktifkan mode di mana dithering (dan pembentukan kebisingan jika berlaku) adalah
diaktifkan secara otomatis hanya bila diperlukan. Penggunaan yang paling mungkin untuk ini adalah ketika
menerapkan fade in atau out ke file yang sudah ragu-ragu, sehingga redithering
hanya berlaku untuk bagian yang pudar. Namun, dithering otomatis tidak mudah, jadi
memudar harus hati-hati diperiksa untuk setiap modulasi kebisingan; jika ini terjadi,
lalu bingungkan kembali seluruh file, atau gunakan memangkas, luntur, dan menggabungkan.

-p opsi memungkinkan mengesampingkan presisi target.

Jika opsi global SoX -R pilihan tidak diberikan, maka nomor pseudo-acak
generator yang digunakan untuk menghasilkan white noise akan `di-reseed', yaitu yang dihasilkan
kebisingan akan berbeda antara doa.

Efek ini tidak boleh diikuti oleh efek lain yang mempengaruhi audio.

Lihat juga bagian `Dithering' di atas.

sampel [faktor(2)]
Turunkan sampel sinyal dengan faktor bilangan bulat: Hanya yang pertama dari masing-masing faktor
sampel dipertahankan, yang lain dibuang.

Tidak ada filter penipisan yang diterapkan. Jika inputnya bukan bandlimited yang benar
sinyal baseband, aliasing akan terjadi. Ini mungkin diinginkan, misalnya, untuk frekuensi
terjemahan.

Untuk efek resampling umum dengan anti-aliasing, lihat tarif. Lihat juga contoh tambahan.

tahi telinga Membuat audio lebih mudah untuk didengarkan di headphone. Menambahkan `isyarat' ke stereo 44.1kHz (mis
audio CD format) audio sehingga ketika didengarkan di headphone gambar stereonya
dipindahkan dari dalam kepala Anda (standar untuk headphone) ke luar dan di depan
pendengar (standar untuk pembicara).

gema keuntungan keuntungan <menunda kerusakan>
Tambahkan gema ke audio. Gema adalah suara yang dipantulkan dan dapat terjadi secara alami
di antara pegunungan (dan terkadang gedung-gedung besar) ketika berbicara atau berteriak; digital
efek gema meniru perilaku ini dan sering digunakan untuk membantu mengisi suara
dari satu instrumen atau vokal. Perbedaan waktu antara sinyal asli
dan refleksinya adalah `delay' (waktu), dan kenyaringan sinyal yang dipantulkan
adalah 'pembusukan'. Beberapa gema dapat memiliki penundaan dan peluruhan yang berbeda.

Setiap diberikan menunda kerusakan pair memberikan penundaan dalam milidetik dan peluruhan (relatif
untuk mendapatkan-in) dari gema itu. Gain-out adalah volume keluaran. Misalnya: Ini
akan membuatnya terdengar seolah-olah ada dua kali lebih banyak instrumen daripada yang sebenarnya
bermain:
mainkan lead.aiff echo 0.8 0.88 60 0.4
Jika penundaannya sangat singkat, maka itu terdengar seperti robot (logam) yang memainkan musik:
mainkan lead.aiff echo 0.8 0.88 6 0.4
Penundaan yang lebih lama akan terdengar seperti konser udara terbuka di pegunungan:
mainkan lead.aiff echo 0.8 0.9 1000 0.3
Satu gunung lagi, dan:
mainkan lead.aiff echo 0.8 0.9 1000 0.3 1800 0.25

gema keuntungan keuntungan <menunda kerusakan>
Tambahkan urutan gema ke audio. Setiap menunda kerusakan pasangan memberikan penundaan dalam
milidetik dan peluruhan (relatif terhadap gain-in) dari gema itu. Keuntungan adalah
volume keluaran.

Seperti efek gema, gema adalah singkatan dari `ECHO in Sequel', yaitu gema pertama
mengambil input, input kedua dan gema pertama, input ketiga dan
gema pertama dan kedua, ... dan seterusnya. Perawatan harus diambil menggunakan banyak
gema; gema tunggal memiliki efek yang sama dengan gema tunggal.

Sampel akan dipantulkan dua kali dalam gema simetris:
mainkan lead.aiff echos 0.8 0.7 700 0.25 700 0.3
Sampel akan dipantulkan dua kali dalam gema asimetris:
mainkan lead.aiff echos 0.8 0.7 700 0.25 900 0.3
Sampel akan terdengar seolah-olah dimainkan di garasi:
mainkan lead.aiff echos 0.8 0.7 40 0.25 63 0.3

equalizer frekuensi[k] lebar[q|o|h|k] mendapatkan
Terapkan filter pemerataan puncak dua kutub (EQ). Dengan filter ini, sinyal-
level pada dan di sekitar frekuensi yang dipilih dapat ditingkatkan atau dikurangi, sementara
(tidak seperti filter band-pass dan band-reject) yang pada semua frekuensi lainnya adalah
tidak berubah.

frekuensi memberikan frekuensi pusat filter dalam Hz, lebar, lebar pita, dan
mendapatkan penguatan atau atenuasi yang diperlukan dalam dB. Hati-hati terhadap Guntingan saat menggunakan file
positif mendapatkan.

Untuk menghasilkan kurva pemerataan yang kompleks, efek ini dapat diberikan beberapa:
kali, masing-masing dengan frekuensi pusat yang berbeda.

Filter dijelaskan secara rinci dalam [1].

Efek ini mendukung --merencanakan pilihan global.

Lihat juga bas dan tiga kali lipat untuk menyimpan efek pemerataan.

luntur [mengetik] memudar-dalam-panjang [Hentikan waktu [fade-out-panjang]]
Terapkan efek fade ke awal, akhir, atau kedua audio.

Opsional mengetik dapat ditentukan untuk memilih bentuk kurva fade: q untuk
seperempat gelombang sinus, h untuk setengah gelombang sinus, t untuk kemiringan linier (`segitiga'),
l untuk logaritma, dan p untuk parabola terbalik. Standarnya adalah logaritmik.

Fade-in dimulai dari sampel pertama dan meningkatkan level sinyal dari 0 hingga penuh
volume lebih memudar-dalam-panjang detik. Tentukan 0 detik jika tidak ada fade-in yang diinginkan.

Untuk fade-out, audio akan terpotong di Hentikan waktu dan level sinyal akan
digenjot dari volume penuh ke 0 mulai dari fade-out-panjang detik sebelum
Hentikan waktu. Jika fade-out-panjang tidak ditentukan, nilai defaultnya sama dengan
memudar-dalam-panjang. Tidak ada fade-out yang dilakukan jika Hentikan waktu tidak ditentukan. jika
panjang file dapat ditentukan dari header file input dan perubahan panjang
efeknya tidak berlaku, maka 0 dapat ditentukan untuk Hentikan waktu untuk menunjukkan
kasus biasa dari fade-out yang berakhir di akhir aliran audio input.

Semua waktu dapat ditentukan dalam periode waktu atau jumlah sampel. Untuk menentukan
periode waktu menggunakan format jj:mm:ss.frac format. Untuk menentukan menggunakan jumlah sampel,
tentukan jumlah sampel dan tambahkan huruf `s' ke jumlah sampel (untuk
contoh `8000s').

Lihat juga sambatan efek.

pohon cemara [file-koef|koefisien]
Gunakan mesin konvolusi FFT SoX dengan koefisien filter FIR yang diberikan. Jika seorang
argumen diberikan maka ini diperlakukan sebagai nama file yang berisi filter
koefisien (dipisahkan spasi; mungkin berisi komentar `#'). Jika diberikan
nama file adalah `-', atau jika tidak ada argumen yang diberikan, maka koefisien dibaca dari
`masukan standar' (stdin); jika tidak, koefisien dapat diberikan pada perintah
garis. Contoh:
sox infile outfile fir 0.0195 -0.082 0.234 0.891 -0.145 0.043
sox infile outfile cemara coefs.txt
dengan coefs.txt yang mengandung
#penyaring hp
# frekuensi = 10000
1.2311233052619888e-01
-4.4777096106211783e-01
5.1031563346705155e-01
-6.6502926320995331e-02
...

Efek ini mendukung --merencanakan pilihan global.

pengarah [menunda kedalaman regen lebar kecepatan bentuk tahap interp]
Terapkan efek flanging ke audio. Lihat [3] untuk penjelasan rinci tentang
bergelang.

Semua parameter bersifat opsional (kanan ke kiri).

Jarak Default Description
menunda 0 - 30 0 Penundaan dasar dalam milidetik.
kedalaman 0 - 10 2 Menambahkan penundaan sapuan dalam milidetik.
regen -95 - 95 0 Persentase regenerasi (tertunda
umpan balik sinyal).
lebar 0 - 100 71 Persentase campuran sinyal tertunda
dengan asli.
kecepatan 0.1 - 10 0.5 Sapuan per detik (Hz).
bentuk sin Bentuk gelombang tersapu: sinus|segi tiga.
tahap 0 - 100 25 Pergeseran fase persentase gelombang tersapu
untuk multi-channel (misalnya stereo)
Penghubung jalur pipa; 0 = 100 = fase yang sama pada
setiap saluran.
interp lin Interpolasi garis tunda digital:
linear|kuadrat.

mendapatkan [-e|-B|-b|-r] [-n] [-l|-h] [keuntungan-dB]
Terapkan amplifikasi atau atenuasi ke sinyal audio, atau, dalam beberapa kasus, ke beberapa
dari salurannya. Perhatikan bahwa penggunaan salah satu dari -e, -B, -b, -r, atau -n membutuhkan sementara
ruang file untuk menyimpan audio yang akan diproses, jadi mungkin tidak cocok untuk digunakan dengan
audio 'streaming'.

Tanpa pilihan lain, keuntungan-dB digunakan untuk mengatur level daya sinyal dengan
jumlah dB yang diberikan: penguatan positif (hati-hati terhadap Clipping), pelemahan negatif.
Dengan pilihan lain, keuntungan-dB amplifikasi atau atenuasi (secara logis) diterapkan
setelah pemrosesan karena opsi tersebut.

Mengingat -e pilihan, tingkat saluran audio dari file multi-saluran adalah
'sama', yaitu penguatan diterapkan ke semua saluran selain saluran dengan yang tertinggi
tingkat puncak, sehingga semua saluran mencapai tingkat puncak yang sama (tetapi, tanpa juga
pemberian -n, audio tidak `dinormalisasi').

-B (keseimbangan) opsi mirip dengan -e, tetapi dengan -B, tingkat RMS digunakan
bukannya tingkat puncak. -B mungkin digunakan untuk memperbaiki ketidakseimbangan stereo yang disebabkan oleh
kartrid meja putar rekaman yang tidak sempurna. Perhatikan bahwa tidak seperti -e, -B mungkin menyebabkan beberapa
guntingan.

-b mirip dengan -B tetapi memiliki perlindungan kliping, yaitu jika perlu untuk mencegah
kliping saat menyeimbangkan, redaman diterapkan ke semua saluran. Catatan, bagaimanapun,
bahwa dalam hubungannya dengan -n, -B dan -b adalah sinonim.

-r opsi digunakan bersama dengan pemanggilan sebelumnya dari mendapatkan pada pengatur terkenal. Pengatur ini menawarkan bantuan hukum kepada traderapabila trader berselisih dengan broker yang terdaftar dengan mereka. -h
opsi - lihat di bawah untuk detailnya.

-n opsi menormalkan audio ke 0dB FSD; itu sering digunakan bersama dengan
negatif keuntungan-dB sehingga audio dinormalisasi ke tingkat tertentu
di bawah 0dB. Sebagai contoh,
sox infile outfile mendapatkan -n
dinormalisasi ke 0dB, dan
sox masuk file keluar keuntungan -n -3
dinormalisasi menjadi -3dB.

-l opsi memanggil pembatas sederhana, mis
sox infile keuntungan file keluar -l 6
akan menerapkan gain 6dB tetapi tidak pernah klip. Perhatikan bahwa membatasi lebih dari beberapa dB
daripada sesekali (dalam bagian audio) tidak disarankan karena dapat menyebabkan suara
distorsi. Lihat teman efek untuk limiter yang lebih mumpuni.

-h opsi digunakan untuk menerapkan keuntungan untuk menyediakan ruang kepala untuk pemrosesan selanjutnya.
Misalnya dengan
sox masuk file keluar keuntungan -h bass +6
6dB redaman akan diterapkan sebelum efek peningkatan bass sehingga memastikan
bahwa itu tidak akan klip. Tentu saja, dengan bass, jelas berapa banyak ruang kepala yang akan didapat
dibutuhkan, tetapi dengan efek lain (misalnya kecepatan, gentar) tidak selalu jelas.
Keuntungan lain menggunakan mendapatkan -h daripada redaman eksplisit, adalah bahwa jika
ruang kepala tidak digunakan oleh efek selanjutnya, dapat direklamasi dengan mendapatkan -r,
misalnya:
sox infile outfile gain -h bass +6 tingkat 44100 gain -r
Rantai efek di atas menjamin tidak akan pernah terpotong atau diperkuat; itu melemahkan jika
diperlukan untuk mencegah kliping, tetapi hanya sebanyak yang diperlukan untuk melakukannya.

Pemformatan output (dithering dan pengurangan kedalaman bit) juga memerlukan ruang kepala (yang
tidak dapat `direklamasi'), mis
sox infile outfile gain -h bass +6 rate 44100 gain -rh gentar
Di sini, yang kedua mendapatkan doa, merebut kembali ruang kepala sebanyak mungkin dari
efek sebelumnya, tetapi mempertahankan ruang kepala sebanyak yang diperlukan untuk selanjutnya
pengolahan. Opsi global SoX -G dapat diberikan untuk memanggil secara otomatis mendapatkan -h
dan mendapatkan -r.

Lihat juga norma dan vol efek.

jalan raya|jalan rendah [-1|-2] frekuensi[k] [lebar[q|o|h|k]]
Terapkan filter lolos tinggi atau lolos rendah dengan titik 3dB frekuensi. Filternya bisa
salah satu kutub tunggal (dengan -1), atau kutub ganda (default, atau dengan -2). lebar
hanya berlaku untuk filter kutub ganda; defaultnya adalah Q = 0.707 dan memberikan a
Tanggapan Butterworth. Filter meluncur pada 6dB per kutub per oktaf (20dB per
kutub per dekade). Filter kutub ganda dijelaskan secara rinci dalam [1].

Efek ini mendukung --merencanakan pilihan global.

Lihat juga tulus untuk filter dengan roll-off yang lebih curam.

Hilbert [-n keran]
Terapkan filter transformasi Hilbert ketukan ganjil, pergeseran fase sinyal sebesar 90 derajat.

Ini digunakan dalam banyak skema pengkodean matriks dan untuk pembangkitan sinyal analitik. Itu
proses sering ditulis sebagai perkalian dengan i (Atau j), satuan imajiner.

Filter transformasi Hilbert ketukan ganjil memiliki karakteristik bandpass, melemahkan
frekuensi terendah dan tertinggi. Bandwidth-nya dapat dikontrol dengan jumlah
keran filter, yang dapat ditentukan dengan -n. Secara default, jumlah ketukan adalah
dipilih untuk frekuensi cutoff sekitar 75 Hz.

Efek ini mendukung --merencanakan pilihan global.

ladspa modul [Plugin] [argumen...]
Terapkan plugin LADSPA [5] (Linux Audio Developer's Simple Plugin API). Meskipun
nama, LADSPA tidak khusus Linux, dan berbagai efek tersedia sebagai
Plugin LADSPA, seperti cmt [6] (Computer Music Toolkit) dan Steve Harris's
koleksi plugin [7]. Argumen pertama adalah modul plugin, yang kedua namanya
dari plugin (modul dapat berisi lebih dari satu plugin) dan argumen lainnya
adalah untuk port kontrol plugin. Argumen yang hilang disediakan secara default
nilai jika memungkinkan. Hanya plugin dengan paling banyak satu input audio dan satu output audio
pelabuhan dapat digunakan. Jika ditemukan, variabel lingkungan LADSPA_PATH akan digunakan sebagai
jalur pencarian untuk plugin.

kekerasan [mendapatkan [referensi]]
Kontrol kenyaringan - mirip dengan mendapatkan efek, tetapi memberikan pemerataan untuk
sistem pendengaran manusia. Melihat http://en.wikipedia.org/wiki/Loudness untuk detail
deskripsi kekerasan. Keuntungannya disesuaikan dengan yang diberikan mendapatkan parameter (biasanya
negatif) dan sinyal disamakan menurut ISO 226 dengan tingkat referensi
65dB, meskipun merupakan alternatif referensi level dapat diberikan jika audio asli memiliki
telah disamakan untuk beberapa tingkat optimal lainnya. Penguatan default -10dB digunakan jika a
mendapatkan nilai tidak diberikan.

Lihat juga mendapatkan efek.

jalan rendah [-1|-2] frekuensi[k] [lebar[q|o|h|k]]
Terapkan filter lolos rendah. Lihat deskripsi jalan raya efek untuk rincian.

compand "serang1,peluruhan1{,serang2,peluruhan2}
[lutut-lunak-dB:]di-dB1[,keluar-dB1]{,di-dB2,keluar-dB2}
[mendapatkan [volume awal-dB [menunda]]]" {crossover-frekuensi[k] "serangan1,..."}

Compander multi-band mirip dengan compander single-band tetapi audionya
pertama dibagi menjadi band menggunakan filter cross-over Linkwitz-Riley dan secara terpisah
compander tertentu berjalan pada setiap band. Lihat teman efek untuk definisi
dari parameternya. Parameter compand ditentukan antara tanda kutip ganda dan
frekuensi crossover untuk pita itu diberikan oleh crossover-frekuensi; ini bisa diulang
untuk membuat beberapa band.

Sebagai contoh, perintah berikut (satu panjang) menunjukkan bagaimana companding multi-band adalah
biasanya digunakan di radio FM:
mainkan track1.wav gain -3 sejak 8000- 29 100 mcompand \
"0.005,0.1 -47,-40,-34,-34,-17,-33" 100 \
"0.003,0.05 -47,-40,-34,-34,-17,-33" 400 \
"0.000625,0.0125 -47,-40,-34,-34,-15,-33" 1600 \
"0.0001,0.025 -47,-40,-34,-34,-31,-31,-0,-30" 6400 \
"0,0.025 -38,-31,-28,-28,-0,-25" \
dapatkan 15 jalan pintas 22 jalan pintas 22 sinc -n 255 -b 16 -17500 \
dapatkan 9 lowpass -1 17801
File audio diputar dengan simulasi suara radio FM (atau sinyal siaran
kondisi jika filter lowpass di bagian akhir dilewati). Perhatikan bahwa pipa adalah
diatur dengan pra-penekanan 75us gaya AS.

Lihat juga teman untuk efek penggabungan pita tunggal.

kebisinganprof [file profil]
Hitung profil audio untuk digunakan dalam pengurangan kebisingan. Lihat deskripsi
dari berisik efek untuk rincian.

berisik [file profil [jumlah]]
Kurangi noise pada sinyal audio dengan membuat profil dan memfilter. Efek ini adalah
cukup efektif untuk menghilangkan kebisingan latar belakang yang konsisten seperti desis atau dengung.
Untuk menggunakannya, jalankan SoX terlebih dahulu dengan kebisinganprof efek pada bagian audio yang
idealnya berisi keheningan tetapi sebenarnya berisi kebisingan - bagian seperti itu adalah
biasanya ditemukan di awal atau akhir rekaman. kebisinganprof akan menulis
keluarkan profil kebisingan untuk file profil, atau ke stdout jika tidak ada file profil atau jika `-' adalah
diberikan. Misalnya
sox pidato.wav -n potong 0 1.5 noiseprof pidato.profil kebisingan
Untuk benar-benar menghilangkan noise, jalankan SoX lagi, kali ini dengan berisik memengaruhi;
berisik akan mengurangi kebisingan sesuai dengan profil kebisingan (yang dihasilkan oleh
kebisinganprof), dari file profil, atau dari stdin jika tidak ada file profil atau jika `-' diberikan.
Misalnya
sox speech.wav dibersihkan.wav noisered speech.noise-profile 0.3
Berapa banyak kebisingan yang harus dihilangkan ditentukan oleh jumlah-a angka antara 0 dan 1
dengan standar 0.5. Angka yang lebih tinggi akan menghilangkan lebih banyak noise tetapi menghadirkan lebih banyak
kemungkinan menghapus komponen yang diinginkan dari sinyal audio. Sebelum mengganti
rekaman asli dengan versi pengurangan kebisingan, bereksperimen dengan yang berbeda jumlah
nilai untuk menemukan yang optimal untuk audio Anda; gunakan headphone untuk memeriksa apakah Anda
senang dengan hasilnya, memberikan perhatian khusus pada bagian yang lebih tenang
Audio.

Pada kebanyakan sistem, dua tahap - pembuatan profil dan reduksi - dapat digabungkan menggunakan a
pipa, misalnya
sox noise.wav -n trim 0 1 noiseprof | main berisik.wav noisered

norma [tingkat dB]
Normalisasikan audio. norma hanyalah sebuah alias untuk mendapatkan -n; lihat mendapatkan efek untuk
rincian.

oops Di Luar Fase Efek Stereo. Mencampur stereo ke twin-mono di mana setiap saluran mono
berisi perbedaan antara saluran stereo kiri dan kanan. Ini
kadang-kadang dikenal sebagai efek 'karaoke' karena sering kali memiliki efek menghilangkan sebagian besar
atau semua vokal dari rekaman. Ini setara dengan remix 1,2 1,2.

overdrive [mendapatkan(20) [warna(20)]]
Distorsi non linier. Itu warna parameter mengontrol jumlah harmonik genap
konten dalam output yang terlalu didorong.

bantalan { panjangnya[@posisi] }
Pad audio dengan keheningan, di awal, akhir, atau titik tertentu
melalui audionya. Keduanya panjangnya dan posisi dapat menentukan waktu atau, jika ditambahkan
dengan `s', sejumlah sampel. panjangnya adalah jumlah keheningan untuk dimasukkan dan
posisi posisi dalam aliran audio input untuk memasukkannya. Nomor berapa saja
panjang dan posisi dapat ditentukan, asalkan posisi tertentu adalah:
tidak kalah dengan yang sebelumnya. posisi adalah opsional untuk yang pertama dan terakhir
panjang yang ditentukan dan jika dihilangkan sesuai dengan awal dan akhir
audionya masing-masing. Sebagai contoh, bantalan 1.5 1.5 menambahkan 1.5 detik bantalan hening
di setiap akhir audio, sementara bantalan 4000an@3:00 menyisipkan 4000 sampel keheningan 3
menit ke dalam audio. Jika keheningan hanya diinginkan di akhir audio, tentukan
baik posisi akhir atau tentukan pad panjang nol di awal.

Lihat juga menunda untuk efek yang dapat menambahkan keheningan di awal audio aktif
saluran demi saluran.

penghapus keuntungan keuntungan menunda kerusakan kecepatan [-s|-t]
Tambahkan efek pentahapan ke audio. Lihat [3] untuk penjelasan rinci tentang pentahapan.

delay/decay/speed memberikan penundaan dalam milidetik dan peluruhan (relatif terhadap gain-
in) dengan kecepatan modulasi dalam Hz. Modulasinya berupa sinusoidal (-s) -
lebih disukai untuk beberapa instrumen, atau segitiga (-t) - memberikan instrumen tunggal
efek pentahapan yang lebih tajam. Peluruhan harus kurang dari 0.5 untuk menghindari umpan balik, dan
biasanya tidak kurang dari 0.1. Gain-out adalah volume keluaran.

Sebagai contoh:
mainkan snare.flac phaser 0.8 0.74 3 0.4 0.5 -t
Lebih lembut:
mainkan snare.flac phaser 0.9 0.85 4 0.23 1.3 -s
Suara populer:
mainkan snare.flac phaser 0.89 0.85 1 0.24 2 -t
Lebih parah:
mainkan snare.flac phaser 0.6 0.66 3 0.6 2 -t

nada [-q] bergeser [ruas [Cari [tumpang tindih]]]
Ubah nada audio (tetapi bukan tempo).

bergeser memberikan pergeseran nada sebagai `sen' positif atau negatif (yaitu seperseratus a
seminada). Lihat waktu efek untuk deskripsi parameter lainnya.

Lihat juga membungkuk, kecepatan, dan waktu efek.

tarif [-q|-l|-m|-h|-v] [opsi-override] MENILAI[k]
Ubah tingkat pengambilan sampel audio (yaitu sampel ulang audio) ke yang diberikan MENILAI (bahkan
non-integer jika ini didukung oleh format file output) menggunakan tingkat kualitas
didefinisikan sebagai berikut:

Kualitas Pita- Rejo dB Typical penggunaan
lebar
-q t/a cepat 30 @ pemutaran aktif
Perangkat keras kuno Fs/4
-l rendah 80% 100 pemutaran di lama
perangkat keras
-m pemutaran audio sedang 95% 100
-h penguasaan tinggi 95% 125 16-bit
(gunakan dengan gentar)
-v sangat tinggi 95% 175 penguasaan 24-bit

dimana Lebar pita adalah persentase pita frekuensi audio yang dipertahankan
dan Rejo dB adalah tingkat penolakan kebisingan. Meningkatkan level pengambilan sampel ulang
kualitas datang dengan mengorbankan peningkatan jumlah waktu untuk memproses audio. Jika
tidak ada pilihan kualitas yang diberikan, tingkat kualitas yang digunakan adalah `tinggi' (tetapi lihat `Memainkan &
Merekam Audio' di atas tentang pemutaran).

Algoritme `cepat' menggunakan interpolasi kubik; semua yang lain menggunakan band-limited
interpolasi. Secara default, semua algoritme memiliki respons fase `linier'; untuk
`sedang', `tinggi' dan `sangat tinggi', respons fase dapat dikonfigurasi (lihat di bawah).

tarif efek dipanggil secara otomatis jika SoX's -r opsi menentukan tingkat yang
berbeda dengan file input. Atau, jika efek ini diberikan
secara eksplisit, maka SoX's -r pilihan tidak perlu diberikan. Misalnya, dua berikut ini
perintah setara:
sox masukan.wav -r 48k keluaran.wav bass -b 24
sox input.wav output.wav bass -b 24 kecepatan 48k
meskipun perintah kedua lebih fleksibel karena memungkinkan tarif pilihan yang akan diberikan,
dan memungkinkan efek untuk dipesan secara sewenang-wenang.

* * *

Peringatan: diskusi rinci teknis berikut.

Pemilihan kualitas sederhana yang dijelaskan di atas menyediakan pengaturan yang memenuhi
kebutuhan sebagian besar tugas resampling. Namun, kadang-kadang, mungkin saja
diinginkan untuk menyempurnakan respons filter resampler; ini dapat dicapai dengan menggunakan
mengesampingkan Pilihan, seperti yang dijelaskan dalam tabel berikut:

-M/-I/-L Respon fase = minimum/menengah/linier
-s Filter curam (lebar pita = 99%)
-a Izinkan aliasing/imaging di atas pass-band
-b 74-99.7 % lebar pita apa saja
-p 0-100 Setiap respon fase (0 = minimum, 25 = menengah,
50 = linier, 100 = maksimum)

Opsi NB Override tidak dapat digunakan dengan algoritme kualitas `cepat' atau `rendah'.

Semua resampler menggunakan filter yang terkadang dapat membuat `gema' (alias `dering')
artefak dengan sinyal sementara seperti yang terjadi dengan `jepret jari' atau
suara yang sangat perkusi lainnya. Artefak semacam itu jauh lebih terlihat oleh
telinga manusia jika terjadi sebelum transien (`pre-echo') daripada jika terjadi setelah
itu (`pasca-gema'). Perhatikan bahwa frekuensi artefak semacam itu terkait dengan
lebih kecil dari tingkat pengambilan sampel asli dan baru tetapi jika ini setidaknya
44.1kHz, maka artefak akan berada di luar jangkauan pendengaran manusia.

Pengaturan respons fase dapat digunakan untuk mengontrol distribusi transien apa pun
echo antara `pre' dan `post': dengan fase minimum, tidak ada pre-echo kecuali
pasca-gema terpanjang; dengan fase linier, pra dan pasca gema berada dalam jumlah yang sama (dalam
istilah sinyal, tetapi bukan istilah audibilitas); pengaturan fase menengah mencoba untuk
temukan kompromi terbaik dengan memilih panjang (dan level) kecil dari pra-gema dan a
pasca-gema yang panjangnya sedang.

Respons fase minimum, menengah, atau linier dipilih menggunakan -M, -I, atau -L
pilihan; respons fase khusus dapat dibuat dengan -p pilihan. Perhatikan fase itu
tanggapan antara `linier' dan `maksimum' (lebih besar dari 50) jarang berguna.

Pengaturan lebar pita resampler menentukan seberapa banyak konten frekuensi
sinyal asli (wrt tingkat sampel asli saat up-sampling, atau yang baru
sample rate saat down-sampling) dipertahankan selama konversi. Istilah `lulus-
band' digunakan untuk merujuk ke semua frekuensi hingga titik lebar pita (mis
Tingkat pengambilan sampel 44.1kHz, dan lebar pita resampling 95%, pita pass mewakili
frekuensi dari 0Hz (DC) hingga sekitar 21kHz). Meningkatkan lebar pita resampler
menghasilkan konversi yang lebih lambat dan dapat meningkatkan artefak gema sementara (dan sebaliknya).
sebaliknya).

-s Opsi `steep filter' mengubah lebar pita resampling dari default 95%
(berdasarkan titik 3dB), hingga 99%. Itu -b opsi memungkinkan lebar pita diatur ke
nilai apa pun dalam kisaran 74-99.7%, tetapi perhatikan bahwa nilai lebar pita lebih besar dari 99%
tidak direkomendasikan untuk penggunaan normal karena dapat menyebabkan gema transien yang berlebihan.

Jika -a pilihan diberikan, maka aliasing/imaging di atas pass-band diperbolehkan.
Misalnya, dengan laju pengambilan sampel 44.1kHz, dan lebar pita resampling 95%, ini
berarti konten frekuensi di atas 21kHz dapat terdistorsi; Namun, karena ini adalah
di atas pass-band (yaitu di atas frekuensi minat/keterdengaran tertinggi),
ini mungkin tidak menjadi masalah. Manfaat mengizinkan aliasing/pencitraan berkurang
waktu pemrosesan, dan mengurangi (hampir setengah) artefak gema sementara. Perhatikan bahwa
jika opsi ini diberikan, maka lebar pita minimum yang diizinkan dengan -b meningkat menjadi
85%.

contoh:
sox input.wav -b 16 output.wav rate -s -a 44100 gentar -s
pengambilan sampel ulang kualitas default (tinggi); menimpa: filter curam, izinkan aliasing; ke
tingkat sampel 44.1kHz; kegentaran berbentuk kebisingan untuk file WAV 16-bit.
sox masukan.wav -b 24 keluaran.aiff rate -v -I -b 90 48k
pengambilan sampel ulang berkualitas sangat tinggi; menimpa: fase menengah, lebar pita 90%; ke 48k
tingkat sampel; menyimpan output ke file AIFF 24-bit.

* * *

nada dan kecepatan efek menggunakan tarif efek pada intinya.

remix [-a|-m|-p]di luar spesifikasi>
di luar spesifikasi = dalam spesifikasi{,dalam spesifikasi} | 0
dalam spesifikasi = [di-chan][-[di-chan2]] [spesifikasi vol]
spesifikasi vol = p|i|v[volume]

Pilih dan campur saluran audio input ke saluran audio output. Setiap keluaran
saluran ditentukan, pada gilirannya, oleh yang diberikan di luar spesifikasi: daftar masukan yang berkontribusi
saluran dan spesifikasi volume.

Perhatikan bahwa efek ini beroperasi pada audio saluran dalam efek SoX
rantai pemrosesan; seharusnya tidak bingung dengan -m opsi global (di mana
beberapa arsip dicampur-dikombinasikan sebelum memasuki rantai efek).

An di luar spesifikasi berisi nomor saluran masukan yang dipisahkan koma dan dipisahkan tanda hubung
rentang nomor saluran; kalau tidak, 0 dapat diberikan untuk membuat output senyap
saluran. Sebagai contoh,
sox masukan.wav keluaran.wav remix 6 7 8 0
membuat file output dengan empat saluran, di mana saluran 1, 2, dan 3 adalah salinan dari
saluran 6, 7, dan 8 dalam file input, dan saluran 4 diam. Sedangkan
sox masukan.wav keluaran.wav remix 1-3,7 3
membuat file output stereo (agak aneh) di mana saluran kiri adalah campuran
bawah saluran input 1, 2, 3, dan 7, dan saluran kanan adalah salinan input
saluran 3.

Di mana rentang saluran ditentukan, nomor saluran di kiri dan kanan
tanda hubung adalah opsional dan default ke 1 dan jumlah saluran input
masing-masing. Jadi
sox masukan.wav keluaran.wav remix -
melakukan mix-down dari semua saluran input ke mono.

Secara default, di mana saluran output dicampur dari beberapa (n) saluran input, masing-masing
saluran input akan diskalakan dengan faktor /n. Volume pencampuran khusus dapat diatur
dengan mengikuti saluran input yang diberikan atau rentang saluran input dengan a spesifikasi vol
(spesifikasi volume). Ini salah satu suratnya p, i, atau v, Diikuti oleh
nomor volume, artinya tergantung pada huruf yang diberikan dan didefinisikan sebagai
berikut:

Surat Volume jumlah Catatan
p penyesuaian daya dalam dB 0 = tidak ada perubahan
saya mengatur daya dalam dB Sebagai `p', tetapi membalikkan
audio
v tegangan pengali 1 = tidak ada perubahan, 0.5 6dB
redaman, 2 6dB
keuntungan, -1 = terbalik

Jika di luar spesifikasi termasuk setidaknya satu spesifikasi vol maka, secara default, penskalaan /n bukan
diterapkan ke saluran lain di luar spesifikasi yang sama (meskipun mungkin di luar
spesifikasi). Opsi -a (otomatis), dapat diberikan untuk mempertahankan opsi otomatis
penskalaan dalam hal ini. Sebagai contoh,
sox masukan.wav keluaran.wav remix 1,2 3,4v0.8
menghasilkan pengganda level saluran 0.5,0.5 1,0.8, sedangkan
sox masukan.wav keluaran.wav remix -a 1,2 3,4v0.8
menghasilkan pengali level saluran sebesar 0.5,0.5 0.5,0.8.

Opsi -m (manual) menonaktifkan semua penyesuaian volume otomatis, jadi
sox masukan.wav keluaran.wav remix -m 1,2 3,4v0.8
menghasilkan pengali level saluran sebesar 1,1 1,0.8.

Nomor volume bersifat opsional dan menghilangkannya berarti tidak ada perubahan volume;
namun, satu-satunya kasus di mana ini berguna adalah dalam hubungannya dengan i. Forum
Misalnya, jika masukan.wav adalah stereo, maka
sox masukan.wav keluaran.wav remix 1,2i
adalah ekuivalen mono dari oops efek.

Jika -p opsi diberikan, maka penskalaan /n otomatis apa pun diganti dengan /√n
(`kekuatan') penskalaan; ini memberikan campuran yang lebih keras tetapi kadang-kadang mungkin klip.

* * *

Salah satu penggunaan remix efeknya adalah untuk membagi file audio menjadi satu set file, masing-masing
berisi salah satu saluran konstituen (untuk melakukan selanjutnya
pemrosesan pada saluran audio individual). Di mana lebih dari beberapa saluran berada
terlibat, skrip seperti berikut (skrip Bourne shell) berguna:
#!/ Bin / sh
chans=`soxi -c "$1"`
while [ $chans -ge 1 ]; melakukan
chans0=`printf %02i $chans` # 2 digit sehingga hingga 99 chans
out=`echo "$1"|sed "s/\(.*\)\.\(.*\)/\1-$chans0.\2/"`
sox "$1" "$out" remix $chans
chans=`expr $chans - 1`
dilakukan
Jika sebuah file masukan.wav berisi enam saluran audio diberikan, skrip akan
menghasilkan enam file output: masukan-01.wav, masukan-02.wav, ..., masukan-06.wav.

Lihat juga menukar efek.

ulangi [menghitung (1)]
Ulangi seluruh audio menghitung kali, atau sekali jika menghitung tidak diberikan. Memerlukan
ruang file sementara untuk menyimpan audio yang akan diulang. Perhatikan bahwa mengulang sekali
menghasilkan dua salinan: audio asli dan audio berulang.

berkumandang [-w|--basah-saja] [gema (50%) [Peredam HF (50%)
[skala ruangan (100%) [kedalaman stereo (100%)
[pra-penundaan (0 md) [keuntungan basah (0dB)]]]]]]]

Tambahkan gema ke audio menggunakan algoritma `freeverb'. Sebuah gema
efek terkadang diinginkan untuk ruang konser yang terlalu kecil atau berisi begitu
banyak orang bahwa gema alami aula berkurang. Menerapkan kecil
jumlah reverb stereo ke sinyal mono (kering) biasanya akan membuatnya lebih terdengar
alami. Lihat [3] untuk penjelasan rinci tentang gema.

Perhatikan bahwa efek ini meningkatkan volume dan panjang audio, jadi untuk
mencegah kliping di domain ini, pemanggilan tipikal mungkin:
mainkan dry.wav gain -3 pad 0 3 reverb
-w opsi dapat diberikan untuk memilih hanya sinyal `basah', sehingga memungkinkannya untuk menjadi
diproses lebih lanjut, terlepas dari sinyal 'kering'. Misalnya
putar -m voice.wav "|sox voice.wav -p reverse reverb -w reverse"
untuk efek reverb terbalik.

membalikkan
Balikkan audio sepenuhnya. Membutuhkan ruang file sementara untuk menyimpan audio ke
dibalik.

riaa Terapkan pemerataan pemutaran vinil RIAA. Tingkat pengambilan sampel harus salah satu dari: 44.1,
48, 88.2, 96 kHz.

Efek ini mendukung --merencanakan pilihan global.

diam [-l] di atas-periode [lamanya ambang[d|%]
[di bawah periode lamanya ambang[d|%]]

Menghapus keheningan dari awal, tengah, atau akhir audio. 'Diam' adalah
ditentukan oleh ambang batas tertentu.

di atas-periode nilai digunakan untuk menunjukkan apakah audio harus dipangkas di
awal audionya. Nilai nol menunjukkan tidak ada keheningan yang harus dipangkas
awal mula. Saat menentukan bukan nol di atas-periode, itu memotong audio hingga
ia menemukan non-keheningan. Biasanya, saat memangkas keheningan dari awal audio,
di atas-periode akan menjadi 1 tetapi dapat ditingkatkan ke nilai yang lebih tinggi untuk memangkas semua audio
hingga hitungan periode non-diam tertentu. Misalnya, jika Anda memiliki audio
file dengan dua lagu yang masing-masing berisi 2 detik keheningan sebelum lagu, Anda
bisa menentukan di atas periode dari 2 untuk menghapus periode hening dan yang pertama
lagu.

Ketika di atas-periode bukan nol, Anda juga harus menentukan a lamanya dan ambang.
Durasi indikasi jumlah waktu non-keheningan harus dideteksi sebelum itu
berhenti memotong audio. Dengan meningkatkan durasi, ledakan kebisingan dapat diperlakukan sebagai
diam dan dipangkas.

ambang digunakan untuk menunjukkan nilai sampel apa yang harus Anda perlakukan sebagai diam. Untuk
audio digital, nilai 0 mungkin baik-baik saja tetapi untuk audio yang direkam dari analog, Anda mungkin
ingin meningkatkan nilai untuk memperhitungkan kebisingan latar belakang.

Saat secara opsional memangkas keheningan dari akhir audio, Anda menentukan a di bawah-
periode menghitung. Pada kasus ini, di bawah periode berarti menghapus semua audio setelah hening
terdeteksi. Biasanya, ini akan menjadi nilai 1 tetapi dapat ditingkatkan untuk dilewati
selama periode keheningan yang diinginkan. Misalnya, jika Anda memiliki lagu dengan 2
detik hening di tengah dan 2 detik di akhir, Anda dapat mengatur di bawah-
periode ke nilai 2 untuk melewati keheningan di tengah audio.

Untuk di bawah periode, lamanya menentukan periode keheningan yang harus ada sebelumnya
audio tidak disalin lagi. Dengan menentukan durasi yang lebih tinggi, keheningan itu
ingin dapat dibiarkan dalam audio. Misalnya, jika Anda memiliki lagu dengan ekspektasi
1 detik hening di tengah dan 2 detik hening di akhir, durasi
dari 2 detik dapat digunakan untuk melewati keheningan tengah.

Sayangnya, Anda harus mengetahui lamanya keheningan di akhir audio Anda
file untuk memangkas keheningan andal. Cara mengatasinya adalah dengan menggunakan diam efek di
kombinasi dengan membalikkan memengaruhi. Dengan membalikkan audio terlebih dahulu, Anda dapat menggunakan
di atas-periode untuk memangkas semua audio dengan andal dari yang tampak seperti bagian depan
mengajukan. Kemudian balikkan file lagi untuk kembali normal.

Untuk menghilangkan keheningan dari tengah file, tentukan a di bawah periode itu adalah
negatif. Nilai ini kemudian diperlakukan sebagai nilai positif dan juga digunakan untuk
menunjukkan efeknya harus memulai kembali pemrosesan seperti yang ditentukan oleh di atas-periode,
sehingga cocok untuk menghilangkan periode hening di tengah audio.

Pilihan -l mengindikasikan bahwa di bawah periode lamanya panjang audio harus dibiarkan
utuh pada awal setiap periode keheningan. Misalnya, jika Anda ingin
hapus jeda panjang di antara kata-kata tetapi tidak ingin menghapus jeda sepenuhnya.

periode jumlahnya dalam satuan sampel. Durasi hitungan mungkin dalam format
jj:mm:ss.frac, atau jumlah sampel yang tepat. ambang angka dapat diberi akhiran
dengan d untuk menunjukkan nilainya dalam desibel, atau % untuk menunjukkan persentase dari
nilai maksimum dari nilai sampel (0% menentukan keheningan digital murni).

Contoh berikut menunjukkan bagaimana efek ini dapat digunakan untuk memulai perekaman yang
tidak mengandung penundaan di awal yang biasanya terjadi antara `menekan
tombol rekam' dan awal pertunjukan:
rec parameter nama file efek lainnya diam 1 5 2%

tulus [-a untuk|-b beta] [-p tahap|-M|-I|-L] [-t tbw|-n keran] [frekuensiHP][-frekuensiLP [-t tbw|-n
ketuk]]
Menerapkan filter low-pass, high-pass, band-pass, atau band-reject berjendela kaiser
ke sinyal. Itu frekuensiHP dan frekuensiLP parameter memberikan frekuensi 6dB
titik filter lolos tinggi dan lolos rendah yang dapat dipanggil satu per satu, atau
bersama. Jika keduanya diberikan, maka frekuensiHP kurang dari frekuensiLP membuat band-pass
Saring, frekuensiHP lebih besar dari frekuensiLP membuat filter band-reject. Misalnya,
doa
sejak 3k
sejak -4k
Sink 3k-4k
Sink 4k-3k
buat filter lolos-tinggi, lolos-rendah, lolos-band, dan menolak-pita.

Redaman stop-band default 120dB dapat diganti dengan -a;
sebagai alternatif, parameter kaiser-window `beta' dapat diberikan langsung dengan -b.

Lebar pita transisi default 5% dari total pita dapat diganti dengan -t
(Dan tbw dalam Hertz); sebagai alternatif, jumlah keran filter dapat diberikan secara langsung
dengan -n.

Jika keduanya frekuensiHP dan frekuensiLP diberikan, maka -t or -n pilihan yang diberikan di sebelah kiri
frekuensi berlaku untuk kedua frekuensi; salah satu opsi ini diberikan kepada
hak frekuensi hanya berlaku untuk frekuensiLP.

-p, -M, -I, dan -L opsi mengontrol respons fase filter; lihat tarif
efek untuk rincian.

Efek ini mendukung --merencanakan pilihan global.

spektogram [Pilihan]
Buat spektogram audio; audio dilewatkan tanpa dimodifikasi melalui SoX
rantai pengolahan. Efek ini opsional - ketik sox --membantu dan periksa daftar
efek yang didukung untuk melihat apakah itu telah disertakan.

Spektogram dirender dalam file Portable Network Graphic (PNG), dan menunjukkan
waktu pada sumbu X, frekuensi pada sumbu Y, dan magnitudo sinyal audio pada sumbu Z
sumbu. Nilai sumbu Z diwakili oleh warna (atau secara opsional intensitas) dari
piksel pada bidang XY. Jika sinyal audio berisi banyak saluran, maka
ini ditampilkan dari atas ke bawah mulai dari saluran 1 (yang kiri
saluran untuk audio stereo).

Misalnya, jika `my.wav' adalah file stereo, maka dengan
sox my.wav -n spektogram
spektogram dari seluruh file akan dibuat dalam file `spectogram.png'.
Namun lebih sering, analisis porsi audio yang lebih kecil diperlukan; misalnya
dengan
sox my.wav -n remix 2 trim 20 30 spektogram
spektogram menunjukkan informasi hanya dari saluran kedua (kanan), dan dari
tiga puluh detik audio mulai dari dua puluh detik. Untuk menganalisis sedikit
bagian dari domain frekuensi, tarif efek dapat digunakan, misalnya
sox my.wav -n rate 6k spectogram
memungkinkan analisis rinci frekuensi hingga 3kHz (setengah laju pengambilan sampel) yaitu
di mana sistem pendengaran manusia paling sensitif. Dengan
sox my.wav -n trim 0 10 spektogram -x 600 -y 200 -z 100
opsi yang diberikan mengontrol ukuran sumbu X, Y & Z spektogram (dalam hal ini
kasus, area spektogram dari gambar yang dihasilkan akan berukuran 600 kali 200 piksel
dan rentang sumbu Z akan menjadi 100 dB). Perhatikan bahwa gambar yang dihasilkan termasuk sumbu
legenda dll dan akan menjadi sedikit lebih besar dari ukuran spektogram yang ditentukan.
Dalam contoh ini:
sox -n -n synth 6 tri 10k:14k spektogram -z 100 -w kaiser
`jendela' analisis dengan rentang dinamis tinggi dipilih untuk menampilkan yang terbaik
spektogram gelombang segitiga menyapu. Untuk contoh smilar, tambahkan berikut ini
ke perintah `berpadu' dalam deskripsi menunda efek (di atas):
rate 2k spektogram -X 200 -Z -10 -w kaiser
Pilihan juga tersedia untuk mengontrol tampilan (pengaturan warna, kecerahan,
kontras, dll.) dan nama file spektogram; misalnya dengan
sox my.wav -n spektogram -m -l -o print.png
spektogram dibuat sesuai untuk dicetak pada printer `hitam putih'.

Pilihan:

-x num Ubah lebar (maksimum) (sumbu X) spektogram dari default
nilai 800 piksel ke angka tertentu antara 100 dan 200000. Lihat juga -X
dan -d.

-X num Piksel sumbu X/detik; defaultnya dihitung secara otomatis agar sesuai dengan yang diberikan atau
durasi audio yang diketahui ke ukuran sumbu X, atau 100 sebaliknya. Jika diberikan dalam
berhubungan dengan -d, opsi ini mempengaruhi lebar spektogram;
jika tidak, itu mempengaruhi durasi spektogram. num bisa dari 1
(resolusi waktu rendah) hingga 5000 (resolusi waktu tinggi) dan tidak perlu
bilangan bulat. SoX mungkin membuat sedikit penyesuaian pada nomor yang diberikan untuk
alasan kuantisasi pemrosesan; jika demikian, SoX akan melaporkan nomor sebenarnya
digunakan (dapat dilihat saat opsi global SoX -V sedang berlaku). Lihat juga -x dan
-d.

-y num Menyetel ukuran sumbu Y dalam piksel (per saluran); ini nomornya
frekuensi `bins' yang digunakan dalam analisis Fourier yang menghasilkan spektogram.
NB bisa lambat menghasilkan spektogram jika angka ini bukan satu
lebih dari kekuatan dua (misalnya 129). Secara default, ukuran sumbu Y dipilih
secara otomatis (tergantung pada jumlah saluran). Melihat -Y untuk alternatif
cara pengaturan ketinggian spektogram.

-Y num Menetapkan tinggi total target spektogram. Nilai defaultnya adalah
550 piksel. Menggunakan opsi ini (dan secara default), SoX akan memilih ketinggian
untuk saluran spektogram individu yang satu lebih dari kekuatan dua, jadi
tinggi total sebenarnya mungkin kurang dari angka yang diberikan. Namun, ada
juga merupakan ketinggian minimum per saluran jadi jika ada banyak saluran,
jumlahnya mungkin terlampaui. Melihat -y untuk cara alternatif pengaturan spektogram
tinggi.

-z num Rentang sumbu Z (warna) dalam dB, default 120. Ini menetapkan rentang dinamis
spektogram menjadi -num dBFS menjadi 0 dBFS. Di dapat berkisar dari 20 hingga 180.
Mengurangi rentang dinamis secara efektif meningkatkan `kontras' dari
tampilan spektogram, dan sebaliknya.

-Z num Menetapkan batas atas sumbu Z dalam dBFS. Sebuah negatif num efektif
meningkatkan `kecerahan' tampilan spektogram, dan sebaliknya.

-q num Mengatur kuantisasi sumbu Z, yaitu jumlah warna yang berbeda (atau
intensitas) di mana untuk membuat nilai sumbu Z. Sejumlah kecil (misalnya 4) akan
memberikan efek seperti `poster' sehingga lebih mudah untuk membedakan pita magnitudo
tingkat yang sama. Jumlah kecil juga biasanya menghasilkan file PNG kecil. Itu
nomor yang diberikan menentukan jumlah warna yang akan digunakan di dalam rentang sumbu Z;
dua warna dicadangkan untuk mewakili nilai di luar rentang.

-w nama
Jendela: Hann (default), Hamming, Bartlett, Rectangular atau Kaiser. Itu
spektogram diproduksi menggunakan Discrete Fourier Transform (DFT)
algoritma. Parameter penting untuk algoritma ini adalah pilihan
'fungsi jendela'. Secara default, SoX menggunakan jendela Hann yang memiliki semua
resolusi frekuensi bulat dan properti rentang dinamis. Untuk lebih baik
resolusi frekuensi (tetapi rentang dinamis lebih rendah), pilih jendela Hamming; untuk
rentang dinamis yang lebih tinggi (tetapi resolusi frekuensi yang lebih buruk), pilih Kaiser
jendela. Jendela Bartlett dan Rectangular juga tersedia.

-W num Parameter penyesuaian jendela. Ini dapat digunakan untuk membuat penyesuaian kecil pada
bentuk jendela Kaiser. Angka positif (hingga sepuluh) meningkatkan
rentang dinamis, angka negatif menguranginya.

-s Izinkan tumpang tindih kendur dari jendela DFT. Ini dapat, dalam beberapa kasus, meningkatkan
ketajaman gambar dan memberikan kepatuhan yang lebih besar pada -x nilai, tetapi pada
biaya kerugian spektral kecil.

-m Membuat spektogram monokrom (standarnya adalah warna).

-h Memilih palet warna tinggi - kurang menyenangkan secara visual daripada default
palet warna, tetapi mungkin lebih mudah untuk membedakan tingkat yang berbeda.
Jika opsi ini digunakan bersama dengan -m, hasilnya akan menjadi hibrida
palet monokrom/warna.

-p num Permute warna dalam palet warna atau hibrida. Itu num parameter, dari
1 (default) hingga 6, memilih permutasi.

-l Membuat spektogram `printer friendly' dengan latar belakang terang (
default memiliki latar belakang gelap).

-a Menekan tampilan garis sumbu. Ini terkadang berguna dalam membantu
untuk membedakan artefak di tepi spektogram.

-r Spektogram mentah: menekan tampilan sumbu dan legenda.

-A Memilih alternatif, rangkaian warna tetap. Ini disediakan hanya untuk
kompatibilitas dengan spektogram yang dihasilkan oleh paket lain. Seharusnya tidak
biasanya digunakan karena memiliki beberapa masalah, paling tidak, kurangnya
diferensiasi di ujung bawah yang menghasilkan penyembunyian level rendah
artefak.

-t teks
Atur judul gambar - teks untuk ditampilkan di atas spektogram.

-c teks
Atur (atau hapus) komentar gambar - teks untuk ditampilkan di bawah dan di sebelah kiri
spektogram.

-o teks
Nama file PNG keluaran spektogram, default `spectogram.png'.

Advanced Pilihan:
Untuk memproses bagian audio yang lebih kecil tanpa mempengaruhi efek lain atau
sinyal keluaran (tidak seperti ketika memangkas efek digunakan), opsi berikut mungkin:
digunakan.

-d lamanya
Opsi ini mengatur resolusi sumbu X sedemikian rupa sehingga audio dengan yang diberikan
lamanya ([[HH:]MM:]SS) sesuai dengan lebar sumbu X yang dipilih (atau default). Untuk
contoh,
sox input.mp3 output.wav -n spectogram -d 1:00 stats
membuat spektogram yang menunjukkan menit pertama audio, sementara
itu statistik efek diterapkan ke seluruh sinyal audio.

Lihat juga -X untuk cara alternatif pengaturan resolusi sumbu X.

-S waktu
Mulai spektogram pada titik tertentu dalam aliran audio. Sebagai contoh
sox input.aiff output.wav spectogram -S 1:00
membuat spektogram yang menampilkan semua kecuali menit pertama audio (
file output bagaimanapun, menerima seluruh aliran audio).

Untuk kemampuan melakukan pemrosesan data spektral off-line, lihat: Stat
efek.

kecepatan faktor[c]
Sesuaikan kecepatan audio (pitch dan tempo bersamaan). faktor adalah rasio dari
kecepatan baru ke kecepatan lama: lebih besar dari 1 mempercepat, kurang dari 1 melambat,
atau, jika ditambahkan dengan huruf `c', jumlah sen (yaitu seperseratus a
semitone) di mana nada (dan tempo) harus disesuaikan: lebih besar dari 0
meningkat, kurang dari 0 menurun.

Secara teknis, efek kecepatan hanya mengubah informasi laju sampel, meninggalkan
sampel sendiri tak tersentuh. Itu tarif efek dipanggil secara otomatis untuk sampel ulang
ke laju sampel keluaran, menggunakan kualitas/kecepatan defaultnya. Untuk kualitas yang lebih tinggi atau
resampling kecepatan lebih tinggi, di samping kecepatan efek, tentukan tarif efek
dengan pilihan kualitas yang diinginkan.

Lihat juga membungkuk, nada, dan waktu efek.

sambatan [-h|-t|-q] { posisi[,kelebihan[,kelonggaran]] }
Gabungkan bagian audio. Efek ini memberikan dua hal melalui audio sederhana
rangkaian: a (biasanya pendek) cross-fade diterapkan pada sambungan, dan gelombang
perbandingan kesamaan dibuat untuk membantu menentukan tempat terbaik untuk membuat
bergabung.

Salah satu pilihan -h, -t, atau -q dapat diberikan untuk memilih amplop pudar sebagai setengah
gelombang kosinus (default), segitiga (alias linier), atau gelombang seperempat kosinus
masing.

Tipe Audio Luntur tingkat Transisi
t gain konstan berkorelasi tiba-tiba
h gain konstan berkorelasi halus
q daya konstan tidak berkorelasi halus

Untuk melakukan penyambungan, pertama-tama gunakan memangkas efek untuk memilih bagian audio yang akan
bergabung bersama. Seperti saat melakukan sambungan pita, ujung bagian menjadi
disambung ke harus dipangkas dengan kecil kelebihan (default 0.005 detik) audio
setelah titik bergabung yang ideal. Awal dari bagian audio untuk disambung
harus dipangkas dengan yang sama kelebihan (sebelum titik bergabung yang ideal), ditambah an
tambahan kelonggaran (default 0.005 detik). SoX kemudian harus dipanggil dengan keduanya
bagian audio sebagai file input dan sambatan efek yang diberikan dengan posisi di
yang melakukan penyambungan - ini adalah panjang bagian audio pertama (termasuk
kelebihan).

Diagram berikut menggunakan analogi pita untuk mengilustrasikan operasi sambungan.
Efeknya mensimulasikan pemotongan diagonal dan menggabungkan dua bagian:

panjang1 kelebihan
-----------><--->
_______ : : _______
\ : : :\ `
\ : : : \ `
\: : : \ `
* : : * - - *
\ : : :\ `
\ : : : \ `
__________________: : : \_____`____
: : : :
<---> <----->
kelebihan waktu luang

di mana * menunjukkan titik-titik bergabung.

Misalnya, lagu yang panjang dimulai dengan dua bait yang dimulai (seperti yang ditentukan misalnya oleh
menggunakan bermain perintah dengan memangkas (awal) efek) pada waktu 0:30.125 dan
1:03.432. Perintah berikut memotong ayat pertama:
sox terlalu panjang.wav part1.wav trim 0 30.130
(kelebihan 5 ms, setelah bait pertama dimulai)
sox terlalu panjang.wav part2.wav trim 1:03.422
(kelebihan 5 ms ditambah kelonggaran 5 ms, sebelum bait kedua dimulai)
sox part1.wav part2.wav sambungan kanan-kanan.wav 30.130
Untuk contoh lain, perintah SoX
mainkan "|sox -n -p synth 1 sin %1" "|sox -n -p synth 1 sin %3"
menghasilkan dan memainkan dua nada, tetapi ada klik buruk pada transisi; itu
klik dapat dihilangkan dengan menyambungkan alih-alih menggabungkan audio, yaitu dengan
menambahkan sambatan 1 ke perintah. (Klik di awal dan akhir audio
dapat dihapus oleh mendahului efek sambungan dengan luntur q . 01 2 . 01).

Asalkan aritmatika Anda cukup baik, banyak sambungan dapat dilakukan dengan a
tunggal sambatan doa. Sebagai contoh:
#!/ Bin / sh
# Audio Copy dan Paste Over
# acpo infile salin-mulai salin-hentikan tempel-over-mulai file keluar
# Semua waktu diukur dalam sampel.
rate=`soxi -r "$1"`
e=`expr $rate '*' 5 / 1000` # Menggunakan kelebihan bawaan
l=$e # dan kelonggaran.
sox "$1" piece.wav trim `expr $2 - $e - $l`s \
`expr $3 - $2 + $e + $l + $e`s
sox "$1" part1.wav trim 0 `expr $4 + $e`s
sox "$1" part2.wav trim `expr $4 + $3 - $2 - $e - $l`s
sox part1.wav piece.wav part2.wav "$5" splice \
`expr $4 + $e`s \
`ekspr $4 + $e + $3 - $2 + $e + $l + $e`s
Dalam skrip Bourne shell di atas, dua sambungan digunakan untuk `menyalin dan menempelkan' audio.

* * *

Dimungkinkan juga untuk menggunakan efek ini untuk melakukan cross-fade umum, misalnya untuk bergabung
dua lagu. Pada kasus ini, kelebihan biasanya akan menjadi beberapa detik, -q
opsi biasanya akan diberikan (untuk memilih 'kekuatan yang sama' cross-fade), dan kelonggaran
harus nol (yang merupakan default jika -q diberikan). Misalnya, jika f1.wav dan
f2.wav adalah file audio yang akan di-cross-faded, maka
sox f1.wav f2.wav out.wav sambungan -q $(soxi -D f1.wav),3
cross-fade file di mana titik kenyaringan yang sama adalah 3 detik sebelum akhir
dari f1.wav, yaitu total panjang cross-fade adalah 2 × 3 = 6 detik (Catatan:
$(...) notasi adalah POSIX shell).

Stat [-s skala] [-rms] [-frekuensi] [-v] [-d]
Menampilkan informasi statistik domain waktu dan frekuensi tentang audio. audio
dilewatkan tanpa dimodifikasi melalui rantai pemrosesan SoX.

Informasi tersebut dikeluarkan ke aliran `kesalahan standar' (stderr) dan adalah
dihitung, dimana n adalah durasi audio dalam sampel, c adalah jumlah
saluran audio, r adalah kecepatan sampel audio, dan xk mewakili nilai PCM (dalam
rentang -1 hingga +1 secara default) dari setiap sampel berturut-turut dalam audio, sebagai berikut:

sampel Baca baca n×c
Panjang (detik) n÷r
Diskalakan by Lihat -s di bawah.
Maksimum amplitudo maks(xk) Nilai sampel maksimum
dalam audio; biasanya
ini akan menjadi positif
nomor.
Minimum amplitudo menit(xk) Nilai sampel minimum
dalam audio; biasanya
ini akan menjadi negatif
nomor.
Garis tengah amplitudo min(xk)+½maks(xk)
Berarti norma /nΣ│xkRata-rata dari
nilai mutlak masing-masing
sampel dalam audio.
Berarti amplitudo /nΣxk Rata-rata dari masing-masing
sampel dalam audio. Jika
angka ini bukan nol,
maka itu menunjukkan
adanya DC
offset (yang bisa berupa
dihapus menggunakan
pergeseran dc efek).
RMS amplitudo (¹/nΣxk²) Tingkat DC
sinyal yang akan memiliki
kekuatan yang sama dengan
kekuatan rata-rata audio.
Maksimum delta maks(│xk-xk-1)
Minimum delta menit(│xk-xk-1)
Berarti delta /n-1Σ│xk-xk-1│
RMS delta (¹/n-1Σ(xk-xk-1)²)
Kasar frekuensi Dalam Hz.
Volume Pengaturan Parameter ke vol
efek yang akan membuat
audio sekeras
mungkin tanpa
guntingan. Catatan: Lihat
diskusi tentang Guntingan
di atas untuk alasan mengapa
jarang merupakan ide yang bagus
sebenarnya untuk melakukan ini.

Perhatikan bahwa pengukuran delta tidak berlaku untuk audio multi-saluran.

-s opsi dapat digunakan untuk menskalakan data input dengan faktor tertentu. Standarnya
nilai skala adalah 2147483647 (yaitu nilai maksimum integer bertanda 32-bit).
Efek internal selalu bekerja dengan data PCM panjang yang ditandatangani sehingga nilainya harus
berhubungan dengan fakta ini.

-rms opsi akan mengonversi semua nilai rata-rata keluaran menjadi `root mean square'
Format.

-v opsi hanya menampilkan nilai `Penyesuaian Volume'.

-frekuensi opsi menghitung spektrum daya input (4096 titik DFT) alih-alih
statistik yang tercantum di atas. Ini hanya boleh digunakan dengan audio saluran tunggal
file.

-d opsi menampilkan hex dump dari audio data PCM bertanda 32-bit di SoX's
penyangga internal. Ini terutama digunakan untuk membantu melacak masalah endian yang
terkadang terjadi pada versi lintas platform SoX.

Lihat juga statistik efek.

statistik [-b bit|-x bit|-s skala] [-w waktu jendela]
Tampilkan informasi statistik domain waktu tentang saluran audio; audio adalah
melewati tanpa dimodifikasi melalui rantai pemrosesan SoX. Statistik dihitung dan
ditampilkan untuk setiap saluran audio dan, jika berlaku, angka keseluruhan juga
diberikan.

Misalnya, untuk file musik stereo tipikal yang dikuasai dengan baik:

Keseluruhan Kiri Kanan
DC offset 0.000803 -0.000391 0.000803
Level minimum -0.750977 -0.750977 -0.653412
Tingkat maksimum 0.708801 0.708801 0.653534
Pk lev dB -2.49 -2.49 -3.69
RMS lev dB -19.41 -19.13 -19.71
RMS Pk dB -13.82 -13.82 -14.38
RMS Tr dB -85.25 -85.25 -82.66
Faktor puncak - 6.79 6.32
Faktor datar 0.00 0.00 0.00
Pk hitung 2 2 2
Kedalaman bit 16/16 16/16 16/16
Jumlah sampel 7.72M
Panjang s 174.973
Skala maks 1.000000
Jendela s 0.050

DC mengimbangi, Min tingkat, dan max tingkat ditampilkan, secara default, dalam kisaran ±1. jika
-b (bit) opsi diberikan, maka ketiga pengukuran ini akan diskalakan menjadi a
bilangan bulat bertanda dengan jumlah bit yang diberikan; misalnya, untuk 16 bit, skala
akan menjadi -32768 hingga +32767. Itu -x opsi berperilaku dengan cara yang sama seperti -b kecuali itu
nilai integer yang ditandatangani ditampilkan dalam heksadesimal. Itu -s skala opsi
tiga pengukuran dengan angka floating-point yang diberikan.

Pk lev dB dan RMS lev dB adalah puncak standar dan level RMS yang diukur dalam dBFS.
RMS Pk dB dan RMS Tr dB adalah nilai puncak dan palung untuk tingkat RMS yang diukur lebih dari a
jendela pendek (default 50ms).

Puncak faktor adalah rasio standar puncak ke level RMS (catatan: tidak dalam dB).

Datar faktor adalah ukuran kerataan (yaitu sampel berurutan dengan
nilai) dari sinyal pada tingkat puncaknya (yaitu baik Min tingkat, atau max tingkat).
Pk menghitung adalah jumlah kesempatan (bukan jumlah sampel) bahwa sinyal
tercapai juga Min tingkat, atau max tingkat.

tangan kanan Kedalaman bit angka adalah definisi standar kedalaman bit yaitu bit
kurang signifikan dari angka yang diberikan tetap pada nol. Angka di sebelah kiri adalah
jumlah bit paling signifikan yang ditetapkan pada nol (atau satu untuk negatif
angka) dikurangi dari angka di sebelah kanan (angka yang dikurangi langsung
berhubungan dengan Pk lev dB).

Untuk audio multi-saluran, angka keseluruhan untuk setiap pengukuran di atas adalah
diberikan dan diturunkan dari angka saluran sebagai berikut: DC mengimbangi: maksimal
besarnya; max tingkat, Pk lev dB, RMS Pk dB, Kedalaman bit: maksimum; Min tingkat,
RMS Tr dB: minimal; RMS lev dB, Datar faktor, Pk menghitung: rata-rata; Puncak faktor: tidak
berlaku.

Panjang s adalah durasi dalam detik audio, dan Di sampel sama dengan
laju sampel dikalikan dengan Panjang. Skala max adalah penskalaan yang diterapkan pada yang pertama
tiga pengukuran; secara khusus, itu adalah nilai maksimum yang dapat berlaku untuk
max tingkat. Jendela s adalah panjang jendela yang digunakan untuk RMS puncak dan palung
pengukuran.

Lihat juga Stat efek.

menukar Tukar saluran stereo. Lihat juga remix untuk efek yang memungkinkan saluran sewenang-wenang
pemilihan dan pemesanan (dan pencampuran).

meregang faktor [jendela luntur bergeser kabur]
Ubah durasi audio (tetapi bukan nadanya). Efek ini secara luas setara
ke waktu efek dengan (faktor terbalik dan) Cari diatur ke nol, jadi secara umum,
hasilnya relatif buruk; itu dipertahankan karena terkadang berkinerja lebih baik
waktu untuk kecil faktors.

faktor peregangan: >1 memanjang, <1 memperpendek durasi. jendela ukuran dalam ms.
Standarnya adalah 20ms. Itu luntur pilihan, bisa `lin'. bergeser rasio, dalam [0 1]. Bawaan
tergantung pada faktor peregangan. 1 untuk memperpendek, 0.8 untuk memperpanjang. Itu kabur rasio, dalam [0
0.5]. Jumlah default fade tergantung pada faktor dan bergeser.

Lihat juga waktu efek.

synth [-j KUNCI] [-n] [len [lepas [ph [p1 [p2 [p3]]]]]] {[mengetik] [menggabungkan]
[[%]Frek[k][:|+|/|-[%]frekuensi2[k]]] [lepas [ph [p1 [p2 [p3]]]]]}
Efek ini dapat digunakan untuk menghasilkan nada audio frekuensi tetap atau tersapu dengan
berbagai bentuk gelombang, atau untuk menghasilkan suara pita lebar dari berbagai `warna'. beberapa
efek synth dapat mengalir untuk menghasilkan bentuk gelombang yang lebih kompleks; pada setiap tahap itu
dimungkinkan untuk memilih apakah bentuk gelombang yang dihasilkan akan dicampur dengan, atau
dimodulasi ke output dari tahap sebelumnya. Audio untuk setiap saluran dalam a
file audio multi-channel dapat disintesis secara independen.

Meskipun efek ini digunakan untuk menghasilkan audio, file input tetap harus diberikan,
karakteristik yang akan digunakan untuk mengatur panjang audio yang disintesis,
jumlah saluran, dan laju pengambilan sampel; namun, karena audio file input adalah
biasanya tidak diperlukan, `file null' (dengan nama khusus -n) sering diberikan
sebagai gantinya (dan panjangnya ditentukan sebagai parameter untuk synth atau oleh yang lain yang diberikan
efek yang dapat memiliki panjang terkait).

Misalnya, berikut ini menghasilkan file audio 3 detik, 48kHz, yang berisi a
gelombang sinus menyapu dari 300 ke 3300 Hz:
sox -n output.wav synth 3 sinus 300-3300
dan ini menghasilkan versi 8 kHz:
sox -r 8000 -n output.wav synth 3 sinus 300-3300
Beberapa saluran dapat disintesis dengan menentukan set parameter yang ditampilkan
antara kawat gigi beberapa kali; berikut ini menempatkan nada sapuan di kiri
saluran dan menambahkan suara `coklat' di sebelah kanan:
sox -n output.wav synth 3 sinus 300-3300 brownnoise
Contoh berikut menunjukkan bagaimana dua efek synth dapat di-cascade untuk membuat lebih banyak lagi
bentuk gelombang kompleks:
mainkan -n synth 0.5 sinus 200-500 synth 0.5 sinus fmod 700-100
Frekuensi juga dapat diberikan dalam notasi not `ilmiah', atau, dengan awalan `%'
karakter, sebagai jumlah seminada relatif terhadap `A tengah' (440 Hz). Sebagai contoh,
berikut ini dapat digunakan untuk membantu menyetel senar `E' rendah gitar:
mainkan -n synth 4 petik %-29
atau dengan loop (Bourne shell), seluruh gitar:
untuk n di E2 A2 D3 G3 B3 E4; melakukan
play -n synth 4 pluck $n repeat 2; selesai
Lihat menunda efek (di atas) dan referensi ke `contoh skrip SoX' (di bawah)
keahlian yang lebih synth contoh.

NB Efek ini menghasilkan audio pada volume maksimum (0dBFS), yang berarti ada
adalah kemungkinan besar kliping saat menggunakan audio selanjutnya, jadi dalam banyak kasus,
Anda akan ingin mengikuti efek ini dengan mendapatkan efek untuk mencegah hal ini dari
kejadian. (Lihat juga Guntingan di atas.) Perhatikan bahwa, secara default, tombol synth efek
menggabungkan fungsi dari mendapatkan -h (Lihat mendapatkan efek untuk rincian);
synth's -n opsi dapat diberikan untuk menonaktifkan perilaku ini.

Penjelasan rinci dari masing-masing synth parameter berikut:

len adalah panjang audio untuk disintesis yang dinyatakan sebagai waktu atau sejumlah
sampel; 0=panjang input, default=0.

Format untuk menentukan panjang dalam waktu adalah jj:mm:ss.frac. Format untuk
menentukan jumlah sampel adalah jumlah sampel dengan huruf `s' ditambahkan ke
.

mengetik adalah salah satu dari sinus, persegi, segitiga, gigi gergaji, trapesium, exp, [putih]noise,
tpdfnoise pinknoise, brownnoise, memetik; default = sinus.

menggabungkan adalah salah satu dari create, mix, amod (modulasi amplitudo), fmod (frekuensi
modulasi); default=buat.

Frek/frekuensi2 adalah frekuensi pada awal/akhir sintesis dalam Hz atau, jika
didahului dengan `%', semitone relatif terhadap A (440 Hz); sebagai alternatif, `ilmiah'
notasi notasi (misalnya E2) dapat digunakan. Frekuensi default adalah 440Hz. Secara default,
penyetelan yang digunakan dengan notasi not adalah 'temperamen yang sama'; itu -j KUNCI Option
memilih `hanya intonasi', di mana KUNCI adalah bilangan bulat semitone relatif terhadap
A (misalnya, -9 atau 3 memilih kunci C), atau not dalam notasi ilmiah.

If frekuensi2 diberikan, maka len juga harus diberikan dan nada yang dihasilkan akan
disapu di antara frekuensi yang diberikan. Dua frekuensi yang diberikan harus
dipisahkan oleh salah satu karakter `:', `+', `/', atau `-'. Karakter ini digunakan
untuk menentukan fungsi sapuan sebagai berikut:

: Linear: nada akan berubah dengan jumlah hertz per detik yang tetap.

+ Kotak: fungsi orde kedua digunakan untuk mengubah nada.

/ Eksponensial: nada akan berubah dengan jumlah seminada yang tetap per detik.

- Eksponensial: sebagai `/', tetapi fase awal selalu nol, dan melangkah (kurang
halus) perubahan frekuensi.

Tidak digunakan untuk kebisingan.

lepas adalah bias (DC-offset) dari sinyal dalam persen; standar = 0.

ph adalah pergeseran fasa dalam persentase 1 siklus; standar = 0. Tidak digunakan untuk kebisingan.

p1 adalah persentase dari setiap siklus yang `on' (persegi), atau `naik' (segitiga,
exp, trapesium); default=50 (persegi, segitiga, exp), default=10 (trapesium), atau
menopang (mencabut); standar = 40.

p2 (trapesium): persentase melalui setiap siklus di mana `jatuh' dimulai;
standar = 50. exp: amplitudo dalam kelipatan 2dB; default=50, atau tone-1 (petik);
standar = 20.

p3 (trapesium): persentase melalui setiap siklus di mana 'jatuh' berakhir;
default=60, atau nada-2 (petik); standar = 90.

waktu [-q] [-m|-s|-l] faktor [ruas [Cari [tumpang tindih]]]
Ubah kecepatan pemutaran audio tetapi bukan nadanya. Efek ini menggunakan WSOLA
algoritma. Audio dipotong menjadi beberapa segmen yang kemudian digeser dalam waktu
domain dan tumpang tindih (cross-faded) pada titik-titik di mana bentuk gelombangnya paling banyak
serupa seperti yang ditentukan oleh pengukuran 'kuadrat terkecil'.

Secara default, pencarian linier digunakan untuk menemukan titik tumpang tindih terbaik. jika
opsional -q parameter diberikan, pencarian pohon digunakan sebagai gantinya. Hal ini membuat
efek bekerja lebih cepat, tetapi hasilnya mungkin tidak terdengar bagus. Namun, jika Anda
harus meningkatkan kecepatan pemrosesan, ini umumnya mengurangi kualitas suara
daripada mengurangi nilai pencarian atau tumpang tindih.

-m opsi digunakan untuk mengoptimalkan nilai default segmen, pencarian, dan tumpang tindih untuk
pengolahan musik.

-s opsi digunakan untuk mengoptimalkan nilai default segmen, pencarian, dan tumpang tindih untuk
pemrosesan ucapan.

-l opsi digunakan untuk mengoptimalkan nilai default segmen, pencarian, dan tumpang tindih untuk
Pemrosesan `linier' yang cenderung menyebabkan distorsi yang lebih nyata tetapi mungkin
berguna ketika faktor mendekati 1.

Jika -m, -s, atau -l ditentukan, nilai default segmen akan dihitung
berdasarkan faktor, sedangkan pencarian default dan nilai tumpang tindih didasarkan pada segmen. Setiap
nilai yang Anda berikan masih menimpa nilai default ini.

faktor memberikan rasio tempo baru ke tempo lama, jadi misalnya 1.1 mempercepat
tempo sebesar 10%, dan 0.9 memperlambatnya sebesar 10%.

Opsional ruas parameter memilih ukuran segmen algoritma di
milidetik. Jika tidak ada flag lain yang ditentukan, nilai defaultnya adalah 82 dan adalah
biasanya cocok untuk membuat perubahan kecil pada tempo musik. Untuk perubahan yang lebih besar
(misalnya faktor 2), 41 ms dapat memberikan hasil yang lebih baik. Bendera -m, -s, dan -l
akan menyebabkan default segmen secara otomatis disesuaikan berdasarkan faktor. Untuk
contoh menggunakan -s (untuk ucapan) dengan tempo 1.25 akan menghitung segmen default
nilai 32.

Opsional Cari parameter memberikan panjang audio dalam milidetik di mana
algoritma akan mencari titik-titik yang tumpang tindih. Jika tidak ada flag lain yang ditentukan,
nilai default adalah 14.68. Nilai yang lebih besar menggunakan lebih banyak waktu pemrosesan dan mungkin atau mungkin tidak
menghasilkan hasil yang lebih baik. Maksimum praktis adalah setengah dari nilai segmen. Mencari
dapat dikurangi untuk memotong waktu pemrosesan dengan risiko menurunkan kualitas output. Itu
Bendera -m, -s, dan -l akan menyebabkan default pencarian disesuaikan secara otomatis
berdasarkan segmen.

Opsional tumpang tindih parameter memberikan panjang tumpang tindih segmen dalam milidetik.
Nilai default adalah 12, tetapi flag -m, -s, atau -l secara otomatis menyesuaikan tumpang tindih berdasarkan
ukuran segmen. Meningkatkan tumpang tindih meningkatkan waktu pemrosesan dan dapat meningkat
kualitas. Maksimum praktis untuk tumpang tindih adalah nilai pencarian, dengan tumpang tindih
biasanya menjadi (setidaknya) sedikit lebih kecil dari pencarian.

Lihat juga kecepatan untuk efek yang mengubah tempo dan nada bersama-sama, nada dan membungkuk
untuk efek yang hanya mengubah nada, dan meregang untuk efek yang mengubah tempo
menggunakan algoritma yang berbeda.

tiga kali lipat mendapatkan [frekuensi[k] [lebar[s|h|k|o|q]]]
Terapkan efek kontrol nada treble. Lihat deskripsi bas efek untuk
rincian.

getaran kecepatan [kedalaman]
Terapkan efek tremolo (modulasi amplitudo frekuensi rendah) ke audio. Itu
frekuensi tremolo dalam Hz diberikan oleh kecepatan, dan kedalaman sebagai persentase dengan kedalaman
(standar 40).

memangkas {[=|-]posisi}
Memotong bagian dari audio. Berapapun posisis dapat diberikan; audio tidak
dikirim ke output sampai yang pertama posisi tercapai. Efeknya kemudian bergantian
antara menyalin dan membuang audio di masing-masing posisi.

Jika posisi didahului oleh tanda sama dengan atau minus, itu ditafsirkan relatif terhadap
awal atau akhir audio, masing-masing. (Panjang audio harus
dikenal untuk lokasi relatif akhir untuk bekerja.) Jika tidak, itu dianggap sebagai offset
dari yang terakhir posisi, atau dari awal audio untuk parameter pertama. Menggunakan
nilai 0 untuk yang pertama posisi parameter memungkinkan penyalinan dari awal
audionya.

Semua parameter dapat ditentukan menggunakan jumlah waktu atau hitungan yang tepat dari
sampel. Format untuk menentukan panjang dalam waktu adalah jj:mm:ss.frac. Sebuah nilai dari
1:30.5 untuk parameter pertama tidak akan dimulai sampai 1 menit, tiga puluh dan detik
ke dalam audio. Format untuk menentukan jumlah sampel adalah jumlah sampel
dengan huruf `s' ditambahkan padanya. Nilai 8000s untuk parameter pertama akan
tunggu hingga 8000 sampel terbaca sebelum mulai memproses audio.

Sebagai contoh,
sox infile outfile pangkas 0 10
akan menyalin sepuluh detik pertama, sementara
mainkan infile trim 12:34 = 15:00 -2:00
akan diputar dari 12 menit 34 detik ke dalam audio hingga 15 menit ke dalam audio
(yaitu berdurasi 2 menit 26 detik), lalu lanjutkan pemutaran dua menit sebelum
akhir audio.

contoh tambahan [faktor]
Upsample sinyal dengan faktor bilangan bulat: faktor-1 sampel bernilai nol dimasukkan
antara setiap pasangan sampel masukan. Akibatnya, spektrum aslinya adalah
direplikasi ke dalam ruang frekuensi baru (aliasing) dan dilemahkan. Ini
redaman dapat dikompensasikan dengan menambahkan vol faktor setelah lebih jauh
pengolahan. Efek upsample biasanya digunakan dalam kombinasi dengan penyaringan
efek.

Untuk efek resampling umum dengan anti-aliasing, lihat tarif. Lihat juga sampel.

sebagai [Pilihan]
Detektor Aktivitas Suara. Upaya untuk mengurangi kesunyian dan suara latar yang senyap dari
ujung (resolusi yang cukup tinggi yaitu 16-bit, 44-48kHz) rekaman pembicaraan.
Algoritma saat ini menggunakan pengukuran daya cepstral sederhana untuk mendeteksi suara,
jadi mungkin tertipu oleh hal lain, terutama musik. Efeknya hanya dapat dipangkas dari
bagian depan audio, jadi untuk memangkas dari belakang, membalikkan efek harus
juga digunakan. Misalnya
mainkan pidato.wav norma vad
untuk memangkas dari depan,
mainkan pidato.wav norma membalikkan vad terbalik
untuk memangkas dari belakang, dan
mainkan pidato.wav norm vad reverse vad reverse
untuk memotong dari kedua ujungnya. Penggunaan dari norma efeknya disarankan, tapi ingat
itu juga tidak membalikkan maupun norma cocok untuk digunakan dengan audio streaming.

Pilihan:
Nilai default ditampilkan dalam tanda kurung.

-t num (7)
Tingkat pengukuran yang digunakan untuk memicu deteksi aktivitas. Ini mungkin perlu
untuk diubah tergantung pada tingkat kebisingan, tingkat sinyal, dan lainnya
karakteristik audio masukan.

-T num (0.25)
Konstanta waktu (dalam detik) digunakan untuk membantu mengabaikan ledakan suara yang singkat.

-s num (1)
Jumlah audio (dalam detik) untuk mencari ledakan yang lebih tenang/lebih pendek
audio untuk disertakan sebelum titik pemicu yang terdeteksi.

-g num (0.25)
Kesenjangan yang diizinkan (dalam detik) antara semburan audio yang lebih tenang/lebih pendek untuk disertakan
sebelum titik pemicu yang terdeteksi.

-p num (0)
Jumlah audio (dalam detik) untuk dipertahankan sebelum titik pemicu dan
setiap ledakan yang ditemukan lebih tenang/lebih pendek.

Advanced Pilihan:
Ini memungkinkan penyetelan yang baik dari parameter internal algoritme.

-b num Algoritme (secara internal) menggunakan estimasi/reduksi noise adaptif secara berurutan
untuk mendeteksi awal audio yang diinginkan. Opsi ini menetapkan waktu untuk
perkiraan kebisingan awal.

-N num Konstanta waktu yang digunakan oleh penduga kebisingan adaptif ketika tingkat kebisingan
meningkat.

-n num Konstanta waktu yang digunakan oleh penduga kebisingan adaptif ketika tingkat kebisingan
sedang menurun.

-r num Jumlah pengurangan kebisingan untuk digunakan dalam algoritma deteksi (misalnya 0, 0.5,
...).

-f num Frekuensi pemrosesan/pengukuran algoritma.

-m num Durasi pengukuran; secara default, dua kali periode pengukuran; yaitu dengan
tumpang tindih.

-M num Konstanta waktu digunakan untuk menghaluskan pengukuran spektral.

-h num Frekuensi `Brick-wall' dari filter high-pass diterapkan pada input ke
algoritma pendeteksi.

-l num Frekuensi `Brick-wall' dari filter lolos rendah diterapkan pada input ke
algoritma pendeteksi.

-H num Frekuensi 'Brick-wall' dari pengangkat high-pass yang digunakan dalam algoritma detektor.

-L num Frekuensi `Brick-wall' pengangkat low-pass yang digunakan dalam algoritma detektor.

Lihat juga diam efek.

vol mendapatkan [mengetik [pembatas keuntungan]]
Terapkan amplifikasi atau redaman pada sinyal audio. tidak seperti -v Option
(yang digunakan untuk menyeimbangkan beberapa file input saat mereka memasuki efek SoX
rantai pemrosesan), vol adalah efek seperti yang lain sehingga dapat diterapkan di mana saja, dan
beberapa kali jika perlu, selama rantai pemrosesan.

Jumlah untuk mengubah volume diberikan oleh mendapatkan yang ditafsirkan menurut
pemberian mengetik, sebagai berikut: jika mengetik is amplitudo (atau dihilangkan), maka mendapatkan adalah
rasio amplitudo (yaitu tegangan atau linier), jika kekuasaan, maka daya (yaitu watt atau
rasio tegangan-kuadrat), dan jika dB, maka terjadi perubahan daya dalam dB.

Ketika mengetik is amplitudo or kekuasaan, Sebuah mendapatkan dari 1 membuat volume tidak berubah, kurang dari
1 menguranginya, dan lebih besar dari 1 meningkatkannya; negatif mendapatkan membalikkan audio
sinyal selain menyesuaikan volumenya.

Ketika mengetik is dB, Sebuah mendapatkan dari 0 membuat volume tidak berubah, kurang dari 0 menguranginya,
dan lebih besar dari 0 meningkatkannya.

Lihat [4] untuk diskusi terperinci tentang tegangan listrik (dan karenanya sinyal audio)
dan rasio daya.

Hati-hati terhadap Guntingan ketika volume meningkat.

mendapatkan dan mengetik parameter dapat digabungkan jika diinginkan, mis vol 10dB.

Opsional pembatas keuntungan nilai dapat ditentukan dan harus menjadi nilai yang jauh lebih kecil dari
1 (misalnya 0.05 atau 0.02) dan hanya digunakan pada puncak untuk mencegah kliping. Bukan
menentukan parameter ini akan menyebabkan tidak ada pembatas yang digunakan. Dalam mode verbose, ini
efek akan menampilkan persentase audio yang perlu dibatasi.

Lihat juga mendapatkan untuk efek perubahan volume dengan kemampuan berbeda, dan teman
untuk efek kompresi/ekspansi/pembatasan rentang dinamis.

Ditinggalkan efek
Efek berikut telah diganti namanya atau fungsinya disertakan di efek lain
memengaruhi; mereka terus bekerja di versi SoX ini tetapi mungkin akan dihapus di masa mendatang.

pengaduk [ -l|-r|-f|-b|-1|-2|-3|-4|n{,n} ]
Kurangi jumlah saluran audio dengan mencampur atau memilih saluran, atau menambah
jumlah saluran dengan menduplikasi saluran. Catatan: efek ini beroperasi pada
audio saluran dalam rantai pemrosesan efek SoX; seharusnya tidak bingung
pada pengatur terkenal. Pengatur ini menawarkan bantuan hukum kepada traderapabila trader berselisih dengan broker yang terdaftar dengan mereka. -m opsi global (di mana banyak arsip dicampur-gabung sebelum masuk
rantai efek).

Saat mengurangi jumlah saluran, dimungkinkan untuk menggunakan -l, -r, -f, -b, -1,
-2, -3, -4, opsi untuk memilih hanya saluran kiri, kanan, depan, belakang atau
saluran tertentu untuk output alih-alih rata-rata saluran. Itu -l, dan -r
opsi akan melakukan rata-rata dalam file quad-channel jadi pilih saluran yang tepat untuk
cegah ini.

pengaduk efek juga dapat dipanggil dengan hingga 16 angka, dipisahkan dengan koma,
yang menentukan proporsi (0 = 0% dan 1 = 100%) dari setiap saluran input yang akan
dicampur ke dalam setiap saluran keluaran. Dalam mode dua saluran, 4 angka diberikan: l →
l, l → r, r → l, dan r → r, berturut-turut. Dalam mode empat saluran, 4 . pertama
angka memberikan proporsi untuk saluran keluaran kiri-depan, sebagai berikut: lf →
lf, rf → lf, lb → lf, dan rb → rf. 4 berikutnya memberikan output kanan-depan di
urutan yang sama, lalu bek kiri dan bek kanan.

Dimungkinkan juga untuk menggunakan 16 nomor untuk memperluas atau mengurangi jumlah saluran;
cukup tentukan 0 untuk saluran yang tidak digunakan.

Akhirnya, kombinasi angka tertentu yang dikurangi dapat ditentukan dengan pasti
kombinasi saluran input/output.

In Ch Di luar Ch Di Pemetaan
2 1 2 aku → aku, r → aku
2 2 1 sesuaikan saldo
4 1 4 lf → aku, rf → aku, lb → aku, rb → aku
4 2 2 lf → l&rf → r, lb → l&rb → r
4 4 1 sesuaikan saldo
4 4 2 keseimbangan depan, keseimbangan belakang

Efek ini telah digantikan oleh remix efek yang menangani sejumlah
Saluran.

DIAGNOSTIK

Status keluar adalah 0 untuk tidak ada kesalahan, 1 jika ada masalah dengan parameter baris perintah,
atau 2 jika terjadi kesalahan selama pemrosesan file.

Gunakan bermain online menggunakan layanan onworks.net