forked from ikarustechnologies/stellarmatewebmanual
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Command-LinemodeforImageGenerati.html
253 lines (190 loc) · 11.7 KB
/
Command-LinemodeforImageGenerati.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
<!DOCTYPE html>
<link href="https://fonts.googleapis.com/css2?family=Inter" rel="stylesheet">
<html lang="en">
<head>
<meta charset="utf-8" />
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="generator" content="HelpNDoc Professional Edition 6.9.0.577">
<meta name="viewport" content="width=device-width, initial-scale=1" />
<link rel="icon" href="favicon.ico"/>
<title>Command-Line mode for Image Generation</title>
<meta name="description" content="" />
<meta name="keywords" content="">
<!-- Twitter Card data -->
<meta name="twitter:card" content="summary">
<meta name="twitter:title" content="Command-Line mode for Image Generation">
<meta name="twitter:description" content="">
<!-- Open Graph data -->
<meta property="og:title" content="Command-Line mode for Image Generation" />
<meta property="og:type" content="article" />
<meta property="og:description" content="" />
<meta property="og:site_name" content="The StellarMate Plus Manual" />
<!-- Bootstrap core CSS -->
<link href="vendors/bootstrap-3.4.1/css/bootstrap.min.css" rel="stylesheet"/>
<!-- IE10 viewport hack for Surface/desktop Windows 8 bug -->
<link href="vendors/bootstrap-3.4.1/css/ie10-viewport-bug-workaround.css" rel="stylesheet"/>
<!-- HTML5 shim and Respond.js for IE8 support of HTML5 elements and media queries -->
<!--[if lt IE 9]>
<script src="vendors/html5shiv-3.7.3/html5shiv.min.js"></script>
<script src="vendors/respond-1.4.2/respond.min.js"></script>
<![endif]-->
<!-- JsTree styles -->
<link href="vendors/jstree-3.3.7/themes/default/style.min.css" rel="stylesheet"/>
<!-- Hnd styles -->
<link href="css/layout.min.css" rel="stylesheet" />
<link href="css/effects.min.css" rel="stylesheet" />
<link href="css/theme-light-blue.min.css" rel="stylesheet" />
<link href="css/print.min.css" rel="stylesheet" media="print" />
<style type="text/css">nav { width: 350px} @media screen and (min-width:769px) { body.md-nav-expanded div#main { margin-left: 350px} body.md-nav-expanded header { padding-left: 364px} }</style>
<!-- Content style -->
<link href="css/hnd.content.css" rel="stylesheet" />
</head>
<body class="md-nav-expanded">
<div id="skip-link">
<a href="#main-content" class="element-invisible">Skip to main content</a>
</div>
<header class="headroom">
<button class="hnd-toggle btn btn-default">
<span class="sr-only">Toggle navigation</span>
<span class="icon-bar"></span><span class="icon-bar"></span><span class="icon-bar"></span>
</button>
<h1>The StellarMate Plus Manual</h1>
<a href="https://www.stellarmate.com"><img src="StellarMate_Logo_Text_Black.png" alt="logo" class="logo"/></a>
</header>
<nav class="md-nav-expanded">
<!-- Nav tabs -->
<ul class="tab-tabs nav nav-tabs" role="tablist">
<li id="nav-close">
<button class="hnd-toggle btn btn-default">
<span class="glyphicon glyphicon-remove" aria-hidden="true"></span>
</button>
</li>
<li role="presentation" class="tab active">
<a href="#contents" id="tab-contents" aria-controls="contents" role="tab" data-toggle="tab">
<i class="glyphicon glyphicon-list"></i>
Contents
</a>
</li>
<li role="presentation" class="tab">
<a href="#search" id="tab-search" aria-controls="search" role="tab" data-toggle="tab">
<i class="glyphicon glyphicon-search"></i>
Search
</a>
</li>
</ul> <!-- /Nav tabs -->
<!-- Tab panes -->
<div class="tab-content">
<div role="tabpanel" class="tab-pane active" id="contents">
<div id="toc" class="tree-container unselectable"
data-url="_toc.json"
data-openlvl="1"
>
</div>
</div> <!-- /contents-->
<div role="tabpanel" class="tab-pane" id="search">
<div class="search-content">
<div class="search-input">
<form id="search-form">
<div class="form-group">
<div class="input-group">
<input type="text" class="form-control" id="input-search" name="input-search" placeholder="Search..." />
<span class="input-group-btn">
<button class="btn btn-default" type="submit">
<span class="glyphicon glyphicon-search" aria-hidden="true"></span>
</button>
</span>
</div>
</div>
</form>
</div> <!-- /search-input -->
<div class="search-result">
<div id="search-info"></div>
<div class="tree-container unselectable" id="search-tree"></div>
</div> <!-- /search-result -->
</div> <!-- /search-content -->
</div> <!-- /search-->
</div> <!-- /Tab panes -->
</nav>
<div id="main">
<article>
<div id="topic-content" class="container-fluid"
data-hnd-id="Command-LinemodeforImageGenerati"
data-hnd-context="134"
data-hnd-title="Command-Line mode for Image Generation"
>
<div class="navigation">
<ol class="breadcrumb">
<li><a href="TheKStarsHandbook.html">The KStars Handbook</a></li>
</ol>
<div class="nav-arrows">
<div class="btn-group btn-group-xs" role="group"><a class="btn btn-default" href="TheKStarsHandbook.html" title="The KStars Handbook" role="button"><span class="glyphicon glyphicon-menu-up" aria-hidden="true"></span></a><a class="btn btn-default" href="FITSViewerTool.html" title="FITS Viewer Tool" role="button"><span class="glyphicon glyphicon-menu-left" aria-hidden="true"></span></a><a class="btn btn-default" href="QuestionsandAnswers.html" title="Questions and Answers" role="button"><span class="glyphicon glyphicon-menu-right" aria-hidden="true"></span></a></div>
</div>
</div>
<a id="main-content"></a>
<h2>Command-Line mode for Image Generation</h2>
<div class="main-content">
<p></p>
<p class="rvps10"><span class="rvts6">You can use KStars to generate an image of the sky without actually launching the GUI portion of the program. To use this feature, start KStars from a command prompt using arguments to specify the filename for the image, as well as the desired image dimensions:</span></p>
<p class="rvps10"><span class="rvts25">kstars</span><span class="rvts71"> --dump [--filename </span><span class="rvts72">kstars.png</span><span class="rvts71">] [--height </span><span class="rvts72">640</span><span class="rvts71">] [--width </span><span class="rvts72">480</span><span class="rvts71">] [--script </span><span class="rvts72">myscript.kstars</span><span class="rvts71">] [--date </span><span class="rvts72">"4 July 1976 12:30:00"</span><span class="rvts71">]</span></p>
<p class="rvps10"><span class="rvts6">If no filename is specified, it generates a file named </span><span class="rvts71">kstars.png</span><span class="rvts6">. It will attempt to generate an image that matches the extension of your filename. The following extensions are recognized: “png”, “jpg”, “jpeg”, “gif”, “pnm”, and “bmp”. If the filename extension is not recognized, it defaults to the PNG image type.</span></p>
<p class="rvps10"><span class="rvts6">Likewise, if the image width and height are not specified, they default to 640 and 480, respectively.</span></p>
<p class="rvps10"><span class="rvts6">By default, KStars will read in the options values stored in your </span><span class="rvts71">$KDEHOME/share/config/kstarsrc</span><span class="rvts6"> file to determine where the image will be centered, and how it is rendered. This means you need to run KStars in normal GUI mode, and exit the program when it is set up with the desired options for the generated images. This is not very flexible, so we also provide the ability to execute a KStars D-Bus script to set the scene before generating the image. The filename you specify as the script argument should be a valid KStars D-Bus script, such as one created with the </span><a class="rvts23" href="TheScriptBuilderTool.html">Script Builder Tool</a><span class="rvts6">. The script can be used to set where the image is pointing, set the geographic location, set the time and date, change the Zoom level, and adjust other view options. Some of the D-Bus functions make no sense in non-GUI mode (such as </span><span class="rvts71">waitForKey()</span><span class="rvts6">); if these functions are encountered while parsing the script, they are simply ignored.</span></p>
<p class="rvps10"><span class="rvts6">By default, KStars will use the system CPU time and date for generating the image. Alternatively, you may specify a time and date with the “--date” argument. You can also use this argument for specifying the startup date in normal GUI mode.</span></p>
<p></p>
</div>
<div id="topic_footer"><div id="topic_footer_content">Copyright © 2020 by Ikarus Technologies. All Rights Reserved.</div></div>
</div> <!-- /#topic-content -->
</article>
<footer></footer>
</div> <!-- /#main -->
<div class="mask" data-toggle="sm-nav-expanded"></div>
<!-- Modal -->
<div class="modal fade" id="hndModal" tabindex="-1" role="dialog" aria-labelledby="hndModalLabel">
<div class="modal-dialog" role="document">
<div class="modal-content">
<div class="modal-header">
<button type="button" class="close" data-dismiss="modal" aria-label="Close"><span aria-hidden="true">×</span></button>
<h4 class="modal-title" id="hndModalLabel"></h4>
</div>
<div class="modal-body">
</div>
<div class="modal-footer">
<button type="button" class="btn btn-primary modal-btn-close" data-dismiss="modal">Close</button>
</div>
</div>
</div>
</div>
<!-- Scripts -->
<script src="vendors/jquery-3.4.1/jquery.min.js"></script>
<script src="vendors/bootstrap-3.4.1/js/bootstrap.min.js"></script>
<script src="vendors/markjs-8.11.1/jquery.mark.min.js"></script>
<script src="vendors/uri-1.19.1/uri.min.js"></script>
<script src="vendors/imageMapResizer-1.0.7/imageMapResizer.min.js"></script>
<!-- IE10 viewport hack for Surface/desktop Windows 8 bug -->
<script src="vendors/bootstrap-3.4.1/js/ie10-viewport-bug-workaround.js"></script>
<!-- Headroom -->
<script src="vendors/headroom-0.9.4/headroom.min.js"></script>
<script src="vendors/headroom-0.9.4/jquery.headroom.min.js"></script>
<!-- JsTree -->
<script src="vendors/jstree-3.3.7/jstree.min.js"></script>
<!-- HelpNDoc scripts -->
<script src="_translations.js"></script>
<script src="js/hndsd.min.js"></script>
<script src="js/hndse.min.js"></script>
<script src="js/app.min.js"></script>
<!-- Scripts -->
<script>
$(function() {
// Create the app
var app = new Hnd.App();
// Update translations
hnd_ut(app);
// Instanciate imageMapResizer
imageMapResize();
// Custom JS
// Boot the app
app.Boot();
});
</script>
</body>
</html>