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="_type" select="substring-before($args,':')"/>

    22

    <xsl:variable name="type">

    23

      <xsl:choose>

    24

        <xsl:when test="$_type">

    25

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

    26

        </xsl:when>

    27

        <xsl:otherwise>

    28

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

    29

        </xsl:otherwise>

    30

      </xsl:choose>

    31

    </xsl:variable>

    32

    <xsl:if test="$type">

    33

      <widget>

    34

        <xsl:attribute name="id">

    35

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

    36

        </xsl:attribute>

    37

        <xsl:attribute name="type">

    38

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

    39

        </xsl:attribute>

    40

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

    41

          <arg>

    42

            <xsl:attribute name="value">

    43

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

    44

            </xsl:attribute>

    45

          </arg>

    46

        </xsl:for-each>

    47

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

    48

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

    49

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

    50

            <path>

    51

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

    52

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

    53

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

    54

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

    55

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

    56

              <xsl:attribute name="value">

    57

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

    58

              </xsl:attribute>

    59

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

    60

                <xsl:attribute name="accepts">

    61

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

    62

                </xsl:attribute>

    63

              </xsl:if>

    64

              <xsl:choose>

    65

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

    66

                  <xsl:attribute name="min">

    67

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

    68

                  </xsl:attribute>

    69

                  <xsl:attribute name="max">

    70

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

    71

                  </xsl:attribute>

    72

                </xsl:when>

    73

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

    74

                  <xsl:message terminate="yes">

    75

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

    76

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

    77

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

    78

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

    79

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

    80

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

    81

                  </xsl:message>

    82

                </xsl:when>

    83

              </xsl:choose>

    84

              <xsl:if test="$indexed_hmitree">

    85

                <xsl:choose>

    86

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

    87

                    <xsl:attribute name="type">

    88

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

    89

                    </xsl:attribute>

    90

                  </xsl:when>

    91

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

    92

                    <xsl:attribute name="type">

    93

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

    94

                    </xsl:attribute>

    95

                  </xsl:when>

    96

                  <xsl:otherwise>

    97

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

    98

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

    99

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

   100

                      <xsl:message terminate="yes">

   101

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

   102

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

   103

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

   104

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

   105

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

   106

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

   107

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

   108

                      </xsl:message>

   109

                    </xsl:if>

   110

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

   111

                      <xsl:attribute name="index">

   112

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

   113

                      </xsl:attribute>

   114

                      <xsl:attribute name="type">

   115

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

   116

                      </xsl:attribute>

   117

                    </xsl:if>

   118

                  </xsl:otherwise>

   119

                </xsl:choose>

   120

              </xsl:if>

   121

            </path>

   122

          </xsl:if>

   123

        </xsl:for-each>

   124

      </widget>

   125

    </xsl:if>

   126

  </xsl:template>

   127

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

   128

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

   129

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

   130

  </xsl:template>

   131

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

   132

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

   133

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

   134

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

   135

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

   136

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

   137

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

   138

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

   139

    </xsl:if>

   140

  </xsl:template>

   141

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

   142

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

   143

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

   144

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

   145

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

   146

  </xsl:template>

   147

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

   148

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

   149

    <type>

   150

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

   151

    </type>

   152

    <longdesc>

   153

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

   154

</xsl:text>

   155

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

   156

</xsl:text>

   157

    </longdesc>

   158

    <shortdesc>

   159

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

   160

    </shortdesc>

   161

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

   162

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

   163

    </path>

   164

  </xsl:template>

   165

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

   166

    <type>

   167

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

   168

    </type>

   169

    <longdesc>

   170

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

   171

</xsl:text>

   172

    </longdesc>

   173

    <shortdesc>

   174

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

   175

    </shortdesc>

   176

  </xsl:template>

   177

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

   178

    <type>

   179

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

   180

    </type>

   181

    <longdesc>

   182

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

   183

</xsl:text>

   184

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

   185

</xsl:text>

   186

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

   187

</xsl:text>

   188

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

   189

</xsl:text>

   190

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

   191

</xsl:text>

   192

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

   193

</xsl:text>

   194

    </longdesc>

   195

    <shortdesc>

   196

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

   197

    </shortdesc>

   198

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

   199

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

   200

    </path>

   201

  </xsl:template>

   202

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

   203

    <type>

   204

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

   205

    </type>

   206

    <longdesc>

   207

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

   208

