Logitech LogiCad3D Magellan/SPACE MOUSE Classic, LogiCad3D Magellan/SPACE MOUSE Plus, LogiCad3D Magellan/SPACE MOUSE Plus XT User Manual

Copyright

This manual and the programs on the LogiCad3D CD-ROM are protected by copyright of LogiCad3D. They must not be copied or distributed without the express written permission of LogiCad3D. Violators will be prosecuted to the fullest extent of civil and criminal laws. The right to these programs and the manual are held by:

LogiCad3D GmbH - A Logitech Company An der Hartmuehle 8 D-82229 Seefeld, Germany Tel: + 49 (0) 8152-9919-0 Fax: + 49 (0) 8152-9919-50 Email: help@logicad3d.com Web:

The information in this manual is subject to change without notice. LogiCad3D shall not be held liable for technical or editorial errors or omissions contained herein, nor for incidental or consequential damages resulting from the furnishing, performance or use of this material. The information in this manual may not be changed without special notification. The instructions in this manual are checked regularly and necessary corrections are included in all subsequent editions. More copies or newer editions of this manual and technical information on the Magellan/SPACE MOUSE can be obtained only from LogiCad3D GmbH.

www.logicad3d.com

NOTICE:

The use of the Magellan/SPACE MOUSE is primarily intended for graphical applications only. The company LogiCad3D is not liable for any damages (including all kinds of damage from lost profit, operating breakdown, loss of business information, data or other kinds of monetary loss) that are due to either proper or improper use of this LogiCad3D product. In any case, LogiCad3D’s liability is restricted to the amount of money paid for the product. This exclusion does not hold for damages caused by LogiCad3D intentionally or grossly negligent. In the same way, claims based on general laws and rules of product liability remain untouched. For other applications LogiCad3D declines any liability or claims for damages.

SPACE MOUSE is a registered European trademark of LogiCad3D GmbH.

TM

Magellan Inc./GmbH.

This device uses one or more patents held by the Deutsches Zentrum für Luft- und Raumfahrt e.V. (DLR).

Edited 07/00 by LogiCad3D GmbH - A Logitech Company, GERMANY.

is the US trademark of LogiCad3D

The citation of names in this manual as a rule does not mention existing patents, registered designs or trademarks. Missing corresponding remarks do not justify the assumption that the names may be freely usable. All trademarks are acknowledged where applicable.

NOTE: For optimal viewing of this document, it is recommended to use the latest version of Adobe Acrobat Reader, available on the Magellan/SPACE MOUSE driver CD-ROM or at

www.adobe.com/acrobat.

2

Introduction to Magellan/SPACE MOUSE

Magellan/SPACE MOUSE is a 3D input device that is used to control the position and orientation of 3D graphical objects in virtual space. The device controls three translational degrees of freedom (X, Y and Z) and three rotational degrees of freedom (A, B and C).

How Magellan/SPACE MOUSE Controls Six Degrees of Freedom

Moving the onscreen object is as easy as moving the Magellan/SPACE MOUSE cap. Shift the cap right or left to move the onscreen object horizontally through space. Pull the cap up or press it down to move the object vertically through space. Pull the cap toward the user or press it away to zoom in and out. Rotate the cap about the desired axis to rotate the onscreen object.

with a 3D CAD application, it takes over the functions of the viewing and supply hand (e.g. for a right-handed person this is the left hand). The working hand (e.g. the right hand) operates the conventional 2D mouse. This corresponds to the natural way of working with real objects and therefore supports intuitive creativity when generating and manipulating 3D objects in a CAD application.

How to Optimally Handle Magellan/ SPACE MOUSE

Spread three or four fingertips around the cap and gently shift and twist it. Apply only light fingertip pressure to the cap. DO NOT grasp the entire cap in your hand. It does not matter whether the right or left hand is used. No shoulder or wrist movement is necessary. The

Note that the values input by Magellan/SPACE MOUSE are not interpreted as absolute position commands but as velocity commands. When the cap is displaced translationally or rotationally by a constant amount (a distance measurement), the graphical object is assigned a continuous speed in the same direction (a velocity measurement). The magnitude of the cap’s displacement determines the magnitude of the onscreen object’s velocity.

