From f42ae47fe425b8ef353ec72ff9edaff451206cb8 Mon Sep 17 00:00:00 2001 From: wang_zhiqiang Date: Mon, 3 Dec 2018 13:18:47 +0800 Subject: change readme --- doc/parts/show_hide_onscreen.png | Bin 76169 -> 0 bytes doc/parts/show_hide_onscreen.pu | 80 --------------------------------------- doc/parts/startup.png | Bin 30290 -> 0 bytes doc/parts/startup.pu | 33 ---------------- doc/readme.md | 44 +++++++++++++++++++++ sample/readme.md | 37 ------------------ 6 files changed, 44 insertions(+), 150 deletions(-) delete mode 100644 doc/parts/show_hide_onscreen.png delete mode 100644 doc/parts/show_hide_onscreen.pu delete mode 100644 doc/parts/startup.png delete mode 100644 doc/parts/startup.pu create mode 100644 doc/readme.md delete mode 100644 sample/readme.md diff --git a/doc/parts/show_hide_onscreen.png b/doc/parts/show_hide_onscreen.png deleted file mode 100644 index 933540e..0000000 Binary files a/doc/parts/show_hide_onscreen.png and /dev/null differ diff --git a/doc/parts/show_hide_onscreen.pu b/doc/parts/show_hide_onscreen.pu deleted file mode 100644 index b72ccb1..0000000 --- a/doc/parts/show_hide_onscreen.pu +++ /dev/null @@ -1,80 +0,0 @@ -@startuml - -title Show/Hide Onscreenapp Sequence - -actor User -entity HomeScreen_Service as HSS -entity App -entity Onscreenapp -entity WindowManagere as WM - -== show Onscreenapp == -User->App: display Onscreenapp by user operation -App->HSS: subscribe replyShowWindow event -App->HSS: call showWindow() -note right -{ "application_id": "onscreenapp", - "parameter": { - "file": "qml file path", - "data": {...} - } -} -end note -HSS->HSS: get app's id -HSS->Onscreenapp: push showWindow event -note right -{ "application_id": "onscreenapp", - "parameter": { - "file": "qml file path", - "data": {...}, - "replyid": "app's id" - } -} -end note -Onscreenapp->WM: activateWindow("on_screen.app") - -alt display able -WM->Onscreenapp: SyncDraw -Onscreenapp->Onscreenapp: load app's qml -Onscreenapp->WM: EndDraw("on_screen.app") -WM->Onscreenapp: VISIBLE("on_screen.app") - -else display disable -rnote over Onscreenapp -do nothing -end rnote -end - -== hide Onscreenapp == -alt touch Onscreenapp's button -User->Onscreenapp: touch Onscreenapp's button -Onscreenapp->WM: deactivateWindow("on_screen.app") -Onscreenapp->Onscreenapp: unload qml -Onscreenapp->HSS: call replyShowWindow() -note right -{ "application_id": "app's id", - "parameter": { - "method": "Buttons.ButtonPress", - "buttonName": "pressed button name", - "buttonPressMode": "Short" - } -} -end note -WM->Onscreenapp: INVISIBLE("on_screen.app") -HSS->App: push replyShowWindow event -App->App: call button function - -else hide by App - -App->HSS: call hideWindow("onscreenapp") -note right -{ "application_id": "onscreenapp"} -end note -HSS->Onscreenapp: push hideWindow event -Onscreenapp->Onscreenapp: unload qml -Onscreenapp->WM: deactivateWindow("on_screen.app") -WM->Onscreenapp: INVISIBLE("on_screen.app") - -end - -@enduml diff --git a/doc/parts/startup.png b/doc/parts/startup.png deleted file mode 100644 index b292357..0000000 Binary files a/doc/parts/startup.png and /dev/null differ diff --git a/doc/parts/startup.pu b/doc/parts/startup.pu deleted file mode 100644 index 95c9f95..0000000 --- a/doc/parts/startup.pu +++ /dev/null @@ -1,33 +0,0 @@ -@startuml - -title Onscreenapp Startup Sequence - -entity Systemd -entity HomeScreen_Service -entity Onscreenapp -entity WindowManager as WM - -== System StartUp == - -Systemd->Onscreenapp: start - -group WindowManger Initilize -Onscreenapp->WM: init(port, token) -Onscreenapp->WM: requestSurface("on_screen.app") -rnote over WM -WM process -end rnote -Onscreenapp<--WM: return SurfaceID -Onscreenapp->WM: subscribe Event_SyncDraw -Onscreenapp->WM: subscribe Event_Visible -Onscreenapp->WM: subscribe Event_Invisible -end - -group HomeScreen_Service Initilize -Onscreenapp->HomeScreen_Service: init(port, token) -Onscreenapp->HomeScreen_Service: subscribe showWindow Event -Onscreenapp->HomeScreen_Service: subscribe hideWindow Event -Onscreenapp->Onscreenapp: qmlLoad() -end - -@enduml \ No newline at end of file diff --git a/doc/readme.md b/doc/readme.md new file mode 100644 index 0000000..0b6ba93 --- /dev/null +++ b/doc/readme.md @@ -0,0 +1,44 @@ + +usage of onscreenapp +=== + +## dependence + +Onscreenapp depend on libhomescreen add agl-service-homescreen as below: +- libhomescreen must have 'showWindow/hideWindow/replyShowWindow' event + and 'showWindow/hideWindow/replyShowWindow' interface. +- agl-service-homescreen must have 'showWindow/hideWindow/replyShowWindow' verbs. + +## sequence + +show/hide onscreen sequence. +- ![showOnscreen.svg](parts/showOnscreen.svg) + +## about sample 'onstestapp' +onstestapp is a sample to use onscreenapp. + +### compile & install +- compile + - when onscreenapp is compiled, this app's wgt file will exist at "onscreenapp/sample/package" which called onstestapp.wgt. + +- install + `afm-util install onstestapp.wgt;sync` + +### onstestapp usage + +Before start onstestapp you must copy all files in "qml" folder to "$HOME/app-data/OnScreen/onstestapp/" on your board(R-car M3 etc.), +then do as below: + +1. start onstestapp in launcher +2. select onscreen type +3. press "Post" button + +### edit parameter with keyboard + +You also can edit the text which will post to onscreen, do as below: + +- comment below contents in /etc/xdg/weston/weston.ini + - `#ivi-input-module=ivi-input-controller.so` + +- before press "Post" button, touch text area to call keyboard and edit the text. + diff --git a/sample/readme.md b/sample/readme.md deleted file mode 100644 index a48f3e0..0000000 --- a/sample/readme.md +++ /dev/null @@ -1,37 +0,0 @@ - -A test application for onscreenapp -=== - -## compile & install - -- compile - - when onscreenapp is compiled, this app's wgt file will exist at "onscreenapp/sample/package" which called onstestapp.wgt. - -- install - `afm-util install onstestapp.wgt;sync` - -## dependence - -Onscreenapp depend on libhomescreen add agl-service-homescreen as below: -- libhomescreen must have 'showWindow/hideWindow/replyShowWindow' event - and 'showWindow/hideWindow/replyShowWindow' interface. -- agl-service-homescreen must have 'showWindow/hideWindow/replyShowWindow' verbs. - -## usage - -Before start onstestapp you must copy all files in "qml" folder to "$HOME/app-data/OnScreen/onstestapp/" on your board(R-car M3 etc.), -then do as below: - -1. start onstestapp in launcher -2. select onscreen type -3. press "Post" button - -## edit parameter with keyboard - -You also can edit the text which will post to onscreen, do as below: - -- comment below contents in /etc/xdg/weston/weston.ini - - `#ivi-input-module=ivi-input-controller.so` - -- before press "Post" button, touch text area to call keyboard and edit the text. - -- cgit 1.2.3-korg