Tizen extension

tizen_surface

version 1
tizen-specific surface

The tizen_surface provides tizen-specific functionalities for the given surface.

get_tizen_resource(id: new_id<tizen_resource>, surface: object<wl_surface>)
Argument
Type
Description
idnew_id<tizen_resource>
the new tizen_resource object
surfaceobject<wl_surface>
the surface object
get a tizen_resource object

Create a tizen_resource interface for the given surface.

destroy
Type: destructor
destroy()
destroy tizen_surface

Destroy this tizen_surface object.


global resource id

This tizen_resource provides a global resource id. It is a unique id which is provided by the display server.

destroy
Type: destructor
destroy()
destroy tizen_resource

Destroy this tizen_resource object.

resource_id(id: uint)
Argument
Type
Description
iduint
the global resource id
a global resource id

The resource_id event is sent immediately upon the tizen_resource object creation by the display server. The id is a unique id which is generated by the display server.


tizen_policy

version 13
tizen-specific policy for window management

The tizen_policy provides tizen-specific requests and events for window management at Tizen Platform.

[TODO] Explain the window layer at the display server. Need to explain the window layer to understand the requests and the events at tizen_policy interface.

get_visibility(id: new_id<tizen_visibility>, surface: object<wl_surface>)
Argument
Type
Description
idnew_id<tizen_visibility>
the new visibility object
surfaceobject<wl_surface>
the surface object
get a visibility object

Create a visibility interface for the given surface.

get_position(id: new_id<tizen_position>, surface: object<wl_surface>)
Argument
Type
Description
idnew_id<tizen_position>
the new position object
surfaceobject<wl_surface>
the surface object
get a position object

Create a position interface for the given surface. [TODO]: need to explain the relationship with zxdg_positioner_v6

activate(surface: object<wl_surface>)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
activate the surface

Activate the given surface. A client requests this when a client wants to raise at the top of the windows stack in the window's layer at the display server and also wants to get a keyboard focus from the display server. However the display server does not always set the focus on the reqested surface. It depends on the focus policy of the display server. A client just demands a keyboard focus via this request.

activate_below_by_res_id(res_id: uint, below_res_id: uint)
Argument
Type
Description
res_iduint
the global resource id
below_res_iduint
the global resource id
activate the res_id and position below res_id

Activate the surface associated with the given res_id and position it below the surface associated with the below_res_id. A client uses this reuquest when it want to change the order of the window stack with the gloal resource ids which are the surfaces belonging to different processes. However, this requestit does not work when the surface associated with the below_res_id is a parent of the surface assicated with the res_id.

raise(surface: object<wl_surface>)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
raise the surface

This request raises the given surface to the top of the window stack in a window layer. A client can decide the window layer with the window_type for the given surface through the set_type request of tizen_policy interface. The surface positions at the top in the window layer.

lower(surface: object<wl_surface>)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
lower the surface

This request lowers the given surface to the bottom of the window stack in a window layer. The surface positions at the bottom in the window layer.

lower_by_res_id(res_id: uint)
Argument
Type
Description
res_iduint
the global resource id
lower the res_id

This request lowers the surface associated with the given res_id to the bottom of the window stack in a window layer. The surface positions at the bottom in the window layer.

set_focus_skip(surface: object<wl_surface>)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
be unable to be the focused surface

This request makes the given surface unable to be the focused surface. The display server must not give the focus to the surface.

unset_focus_skip(surface: object<wl_surface>)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
enable to be the focused surface

This request makes the given surface enable to be the focused surface.

set_role(surface: object<wl_surface>, role: string)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
rolestring
the name of the role
set the role of the surface

Give the role to the given surface. A client set the tizen-specific role of the surface except for the role of xdg_surface interface, xdg_top_level, xdg_popup and so on.

set_type(surface: object<wl_surface>, win_type: uint)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
win_typeuint
the window type
set the type of the surface

Set the type of the given surface. The display server use the window type for the policy of the window management which are focus management, visibility management, stack management and so on.

set_conformant(surface: object<wl_surface>)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
set the conformant(adaptational) surface

Set the conformant surface. The conformant surface can get the event through which the display server notifies the area covered by the compormant_part that is the surface in another client.

unset_conformant(surface: object<wl_surface>)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
unset the conformant(adaptational) surface

Unset the conformant surface.

get_conformant(surface: object<wl_surface>)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
check the conformant surface

Ask if the given surface is the conformant surface or not. The display server sents the result via the confirmant event.

set_notification_level(surface: object<wl_surface>, level: int)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
levelint
the z-order value
set the level in the notification

This request sets the level in the notification layer. The display server decides the z-order with the given level in the notification layer.

set_transient_for(child_id: uint, parent_id: uint)
Argument
Type
Description
child_iduint
the global resource id for the child surface
parent_iduint
the globacl resource is for the parent surface
set the transient parent for parent_id

This request sets the transient parent for the surface associated with the parent_id. The surface associated with the given child_id becomes a transient children for the surface associated with the parent_id.

unset_transient_for(child_id: uint)
Argument
Type
Description
child_iduint
the global resource id for the child surface
unset the transient parent/child relationship

This reuqest unsets the transient parent on the surface associated with the child_id.

set_window_screen_mode(surface: object<wl_surface>, mode: uint)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
modeuint
the screen mode
set the screen mode to the surface

A client sets the screen mode which it wants the screen to be as long as the given surface is shown on the screen.

place_subsurface_below_parent(subsurface: object<wl_subsurface>)
Argument
Type
Description
subsurfaceobject<wl_subsurface>
the subsurface object
place the subsurace below the parent surface

This request places the surface of the subsurface below its' parent surface.

set_subsurface_stand_alone(subsurface: object<wl_subsurface>)
Argument
Type
Description
subsurfaceobject<wl_subsurface>
the subsurface object
make the subsurface be a stand_alone mode

This request makes the surface associated with the given subsurface not follow the policy of the window managment triggered by the parent surface. The window policy of the surface associated with the given subsurface is not affected by its parent surface.

get_subsurface(id: new_id<wl_subsurface>, surface: object<wl_surface>, parent_id: uint)
Argument
Type
Description
idnew_id<wl_subsurface>
the new subsurface object
surfaceobject<wl_surface>
the surface object
parent_iduint
the global reosurce id
get the subsurface of the surface with the parent_id

Get the subsurface of the given surface with the global resource parent_id.

set_opaque_state(surface: object<wl_surface>, state: int)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
stateint
set the opaque state to the surface

