Navigation:  Reference > Detailed Function Description > Working with DPlot Documents > FNDPlot_xyz_data

 

DEF FNDplot_xyz_data(INTEGER Doc_num,REAL Datxyz(*),INTEGER Points_x, Points_y, Curve, Curvetext$,INTEGER Linetype,OPTIONAL INTEGER Verbose)

!

! Adding XYZ data points to DPlot document

!  This routine does some kind of intelligent caching. It send bunches of data to

!  DPlot rather than single point pairs. This has a huge impact on performance !

!

! INPUT:  Doc_num    = DPlot Document number where data points should be added

!                      If Doc_num=0 then data will be added to active document

!         Datxyz(*)  = Data array with data points. Only 2- and 3-dimensional

!                      arrays are supported at this time

!                       Dat_xyz(1,1,1) = first x value

!                       Dat_xyz(1,1,2) = first y value

!                      [Dat_xyz(1,1,3) = first z value] for 3 dimensions

!                        ...

!                       Dat_xyz(i,j,1) = last x value

!                       Dat_xyz(i,j,2) = last y value

!                      [Dat_xyz(i,j,3) = last z value] for 3 dimensions

!                        ** where: i = SIZE(datxyz,1)

!                                  j = SIZE(datxyz,2)

!         Points_x   = Number of points in x direction which should be transfered

!                      If Points_x=0 then all elements of the array will be added to

!                      the curve

!         Points_y   = Number of points in y direction which should be transfered

!                      (for 3D plots only)

!                      If Points_y=0 then all elements of the array will be added to

!                      the curve

!         Curve      = Index of curve where data should be added to

!                      If Curve=0: Points will be added to currently selected curve

!         Curvetext$ = Arbitrary text for curve (e.g. function used for curve)

!         Verbose    = >0 if verbose mode is used

 

FNDplot_xyz_data adds data points to an existing DPlot document. You may add points for 2D diagrams as well as for 3D diagrams. If you have more than one DPlot document open you must specify the DPlot document number (-> variable Doc_num).