Parameters

DocNum	Document index for a 3D plot returned by a previous call to DPlot_Plot, DPlot_Plot8, etc.
NumPoints	Number of X,Y pairs in the Border array. If 0, any existing border will be removed.
*Border	Address of the Border array. Values should be in the order X[0], Y[0], X[1], Y[1],...,X[NumPoints-1],Y[NumPoints-1].

Return Values

-5	Failure to initialize DDE. Should never happen, but if it does then rebooting may be necessary.
-2	Failure to establish a conversation for DocNum, most likely because that document has been closed (or was never created).
-1	Could not find DPlot.
0	Generic failure most likely due to using an older version of DPlot that does not support this functionality. Requires DPlot 1.9.8.3 or later.
1	Success.

Remarks
This function may be used only on surface plots of randomly-spaced 3D points (DATA_3DR). The border may start at any location and then proceed in either a clockwise or counterclockwise direction. The border may cross over itself. Triangles for which the center point is outside the border will be removed (Note that this means that the resulting plot may have triangles that cross the border; triangles are not clipped by the border.) The border cannot be added to using this function; any existing border, set either with a call to this function or via the Define Boundary menu command, will be removed. For a description of creating holes in a surface see the DPlot Help file topic on the Define Boundary menu command. For example usage see the C ctest, VB btest, or Watcom FORTRAN ftest demo programs.