Set the opaque state to the given surface. The display server makes this surface be opaque even if the color depth of the buffer attached to the surface is 32 depth.

iconify(surface: object<wl_surface>)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
set the iconified state to the surface

Set the iconified state to the given surface. The iconfied state is the window state in which the surface is not showing on the screen.

uniconify(surface: object<wl_surface>)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
set the uniconified state to the surface

Set the uniconified state to the given surface. The uniconfied state is the window state in which the iconified surface is showing on the screen.

add_aux_hint(surface: object<wl_surface>, id: int, name: string, value: string)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
idint
the id of the auxiliary hint
namestring
the name of the auxiliary hint
valuestring
the vaule of the auxiliary hint
add the information of the auxiliary hint to the surface

Add the information of the auxiliary hint to the given surface. The name and the value are changed when the display server already has the same id with which the client sends this request.

change_aux_hint(surface: object<wl_surface>, id: int, value: string)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
idint
the id of the auxiliary hint
valuestring
the vaule of the auxiliary hint
change the value of the auxiliary hint to the surface

Change the value of the auxiliary hint id which the surface has.

del_aux_hint(surface: object<wl_surface>, id: int)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
idint
the id of the auxiliary hint
delete the information of the auxiliry hint

Delete the information of the auxiliary hint associated the hint id which the given surface has.

get_supported_aux_hints(surface: object<wl_surface>)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
get the aux hints

Get the ids of the aux hints which the given surface supports. The display server send the supported_aux_hints events as the reply of this requrest.

set_background_state(pid: uint)
Argument
Type
Description
piduint
the process id
set the background state

Set the all surfaces associated with the given pid to be the background state. The surfaces set to be the hide state and cannot show on a screen even if the client send the show request and the activate request.

unset_background_state(pid: uint)
Argument
Type
Description
piduint
the process id
unset the background state

Set the all surfaces associated with the given pid not to be the background state. The sufaces can allow to be showed and to be activated by the client's request.

set_floating_mode(surface: object<wl_surface>)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
set the floating mode

Set the floating mode to the given surface. The surface which sets to be floating mode can be a partial window and can position over other top-level windows.

unset_floating_mode(surface: object<wl_surface>)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
unset the floating mode

Unset the floating mode to the given surface. The geometry of the surface does not change and the z-order of it can be the same as the top-level windows.

set_stack_mode(surface: object<wl_surface>, mode: uint)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
modeuint
the stack mode
set the stack mode

Set the stack mode to the given surface. The surface can changes the z-order in the same layer by the stack mode.

activate_above_by_res_id(res_id: uint, above_res_id: uint)
Argument
Type
Description
res_iduint
the global resource id
above_res_iduint
the globacl resource id
activate and position over the above resource id

Activate the surface associated with the given res_id which is the global resource id and set to position over the surface assoicated with the above_res_id.

get_subsurface_watcher(id: new_id<tizen_subsurface_watcher>, surface: object<wl_surface>)
Argument
Type
Description
idnew_id<tizen_subsurface_watcher>
new tizen_subsurface_watcher object
surfaceobject<wl_surface>
the surface object
get the subsurface watcher

Get the subsurface watcher associated with the given surface. A client can get the information about the subsurface associated with the surface.

set_parent(child: object<wl_surface>, parent: object<wl_surface>)
Argument
Type
Description
childobject<wl_surface>
the surface object
parentobject<wl_surface>
the surface object
set the parent

Set the parent/client relationship. The child surface position over the parent surface.

ack_conformant_region(surface: object<wl_surface>, serial: uint)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
serialuint
serial number
ack for tizen_policy@conformant_region

A client can refresh its surface for applying new conformant region which is from tizen_policy@conformant_region event. The client has to ack after complete of its updates by this request.

destroy
Type: destructorsince 6
destroy()
destroy the tizen_policy

Destroy this tizen_policy object.

has_video(surface: object<wl_surface>, has: uint)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
hasuint
1 is the tizen_video_object, or 0
check the tizen_video_object

A cleint sends the information that it has the tizen_video_object to the display server.

set_appid(pid: int, appid: string)
Argument
Type
Description
pidint
process id
appidstring
application id
set the application id

Set the application id associated with the given pid.

show(surface: object<wl_surface>)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
notify showing the surface

Notify showing the given surface. This request means that a client is going to attach the buffer to the given surface. There is nothing to do at the display server when a client sends this request.

hide(surface: object<wl_surface>)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
notify hiding the surface

Notify hiding the given surface. This request means that a client is going to attach the null buffer to the given surface. There is nothing to do at the display server when a client sends this request.

set_transient_for_below(child_id: uint, parent_id: uint)
Argument
Type
Description
child_iduint
parent_iduint
set transient_for and place under the transient_for parent

This makes a relationship between parent and child. A child is always placed under a parent.

set_parent_with_below(child: object<wl_surface>, parent: object<wl_surface>)
Argument
Type
Description
childobject<wl_surface>
the surface object
parentobject<wl_surface>allow null
set parent and place under the parent

This makes a relationship between parent and child. A child is always placed under a parent. Setting a null parent for a child window removes any parent-child relationship for the child.

set_maximize_direction(surface: object<wl_surface>, direction: uint<tizen_policy.maximize_direction>)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
directionuint<tizen_policy.maximize_direction>
maximize direction
set maximize direction

Set the maximize direction of the surface.

set_pin_mode(surface: object<wl_surface>)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
set pin mode

Set the pin mode of the surface.

unset_pin_mode(surface: object<wl_surface>)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
unset pin mode

Unset the pin mode of the surface.

set_layout(surface: object<wl_surface>, num_cols: uint, num_rows: uint, column: uint, row: uint, cols_span: uint, rows_span: uint)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
num_colsuint
the total number of columns
num_rowsuint
the total number of rows
columnuint
the column number to be positioned
rowuint
the row number to be positioned
cols_spanuint
the columns span
rows_spanuint
the rows span
set layout of the surface

Set the layout of the surface with the coordinates passed.

set_modal(surface: object<wl_surface>)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
set modal state

Set the modal state of the surface.

unset_modal(surface: object<wl_surface>)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
unset modal state

Unset the modal state of the surface.

conformant(surface: object<wl_surface>, is_conformant: uint)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
is_conformantuint
if the surface is conformant or not, 0 or 1
conformant event

Notify the client when a client sends the get_conformant request.

