نام (NAME)

wrjpgcom - درج یادداشت‌های متنی در یک فایل JPEG

خلاصه دستور (SYNOPSIS)

wrjpgcom [ -replace ] [ -comment text ] [ -cfile name ] [ filename ]

توضیحات (DESCRIPTION)

دستور wrjpgcom فایل JPEG/JFIF مشخص‌شده، یا در صورت عدم تعیین فایل، ورودی استاندارد را می‌خواند و یک فایل JPEG/JFIF جدید در خروجی استاندارد تولید می‌کند. یک بلوک یادداشت به فایل اضافه می‌شود.

استاندارد JPEG اجازه می‌دهد تا بلوک‌های «یادداشت» (COM) درون یک فایل JPEG قرار گیرند. اگرچه این استاندارد عملاً تعریف نمی‌کند که بلوک‌های COM برای چه منظوری هستند، اما به طور گسترده‌ای برای نگهداری رشته‌های متنی ارائه‌شده توسط کاربر به کار می‌روند. این ویژگی به شما امکان می‌دهد حاشیه‌نویسی‌ها، عناوین، اصطلاحات نمایه و غیره را به فایل‌های JPEG خود اضافه کرده و بعداً آن‌ها را به صورت متنی بازیابی کنید. بلوک‌های COM با تصویر ذخیره‌شده در فایل JPEG تداخلی ایجاد نمی‌کنند. حداکثر اندازه یک بلوک COM برابر ۶۴ کیلوبایت است، اما می‌توانید به تعداد دلخواه از آن‌ها را در یک فایل JPEG داشته باشید.

دستور wrjpgcom یک بلوک COM حاوی متن ارائه‌شده توسط شما را به یک فایل JPEG اضافه می‌کند. به طور معمول، بلوک COM بعد از بلوک‌های COM موجود افزوده می‌شود؛ اما در صورت تمایل می‌توانید بلوک‌های COM قدیمی را حذف کنید.

گزینه‌ها (OPTIONS)

نام سوییچ‌ها ممکن است مخفف شود و به حروف بزرگ و کوچک حساس نیستند.

-replace

حذف تمام بلوک‌های COM موجود از فایل.

-comment text

ارائه متن برای بلوک COM جدید در خط فرمان.

-cfile name

خواندن متن برای بلوک COM جدید از فایل مشخص‌شده.

اگر تنها یک خط متن یادداشت برای افزودن دارید، می‌توانید آن را در خط فرمان با -comment ارائه دهید. متن یادداشت باید درون علامت نقل‌قول قرار گیرد تا به عنوان یک آرگومان واحد در نظر گرفته شود. یادداشت‌های طولانی‌تر را می‌توان از یک فایل متنی خواند.

اگر نه -comment و نه -cfile را تعیین کنید، آن‌گاه wrjpgcom متن یادداشت را از ورودی استاندارد می‌خواند. (در این حالت نام فایل تصویر ورودی حتماً باید مشخص شود تا فایل JPEG منبع از جای دیگری خوانده شود.) می‌توانید چندین خط، حداکثر تا سقف ۶۴ کیلوبایت وارد کنید. برای پایان دادن به ورود متن یادداشت، نشانگر پایان فایل (معمولاً control-D) را وارد نمایید.

دستور wrjpgcom در صورتی که رشته یادداشت ارائه‌شده خالی باشد، بلوک COM اضافه نمی‌کند. بنابراین -replace -comment "" می‌تواند برای حذف تمامی بلوک‌های COM از یک فایل استفاده شود.

مثال‌ها (EXAMPLES)

افزودن یک یادداشت کوتاه به in.jpg و تولید out.jpg:

wrjpgcom -c "View of my back yard" in.jpg > out.jpg

پیوست کردن یک یادداشت طولانی که از قبل در comment.txt ذخیره شده است:

wrjpgcom in.jpg < comment.txt > out.jpg

یا به طور معادل:

wrjpgcom -cfile comment.txt < in.jpg > out.jpg

همچنین ببینید (SEE ALSO)

cjpeg(1), djpeg(1), jpegtran(1), rdjpgcom(1)

نویسنده (AUTHOR)

گروه مستقل JPEG (Independent JPEG Group)