PREV NEXT

Generic Logic, Inc. www.genlogic.com


2 GLG HMI Configurator Menus

This chapter presents descriptions of all the options of the GLG HMI Configurator's menus. They are organized by menu name, in the same order as they appear in the HMI Configurator's menu bar:

The toolbar below the menu bar provides convenient shortcuts for accessing the most often used menu choices. To see the tooltip showing the function of a toolbar's button, hold the mouse inside the button until the tooltip appears.

File

The File menu provides options for creating, loading and saving drawing files, exporting/importing strings and tags, printing drawings, generating images, and closing the GLG HMI Configurator.

New Drawing (Resize and Stretch)

New Drawing (Resize and Stretch) creates a new resizable drawing. When the drawing is resized, all objects in the drawing are resized as well. If the window is resized in such a way that its width/height ratio is not maintained, the drawing is stretched to fit the new window size, which makes objects such as circles appear stretched.

Several options are provided to target screens with different aspect ratios:

1:1 Width/Height Ratio
4:3 Width/Height Ratio
16:9 Width/Height Ratio
Width/Height Ratio From Config File

The last option uses the aspect ratio defined by the CustomSpanX and CustomSpanY parameters in the glg_config file.

New Drawing (Resize, No Stretch)

New Drawing (Resize, No Stretch) creates a new resizable drawing. When the drawing is resized, all objects in the drawing are resized as well. The drawing maintain its X/Y ratio, so that objects such as circles always maintain their circular shape.

Several options are provided to target screens with different aspect ratios:

1:1 Width/Height Ratio
4:3 Width/Height Ratio
16:9 Width/Height Ratio
Width/Height Ratio From Config File

The last option uses the aspect ratio defined by the CustomSpanX and CustomSpanY parameters in the glg_hmi_config file.

New Drawing (Fixed Scale, No Stretch)

New Drawing (Fixed Scale, No Stretch) creates a non-resizable drawing where objects do not change their size when the drawing is resized. Instead, more or less of the drawing area is shown in the window. Since the drawing is not stretched, the objects in the drawing always keep their X/Y ratio.

The following options are provided:

Custom Size
allows creating a fixed scale drawing of an arbitrary size specified via a popup dialog.
Size From Config File
creates a fixed scale viewport with the size specified in the glg_hmi_config file.

Reset Drawing

Reset Drawing re-initializes the current drawing.

For composite objects such as graphs, Reset Drawing erases volatile resources such as graph's data.

Resize Drawing

Changes the size of a fixed scale drawing.

Open

Open loads a drawing from a file.

When you select Open, the HMI Configurator prompts you to select a file name, using the standard file selection dialog.

If a drawing is already open, Open discards the current drawing. The HMI Configurator asks if you want to discard the current drawing, but it does not prompt you to save the changes.

Open URL

Open URL loads a drawing from a URL.

In the Linux/Unix environment, the GLG_WGET_PATH environment variable must be set to point to the wget utility executable to enable this option.

Load Template

This option is similar to the Open option for loading a drawing. However, Load Template doesn't allow the user to save the modified drawing back to the same file, to avoid accidentally overwriting the drawing used as a template for creating other drawings.

Recent Drawings

Recent Drawings displays a list of the recently edited drawings. Select one of the recent drawings from the list to load it.

If a drawing is already open, loading a recent drawing discards the current drawing. The HMI Configurator asks if you want to discard the current drawing, but it does not prompt you to save the changes.

Save

Save saves the current drawing to a file.

The first time you save a drawing, the HMI Configurator prompts you for a file name, using the standard file selection dialog. If the drawing has been saved before, it asks if you want to overwrite the existing file.

The HMI Configurator can save files in two different formats:

There is also an option for saving compressed drawings. Compressed drawings are smaller but load slower than non-compressed.

The default format for saving drawings is compressed ASCII. To change the format, use Options, Save Format and Save Compressed; see page 78.

SaveAs

Save As saves the current drawing to a different file.

When you select Save As, the HMI Configurator prompts you to enter a file name, using the standard file selection dialog. The usual file name extension for a GLG drawing is .g though it is not required.

The default format for saving drawings is compressed ASCII. To change the format, use Options, Save Format and Save Compressed; see page 78.

Print

For Linux/UNIX users, Print saves a PostScript image of the current drawing into a file.

For Windows users, Print sends the current drawing to the printer, using the standard Windows print facilities. Use Export PostScript to save a PostScript image of the drawing to a file. The Print toolbar button can be configured to perform either task using the ToolbarPrint configuration file variable.

Print uses the print configuration set by the File, Print Configuration options.

Export PostScript

Export PostScript (Windows only) saves a PostScript image of the current drawing (in its current state) to a file. On Unix/Linux, the Print option performs the same task.

Export PostScript uses the print configuration set by the File, Print Configuration options.

Print Configuration

The Print Configuration submenu provides options to let you set up the printer.

Page Layout

Page Layout specifies how to map the drawing to the printed page.

Page Layout presents a viewport that corresponds to the printed area. The position and size of the viewport relatively to the Drawing Area define the position and size of the area in which the drawing will be printed relatively to the page.

Resize the page layout viewport with the mouse to define the printing area. Delete the viewport when you have finished.

This option applies to both PostScript and Windows printing.

Stretch

Stretch prints the drawing using the full area of the page. The drawing is scaled to fill the printing area, so the proportions of the printed drawing may not correspond to the drawing's actual proportions. Using the appropriate orientation (portrait or landscape) can help reduce distortion; to preserve the drawing ratio, turn Stretch off.

This option applies to both PostScript and Windows printing.

PostScript Level