Two Hands for Intuitive Control

Magellan/SPACE MOUSE allows for simultaneous control of six degrees of freedom with only one hand. When used in conjunction

ergonomic design allows the hand to rest on the device without fatigue.

Displacement Range

The cap may be shifted up to ±1.5 mm in the translational directions. The cap may be rotated up to ±4 degrees about the rotational axes.

Magellan/SPACE MOUSE Measurement System

The cap movements are measured inside the cap by a worldwide-patented, optoelectronic measuring system. The cap is suspended by springs and always returns to its initial position.

4

Installation

To install the Magellan/SPACE MOUSE device and driver software on UNIX systems, see the information below. For help with installation problems see Troubleshooting.

Package Contents

The product package contains:

 a 3D input device (Magellan/SPACE MOUSE

Classic, Plus or Plus XT);

 a CD-ROM containing the driver software;

 the product documentation; and

 a serial port adapter (if required for the

system specified at the time of order).

Hardware Installation

The Magellan/SPACE MOUSE has a serial interface cable with a 9-pin female connector, which must be connected to the proper serial port (RS232 or V24) of your UNIX workstation. The Magellan/SPACE MOUSE cable either plugs directly into the serial port at the back of the workstation or may require a separate adapter cable, which has been included if required. TURN OFF the workstation before connecting the Magellan/SPACE MOUSE. Once the connections have been made, you can restore power to the workstation. For further information see the related appendices listed below.

Related Sections

Connecting to the RS232 Serial Port Connecting to IBM RS6000 Workstations Connecting to SGI Workstations Connecting to SUN Workstations

Supported Platforms

The Magellan/SPACE MOUSE X-Window driver is supported on the following platforms:

 DEC

Digital Equipment Corporation with OSF1

 HP

Hewlett-Packard Company with HP-UX

 IBM

International Business Machines Corporation with AIX

 SGI 53

Silicon Graphics Inc. with IRIX

5.3

 SGI 62/32

Silicon Graphics Inc. with IRIX

6.2/32 bit (R4000, R5000, ... )

 SGI 62/64

Silicon Graphics Inc. with IRIX

6.2/64 bit (R10000, ... )

 SGI 63/32

Silicon Graphics Inc. with IRIX

6.3/32 bit (R10000, ... )

 SGI 64/64

Silicon Graphics Inc. with IRIX

6.4/64 bit (R10000, ... )

 SGI 65/64

Silicon Graphics Inc. with IRIX

6.5/64 bit (R10000, ... )

 SUN

Locate your application in the following pages of this manual. The appropriate global installation commands and other important installation instructions are listed for each supported platform.

NOTE: This list was last updated 10/2000. (For the most current application list, please see www.logicad3d.com/software/drivers.) If the list indicates that an appropriate driver is included with your application, you should consult the application manual for the appropriate Magellan/SPACE MOUSE installation procedure.

Sun Microsystems with Solaris

5

Application List & Driver Installation Commands

Application Platform Installation Command/Note

4D Navigator (v.4.20 or higher)

Alias|Wavefront

(all current versions)

ANSA (up to v.9.5)

ANSA (v.9.5)

Ansys (v.5.6)

CADDS5 (v.5.2 or higher)

CADENAS (all current versions)

Camand (Camax)

(all current versions)

CATIA (v.4.0 or higher)

CDRS (v.6.0 or higher)

Clovis (v.3.0, A36 or higher)

Covise (all current versions)

Division (all current versions)

EUCLID (up to v.2.3)

FIDES (v.3.92 or higher)

HP Shared 3D Viewer

(all current versions)

HyperMesh (v.3.1)

I-DEAS Master Series

(v.4, 5, 6, 7 or higher)

ICEM SURF (up to v.3.0)

HP, IBM, SGI (all), SUN ./xinstall

