| 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 ]
webpmux -info INPUT
webpmux [-h|-help]
webpmux -version
webpmux argument_file_name
توضیحات (DESCRIPTION)
این صفحه راهنما، دستور webpmux را مستند میکند.
دستور webpmux میتواند برای ساخت یا استخراج از پروندههای متحرک WebP و همچنین افزودن، استخراج یا حذف فرادادههای XMP/EXIF و نمایه ICC استفاده شود. اگر یک نام پرونده منفرد (که با نویسه «-» شروع نمیشود) به عنوان آرگومان داده شود، آرگومانهای خط فرمان در واقع از این پرونده توکنایز (خوانده) میشوند. این ویژگی امکان اسکریپتنویسی آسان یا استفاده از تعداد زیادی آرگومان را فراهم میکند.
گزینهها (OPTIONS)
GET_OPTIONS (-get):
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)
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
-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 |