For PostScript printing and export, PostScript Level specifies which version of PostScript the HMI Configurator sends to the printer. Level 3 is required for proper PostScript printing of images with transparent background.

PostScript Orientation

For PostScript printing and export, PostScript Orientation determines whether the drawing is printed in portrait mode (across the width of the page) or in landscape mode (down the height of the page).

For Windows printing, the page orientation is set in the Print dialog.

Portrait and Landscape Orientations

Save Image

Save Image saves the image of the visible part of the drawing area into a file in either the JPEG or PNG format. The format of the image is defined by the SaveImageFormat variable in the glg_hmi_config file.

Save Image Full

Save Image Full saves an unclipped image of the whole drawing into a file in either the JPEG or PNG format. The format of the image is defined by the SaveImageFormat variable in the glg_hmi_config file.

Export Strings

Export Strings exports all strings defined in the drawing into a file.

Refer to Localization Support on page 230 of the GLG User's Guide and Builder Reference Manual for information about the string translation file format.

Import Strings

Import Strings imports strings from a string translation file, replacing matching strings in the drawing.

Refer to Localization Support on page 230 of the GLG User's Guide and Builder Reference Manual for information about the string translation file format.

Export Tags

Export Tags exports all tag names defined in the drawing into a file.

Refer to Tag Export and Import Features for Run-Time Tag Mapping on page 234 of the GLG User's Guide and Builder Reference Manual for information about the tag file format.

Import Tags

Import Tags imports tag names from a tag translation file, replacing matching tag names in the drawing.

Refer to Tag Export and Import Features for Run-Time Tag Mapping on page 234 of the GLG User's Guide and Builder Reference Manual for information about the tag file format.

Exit

Exit closes the GLG HMI Configurator.

If a drawing is already open, the HMI Configurator asks if you want to discard the current drawing, but it does not prompt you to save the changes. You must explicitly save the drawing using File, Save before exiting the GLG HMI Configurator.

Palettes

The Palettes menu contains the Shapes, Images and Text palette used for creating graphical primitives, such as polygons, arcs, images and text objects, and also provides access to palettes of widgets and other pre-built objects. By default, only the Custom Objects and Custom Widget Samples palettes are installed. Other palettes are optional. Possible palettes include Real-Time Charts, 2D Graphs, 3D Graphs, Controls, Avionics, Process Control Symbols, Electrical and Electronic Circuit Symbols, and Special Widgets palettes, as well as the palettes provided by an OEM vendor.

The Palettes Menu lists all available palettes of pre-built objects. To display a palette, select it from the palettes list. To add an object from a palette into the drawing, click on its icon in the palette. The HMI Configurator will insert a copy of the object into the drawing. Give the object a name and adjust its shape using the resize box.

When no optional palettes are installed, the Palette Menu provides the Custom Objects, Custom Widget Samples, Read Palette and Read Directory options.

Manual Widget Positioning

Manual Widget Positioning controls how widgets from the widget palettes are positioned in the drawing. If the toggle is checked, selecting a widget from the palette and clicking in the drawing will insert the widget at the position of the mouse click. If the option is unchecked, the widget will be positioned in the center of the drawing area.

Make Widget Viewports Transparent

The Make Widget Viewports Transparent option may be used to add dials and gauges with transparent background. If it is checked, adding a viewport-based widget from the palette converts it to use a light viewport with a transparent background. If the option is not checked, a viewport object with non-transparent background is used.

Custom Objects

The Custom Objects palette displays samples of pre-built widgets that can be used in a drawing. It contains buttons, sliders and other objects.

Refer to the Using Custom Object Palette section on page 67 of the GLG Builder and Animation Tutorial for detailed description of all widgets in the Custom Objects palette.

Custom Widget Samples

The Custom Widget Samples palette displays samples of HMI components that use application-specific public properties. Public properties provide a simplified interface for configuring components via the Properties dialog.

Click on a component in the palette to add it to the drawing, then use Object, Properties to display its public properties.

Read Palette

The Read Palette option can be used to load a palette into the HMI Configurator. A palette is defined by a Palette Description File with the .pal extension. This file provides information about the palette and the objects it contains.

To load a palette, select Read Palette, then select the palette's .pal file using the activated file browser.

Read Directory

The Read Directory option can be used to scan a directory containing GLG drawings and display a palette containing all drawings in the directory. To read a directory, select Read Directory, then select a directory to read with the activated file browser.

Edit

The Edit Menu provides options that let you make and manipulate copies of objects.

These options operate on the selected object. To operate on several objects at the same time, use the menu options for selecting multiple objects, then use editing options.

The Cut, Copy, and Paste options add and remove objects. The Clone options let you position and transform the added objects as they are created.

Select Multiple Objects

Select Multiple Objects is equivalent to using Ctrl-click. It starts multiple object selection without the need to hold the Ctrl key. After the option is selected, click on the objects in the drawing to add or delete them from the selection.

Select Rectangular Area

Select Rectangular Area is equivalent to clicking and dragging the mouse in the drawing to define the selection rectangle. It provides a convenient option for starting a rectangular selection for cases when all drawing area is covered with objects and there is no free space to click and drag the mouse without selecting some object. After the option is selected, click and drag the mouse anywhere in the drawing area to define the selection rectangle. All objects that are either completely or partially enclosed by the rectangle will be selected.

Select All

Select All selects all objects in the drawing.

Cut

Cut removes the selected object from the drawing and places it on the clipboard. The cut object remains on the clipboard until you replace it by performing another Edit, Cut or an Edit, Copy operation.

You can retrieve the cut object by using Edit, Paste.

Copy

