WEBPMUX(1) General Commands Manual WEBPMUX(1)

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

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

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

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

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

تنظیم تعداد تکرار چرخه در یک پرونده متحرک.

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

تنظیم رنگ پس‌زمینه بوم در یک پرونده متحرک.

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

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

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

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

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

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

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

حذف نمایه ICC.
حذف فراداده EXIF.
حذف فراداده XMP.

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

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

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

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

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

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

که در آن: '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 خواهد بود.
تکرار چرخه فریم‌ها به تعداد n بار. مقدار 0 نشان می‌دهد فریم‌ها باید برای همیشه تکرار شوند. بازه معتبر 0 تا 65535 است [پیش‌فرض: 0 (بی‌نهایت)].
رنگ پس‌زمینه بوم.
که در آن: 'A'، 'R'، 'G' و 'B' اعداد صحیحی در بازه 0 تا 255 هستند که به ترتیب مقادیر مؤلفه‌های آلفا (شفافیت)، قرمز، سبز و آبی را مشخص می‌کنند [پیش‌فرض: 255,255,255,255].

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

پرونده خروجی در قالب WebP.

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

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

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

افزودن نمایه 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

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

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

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

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

July 18, 2024