.TH ICO 1 "X Version 11" "X Version 11"
.SH "نام (NAME)"
ico \- نمایش اشکال چندوجهی متحرک و سه‌بعدی در سامانه پنجره X
.SH "خلاصه دستور (SYNOPSIS)"
.B ico
[\fB\-display\fI display\fR]
[\fB\-geometry\fI geometry\fR]
[\fB\-r\fR]
[\fB\-d\fI pattern\fR]
[\fB\-i\fR]
[\fB\-dbl\fR]
[\fB\-faces\fR]
[\fB\-noedges\fR]
[\fB\-sleep\fI n\fR]
[\fB\-obj\fI object\fR]
[\fB\-colors\fI color-list\fR]
.PP
.B ico \-objhelp
.PP
.B ico \-version
.SH "توضیحات (DESCRIPTION)"
برنامه
.B ico
یک چندوجهی چرخان سیمی (wire-frame) با حذف خطوط پنهان، یا یک چندوجهی با وجوه توپر (solid-fill) با حذف سطوح پنهان را نمایش می‌دهد. چندین شکل چندوجهی گوناگون در دسترس است؛ افزودن یک چندوجهی جدید به برنامه نیز بسیار ساده است.
.SH "گزینه‌ها (OPTIONS)"
.TP
.B \-r
نمایش تصویر در پنجره ریشه (root window) به جای ایجاد یک پنجره جدید.
.TP
.BI \-d " pattern"
تعیین یک الگوی بیتی (bit pattern) برای رسم خط‌چین در مدل‌های سیمی.
.TP
.B \-i
استفاده از رنگ‌های معکوس (inverted) برای مدل‌های سیمی.
.TP
.B \-dbl
استفاده از بافر دوگانه (double buffering) در نمایش. این گزینه هم برای رسم مدل‌های سیمی و هم برای سطوح توپر کاربرد دارد. در مدل‌های توپر، استفاده از این سوییچ باعث حرکتی بسیار روان‌تر و بدون پرش می‌شود. توجه داشته باشید که این حالت به دو برابر صفحات بیتی (bit planes) بیشتر نسبت به حالت بدون بافر دوگانه نیاز دارد. از آنجا که معمولاً برخی رنگ‌ها توسط برنامه‌های دیگر اشغال می‌شوند، بیشتر نمایشگرهای ۸ بیتی هنگام استفاده از بافر دوگانه به هشت رنگ محدود خواهند شد.
.TP
.B \-faces
رسم وجوه توپر و رنگی به جای ساختار سیمی.
.TP
.B \-noedges
عدم رسم یال‌ها و لبه‌های مدل سیمی. این گزینه معمولاً فقط زمانی استفاده می‌شود که گزینه
.B \-faces
به کار رفته باشد.
.TP
.BI \-sleep " n"
مکث به مدت
.I n
ثانیه بین هر حرکت یا فریم شیء.
.TP
.BI \-obj " object"
تعیین نوع شیء یا چندوجهی برای رسم. در صورت عدم تعیین شیء، یک بیست‌وجهی (icosahedron) رسم می‌شود.
.TP
.B \-objhelp
چاپ فهرستی از اشیاء و چندوجهی‌های موجود به همراه اطلاعات مربوط به هر شیء و خروج.
.TP
.BI \-colors " color ..."
تعیین رنگ‌هایی که باید برای رسم وجوه توپر شیء استفاده شوند. اگر تعداد رنگ‌های ارائه‌شده کمتر از تعداد وجوه باشد، رنگ‌ها به صورت دوره‌ای تکرار می‌شوند.
.TP
.B \-version
چاپ اطلاعات نسخه برنامه و خروج.
.SH "پایان اجرای برنامه (PROGRAM TERMINATION)"
فشردن کلید
.B q
باعث بسته شدن پنجره می‌شود. اگر برنامه با پشتیبانی از ریسمان‌ها (threads) کامپایل شده باشد، تنها زمانی متوقف می‌شود که تمام ریسمان‌ها خاتمه یابند. همچنین می‌توانید پنجره پویانمایی را با استفاده از پیام حذف ICCCM ببندید (بسته به مدیر پنجره شما، ممکن است دکمه کنترلی یا منویی برای ارسال این پیام وجود داشته باشد).
.SH "افزودن چندوجهی‌ها (ADDING POLYHEDRA)"
اگر کد منبع
.B ico
را در اختیار داشته باشید، افزودن چندوجهی‌های بیشتر بسیار آسان است. هر چندوجهی در یک فایل هدر با نام
.I objXXX.h
تعریف می‌شود که در آن
.I XXX
نام مرتبط با چندوجهی است. قالب این فایل در پرونده
.I polyinfo.h
مشخص شده است. برای مشاهده ساختار دقیق، فایل
.I objcube.h
را بررسی کرده و سپس فایل
.I objXXX.h
خود را بر اساس همان ساختار ایجاد نمایید.
.PP
پس از ساخت فایل جدید
.I objXXX.h
(یا کپی کردن آن از مکانی دیگر)، کافی است دستور
.B make depend
را اجرا کنید. این کار فایل
.I allobjs.h
را که فهرستی از تمامی فایل‌های
.I objXXX.h
است بازسازی می‌کند. اجرای دستور
.B make
پس از آن، برنامه
.B ico
را با اطلاعات اشیاء جدید کامپایل و بازسازی خواهد کرد.
.SH "همچنین ببینید (SEE ALSO)"
.BR X (7)
.SH "ایرادات و باگ‌ها (BUGS)"
هرم‌ها و چهاروجهی‌ها با وجوه توپر به درستی نمایش داده نمی‌شوند.
.PP
نام‌های تکراری در گزینه
.B \-colors
سلول‌های رنگی مجزایی را تخصیص می‌دهند.
.PP
تخصیص رنگ در نمایشگرهای رنگ واقعی (TrueColor) با شکست مواجه می‌شود و گزینه
.B \-faces
در آن‌ها به خوبی کار نمی‌کند.