Copy places a copy of the selected object on the clipboard without removing it from the drawing. The copied object remains on the clipboard until you replace it by performing an Edit, Cut or Edit, Copy operation.

You can retrieve the copied object by using Edit, Paste.

Paste

Paste gets a cut or copied object from the clipboard and adds it to the current drawing. Pasting an object does not delete the object from the clipboard, so you can paste the same object repeatedly.

Delete

Delete removes the selected object from the drawing. The deleted object is irrevocably discarded; it is not placed on the clipboard.

To remove an object from the drawing and place it on the clipboard, use Edit, Cut. This allows you to move an object from one part of the drawing to another.

Define Clone Offset

Define Clone Offset determines the placement of a copy with respect to the original object.

When you select Define Clone Offset, the HMI Configurator prompts you to click on two points that define the clone path. The clone path specifies the distance and direction from the origin of the original object to the origin of the copy.

The HMI Configurator uses a default offset of 50 units to the Southeast for all objects unless you redefine the offset.

To copy an object using the defined offset, use the Copy With an Offset option of the Edit menu.

Copy Object With an Offset

Copy Object With an Offset creates a copy of the selected object. The copy is positioned with an offset defined by the Define Clone Offset option.

Edit Group Elements

Provides options for editing multiple objects in a group via resources. A selected editing operation, such as Set D Resource, can be applied to elements of the group, skipping the elements that do not have the specified resource. If the Recursive option is selected, the editing operation will be also applied to the sub-elements inside each group element.

Set D Resource

Traverses all objects in the group and sets the value of a specified resource of D (double) type.

Set G Resource

Traverses all objects in the group and sets the value of a specified resource of G type (XYZ coordinate or color RGB).

Set S Resource

Traverses all objects in the group and sets the value of a specified resource of S (String) type.

Recursive

Controls traversing of subobjects inside group elements that are containers, such as groups, viewports and light viewports. If the Recursive option is set, the editing operation will be applied to the elements of the group, as well as sub-elements inside each container element with an unset HasResources flag. If the option is unset, the editing operation will be applied only to the top-level elements of the group.

Run-Time Scrollbars

The Run-Time Scrollbars menu has options for setting the drawing's run-time scrollbars. The run-time scrollbars are displayed when the drawing is deployed in an application and used to scroll the drawing.

The menu has the following options:

None

Disables the drawing's run-time scrollbars.

X and Y

Enables the drawing's run-time scrollbars, both in the X and Y direction.

X

Enables the drawing's horizontal run-time scrollbar.

Y

Enables the drawing's vertical run-time scrollbar.

Keep Edit Ratio

Provides access to the Keep Edit Ratio attribute of the top drawing viewport. If checked, the drawing will maintain its X/Y ratio to prevent shape distortion of circles and other objects.

Undo

Undo

Undo reverts the effect of the last editing operation, such as changing geometry or an attribute value of an object or group of objects, changes to object's control points, layout and alignment operations, zooming and panning and others. The undo button displays the last editing operation that can be undone and changes its label to Redo after performing the Undo operation. For some editing operations, such as deleting objects, the Paste option should be used instead of Undo.

Undo History

Undo History displays a list of recent editing actions and allows selecting individual actions to undo or redo.

Some geometry editing actions require the drawing's viewing state (pan and zoom) to be unchanged in order to be reverted properly. The changes to the drawing's viewing state are listed in the Undo History list and can be undone as well.

View

The View Menu provides options to zoom and pan the drawing.

Zooming

The Zooming submenu provides options to let you change the scale of the view. The changes in scale affect your view of the drawing, not the drawing itself, and are saved with the viewport. The HMI Configurator's Control Panel also provides zooming controls.

Zoom In

Zoom In increases the scale of the drawing, so the objects look bigger. Zooming into a drawing enlarges the objects in the center of the drawing, but objects near the edges of the drawing may be clipped.

To control the degree of scaling, use View, Zooming, Set Zoom Factor.

Zoom Out

Zoom Out decreases the scale of the drawing, so the objects look smaller.

To control the degree of scaling, use View, Zooming, Set Zoom Factor.

Zoom To

Zoom To zooms into a specified area of the drawing. When you select this option, the HMI Configurator prompts you to specify two points that define a bounding box for the zoom area.

To recover your view of the excluded area, use View, Zooming, Zoom Out.

Set Zoom Factor

Set Zoom Factor controls the scale factor to be applied when you zoom using the Zoom In and Zoom Out buttons of the Control Panel or the menu options. The HMI Configurator prompts you for a scaling factor (for example, 2 to scale up or 0.5 to scale down).

Reset Zoom

Reset Zoom returns to the normal scale for the view (100% zoom).

Pan To

Pan To moves the center of the view to another part of the drawing area.

After you select this option, click on a spot to use as the new center of the view.

Scroll by Dragging

Starts dragging mode. Click and drag the mouse after selecting this option to scroll the drawing with the mouse.

Scrolling the drawing with the mouse may also be performed by the Ctrl-click-drag sequence in any empty area of the drawing. However, if the drawing area is completely occupied by objects, this menu option provides an alternative.

Traverse

The Traverse Menu provides options for editing inner objects of a widget. For example, a real-time chart widget is comprised of a Chart object inside the widget's viewport. The Resource Browser may be used to edit the chart's properties as resources. To edit the chart's properties via the Properties dialog, the Set Focus menu may be used to set editing focus inside the widget's viewport, after which the chart object can be selected for editing.

Set Focus

Set Focus sets editing focus into the viewport selected with the mouse. To set the focus, use this menu option (or click on the Set Focus button on the Control Panel). The HMI Configurator prompts you to select a viewport to set focus into. Ctrl-Shift-clicking on a viewport also moves focus into it, acting as a convenient shortcut for Set Focus. If a viewport is part of a group, the first Ctrl-Shift-click on a viewport selects it, and the second Ctrl-Shift-click moves focus inside the viewport.

