Menu and Toolbar Reference

Menus

The File menu includes standard file operations for saving, loading, and printing RPvdsEx files.

New	Opens a new file.
Open	Opens the Open dialog box so that an existing file can be opened.
Close	Closes the active file, leaving the application open.
Save	Saves the current file with the current name. If the file has not previously been saved, the Save As dialog box opens so that the file can be named.
Save As	Opens the Save As dialog box so that the file can be saved with a new name.
Macro
New Macro Design	Opens a new macro file.
Open Macro Design	Opens the RPvdsEx macro chooser dialog. The default folder location to search for macros is C:\TDT\RPvdsEx\Macros.
Page Setup	Opens the Page Setup dialog box.
Print	Prints the current tabbed window, including all sheets.
Print Preview	Switches to Print Preview mode, displaying the circuit diagram as it will print. This mode provides additional options for viewing sheets.
Print Setup	Opens the Print Setup dialog box. Available options depend on the installed printer(s).
Recent Files	The fourth section of the File menu lists recently used files. Clicking a file name opens the file. The recent workspaces are also listed (currently, only the Default workspace is supported).
Exit	Closes the application.

The Edit menu includes tools for modifying circuit diagrams.

Undo	Undo will undo the last action. RPvdsEx supports multiple undos.
Redo	Redo will reinstate the change that was undone by the last undo. RPvdsEx supports multiple redos.
Find and Replace
Rename Components	Opens the Change Component Name Dialog box. Enables the user to implement a text find and replace in the component name field of components in the current selection, sheet, or circuit.
Change Component Parameters	Opens the Change Parameter Dialog box. Enables the user to change the value of a component parameter in the current selection, sheet, or circuit.
Change Number of Channels	Opens the Update Number of Channels Dialog box. Enables the user to change the number of channels as specified in the channel number parameter of component and macros in the current selection, sheet, or circuit.
Cut	Removes the current selection, allowing it to be pasted in a subsequent operation.
Copy	Copies the current selection, allowing it to be pasted in a subsequent operation.
Paste	Adds the most recently cut or copied selection to the circuit diagram.
Index	Opens the Indexing Setup dialog box (Index), which can be used to increment indexed parameter tags (such as iChan~2) or time slices. The settings are applied to currently selected components only.
Preferences	Opens the Preferences dialog box. This dialog contains compiler and control object file settings.

The View menu includes tools for adjusting the window's display.

Toolbar	Allows toggling the display of selected toolbars.
Status Bar	Toggles the display of the status bar on the bottom of the window.
Zoom	Zooms in on a pointer position. Click to activate zoom.
Zoom To Fit	Zooms to fit the contents of the sheet.
Zoom In	Zooms in display.
Zoom Out	Zooms out display.
Pan	Allows the user to drag the sheet using the mouse.

The Components menu is used to place components and links on the RPvdsEx circuit. The components are grouped into different function types, which can be found in the RP Component Reference section.

Helpers	Opens the Select component to place dialog box to the Helpers category. This category includes important tools for working and debugging in the RPvdsEx environment.
Macro Tools	Opens the Select component to place dialog box to the Macro Tools category. This command is only available when working with a macro circuit (*.rcm).
OpenEx Headers	Opens the Select component to place dialog box to the OpenEx Headers category. This category contains components designed exclusively for use in circuits designed for the OpenEx environment.
Multi-Processor	Opens the Select component to place dialog box to the Multi-processor category. This command is only available when a high performance processor, such as the RX5, has been specified in the hardware setup.
Common	Displays a submenu listing the most commonly used components. Using this menu allow the user to bypass the Select components to place dialog box.
Component Groups	Opens the Select component to place dialog box to the specified category. Categories group similar components together by function.
Circuit Macros	Opens the Macro chooser dialog. This command is not available when editing a macro circuit.

The Implement menu includes tools for compiling, running, or generating code. It also allows different devices to be selected and configured.

