MapTool User Interface: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
No edit summary
(Adding an image of the minimum UI.)
Line 2: Line 2:


==Overview of the MapTool Application Window==
==Overview of the MapTool Application Window==
[[Image:MapToolUI.png|thumb|The minimum MapTool interface with no optional panels open.]]
Each open instance of MapTool has an application window which contains a few ever-present components.  
Each open instance of MapTool has an application window which contains a few ever-present components.  



Revision as of 00:36, 19 October 2019

 This article is a draft, be advised that information it contains may be incomplete, inaccurate, or unclear.

Overview of the MapTool Application Window

The minimum MapTool interface with no optional panels open.

Each open instance of MapTool has an application window which contains a few ever-present components.

The application window always consists of a title bar, a menu bar, the map building and navigation tools, and the map view. One or more panels may be docked to sides of the map view or even floated seperate from the main application window.

The default layout also docks the `Resource Library` panel at the top left side, and a tabbed panel containing the `Map Explorer` and `Draw Explorer` in the lower left side, and the `Chat` panel. This default layout can be restored by selecting Window > Restore Layout.

Multiple instances of MapTool

Users may open multiple instances of MapTool at once, for instance to test the player view on one instance while serving a campaign file in another on the same computer. When doing this, each instance of the program will have its own application window with its own user interface. When doing this, it is helpful to keep all panels docked rather than floating to prevent confusion between open instances.

Menu bar

Maptool’s menu bar consists of seven dropdown menus. Underlined letters in a menu command indicates the hotkey that selects that command when the menu is open. Code styled commands next to a menu command indicate a shortcut key for that command. Shortcut keys listed are for MapTool on Windows and may differ for your operating system. For other OSes, you can verify your shortcut keys by looking in the menus of your MapTool installation.

File Menu

The File menu mainly contains Campaign File and networking commands, along with other miscellaneous export functions.

  • New Campaign
This creates a new campaign file with default properties, states, and a single map called 'Grasslands' configured according to the installation's new map defaults.
  • Open Campaign... [Ctrl-O]
Opens a file explorer window to select and open a MapTool Campaign File.
  • Save Campaign [Ctrl-S]
Saves the current campaign file. If it is a new campaign, MapTool opens a file explorer window to select a save location and name the campaign file.
  • Save Campaign As...
Opens a file explorer window to select a save location and name the campaign file.
  • Save Chat Log History...
Opens a file explorer window to select a save location and name an HTML file containing the entire content of the current chat panel.
  • Export
Submenu containing additional options.
  • Screenshot [Ctrl+Shift-S]
Opens the Export Screenshot dialog.
  • Screenshot As...
Opens the Export Screenshot dialog.
  • Campaign As...
Opens the Export Campaign dialog, which allows saving a campaign file in a format compatible with older versions of MapTool.
  • Campaign Repository File...
Opens a file explorer window to select a save location and name a ZIP file containing the entire content of the campaign for use as a Campaign Repository.
  • Add Resource to Library...
Opens the Add Resource to Library dialog, which will add new resources to the Resource Library.
  • Start Server...
Starts a new MapTool server from the current instance of Maptool with the currently open campaign file. See Networking.
  • Connect to Server...
Connect to a local or remote MapTool server.
  • Disconnect from Server...
Disconnect from the current server. This opens the campaign file which was open before connecting to a server.
  • Connection Information...
Displays additional connection information, such as the IP address.
  • Recent Campaigns
Shows a list of up to 10 most recently opened campaign files.
  • Exit
Will prompt the user to save the current campaign and close MapTool.

Edit Menu

The Edit menu contains drawing and token editing commands and access to campaign settings and MapTool preferences.

  • Undo Drawing [Ctrl-Z]
Removes the most recent drawing object that was created via the Draw tool.
This menu command only affects drawings created with the Drawing Tool. Token movement can be undone by right-clicking a token and selecting 'Revert last move'. Token removal, and changes to the Vision Blocking Layer and Fog of War cannot be undone/redone. However, the key command may affect text in input areas such as the chat window and macro editor.
  • Redo Drawing [Ctrl-R]
Re-adds the most recently drawing object that was removed via Undo Drawing.
This menu command only affects drawings created with the Drawing Tool. Token movement can be undone by right-clicking a token and selecting 'Revert last move'. Token removal, and changes to the Vision Blocking Layer and Fog of War cannot be undone/redone. However, the key command may affect text in input areas such as the chat window and macro editor.
  • Clear All Drawings [Ctrl+Shift-D]
Removes all items in the Draw Explorer on the current map.
This menu command only affects drawings created with the Drawing Tool. Tokens, the Vision Blocking Layer, and Fog of War are not affected.
  • Copy [Ctrl-C]
Copies a token to the clipboard.
This menu command only affects Tokens, although the key command can affect text in input areas such as the chat window and macro editor.
  • Cut [Ctrl-X]
Cuts a token, removing it from the map and placing it in the clipboard.
This menu command only affects Tokens, although the key command can affect text in input areas such as the chat window and macro editor.
  • Paste [Ctrl-V]
Pastes any token in the clipboard to the current map underneath the current cursor position.
This menu command only affects Tokens, although the key command can affect text in input areas such as the chat window and macro editor.
  • Campaign Properties...
Opens the Campaign Properties dialog. These are settings which are saved with the current campaign such as token properties, states, and more.
  • Preferences...
Opens the Preferences dialog. These are settings which are saved with the local installation of MapTool. They are not saved with a campaign, and will need to be reconfigured on any new installation of MapTool.

Map Menu

  • New Map... [Ctrl-N]
  • Quick Map
  • Import Map...
  • Export Map...
  • Player Visible [Ctrl-H]
  • Restore Fog-of-War [Ctrl+Shift-R]

View Menu

Tool Menu

Window Menu

Help Menu