conformant_area(surface: object<wl_surface>, conformant_part: uint, state: uint, x: int, y: int, w: int, h: int)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
conformant_partuint
the name of the conformant part
stateuint
visible(1) or not(0)
xint
x position of the hiding area by conformant part
yint
y position of the hiding area by conformant part
wint
width of the hiding area by conformant part
hint
height of the hiding area by conformant part
conformant area event

Notify a client when the conformant area is caclulated by the another surface as the conformnat_part. This event does NOT guarantee the perfect composition of the conformant surface and the surface of the conformant part.

notification_done(surface: object<wl_surface>, level: int, error_state: uint)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
levelint
the z-order value
error_stateuint
the error type
done event of set_notification request

Notify a client when the surface is located in the z-order which has been reuqested via the set_notification_level request.

transient_for_done(child_id: uint)
Argument
Type
Description
child_iduint
the global resource id for the child surface
done event of set/unset transient_for

Notify a client when the surface associated with the child_id is to set the transient parent or when it is to unset the transient parent.

window_screen_mode_done(surface: object<wl_surface>, mode: uint, error_state: uint)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
modeuint
the screen mode
error_stateuint
the error type
done event for set_window_screen_mode request

Notify a client when the screen_mode from the client's request activates in the display server.

iconify_state_changed(surface: object<wl_surface>, iconified: uint, force: uint)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
iconifieduint
the iconfied or uniconified state, 1 or 0
forceuint
the iconfied is forced or not, 1 or 0
change event of the iconfied state

Notify a client when the iconfied state of the surface is changed. The iconfied state is not only changed when the client requets the iconify and uniconify but also changed when the iconfied state is decided by the display server.

supported_aux_hints(surface: object<wl_surface>, hints: array, num_hints: uint)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
hintsarray
the id array of the auxiliary hints
num_hintsuint
the number of hints
reply event for the get_supported_aux_hints request

Notify a client when the display server get the get_supported_aux_hints request. The display server send the id array of the suxiliary hints which the surface supports.

allowed_aux_hint(surface: object<wl_surface>, id: int)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
idint
the id of the auxiliary hint
event of the allowed auxiliary hint

Notify a client when the auxiliary hint which the given surface has is added and changed.

aux_message(surface: object<wl_surface>, key: string, value: string, options: array)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
keystring
the key string
valuestring
the vaule of the key
optionsarray
the array of option information
the auxiliary message event

Notify a client when the display server sends the auxiliary message. The display server can use this event when it notifies an additional information to the client.

conformant_region(surface: object<wl_surface>, conformant_part: uint, state: uint, x: int, y: int, w: int, h: int, serial: uint)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
conformant_partuint
the name of the conformant part
stateuint
visible(1) or not(0)
xint
x position of the hiding area by conformant part
yint
y position of the hiding area by conformant part
wint
width of the hiding area by conformant part
hint
height of the hiding area by conformant part
serialuint
serail number
notify of geometry values of conformant region(area)

The server can notify of conformant region(area) using this event. If client is received this event, client should ack for it using tizen_policy@ack_conformant_region request.

interactive_move_done(surface: object<wl_surface>, x: int, y: int, w: uint, h: uint, angle: int)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
xint
x-position after move
yint
y-position after move
wuint
width after move
huint
height after move
angleint
current angle of surface
interactive move is done

This event is sent when the display server finishes interactive moving the window. The changed geometry of the window is sent together.

interactive_resize_done(surface: object<wl_surface>, x: int, y: int, w: uint, h: uint, angle: int)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
xint
x-position after resize
yint
y-position after resize
wuint
width after resize
huint
height after resize
angleint
current angle of surface
interactive resize is done

This event is sent when the display server finishes interactive resizing the window. The changed geometry of the window is sent together.

Argument
Value
Description
none0
none
toplevel1
the toplevel
fullscreen2
the fullscreen state
maximized3
the maximize state
transient4
the transient relation state
menu5
the menu
dnd6
the dnd
custom7
the custom
notification8
the notification
utility9
the utility
dialog10
the dialog
dock11
the dock
splash12
the splash
desktopsince 1113
the desktop
window type of the surface

A client can set the window type through the set_type request with win_type values. The value gives the surface the window_state, the z-order at the window stack in the window layer and other types in the display server.

The following values are window types with z-order values in descending order. Those are notification, dnd, dock, splash, fullscreen, toplevel or maximized and desktop. The menu, dnd, notification, utility, dialog, dock, splash and desktop are the window type which is defined in netwm spefification. https://specifications.freedesktop.org/wm-spec/wm-spec-1.4.html#idm46148902270160

conformant_part { indicator, keyboard, clipboard } 
Argument
Value
Description
indicator0
the indicator surface
keyboard1
the keyboard surface
clipboard2
the clipboard surface
the name of conformant part

This value indicates the surface name at Tizen Platform.

error_state { none, permission_denied } 
Argument
Value
Description
none0
success
permission_denied1
the permission denied
error state

This describes the state of error.

level { 1, 2, 3, none, default, medium, high, top } 
Argument
Value
Description
10
the bottom default z-order
21
the bottom midium z-order
32
the bottom high z-order
none-1
the bottom lowest z-order
default10
the default z-order
medium20
the medium z-order
high30
the high z-order
top40
the top z-order
notification level

This is the level of the notification type. This level stands for the z-order in the notification layer at the display server. The none, 1, 2, 3, default, medium, high and top is z-order in ascending order. The lower number value means the lower z-order.

mode { default, always_on } 
Argument
Value
Description
default0
the default screen mode
always_on1
keep the screen turn on
screen mode

This value means how the screen is to operate.

stack_mode { none, above, below } 
Argument
Value
Description
none0
above1
below2
mode for the relative stack order

The set_stack_mode request uses this mode values.

maximize_direction { none, all, left, right, top, bottom } 
Argument
Value
Description
none0
none. same to unmaximize
all1
the full size of the screen
left2
the left side of the screen
right3
the right side of the screen
top4
the top of the screen
bottom5
the bottom of the screen
direction values

These values are used by the set_maximize_direction as the paremater.


tizen-specific visibility

A client wants to know the visiblity information of the surface.

destroy()
destroy the tizen_visibility

Destroy this tizen_visiblity object.

notify(visibility: uint)
Argument
Type
Description
visibilityuint
visiblity type
notify the visiblity state

Notify a client when the visibility of the surface is changed.

changed(type: uint<tizen_visibility.visibility>, option: uint)
Argument
Type
Description
typeuint<tizen_visibility.visibility>
changed visibility type
optionuint
extra value
notify the changed visiblity type

Notify a client when the visibility of the surface is changed with the extra vaule.

