.\" Hey, EMACS: -*- nroff -*- .TH WEBPMUX 1 "July 18, 2024" .SH "نام (NAME)" webpmux \- ساخت پرونده‌های متحرک WebP از تصاویر ثابت، استخراج فریم‌ها، و مدیریت فراداده‌های XMP/EXIF و نمایه ICC .SH "خلاصه دستور (SYNOPSIS)" .B webpmux \-get .I GET_OPTIONS .I INPUT .B \-o .I OUTPUT .br .B webpmux \-set .I SET_OPTIONS .I INPUT .B \-o .I OUTPUT .br .B webpmux \-strip .I STRIP_OPTIONS .I INPUT .B \-o .I OUTPUT .br .B webpmux \-frame .I FRAME_OPTIONS .B [ \-frame ... ] [ \-loop .I LOOP_COUNT .B ] .br .RS 8 .B [ \-bgcolor .I BACKGROUND_COLOR .B ] \-o .I OUTPUT .RE .br .B webpmux \-duration .I DURATION OPTIONS .B [ \-duration ... ] .I INPUT .B \-o .I OUTPUT .br .B webpmux \-info .I INPUT .br .B webpmux [\-h|\-help] .br .B webpmux \-version .br .B webpmux argument_file_name .SH "توضیحات (DESCRIPTION)" این صفحه راهنما، دستور .B webpmux را مستند می‌کند. .PP دستور \fBwebpmux\fP می‌تواند برای ساخت یا استخراج از پرونده‌های متحرک WebP و همچنین افزودن، استخراج یا حذف فراداده‌های XMP/EXIF و نمایه ICC استفاده شود. اگر یک نام پرونده منفرد (که با نویسه «\-» شروع نمی‌شود) به عنوان آرگومان داده شود، آرگومان‌های خط فرمان در واقع از این پرونده توکنایز (خوانده) می‌شوند. این ویژگی امکان اسکریپت‌نویسی آسان یا استفاده از تعداد زیادی آرگومان را فراهم می‌کند. .SH "گزینه‌ها (OPTIONS)" .SS GET_OPTIONS (\-get): .TP .B icc دریافت نمایه ICC. .TP .B exif دریافت فراداده EXIF. .TP .B xmp دریافت فراداده XMP. .TP .BI frame " n" دریافت فریم nام از یک تصویر متحرک (مقدار n = 0 معنای ویژه‌ای دارد: آخرین فریم). .SS SET_OPTIONS (\-set) .TP .BI loop " loop_count" تنظیم تعداد تکرار چرخه در یک پرونده متحرک. .P که در آن: .I loop_count باید در بازه [0, 65535] باشد. .TP .BI bgcolor " A,R,G,B" تنظیم رنگ پس‌زمینه بوم در یک پرونده متحرک. .P که در آن: 'A'، 'R'، 'G' و 'B' اعداد صحیحی در بازه 0 تا 255 هستند که به ترتیب مقادیر مؤلفه‌های آلفا (شفافیت)، قرمز، سبز و آبی را مشخص می‌کنند. .TP .BI icc " file.icc" تنظیم نمایه ICC. .P که در آن: 'file.icc' حاوی نمایه ICC مورد نظر برای تنظیم است. .TP .BI exif " file.exif" تنظیم فراداده EXIF. .P که در آن: 'file.exif' حاوی فراداده EXIF مورد نظر برای تنظیم است. .TP .BI xmp " file.xmp" تنظیم فراداده XMP. .P که در آن: 'file.xmp' حاوی فراداده XMP مورد نظر برای تنظیم است. .SS STRIP_OPTIONS (\-strip) .TP .B icc حذف نمایه ICC. .TP .B exif حذف فراداده EXIF. .TP .B xmp حذف فراداده XMP. .SS DURATION_OPTIONS (\-duration) تغییر مدت زمان نمایش یک بازه مشخص از فریم‌ها. این گزینه فقط بر روی پرونده‌های متحرک WebP اثر دارد و بر روی پرونده‌های تک‌فریم بی‌اثر است. .TP .I duration[,start[,end]] که در آن: .br .B duration مدت زمان بازه بر حسب میلی‌ثانیه است (اجباری). باید مقداری غیرمنفی باشد. .br .B start شاخص فریم شروع بازه است (اختیاری). .br .B end شاخص فریم پایان بازه (شامل خود آن) است (اختیاری). .TP سه کاربرد متداول این گزینه عبارتند از: .br .B \-duration d تنظیم مدت زمان برابر با 'd' برای کل پویانمایی. .br .B \-duration d,f تنظیم مدت زمان فریم 'f' برابر با 'd'. .br .B \-duration d,start,end تنظیم مدت زمان برابر با 'd' برای کل بازه [start,end]. .P توجه داشته باشید که فریم‌های خارج از بازه [start, end] دست‌نخورده باقی خواهند ماند. مقدار '0' برای 'end' معنای ویژه‌ای دارد: «آخرین فریم پویانمایی». .TP .I یادآوری: شماره‌گذاری فریم‌ها از '1' آغاز می‌شود. .SS FRAME_OPTIONS (\-frame) ساخت یک پرونده متحرک WebP از چندین تصویر WebP (غیرمتحرک). .TP .I 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 خواهد بود. .TP .BI \-loop " n" تکرار چرخه فریم‌ها به تعداد n بار. مقدار 0 نشان می‌دهد فریم‌ها باید برای همیشه تکرار شوند. بازه معتبر 0 تا 65535 است [پیش‌فرض: 0 (بی‌نهایت)]. .TP .BI \-bgcolor " A,R,G,B" رنگ پس‌زمینه بوم. .br که در آن: 'A'، 'R'، 'G' و 'B' اعداد صحیحی در بازه 0 تا 255 هستند که به ترتیب مقادیر مؤلفه‌های آلفا (شفافیت)، قرمز، سبز و آبی را مشخص می‌کنند [پیش‌فرض: 255,255,255,255]. .SS ورودی (INPUT) .TP پرونده ورودی در قالب WebP. .SS خروجی (\-o) .TP پرونده خروجی در قالب WebP. .SS نکته: .TP ماهیت داده‌های EXIF، XMP و ICC بررسی نمی‌شود و معتبر فرض می‌گردند. .SH "وضعیت خروج (EXIT STATUS)" اگر هیچ مشکلی در حین اجرا رخ ندهد، \fBwebpmux\fP با مقدار ثابت زبان سی \fBEXIT_SUCCESS\fP خارج می‌شود. این مقدار معمولاً صفر است. .PP در صورت بروز خطا، \fBwebpmux\fP با مقدار ثابت زبان سی \fBEXIT_FAILURE\fP خارج می‌شود. این مقدار معمولاً یک است. .SH "مثال‌ها (EXAMPLES)" افزودن نمایه ICC: .br webpmux \-set icc image_profile.icc in.webp \-o icc_container.webp .P استخراج نمایه ICC: .br webpmux \-get icc icc_container.webp \-o image_profile.icc .P حذف نمایه ICC: .br webpmux \-strip icc icc_container.webp \-o without_icc.webp .P افزودن فراداده XMP: .br webpmux \-set xmp image_metadata.xmp in.webp \-o xmp_container.webp .P استخراج فراداده XMP: .br webpmux \-get xmp xmp_container.webp \-o image_metadata.xmp .P حذف فراداده XMP: .br webpmux \-strip xmp xmp_container.webp \-o without_xmp.webp .P افزودن فراداده EXIF: .br webpmux \-set exif image_metadata.exif in.webp \-o exif_container.webp .P استخراج فراداده EXIF: .br webpmux \-get exif exif_container.webp \-o image_metadata.exif .P حذف فراداده EXIF: .br webpmux \-strip exif exif_container.webp \-o without_exif.webp .P ساخت یک پرونده متحرک WebP از ۳ تصویر WebP (غیرمتحرک): .br webpmux \-frame 1.webp +100 \-frame 2.webp +100+50+50 .br .RS 8 \-frame 3.webp +100+50+50+1+b \-loop 10 \-bgcolor 255,255,255,255 .br \-o anim_container.webp .RE .P دریافت دومین فریم از یک پرونده متحرک WebP: .br webpmux \-get frame 2 anim_container.webp \-o frame_2.webp .P استفاده از \-get/\-set/\-strip با نام پرونده ورودی که با «\-» آغاز می‌شود: .br webpmux \-set icc image_profile.icc \-o icc_container.webp \-\- \-\-\-in.webp .br webpmux \-get icc \-o image_profile.icc \-\- \-\-\-icc_container.webp .br webpmux \-strip icc \-o without_icc.webp \-\- \-\-\-icc_container.webp .SH "نویسندگان (AUTHORS)" برنامه \fBwebpmux\fP بخشی از libwebp است و توسط تیم WebP نوشته شده است. .br آخرین درخت کد منبع در نشانی زیر در دسترس است: https://chromium.googlesource.com/webm/libwebp .PP این صفحه راهنما توسط Vikas Arora برای پروژه دبیان نوشته شده است (و ممکن است توسط دیگران نیز استفاده شود). .SH "گزارش باگ‌ها (REPORTING BUGS)" لطفاً تمام اشکالات را به سامانه ردیابی مشکلات گزارش دهید: https://issues.webmproject.org .br از وصله‌ها (پچ‌ها) استقبال می‌شود! برای شروع به این صفحه مراجعه کنید: https://www.webmproject.org/code/contribute/submitting\-patches .SH "همچنین ببینید (SEE ALSO)" .BR cwebp (1), .BR dwebp (1), .BR gif2webp (1) .br برای اطلاعات بیشتر لطفاً به https://developers.google.com/speed/webp مراجعه کنید.