1

<?xml version="1.0"?>

     2

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:exsl="http://exslt.org/common" xmlns:regexp="http://exslt.org/regular-expressions" xmlns:str="http://exslt.org/strings" xmlns:func="http://exslt.org/functions" xmlns:svg="http://www.w3.org/2000/svg" xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape" version="1.0" extension-element-prefixes="ns func exsl regexp str dyn" exclude-result-prefixes="ns func exsl regexp str dyn svg inkscape">

     3

  <xsl:output method="xml"/>

     4

  <xsl:variable name="indexed_hmitree" select="/.."/>

     5

  <xsl:variable name="pathregex" select="'^(\w+=)?([^,=]+)([-.\d,]*)$'"/>

     6

  <xsl:variable name="newline">

     7

    <xsl:text>

     8

</xsl:text>

     9

  </xsl:variable>

    10

  <xsl:variable name="twonewlines" select="concat($newline,$newline)"/>

    11

  <xsl:template mode="parselabel" match="*">

    12

    <xsl:variable name="label" select="@inkscape:label"/>

    13

    <xsl:variable name="desc" select="svg:desc"/>

    14

    <xsl:variable name="len" select="string-length($label)"/>

    15

    <xsl:variable name="has_continuation" select="substring($label,$len,1)='\'"/>

    16

    <xsl:variable name="full_decl">

    17

      <xsl:choose>

    18

        <xsl:when test="$has_continuation">

    19

          <xsl:variable name="_continuation" select="substring-before($desc, $twonewlines)"/>

    20

          <xsl:variable name="continuation">

    21

            <xsl:choose>

    22

              <xsl:when test="$_continuation">

    23

                <xsl:value-of select="$_continuation"/>

    24

              </xsl:when>

    25

              <xsl:otherwise>

    26

                <xsl:value-of select="$desc"/>

    27

              </xsl:otherwise>

    28

            </xsl:choose>

    29

          </xsl:variable>

    30

          <xsl:value-of select="concat(substring($label,1,$len - 1),translate($continuation,$newline,''))"/>

    31

        </xsl:when>

    32

        <xsl:otherwise>

    33

          <xsl:value-of select="$label"/>

    34

        </xsl:otherwise>

    35

      </xsl:choose>

    36

    </xsl:variable>

    37

    <xsl:variable name="id" select="@id"/>

    38

    <xsl:variable name="declaration" select="substring-after($full_decl,'HMI:')"/>

    39

    <xsl:variable name="_args" select="substring-before($declaration,'@')"/>

    40

    <xsl:variable name="args">

    41

      <xsl:choose>

    42

        <xsl:when test="$_args">

    43

          <xsl:value-of select="$_args"/>

    44

        </xsl:when>

    45

        <xsl:otherwise>

    46

          <xsl:value-of select="$declaration"/>

    47

        </xsl:otherwise>

    48

      </xsl:choose>

    49

    </xsl:variable>

    50

    <xsl:variable name="_typefreq" select="substring-before($args,':')"/>

    51

    <xsl:variable name="typefreq">

    52

      <xsl:choose>

    53

        <xsl:when test="$_typefreq">

    54

          <xsl:value-of select="$_typefreq"/>

    55

        </xsl:when>

    56

        <xsl:otherwise>

    57

          <xsl:value-of select="$args"/>

    58

        </xsl:otherwise>

    59

      </xsl:choose>

    60

    </xsl:variable>

    61

    <xsl:variable name="freq" select="substring-after($typefreq,'|')"/>

    62

    <xsl:variable name="_type" select="substring-before($typefreq,'|')"/>

    63

    <xsl:variable name="type">

    64

      <xsl:choose>

    65

        <xsl:when test="$_type">

    66

          <xsl:value-of select="$_type"/>

    67

        </xsl:when>

    68

        <xsl:otherwise>

    69

          <xsl:value-of select="$typefreq"/>

    70

        </xsl:otherwise>

    71

      </xsl:choose>

    72

    </xsl:variable>

    73

    <xsl:if test="$type">

    74

      <widget>

    75

        <xsl:attribute name="id">

    76

          <xsl:value-of select="$id"/>

    77

        </xsl:attribute>

    78

        <xsl:attribute name="type">

    79

          <xsl:value-of select="$type"/>

    80

        </xsl:attribute>

    81

        <xsl:if test="$freq">

    82

          <xsl:if test="not(regexp:test($freq,'^[0-9]*(\.[0-9]+)?[smh]?'))">

    83

            <xsl:message terminate="yes">

    84

              <xsl:text>Widget id:</xsl:text>

    85

              <xsl:value-of select="$id"/>

    86

              <xsl:text> label:</xsl:text>

    87

              <xsl:value-of select="$full_decl"/>

    88

              <xsl:text> has wrong syntax of frequency forcing </xsl:text>

    89

              <xsl:value-of select="$freq"/>

    90

            </xsl:message>

    91

          </xsl:if>

    92

          <xsl:attribute name="freq">

    93

            <xsl:value-of select="$freq"/>

    94

          </xsl:attribute>

    95

        </xsl:if>

    96

        <xsl:variable name="tail" select="substring-after($declaration,'@')"/>

    97

        <xsl:variable name="taillen" select="string-length($tail)"/>

    98

        <xsl:variable name="has_enable" select="contains($tail, '#')"/>

    99

        <xsl:variable name="paths">

   100

          <xsl:choose>

   101

            <xsl:when test="$has_enable">

   102

              <xsl:value-of select="substring-before($tail,'#')"/>

   103

            </xsl:when>

   104

            <xsl:otherwise>

   105

              <xsl:value-of select="$tail"/>

   106

            </xsl:otherwise>

   107

          </xsl:choose>

   108

        </xsl:variable>

   109

        <xsl:if test="$has_enable">

   110

          <xsl:variable name="enable_expr" select="substring-after($tail,'#')"/>

   111

          <xsl:attribute name="enable_expr">

   112

            <xsl:value-of select="$enable_expr"/>

   113

          </xsl:attribute>

   114

        </xsl:if>

   115

        <xsl:for-each select="str:split(substring-after($args, ':'), ':')">

   116

          <arg>

   117

            <xsl:attribute name="value">

   118

              <xsl:value-of select="."/>

   119

            </xsl:attribute>

   120

          </arg>

   121

        </xsl:for-each>

   122

        <xsl:for-each select="str:split($paths, '@')">

   123

          <xsl:if test="string-length(.) &gt; 0">

   124

            <path>

   125

              <xsl:variable name="path_match" select="regexp:match(.,$pathregex)"/>

   126

              <xsl:variable name="pathassign" select="substring-before($path_match[2],'=')"/>

   127

              <xsl:variable name="pathminmax" select="str:split($path_match[4],',')"/>

   128

              <xsl:variable name="path" select="$path_match[3]"/>

   129

              <xsl:variable name="pathminmaxcount" select="count($pathminmax)"/>

   130

              <xsl:if test="not($path)">

   131

                <xsl:message terminate="yes">

   132

                  <xsl:text>Widget id:</xsl:text>

   133

                  <xsl:value-of select="$id"/>

   134

                  <xsl:text> label:</xsl:text>

   135

                  <xsl:value-of select="$full_decl"/>

   136

                  <xsl:text> has wrong syntax</xsl:text>

   137

                </xsl:message>

   138

              </xsl:if>

   139

              <xsl:attribute name="value">

   140

                <xsl:value-of select="$path"/>

   141

              </xsl:attribute>

   142

              <xsl:if test="$pathassign">

   143

                <xsl:attribute name="assign">

   144

                  <xsl:value-of select="$pathassign"/>

   145

                </xsl:attribute>

   146

              </xsl:if>

   147

              <xsl:choose>

   148

                <xsl:when test="$pathminmaxcount = 2">

   149

                  <xsl:attribute name="min">

   150

                    <xsl:value-of select="$pathminmax[1]"/>

   151

                  </xsl:attribute>

   152

                  <xsl:attribute name="max">

   153

                    <xsl:value-of select="$pathminmax[2]"/>

   154

                  </xsl:attribute>

   155

                </xsl:when>

   156

                <xsl:when test="$pathminmaxcount = 1 or $pathminmaxcount &gt; 2">

   157

                  <xsl:message terminate="yes">

   158

                    <xsl:text>Widget id:</xsl:text>

   159

                    <xsl:value-of select="$id"/>

   160

                    <xsl:text> label:</xsl:text>

   161

                    <xsl:value-of select="$full_decl"/>

   162

                    <xsl:text> has wrong syntax of path section </xsl:text>

   163

                    <xsl:value-of select="$pathminmax"/>

   164

                  </xsl:message>

   165

                </xsl:when>

   166

              </xsl:choose>

   167

              <xsl:if test="$indexed_hmitree">

   168

                <xsl:choose>

   169

                  <xsl:when test="regexp:test($path,'^\.[a-zA-Z0-9_]+$')">

   170

                    <xsl:attribute name="type">

   171

                      <xsl:text>PAGE_LOCAL</xsl:text>

   172

                    </xsl:attribute>

   173

                  </xsl:when>

   174

                  <xsl:when test="regexp:test($path,'^[a-zA-Z0-9_]+$')">

   175

                    <xsl:attribute name="type">

   176

                      <xsl:text>HMI_LOCAL</xsl:text>

   177

                    </xsl:attribute>

   178

                  </xsl:when>

   179

                  <xsl:otherwise>

   180

                    <xsl:variable name="item" select="$indexed_hmitree/*[@hmipath = $path]"/>

   181

                    <xsl:variable name="pathtype" select="local-name($item)"/>

   182

                    <xsl:if test="$pathminmaxcount = 3 and not($pathtype = 'HMI_INT' or $pathtype = 'HMI_REAL')">

   183

                      <xsl:message terminate="yes">

   184

                        <xsl:text>Widget id:</xsl:text>

   185

                        <xsl:value-of select="$id"/>

   186

                        <xsl:text> label:</xsl:text>

   187

                        <xsl:value-of select="$full_decl"/>

   188

                        <xsl:text> path section </xsl:text>

   189

                        <xsl:value-of select="$pathminmax"/>

   190

                        <xsl:text> use min and max on non mumeric value</xsl:text>

   191

                      </xsl:message>

   192

                    </xsl:if>

   193

                    <xsl:if test="count($item) = 1">

   194

                      <xsl:attribute name="index">

   195

                        <xsl:value-of select="$item/@index"/>

   196

                      </xsl:attribute>

   197

                      <xsl:attribute name="type">

   198

                        <xsl:value-of select="$pathtype"/>

   199

                      </xsl:attribute>

   200

                    </xsl:if>

   201

                  </xsl:otherwise>

   202

                </xsl:choose>

   203

              </xsl:if>

   204

            </path>

   205

          </xsl:if>

   206

        </xsl:for-each>

   207

        <xsl:choose>

   208

          <xsl:when test="$has_continuation">

   209

            <xsl:variable name="_continuation" select="substring-after($desc, $twonewlines)"/>

   210

            <xsl:if test="$_continuation">

   211

              <desc>

   212

                <xsl:value-of select="$_continuation"/>

   213

              </desc>

   214

            </xsl:if>

   215

          </xsl:when>

   216

          <xsl:otherwise>

   217

            <xsl:if test="$desc">

   218

              <desc>

   219

                <xsl:value-of select="$desc/text()"/>

   220

              </desc>

   221

            </xsl:if>

   222

          </xsl:otherwise>

   223

        </xsl:choose>

   224

      </widget>

   225

    </xsl:if>

   226

  </xsl:template>

   227

  <xsl:template mode="genlabel" match="arg">

   228

    <xsl:text>:</xsl:text>

   229

    <xsl:value-of select="@value"/>

   230

  </xsl:template>

   231

  <xsl:template mode="genlabel" match="path">

   232

    <xsl:text>@</xsl:text>

   233

    <xsl:value-of select="@value"/>

   234

    <xsl:if test="string-length(@min)&gt;0 or string-length(@max)&gt;0">

   235

      <xsl:text>,</xsl:text>

   236

      <xsl:value-of select="@min"/>

   237

      <xsl:text>,</xsl:text>

   238

      <xsl:value-of select="@max"/>

   239

    </xsl:if>

   240

  </xsl:template>

   241

  <xsl:template mode="genlabel" match="widget">

   242

    <xsl:text>HMI:</xsl:text>

   243

    <xsl:value-of select="@type"/>

   244

    <xsl:apply-templates mode="genlabel" select="arg"/>

   245

    <xsl:apply-templates mode="genlabel" select="path"/>

   246

  </xsl:template>

   247

  <xsl:variable name="hmi_elements" select="//svg:*[starts-with(@inkscape:label, 'HMI:')]"/>

   248

  <xsl:template match="widget[@type='Assign']" mode="widget_desc">

   249

    <type>

   250

      <xsl:value-of select="@type"/>

   251

    </type>

   252

    <longdesc>

   253

      <xsl:text>

   254

