Galaxy Toolbox

User guide
2014
 table_of_contents

Table of Contents
Galaxy Toolbox ..........................................................................................................................................4
About ....................................................................................................................................................5
Copyright & Information .................................................................................................................6
Registration States ........................................................................................................................7
Installation Guide .................................................................................................................................8
Install Galaxy Toolbox ...................................................................................................................9
Uninstall Galaxy Toolbox .............................................................................................................12
Using Installer ........................................................................................................................13
Using Control Panel ..............................................................................................................16
Product registration ......................................................................................................................17
File Locations ...............................................................................................................................22
Features .............................................................................................................................................23
Status View ..................................................................................................................................24
System requirement ...............................................................................................................26
Accessibility ............................................................................................................................27
Automation context ................................................................................................................28
Graphic Toolbox context ........................................................................................................33
Behavior According to the Registration State .......................................................................35
GBI ...............................................................................................................................................37
AutoCAD Import .....................................................................................................................38
System requirement.........................................................................................................39
Drawing Limitations .........................................................................................................40
Introduction ......................................................................................................................41
Getting Started.................................................................................................................44
Opening AutoCAD Import ..........................................................................................45
Import Settings...........................................................................................................50
Configure Import Settings ....................................................................................53
Layouts...........................................................................................................54
Blocks.............................................................................................................56
Graphic Preview ......................................................................................59
Tagname Rule..........................................................................................62
Instance Attributes .............................................................................65
Attributes ..................................................................................................66
Layers ............................................................................................................67
Save Configuration ..............................................................................................69
Import .........................................................................................................................71
Import Preview .....................................................................................................72
Start Import ..........................................................................................................73
Ask Action ............................................................................................................74
Rename Action ....................................................................................................75
Results .......................................................................................................................76
XAML Import ..........................................................................................................................77
System requirement.........................................................................................................78
Drawing Limitations .........................................................................................................79
Getting Started.................................................................................................................80
Opening XAML Import ...............................................................................................81
Import Settings...........................................................................................................86
Save Configuration ..............................................................................................88
Import .........................................................................................................................90

Document ID: Revision 1.0 2/129

 table_of_contents

Import Preview .....................................................................................................91

Start Import ..........................................................................................................92
Ask Action ............................................................................................................93
Results .............................................................................................................................94
SVG Import ............................................................................................................................95
System requirement.........................................................................................................96
Drawing Limitations .........................................................................................................97
Getting Started.................................................................................................................98
Opening SVG Import .................................................................................................99
Import Settings.........................................................................................................104
Save Configuration ............................................................................................106
Import .......................................................................................................................108
Import Preview ...................................................................................................109
Start Import ........................................................................................................110
Ask Action ..........................................................................................................111
Results ...........................................................................................................................112
WMF/EMF Import ................................................................................................................113
System requirement.......................................................................................................114
Drawing Limitations .......................................................................................................115
Getting Started...............................................................................................................116
Opening WMF/EMF Import......................................................................................117
Import Settings.........................................................................................................121
Save Configuration ............................................................................................123
Import .......................................................................................................................125
Import Preview ...................................................................................................126
Start Import ........................................................................................................127
Ask Action ..........................................................................................................128
Results ...........................................................................................................................129

Document ID: Revision 1.0 3/129

 galaxy_toolbox

Galaxy Toolbox
Galaxy Toolbox is the first ever toolbox designed for Wonderware System Platform. Conceived from the outset to
simplify common tasks, Galaxy Toolbox will help you to develop applications faster.
Simple to install, it seamlessly integrates powerful new features into the IDE.

Have you ever tried to find all :

• Un-deployed instances
• Objects with errors
• Objects with warnings
• Objects with changes pending

While the built-in search facility does allow you to search for some of these cases, Galaxy Toolbox status view is
the right tool for the job.

Have you ever wished you could build screens, objects and even templates, by simply importing an AutoCAD
drawing directly into an ArchestrA application?

Now, with Galaxy Toolbox GBI tool, AutoCAD blocks are directly mapped to graphic instances and objects. With
just a few clicks an application can be mostly generated.
You can even substitute blocks ‘on the fly’ with standard symbols already in your Galaxy, populating custom
properties and UDAs automatically with data embedded in your DWG file.

How about building screens with your favorite graphic editing tool? Using the XAML Import feature of the
Galaxy Toolbox GBI tool you can import graphics created in any editor that can export XAML files ; using
the SVG Import feature of the Galaxy Toolbox GBI tool you can import SVG graphics ; using the WMF/EMF
Import, you can import WMF or EMF files.

Document ID: Revision 1.0 4/129

 about

About
[code192] is a software factory dedicated to develop Wonderware companion software.
We delivers products following Wonderware’s roadmap :
• Aligned with Wonderware strategies
• Responding rapidly to market needs

You will find out more about us on the [code192] website.

Document ID: Revision 1.0 5/129

 copyright___information

Copyright & Information

Galaxy Toolbox: 2.7
Copyright: [code192] 2013. All rights reserved.
 
Warning: This program is protected by copyright law. Reproduction or distribution of this program is prohibited.
Any breach will incur significant penalties which will be legally enforced.

Document ID: Revision 1.0 6/129

 registration_states

Registration States
Each feature in Galaxy Toolbox is licensed independently.

The registration states are:

• Un-registered edition: The user has not registered a license.
• Registered edition: User provided a valid license key
• Expires: Licenses can be for a fixed time (e.g. evaluation licenses)
• Does not expire: License has no expiration date

The features installed in the IDE by Galaxy Toolbox will behave differently depending on the registration state.

Document ID: Revision 1.0 7/129

 installation_guide

Installation Guide

Galaxy Toolbox needs to be installed using .

The features will be then added to the IDE, but you will need to register each feature to fully activate it.
You may obtain a trial registration from Software Toolbox. A trial is a fully functional, time limited license.

Document ID: Revision 1.0 8/129

 install_galaxy_toolbox

Install Galaxy Toolbox

Double click on the provided file

ArchestrA must be installed on your computer or you will get this message and the installation will end.

Read the License Agreement and, if acceptable, check "I accept the terms in the License Agreement" then click
the "Next" button

Document ID: Revision 1.0 9/129

 install_galaxy_toolbox

Choose what you want to install

Wait while setup installs the necessary files on your computer

When the installation is complete. Click "Finish" button

Document ID: Revision 1.0 10/129

 install_galaxy_toolbox

