The explicit location data is specified by three sets of begin and end values (-xbegin, -xend), (-ybegin, -yend), (-zbegin, -zend) which together compose explicit corner markers for volume in (x,y,z) three space. The x-axis corresponds uniformly to the implicit width dimension on the polymorphic data model, with the y-axis and z-axis corresponding to implicit height, and depth dimensions, respectively.
Data is generated uniformly from those specified corner markers, however the explicitness of the generated data can be specified by the grid (-grid) option. A KUNIFORM grid will dictate that the generated data consist simply of setting the uniform corner markers on the output data set. A KRECTILINEAR grid will dictate that the generated data consist of three arrays of locations, an x-array, a y-array, and a z-array, with the data within those arrays changing uniformly over the specified (x,y,z) begin and end values. A KCURVILINEAR grid will dictate that the generated data consist of a four dimensional array of location data. Essentially, this data set is a three dimensional array of (x,y,z) points.
The size and datatype of the resulting location data segment can be specified. The size of the location segment is controlled with three parameters (-wsize, -hsize, -dsize) which correspond to the implicit width, height, and depth of the location segment. The dimension size of the destination location segment will always be three corresponding to the size of the location points (x,y,z). The data type of the location segment is controlled with a single parameter (-type).
Any size specifications will be overwritten by existing size information in the input source object. If the input source object contains any explicit location data, the size and data type of the existing location segment will be used to determine the size and data type of the destination location segment. Any explicit location data in the source object will be destroyed in favor of the newly generated data. Additionally, if the input source object contains no explicit location segment but does contain a value segment or a mask segment, the width, height, and depth size of either of those segments will be used to set the width, height, and depth size of the destination location segment.