</xsl:text>

   255

      <xsl:text>Arguments are either:

   256

</xsl:text>

   257

      <xsl:text>

   258

</xsl:text>

   259

      <xsl:text>- name=value: setting variable with literal value.

   260

</xsl:text>

   261

      <xsl:text>- name=other_name: copy variable content into another

   262

</xsl:text>

   263

      <xsl:text>

   264

</xsl:text>

   265

      <xsl:text>"active"+"inactive" labeled elements can be provided to show feedback when pressed

   266

</xsl:text>

   267

      <xsl:text>

   268

</xsl:text>

   269

      <xsl:text>Exemples:

   270

</xsl:text>

   271

      <xsl:text>

   272

</xsl:text>

   273

      <xsl:text>HMI:Assign:notify=1@notify=/PLCVAR

   274

</xsl:text>

   275

      <xsl:text>HMI:Assign:ack=2:notify=1@ack=.local_var@notify=/PLCVAR

   276

</xsl:text>

   277

      <xsl:text>

   278

</xsl:text>

   279

    </longdesc>

   280

    <shortdesc>

   281

      <xsl:text>Assign variables on click</xsl:text>

   282

    </shortdesc>

   283

  </xsl:template>

   284

  <xsl:template match="widget[@type='Back']" mode="widget_desc">

   285

    <type>

   286

      <xsl:value-of select="@type"/>

   287

    </type>

   288

    <longdesc>

   289

      <xsl:text>Back widget brings focus back to previous page in history when clicked.

   290

