isa/mutter
1
0
Fork 0
mirror of https://github.com/brl/mutter.git synced 2024-11-30 03:50:47 -05:00
Code Issues Packages Projects Releases Wiki Activity
aa723e7207
mutter/clutter/clutter/clutter-pick-stack-private.h

72 lines
2.6 KiB
C
Raw Normal View History

Introduce ClutterPickStack ClutterPickStack is a new boxed type that stores the vertices and clip rectangles. It is meant to be a byproduct of picking, and takes over most of what ClutterStage currently does. It introduces a 'seal' system, inspired by MetaKmsUpdate. After the pick operation is done, and the rectangles are collected, the pick stack is sealed, and is not allowed to be externally modified anymore. Internally, it still can invalidate pick records when an actor is destroyed. For now, it handles both the clip rectangles, and the matrix stack, separatedly. Future commits will rearrange this. https://gitlab.gnome.org/GNOME/mutter/-/merge_requests/1509
2020-10-16 18:13:12 -04:00
/*
* Copyright (C) 2020 Endless OS Foundation, LLC
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef CLUTTER_PICK_STACK_PRIVATE_H
#define CLUTTER_PICK_STACK_PRIVATE_H
#include <glib-object.h>
#include "clutter-macros.h"
#include "clutter-stage-view.h"
G_BEGIN_DECLS
#define CLUTTER_TYPE_PICK_STACK (clutter_pick_stack_get_type ())
typedef struct _ClutterPickStack ClutterPickStack;
GType clutter_pick_stack_get_type (void) G_GNUC_CONST;
ClutterPickStack * clutter_pick_stack_new (CoglContext *context);
ClutterPickStack * clutter_pick_stack_ref (ClutterPickStack *pick_stack);
void clutter_pick_stack_unref (ClutterPickStack *pick_stack);
void clutter_pick_stack_seal (ClutterPickStack *pick_stack);
Use graphene_ray_t to pick actors This commit introduces a few important changes in order to acommodate graphene_ray_t. Most of them are positive changes, so don't panic :) The first very visible change is that neither the actor box nor the clip rectangles are projected before being pushed. This required changing the parameters of the related functions at both ClutterPickContext, and ClutterPickStack, to receive boxes instead of vertices. These rectangles are projected on demand now, so in the best case (first actor picked) only one projection happens; and in the worst case, it projects as much as it does now. The second important change is that there are no more checks for axis-alignment anymore. That's because picking now happens in 3D space, using triangles. Talking about triangles in 3D space, this is what is used now for picking. We break down each actor rectangle in 2 triangles, and check if the projected pick point is inside any one of them, of if the ray intersects any one of them. The same check happens for the clip rectangles. Checking the projected pick point is both an optimization for the 2D case, and a workaround to graphene_ray_t problems with float precision, which is specially visible on edges such as the top bar. https://gitlab.gnome.org/GNOME/mutter/-/merge_requests/1509
2020-10-17 10:52:45 -04:00
void clutter_pick_stack_log_pick (ClutterPickStack *pick_stack,
const ClutterActorBox *box,
ClutterActor *actor);
clutter: Also log overlap regions in ClutterPickContext/Stack These may be used for optimizations once we find the pick actor, so picking can be avoided in areas we know didn't cross into other actors. Nothing makes use of it yet though, just log these so far. Part-of: <https://gitlab.gnome.org/GNOME/mutter/-/merge_requests/1915>
2021-06-30 10:02:43 -04:00
void clutter_pick_stack_log_overlap (ClutterPickStack *pick_stack,
ClutterActor *actor);
Introduce ClutterPickStack ClutterPickStack is a new boxed type that stores the vertices and clip rectangles. It is meant to be a byproduct of picking, and takes over most of what ClutterStage currently does. It introduces a 'seal' system, inspired by MetaKmsUpdate. After the pick operation is done, and the rectangles are collected, the pick stack is sealed, and is not allowed to be externally modified anymore. Internally, it still can invalidate pick records when an actor is destroyed. For now, it handles both the clip rectangles, and the matrix stack, separatedly. Future commits will rearrange this. https://gitlab.gnome.org/GNOME/mutter/-/merge_requests/1509
2020-10-16 18:13:12 -04:00
Use graphene_ray_t to pick actors This commit introduces a few important changes in order to acommodate graphene_ray_t. Most of them are positive changes, so don't panic :) The first very visible change is that neither the actor box nor the clip rectangles are projected before being pushed. This required changing the parameters of the related functions at both ClutterPickContext, and ClutterPickStack, to receive boxes instead of vertices. These rectangles are projected on demand now, so in the best case (first actor picked) only one projection happens; and in the worst case, it projects as much as it does now. The second important change is that there are no more checks for axis-alignment anymore. That's because picking now happens in 3D space, using triangles. Talking about triangles in 3D space, this is what is used now for picking. We break down each actor rectangle in 2 triangles, and check if the projected pick point is inside any one of them, of if the ray intersects any one of them. The same check happens for the clip rectangles. Checking the projected pick point is both an optimization for the 2D case, and a workaround to graphene_ray_t problems with float precision, which is specially visible on edges such as the top bar. https://gitlab.gnome.org/GNOME/mutter/-/merge_requests/1509
2020-10-17 10:52:45 -04:00
void clutter_pick_stack_push_clip (ClutterPickStack *pick_stack,
const ClutterActorBox *box);
Introduce ClutterPickStack ClutterPickStack is a new boxed type that stores the vertices and clip rectangles. It is meant to be a byproduct of picking, and takes over most of what ClutterStage currently does. It introduces a 'seal' system, inspired by MetaKmsUpdate. After the pick operation is done, and the rectangles are collected, the pick stack is sealed, and is not allowed to be externally modified anymore. Internally, it still can invalidate pick records when an actor is destroyed. For now, it handles both the clip rectangles, and the matrix stack, separatedly. Future commits will rearrange this. https://gitlab.gnome.org/GNOME/mutter/-/merge_requests/1509
2020-10-16 18:13:12 -04:00
void clutter_pick_stack_pop_clip (ClutterPickStack *pick_stack);
void clutter_pick_stack_push_transform (ClutterPickStack *pick_stack,
const graphene_matrix_t *transform);
void clutter_pick_stack_get_transform (ClutterPickStack *pick_stack,
graphene_matrix_t *out_transform);
void clutter_pick_stack_pop_transform (ClutterPickStack *pick_stack);
Use graphene_ray_t to pick actors This commit introduces a few important changes in order to acommodate graphene_ray_t. Most of them are positive changes, so don't panic :) The first very visible change is that neither the actor box nor the clip rectangles are projected before being pushed. This required changing the parameters of the related functions at both ClutterPickContext, and ClutterPickStack, to receive boxes instead of vertices. These rectangles are projected on demand now, so in the best case (first actor picked) only one projection happens; and in the worst case, it projects as much as it does now. The second important change is that there are no more checks for axis-alignment anymore. That's because picking now happens in 3D space, using triangles. Talking about triangles in 3D space, this is what is used now for picking. We break down each actor rectangle in 2 triangles, and check if the projected pick point is inside any one of them, of if the ray intersects any one of them. The same check happens for the clip rectangles. Checking the projected pick point is both an optimization for the 2D case, and a workaround to graphene_ray_t problems with float precision, which is specially visible on edges such as the top bar. https://gitlab.gnome.org/GNOME/mutter/-/merge_requests/1509
2020-10-17 10:52:45 -04:00
ClutterActor *
clutter: Calculate "safe area" during pointer pick This safe area is the region (in stage coordinates) where the pointer is ensured to stay within the current actor. This is not used yet, but will be used for optimizations in pointer picking. Part-of: <https://gitlab.gnome.org/GNOME/mutter/-/merge_requests/1915>
2021-07-05 11:20:35 -04:00
clutter_pick_stack_search_actor (ClutterPickStack *pick_stack,
const graphene_point3d_t *point,
const graphene_ray_t *ray,
cairo_region_t **clear_area);
Introduce ClutterPickStack ClutterPickStack is a new boxed type that stores the vertices and clip rectangles. It is meant to be a byproduct of picking, and takes over most of what ClutterStage currently does. It introduces a 'seal' system, inspired by MetaKmsUpdate. After the pick operation is done, and the rectangles are collected, the pick stack is sealed, and is not allowed to be externally modified anymore. Internally, it still can invalidate pick records when an actor is destroyed. For now, it handles both the clip rectangles, and the matrix stack, separatedly. Future commits will rearrange this. https://gitlab.gnome.org/GNOME/mutter/-/merge_requests/1509
2020-10-16 18:13:12 -04:00
clutter/pick-stack: Add autoptr support It'll allow us use g_autoptr (ClutterPickStack) when removing the pick stack cache, making the code a bit more modern. Part-of: <https://gitlab.gnome.org/GNOME/mutter/-/merge_requests/1520>
2020-10-22 18:34:26 -04:00
G_DEFINE_AUTOPTR_CLEANUP_FUNC (ClutterPickStack, clutter_pick_stack_unref)
Introduce ClutterPickStack ClutterPickStack is a new boxed type that stores the vertices and clip rectangles. It is meant to be a byproduct of picking, and takes over most of what ClutterStage currently does. It introduces a 'seal' system, inspired by MetaKmsUpdate. After the pick operation is done, and the rectangles are collected, the pick stack is sealed, and is not allowed to be externally modified anymore. Internally, it still can invalidate pick records when an actor is destroyed. For now, it handles both the clip rectangles, and the matrix stack, separatedly. Future commits will rearrange this. https://gitlab.gnome.org/GNOME/mutter/-/merge_requests/1509
2020-10-16 18:13:12 -04:00
G_END_DECLS
#endif /* CLUTTER_PICK_STACK_PRIVATE_H */
Reference in New Issue Copy Permalink