</xsl:text>

   209

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

   210

</xsl:text>

   211

      <xsl:text>

   212

</xsl:text>

   213

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

   214

</xsl:text>

   215

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

   216

</xsl:text>

   217

      <xsl:text>in between 0 and 100.

   218

</xsl:text>

   219

      <xsl:text>

   220

</xsl:text>

   221

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

   222

</xsl:text>

   223

    </longdesc>

   224

    <shortdesc>

   225

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

   226

    </shortdesc>

   227

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

   228

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

   229

    </path>

   230

  </xsl:template>

   231

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

   232

    <type>

   233

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

   234

    </type>

   235

    <longdesc>

   236

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

   237

</xsl:text>

   238

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

   239

</xsl:text>

   240

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

   241

</xsl:text>

   242

      <xsl:text>

   243

</xsl:text>

   244

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

   245

</xsl:text>

   246

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

   247

</xsl:text>

   248

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

   249

</xsl:text>

   250

      <xsl:text>

   251

</xsl:text>

   252

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

   253

</xsl:text>

   254

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

   255

</xsl:text>

   256

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

   257

</xsl:text>

   258

    </longdesc>

   259

    <shortdesc>

   260

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

   261

    </shortdesc>

   262

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

   263

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

   264

    </arg>

   265

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

   266

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

   267

    </arg>

   268

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

   269

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

   270

    </path>

   271

  </xsl:template>

   272

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

   273

    <type>

   274

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

   275

    </type>

   276

    <longdesc>

   277

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

   278

</xsl:text>

   279

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

   280

</xsl:text>

   281

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

   282

</xsl:text>

   283

      <xsl:text>"container" labeled element.

   284

</xsl:text>

   285

    </longdesc>

   286

    <shortdesc>

   287

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

   288

    </shortdesc>

   289

  </xsl:template>

   290

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

   291

    <type>

   292

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

   293

    </type>

   294

    <longdesc>

   295

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

   296

</xsl:text>

   297

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

   298

</xsl:text>

   299

      <xsl:text>

   300

</xsl:text>

   301

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

   302

</xsl:text>

   303

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

   304

</xsl:text>

   305

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

   306

</xsl:text>

   307

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

   308

</xsl:text>

   309

      <xsl:text>

   310

</xsl:text>

   311

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

   312

</xsl:text>

   313

      <xsl:text>format string as first argument.

   314

</xsl:text>

   315

    </longdesc>

   316

    <shortdesc>

   317

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

   318

    </shortdesc>

   319

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

   320

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

   321

    </arg>

   322

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

   323

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

   324

    </path>

   325

  </xsl:template>

   326

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

   327

    <type>

   328

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

   329

    </type>

   330

    <longdesc>

   331

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

   332

</xsl:text>

   333

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

   334

</xsl:text>

   335

      <xsl:text>

   336

</xsl:text>

   337

      <xsl:text>It needs "text" (svg:text), "box" (svg:rect), "button" (svg:*),

   338

</xsl:text>

   339

      <xsl:text>and "highlight" (svg:rect) labeled elements.

   340

</xsl:text>

   341

      <xsl:text>

   342

</xsl:text>

   343

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

   344

</xsl:text>

   345

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

   346

</xsl:text>

   347

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

   348

</xsl:text>

   349

      <xsl:text>

   350

</xsl:text>

   351

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

   352

</xsl:text>

   353

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

   354

</xsl:text>

   355

      <xsl:text>by this HMI. 

   356

</xsl:text>

   357

    </longdesc>

   358

    <shortdesc>

   359

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

   360

    </shortdesc>

   361

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

   362

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

   363

    </arg>

   364

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

   365

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

   366

    </path>

   367

  </xsl:template>

   368

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

   369

    <type>

   370

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

   371

    </type>

   372

    <longdesc>

   373

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

   374

</xsl:text>

   375

      <xsl:text>repeated HMI_NODEs. 

   376

</xsl:text>

   377

      <xsl:text>

   378

</xsl:text>

   379

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

   380

</xsl:text>

   381

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

   382

</xsl:text>

   383

      <xsl:text>

   384

</xsl:text>

   385

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

   386