</xsl:text>

   291

    </longdesc>

   292

    <shortdesc>

   293

      <xsl:text>Jump to previous page</xsl:text>

   294

    </shortdesc>

   295

  </xsl:template>

   296

  <xsl:template match="widget[@type='Button']" mode="widget_desc">

   297

    <type>

   298

      <xsl:value-of select="@type"/>

   299

    </type>

   300

    <longdesc>

   301

      <xsl:text>Button widget takes one boolean variable path, and reflect current true

   302

</xsl:text>

   303

      <xsl:text>or false value by showing "active" or "inactive" labeled element

   304

</xsl:text>

   305

      <xsl:text>respectively. Pressing and releasing button changes variable to true and

   306

</xsl:text>

   307

      <xsl:text>false respectively. Potential inconsistency caused by quick consecutive

   308

</xsl:text>

   309

      <xsl:text>presses on the button is mitigated by using a state machine that wait for

   310

</xsl:text>

   311

      <xsl:text>previous state change to be reflected on variable before applying next one.

   312

</xsl:text>

   313

    </longdesc>

   314

    <shortdesc>

   315

      <xsl:text>Push button reflecting consistently given boolean variable</xsl:text>

   316

    </shortdesc>

   317

    <path name="value" accepts="HMI_BOOL">

   318

      <xsl:text>Boolean variable</xsl:text>

   319

    </path>

   320

  </xsl:template>

   321

  <xsl:template name="generated_button_class">

   322

    <xsl:param name="fsm"/>

   323

    <xsl:text>    state = "init";

   324

