Chapter 2. Concepts

2.1. Projects

Projects are a way to organize image collections based on how and where they are downloaded from. Projects can be exported and shared with friends or backed up to other locations.

2.1.1. Basic Newsgroup

The Basic Newsgroup project will create a new image collection based on one newsgroup server. The newsgroup server may have any number of groups and you can select which groups to add to the project.

2.2. Workbench

The term Workbench refers to the desktop environment. The Workbench aims to achieve seamless tool integration and controlled openness by providing a common paradigm for the creation, management, and navigation of workspace resources.

Each Workbench window contains one or more perspectives. Perspectives contain views and editors and control what appears in certain menus and tool bars. More than one Workbench window can exist on the desktop at any given time.

2.2.1. Resources

Resources is a collective term for the projects, folders, and files that exist in the Workbench. The navigation views provide a hierarchical view of resources and allows you to open them for editing. Other tools may display and handle these resources differently.

There are three basic types of resources that exist in the Workbench:

Files Comparable to files as you see them in the file system. Folders Comparable to directories on a file system. In the Workbench, folders are contained in projects or other folders. Folders can contain files and other folders. Projects Contain folders and files. Projects are used for builds, version management, sharing, and resource organization. Like folders, projects map to directories in the file system. (When you create a project, you specify a location for it in the file system.) A project is either open or closed. When a project is closed, it cannot be changed in the Workbench. The resources of a closed project will not appear in the Workbench, but the resources still reside on the local file system. Closed projects require less memory. Since they are not examined during builds, closing a project can improve build time. When a project is open, the structure of the project can be changed and you will see the contents.

2.2.2. Working Sets

Working sets group elements for display in views or for operations on a set of elements.

The navigation views use working sets to restrict the set of resources that are displayed. If a working set is selected in the navigator, only resources, children of resources, and parents of resources contained in the working set are shown. The problems view, tasks view and bookmarks view can all be filtered based on a working set via the Configure Contents view menu item. When using the search facility, you can also use working sets to restrict the set of elements that are searched.

Different views provide different ways to specify a working set. The views in the Eclipse SDK use the Window Working Set by default. The Window Working Set is specified in Window > Working Sets menu and is initially empty. Views that support working sets typically use the following working set selection dialog to manage existing working sets and to create new working sets:

When you create a new working set you can choose from different types of working sets. In the example below you can create a resource working set, a Java working set or a help working set.

If you create a new resource working set you will be able to select the working set resources as shown below. The same wizard is used to edit an existing working set. Different types of working sets provide different kinds of working set editing wizards.

Working sets may also be a part of a manual build workflow. With autobuild disabled the Project > Build Working Set menu becomes enabled. From here you are able to selectively build working sets of your choosing.

Note: Newly created resources are not automatically included in the active working set. They are implicitly included in a working set if they are children of an existing working set element. If you want to include other resources after you have created them you have to explicitly add them to the working set.

2.3. Perspectives

Each Workbench window contains one or more perspectives. A perspective defines the initial set and layout of views in the Workbench window. Within the window, each perspective shares the same set of editors. Each perspective provides a set of functionality aimed at accomplishing a specific type of task or works with specific types of resources. For example, the Collecting perspective combines views that you would commonly use while collecting image files.

Perspectives control what appears in certain menus and toolbars. They define visible action sets, which you can change to customize a perspective. You can save a perspective that you build in this manner, making your own custom perspective that you can open again later.

You can use the General > Perspectives preference page to open perspectives in the same window or in a new window.

2.3.1. Collecting Perspective

The Collecting Perspective is best suited for use when the image collection process is running.

2.3.2. Classic Perspective

The Classic Perspective attempts to match the legacy version 2.x look and feel of the program. It also includes some new additional views to add functionalty.

2.3.3. Browsing Perspective

The browsing perspective is best used for viewing individual image collections.

2.4. Views

Views provide alternative presentations as well as ways to navigate the information in your Workbench. For example, the Project Explorer and other navigation views display projects and other resources that you are working with.

Views also have their own menus. To open the menu for a view, click the icon at the left end of the view's title bar. Some views also have their own toolbars. The actions represented by buttons on view toolbars only affect the items within that view.

A view might appear by itself, or stacked with other views in a tabbed notebook. You can change the layout of a perspective by opening and closing views and by docking them in different positions in the Workbench window.

2.4.1. Fast Views

Fast views are hidden views that can be quickly opened and closed. They work like other views except they do not take up space in your Workbench window.

Fast views are represented by toolbar buttons on the fast view bar, which is the toolbar initially on the bottom left of the Workbench window. When you click the toolbar button for a fast view, that view opens temporarily in the current perspective (overlaying it). As soon as you click outside that view or the view loses focus it is hidden again. The fast view bar can also be docked on the other sides of the Workbench window.

2.4.2. Detached Views

Detached views are views that are shown in a separate window with a smaller trim. They work like other views except they are always shown in front of the Workbench window.

You can create a new detached view by dragging any open view outside of the Workbench window or by selecting Detached from the menu that opens when you right-click the view's tab.

2.4.3. Project Explorer View

The Project Explorer view provides a hierarchical view of the projects and resources in the Workbench. From here, you can open project resources for operations such as exporting.

Right-click on any resource in the Project Explorer view to open a pop-up menu that allows you to perform operations such as copying, moving, or deleting resources. To see a description of what each menu item does, move selection highlight to that menu item and press the context-sensitive help key (e.g., F1 on Microsoft Windows).

2.4.4. Thumbnail View

The thumbnail view is a presentation of all images found in the current folder (and subfolders) of the selected item in the Project Explorer. When you click on a project or folder in the Project Explorer, all images within these folders will load and appear as thumbnails in the thumbnail viewer.

2.4.5. Image View

The image view shows the currently selected image in the thumbnail view. The image can be zoomed in and out using the slider on the toolbar.

2.4.6. Console View

The console view shows all log activity of the application. It can help you track events and activities of the application.

2.4.7. Properties View

The properties view displays property names and values for a selected item such as a resource.

Toolbar buttons allow you to toggle to display properties by category or to filter advanced properties. Another toolbar button allows you to restore the selected property to its default value.

2.4.8. Progress View

The progress view shows the current activity of the application and will show a brief description of the activity. Any current processes in the progress view may be canceled by clicking the red cancel button on the right of the progress bar.

2.4.9. Problems View

As the application processes information, various problems, errors, or warnings may appear in the Problems view. For example, if a project fails to load because it contains errors, it will be logged in the Problems view.