CogAcqLineScan.SetStepsPerLine Method

CogAcqLineScan SetStepsPerLine Method

Cognex VisionPro 9.23

Set the number of encoder steps per image line. The number of steps is StepsPerLine + Step16thsPerLine/16.

Namespace: Cognex.VisionPro.Implementation.Internal
Assembly: Cognex.VisionPro.Core (in Cognex.VisionPro.Core.dll) Version: 91.0.0.0

Syntax

C++

Copy to Clipboard Print

public virtual void SetStepsPerLine(
	int stepsPerLine,
	int step16thsPerLine
)

public virtual void SetStepsPerLine(
	int stepsPerLine,
	int step16thsPerLine
)

Public Overridable Sub SetStepsPerLine ( 
	stepsPerLine As Integer,
	step16thsPerLine As Integer
)

Public Overridable Sub SetStepsPerLine ( 
	stepsPerLine As Integer,
	step16thsPerLine As Integer
)

public:
virtual void SetStepsPerLine(
	int stepsPerLine, 
	int step16thsPerLine
)

public:
virtual void SetStepsPerLine(
	int stepsPerLine, 
	int step16thsPerLine
)

Parameters

stepsPerLine: Type: System Int32
The number of encoder steps per line.

step16thsPerLine: Type: System Int32
The number fractional steps per line as 1/16th steps that can be added to stepsPerLine to make up a single line.

Implements

ICogAcqLineScan SetStepsPerLine(Int32, Int32)

Events

Event Type	Reason
ICogChangedEvent Changed	Fires when the number of steps per line changes. The following state flag may be affected: SfGetStepsPerLine

Event Type

Reason

ICogChangedEvent Changed

Fires when the number of steps per line changes.

The following state flag may be affected:

SfGetStepsPerLine

Exceptions

Exception	Condition
ArgumentException	stepsPerLine < 1 or stepsPerLine > 4095 or step16thsPerLine < 0 or step16thsPerLine > 15

Remarks

Set the number of encoder steps per image line. The number of steps is stepsPerLine + step16thsPerLine/16.

When using the test encoder with the test line scan camera ("Test LS 2048x2048"), the minimum steps per line you can use without getting e_CogAcq_EncoderOverrun errors is:

minStepsPerLine = (width + xROI) / 64 + 2

Where width is the width of the CogAcqROI and xROI is the x-coordinate of the region of interest. If xROI is zero, the smallest value you can use with the test encoder without getting e_CogAcq_EncoderOverrun errors is 34 for 2048-pixel-wide images and 18 for 1024-pixel-wide images.

See How to Set Steps per Line for Linescan Cameras for additional information about choosing appropriate values.

Note: steps16thsPerLine is ignored on MVS-8600.