Getting Started
with SCADE Display
Contacts
Legal Contact
Technical Support
Legal Information
Copyrights 2002-2012 Esterel Technologies.
SCADE System, SCADE LifeCycle, SCADE Suite, SCADE Display, and SCADE are registered trademarks of Esterel
Technologies. All rights reserved.
Getting Started with SCADE Display Copyright Esterel Technologies - Published November 2013.
Terms of Use
Important! Read carefully before starting this software and referring to its user documentation. This publication, as well
as the software it describes, is distributed as part of the SCADE Display user documentation under license and may be used
or copied only in accordance with the terms and conditions of the Software License Agreement (SLA) accepted during
SCADE Display products installation. Except as permitted by the SLA, the content of this publication cannot be reproduced,
stored, or transmitted in any form or by any means, electronic, mechanical, recording, or otherwise, without the prior
permission of Esterel Technologies SAS. Any existing artwork or images that you may want to reuse in your projects may
be protected under copyright law. The unauthorized use of such material into your own work may constitute a violation of
Esterel Technologies copyrights. If needed, make sure your obtain the written permission from Esterel Technologies. By
starting the software you expressly agree to the following conditions:
Property: This software is and remains the exclusive property of Esterel Technologies SAS. It cannot be copied or
distributed without written authorization from Esterel Technologies SAS. Esterel Technologies SAS retains title and
ownership of the software.
Warranty: The software is provided, as is, without warranty of any kind. Esterel Technologies SAS does not
guarantee the use, or the results from the use, of this software. All risk associated with usage results and
performance is assumed by you the user.
Documentation Disclaimer
The content of the SCADE Solutions for ARINC 661 user documentation is distributed for informational use only, is subject
to change without notice, and should not be construed as a commitment by Esterel Technologies SAS. Although every
precaution has been taken to prepare this manual, Esterel Technologies assumes no responsibility or liability for any errors
that may be contained in this book or any damages resulting from the use of the information contained herein.
Copyright 2012, Oracle and/or its affiliates. All rights reserved. Oracle and Java are registered trademarks of
Oracle and/or its affiliates.
Portions of this software are copyright 2007 The FreeType Project (www.freetype.org). All rights reserved.
Caml 1996-2006 INRIA, licensed by Esterel Technologies. SCADE Solutions for ARINC 661 integrate all or parts of
run-time Caml developed by INRIA and its partners.
DISCLAIMER: THIS SOFTWARE IS PROVIDED BY INRIA AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED
WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INRIA OR ITS CONTRIBUTORS BE LIABLE FOR
ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Shipping date: 15/11/13
RELATED DOCUMENTS
OVERVIEW
This manual walks you through the basics of
specification creation with SCADE Display. The
document is divided into the following chapters:
Chapter 1: Introduction
This chapter guides your first steps into the SCADE
Display environment and workflow.
Chapter 2: Creating Counter
This chapter walks you through a set of exercises
that teaches you how to create a basic display
specification.
Chapter 3: Creating Reusable Object
This chapter walks you through a set of exercises
that teaches how to create a reusable object.
Chapter 4: Reusing Counter Object
This chapter walks you through a set of exercises
that teaches how to reuse an object previously
created.
Chapter 5: Adding Interaction to Counter
This chapter teaches you how to add an interactive
object to the existing counter object. It consists of
creating a button with On/Off positions to turn on
and off the counter. It also shows how to simulate
the final counter with SCADE Suite Simulator.
Italics
Courier
New
Title Case
UPPERCASE
File formats
Table of Contents
Getting Started Overview
List of Figures
1. Introduction
1-1
1-1
1-3
1-5
Documentation Set
1-5
1-5
1-6
2. Creating Counter
2-7
Starting to Specify
2-7
Exercise 2.1:
Exercise 2.2:
2-8
2 - 11
2 - 13
Exercise 2.3:
2 - 14
Exercise 2.4:
2 - 15
Exercise 2.5:
2 - 18
Exercise 2.6:
2 - 20
Exercise 2.7:
Replicating Objects
2 - 20
Exercise 2.8:
Grouping Objects
2 - 23
Exercise 2.9:
Naming Objects
2 - 25
2 - 26
2 - 27
2 - 30
2 - 31
2 - 32
2 - 35
Table of Contents
Drawing the Label
2 - 38
2 - 39
2 - 42
2 - 43
2 - 44
2 - 44
2 - 46
3 - 49
3 - 49
3 - 50
3 - 51
3 - 52
3 - 54
3 - 55
3 - 58
3 - 58
3 - 60
3 - 60
3 - 61
4 - 63
4 - 63
4 - 63
4 - 64
4 - 64
4 - 66
Esterel Technologies
ii
3 - 49
4 - 67
Table of Contents
Exercise 4.30: Instantiating the Hertz Counter
4 - 67
4 - 68
4 - 69
4 - 69
4 - 71
4 - 71
4 - 72
5 - 73
5 - 73
5 - 74
5 - 80
5 - 83
5 - 83
5 - 85
5 - 85
5 - 87
5 - 87
5 - 91
List of Figures
Figure 1.1:
1-1
Figure 1.2:
1-3
Figure 2.1:
2-8
Figure 2.2:
Figure 2.3:
2-9
2 - 10
Figure 2.4:
2 - 11
Figure 2.5:
2 - 12
Figure 2.6:
2 - 14
Figure 2.7:
2 - 15
Figure 2.8:
2 - 16
Figure 2.9:
2 - 17
Figure 2.10:
Drawn arc
2 - 17
Figure 2.11:
2 - 18
Figure 2.12:
Properties tab
2 - 18
Figure 2.13:
Dimensioned arc
2 - 19
Figure 2.14:
2 - 21
Figure 2.15:
2 - 21
Figure 2.16:
2 - 22
Figure 2.17:
Graduated arc
2 - 22
Figure 2.18:
Selecting objects
2 - 23
Figure 2.19:
Objects grouping
2 - 24
Figure 2.20:
Graduations selection
2 - 25
Figure 2.21:
2 - 25
Figure 2.22:
Group naming
2 - 26
Figure 2.23:
2 - 27
Figure 2.24:
2 - 28
Figure 2.25:
2 - 29
Figure 2.26:
2 - 30
Figure 2.27:
2 - 30
Figure 2.28:
2 - 31
Figure 2.29:
Needle shape
2 - 32
Figure 2.30:
2 - 33
Figure 2.31:
2 - 34
Figure 2.32:
2 - 34
Figure 2.33:
2 - 36
List of Figures
Figure 2.34:
2 - 36
Figure 2.35:
2 - 37
Figure 2.36:
Name changing
2 - 38
Figure 2.37:
2 - 39
Figure 2.38:
2 - 40
Figure 2.39:
2 - 41
Figure 2.40:
2 - 42
Figure 2.41:
2 - 42
Figure 2.42:
2 - 43
Figure 2.43:
Animation panel
2 - 45
Figure 2.44:
2 - 46
Figure 3.45:
3 - 50
Figure 3.46:
3 - 52
Figure 3.47:
3 - 53
Figure 3.48:
3 - 53
Figure 3.49:
3 - 55
Figure 3.50:
3 - 56
Figure 3.51:
Structure tree
3 - 57
Figure 3.52:
3 - 59
Figure 3.53:
Top-level container
3 - 61
Figure 4.54:
4 - 65
Figure 4.55:
4 - 65
Figure 4.56:
4 - 66
Figure 4.57:
4 - 68
Figure 4.58:
Animation panel
4 - 69
Figure 4.59:
4 - 70
Figure 4.60:
4 - 71
Figure 4.61:
4 - 72
Figure 5.62:
5 - 74
Figure 5.63:
5 - 75
Figure 5.64:
5 - 75
Figure 5.65:
5 - 76
Figure 5.66:
5 - 77
Figure 5.67:
5 - 78
Figure 5.68:
5 - 79
Esterel Technologies
vi
List of Figures
Figure 5.69:
5 - 79
Figure 5.70:
5 - 81
Figure 5.71:
5 - 82
Figure 5.72:
5 - 84
Figure 5.73:
5 - 86
Figure 5.74:
5 - 87
Figure 5.75:
5 - 88
Figure 5.76:
5 - 89
Figure 5.77:
5 - 90
Figure 5.78:
5 - 91
Figure 5.79:
5 - 92
Introduction
This chapter is intended as an overview of SCADE Displays features and
workflow.
Before starting any exercise, please read through the following sections:
Purpose and Organization of this Manual
Presenting SCADE Display User Interface
Documentation and Online Help
Introduction: 1
Purpose and Organization of this Manual
Esterel Technologies
1-2
Introduction: 1
Presenting SCADE Display User Interface
The SCADE Display GUI contains the following areas and toolbars:
1 The Visualization area is a large area in which you draw the specification.
2 The toolbars above the Visualization area give access to various features like loading
or saving files, editing, getting contextual help, and to features allowing to transform
the objects of the specification (aligning, rotating, managing control points, etc.).
Introduction: 1
Presenting SCADE Display User Interface
3 Left of the Visualization area, the Object Palette provides objects that can be drawn in
objects.
6 The Status bar displays information depending on the current SCADE Display use
context.
Note
Most of these features are also available from the Menu bar.
For more information about SCADE Display GUI, see Chapter 2 about Discovering
SCADE Display User Interface from SCADE Display User Manual.
You may now continue with the features and exercises related to Creating Counter.
Esterel Technologies
1-4
Introduction: 1
Documentation and Online Help
Documentation Set
The product documentation set is composed of the following documents:
Release Notes
Manuals and Guidelines about SCADE Display tool
Online Help integrated in the SCADE Display application
Release Notes, Manuals and Guidelines can be opened as explained in Accessing SCADE
Display PDF Manuals.
Manuals and Guidelines are available in HTML format through the SCADE Display online help as explained in Accessing SCADE Display Online Help.
Introduction: 1
Documentation and Online Help
Button
Hide/Show
Back/Forward
Home
Font
3 On the welcoming page, click on the SCADE Display logo to access the list of help
resources available. Alternatively, look into the Contents tab on the left and double
click the SCADE Display Help Resources book to expand the list of help resources.
4 Navigate in the HTML pages with the following navigation elements:
Esterel Technologies
1-6
Creating Counter
This chapter teaches you how to create a counter. You will create the
graduations, the counter areas, the needle, and a label indicating a value of the
needle.
Learn the basics of graphical specification with SCADE Display in:
Starting to Specify
Drawing the Background of the Counter
Drawing Needle Areas
Drawing the Needle
Drawing the Label
Animating Display Specification
Starting to Specify
This section shows you how to launch a SCADE Display session and create a new blank
specification from a SCADE Display predefined template.
CONCEPTS
Creating Counter: 2
Starting to Specify
Exercise 2.1:
This exercise explains how you can launch the SCADE Display application.
To run SCADE Display
open the Windows Start menu and select the SCADE Display application.
The SCADE Display splash screen appears until the end of the initialization stage.
At the end of the initialization stage, the SCADE Display window opens up.
By default, the SCADE Display window displays a startup page providing access to the
Welcome pages of all SCADE products.
Esterel Technologies
2-8
Creating Counter: 2
Starting to Specify
Creating Counter: 2
Starting to Specify
The SCADE Display Welcome page contains get started information and useful links to
project management, documentation, distributed models, or customer support contacts.
You can now continue with Exercise 2.2: Creating New Specification.
Esterel Technologies
2 - 10
Creating Counter: 2
Starting to Specify
Exercise 2.2:
This exercise shows you how to create a new specification from a predefined template.
To create a blank specification
1 Click New
from the File toolbar or select the File > New menu.
Creating Counter: 2
Starting to Specify
5 Set the main window into full screen by clicking the Windows Maximize
button.
1 Click Save
2 In the pop-up window, type Counter.sgfx in the File name field and browse for
folder location.
3 Click Save to save the specification.
For more information about specifications, see Chapter 3 about Working with
Specifications and Layers from SCADE Display User Manual.
Esterel Technologies
2 - 12
Creating Counter: 2
Drawing the Background of the Counter
For more information about the SCADE Display General User Interface, see Chapter 2
about Discovering SCADE Display User Interface.
Tip
If you need help to understand the graphics terms used in this manual, consult the
SCADE Products Glossary from the Help menu by opening Manuals in PDF
Documentation.
Now, you can continue with Drawing the Background of the Counter on page 13.
Creating Counter: 2
Drawing the Background of the Counter
This exercise shows you how you can define the graphical attributes of an object before or
after drawing it.
To select the attributes of the first object
1 In the Object Attributes area (see Figure 2.6), click Outline color
to open an
2 Select a white
3 Click Filling Color
4 Click Line Width
Esterel Technologies
2 - 14
color.
and select No Fill from the filling color chooser.
drop-down list.
Creating Counter: 2
Drawing the Background of the Counter
For more information about the Object Attributes area, see Object Attributes Area on
page 54 from SCADE Display User Manual.
For more information about object attributes, see Editing Objects Graphical Attributes on
page 117.
Now, you can continue with Drawing the First Arc.
Exercise 2.4:
The Object Palette contains several tabs that allow you to select the type of object you
want to draw. The Primitives tab contains the basic primitives available in SCADE
Display.
To draw the first arc
Creating Counter: 2
Drawing the Background of the Counter
2 Click once on the center of the Visualization area (where the two red dashed lines
Esterel Technologies
2 - 16
Creating Counter: 2
Drawing the Background of the Counter
3 Click then on the middle of the upper-right quarter of the Visualization area to set the
radius of the arc and its start point, as show on Figure 2.10.
4 Click on the middle of the lower-left quarter to set the arc end point.
In SCADE Display, you will handle all the objects the same way.
For more information about the Visualization area, see Visualization Area on page 18
from SCADE Display User Manual.
For more information about primitives, see section Drawing Primitives on page 156.
Getting Started with SCADE Display
2 - 17
Creating Counter: 2
Drawing the Background of the Counter
Exercise 2.5:
You have created an arc but its parameters have been roughly set through mouse
positioning. In the Visualization area, you can notice that the control points of the arc are
displayed. It indicates that the object is selected. You can now set more precisely its
properties.
Note
You can set an objects properties only once it is drawn, not before.
Esterel Technologies
2 - 18
Creating Counter: 2
Drawing the Background of the Counter
2 In the View property, click the drop-down list and select the From center value.
3 Next to the Center property, do the following to set its value:
set its horizontal coordinate by entering 0 in the first numerical field and press
Enter to validate,
set its vertical coordinate by entering 0 in the second numerical field and press
Enter to validate.
4 Set the value of the other properties in the same way:
Radius to 100,
Start angle to 45,
End angle to 225.
Tip
When setting control points from the objects properties, it is highlighted with a red
square in the visualization area, allowing to quickly identify which point is being edited.
For more information about the Properties tab, see Properties Panel on page 72 from
SCADE Display User Manual.
For more information about object properties, see About Properties Types on page 134.
Now, you can continue with Exercise 2.6: Setting the Grid Options.
Creating Counter: 2
Drawing the Background of the Counter
Exercise 2.6:
You can access the grid options from the Grid toolbar. The grid allows positioning
primitives precisely through mouse positioning thanks to the grid attraction. This feature
is based on a virtual grid that attracts the mouse so that points handled through the mouse
are positioned exactly on the nearest grid nodes.
To set the Snap to Grid feature
Replicating Objects
Now, you have to draw the graduations of the counter. But rather than drawing each
graduation along the arc, you can draw only one graduation and then replicate it.
To draw the first graduation
2 In the Visualization area, click once on the upper point of the arc.
3 Click on the first grid point below the previous point.
4 Right-click to finish the broken line.
Esterel Technologies
2 - 20
Creating Counter: 2
Drawing the Background of the Counter
For more information about the Broken Line primitive, see section Drawing Line on
page 161 from SCADE Display User Manual.
Now, you can replicate the graduation you have just drawn. Its control points should be
displayed. If not, click on the graduation to select it.
To replicate the graduation
Creating Counter: 2
Drawing the Background of the Counter
For more information about replication, see Replicating Operations on page 295 from
SCADE Display User Manual.
Esterel Technologies
2 - 22
Creating Counter: 2
Drawing the Background of the Counter
Exercise 2.8:
Grouping Objects
Grouping objects consists of setting objects as children of a basic container. You will
create a first group containing the objects forming the counter contour and a second group
containing the graduations.
To group the counter contour
The three items are now selected. Figure 2.18 describes the selected objects in the
Visualization area and in the Structure tree:
4 Click Group
Creating Counter: 2
Drawing the Background of the Counter
For more information about the Group toolbar, see Group Toolbar on page 47 from
SCADE Display User Manual.
For more information about the Structure tree, see Structure Panel on page 55.
For more information about grouping, see Grouping Objects on page 270.
Now, you can group the graduations.
To group the graduations
Esterel Technologies
2 - 24
Creating Counter: 2
Drawing the Background of the Counter
3 Click Group
Naming Objects
In this exercise, you will rename the objects through the Structure tree.
To name the groups
1 Select the first group item of the Structure tree and press F2 to enable an editable
text-field.
2 Type Counter contour.
3 Press Enter to validate the new name.
Creating Counter: 2
Drawing Needle Areas
4 Repeat steps 1-3 with the other group item and name it Graduations.
For more information about the naming objects, see Grouping Objects on page 270 from
SCADE Display User Manual.
Now, you can continue with Drawing Needle Areas.
Duplicate objects
Bring objects to front
You will learn how to draw the needle areas in these exercises:
Exercise 2.10: Duplicating Objects
Exercise 2.11: Arranging Objects
Esterel Technologies
2 - 26
Creating Counter: 2
Drawing Needle Areas
Exercise 2.10:
Duplicating Objects
Now, you will draw the needle areas of the counter. As for the graduations, you can draw
a first needle area and then duplicate it as many times as you need.
To set the first needle area attributes
1 Click on the background of the Visualization area (i.e. on an area where no object is
color.
1 Click once in the center of the Visualization area to set the crown center.
2 Click near the upper end of the arc to set the crown start point.
3 Click near this point, but closer to the center to define the crown thickness.
4 Click on the lower end of the arc to define the crown end point.
Creating Counter: 2
Drawing Needle Areas
Finally, set more precisely the properties of the crown in the Properties tab.
To set the first needle area properties
For more information about the crown primitive, see Drawing Crown on page 176 from
SCADE Display User Manual.
You can now duplicate the crown in order to draw the other needle areas. Select the crown
if it is not already selected.
To duplicate the first needle area
Esterel Technologies
2 - 28
Creating Counter: 2
Drawing Needle Areas
You can duplicate the second crown to create the third needle area.
To draw the third needle area
Creating Counter: 2
Drawing Needle Areas
For more information about duplicating primitives, see Basic Editing Features on page
292 from SCADE Display User Manual.
Now, you can continue with Exercise 2.11: Arranging Objects.
Exercise 2.11:
Arranging Objects
Arranging objects consists of changing their drawing order. Currently, the needle areas
hide the counter outline. This exercise shows you how to bring the counter outline to front
to make it visible.
To bring the counter outline over the three needle areas
In the Visualization area, the counter contour is now visible as shown in the figure below.
Esterel Technologies
2 - 30
Creating Counter: 2
Drawing the Needle
Figure 2.28: Bringing the counter outline over the needle areas
Creating Counter: 2
Drawing the Needle
Exercise 2.12:
This exercise shows you how to draw a shape and define its rotation.
To set the needle shape attributes
to set it off.
to switch it on:
1 Click in lower left side of the center of the Visualization area to draw the lower left
Esterel Technologies
2 - 32
Creating Counter: 2
Drawing the Needle
Finally, set more precisely the needle properties in the Properties tab.
To set the needle properties
For more information about the Polygon Smooth feature, see Defining polygon smooth on
objects on page 122 from SCADE Display User Manual.
For more information about the Shape primitive, see Drawing Shape on page 183.
To define the needle rotation
3 Click the Containers tab in the Object Palette, and select Rotation Group
Creating Counter: 2
Drawing the Needle
4 Click once in the center of the Visualization area to set the container origin.
5 Click on the middle of the upper right quarter of the Visualization area to position the
angle is 90. The rotation container created contains now the needle.
Finally set more precisely the properties of the rotation container in the Properties tab.
Esterel Technologies
2 - 34
Creating Counter: 2
Drawing the Needle
1 Set the rotation container Origin to 0 and 0 and the Reference angle to 90.
Note
The reference angle defines the reference axis with respect to the container origin. The
reference axis is associated with the needle shape current position and is rotated:
on the start axis (defined by the start angle) when the computed functional value is
equal to its associated value,
on the end axis (defined by the end angle) when the computed functional value is
equal to its associated value.
Plugging Needle
This exercise teaches you how to associate the Needle with a variable so that the
representation of the Needle changes according to the value of this variable.
To plug the needle angle
1 If the rotation container is not already selected, select the rotate group item in the
Structure tree.
2 Select the Plugs tab in the Object Information area.
3 Click in the Functional value text-field and type value.
Creating Counter: 2
Drawing the Needle
At this time, the plug is displayed in red meaning that the type variable is not valid.
Indeed, the value variable must be declared in the Variable Dictionary for the plug
(i.e., the association of the rotation container with the value variable) to be valid.
Esterel Technologies
2 - 36
Creating Counter: 2
Drawing the Needle
The line is now displayed in blue meaning that the plug is valid.
6 Click onto the Properties tab to display the object properties again.
The needle is thus configured to rotate according to the value of the value variable.
For more information about plugging, see Plugging Objects Properties to Variables on
page 147 from SCADE Display User Manual.
For more information about rotation container plugging, see Drawing Rotation Group on
page 224.
To change the name of the needle rotation container
1 In the Structure tree, double-click on the rotate group item to open an editable text-
field.
2 Type Needle and press Enter to validate.
Creating Counter: 2
Drawing the Label
3 Click Save
Draw text
Align objects
Reuse an existing plug variable
You will learn how to draw the label in these exercises:
Exercise 2.14: Drawing the Label
Exercise 2.15: Aligning Objects
Exercise 2.16: Plugging Label Value
Esterel Technologies
2 - 38
Creating Counter: 2
Drawing the Label
Exercise 2.14:
This exercise shows you how to draw a label with a value and a unit. Then you will learn
how to reuse an existing variable and plug the label and the needle to the same variable.
To draw the label contour
1 Deselect all the objects by clicking in an empty space in the Visualization area.
2 Switch the Snap to Grid
feature off.
7 Click on the lower-right quarter of the Visualization area to draw the upper-left point
of the rectangle.
8 Move the mouse cursor and click to draw its lower-right point.
Creating Counter: 2
Drawing the Label
For more information about the rectangle primitive, see Drawing Rectangle on page 180
from SCADE Display User Manual.
To draw the value label
1 Deselect all.
2 Select Font T4
7 Click on the middle of the right side of the rectangle contour in the Visualization area
Esterel Technologies
2 - 40
Creating Counter: 2
Drawing the Label
For more information about text-related attributes, see Defining Text-Based Attributes on
page 132 from SCADE Display User Manual.
For more information about the bi-font primitive, see Drawing Bi-font on page 197.
To draw the unit label
1 Deselect all.
2 Select a blue outline color
3 Select
.
.
7 Click on the middle of the right side of the rectangle contour in the Visualization area
Creating Counter: 2
Drawing the Label
For more information about the Text primitive, see Drawing Text on page 191 from
SCADE Display User Manual.
Exercise 2.15:
Aligning Objects
This exercise shows you how to align the value, the unit and the contour.
To align the value, the unit and the contour
1 Click (and maintain the mouse button clicked) on the upper left side of the label
Figure 2.41.
Esterel Technologies
2 - 42
Creating Counter: 2
Drawing the Label
This exercise teaches you how to reuse the existing value variable to plug the Label
value.
To plug the label value
Creating Counter: 2
Animating Display Specification
The plug is valid as the value variable is already declared with the correct parameters
in the Variable Dictionary.
3 Click Save
As the needle, the counter value is now configured to change according to the value
variable.
Now, you can continue with Animating Display Specification.
Before launching the animation, you have to define the scenario through the Animation
panel.
To define the animation scenario
Tip
You can also click the Animation tab in the General Information area to shift to
animation mode.
Esterel Technologies
2 - 44
Creating Counter: 2
Animating Display Specification
Now, you can continue with Exercise 2.18: Launching Specification Animation.
Creating Counter: 2
Animating Display Specification
Exercise 2.18:
Now that the scenario is defined, you can launch the animation of the specification.
To launch the animation of the specification
1 Click Play
As the animation runs, you can see that the needle and the counter are animated
according to the values of the value variable.
2 Click Stop
Esterel Technologies
2 - 46
Creating Counter: 2
Animating Display Specification
Click on Stop
When you quit the animation mode, you shift back to the editing mode.
You have designed a complete functional counter that may be used to display information.
For more information about the animation graphical interface, see Animation Panel on
page 67 from SCADE Display User Manual.
For more information about the animation itself, see Animating Model Design on page
366.
Now, you can continue with Creating Danger and Nominal Parameters.
Esterel Technologies
3 - 50
Exercise 3.20:
To create the Danger parameter and the Nominal parameter, you have to modify the
representation of their areas and group these two areas in the same container.
To modify the representation of the Danger area
Clipping Areas
You can use clipping masks to hide a part of the display object.
To clip the areas
1 Select the Danger item in the Structure tree to set the created group as the current
context.
As you can notice, only the Danger area and the Nominal area are now visible in the
Visualization area (however, the Danger area is invisible since hidden, or actually
drawn behind the Nominal area). This is because you are in the created group context
(highlighted in green).
When you select an object (highlighted in light blue in the Structure tree), you
automatically set the container that contains that object as the current context
(highlighted in green) and only the objects contained in that container are visible in the
Visualization area.
2 Select the Masks tab in the Object Palette.
Esterel Technologies
3 - 52
4 Click on the middle of the upper right quarter of the Visualization area to position the
For more information about clip-planes, see Drawing Clip Plane on page 205 from
SCADE Display User Manual.
Now, you can continue with Exercise 3.22: Rotating and Plugging the Danger Area.
Exercise 3.22:
Configure and plug the Danger area so that it rotates according to the value of the variable
it is connected to.
To rotate the danger area
4 Click on the middle of the upper right quarter of the Visualization area to position the
rotation start axis so that its angle is 45 (use the grid to do so).
5 Click twice on the middle of the lower left quarter of the Visualization area to position
the rotation end axis and the rotation reference axis so that their angles are 225 (use
the grid to do so).
6 In the Properties tab, set:
Esterel Technologies
3 - 54
automatically.
6 Select the Properties tab to display the properties again.
The Danger area is thus configured to rotate according to the value of the danger
variable.
Now, you can continue with Exercise 3.23: Rotating and Plugging the Nominal Area.
Exercise 3.23:
As in the previous exercise, configure and plug the Nominal area so that it rotates
according to the value of the variable it is connected to.
To rotate the nominal area
3 Click in the upper right part of the Visualization area to position the rotation start axis
axis and the rotation reference axis so that their angles are 225 (use the grid to do so).
5 In the Properties tab, set:
Reference angle to 45
Angle to 45 in the Start sub-tree
Functional value to 100
Locked to True
Angle to 225 in the End sub-tree
Functional value to 0
Locked to True
Orientation to Counterclockwise
The resulting rotation container is:
1 Select the second rotate group item and select the Plugs tab.
Esterel Technologies
3 - 56
The Nominal area is now configured to rotate according to the value of the nominal
variable.
To name the containers
Check the layer design to verify that the specification contains no error.
To check the specification design
1 In the Structure tree, select symbology_layer, the root node of the specification to
from the Project toolbar or select Project > Checker > Check
Layer to launch the Design Checker on the whole layer.
Esterel Technologies
3 - 58
3 Click the object Static in the bottom-right part of the window to show the related
Create a top-level container containing all the objects that compose the counter before
saving it as an object.
To create a top-level container
.
The objects are now grouped as shown on the picture below.
Esterel Technologies
3 - 60
Now, you can continue with Exercise 3.26: Saving the Specification as Object.
Exercise 3.26:
Objects.
4 Type counter_ref.ogfx in the File Name field and save the file in a sub-
For more information about saving as object, see Chapter 7 about Working with Reference
Objects from SCADE Display User Manual.
window.
4 Save the new specification as TwoCounters.sgfx.
You can insert or instantiate a saved reference object through a specific type of containers
called reference containers.
To instantiate the counter
1 Click Reference
Esterel Technologies
4 - 64
2 In the file chooser that opens, browse and select the counter_ref.ogfx file that
1 Select the Counter item in the Structure tree or in the Visualization area if it is not
already selected.
2 In the Properties tab, set counter properties as follows:
For more information about reference containers, see Drawing Containers on page 210
from SCADE Display User Manual.
Now, you can continue with Exercise 4.29: Plugging the Volt Counter.
Exercise 4.29:
Plug the reference container so that it rotates according to the value of the variable it is
connected to.
To plug the Volt counter
1 Select the Counter_ref item in the Structure tree, press F2, and rename it Volt
counter.
2 Display the content of the Plugs tab, type volt in the value text-field, and press
Enter to validate.
3 Click Create variables to create the volt variable in the Variable Dictionary.
4 Select the Properties tab to display the properties again.
Esterel Technologies
4 - 66
The Volt counter is thus configured to change according to the value of the volt
variable.
Now, you can continue with Creating Hertz Counter.
2 In the file chooser that opens, select the counter_ref.ogfx file that you created in
1 Select the Counter_ref item in the Structure tree or in the Visualization area if it is
Now, you can continue with Exercise 4.31: Plugging the Hertz Counter.
Exercise 4.31:
validate.
4 Click Create variables to create the hertz variable in the Variable Dictionary.
5 Select the Properties tab to display the properties again.
6 Click
The Hertz counter will thus change according to the value of the hertz variable. Now,
you can continue with Animating the Volt and Hertz Counters.
Esterel Technologies
4 - 68
In the Visualization area, both needles are animated according to the values of the volt
and hertz variables.
7 Click Stop
Esterel Technologies
4 - 70
1 Select Project > Code Generator > Generate Resource Tables Code.
The Console panel displays automatically, showing information messages and the
results of the code generation process.
SCADE Display KCG generates the resources files in the same directory as the
specification code.
You have designed a display specification based on the reusable component previously
specified and completed the Getting Started with SCADE Display. You have seen how to
create, design, check, animate, and generate a display specification. You have also seen
how to create and reuse reference objects. You are now ready to design your own display
specification.
If you need to learn more about SCADE Display design environment and tools, please
refer to the complete SCADE Display documentation set available in PDF format, or
browse in the contents of the SCADE Display Help interface.
Esterel Technologies
4 - 72
Learn the basics of creating interactive objects in SCADE Display in the following
exercises:
Exercise 5.35: Drawing Button Graphics with In/Out Positions
Exercise 5.36: Defining InOutButton Active Area
Exercise 5.35:
The purpose of this exercise is to create a new specification containing the graphics for a
button with In and Out positions.
To draw the graphics for the OutPosition case
1 Click New
from the File toolbar or select the File > New menu.
2 In the Create New Specification window that opens, double-click the 768x768 Object
template.
The object specification is an OGFX file. Object specifications are always created with
a group in the layer as shown in Figure 5.62:
Line Width to 8.
6 In the Object Palette, click Rectangle
Visualization area,
Esterel Technologies
5 - 74
Figure 5.65: Grouping the graphical elements of the buttons Out position
1 Duplicate the OutPosition group by selecting it in the Structure area and press
Esterel Technologies
5 - 76
1 Select the OutPosition group in the Structure tree, press CTRL, and click the InPosition
You have created the graphics of the InOutButton involving a conditional group with two
states 1 and 2:
State 1 selects the OutPosition object
State 2 selects the InPosition object
To define the index for the two cases
1 Create a new variable in the Variable Dictionary named MouseIn, of type bool
Esterel Technologies
5 - 78
2 Select the Graphics group in the Structure area and display the Plugs tab.
3 Click the Index pluggable property text-field and type the conditional if-then-else
expression MouseIn ? 2 : 1.
Figure 5.69: Plugging the Index property of the Graphics conditional Group
The index property allows selecting between the two cases (OutPosition and InPosition
groups) of the Graphics conditional group.
Getting Started with SCADE Display
5 - 79
The following exercises show you how to add interaction to the InOutButton. The
buttons interactivity relies on an active area around the rectangle that detects when the
mouse is inside the button.
For more information about variable expressions, see Plugging Objects to Expressions on
page 150 from SCADE Display User Manual.
You can continue Exercise 5.36: Defining InOutButton Active Area.
Exercise 5.36:
The purpose of this exercise is to define the active area of the InOutButton object that
detects the mouse pointer. It involves two steps:
Defining the Rectangle Active Area geometry and associating the mouse to it
Plugging the Inside, Width percent, and Height percent properties
To define the Rectangle Area geometry and associate the mouse to it
Esterel Technologies
5 - 80
Dictionary.
1 Click Save to save the current Object specification as a SCADE Display Object file
(.ogfx).
Esterel Technologies
5 - 82
2 In the Save window, type InOutButton_ref in the File name field, select the
You have defined the input/output plugs of the specification. Later, you will be able to
connect these inputs/outputs plugs to the inputs/outputs of a SCADE Suite model.
You can continue Reusing InOutButton Reference Object.
The purpose of this exercise is to insert a InOutButton into the counter specification
created in Chapter 4 about Reusing Counter Object.
To insert the InOutButton within the Counter specification
3 In the file chooser that opens, browse and select the InOutButton_ref.ogfx file
5.72.
To plug the InOutButton button
1 Select the InOutButton object and display the Plugs tab content.
2 Click in the Plug All button to automatically plug each output property of the
Variable Dictionary.
4 Click Save to save the TwoCounter.sgfx specification.
Esterel Technologies
5 - 84
The purpose of this exercise is to open the SCADE Suite model provided with your
SCADE installation.
To open the SCADE Suite model
GettingStarted/Display folder.
2 Double-click the Example.etp file to start the SCADE Suite application and load
The Example.etp project contains one operator named RootOperator with the
following interface:
Kind
Name
Type
Input
MouseIn
Boolean
Input
InAreaWidth
real
Input
Outputs
InAreaHeight
real
hertz
real
volt
real
As illustrated in Figure 5.73, the RootOperator operator uses the defined inputs and
outputs and the If Then Else operator so that:
the value of the Hertz counter equals InAreaWidth * 100. when MouseIn is
true (0. otherwise)
the value of the Volt counter equals InAreaHeight * 100. when MouseIn is
true (0. otherwise)
MouseIn
bool
InAreaWidth * 100.
0.
real
real
real
Hertz
real
InAreaHeight * 100.
real
Volt
You can connect the models inputs and outputs to the SCADE Display specifications
plugs. However, you need to insert the graphical specification in the project first.
Esterel Technologies
5 - 86
Exercise 5.39:
The purpose of this exercise is to insert the SCADE Display specification into the SCADE
Suite project so that they reference each other.
To insert the counters display specification in the SCADE Suite project
1 Select Insert > Files from the menu bar to open a file chooser.
2 Browse for the TwoCounter.sgfx specification file created in the previous
Figure 5.74: Inserting a SCADE Display SFGX file in a SCADE Suite project
Now you have linked your model and your specification, you can connect their inputs/
outputs.
Exercise 5.40:
The purpose of this exercise is to connect the SCADE Display specification inputs/outputs
to the SCADE Suite model inputs/outputs.
To connect model and specification inputs/outputs
model, and select Connect to Graphical Panels from the contextual menu (see Figure
5.75).
Figure 5.75: Contextual menu command to connect model I/O to graphical panel I/O
The SCADE Suite/Graphical Panels Connections window that opens displays the list
of all the SCADE Suite model inputs and outputs on one hand, and the list of all the
SCADE Display inputs and outputs on the other hand, and allows connecting them (see
Figure 5.76).
Esterel Technologies
5 - 88
in the left part of the window, select all the SCADE Suite I/Os by pressing the
Shift key and clicking each I/O,
in the right part of the window, select all the SCADE Display I/O by pressing the
Shift key and clicking each I/O,
click Connect by Name to connect all variables according to their name.
The connections are added to the list of existing connections in the Connections frame.
You have created a SCADE Suite model of a counter that can be used interactively
through an interactive button.
You can now launch the simulation of the model to test the behavior of the counter.
Esterel Technologies
5 - 90
Exercise 5.41:
The purpose of this exercise is to set and launch the co-simulation of the Example.etp
model with the TwoCounter.sgfx specification.
To set code simulation of the Example model
toolbar.
3 Click Run
4 Click Yes. in the pop-up window asking you whether you want to build a simulation
binary file.
The SCADE Suite Simulator interface and SCADE Display Viewer open up:
that the counters react when the mouse pointer is inside the button
how the counters react depending on the position of the mouse pointer in the button:
You have now completed the Getting Started with SCADE Display and have seen how to
create a basic display specification, how to create and reuse an interactive object. You are
ready to create your own specification.
Esterel Technologies
5 - 92