SGI 53 ./sgi/mglinst first permanent SGI 62/32 ./sgi/mglin32 third SGI 62/64 ./sgi/mglin64 third SGI 63/32 ./sgi/mgl6332 third SGI 64/64, SGI 65/64 ./sgi/mgl6464 third

IBM ./xinstall

(install X-Window driver

v.2.0/3.0)

SGI 53 ./sgi/mglinst first permanent SGI 62/32 ./sgi/mglin32 first permanent SGI 62/64 ./sgi/mglin64 first permanent SGI 63/32 ./sgi/mgl6332 first permanent SGI 64/64, SGI 65/64 ./sgi/mgl6464 first permanent

HP, SGI (all), SUN ./xinstall

DEC, HP, IBM, SGI (all), SUN

HP, IBM, SGI (all), SUN ./xinstall

DEC, HP, IBM, SGI (all), SUN

SGI 53 ./sgi/mglinst second permanent SGI 62/32 ./sgi/mglin32 second permanent SGI 62/64 ./sgi/mglin64 second permanent SGI 63/32 ./sgi/mgl6332 second permanent SGI 64/64, SGI 65/64 ./sgi/mgl6464 second permanent

HP, IBM, SGI (all), SUN ./xinstall

SGI 53 ./sgi/dialinst cdrs SGI 62/32 ./sgi/dialin32 cdrs SGI 62/64 ./sgi/dialin64 cdrs SGI 63/32 ./sgi/dial6332 cdrs SGI 64/64, SGI 65/64 ./sgi/dial6464 cdrs

SGI (all)

HP, SGI (all)

SGI 53 ./sgi/mglinst second permanent SGI 62/32 ./sgi/mglin32 second permanent SGI 62/64 ./sgi/mglin64 second permanent SGI 63/32 ./sgi/mgl6332 second permanent SGI 64/64, SGI 65/64 ./sgi/mgl6464 second permanent

HP, IBM, SGI (all), SUN ./xinstall

SGI (all)

DEC, HP, IBM, SGI (all), SUN ./xinstall

SGI 53 ./sgi/mglinst first permanent SGI 62/32 ./sgi/mglin32 first permanent SGI 62/64 ./sgi/mglin64 first permanent SGI 63/32 ./sgi/mgl6332 first permanent SGI 64/64, SGI 65/64 ./sgi/mgl6464 first permanent

Driver included with application

6

Application Platform Installation Command/Note

ICEM SURF (v.3.0 or higher)

IGRIP (all current versions)

Java3D (all current versions)

KISMET (all current versions)

MADYMO (v.5.1 or higher)

Medina - Pre/Post- Processor for FEM (all current versions)

Pam System Internat for VT CRASH (all current versions)

Patran (v.2.x, 3.x up to 8.x)

Patran (v.9.0 or higher)

Pro/ENGINEER (v.17 or higher)

Prosolvia Clarus

(all current versions)

Prosolvia Oxygen

(all current versions)

PT/PRODUCTS (all current versions)

ROBCAD (v.3.6 or higher)

Silma (all current versions)

SIMPACK (all current versions)

Softimage 3D (v.3.7 or higher)

Solid Designer (prior to v.6.0)

DEC, HP, IBM, SGI (all), SUN ./xinstall

SGI (all) ./xinstall

SUN

Follow the instructions found at

www.logicad3d.com/software/dri vers/SUN-Java3D.html

IBM ./xinstall

(install X-Window driver

v.2.0/3.0)

SGI 53 ./sgi/mglinst first permanent SGI 62/32 ./sgi/mglin32 first permanent SGI 62/64 ./sgi/mglin64 first permanent SGI 63/32 ./sgi/mgl6332 first permanent SGI 64/64, SGI 65/64 ./sgi/mgl6464 first permanent

SGI 53 ./sgi/dialinst madymo SGI 62/32 ./sgi/dialin32 madymo SGI 62/64 ./sgi/dialin64 madymo SGI 63/32 ./sgi/dial6332 madymo SGI 64/64, SGI 65/64 ./sgi/dial6464 madymo

HP, IBM, SGI (all), SUN ./xinstall

