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="'^([^\[,]+)(\[[^\]]+\])?([-.\d,]*)$'"/>

     6

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

     7

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

     8

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

     9

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

    10

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

    11

    <xsl:variable name="args">

    12

      <xsl:choose>

    13

        <xsl:when test="$_args">

    14

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

    15

        </xsl:when>

    16

        <xsl:otherwise>

    17

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

    18

        </xsl:otherwise>

    19

      </xsl:choose>

    20

    </xsl:variable>

    21

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

    22

    <xsl:variable name="typefreq">

    23

      <xsl:choose>

    24

        <xsl:when test="$_typefreq">

    25

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

    26

        </xsl:when>

    27

        <xsl:otherwise>

    28

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

    29

        </xsl:otherwise>

    30

      </xsl:choose>

    31

    </xsl:variable>

    32

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

    33

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

    34

    <xsl:variable name="type">

    35

      <xsl:choose>

    36

        <xsl:when test="$_type">

    37

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

    38

        </xsl:when>

    39

        <xsl:otherwise>

    40

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

    41

        </xsl:otherwise>

    42

      </xsl:choose>

    43

    </xsl:variable>

    44

    <xsl:if test="$type">

    45

      <widget>

    46

        <xsl:attribute name="id">

    47

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

    48

        </xsl:attribute>

    49

        <xsl:attribute name="type">

    50

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

    51

        </xsl:attribute>

    52

        <xsl:if test="$freq">

    53

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

    54

            <xsl:message terminate="yes">

    55

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

    56

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

    57

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

    58

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

    59

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

    60

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

    61

            </xsl:message>

    62

          </xsl:if>

    63

          <xsl:attribute name="freq">

    64

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

    65

          </xsl:attribute>

    66

        </xsl:if>

    67

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

    68

          <arg>

    69

            <xsl:attribute name="value">

    70

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

    71

            </xsl:attribute>

    72

          </arg>

    73

        </xsl:for-each>

    74

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

    75

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

    76

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

    77

            <path>

    78

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

    79

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

    80

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

    81

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

    82

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

    83

              <xsl:attribute name="value">

    84

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

    85

              </xsl:attribute>

    86

              <xsl:if test="string-length($path_accepts)">

    87

                <xsl:attribute name="accepts">

    88

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

    89

                </xsl:attribute>

    90

              </xsl:if>

    91

              <xsl:choose>

    92

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

    93

                  <xsl:attribute name="min">

    94

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

    95

                  </xsl:attribute>

    96

                  <xsl:attribute name="max">

    97

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

    98

                  </xsl:attribute>

    99

                </xsl:when>

   100

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

   101

                  <xsl:message terminate="yes">

   102

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

   103

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

   104

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

   105

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

   106

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

   107

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

   108

                  </xsl:message>

   109

                </xsl:when>

   110

              </xsl:choose>

   111

              <xsl:if test="$indexed_hmitree">

   112

                <xsl:choose>

   113

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

   114

                    <xsl:attribute name="type">

   115

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

   116

                    </xsl:attribute>

   117

                  </xsl:when>

   118

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

   119

                    <xsl:attribute name="type">

   120

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

   121

                    </xsl:attribute>

   122

                  </xsl:when>

   123

                  <xsl:otherwise>

   124

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

   125

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

   126

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

   127

                      <xsl:message terminate="yes">

   128

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

   129

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

   130

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

   131

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

   132

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

   133

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

   134

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

   135

                      </xsl:message>

   136

                    </xsl:if>

   137

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

   138

                      <xsl:attribute name="index">

   139

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

   140

                      </xsl:attribute>

   141

                      <xsl:attribute name="type">

   142

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

   143

                      </xsl:attribute>

   144

                    </xsl:if>

   145

                  </xsl:otherwise>

   146

                </xsl:choose>

   147

              </xsl:if>

   148

            </path>

   149

          </xsl:if>

   150

        </xsl:for-each>

   151

        <xsl:if test="svg:desc">

   152

          <desc>

   153

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

   154

          </desc>

   155

        </xsl:if>

   156

      </widget>

   157

    </xsl:if>

   158

  </xsl:template>

   159

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

   160

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

   161

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

   162

  </xsl:template>

   163

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

   164

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

   165

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

   166

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

   167

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

   168

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

   169

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

   170

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

   171

    </xsl:if>

   172

  </xsl:template>

   173

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

   174

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

   175

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

   176

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

   177

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

   178

  </xsl:template>

   179

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

   180

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

   181

    <type>

   182

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

   183

    </type>

   184

    <longdesc>

   185

      <xsl:text>AnimateRotation - DEPRECATED, do not use.

   186

