Revision as of 17:19, 20 July 2007

Home < Slicer3:Human Interface and Style Guide for Developers

Slicer Human Interface Design and Style Guidelines

Introduction

3D Slicer (or Slicer) is a large and continuously developing application. Its base is designed to offer substantial core functionality, and its modules extend that functionality to include specialized and cutting-edge research tools and interoperability with other open source softwares. The development effort seeks to simultaneously ensure that Slicer meets the needs of a broad user community, that developers can easily contribute to and extend the application, and that the software remains easy to test and maintain.

These human interface design and style guidelines are a resource for Slicer developers who want to create module interfaces that are easy to learn, understandable and usable, and that conform to Slicer’s general appearance and behavior conventions. The recommendations in this document are designed to be easy for developers to apply and their adoption is strongly encouraged. However, a developer’s interface design can depart from convention when these guidelines appear inappropriate for a particular application.

The guidelines are intended for software developers, interface designers, and graphic artists who will be creating core functionality or software modules for 3D Slicer. Included design recommendations are based broadly on cognitive science, human perception, human factors and HCI. Included is information on basic interface components, choosing and using them effectively and in a manner consistent with Slicer conventions.

Organization

This document is organized into the following two sections:

1. Slicer Design Principles

2. Slicer Widget and Interface Style Specifics

Within these sections, developers will find recommendations that promote usable and consistent Slicer module interfaces, and link to technical resources where appropriate.

Slicer Design Principles

Design for scientists and engineers

Remember that design is not just about appearance and style; it's about communicating ideas and solving problems. Most users of the software you develop for Slicer will be from one (or more) of these communities:

Algorithm researchers (who work within Slicer's development environment and with associated toolkits)
Biomedical engineers (who rely on Slicer's interactive enironment and scripting capabilities)
Application scientists (who use Slicer as a desktop application and turnkey system)

In general, these categories of users will not want appearance and style to get in the way of the task they want to accomplish. Interfaces should have a well-organized, accessible, simple and clean design that:

exposes essential feature,
provides access to essential information, and
permits a task to be accomplished efficiently and reliably.

Accessibility & appropriateness

Currently, Slicer has no program to internationalize or localize its interface. To keep the GUI as appropriate for a multinational and multicultural user base, whenever possible, appropriate language and graphics that aren't overloaded with meaning should be used. Make sure all widgets have explanatory tool tips (balloon help text), and provide keyboard "hot-keys" for important functionality in a manner consistent with Slicer's conventions.

Follow Slicer's User-Centered Design Practice

Design for varying levels of expertise

Keep it simple

Keep it well-organized

Keep it stable

Keep users informed

Allow users to correct mistakes

Respect users' wishes (application settings)

Maintain consistency with Slicer's appearance and behavior

Make principled design decisions

Slicer Interface Design & Style Information

Overall Look and Feel

GUI Style: Try not to add style elements (like foreground and background color, font, relief, etc.) to the interface you create; let the options database (as set up by the vtkSlicerTheme class) specify the style for the widgets in your module so that all modules appear consistent within the Slicer3 application.

Module style

Collapsing frame style

Tabbed notebook style

Application windows

Types of windows

Window appearance

Message windows & dialogs

Other pop-up windows

Menu bar and its menus

File Menu

Edit Menu

View Menu

Help Menu

Application settings

Confirm on delete

Check vtkSlicerApplication::ConfirmDelete setting; if a user has requested to be presented with a confirm on delete, then give them that option.

Adding your own application setting options

Mouse modes

Basic mouse modes

Adding new mouse modes

Mouse cursors

Basic mouse cursors

Defining your own mouse cursors

Keyboard shortcuts

Keyboard shortcut paradigm

Basic keyboard shortcuts

Defining your own keyboard shortcuts

Event Bindings

With respect to the specification of keyboard accelerators, please follow these three recommendations;

Before assigning "hot-keys" to functionality, either in the main Slicer application or in a new module, please consult the Slicer3 event bindings table (and design plan) to make sure the key is not already assigned.
Across Slicer modules, try to use similar "hot-key" assignments for similar functionality; this consistency makes Slicer easier to learn.
Once you assign "hot-keys" in your module, please add those mappings to the Slicer3 event binings table for others to reference.

Application Font

Verdana is the font chosen for the 3DSlicer brand.

Maintaining consistency of type is an important component of maintaining a coherent look and feel for 3DSlicer and any related or derived visual communications. Verdana was designed specifically to be read on a digital display; it is recommended that we use Verdana (or Geneva) wherever possible in 3DSlicer's web presence and online tutorial materials, and wherever reasonable and appropriate in formal printed materials.

Within the software, since it can't be guaranteed that these fonts will be widely available on all platforms, Helvetica or Arial should be used as a substitute. Slicer's theme sets the application font to be Helvetica 8 normal. Please avoid typefaces with serifs.

Icons

Icons can be a powerful way to represent complicated information within a small footprint on the GUI panel. They associate a visual image with data, state, or a particular operation.

They should be easy to parse, convey a strong metaphor, and not require significant time for a user to interpret.
They should be memorable so that a user can recognize them quickly in future sessions with your module.
If an icon already exists within 3DSlicer to represent the data, state or operation you want to indicate, then re-use that icon (indicate visibility with the open/shutting eye, for example.)
Note: if the concept is too difficult to represent with a picture, then a text label can always be used instead!

When designing icons, do bear in mind that it's possible to offend users with images that have cultural or polictal connotations. Even colors can have connotations for users in different parts of the world that may be surprising and unintended for the designer and developer. Generally speaking, it's useful to avoid images that contain:

icons that depict only hands or feet
images of animals
maps containing disputed boundaries or region names.
lists of countries that are not in alphabetical order.
pictures of flags
pictures of money

Slicer icon conventions

These icon blanks are provided for download and use:

Enabled or Enabled+Selected:
Disabled or Enabled+Deselected:
Enabled Menubutton:
Disabled Menubutton:

Icons as Buttons & MenuButtons

Icons inside Menus

3DSlicer icons should all be of dimension 21x21 pixels.

Enabled or Enabled + Selected icons should have:

a white background (r=255, g=255, b=255, or #FF FF FF)
a black hairline along the perimeter (r=0,g=0,b=0, or #00 00 00).

Disabled or Enabled + Deselected icons should have:

a grey background, value (r=230, g=230, b=230, or hex value #E6 E6 E6)
a grey hairline perimeter of value (r=178, g=178, b=178, hex value #B2 B2 B2).

Icons currently used in Slicer's Base

Below is a figure of icons currently in use in 3DSlicer. If the icon you need is already used in Slicer, we encourage its re-use in your own module (the visibility icon is a good example). However, if an icon is re-used, make sure you are using it to convey the same meaning/function -- icons shouldn't have different meanings in different places. Finally, make sure any new icons designed for a module don't duplicate ones already in use elsewhere in Slicer.

Widget-specific conventions

Buttons & Pop-up Buttons

PushButtons

PushButtons with icons

Representing state with toggling icons

ChangeColorButtons & Color Selector Widgets

HelpButtons

Widgets for Selecting things

Using selection widgets effectively

MenuButtons

MenuButtons with icons

Menus & menu behavior

Menuitems

Cascades

Context menus

Checkbuttons and Radiobuttons

Checkbuttons and Radiobuttons with icons

Entry Widgets

Listboxes

Multi-column Lists

SpinBoxes and SpinButtons

Widgets for Adjusting things

Choosing the best widget for the task

Sliders

Range Widgets

Widgets for Displaying things

Choosing the widgets for the task

Labels

Tree Widgets

Text Widgets

Toolbars & Toolbar Sets

Progress Feedback

Widgets for Editing things

When to use an editor widget

Color Transfer Function Editor

Parameter Value Function Editor

Piecewise Function Editor

Text Property Editor

Widgets for Containing things

Organizing your GUI panel

Frames and SplitFrames

Pop-up Frames

Notebooks

FileBrowsers and FileBrowserDialogs

Canvas Widgets

Groups of Widgets

Slicer Widgets

Available Slicer widgets

Designing your own widgets

Layout Examples

Providing Help

Language

Credit and Logos