Device Setup	Opens the Set Hardware Parameters dialog box allowing users to configure the circuit for the correct RP module. In addition, it allows access to such properties as the sample rate and time slices.
Build, Load and Run	Compiles the DSP code from the circuit diagram, loads the code to the processor, and runs the code.
Compile Diagram	Compiles the circuit diagram, determining the proper processing chain order and generating the DSP code. If errors are found in the circuit diagram, such as links that don't terminate anywhere or links between incompatible data types, the circuit diagram will be updated with red links to call attention to the errors.
Load Chain	Loads the processing chain (DSP code) to the processor.
Run Processor	Runs the loaded processing chain (DSP code) on the processor.
Halt Processor	Halts the processing chain on the processor.
Build Control Object	Generates Circuit file.
	By default, RPvdsEx v60 and greater uses an RCX combined file format instead of the legacy two file system (RPX, RCO). With this preferred file format, the separate control file is no longer needed and the Build RCO button is intentionally grayed out. Reverting to the legacy RPX/RCO file system... On the Edit menu, click Preferences . Clear the Embed RCO object file check box. Click OK . After performing this step, the Build RCO button is enabled and Circuit files can be created as before.
Generate Code	Generates C code, for the processing chain, that can be incorporated into a custom program.
Processor Select	Displays a submenu listing processor select options. When a multi-DSP device is specified in the hardware setup, the processor select submenu is used to select the processor(s) that will be compiled when the user compiles the circuit.

The Triggers menu allows the user to fire hardware or software triggers from within the RPvdsEx environment. This is useful for testing circuits.

Pulse zTrg-A	Pulses zBus trigger A.
zTrg-A High	Sets zBus trigger A high.
zTrg-A Low	Sets zBus trigger A low.
Pulse zTrg-B	Pulses zBus trigger B.
zTrg-B High	Sets zBus trigger B high.
zTrg-B Low	Sets zBus trigger B low.
Soft-1	Pulses software trigger one.
Soft-2	Pulses software trigger two.
Soft-3	Pulses software trigger three.
Soft-4	Pulses software trigger four.

zTrg-A and zTrg-B are global triggers that are generated on the zBUS. They can be used to synchronize the start of several chains across multiple zBUS caddies. zTrig can be set as a pulse or always high or always low. zTrig can be initiated from RPvdsEx or from a program such as BrainWare or PyschRP.

RPvdsEx supports up to ten software triggers in a circuit, however, only the first four can be triggered from the RPvdsEx interface.

The Window menu allows you to reset the toolbars to the default layout.

Reset Toolbars	Arranges all toolbars in the default layout.

Toolbars

Main (File)

The Main toolbar (also called the File toolbar) includes standard file operations for saving, loading, and printing RPvdsEx files and tools for viewing and editing files.

	New	Opens a new file.
	Open	Opens the Open dialog box so that an existing file can be opened.
	Save	Saves the current file. If the file has not previously been saved, the Save As dialog box opens so that the file can be named.
	Cut	Removes the current selection, allowing it to be pasted in a subsequent operation.
	Copy	Copies the current selection, allowing it to be pasted in a subsequent operation.
	Paste	Adds the most recently cut or copied selection to the circuit diagram.
	Rename Components	Opens the Change Component Name Dialog box. Enables the user to implement a text find and replace in the component name field of components in the current selection, sheet, or circuit.
	Change Component Parameters	Opens the Change Parameter Dialog box. Enables the user to change the value of a component parameter in the current selection, sheet, or circuit.
	Change Number of Channels	Opens the Update Number of Channels Dialog box. Enables the user to change the number of channels in the channel number parameter of component and macros in the current selection, sheet, or circuit.
	Print	Prints the current tabbed window, including all sheet.
	About	Display program information, version number, and copyright.
	Zoom	Zooms in on a pointer position. Click to activate zoom.
	Zoom To Fit	Zooms to fit the contents of the sheet.
	Zoom In	Zooms in display.
	Zoom Out	Zooms out display.
	Pan	Allows the user to drag the sheet using the mouse.

Implement

