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

    const "screensaverpage", "$hmi_pages_descs[arg[1]/@value = 'ScreenSaver']";

    29

    const "delay" choose {

    30

        when "$screensaverpage" {

    31

            const "delaystr", "$screensaverpage/arg[2]/@value";

    32

            if "not(regexp:test($delaystr,'^[0-9]+$'))"

    33

                error > ScreenSaver page has missing or malformed delay argument.

    34

            value "$delaystr";

    35

        }

    36

        otherwise > null

    37

    }

    38

    | var screensaver_delay = «$delay»;

    39

}

    40

    41

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

    42

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

    43

    44

// returns all directly or indirectly refered elements

    45

def "func:refered_elements" {

    46

    param "elems";

    47

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

    48

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

    49

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

    50

    choose {

    51

        when "$originals"

    52

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

    53

        otherwise

    54

            result "$descend";

    55

    }

    56

}

    57

    58

// variable "overlapping_geometry" was added for optimization.

    59

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

    60

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

    61

// in order to optimize further, func:overlapping_geometry 

    62

// should be implemented in python or even C,

    63

// as this is still the main bottleneck here

    64

const "_overlapping_geometry" {

    65

    foreach "$hmi_pages | $keypads" {

    66

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

    67

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

    68

        elt {

    69

            attrib "id" > «@id»

    70

            copy "func:overlapping_geometry(.)";

    71

        }

    72

        value "ns:ProgressEnd($k)";

    73

    }

    74

}

    75

    76

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

    77

    78

def "func:all_related_elements" {

    79

    param "page";

    80

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

    81

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

    82

    const "page_widgets_elements", """

    83

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

    84

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

    85

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

    86

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

    87

    result "$page_sub_elements";

    88

}

    89

    90

    91

def "func:required_elements" {

    92

    param "pages"; 

    93

    choose{

    94

        when "$pages"{

    95

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

    96

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

    97

        }otherwise{

    98

            result "/..";

    99

        }

   100

    }

   101

}

   102

   103

const "required_page_elements",

   104

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

   105

   106

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

   107

   108

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

   109

   110

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

   111

   112

def "func:sumarized_elements" {

   113

    param "elements";

   114

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

   115

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

   116

        not(child::*[

   117

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

   118

            not(@id = $short_list/@id)

   119

        ])]""";

   120

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

   121

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

   122

}

   123

   124

def "func:detachable_elements" {

   125

    param "pages";

   126

    choose{

   127

        when "$pages"{

   128

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

   129

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

   130

        }otherwise{

   131

            result "/..";

   132

        }

   133

    }

   134

}

   135

   136

// Avoid nested detachables

   137

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

   138

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

   139

   140

emit "declarations:page-class" {

   141

    | class PageWidget extends Widget{}

   142

}

   143

   144

emit "declarations:detachable-elements" {

   145

    |

   146

    | var detachable_elements = {

   147

    foreach "$detachable_elements"{

   148

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

   149

    }

   150

    | }

   151

}

   152

   153

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

   154

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

   155

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

   156

   157

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

   158

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

   159

   160

   161

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

   162

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

   163

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

   164

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

   165

    const "page", ".";

   166

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

   167

   168

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

   169

   170

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

   171

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

   172

   173

    const "page_root_path", "$desc/path[not(@assign)]";

   174

    if "count($page_root_path)>1"

   175

        error > Page id="«$page/@id»" : only one root path can be declared

   176

   177

    const "page_relative_widgets",

   178

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

   179

   180

    // Take closest ancestor in detachable_elements

   181

    // since nested detachable elements are filtered out

   182

    const "sumarized_page", 

   183

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

   184

   185

    const "required_detachables", 

   186

        """$sumarized_page/

   187

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

   188

   189

    |   "«$pagename»": {

   190

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

   191

    if "count($page_root_path)=1"{

   192

        if "count($page_root_path/@index)=0"

   193

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

   194

    |     page_index: «$page_root_path/@index»,

   195

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

   196

    }

   197

    |     widgets: [

   198

    |         [hmi_widgets["«$page/@id»"], []],

   199

    foreach "$page_managed_widgets" {

   200

        const "widget_paths_relativeness" 

   201

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

   202

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

   203

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

   204

            }

   205

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

   206

    }

   207

    |     ],

   208

    |     jumps: [

   209

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

   210

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

   211

    }

   212

    |     ],

   213

    |     required_detachables: {

   214

    foreach "$required_detachables" {

   215

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

   216

    }

   217

    |     }

   218

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

   219

        with "page_desc", "$desc";

   220

    }

   221

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

   222

    value "ns:ProgressEnd($pagename)";

   223

}

   224

   225

emit "definitions:page-desc" {

   226

    |

   227

    | var page_desc = {

   228

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

   229

    | }

   230

}

   231

   232

template "*", mode="widget_page";

   233

   234

   235

emit "debug:detachable-pages" {

   236

    |

   237

    | DETACHABLES:

   238

    foreach "$detachable_elements"{

   239

        |  «@id»

   240

    }

   241

    | DISCARDABLES:

   242

    foreach "$discardable_elements"{

   243

        |  «@id»

   244

    }

   245

    | In Foreach:

   246

    foreach "$in_forEach_widget_ids"{

   247

        |  «.»

   248

    }

   249

    | Overlapping 

   250

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

   251

}