</xsl:text>

   387

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

   388

</xsl:text>

   389

      <xsl:text>

   390

</xsl:text>

   391

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

   392

</xsl:text>

   393

      <xsl:text>variable.

   394

</xsl:text>

   395

      <xsl:text>

   396

</xsl:text>

   397

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

   398

</xsl:text>

   399

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

   400

</xsl:text>

   401

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

   402

</xsl:text>

   403

    </longdesc>

   404

    <shortdesc>

   405

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

   406

    </shortdesc>

   407

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

   408

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

   409

    </arg>

   410

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

   411

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

   412

    </path>

   413

  </xsl:template>

   414

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

   415

    <type>

   416

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

   417

    </type>

   418

    <longdesc>

   419

      <xsl:text>Input widget takes one variable path, and displays current value in

   420

</xsl:text>

   421

      <xsl:text>optional "value" labeled sub-element. 

   422

</xsl:text>

   423

      <xsl:text>

   424

</xsl:text>

   425

      <xsl:text>Click on optional "edit" labeled element opens keypad to edit value.

   426

</xsl:text>

   427

      <xsl:text>

   428

</xsl:text>

   429

      <xsl:text>Operation on current value is performed when click on sub-elements with

   430

</xsl:text>

   431

      <xsl:text>label starting with '=', '+' or '-' sign. Value after sign is used as

   432

</xsl:text>

   433

      <xsl:text>operand.

   434

</xsl:text>

   435

    </longdesc>

   436

    <shortdesc>

   437

      <xsl:text>Input field with predefined operation buttons</xsl:text>

   438

    </shortdesc>

   439

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

   440

      <xsl:text>optional printf-like format </xsl:text>

   441

    </arg>

   442

    <path name="edit" accepts="HMI_INT, HMI_REAL, HMI_STRING">

   443

      <xsl:text>single variable to edit</xsl:text>

   444

    </path>

   445

  </xsl:template>

   446

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

   447

    <type>

   448

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

   449

    </type>

   450

    <longdesc>

   451

      <xsl:text>Send given variables as POST to http URL argument, spread returned JSON in

   452

</xsl:text>

   453

      <xsl:text>SVG sub-elements of "data" labeled element.

   454

</xsl:text>

   455

      <xsl:text>

   456

</xsl:text>

   457

      <xsl:text>Documentation to be written. see svbghmi exemple.

   458

</xsl:text>

   459

    </longdesc>

   460

    <shortdesc>

   461

      <xsl:text>Http POST variables, spread JSON back</xsl:text>

   462

    </shortdesc>

   463

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

   464

      <xsl:text> </xsl:text>

   465

    </arg>

   466

    <path name="edit" accepts="HMI_INT, HMI_REAL, HMI_STRING">

   467

      <xsl:text>single variable to edit</xsl:text>

   468

    </path>

   469

  </xsl:template>

   470

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

   471

    <type>

   472

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

   473

    </type>

   474

    <longdesc>

   475

      <xsl:text>Jump widget brings focus to a different page. Mandatory single argument

   476

</xsl:text>

   477

      <xsl:text>gives name of the page.

   478

</xsl:text>

   479

      <xsl:text>

   480

</xsl:text>

   481

      <xsl:text>Optional single path is used as new reference when jumping to a relative

   482

</xsl:text>

   483

      <xsl:text>page, it must point to a HMI_NODE.

   484

</xsl:text>

   485

      <xsl:text>

   486

</xsl:text>

   487

      <xsl:text>"active"+"inactive" labeled elements can be provided and reflect current

   488

</xsl:text>

   489

      <xsl:text>page being shown.

   490

</xsl:text>

   491

      <xsl:text>

   492

</xsl:text>

   493

      <xsl:text>"disabled" labeled element, if provided, is shown instead of "active" or

   494

</xsl:text>

   495

      <xsl:text>"inactive" widget when pointed HMI_NODE is null.

   496

</xsl:text>

   497

    </longdesc>

   498

    <shortdesc>

   499

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

   500

    </shortdesc>

   501

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

   502

      <xsl:text>name of page to jump to</xsl:text>

   503

    </arg>

   504

    <path name="reference" count="optional" accepts="HMI_NODE">

   505

      <xsl:text>reference for relative jump</xsl:text>