SinumerikOperate_QT_X3D
SinumerikOperate_QT_X3D
___________________
MyHMI /3GL
SINUMERIK
SINUMERIK 840D sl
SINUMERIK Integrate Create
MyHMI /3GL
Programming Manual
Valid for:
03/2017
Legal information
Warning notice system
This manual contains notices you have to observe in order to ensure your personal safety, as well as to prevent
damage to property. The notices referring to your personal safety are highlighted in the manual by a safety alert
symbol, notices referring only to property damage have no safety alert symbol. These notices shown below are
graded according to the degree of danger.
DANGER
indicates that death or severe personal injury will result if proper precautions are not taken.
WARNING
indicates that death or severe personal injury may result if proper precautions are not taken.
CAUTION
indicates that minor personal injury can result if proper precautions are not taken.
NOTICE
indicates that property damage can result if proper precautions are not taken.
If more than one degree of danger is present, the warning notice representing the highest degree of danger will
be used. A notice warning of injury to persons with a safety alert symbol may also include a warning relating to
property damage.
Qualified Personnel
The product/system described in this documentation may be operated only by personnel qualified for the specific
task in accordance with the relevant documentation, in particular its warning notices and safety instructions.
Qualified personnel are those who, based on their training and experience, are capable of identifying risks and
avoiding potential hazards when working with these products/systems.
Proper use of Siemens products
Note the following:
WARNING
Siemens products may only be used for the applications described in the catalog and in the relevant technical
documentation. If products and components from other manufacturers are used, these must be recommended
or approved by Siemens. Proper transport, storage, installation, assembly, commissioning, operation and
maintenance are required to ensure that the products operate safely and without any problems. The permissible
ambient conditions must be complied with. The information in the relevant documentation must be observed.
Trademarks
All names identified by ® are registered trademarks of Siemens AG. The remaining trademarks in this publication
may be trademarks whose use by third parties for their own purposes could violate the rights of the owner.
Disclaimer of Liability
We have reviewed the contents of this publication to ensure consistency with the hardware and software
described. Since variance cannot be precluded entirely, we cannot guarantee full consistency. However, the
information in this publication is reviewed regularly and any necessary corrections are included in subsequent
editions.
Introduction
The manual describes working with the X3D Viewer with which you can integrate animated
and non-animated graphical scenes (animated elements) – called help screens in the
following – into the graphical user interface of SINUMERIK Operate as of Version V4.7 SP1 .
You can show motion sequences and parameters in context-sensitive help screens. This
helps you to improve the operation of applications and make the user interface more
appealing.
Implementation of your initial idea to the final help screen is described in the steps below:
● Creation of graphical elements and 3D models for the help screens that will eventually
appear in the X3D Viewer (see Chapter Auto-Hotspot).
● Creation of the scene description file in which the model data of the graphics file will be
assigned to the scenes and animations to be displayed at particular points (see Chapter
Auto-Hotspot).
● Conversion of the X3D files and XML files into HMI files (see Chapter Conversion to hmi
file (Page 18)).
● C++ integration of the X3D Viewer into your own application (see Chapter Implementation
example (Page 21)).
● Application in Run MyScreens (see Chapter Display in Run MyScreens (Page 22)).
1.2 Modeling
1.2.1 Requirements
The aim of the modeling is to create a file with the generated 3D models in .x3d file format,
an official standard for 3D contents.
Modeling is performed in the Flux Studio Web3D authoring tool . The Flux Studio Web3D
authoring tool is a freely available 3D modeling tool with versatile export and import options.
Requirements
● You have installed the Flux Studio Web3D authoring tool, Version 2.1.
● You are familiar with modeling and use of Flux Studio.
● File format .x3d is not described in any detail in this document, adequate knowledge of
the subject is assumed.
Note
You can download the Flux Studio Web3D authoring tool from the Internet via the following
link:
http://mediamachines.wordpress.com/flux-player-and-flux-studio
6. Before you can create a .x3d file you must make the following settings in dialog box
"Export Options":
7. We recommend the following settings for texts (see also the following dialog box):
– Texts must always be centered.
– The size of the text should be 0.2. This size allows you to position the text easily. The
text output by the X3D Viewer is in the font size of the user interface, irrespective of
this value.
8. To create hatching, use file schnitt.png as the texture. The lines always go from the
bottom left to the top right at an angle of 45°. You should set the scaling to 3 in both
dimensions. The rotation depends on the construction type and must be adapted
manually.
See also
XML commands (Page 13)
Import as inline
Flux Studio uses the object "Inline" for importing .x3d files. It allows you to link in external
elements without multiplying the 3D data of these models.
Insert the object with menu item Create -> Create Inline. Then enter a file name in the object
properties.
The model data from the Cinema4D file is inserted as a complete group. All cameras and
any other information that is additionally imported should be deleted. Only the graphics
elements of the Cinema4D file are required.
General
Template Description
intersection_texture.png Texture for an sectioned area
rapid_traverse_line_hori.fxw Horizontal line to illustrate the tool traversing path
during rapid traverse
rapid_traverse_line_vert.fxw Vertical line to illustrate the tool traversing path
during rapid traverse
feed_traverse_line_hori.fxw Horizontal line to illustrate the tool path during
feed
feed_traverse_line_vert.fxw Vertical line to illustrate the tool path during feed
dimensioning_lines_hori.fxw Horizontal projection lines
dimensioning_lines_vert.fxw Vertical projection lines
z1_inc.fxw Horizontal dimension line with the identifier Z1
x1_inc.fxw Vertical dimension line with the identifier X1
3d_coordinate_origin.fxw 3D coordinate origin
3d_zero_point.fxw 3D zero point
Turning
Template Description
turning_blank.fxw The blank for turning technology: A simple cylin-
der
turning_centerline.fxw Center line
turning_centerpoint.fxw Coordinate origin to display the zero point in the
WCS
turning_refpoint.fxw Reference point, for example, for a machining
operation
turning_machining_area.fxw Boundary lines for the machining area
Milling
Template Description
milling_blank.fxw The blank for milling technology: A simple cube
milling_centerline.fxw Center line
milling_refpoint.fxw Reference point, for example, for a machining
operation
1.3.1 Overview
The scene description file (extension .xml) is required so that the X3D Viewer can access the
graphics. In the scene description file, you assign the scene names that are called from the
configuration to the times in the .x3d file (time sensor) at which the graphics are positioned.
Description
Description
<TextPosition center='true' /> Marking that the texts are centered. This is relevant
to the display of the texts in rotated screens. We
recommend using this setting.
Description
<!--Definition of an animation-->
<SceneKey name='BoringAnimation' masterRotationSpeed="-64.0"
maxRotAngle="45.0" begin-Time='0.110 endTime='0.118 view='camiso'
speedMaster='boringtool' Type="VIEW_3D_TURN_CYL">
Description
Description
Description
Description
Description
Description
Examples
mirror="RotatePieceZ=180"
mirror="RotatePieceZ=-90 MirrorScreenX"
mirror="RotateScreenY=90"
mirror="MirrorPieceX MirrorPieceY"
mirror="MirrorPieceZ RotatePieceX=-90"
Description
Note
The X3D files and their associated XML files are converted to HMI files when the HMI is
powered up.
For each X3D file, a corresponding XML file of the same name must be created. To do this,
you store the X3D files and XML files in directory search path of HMI\ico\x3d\turning or
milling. You proceed in the same way with the .ts files.
Parameters Meaning
pParent The parameter is passed on to the constructor of
the Qwidget.
~SlX3dViewerWidget ( )
Destructor of the X3D Viewer widget.
Parameters Meaning
- -
void viewSceneSlot ( const QString& rsFileName, const QString& rsScene, const QString&
rsAnimationScene, int nChannel, int nPlane, SlStepTechnology nTechnology )
With the viewSceneSlot method, the X3D Viewer is instructed to load the rsScene static
scene and the rsAnimationSzene animated scene from the rsFileName file and display them
alternately.
The static scene and then the animated scene are repeatedly alternately displayed for a
fixed time.
If no static scene is specified, the animation will be shown immediately; an animated scene
may also not have been specified.
Channel number, plane and technology are used to rotate the scenes to the correct position
(depending on the set machine coordinate system).
Parameters Meaning
rsFileName Name of the file that contains the scenes to be
displayed
rsScene Name of the static scene.
rsAnimationScene Name of the animated scene.
nChannel Channel number
nPlane Plane
nTechnology Technology
The following constants are defined for the
SlStepTechnology enumeration type:
• SL_STEP_NO_TECHNOLOGY
• SL_STEP_MILLING
• SL_STEP_TURNING
• SL_STEP_SURFACE_GRINDING
• SL_STEP_CIRCULAR_GRINDING
void viewSceneSlot ( const QString& rsFileName, const QString& rsScene, const QString&
rsAnimationScene )
A simplified form of the viewSceneSlot method with which the X3D Viewer can be instructed
to load and display the rsScene static scene and/or the rsAnimationSzene animated scene
from the rsFileName file.
Parameters Meaning
rsFileName Name of the file that contains the scenes to be
displayed.
rsScene Name of the static scene.
rsAnimationScene Name of the animated scene.
1.5.5 Libraries
In order to be able to apply the X3D Viewer in your own projects, the list of library
dependencies must be extended by the 'slx3dviewer.lib' entry.
//M(MASK_F_DR_O1_MAIN/$85407////52,80/XG1)
The following parameters are required to activate the individual help screens; their meaning
is described in Section 5.3 Public slots:
1. File name
2. StaticScene (optional)
3. AnimationScene (optional)
4. Technology (optional)
5. Plane (optional)
The parameters are combined into a character string in this order, separated by a comma.
Examples
● The default help screen can be set with the specified variable Hlp.
In the following example, the "MyAnimation" animation is output from the
"MyDlgHelp.hmi" file. No StaticScene is specified, i.e. no static scene is output. No
specifications are made for the Technology and Plane, i. e. default values are used.
Hlp = "MyDlgHelp.hmi,,MyAnimation"
● The hlp property can be set on a specific help screen for the individual parameters of the
input screen.
In the following example, the static "MyParam" scene and the "MyAnimation" animation
are output from the "MyDlgHelp.hmi" file in the G17 plane. No specification is made for
the Technology, i.e. a default value is used.
VarMyParam.hlp = "MyDlgHelp.hmi,MyParam,MyAnimation,,G17"