To return to the default editing mode, use Traverse, Main Focus, or click on the Main Focus button.

Main Focus

Main Focus returns focus to the main drawing area. Ctrl-Shift-clicking on a top-level viewport of the drawing area also moves focus into it.

This option is grayed out until you use Traverse, Set Focus to change the viewport editing mode.

Arrange

The Arrange Menu provides options to let you change the relationships between objects.

Create Temporary Group

Create Temporary Group is equivalent to Select Rectangular Area described on page 56.

Select Multiple Objects

Select Multiple Objects is equivalent to Select Multiple Objects described on page 56.

Add Object to Group

Add Object to Group adds an object to the selected group object. It may be used with both temporary and permanent groups.

Use the following procedure:

The status bar at the bottom of the HMI Configurator window provides prompts to guide you through the procedure.

This option is equivalent to the Add Object button in the Properties dialog for a group object.

Delete Object from Group

Delete Object from Group removes a single object from the selected group. The option may be used with both temporary and permanent groups.

Use the following procedure:

The status bar at the bottom of the HMI Configurator window provides prompts to guide you through the procedure.

This option is equivalent to the Remove Object button in the Properties dialog for a group object.

Add or Delete Object from Group

Add or Delete Object from Group adds an object to the group if the object is not part of the group, or deletes the object from the group if the object is a part of the group.The option may be used with both temporary and permanent groups.

Use the following procedure:

The status bar at the bottom of the HMI Configurator window provides prompts to guide you through the procedure.

For temporary groups, the same action can be accomplished by Ctrl-clicking on the object with the mouse.

Select Next

Select Next is used to select individual objects inside the group for editing. When you click on an object in a group with the mouse, you select the entire group. If you want to edit only one member of the group, you can use Select Next to select it.

When a permanent group is selected, the Ctrl-Shift-click on an object in the group selects the object, acting as a shortcut for Select Next. When an object inside the group is selected using Select Next, the boundaries of its parent group are highlighted with a dotted line to provide visual feedback for the group.

This option is equivalent to the Select Next button in the Properties dialog for a group object.

Select Next mode is aborted when an object outside of the group is selected.

Edit All (First)

For a group object, Edit All (First) starts editing the attributes of objects in the group by using the first object in the group to select a set of attributes for editing. This is a convenient option for fast editing of groups that contain objects of the same type.

For groups that contain objects of different types, the Edit All (Select) option allows you to select a set of attributes to edit. For example, if the group contains both the polygon and text objects, the Edit All (Select) option allows you to select the polygon or text attributes to be edited.

This option is equivalent to the Edit All (First) button in the Properties dialog for a group object.

Edit All (Select)

For a group object, Edit All (Select) allows you to choose a set of attributes to edit. This may be convenient when the group contains objects of different types with different sets of attributes.

When you select this option, the HMI Configurator prompts you to select an object that has the attributes you want to change. The changes you make to an attribute in the Properties dialog apply to all the objects in the group that have the attribute.

For example, consider a group that contains two circles, a parallelogram, and a fixed text object. Select Edit All (Select) and then select a circle. The Properties dialog shows the attributes for a circle object. Resetting the Resolution affects both circles. Resetting the LineWidth affects both of the circles and the parallelogram. However, the text object doesn't have a LineWidth attribute and is not affected.

This option is equivalent to the Edit All (Select) button in the Properties dialog for a group object.

Permanent Group

Permanent Group toggles the type of the selected group object between temporary and permanent. The current group type is displayed as the state of this toggle button.

Explode Group

Explode Group discards the permanent group, so that the objects in a group become independent objects. Any dynamics attached to the group is discarded with the group.

Reorder

The Reorder submenu provides options to let you change the drawing order of objects.

The last object drawn appears to be in front of any other overlapping objects, with the exception of components that use viewports: viewports are windows and always appear on top of graphical objects.

Move to Back

Move to Back moves the selected object behind other objects in the drawing. All overlapping objects appear to be in front of the selected object.

Bring to Front

Bring to Front moves the selected object in front of other objects in the drawing. All overlapping objects appear to be behind the selected object.

Move Backward

Move Backward changes the selected object's place in the rendering list, moving the object back in the list by one position every time Move Backward is selected (the Ctrl-+ accelerator may also be used).

Move Forward

Move Forward changes the selected object's place in the rendering list, moving the object forward in the list by one position every time Move Forward is selected (the Ctrl-- accelerator may also be used).

Convert Viewport

Contains options for converting viewports.

Viewport -> Light Viewport

Converts a selected viewport to a light viewport.

Light Viewport -> Viewport

Converts a selected light viewport to a viewport.

UTF8 Conversions

Convert Strings from Current Local to UTF8

Converts string attributes (such as TextString of a text object) of all objects in the drawing from the current locale to UTF8 and sets the UTF8Encoding flag of each attribute to YES.

Convert UTF8 Strings to Current Locale

Converts string attributes (such as TextString of a text object) of all objects in the drawing from UTF8 encoding the current locale and sets the UTF8Encoding flag of each attribute to NO.

Layout

The Layout Menu provides options to align and layout objects in the drawing. It may also be used to view or set the objects' width and height using the Layout Toolbox option.

Layout Toolbox

This option activates the Layout Toolbox which contains icons and controls for performing various align and layout operations. See Object Layout and Alignment on page 46 for more information.

Position in Drawing

