.Dd November 2, 2014
.Dt SNDFILE-METADATA-SET 1
.Os
.Sh "نام (NAME)"
.Nm sndfile-metadata-get ,
.Nm sndfile-metadata-set
.Nd افزودن یا ویرایش متادیتا در فایل‌های صوتی با libsndfile
.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 را در فایل صوتی تنظیم می‌کند.
اگر فایل حاوی چانک 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