Document ID: Revision 1.0 11/129

 uninstall_galaxy_toolbox

Uninstall Galaxy Toolbox

There are two ways to perform an Uninstall:

• Using Installer

• Using Control Panel

Document ID: Revision 1.0 12/129

 using_installer

Using Installer

Double click on the provided file

Click "Next" button

Click "Remove" button and Next

Click "Remove"

Document ID: Revision 1.0 13/129

 using_installer

If ArchestrA is running, you will have to close it before continuing

Wait while the setup removes the necessary files from your computer

Document ID: Revision 1.0 14/129

 using_installer

Click "Finish" button

Document ID: Revision 1.0 15/129

 using_control_panel

Using Control Panel

Navigate to Program and Features clicking on Start->Control Panel->Programs->Program and Features.
Right click Galaxy Toolbox and select uninstall just as in the screenshot below

Document ID: Revision 1.0 16/129

 product_registration

Product registration
The Galaxy Toolbox tool is protected by license. A license key can be purchased from Software Toolbox. You
will receive a license number. You will need to register the license you receive to your computer in order to
activate the software. Registration can be done directly on the computer the software is installed on, provided it
has internet access. If the computer the software is installed on does not have internet access you will need another
computer with internet access to register your software and retrieve an activation code.

When you first open the IDE after installation, you will see the product is not yet registered. If you don't provide a
valid key the tool will be visible in the IDE but some features will be disabled.

You can see that Status View is not registered here:

Click on the yellow text to open the registration tool

You can see that GBI is not registered here:

Click on the yellow key to open the registration tool

The same registration tool is opened from both location. You can run the registration tool at any time. It is located
at
C:\Program Files[(x86)]\Common Files\code 192\GalaxyToolbox\License
\LicenseManager.exe
You will need to run the registration tool from the above location if you wish to upgrade a registration. One
example of when this will be necessary is when you wish to replace your evaluation license with a full license.

When the registration pop-up appears, select the product you wish to register and click Register

Document ID: Revision 1.0 17/129

 product_registration

Enter the license number you received from Software Toolbox and choose either Manual or Online registration.
To register online the computer must be connected to the internet. Click Register to proceed to the next step

Enter the user information then click Register

Document ID: Revision 1.0 18/129

 product_registration

If you selected Online, registration should complete here and you will see

If registration fails you will see the following and you will need to register manually

To proceed with manual registration find a computer that has internet access and go to the Software Toolbox
Registration page here

Enter the unlock code provided by Software Toolbox

Document ID: Revision 1.0 19/129

 product_registration

The following popup will confirm registration

You can confirm the expiration date of your license from the About window in the GBI tool.

Document ID: Revision 1.0 20/129

 product_registration

Document ID: Revision 1.0 21/129

 file_locations

File Locations
Installation installs files in the following (default) locations:

GBI
GBI is installed in:
• C:\Program Files[(x86)]\code192\GalaxyToolbox\Graphics Bulk Import
• C:\Program Files[(x86)]\ArchestrA\Framework\bin\IDEExtension

License Manager
The License Manage is installed in:
• C:\Program Files[(x86)]\Common Files\code 192\GalaxyToolbox\License\

Status View
Status View is installed in the IDEExtenstions folder:
• C:\Program Files[(x86)]\ArchestrA\Framework\bin\IDEExtension

Document ID: Revision 1.0 22/129

 features

Features
Installing Galaxy Toolbox on your computer will add new features on the IDE:
• Status View: this view is integrated into the IDE in the same way as "Deployment" or "Derivation"
view and allows you to display objects filtered by their status (checked out, with warnings, with error,
undeployed, or with pending changes)
• GBI: this tool can be launched from the IDE or as a stand-alone application. This tool allows the user to
import DWG or XAML files.

Document ID: Revision 1.0 23/129

 status_view

Status View

IDE Integration control

The view is totally integrated in the IDE just like the the standard views. It's available in the View menu
and on the view tool bar.

Context Selector

You can select your object context: Automation context will displays automation objects and their
templates. Graphic toolbox context will display ArchestrA symbols

Status Selector

Select an object status to change the display list

Galaxy Tree View

The galaxy tree view allows you to interact with objects exactly the same as with the other IDE views.

Document ID: Revision 1.0 24/129

 status_view

Version and License status

Display the version of the Status view and the registration state for Galaxy Toolbox. The behavior of the
view will change depending on the license type.

Document ID: Revision 1.0 25/129

 system_requirement_1

System requirement
ArchestrA 3.0, version or higher must be installed on the computer where Galaxy Toolbox Status View will be
installed. The IDE must also be installed

Document ID: Revision 1.0 26/129

 accessibility

Accessibility
Status view is accessible from the View menu, from the toolbar or via the Ctrl+Shift+S shortcut

IDE View menu

IDE Toolbar

Document ID: Revision 1.0 27/129

 automation_context

Automation context
Select "Automation" in the Context list of the Status View

In the Automation context, only the automation objects (not symbols) are displayed in the Galaxy tree view. The
available filters with that context are:

• Checked out

• Has warning

Document ID: Revision 1.0 28/129

 automation_context

• Has error

Document ID: Revision 1.0 29/129

 automation_context

• Undeployed

Document ID: Revision 1.0 30/129

 automation_context

• Pending changes

Document ID: Revision 1.0 31/129

 automation_context

Document ID: Revision 1.0 32/129

 graphic_toolbox_context

Graphic Toolbox context

Select "Graphic toolbox" in the Context list of the Status View

In the Graphic toolbox context, only ArchestrA Symbol objects are displayed in the Galaxy tree view. The
available filters in that context are:

• Checked out

• Has warning

Document ID: Revision 1.0 33/129

 graphic_toolbox_context

Document ID: Revision 1.0 34/129

 behavior_according_to_the_registration_state

Behavior According to the Registration State

The registration state depends on the whether or not the product has been registered.

Un-registred edition: Until you register Galaxy Toolbox, the status view is functional but a maximum of five
objects are displayed

Registered edition: The Status view is fully functional

Document ID: Revision 1.0 35/129

 behavior_according_to_the_registration_state

Document ID: Revision 1.0 36/129

 gbi

GBI
The [code192] GBI tool has two feature:
• AutoCAD Import imports DWG files.
• WPF Import imports XAML files.
• SVG Import imports SVG files.
• WMF/EMF Import imports WMF and EMF files.

