//! A module for the [`GizmoConfig`] [`Resource`]. use crate as bevy_gizmos; pub use bevy_gizmos_macros::GizmoConfigGroup; use bevy_ecs::{component::Component, system::Resource}; use bevy_reflect::{Reflect, TypePath}; use bevy_render::view::RenderLayers; use bevy_utils::TypeIdMap; use core::panic; use std::{ any::TypeId, ops::{Deref, DerefMut}, }; /// A trait used to create gizmo configs groups. /// /// Here you can store additional configuration for you gizmo group not covered by [`GizmoConfig`] /// /// Make sure to derive [`Default`] + [`Reflect`] and register in the app using `app.init_gizmo_group::()` pub trait GizmoConfigGroup: Reflect + TypePath + Default {} /// The default gizmo config group. #[derive(Default, Reflect, GizmoConfigGroup)] pub struct DefaultGizmoConfigGroup; /// A [`Resource`] storing [`GizmoConfig`] and [`GizmoConfigGroup`] structs /// /// Use `app.init_gizmo_group::()` to register a custom config group. #[derive(Resource, Default)] pub struct GizmoConfigStore { // INVARIANT: must map TypeId::of::() to correct type T store: TypeIdMap<(GizmoConfig, Box)>, } impl GizmoConfigStore { /// Returns [`GizmoConfig`] and [`GizmoConfigGroup`] associated with [`TypeId`] of a [`GizmoConfigGroup`] pub fn get_config_dyn(&self, config_type_id: &TypeId) -> Option<(&GizmoConfig, &dyn Reflect)> { let (config, ext) = self.store.get(config_type_id)?; Some((config, ext.deref())) } /// Returns [`GizmoConfig`] and [`GizmoConfigGroup`] associated with [`GizmoConfigGroup`] `T` pub fn config(&self) -> (&GizmoConfig, &T) { let Some((config, ext)) = self.get_config_dyn(&TypeId::of::()) else { panic!("Requested config {} does not exist in `GizmoConfigStore`! Did you forget to add it using `app.init_gizmo_group()`?", T::type_path()); }; // hash map invariant guarantees that &dyn Reflect is of correct type T let ext = ext.as_any().downcast_ref().unwrap(); (config, ext) } /// Returns mutable [`GizmoConfig`] and [`GizmoConfigGroup`] associated with [`TypeId`] of a [`GizmoConfigGroup`] pub fn get_config_mut_dyn( &mut self, config_type_id: &TypeId, ) -> Option<(&mut GizmoConfig, &mut dyn Reflect)> { let (config, ext) = self.store.get_mut(config_type_id)?; Some((config, ext.deref_mut())) } /// Returns mutable [`GizmoConfig`] and [`GizmoConfigGroup`] associated with [`GizmoConfigGroup`] `T` pub fn config_mut(&mut self) -> (&mut GizmoConfig, &mut T) { let Some((config, ext)) = self.get_config_mut_dyn(&TypeId::of::()) else { panic!("Requested config {} does not exist in `GizmoConfigStore`! Did you forget to add it using `app.init_gizmo_group()`?", T::type_path()); }; // hash map invariant guarantees that &dyn Reflect is of correct type T let ext = ext.as_any_mut().downcast_mut().unwrap(); (config, ext) } /// Returns an iterator over all [`GizmoConfig`]s. pub fn iter(&self) -> impl Iterator + '_ { self.store .iter() .map(|(id, (config, ext))| (id, config, ext.deref())) } /// Returns an iterator over all [`GizmoConfig`]s, by mutable reference. pub fn iter_mut( &mut self, ) -> impl Iterator + '_ { self.store .iter_mut() .map(|(id, (config, ext))| (id, config, ext.deref_mut())) } /// Inserts [`GizmoConfig`] and [`GizmoConfigGroup`] replacing old values pub fn insert(&mut self, config: GizmoConfig, ext_config: T) { // INVARIANT: hash map must correctly map TypeId::of::() to &dyn Reflect of type T self.store .insert(TypeId::of::(), (config, Box::new(ext_config))); } pub(crate) fn register(&mut self) { self.insert(GizmoConfig::default(), T::default()); } } /// A struct that stores configuration for gizmos. #[derive(Clone, Reflect)] pub struct GizmoConfig { /// Set to `false` to stop drawing gizmos. /// /// Defaults to `true`. pub enabled: bool, /// Line width specified in pixels. /// /// If `line_perspective` is `true` then this is the size in pixels at the camera's near plane. /// /// Defaults to `2.0`. pub line_width: f32, /// Apply perspective to gizmo lines. /// /// This setting only affects 3D, non-orthographic cameras. /// /// Defaults to `false`. pub line_perspective: bool, /// How closer to the camera than real geometry the line should be. /// /// In 2D this setting has no effect and is effectively always -1. /// /// Value between -1 and 1 (inclusive). /// * 0 means that there is no change to the line position when rendering /// * 1 means it is furthest away from camera as possible /// * -1 means that it will always render in front of other things. /// /// This is typically useful if you are drawing wireframes on top of polygons /// and your wireframe is z-fighting (flickering on/off) with your main model. /// You would set this value to a negative number close to 0. pub depth_bias: f32, /// Describes which rendering layers gizmos will be rendered to. /// /// Gizmos will only be rendered to cameras with intersecting layers. pub render_layers: RenderLayers, } impl Default for GizmoConfig { fn default() -> Self { Self { enabled: true, line_width: 2., line_perspective: false, depth_bias: 0., render_layers: Default::default(), } } } #[derive(Component)] pub(crate) struct GizmoMeshConfig { pub line_perspective: bool, pub render_layers: RenderLayers, } impl From<&GizmoConfig> for GizmoMeshConfig { fn from(item: &GizmoConfig) -> Self { GizmoMeshConfig { line_perspective: item.line_perspective, render_layers: item.render_layers, } } }