This submenu provides options for positioning object in the drawing's viewport. The Align To Viewport Span option of the Layout menu controls the area used for alignment: the viewport span or the currently visible area of the viewport.

At Left Edge

At Left Edge aligns the left edge of the selected object with the left edge of the drawing.

Center Horizontally

Center Horizontally positions the selected object in the center of the drawing in the horizontal direction.

At Right Edge

At Right Edge aligns the right edge of the selected object with the right edge of the drawing.

At Top Edge

At Top Edge aligns the top edge of the selected object with the top edge of the drawing.

Center Vertically

Center Vertically positions the selected object in the center of the drawing in the vertical direction.

At Bottom Edge

At Bottom Edge aligns the bottom edge of the selected object with the bottom edge of the drawing.

Set Width/Height

The Set Width/Height submenu provides options for setting an object's width and height.

World Coordinates

Provides options for setting an object's width and height in world coordinates.

Set Width
Set Height

Opens the Layout Toolbox dialog and selects options for setting width or height of the selected object in world coordinates. The current width or height is displayed in the dialog and can be changed be entering a new value.

Set Group Element Width
Set Group Element Height

Opens the Layout Toolbox dialog and selects options for setting width or height of all elements of the selected group in world coordinates. The dialog displays width or height of the first element of the group. The width or height of all group elements may be changed by entering a new value.

Pixels

Provides options for setting an object's width and height in pixels.

Set Width
Set Height
Set Group Element Width
Set Group Element Height

These options are the same as the corresponding options for setting width/height in world coordinates, except that they use pixels instead of the world coordinates.

Set Space/Distance

The Set Space/Distance submenu provides options for setting space or distance between elements of a group. The distance is measured between the object's centers, while space is the distance between the object's extents.

The Align Points option controls how object extents are determined, using either an object's bounding box or control points.

World Coordinates

Provides options for setting space or distance between elements of a group in world coordinates.

Set Horiz. Space
Set Vert. Space
Set Horiz. Center Distance
Set Vert. Center Distance

Opens the Layout Toolbox dialog and selects options for setting space or distance between elements of the selected group in world coordinates. The space or distance can be changed be entering a new value instead of the default value displayed in the dialog.

Pixels

Provides options for setting space or distance between objects in a group in pixels.

Set Horiz. Space
Set Vert. Space
Set Horiz. Center Distance
Set Vert. Center Distance

These options are the same as the corresponding options for setting space/distance in world coordinates, except that they use pixels instead of the world coordinates.

Align

The Align submenu provides options for aligning objects.

Align Left

Align Left aligns the left edge of each selected object with the left edge of the anchor object. If no anchor object is selected, the left most selected object is used as an anchor.

Align Horiz. Center

Align Horiz. Center aligns the center of each selected object with the center of the anchor object horizontally. If no anchor object is selected, the left most selected object is used as an anchor.

Align Right

Align Right aligns the right edge of each selected object with the right edge of the anchor object. If no anchor object is selected, the right most selected object is used as an anchor.

Align Top

Align Top aligns the top edge of each selected object with the top edge of the anchor object. If no anchor object is selected, the highest selected object is used as an anchor.

Align Vert. Center

Align Vert. Center aligns the center of each selected objects with the center of the anchor object vertically. If no anchor object is selected, the highest selected object is used as an anchor.

Align Bottom

Align Bottom aligns the bottom of each selected object with the bottom of the anchor object. If no anchor object is selected, the lowest selected object is used as an anchor.

Make Same Size

Make Same Size submenu provides options for setting size of selected objects to be the same.

Width

Sets the width of each selected object to be the same as the width of the anchor object. If no anchor object is selected, the left most selected object is used as an anchor.

Height

Sets the height of each selected object to be the same as the height of the anchor object. If no anchor object is selected, the left most selected object is used as an anchor.

Both

Sets both the width and height of each selected object to be the same as the width and height of the anchor object. If no anchor object is selected, the left most selected object is used as an anchor.

Distribute

Distribute submenu provides options for distributing objects in the selected group, leaving no spaces between the objects.

Across

Distributes objects horizontally leaving no extra spaces between the object's extents.

Down

Distributes objects vertically leaving no extra spaces between the object's extents.

Space Evenly

Space Evenly submenu provides options for evenly distributing spaces between objects in the selected group.

Across

Distributes objects horizontally with equal spaces between the object's extents.

Down

Distributes objects vertically with equal spaces between the object's extents.

Distribute Evenly

Distribute Evenly submenu provides options for evenly distributing objects in the selected group using objects' centers.

Across

Distributes objects horizontally with equal distance between the objects' centers.

Down

Distributes objects vertically with equal distance between the objects' centers.

Select Anchor

Select Anchor defines the anchor object. Select this option, then click on the object with the mouse to define it to be the anchor. The anchor selection will be preserved until the currently selected group is unselected.

Align Points

When this toggle is checked, the objects' control points are used to align objects. If the toggle is unchecked, the objects' extents will be used.

Align To Viewport Span

When this toggle is checked, the viewport span is used as the drawing extent used to position the object. If the toggle is unchecked, the currently visible area of the viewport's window is used as the drawing extent.

For resizable viewports, the span is defined by the SpanX and SpanY attributes of the viewport's screen object. For fixed scale viewports, the span is the size of the viewport. By default, the span extent is annotated with a different color and span marks at the corners of the span.

For resizable viewports with stretch, as well as fixed scale viewports, the difference between the span and the current visible area is noticeable only when the viewport is zoomed or edited by using Hierarchy Down.

More

This option is equivalent to the Layout Toolbox option: it brings the Layout Toolbox for more alignment and layout options.

Object

The Object Menu provides options to let you create and manipulate objects within the drawing.

