.\" Copyright 1991, 1994, 1998  The Open Group
.\"
.\" Permission to use, copy, modify, distribute, and sell this software and its
.\" documentation for any purpose is hereby granted without fee, provided that
.\" the above copyright notice appear in all copies and that both that
.\" copyright notice and this permission notice appear in supporting
.\" documentation.
.\"
.\" The above copyright notice and this permission notice shall be included
.\" in all copies or substantial portions of the Software.
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
.\" IN NO EVENT SHALL THE OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR
.\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
.\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
.\" OTHER DEALINGS IN THE SOFTWARE.
.\"
.\" Except as contained in this notice, the name of The Open Group shall
.\" not be used in advertising or otherwise to promote the sale, use or
.\" other dealings in this Software without prior written authorization
.\" from The Open Group.
.\"
.\"
.TH XMAG 1 "xmag 1.0.8" "X Version 11"
.SH "نام (NAME)"
xmag \- بزرگ‌نمایی بخش‌هایی از صفحه نمایش
.SH "خلاصه دستور (SYNOPSIS)"
.B xmag
[
.B \-mag
.I magfactor
] [
.B \-source
.I geom
] [
.I \-toolkitoption
\&.\|.\|. ]
.br
.B xmag
[
.B \-help
|
.B \-version
]
.SH "توضیحات (DESCRIPTION)"
برنامه \fIxmag\fP به شما امکان می‌دهد بخش‌هایی از یک صفحه نمایش X را بزرگ‌نمایی کنید. اگر ناحیه مشخصی تعیین نشده باشد، مربعی با اشاره‌گر در گوشه بالا سمت چپ آن نمایش داده می‌شود که نشان‌دهنده ناحیه مورد نظر برای بزرگ‌نمایی است. این ناحیه را می‌توان با فشردن دکمه ۲ (Button 2) به اندازه دلخواه کشید. پس از انتخاب یک ناحیه، پنجره‌ای باز می‌شود که نسخه بزرگ‌شده آن ناحیه را نشان می‌دهد و در آن هر پیکسل از تصویر مبدأ توسط یک مربع کوچک به همان رنگ نمایش داده می‌شود. فشردن Button1 در پنجره بزرگ‌نمایی، موقعیت و مقدار RGB پیکسلی را که زیر اشاره‌گر قرار دارد تا زمان رها شدن دکمه نشان می‌دهد. فشردن کلیدهای «Q» یا «^C» در پنجره بزرگ‌نمایی باعث خروج از برنامه می‌شود. این برنامه دارای ۵ دکمه در بالای پنجره خود است.
گزینه \fIClose\fP این نمونه بزرگ‌نمایی خاص را می‌بندد.
گزینه \fIReplace\fP انتخاب‌گر کشسان (rubber band) را دوباره فعال می‌کند تا بتوان ناحیه دیگری را برای این نمونه بزرگ‌نمایی انتخاب کرد.
گزینه \fINew\fP انتخاب‌گر کشسان را برای ایجاد یک نمونه بزرگ‌نمایی جدید فراخوانی می‌کند.
گزینه \fISelect\fP تصویر بزرگ‌نمایی‌شده را در انتخاب اولیه (primary selection) قرار می‌دهد.
گزینه \fIPaste\fP بافر انتخاب اولیه را در \fIxmag\fP جای‌گذاری می‌کند.
توجه داشته باشید که می‌توانید بین \fIxmag\fP و برنامه \fIbitmap\fP عمل برش و جای‌گذاری (cut and paste) را انجام دهید. تغییر اندازه پنجره \fIxmag\fP اندازه ناحیه بزرگ‌نمایی را نیز تغییر می‌دهد.
برنامه \fIxmag\fP نقشه رنگ (colormap)، خصوصیات بصری (visual) و عمق پنجره مبدأ را حفظ می‌کند.
.SH "ویجت‌ها (WIDGETS)"
برنامه \fIxmag\fP از X Toolkit و مجموعه ویجت Athena (Athena Widget Set) استفاده می‌کند.
تصویر بزرگ‌نمایی‌شده در ویجت Scale نمایش داده می‌شود.
برای اطلاعات بیشتر، به مستندات Athena Widget Set مراجعه کنید.
در زیر ساختار ویجت‌های برنامه \fIxmag\fP آمده است.
تورفتگی‌ها ساختار سلسله‌مراتبی را نشان می‌دهند. ابتدا نام کلاس ویجت و سپس نام نمونه ویجت ذکر شده است.
.sp
.nf
	Xmag xmag
		RootWindow root
		TopLevelShell xmag
			Paned pane1
				Paned pane2
					Command close
					Command replace
					Command new
					Command select
					Command paste
					Label xmag label
				Paned pane2
					Scale scale
		OverrideShell pixShell
			Label pixLabel

.fi
.SH "گزینه‌ها (OPTIONS)"
.TP 15
.B \-source\fI geom\fP
این گزینه اندازه و/یا مکان ناحیه مبدأ را روی صفحه نمایش مشخص می‌کند. به‌طور پیش‌فرض، یک مربع ۶۴x۶۴ در اختیار کاربر قرار می‌گیرد تا ناحیه‌ای از صفحه نمایش را انتخاب کند.
.TP 15
.B \-mag\fI integer\fP
این گزینه ضریب بزرگ‌نمایی مورد نظر را تعیین می‌کند. مقدار پیش‌فرض ۵ است.
.TP 15
.B \-help
این گزینه مشخص می‌کند که \fIxmag\fP باید پیام راهنمای نحوه استفاده را چاپ کرده و خارج شود.
.TP 15
.B \-version
این گزینه مشخص می‌کند که \fIxmag\fP باید اطلاعات نسخه را چاپ کرده و خارج شود.
.SH "نویسندگان (AUTHORS)"
Dave Sternlicht و Davor Matic، کنسرسیوم MIT X.