Argument
Value
Description
unobscured0
fully showing on a screen
partially_obscured1
partially showing on a screen
fully_obscured2
not showing on a screen
pre_unobscuredsince 53
ready to be unobscured
visibility type

These are the visibilty types which tells how the surface assoicated with the tizen_visibility resource is showing on a screen or not.


tizen-specific position

A client can set the position information of the surface.

destroy
Type: destructor
destroy()
destroy the tizen_position

Destroy this tizen_position object.

set(x: int, y: int)
Argument
Type
Description
xint
x position
yint
y position
set the position

Set the position.

changed(x: int, y: int)
Argument
Type
Description
xint
x position
yint
y position
event of position changed

Notify a client when the posion is changed.



destroy()
set_geometry(surface: object<wl_surface>, serial: uint, x: int, y: int, w: int, h: int)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
serialuint
xint
yint
wint
hint
geometry_done(surface: object<wl_surface>, serial: uint, x: int, y: int, w: int, h: int, error_state: uint<tizen_move_resize.error_state>)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
serialuint
xint
yint
wint
hint
error_stateuint<tizen_move_resize.error_state>
Notify of set_geometry request result

tizen_gesture

version 2

grab_tap(fingers: uint, repeats: uint)
Argument
Type
Description
fingersuint
repeatsuint
ungrab_tap(fingers: uint, repeats: uint)
Argument
Type
Description
fingersuint
repeatsuint
grab_palm_cover()
ungrab_palm_cover()
select_palm_cover(surface: object<wl_surface>)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
deselect_palm_cover(surface: object<wl_surface>)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
activate_set(surface: object<wl_surface>, type: uint<tizen_gesture.type>, active: uint)
Argument
Type
Description
surfaceobject<wl_surface>allow null
typeuint<tizen_gesture.type>
activeuint
destroy
Type: destructorsince 2
destroy()
destroy the tizen_gesture

Destroy the tizen_gesture.

edge_swipe(mode: uint<tizen_gesture.mode>, fingers: uint, sx: int, sy: int, edge: uint<tizen_gesture.edge>)
Argument
Type
Description
modeuint<tizen_gesture.mode>
fingersuint
sxint
x coordinate of touch down point
syint
y coordinate of touch down point
edgeuint<tizen_gesture.edge>
edge_drag(mode: uint<tizen_gesture.mode>, fingers: uint, cx: int, cy: int, edge: uint<tizen_gesture.edge>)
Argument
Type
Description
modeuint<tizen_gesture.mode>
fingersuint
cxint
x coordinate of center touch point
cyint
y coordinate of center touch point
edgeuint<tizen_gesture.edge>
tap_notify(fingers: uint, repeats: uint, error: uint)
Argument
Type
Description
fingersuint
repeatsuint
erroruint
tap(mode: uint<tizen_gesture.mode>, fingers: uint, repeats: uint)
Argument
Type
Description
modeuint<tizen_gesture.mode>
fingersuint
repeatsuint
palm_cover_notify(surface: object<wl_surface>, error: uint)
Argument
Type
Description
surfaceobject<wl_surface>allow null
erroruint
palm_cover(surface: object<wl_surface>, mode: uint<tizen_gesture.mode>, duration: uint, cx: int, cy: int, size: uint, pressure: fixed)
Argument
Type
Description
surfaceobject<wl_surface>allow null
modeuint<tizen_gesture.mode>
durationuint
cxint
x coordinate of center touch point
cyint
y coordinate of center touch point
sizeuint
pressurefixed
activate_notify(surface: object<wl_surface>, type: uint<tizen_gesture.type>, active: uint, error: uint)
Argument
Type
Description
surfaceobject<wl_surface>allow null
typeuint<tizen_gesture.type>
activeuint
erroruint
Argument
Value
Description
edge_swipe1
edge_dragsince 22
tapsince 24
palm_coversince 28
pansince 216
pinchsince 232
palm_swipesince 264
mode { begin, update, end, done } 
Argument
Value
Description
begin1
update2
end3
done4
edge { top, right, bottom, left } 
Argument
Value
Description
top1
right2
bottom3
left4
edge_size { none, full, partial } 
Argument
Value
Description
none0
full1
partial2

an interface to set each focus for each key

In tradition, all the keys in a keyboard and a device on which some keys are attached will be sent to focus surface by default. Currently it's possible to set up each focus for each key in a keyboard and a device. Therefore, by setting a key grab for a surface, the owner of the surface will get the key event when it has the key grab for the key.

set_keygrab(surface: object<wl_surface>, key: uint, mode: uint)
Argument
Type
Description
surfaceobject<wl_surface>allow null
keyuint
modeuint
unset_keygrab(surface: object<wl_surface>, key: uint)
Argument
Type
Description
surfaceobject<wl_surface>allow null
keyuint
get_keygrab_status(surface: object<wl_surface>, key: uint)
Argument
Type
Description
surfaceobject<wl_surface>allow null
keyuint
set_keygrab_list(surface: object<wl_surface>, grab_list: array)
Argument
Type
Description
surfaceobject<wl_surface>allow null
grab_listarray
array of two integer variables pairs each pairs consist of keycode and keygrab mode
unset_keygrab_list(surface: object<wl_surface>, ungrab_list: array)
Argument
Type
Description
surfaceobject<wl_surface>allow null
ungrab_listarray
array of integer variables meaning keycode wanted to ungrab
get_keygrab_list(surface: object<wl_surface>)
Argument
Type
Description
surfaceobject<wl_surface>allow null
set_register_none_key(surface: object<wl_surface>, data: uint)
Argument
Type
Description
surfaceobject<wl_surface>allow null
datauint
get_keyregister_status(data: uint)
Argument
Type
Description
datauint
set_input_config(surface: object<wl_surface>, config_mode: uint, value: uint)
Argument
Type
Description
surfaceobject<wl_surface>allow null
config_modeuint
valueuint
destroy
Type: destructor
destroy()
destroy the tizen_keyrouter

Destroy the tizen_keyrouter.