</xsl:text>

   325

    <xsl:text>    dispatch(value) {

   326

</xsl:text>

   327

    <xsl:apply-templates mode="dispatch_transition" select="$fsm"/>

   328

    <xsl:text>    }

   329

</xsl:text>

   330

    <xsl:text>    onmouseup(evt) {

   331

</xsl:text>

   332

    <xsl:text>        svg_root.removeEventListener("pointerup", this.bound_onmouseup, true);

   333

</xsl:text>

   334

    <xsl:apply-templates mode="mouse_transition" select="$fsm">

   335

      <xsl:with-param name="position" select="'up'"/>

   336

    </xsl:apply-templates>

   337

    <xsl:text>    }

   338

</xsl:text>

   339

    <xsl:text>    onmousedown(evt) {

   340

</xsl:text>

   341

    <xsl:text>        svg_root.addEventListener("pointerup", this.bound_onmouseup, true);

   342

</xsl:text>

   343

    <xsl:apply-templates mode="mouse_transition" select="$fsm">

   344

      <xsl:with-param name="position" select="'down'"/>

   345

    </xsl:apply-templates>

   346

    <xsl:text>    }

   347

</xsl:text>

   348

    <xsl:apply-templates mode="actions" select="$fsm"/>

   349

    <xsl:text>    init() {

   350

</xsl:text>

   351

    <xsl:text>        this.bound_onmouseup = this.onmouseup.bind(this);

   352

</xsl:text>

   353

    <xsl:text>        this.element.addEventListener("pointerdown", this.onmousedown.bind(this));

   354

</xsl:text>

   355

    <xsl:text>        this.activity_state = undefined;

   356

</xsl:text>

   357

    <xsl:text>    }

   358