The Implement toolbar includes tools for compiling, running, or generating code. It also allows different devices to be selected and configured.

	Device Setup	Opens the Set Hardware Parameters dialog box allowing users to configure the circuit for the correct RP module. In addition, it allows access to such properties as the sample rate and time slices.
	Build, Load and Run	Compiles the DSP code from the circuit diagram, loads the code to the processor, and runs the code.
	Compile Diagram	Compiles the circuit diagram, determining the proper processing chain order and generating the DSP code.
	Load Chain	Loads the processing chain (DSP code) to the processor.
	Run Processor	Runs the loaded processing chain (DSP code) on the processor.
	Halt Processor	Halts the processing chain on the processor.
	Turn Helpers On
	Turn Helpers Off
	Build Control Object	Generates an RP Control Object (RCO) file. By default, RPvdsEx v60 and greater uses an RCX combined file format instead of the legacy two file system (RPX, RCO). With this preferred file format, the separate control file is no longer needed and the Build RCO button is intentionally grayed out.
	Generate Code	Generates C code, for the processing chain, that can be incorporated into a custom program.

Processors

The processor selection commands are available from the Implement menu or the Processor Select toolbar. When a processor is selected, its button will appear "pressed." Either a single processor or all processors may be selected. Selection of two, three, or four processors is not supported.

	Main DSP	Selects main processor
	Aux One	Selects first auxiliary processor
	Aux Two	Selects second auxiliary processor
	Aux Three	Selects third auxiliary processor
	Aux Four	Selects fourth auxiliary processor
	All DSPs	Selects all processors

Note:

These commands are only available when the device selected in the Set Hardware Parameters dialog box is an RX device.

Components

Most buttons on this toolbar opens the Select component to place dialog box to the specified category. Categories group similar components together by function.

	Helpers	Opens to important tools for working and debugging in the RPvdsEx environment.
	OpenEx Headers	Opens to components designed exclusively for use in circuits designed for the OpenEx environment.
	Input/Output	Opens to input and output components to connect a circuit to the physical world.
	Basic Math	Opens to low-level math operations.
	Audio Processing	Opens to components that are related to 3D audio processing.
	Exponents and Logs	Opens to typical log and exponential functions as well as a linear-to-dB and dB-to-linear processes.
	Gating Functions	Opens to components used to gate the onset and offset of signals.
	Coefficient Generators	Opens to components used to calculate the coefficients of specified high-pass, low-pass, band-pass, or notch filters in real-time.
		Their outputs can be connected to the filter coefficient port of a Biquad filter component.
	Buffer Operations	Opens to components used to create and access data buffers.
	Delay Functions	Opens to components used to create or synchronize intentional delays.
	Neuro Analysis	Opens to components developed primarily for neurophysiology applications.
	Device Status	Opens to components to monitor and do math with major system status values.
	Macro Tools	This command is only available when working within a macro circuit.
	Multi-Processor	Opens to components designed for use with multi-processor devices.
	Type conversion	Opens to components used to convert a signal from one basic data type to another.
	Integer Math	Opens to mathematical functions for integer data, allowing bitwise mathematical operations.
	Trigonometry	Opens to trigonometric functions.
	Waveform Generators	Opens to components that generate signals on the DSP.
	Digital Filters	Opens to Basic digital filtering tasks.
	Counters and Logic	Opens to counter and logic functions.
	Data Reduction	Opens to functions to decrease the size of the data set.
	Basic Analysis	Opens to components that analyze various aspects of a signal.
	State/Flow Control	Opens to state and flow components.
	Macro	Opens the Insert RPvdsEx Macro Dialog Box

Common Components

This toolbar provides quick access to commonly used components, allowing the user to bypass the Select components to place dialog box.

	Link	Starts link creation. After clicking this button the user can click the output and input ports of components on the circuit diagram to create a link.
	Iterate	Selects the Iterate function to be added to the circuit diagram.
	HopTo	Selects the HopTo helper to be added to the circuit diagram.
	HopFrom	Selects the HopFrom helper to be added to the circuit diagram.
	zHopTo	Selects the zHopTo component to be added to the circuit diagram.
	zHopFrom	Selects the zHop components to be added to the circuit diagram.
	ParTag Right	Selects the right parameter tag to be added to the circuit diagram.
	ParTag Left	Selects the left parameter tag to be added to the circuit diagram.
	Script Tag
	ParWatch	Selects the parameter watch to be added to the circuit diagram.
	Graph	Selects the graph to be added to the circuit diagram.
	Memo	Selects the memo to be added to the circuit diagram.