.Dd November 2, 2014
.Dt SNDFILE-METADATA-GET 1
.Os
.Sh "نام (NAME)"
.Nm sndfile-metadata-get ,
.Nm sndfile-metadata-set
.Nd دریافت یا تنظیم متاداده در یک فایل صوتی
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm sndfile-metadata-get
.Op Ar گزینه‌ها
.Ar فایل
.Nm sndfile-metadata-set
.Op Ar گزینه‌ها
.Ar فایل
.Nm sndfile-metadata-set
.Op Ar گزینه‌ها
.Ar ورودی
.Ar خروجی
.Sh "توضیحات (DESCRIPTION)"
.Nm sndfile-metadata-get
متاداده‌های bext و رشته‌ایِ ذخیره‌شده در یک فایل صوتی را نمایش می‌دهد.
گزینه‌های زیر مواردی را که باید چاپ شوند مشخص می‌کنند.
.Pp
.Bl -tag -width bext-descriptionXXXX -compact
.It Fl -all
تمام متاداده‌ها
.It Fl -bext-description
توضیحات
.It Fl -bext-originator
اطلاعات ایجادکننده
.It Fl -bext-orig-ref
مرجع ایجادکننده
.It Fl -bext-umid
شناسه یکتای محتوا (UMID)
.It Fl -bext-orig-date
تاریخ ایجاد
.It Fl -bext-orig-time
زمان ایجاد
.It Fl -bext-coding-hist
تاریخچه کدگذاری
.It Fl -str-title
عنوان
.It Fl -str-copyright
حق نشر (کپی‌رایت)
.It Fl -str-artist
هنرمند
.It Fl -str-comment
یادداشت
.It Fl -str-date
تاریخ ساخت
.It Fl -str-album
آلبوم
.It Fl -str-license
مجوز
.El
.Pp
.Nm sndfile-metadata-set
در صورتی که قالب فایل پشتیبانی کند، متاداده‌های bext و رشته‌ای را در یک فایل صوتی تنظیم می‌کند.
اگر فایل شامل یک قطعه (chunk) BEXT برای تغییر نباشد،
باید از حالت دوم خلاصه دستور استفاده شود که در آن، فایل خروجی دیگری
با قابلیت ذخیره متاداده ایجاد می‌شود.
این فایل در صورتی که از قبل وجود داشته باشد، رونویسی می‌شود.
گزینه‌های زیر آرگومانی را برای تعیین متاداده دریافت می‌کنند:
.Pp
.Bl -tag -width bext-coding-histXXXXXXX -compact
.It Fl -bext-description
توضیحات
.It Fl -bext-originator
ایجادکننده
.It Fl -bext-orig-ref
مرجع ایجادکننده
.It Fl -bext-umid
شناسه یکتای محتوا (UMID)
.It Fl -bext-orig-date
تاریخ ایجاد
.It Fl -bext-orig-time
زمان ایجاد
.It Fl -bext-coding-hist
تاریخچه کدگذاری
.It Fl -bext-time-raf
مرجع زمانی
.It Fl -str-comment
یادداشت
.It Fl -str-title
عنوان
.It Fl -str-copyright
حق نشر (کپی‌رایت)
.It Fl -str-artist
هنرمند
.It Fl -str-date
تاریخ
.It Fl -str-album
آلبوم
.It Fl -str-license
مجوز
.El
.Pp
گزینه‌های زیر هیچ آرگومانی دریافت نمی‌کنند:
.Pp
.Bl -tag -width bext-coding-histXXXXXXX -compact
.It Fl -bext-auto-time-date
تنظیم زمان و تاریخ BEXT به مقدار فعلی.
.It Fl -bext-auto-time
تنظیم زمان BEXT به مقدار فعلی.
.It Fl -bext-auto-date
تنظیم تاریخ BEXT به مقدار فعلی.
.It Fl -str-auto-date
تنظیم تاریخ رشته‌ای به مقدار فعلی.
.El
.Sh "وضعیت خروج (EXIT STATUS)"
.Ex -std
.Sh "همچنین ببینید (SEE ALSO)"
.Lk http://libsndfile.github.io/libsndfile
.Lk http://tech.ebu.ch/docs/tech/tech3285.pdf
.Sh "نویسندگان (AUTHORS)"
.An Erik de Castro Lopo Aq Mt erikd@mega-nerd.com