keygrab_notify(surface: object<wl_surface>, key: uint, mode: uint, error: uint)
Argument
Type
Description
surfaceobject<wl_surface>allow null
keyuint
modeuint
erroruint
keygrab_notify_list(surface: object<wl_surface>, grab_result: array)
Argument
Type
Description
surfaceobject<wl_surface>allow null
grab_resultarray
array of three integer variables pairs each pairs consist of keycode, keygrab mode and keygrab result
getgrab_notify_list(surface: object<wl_surface>, grab_result: array)
Argument
Type
Description
surfaceobject<wl_surface>allow null
grab_resultarray
array of two integer variables pairs each pairs consist of keycode, keygrab mode
set_register_none_key_notify(surface: object<wl_surface>, mode: uint)
Argument
Type
Description
surfaceobject<wl_surface>allow null
modeuint
keyregister_notify(status: uint)
Argument
Type
Description
statusuint
set_input_config_notify(status: uint)
Argument
Type
Description
statusuint
key_cancel(key: uint)
Argument
Type
Description
keyuint
event_surface(surface: object<wl_surface>, key: uint, mode: uint)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
keyuint
modeuint
Argument
Value
Description
none0
no error
invalid_surface1
Given surface is invalid.
invalid_key2
Given key is invalid.
invalid_mode3
Given mode is invalid.
grabbed_already4
The key has been grabbed already.
no_permission5
The wl client has no permission to grab the key.
no_system_resources6
System resources are insufficient.
invalid_array7
Given array has invalid pairs or data type.
Argument
Value
Description
none0
none
shared1
mode to get a key grab with the other client surfaces when the focused client surface gets the key
topmost2
mode to get a key grab when the client surface is the top most surface
overridable_exclusive3
mode to get a key grab exclusively, overridably regardless of the order in the surface stack
exclusive4
mode to get a key grab exclusively regardless of the order in surface stack
registered5
mode to get a key grab only when a requesting surface is on top among the registering surfaces for the key
mode for a key grab

This value is used to set a mode for a key grab. With this mode and the order of the surface between surfaces' stack, the compositor will determine the destination client surface.

Argument
Value
Description
none0
none
invisible_set1
mode to set window to enable send event to invisible window below in stack
invisible_get2
mode to set window to get event to invisible state if any top window has set register_set
num_key_focus3
mode to register for num keys for focus window
picture_off4
mode to set picture off for particular key
mode for setting specific property for Key delivery

This value is used to set a mode for a window. With this mode and the order of the surface between surfaces' stack, the compositor will determine the destination client surface.


interface for tizen-screenshooter

Clients can get a screenmirror object from this interface.

get_screenmirror(id: new_id<tizen_screenmirror>, output: object<wl_output>)
Argument
Type
Description
idnew_id<tizen_screenmirror>
new screenmirror object
outputobject<wl_output>
output object for screenmirror
create a screenmirror object

Before using screenmirror, a client should get a screenmirror object from display server.

set_oneshot_auto_rotation(set: uint)
Argument
Type
Description
setuint
set screen shot auto rotation value

Client can set auto rotation value for one shot.

destroy()
destroy the tizen_screenshooter

Destroy the tizen_screenshooter.

shoot(output: object<wl_output>, buffer: object<wl_buffer>)
Argument
Type
Description
outputobject<wl_output>
bufferobject<wl_buffer>
format(format: uint)
Argument
Type
Description
formatuint
supported format for screenshooter

The tbm format codes match the #defines in tbm_surface.h. The formats actually supported by the compositor will be reported by the format event.

screenshooter_notify(noti: uint)
Argument
Type
Description
notiuint
send notification of screenshooter

Clients can get notification of screenshooter.


interface for screenmirror

A client can use this interface to get stream images of screen. Before starting, queue all buffers. Then, start a screenmirror. After starting, a dequeued event will occur when drawing a captured image on a buffer is finished. You might need to queue the dequeued buffer again to get a new image from display server.

destroy()
set_stretch(stretch: uint)
Argument
Type
Description
stretchuint
stretch type for screenmirror
queue(buffer: object<wl_buffer>)
Argument
Type
Description
bufferobject<wl_buffer>
buffer object for screenmirror
queue a buffer
dequeue(buffer: object<wl_buffer>)
Argument
Type
Description
bufferobject<wl_buffer>
buffer object for screenmirror
dequeue a buffer

A user can dequeue a buffer from display server when he wants to take back it from server.

set_auto_rotation(set: uint)
Argument
Type
Description
setuint
set screenmirror auto rotation value

Client can set auto rotation value for screenmirror.

dequeued(buffer: object<wl_buffer>)
Argument
Type
Description
bufferobject<wl_buffer>
dequeued buffer which contains a captured image
dequeued event

occurs when drawing a captured image on a buffer is finished

content(content: uint)
Argument
Type
Description
contentuint
content changed event

occurs when the content of a captured image is changed. (normal or video)

stop()
stop event

occurs when the screenmirror is stopped eventually

content { normal, video } 
Argument
Value
Description
normal0
video1
stretch { keep_ratio, fully } 
Argument
Value
Description
keep_ratio0
fully1

tizen_video

version 1
interface for tizen-video

Clients can get the video information that the compositor can handle from this interface.

get_object(id: new_id<tizen_video_object>, surface: object<wl_surface>)
Argument
Type
Description
idnew_id<tizen_video_object>
surfaceobject<wl_surface>
the surface object
get_viewport(id: new_id<tizen_viewport>, surface: object<wl_surface>)
Argument
Type
Description
idnew_id<tizen_viewport>
surfaceobject<wl_surface>
the surface object
destroy
Type: destructor
destroy()
destroy the tizen_video

Destroy the tizen_video.

format(format: uint)
Argument
Type
Description
formatuint
supported format for video

The tbm format codes match the #defines in tbm_surface.h. The formats actually supported by the compositor will be reported by the format event.



destroy()
set_attribute(name: string, value: int)
Argument
Type
Description
namestring
valueint
follow_topmost_visibility()
follow mute control change of a topmost surface

If tizen_video_object.follow_topmost_visibility is applied to a video_object, It will be video mute control based on topmost visibility.

unfollow_topmost_visibility()
unfollow mute control change of a topmost surface

If tizen_video_object.unfollow_topmost_visibility is applied to a video_object, It will not be video mute control based on topmost visibility.

allowed_attribute()
allowed_attribute

If tizen_video_object.allowed_attribute is applied to a video_object, set_attribute request will be deliever to tdm backend directly.

disallowed_attribute()
disallowed_attribute

If tizen_video_object.disallowed_attribute is applied to a video_object, It would be tdm_attribute call when topmost showing.

attribute(name: string, value: uint)
Argument
Type
Description
namestring
valueuint
size(min_w: int, min_h: int, max_w: int, max_h: int, prefer_align: int)
Argument
Type
Description
min_wint
min_hint
max_wint
max_hint
prefer_alignint


destroy()
destroy the tizen_subsurface_watcher

