.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "REGINA-GUI" "1" "25 August 2025" "" "The Regina Handbook"

.SH "نام (NAME)"
regina-gui \- واسط کاربری گرافیکی Regina
.SH "خلاصه دستور (SYNOPSIS)"

\fBregina-gui\fR [ \fB\fIfile\fB\fR\fI ...\fR ]

.SH "توضیحات (DESCRIPTION)"
.PP
نرم‌افزار Regina یک بسته نرم‌افزاری برای مطالعه مثلث‌بندی‌های ۳-منیفلد (3-manifold)
و سطوح نرمال (normal surfaces) است. سایر قابلیت‌های کلیدی شامل
ساختارهای زاویه‌ای، سرشماری و فهرست‌بندی، شناسایی
ترکیبیاتی مثلث‌بندی‌ها، و وظایف سطح بالا مانند
شناسایی ۳-کُره و تجزیه جمع همبند است.
نرم‌افزار Regina به همراه یک واسط کاربری گرافیکی کامل ارائه می‌شود و همچنین
اتصالات Python و یک رابط برنامه‌نویسی C++ سطح پایین را فراهم می‌کند.
.PP
این فرمان واسط کاربری گرافیکی کامل را اجرا می‌کند و روش معمول
برای شروع Regina است. هر فایلی که در خط فرمان فرستاده شود،
هنگام راه‌اندازی باز خواهد شد.
.SH "محیط (ENVIRONMENT)"
.PP
متغیرهای محیطی زیر بر رفتار این برنامه تأثیر می‌گذارند.
.TP
\fB\fIREGINA_PYLIBDIR\fB\fR
پوشه‌ای که حاوی ماژول Python با نام
\fIregina\fR\& است.

اگر ماژول Python نرم‌افزار Regina را در یک مسیر استاندارد
Python نصب کرده‌اید (یعنی Python می‌تواند بدون گسترش sys.path آن را
مستقیماً وارد کند)، در این صورت
\fIREGINA_PYLIBDIR\fR باید خالی یا تعریف‌نشده باقی بماند.

در حالت عادی نباید نیازی باشد که این گزینه را خودتان تنظیم کنید.
این برنامه می‌داند چگونه ماژول Python نرم‌افزار Regina را در شرایط استاندارد پیدا کند،
که شامل نصب‌های ثابت در سیستم‌فایل (مانند \fBGNU/Linux\fR و \fBWindows\fR)،
بسته‌های برنامه‌ای با قابلیت جابه‌جایی (مانند \fBmacOS\fR)،
و اجرای مستقیم از درخت کد منبع است.
.TP
\fB\fIREGINA_HOME\fB\fR
پوشه‌ای که فایل‌های دادهٔ Regina در زیرشاخهٔ آن نصب شده‌اند.
این موارد (از جمله) شامل فایل‌های مثال در
\fI$REGINA_HOME/examples/\fR،
مستندات API در
\fI$REGINA_HOME/engine-docs/\fR،
و پایگاه‌های دادهٔ سرشماری در
\fI$REGINA_HOME/data/census/\fR\& هستند.

در حالت عادی نباید نیازی باشد که این گزینه را خودتان تنظیم کنید.
این برنامه می‌داند چگونه فایل‌های داده‌اش را در شرایط استاندارد
پیدا کند، که شامل نصب‌های ثابت در سیستم‌فایل (مانند \fBGNU/Linux\fR و \fBWindows\fR)،
بسته‌های برنامه‌ای با قابلیت جابه‌جایی (مانند \fBmacOS\fR)،
و اجرای مستقیم از درخت کد منبع است.
.SH "کاربران MACOS (MACOS USERS)"
.PP
اگر یک بستهٔ برنامک کشیدن و رها کردن (drag-and-drop app bundle) بارگیری کرده‌اید، این همان
برنامه‌ای است که هنگام باز کردن آن اجرا می‌شود.
فایل اجرایی آن صرفاً \fBRegina\fR نام دارد،
نه \fBregina-gui\fR\&.
.SH "همچنین ببینید (SEE ALSO)"
.PP
regina-python\&.
.PP
نرم‌افزار Regina دارای یک کتابچه راهنمای جامع کاربران است که می‌توانید از طریق منوی
Help->Regina Handbook
به آن دسترسی داشته باشید. شما همچنین می‌توانید کتابچه راهنمای کاربران را به‌صورت برخط در
\fBhttp://regina-normal.github.io/docs\fR\&
مطالعه کنید.
.SH "نویسندگان (AUTHORS)"
.PP
افراد زیادی در توسعهٔ Regina مشارکت داشته‌اند؛ برای مشاهدهٔ فهرست
کامل مشارکت‌کنندگان به کتابچه راهنمای کاربران مراجعه کنید.