shnpad - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

shntool - một tiện ích báo cáo và xử lý dữ liệu WAVE đa năng

SYNOPSIS

dụng cụ nhỏ chế độ ...
dụng cụ nhỏ [CORE TÙY CHỌN]

MÔ TẢ

dụng cụ nhỏ là một tiện ích dòng lệnh để xem và / hoặc sửa đổi dữ liệu và thuộc tính WAVE. Nó chạy
ở một số chế độ hoạt động khác nhau và hỗ trợ nhiều định dạng âm thanh không mất dữ liệu.

dụng cụ nhỏ bao gồm ba phần - cốt lõi của nó, chế độ mô-đun, và định dạng các mô-đun. Cái này
giúp bảo trì mã dễ dàng hơn, cũng như hỗ trợ các lập trình viên khác phát triển
chức năng mới. Kho lưu trữ phân phối chứa một tệp có tên 'modules.howto'
mô tả cách tạo một chế độ hoặc mô-đun định dạng mới, cho những người có khuynh hướng như vậy.

Chế độ mô-đun
dụng cụ nhỏ thực hiện các chức năng khác nhau trên dữ liệu WAVE thông qua việc sử dụng các mô-đun chế độ. Cốt lõi
of dụng cụ nhỏ chỉ đơn giản là một trình bao bọc xung quanh các mô-đun chế độ. Trên thực tế, khi dụng cụ nhỏ được chạy với
một chế độ hợp lệ làm đối số đầu tiên của nó, về cơ bản nó chạy thủ tục chính cho
chế độ được chỉ định và thoát. dụng cụ nhỏ đi kèm với một số chế độ tích hợp, được mô tả bên dưới:

len Hiển thị độ dài, kích thước và thuộc tính của dữ liệu PCM WAVE

sửa chữa Khắc phục các vấn đề về ranh giới khu vực với dữ liệu PCM WAVE chất lượng của CD

băm Tính toán dấu vân tay MD5 hoặc SHA1 của dữ liệu PCM WAVE

