MShapePtr is a useful function in its own right but has been included in the c2p section of the manual because it is of particular use for providing the `Chunky' parameter of Mc2p. Using MShapePtr you can return an address that has been calculated based on one of Mildred's Shape objects.
At its simplest, the routine will take the base address of the Shape's data. It will check if `wrapping' is active (see the relevent section of the manual) and if so will add the Shape's Handle coordinate position to the base address. Then it will check if `clipping' is active (see the relevent section of the manual), and if so it will add the Shape's clip window top-left corner coordinate position to the base address. This final address will then be returned and can be used mainly as the Chunky.l address required by Mc2p.
In its more sophisticated form, the routine can also take additional Xoffset and Yoffset coordinates, produce an address offset from them and add this also to the base address. Using this on its own you can position the topleft corner of the chunky source data.
If you do not specify a chunky Shape object to use, the routine will assume the currently used Shape object and base its calculations on that instead.
Possible syntax:
MShapePtr ( ShapeNum.w )
