1

// detachable_pages.ysl2

     2

//

     3

// compute what elements are required by pages

     4

// and decide where to cut when removing/attaching

     5

// pages elements on page switch

     6

     7

const "hmi_pages_descs", "$parsed_widgets/widget[@type = 'Page']";

     8

const "hmi_pages", "$hmi_elements[@id = $hmi_pages_descs/@id]";

     9

    10

const "default_page" choose {

    11

    when "count($hmi_pages) > 1" {

    12

        choose {

    13

            when "$hmi_pages_descs/arg[1]/@value = 'Home'" > Home

    14

            otherwise {

    15

                error > No Home page defined!

    16

            }

    17

        }

    18

    }

    19

    when "count($hmi_pages) = 0" {

    20

        error > No page defined!

    21

    }

    22

    otherwise > «func:widget($hmi_pages/@id)/arg[1]/@value»

    23

}

    24

    25

emit "preamble:default-page" {

    26

    |

    27

    | var default_page = "«$default_page»";

    28

}

    29

    30

const "keypads_descs", "$parsed_widgets/widget[@type = 'Keypad']";

    31

const "keypads", "$hmi_elements[@id = $keypads_descs/@id]";

    32

    33

// returns all directly or indirectly refered elements

    34

def "func:refered_elements" {

    35

    param "elems";

    36

    const "descend", "$elems/descendant-or-self::svg:*";

    37

    const "clones", "$descend[self::svg:use]";

    38

    const "originals", "//svg:*[concat('#',@id) = $clones/@xlink:href]";

    39

    choose {

    40

        when "$originals"

    41

            result "$descend | func:refered_elements($originals)";

    42

        otherwise

    43

            result "$descend";

    44

    }

    45

}

    46

    47

// variable "overlapping_geometry" was added for optimization.

    48

// It avoids calling func:overlapping_geometry 3 times for each page

    49

// (apparently libxml doesn't cache exslt function results)

    50

// in order to optimize further, func:overlapping_geometry 

    51

// should be implemented in python or even C,

    52

// as this is still the main bottleneck here

    53

const "_overlapping_geometry" {

    54

    foreach "$hmi_pages | $keypads" {

    55

        const "k", "concat('overlapping:', @id)";

    56

        value "ns:ProgressStart($k, concat('collecting membership of ', @inkscape:label))";

    57

        elt {

    58

            attrib "id" > «@id»

    59

            copy "func:overlapping_geometry(.)";

    60

        }

    61

        value "ns:ProgressEnd($k)";

    62

    }

    63

}

    64

    65

const "overlapping_geometry", "exsl:node-set($_overlapping_geometry)";

    66

    67

def "func:all_related_elements" {

    68

    param "page";

    69

    const "page_overlapping_geometry", "$overlapping_geometry/elt[@id = $page/@id]/*";

    70

    const "page_overlapping_elements", "//svg:*[@id = $page_overlapping_geometry/@Id]";

    71

    const "page_widgets_elements", """

    72

        $hmi_elements[not(@id=$page/@id)

    73

                      and descendant-or-self::svg:*/@id = $page_overlapping_elements/@id]

    74

        /descendant-or-self::svg:*""";

    75

    const "page_sub_elements", "func:refered_elements($page | $page_overlapping_elements | $page_widgets_elements)";

    76

    result "$page_sub_elements";

    77

}

    78

    79

    80

def "func:required_elements" {

    81

    param "pages"; 

    82

    choose{

    83

        when "$pages"{

    84

            result """func:all_related_elements($pages[1])

    85

                      | func:required_elements($pages[position()!=1])""";

    86

        }otherwise{

    87

            result "/..";

    88

        }

    89

    }

    90

}

    91

    92

const "required_page_elements",

    93

    "func:required_elements($hmi_pages | $keypads)/ancestor-or-self::svg:*";

    94

    95

const "required_list_elements", "func:refered_elements(($hmi_lists | $hmi_textlists)[@id = $required_page_elements/@id])/ancestor-or-self::svg:*";

    96

    97

const "required_elements", "$defs | $required_list_elements | $required_page_elements";

    98

    99

const "discardable_elements", "//svg:*[not(@id = $required_elements/@id)]";

   100

   101

def "func:sumarized_elements" {

   102

    param "elements";

   103

    const "short_list", "$elements[not(ancestor::*/@id = $elements/@id)]";

   104

    const "filled_groups", """$short_list/parent::*[

   105

        not(child::*[

   106

            not(@id = $discardable_elements/@id) and

   107

            not(@id = $short_list/@id)

   108

        ])]""";

   109

    const "groups_to_add", "$filled_groups[not(ancestor::*/@id = $filled_groups/@id)]";

   110

    result "$groups_to_add | $short_list[not(ancestor::*/@id = $filled_groups/@id)]";

   111

}

   112

   113

def "func:detachable_elements" {

   114

    param "pages";

   115

    choose{

   116

        when "$pages"{

   117

            result """func:sumarized_elements(func:all_related_elements($pages[1]))

   118

                      | func:detachable_elements($pages[position()!=1])""";

   119

        }otherwise{

   120

            result "/..";

   121

        }

   122

    }

   123

}

   124

   125

