.\" generated with Ronn/v0.7.3
.\" http://github.com/rtomayko/ronn/tree/0.7.3
.
.TH "PAGELAYOUTAPI" "1" "December 2023" "" ""
.
.SH "نام (NAME)"
\fBpagelayoutapi\fR \- رابط برنامه‌نویسی (API) برای کلاس pagelayout در LaTeX
.
.SH "خلاصه دستور (SYNOPSIS)"
\fBpagelayoutapi getwidth\fR % FILE
.
.P
\fBpagelayoutapi getheight\fR % FILE
.
.P
\fBpagelayoutapi optimize\fR % FILE % FILENAME % EXTENSION % ORIGINALWIDTH % ORIGINALHEIGHT % CROPLEFT % CROPRIGHT % CROPTOP % CROPBOTTOM % DENSITY % WIDTH % HEIGHT % DOWNSAMPLETHRESHOLD % UNSHARP % QUALITY
.
.P
\fBpagelayoutapi makeshadow\fR % FILENAME % STANDARDDEVIATION % OPACITY % COLOR % WIDTH % HEIGHT % FRAMEWIDTH % FRAMEHEIGHT % MARGIN % BORDERRADIUS
.
.P
\fBpagelayoutapi start\fR [% import % [GRAPHICSPATH]] [% turbo % JOBNAME]
.
.P
\fBpagelayoutapi batchoptimize\fR % BATCHLIST
.
.SH "توضیحات (DESCRIPTION)"
این اسکریپت یک رابط برنامه‌نویسی (API) برای کلاس pagelayout در LaTeX فراهم می‌کند\.
.
.TP
\fBpagelayoutapi getwidth\fR
عرض فایل تصویری داده‌شده را بر حسب پیکسل برمی‌گرداند\.
.
.TP
\fBpagelayoutapi getheight\fR
ارتفاع فایل تصویری داده‌شده را بر حسب پیکسل برمی‌گرداند\.
.
.TP
\fBpagelayoutapi optimize\fR
یک تصویر برش‌خورده، تغییراندازه‌یافته، واضح‌شده (sharpened) و فشرده‌شده ایجاد کرده و آن را در دایرکتوری حافظه موقت (cache) ذخیره می‌کند\.
.
.TP
\fBpagelayoutapi makeshadow\fR
یک تصویر سایه‌دار ایجاد کرده و آن را در دایرکتوری حافظه موقت (cache) ذخیره می‌کند\.
.
.TP
\fBpagelayoutapi start\fR
پارامتر import روند وارد کردن تصویر را آغاز می‌کند (فصل «Image Optimization» در pagelayout\-manual\.pdf را ببینید)\. اجرای دستور با پارامتر turbo، در شرایطی که jobname نام فایل سند باشد، سند را در یک حالت دسته‌ای (batch) ویژه پردازش می‌کند که یک فهرست دسته‌ای ساخته و دستور \fBpagelayoutapi batchoptimize\fR را فراخوانی می‌نماید\.
.
.TP
\fBpagelayoutapi batchoptimize\fR
چندین تصویر را به‌صورت موازی بهینه‌سازی می‌کند\.
.
.SH "گزینه‌ها (OPTIONS)"
.
.TP
\fB\-\-help\fR
یک پیام راهنما را چاپ می‌کند\.
.
.TP
\fB\-\-version\fR
اطلاعات نسخه را چاپ می‌کند\.
.
.SH "پارامترها (PARAMETERS)"
.
.TP
FILE
نام فایل همراه با پسوند (به عنوان مثال IMG1234\.JPEG)
.
.TP
FILENAME
نام فایل بدون پسوند (به عنوان مثال IMG1234)
.
.TP
EXTENSION
پسوند فایل بهینه‌شده (\.jpg|\.png)
.
.TP
DENSITY
تراکم بر حسب ppi (به عنوان مثال 72)
.
.TP
DOWNSAMPLETHRESHOLD
آستانه کاهش نمونه‌برداری (downsample) (عدد صحیح >= 100)
.
.TP
UNSHARP
فیلتر وضوح‌بخشی unsharp (به عنوان مثال 2x1)
.
.TP
QUALITY
کیفیت (عدد صحیح > 0، <= 100)
.
.TP
STANDARDDEVIATION
انحراف معیار (عدد اعشاری > 0\.0)
.
.TP
OPACITY
میزان کدری (عدد اعشاری >= 0\.0، <= 1\.0)
.
.TP
COLOR
رشته رنگ (به عنوان مثال pink)
.
.TP
GRAPHICSPATH
فهرستی از دایرکتوری‌ها (به عنوان مثال {images/}{tmp/})
.
.TP
JOBNAME
نام فایل LaTeX بدون پسوند (به عنوان مثال my\-document)
.
.TP
BATCHLIST
یک فهرست ساده از موارد دسته‌ای که در آن هر مورد، فهرستی ساده از ۱۵ پارامتر مورد نیاز دستور `pagelayoutapi optimize` است
.
.P
تمامی پارامترهای دیگر ابعاد طولی هستند\. دستور \fBpagelayoutapi optimize\fR مقادیر عدد صحیح را در واحد LaTeX به نام sp (به عنوان مثال 65536) انتظار دارد\. دستور \fBpagelayoutapi makeshadow\fR مقادیر اعشاری را در یک واحد سازگار با SVG (به عنوان مثال 420\.0pt) انتظار دارد\.
.
.SH "محیط (ENVIRONMENT)"
ابزار \fBpagelayoutapi\fR نیازمند ImageMagick نسخه 7\.0 یا بالاتر و Inkscape نسخه 1\.0 یا بالاتر است\.
.
.TP
\fBPAGELAYOUT_IMPORT_DIRECTORY\fR
یک دایرکتوری سراسری برای وارد کردن فایل‌ها در سطح سیستم تعریف می‌کند\.
.
.SH "نویسندگان (AUTHORS)"
ابزار \fBpagelayoutapi\fR توسط Friedemann Bartels نوشته شده است\. \fIhttps://github\.com/friedemannbartels\fR
.
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
کپی‌رایت (c) 2022\-2023 متعلق به Friedemann Bartels است\. استفاده آزاد از این نرم‌افزار تحت شرایط مجوز عمومی پروژه لایتک (LaTeX Project Public License) نسخه 1\.3c یا بالاتر مجاز می‌باشد\.