Destroy the tizen_subsurface_watcher.

message(value: uint)
Argument
Type
Description
valueuint

the viewport for a surface

This is the alternative and convenient solution of wl_viewport to present a surface on screen.

The below five functions can be replaced with this interface. The below functions will be ignored after applying this interface to a surface. - wl_surface.set_buffer_transform - wl_surface.set_buffer_scale - wl_subsurface.set_position - wl_viewport.set_source - wl_viewport.set_destination

wl_viewport.set_source is very complicated especially when the buffer of wl_surface is transformed by wl_surface.set_buffer_transform. And when the parent is resized, if we want to change the geometry of a subsurface also, wl_subsurface.set_position and wl_viewport.set_destination should be called everytime the parent is resized in client side. This makes difficult to synchronize a parent surface and a subsurface on screen.

tizen_viewport allows clients to set the relative geometry to a subsurface in a parent surface. Whenever a parent surface is resized, the geometry of a subsurface will be calculated, moved and resized automatically by a compositor. The tizen_viewport is specified in the coordinates of a subsurface's parent.

If tizen_viewport is applied to a shell surface(toplevel), the all value related with x, y pos of tizen_viewport and tizen_destination_mode interface will be ignored.

The below 3 functions don't consider the transform of a parent's surface. - tizen_viewport.set_source - tizen_viewport.set_destination - tizen_viewport.set_destination_ratio

Furthermore, tizen_destination_mode.follow_parent_transform is called, tizen_viewport will consider the transform of a parent surface when applying the destination mode to a subsurface. If tizen_destination_mode.follow_parent_transform is applied to a shell surface, it will be ignored.

The destination will be cropped by a parent surface.

The change will be applied when wl_surface.commit is called.

destroy
Type: destructor
destroy()
set_transform(transform: uint)
Argument
Type
Description
transformuint
set the transform of a surface

The accepted values for the transform parameter are the values for wl_output.transform according to the output transform.

The tizen_viewport.set_transform is applied only to itself. Basically it doesn't effect the transform of its subsurfaces. That is, if 90 transform is setted and its subsurface still has 0 transform, its subsurface won't be rotated.

If needed to rotate the subsurface depended on a parent surface, tizen_destination_mode.follow_parent_transform will make it possible.

set_source(x: uint, y: uint, width: uint, height: uint)
Argument
Type
Description
xuint
yuint
widthuint
heightuint
set the source rectalge of a wl_buffer

The source rectangle won't be changed when a parent is resized. If it needs to be changed, tizen_viewport.set_source should be called with new values.

set_destination(x: int, y: int, width: uint, height: uint)
Argument
Type
Description
xint
yint
widthuint
heightuint
set the destination geometry of a surface

The destination geometry won't be changed when a parent is resized. If it needs to be changed, tizen_viewport.set_destination should be called with new values.

If tizen_viewport is applied to a shell surface(toplevel), the x, y value of tizen_viewport.set_destination will be ignored.

set_destination_ratio(x: fixed, y: fixed, width: fixed, height: fixed)
Argument
Type
Description
xfixed
yfixed
widthfixed
heightfixed
set the ratio destination rectalge in a parent surface

The destination rectangle of a subsurface will be automatically changed when a parent is resized. This allows the real number between 0.0 and 1.0. See wl_fixed_from_double and wl_fixed_to_double.

If tizen_viewport is applied to a shell surface(toplevel), the x, y value of tizen_viewport.set_destination_ratio will be ignored.

get_destination_mode(id: new_id<tizen_destination_mode>)
Argument
Type
Description
idnew_id<tizen_destination_mode>
query_parent_size()
set the ratio destination rectalge in a parent surface

A client can asks the display server to send the size of tizen_viewport object's parent surface. Once a client requests it, the "parent_size" event will be sent whenever the parent surface's size is changed.

follow_parent_transform()
follow the transform change of a parent surface

The real transform of a subsurface is (parent's transform + subsurface's transform). The subsurface will be rotated automatically when the parent is rotated.

If tizen_viewport.follow_parent_transform is applied to a shell surface(toplevel), it will be ignored.

destination_changed(transform: uint, x: int, y: int, width: uint, height: uint)
Argument
Type
Description
transformuint
xint
yint
widthuint
heightuint
parent_size(width: uint, height: uint)
Argument
Type
Description
widthuint
heightuint

the destination mode for a surface

The destination rectangle will be automatically changed when a parent is resized. When tizen_destination_mode.set is called, the value of tizen_viewport.set_destination and tizen_viewport.set_destination_ratio will be ignored.

The destination of a surface is decided by the mode, ratio, scale, offset and align values. The ratio, scale, offset and align will be applied sequentially.

The change will be applied when wl_surface.commit is called.

destroy()
follow_parent_transform()
follow the transform change of a parent surface

The real transform of a subsurface is (parent's transform + subsurface's transform). That is, the subsurface will be rotated automatically when the parent is rotated.

If tizen_destination_mode.follow_parent_transform is applied to a shell surface(toplevel), it will be ignored.

set_ratio(horizontal: fixed, vertical: fixed)
Argument
Type
Description
horizontalfixed
verticalfixed
set the ratio of the destination rectangle of a subsurface

This allows the real number. See wl_fixed_from_double and wl_fixed_to_double.

set_scale(horizontal: fixed, vertical: fixed)
Argument
Type
Description
horizontalfixed
verticalfixed
set the scale of the destination rectangle of a subsurface

This allows the real number. See wl_fixed_from_double and wl_fixed_to_double.

set_align(horizontal: fixed, vertical: fixed)
Argument
Type
Description
horizontalfixed
verticalfixed
set the align of the destination rectangle of a subsurface

This allows the real number between 0.0 and 1.0. See wl_fixed_from_double and wl_fixed_to_double.

set_offset(x: int, y: int, w: int, h: int)
Argument
Type
Description
xint
yint
wint
hint
error { invalid_type } 
Argument
Value
Description
invalid_type0

global embedded compositor object

The global obejct. Wayland has 3 type of compositor, embedded compositor is one of them. But tizen application is sendboxing by smack, then a application not allow commutication to other application by socket. So system or session compositor create socket and send to embedded compostior.

get_socket()
create new socket

The get_socket request ask the server to create socket and emit socket event.

destroy()
socket(sock_fd: fd)
Argument
Type
Description
sock_fdfd
socket fd

Sent immediately after get_socket request


global input device manager object

Tizen input device manager is a global interface. This object has device add/remove events to provide tizen input device object to a client. This allows for a client to get the con

