# &app; manual

# &app; Manual V&manrevision;

2006
Jean Bréfort

&legal;

GNOME Documentation Project
Jean
Bréfort

     jean.brefort@normalesup.org

&app; Manual V&manrevision;
&date;

Jean Bréfort jean.brefort@normalesup.org

GNOME Documentation Project

This manual describes version &appversion; of &app;.

## Feedback

To report a bug or make a suggestion regarding the &app; application or this manual, go to the &app; home page.

&app; allows you to display molecular structures.

## Introduction

The &app; application is a simple molecular structures visualizer.

## Getting started

### To Start &app;

You can start &app; in the following ways:

Applications menu

  Choose Education Molecules Viewer .

Command line

  Type `gchem3d-viewer`, then press Return.

### When You Start &app;

When you start &app;, the following window is displayed:

#### &app; main window

Screenshot of the &app; main window.

The &app; window contains the following elements:

Menubar

  The menus on the menubar contain all of the commands you need to work with files in &app;.

Display area

  The display area contains the contents of an opened file if any.

### To Open a File

To open a file, choose File Open to display the Open File dialog. Select the file that you want to open, then click OK. The file is displayed in the &app; main window.

&app; can open files on a distant server using the Gnome Virtual File System.

&app; can open several file formats. Available formats are:

- ChemML files (*.cml)

- MDL MOL files, MDL Structure Data files (*.mol;*.sd;*.sdf)

- PDB files (*.pdb;*.ent)

- XYZ Coordinate Format files (*.xyz)

You can open multiple files in &app;. The application displays each file in its own window.

Recently opened file appear in the File Open recent sub-menu.

### To Open Multiple Files from a Command Line

You can run &app; from a command line and open a single file or multiple files. To open multiple files from a command line, type the following command, then press Return:

`gchem3d-viewer file1 file2 file3`

## Usage

### To Save the View as an Image

To open a file, choose File Save as Image... to display the Save as image dialog. Select a file name and, if wanted, a file type, then click OK.

Supported types are VRML, and all types that GdkPixbuf can export. You'll find an exact list in the drop-down file type menu.

If no file type is specified, &app; tries to determine the type from the file name. If it does not succeed, the default type (VRML) will be used.

An appropriate extension will be added to the file name if none is found.

PostScript and PDF files can also be obtained with the Print command.

### To Print the View

To open a file, choose File Print... .

&app; uses a 300 dpi resolution when printing.

You might want to change the Background color before printing.

### To Change the Model Options

&app; id able to display a molecule using two model types: the ball ans stick model and the compact model. The first one is the default.

To change the mode, choose either View Balls and sticks or View Space filling .

You can also change the orientation. Just click somewhere in the view and drag the mouse until you get the wanted orientation.

### To Change the Background Color

To change the backgound color, choose View Background color and select the appropriate color in the palette, or choose a custom color.

### To Ask a Question

If you choose Help Ask a question, your mail agent should pop up with a new message to the Gnome Chemistry Utils mailing list.

Another way to get some help is to connect on the #gchemutils channel at irc.gimp.net and ask your question there (if you are not alone on the channel).

### To Find the Gnome Chemistry Utils on the Web.

If you choose Help Gnome Chemistry Utils on the web, the default web browser should pop up and display the main page for the Gnome Chemsitry Utils.

The main page is http://gchemutils.nongnu.org and the project page at savannah http://savannah.nongnu.org/projects/gchemutils.

### To Report a Bug

To report a bug, you must use the bug page for the Gnome Chemistry Utils at Savannah. You can access it by choosing Help Report Bugs (hopefully you'll have only one at once to report).

You can also type the bug report page address directly in the browser. The bug repository is at https://savannah.nongnu.org/bugs/?group=gchemutils

## License

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

A copy of the GNU General Public License is included as an appendix to the GNOME Users Guide. You may also obtain a copy of the GNU General Public License from the Free Software Foundation by visiting their Web site or by writing to

        Free Software Foundation, Inc.
        51 Franklin St - Fifth Floor
        Boston, MA 02111-1307
        USA