tập giấy Đĩa CD (tệp hyquality không được căn chỉnh trên ranh giới khu vực với dấu lặng

tham gia Kết hợp dữ liệu PCM WAVE từ nhiều tệp thành một

chia Tách dữ liệu PCM WAVE từ một tệp thành nhiều tệp

làm sao Ghi dữ liệu PCM WAVE từ một hoặc nhiều tệp vào thiết bị đầu cuối

CMP So sánh dữ liệu PCM WAVE trong hai tệp

cây cơ bida Tạo trang tính CUE hoặc các điểm phân tách từ một tập hợp tệp

chuyển đổi Chuyển đổi tệp từ định dạng này sang định dạng khác

Thông tin Hiển thị thông tin chi tiết về dữ liệu PCM WAVE

dải Tách thêm các phần RIFF và / hoặc viết các tiêu đề chuẩn

gen Tạo các tệp dữ liệu PCM WAVE chất lượng CD có chế độ im lặng

tỉa Cắt im lặng PCM WAVE từ cuối tệp

Để biết thêm thông tin về ý nghĩa của các tùy chọn dòng lệnh khác nhau cho mỗi chế độ, hãy xem
các CHẾ ĐỘ ‐ CỤ THỂ LỰA CHỌN phần bên dưới.

Để thuận tiện, mỗi chế độ có thể chỉ định một tên hoặc bí danh thay thế sẽ gọi nó
(tính năng này hiện chỉ khả dụng trên các hệ thống hỗ trợ biểu tượng hoặc cứng
liên kết). Đặc biệt, mỗi chế độ được đặt bí danh là 'shn '. Ví dụ, đang chạy
nhỏ bé tương đương với chạy dụng cụ nhỏ len - do đó tiết kiệm được một vài lần gõ phím.

Định dạng mô-đun
Định dạng tệp được tóm tắt từ dụng cụ nhỏ thông qua việc sử dụng các mô-đun định dạng. Họ cung cấp
một phương tiện cho dụng cụ nhỏ để chuyển đọc và / hoặc ghi các định dạng tệp khác nhau. Cái này
sự trừu tượng cho phép dụng cụ nhỏ tập trung vào công việc của mình mà không cần lo lắng về các chi tiết của
mỗi định dạng tệp.

Các định dạng sau hiện đang được hỗ trợ:

wav Định dạng tệp RIFF WAVE

oof Định dạng tệp trao đổi âm thanh (chỉ AIFF và không nén / gieot AIFF-C) (qua
'sox'):
<http://sox.sourceforge.net/>

shn Rút ngắn bộ mã hóa dạng sóng có độ phức tạp thấp (thông qua 'rút ngắn'):
<http://www.softsound.com/Shorten.html>
<http://www.etree.org/shnutils/shorten/>

flac Bộ giải mã âm thanh không mất dữ liệu miễn phí (thông qua 'flac'):
<http://flac.sourceforge.net/>

ape Monkey's Audio Compressor (thông qua 'mac'):
<http://www.monkeysaudio.com/>
<http://supermmx.org/linux/mac/>

a the C Apple Lossless Audio Codec (thông qua 'alac'):
<http://craz.net/programs/itunes/alac.html>

tak (T) om's lossless (A) udio (K) ompressor (via 'takc'):
<http://www.thbeck.de/Tak/Tak.html>

của OptimFROG Lossless WAVE Audio Coder (thông qua 'ofr'):
<http://www.losslessaudio.org/>

tta Bộ giải mã âm thanh không mất TTA (qua 'ttaenc'):
<http://tta.sourceforge.net/>

như Mã hóa không mất âm thanh MPEG-4 (qua 'mp4als'):
<http://www.nue.tu-berlin.de/forschung/projekte/ -
lossless / mp4als.html>

wv WavPack Hybrid Lossless Audio Compression (qua 'wavpack' và 'wvunpack'):
<http://www.wavpack.com/>

lpac Nén âm thanh dự đoán không mất dữ liệu (qua 'lpac'):
<http://www.nue.tu-berlin.de/wer/liebchen/lpac.html>

la Âm thanh Lossless (qua 'la'):
<http://www.lossless-audio.com/>

bon chen Bộ nén âm thanh mất mát / không mất dữ liệu Bonk (thông qua 'bonk'):
<http://www.logarithmic.net/pfh/bonk>

kxs Máy nén tệp WAV không mất dữ liệu Kexis (thông qua 'kexis'):
<http://www.sourceforge.net/projects/kexis/>

mét vuông Định dạng nén âm thanh MKW (thông qua 'mkwcon'):
<http://www.etree.org/shnutils/mkwcon/>

người trông coi Mô-đun định dạng đầu ra tùy chỉnh (chỉ đầu ra, hữu ích để mã hóa thành một định dạng
việc này dụng cụ nhỏ chưa hỗ trợ)

kỳ hạn gửi đầu ra đến thiết bị đầu cuối

vô giá trị gửi đầu ra đến / dev / null (chỉ đầu ra, hữu ích cho các lần chạy cạn
các chế độ, chẳng hạn như sửa chữa chế độ hoặc dải chế độ)

Khi đọc tệp để nhập, dụng cụ nhỏ tự động phát hiện mô-đun định dạng, nếu có,
xử lý từng tệp. Trong các chế độ mà tệp được tạo dưới dạng đầu ra, bạn có thể chỉ định những gì
định dạng đầu ra phải là - nếu không, dụng cụ nhỏ quyết định cho bạn bằng cách chọn định dạng đầu tiên
nó tìm thấy mô-đun hỗ trợ đầu ra (trong cài đặt mặc định, đây sẽ là wav
định dạng).

CORE LỰA CHỌN

Người mẫu
Khi chạy mà không có chế độ, dụng cụ nhỏ thực hiện các tùy chọn sau:

-m Hiển thị thông tin mô-đun chế độ chi tiết

-f Hiển thị thông tin mô-đun định dạng chi tiết

-a Hiển thị các đối số mô-đun định dạng mặc định

-v Hiển thị thông tin phiên bản

-h Hiển thị màn hình trợ giúp

GLOBAL LỰA CHỌN

Tất cả chế độ
Tất cả các chế độ hỗ trợ các tùy chọn sau:

-D In thông tin gỡ lỗi

-F hồ sơ
Chỉ định một tệp chứa danh sách tên tệp để xử lý. Điều này sẽ ghi đè bất kỳ tệp nào
được chỉ định trên dòng lệnh hoặc trên thiết bị đầu cuối.

LƯU Ý: Hầu hết các chế độ sẽ chấp nhận tên tệp đầu vào từ một nguồn duy nhất, theo
thứ tự ưu tiên sau: tệp được chỉ định bởi -F tùy chọn, nếu không thì tên tệp
trên dòng lệnh, nếu không thì tên tệp được đọc từ thiết bị đầu cuối.

-H Lần in ở định dạng h: mm: ss. {Ff, nnn}, thay vì m: ss. {Ff, nnn}

-P kiểu
Chỉ định loại chỉ báo tiến độ. kiểu là một trong những: {pct, dot, quay, đối mặt, không ai}.
pct hiển thị phần trăm hoàn thành của mỗi hoạt động. dot cho thấy sự tiến bộ của
mỗi thao tác bằng cách hiển thị dấu '.' sau mỗi bước 10% để hoàn thành. quay
hiển thị chỉ báo tiến độ vắt. đối mặt hiển thị tiến trình của từng hoạt động bằng cách
hiển thị sáu biểu tượng cảm xúc ngày càng trở nên vui vẻ khi hoạt động gần đến
hoàn thành. không ai ngăn không cho bất kỳ thông tin hoàn thành tiến độ nào
hiển thị. Mặc định là pct.

-h Hiển thị màn hình trợ giúp cho chế độ này

-i fmt Chỉ định bộ giải mã định dạng tệp đầu vào và / hoặc các đối số. Định dạng là: "bộ giải mã fmt
[arg1 ... argN] ", và phải được bao quanh bởi dấu ngoặc kép. Nếu các đối số được đưa ra, thì
một trong số chúng phải chứa "% f", sẽ được thay thế bằng tên tệp đầu vào.
Ví dụ:

-i 'shn rút ngắn-2.3b'(sử dụng rút gọn chính thức-2.3b thay vì các phiên bản mới hơn; bỏ đi
đối số mặc định không bị ảnh hưởng)

-i 'shn rút ngắn -x -d 2048 %f -'(buộc rút ngắn để bỏ qua 2048 byte đầu tiên của
mỗi tệp)

-q Ngắt đầu ra không quan trọng (chế độ yên tĩnh). Đầu ra thường chuyển đến stderr
sẽ không được hiển thị, ngoài các lỗi hoặc thông tin gỡ lỗi (nếu được chỉ định).

-r val Sắp xếp lại các tệp đầu vào? val là một trong những: {xin, ascii, tự nhiên, không ai}. Mặc định là
tự nhiên.

-v Hiển thị thông tin phiên bản

-w Cảnh báo loại bỏ

-- Cho biết rằng mọi thứ theo sau nó là một tên tệp

Đầu ra chế độ
Ngoài ra, bất kỳ chế độ nào tạo tệp đầu ra đều hỗ trợ các tùy chọn sau:

-O val Ghi đè các tệp hiện có? val là một trong những: {xin, luôn luôn, không bao giờ}. Mặc định là
xin.

-a str Tiếp đầu ngữ str đến phần cơ sở của tên tệp đầu ra

-d dir Chỉ định thư mục đầu ra

-o str Chỉ định phần mở rộng định dạng tệp đầu ra, bộ mã hóa và / hoặc các đối số. Định dạng là: "fmt
[ext = abc] [encoder [arg1 ... argN (% f = filename)]] ", và phải được bao quanh bởi
dấu ngoặc kép. Nếu các đối số được đưa ra, thì một trong số chúng phải chứa "% f", sẽ là
được thay thế bằng tên tệp đầu ra. Ví dụ:

-o 'shn rút ngắn -V2 - %f'(tạo tệp rút gọn mà không cần tìm bảng)

-o 'flac làm tróc sơn - %f'(sử dụng bộ mã hóa flac thay thế)

-o 'oof ext = aif'(ghi đè phần mở rộng aiff mặc định của' aiff 'bằng' aif ')

-o 'người trông coi ext = mp3 què --Yên lặng - %f'(tạo tệp mp3 bằng lame)

-z str sửa bài str đến phần cơ sở của tên tệp đầu ra

CHẾ ĐỘ ‐ CỤ THỂ LỰA CHỌN

len chế độ lựa chọn
-U đơn vị
Chỉ định đơn vị mà các tổng số sẽ được in. đơn vị là một trong những: {b, kb,
mb, gb, tb}. Mặc định là b.

-c Không hiển thị tên cột

-t Không hiển thị dòng tổng

-u đơn vị
Chỉ định đơn vị mà mỗi tệp sẽ được in. đơn vị là một trong những: {b, kb, mb,
gb, tb}. Mặc định là b.

len chế độ đầu ra

Đầu ra của chế độ len thoạt đầu có vẻ khó hiểu, vì nó cố gắng truyền tải một
nhiều thông tin chỉ trong một ít không gian. Nhưng nó khá dễ đọc
một khi bạn biết những gì các cột đại diện; và trong các cột nhất định, mỗi cột
ký tự trong cột có nghĩa là. Mỗi cột được giải thích bên dưới.

chiều dài Hiển thị độ dài của dữ liệu WAVE, ở định dạng m: ss.nnn (mili giây). Nếu
dữ liệu là chất lượng CD, sau đó m: ss.ff được hiển thị thay thế, trong đó ff là một số từ
00 đến 74 gần đúng nhất với số khung hình (khối 2352 ‐ byte)
còn lại sau m: ss. Nếu tất cả các tệp đều có chất lượng CD, tổng độ dài sẽ là
được hiển thị ở định dạng m: ss.ff; nếu không nó sẽ ở định dạng m: ss.nnn. LƯU Ý: CD‐
tập tin chất lượng được làm tròn đến khung gần nhất; tất cả các tệp khác được làm tròn
chính xác đến phần nghìn giây.

mở rộng kích thước
Hiển thị tổng kích thước của tất cả các phần WAVE trong tệp (tiêu đề, dữ liệu và
bất kỳ phần RIFF bổ sung nào). Về cơ bản, đây là kích thước mà tệp sẽ là
nếu nó được chuyển đổi sang định dạng .wav, ví dụ: với dụng cụ nhỏ chuyển đổi.

LƯU Ý: Không dựa vào trường này cho kích thước âm thanh! Nếu bạn chỉ muốn biết
có bao nhiêu byte âm thanh trong một tệp, hãy chạy nó qua Thông tin và nhìn vào
trường "kích thước dữ liệu" trong đầu ra của nó.

cdr Hiển thị các thuộc tính liên quan đến tệp chất lượng CD. A 'c' trong ô đầu tiên
cho biết rằng dữ liệu WAVE không phải là chất lượng [C] D ‐. A 'b' ở vị trí thứ hai
cho biết rằng dữ liệu WAVE chất lượng của CD không bị cắt trên một cung [b] dư thừa.
Một 's' trong khe thứ ba cho biết rằng dữ liệu WAVE chất lượng của CD quá
[s] hort bị đốt cháy.

Dấu '-' trong bất kỳ vị trí nào trong số này cho biết rằng thuộc tính cụ thể là OK hoặc
thông thường. Dấu 'x' trong bất kỳ vị trí nào trong số này chỉ ra rằng thuộc tính cụ thể
không áp dụng cho tệp này, hoặc không thể xác định được.

LÀN SÓNG Hiển thị các thuộc tính của dữ liệu WAVE. Chữ 'h' ở vị trí đầu tiên cho biết rằng
WAVE [h] eader không phải là trình chuẩn. Một chữ 'e' ở vị trí thứ hai cho biết
rằng tệp WAVE chứa các khối [e] xtra RIFF.

Dấu '-' trong bất kỳ vị trí nào trong số này cho biết rằng thuộc tính cụ thể là OK hoặc
thông thường. Dấu 'x' trong bất kỳ vị trí nào trong số này chỉ ra rằng thuộc tính cụ thể
không áp dụng cho tệp này, hoặc không thể xác định được.

vấn đề
Hiển thị các sự cố được phát hiện với tiêu đề WAVE, dữ liệu WAVE hoặc chính tệp.
Dấu '3' trong vị trí đầu tiên chỉ ra rằng tệp chứa tiêu đề ID [3] v2.
Dấu 'a' trong vị trí thứ hai cho biết rằng dữ liệu âm thanh không
block‐ [a] ligned. Chữ 'i' trong vị trí thứ ba cho biết rằng tiêu đề WAVE là
[i] không nhất quán về kích thước dữ liệu và / hoặc kích thước tệp. A 't' ở ô thứ tư
cho biết rằng tệp WAVE dường như [t] runcated. A 'j' ở phần thứ năm
vị trí cho biết rằng tệp WAVE dường như không được nối [j] vào nó.

Dấu '-' trong bất kỳ vị trí nào trong số này cho biết rằng vấn đề cụ thể không phải là
được phát hiện. Dấu 'x' trong bất kỳ vị trí nào trong số này cho biết rằng
vấn đề không áp dụng cho tệp này, hoặc không thể xác định được.

fmt Hiển thị định dạng tệp nào đã xử lý tệp này.

tỉ lệ Hiển thị tỷ lệ nén cho tệp này.

tên tập tin
Hiển thị tên của tệp đang được kiểm tra.

sửa chữa chế độ lựa chọn
LƯU Ý: tên tệp cho các tệp được tạo trong sửa chữa chế độ sẽ dựa trên tên tệp đầu vào với
chuỗi '-fixed' được thêm vào nó và phần mở rộng sẽ là phần mở rộng mặc định của
định dạng tệp đầu ra. Ví dụ: với định dạng tệp đầu ra là shn tệp 'foo.wav'
sẽ trở thành 'foo-fixed.shn'. Điều này có thể được ghi đè với -a và / hoặc -z tùy chọn toàn cầu
miêu tả trên.

-b Đường thay đổi ngắt lùi về ranh giới khu vực trước đó. Đây là mặc định.

-c Kiểm tra xem có cần sửa chữa hay không mà không thực sự sửa bất cứ thứ gì. dụng cụ nhỏ sẽ
thoát với trạng thái 0 nếu cần sửa chữa và trạng thái 1 nếu không. Điều này có thể hữu ích
trong tập lệnh shell, ví dụ: "if shntool fix -c *; then shntool fix *; else ...; fi"

-f Đường chuyển dịch ngắt về phía trước đến ranh giới khu vực tiếp theo.

-k Chỉ định rằng tất cả các tệp phải được xử lý, ngay cả khi một số tệp đầu tiên
sẽ không bị thay đổi, ngoài việc thay đổi định dạng tệp có thể xảy ra. Mặc định là
bỏ qua N tệp đầu tiên sẽ không bị thay đổi từ góc độ dữ liệu WAVE trong
để tránh những công việc không cần thiết.

-n Chỉ định rằng tệp cuối cùng được tạo không nên được đệm bằng dấu lặng để làm cho nó
Kích thước dữ liệu WAVE là bội số của 2352 byte. Mặc định là đệm tệp cuối cùng.

-u Đường tròn ngắt đến ranh giới khu vực gần nhất.

băm chế độ lựa chọn
-c Chỉ định rằng phải tạo tệp tham chiếu tổng hợp cho tất cả các tệp đầu vào,
thay vì mặc định là một dấu vân tay cho mỗi tệp. Dấu vân tay tổng hợp là
chỉ đơn giản là dấu vân tay của dữ liệu WAVE từ tất cả các tệp đầu vào được lấy toàn bộ trong
thứ tự đã cho và giống với thứ tự sẽ được tạo từ
tệp đã nối nếu các tệp giống nhau được nối thành một tệp lớn, không có phần đệm
thêm. Tùy chọn này có thể được sử dụng để tập hợp tệp vân tay hoặc để xác định nhóm tệp
trong đó các ngắt bản nhạc đã được di chuyển xung quanh, nhưng không có âm thanh nào được sửa đổi trong bất kỳ
cách (ví dụ: không thêm phần đệm, không thực hiện lấy mẫu lại, v.v.).

-m Tạo dấu vân tay MD5. Đây là mặc định.

-s Tạo dấu vân tay SHA1.

tập giấy chế độ lựa chọn
LƯU Ý: tên tệp cho các tệp được tạo trong tập giấy chế độ sẽ dựa trên tên tệp đầu vào với
chuỗi '-prepadded' hoặc '-postpadded' được thêm vào nó và phần mở rộng sẽ là
phần mở rộng mặc định của định dạng tệp đầu ra. Ví dụ: với định dạng tệp đầu ra là
shn và phần đệm trước được chỉ định trên dòng lệnh, tệp 'foo.wav' sẽ trở thành
'foo-prepadded.shn'. Điều này có thể được ghi đè với -a và / hoặc -z tùy chọn toàn cầu
miêu tả trên.

Lưu ý rằng một số bộ mã hóa định dạng đầu ra (ví dụ: flac, ape) tự động loại bỏ các tiêu đề
và / hoặc khối RIFF bổ sung.

-b Chỉ định rằng tệp được tạo phải được đệm ở đầu bằng dấu lặng để
làm cho kích thước dữ liệu WAVE của nó là bội số của 2352 byte.

-e Chỉ định rằng tệp được tạo nên được đệm ở cuối bằng dấu lặng để tạo
kích thước dữ liệu WAVE của nó là bội số của 2352 byte. Đây là hành động mặc định.

tham gia chế độ lựa chọn
LƯU Ý: tên tệp cho các tệp được tạo trong tham gia chế độ sẽ có tiền tố là 'đã tham gia.', và
phần mở rộng sẽ là phần mở rộng mặc định của định dạng tệp đầu ra. Ví dụ, với một
định dạng tệp đầu ra của wav các tập tin 'files * .wav' sẽ trở thành 'join.wav'. Điều này có thể là
ghi đè với -a và / hoặc -z các tùy chọn toàn cầu được mô tả ở trên.

-b Chỉ định rằng tệp được tạo phải được đệm ở đầu bằng dấu lặng để
làm cho kích thước dữ liệu WAVE của nó là bội số của 2352 byte. Lưu ý rằng tùy chọn này không
áp dụng nếu tệp đầu vào không phải là chất lượng CD, vì phần đệm không được xác định trong đó
trường hợp.

-e Chỉ định rằng tệp được tạo nên được đệm ở cuối bằng dấu lặng để tạo
kích thước dữ liệu WAVE của nó là bội số của 2352 byte. Đây là hành động mặc định. Ghi chú
rằng tùy chọn này không áp dụng nếu tệp đầu vào không phải là chất lượng CD, vì
padding là không xác định trong trường hợp đó.

-n Chỉ định rằng tệp được tạo không được đệm bằng dấu lặng để tạo thành SÓNG
kích thước dữ liệu là bội số của 2352 byte. Lưu ý rằng tùy chọn này không áp dụng nếu
các tệp đầu vào không phải là chất lượng CD, vì phần đệm không được xác định trong trường hợp đó.

chia chế độ lựa chọn
LƯU Ý: tên tệp cho các tệp được tạo trong chia chế độ có dạng prefixNNN.ext, trong đó NNN
là số tệp đầu ra và 'ext' là phần mở rộng mặc định của định dạng tệp đầu ra.
Nếu định dạng tệp đầu ra của 'wav' được sử dụng và tiền tố không bị thay đổi thông qua -n chuyển đổi
được mô tả bên dưới, thì tên tệp đầu ra sẽ là "split-track01.wav",
"split-track02.wav", v.v. Điều này có thể được ghi đè bằng -a và / hoặc -z tùy chọn toàn cầu
miêu tả trên.

Để biết thông tin về việc chỉ định các điểm phân tách, hãy xem Chỉ định chia điểm phần bên dưới.

-c num Chỉ định số bắt đầu đếm khi đặt tên tệp đầu ra. Mặc định
là 1.

-e len Tiền tố mỗi bản nhạc bằng len lượng chì ‐ vào được lấy từ bản nhạc trước. len
phải được cung cấp ở định dạng byte, m: ss, m: ss.ff hoặc m: ss.nnn.

-f hồ sơ
Chỉ định một tệp để đọc dữ liệu điểm phân tách. Nếu không cho, thì chia
điểm được đọc từ thiết bị đầu cuối.

-l len Chỉ định rằng tệp đầu vào nên được chia thành các tệp nhỏ hơn dựa trên bội số
của len Khoảng thời gian. len phải được cung cấp theo byte, m: ss, m: ss.ff hoặc m: ss.nnn
định dạng.

-m str Chỉ định một chuỗi thao tác ký tự cho tên tệp được tạo từ trang tính CUE.
Các ký tự này, được lấy từng ký tự một, đại diện cho việc dịch từ / sang ký tự. Họ
phải luôn luôn theo cặp. Vài ví dụ:

:- Dịch tất cả các bản sao của ':' sang '-'

: - / - Dịch cả ':' và '/' thành '-'

:-/_*NS Dịch ':' thành '-', '/' thành '_' và '*' thành 'x'

-n fmt Chỉ định định dạng đầu ra số lượng tệp. Giá trị mặc định là% 02d, cho hai chữ số ‐
số không ‐ đệm (01, 02, 03, ...).

-t fmt Đặt tên tệp đầu ra ở định dạng do người dùng chỉ định dựa trên các trường trang tính CUE. Các
các chuỗi định dạng sau được nhận dạng:

%p Performer

%a Album

%t Theo dõi tiêu đề

%n Theo dõi số

-u len Đăng sửa từng bản nhạc với len lượng chì được lấy ra từ bản nhạc tiếp theo. len phải
được cho ở định dạng byte, m: ss, m: ss.ff hoặc m: ss.nnn.

-x
Chỉ trích xuất các bản nhạc trong (được phân tách bằng dấu phẩy, có thể chứa phạm vi). Các ví dụ
bao gồm:

7 Chỉ trích xuất bản nhạc 7

3-5 Chỉ trích xuất các bản nhạc từ 3 đến 5

2-6,9,11-13
Chỉ trích xuất các bản nhạc từ 2 đến 6, 9 và 11 đến 13

Chỉ định chia điểm
Các điểm phân chia chỉ cần đánh dấu các vị trí trong dữ liệu WAVE của tệp đầu vào nơi theo dõi
sẽ được tách ra. Chúng có thể được chỉ định trong bất kỳ sự kết hợp nào của các định dạng sau:

byte trong đó byte là một phần bù byte cụ thể

m: ss trong đó m = phút và ss = giây

m: ss.ff
trong đó m = phút, ss = giây và ff = khung hình (75 mỗi giây, do đó, phạm vi ff
từ 00 đến 74)

m: ss.nnn
trong đó m = phút, ss = giây và nnn = mili giây (sẽ được làm tròn thành
ranh giới ngành gần nhất hoặc ranh giới ngành đầu tiên nếu ranh giới gần nhất
tình cờ là phần đầu của tệp)

GỢI Ý tấm
- một trang tính CUE đơn giản, trong đó mỗi dòng "INDEX 01 m: ss: ff" được chuyển đổi thành
am: ss.ff điểm chia

Các điểm phân tách phải được đưa ra theo thứ tự tăng dần và phải xuất hiện một điểm trên mỗi dòng. Nếu như
độ lệch byte được tính từ điểm tách cuối cùng bằng WAVE của tệp đầu vào
kích thước dữ liệu, sau đó nó bị bỏ qua. Vì các điểm phân tách chỉ định các vị trí trong
tệp đầu vào nơi các bản nhạc sẽ được chia, N điểm tách sẽ tạo ra N + 1 tệp đầu ra.
Tất cả các định dạng m: ss sẽ tạo ra sự phân chia trên ranh giới khu vực bất cứ khi nào tệp đầu vào
CD ‐ chất lượng; để buộc phân chia không căn chỉnh theo ngành, hãy sử dụng định dạng byte chính xác.

làm sao chế độ lựa chọn
-c Chỉ định rằng các khối RIFF bổ sung sẽ được loại bỏ khỏi đầu ra. Mặc định
là viết thêm các đoạn RIFF.

-d Chỉ định rằng dữ liệu SÓNG sẽ được loại bỏ khỏi đầu ra. Mặc định là
để ghi dữ liệu.

-e Chỉ định rằng tiêu đề WAVE nên được loại bỏ khỏi đầu ra. Mặc định
là viết tiêu đề.

-n Chỉ định rằng byte đệm NULL ở cuối các khối dữ liệu có kích thước lẻ phải là
bị chặn khỏi đầu ra, nếu có. Mặc định là ghi byte đệm NULL.
Tùy chọn này chỉ áp dụng khi dữ liệu WAVE cũng được ghi, nếu không, nó sẽ bị bỏ qua.

CMP chế độ lựa chọn
-c giây
Đặt số giây âm thanh để sử dụng cho bộ đệm so sánh dịch chuyển byte.
Tùy chọn này chỉ có ý nghĩa với -s Lựa chọn. Mặc định là 3 giây.

-f lông tơ
Đặt "hệ số mờ" để xác định xem dữ liệu được dịch chuyển theo byte có giống nhau hay không.
lông tơ là một số nguyên dương đại diện cho số byte tối đa cho phép
không khớp giữa hai tệp trong khu vực được tìm kiếm bởi -s Lựa chọn. Điều này
cho phép một người kiểm tra các byte khác nhau giữa các tệp (a) được dịch chuyển theo byte
và (b) có ít nhất một lỗi trong khu vực được tìm kiếm bởi -s Lựa chọn. Các
yếu tố lông tơ càng cao, thời gian tìm kiếm càng lâu, vì vậy hãy đặt nó ở mức thấp để bắt đầu (8
hoặc lâu hơn), và tăng nó theo từng bước nhỏ nếu cần. LƯU Ý: công tắc này chỉ có thể là
được sử dụng với -s công tắc điện.

-l Liệt kê các hiệu số và giá trị của tất cả các byte khác nhau. Đầu ra tương tự như 'cmp -l'; trong
đặc biệt, hiệu số dựa trên 1 ‐. Có thể được sử dụng với -s công tắc điện.

-s Kiểm tra xem dữ liệu WAVE có trong các tệp đầu vào có giống nhau không
modulo a byte ‐ shift. Hiện tại, điều này sẽ chỉ phát hiện sự khác biệt cho đến đầu tiên
529200 byte (bằng 3 giây của dữ liệu chất lượng CD). Điều này có thể được sử dụng để so sánh
SÓNG dữ liệu trong một tệp được ghi trước thành SÓNG dữ liệu trong bản nhạc tương ứng được trích xuất
từ đĩa CD đã ghi, rất hữu ích nếu bản nhạc được trích xuất từ ​​đĩa CD đã ghi TAO,
và do đó có thể có khoảng cách im lặng 2 giây ở đầu. Tùy chọn này có thể
cũng giúp xác định ổ ghi CD / đầu đọc CD kết hợp đọc / ghi bù đắp.

cây cơ bida chế độ lựa chọn
-c Chỉ định rằng một trang tính CUE đơn giản sẽ được xuất ra. Đây là hành động mặc định.
LƯU Ý: tất cả các tệp đầu vào phải có chất lượng CD để các trang CUE hợp lệ.

-s Chỉ định rằng các điểm phân tách ở định dạng offset byte rõ ràng sẽ được xuất ra.

chuyển đổi chế độ lựa chọn
LƯU Ý: tên tệp cho các tệp được tạo trong chuyển đổi chế độ sẽ được đặt tên dựa trên tệp đầu vào
Tên. Cụ thể, nếu tên tệp đầu vào kết thúc bằng phần mở rộng tệp mặc định cho
định dạng của tệp, sau đó phần mở rộng mặc định cho định dạng đầu ra mong muốn sẽ thay thế nó;
nếu không, nó sẽ được thêm vào nó. Ví dụ: đối với định dạng đầu ra của shn và wav
tệp đầu vào có tên là 'file.wav', tệp được chuyển đổi sẽ có tên là 'file.shn', vì '.wav' là
phần mở rộng mặc định cho wav định dạng. Mặt khác, trong cùng một tình huống
ở trên, nhưng với tệp đầu vào có tên 'file.wave', tệp được chuyển đổi sẽ được đặt tên
'file.wave.shn', vì '.wave' không khớp với '.wav'. Điều này có thể được ghi đè với -a
và / hoặc -z các tùy chọn toàn cầu được mô tả ở trên.

Lưu ý rằng một số bộ mã hóa định dạng đầu ra (ví dụ: flac, ape) tự động loại bỏ các tiêu đề
và / hoặc các phần RIFF bổ sung, trong khi những phần khác (ví dụ: sox) có thể điều chỉnh kích thước dữ liệu WAVE hiếm gặp
các phiên bản để căn chỉnh âm thanh trên một ranh giới khối.

-t Đọc dữ liệu WAVE từ thiết bị đầu cuối.

Thông tin chế độ lựa chọn
Chế độ này không hỗ trợ bất kỳ tùy chọn bổ sung nào.

dải chế độ lựa chọn
LƯU Ý: tên tệp cho các tệp được tạo trong dải chế độ sẽ dựa trên tên tệp đầu vào với
chuỗi '-stripped' được thêm vào nó và phần mở rộng sẽ là phần mở rộng mặc định của
định dạng tệp đầu ra. Ví dụ: với định dạng tệp đầu ra là wav tệp 'bar.shn'
sẽ trở thành 'bar-stripe.wav'. Điều này có thể được ghi đè với -a và / hoặc -z toàn cầu
các tùy chọn được mô tả ở trên.

Lưu ý rằng một số bộ mã hóa định dạng đầu ra (ví dụ: flac, ape) tự động loại bỏ các tiêu đề
và / hoặc các phần RIFF bổ sung, trong khi những phần khác (ví dụ: sox) có thể điều chỉnh kích thước dữ liệu WAVE hiếm gặp
các phiên bản để căn chỉnh âm thanh trên một ranh giới khối.

-c Chỉ định rằng không được loại bỏ các phần RIFF thừa. Mặc định là loại bỏ
mọi thứ xuất hiện sau đoạn dữ liệu đầu tiên.

-e Chỉ định rằng tiêu đề WAVE không nên được đặt thành chuẩn. Mặc định là
chuẩn hóa tiêu đề.

gen chế độ lựa chọn
LƯU Ý: tên tệp cho các tệp được tạo trong gen chế độ sẽ có tiền tố là 'im lặng.' và
phần mở rộng sẽ là phần mở rộng mặc định của định dạng tệp đầu ra. Ví dụ, với một
định dạng tệp đầu ra của wav tệp được tạo sẽ trở thành 'im lặng.wav'. Điều này có thể là
ghi đè với -a và / hoặc -z các tùy chọn toàn cầu được mô tả ở trên.

-l len Tạo tệp chứa len lượng im lặng. len phải được cho bằng byte, m: ss,
định dạng m: ss.ff hoặc m: ss.nnn.

tỉa chế độ lựa chọn
LƯU Ý: tên tệp cho các tệp được tạo trong tỉa chế độ sẽ dựa trên tên tệp đầu vào với
chuỗi '-trimmed' được thêm vào nó và phần mở rộng sẽ là phần mở rộng mặc định của
định dạng tệp đầu ra. Ví dụ: với định dạng tệp đầu ra là shn tệp 'foo.wav'
sẽ trở thành 'foo-trimmed.shn'. Điều này có thể được ghi đè với -a và / hoặc -z toàn cầu
các tùy chọn được mô tả ở trên.

-b Chỉ cắt bỏ khoảng lặng từ đầu tệp

-e Chỉ cắt bỏ khoảng lặng ở cuối tệp

MÔI TRƯỜNG BIẾN

ST_DEBUG
Nếu được đặt, shntool sẽ in thông tin gỡ lỗi. Điều này tương tự với -D
tùy chọn toàn cầu, ngoại trừ việc gỡ lỗi được bật ngay lập tức, thay vì
khi dòng lệnh được phân tích cú pháp.

NS_ _THÁNG MƯỜI HAI
Chỉ định bộ giải mã định dạng tệp đầu vào và / hoặc các đối số. Thay thế với
định dạng bạn muốn sửa đổi, ví dụ: ST_SHN_DEC. Định dạng của biến này là
khó chịu với -i tùy chọn toàn cầu, ngoại trừ định dạng ban đầu không được bao gồm.
Ví dụ:

ST_SHN_DEC='rút ngắn-2.3b'

ST_SHN_DEC='rút ngắn -x -d 2048 %f -'

NS_ _ENC
Chỉ định phần mở rộng định dạng tệp đầu ra, bộ mã hóa và / hoặc các đối số. Thay thế
với định dạng bạn muốn sửa đổi, ví dụ: ST_SHN_ENC. Định dạng của biến này
là hậu môn với -o tùy chọn toàn cầu, ngoại trừ định dạng ban đầu không phải là
bao gồm. Ví dụ:

ST_SHN_ENC='rút ngắn -V2 - %f'

ST_FLAC_ENC='làm tróc sơn - %f'

ST_AIFF_ENC='ext = aif'

ST_CUST_ENC='ext = mp3 què --Yên lặng - %f'

Lưu ý rằng các tùy chọn dòng lệnh được ưu tiên hơn bất kỳ biến môi trường nào trong số này.

EXIT TÌNH TRẠNG

Nói chung, dụng cụ nhỏ sẽ thoát với trạng thái 0 khi thành công và trạng thái 1 nếu nó
gặp lỗi. Ngoại lệ duy nhất là khi tùy chọn 'thoát' được chọn từ bên trong
menu sắp xếp lại tệp tương tác, trong trường hợp đó, trạng thái tồn tại sẽ là 255.

GHI CHÚ

dụng cụ nhỏ là một từ viết sai, vì nó xử lý dữ liệu WAVE, không rút gọn dữ liệu. Tên là một
giữ lại từ những ngày đầu của nó là 'shnlen', một chương trình được tạo ra đặc biệt để trích xuất
thông tin về dữ liệu WAVE được lưu trữ trong các tệp .shn.

Bí danh cho dụng cụ nhỏ được bắt đầu bằng 'shn' thay vì 'wav' để tránh va chạm có thể xảy ra
với các chương trình hiện có.

Sử dụng shnpad trực tuyến bằng các dịch vụ onworks.net