SGI (all)

SGI 53 ./sgi/dialinst patran permanent SGI 62/32 ./sgi/dialin32 patran permanent SGI 62/64 ./sgi/dialin64 patran permanent SGI 63/32 ./sgi/dial6332 patran permanent SGI 64/64, SGI 65/64 ./sgi/dial6464 patran permanent

SGI (all)

DEC, HP, IBM, SGI (all), SUN ./xinstall

SGI (all)

DEC, HP, IBM, SGI (all), SUN ./xinstall

HP, IBM, SGI (all), SUN

HP, IBM, SGI (all), SUN ./xinstall

SGI 53 ./sgi/mglinst first permanent SGI 62/32 ./sgi/mglin32 first permanent SGI 62/64 ./sgi/mglin64 first permanent SGI 63/32 ./sgi/mgl6332 first permanent SGI 64/64, SGI 65/64 ./sgi/mgl6464 first permanent

DEC, HP, IBM, SUN ./xinstall SGI 53 ./sgi/mglinst second permanent SGI 62/32 ./sgi/mglin32 second permanent SGI 62/64 ./sgi/mglin64 second permanent SGI 63/32 ./sgi/mgl6332 second permanent SGI 64/64, SGI 65/64 ./sgi/mgl6464 second permanent

Driver included with application

7

Application Platform Installation Command/Note

Solid Designer (v.6.0 or higher)

SIMPACK (all current versions)

Softimage 3D (v.3.7 or higher)

Solid Designer (prior to v.6.0)

Solid Designer (v.6.0 or higher)

Strim (prior to v.3.0)

Strim (v.3.0 or higher)

SuperScape VRT/ Viscape

(all current versions)

TEBIS (v.3.1 Release 8)

TEBIS (v.3.1 Release 9)

TECOPLAN (all current versions)

TGS OpenInventor

(v.2.5 or higher)

Unigraphics (v.11 or higher)

VEGA (v.3.0 or higher)

Virtual Design 2

(all current versions)

VisFly (v.1.1 or higher)

VisMockUp (v.1.1 or higher)

Vuppet Master

(all current versions)

World Tool Kit

(all current versions)

World Up (all current versions)

DEC, HP, IBM, SGI (all), SUN ./xinstall

HP, IBM, SGI (all), SUN ./xinstall

SGI 53 ./sgi/mglinst first permanent SGI 62/32 ./sgi/mglin32 first permanent SGI 62/64 ./sgi/mglin64 first permanent SGI 63/32 ./sgi/mgl6332 first permanent SGI 64/64, SGI 65/64 ./sgi/mgl6464 first permanent

DEC, HP, IBM, SUN ./xinstall SGI 53 ./sgi/mglinst second permanent SGI 62/32 ./sgi/mglin32 second permanent SGI 62/64 ./sgi/mglin64 second permanent SGI 63/32 ./sgi/mgl6332 second permanent SGI 64/64, SGI 65/64 ./sgi/mgl6464 second permanent

DEC, HP, IBM, SGI (all), SUN ./xinstall

SGI 53 ./sgi/mglinst strim 100 permanent SGI 62/32 ./sgi/mglin32 strim 100 permanent SGI 62/64 ./sgi/mglin64 strim 100 permanent SGI 63/32 ./sgi/mgl6332 strim 100 permanent SGI 64/64, SGI 65/64 ./sgi/mgl6464 strim 100 permanent

SGI (all) ./xinstall

SGI 53, SGI62/64

HP, SGI (all) ./xinstall

Driver included with application

(install X-Window driver

v.2.0/3.0)

HP, SGI (all) ./xinstall

HP, IBM, SGI (all), SUN

DEC, HP, IBM, SGI (all), SUN ./xinstall

SGI (all)

SGI (all), SUN ./xinstall

Driver included with application

(install X-Window driver

v.2.0/3.0)

HP, IBM, SGI (all), SUN ./xinstall

SGI (all)

Driver included with application

8

Driver Installation Procedures

