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.