SCI Functions > Home Position & Home Jump

Return value	Function / Property name	Parameter
long	ScGetHomePosition()	int Index, double *pVal

Table 78: GetHomePosition

This function returns one of the home positions coordinates. The parameter Index specifies which coordinate value has to be given.

Index	Comment
0	x
1	y
2	z

Table 79: GetHomePosition indices

Return value	Function / Property name	Parameter
long	ScSCIGetHomePosition()	double HomeX,double HomeY
long	ScSCIGetZHomePosition()	double *HomeZ

Table 80: GetHomePosition

These function return the current home position coordinates.

Return value	Function / Property name	Parameter
long	ScSetHomePosition()	double pXVal, double pYVal
long	ScSCISetHomePosition()	double HomeX, double HomeY

Table 81: SetHomePosition

In case homing is used, this function defines coordinates for the home position in planar directions. The dll-version of this function sets the Z-value to 0, so ScSCISetZHomePosition() should be called afterwards.

Return value	Function / Property name	Parameter
long	ScSetZHomePosition()	double pZVal
long	ScSCISetZHomePosition()	double HomeZ

Table 82: SetZHomePosition

In case homing is used and a 3D-application is created, this function defines the depth-coordinate value for the home position.

Return value	Function / Property name	Parameter
long	ScHomeJump	none
long	ScSCISetHomeJump()	long Value
long	ScSCIGetHomeJump()	long *Value

Table 83: HomeJump

This property enables (1) or disables (0) the home jump feature. If enabled, the coordinates specified by ScSetHomePosition() / ScSetZHomePosition() are used for homing. The ScHomeJump property may be overwritten depending on some flags that are set using ScSetDeviceOperationMode() (please see below).

	When using the scanner card interface, home jumps will only occur if the execution is stopped via software before the actual marking operation has finished.