WEBPMUX(1)                  General Commands Manual                 WEBPMUX(1)

نام (NAME)
       webpmux - ساخت پرونده‌های متحرک WebP از تصاویر ثابت، استخراج فریم‌ها، و
       مدیریت فراداده‌های XMP/EXIF و نمایه ICC

خلاصه دستور (SYNOPSIS)
       webpmux -get GET_OPTIONS INPUT -o OUTPUT
       webpmux -set SET_OPTIONS INPUT -o OUTPUT
       webpmux -strip STRIP_OPTIONS INPUT -o OUTPUT
       webpmux -frame FRAME_OPTIONS [ -frame ... ] [ -loop LOOP_COUNT ]
               [ -bgcolor BACKGROUND_COLOR ] -o OUTPUT
       webpmux -duration DURATION OPTIONS [ -duration ... ] INPUT -o OUTPUT
       webpmux -info INPUT
       webpmux [-h|-help]
       webpmux -version
       webpmux argument_file_name

توضیحات (DESCRIPTION)
       این صفحه راهنما، دستور webpmux را مستند می‌کند.

       دستور webpmux می‌تواند برای ساخت یا استخراج از پرونده‌های متحرک WebP و
       همچنین افزودن، استخراج یا حذف فراداده‌های XMP/EXIF و نمایه ICC استفاده
       شود.  اگر یک نام پرونده منفرد (که با نویسه «-» شروع نمی‌شود) به عنوان
       آرگومان داده شود، آرگومان‌های خط فرمان در واقع از این پرونده توکنایز
       (خوانده) می‌شوند.  این ویژگی امکان اسکریپت‌نویسی آسان یا استفاده از تعداد
       زیادی آرگومان را فراهم می‌کند.

گزینه‌ها (OPTIONS)
   GET_OPTIONS (-get):
       icc    دریافت نمایه ICC.

       exif   دریافت فراداده EXIF.

       xmp    دریافت فراداده XMP.

       frame n
              دریافت فریم nام از یک تصویر متحرک (مقدار n = 0 معنای ویژه‌ای
              دارد: آخرین فریم).


   SET_OPTIONS (-set)
       loop loop_count
              تنظیم تعداد تکرار چرخه در یک پرونده متحرک.

       که در آن: loop_count باید در بازه [0, 65535] باشد.

       bgcolor A,R,G,B
              تنظیم رنگ پس‌زمینه بوم در یک پرونده متحرک.

       که در آن: 'A'، 'R'، 'G' و 'B' اعداد صحیحی در بازه 0 تا 255 هستند که به
       ترتیب مقادیر مؤلفه‌های آلفا (شفافیت)، قرمز، سبز و آبی را مشخص می‌کنند.

       icc file.icc
              تنظیم نمایه ICC.

       که در آن: 'file.icc' حاوی نمایه ICC مورد نظر برای تنظیم است.

       exif file.exif
              تنظیم فراداده EXIF.

       که در آن: 'file.exif' حاوی فراداده EXIF مورد نظر برای تنظیم است.

       xmp file.xmp
              تنظیم فراداده XMP.

       که در آن: 'file.xmp' حاوی فراداده XMP مورد نظر برای تنظیم است.


   STRIP_OPTIONS (-strip)
       icc    حذف نمایه ICC.

       exif   حذف فراداده EXIF.

       xmp    حذف فراداده XMP.


   DURATION_OPTIONS (-duration)
       تغییر مدت زمان نمایش یک بازه مشخص از فریم‌ها. این گزینه فقط بر روی
       پرونده‌های متحرک WebP اثر دارد و بر روی پرونده‌های تک‌فریم بی‌اثر است.

       duration[,start[,end]]
              که در آن:
              duration مدت زمان بازه بر حسب میلی‌ثانیه است (اجباری).  باید
              مقداری غیرمنفی باشد.
              start شاخص فریم شروع بازه است (اختیاری).
              end شاخص فریم پایان بازه (شامل خود آن) است (اختیاری).

       سه کاربرد متداول این گزینه عبارتند از:
              -duration d
                   تنظیم مدت زمان برابر با 'd' برای کل پویانمایی.
              -duration d,f
                   تنظیم مدت زمان فریم 'f' برابر با 'd'.
              -duration d,start,end
                   تنظیم مدت زمان برابر با 'd' برای کل بازه [start,end].

       توجه داشته باشید که فریم‌های خارج از بازه [start, end] دست‌نخورده باقی
       خواهند ماند.  مقدار '0' برای 'end' معنای ویژه‌ای دارد: «آخرین فریم
       پویانمایی».

       یادآوری:
              شماره‌گذاری فریم‌ها از '1' آغاز می‌شود.


   FRAME_OPTIONS (-frame)
       ساخت یک پرونده متحرک WebP از چندین تصویر WebP (غیرمتحرک).

       file_i +di[+xi+yi[+mi[bi]]]
              که در آن: 'file_i' فریم iام (با قالب WebP) است، 'xi' و 'yi' آفست
              تصویر را برای این فریم مشخص می‌کنند، 'di' مدت زمان مکث پیش از
              فریم بعدی است، 'mi' روش دور انداختن (dispose) این فریم است (0
              برای NONE یا 1 برای BACKGROUND) و 'bi' روش ترکیب (blending) برای
              این فریم است (+b برای BLEND یا -b برای NO_BLEND).  آرگومان 'bi'
              می‌تواند حذف شود و مقدار پیش‌فرض آن +b (BLEND) خواهد بود.  همچنین
              اگر 'bi' حذف شود، 'mi' نیز می‌تواند حذف شود و مقدار پیش‌فرض آن 0
              (NONE) خواهد بود.  در نهایت، اگر 'mi' و 'bi' هر دو حذف شوند،
              'xi' و 'yi' نیز می‌توانند حذف شوند و مقدار پیش‌فرض آن‌ها +0+0 خواهد
              بود.

       -loop n
              تکرار چرخه فریم‌ها به تعداد n بار. مقدار 0 نشان می‌دهد فریم‌ها باید
              برای همیشه تکرار شوند.  بازه معتبر 0 تا 65535 است [پیش‌فرض: 0
              (بی‌نهایت)].

       -bgcolor A,R,G,B
              رنگ پس‌زمینه بوم.
              که در آن: 'A'، 'R'، 'G' و 'B' اعداد صحیحی در بازه 0 تا 255 هستند
              که به ترتیب مقادیر مؤلفه‌های آلفا (شفافیت)، قرمز، سبز و آبی را
              مشخص می‌کنند [پیش‌فرض: 255,255,255,255].


   ورودی (INPUT)
       پرونده ورودی در قالب WebP.


   خروجی (-o)
       پرونده خروجی در قالب WebP.


   نکته:
       ماهیت داده‌های EXIF، XMP و ICC بررسی نمی‌شود و معتبر فرض می‌گردند.


