mirror of https://github.com/anoshenko/rui.git
234 lines
8.6 KiB
Go
234 lines
8.6 KiB
Go
package rui
|
||
|
||
// Constants for [View] specific pointer events properties
|
||
const (
|
||
// PointerDown is the constant for "pointer-down" property tag.
|
||
//
|
||
// Used by View.
|
||
// Fired when a pointer becomes active. For mouse, it is fired when the device transitions from no buttons depressed to at
|
||
// least one button depressed. For touch, it is fired when physical contact is made with the digitizer. For pen, it is
|
||
// fired when the stylus makes physical contact with the digitizer.
|
||
//
|
||
// General listener format:
|
||
//
|
||
// func(view rui.View, event rui.PointerEvent)
|
||
//
|
||
// where:
|
||
// - view - Interface of a view which generated this event,
|
||
// - event - Pointer event.
|
||
//
|
||
// Allowed listener formats:
|
||
//
|
||
// func(event rui.PointerEvent)
|
||
// func(view rui.View)
|
||
// func()
|
||
PointerDown PropertyName = "pointer-down"
|
||
|
||
// PointerUp is the constant for "pointer-up" property tag.
|
||
//
|
||
// Used by View.
|
||
// Is fired when a pointer is no longer active.
|
||
//
|
||
// General listener format:
|
||
//
|
||
// func(view rui.View, event rui.PointerEvent)
|
||
//
|
||
// where:
|
||
// - view - Interface of a view which generated this event,
|
||
// - event - Pointer event.
|
||
//
|
||
// Allowed listener formats:
|
||
//
|
||
// func(event rui.PointerEvent)
|
||
// func(view rui.View)
|
||
// func()
|
||
PointerUp PropertyName = "pointer-up"
|
||
|
||
// PointerMove is the constant for "pointer-move" property tag.
|
||
//
|
||
// Used by View.
|
||
// Is fired when a pointer changes coordinates.
|
||
//
|
||
// General listener format:
|
||
//
|
||
// func(view rui.View, event rui.PointerEvent)
|
||
//
|
||
// where:
|
||
// - view - Interface of a view which generated this event,
|
||
// - event - Pointer event.
|
||
//
|
||
// Allowed listener formats:
|
||
//
|
||
// func(event rui.PointerEvent)
|
||
// func(view rui.View)
|
||
// func()
|
||
PointerMove PropertyName = "pointer-move"
|
||
|
||
// PointerCancel is the constant for "pointer-cancel" property tag.
|
||
//
|
||
// Used by View.
|
||
// Is fired if the pointer will no longer be able to generate events (for example the related device is deactivated).
|
||
//
|
||
// General listener format:
|
||
//
|
||
// func(view rui.View, event rui.PointerEvent)
|
||
//
|
||
// where:
|
||
// - view - Interface of a view which generated this event,
|
||
// - event - Pointer event.
|
||
//
|
||
// Allowed listener formats:
|
||
//
|
||
// func(event rui.PointerEvent)
|
||
// func(view rui.View)
|
||
// func()
|
||
PointerCancel PropertyName = "pointer-cancel"
|
||
|
||
// PointerOut is the constant for "pointer-out" property tag.
|
||
//
|
||
// Used by View.
|
||
// Is fired for several reasons including: pointing device is moved out of the hit test boundaries of an element; firing
|
||
// the "pointer-up" event for a device that does not support hover (see "pointer-up"); after firing the "pointer-cancel"
|
||
// event (see "pointer-cancel"); when a pen stylus leaves the hover range detectable by the digitizer.
|
||
//
|
||
// General listener format:
|
||
//
|
||
// func(view rui.View, event rui.PointerEvent)
|
||
//
|
||
// where:
|
||
// - view - Interface of a view which generated this event,
|
||
// - event - Pointer event.
|
||
//
|
||
// Allowed listener formats:
|
||
//
|
||
// func(event rui.PointerEvent)
|
||
// func(view rui.View)
|
||
// func()
|
||
PointerOut PropertyName = "pointer-out"
|
||
|
||
// PointerOver is the constant for "pointer-over" property tag.
|
||
//
|
||
// Used by View.
|
||
// Is fired when a pointing device is moved into an view's hit test boundaries.
|
||
//
|
||
// General listener format:
|
||
//
|
||
// func(view rui.View, event rui.PointerEvent)
|
||
//
|
||
// where:
|
||
// - view - Interface of a view which generated this event,
|
||
// - event - Pointer event.
|
||
//
|
||
// Allowed listener formats:
|
||
//
|
||
// func(event rui.PointerEvent)
|
||
// func(view rui.View)
|
||
// func()
|
||
PointerOver PropertyName = "pointer-over"
|
||
)
|
||
|
||
// PointerEvent represent a stylus events. Also inherit [MouseEvent] attributes
|
||
type PointerEvent struct {
|
||
MouseEvent
|
||
|
||
// PointerID is a unique identifier for the pointer causing the event.
|
||
PointerID int
|
||
|
||
// Width is the width (magnitude on the X axis), in pixels, of the contact geometry of the pointer.
|
||
Width float64
|
||
// Height is the height (magnitude on the Y axis), in pixels, of the contact geometry of the pointer.
|
||
Height float64
|
||
|
||
// Pressure is the normalized pressure of the pointer input in the range 0 to 1, where 0 and 1 represent
|
||
// the minimum and maximum pressure the hardware is capable of detecting, respectively.
|
||
Pressure float64
|
||
|
||
// TangentialPressure is the normalized tangential pressure of the pointer input (also known
|
||
// as barrel pressure or cylinder stress) in the range -1 to 1, where 0 is the neutral position of the control.
|
||
TangentialPressure float64
|
||
|
||
// TiltX is the plane angle (in degrees, in the range of -90 to 90) between the Y–Z plane
|
||
// and the plane containing both the pointer (e.g. pen stylus) axis and the Y axis.
|
||
TiltX float64
|
||
|
||
// TiltY is the plane angle (in degrees, in the range of -90 to 90) between the X–Z plane
|
||
// and the plane containing both the pointer (e.g. pen stylus) axis and the X axis.
|
||
TiltY float64
|
||
|
||
// Twist is the clockwise rotation of the pointer (e.g. pen stylus) around its major axis in degrees,
|
||
// with a value in the range 0 to 359.
|
||
Twist float64
|
||
|
||
// PointerType indicates the device type that caused the event ("mouse", "pen", "touch", etc.)
|
||
PointerType string
|
||
|
||
// IsPrimary indicates if the pointer represents the primary pointer of this pointer type.
|
||
IsPrimary bool
|
||
}
|
||
|
||
func (event *PointerEvent) init(data DataObject) {
|
||
event.MouseEvent.init(data)
|
||
|
||
event.PointerID, _ = dataIntProperty(data, "pointerId")
|
||
event.Width = dataFloatProperty(data, "width")
|
||
event.Height = dataFloatProperty(data, "height")
|
||
event.Pressure = dataFloatProperty(data, "pressure")
|
||
event.TangentialPressure = dataFloatProperty(data, "tangentialPressure")
|
||
event.TiltX = dataFloatProperty(data, "tiltX")
|
||
event.TiltY = dataFloatProperty(data, "tiltY")
|
||
event.Twist = dataFloatProperty(data, "twist")
|
||
value, _ := data.PropertyValue("pointerType")
|
||
event.PointerType = value
|
||
event.IsPrimary = dataBoolProperty(data, "isPrimary")
|
||
}
|
||
|
||
func handlePointerEvents(view View, tag PropertyName, data DataObject) {
|
||
listeners := getOneArgEventListeners[View, PointerEvent](view, nil, tag)
|
||
if len(listeners) == 0 {
|
||
return
|
||
}
|
||
|
||
var event PointerEvent
|
||
event.init(data)
|
||
|
||
for _, listener := range listeners {
|
||
listener(view, event)
|
||
}
|
||
}
|
||
|
||
// GetPointerDownListeners returns the "pointer-down" listener list. If there are no listeners then the empty list is returned.
|
||
// If the second argument (subviewID) is not specified or it is "" then a value from the first argument (view) is returned.
|
||
func GetPointerDownListeners(view View, subviewID ...string) []func(View, PointerEvent) {
|
||
return getOneArgEventListeners[View, PointerEvent](view, subviewID, PointerDown)
|
||
}
|
||
|
||
// GetPointerUpListeners returns the "pointer-up" listener list. If there are no listeners then the empty list is returned.
|
||
// If the second argument (subviewID) is not specified or it is "" then a value from the first argument (view) is returned.
|
||
func GetPointerUpListeners(view View, subviewID ...string) []func(View, PointerEvent) {
|
||
return getOneArgEventListeners[View, PointerEvent](view, subviewID, PointerUp)
|
||
}
|
||
|
||
// GetPointerMoveListeners returns the "pointer-move" listener list. If there are no listeners then the empty list is returned.
|
||
// If the second argument (subviewID) is not specified or it is "" then a value from the first argument (view) is returned.
|
||
func GetPointerMoveListeners(view View, subviewID ...string) []func(View, PointerEvent) {
|
||
return getOneArgEventListeners[View, PointerEvent](view, subviewID, PointerMove)
|
||
}
|
||
|
||
// GetPointerCancelListeners returns the "pointer-cancel" listener list. If there are no listeners then the empty list is returned.
|
||
// If the second argument (subviewID) is not specified or it is "" then a value from the first argument (view) is returned.
|
||
func GetPointerCancelListeners(view View, subviewID ...string) []func(View, PointerEvent) {
|
||
return getOneArgEventListeners[View, PointerEvent](view, subviewID, PointerCancel)
|
||
}
|
||
|
||
// GetPointerOverListeners returns the "pointer-over" listener list. If there are no listeners then the empty list is returned.
|
||
// If the second argument (subviewID) is not specified or it is "" then a value from the first argument (view) is returned.
|
||
func GetPointerOverListeners(view View, subviewID ...string) []func(View, PointerEvent) {
|
||
return getOneArgEventListeners[View, PointerEvent](view, subviewID, PointerOver)
|
||
}
|
||
|
||
// GetPointerOutListeners returns the "pointer-out" listener list. If there are no listeners then the empty list is returned.
|
||
// If the second argument (subviewID) is not specified or it is "" then a value from the first argument (view) is returned.
|
||
func GetPointerOutListeners(view View, subviewID ...string) []func(View, PointerEvent) {
|
||
return getOneArgEventListeners[View, PointerEvent](view, subviewID, PointerOut)
|
||
}
|