Document ID: Revision 1.0 37/129

 autocad_import

AutoCAD Import
This section will explain how to open .DWG files, configure blocks, select Layouts and associated layers and run
the import process.

Document ID: Revision 1.0 38/129

 system_requirement_2

System requirement
ArchestrA 4.0 version or higher must be installed on the computer where Galaxy Toolbox AutoCAD Import is to
be installed, with minimum screen resolution 1024x768 pixels.

Document ID: Revision 1.0 39/129

 drawing_limitations_1

Drawing Limitations
AutoCAD drawings from 2010 are supported. Older drawing usually work.
It is possible to build drawings that make life difficult for the tool.
Some examples are:
• Very small features (small relative to the largest dimensions of the layer)
• 3D drawings
• 2D drawing not drawn on the XY plane.
• Drawings that have filled areas built with lots of lines.
• Adding attributes to blocks with duplicate names

Document ID: Revision 1.0 40/129

 introduction

Introduction
[code192] has developed an add-in feature to the Wonderware System Platform (WSP) IDE that allows the import
of AutoCAD® DWG files.

The Main Objectives of the AutoCAD Import tool are:

• Import what you can see in an AutoCAD Layout as scalable ArchestrA graphics.
• Extract relevant data from Blocks.
• Customize instances of templates or symbols with extracted block data. Where necessary create new templates
on which to base those instances.

This is achieved by
• Creating object models in the Galaxy, containing ArchestrA Graphics
• ArchestrA Graphics are contained in the Graphic Toolbox or in Object Templates
• Each imported Layout is an assembly of layers as embedded symbols

Several steps are performed during the import process:

1. Scaling
An AutoCAD file has no absolute coordinates, it is purely vectorial. For this reason, we need to have a scaling
step that converts the unitless dimensions of AutoCAD to pixels and scales the imported entities to a usable size.

2. Block Creation
- The AutoCAD blocks are analyzed in order to create ArchestrA Graphics.
- Created blocks (symbols) have a resolution of 256x256 pixels.
- They are grouped in a Blocks folder in the Graphics Toolbox.

4. Layout Creation
- The chosen layout is created by aggregating the selected layers as embedded symbols.

3. Layer Creation
- All graphical elements are created (lines, text, shapes…)
- All AutoCAD ‘inserts’ (graphical instances) are implemented as embedded symbols (either symbols from the
Grapic Toolbox or from object Templates)
- Each layer is embedded as a symbol or symbols (where one symbol is too complex).

Basic Definitions used with AutoCAD drawings

AutoCAD is a software application for 2D and 3D computer aided design (CAD) and drafting developed and
marketed by Autodesk, Inc.
The file format generated is named ‘DWG’.

AutoCAD drawings consist of:

Document ID: Revision 1.0 41/129

 introduction

• Layouts : Represents a paper space. Put simply, a layout is a page that allows you to set up a plot or print of
your drawing. You can create as many layouts as you need in AutoCAD. Each layout is saved on its own layout
tab and can be associated with a different page setup.

Below is a visual representation of a layout for a print to be plotted from a Layout tab.

• Layers are a way of managing, tidying and also controlling the visual layout of a drawing. An arrangement in
paper space of sheet elements, typically including a border, title block, general notes, and a display of items
drawn in model space.

• Blocks are equivalent to graphical object models. They contain graphical definition and attributes. The
blocks' ‘instances’ are called ‘inserts’. Blocks can also contain non-graphical information. This means text
objects called attributes. A well designed drawing can contain attributes needed to automatically build objects
instances, such as engineering units, ranges, and even PLC addresses.

Document ID: Revision 1.0 42/129

 introduction

Document ID: Revision 1.0 43/129

 getting_started_1

Getting Started
This section contains quick tutorials to help you start working with AutoCAD Import. It contains steps and
explanations on how to control the import of an AutoCAD drawing.

Document ID: Revision 1.0 44/129

 opening_autocad_import

Opening AutoCAD Import

There are two ways to open the AutoCAD Import tool - embedded mode and external mode:

Embedded Mode
From the ArchestrA IDE: go to Galaxy -> Import -> From -> AutoCAD.
By selecting AutoCAD you have already completed Step 1 of the import process. Launching from the
IDE tells the tool that the target is the current galaxy. All that is missing is the AutoCAD file. A file open
dialog box appears.

Select the DWG file to import. Click Open to enter the tool at Step 3, or Cancel to go back to the Connect Source and
Target (step 2).

• Click Open, the AutoCAD Import tool will start to Read and Open the selected .DWG file, and a process
box will appear

Document ID: Revision 1.0 45/129

 opening_autocad_import

If there are no errors reading the AutoCAD File the Configuration Dialog (Import Settings) will appear

• If you click Cancel , the tool opens at Step 2.

As we see on the screen, Source is not selected and Target is already connected. This is because the tool was
started in Embedded mode from the IDE. At the time the IDE was connected to galaxy Code192_GBIDemo.

Document ID: Revision 1.0 46/129

 opening_autocad_import

To re-open the file open dialog box, click the icon in Source Connection.

After selecting source file, it is pre-processed then the tool moves to step3.

External Mode
From C:\Program Files (x86)\code192\GalaxyToolbox\Graphics Bulk Import
run code192.GraphicsBulkImport.exe

AutoCAD is selected by default, so click Connect Source and Target or the arrow to advance to step 2

Document ID: Revision 1.0 47/129

 opening_autocad_import

Click the icon in Source Connection to open a file browser

Document ID: Revision 1.0 48/129

 opening_autocad_import

Select the DWG file to import. Click Open select the file.

Next click on the icon in Target Selection

Choose the Galaxy and click the check to connect to the Galaxy and advance to Step 3

Document ID: Revision 1.0 49/129

 import_settings_1

Import Settings
This section is a tutorial on how to select and configure Blocks, select Layouts and associated Layers.

The Import Settings page consists of several parts;

Navigation Bar

Shows steps and progress

Configuration Open/Save

Allows the user to Open and Save bindings.

Layouts Selector

Shows all Layouts the AutoCAD drawing contains. By default, the main one is selected.

Blocks Editor

Document ID: Revision 1.0 50/129

 import_settings_1

Shows all Blocks contained in the AutoCAD drawing, they are not linked to selected Layout(s) or
Layer(s), these are all blocks detected in the .DWG file. For more detail click here.

Layers Editor