وضعیت خروج (EXIT STATUS)
       اگر هیچ مشکلی در حین اجرا رخ ندهد، webpmux با مقدار ثابت زبان سی
       EXIT_SUCCESS خارج می‌شود. این مقدار معمولاً صفر است.

       در صورت بروز خطا، webpmux با مقدار ثابت زبان سی EXIT_FAILURE خارج
       می‌شود. این مقدار معمولاً یک است.


مثال‌ها (EXAMPLES)
       افزودن نمایه ICC:
       webpmux -set icc image_profile.icc in.webp -o icc_container.webp

       استخراج نمایه ICC:
       webpmux -get icc icc_container.webp -o image_profile.icc

       حذف نمایه ICC:
       webpmux -strip icc icc_container.webp -o without_icc.webp

       افزودن فراداده XMP:
       webpmux -set xmp image_metadata.xmp in.webp -o xmp_container.webp

       استخراج فراداده XMP:
       webpmux -get xmp xmp_container.webp -o image_metadata.xmp

       حذف فراداده XMP:
       webpmux -strip xmp xmp_container.webp -o without_xmp.webp

       افزودن فراداده EXIF:
       webpmux -set exif image_metadata.exif in.webp -o exif_container.webp

       استخراج فراداده EXIF:
       webpmux -get exif exif_container.webp -o image_metadata.exif

       حذف فراداده EXIF:
       webpmux -strip exif exif_container.webp -o without_exif.webp

       ساخت یک پرونده متحرک WebP از ۳ تصویر WebP (غیرمتحرک):
       webpmux -frame 1.webp +100 -frame 2.webp +100+50+50
               -frame 3.webp +100+50+50+1+b -loop 10 -bgcolor 255,255,255,255
               -o anim_container.webp

       دریافت دومین فریم از یک پرونده متحرک WebP:
       webpmux -get frame 2 anim_container.webp -o frame_2.webp

       استفاده از -get/-set/-strip با نام پرونده ورودی که با «-» آغاز می‌شود:
       webpmux -set icc image_profile.icc -o icc_container.webp -- ---in.webp
       webpmux -get icc -o image_profile.icc -- ---icc_container.webp
       webpmux -strip icc -o without_icc.webp -- ---icc_container.webp


نویسندگان (AUTHORS)
       برنامه webpmux بخشی از libwebp است و توسط تیم WebP نوشته شده است.
       آخرین درخت کد منبع در نشانی زیر در دسترس است:
       https://chromium.googlesource.com/webm/libwebp

       این صفحه راهنما توسط Vikas Arora <vikaas.arora@gmail.com> برای پروژه
       دبیان نوشته شده است (و ممکن است توسط دیگران نیز استفاده شود).


گزارش باگ‌ها (REPORTING BUGS)
       لطفاً تمام اشکالات را به سامانه ردیابی مشکلات گزارش دهید:
       https://issues.webmproject.org
       از وصله‌ها (پچ‌ها) استقبال می‌شود! برای شروع به این صفحه مراجعه کنید:
       https://www.webmproject.org/code/contribute/submitting-patches


همچنین ببینید (SEE ALSO)
       cwebp(1), dwebp(1), gif2webp(1)
       برای اطلاعات بیشتر لطفاً به https://developers.google.com/speed/webp
       مراجعه کنید.

                                 July 18, 2024                      WEBPMUX(1)