Supported by...


All Cameras.  Check for support using PxLGetCameraFeatures.


Description


A set of control information the camera uses to calculate the SharpnessScore of an image. The SharpnessScore of the image, is returned in the SharpnessScore field of the FRAME_DESC structure that is returned with each image capture. The ROI like parameters (fLeft, fTop, fWidth, and fHeight) define the area, within the currently defined Region of Interest, that is used by the camera to compute the image SharpnessScore. The SharpnessScore of an image is a metric of how many ‘crisp’ edges there are in the image. Higher values indicate the presence of more edges. Comparing the SharpnessScore of an image of one target to an image of a different target is meaningless, as there are no units associated with the SharpessScore.  Rather it is intended that this score could be used to compare subsequent images of the same target, as focal adjustments are made to the stream of images (with perhaps FEATURE_FOCUS, if the camera/lens supports it). The user should continue to make focal adjustments until this value is maximized (for this given target). The calculated SharpnessScore will always be less than the MaxValue parameter of this feature.  


API Control


PxLGetFeaturePxLSetFeature


Feature ID
Number of Params
ParametersUnitRestrictions

FEATURE_SHARPNESS_SCORE



If supported, provides information the camera uses to calculate the 'SharpnessScore' of an image. Sharpness score is a measure of how many crisp edges there are in an image.

5

fLeft

Pixels

Integer Only

fTop

Pixels

Integer Only

fWidth

Pixels

Integer Only

fHeight

Pixels

Integer Only

fMaxValue

N/A

Integer Only



Feature Flags


CameraPresenceRead OnlyAutoManualOne-time AutoOffSettable while streamingPersistableCiD

Lens dependant

Yes

No

No

Yes

No

Yes

No

Yes

No



Parameters


CameraParameterUnitTypeMinMaxDefaultStep SizeComment

All cameras with v6 descriptors

Left

Pixels

Absolute

0

1888

704

32

The X value of the location of the area in the (pre-PixelAddressed) image used to determine SharpnessScore. The field is always relative to the Image ROI (FEATURE_ROI), so a Left, Right of 0, 0 will always use the upper left section of the image to calcualte the SharpnessScore

Right

Pixels

Absolute

0

1192

334

8

The Y value of the location of the area in the (pre-PixelAddressed) Image used to determine SharpnessScore. This field is always relative to the image ROI (FEATURE_ROI), so a Left, Right of 0, 0 will always use the upper left section of the image to calcualte the SharpnessScore.

Width

Pixels

Absolute

32

512

512

2

The X value of the size of the area in the (pre-PixelAddressing) image used to determine SharpnessScore.

Height

Pixels

Absolute

8

512

12

1

The Y value of the size of the area in the (pre-PixelAddressing) image used to determine SharpnessScore.

MaxValue

Pixels

Absolute

N/A

N/A

N/A

N/A

The read-only parameter, is the maximum SharpnessScore possible given the camera's current settings. The value will change with adjustments to the Width and Height parameter.