Shows all associated Layers for Selected Layout. By default all of them are selected. For more detail click
here.

Preview

Document ID: Revision 1.0 51/129

 import_settings_1

Shows preview of selected Layouts, Layers and Blocks. By Clicking on preview image, it automatically
zooms to full screen.

Status

Shows different use-cases depending on selected Action.

Note: Color Coding

Ø Green Background- indicates that there is currently nothing matching found in the galaxy.
Ø Yellow background- indicates that graphic already exist in the galaxy
Ø Blue background- indicates that graphic already exist in the galaxy but user will be prompted for an action during the
import
Ø Orange Background- indicates that graphic already exist in the galaxy and will be renamed
Ø Grey background- Indicates that all the blocks are configured and ready for import

Connection Status

Shows the Source file and target Galaxy.

Document ID: Revision 1.0 52/129

 configure_import_settings

Configure Import Settings

This Section will provide steps to edit and configure Blocks, Layers and Layouts

Document ID: Revision 1.0 53/129

 layouts

Layouts
Explanation of all the functionality and all different cases

For the selected Layout(s) we have different use cases:

1. If Graphic does not exist in the Galaxy it will be created from AutoCAD.

2. If Graphic already exists in the Galaxy, select appropriate action:

• Ask - During the import a popup will ask the user whether to replace the existing graphic or rename the new one.
• Replace - Graphic in the Galaxy will be replaced with graphic from the AutoCAD file.
• Rename - Graphic in the Galaxy will not be effected. The graphic to be imported will have a suffix added to its name to
avoid a conflict
•

Document ID: Revision 1.0 54/129

 layouts

Skip - Graphic from AutoCAD won't replace existing graphic in the Galaxy. The selected Layers for that Layout will still
be imported (unless they are also set to skip)

Note: The yellow background indicates that graphic already exist in the galaxy

Document ID: Revision 1.0 55/129

 blocks

Blocks
Expanding the Blocks shows the proposed instance names

Note: Blocks are un-named in AutoCAD, but they may have ‘name’ attributes associated with the blocks. The green
background indicates that there is currently nothing matching found in the galaxy. Above are examples of how the tool
applies default names. To change these names see Tagname Rule

Select a Block

The GalaxyBindingEditor on the right changes context to the selected block, displaying graphic preview, status,
Attributes and Tagname rule as shown;

Document ID: Revision 1.0 56/129

 blocks

Understanding the Implications of Block Destinations

AutoCAD inserts (instances of blocks) can be imported as either

• ArchestrA Symbols or
• ArchestrA Objects

It is important to understand the difference as correctly choosing will allow you to effectively leverage the engineering time
already invested in your AutoCAD drawings.

ArchestrA Symbols
When blocks are imported as Symbols, one symbol is creates in the Graphic Toolbox for each block type (see 1 below). This
symbol is pasted multiple times in the layer symbols (3 below). The properties of these symbols (4 below) show that the
symbols have no owning object.

ArchestrA Objects
When blocks are imported as Objects, the symbols is created in a Template object. Multiple objects are instantiated from
the template (see 2 below). Each object inherits this symbol and these inherited symbols are pasted in the layer symbols (3
below). The properties of these symbols (5 below) show that they each have a different owning object.

Document ID: Revision 1.0 57/129

 blocks

Document ID: Revision 1.0 58/129

 graphic_preview

Graphic Preview

In the Graphic Preview, using the browser, the import target for the selected Block can be a symbol from the symbol
toolbox, a symbol in a template or, if nothing is selected, the Graphic will be created from AutoCAD. The form of the name
will determine the binding and what is created.

Note: Status changes according to the current configuration.

The Graphic Preview status changes, as shown:

The Action status changed, and there are 4 choices:

1. Ask - The user will be prompted to decide for further action

2. Replace - Graphic in the Galaxy will be replaced by one from AutoCAD

3. Rename- Graphic from AutoCAD will be renamed

4. Skip- Graphic from AutoCAD won't be imported in the Galaxy

If the destination does not exist the the action looks like this:

Note: The color of selected Block changes depending on the selected action

• ASK-Blue
• REPLACE-Yellow
• RENAME- Orange
• SKIP-Grey

Default Action is SKIP

Document ID: Revision 1.0 59/129

 graphic_preview

Insert Destinations

There are two major cases to consider:

• Binding to symbols that already exist in the Galaxy. You can enter the binding destination or use the browser

Click . The Galaxy Browser appears, select a symbol from the Symbol Library or from a Template

Binding to a Symbol Binding to a Symbol belonging to

Note: You can also type the name of symbol. See below for format information

• Allowing the tool to create new symbols in the Galaxy and binding to them. In this case there is nothing to browse to, so
the binding destination must be entered as text. The template and symbol may not exist or just the symbol.
1. To bind to a Symbol enter the name of the new symbol. The name must not begin with a $ and must not contain
dots. It can consist of alphanumeric characters and '$', '#' or '_'
2. To bind to a Symbol in a Template, enter '$TemplateName.SymbolName'. There must be a $ at the start to
indicate a template name and there must be one and only one dot to delimit the template name from the symbol
name
3. Press TAB. The tool will validate the name you have entered. If you start with a '$' but don't have a dot then the
'$' will be removed and your entry treated as a symbol name. If the tool corrects an invalid entry it will highlight
the entry in yellow

User entered a good symbol name

User entered $DiscreteValve. Tool will import a symbol

User entered a good template and symbol name

User entered $DiscreteValve.£Mimic. Illegal character

replaced with _

Insert Alignment

Document ID: Revision 1.0 60/129

 graphic_preview

When using a symbol that exists in the galaxy, there is usually a difference between the size and shape of the symbol in the
AutoCAD file and the one in the Galaxy. Use the following selections to determine how the import process must deal with
this.

Horizontal Alignment
Horizontal alignment controls how the width of the ArchestrA symbol is modified when it is pasted into a layer.

• Automatic: If Block and ArchestrA Symbol have the same name, Automatic works the same as Stretch, otherwise it
behaves like Center
• Left: The ArchestrA symbol width is not resized. The ArchestrA symbol is aligned with the left side of the
AutoCAD insert bounds
• Centre: The ArchestrA symbol width is not resized. The ArchestrA symbol is aligned with the center of the
AutoCAD insert bounds
• Right: The ArchestrA symbol width is not resized. The ArchestrA symbol is aligned with the right side of the
AutoCAD insert bounds
• Stretch The ArchestrA symbol is resized so that its width is the same as the AutoCAD insert.