Create

The options under the Create option let you add new objects to the drawing.

Most of the options under the Create submenu correspond to the buttons in the Object Palette on the left side of the HMI Configurator window. You can create the object by choosing its type from this menu, or by clicking on the corresponding button in the palette.

If an object has an icon in the drawing primitives palette, the icon is shown next to the object description. If an icon is not displayed, the object may be created only by using the Object, Create main menu.

See Creating Objects for instructions on drawing objects.

Polygon

The Polygon options let you create the following kinds of polygons:

To create any type of polygon, click in the drawing to define the polygon's points, then click the right mouse button (or use the Escape key) to complete the polygon. For the closed and filled polygons, the HMI Configurator joins the first and last vertices, closing the polygon.

Rectangle

The Rectangle options let you create the following kinds of rectangles:

Although the GLG object set does not include a rectangle object, the Rectangle options are provided for convenience. Drawing a rectangle actually creates a parallelogram with perpendicular sides.

To create a rectangle, click on two points to define the diagonal corners of the rectangle.

Parallelogram

The Parallelogram options let you create the following kinds of parallelograms:

To create a parallelogram, click on one point, and then click on two other points. The second and third points define two vectors from the first point; they specify the angles and lengths of the opposing sides.

Rounded Rectangle

The Rounded Rectangle options let you create the following kinds of rectangles:

To create a rounded rectangle, click on two points to define the diagonal corners of the rectangle. It creates a parallelogram with perpendicular sides and rounded corners. The size of the rounded corners is controlled by the object's Radius1 and Radius2 attributes.

Arc

The Arc options let you create the following kinds of arcs:

An arc is a many-sided regular polygon, like a circle; however, an arc does not encompass 360. A simple arc is just the segment of a circle's perimeter connecting the points you choose. A chord arc closes the shape with a straight line from one end of the arc to the other. A segment arc closes the shape with two straight lines from each end of the arc to the center, like a wedge of pie.

To create any type of arc, click on the center point, a point to define the radius, and a point to define the angle of the sector.

You can convert an arc to a circle by editing its StartAngle or EndAngle attributes.

The control points of an arc or a circle are unusual for graphical objects. See the description of a circle (below) for an explanation.

Circle

The Circle options let you create the following kinds of circles:

A circle is a many-sided regular polygon. Its Resolution attribute specifies the number of sides used to render the circle. At low Resolution values, the shape no longer resembles a circle; for example, a circle with a Resolution of 5 is a pentagon.

To define a circle, click on the center point, then on a point to define the radius.

In GLG, both circles and arcs are rendered using an Arc object type. A circle is a special case of an arc with a StartAngle of 0 and an EndAngle of 360.

Circles and arcs have an arrangement of control points different from other graphical objects. Each circle has two control points that initially appear superimposed at the center of the circle. (The move point is moved slightly away from the center to avoid confusion.) The two points define a line to which the circle is perpendicular. The length of the line is ignored. This means that you can grab one of the control points, and tilt the circle by moving it. However, a circle has no control points on its perimeter for resizing it; to change its radius, change its Radius attribute or use the Resize Box.

The Control Points of a Circle
Ellipse

The Ellipse options let you create the following kinds of ellipses:

An ellipse is a rounded rectangle with rounded corners taking the whole extent of the rectangle. Its Resolution attribute specifies the number of segments used to render each corner of the ellipse. At low Resolution values, the shape no longer resembles an ellipse; for example, an ellipse with a Resolution of 2 is a hexagon.

To create an ellipse, click on two points to define the diagonal corners of the ellipse's bounding rectangle.

Spline

The Spline options let you create a multi-point spline used to render curves in 2D or 3D space:

To create a spline, click in the drawing area to define the number of spline control points, then click the middle or right mouse buttons (or use the Escape key) to complete the spline. The spline will render a smooth curve defined by the control points. The shape of the curve may be changed by moving the control points.

Marker

A marker is an object that indicates the position of a single point. Markers are made by selecting one or more shapes from a set of predefined shapes such as squares, crosses, and circles. Unlike other graphical objects, marker objects do not change their size when the viewport is resized.

To create a marker, select Object, Create, Marker and then specify the point.

Since markers are always drawn the same size, they are not affected by transformations. To change a marker's size, change its Size attribute.

Image

An image object may be used to display an image in the GIF or BMP (on Windows only) formats. The Image options let you create the following kinds of images:

To create an image, select the type of the image: fixed size or scalable, define its position (one control point for the fixed image and two points for the scalable image), and select the image file.

For images of fixed size, the Anchoring attribute may be used to control the image's position relative to its control point.

Text

The Text options let you create the following kinds of text objects:

A text object is a graphical object that presents a string. The text object itself just sets the boundaries of the text. The text object's data attribute defines the string that appears in the drawing.

GIS Object

A GIS Object provides a way to embed GIS maps generated with the GLG Map Server into GLG drawings. It automatically handles all aspects of the low-level interaction with the Map Server to display, zoom and pan GIS map data. The GIS Object provides attributes to control projection, center and extent of the map.

To create a GIS Object:

1. Select Object, Create, GIS Object and choose rectangular or orthographic projection to create the GIS Object.
2. Click on two points to define a rectangular area to use for the map display.
3. When prompted, select a dataset file that describes the GIS data to render.

The GIS Object will display the map specified by the dataset file. The map may be positioned by changing the GISCenter and GISExtent attributes of the object. The GIS Zoom mode of the drawing's Integrated Zoom feature may be used at run time to zoom and pan the map.

Connector

This option creates a connector object which may be used to connect other objects in the drawing. It is useful when connecting objects in a diagram drawing.

