Administration
Administration
Administration
GUIDE
www.cad-schroer.com
All rights reserved. No part of this documentation may be reproduced in any manner (print, photocopy or other) without the written
permission of CAD Schroer GmbH.
CAD Schroer GmbH has made its best effort to ensure that the information in this document is accurate and reliable, but cannot
guarantee the accuracy, timeliness, reliability or completeness of any of the information contained herein. CAD Schroer GmbH
will not make any warranty nor accept legal responsibility or liability of any kind for consequences resulting from errors or omis-
sions.
All other brand or product names are trademarks or registered trademarks of their respective owners.
August 2009
CAD Schroer GmbH CAD Schroer France SAS CAD Schroer Italia SRL
Fritz-Peters-Str. 26-30 17, Rue du Docteur Lebel Piazza Della Resistenza 26
47447 Moers 94300 Vincennes 20021 Bollate MI
TABLE OF CONTENTS
Preface 5
Installation 7
Installing MEDUSA. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Uninstalling. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Configuring MEDUSA 11
Description of a Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Description of MEDCONFIG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Using MEDCONFIG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Overview of Configuring a Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Before You Start Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
The Product List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Step 1 - Creating a Product List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Step 2 - Configuring the MEDUSA Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Administration 35
Administrator Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Creating and Editing MEDUSA Styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Setting up Standard Colors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Setting up Standard Boldness (Thickness) Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Setting up Boldness for Plotting Dimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Setting up Standard Sheet Filename . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Setting up the Sheet Header Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Setting up Symbol Manager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Layer Set Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Customize Layers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
PREFACE
Book Conventions
The following table illustrates and explains conventions used in writing about MEDUSA applica-
tions.
Convention Example Explanation
Menu Choose Zoom from the View menu Indicates a command, function or
Add button button that you can choose from a
Choose the tool Creates thin solid lines. menu, dialog or tooltray.
Syntax acos 0.345 User input,
The ciaddobj command commands, keywords and
Return or Control-g keys to press on a keyboard.
SyntaxBold Enter command> plot_config Where system output and user input
are mixed, user input is in bold.
SyntaxItalic tar -cvf /dev/rst0 filename Supply an appropriate substitute for
each variable; for the given example
replace filename with an actual file
name.
Filename&path medusa\med2d\m2d\src\ Shows path and filenames.
UPPERCASE MEDUSA or CADCONVERT Names of products.
italic left mouse button Indicates the buttons to press on a
Drafting User Guide mouse and names of books.
bold A temporary group is a collection of ... Emphasize text.
Please note: Illustrations showing menus and forms are taken from a window system.
The display for other platforms can differ slightly.
Online documentation for each book is provided in HTML format. You can view this online
documentation in the installation directory, on the CD-ROM, or directly by calling it up within the
MEDUSA user interface.
Installation Directory
1. Navigate to the directory where MEDUSA is installed.
<MEDUSA installation directory>/meddoc/doc/<language>/ (Unix)
<MEDUSA installation directory>\meddoc\doc\<language>\ (Windows)
where <language> is either english, german or french.
2. Click on the file mainmenu.htm.
3. Click the book title you want to view.
CD-ROM
1. Navigate with your HTML browser to the CD-ROM into the following directory.
<CDROM_mount_point>/doc/<language>/ (Unix)
<CDROM_Drive>:\doc\<language>\ (Windows)
2. Click on the file mainmenu.htm.
3. Click the book title you want to view.
MEDUSA Interface
1. Click left on the entry Help inside the main menu.
2. Choose MEDUSA Documentation from the pulldown menu.
A browser opens showing the mainmenu.htm listing all available documents.
Printing Documentation
A PDF (Portable Document Format) file is included for each online book. See the first page of
each online book for the document name which corresponds to the PDF file name (e.g. HTML
title is Drafting User Guide, PDF file is drafting.pdf). Check with your system administrator if you
need more information. You must have Acrobat Reader installed to view and print PDF files. If
you don‘t have the Acrobat Reader, you can download it for free from the Adobe homepage:
http://www.adobe.com/products/acrobat/readstep.html
INSTALLATION
• Uninstalling .............................................................................. 10
Installing MEDUSA
This section gives some hints which are helpful for the installation of MEDUSA with and without
the MEDUSA Information System (MEDInfo).
Before you start the installation on a Windows system, please close all applications.
Please note: The installation has to be executed by a user with administrator rights.
The installation is done by the installation assistant which will guide you through the setup pro-
cess. If errors occur during installation, these are reported in the file log.txt in the installation
path.
After you have started the installation, follow the steps of the installation assistant. During the
installation you will be prompted for relevant information, for example, language and installation
directory. Most of the dialogs are self-explanatory but you should consider the following:
• The installation path may not contain spaces.
• You can decide between a local license file and a license server.
You choose local keyfile for license files which do not contain a SERVER and DAEMON
line. If you choose a License Server, consider that it has to be configured separately. For
information about the installation of the license server see the License Management
Guide, chapter Installation.
With the definition of the license the specifications for any projects, are set. That is, the
assignment of the variable MEDUSA_LICENSE_PATH will be defined (see the login file
within the MEDUSA project).
Precondition for MEDInfo is the installation of the Apache Web Server including the PHP envi-
ronment. If there is no Apache web server installed and you want to use MEDInfo, go to the
apache directory on the installation disc and launch install.bat.
Please note: MEDUSA and MEDInfo have to installed on local harddisks, because MEDInfo
uses services, which are available locally only. This is valid for the installation on
a client as well as on a server.
MEDInfo can be installed any time after MEDUSA has been installed. To do this
you only have to launch the installation executable from the installation disc and
to choose the MEDInfo products.
Uninstalling
Windows
The deinstallation assistant is started which leads you through the deinstallation process. All
components of the application and the whole MEDUSA product will be removed.
You also can uninstall using the options Settings -> Control Panel from your start menu and then
choose the entry Software.
UNIX
Under UNIX run the tool <installation path>/_uninstall/uninst.csh to remove all MEDUSA compo-
nents.
CONFIGURING MEDUSA
This chapter describes how you configure a MEDUSA project using the MEDUSA configuration
utility called MEDCONFIG. You must have completed the installation procedures before working
through this chapter.
• Description of a Project............................................................ 12
• Using MEDCONFIG................................................................. 16
Description of a Project
When you have finished installing MEDUSA (see “Installation” on page 7), you configure a
project. A project provides the link between the installed MEDUSA products, and is one defini-
tion of how you want to run MEDUSA. This definition includes, for example, the choice of prod-
ucts you want to use, and which the description of workstations you want MEDUSA to run on.
As a reference you can use the project <medusa>\master_project. Do not change this
project.
This following table shows the products of a MEDUSA installation in different projects.
Table 1 MEDUSA User Project Examples
Please note: In case of a localized version, for example german, additional products like
medchangeger, medch3duiger, medchmechger are necessary. The language
is defined by the last characters of the products, ger for german. For other
languages the suffix is appropriate, fra for französisch/french, ja for japanese
and it for italian.
Each project shown in the previous table, proj1 through proj3, has a different combination of
MEDUSA products. Each project is independent, but the one thing they have in common is that
they use the same source files within MEDUSA. For example, all three projects use the same
med2d product but refer to it separately.
You can configure workstations to suit the hardware and MEDUSA products you intend to use
with each project.
Description of MEDCONFIG
MEDCONFIG is a MEDUSA utility you use to configure a project with the MEDUSA products
you have installed, as well as any Customization you have made to MEDUSA.
MEDCONFIG runs under the MEDUSA Executive, and uses information provided within the
MEDUSA products to configure a project. When you start up MEDCONFIG, you give it the path-
name of the project directory where it can write its information. MEDCONFIG then checks that
the directory exists and is accessible, and then looks to see if the project has been configured
already.
If these files are not present, then the project is new and needs to be configured as a new
project. This is called an initial configuration and you are asked for some information by MED-
CONFIG automatically
If these files exist, MEDCONFIG recognizes a project as already configured, and therefore
MEDCONFIG starts.
If MEDCONFIG carries out an initial configuration, it asks you for these types of information:
• Name of the project directory
• List of products to include in the project (if a product_list.dat file does not exist)
• Temporary workspace and batch queue directory
• Text string used for saving sheets and models
There are examples of running MEDCONFIG throughout this chapter where you can see
exactly how MEDCONFIG prompts you for this information.
After an initial configuration, MEDCONFIG puts you at the interactive level. At this point, you
may decide to quit from MEDCONFIG and save your configuration environment. This is advis-
able since any hardware or operating system crashes may cause you to lose all of the configu-
ration session so far. You can then re-enter MEDCONFIG and configure workstations and other
settings.
When you have finished configuring the project, you quit from MEDCONFIG. This saves all the
information you supplied into the files called mxedef.bin, mxedef.fasl and login.bat,
which MEDCONFIG writes to your project directory. After this, you are ready to use MEDUSA.
After Configuration
After configuration perhaps you have to make same settings again, e.g. for online help .
The user guide and online help of MEDUSA is available in the languages English, German and
French.
After finished configuring a project only the English online help is available. If you want to use a
localized online help, you have to enter the following line into the login.bat:
set MED_LANG=<lang>
Please note: Reconfiguring a project (see “Reconfigure a Project” on page 21) also writes new
the login.bat. Therefore you have to add the variable definition again after
reconfiguration.
Environment Variables
Separators of Decimal Values: In order to be able to enter both as separator of decimal val-
ues, comma (, is default) or point (.), you have to set the following environment variables within
the login.bat of the user project (<medusa>\<userproject>\login.bat):
set UIE_COMMA_IS_DECIMAL=1
set MED_COMMA_IS_DEZIMAL=1
This effects, that a separator is always displayed as comma (,) in an input field, regardless of
inserting comma or point.
Unicode Filename Support: To enable the extended unicode filename support on Windows
the environment variable MED_UNICODE_FILENAMES=1 must be set.
Please note: Reconfiguring a project (see “Reconfigure a Project” on page 21) also writes new
the login.bat. Therefore you have to add the variable definition again after
reconfiguration.
Using MEDCONFIG
This is a brief description of how you use MEDCONFIG. More detail is given with the individual
steps of the configuration procedure.
Syntax
MEDCONFIG Modes
MEDCONFIG runs in two modes, PROJECT and ADMIN, which give you access to sets of
commands.
• PROJECT mode is the default mode; you enter this mode if you start MEDCONFIG
without entering any options at all.
• ADMIN mode gives you additional MEDCONFIG commands which enable you to
make changes to the compiled files within MEDCONFIG.
The table below shows which commands are available (Y) in these modes. The total set of com-
mands available reflects the products you include in the project. For example, if you are not
using MEDUSA DB, you do not see the mdba_application_control command.
Table 2 MEDCONFIG Commands
You press Return to accept the default answer in angled brackets, or you type in your own
response at the prompt.
As you use MEDCONFIG, you find that if the program needs information, you are prompted for
it. For example, if you mistype a pathname in the product list during configuration, MEDCONFIG
tells you your information is not correct:
Enter pathname of product> c:\medusa\med2
mxe: product c:\medusa\med2 does not exist or is not accessible
Enter pathname of product>
If the information you supply is not suitable, or you have made an error, perhaps a typing mis-
take in a pathname, MEDCONFIG tells you there was an error and asks for the information
again.
You use the set of commands available in MEDCONFIG to build menus and configure worksta-
tions, and to compile customized files if you add them after the initial configuration.
When you quit from an interactive MEDCONFIG session, either save your configuration file, or
abort if you need to do an initial configuration again.
To see the commands that are available, enter help in response to the Enter command>
prompt in MEDCONFIG.
For further information on these commands, refer to the MEDUSA Customization Guide.
Aborting MEDCONFIG
If you need to stop MEDCONFIG without completing a configuration, you can use control c.
After you entered control c, you can choose to abort the configuration or continue.
The following subsections give an overview of the procedure to follow to configure a MEDUSA
project.
If you are familiar with this topic, you may find the information of this overview enough for con-
figuring a project. If you doing project configuration the first time, you should work through this
chapter in succession given below.
When you configure a project, these are the general steps you follow:
1. You create a project directory to hold the configuration files and start
<medusa>\medsys\login (see “Accessing MEDCONFIG” on page 24).
2. You start an initial configuration in MEDCONFIG and give the pathname of the project
directory.
MEDCONFIG carries out an initial configuration, and starts by prompting you for, or
reading in, the list of MEDUSA products that you want to include in the project. This list
must include any plotting products you want to use with the project.
3. MEDCONFIG then generates the binary files for the project, and prompts you for any
information it needs. MEDCONFIG informs you if it had any problems with part of the
configuration. If there were any problems, you use the MEDCONFIG interactive
commands to try parts of the configuration again.
4. MEDCONFIG asks you whether you want to link the 2D drafting image in order to
create a new draft executable or copy a pre-configured one for the project.
5. You configure the workstation(s) for the project.
6. If you did not create a draft executable for the project earlier on in the configuration you
can create one now.
Please note: Never copy a project to a new location, because the defined path inside the batch
files and the binaries do not work.
Reconfigure a Project
You can repeat any stage of the project creation and configuration procedure by reconfiguring
the project. You may want to do this if you need to add customizations or products to your
project, or if you want to move products within your project. There are two ways of reconfigur-
ing:
• You specify the -reconfigure option when you start up MEDCONFIG. This takes the
existing file called mxedef.bin in the project and uses its values as the defaults for the
new settings, but MEDCONFIG configures the project as if it were new.
• You give the reconfigure command at the interactive level of MEDCONFIG, as
shown below:
Enter command> reconfigure
This restarts MEDCONFIG and continues as if you had started MEDCONFIG with the
-reconfigure option, as above.
Default workstations TTY and WS_DEFAULT are not modified when you reconfigure a project.
Please note: If you reconfigure an existing project, you may need to relink the 2D draft
executable.
The examples in the following sections use a project called proj that contains every MEDUSA
product directory. This project, therefore, shows all the MEDCONFIG commands available, but
the command set you see at your site depends on which MEDUSA products you include in the
project.
The order in which MEDCONFIG configures products and prompts you for information depends
on the order of the products in the product list. The sample project shows products being config-
ured in the order in the sample product list; your own project may be ordered differently, so the
order of configuration actions may not be the same.
The order of some of the products is important. See “The Product List” on page 25 for rules on
the order of products in the product list.
Configuration Display
Most products display messages to the screen when MEDCONFIG configures them. Some
products in the product list are configured as part of other products, so do not display any con-
figuration actions on the screen. This is the case, for example, for the product med3dprop.
Before you start to configure a project, you need to set up certain directories, and find out the
exact pathnames of the products you are going to use in the project. In this section, you learn
how to create these directories, where the products are stored, and how the names of the prod-
uct are.
Please note: In this section paths and commands are given for a Windows system.
When you run MEDCONFIG to configure a project, you need to enter the exact pathnames of
the products to configure. To find out these names and pathnames look at the file
product_list.dat created during the MEDUSA Installation inside the sub-directory
MASTER_PROJECT.
Alternatively, if the products have all been loaded into one MEDUSA product directory, called
medusa throughout this manual, you can list the contents of the directory to find out product
names and pathnames.
The example below assumes the products have all been installed in the c:\medusa directory.
This list varies depending on the MEDUSA products you have bought (lines beginning with
dashes (--) are comment lines indicating products which are not used in the project).
c:\medusa\medsys
c:\medusa\med2d
c:\medusa\med3d
c:\medusa\med3dprop
c:\medusa\med3dshrink
c:\medusa\med3dtran
c:\medusa\med3dui
c:\medusa\medavw
--c:\medusa\akcat
--c:\medusa\am
c:\medusa\cadconvert
--c:\medusa\cvcat_ansi
--c:\medusa\ducat
--c:\medusa\ducting
--c:\medusa\ham
--c:\medusa\isogen
c:\medusa\mdbaccess
c:\medusa\mdbcustool
c:\medusa\mdbfortran
c:\medusa\mdbhetnet
--c:\medusa\medchangeger
--c:\medusa\medchgedmger
--c:\medusa\medchinfoger
--c:\medusa\medchinfo_demoger
--c:\medusa\medchmechger
--c:\medusa\medchmedproger
--c:\medusa\medchrasterger
--c:\medusa\medchrefger
c:\medusa\meddars
c:\medusa\meddoc
c:\medusa\meddtm
c:\medusa\mededa
--c:\medusa\medgedm
--c:\medusa\medgedm_medinfo
--
--c:\medusa\medilink
--
--c:\medusa\medinfo
--c:\medusa\medinfo_demo
--c:\medusa\medinfo_web
c:\medusa\medmech
c:\medusa\medmechgedm
c:\medusa\medpara
c:\medusa\medparts
c:\medusa\medplot
c:\medusa\medplot_canon
c:\medusa\medplot_hp
c:\medusa\medplot_raster
c:\medusa\medplot_winplot
c:\medusa\medplot_winpost
c:\medusa\medpro
c:\medusa\medraster
c:\medusa\medref
c:\medusa\medshade
c:\medusa\medstl
c:\medusa\medtt
c:\medusa\medvda
c:\medusa\medvrml
--c:\medusa\piping
--c:\medusa\spcat
--c:\medusa\sscat
--c:\medusa\steel
--c:\medusa\support
Create Directories
The MEDUSA product directories are static, that is, after installation they are not subsequently
changed. Therefore they can be located on a disk that is not regularly backed up. The project
directory may have data written to the disk periodically and should be backed up. It is suggested
that the logical name PROJ should be created to reference the disk where projects are created.
MEDUSA uses a scratch disk space. Use of this space will vary. It is suggested that medtemp is
used to reference this space. The medtemp directory should not be backed up and it is worth
clearing medtemp on machine startup.
You may now start to configure the project. The following sections give an overview of the con-
figuration utility, MEDCONFIG.
Accessing MEDCONFIG
If this is the first time you have used the MEDCONFIG utility, you need to enter the following
command to make MEDCONFIG available to you:
c:\medusa\medsys\login
On Unix systems you can add this command to your .cshrc or .login file, so that MEDCON-
FIG is always available to you.
MEDCONFIG uses a file in the top level of the project directory to store the names of the prod-
ucts to include in that project. This file is called product_list.dat. There are some rules on
the order in which you enter the products in the product list, so that the Code Table and Data
Definition Language (DDL) files are then available for use by other products.
• medsys must be the first product in the product list.
• med2d should be the first application product after medsys or after the kanji font if one
is required.
• med3d must be the first 3D product.
• medplot should be the first plotting product. Any further plotting products can be
entered in any order relative to other plotting products. It is suggested that plotting
products follow med2d products.
• medraster_base is needed for medraster, medplot_raster and
medplot_hpgl2rtl.
• product_list.dat should only contain the items that are available on disk. Unused
products can also be commented, the line then starts with two dashes (--).
There are two ways of entering the product list for MEDCONFIG:
• Using an editor before you start MEDCONFIG
• Inside MEDCONFIG, where you are prompted for the product list. The file
product_list.dat is created for you in the project directory.
Both these options are described in “Step 1 - Creating a Product List” on page 26.
If you edit the product list while you are running MEDCONFIG, you will use the default text edi-
tor, such as vi (Unix).
If the default text editor is not suitable, you may customize your startup files to select another
editor. Details of how to change your default text editor are given in the MEDUSA Customization
Guide.
Please note: In this section paths and commands are given for a UNIX system.
The following example shows how you create a project called /proj. This project has only
some products of the MEDUSA products palette. For your project you include only those prod-
ucts you need.
You now start MEDCONFIG. You may also enter the product list after you have started up MED-
CONFIG, as shown below.
Starting up MEDCONFIG
1. Enter the following command line to add the MEDUSA directories and products to the
search path that you are using, so that you can access MEDCONFIG:
os% /medusa/medsys/login
2. Start up MEDCONFIG in Administrator mode, and enter the project name when
prompted:
os% medconfig -admin
MEDUSA - Configuration Utility
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Enter pathname of project <quit>: /proj
Project /proj is not configured
Do you want to configure it? <yes>:
If you did not create a product list before starting MEDCONFIG, you can enter it now:
1. After you have started MEDCONFIG and having defined the project directory, you are
prompted for project configuration:
Do you want to configure it? <yes>: Return
2. Press the Return key on your keyboard.
the following message comes up:
Input or Edit (using vi) the product list, or Abort ? (I/E/A)
This command line has three options:
• I
Allows you to input a product list by typing each product name at the prompt. For
example:
pathname of product> /medusa/medsys
pathname of product> /medusa/med2d
You end the list by pressing the Return key on your keyboard:
pathname of product> Return
If there is a product list available already, you have the option to overwrite it and
start again. If you answer yes an existing product list is overwritten immediately. If
you answer no, then the question above appears again.
• E
This option starts up a text editor with the existing product list. If there is no product
list, a new one is created and stored.
• A
stops configuration and quits MEDCONFIG. You are back at the operating system
level and the following message is given:
Configuration aborted: Product list not confirmed
If there is a mistake in the product list, MEDCONFIG tells you where it is, and then prompts you
to edit the product list. You must correct the error before MEDCONFIG can continue with the
configuration:
MEDCONFIG asks you to confirm the product list, and lists the products you entered:
The product list is defined as follows:
/medusa/medsys
/medusa/med2d
/medusa/med3d
/medusa/med3dprop
/medusa/med3dshrink
/medusa/med3dtran
/medusa/med3dui
/medusa/medshade
/medusa/mdbaccess
/medusa/mdbcustool
/medusa/mdbfortran
/medusa/meddoc
If you answer no, the question for entering the product list is displayed again:
Input or Edit (using vi) the product list, or Abort ? (I/E/A)
If you answer yes by pressing the Return key, MEDCONFIG starts with the configuration.
After defining the products for your project, MEDCONFIG configures the MEDUSA products in
the order you entered them in the product list, and builds the necessary binary files. MEDCON-
FIG compiles binary files for the following data:
• Messages
• Code Table
• Data Definition Language (DDL) file
• Decortext and standard fonts
• Prim table
• Symbol table
• Boldness map
The configuration process runs automatically, unless you need to give additional information.
The configuration process and additional information that you may need to enter is described in
the following sections.
When you have confirmed the product list, MEDCONFIG configures the MEDUSA system prod-
uct, medsys:
Configuring product /medusa/medsys
MEDCONFIG then prompts you to enter the temporary workspace directory for the project:
Enter name of temporary workspace directory </medtemp>:
You press return to accept the default name in angled brackets, or you type in the full path-
name of the directory you want to use. If you reconfigure the project, MEDCONFIG uses the
most recent entries for this directory as the default.
If the temporary workspace directory specified does not exist you will be prompted:
Directory does not exist or is not accessible - Continue? <yes>
If you press return to continue the configuration you must remember to create the temporary
workspace directory before you try to use the project.
MEDCONFIG next checks the binary versions (.bmf) of all source message files (.nem) for the
products in the product list (except for the user interface message files), and displays informa-
tion for each message file. For example, a message such as the following is output:
Compiling MESSAGE 'raster_messages' ...
Configure Workstations
At this stage the default workstations TTY and WS_DEFAULT (graphics) are configured. You
have no possibility to interfere for customizing workstations to your needs. You can do this later.
For details see the MEDUSA Customization Guide.
As already described above for the other message files, MEDCONFIG checks the binary ver-
sions of the user interface source files, and displays information for each message file. For
example, if the binary files predate the source files, the following messages are output:
Compiling UISTRING ’MED2D/HELP_CONTEXT_MESSAGES’ ...
Compiling UISTRING ’MED2D/MED2D_MESSAGES’ ...
When the binary files have later date stamps than the source files, MEDCONFIG displays these
messages:
UISTRING binary ’MED2D/HELP_CONTEXT_MESSAGES’ is up-to-date
UISTRING binary ’MED2D/MED2D_MESSAGES’ is up-to-date
You are asked whether you want to exchange sheets with STHENO or MEDUSA or not.
If you want to exchange STHENO sheets, answer Yes and specify the location of your
STHENO installation, when the appropriate question appears.
If you want to exchange MEDUSA sheets, answer Yes and specify the location of your
MEDUSA project, when the appropriate question appears.
Please note: For details see the chapter “Sheet Converter“ of the “Migration“ part.
“Migration” is available as pdf file within the product
<medusa>\meddoc\doc\english\administration\migration.pdf.
A query for changing the Administration password appears. Pressing Return keeps the old
one.
Most binary files are compiled as part of the 2D product, med2d. This is shown below:
MEDCONFIG then compiles the decortext and standard fonts by reading in the MEDUSA
sheets where the fonts are defined:
Further Compilations
MEDCONFIG runs further compilation, for example for defaults, fits and styles.
MEDCONFIG then asks you whether you want to link the 2D drafting image in order to create a
draft executable for the project:
Link 2D drafting image? <yes>:
If you enter n or no at this prompt, you can create a draft executable for the project at a later
stage by running the link command. This command can be found in the project directory
<project-dir>/m2d/build/draft/. The executable is draft_link.bat (Windows)
respectively link (UNIX).
When MEDCONFIG configures the MEDUSA 3D Design product, med3d, it prompts you for the
temporary workspace directory to use for queuing 3D batch jobs. You may accept the default, or
type in the pathname of another directory:
Products like med3dprop and med3dshrink do not display any configuration actions. For
this see also the section “Configuration Display” on page 21.
The last task of MEDCONFIG is the configuration of the superprint driver. If the configuration is
successful, the following message is given:
Superprint driver for winplot creation succeeded
If superprint is already configured and you reconfigure your project for some reason, the follow-
ing message is given:
Superprint driver for winplot exists
As the case may be MEDCONFIG prompts you to enter further commands appropriate to your
project configuration. The full list of commands is given in Table 2, “MEDCONFIG Commands”,
on page 17.
It is advisable to quit from MEDCONFIG and save your configuration environment at this point.
You can then re-enter MEDCONFIG and continue the configuration process if required. If you
do not do this, any hardware or operating system crash may cause you to lose all of the current
configuration.
ADMINISTRATION
• Administrator Mode.................................................................. 36
Administrator Mode
Only users with System Administrator privilege can create or modify styles, change standard
settings for color, boldness and sheet filename, or adjust settings for the sheet header editor,
the symbol manager and the layer management.
Please note: MEDUSA is provided with the default password Admin. If the password is
requested, enter Admin.
Once you changed the password, only this string can be used for the password
from then on.
It is recommended that your System Administrator changes the password after
program installation.
Each set of creation tools (for example, Line, Text, Prim, and Dimension) has a list of properties
that define how the geometry will be presented on the sheet. Styles are the mechanism by
which MEDUSA describes geometry. For example, there are many line creation tools available,
but it is the style that fully describes how a line will be presented on the drawing, for example,
solid thin, dashed thin and so on.
Each style has a unique name and a particular grouping of properties, which reflect how the
geometry will be created.
Creating a Style
Please note: Administrator mode must be enabled before you can create or modify styles within
MEDUSA since style changes affect all MEDUSA users.
You access style creation via the Properties dialogs associated with each type or class of geome-
try, all of which are available from the MEDUSA Dashboard.
The following example shows you how to create a new line style called My Style, which will have
the following attributes:
Line Type: Dotted Line
Line Thickness: 1.0
Color: Blue
1. First set the geometry type to line in order to create the new style from the displayed
one. You can do this by either
• selecting the generic creation tool Creates lines of specified type and properties , which is
located at the far left of the Dashboard, as shown below, or
• selecting a line inside the drawing area.
The Properties dialog is context sensitive. If text, dimensions or one of the other types
was selected when you selected the Properties tool then the relevant Properties dialog is
presented.
The properties described in Figure 5 show the current style settings for the solid thin
style. Note that the Type setting is disabled. This is because the solid thin style has
defined the Type to be locked, which means that no user, other than the System
Administrator, can change the setting. This allows the enforcement of company-wide
drawing style standards.
3. To create a new style, select the Style button from the Line Properties dialog.
The Style Creation dialog appears.
The Style Creation dialog lists all the attributes associated with a particular geometry type. Each
attribute displays the options Use and Lock, which can be set accordingly.
The Use field indicates what attributes will be stored in the style.
4. You need to define Type, Thickness and Color attributes, so tick those choice boxes.
The Lock field is only enabled if you have set the corresponding Use choice box, and instructs the
system not to allow any user to change the setting of that attribute.
5. For this example, lock the Color attribute.
Now that both the Properties and Style Creation dialogs are visible, you will see that before you can
modify the Type attribute on the Properties dialog, it is necessary to unlock it within the Style Creation
dialog. By toggling the lock field you will see the properties type switch from disabled to enabled,
allowing you to change the attribute.
6. Now change the line attributes. Change:
• Color to blue,
• Thickness to one of the thicknesses of the pulldown list (if you move the cursor over a
line and leave it there for a little while, a tool tip comes up showing you the thickness
as real number),
• Type to Dotted Line.
Note that you will need to unlock the color attribute before you can change the color.
7. Before you save the style, reset the Lock choice box for the Color attribute.
Please note: As you type the new style name into the field, the system tries to match the name
with an existing style. If the New button remains disabled after you have typed a
new style name, then a style with that name already exists in the system.
9. Choose the Style Tree Folder to define the place of your style inside the style tree.
10.Click New on the Style Creation Dialog.
MyStyle is saved. The new style name appears in the style field of the Properties dialog.
If you decide not to save the style, then select Close to cancel the operation and reset
the Properties dialog to its original settings.
Please note: At this stage the new style is only saved temporary for the current session. For
saving permanently go on with the steps below.
Please note: If you are the System Administrator and if you want all users to have the styles you
created, then you have to edit the file styles.xml.
Use the generic line creation tool from the Dashboard to test out your new style. Alterna-
tively, you can associate the MyStyle style directly with a custom tool. (See the Drafting User
Guide for details).
Modifying Styles
You can also modify existing styles. The next example shows how to modify My Style so that My
Style lines will be red, and users cannot change either the thickness or the line type attributes.
Deleting Styles
Please note: Inside the style tree you can use Remove Style from Favourites from the popup menu,
which removes the selected style from the favorites folder of the tree only. Inside
the dashboard it is still available.
The Select background color dialog which you can call up by Options > Configuration > Select Background Col-
ors allows you to select a background color other then the default ivory background.
Changing the background color requires the alteration of some displayed colors to be visible on
the new background. For example a black line is invisible on a black background, but is still
required to be black when printed on paper. To achieve this effect MEDUSA has an algorithm
built in to ensure all colors are visible on the screen. This effect can be seen in Figure 10, “The
Select Color Dialog”. Compare both color scales.
Figure 10 The Select Color Dialog
The upper color scale (Current Colors) shows the colors displayed on the screen. It changes when
changing the background color from ivory to dark blue. Only colors that would not be visible are
altered.
The lower palette displays the plot colors. They are still unchanged.
Any new or imported colors are automatically handled by the MEDUSA algorithm, but if you do
not like the color matches created by MEDUSA you can create your own color mappings. Any
color is exactly defined by a triplet of numbers, the RGB value. Define exact RGB values for
each color for every background.
You find a name field in the second column and 5 alternative RGB triplets for each color in the
following columns. These correspond to the color values to be used for alternative for non-ivory
background. You can define up to 8 alternative RGB triplets for each color. Additional back-
ground colors will be displayed in the Select background color dialog (Figure 9, “Select background
color Dialog”)
Sample:
You might select the dark blue background, which would be the second button on the Select back-
ground dialog (see Figure 9, “Select background color Dialog”). This background is defined by
RGB values <0 18 50> which you can find in the first line and second column of RGB values.
If you now display the Select Color dialog again (see Figure 10, “The Select Color Dialog”, which
can be done by selecting any piece of geometry and clicking on the color button on the dash-
board) the colors in the lower area will reflect the colors below the RGB values <0 18 50> and
with COLOUR at the beginning of the line.
The highlight color is still red, defined by RGB values <255 0 0>.
A black line is now displayed as white, defined by RGB values <255 255 255>,
a green line is still displayed green defined by RGB value <0 204 0>,
a default blue line is displayed as a light blue, RGB <133 133 204>, to be visible on the dark
blue background and so on. (Figure 10, “The Select Color Dialog”)
Please note: Plotting is not affected, as any changes on the screen are graphical only and not
written to the sheet. At any point you may switch the background color to the
default sheet you see the sheet exactly as plotable.
The boldness (thickness) used for drawing lines and text are defined in the following file in your
MEDUSA product: <medusa>\med2d\m2d\src\boldness.map.
Please note: Any adjustments which you make should not be made to the original boldness.map
but in the boldness.map file of a product area (<path to customer
product>\m2d\src\boldness.map). It will be merged with the contents of any
boldness.map files in any of your listed products to generate the
<path to project>\m2d\bin\boldness.map file. This task is performed by the BOLD
option within MEDCONFIG, and is done automatically when a project is
configured, or reconfigured.
You can have a maximum of 16 boldnesses. You can modify this file to setup your system bold-
ness values as required. Each BOLDNESS definition starts with the keyword BOLDNESS, fol-
lowed by the boldness index (1 through 16) and the boldness value. The values do not have to
be unique so you could setup all your boldness values to be the same. Any text including and
following -- is treated as a comment and is ignored.
You can set up the boldness values for plotting dimension lines and texts for your project.
Windows:
set BOLD_DIM_TXT=<value>
set BOLD_DIM_LINE=<value>
Unix:
setenv BOLD_DIM_TXT <value>
setenv BOLD_DIM_LINE <value>
The environment variables can be set e.g. in the login.bat of your MEDUSA user project.
For the default values for thickness (<value>) see the the following table:.
<value> Boldness
1 0.18
2 0.25
3 0.35
4 0.5
5 0.7
6 1.0
7 1.4
8 2.0
If the variables are not set, the default value for boldness is set to 2 (0.25).
Please note: Consider that these settings are used only, if the option for Dimension Text inside the
Dimension dialog (available with Options > Defaults > Dimension) is set to Bold.
When saving a new sheet the default name is automatically generated from the sheet header.
This is normally defined by the style drawing_number, and therefore the file name would be,
for example, DrgNo.she.
If you wish to use more, or other items, from the sheet header you can modify the default.
1. Open the file <medusa>\med2d\m2d\src\defaults.dat to display the text entries for the
sheet saving.
The relevant section looks like following, for example:
-- SHEET_SAVE "<drawing_number>_<sheet_issue_number>_<sheet_number>"
-- SHEET_SAVE "<drawing_number>_<sheet_number>"
SHEET_SAVE @tTSH
The two lines which begin with -- are comments only, and will be ignored when the
defaults.dat file is compiled during the project configuration process.
The SHEET_SAVE expression tokens can be recorded in one of two formats.
a. The active entry shown here has the form (@tTSH) which uses the tradition
MEDUSA Text Type method to identifying a text item on the sheet. The three
characters following the @t are a type code (or CAN-code).
b. Alternatively the style form (<drawing_number>) can be used, as shown in the
two alternative examples. Each item inside the brackets <> is taken to be an
existing style name. Characters outside the brackets <> are fixed.
Please note: The style names used here are the internal ones, e.g. drawing_number, and not
those ones used in the graphical user interface, e.g. Drawing Number.
Please note: Each token should identify a unique text item on the sheet. In practice the first text
element found that matches the token is used to provide the relevant string.
Example:
defaults
sheet_save string "<drawing_number>_<sheet_issue_number>_<sheet_number>"
3. Save the defaults.dat file in the project area or merge your additions into the one that is
already there.
The process that compiles the defaults.dat files searches every product in your project's
product list and loads all of the defaults.dat that it finds. The contents of them all are
merged into the final defaults.bin file that is saved within the project.
The standard settings are stored in:
<MEDUSA installation path>\med2d\m2d\src\defaults.dat
Only after recompiling of the project the entries are available. A binary file defaults.bin is
generated in:
<path to the project>\m2d\bin
Please note: Using some characters has different effects on different operating systems.
Care should be given to special characters, for example: . / \ and so on.
Avoid these characters.
Please note: When using the Design Objects product (medmech) within your project, and while
working within a working set, the defined sheet saving expression is ignored. It is
essential to the Design Objects processes that each sheet involved within the
design of a component is unique, and so it always uses the form
"@tTSH_@tTIS_@tTSN". The effect of this can be seen when using the sheet
Save as... tool, if you have a different SHEET_SAVE expression.
If the sheet is a member of your working set the suggested sheet file will conform
with the <drawing_number>_<sheet_issue_number>_<sheet_number>
form.
However when the sheet is not a member of the working set your normal sheet
saving expression will be used to generate the suggested file identifier.
The operation and appearance of the Sheet Header Editor can be configured according to the
user's needs, via a configuration file.
It is possible to use several configuration files for the sheet header editor, either the sfeld.cfg file
or a sfeld_xxx.cfg file.
sfeld.cfg
All adjustments, which you make, should not be made in the original file sfeld.cfg in
<medusa>\med2d\m2d\src\, since these adjustments will be lost with a version change.
Specify any adjustments in <path to customer product>\m2d\src\sfeld.cfg.
It is searched in all ...\m2d\src directories over all MEDUSA products for a sfeld.cfg file. The last
found file is used.
sfeld_xxx.cfg
In the defaults.dat file is defined, if the sheet should be scanned for a texttype or attribute (on
sheet level).
sfeld_conf_typ integer 2
sfeld_conf string "sfconf"
In the example shown above the two last lines specify, to scan the sheet for the attribute.
sfconf is the name of the attribute (6 characters are maximum).
In our example, the two lines which cause the search for the texttype are uncommented. TB1 is
the texttype.
The used name convention for the configuration file is: sfeld_xxx.cfg
The xxx characters are the value of the attribute and thus they define the name convention of
the configuration file.
It is searched in all ...\m2d\src directories over all MEDUSA products for a sfeld_xxx.cfg file. The
last found file is used.
Das Produkt kann mehrere Konfigurationsdateien enthalten. Durch Ändern des Attribute-Wer-
tes auf dem Blatt wird bestimmt, welche der Konfigurationsdateien angezogen wird.
The product may contain several configuration files. A change of the attributes value defines
which configuration file is used.
The structure of the configuration file orients itself on the INI-files of the operating system Win-
dows and supports the following elements:
• Chapter heading
All configuration parameters that belong to a certain task area are combined to logical
units (chapters). A chapter is initiated with the chapter heading and terminated with the
next chapter or the file end. The chapter header is followed by data lines, comment
lines or blank lines in optional sequence.
Syntax: [<Chapter name>]
Only alpha-numeric characters as well as underscores “_” are allowed in the chapter
header. It won't be differentiated between upper- and lower case.
Sample: [sfeld_cfg]
• Data lines
The individual configuration parameter is placed in a data file, following the chapter
header. The line will be ignored, if the data line does not have a chapter header defined
at the time of read in.
Syntax: <Keyword> = <value>
Sample: Coordinate_1 = 1.23
• Comment lines
All lines starting with the character string: --, are recognized as comment lines.
The content of the line is ignored.
Sample: -- this is a comment
• Blank line
The configuration file may contain as many blank lines as desired. They are ignored.
In the following sections you find information on the chapters of a configuration file. Finally, an
example file is given.
The chapter sfeld_cfg describes the basic settings. The keywords of this chapter are
optional, this means that they overwrite constant program default settings. You find these pro-
gram default settings inside the tables below.
Name : zoom_hor
Meaning : Defines the width of the zoom-area that the text field is zoomed to.
Type of Data : Real number > 0.0
Default value : 190.0
Comment : optional
Name : zoom_ver
Meaning : Defines the height of the zoom-area that the text field is zoomed to.
Type of Data : Real number > 0.0
Default value : 85.0
Comment : optional
Name : dlg_maxrow
Meaning : Defines the maximum amount of the lines of the dialog box.
Type of Data : Whole number > 0
Default value : 15
Comment : optional
Name : dlg_maxchar
Meaning : Defines globally the maximum amount of characters for an input field in
the dialog box. Can possibly be overwritten with specifications from the
definition of a dialog box. The entry will be shortened if it exceeds the
length.
Type of Data : Whole number > 0
Default value : 128
Comment : optional
Name : emptytextchar
Meaning : A fill character can be entered since MEDUSA removes text with empty
content ("") when saving a sheet.
Type of Data : Character
Default value : "."
Comment : optional
Name : layer_protect
Meaning : Defines the layers that are to be protected from alterations during the
termtime of MEDUSA.
Type of Data : Character string
Default value : "", i.e. no protected layers
Comment : optional
All chapters starting with sfeld_dlgarea_, contain the definition for each individual input line
in a dialog box and also summarize those input lines into a group making up a dialog area. Pos-
sible groups could be, for example, the standard input, or the area of the update index, or simply
all data in all.
Please note: The configuration file must contain at least one dialog area chapter.
Syntax:
[sfeld_dlgarea_<number>]
<number> represents a whole number and therefore defines the chapter name explicitly.
Sample:
[sfeld_dlgarea_1]
[sfeld_dlgarea_12]
[sfeld_dlgarea_4]
The sequence of the chapter names in the configuration file is optional. Each chapter name can
only be given once.
Keywords are available for each chapter. To define a line in a dialog box, the keywords label
and texttyp must be stated.
You have the possibility to split an existing chapter into several chapters at any time. To do so,
simply enter a new chapter header at the desired spot and the keywords later mentioned under
general keywords (see below).
If you would like to combine several chapters into one chapter, you may do so by deleting the
chapter name as well as the belonging keywords.
General Keywords
Name : area_dlglabel
Meaning : Defines the heading, which is displayed to the respective group on the
dialog box pages
Type of Data : character string
Comment : --
In the following tables you find the entries <xxx>, which have to be replaced by a number,
which makes the keyword in the whole configuration file unique. The same number is to be
used for all fields, which describe a dialog box input line, for example:
label1, texttyp1, maxchar1, ...
Name : label<xxx>
Meaning : Determines the text before the input field in a dialog box line.
Type of Data : character string
Comment : Needed for the definition of an input line!
Name : texttyp<xxx>
Meaning : Determines the style of text in the MEDUSA sheet, which is to be
connected with the dialog box input line. If several texts of the same
style are available in the sheet, the one found first is used.
Sample: "Sheet title"
Type of Data : character string
Comment : Is necessary for the definition of an input line!
Name : maxchar<xxx>
Meaning : Defines the max. amount of characters in the input field. Overwrites
the [sfeld_cfg]dlg_maxchar defined value, if existing.
Type of Data : whole number > 0
Comment : optional Keyword
Name : mandatory<xxx>
Meaning : Defines, whether or not an input field must contain data or if 'empty'
data is accepted as well.
Type of Data : Character string "on" or "off"
Comment : optional keywords:
Active only if the keyword enabled<xxx> has the value "on" or if the
keyword is missing enabled<xxx> and the program defaults ("on")
come to the course.
If the value of the keyword is unequal to "on", the adjustment "off"
applies.
If the keyword is not used, likewise the adjustment "off" applies.
Name : enabled<xxx>
Meaning : Determines whether inputs are possible in an input field or not.
Type of Data : character string "on" or "off"
Comment : optional keyword
enabled<xxx> = off has the consequence that the adjustments
remain unconsidered with mandatory<xxx>.
If the value of the keyword is unequal to "on", the adjustment "off"
applies.
If the keyword is not being used, the „on“ setting will count.
Name : multitext<xxx>
Meaning : Describes if all texts of given type are synchronized.
Type of Data : Character string "on" or "off"
Comment : optional keyword
multitext<xxx> = off has the consequence, that only the first
found texttyp is modified. „on“ modifies all texts of the found type.
Is the value of the keyword unequal to "on", the switch is set to "off".
Is no keyword used, the switch is set to "off".
Name : suppress<xxx>
Meaning : If this attribute is set to "on", the attribute mandatory is ignored and
the check for the texttyp is suppressed.
Due to it no error message is displayed, if a text of this type/style set
for this input field does not exist on the sheet. In this case the Sheet
Header Tool dialog opens and the input field to which the attribute
suppress =ON has been assigned is disabled.
Type of Data : Character string "on" or "off"
Comment : optional keyword
If the value of the keyword is unequal to "on", the switch is set to "off".
If no keyword is used, the switch is set to "off".
Please note: In addition to the keywords listed above the configuration file contains the two
other keywords, ilink and itype. Both are irrelevant for MEDUSA4.
--------------------------------
-- --
-- MEDUSA Sheet Header Tool --
-- --
-- - Configuration - --
-- --
--------------------------------
-- Common Description
[sfeld_cfg]
dlg_maxrow = 7
dlg_maxchar = 20
emptytextchar = " "
date_format = %d-%m-%Y
[sfeld_dlgarea_1]
area_dlglabel = sub_sheethead$label_compulsory_input
label1 = sub_sheethead$label_sheet_title
texttyp1 = Sheet title
maxchar1 = 25
mandatory1 = On
enabled1 = On
multitext1 = On
ilink1 = Sheet_Title
itype1 = string
label2 = sub_sheethead$label_drawing_label
texttyp2 = Drawing number
maxchar2 = 15
mandatory2 = On
enabled2 = On
multitext2 = Off
ilink2 = Drawing_Number
itype2 = string
label3 = sub_sheethead$label_drawn_by
texttyp3 = Drawn by
maxchar3 = 10
mandatory3 = On
enabled3 = On
multitext3 = Off
ilink3 = Drawn_By
itype3 = string
label4 = sub_sheethead$label_date
texttyp4 = Date
maxchar4 = 20
mandatory4 = On
enabled4 = On
multitext4 = Off
ilink4 = Creation_Date
itype4 = date
label5 = sub_sheethead$label_checked_by
texttyp5 = Checked by
maxchar5 = 10
mandatory5 = On
enabled5 = On
multitext5 = Off
label6 = sub_sheethead$label_checked_date
texttyp6 = Checked date
maxchar6 = 10
mandatory6 = On
enabled6 = On
multitext6 = Off
[sfeld_dlgarea_2]
area_dlglabel = sub_sheethead$label_additional_input
label7 = sub_sheethead$label_sheet_number
texttyp7 = Sheet number
maxchar7 = 3
mandatory7 = Off
enabled7 = On
multitext7 = Off
label8 = sub_sheethead$label_number_of_sheets
texttyp8 = Number of sheets
maxchar8 = 3
mandatory8 = Off
enabled8 = On
multitext8 = Off
label9 = sub_sheethead$label_sheet_issue_number
texttyp9 = Sheet issue number
maxchar9 = 3
mandatory9 = On
enabled9 = On
multitext9 = Off
ilink9 = Sys_Revision
label10 = sub_sheethead$label_format
texttyp10 = Format
maxchar10 = 3
mandatory10 = ON
enabled10 = Off
multitext10 = Off
label11 = sub_sheethead$label_principle_scale
texttyp11 = Scale
mandatory11 = Off
enabled11 = On
multitext11 = Off
[sfeld_dlgarea_3]
area_dlglabel = sub_sheethead$label_additional_input
label12 = sub_sheethead$label_document_type
texttyp12 = Document type
maxchar12 = 5
mandatory12 = On
enabled12 = On
multitext12 = Off
ilink12 = Cad_System
itype12 = string
label13 = sub_sheethead$label_design_project
texttyp13 = Design Project
maxchar13 = 10
mandatory13 = Off
enabled13 = On
multitext13 = Off
contains paths to XML-files (*.xml) separated by semicolons. These XML-files are used for
configuring the symbol libraries inside the symbol manager.
<symbol_manager>
<symbol_library>
<symbols name=str path=str mask=str icon=str>
</symbols>
....
</symbol_library>
....
</symbol_manager>
Example
The following picture shows the symbol manager for the file example_symtree.xml, whose syn-
tax is given on the following pages.
Figure 12 Example Symbol Manager
</symbols>
</symbols>
<symbols name="Pins" path="./MASCHBAUBIB" mask="*stift*.sym"
icon="csg_stifte.gif">
<symbols name="Set Pin" path="./MASCHBAUBIB" mask="G*stift*.sym">
</symbols>
<symbols name="Spring Pin" path="./MASCHBAUBIB" mask="Sp*stift*.sym">
</symbols>
</symbols>
<symbols name="Washers and Rings" path="./MASCHBAUBIB" mask="Scheibe*.sym
Fe*.sym" icon="csg_scheibe.gif">
<symbols name="Washers" path="./MASCHBAUBIB" mask="Scheibe*.sym">
</symbols>
<symbols name="Spring Rings" path="./MASCHBAUBIB" mask="Feder*.sym">
</symbols>
</symbols>
</symbols>
</symbol_library>
<!-- Symbolbibliothek 2 -->
<symbol_library>
<symbols name="Symbols 2" path="." mask="*.sym" icon="symbols.gif">
<symbols name="Sockets" path="./BUCHSEN">
<symbols name="Sockets" path="./BUCHSEN/BUCHSEN"/>
<symbols name="slitted Sockets" path="./BUCHSEN/GESCHLITZTE_BUNDBUCHSEN"
mask="*.sym">
</symbols>
</symbols>
<symbols name="Cylinders" path="./ZYLINDER">
<symbols name="Hydraulics" path="./ZYLINDER/hydraulik">
<symbols name="Guide Slide Bearing" path="./ZYLINDER/hydraulik
/gleitfuehrung" mask="*.sym">
</symbols>
<symbols name="Slide Mounting" path="./ZYLINDER/hydraulik
/schienenfuehrung" mask="*.sym">
</symbols>
</symbols>
<symbols name="Pneumatics" path="./ZYLINDER/pneumatik" mask="*.sym">
</symbols>
</symbols>
</symbols>
</symbol_library>
Please note: For the layer set management you have to be in Administrator mode. To enter
Administrator mode choose the entry Admin Mode from the Options menu.
If you are not in Administrator mode all entries of the tab below are disabled.
1. Choose either the Layer Manager option from the entry Layers in the menu bar, or, if you
are just creating or editing an element, click left on the button View or change the layer prop-
erties for opening the Layer Management Dialog.
Two tabs are available, for Layer Properties and for Layer Set Management (admin only).
2. Click on Layer Set Management (admin only) for displaying its contents.
Figure 13 Layer Manager: Tab Layer Set Management (admin Only)
Text
field Color
selection
button
show
options
On top of the Layer Set Management (admin only) tab you find the following entries:
Layer Sets
This text field displays the currently chosen layer set. It is empty by default, indicating
that no layer set is chosen. If you select a layer set from the pulldown list available by
the arrow on the right of the text field, the Layer Set Attributes of the chosen set are
displayed.
Save
This button allows you to save the current layer set.
Delete
deletes the current layer set.
Below the parameters on top of the dialog you find two lists. On the left you see the list of All
Layers (depending on the show options) and on the right you see the list of layers which belong
to the current Layer Set (Actual Layers). Between the lists you find some buttons used for selecting
and deselecting layers either in the left or right list, and for moving layers from one list to the
other.
Figure 14 Layer Manager: List Buttons
Below the lists of the Layer Set Management tab you find the section Layer on the left hand side:
Text field (below the list of all layers on the left)
The field is disabled by default. If you click double on a layer number inside the list
above, the field becomes enabled and the name is displayed in it. Now you can delete
or change the layer name. Details are given in “Customize Layers” on page 67.
Show Named Layers, Show Used Layers, Show All Layers
Options for displaying either all named layers, all layers used in the current sheet, or all
layers available in MEDUSA, which are the layers numbered from 0 to 1023.
On the right of the Layer Set Management (admin only) tab you find the section Layer Set Attributes.
All entries are disabled if no layer set is chosen.
On, Off
switches the options for visibility and selectivity at the same time On or Off.
Visible, Invisible
switches the selected layers Visible or Invisible.
Hitable, Unhitable
switches the selected layers Hitable (selectable) or Unhitable (not selectable).
Protected Modify, Protected Full, Unprotected
Options for allowing changes on layers or not.
Protected Modify allows to add new elements but prohibits changing existing elements.
Protected Full prevents any changes of elements on this layers.
Unprotected allows to change elements and add new elements.
Color ON, Color OFF
If the option Color ON is set, the elements on the layer are drawn in the color specified
by the color attribute. If the option Color OFF is set the elements on the layers defined in
the current layer set are drawn with the color defined for the appropriate styles.
Color selection button (below the option Color OFF)
opens the Select color dialog which allows you to select the color for the current layer set
by clicking on a colored button and confirming your choice with OK.
Figure 15 Select Color Dialog
The buttons in the bottom of the Layer Set Management (admin only) tab, which are:
Reset
sets the layer settings back to the default values.
OK, Apply,
uses the current settings. In case of OK the dialog is closed. After Apply the button is
disabled until you changed something in the dialog.
Cancel, Help
work as usual.
Customize Layers
Please note: You can customize layers when you are in Administrator mode only.
In MEDUSA you always have 1024 layers numbered from 0 to 1023, so you cannot add new
layers which have a higher number.
This section shows you how to rename layers and how to delete layer names.
For deleting a layer name do the following steps, assuming that you are already in administra-
tor mode:
1. Open the dialog Layer Management Dialog by choosing Layers > Layer Manager in the menu bar
and then the tab Layer Set Management (admin only) (see Figure 13, “Layer Manager: Tab
Layer Set Management (admin Only),” on page 64).
In the list on the left hand side you see the layers according to the defined show option.
It can be all, named or used layers.
2. Double click left either on a layer number or the layer name.
Below the list the text field becomes enabled and the layer name is displayed.
Additionally the button for deleting the layer name is activated.
Figure 16 Example: Rename Layer Name
You can customize layer sets when in Administrator mode. There are two possibilities to define
your own layer sets:
a. using the Layer Manager or
b. creating a layerset.xml file in the customer product.
To create, modify or delete layer sets open the dialog Layer Management Dialog by choosing Layers >
Layer Manager in the menu bar and then the tab Layer Set Management (admin only) (see Figure 13,
“Layer Manager: Tab Layer Set Management (admin Only),” on page 64).
To delete a layer set, select the set and click the Delete button.
It is possible to have more than one layerset.xml files. They have to be placed into the product
directories into m2d\src. MEDUSA looks through all m2d\src directories that are in the product
list, starting from top, and merges the founded layerset.xml files. An example for a layerset.xml file
is shown below:
<layersets>
<layerset>
<name>SET1</name>
<color_on>true</color_on>
<color_pen>0</color_pen>
<hitable>true</hitable>
<protection>3</protection>
<visible>true</visible>
<layers>1-3 5</layers>
</layerset>
<layerset>
<name>SET2</name>
<color_on>true</color_on>
<color_pen>0</color_pen>
<hitable>true</hitable>
<protection>2</protection>
<visible>true</visible>
<layers>10-23 36-38 99</layers>
</layerset>
</layersets>
protection:
• 1 - protected modify
• 2 - proteted full
• 3 - unprotected
Please note: Changes of the layer sets should be always done in the customer product not in
the product directories of the original product. For information about adding user
product directories see the Customization Guide please.
User-Defined Dashboards
Dashboards are an important part of the user interface of MEDUSA and many dashboards are
available for giving fast information on selected elements like lines, texts and prims.
In addition to the usual dashboards it is possible to create your own dashboards for groups, for
which you want to specify certain information which shall be displayed in both the dashboard
itself and in the associated properties dialog. The information like properties and attributes dis-
played in the dashboard and properties dialog can be defined differently in order to give the
main information in the dashboard only and all information on a group in the properties dialog,
for example.
Please note: In order to define a new dashboard you have to be in Admin Mode.
5. Define the selection criteria and the information you want to be displayed in the
Dashboard and in the properties Dialog.
For details on the entries of the dialog see “The Create Dialog” on page 75.
6. If you want to use the dashboard also in subsequent sessions of MEDUSA, activate
the option Create File.
Please note: If you do not activate Create File, the user defined dashboard is only created
temporary and it will be lost after quitting the current MEDUSA session.
7. When you are satisfied with your settings, press the Create button.
The default group dashboard and properties dialog will be replaced by that one you
have just defined.
The new dashboard and dialog will appear each time that you select a group that
corresponds to your selection criteria during the current session.
If you want to make the new dashboard a permanent part of your MEDUSA
environment read “Adding a User-Defined Dashboard to Customer Product” on
page 78
The following figures show the user-defined dashboard and the accordant properties
dialog for the example of a Diagram Symbol.
Figure 22 User-Defined Dashboard
The Create Dialog can be opened inside the Named group properties dialog after selecting a group.
Please note: If a user defined dashboard already exists for the selected group, the Named group
properties dialog is not available but the dialog you defined with the user defined
dashboard.
The tab pages of the dialog contain all the elements of the group and enable you to select those
you wish to be displayed in the dashboard and the properties dialog, also those that identify this
particular group.
Please note: If any of these particular elements or attributes is not present in the group, the
accordant tab page is disabled.
Each of the tab pages contains a table which has the following columns:
Type identifies the types of elements for the particular tab. For example Solid might appear
in the Lines tab. In the User Attributes tab the Type is the name of the attribute,
for example attr1.
Value Where applicable, this shows the current value of the element. This might be the
current text string or attribute value.
No shows the number of elements of this type that are in the group. This applies only to
texts, prims and lines.
Selection The option enables you to specify the characteristics of the group that this dashboard/
dialog is defined for. The entries for which Selection is marked are used as selection
criteria when selecting a group.
It is usual to tick items that are specific to the group you intend.
For a Diagram Symbol you might tick LB2 in the Texts, Superprim in the Prims and
some or all of the User Attributes. You might not tick TTN texts because the selection
would be restricted to the number TTN texts in the particular diagram symbol you
selected.
It makes no sense to tick common group properties such as Free for Style, Group for
Type and “ ” for Label, since these are used for many groups.
Dashboard
These tick boxes indicate the fields that are to appear on the dashboard itself.
For the Diagram Symbol you might tick just LB2 text.
Dialog
These tick boxes indicate the fields that are to appear in the properties dialog.
For the Title Block you might repeat those on the Dashboard and add the other user-
definable fields. For the Diagram Symbol you might select all texts.
There are the following cases in which you can use user-defined dashboards.
• Use in the session in which you create a user-defined dashboard.
• Use after adding a user-defined dashboard, created in a previous MEDUSA session,
manually to the current session.
• Use by adding a dashboard permanently to a product.
Please note: To be able to use a dashboard created in a previous MEDUSA session, it has to
be saved into a file by activating the Create file option in the Create Dialog as described
in “Creating a User-Defined Dashboard” on page 72.
For an example of a user defined dashboard and the appropriate properties dialog see the end
of the secion “Creating a User-Defined Dashboard” on page 72.
As long as you run the session in which you created a user-defined dashboard, this dashboard
is automatically displayed whenever you select a group which matches the selection criteria of
the created dashboard.
If you saved a user-defined dashboard to a file, you can re-use the file by executing it in the cur-
rent session. The file is executed by typing the according command into a console window
(DOS Box).
Please note: Adding a dashboard manually during a session can be executed only in API mode.
Start with the command:
call <medusa>project\m2d\command\medusa.bat -api
The console is displayed by selecting Show Console from the Windows option of the menu bar.
Figure 26 Showing the Console
If you changed the directory, you have to insert the complete path to the file, for example:
exec D:\projects\medusa_proj_1\diagram_symbol.bad
Having created a user-defined dashboard, you may wish to make it more permanent part of
your MEDUSA environment. This is done by adding the dashboard to the product. The proper-
ties dialog provides the Add to product button.
Please note: Adding a user-defined dashboard to a customer product has to be done while
creating the dashboard, see “Creating a User-Defined Dashboard” on page 72.
1. When you press the Add to product button, the Product Directory Selector opens.
Here you can choose the directory, where you wish to save the dashboard. It is
recommended to use the default directory. This is custom_dashboard in the product.
2. When you have selected the directory, click OK.
If this is the first time you have added a dashboard to this directory, you will see an
Information window.
In future MEDUSA sessions the new dashboard and the properties dialog are
displayed, when you select a group matching the dashboard selection criteria.
The properties dialog provides no longer both the Delete dashboard button and the Add to
product button.
Once a dashboard has been added to your product it can be removed in two ways:
• Deactivate the product in the product list.
Comment out or delete the line you added to your product list and recompile the
project. This removes all user-defined dashboards.
• Remove a particular dashboard
To remove just a specific dashboard, find the directory where the definition file is
stored, for example custom_dashboard\ui\med2d
Delete or comment out the dashboard in the library-init.bar file.
Example for a library-init.bar file:
proc(library)
-- Callback routines for initialisation of custom dashboards
-- To remove a dashboard, comment out or delete the relevant entry
-- and recompile your project
m2d_callback_set(!dashboard_startup,dashboard_diagram_symbol)
endproc
In this example the line which has to be deleted or commented out is:
m2d_callback_set(!dashboard_startup,dashboard_diagram_symbol)
Type into the MEDUSA console (visible via Window > Show console):
dir:-“<path to the source files>\custom_dashboard\ui\med2d“
compile_all_source_files(dir)
library_create_index(dir)
You cannot modify a user defined dashboard. If you want to change the definitions for a dash-
board, you need to delete the dashboard and then create it new.
If the dashboard you have created is not correct or you no longer wish to keep it, press the
Delete dashboard button (see Figure 23, “User Defined Properties Dialog,” on page 75). Now the
default group dashboard and properties dialog will be seen again.
Please note: If you delete a user-defined dashboard created also as a file, it does not delete the
file! So, you can execute the file in following sessions in order to use the
dashboard again (see “Adding Dashboard to the Current Session Manually” on
page 78 and “Adding a User-Defined Dashboard to Customer Product” on
page 78).
Some dashboard actions depend on the count of selected elements. If the number of selected
elements exceed the limit count, the dashboard is not displayed or updated.
You can define the limits either in the Defaults dialog (Options > Defaults > Common) or in the
defaults.dat file of the product.
Figure 30 shows the appropriate part of the Common tab, where you can insert the desired val-
ues.
Figure 30 Defaults Dialog: Tab Common, Dashboard Element Selection Limits
Please note: The higher the values are the longer MEDUSA needs for checking.
When you quit the program, you are asked if you want to save the changes of the defaults or
not. If you confirm the changes, the new values will be taken over, and are valid for following
MEDUSA sessions.
The defaults.dat file is located in the directory med2d\m2d\src of the product. You find the key-
words for the limits setting as follows:
---------------------------------------------------------------------
-- Dashboard element selection limits for show / not show a dashboard
---------------------------------------------------------------------
-- countlimit_dashboard integer 5000
-- countlimit_props integer 2000
-- countlimit_text integer 100
To change and validate the new limits delete the dashes and modify the values as desired.
Please note: Changes in the defaults.dat should be always done in the customer product not in
the original product!
Please note: MEDUSA must be started in api-mode otherwise you cannot store a symbol for
balloons.
Please note: Each text is a variable which shall be replaced by a value. Therefore this text has
to consist of a dollar sign and a number, e.g. $11. The used numbers in a symbol
must be consecutive.
Please note: If you have no custom product directory, you can use the installation directory, e.g.
c:\medusa\med2d\m2d\src\defaults.dat
Consider that the installation directory will be deleted when uninstalling.
For MEDUSA you can define which character set (codepage) is used by the operating system.
For identifying characters of the used codepage following variables have to be defined inside
the file login.bat:
Windows:
set MED_APP_ENCODING=utf8
set MED_OS_ENCODING=<Character Set>
UNIX:
setenv MED_APP_ENCODING utf8
setenv MED_OS_ENCODING <Character Set>
These are only some examples. There are further character set encodings for other languages.
Further information on codepages can be found on this website:
http://www.microsoft.com/globaldev/reference/WinCP.mspx.
INDEX
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
A D
Accessing MEDCONFIG 24 ddl 17
Adding layer sets 69 Decortext fonts 17
Adding layers to layer set 69 defaults 17
Admin Mode Password dialog 36 delete User-Defined Dashboard 81
Administration 35 Deleting
Administrator Mode 36 a layer name 67
Attributes layer sets 70
changing values 39 styles 42
locking 39 dfont 17
use in style 39 Dialogs
Admin Mode Password 36
Line Properties 38
B Select background color 43
bacis 18 Style Creation 39
Balloon Text Symbols 84 Documentation 14
balloon_defaults.dat 84
balloon_template.she 84
bold 17 E
Boldness setting 46 Editing styles 37
button
View or change the layer properties 64 F
Finding Out the Product Names 22
C fits 17
Changing layer set name 69 font 17
character set 85 Fonts
code 17 building
Codepage 85 dfont command 17
Colors compiling 32
create color map 43
setting 43 H
configuration
3D Design Products 32 Help 14
configuration link 2D Drafting Image 32 help 18
zoom_hor 53 Uninstalling 10
zoom_ver 53 Unprotected 66
Sheet structure tree 41 user interface
Style Creation dialogs 39 compile messages 17
style tree 41 User Project 12
Styles User-Defined Dashboard
attributes to use 39 create 72
creating 37 Create Dialog 75
creating and editing 37 delete 81
deleting 42 modify 81
modifying 41 selection criteria 77
preventing alteration by locking attributes 39 use 77
saving 40 Using styles 41
saving permanently 41 using User-Defined Dashboard 77
using 41
styles 17
V
Values of attributes
T changing 39
Text View or change the layer properties 64
setting thickness 46 Visible 65
Thickness setting 46
ttable 17
W
wsconfig 18
U
UIE_COMMA_IS_DECIMAL 14
uistrings 17 X
Unhitable 66 xresources 18
Unicode Filename Support 15