Vertical Alignment
Vertical alignment controls how the height of the ArchestrA symbol is modified when it is pasted into a layer.

• Automatic: If Block and ArchestrA Symbol have the same name, Automatic works the same as Stretch, otherwise it
behaves like Center
• Top: The ArchestrA symbol width is not resized. The ArchestrA symbol is aligned with the top of the AutoCAD
insert bounds
• Centre: The ArchestrA symbol width is not resized. The ArchestrA symbol is aligned with the center of the
AutoCAD insert bounds
• Bottom: The ArchestrA symbol width is not resized. The ArchestrA symbol is aligned with the bottom of the
AutoCAD insert bounds
• Stretch The ArchestrA symbol is resized so that its height is the same as the AutoCAD insert.

Document ID: Revision 1.0 61/129

 tagname_rule

Tagname Rule
By default each symbol, or object instance is given a name consisting of an underscore, the name of the block it was derived
from and a sequential number.

It is possible to form from simple to quite complex rules as to how to generate meaningful names. These names are applied
to the symbols when they are pasted into layer symbols. The names are also used to name ArchestrA objects if the block has
been bound to a template.

To open the editor, click on edit the button .

The editor appears

Click on the + to add an initial attribute to the rule definition:

The dropdown menu allows you to use block's attributes to form the instances name

Document ID: Revision 1.0 62/129

 tagname_rule

You can concatenate several fields, including static data. You can also use rules to extract only some characters from a field.
For every chosen name, the Preview is shown.
To change a filed from and attribute to static, click on the tag icon to the left of Attribute

To change the order of parts of the rule, simply drag them up or down the list

When complete, click the OK button.

Tagname rule will be populated with the chosen Attribute

Automatically, all the Instances changed name

A more complex rule looks like this

Document ID: Revision 1.0 63/129

 tagname_rule

Document ID: Revision 1.0 64/129

 instance_attributes

Instance Attributes
One the Tagname Rule is defined, the proposed instances have there proposed names

By Clicking on an Instance, we have list of all associated Attributes, Original and the one to be exported. Unless the original
value violates an ArchestrA rule, the Exported Value will be the same as the original value

Document ID: Revision 1.0 65/129

 attributes

Attributes

In the Attributes, Uncheck the attributes that are not required.

For the attributes that need to be mapped into the new objects or symbols, select the destination (context and attribute).

The Value definition allows different attributes from the AutoCAD file to be combined or modified. By default each
attribute is mapped unmodified. A rule can be created for each attribute in the same way that tagname rules are created.

The context can be:

• Custom Property: When the symbol is pasted into the layer symbol, the default custom property will be overridden
with the value from AutoCAD
• Attribute: This is only available when inserts are imported as ArchestrA objects. The attribute can be a
UDA, a Field Attribute or any other writable attribute.

The Attribute is the name of the destination custom property/ UDA / Field attribute etc.

Custom Properties or Attributes will be created if they don't already exist, provided the action in the Graphic panel is
Replace or New (or Ask and when asked you choose replace). The link icon shows if they exist already or not.

The attribute can be typed in or browsed to. Obviously if you want to create something that does not exist you will need to
type it in. If you simply wish to type instead of browse, pressing TAB or clicking somewhere else will validate what you
typed.

Document ID: Revision 1.0 66/129

 layers

Layers

For the Chosen Layout there may be several associated Layers. There are several use cases depending on the Status:

1. If selected Layers does not exist in the galaxy, we can only select or unselect the Layers as shown, and the choice
will be previewed.

Note: Un-checked Layer will change color to Grey and won't be imported

2. If Layers already exists in the galaxy, there are four choices:

• Ask - During the import a popup will ask the user whether to replace the existing graphic or rename the new one.
• Replace - Graphic in the Galaxy will be replaced with graphic from the AutoCAD file.
• Rename - Graphic in the Galaxy will not be effected. The graphic to be imported will have a suffix added to its name to
avoid a conflict
• Skip - Graphic from AutoCAD won't replace existing graphic. The color will be gray.

Document ID: Revision 1.0 67/129

 layers

Note: The yellow background indicates that graphic already exist in the galaxy and that, unless something changes, by
default, they will be replaced with the selected graphic from AutoCAD.

Document ID: Revision 1.0 68/129

 save_configuration_1

Save Configuration
All of the configuration done in the Import Settings page can be saved.
Click to save configuration

Click to load saved configuration

Click Save
A typical Save dialog appears. Enter a filename and click Save

It is a good idea to save before running the import. This allows you to run the same import again later

Click Open
A typical Open dialog appears. Select the required file and click Open

Document ID: Revision 1.0 69/129

 save_configuration_1

Document ID: Revision 1.0 70/129

 import_1

Import

This is where the import is previewed, run, and the results appear.

Document ID: Revision 1.0 71/129

 import_preview_1

Import Preview
When you enter this page a preview like this is show. It displays what will happen.

Here are the possible proposed actions

Create
Rename
Ask
Replace. Existing is deleted

Document ID: Revision 1.0 72/129

 start_import_1

Start Import
The import is started by clicking this icon

Before the import begins, a check is run to see if anything has changed in the galaxy.

If a change is found the following popup appears.

Press OK. The preview updates and it is necessary to click the start icon again.

This gives you the opportunity to check that the proposed import is still acceptable.

Once the check is complete a popup asks for the resolution

This is necessary in order to correctly scale the AutoCAD graphics to fit into ArchestrA graphics.

Document ID: Revision 1.0 73/129

 ask_action_1

Ask Action
If during the Block configuration, Action: Ask was selected, the User will be prompted to choose the action while
processing
The popup will appear

Since the symbol already exist in the Galaxy and we have two choices:
1. Replace - click Yes
2. Generate a new name - click No

Document ID: Revision 1.0 74/129

 rename_action

Rename Action
Strings in graphics can be substituted during the import. This can be a very useful and powerful tool.
Static data stored in UDAs or custom properties is only visible at runtime, and in the case of UDAs requires communication
between object and symbol, which effects screen opening time.

It is possible for a developer to perform a string substitution (CTRL+L in InTouch or the IDE) and 'hard code' strings (labels,
units etc) onto each symbol as screens are built, but this is tedious and error prone.

The tool can do this work for you as blocks are pasted.
When a layer is being generated, if the tool detects text in a symbol being pasted the following popup appears.

