Menu and Toolbar Commands

File

RaySim6 Documents are stored as a binary archive with no pre-designated file extension. It's not practical to edit the documents outside of the RaySim6 program. Results can be exported in an tab-delimited text file using File/Export Results command.

File/New - Start a new Document. Be sure to save your current Document before starting a new Document, if desired.

File/Open - Open an existing Document. Use the Open file chooser to locate your RaySim file. Alternately, the most recently saved files are listed near the bottom of the File dropdown menu.

File/Save - Save the current Document to hard disk or portable memory device. The Document is saved using the present filename.

File/Save As - Save the current Document to hard disk or portable memory device using a new name.

File/Export Results - Export the results for all Batches into a tab-delimited text file. Each Batch is exported into a separate file with the name being the concatenation of the RaySim6 Document and the Batch name, with an extension ".rso". For example, Export Results for the "Starter" Document will create four tab-delimited files: "Starter_Silicon Pyramid.rso", "Starter_Thin-film on glass.rso", "Starter_Dispersive Prism.rso" and "Starter_Box.rso".

The exported data is in the same format as shown in the Model Results View.

If there are no results to export for a particular Batch because no simulations have been performed, the export file for that Batch will not be written.

File/Exit - Exits RaySim6. Save your Document before exiting, if desired.

Edit

Edit/Copy - Copies the currently selected Model item, either a Batch, a Layer or a Plane to the clipboard. Left click on the Model item you wish to copy to select it first, then use Edit/Paste to create a duplicate of the selected Batch, Layer or Plane. Note that only one Model item (ie, either Batch, Layer or Plane) can be copied to the clipboard at a time - the most recently selected item is copied.

When no Batch, Layer or Plane has been selected already, this menu item is disabled.

Edit/Paste- Creates a duplicate of a Model item that has already been copied onto the clipboard. The item is pasted into the currently selected Model item.

This menu item is only enabled when the user has selected a Model item that is similar to the one already copied onto the clipboard, because it is only possible to copy Batch data into a Batch item, to copy Layer data into a Layer item and to copy Plane data into a Plane item. A typical Copy/Paste sequence to build up a new Model would be similar to:

1. Select the Batch, Layer or Plane you wish to duplicate by left clicking on it in the Batch View Area
2. Choose Edit/Copy

2. Create an empty Batch, Layer or Plane at the desired place within the Model
3. Select this new Batch, Layer or Plane by left clicking on it in the Batch View Area
4. Choose Edit/Paste

Edit/Paste w/ Swapped Edges - Creates a duplicate of a Plane item that has already been copied onto the clipboard. The Plane item is pasted into the currently selected Plane item with the two Plane's Edges swapped. This, in effect, reverses the Normal direction of the Plane, flipping it upside down in its place. This Paste operation also adds a "!" character to the name to indicate that it has been pasted with its two edges swapped.

View

View/Model Graphic - Changes the view to the Model View.

View/Graph - Currently under construction. Eventually, it will change the view to the Graph View, allowing results of simulations to be plotted.

View/Results - Changes the view to the Model Results View.

Draw

Draw/Draw on Raytrace - Toggles trace drawing. When this menu item is checked, RaySim6 will draw the rays it is tracing. While fun and relaxing, even hypnotising, drawing while tracing slows the trace computation significantly.

Draw/Color Scale - Brings up the Color Scale dialog box, in which the user can change the parameters of the Trace Legend Bar.

Draw/Compress Z, Draw/Compress X, Draw/Compress Y - Each compresses the drawing scale in the indicated direction by a factor of 10. This is useful when working with models that have greatly different extents in different directions. The drawing compression does not affect the trace simulation, though the drawn rays will be similarly compressed on the Rendering Area.

Raytrace

Raytrace/Stop When Finished - Toggles repetitive trace simulation. When checked, the trace thread will stop when the trace is complete. When not checked, the trace thread will enter standby mode when the trace is complete. While in standby mode, the trace thread will reactivate itself and refresh the trace whenever the user moves, zooms or rotates the model, or moves or rotates the incident trace ray. This is useful in conjunction with Draw on Raytrace, whereby the trace rays can be drawn repetitively on the screen while the model (and incident ray) is moved, zoomed or rotated within the Rendering Area, giving an animated, 3D view of the model and trace.

RayTrace/Start - Start a Batch trace.

RayTrace/Pause - Pause a Batch trace.

RayTrace/Stop - Stop a Batch trace. Note that because of the large memory requirements of some trace simulations, the trace thread may take several seconds to finish cleaning up its memory allocations before returning control to the user.

Builders

Builders/Add Batch - Inserts a new, empty Batch after the currently selected Batch.

Builders/Edit Batch - Calls up a dialog box that allows the user to edit the settings of the currently selected Batch.

Builders/Delete Batch - Deletes currently selected Batch. Be careful, there is presently no "Undo" feature implemented in RaySim6.

Builders/Add Layer- Inserts a new, empty Layer after the currently selected Layer .

Builders/Edit Layer- Calls up a dialog box that allows the user to edit the settings of the currently selected Layer .

Builders/Delete Layer- Deletes currently selected Layer . Be careful, there is presently no "Undo" feature implemented in RaySim6.

Builders/Add Plane- Inserts a new, empty Plane after the currently selected Plane.

Builders/Edit Plane- Calls up a dialog box that allows the user to edit the settings of the currently selected Plane.

Builders/Delete Plane- Deletes currently selected Plane. Be careful, there is presently no "Undo" feature implemented in RaySim6.

Help

Help/About RaySim6 - Calls up a dialog with important information about how to contact the author of RaySim6, the terms of use and a disclaimer.

back