.TH GVCOLOR 1 "21 March 2001"
.SH "نام (NAME)"
gvcolor \- جریان دادن به رنگ‌ها در سرتاسر یک گراف جهت‌دار رتبه‌بندی‌شده
.SH "خلاصه دستور (SYNOPSIS)"
.B gvcolor
[ 
.I files 
]
.SH "نحوه استفاده (USAGE)"
.ft 5
dot file.gv | gvcolor | dot \-T\fI<format>\fP
.ft
.SH "توضیحات (DESCRIPTION)"
.B gvcolor
(که پیش‌تر با نام
.BR colorize
شناخته می‌شد) پالایه‌ای است که رنگ گره‌ها را بر اساس مقادیر اولیهٔ بذر (seed) تعیین می‌کند.
رنگ‌ها در امتداد یال‌ها از مبدأ (tail) به مقصد (head) جاری می‌شوند و در گره‌ها
(به‌عنوان بردارهای HSB) میانگین‌گیری می‌شوند.
\fIگراف باید پیش از این توسط dot پردازش شده باشد.\fP
انتخاب مناسب رنگ‌های اولیه موجب تولید نگاره‌هایی می‌شود که در آن‌ها رنگ
گره‌ها به برجسته‌سازی روابط منطقی میان گره‌ها کمک می‌کند، حتی
زمانی که در چیدمان فاصلهٔ زیادی از یکدیگر داشته باشند.
.PP
رنگ‌های اولیه باید از بیرون و با استفاده از مشخصهٔ \fBcolor\fP
یک گره تعیین شوند. اغلب اختصاص دادن رنگ به چند گره کلیدی چشمه (source) یا چاهک (sink)
و تنظیم دستی رنگ آن‌ها با ویرایش فایل گراف مؤثر واقع می‌شود.
نام رنگ‌ها همانند \fIdot(1)\fP است: نام‌های نمادین یا سه‌گانه‌های RGB.
بهتر است رنگ‌هایی انتخاب شوند که به‌سادگی قابل تشخیص اما با یکدیگر مرتبط باشند؛
نه لزوماً با فاصله‌های یکنواخت روی چرخهٔ رنگ. برای مثال،
blue_green،‏ green و light_yellow ظاهر بهتری نسبت به red،‏ green و blue ایجاد می‌کنند.
.PP
مشخصه‌های معینی از گراف، الگوریتم \fIgvcolor\fP را کنترل می‌کنند.
دستور \fBflow=back\fP جریان رنگ‌ها را از مقصد به مبدأ (heads to tails) معکوس می‌کند.
دستور \fBsaturation=.1,.9\fP (یا هر دو عددی بین 0 و 1)
غلظت رنگ (saturation) را به‌صورت خطی از کمترین تا بیشترین رتبه تنظیم می‌کند.
اگر \fBDefcolor\fP تعیین شده باشد، این مقدار رنگ به هر گرهی که به گونه‌ای دیگر
رنگ‌آمیزی نشده باشد اعمال می‌شود.
.SH "وضعیت خروج (EXIT STATUS)"
مقادیر خروج زیر بازگردانده می‌شوند:
.TP 4
.B 0
اتمام موفقیت‌آمیز.
.TP
.B 1
اگر گره‌های گراف دارای مشخصهٔ \(lqpos\(rq نباشند.
.SH "گزارش باگ‌ها (BUGS)"
مناسب‌تر خواهد بود اگر برنامه بدون اتکا به یک دور پردازش اولیه توسط \fBdot\fP کار کند.
.SH "نویسندگان (AUTHORS)"
Stephen C. North <north@research.att.com>
.br
Emden R. Gansner <erg@research.att.com>
.SH "همچنین ببینید (SEE ALSO)"
gc(1), dot(1), gvpr(1), ccomps(1), sccmap(1), tred(1), libgraph(3)