.TH XPLANET 1 .\" NAME should be all caps, SECTION should be 1-8, maybe w/ subsection .\" other parms are allowed: see man(7), man(1) .SH "نام (NAME)" xplanet \- رندر کردن تصویری از یک سیاره در یک پنجره X یا در یک فایل .SH "خلاصه دستور (SYNOPSIS)" .B xplanet .I "[گزینه‌ها]" .SH "توضیحات (DESCRIPTION)" دستور .B Xplanet مشابه Xearth است که در آن تصویری از کره زمین در یک پنجره X رندر می‌شود. تمام سیارات اصلی و بیشتر قمرها قابل رسم هستند. چندین نگاشت مختلف تصویرسازی نقشه نیز پشتیبانی می‌شوند، از جمله سمتی (azimuthal)، مرکاتور (Mercator)، ملواید (Mollweide)، ارتوگرافیک (orthographic) و مستطیلی (rectangular). آخرین نسخه را همیشه می‌توانید در نشانی http://xplanet.sourceforge.net بیابید. .SH "گزینه‌ها (OPTIONS)" تنها مشخص کردن تعداد نویسه کافی برای رفع ابهام گزینه‌ها کفایت می‌کند. گزینه‌های معتبر Xplanet عبارتند از: .TP .B \-arc_file مشخص کردن یک فایل قوس (arc) برای رسم در پس‌زمینه ستارگان. هر خط در این فایل باید دارای ساختار زیر باشد: .nf .sp dec1 ra1 dec2 ra2 .sp .fi که در آن میل (declination) به درجه و بعد (right ascension) به ساعت است. در صورت مشخص شدن گزینه .B \-projection این گزینه هیچ تاثیری نخواهد داشت. .TP .B \-arc_spacing spacing هنگام رسم یک قوس، پاره‌خط‌هایی را رسم می‌کند که به اندازه spacing درجه از یکدیگر فاصله دارند. مقدار پیش‌فرض 0.1 درجه است. پاره‌خط‌های کوتاه‌تر از spacing رسم نخواهند شد. .TP .B \-arc_thickness thickness تعیین ضخامت قوس‌ها. مقدار پیش‌فرض 1 پیکسل است. هنگام رسم قوس‌ها روی یک سیاره با استفاده از گزینه arc_file در فایل پیکربندی، از گزینه arc_thickness در آنجا نیز استفاده کنید. .TP .B \-background background_file استفاده از background_file به عنوان تصویر پس‌زمینه، به طوری که سیاره روی آن قرار گیرد. یک رنگ نیز می‌تواند ارائه شود (برای نمونه .B \-background "navy blue" یا .BR \-background " 0xff00ff" ). .TP .B \-base_magnitude magnitude ستاره‌ای با قدر (magnitude) مشخص‌شده دارای روشنایی پیکسلی 1 خواهد بود. مقدار پیش‌فرض 10 است. اگر این عدد بزرگ‌تر باشد، ستاره‌ها درخشان‌تر رسم خواهند شد. .TP .B \-body body رندر کردن تصویری از سیاره یا قمر مشخص‌شده. مقادیر معتبر برای body عبارتند از sun، mercury، venus، earth، moon، mars، phobos، deimos، jupiter، io، europa، ganymede، callisto، saturn، mimas، enceladus، tethys، dione، rhea، titan، hyperion، iapetus، phoebe، uranus، miranda، ariel، umbriel، titania، oberon، neptune، triton، nereid، pluto، charon، random و major. میدان دید همچنین می‌تواند با استفاده از «naif» یا «norad» به همراه شناسه قمر متمرکز شود. برای نمونه، .B "\-body naif-82" میدان دید را روی شناسه NAIF با مقدار \-82 که مدارگرد کاسینی (Cassini) است متمرکز می‌کند. برنامه Xplanet باید با پشتیبانی از SPICE کامپایل شده باشد و کرネル‌های لازم موجود باشند. برای جزئیات بیشتر به فایل README در زیرشاخه spice مراجعه کنید. استفاده از .B "\-body norad20580" میدان دید را روی شناسه NORAD با مقدار 20580 که تلسکوپ فضایی هابل است متمرکز می‌کند. در این حالت فایل‌های TLE مناسب باید موجود باشند. برای اطلاعات بیشتر به فایل README در زیرشاخه satellites مراجعه کنید. استفاده از «path» میدان دید را در راستای جهت حرکت نقطه مبدا متمرکز می‌کند. این جهت نسبت به جهت حرکت جرمی است که توسط .B \-path_relative_to مشخص شده است. زمین (earth) جرم پیش‌فرض است. این گزینه مشابه .B \-target است. .TP .B \-center +x+y قرار دادن مرکز جرم رندرشده در مختصات پیکسلی (x, y). گوشه بالا سمت چپ صفحه در (0,0) است. هر یک از x یا y می‌تواند منفی باشد. مقدار پیش‌فرض، مرکز صفحه نمایش است. .TP .B \-color color تنظیم رنگ برای برچسب (label). مقدار پیش‌فرض "red" است. هر رنگی در فایل rgb.txt قابل استفاده است. رنگ‌ها همچنین می‌توانند با مقادیر هگزادسیمال RGB مشخص شوند؛ برای نمونه .B \-color 0xff و .B \-color blue همانند .B \-color 0xff0000 و .B \-color red معنای یکسانی دارند. .TP .B \-config config_file استفاده از فایل پیکربندی config_file. ساختار config_file در فایل README.config شرح داده شده است. برای مشاهده مکان‌هایی که xplanet جهت یافتن فایل پیکربندی جستجو می‌کند، توضیحات .B \-searchdir را ببینید. .TP .B \-create_scattering_tables scattering_file ایجاد جدول‌های جستجو برای پراکندگی رایلی (Rayleigh scattering). برای اطلاعات بیشتر فایل README موجود در دایرکتوری scattering را مشاهده کنید. .TP .B \-date YYYYMMDD.HHMMSS استفاده از تاریخ مشخص‌شده به جای زمان محلی فعلی. فرض می‌شود این تاریخ به وقت گرینویچ (GMT) است. .TP .B \-date_format string تعیین قالب برای برچسب تاریخ/زمان. این رشته قالب به .BR strftime (3) پاس داده می‌شود. مقدار پیش‌فرض "%c %Z" است که تاریخ، زمان و منطقه زمانی را در نمایش متناسب با محلی‌سازی (locale) نشان می‌دهد. .TP .B \-dynamic_origin file تعیین موقعیت ناظر. این موقعیت نسبت به جرمی است که با .B \-origin مشخص شده است (به طور پیش‌فرض خورشید). آخرین خط فایل باید به شکل زیر باشد: .nf .sp YYYYMMDD.HHMMSS range lat lon localtime .sp .fi برای نمونه، .nf .sp 19951207.120000 10.328 \-3.018 97.709 9.595 .sp .fi زمان مشخص‌شده نادیده گرفته شده و زمان جاری استفاده می‌شود. برد (range) بر حسب شعاع سیاره، و lat و lon بر حسب درجه هستند. زمان محلی (بر حسب ساعت) اختیاری است، اما در صورت وجود، به جای طول جغرافیایی استفاده خواهد شد. فقط آخرین خط فایل استفاده می‌شود. این فایل می‌تواند بین رندرها با استفاده از اسکریپتی که با گزینه‌های .B \-prev_command یا .B \-post_command اجرا می‌شود به‌روزرسانی گردد. .TP .B \-ephemeris_file filename تعیین یک فایل جدول نجومی دیجیتال JPL (از نوع DE200، DE405 یا DE406) جهت استفاده برای محاسبه موقعیت سیارات. برنامه Xplanet از کد بیل گری (Bill Gray) در نشانی http://www.projectpluto.com/jpl_eph.htm استفاده می‌کند که فایل‌های دودویی big-endian و little-endian را می‌خواند. فایل‌های تقویم نجومی موجود در ftp://ssd.jpl.nasa.gov/pub/eph/export/unix فایل‌های big-endian هستند، اما برای استفاده از آن‌ها نیازی به تعویض بایت (byte-swapping) اضافی ندارید. برای مشاهده محل‌هایی که xplanet جهت یافتن فایل تقویم نجومی جستجو می‌کند، توضیحات .B \-searchdir را ببینید. .TP .B \-font fontname تنظیم قلم (فونت) برای برچسب. تنها قلم‌های TrueType پشتیبانی می‌شوند. اگر گزینه .B \-pango استفاده شود، fontname به عنوان نام خانواده قلم (مانند "Arial") در نظر گرفته می‌شود. .TP .B \-fontsize size تعیین اندازه نقطه (point size). مقدار پیش‌فرض 12 است. .TP .B \-fork جدا شدن از ترمینال کنترل‌کننده. این گزینه در MS Windows برای اجرای xplanet از طریق یک بچ‌فایل بدون نیاز به باز نگه داشتن پنجره DOS مفید است. هنگام استفاده از این گزینه مراقب باشید؛ ممکن است چند پردازش به طور همزمان بدون اطلاع شما در حال اجرا باشند - بخش Task Manager را بررسی کنید. در سیستم‌های یونیکس این مورد اساساً مشابه اجرای xplanet در پس‌زمینه است. .TP .B \-fov تعیین میدان دید، بر حسب درجه. این گزینه و گزینه .B \-radius مانعة‌الجمع هستند. در صورت استفاده از گزینه .B \-projection این گزینه هیچ تاثیری ندارد. .TP .B \-geometry string تعیین ابعاد هندسی تصویر با استفاده از ساختار استاندارد ابعاد پنجره در X: [{xX}][{+-}{+-}] (برای نمونه 256x256-10+10 پنجره‌ای با اندازه 256x256 پیکسل را در فاصله 10 پیکسل از سمت راست و 10 پیکسل پایین‌تر از بالای پنجره ریشه قرار می‌دهد). پنجره ریشه خارج از تصویر به رنگ مشکی خواهد بود. این گزینه می‌تواند همراه با .B \-window یا .B \-output استفاده شود. .TP .B \-glare radius رسم درخشش (glare) در اطراف خورشید با شعاعی به اندازه مقدار مشخص‌شده بزرگ‌تر از خورشید. مقدار پیش‌فرض 28 است. .TP .B \-gmtlabel مشابه گزینه .BR \-label ، اما به جای زمان محلی، زمان گرینویچ (GMT) را نشان می‌دهد. .TP .B \-grs_longitude lon طول جغرافیایی لکه سرخ بزرگ مشتری (GRS). مقدار متداول 94 درجه است. اگر این گزینه مشخص شود، طول‌های جغرافیایی در مشتری در مختصات System II محاسبه خواهند شد. به طور پیش‌فرض، طول‌ها در مختصات System III محاسبه می‌شوند. هنگام استفاده از این گزینه، از نقشه تصویری برای مشتری استفاده کنید که در آن مرکز GRS در ستون پیکسل 0 یا سمت چپ تصویر قرار داشته باشد. .TP .B \-hibernate seconds پس از اینکه صفحه نمایش برای تعداد ثانیه‌های مشخص‌شده بیکار (idle) ماند، xplanet به خواب می‌رود. این گزینه مستلزم آن است که xplanet با افزونه X Screensaver کامپایل شده باشد. .TP .B \-idlewait seconds برنامه Xplanet را اجرا نکن مگر اینکه صفحه نمایش برای تعداد ثانیه‌های مشخص‌شده بیکار مانده باشد. این گزینه مستلزم آن است که xplanet با افزونه X Screensaver کامپایل شده باشد. .TP .B \-interpolate_origin_file این گزینه تنها همراه با .B \-origin_file مفید است. این گزینه موقعیت ناظر را در زمان فعلی با درون‌یابی میان مقادیر مشخص‌شده در فایل مبدا محاسبه می‌کند. این ویژگی زمانی کاربرد دارد که موقعیت‌های فضاپیما را در یک فایل مبدا به صورت جدول دارید، اما نمای بی‌درنگ (real time) را می‌خواهید. .TP .B \-jdate Julian date استفاده از تاریخ ژولیانی (Julian date) مشخص‌شده به جای زمان محلی جاری. .TP .B \-label نمایش یک برچسب در گوشه بالا سمت راست. .TP .B \-labelpos تعیین موقعیت برچسب با استفاده از ساختار استاندارد ابعاد پنجره X. موقعیت پیش‌فرض "-15+15" است، یعنی 15 پیکسل به سمت چپ و پایین‌تر از گوشه بالا سمت راست صفحه نمایش. این گزینه به طور ضمنی شامل .B \-label نیز می‌شود. .TP .B \-label_altitude نمایش ارتفاع از سطح به جای فاصله از مرکز جرم در برچسب. .TP .B \-label_body body استفاده از جرم مشخص‌شده برای محاسبه مقادیر نقطه زیرناظر (sub-observer)، نقطه زیرخورشید (sub-solar) و روشنایی در برچسب. این گزینه همراه با گزینه .B \-separation مفید است. .TP .B \-label_string تعیین متن خط اول برچسب. به طور پیش‌فرض، متنی شبیه به "Looking at Earth" نمایش داده می‌شود. هر نمونه از %t با نام هدف (target) و هر نمونه از %o با نام مبدا (origin) جایگزین خواهد شد. .TP .B \-latitude latitude رندر کردن جرم هدف به طوری که از بالای عرض جغرافیایی مشخص‌شده (بر حسب درجه) دیده شود. مقدار پیش‌فرض 0 است. .TP .B \-light_time محاسبه مدت زمانی که طول می‌کشد تا نور از جرم هدف به ناظر برسد (زمان سیر نور). حالت پیش‌فرض نادیده گرفتن اثرات زمان سیر نور است. .TP .B \-localtime localtime قرار دادن ناظر در بالای طول جغرافیایی که زمان محلی آن برابر با مقدار مشخص‌شده است. 0 نشان‌دهنده نیمه‌شب و 12 نشان‌دهنده ظهر است. .TP .B \-log_magstep step افزایش درخشش یک ستاره به میزان 10^step به ازای هر واحد کاهش عدد صحیح در قدر. مقدار پیش‌فرض 0.4 است. این بدان معناست که ستاره‌ای با قدر 2 به میزان 10^0.4 (حدود 2.5) برابر درخشان‌تر از ستاره‌ای با قدر 3 است. عدد بزرگ‌تر ستاره‌ها را درخشان‌تر می‌کند. .TP .B \-longitude longitude قرار دادن ناظر در بالای طول جغرافیایی مشخص‌شده (بر حسب درجه). طول جغرافیایی به سمت شرق مثبت و به سمت غرب منفی است (برای زمین و ماه)، بنابراین برای نمونه لس‌آنجلس در \-118 یا 242 قرار دارد. مقدار پیش‌فرض 0 است. .TP .B \-make_cloud_maps اگر ورودی برای cloud_map در فایل پیکربندی وجود داشته باشد، xplanet یک تصویر روز و یک تصویر شب با پوشش ابر خروجی داده و سپس خارج می‌شود. تصاویر در دایرکتوری مشخص‌شده توسط .B \-tmpdir یا در دایرکتوری فعلی (در صورت عدم استفاده از .BR \-tmpdir ) ایجاد خواهند شد. نام تصاویر خروجی به طور پیش‌فرض day_clouds.jpg و night_clouds.jpg است، اما با گزینه .B \-output قابل تغییر است. اگر .B "\-output filename.extension" مشخص شود، نام تصاویر خروجی "day_filename.extension" و "night_filename.extension" خواهد بود. ابعاد تصاویر خروجی برابر با تصویر روز است. .TP .B \-marker_file تعیین فایلی شامل داده‌های نشانه‌گذار (marker) تعریف‌شده توسط کاربر برای نمایش در پس‌زمینه ستارگان. قالب هر خط عموماً به صورت میل (declination)، بعد (right ascension) و رشته متنی است، همانند مثال زیر: .nf .sp \-16.7161 6.7525 "Sirius" .sp .fi برای گزینه‌های اضافی که ممکن است مشخص شوند، مدخل marker_file را در README.config ببینید. در صورت مشخص شدن .B \-projection این گزینه هیچ تاثیری ندارد. این گزینه برای نشانه‌گذارهای شهری در نظر گرفته نشده است؛ برای آن منظور از گزینه marker_file در فایل پیکربندی استفاده کنید. .TP .B \-markerbounds filename نوشتن مختصات کادر احاطه‌کننده (bounding box) برای هر نشانه‌گذار در filename. این قابلیت اگر از xplanet برای ساخت نقشه‌های تصویری (imagemaps) صفحات وب استفاده می‌کنید می‌تواند مفید باشد. هر خط مانند نمونه زیر است: .nf .sp 204,312 277,324 Los Angeles .sp .fi که در آن مختصات مربوط به گوشه‌های بالا سمت چپ و پایین سمت راست کادر هستند. این فایل در هر بار رندر کردن تصویر توسط xplanet مجدداً بازنویسی می‌شود. .TP .B \-north north_type این گزینه تصویر را به گونه‌ای می‌چرخاند که بالای تصویر به سمت north_type اشاره کند. مقادیر معتبر برای north_type عبارتند از: .nf .sp body: body's north pole galactic: galactic north pole orbit: body's orbital north pole (perpendicular to the orbit plane) path: origin's velocity vector (also see \-path_relative_to option) separation: perpendicular to the line of sight and the target-separation target line (see \-separation option) .sp .fi مقدار پیش‌فرض "body" است. .TP .B \-num_times num_times اجرا به تعداد num_times قبل از خروج. مقدار پیش‌فرض، اجرای نامحدود است. .TP .B \-origin body قرار دادن ناظر در مرکز جرم مشخص‌شده. مقادیر معتبر مشابه مقادیر .B \-target هستند. علاوه بر این، مقادیر "above" (بالا)، "below" (پایین) یا "system" (سیستم) نیز می‌توانند مشخص شوند. استفاده از "above" یا "below" نما را روی جرم اصلی (primary) آن متمرکز می‌کند و میدان دید به اندازه‌ای وسیع است که مدار جرم را نشان دهد. استفاده از "system" ناظر را در مرکز یک جرم تصادفی در همان سامانه جرم هدف قرار می‌دهد. دو جرم در یک سامانه هستند اگر یکی از شروط زیر برقرار باشد: .nf .sp 1) target and origin have same primary 2) target is origin's primary 3) origin is target's primary .sp .fi اگر قبل از نام جرم یک خط تیره قرار گیرد، ناظر در سمت مقابل هدف نسبت به جرم مشخص‌شده و در فاصله‌ای برابر با فاصله بین هدف و جرم قرار می‌گیرد. برای نمونه، .B "\-target earth \-origin sun" ناظر را در مرکز خورشید قرار می‌دهد. اگر از .B "\-target earth \-origin \-sun" استفاده شود، ناظر روی خط واصل مراکز زمین و خورشید و در فاصله ۱ واحد نجومی (AU) دورتر از خورشید نسبت به زمین قرار می‌گیرد. .TP .B \-origin_file origin_file تعیین فهرستی از موقعیت‌های ناظر در origin_file. موقعیت‌ها نسبت به جرمی هستند که با .B \-origin مشخص شده است (به طور پیش‌فرض خورشید). هر خط باید به این صورت باشد: .nf .sp YYYYMMDD.HHMMSS range lat lon localtime .sp .fi برای نمونه، .nf .sp 19951207.120000 10.328 \-3.018 97.709 9.595 .sp .fi مقدار range بر حسب شعاع سیاره و lat و lon بر حسب درجه هستند. تاریخ تنها مقدار الزامی است. در صورت ارائه localtime (بر حسب ساعت)، به جای طول جغرافیایی استفاده خواهد شد. برای هر خط در فایل مبدا، ناظر در موقعیت مشخص‌شده نسبت به جرمی که با .B \-origin تعیین شده قرار می‌گیرد. این گزینه برای نمایش پروازهای کناری فضاپیما (flybys) یا گردش در مدار یک سیاره مفید است. هر خطی که ستون اول آن علامت # داشته باشد نادیده گرفته می‌شود. .TP .B \-output filename خروجی دادن به یک فایل به جای رندر در یک پنجره. قالب فایل از پسوند آن تشخیص داده می‌شود. در حال حاضر در صورتی که xplanet با کتابخانه‌های مناسب کامپایل شده باشد، تصاویر .gif، .jpg، .ppm، .png و .tiff قابل ایجاد هستند. اندازه تصویر به طور پیش‌فرض 512 در 512 پیکسل است اما می‌تواند با فلگ .B \-geometry تغییر کند. در صورت استفاده با گزینه .BR \-num_times ، هر فایل خروجی به صورت ترتیبی شماره‌گذاری خواهد شد. .TP .B \-output_map filename خروجی دادن نقشه مستطیلی میانی که در فرآیند رندر تصویر نهایی ایجاد می‌شود. این نقشه دارای همان ابعاد نقشه پیش‌فرض روز خواهد بود. .TP .B \-output_start_index index شروع شماره‌گذاری فایل‌های خروجی از مقدار index. مقدار پیش‌فرض 0 است. .TP .B \-pango استفاده از کتابخانه Pango (نشانی http://www.pango.org ) برای رندر متن‌های بین‌المللی‌شده. پنگو از یونیکد برای تمام کدگذاری‌های خود استفاده می‌کند و در نهایت از خروجی در تمام زبان‌های اصلی جهان پشتیبانی خواهد کرد. اگر xplanet با این کتابخانه کامپایل نشده باشد، این گزینه نادیده گرفته خواهد شد. به نظر می‌رسد نشت حافظه در کتابخانه pango وجود دارد، بنابراین توصیه نمی‌شود اجازه دهید xplanet با این گزینه به طور نامحدود اجرا شود. .TP .B \-path_relative_to body تنها همراه با .B \-north path یا .B \-target path استفاده می‌شود. بردار سرعت مبدا نسبت به جرم مشخص‌شده محاسبه می‌شود. به طور پیش‌فرض، این جرم خورشید است. .TP .B \-post_command command .TP .B \-prev_command command اجرای دستور command قبل یا بعد از هر بار رندر تصویر توسط xplanet. در MS Windows ممکن است لازم باشد از مسیرهایی با سبک یونیکس استفاده کنید. برای نمونه: .nf .sp xplanet.exe \-prev_command ./prev.bat .sp .fi .TP .B \-print_ephemeris چاپ مختصات استوایی مستطیلی خورشیدمرکزی (J2000) برای هر جرمی که xplanet می‌شناسد، و سپس خروج. .TP .B \-projection projection_type نوع تصویرسازی (projection) می‌تواند یکی از موارد ancient، azimuthal، bonne، equal_area، gnomonic، hemisphere، lambert، mercator، mollweide، orthographic، peters، polyconic، rectangular یا tsc باشد. حالت پیش‌فرض بدون تصویرسازی است. در صورت مشخص شدن این گزینه، چند جرم به طور همزمان نمایش داده نخواهند شد، اگرچه سایه‌ها همچنان رسم می‌شوند. .TP .B \-proj_param value ارسال پارامترهای اضافی برای برخی از انواع تصویرسازی. تنها تصویرسازی‌هایی که در حال حاضر از این گزینه استفاده می‌کنند، تصویرسازی‌های Bonne، Gnomonic و Mercator هستند. تصویرسازی Bonne در عرض جغرافیایی مشخص‌شده هم‌شکل (conformal) است. مقادیر بالاتر منجر به شکل قلبی باریک‌تر می‌شوند. مقدار پیش‌فرض 50 درجه است. تصویرسازی‌های Gnomonic و Mercator از عرض جغرافیایی مشخص‌شده به عنوان مرزهای تصویرسازی استفاده می‌کنند. مقادیر پیش‌فرض به ترتیب 45 و 80 درجه هستند. این گزینه ممکن است برای تصویرسازی‌های آینده که نیازمند پارامترهای اضافی باشند بیش از یک بار استفاده شود. در حال حاضر فقط اولین مقدار استفاده می‌شود. .TP .B \-quality quality این گزینه تنها هنگام ایجاد تصاویر JPEG استفاده می‌شود. کیفیت می‌تواند از 0 تا 100 متغیر باشد. مقدار پیش‌فرض 80 است. .TP .B \-radius radius تعیین شعاع کره به صورت درصدی از ارتفاع صفحه نمایش. مقدار پیش‌فرض 45٪ ارتفاع صفحه نمایش است. هنگام رسم زحل، مقدار شعاع روی شعاع حلقه بیرونی اعمال می‌شود. .TP .B \-random قرار دادن ناظر در یک عرض و طول جغرافیایی تصادفی. .TP .B \-range range رندر کره از نمای فاصله‌ای به اندازه range از مرکز سیاره، بر حسب واحدهای شعاع سیاره. مقدار پیش‌فرض 1000 است. توجه داشته باشید که اگر از فاصله‌های بسیار نزدیک استفاده کنید، میدان دید صفحه می‌تواند بیشتر از 180 درجه باشد! اگر تصویری «از فاصله نزدیک» می‌خواهید از گزینه .B \-radius استفاده کنید. .TP .B \-rotate angle چرخش کره به میزان angle درجه در خلاف جهت عقربه‌های ساعت تا جهت شمال (همان‌طور که توسط آرگومان .B \-north تعریف شده است) در بالا قرار نگیرد. مقدار پیش‌فرض 0 است. کاربران نیمکره جنوبی می‌توانند از .B \-rotate 180 استفاده کنند تا زمین به همان شکلی که باید به نظر برسد دیده شود! برای تصویرسازی‌های غیرارتوگرافیک، کره ابتدا چرخانده شده و سپس تصویرسازی می‌شود. .TP .B \-save_desktop_file در مایکروسافت ویندوز و مک OS X، برنامه xplanet یک فایل تصویر واسط ایجاد می‌کند که برای تنظیم پس‌زمینه میزکار استفاده می‌شود. این فایل در دایرکتوری .B \-tmpdir ایجاد خواهد شد. به طور پیش‌فرض، این تصویر پس از تنظیم میزکار حذف می‌شود. مشخص کردن این گزینه فایل را در جای خود باقی می‌گذارد. .TP .B \-searchdir directory هر فایلی که توسط xplanet استفاده می‌شود باید بسته به نوع آن در یکی از دایرکتوری‌های زیر قرار گیرد: "arcs"، "config"، "ephemeris"، "fonts"، "images"، "markers"، "origin"، "satellites" یا "stars". به طور پیش‌فرض، xplanet برای یافتن یک فایل به ترتیب زیر جستجو می‌کند: .nf .sp The current directory searchdir subdirectories of searchdir subdirectories of xplanet (if it exists in the current directory) subdirectories of ${HOME}/.xplanet on X11 subdirectories of ${HOME}/Library/Xplanet on Mac OS X subdirectories of DATADIR/xplanet .sp .fi مقدار DATADIR در زمان کامپایل تنظیم شده و مقدار پیش‌فرض آن /usr/local/share است. .TP .B \-separation body:dist قرار دادن ناظر در موقعیتی که در آن جرم هدف و جرم تفکیک (separation body) به اندازه dist درجه از هم فاصله دارند. برای نمونه .B "\-target earth \-separation moon:-3" به معنای قرار دادن ناظر در موقعیتی است که در آن ماه ۳ درجه در سمت چپ زمین دیده می‌شود. .TP .B \-spice_ephemeris index استفاده از کرネル‌های SPICE برای محاسبه موقعیت جرم نام‌برده‌شده. مقدار index کد شناسه NAIF است (برای نمونه 599 برای مشتری). برای ارائه نام فایل‌های کرネル باید از گزینه .B \-spice_file استفاده شود. این گزینه می‌تواند بیش از یک بار برای اجرام مختلف استفاده شود. .TP .B \-spice_file spice_file مشخص کردن فایلی شامل فهرستی از اشیاء جهت نمایش. فایلی حاوی فهرستی از کرネル‌های SPICE برای خواندن به نام spice_file.krn باید در کنار spice_file وجود داشته باشد. برای اطلاعات بیشتر فایل README در زیرشاخه "spice" را ببینید. .TP .B \-starfreq frequency کسری از پیکسل‌های پس‌زمینه که به رنگ سفید درمی‌آیند. مقدار پیش‌فرض 0.001 است. این گزینه تنها همراه با تصویرسازی‌های سمتی (azimuthal)، ملواید (mollweide)، ارتوگرافیک (orthographic) و پیترز (peters) دارای معنی است. .TP .B \-starmap starmap استفاده از starmap برای رسم ستاره‌های پس‌زمینه. این فایل باید یک فایل متنی باشد که هر خط آن دارای ساختار زیر است: .nf .sp Declination, Right Ascension, Magnitude .sp .fi که در آن Declination (میل) بر حسب درجات اعشاری و Right Ascension (بُعد) بر حسب ساعات اعشاری است. برای نمونه، مدخل مربوط به ستاره شباهنگ (Sirius) عبارت است از: .nf .sp \-16.7161 6.7525 \-1.46 .sp .fi برای مشاهده مکان‌هایی که xplanet جهت یافتن نقشه ستاره‌ها جستجو می‌کند، توضیحات .B \-searchdir را ببینید. .TP .B \-target target مشابه .BR \-body . .TP .B \-tt استفاده از زمان زمینی (terrestrial time) به جای زمان هماهنگ جهانی (universal time). این دو به دلیل چرخش ناهمگون زمین اندکی با هم تفاوت دارند. حالت پیش‌فرض استفاده از زمان هماهنگ جهانی است. .TP .B \-timewarp مشابه xearth، سرعت ظاهری گذر زمان را بر اساس ضریب مقیاس‌بندی می‌کند. مقدار پیش‌فرض 1 است. .TP .B \-tmpdir tmpdir تعیین دایرکتوری که xplanet برای قرار دادن تصاویر ایجادشده با .B \-make_cloud_maps استفاده خواهد کرد. در مایکروسافت ویندوز، xplanet یک فایل بیت‌مپ به نام xplanet.bmp در دایرکتوری مشخص‌شده می‌نویسد. مقدار پیش‌فرض نتیجه فراخوانی تابع GetWindowsDirectory است (C:\(rsWINDOWS در Win95). در مک OS X، برنامه xplanet یک فایل واسط PNG برای تنظیم پس‌زمینه ایجاد می‌کند. مقدار پیش‌فرض /tmp است. در ویندوز و مک OS X، فایل واسط حذف خواهد شد مگر اینکه گزینه .B \-save_desktop_file مشخص شده باشد. .TP .B \-transparency به‌روزرسانی نقشه پیکسلی پس‌زمینه برای ترمینال‌های شفاف Eterm و aterm. این گزینه فقط تحت X11 کار می‌کند. .TP .B \-transpng filename مشابه گزینه .BR \-output ، با این تفاوت که هنگام نوشتن یک فایل PNG، پس‌زمینه را شفاف (transparent) تنظیم می‌کند. .TP .B \-utclabel مشابه .BR \-gmtlabel . .TP .B \-verbosity level .nf .sp level output < 0 only fatal error messages 0 non-fatal warning messages 1 basic information 2 basic diagnostics 3 more detailed diagnostics 4 very detailed diagnostics .sp .fi مقدار پیش‌فرض 0 است. .TP .B \-version نمایش اطلاعات نسخه جاری، همراه با فهرستی از گزینه‌های زمان کامپایل که xplanet از آن‌ها پشتیبانی می‌کند. .TP .B \-vroot رندر تصویر در پنجره ریشه مجازی (virtual root window). برخی از مدیران پنجره از یک پنجره بزرگ که روی پنجره ریشه واقعی قرار می‌گیرد به عنوان پنجره پس‌زمینه خود استفاده می‌کنند. همچنین Xscreensaver از یک پنجره ریشه مجازی برای پوشش دادن صفحه نمایش استفاده می‌کند. .TP .B \-wait wait به‌روزرسانی در هر wait ثانیه. .TP .B \-window رندر تصویر در پنجره اختصاصی X متعلق به خود. اندازه به طور پیش‌فرض 512 در 512 پیکسل است اما می‌تواند توسط فلگ .B \-geometry تنظیم شود. .TP .B \-window-id ID هنگام استفاده از سامانه پنجره‌بندی X11، رسم تصویر در پنجره‌ای با شناسه مشخص‌شده (ID). .TP .B \-window_title title تنظیم عنوان پنجره به title. این گزینه به طور ضمنی شامل .B \-window نیز می‌شود. .TP .B \-XID ID مشابه .BR \-window-id . .TP .B \-xscreensaver مشابه .BR \-vroot .