Usage¶

quark-ctl¶

Commandline tool to interact with a qtec camera.

quark-ctl [OPTIONS] COMMAND [ARGS]...

Options

--debug¶

--ip <ip>¶: IP for remote camera

--port <port>¶: Port for remote camera

--version¶: Show the version and exit.

auto-exposure¶

One-shot auto-exposure.

quark-ctl auto-exposure [OPTIONS]

Options

--device <device>¶: Device of which to reset the controls

--crop <crop>¶: LEFT TOP WIDTH HEIGHT - crop of current frame output to look at for auto exposure

--max-iterations <max_iterations>¶: Maximum number of frames to use for auto exposure

--target-value <target_value>¶: Specify a target value for the saturation value

config¶

Save/load/reset camera configuration.

quark-ctl config [OPTIONS] COMMAND [ARGS]...

load¶

Load a camera configuration.

This will fail if the camera is streaming.

If no CONTROLS are specified all controls (except protected ones) are saved

quark-ctl config load [OPTIONS] [CONTROLS]...

Options

--file <file>¶: File to save the configuration to. Default where VIDEO_NUM will be the number of the video device from /dev/qtec/videoX

--device <device>¶: Device to save configuration of

--no-controls¶: Ignore controls from configuration

--no-crop¶: Ignore crop from configuration

--no-format¶: Ignore format from configuration

--no-framerate¶: Ignore framerate from configuration

--include-protected-controls¶: ADC gain, black level or VRAMP are sensor specific and should almost never be touched. Load their values anyway.

Arguments

CONTROLS¶: Optional argument(s)

load-default-configs¶

Load configuration for all heads.

This will try to load the configuration for each head from /var/lib/qtec. NOTE: This function is used for the quark-init-load service to load configuration at boot.

quark-ctl config load-default-configs [OPTIONS]

reset-controls¶

Reset controls of a camera to their default values.

If no CONTROLS are specified all controls (except protected ones) are saved.

quark-ctl config reset-controls [OPTIONS] [CONTROLS]...

Options

--device <device>¶: Device of which to reset the controls

--include-protected-controls¶: ADC gain, black level or VRAMP are sensor specific and should almost never be touched. Reset their values anyway.

Arguments

CONTROLS¶: Optional argument(s)

save¶

Save camera configuration to a .json file.

If no CONTROLS are specified all controls (except protected ones) are saved

quark-ctl config save [OPTIONS] [CONTROLS]...

Options

--file <file>¶: File to save the configuration to. Default where VIDEO_NUM will be the number of the video device from /dev/qtec/videoX

--device <device>¶: Device to save configuration of

--no-controls¶: Don’t save any controls in configuration

--no-crop¶: Don’t save croppings in configuration

--no-format¶: Don’t save format in configuration

--no-framerate¶: Don’t save framerate in configuration

--include-protected-controls¶: ADC gain, black level or VRAMP are sensor specific and should almost never be touched. Save their values anyway.

Arguments

CONTROLS¶: Optional argument(s)

cropping¶

Configure cropping.

quark-ctl cropping [OPTIONS]

Options

--device <device>¶: Video device

--rect <rect>¶: Cropping region ‘left,top,width,height’

--high-speed¶: Enable the ROI High Speed Mode

--fps <fps>¶: Desired framerate

exposure-sequence¶

Create (and set) an exposure sequence.

quark-ctl exposure-sequence [OPTIONS]

Options

--exposure <exposure>¶: Exposure to set

--device <device>¶: Video device

save-image¶

Save single/multiple/average frame(s).

NOTE: This feature supports: PNG, PNM and PAM file formats.

quark-ctl save-image [OPTIONS] IMAGE_NAME

Options

--iterations <iterations>¶: Number of frames

--avg¶: Average of iterations

--device <device>¶: Video device

--demosaic¶: Apply demosaicing to bayer images

--makedir¶: Create new directory

Arguments

IMAGE_NAME¶: Required argument

stats¶

View and export camera statistics (including histograms).

quark-ctl stats [OPTIONS]

Options

--output <output>¶: Output histogram to .csv file

--bins <bins>¶: Specify number of bins (uses automatic bin count if omitted)

--crop <crop>¶: Specify ROI (top, left, width, height)

--density¶: Use pdf or counts

--grey-convert¶: Convert the image to grayscale before processing.

--n <n>¶: Average stats over n frames (not used in live mode)

--alpha <alpha>¶: Alpha for exponential decaying average (only used in live mode)

--live¶: Use live mode.

--device <device>¶: Optional camera device path.