[ Introduction | Installation | Usage | The iconbar menu | Creating data files | The surface viewer | Screenshots | Licence ]
[ Introduction | Installation | Usage | The iconbar menu | Creating data files | The surface viewer | Screenshots | Licence ]
What does Surface do?
Surface is a simple, no frills application for displaying a
representation of a surface described by a function of the form
z = f(x,y)
An example is shown below. The function plotted is
z = COS(X × Y)
with both X and Y varying from -3 to +3.
For a new installation, simply drag and drop the Surface application into the directory of your choice.
If you have a previous copy of Surface move the old version of Surface somewhere safe and replace it with the new version.
Surface is run in the usual way by double clicking on its icon in a filer display. It will install on the icon bar. Depending on the Choices settings (see below) it may also install the 3D function editor on the iconbar.
The creation of suitable data files for Surface is described below.
The iconbar icon itself offers two actions. Clicking with Select will open the 3DFNEdit data input window, launching the application if it is not already on the iconbar. Clicking with Adjust (right hand mouse button) will open the Choices dialogue, which may also be opened from the iconbar icon menu (see below).
The iconbar icon menu offers the following options.
Info – this leads to
the standard information window, which also contains a web button,
allowing a quick way of accessing the download site.
Help... – will launch the documentation (this file) in the default browser.
New – will open a blank 3DFNEdit data input window, launching the application if it is not already on the iconbar.
Choices... – will open the application choices dialogue, This dialogue can also be opened by clicking Adjust on the iconbar icon. A full description of the features available is given in the Choices page.
Run Fn Editor – will run the 3D function editor if it is not on the iconbar at the time. Details on using 3DFNEdit are given here.
Quit – will remove Surface from the iconbar and terminate the program. If the configuration option is set, then 3DFNEdit will also be quit (if it is running).
Surface has no data entry facilities of its own. Suitable data files can be created using the companion application 3DFNEdit. Surface and 3DFNEdit communicate via the wimp message protocol, and when they are both running, then data entry, editing and surface plotting can be carried out as if they were a single integrated application.
Details on using 3DFNEdit are given here.
Why are two separate applications used? Surface is written in C and compiled. To evaluate arbitrary functions entered by the user at run time would require a full expression evaluator which would involve a lot of code. On the other hand, BBC Basic already provides the keyword EVAL, which is a very powerful expression evaluator. Thus Surface dodges the issue of expression evaluation and simply passes the job over to a Basic program, i.e. 3DFNEdit. Simples.
Suitable data files can also be produced by other programs or applications. Surface is supplied with some example programs in BASIC that create data files to demonstrate the wave functions of hydrogenic atomic orbitals. These show the format of the data files, and are easily modified to calculate other functions.
Contact the author for further information.
When a datafile is loaded in to Surface, the surface plot window will open, showing a representation of the function. An example is shown below.
The menu attached to the plot window is shown to the right.
Function info – This opens a window showing the details that were entered into 3DFNEdit when producing the datafile for the surface plot.
Edit function – This will send the function details to 3DFNEdit (provided it is running) and open its data entry and edit window ready for the function details to be modified. Choosing Plot in that application will transfer the evaluated data back to Surface and the modified data will be plotted. See the user guide for 3DFNEdit for full details on the operation of that application.
Plot surface – When displaying a surface this option will be shaded and unselectable. However, if the display is showing a contour plot (see below), then it will be available, and changes the display back to a surface plot.
View angle – When viewing the surface plot, this leads to a submenu allowing the 'angle of view' to be changed over the range 10 - 45 degree. Small angles look at the surface from the side, larger angles from more above.
Plot contours – When the display is showing a surface plot, this option allows the surface to be viewed as a simple contour plot. An example of a contour plot is shown below.
Contour levels – When viewing the surface as a contour plot, the submenu attached allows the number of contour levels, used to cover the range from the maximum to minimum value of Z, to be changed.
Print – This will lead to a simple Print dialogue to allow hardcopy of the surface on the active printer. The dialogue is shown below.
The active printer is shown in the title bar. The number of copies to print can be selected using the bump arrows. Printing is actioned by pressing the Print button. If no priter is active, this button will be shaded and unselectable.
The printout will be scaled to fit an A4 page, whatever size of display window is being used.
Save drawfile – This leades to a standard Save as dialogue to allow the surface to be saved in drawfile format.
All the screen shots in these pages were obtained using Snapper, a versatile screen capture application.
Snapper is available from http://www.chris- johnson.org.uk/software/snap.html
These pages are best viewed in a CSS compliant browser. For RISC OS, Netsurf would be the browser of choice.
Surface is © Chris Johnson, 2014
Email:chris@chris-johnson.org.uk
This document last modified on 7-Nov-2015