// Avoid nested detachables

   126

const "_detachable_elements", "func:detachable_elements($hmi_pages | $keypads)";

   127

const "detachable_elements", "$_detachable_elements[not(ancestor::*/@id = $_detachable_elements/@id)]";

   128

   129

emit "declarations:detachable-elements" {

   130

    |

   131

    | var detachable_elements = {

   132

    foreach "$detachable_elements"{

   133

    |     "«@id»":[id("«@id»"), id("«../@id»")]`if "position()!=last()" > ,`

   134

    }

   135

    | }

   136

}

   137

   138

const "forEach_widgets_ids", "$parsed_widgets/widget[@type = 'ForEach']/@id";

   139

const "forEach_widgets", "$hmi_widgets[@id = $forEach_widgets_ids]";

   140

const "in_forEach_widget_ids", "func:refered_elements($forEach_widgets)[not(@id = $forEach_widgets_ids)]/@id";

   141

   142

template "svg:*", mode="page_desc" {

   143

    if "ancestor::*[@id = $hmi_pages/@id]" error > HMI:Page «@id» is nested in another HMI:Page

   144

   145

   146

    const "desc", "func:widget(@id)";

   147

    const "pagename", "$desc/arg[1]/@value";

   148

    const "msg", "concat('generating page description ', $pagename)";

   149

    value "ns:ProgressStart($pagename, $msg)";

   150

    const "page", ".";

   151

    const "p", "$geometry[@Id = $page/@id]";

   152

   153

    const "page_all_elements", "func:all_related_elements($page)";

   154

   155

    const "all_page_widgets","$hmi_widgets[@id = $page_all_elements/@id and @id != $page/@id]";

   156

    const "page_managed_widgets","$all_page_widgets[not(@id=$in_forEach_widget_ids)]";

   157

    const "page_relative_widgets",

   158

        "$page_managed_widgets[func:is_descendant_path(func:widget(@id)/path/@value, $desc/path/@value)]";

   159

   160

    // Take closest ancestor in detachable_elements

   161

    // since nested detachable elements are filtered out

   162

    const "sumarized_page", 

   163

        """func:sumarized_elements($page_all_elements)""";

   164

   165

    const "required_detachables", 

   166

        """$sumarized_page/

   167

           ancestor-or-self::*[@id = $detachable_elements/@id]""";

   168

   169

    |   "«$pagename»": {

   170

    //|     widget: hmi_widgets["«@id»"],

   171

    |     bbox: [«$p/@x», «$p/@y», «$p/@w», «$p/@h»],

   172

    if "$desc/path/@value" {

   173

        if "count($desc/path/@index)=0"

   174

            warning > Page id="«$page/@id»" : No match for path "«$desc/path/@value»" in HMI tree

   175

    |     page_index: «$desc/path/@index»,

   176

    |     page_class: "«$indexed_hmitree/*[@hmipath = $desc/path/@value]/@class»",

   177

    }

   178

    |     widgets: [

   179

    foreach "$page_managed_widgets" {

   180

        const "widget_paths_relativeness" 

   181

            foreach "func:widget(@id)/path" {

   182

                value "func:is_descendant_path(@value, $desc/path/@value)";

   183

                if "position()!=last()" > ,

   184

            }

   185

    |         [hmi_widgets["«@id»"], [«$widget_paths_relativeness»]]`if "position()!=last()" > ,`

   186

    }

   187

    |     ],

   188

    |     jumps: [

   189

    foreach "$parsed_widgets/widget[@id = $all_page_widgets/@id and @type='Jump']" {

   190

    |         hmi_widgets["«@id»"]`if "position()!=last()" > ,`

   191

    }

   192

    |     ],

   193

    |     required_detachables: {

   194

    foreach "$required_detachables" {

   195

    |         "«@id»": detachable_elements["«@id»"]`if "position()!=last()" > ,`

   196

    }

   197

    |     }

   198

    apply "$parsed_widgets/widget[@id = $all_page_widgets/@id]", mode="widget_page"{

   199

        with "page_desc", "$desc";

   200

    }

   201

    |   }`if "position()!=last()" > ,`

   202

    value "ns:ProgressEnd($pagename)";

   203

}

   204

   205

emit "definitions:page-desc" {

   206

    |

   207

    | var page_desc = {

   208

    apply "$hmi_pages", mode="page_desc";

   209

    | }

   210

}

   211

   212

template "*", mode="widget_page";

   213

   214

   215

emit "debug:detachable-pages" {

   216

    |

   217

    | DETACHABLES:

   218

    foreach "$detachable_elements"{

   219

        |  «@id»

   220

    }

   221

    | DISCARDABLES:

   222

    foreach "$discardable_elements"{

   223

        |  «@id»

   224

    }

   225

    | In Foreach:

   226

    foreach "$in_forEach_widget_ids"{

   227

        |  «.»

   228

    }

   229

    | Overlapping 

   230

    apply "$overlapping_geometry", mode="testtree";

   231

}