DragGesture

class omni.ui.scene.DragGesture

Bases: ShapeGesture

The gesture that provides a way to capture click-and-drag mouse event.

Methods

__init__(self, **kwargs)	Construct the gesture to track mouse drags.
call_on_began_fn(self, arg0)	Called when the user starts drag.
call_on_changed_fn(self, arg0)	Called when the user is dragging.
call_on_ended_fn(self, arg0)	Called when the user releases the mouse and finishes the drag.
has_on_began_fn(self)	Called when the user starts drag.
has_on_changed_fn(self)	Called when the user is dragging.
has_on_ended_fn(self)	Called when the user releases the mouse and finishes the drag.
set_on_began_fn(self, fn, None])	Called when the user starts drag.
set_on_changed_fn(self, fn, None])	Called when the user is dragging.
set_on_ended_fn(self, fn, None])	Called when the user releases the mouse and finishes the drag.

Attributes

check_mouse_moved	The check_mouse_moved property is a boolean flag that determines whether the DragGesture should verify if the 2D screen position of the mouse has changed before invoking the on_changed method.
modifiers	The keyboard modifier that should be active ti start the gesture.
mouse_button	Mouse button that should be active to start the gesture.

__init__(

self: omni.ui_scene._scene.DragGesture,

**kwargs,

) → None

Construct the gesture to track mouse drags.

`kwargsdict`

See below

### Keyword Arguments:

`mouse_button`

Mouse button that should be active to start the gesture.

`modifiers`

The keyboard modifier that should be active ti start the gesture.

`check_mouse_moved`

The check_mouse_moved property is a boolean flag that determines whether the DragGesture should verify if the 2D screen position of the mouse has changed before invoking the on_changed method. This property is essential in a 3D environment, as changes in the camera position can result in the mouse pointing to different locations in the 3D world even when the 2D screen position remains unchanged.

Usage When check_mouse_moved is set to True, the DragGesture will only call the on_changed method if the actual 2D screen position of the mouse has changed. This can be useful when you want to ensure that the on_changed method is only triggered when there is a genuine change in the mouse’s 2D screen position. If check_mouse_moved is set to False, the DragGesture will not check for changes in the mouse’s 2D screen position before calling the on_changed method. This can be useful when you want the on_changed method to be invoked even if the mouse’s 2D screen position hasn’t changed, such as when the camera position is altered, and the mouse now points to a different location in the 3D world.

`on_began_fn`

Called if the callback is not set when the user clicks the mouse button.

`on_changed_fn`

Called if the callback is not set when the user moves the clicked button.

`on_ended_fn`

Called if the callback is not set when the user releases the mouse button.

`name`

The name of the object. It’s used for debugging.

`manager`

The Manager that controld this gesture.

call_on_began_fn(

self: omni.ui_scene._scene.DragGesture,

arg0: omni::ui::scene::AbstractShape,

) → None

Called when the user starts drag.

call_on_changed_fn(

self: omni.ui_scene._scene.DragGesture,

arg0: omni::ui::scene::AbstractShape,

) → None

Called when the user is dragging.

call_on_ended_fn(

self: omni.ui_scene._scene.DragGesture,

arg0: omni::ui::scene::AbstractShape,

) → None

Called when the user releases the mouse and finishes the drag.

has_on_began_fn(

self: omni.ui_scene._scene.DragGesture,

) → bool

Called when the user starts drag.

has_on_changed_fn(

self: omni.ui_scene._scene.DragGesture,

) → bool

Called when the user is dragging.

has_on_ended_fn(

self: omni.ui_scene._scene.DragGesture,

) → bool

Called when the user releases the mouse and finishes the drag.

set_on_began_fn(self: omni.ui_scene._scene.DragGesture, fn: Callable[[omni::ui::scene::AbstractShape], None]) → None

Called when the user starts drag.

set_on_changed_fn(self: omni.ui_scene._scene.DragGesture, fn: Callable[[omni::ui::scene::AbstractShape], None]) → None

Called when the user is dragging.

set_on_ended_fn(self: omni.ui_scene._scene.DragGesture, fn: Callable[[omni::ui::scene::AbstractShape], None]) → None

Called when the user releases the mouse and finishes the drag.

property check_mouse_moved

The check_mouse_moved property is a boolean flag that determines whether the DragGesture should verify if the 2D screen position of the mouse has changed before invoking the on_changed method. This property is essential in a 3D environment, as changes in the camera position can result in the mouse pointing to different locations in the 3D world even when the 2D screen position remains unchanged.

Usage When check_mouse_moved is set to True, the DragGesture will only call the on_changed method if the actual 2D screen position of the mouse has changed. This can be useful when you want to ensure that the on_changed method is only triggered when there is a genuine change in the mouse’s 2D screen position. If check_mouse_moved is set to False, the DragGesture will not check for changes in the mouse’s 2D screen position before calling the on_changed method. This can be useful when you want the on_changed method to be invoked even if the mouse’s 2D screen position hasn’t changed, such as when the camera position is altered, and the mouse now points to a different location in the 3D world.

property modifiers

The keyboard modifier that should be active ti start the gesture.

property mouse_button

Mouse button that should be active to start the gesture.