NBS_PUT_SHAPE

Put a new shape to a primitive item associated with a specified identifier

Description:

Check that the ID is not NIL and that it pertains to a primitive item.
Check that the caller owns the noticeboard (or WORLD_WRITE is TRUE).
Check that the item has enough potential dimensions to accept all of the supplied dimensions.
Increment the modified count for this item.
Copy the dimensions to the noticeboard.
Increment the modified count once more.
Increment the noticeboard modified count.

The item and noticeboard modified counts will not be incremented if INCREMENT_MODIFY is FALSE.

Invocation

(Int) = NBS_PUT_SHAPE (ID,NDIMS,DIMS,STATUS)

Arguments

ID = INTEGER (Given)
Identifier of the item which the shape is to be put.
NDIM = INTEGER (Given)
Number of dimensions to be put.
DIMS = INTEGER() (Given)
Dimensions to be put.
STATUS = INTEGER (Given and returned)
The global status. Possible return values are,
NBS__NILID NIL ID

NBS__NOTPRIMITIVE Item is not primitive

NBS__NOTOWNER Caller does not own the noticeboard

NBS__TOOMANYDIMS NDIMS is greater than item max dims