Sharpness Score : Pixelink Support

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

PxLGetFeature, PxLSetFeature

Feature ID	Number of Params	Parameters	Unit	Restrictions
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

Camera	Presence	Read Only	Auto	Manual	One-time Auto	Off	Settable while streaming	Persistable	CiD
Lens dependent	Yes	No	No	Yes	No	Yes	No	Yes	No

Parameters

Comments:

Left: 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 calculate the SharpnessScore.

Right: 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 calculate the SharpnessScore.

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

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

Camera	Parameter	Unit	Type	Min	Max	Default	Step Size
All PL-D and PL-X cameras programmed with the latest loads	Left	Pixels	Absolute	Min	Max	Default	Step Size
	Right	Pixels	Absolute	Min	Max	Default	Step Size
	Width	Pixels	Absolute	Min	Max	Default	Step Size
	Height	Pixels	Absolute	Min	Max	Default	Step Size
	MaxValue	Pixels	Absolute	N/A	N/A	N/A	N/A
PL-X9512	Left	Pixels	Absolute	0	4064	1920	32
	Right	Pixels	Absolute	0	2992	1368	8
	Width	Pixels	Absolute	32	4096	256	32
	Height	Pixels	Absolute	8	3000	256	8
	MaxValue	Pixels	Absolute	0	N/A	N/A	N/A
PL-D721 M1	Left	Pixels	Absolute	0	1248	512	32
	Right	Pixels	Absolute	0	1016	384	8
	Width	Pixels	Absolute	32	1280	256	32
	Height	Pixels	Absolute	8	1024	256	8
	MaxValue	Pixels	Absolute	0	N/A	N/A	N/A
PL-D721P	Left	Pixels	Absolute	0	1248	512	32
	Right	Pixels	Absolute	0	1016	384	8
	Width	Pixels	Absolute	32	512	256	32
	Height	Pixels	Absolute	8	512	256	8
	MaxValue	Pixels	Absolute	0	N/A	N/A	N/A
PL-D722	Left	Pixels	Absolute	0	1888	832	32
	Right	Pixels	Absolute	0	1192	472	8
	Width	Pixels	Absolute	32	1920	256	32
	Height	Pixels	Absolute	8	1200	256	8
	MaxValue	Pixels	Absolute	0	N/A	N/A	N/A
PL-D725 M5	Left	Pixels	Absolute	0	2560	1152	32
	Right	Pixels	Absolute	0	2040	896	8
	Width	Pixels	Absolute	32	2592	256	32
	Height	Pixels	Absolute	8	2048	256	8
	MaxValue	Pixels	Absolute	0	N/A	N/A	N/A
PL-D732 M2	Left	Pixels	Absolute	0	2016	896	32
	Right	Pixels	Absolute	0	1072	416	16
	Width	Pixels	Absolute	32	2048	256	32
	Height	Pixels	Absolute	16	1088	256	16
	MaxValue	Pixels	Absolute	0	N/A	N/A	N/A
PL-D734 M4	Left	Pixels	Absolute	0	2016	896	32
	Right	Pixels	Absolute	0	2032	896	16
	Width	Pixels	Absolute	32	2048	256	32
	Height	Pixels	Absolute	16	2048	256	16
	MaxValue	Pixels	Absolute	0	N/A	N/A	N/A
PL-D752 M2B	Left	Pixels	Absolute	0	1888	832	32
	Right	Pixels	Absolute	0	1192	472	8
	Width	Pixels	Absolute	32	1920	256	32
	Height	Pixels	Absolute	8	1200	256	8
	MaxValue	Pixels	Absolute	0	N/A	N/A	N/A
PL-D753 M3	Left	Pixels	Absolute	0	1920	832	16
	Right	Pixels	Absolute	0	1456	600	8
	Width	Pixels	Absolute	16	1936	256	16
	Height	Pixels	Absolute	8	1464	256	8
	MaxValue	Pixels	Absolute	0	N/A	N/A	N/A
PL-D755MU-POL	Left	Pixels	Absolute	0	1216	480	8
	Right	Pixels	Absolute	0	1020	384	4
	Width	Pixels	Absolute	16	1224	256	8
	Height	Pixels	Absolute	8	1024	256	4
	MaxValue	Pixels	Absolute	0	N/A	N/A	N/A
PL-D755 PL-D795 M5D	Left	Pixels	Absolute	0	2432	1088	16
	Right	Pixels	Absolute	0	2040	896	8
	Width	Pixels	Absolute	16	2448	256	16
	Height	Pixels	Absolute	8	2048	256	8
	MaxValue	Pixels	Absolute	0	N/A	N/A	N/A
PL-D757 PL-D797 M7 M7B	Left	Pixels	Absolute	0	3200	1472	8
	Right	Pixels	Absolute	0	2192	968	8
	Width	Pixels	Absolute	8	3208	256	8
	Height	Pixels	Absolute	8	2200	256	8
	MaxValue	Pixels	Absolute	0	N/A	N/A	N/A
PL-D759 PL-D799 M9	Left	Pixels	Absolute	0	4064	1920	32
	Right	Pixels	Absolute	0	2152	952	8
	Width	Pixels	Absolute	32	4096	256	32
	Height	Pixels	Absolute	8	2160	256	8
	MaxValue	Pixels	Absolute	0	N/A	N/A	N/A
PL-D7512 PL-D7912 M12 M12B	Left	Pixels	Absolute	0	4064	1920	32
	Right	Pixels	Absolute	0	2992	1368	8
	Width	Pixels	Absolute	32	4096	256	32
	Height	Pixels	Absolute	8	3000	256	8
	MaxValue	Pixels	Absolute	0	N/A	N/A	N/A
PL-D7620	Left	Pixels	Absolute	0	5464	2608	8
	Right	Pixels	Absolute	0	3640	1696	8
	Width	Pixels	Absolute	8	5472	256	8
	Height	Pixels	Absolute	8	3648	256	8
	MaxValue	Pixels	Absolute	0	N/A	N/A	N/A
PL-D7920	Left	Pixels	Absolute	0	4496	2128	16
	Right	Pixels	Absolute	0	4496	2128	16
	Width	Pixels	Absolute	16	4512	256	16
	Height	Pixels	Absolute	16	4512	256	16
	MaxValue	Pixels	Absolute	0	N/A	N/A	N/A
PL-D7924	Left	Pixels	Absolute	0	5320	2536	8
	Right	Pixels	Absolute	0	4600	2176	8
	Width	Pixels	Absolute	8	5328	256	8
	Height	Pixels	Absolute	8	4608	256	8
	MaxValue	Pixels	Absolute	0	N/A	N/A	N/A
PL-D775	Left	Pixels	Absolute	0	2576	1168	16
	Right	Pixels	Absolute	0	1936	840	8
	Width	Pixels	Absolute	16	2592	256	16
	Height	Pixels	Absolute	8	1944	256	8
	MaxValue	Pixels	Absolute	0	N/A	N/A	N/A
PL-D7715 M15	Left	Pixels	Absolute	0	4576	2176	8
	Right	Pixels	Absolute	0	3280	1512	4
	Width	Pixels	Absolute	32	4608	256	8
	Height	Pixels	Absolute	8	3288	256	4
	MaxValue	Pixels	Absolute	0	N/A	N/A	N/A
PL-D7718 M18	Left	Pixels	Absolute	0	4896	2320	16
	Right	Pixels	Absolute	0	3664	1712	16
	Width	Pixels	Absolute	16	4912	256	16
	Height	Pixels	Absolute	16	3680	256	16
	MaxValue	Pixels	Absolute	0	N/A	N/A	N/A

Sharpness Score

Related Articles