Commands

menu

Menu

Drop down the menu for the Quotidian Viewer.

left view direction

right view direction

future view direction

past view direction

These four commands change the current direction the user is facing in the imaginary three-dimensional space. The direction of the arrow in the compass rose changes to indicate the view direction.  In the left and right directions, the user's view is down the x (horizontal) axis with the future to the left in the left view direction and to the right in the right view direction.

selected event's links

Events can be associated with several kinds of links. Events are implicitly linked to all instances of themselves that are attached to categories. The event definition may contain links to other events. The event definition may contain links to Web pages or other objects handled by Web browsers.

open timeline

The open timeline command shows the user a file chooser dialog. The user can browse through folders or directories and select a timeline file to load into the QViewer. These files always have the suffix .quotid, although it may not be shown to the user on some operating systems.

open timeline URL

The open timeline URL command shows the user a dialog box with an edit field to enter the URL of a timeline file. This file can be on the local machine or loaded over a network. The dialog box saves a list of the most recently selected URLs and tries to anticipate the user's choice by completing the URL. If the desired URL appears, hitting the enter key or the ok button will load that URL. If the anticipated choice is incorrect, the user should keep typing until the correct URL is entered.

remove timeline

The remove timeline command shows the user a dialog box with a list of the loaded timeline files. The user can choose one file from the list and remove it from the QViewer. All the events, categories and links defined in the timeline file are removed and the remaining set of timelines is redisplayed.

remove all timelines

The remove all timelines command removes all the timeline files currently loaded in the QViewer. The QViewer redisplays the imaginary space empty of events.

 

exit

The exit command closes any open QViewer windows and terminates the QViewer application.

new viewer window

The new viewer window command creates a new QViewer window that shares the set of loaded timeline files, display time and time scale with the other open QViewer windows.

close viewer window

The close viewer window closes the QViewer window in which this command is invoked.

When the command is invoked on the last open window, the behavior of this command varies according to the operating system. On Windows and Linux, this command exits the QViewer application when the last viewer window is closed. On Mac, this command closes the last window, but leaves the application running. These behaviors are consistent with application guidelines on each platform.

category mode

This command turns on category mode. This mode allows the user to move, re-size, hide and show timeline categories.

reset

This command resets many of the attributes of the display to their initial values:

When multiple viewer windows are active, some of the reset values apply only to the window where reset was invoked. Others, particularly the time-related ones, apply to all viewer windows.

real-time mode

This commands toggles real-time mode on and off.

set time to clock time

This command sets the display time to the current clock time, which is read from the operating system's real-time clock. This clock typically has millisecond precision, but its accuracy depends on the user's operating environment.

move time to start of event

This command sets the display time of QViewer to be the start time of the currently selected event. If no event is selected, the command has no effect.

move time to end of event

This command sets the display time of QViewer to be the end time of the currently selected event. If no event is selected, the command has no effect.

select the previous event in the same category as the current selected event

This command selects the event that is just before the currently selected event. The display time of QViewer is set to be the end time of the newly selected event. If no event is selected or if the currently selected event is the first one in a category, the command has no effect.

select the next event in the same category as the current selected event

This command sets selects the event that is just after the currently selected event. The display time of QViewer is set to be the start time of the newly selected event. If no event is selected or if the selected event is the last one in a category, the command has no effect.

 

time options ...

This command presents the user with a dialog box to choose the current timezone and current calendar of the QViewer. These are used to print the display date and time on the datetime box and to parse the text the user types into that box. QViewer uses a standard timezone database that arranges timezone locales into continent-city pairs. These are presented in two selection boxes. When the Gregorian calendar is selected, an additional selection box is enabled to choose the date when the changeover from Julian to Gregorian was made.

 

orthographic view

The display is normally set to the perspective view. As events get farther from the user (down the time axis in the past and future directions, down the x axis in the left and right directions), the events get smaller and recede towards a vanishing point at the center of the display. In the orthographic view, events do not get smaller with distance. This may be useful when facing the left or right view directions, in order to compare durations at different distances. It is less useful in the past and future directions, where all time differences are flattened.

show event info in browser

A temporary Web page is created that contains information about the current selected event and the category to which it is attached. This information can include the text fields the author of the timeline has added to the event and category, and the citation field showing the source of the data. What data to show can be set in the selected event info dialog box. This command is disabled when no event is selected.

 

event info ...

A dialog box is displayed with the data fields that can be shown when the show event info in browser choice is selected. A field with a checked box is included in the event info page.

play sounds

This choice toggles between enable audio (green) and disable audio (gray). When audio is enabled, the QViewer will play audio files associated with events. Enabling audio in one viewer causes this choice to be disabled in all other viewer windows. The viewpoint of that viewer is used to render spatial sound.

If this choice is disabled in all windows, no audio is played.

 

show scroll bars

The scroll bars on three sides of the display area can be turned off temporarily with this choice. If the scroll bars are never wanted, the scrollbars_enabled variable can be set to false in the edit preferences window.

 

show compass rose

The compass rose can be turned off temporarily with this choice. If the compass rose is never wanted, the compass_rose_enabled variable can be set to false in the edit preferences window. Note that the compass rose provides important feedback to the user about the current display direction.

 

show status line

This choice controls whether the status line at the bottom of the QViewer window is shown or hidden.

 

show time scale

This choice controls whether the time scale ruler is shown along a category when an event in the category is selected.

 

show mouse sliders

This choice allows the drawing of the mouse sliders to be turned off. When turned off, they never appear. When turned on, they are drawn and hidden according to mouse movements.

 

show duration in tooltips

This choice causes popup tooltips to show the duration of an event in addition to the normal tooltip text associated with an event.
 

edit preferences ...

This window shows a list containing all the preference variables available to users. Each variable has a default value that is built-in to the QViewer and set when the QViewer is first installed. Selecting a row in the list shows some information about the variable and its possible values. The author can add a new value for a preference variable in the rightmost column of the list. Erasing the value in the rightmost column restores the default value.

The window has a tab for QViewer preferences, a Common tab for preferences shared with both the QViewer and the QEditor, and tabs for each recognized controller device.

Currently, preference values are read only once when the QViewer program is started. The user must restart the QViewer to use changed preferences.

 

help contents ...

This command asks your browser to display the table of contents for the on-line Quotidian Viewer documentation.

As an alternative, the F1 (or help) key provides context help. When the key is hit, your browser will show information about the part of the QViewer window with the focus, or the menu item or toolbar button that you have selected by pressing down (and not released) with a mouse button.

 

about

This command shows a dialog box with version and copyright information for the QViewer. The tabs in the window are used to show license information relevant to the third-party software included with the QViewer distribution.

 

bookmarks

This command shows a dialog box containing a list of bookmarks. These act like bookmarks or favorites in a web browser but are usually links to events or timelines. The create, edit, and delete buttons let you change the contents of the list. The load button causes the link selected in the list to be loaded into the viewer.

 

bookmark selected event

This command adds the currently selected event to the list of bookmarks.

 

find

This command lets you search for text in loaded timelines.

 

move selected event to screen center

When enabled this command causes each selected event to move to the center of the screen.

 

send event coordinates to Google Earth

When enabled this command causes geographic coordinates to be written to a file that can be read by Google Earth. To use this feature you must install Google Earth and set it up to work with Quotidian. See: Setting up Quotidian and Google Earth.

© 2011 Quotidian Incorporated