Be sure to bind this interface after binding wl_seat interface. Tizen input device manager interface will only provide device add/remove event for devices which belongs to the wl_seat object(s) bound by the client. Therefore, the compositor needs to create/send the device add/remove event only for the current client's seat(s).

block_events(serial: uint, clas: uint<tizen_input_device_manager.clas>, duration: uint)
Argument
Type
Description
serialuint
clasuint<tizen_input_device_manager.clas>
durationuint
time duration with millisecond granularity
request to block sending event(s)

This request allows a client to request to block one or more events for its purpose. By specifying class as an argument in the request, the events belongs to the class will be blocked during the given duration. Note that an error event will be sent if there is any error.

unblock_events(serial: uint)
Argument
Type
Description
serialuint
request to unblock sending event(s)

This request allows a client to request to release the existing block for the client. Note that no error event will be sent if there is no existing block for the client.

init_generator(clas: uint<tizen_input_device_manager.clas>)
Argument
Type
Description
clasuint<tizen_input_device_manager.clas>
initialize input generator system
deinit_generator(clas: uint<tizen_input_device_manager.clas>)
Argument
Type
Description
clasuint<tizen_input_device_manager.clas>
deinitialize input generator system
generate_key(keyname: string, pressed: uint)
Argument
Type
Description
keynamestring
presseduint
generate a key event using specific or default device
generate_pointer(type: uint<tizen_input_device_manager.pointer_event_type>, x: uint, y: uint, button: uint)
Argument
Type
Description
typeuint<tizen_input_device_manager.pointer_event_type>
xuint
yuint
buttonuint
generate a pointer event using specific or default device
generate_touch(type: uint<tizen_input_device_manager.pointer_event_type>, x: uint, y: uint, finger: uint)
Argument
Type
Description
typeuint<tizen_input_device_manager.pointer_event_type>
xuint
yuint
fingeruint
generate a touch event using specific or default device
pointer_warp(surface: object<wl_surface>, x: fixed, y: fixed)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
xfixed
yfixed
warp pointer to the relative position to the given surface
init_generator_with_name(clas: uint<tizen_input_device_manager.clas>, name: string)
Argument
Type
Description
clasuint<tizen_input_device_manager.clas>
namestring
initialize input generator system with name
destroy()
destroy the tizen_input_device_manager

Destroy the tizen_input_device_manager.

generate_axis(type: uint<tizen_input_device_manager.axis_type>, value: fixed)
Argument
Type
Description
typeuint<tizen_input_device_manager.axis_type>
valuefixed
axis value
generate a pointer/touch axes event using specific or default device

When the server got this request, the server choices generate a event directly or just save values. Pointer axes (such as wheel/hwheel) are delivered to clients independantly about pointer events, but touch axes are delivered to normal touch events(begin/update/end). So the server just save touch axes before generate touch request is came and send a touch event include saved touch axes value.

set_touch_count(max_count: int)
Argument
Type
Description
max_countint
set a max slot of touch

This request only changes system's touch count. So this request doesn't change already connected touch devices's max count. This will influence to user created device using input generator. Input generator creates touch device only supports default touch count. But if user set touch count before create a Input generator device, user can create touch device has touch count user wanted. But some systems has their own maximum touch count. In that case this request returns error not_allowed.

init_generator_with_sync(clas: uint<tizen_input_device_manager.clas>, name: string)
Argument
Type
Description
clasuint<tizen_input_device_manager.clas>
namestring
initialize input generator system with name synchronously
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
subclasuint<tizen_input_device_manager.subclas>
grab keyboard events if device is a certial subclass
keyboard_ungrab(surface: object<wl_surface>)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
grab keyboard events
grab_relative_motion(surface: object<wl_surface>, boundary: uint<tizen_input_device_manager.boundary>)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
boundaryuint<tizen_input_device_manager.boundary>
grab relative motion
ungrab_relative_motion(surface: object<wl_surface>)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
ungrab relative motion
device_add(serial: uint, identifier: string, device: new_id<tizen_input_device>, seat: object<wl_seat>)
Argument
Type
Description
serialuint
identifierstring
devicenew_id<tizen_input_device>
seatobject<wl_seat>
device addition event

The device add/remove notification is going to be sent when a physical/logical device is added/removed to/from the given seat. Note that a tizen input device object can be assigned to a wl_seat and can also be assigned to the other wl_seat at any time. Whenever a relationship between a tizen input device object changes, device remove event from the current wl_seat object will be made and device add event to the other wl_seat object will also be mode.

device_remove(serial: uint, identifier: string, device: object<tizen_input_device>, seat: object<wl_seat>)
Argument
Type
Description
serialuint
identifierstring
deviceobject<tizen_input_device>
seatobject<wl_seat>
device removal event

The device add/remove notification is going to be sent when a physical/logical device is added/removed to/from the given seat. Note that a tizen input device object can be assigned to a wl_seat and can also be assigned to the other wl_seat at any time. Whenever a relationship between a tizen input device object changes, device remove event from the current wl_seat object will be made and device add event to the other wl_seat object will also be mode.

block_expired()
block expiration event

This event will be sent if the duration of existing block is expired. Note that no block expired event will be sent if there is no block for the client.

max_touch_count(serial: uint, max_count: int, seat: object<wl_seat>)
Argument
Type
Description
serialuint
max_countint
seatobject<wl_seat>
notify max slot of touch device is updated

Each touch devices has their own touch counts can be supported. So a server controls maximum touches in this system to maintain resources efficiently. Sometimes a server controls maximum touches using a predefined configuration option. Sometimes a server ensures maximum touches to be supported by touch device. If a server do not use configuration option, maximum touches can be updated when new touch devices are connected. So this events can be sent to client, when a first touch device is added or maximum touches is changed.