There are two types of connectors:

To create a connector, select the connector type, then click in the drawing to define its shape. For the arc connector, select 3 points to define the arc. For the recta-linear connector, select any number of points to define one or more recta-linear segments and press the Escape key or the middle mouse button to finish.

Edit Toolbox

This option activates the Edit Toolbox for fast access to the selected objects' properties. Refer to the Editing Objects with the Edit Toolbox section on page 19 for more information.

Properties

Properties displays a dialog that lists the attributes of the selected object and provides access to their dynamics, alarms and tags.

Public Properties

Public Properties display a dialog that lists user-defined public properties of a component.

Resources

Resources displays a Resource Browser that shows resources of the selected object. If no object is selected, resources of the whole drawing (at the current level of the hierarchy) are shown. Selecting a different object updates the Resource Browser to display the object's resources.

Tags

Tags brings a Tag Browser that shows a list of tags of the selected object, or of the whole drawing if no object is selected. Selecting a different object updates the Tag Browser to display the object's tags.

Alarms

Alarms brings an AlarmBrowser that shows a list of alarms attached to the selected object or all alarms of the whole drawing if no object is selected. Selecting a different object updates the Alarm Browser to display the object's alarms.

Object Dynamics

The Object Dynamics menu contains options for adding and editing geometrical dynamics (such as move, scale or rotate) attached to the object.

Add Dynamics

Add Dynamics adds geometrical dynamics (such as move, scale or rotate) to the selected object. Selecting the option displays a menu of available dynamics types.

Refer to Adding Geometrical Dynamics on page 31 for details.

Edit Dynamics

Edit Dynamics brings the dialog for editing geometrical dynamics attached to the object.

Tooltip

The Tooltip menu contains options for adding and editing object tooltips.

Add Tooltip

Add Tooltip attaches a tooltip action to the selected object and opens the action's Properties dialog for entering the tooltip string as a value of the action's Tooltip attribute.

To activate tooltip processing, the ProcessMouse attribute of the viewport containing the object has to include the Tooltip mask. The Run mode of the Builder may be used to test the tooltips.

Edit Tooltip

Edit Tooltip opens the Properties dialog for editing the tooltip action attached to the selected object.

Delete Tooltip

Delete Tooltip deletes a tooltip action attached to the selected object.

Actions

The Actions submenu provides options for adding and editing actions and commands attached to objects in the drawing.

Add Command

Add Command attaches a command action to the selected object. It prompts the user to select a type of command from a list of available commands, then opens a dialog for specifying values of the command's data properties.

The Back button may be used to return to the action's Properties dialog after the command data has been entered. The action properties specify the event that triggers the command's execution. Refer to Action Object on page 198 for more information.

Add Input Command

Add Input Command attaches an input command action to the selected input object. It uses the same user interface as the Add Command option described above, but is active only when an input object, such as a button, a toggle or a slider, is selected.

Edit Actions

Edit Actions opens an Action List dialog for editing actions attached to the selected object. The dialog provides an interface for editing attributes, reordering or deleting individual actions. Refer to Action Object on page 198 for more information.

The Actions button in the Status Panel at the bottom of the drawing area may be used as a shortcut.

Delete All Actions

Delete All Actions deletes all actions attached to the selected object. To delete individual actions, use the Edit Actions option, select an action to be deleted, then press the Delete button.

Mark Actions

Mark Actions stores a copy of the selected object's actions in the clipboard to subsequently add them to other objects in the drawing. To select individual actions instead of the list of all actions attached to the object, use the Copy button in the action's Properties dialog.

Paste Actions

Add Marked Actions adds a copy of the previously marked actions to the selected object.

Run

The Run menu provides options to let you test the animation of drawings.

Start

Start starts the Run mode.

Start also displays a dialog for entering an animation command.

Refer to the Prototyping Dynamic Behavior Using Run Mode on page 43 for information on animation commands and using live data to animate.

In the Run mode, the Builder activates the Run Toolbar that contains the following controls:

Stop

Stop halts the Run mode.

Options

The Options Menu provides options to let you customize the operation of the HMI Configurator. The glg_hmi_config configuration file can be used to specify default values of various options.

Draw Grid

The Draw Grid submenu provides options to let you display grid lines with a drawing. The grid is displayed at a selected grid interval. In addition to the constant grid spacing options, the Adaptive (Constant Space) option automatically selects a grid interval to maintain approximately constant visual grid spacing. To disable grid, use the No Grid option.

The grid is not saved as part of the drawing. It is just a convenience for editing a drawing.

To position objects relative to the grid, use Options, Snap To, Grid.

Snap To

The Snap To submenu provides options to let you align objects. Snapping places objects by rounding their coordinates as you draw them.

The options on the Snap To submenu specify the resolution of the alignment grid. If you specify Snap to Grid, the HMI Configurator snaps to the grid and also to the midpoints of the grid. The 0 (No snapping) option is used to disable snapping, and 1 (Round to integer) option is used to get rid of the fractional coordinate values, which is almost the same as no snapping, but with integer coordinates.

Show Axis

Show Axis shows or hides the axis icon. The axis icon indicates the center and orientation of the current view and coordinate system.

To change the view projection and the coordinate system used to view the drawing, use the options on the View menu.

Show Coordinates

Show Coordinates shows or hides the mouse coordinate display window in the lower right corner of the HMI Configurator. Both the screen (S) and world (W) coordinates are displayed.

Show Span

Span Marks

Shows or hides red markers that display the extent of the drawing area in the unzoomed state.

Span Area

Enables or disables a color annotation of the extent of the drawing area in the unzoomed state.

Save Format

