Difference between revisions of "MC-Basic:CASTLOCATION"

From SoftMC-Wiki
Jump to: navigation, search
m
Line 15: Line 15:
 
|AVAILABILITY=
 
|AVAILABILITY=
 
Version 4.9.11 and up.
 
Version 4.9.11 and up.
 +
 
|DESCRIPTION=
 
|DESCRIPTION=
Creates and returns a generic location-type point, using the robot type given by the second, long-type argument, whereas coordinate values are taken from the first argument. If the first argument is a scalar, the resulting point will be composed of identical coordinates. Using an array as first argument will result in a point composed of the first "number-of-coordinates" (determined by the robot type) array elements.
+
Creates and returns a generic location type of point, using the robot type given by the second, long-type argument, while coordinate values are taken from the first argument. If the first argument is scalar, the resulting point will be composed of identical coordinates. Using an array as the first argument will result in a point composed of the first "number-of-coordinates" (determined by the robot type) array elements.
  
 
|TYPE=
 
|TYPE=
Line 33: Line 34:
  
 
|LIMITATIONS=
 
|LIMITATIONS=
Only a single-dimension array can be used as argument.
+
*Only a single-dimension array can be used as argument.
 +
*Number of array elements must be equal or greater than number of coordinates.
  
Number of array elements must be equal or greater than number of coordinates.
+
|EXAMPLE=
  
|EXAMPLE=
 
<pre>
 
 
GenLocation = CASTLOCATION(0.5, TYPE_XYZ)
 
GenLocation = CASTLOCATION(0.5, TYPE_XYZ)
  
 
? CASTLOCATION(ArrayOf6Longs, TYPE_XYZR)  
 
? CASTLOCATION(ArrayOf6Longs, TYPE_XYZR)  
</pre>
+
 
  
 
|SEE ALSO=
 
|SEE ALSO=

Revision as of 11:26, 20 March 2014

Creates and returns a generic location type of point, using the robot type given by the second, long-type argument, while coordinate values are taken from the first argument. If the first argument is scalar, the resulting point will be composed of identical coordinates. Using an array as the first argument will result in a point composed of the first "number-of-coordinates" (determined by the robot type) array elements.

Syntax

<location_variable> = castlocation (<long_scalar_expression>, <long_expression>)

<location_variable> = castlocation (<double_scalar_expression>, <long_expression>)

<location_variable> = castlocation (<long_array>, <long_expression>)

<location_variable> = castlocation (<double_array>, <long_expression>)

Availability

Version 4.9.11 and up.

Type

Location

Scope

Configuration, Task, Terminal

Limitations

  • Only a single-dimension array can be used as argument.
  • Number of array elements must be equal or greater than number of coordinates.

Examples

GenLocation = CASTLOCATION(0.5, TYPE_XYZ)

? CASTLOCATION(ArrayOf6Longs, TYPE_XYZR)

See Also