.TH WRJPGCOM 1 "15 June 1995"
.SH "نام (NAME)"
wrjpgcom \- درج یادداشت‌های متنی در یک فایل JPEG
.SH "خلاصه دستور (SYNOPSIS)"
.B wrjpgcom
[
.B \-replace
]
[
.BI \-comment " text"
]
[
.BI \-cfile " name"
]
[
.I filename
]
.LP
.SH "توضیحات (DESCRIPTION)"
.LP
دستور
.B wrjpgcom
فایل JPEG/JFIF مشخص‌شده، یا در صورت عدم تعیین فایل، ورودی استاندارد را می‌خواند و یک فایل JPEG/JFIF جدید در خروجی استاندارد تولید می‌کند. یک بلوک یادداشت به فایل اضافه می‌شود.
.PP
استاندارد JPEG اجازه می‌دهد تا بلوک‌های «یادداشت» (COM) درون یک فایل JPEG قرار گیرند. اگرچه این استاندارد عملاً تعریف نمی‌کند که بلوک‌های COM برای چه منظوری هستند، اما به طور گسترده‌ای برای نگهداری رشته‌های متنی ارائه‌شده توسط کاربر به کار می‌روند. این ویژگی به شما امکان می‌دهد حاشیه‌نویسی‌ها، عناوین، اصطلاحات نمایه و غیره را به فایل‌های JPEG خود اضافه کرده و بعداً آن‌ها را به صورت متنی بازیابی کنید. بلوک‌های COM با تصویر ذخیره‌شده در فایل JPEG تداخلی ایجاد نمی‌کنند. حداکثر اندازه یک بلوک COM برابر ۶۴ کیلوبایت است، اما می‌توانید به تعداد دلخواه از آن‌ها را در یک فایل JPEG داشته باشید.
.PP
دستور
.B wrjpgcom
یک بلوک COM حاوی متن ارائه‌شده توسط شما را به یک فایل JPEG اضافه می‌کند. به طور معمول، بلوک COM بعد از بلوک‌های COM موجود افزوده می‌شود؛ اما در صورت تمایل می‌توانید بلوک‌های COM قدیمی را حذف کنید.
.SH "گزینه‌ها (OPTIONS)"
نام سوییچ‌ها ممکن است مخفف شود و به حروف بزرگ و کوچک حساس نیستند.
.TP
.B \-replace
حذف تمام بلوک‌های COM موجود از فایل.
.TP
.BI \-comment " text"
ارائه متن برای بلوک COM جدید در خط فرمان.
.TP
.BI \-cfile " name"
خواندن متن برای بلوک COM جدید از فایل مشخص‌شده.
.PP
اگر تنها یک خط متن یادداشت برای افزودن دارید، می‌توانید آن را در خط فرمان با
.BR \-comment
ارائه دهید. متن یادداشت باید درون علامت نقل‌قول قرار گیرد تا به عنوان یک آرگومان واحد در نظر گرفته شود. یادداشت‌های طولانی‌تر را می‌توان از یک فایل متنی خواند.
.PP
اگر نه
.B \-comment
و نه
.BR \-cfile
را تعیین کنید، آن‌گاه
.B wrjpgcom
متن یادداشت را از ورودی استاندارد می‌خواند. (در این حالت نام فایل تصویر ورودی حتماً باید مشخص شود تا فایل JPEG منبع از جای دیگری خوانده شود.) می‌توانید چندین خط، حداکثر تا سقف ۶۴ کیلوبایت وارد کنید. برای پایان دادن به ورود متن یادداشت، نشانگر پایان فایل (معمولاً control-D) را وارد نمایید.
.PP
دستور
.B wrjpgcom
در صورتی که رشته یادداشت ارائه‌شده خالی باشد، بلوک COM اضافه نمی‌کند. بنابراین \fB\-replace \-comment ""\fR می‌تواند برای حذف تمامی بلوک‌های COM از یک فایل استفاده شود.
.SH "مثال‌ها (EXAMPLES)"
.LP
افزودن یک یادداشت کوتاه به in.jpg و تولید out.jpg:
.IP
.B wrjpgcom \-c
\fI"View of my back yard" in.jpg
.B >
.I out.jpg
.PP
پیوست کردن یک یادداشت طولانی که از قبل در comment.txt ذخیره شده است:
.IP
.B wrjpgcom
.I in.jpg
.B <
.I comment.txt
.B >
.I out.jpg
.PP
یا به طور معادل:
.IP
.B wrjpgcom
.B -cfile
.I comment.txt
.B <
.I in.jpg
.B >
.I out.jpg
.SH "همچنین ببینید (SEE ALSO)"
.BR cjpeg (1),
.BR djpeg (1),
.BR jpegtran (1),
.BR rdjpgcom (1)
.SH "نویسنده (AUTHOR)"
گروه مستقل JPEG (Independent JPEG Group)