manpages

pktriggercord-cli(1)

PKTRIGGERCORD(1) General Commands Manual PKTRIGGERCORD(1)

NAME

pktriggercord-cli - command-line Pentax DSLR tethering software

SYNOPSIS

pktriggercord-cli [--exposure_mode MODE] [--exposure_compensation VALUE] [--drive_mode DRIVE_MODE] [--flash_mode FLASH_MODE] [--flash_exposure_compensation VALUE] [--iso ISO] [--aperture APERTURE] [--shutter_speed SHUTTER_SPEED] [--af_mode AF_MODE] [--select_af_point AF_SELECT_MODE] [--ae_metering AE_METERING] [--resolution RESOLUTION] [--quality QUALITY] [--jpeg_image_tone IMAGE_TONE] [--white_balance_mode WB_MODE] [--white_balance_adjustment WB_ADJ] [--auto_focus] [--green] [--warnings] [--version | --help | --dust_removal | --status | --status_hex | --frames NUMBER [ --delay SECONDS] ] [ --file_format FORMAT ] [ --output_file FILENAME ] [--debug]

Syntax shows only long option names.

DESCRIPTION

pkTriggerCord is a cross-platform Pentax DSLR tethering software, and pktriggercord-cli is a command-line client for it.

Work mode

Without specifying work mode the program takes 1 picture.

-F, --frames

Specify the number of shots. Maximum number of pictures is 10000.

-d, --delay SECONDS

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.

-f, --auto_focus

Autofocus before first shot.

-g, --green

Green button before first shot.

-s, --status

Print human readable status info and do not take pictures.

--status_hex

Print raw (hexadecimal) and human readable status info and do not take pictures.

--dust_removal

Initiate dust removal process.

Setting exposure parameters

-w, --warnings

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.

-m, --exposure_mode EXPOSURE_MODE

Specify exposure mode. Does NOT work correctly. Please do not use it.

-i, --iso ISO

Specify ISO settings. Single value (400) or interval (200-800) can be used.

-a, --aperture APERTURE

Specify aperture. Sample valid valus: 2.8, 5.6, 11 (depends on the lens).

-t, --shutter_speed SHUTTER_SPEED

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.

--af_mode AF_MODE

Specify the autofocus mode. Valid values are: AF.S, AF.C, AF.A.

--select_af_point AF_SELECT_MODE

Specify the autofocus point selection mode. Valid values are: Auto-5, Auto-11, Select, Spot.

--ae_metering AE_METERING

Specify the autoexposure metering mode. Valid values are: Multi, Center, Spot.

--exposure_correction VALUE

Specify exposure compensation value.

--drive_mode DRIVE_MODE

Specify the drive mode. Valid values are: Single, Continuous-HI, SelfTimer-12, SelfTimer-2, Remote, Remote-3, Continuous-LO.

--flash_mode FLASH_MODE

Specify the flash mode. Valid values are: Manual, Manual-RedEye, Slow, Slow-RedEye, TrailingCurtain, Auto, Auto-RedEye, Wireless.

--flash_exposure_correction VALUE

Specify flash exposure compensation value.

Output file specification

-o,--output_file FILENAME

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.

--file_format FORMAT

Specify the output file format. Valid values are: PEF, DNG, JPEG. It also changes the default file format in the camera.

--color_space COLOR_SPACE

Specify the color space. Valid values are: sRGB, AdobeRGB.

-q,--quality QUALITY

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.

-r,--resolution RESOLUTION

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).

--jpeg_image_tone IMAGE_TONE

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.

--white_balance_mode WB_MODE

Specify the white balance mode. Valid values are: Auto, Daylight, Shade, Cloudy, Fluorescent_D, Fluorescent_N, Fluorescent_W, Fluorescent_L, Tungsten, Flash, Manual, CTE.

--white_balance_adjustment WB_ADJ

Specify the white balance adjustment. Valid values like: G5B2, G3A5, B5, A3, G5, M4.

Other

-v, --version

Display version and exit.

-h, --help

Display a short usage message.

--debug

Debug info.

SEE ALSO

The pktriggercord.sourceforge.net website[1],

EXAMPLES

pktriggercord-cli --status

Connects to the camera and prints out status info.

pktriggercord-cli --status_hex

Connects to the camera and prints out hexadecimal and human-readable status info.

To track down errors, you can add the --debug parameter to the pktriggercord-cli command line.

NOTES

1.
The pktriggercord.sourceforge.net website
http://pktriggercord.sourceforge.net/