Follow the instructions below for either global installation (with "root" privileges) or local installation (without "root" privileges).

Related Sections

Troubleshooting SGI Workstations With IRIX 6.2 or Higher Additional Command Line Options

Global Installation

1

Mount the CD-ROM (replace the # symbol with the number of your CD-ROM drive).

DEC:

HP:

IBM:

SGI:

SUN:

2

Install and configure the driver. (Note

mkdir /CDROM mount –rt cdfs –o noversion /dev/rz#c

/CDROM

cd /CDROM

mkdir /CDROM mount –F cdfs –o ro,cdcase

/dev/dsk/c0t#d0 /CDROM

cd/ CDROM

mkdir /cdrom mount –v cdrfs –r /dev/cd0 /cdrom cd /cdrom

mkdir /CDROM mount –rt iso9660 /dev/scsi/sc0d#10

/CDROM

cd /CDROM

mkdir /cdrom mount –F hsfs –r /dev/dsk/c0c6d#s0

/cdrom

cd /cdrom/cdrom0

that your system may require a different command line. Refer to the application list on pages 7-9.)

./xinstall

Select your application and the serial port to which the Magellan/SPACE MOUSE is

Install

and

Exit

connected. Press

3

(OPTIONAL) Set the user-defined

.

configurations. Create a link from

/usr/magellan/home

to the home

directory of all users, e.g.:

ln –s /hom /usr/magellan/home

Copy (once) the global configuration file to the user home directory.

cp /usr/magellan/xdriver.ini

/home/<username>/xdriver.ini

2

Copy the driver from the CD-ROM (replace the # symbol with the number of your CD-ROM drive).

DEC:

HP:

IBM:

SGI:

SUN:

3

Install and configure the driver.

mkdir /CDROM mount –rt cdfs –o noversion /dev/rz#c

/CDROM

cp /CDROM/dec/xdriver xdriver

mkdir /CDROM mount –F cdfs –o ro,cdcase

/dev/dsk/c0t#d0 /CDROM

cp /CDROM/hp/xdriver xdriver

mkdir /cdrom mount –v cdrfs –r /dev/cd0 /cdrom cp /cdrom/ibm/xdriver xdriver

mkdir /CDROM mount –rt iso9660 /dev/scsi/sc0d#10

/CDROM

cp /CDROM/sgi/xdriver xdriver

mkdir /cdrom mount –F hsfs –r /dev/dsk/c0t6d#s0

/cdrom

cp /cdrom/cdrom0/sun/xdriver xdriver

chmod 555 xdriver ./xdriver -new

Select your application and the serial port to which the Magellan/SPACE MOUSE is

Install

and

Exit

connected. Press

4

The driver must be active before you

.

launch your application. This can be achieved in several ways, e.g. enter the call of the xdriver in the application startup file, in a login startup file (.cshrc) or in the Xstartup file (as root). The call of the xdriver is:

<path>/xdriver &

Starting the Driver for the First Time

After the system has copied the X-Window driver, the driver must be started for the first time and configured. The driver demands sequential information in procedure, which it then stores in a fixed configuration table. The file name of the configuration table is

xdriver.ini /usr/magellan

. It is saved in the directory

(the same directory in which the X-Window driver is installed). While activating the X-Window driver, it searches for the configuration table and uses the information stored there.

Local Installation

1

Create a subdirectory for the Magellan/ SPACE MOUSE driver.

mkdir ./magellan chmod 777 ./magellan cd ./magellan

Uninstalling the X-Window Driver

To uninstall a global installation, use the following command:

/usr/magellan/xdriver –disableinit

To uninstall a local installation, simply remove the

xdriver

entry from the start-up file.

9

Logitech LogiCad3D Magellan/SPACE MOUSE Classic, LogiCad3D Magellan/SPACE MOUSE Plus, LogiCad3D Magellan/SPACE MOUSE Plus XT User Manual

Specifications and Main Features

Frequently Asked Questions

User Manual

Copyright

Contents

Introduction to Magellan/SPACE MOUSE

Installation

Driver Installation Procedures