</xsl:text>

   187

      <xsl:text>Doesn't follow WYSIWYG principle, and forces user to add animateTransform tag in SVG (using inkscape XML editor for exemple)

   188

</xsl:text>

   189

    </longdesc>

   190

    <shortdesc>

   191

      <xsl:text>AnimateRotation - DEPRECATED</xsl:text>

   192

    </shortdesc>

   193

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

   194

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

   195

    </path>

   196

  </xsl:template>

   197

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

   198

    <type>

   199

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

   200

    </type>

   201

    <longdesc>

   202

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

   203

</xsl:text>

   204

    </longdesc>

   205

    <shortdesc>

   206

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

   207

    </shortdesc>

   208

  </xsl:template>

   209

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

   210

    <type>

   211

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

   212

    </type>

   213

    <longdesc>

   214

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

   215

</xsl:text>

   216

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

   217

</xsl:text>

   218

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

   219

</xsl:text>

   220

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

   221

</xsl:text>

   222

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

   223

</xsl:text>

   224

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

   225

</xsl:text>

   226

    </longdesc>

   227

    <shortdesc>

   228

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

   229

    </shortdesc>

   230

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

   231

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

   232

    </path>

   233

  </xsl:template>

   234

  <xsl:template name="generated_button_class">

   235

    <xsl:param name="fsm"/>

   236

    <xsl:text>    display = "inactive";

   237

</xsl:text>

   238

    <xsl:text>    state = "init";

   239

</xsl:text>

   240

    <xsl:text>    dispatch(value) {

   241

</xsl:text>

   242

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

   243

    <xsl:text>    }

   244

</xsl:text>

   245

    <xsl:text>    onmouseup(evt) {

   246

</xsl:text>

   247

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

   248

</xsl:text>

   249

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

   250

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

   251

    </xsl:apply-templates>

   252

    <xsl:text>    }

   253

</xsl:text>

   254

    <xsl:text>    onmousedown(evt) {

   255

</xsl:text>

   256

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

   257

</xsl:text>

   258

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

   259

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

   260

    </xsl:apply-templates>

   261

    <xsl:text>    }

   262

</xsl:text>

   263

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

   264

    <xsl:text>    animate(){

   265

</xsl:text>

   266

    <xsl:text>        this.set_activation_state(this.display == "active");

   267

</xsl:text>

   268

    <xsl:text>    }

   269

</xsl:text>

   270

    <xsl:text>    init() {

   271

</xsl:text>

   272

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

   273

</xsl:text>

   274

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

   275

</xsl:text>

   276

    <xsl:text>        this.set_activation_state(undefined);

   277

</xsl:text>

   278

    <xsl:text>    }

   279

</xsl:text>

   280

  </xsl:template>

   281

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

   282

    <type>

   283

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

   284

    </type>

   285

    <longdesc>

   286

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

   287

</xsl:text>

   288

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

   289

</xsl:text>

   290

      <xsl:text>

   291

</xsl:text>

   292

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

   293

</xsl:text>

   294

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

   295

</xsl:text>

   296

      <xsl:text>in between 0 and 100.

   297

</xsl:text>

   298

    </longdesc>

   299

    <shortdesc>

   300

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

   301

    </shortdesc>

   302

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

   303

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

   304

    </arg>

   305

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

   306

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

   307

    </arg>

   308

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

   309

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

   310

    </path>

   311

  </xsl:template>

   312

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

   313

    <type>

   314

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

   315

    </type>

   316

    <longdesc>

   317

      <xsl:text>CircularSlider - DEPRECATED, to be replaced by PathSlider

   318

</xsl:text>

   319

      <xsl:text>This widget moves "handle" labeled group along "range" labeled

   320

</xsl:text>

   321

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

   322

</xsl:text>

   323

      <xsl:text>

   324

</xsl:text>

   325

      <xsl:text>If "min" a "max" labeled texts are provided, or if first and second

   326

</xsl:text>

   327

      <xsl:text>argument are given, then they are used as respective minimum and maximum

   328

</xsl:text>

   329

      <xsl:text>value. Otherwise, value is expected to be in between 0 and 100.

   330

</xsl:text>

   331

      <xsl:text>

   332

</xsl:text>

   333

      <xsl:text>If "value" labeled text is found, then its content is replaced by value.

   334

</xsl:text>

   335

      <xsl:text>During drag, "setpoint" labeled group is moved to position defined by user

   336

</xsl:text>

   337

      <xsl:text>while "handle" reflects current value from variable.

   338