The popup allows the user to create a rule to set strings on each instance.
If normal animations are used leave the checkboxes unchecked.
Check the ‘Apply the settings to the following symbols of the same type’ checkbox. This
Click OK to continue.
The import continues

You can provide this data for every symbol (by not checking the check-box at the bottom).

After the import; if you open the import you will see the replaced text at design time. This can be very useful to help a
developer quickly locate a specific instance.

Document ID: Revision 1.0 75/129

 results_1

Results
When the import is complete the following popup appears

Results are displayed for each operation

Possible statuses are

Ready to be imported
Creating symbol
Successfully Imported
Cancelled

Document ID: Revision 1.0 76/129

 xaml_import

XAML Import
This section will explain how to open .XAML files and run the import process

Document ID: Revision 1.0 77/129

 system_requirement_3

System requirement
ArchestrA 4.0 version or higher must be installed on the computer where Galaxy Toolbox XAML Import is to be
installed, with minimum screen resolution 1024x768 pixels.

Document ID: Revision 1.0 78/129

 drawing_limitations_2

Drawing Limitations
Supported Elements
Xaml Import supports the following graphic primitives (other elements are ignored):
• Path
• Rectangle
• Ellipse
• Line
• PolyLine
• Polygon
• Image
• Label
• Textblock

Size and Location

ArchestrA doesn't support relative location and size and requires absolute coordinates and size. Use Canvas.Left
and Canvas.Top to specify absolute location and Width and Height to specify size.
The location is determined individually, by element. The parent location is ignored by the tool.

Supported Properties
Xaml Import supports the following properties (other properties are ignored):
• Canvas.Left: Parent location will be ignored
• Canvas.Top: Parent location will be ignored
• Width: Parent width will be ignored
• Height: Parent height will be ignored
• Fill: Solid Fill, Radial and Linear Gradient are supported. Note that ArchestrA support only 3 colors in
gradient
• Stroke: Solid Fill, Radial and Linear Gradient are supported. Note that ArchestrA support only 3 colors
in gradient
• StrokeThickness: The minimum thickness in ArchestrA is 1. Values between 0 and 1 will be rounded to
1. 0 means no stroke.
• StrokeDashArray: ArchestrA has fixed pattern for stroke. StrokeDashArray value will be converted to
one of theses values: Solid, Long Dash, Short Dash, Dot, Dash-Dot, Dash-Dot-Dot-Dash
• StrokeStartLineCap
• StrokeEndLineCap
• FontFamily
• FontStyle
• FontWeight
• FontStretch
• FontSize
• ForeGround
• Visibility
• Opacity
• RenderTransform: Parent transform will be ignored

Document ID: Revision 1.0 79/129

 getting_started_2

Getting Started
This section contains quick tutorials to help you start working with XAML Import. It contains steps and
explanations on how to import a XAML file.

Document ID: Revision 1.0 80/129

 opening_xaml_import

Opening XAML Import

There are two ways to open the XAML Import tool - embedded mode and external mode:

Embedded Mode
From the ArchestrA IDE: go to Galaxy -> Import -> From -> XAML.
By selecting XAML you have already completed Step 1 of the import process. Launching from the IDE
tells the tool that the target is the current galaxy. All that is missing is the XAML file. A file open dialog
box appears.

Select the XAML file to import. Click Open to enter the tool at Step 3, or Cancel to go back to the Connect Source and
Target (step 2).

• Click Open, the XAML Import tool will start to Read and Open the selected .XAML file, and a process
box will appear

Document ID: Revision 1.0 81/129

 opening_xaml_import

If there are no errors reading the XAML File the Configuration Dialog (Import Settings) will appear

• If you click Cancel , the tool opens at Step 2.

Document ID: Revision 1.0 82/129

 opening_xaml_import

As we see on the screen, Source is not selected and Target is already connected. This is because the tool was
started in Embedded mode from the IDE. At the time the IDE was connected to galaxy Code192_GBIDemo.
To re-open the file open dialog box, click the icon in Source Connection.

After selecting source file, it is pre-processed then the tool moves to step3.

External Mode
From C:\Program Files (x86)\code192\GalaxyToolbox\Graphics Bulk Import
run code192.GraphicsBulkImport.exe

AutoCAD is selected by default, so click XAML to change to XAML mode and advance to step 2*

Document ID: Revision 1.0 83/129

 opening_xaml_import

Click the icon in Source Connection to open a file browser

Select the XAML file to import. Click Open select the file.

Next click on the icon in Target Selection

Document ID: Revision 1.0 84/129

 opening_xaml_import

Choose the Galaxy and click the check to connect to the Galaxy and advance to Step 3

Document ID: Revision 1.0 85/129

 import_settings_2

Import Settings
The Import Settings page consists of several parts;

Navigation Bar

Shows steps and progress.

Configuration Open/Save

Allows the user to Open and Save bindings.

Files Selector

Shows the selected file.

Preview

Document ID: Revision 1.0 86/129

 import_settings_2

Shows preview of selected file. Action specifies how to deal with existing symbols of the same name

Status

Shows different use-cases depending on selected Action.

Note: Color Coding

Ø Green Background- indicates that there is currently nothing matching found in the galaxy.
Ø Yellow background- indicates that graphic already exist in the galaxy
Ø Blue background- indicates that graphic already exist in the galaxy but user will be prompted for an action during the
import
Ø Orange Background- indicates that graphic already exist in the galaxy and will be renamed
Ø Grey background- Indicates that all the blocks are configured and ready for import

Connection Status

Shows the Source file and target Galaxy.

Document ID: Revision 1.0 87/129

 save_configuration_2

Save Configuration
The configuration done in the Import Settings page can be saved.
Click to save configuration

Click to load saved configuration

Click Save
A typical Save dialog appears. Enter a filename and click Save

Click Open
A typical Open dialog appears. Select the required file and click Open

Document ID: Revision 1.0 88/129

 save_configuration_2

Document ID: Revision 1.0 89/129

 import_2

Import
This is where the import is previewed, run, and the results appear.

Document ID: Revision 1.0 90/129

 import_preview_2

Import Preview
When you enter this page a preview like this is show. It displays what will happen.

Here are the possible proposed actions

Create
Rename
Ask
Replace. Existing is deleted

Document ID: Revision 1.0 91/129

 start_import_2

Start Import
The import is started by clicking this icon

