Navigation:  Reference > Detailed Function Description > Working with DPlot Documents > SUB DPlot_show

 

SUB Dplot_show(INTEGER Doc_num,OPTIONAL INTEGER Target,REAL X0,Y0,W,H,@Bitmap, INTEGER Verbose)

!

! Displays a DPlot diagram on the screen

!

!  INPUT:

!   Doc_num   = Document number of open DPlot document

!   Target    =  0: HTBasic bitmap screen (limited to 256 colors in color map mode)

!                   -> default mode

!               >0: Basic Plus Bitmap widget (can show more than 256 colors but

!                   DUMP is still restricted to 256 colors)

!               >1: Info window "Creating 3D view, please wait..." is displayed

!   X0        = X origin in percent of the screen width

!   Y0        = Y origin in percent of the screen width

!   W         = Desired Width of picture in percent of the screen width

!   H         = Desired Height of picture in percent of the screen height

!   @Bitmap   = Pointer to a COM block variable for Basic Plus bitmap widget

 

DPlot_show  shows a DPlot diagram on the screen. For this purpose it utilizes a special DPlot function which saves the current DPlot document as a bitmap file and then this bitmap file will be shown within the HTBasic screen. The user specifies the position and size of the bitmap on the screen (default: full screen).

You can also define the colour depth: If you specify 0 for the Target variable (or omit this variable completely) a colour depth of 256 colours is used. In this case the bitmap file will be loaded into the HTBasic bitmap memory using GLOAD and can be manipulated with the normal plot commands like PLOT, LABEL, etc.

If you set the parameter Target to >0 a colour depth of millions of colours is assumed (also called "high color mode") and the diagram will be loaded into a Basic Plus Bitmap widget. Using this method you can display diagrams with millions of colours but with the down side that these widgets can’t be easily DUMPed to a printer (since the Basic Plus Bitmap widget DUMP routine does not support more than 256 colours) which will result in false colours when doing a DUMP GRAPHICS. In high color mode it is also not possible to use HTBasic graphics commands (which shouldn't be necessary in most cases, though). If the variable Target is set to >1 then an info window "Creating 3D view, please wait..." is displayed. This can be handy when you want to display complex 3D diagrams which require several seconds to be displayed.

Dplot_show automatically registers the document with FNDplot_autosize for any subsequent automatic screen re-sizing.