-
Notifications
You must be signed in to change notification settings - Fork 0
/
pktriggercord-cli.1
327 lines (327 loc) · 8.75 KB
/
pktriggercord-cli.1
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
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
.TH "PKTRIGGERCORD" "1"
.HEAD <STYLE type="text/css"> h3 { margin-left: 5%} </STYLE>
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.SH "NAME"
pktriggercord-cli - command-line Pentax DSLR tethering software
.SH "SYNOPSIS"
.SY pktriggercord-cli
.OP \-\-model CAMERA_MODEL
.OP \-\-device DEVICE
.OP \-\-timeout SECONDS
.OP \-\-exposure_mode MODE
.OP \-\-exposure_compensation VALUE
.OP \-\-drive_mode DRIVE_MODE
.OP \-\-flash_mode FLASH_MODE
.OP \-\-flash_exposure_compensation VALUE
.OP \-\-iso ISO
.OP \-\-aperture APERTURE
.OP \-\-shutter_speed SHUTTER_SPEED
.OP \-\-af_mode AF_MODE
.OP \-\-select_af_point AF_SELECT_MODE
.OP \-\-ae_metering AE_METERING
.OP \-\-resolution RESOLUTION
.OP \-\-quality QUALITY
.OP \-\-jpeg_image_tone IMAGE_TONE
.OP \-\-white_balance_mode WB_MODE
.OP \-\-white_balance_adjustment WB_ADJ
.OP \-\-auto_focus
.OP \-\-reconnect
.OP \-\-green
[\fB\-\-warnings\fR | \fB\-\-nowarnings\fR ]
[\fB\-\-version\fR | \fB\-\-help\fR | \fB\-\-dust_removal\fR | \fB\-\-status\fR |
\fB\-\-status_hex\fR | \fB\-\-frames\fR NUMBER [ \fB\-\-delay\fR
SECONDS] | \fB\-\-noshutter\fR | \fB\-\-servermode\fR |
\fB\-\-pentax_debug_mode\fR VALUE]
[ \fB\-\-file_format\fR FORMAT ] [ \fB\-\-output_file\fR FILENAME ]
.OP \-\-debug
.YS
.PP
Syntax shows only long option names.
.SH "DESCRIPTION"
.PP
.URL http://pktriggercord.sourceforge.net pkTriggerCord
.HTML <!--
pkTriggerCord
.HTML -->
is a cross\-platform Pentax DSLR tethering software, and
pktriggercord-cli is a command\-line client for it\.
.HnS 2
.SS Connection
.HnE
.PP
By default the software connects to the first available Pentax camera\.
.PP
\fB\-\-model \fR\fB\fICAMERA_MODEL\fR
.RS 4
Specify the camera model. Useful if more than one camera is connected.
Valid ( case-insensitive ) values are: K20d, K10d, GX10, GX20, K-X,
K200D, K-7, K-r, K-5, K-2000, K-m, K-30, K100D, K110D, K-01, K-5II, K-5IIs\.
.RE
.PP
\fB\-\-device \fR\fB\fIDEVICE\fR
.RS 4
Specify the device. Useful if more than one camera is connected.
Valid ( case-sensitive ) values are depend on the operating system.
Valid values for Linux: sg0, sg1, ..., for Windows: C, D, E, ...\.
.RE
.PP
\fB\-\-timeout \fR\fB\fISECONDS\fR
.RS 4
Specify the timeout in seconds for camera connection. 0 means no
timeout, the program will wait forever. By default there is no
timeout.
.RE
.HnS 2
.SS Work mode
.HnE
.PP
Without specifying work mode the program takes 1 picture.
.PP
\fB\-F\fR, \fB\-\-frames\fR
.RS 4
Specify the number of shots. Maximum number of pictures is 10000.
.RE
.PP
\fB\-d\fR, \fB\-\-delay \fR\fB\fISECONDS\fR\fR
.RS 4
Specify the delay between the shots (if number of frames is greater
than 1). The minimum delay is based on several factors, approximately
3 seconds\. If auto bracketing is set there is only delay after
bracketing groups.
.RE
.PP
\fB\-f\fR, \fB\-\-auto_focus\fR
.RS 4
Autofocus before first shot.
.RE
.PP
\fB\-\-reconnect\fR
.RS 4
Reconnect between shots. Might solve image artifact problems.
.RE
.PP
\fB\-g\fR, \fB\-\-green\fR
.RS 4
Green button before first shot.
.RE
.PP
\fB\-s\fR, \fB\-\-status\fR
.RS 4
Print human readable status info and do not take pictures.
.RE
.PP
\fB\-\-status_hex\fR
.RS 4
Print raw (hexadecimal) and human readable status info and do not take pictures\.
.RE
.PP
\fB\-\-noshutter\fR
.RS 4
Do not send shutter command just wait for new images. Shutter should be
released by using a cable release or by pressing the shutter button of
the camera. The latter does not work for all camera models\.
.RE
.PP
\fB\-\-dust_removal\fR
.RS 4
Initiate dust removal process\.
.RE
.PP
\fB\-\-servermode\fR
.RS 4
The program waits for commands (TODO: describe command) using port
number 8888. The program ends if no client connects for 15 seconds\.
.RE
.PP
\fB\-\-pentax_debug_mode VALUE\fR
.RS 4
Enable (VALUE=1) or disable (VALUE=0) the camera debug mode. This is
DANGEROUS, use it only if you know camera debug mode.\.
.RE
.HnS 2
.SS Setting exposure parameters
.HnE
.PP
\fB-w\fR, \fB\-\-warnings\fR
.RS 4
Specify warning mode. The program prints out warning messages if the
settings are invalid. It will not stop since the camera can fix most
of the invalid settings. For instance specifying -iso 796 will change the iso to 800\.
.RE
.PP
\fB\-\-nowarnings\fR
.RS 4
Turns off warning mode\.
.RE
.PP
\fB\-m\fR, \fB\-\-exposure_mode\fR \fIEXPOSURE_MODE\fR
.RS 4
Specify exposure mode. Does NOT work correctly. Please do not use it.
.RE
.PP
\fB\-i\fR, \fB\-\-iso\fR \fIISO\fR
.RS 4
Specify ISO settings. Single value (400) or interval (200-800) can be used\.
.RE
.PP
\fB\-a\fR, \fB\-\-aperture\fR \fIAPERTURE\fR
.RS 4
Specify aperture. Sample valid valus: 2.8, 5.6, 11 (depends on the lens).
.RE
.PP
\fB\-t\fR, \fB\-\-shutter_speed\fR \fISHUTTER_SPEED\fR
.RS 4
Specify shutter speed\. Value should be specified in the following
format: 1/50, 1/500, ...
Values greater than 30 sec only allowed if Bulb mode is already set.
.RE
.PP
\fB\-\-af_mode\fR \fIAF_MODE\fR
.RS 4
Specify the autofocus mode. Valid values are: AF.S, AF.C, AF.A\.
.RE
.PP
\fB\-\-select_af_point\fR \fIAF_SELECT_MODE\fR
.RS 4
Specify the autofocus point selection mode. Valid values are: Auto-5, Auto-11, Select, Spot\.
.RE
.PP
\fB\-\-ae_metering\fR \fIAE_METERING\fR
.RS 4
Specify the autoexposure metering mode. Valid values are: Multi, Center, Spot\.
.RE
.PP
\fB\-\-exposure_correction\fR \fIVALUE\fR
.RS 4
Specify exposure compensation value.
.RE
.PP
\fB\-\-drive_mode\fR \fIDRIVE_MODE\fR
.RS 4
Specify the drive mode. Valid values are: Single, Continuous-HI, SelfTimer-12, SelfTimer-2, Remote, Remote-3, Continuous-LO\.
.RE
.PP
\fB\-\-flash_mode\fR \fIFLASH_MODE\fR
.RS 4
Specify the flash mode. Valid values are: Manual, Manual-RedEye, Slow, Slow-RedEye, TrailingCurtain, Auto, Auto-RedEye, Wireless\.
.RE
.PP
\fB\-\-flash_exposure_correction\fR \fIVALUE\fR
.RS 4
Specify flash exposure compensation value.
.RE
.HnS 2
.SS Output file specification
.HnE
.PP
\fB\-o\fR,\fB\-\-output_file\fR \fIFILENAME\fR
.RS 4
Specify the name of the output file prefix. Frame number and
extension will be automatically added. If not specified the file will
be sent to standard output\.
.RE
.PP
\fB\-\-file_format\fR \fIFORMAT\fR
.RS 4
Specify the output file format. Valid values are: PEF, DNG, JPEG. It
also changes the default file format in the camera\.
.RE
.PP
\fB\-\-color_space\fR \fICOLOR_SPACE\fR
.RS 4
Specify the color space. Valid values are: sRGB, AdobeRGB\.
.RE
.PP
\fB\-q\fR,\fB\-\-quality\fR \fIQUALITY\fR
.RS 4
Specify jpeg quality using the 'star' rating of the camera. 1, 2, 3 can be used for all the cameras, for some cameras 4 is also allowed. It also changes the jpeg quality in the camera\.
.RE
.PP
\fB\-r\fR,\fB\-\-resolution\fR \fIRESOLUTION\fR
.RS 4
Specify jpeg resolution. While this changes the jpeg resolution setting in the camera, it will not affect the resolution of the downloaded jpeg file. (it's a bug)\.
.RE
.PP
\fB\-\-jpeg_image_tone\fR \fIIMAGE_TONE\fR
.RS 4
Specify the jpeg image tone. Valid values are: Natural, Bright,
Portrait, Landscape, Vibrant, Monochrome, Muted,
ReversalFilm\. Currently this setting is temporary, picture taking
restores it back to the original, so it's quite useless\.
.RE
.PP
\fB\-\-white_balance_mode\fR \fIWB_MODE\fR
.RS 4
Specify the white balance mode. Valid values are: Auto, Daylight,
Shade, Cloudy, Fluorescent_D, Fluorescent_N, Fluorescent_W,
Fluorescent_L, Tungsten, Flash, Manual, CTE\.
.RE
.PP
\fB\-\-white_balance_adjustment\fR \fIWB_ADJ\fR
.RS 4
Specify the white balance adjustment. Valid values like: G5B2, G3A5, B5, A3, G5, M4\.
.RE
.HnS 2
.SS Other
.HnE
.PP
\fB\-v\fR, \fB\-\-version\fR
.RS 4
Display version and exit\.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
Display a short usage message\.
.RE
.PP
\fB\-\-debug\fR
.RS 4
Debug info\.
.RE
.SH "SEE ALSO"
.PP
\fIThe pktriggercord.sourceforge.net website\fR\&[1],
.SH "EXAMPLES"
.PP
.CDS
\fBpktriggercord\-cli\fR \fB\-\-status\fR\fR
.CDE
.RS 4
Connects to the camera and prints out status info\.
.RE
.PP
.CDS
\fBpktriggercord\-cli\fR \fB\-\-status_hex\fR\fR
.CDE
.RS 4
Connects to the camera and prints out hexadecimal and human-readable status info\.
.RE
.PP
To track down errors, you can add the
\fB\-\-debug\fR
parameter to the
\fBpktriggercord-cli\fR
command line\.
.\" .SH "AUTHORS"
.\" .PP
.\" \fBAndras Salamon\fR
.\" .sp -1n
.\" .IP "" 4
.\" Author.
.SH "NOTES"
.IP " 1." 4
.HTML <!--
The pktriggercord.sourceforge.net website
.HTML -->
.RS 4
.HTML <!--
http://pktriggercord.sourceforge.net/
.HTML -->
.URL http://pktriggercord.sourceforge.net/ http://pktriggercord.sourceforge.net/
.RE
.HR
.HTML <p>If you need more info, please go to the <a href="http://sourceforge.net/projects/pktriggercord">project page</a></p> <hr /> <p> <a href="http://sourceforge.net/projects/pktriggercord"><img src="http://sflogo.sourceforge.net/sflogo.php?group_id=394488&type=13" width="120" height="30" alt="pkTriggerCord at SourceForge"/></a></p>