Save Format determines the format the HMI Configurator uses to save a drawing to a file. The HMI Configurator can save files in two formats:

The default format for the saved drawing is ASCII. This is the recommended format that works not only across all hardware platforms, but also across all GLG deployment options: C/C++, Java, C# and JavaScript.

Save Compressed

Save Compressed enables or disables saved drawing compression. When the drawing compression is enabled, drawings are saved using gzip-compression. The saved file extension is not changed when the drawing is saved compressed. This option controls only saving operations: on loading, the drawing format is recognized and handled automatically.

The default is Save Compressed.

SaveImageFormat

SaveImage Format specifies the image format to use when saving images via the Save Image menu option. Supported formats are JPEG and PNG.

Convert Strings to UTF8 on Save

When this option is checked, all string attributes (such as TextString of a text object) are automatically converted from the current locale to UTF8 when the drawing is saved. This is especially convenient when using localized strings on Windows in a drawing that will be used on the web with the JavaScript. JavaScript supports a limited number of character sets, using UTF8 as a default character set, while the UTF8 system locale is not supported on Windows. The Convert Strings to UTF8 on Save option provides a convenient way to save the drawing in the UTF8 locale without a need to use external converters.

The Arrange, UTF8 Conversions menu provides options for converting all strings in the drawing from the current locale to UTF8 and from UTF8 to the current locale. These options may be used to verify the converted drawing before saving it.

When a string attribute is converted to UTF8, its UTF8Encoding flag is set to YES.

Selection Options

Show Attachment Points

Enables or disables display of attachment points of the selected reference object.

Disable Dynamics For Editing

Disable Dynamics For Editing disables geometrical dynamics (such as move, scale or rotate) when the object is selected. When the option is set, the object will appear in its untransformed state with dynamics disabled. This is convenient for editing objects in the object's initial state.

The option disables only the geometrical dynamics attached to the object. It does not disable dynamics attached to the object's control points.

Select Non-Components

Select Non-Components modifies the behavior of the Select All option: if Select Non-Components is set, Select All selects only objects that do not have public properties defined (non-component objects).

Trace / Highlight

Trace Tags

When activated, Trace Tags highlights all objects in the drawing that depend on a tag selected in a Tag Browser.

Trace Resources & Constraints

When activated, Trace Resources & Constraints highlights all objects in the drawing that depend on a resource selected in a Resource Browser or an attribute displayed in the Attribute Object dialog.

Highlight Widgets

Controls tracing behavior. If Highlight Widgets is unchecked, the first found drawable parent of the traced object will be highlighted. If it is checked, the parent that has the IsWidget resource will be highlighted.

Highlight Top Level Objects

Controls tracing behavior. If Highlight Top Level Objects is unchecked, the first found drawable parent of the traced object will be highlighted. If it is checked, the parent that is a direct child of the Drawing Area that has editing focus will be highlighted.

Magnetic Control Points

Controls the Magnetic Mode.

Attach to Point

Attaches a new point to the highlighted point selected with the mouse click.

Use Point Position

Positions a new point at the position of the highlighted point selected with the mouse click.

Disable

Disables Magnetic Mode. A new point will be positioned at the exact mouse click position without attaching the new point to any points in the vicinity of the click.

Color Options

Swap Color Palettes

Swap Color Palettes toggles the displayed color palette between the default color palette and custom color palette.

255 Color Display

255 Color Display toggles the range of the color RGB values between the default [0;1] range and the [0;255] range familiar to the Windows users. The color display range changes only the color RGB display in the HMI Configurator. The run-time color RGB values and the values saved in the drawing still use the default [0;1] range.

Dynamics Options

Treat Dynamics as Global on Copy

Treat Dynamics as Global on Copy controls the way the dynamics is copied. If the option is set, the dynamics' parameters such as color and threshold lists are treated as global when the object the dynamics is attached to is copied and may be changed in one place for all object copies. The option also controls copying dynamics using the dynamics' Copy and Paste Dynamics options.

Advanced Dynamics Display

Advance Dynamics Display controls the way dynamics are displayed. If the option is not checked (default), the Edit Dynamics dialog displays public properties of predefined dynamics for convenient editing. If the option is checked, the dialog displays all attributes of the dynamics for advanced editing. By default, this option is disabled in the glg_hmi_config file.

Refer to Transformation Object on page 167 of the GLG User's Guide and Builder Reference Manual for information on dynamics' attributes.

Data Browser Options

Browse Tag Names
Browse Tag Sources

Control the usage of the Data Browser. If Browse Tag Sources is selected, the tag string selected in the Data Browser is assigned to the TagSource attribute of the tag being edited, otherwise it is assigned to the tag's TagName attribute.

Appearance

Scrollbars

Scrollbars shows or hides the scrollbars in the GLG HMI Configurator window.

Toolbar

Toolbar shows or hides the toolbar at the top of the GLG HMI Configurator window.

Force File Extensions

If checked, automatically adds ".g" extension when saving drawings if a specified filename has no extension.

Display OpenGL Info

This option displays diagnostic information about the status of the OpenGL driver. If the driver has been successfully initialized, it also displays the OpenGL renderer and vendor information to assist in troubleshooting the OpenGL driver setup problems.

The -verbose command-line option may be used to display extended diagnostic information on Linux/Unix, or to record the information in the glg_error.log file on Windows.

Help

Online Reference

On Windows, Online Reference starts a browser with the GLG Online Documentation page. On Linux/Unix, it displays a dialog with information on how to access GLG Documentation.

About GLG Toolkit

About GLG Toolkit displays a dialog with the GLG Toolkit version information.


Generic Logic, Inc.
www.genlogic.com
PREV NEXT