Professional Documents
Culture Documents
Installation
• Download tRev by clicking the OS X or Vista link (in right-hand column on our site).
• Place the tRev.app at the same level as Revolution.app or Revolution.exe.
• Drag tRev to your Dock or Taskbar
• Click the tRev icon on your Dock or Taskbar
When tRev opens, it automatically launches Rev for you if it isn't already open. If Rev is
already running, tRev doesn't care. He will show you a small portrait of himself in the
upper right corner of your screen, and then you're ready to rock and roar!
The first time you open tRev, it will download the components it needs. Once running, it
will let you know when it needs updating by placing a link in the lower left of the Editor
window that says: Updates Available. Click that link to get your component updates.
You can also use the Help menuʼs Check for Updates... to manually update tRevʼs
components.
Switching
There are six methods you can use to switch between tRev and Revolution:
1. You can click a window in either Rev or tRev to switch back and forth between the
two environments.
2. These are two different apps, but we have them working together as one.
3. Click the tRev logo at the top right of the screen to toggle between Rev and tRev.
NOTE: This operation is not possible on the Vista version of Revolution at this time.
The folks at RunRev are working on solving this problem.
4. Type command+r (Mac) or control+r (Vista) to go from Rev to tRev.
5. Editing the script of any object in Rev will automatically switch you to tRev.
6. There is a Preference (access via Edit menu on Vista or tRev menu on OS X) for
keeping the tRev editor visible at all times. This is a boon to folks with two monitors
and makes switching easier.
• When an object is selected, you will see Column Buttons become enabled at the
bottom of the objectʼs column. These are Go To, Visible, Delete or Close, depending
upon the type of object.
If either the top left or bottom right of the target stack is not within one of your
screen rects, it get re-positioned in the center of your main screen.
If you are going to an object thatʼs not a card or stack, it gets selected with the
pointer tool if itʼs visible and within the rect of the card.
Inspecting
From Revolution:
• Use any accepted method of editing a script thatʼs native to Revolution. This includes:
• command+shift+s (Mac) or control+shift+s (Vista) for stack scripts
• command+shift+c or control+shift+c for card scripts
• Type command+e (Mac) or control+e (Vista) to edit the object beneath the pointer.
• Type command+d (Mac) or control+d (Vista) to edit the parent of the object beneath
the pointer. d=daddy (as in, whoʼs your daddy?)
From tRev:
• Type command (Mac) or control (Vista) +e to edit the object beneath the pointer.
• Type command (Mac) or control (Vista) +d to edit the parent (d=daddy) of the object
beneath the pointer.
• Depressing the shift key while doing either of those two operations will open the
objectʼs properties in Revolution using its property inspector.
• Hold down the option or alt key and move the pointer over any object to identify its
name and size. Then, press the command (Mac) or control (Vista) key to add it to the
tRev collection of tabs.
• Command or control+shift+s and command or control+shift+c also work in tRev as
they do in Revolution.
• You can also inspect the code or properties of an object from the Object browser as
described above.
• If you type control+space (Mac or Vista), the semi-long name of the Rev object
beneath your pointer will appear in tRevʼs active field. Holding down the shift key while
doing this will insert the short name of the object.
Coding
Once tRev editor is editing an objectʼs code, you can write handlers and comments just
as you would in Revolution – but, you have a couple of interesting options:
1. If you have the Auto-completion preference turned on, tRev will try and guess what
handler or variable name youʼre trying to type. It does this by suggesting the
completion of a word while you type.
• To accept a suggestion, type command (Mac) or control (Vista) +k.
• To view the next suggestion it has, type command or control+l (the key next to k on
the keyboard).
• To view the previous suggestion, type command or control+j (the key before k).
2. There are two types of comments in tRev that wield extraordinary power:
• Type --> messages to create a folder in the handler list called “messages.”
• Type /* my.properties + return to insert a special comment block that lets you
create a set of properties of the current object. This is called a “Raptor” handler.
• Type /* basic.properties followed by command or control+k and you will be able
to set the basic properties of the current object.
• Raptor handlers can be edited to suit your needs.
Code Navigation
As you accumulate handlers and call them in your code, you will notice that the text you
use to make these calls become hypertext links. Clicking these links will take you to the
handler they are calling. This is one of tRevʼs handiest features.
• If a link is show in italics, then it is pointing to a handler in another object.
• Handler links are based on handlers found within the current message path, as well as
those in the front scripts, back scripts, parent scripts and libraries that are running.
Handler List
As you write code in the form of handlers, they accumulate in a list to the left of your
code. If you use the folder comments, these handlers will collect into folders. The Sort
and Donʼt Sort buttons at the bottom of the Handler List will change the order in which
these handler names appear.
There are a few unique characteristics of the names in the Handler List:
• The first word of any block comment will be given the same status in the Handler List
as a handler.
• Functions and GetProp handlers will be followed by () .
Tabs
• Close tabs by clicking their Close box or by depressing the escape key. When one tab
remains, escape switches back to Rev.
• Type CMD or CTL+n for a New tab. (By default, this contains an Object browser.)
• Type CMD or CTL+[ to go to the Previous tab (to left of the current tab).
• Type CMD or CTL+] to go to the Next tab (to right of the current).
• Type CMD or CTL+shift+[ to go to the First tab.
• Type CMD or CTL+shift+] to go to the Last tab.
Errors
This panel automatically opens when you have a compile or execution error. The error
data will be found there, along with a link to the line number where Revolution believes
the error occurred. Most of the time, this line number is correct – but, sometimes it is the
previous line. The errant line of code will be red and hi-lighted, as well. The tab
belonging to the object will also be red.
Staying up-to-date
The application tRev is a standalone that houses the tRev components. tRev app
handles its own component updates. It tells you when it has a new component for you
and also when the app itself needs updating.
You can also check to see if there are new components or a new build of the app via the
Check for Updates menu item beneath tRev's Help menu.
It also shows you a link, in the bottom left corner of your Editor window, when there's
one or more components for you to update – or if a new version of the tRev app needs
to be downloaded and installed.
If there are new components to install, click Updates Available to retrieve them, and
they will be installed automatically. Some updates require restarting tRev, but most do
not. On the tRev site you will be advised as to whether you need to restart tRev.