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


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


CameraParameterUnitTypeMinMaxDefaultStep 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-D7920LeftPixels
Absolute
04496212816
RightPixels
Absolute
04496212816
WidthPixels
Absolute
16451225616
HeightPixels
Absolute
16451225616
MaxValuePixels
Absolute
0N/AN/AN/A
PL-D7924LeftPixels
Absolute
0532025368
RightPixels
Absolute
0460021768
Width Pixels
Absolute
853282568
HeightPixels
Absolute
846082568
MaxValuePixels
Absolute
0N/AN/AN/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