Retrieval

Synopsis

PATRET/'file name'[,'pattern name'][,{matrix|csys,scale}][,AUTO][,IFERR,label:]

Description

Retrieves pattern data from a master part into the currently displayed part as a pattern object. If you do not specify the pattern name, the pattern automatically assumes the filename parameter as its object name.

If you do not specify either a matrix, or a csys and scale, the system retrieves the pattern data at a scale of 1.00, using the WCS of the current part as the default destination coordinate system. The reference coordinate system is always the WCS of the master part.

Parameters

Parameter

Description

'file name'

Specifies the part containing the pattern data to be retrieved. If the part is not found in the current directory, the system searches the directories pointed to by the UGII_UTIL and UGII_PATDIR environment variables.

'pattern name'

Specifies the name for the pattern object to be created. If not specified, the pattern name defaults to the archive part file name.

matrix

A previously defined matrix which determines the location, orientation, and scale of the pattern data being merged. The destination coordinate system is defined by applying the matrix to the current WCS.

csys,scale

A previously defined coordinate system and a scale factor which specifies the destination coordinate system and scale for the pattern data being merged. The scale factor must be a positive value.

AUTO

Minor word which autoscales the data if a metric/English conflict occurs.

IFERR,label

Specifies a label to which program execution jumps if an error occurs during pattern retrieval. Possible errors include: scale must be positive; no pattern data found; invalid pattern name specified; 12 values required for matrix; matrix is not orthogonal; invalid object specified; object must be a csys; part file not found; part failed revision check.

Parameter	Description
'file name'	Specifies the part containing the pattern data to be retrieved. If the part is not found in the current directory, the system searches the directories pointed to by the UGII_UTIL and UGII_PATDIR environment variables.
'pattern name'	Specifies the name for the pattern object to be created. If not specified, the pattern name defaults to the archive part file name.
matrix	A previously defined matrix which determines the location, orientation, and scale of the pattern data being merged. The destination coordinate system is defined by applying the matrix to the current WCS.
csys,scale	A previously defined coordinate system and a scale factor which specifies the destination coordinate system and scale for the pattern data being merged. The scale factor must be a positive value.
AUTO	Minor word which autoscales the data if a metric/English conflict occurs.
IFERR,label	Specifies a label to which program execution jumps if an error occurs during pattern retrieval. Possible errors include: scale must be positive; no pattern data found; invalid pattern name specified; 12 values required for matrix; matrix is not orthogonal; invalid object specified; object must be a csys; part file not found; part failed revision check.