|Top Previous Next|
Sets the bits-per-pixel for the images that are acquired. The bits-per-pixel (also known as the bit depth) deternines the color density of the image. The highter the bit per pixel, the more colors will be used in the image (thus making the size of the image files larger). Typical values for bpp are 1, 4, 8, 16, and 24.
Sets the bits-per-pixel to 1.
When specifying the bpp value, care must be taken that valid values are used in conjunction with the image type that is being acquired. For example, a bpp value of 1 is the only valid value if acquiring to TIFF Group 3 or Group 4 format.
If no bit depth is specified, the bit depth used is the lowest bit depth value that can be used for the file type being acquired. If a bit depth is specified, but the file type doesn't support the bit depth, the lowest bit depth value that can be used for the file type is used.
Below is a table describing the valids for -bitsperpixel for each file type (see the -filetype parameter for file types):
The -bitsperpixel optioin can be combined with the -color option to choose the correct color combined with the appropriate bits-per-pixel setting for the color.
TwainSave will attempt to choose the first available -color and -bitsperpixel value if:
If no available -color or -bitsperpixel value can be found for the device, the device's user interface is still displayed, and the user is still allowed to start image retrieval, but using the settings that the user specifies in the device's user interface. If no user interface was chosen (-noui), the image retrieval will still not be started, and TwainSave will exit immediately.
The bits-per-pixel specified by the device for a particular color type (Black and White, Color, Grayscale, etc.).