Rename WindowManager APIs

Fixed

Description

We will rename WindowManager APIs as follows:

  • activateSurface => activateWindow

  • deactivateSurface => deactivateWindow

The "surface" means information of display material frame buffer managed by Graphics Subsystem (Weston).

And the "window" means the right to draw on display.

The "surface" is physical information and used inside WindowManager.
Therefoe we think it is not good for "surface" to be included in API name.
These APIs provide the function which is to activate/deactivate the right to draw for the applications.
So we change to "activateWindow/deactivateWindow".

We plan to delete the old API by GG.
Therefore the applications can use old APIs until GG,
but the warning "-Wdeprecated-declarations" is occured when compile.
After GG, old APIs can not be used.
If use it, the error is occured when compile.

Environment

None

Activity

Show:

Walt Miner 
August 16, 2018 at 7:52 PM

Close for FF RC3

knimitz 
July 27, 2018 at 7:21 AM

I created . Close this ticket.

knimitz 
July 9, 2018 at 2:59 AM

Sure. I agree with you. 

For native application, I and Tanikawa-san discuss then the version of current libwindowmanager whose API depends on json-c should be 1.0 in FF and move 2.0 after serving API which not depends on json-c to GG.

Tadao Tanikawa 
July 8, 2018 at 7:06 AM

I propose removing dependency to json-c from libwindowmanager and also prefer qlibwindowmanager should be deprecated at the same time.

The following are the reason,

  • Current all API in libwindowmanager depends on json-c (e.g. the parameter of API is json_object *). This is undesirable.

  • Qlibwindowmanager tries to abstract json-c dependency. But this is not necessary if libwindowmanager was not dependent to json-c.

  • Qt should not be extended by additional library. It should be done by Qt module like Qt Android Extras, Qt AGL Extras.

Details

Assignee

Reporter

Fix versions

Labels

Components

Affects versions

Priority

Created July 5, 2018 at 6:57 AM
Updated August 20, 2018 at 1:42 AM
Resolved July 27, 2018 at 7:21 AM