</xsl:text>

   359

  </xsl:template>

   360

  <xsl:template match="widget[@type='CircularBar']" mode="widget_desc">

   361

    <type>

   362

      <xsl:value-of select="@type"/>

   363

    </type>

   364

    <longdesc>

   365

      <xsl:text>CircularBar widget changes the end angle of a "path" labeled arc according

   366

</xsl:text>

   367

      <xsl:text>to value of the single accepted variable.

   368

</xsl:text>

   369

      <xsl:text>

   370

</xsl:text>

   371

      <xsl:text>If "min" a "max" labeled texts are provided, then they are used as

   372

</xsl:text>

   373

      <xsl:text>respective minimum and maximum value. Otherwise, value is expected to be

   374

</xsl:text>

   375

      <xsl:text>in between 0 and 100.

   376

</xsl:text>

   377

    </longdesc>

   378

    <shortdesc>

   379

      <xsl:text>Change end angle of Inkscape's arc</xsl:text>

   380

    </shortdesc>

   381

    <arg name="min" count="optional" accepts="int,real">

   382

      <xsl:text>minimum value</xsl:text>

   383

    </arg>

   384

    <arg name="max" count="optional" accepts="int,real">

   385

      <xsl:text>maximum value</xsl:text>

   386

    </arg>

   387

    <path name="value" accepts="HMI_INT,HMI_REAL">

   388

      <xsl:text>Value to display</xsl:text>

   389

    </path>

   390

  </xsl:template>

   391

  <xsl:template match="widget[@type='CustomHtml']" mode="widget_desc">

   392

    <type>

   393

      <xsl:value-of select="@type"/>

   394

    </type>

   395

    <longdesc>

   396

      <xsl:text>CustomHtml widget allows insertion of HTML code in a svg:foreignObject.

   397

</xsl:text>

   398

      <xsl:text>Widget content is replaced by foreignObject. HTML code is obtained from

   399

</xsl:text>

   400

      <xsl:text>"code" labeled text content. HTML insert position and size is given with

   401

</xsl:text>

   402

      <xsl:text>"container" labeled element.

   403

</xsl:text>

   404

    </longdesc>

   405

    <shortdesc>

   406

      <xsl:text>Custom HTML insert</xsl:text>

   407

    </shortdesc>

   408

  </xsl:template>

   409

  <xsl:template match="widget[@type='Display']" mode="widget_desc">

   410

    <type>

   411

      <xsl:value-of select="@type"/>

   412

    </type>

   413

    <longdesc>

   414

      <xsl:text>If Display widget is a svg:text element, then text content is replaced by

   415