Before the import begins, a check is run to see if anything has changed in the galaxy.

If a change is found the following popup appears.

Press OK. The preview updates and it is necessary to click the start icon again.

This gives you the opportunity to check that the proposed import is still acceptable.

Document ID: Revision 1.0 92/129

 ask_action_2

Ask Action
If during in the import settings, Action: Ask was selected, the User will be prompted to choose the action while processing
The popup will appear

Since the symbol already exist in the Galaxy and we have two choices:
1. Replace - click Yes
2. Generate a new name - click No

Document ID: Revision 1.0 93/129

 results_2

Results
When the import is complete the following popup appears

Results are displayed for each operation

Possible statuses are

Ready to be imported
Creating symbol
Successfully Imported
Cancelled

Document ID: Revision 1.0 94/129

 svg_import

SVG Import
This section will explain how to open .SVG files and run the import process

Document ID: Revision 1.0 95/129

 system_requirement_4

System requirement
ArchestrA 4.0 version or higher must be installed on the computer where Galaxy Toolbox SVG Import is to be
installed, with minimum screen resolution 1024x768 pixels.

Document ID: Revision 1.0 96/129

 drawing_limitations_3

Drawing Limitations
Supported Elements
SVG Import supports the following graphic primitives (other elements are ignored):
• Path
• Rectangle
• Ellipse
• Line
• PolyLine
• Polygon
• Image
• Label
• Textblock

Size and Location

ArchestrA doesn't support relative location and size and requires absolute coordinates and size.
The location is determined individually, by element. The parent location is ignored by the tool.

Supported Properties
SVG Import supports the following properties (other properties are ignored):
• Width: Parent width will be ignored
• Height: Parent height will be ignored
• Fill: Solid Fill, Radial and Linear Gradient are supported. Note that ArchestrA support only 3 colors in
gradient
• Stroke: Solid Fill, Radial and Linear Gradient are supported. Note that ArchestrA support only 3 colors
in gradient
• Stroke-dasharray: ArchestrA has fixed pattern for stroke. StrokeDashArray value will be converted to
one of theses values: Solid, Long Dash, Short Dash, Dot, Dash-Dot, Dash-Dot-Dot-Dash
• Stroke-linecap
• FontFamily
• FontStyle
• FontWeight
• FontStretch
• FontSize
• ForeGround
• Visibility
• Opacity

Exceptions
Some exceptions are not supported by SVG Import :
• Textures
• Reflect
• Moon phases element from Visio
• Bold and Italic from Adobe Illustrator
• Vertical fonts from Adobe Illustrator

Document ID: Revision 1.0 97/129

 getting_started_3

Getting Started
This section contains quick tutorials to help you start working with SVG Import. It contains steps and
explanations on how to import a SVG file.

Document ID: Revision 1.0 98/129

 opening_svg_import

Opening SVG Import

There are two ways to open the SVG Import tool - embedded mode and external mode:

Embedded Mode
From the ArchestrA IDE: go to Galaxy -> Import -> From -> SVG.
By selecting SVG you have already completed Step 1 of the import process. Launching from the IDE tells
the tool that the target is the current galaxy. All that is missing is the SVG file. A file open dialog box
appears.

Select the SVG file to import. Click Open to enter the tool at Step 3, or Cancel to go back to the Connect Source and
Target (step 2).

• Click Open, the SVG Import tool will start to Read and Open the selected .SVG file, and a process box
will appear

Document ID: Revision 1.0 99/129

 opening_svg_import

If there are no errors reading the SVG File the Configuration Dialog (Import Settings) will appear

• If you click Cancel , the tool opens at Step 2.

Document ID: Revision 1.0 100/129

 opening_svg_import

As we see on the screen, Source is not selected and Target is already connected. This is because the tool was
started in Embedded mode from the IDE. At the time the IDE was connected to galaxy GBI_Test.
To re-open the file open dialog box, click the icon in Source Connection.

After selecting source file, it is pre-processed then the tool moves to step3.

External Mode
From C:\Program Files (x86)\code192\GalaxyToolbox\Graphics Bulk Import
run code192.GraphicsBulkImport.exe

Document ID: Revision 1.0 101/129

 opening_svg_import

AutoCAD is selected by default, so click SVG to change to SVG mode and advance to step 2*

Click the icon in Source Connection to open a file browser

Document ID: Revision 1.0 102/129

 opening_svg_import

Select the SVG file to import. Click Open select the file.

Next click on the icon in Target Selection

Choose the Galaxy and click the check to connect to the Galaxy and advance to Step 3

Document ID: Revision 1.0 103/129

 import_settings_3

Import Settings
The Import Settings page consists of several parts;

Navigation Bar

Shows steps and progress.

Configuration Open/Save

Allows the user to Open and Save bindings.

Files Selector

Shows the selected file.

Preview

Document ID: Revision 1.0 104/129

 import_settings_3

Shows preview of selected file. Action specifies how to deal with existing symbols of the same name.

Status

Shows different use-cases depending on selected Action.

Note: Color Coding

Ø Green Background- indicates that there is currently nothing matching found in the galaxy.
Ø Yellow background- indicates that graphic already exist in the galaxy
Ø Blue background- indicates that graphic already exist in the galaxy but user will be prompted for an action during the
import
Ø Orange Background- indicates that graphic already exist in the galaxy and will be renamed
Ø Grey background- Indicates that all the blocks are configured and ready for import

Connection Status

Shows the Source file and target Galaxy.

Document ID: Revision 1.0 105/129

 save_configuration_3

Save Configuration
The configuration done in the Import Settings page can be saved.
Click to save configuration

Click to load saved configuration

Click Save
A typical Save dialog appears. Enter a filename and click Save

Click Open
A typical Open dialog appears. Select the required file and click Open

Document ID: Revision 1.0 106/129

 save_configuration_3

Document ID: Revision 1.0 107/129

 import_3

Import
This is where the import is previewed, run, and the results appear.

Document ID: Revision 1.0 108/129

 import_preview_3

Import Preview
When you enter this page a preview like this is show. It displays what will happen.

Here are the possible proposed actions

Create
Rename
Ask
Replace. Existing is deleted

Document ID: Revision 1.0 109/129

 start_import_3

Start Import
The import is started by clicking this icon

Before the import begins, a check is run to see if anything has changed in the galaxy.

If a change is found the following popup appears.

Press OK. The preview updates and it is necessary to click the start icon again.