Argument
Type
Description
serialuint
boundaryuint<tizen_input_device_manager.boundary>
event indicates which boundary is associated with a relative_motion event
Argument
Value
Description
none0
none of class
mouse1
mouse class
keyboard2
keyboard class
touchscreen4
touchscreen class
device class
Argument
Value
Description
none0
no error
no_permission1
no permission
invalid_class2
invalid class
blocked_already3
blocked already by the other client
no_system_resources4
no system resources such as memory lack
invalid_parameter5
argument is invalid
invalid_surface6
the given surface is not visible or pointer is not on the given surface
no_pointer_available7
there is no pointer available to warp
not_allowed8
this request is not allowed in this system
pointer_event_type { begin, update, end } 
Argument
Value
Description
begin0
update1
end2
Argument
Value
Description
none0
no axis type
wheel1
pointer vertical wheel axis
hwheel2
pointer horizental wheel axis
radius_x3
touch radius of x axis of an event area e.g. touching area with a finger or a pen
radius_y4
touch radius of y axis of an event area e.g. touching area with a finger or a pen
pressure5
touch pressure in an event area e.g. touching area with a finger or a pen
angle6
touch angle in an event area e.g. touching area with a finger or a pen
palm7
touch palm in an event area e.g. touching area with a finger or a pen
Argument
Value
Description
none1
none of subclass
remocon2
remocon subclass
virtual_keyboard4
virtual_keyboard subclass
device subclass
boundary { top, right, bottom, left } 
Argument
Value
Description
top1
right2
bottom3
left4

tizen input device object

The tizen_input_device interface represents one or more input devices associated with a physical/logical input device. This interface provides device specific information/events to allows for client to identify the source device of an event or to get the additional axes/attributes of a device. Note that a tizen_input_device object can be used for a physical input device and can also be used for a group of input devices. e.g. a group of mouse devices

select_axes(axes: array)
Argument
Type
Description
axesarray
array of axis num
request for selecting some of axes among the axes supported by a tizen_input_device object
release()
release the tizen_input_device object
device_info(name: string, clas: uint<tizen_input_device.clas>, subclas: uint<tizen_input_device.subclas>, axes: array)
Argument
Type
Description
namestring
clasuint<tizen_input_device.clas>
subclasuint<tizen_input_device.subclas>
axesarray
array of axis enum
event contains device information
event_device(serial: uint, name: string, time: uint)
Argument
Type
Description
serialuint
namestring
timeuint
timestamp with millisecond granularity
event indicates the source device associated with a wl_pointer/keyboard/touch event
Argument
Type
Description
axis_typeuint<tizen_input_device.axis_type>
valuefixed
axis value
axis change event
Argument
Value
Description
none0
none of class
keyboard2
keyboard class
mouse3
mouse class
touchscreen4
touchscreen class
device class
subclas { none } 
Argument
Value
Description
none0
none of subclass
device subclass
Argument
Value
Description
none0
radius of x axis of an event area e.g. touching area with a finger or a pen
radius_x1
radius of x axis of an event area e.g. touching area with a finger or a pen
radius_y2
radius of y axis of an event area e.g. touching area with a finger or a pen
pressure3
pressure in an event area e.g. touching area with a finger or a pen
angle4
angle in an event area e.g. touching area with a finger or a pen
detent5
detent value e.g. moved distance with a rotary device
axis type enums which can be supported by a device


create_img(id: new_id<tizen_launch_image>)
Argument
Type
Description
idnew_id<tizen_launch_image>
new tizen_launch_image object
destroy()
destroy the tizen_launchscreen

Destroy the tizen_launchscreen.



destroy()
launch(file: string, file_type: uint, color_depth: uint, rotation: uint, indicator: uint, options: array)
Argument
Type
Description
filestring
file_typeuint
color_depthuint
rotationuint
indicatoruint
optionsarray
owner(pid: uint)
Argument
Type
Description
piduint
file_type { img, edj } 
Argument
Value
Description
img0
splash image file path
edj1
splash edj file path
indicator { off, on } 
Argument
Value
Description
off0
splash hide indicator
on1
splash show indicator
rotation { 0, 90, 180, 270 } 
Argument
Value
Description
00
rotation angle 0 degree
9090
rotation angle 90 degree
180180
rotation angle 180 degree
270270
rotation angle 270 degree

tizen_effect

version 1

destroy
Type: destructor
destroy()
start(surface: object<wl_surface>, type: uint)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
typeuint
end(surface: object<wl_surface>, type: uint)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
typeuint
type { none, show, hide, restack } 
Argument
Value
Description
none0
none
show1
show effect of window
hide2
hide effect of window
restack3
restack effect of window


set_window_brightness(surface: object<wl_surface>, brightness: int)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
brightnessint
destroy()
destroy the tizen_display_policy

Destroy the tizen_display_policy.

window_brightness_done(surface: object<wl_surface>, brightness: int, error_state: uint)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
brightnessint
error_stateuint


destroy
Type: destructor
destroy()
set_state(surface: object<wl_surface>, state: int)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
stateint
set_opacity_mode(surface: object<wl_surface>, mode: int)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
modeint
set_visible_type(surface: object<wl_surface>, type: int)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
typeint
flick(surface: object<wl_surface>, type: int)
Argument
Type
Description
surfaceobject<wl_surface>
occur the flick event
typeint
state { unknown, off, on } 
Argument
Value
Description
unknown0
unknown
off1
can not show indicator
on2
can show indicator
Argument
Value
Description
unknown0
unknown
opaque1
opaque mode
translucent2
translucent mode
transparent3
transparent all mode
bg_transparent4
transparent only background mode
visible_type { hidden, shown } 
Argument
Value
Description
hidden0
hidden type indicator
shown1
shown type indicator

an interface for requests and event about clipboard

This interface provides some requests and events about clipboard for other clients.

destroy
Type: destructor
destroy()
show(surface: object<wl_surface>)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
request for show clipboard
hide(surface: object<wl_surface>)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
request for hide clipboard
set_data_only(set: uint)
Argument
Type
Description
setuint
request for setting data only mode for this wl_client

A wayland client can notify of that the client is data only mode. The data only mode means that this wayland client doesn't have any wl_surfaces at all but it wants to use wl_data_device for some data operations.

data_selected(surface: object<wl_surface>)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
announce data are selected by clipboard
allowed_data_only(allowed: uint)
Argument
Type
Description
alloweduint
event to notify if data only set is allowed or not


get_ignore_output_transform(surface: object<wl_surface>)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
destroy()
destroy the tizen_screen_rotation

Destroy the tizen_screen_rotation.

ignore_output_transform(surface: object<wl_surface>, ignore: uint)
Argument
Type
Description
surfaceobject<wl_surface>
the surface object
ignoreuint


get_renderer_surface(id: new_id<tizen_renderer_surface>, surface: object<wl_surface>)
Argument
Type
Description
idnew_id<tizen_renderer_surface>
surfaceobject<wl_surface>
the surface object
destroy
Type: destructor
destroy()
destroy the tizen_renderer

Destroy the tizen_renderer



destroy()
destroy the tizen_renderer_surface

Destroy the tizen_renderer_surface


Compositor Support

No compositor support found