</xsl:text>

   416

      <xsl:text>value of given variables, space separated.

   417

</xsl:text>

   418

      <xsl:text>

   419

</xsl:text>

   420

      <xsl:text>Otherwise, if Display widget is a group containing a svg:text element

   421

</xsl:text>

   422

      <xsl:text>labelled "format", then text content is replaced by printf-like formated

   423

</xsl:text>

   424

      <xsl:text>string. In other words, if "format" labeled text is "%d %s %f", then 3

   425

</xsl:text>

   426

      <xsl:text>variables paths are expected : HMI_IN, HMI_STRING and HMI_REAL.

   427

</xsl:text>

   428

      <xsl:text>

   429

</xsl:text>

   430

      <xsl:text>In case Display widget is a svg::text element, it is also possible to give

   431

</xsl:text>

   432

      <xsl:text>format string as first argument.

   433

</xsl:text>

   434

    </longdesc>

   435

    <shortdesc>

   436

      <xsl:text>Printf-like formated text display</xsl:text>

   437

    </shortdesc>

   438

    <arg name="format" count="optional" accepts="string">

   439

      <xsl:text>printf-like format string when not given as svg:text</xsl:text>

   440

    </arg>

   441

    <path name="fields" count="many" accepts="HMI_INT,HMI_REAL,HMI_STRING,HMI_BOOL">

   442

      <xsl:text>variables to be displayed</xsl:text>

   443

    </path>

   444

  </xsl:template>

   445

  <xsl:template match="widget[@type='DropDown']" mode="widget_desc">

   446

    <type>

   447

      <xsl:value-of select="@type"/>

   448

    </type>

   449

    <longdesc>

   450

      <xsl:text>DropDown widget let user select an entry in a list of texts, given as

   451

</xsl:text>

   452

      <xsl:text>arguments. Single variable path is index of selection.

   453

</xsl:text>

   454

      <xsl:text>

   455

</xsl:text>

   456

      <xsl:text>It needs "text" (svg:text or svg:use referring to svg:text),

   457

</xsl:text>

   458

      <xsl:text>"box" (svg:rect), "button" (svg:*), and "highlight" (svg:rect)

   459

</xsl:text>

   460

      <xsl:text>labeled elements.

   461

</xsl:text>

   462

      <xsl:text>

   463

</xsl:text>

   464

      <xsl:text>When user clicks on "button", "text" is duplicated to display enties in the

   465

</xsl:text>

   466

      <xsl:text>limit of available space in page, and "box" is extended to contain all

   467

</xsl:text>

   468

      <xsl:text>texts. "highlight" is moved over pre-selected entry.

   469

</xsl:text>

   470

      <xsl:text>

   471

</xsl:text>

   472

      <xsl:text>When only one argument is given and argment contains "#langs" then list of

   473

</xsl:text>

   474

      <xsl:text>texts is automatically set to the human-readable list of supported

   475

</xsl:text>

   476

      <xsl:text>languages by this HMI. 

   477

</xsl:text>

   478

      <xsl:text>

   479

</xsl:text>

   480

      <xsl:text>If "text" labeled element is of type svg:use and refers to a svg:text 

   481

</xsl:text>

   482

      <xsl:text>element part of a TextList widget, no argument is expected. In that case

   483

</xsl:text>

   484

      <xsl:text>list of texts is set to TextList content.

   485

</xsl:text>

   486

    </longdesc>

   487

    <shortdesc>

   488

      <xsl:text>Let user select text entry in a drop-down menu</xsl:text>

   489

    </shortdesc>

   490

    <arg name="entries" count="many" accepts="string">

   491

      <xsl:text>drop-down menu entries</xsl:text>

   492

    </arg>

   493

    <path name="selection" accepts="HMI_INT">

   494

      <xsl:text>selection index</xsl:text>

   495

    </path>

   496

  </xsl:template>

   497

  <xsl:template match="widget[@type='ForEach']" mode="widget_desc">

   498

    <type>

   499

      <xsl:value-of select="@type"/>

   500

    </type>

   501

    <longdesc>

   502