This gives you the opportunity to check that the proposed import is still acceptable.

Document ID: Revision 1.0 110/129

 ask_action_3

Ask Action
If during in the import settings, Action: Ask was selected, the User will be prompted to choose the action while processing
The popup will appear

Since the symbol already exist in the Galaxy and we have two choices:
1. Replace - click Yes
2. Generate a new name - click No

Document ID: Revision 1.0 111/129

 results_3

Results
When the import is complete the following popup appears

Results are displayed for each operation

Possible statuses are

Ready to be imported
Creating symbol
Successfully Imported
Cancelled

Document ID: Revision 1.0 112/129

 wmf_emf_import

WMF/EMF Import
This section will explain how to open .WMF or .EMF files and run the import process

Document ID: Revision 1.0 113/129

 system_requirement_5

System requirement
ArchestrA 4.0 version or higher must be installed on the computer where Galaxy Toolbox WMF/EMF Import is
to be installed, with minimum screen resolution 1024x768 pixels.

Document ID: Revision 1.0 114/129

 drawing_limitations_4

Drawing Limitations
Supported Elements
WMF/EMF Import supports the following graphic primitives (other elements are ignored):
• Path
• Rectangle
• Ellipse
• Line
• PolyLine
• Polygon
• Image, in most cases.
• Label
• Textblock

Size and Location

ArchestrA doesn't support relative location and size and requires absolute coordinates and size.
The location is determined individually, by element. The parent location is ignored by the tool.

Supported Properties
WMF/EMF Import supports the following properties (other properties are ignored):
• Width
• Height
• Fonts
• Rotation

Exceptions
Some exceptions are not supported by WMF/EMF Import :
• Textures
• Reflect
• Radiant
• Transparency
• Bold and Italic from Adobe Illustrator
• Vertical fonts from Adobe Illustrator

We recommand to import into WMF/EMF rather than WMF or EMF.

Document ID: Revision 1.0 115/129

 getting_started_4

Getting Started
This section contains quick tutorials to help you start working with WMF/EMF Import. It contains steps and
explanations on how to import a WMF or EMF file.

Document ID: Revision 1.0 116/129

 opening_wmf_emf_import

Opening WMF/EMF Import

There are two ways to open the WMF/EMF Import tool - embedded mode and external mode:

Embedded Mode
From the ArchestrA IDE: go to Galaxy -> Import -> From -> WMF/EMF.
By selecting WMF/EMF you have already completed Step 1 of the import process. Launching from the
IDE tells the tool that the target is the current galaxy. All that is missing is the WMF or EMF file. A file
open dialog box appears.

Select the WMF or EMF file to import. Click Open to enter the tool at Step 3, or Cancel to go back to the Connect Source
and Target (step 2).

• Click Open, the WMF/EMF Import tool will start to Read and Open the selected .WMF or .EMF file,
and a process box will appear

Document ID: Revision 1.0 117/129

 opening_wmf_emf_import

If there are no errors reading the WMF or EMF File the Configuration Dialog (Import Settings) will
appear

• If you click Cancel , the tool opens at Step 2.

As we see on the screen, Source is not selected and Target is already connected. This is because the tool was
started in Embedded mode from the IDE. At the time the IDE was connected to galaxy GBI_Test.
To re-open the file open dialog box, click the icon in Source Connection.

Document ID: Revision 1.0 118/129

 opening_wmf_emf_import

After selecting source file, it is pre-processed then the tool moves to step3.

External Mode
From C:\Program Files (x86)\code192\GalaxyToolbox\Graphics Bulk Import
run code192.GraphicsBulkImport.exe

AutoCAD is selected by default, so click WMF/EMF to change to WMF/EMF mode and advance to step 2*

Document ID: Revision 1.0 119/129

 opening_wmf_emf_import

Click the icon in Source Connection to open a file browser

Select the WMF or EMF file to import. Click Open select the file.

Next click on the icon in Target Selection

Choose the Galaxy and click the check to connect to the Galaxy and advance to Step 3

Document ID: Revision 1.0 120/129

 import_settings_4

Import Settings

Navigation Bar

Shows steps and progress.

Configuration Open/Save

Allows the user to Open and Save bindings.

Files Selector

Shows the selected file.

Preview

Document ID: Revision 1.0 121/129

 import_settings_4

Shows different use-cases depending on selected Action.

Status

Shows different use-cases depending on selected Action.

Note: Color Coding

Ø Green Background- indicates that there is currently nothing matching found in the galaxy.
Ø Yellow background- indicates that graphic already exist in the galaxy
Ø Blue background- indicates that graphic already exist in the galaxy but user will be prompted for an action during the
import
Ø Orange Background- indicates that graphic already exist in the galaxy and will be renamed
Ø Grey background- Indicates that all the blocks are configured and ready for import

Connection Status

Shows the Source file and target Galaxy.

Document ID: Revision 1.0 122/129

 save_configuration_4

Save Configuration
The configuration done in the Import Settings page can be saved.
Click to save configuration

Click to load saved configuration

Click Save
A typical Save dialog appears. Enter a filename and click Save

Click Open
A typical Open dialog appears. Select the required file and click Open

Document ID: Revision 1.0 123/129

 save_configuration_4

Document ID: Revision 1.0 124/129

 import_4

Import
This is where the import is previewed, run, and the results appear.

Document ID: Revision 1.0 125/129

 import_preview_4

Import Preview
When you enter this page a preview like this is show. It displays what will happen.

Here are the possible proposed actions

Create
Rename
Ask
Replace. Existing is deleted

Document ID: Revision 1.0 126/129

 start_import_4

Start Import
The import is started by clicking this icon

Before the import begins, a check is run to see if anything has changed in the galaxy.

If a change is found the following popup appears.

Press OK. The preview updates and it is necessary to click the start icon again.

This gives you the opportunity to check that the proposed import is still acceptable.

Document ID: Revision 1.0 127/129

 ask_action_4

Ask Action
If during in the import settings, Action: Ask was selected, the User will be prompted to choose the action while processing
The popup will appear

Since the symbol already exist in the Galaxy and we have two choices:
1. Replace - click Yes
2. Generate a new name - click No

Document ID: Revision 1.0 128/129

 results_4

Results
When the import is complete the following popup appears

Results are displayed for each operation

Possible statuses are

Ready to be imported
Creating symbol
Successfully Imported
Cancelled

Document ID: Revision 1.0 129/129