</xsl:text>

   339

    </longdesc>

   340

    <shortdesc>

   341

      <xsl:text>CircularSlider - DEPRECATED</xsl:text>

   342

    </shortdesc>

   343

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

   344

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

   345

    </arg>

   346

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

   347

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

   348

    </arg>

   349

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

   350

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

   351

    </path>

   352

  </xsl:template>

   353

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

   354

    <type>

   355

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

   356

    </type>

   357

    <longdesc>

   358

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

   359

</xsl:text>

   360

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

   361

</xsl:text>

   362

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

   363

</xsl:text>

   364

      <xsl:text>"container" labeled element.

   365

</xsl:text>

   366

    </longdesc>

   367

    <shortdesc>

   368

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

   369

    </shortdesc>

   370

  </xsl:template>

   371

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

   372

    <type>

   373

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

   374

    </type>

   375

    <longdesc>

   376

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

   377

</xsl:text>

   378

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

   379

</xsl:text>

   380

      <xsl:text>

   381

</xsl:text>

   382

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

   383

</xsl:text>

   384

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

   385

</xsl:text>

   386

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

   387

</xsl:text>

   388

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

   389

</xsl:text>

   390

      <xsl:text>

   391

</xsl:text>

   392

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

   393

</xsl:text>

   394

      <xsl:text>format string as first argument.

   395

</xsl:text>

   396

    </longdesc>

   397

    <shortdesc>

   398

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

   399

    </shortdesc>

   400

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

   401

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

   402

    </arg>

   403

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

   404

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

   405

    </path>

   406

  </xsl:template>

   407

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

   408

    <type>

   409

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

   410

    </type>

   411

    <longdesc>

   412

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

   413

</xsl:text>

   414

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

   415

</xsl:text>

   416

      <xsl:text>

   417

</xsl:text>

   418

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

   419

</xsl:text>

   420

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

   421

</xsl:text>

   422

      <xsl:text>labeled elements.

   423

</xsl:text>

   424

      <xsl:text>

   425

</xsl:text>

   426

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

   427

</xsl:text>

   428

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

   429

</xsl:text>

   430

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

   431

</xsl:text>

   432

      <xsl:text>

   433

</xsl:text>

   434

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

   435

</xsl:text>

   436

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

   437

</xsl:text>

   438

      <xsl:text>languages by this HMI. 

   439

</xsl:text>

   440

      <xsl:text>

   441

</xsl:text>

   442

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

   443

</xsl:text>

   444

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

   445

</xsl:text>

   446

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

   447

</xsl:text>

   448

    </longdesc>

   449

    <shortdesc>

   450

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

   451

    </shortdesc>

   452

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

   453

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

   454

    </arg>

   455

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

   456

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

   457

    </path>

   458

  </xsl:template>

   459

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

   460

    <type>

   461

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

   462

    </type>

   463

    <longdesc>

   464

      <xsl:text>ForEach widget is used to span a small set of widget over a larger set of

   465

</xsl:text>

   466

      <xsl:text>repeated HMI_NODEs. 

   467

</xsl:text>

   468

      <xsl:text>

   469

</xsl:text>

   470

      <xsl:text>Idea is somewhat similar to relative page, but it all happens inside the

   471

</xsl:text>

   472

      <xsl:text>ForEach widget, no page involved.

   473

</xsl:text>

   474

      <xsl:text>

   475

</xsl:text>

   476

      <xsl:text>Together with relative Jump widgets it can be used to build a menu to reach

   477

</xsl:text>

   478

      <xsl:text>relative pages covering many identical HMI_NODES siblings.

   479

</xsl:text>

   480

      <xsl:text>

   481

</xsl:text>

   482

      <xsl:text>ForEach widget takes a HMI_CLASS name as argument and a HMI_NODE path as

   483

</xsl:text>

   484

      <xsl:text>variable.

   485

</xsl:text>

   486

      <xsl:text>

   487

</xsl:text>

   488

      <xsl:text>Direct sub-elements can be either groups of widget to be spanned, labeled

   489

</xsl:text>

   490

      <xsl:text>"ClassName:offset", or buttons to control the spanning, labeled

   491

</xsl:text>

   492

      <xsl:text>"ClassName:+/-number".

   493

</xsl:text>

   494

    </longdesc>

   495

    <shortdesc>

   496

      <xsl:text>span widgets over a set of repeated HMI_NODEs</xsl:text>

   497

    </shortdesc>

   498

    <arg name="class_name" accepts="string">

   499

      <xsl:text>HMI_CLASS name</xsl:text>

   500

    </arg>

   501

    <path name="root" accepts="HMI_NODE">

   502

      <xsl:text> where to find HMI_NODEs whose HMI_CLASS is class_name</xsl:text>

   503

    </path>