.Dd November 2, 2014
.Dt SNDFILE-CONVERT 1
.Os
.Sh "نام (NAME)"
.Nm sndfile-convert
.Nd تبدیل فرمت‌های مختلف فایل‌های صوتی به یکدیگر با استفاده از libsndfile
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm sndfile-convert
.Op Fl override-sample-rate Ns = Ns Ar rate
.Op Fl endian Ns = Ns Cm little | big | cpu
.Op Fl normalize
.Op Ar encoding
.Ar input
.Ar output
.Sh "توضیحات (DESCRIPTION)"
.Nm
فایل‌های صوتی را از یک فرمت صوتی به فرمت دیگر تبدیل می‌کند.
اگر فایل خروجی از قبل وجود داشته باشد، بازنویسی می‌شود.
.Ss "فرمت‌ها (Formats)"
فرمت فایل خروجی بر اساس پسوند نام فایل تعیین می‌شود.
فرمت‌های فایلی زیر در حال حاضر پشتیبانی و شناخته می‌شوند:
.Pp
.Bl -tag -compact -width ircam
.It wav
WAV (مایکروسافت)
.It aif
AIFF (اپل/SGI)
.It au
AU (سان/NeXT)
.It snd
AU (سان/NeXT)
.It raw
RAW (بدون هدر)
.It gsm
RAW (بدون هدر)
.It vox
RAW (بدون هدر)
.It paf
PAF (سامانه Ensoniq PARIS، اندیان بزرگ)
.It fap
PAF (سامانه Ensoniq PARIS، اندیان کوچک)
.It svx
IFF (فرمت Amiga IFF/SVX8/SV16)
.It nist
SPHERE (فرمت NIST SPeech HEader Resources)
.It sph
SPHERE (فرمت NIST SPeech HEader Resources)
.It voc
VOC (محصول Creative Labs)
.It ircam
SF (فرمت Berkeley/IRCAM/CARL)
.It sf
SF (فرمت Berkeley/IRCAM/CARL)
.It w64
W64 (فرمت SoundFoundry WAVE 64)
.It mat
MAT4 (فرمت GNU Octave 2.0 / Matlab 4.2)
.It mat4
MAT4 (فرمت GNU Octave 2.0 / Matlab 4.2)
.It mat5
MAT5 (فرمت GNU Octave 2.1 / Matlab 5.0)
.It pvf
PVF (فرمت Portable Voice Format)
.It xi
XI (فرمت FastTracker 2)
.It htk
HTK (فرمت HMM Tool Kit)
.It sds
SDS (استاندارد Midi Sample Dump Standard)
.It avr
AVR (فرمت Audio Visual Research)
.It wavex
WAVEX (فرمت MS WAVE به همراه WAVEFORMATEX)
.It sd2
SD2 (فرمت Sound Designer II)
.It flac
FLAC (کدک صوتی بدون اتلاف FLAC)
.It caf
CAF (فایل Apple Core Audio)
.It wve
WVE (فرمت Psion Series 3)
.It prc
WVE (فرمت Psion Series 3)
.It ogg
OGG (فرمت ظرف OGG)
.It oga
OGG (فرمت ظرف OGG)
.It mpc
MPC (فرمت Akai MPC 2k)
.It rf64
RF64 (فرمت RIFF 64)
.El
.Ss "گزینه‌ها (Options)"
گزینه‌های زیر پشتیبانی می‌شوند:
.Pp
.Bl -tag -compact -width "override-sample-rate=XXXXX"
.It Fl override-sample-rate Ns = Ns Ar rate
تنظیم نرخ نمونه‌برداری ورودی به
.Ar rate
هرتز.
.It Fl endian Ns = Ns Cm little
تنظیم ترتیب بایت‌های فایل خروجی به صورت اندیان کوچک (little-endian).
.It Fl endian Ns = Ns Cm big
تنظیم ترتیب بایت‌های فایل خروجی به صورت اندیان بزرگ (big-endian).
.It Fl endian Ns = Ns Cm cpu
تنظیم ترتیب بایت‌های فایل خروجی مطابق با ترتیب بایت‌های پردازنده (CPU).
.It Fl normalize
نرمال‌سازی داده‌های صوتی در فایل خروجی.
.El
.Ss "کدگذاری‌ها (Encodings)"
پارامتر اختیاری
.Ar encoding
امکان تنظیم نحوه کدگذاری داده‌ها را برای فایل خروجی فراهم می‌کند.
کدگذاری‌های زیر در حال حاضر پشتیبانی می‌شوند:
.Pp
.Bl -tag -compact -width ima-adpcmXX
.It Fl pcms8
کدگذاری 8 بیتی علامت‌دار pcm
.It Fl pcmu8
کدگذاری 8 بیتی بدون علامت pcm
.It Fl pcm16
کدگذاری 16 بیتی pcm
.It Fl pcm24
کدگذاری 24 بیتی pcm
.It Fl pcm32
کدگذاری 32 بیتی pcm
.It Fl float32
ممیز شناور 32 بیتی
.It Fl ulaw
کدگذاری ULAW
.It Fl alaw
کدگذاری ALAW
.It Fl ima-adpcm
کدگذاری IMA ADPCM (فقط WAV)
.It Fl ms-adpcm
کدگذاری MS ADPCM (فقط WAV)
.It Fl gsm610
کدگذاری GSM6.10 (فقط WAV)
.It Fl dwvw12
کدگذاری 12 بیتی DWVW (فقط AIFF)
.It Fl dwvw16
کدگذاری 16 بیتی DWVW (فقط AIFF)
.It Fl dwvw24
کدگذاری 24 بیتی DWVW (فقط AIFF)
.It Fl vorbis
کدگذاری Vorbis (فقط OGG)
.El
.Pp
اگر هیچ کدگذاری برای فایل خروجی مشخص نشود،
.Nm
تلاش می‌کند از کدگذاری فایل ورودی استفاده کند.
این کار همیشه موفقیت‌آمیز نخواهد بود زیرا بیشتر فرمت‌های ظرف
(مانند WAV، AIFF و غیره) تنها از زیرمجموعه کوچکی از کدگذاری‌ها پشتیبانی می‌کنند
(مانند PCM شانزده بیتی، a-law، Vorbis و غیره).
.Sh "وضعیت خروج (EXIT STATUS)"
.Ex -std
.Sh "همچنین ببینید (SEE ALSO)"
.Lk http://libsndfile.github.io/libsndfile
.Sh "نویسندگان (AUTHORS)"
.An Erik de Castro Lopo Aq Mt erikd@mega-nerd.com .