.TH "rifftree" "1" "7 May 2014" "libgig 4.6.0" "libgig tools" .SH "نام (NAME)" rifftree \- چاپ ساختار درختی RIFF یک فایل دلخواه مبتنی بر RIFF. .SH "خلاصه دستور (SYNOPSIS)" .B rifftree [OPTIONS] FILE .SH "توضیحات (DESCRIPTION)" قالب مبادله فایل منابع (Resource Interchange File Format یا به اختصار RIFF) یک قالب فایل باینری ساده است که برای ساختارهای داده‌ای درخت‌گونه طراحی شده است. بسیاری از قالب‌های فایل اختصاصی بر پایه قالب RIFF ساخته شده‌اند (مانند قالب‌های فایل چندرسانه‌ای نظیر WAV، AVI، DLS و GIG). داده‌ها در یک فایل RIFF در بخش‌هایی موسوم به «تکه» یا چانک (chunk) کپسوله‌سازی می‌شوند. تکه‌های فهرستی (کانتینرها یا نگه‌دارنده‌ها) وجود دارند که می‌توان آن‌ها را گره‌های درخت داده در نظر گرفت و بنابراین می‌توانند دارای فرزند (تکه‌های فرعی یا subchunk) باشند، و تکه‌های داده معمولی وجود دارند که برگ‌های درخت داده محسوب می‌شوند و نمی‌توانند فرزند داشته باشند. تکه‌های معمولی (برگ‌های درخت) حاوی داده‌های واقعی ذخیره‌شده هستند. تکه‌های فهرستی (گره‌ها/کانتینرها) به خودی خود حاوی هیچ داده‌ای نیستند. .PP هر تکه فهرستی و تکه معمولی دارای یک شناسه (ID) ۳۲ بیتی (غیرمنحصربه‌فرد) است که معمولاً یک متن اسکی (ASCII) ۴ کاراکتری خوانا برای انسان است و هدف لیست یا تکه مربوطه را نشان می‌دهد. این برنامه این شناسه را برای هر تکه پیدا شده چاپ می‌کند. مزیت شناسه‌های خوانای تکه‌ها/فهرست‌ها این است که فایل‌های مبتنی بر این روش را می‌توان به راحتی به‌صورت دستی با یک ویرایشگر هگز (hex editor) تحلیل و بررسی کرد. .PP یک فایل معمولی RIFF همیشه با یک تکه فهرستی (با شناسه تکه "RIFF" یا "RIFX") شروع می‌شود که حاوی تمام تکه‌های دیگر است. در یک فایل معمولی RIFF هیچ تکه دیگری خارج از محدوده آن تکه نخست وجود ندارد. با این حال می‌توانید با آرگومان‌هایی که در زیر شرح داده شده است (به آرگومان .B \-\-flat مراجعه کنید) این انتظار را نادیده بگیرید تا بتوانید فایل‌های مشابه RIFF را باز کنید. .SH "گزینه‌ها (OPTIONS)" .TP .B FILE نام فایل مبتنی بر RIFF. .TP .B \-v نمایش نسخه و خروج. .TP .B \-s چاپ اندازه هر تکه (chunk) RIFF. .TP .B \-\-flat نخستین تکه فایل یک تکه فهرستی (کانتینر) نیست. اگر فایل یک فایل RIFF «واقعی» نباشد، ممکن است بخواهید از این گزینه استفاده کنید. یک فایل RIFF «واقعی» همیشه دارای یک تکه فهرستی (کانتینر) RIFF به عنوان اولین تکه در فایل است و انتظار دارد تمام تکه‌های دیگر درون آن تکه نخست قرار گیرند. بنابراین در یک فایل RIFF «واقعی»، هیچ تکه دیگری خارج از محدوده (یعنی پس از پایان) تکه اول فایل وجود ندارد. با این حال، بسیاری از قالب‌های فایل ابتدایی، دنباله‌ای مسطح از تکه‌های داده معمولی هستند (نه تکه‌های فهرستی/کانتینر). اگر از این گزینه استفاده می‌کنید، باید گزینه .B \-\-first\-chunk\-id را نیز به کار ببرید. .TP .B \-\-first\-chunk\-id CKID در حال حاضر فقط در ترکیب با گزینه .B \-\-flat استفاده می‌شود. CKID باید شناسه ۳۲ بیتی اولین تکه در فایل باشد. اگر اولین تکه در فایل دارای شناسه تکه داده‌شده نباشد، این برنامه متوقف می‌شود. این کار تضمین می‌کند که فایل واقعاً همان قالبی است که انتظار داشتید. آرگومان مورد انتظار در اینجا باید یک متن اسکی (ASCII) چهارکاراکتری خوانا باشد، زیرا شناسه‌های تکه RIFF معمولاً رشته‌های اسکی خوانا هستند. .TP .B \-\-big\-endian فایل در قالب اندیان بزرگ (Big-Endian) است. در حال حاضر فقط در ترکیب با گزینه .B \-\-flat استفاده می‌شود. بدون .B \-\-flat نوع اندیان به‌طور خودکار شناسایی می‌شود. اگر از .B \-\-flat استفاده کنید و نه .B \-\-big\-endian و نه .B \-\-little\-endian را مشخص نکنید، نوع اندیان بومی دستگاه شما به عنوان پیش‌فرض استفاده خواهد شد. .TP .B \-\-little\-endian فایل در قالب اندیان کوچک (Little-Endian) است. در حال حاضر فقط در ترکیب با گزینه .B \-\-flat استفاده می‌شود. بدون .B \-\-flat نوع اندیان به‌طور خودکار شناسایی می‌شود. اگر از .B \-\-flat استفاده کنید و نه .B \-\-big\-endian و نه .B \-\-little\-endian را مشخص نکنید، نوع اندیان بومی دستگاه شما به عنوان پیش‌فرض استفاده خواهد شد. .SH "مثال‌ها (EXAMPLES)" نمایش ساختار فایل یک فایل استاندارد RIFF (در مثال زیر یک فایل Gigasampler/GigaStudio) و نمایش اندازه دقیق هر تکه در فایل: .PP .nf .RS rifftree \-s piano.gig .RE .fi .PP انجام همین کار برای یک فایل صوتی Korg Trinity/Triton/OASYS/Kronos (که یک فایل استاندارد RIFF نیست، بلکه فایلی شبیه به RIFF است): .PP .nf .RS rifftree \-s \-\-flat \-\-first\-chunk\-id MSP1 \-\-big\-endian PIANO_000.KMP .RE .fi .PP .SH "همچنین ببینید (SEE ALSO)" .BR dlsdump (1), .BR gigdump (1), .BR korgdump (1) .SH "اشکالات (BUGS)" بررسی و گزارش باگ‌ها در: .SH "نویسنده (AUTHOR)" برنامه و صفحه راهنما توسط Christian Schoenebeck نوشته شده است.