ScaleSystem Class

System that applies scaling to entities based on their ScaleStateComponent. More...

Declaration

class helios::engine::modules::spatial::transform::systems::ScaleSystem { ... }

Base class

class	System
	Abstract base class for game systems. More...

Public Member Functions Index

void	init (helios::engine::runtime::world::GameWorld &gameWorld) noexcept override
	Called when the system is added to a GameWorld. More...
void	update (helios::engine::runtime::world::UpdateContext &updateContext) noexcept override
	Updates scale for all entities with dirty ScaleComponents. More...

Description

System that applies scaling to entities based on their ScaleStateComponent.

This system converts the desired world-space dimensions from ScaleStateComponent into scale factors relative to the model's original AABB. It handles unit conversion (e.g., centimeters to meters) based on the ScaleStateComponent's unit.

Required components:

• ScaleStateComponent (desired dimensions and unit)
• ModelAabbComponent (original model bounds)
• ComposeTransformComponent (receives scale updates)

Definition at line 42 of file ScaleSystem.ixx.

Public Member Functions

init()

void helios::engine::modules::spatial::transform::systems::ScaleSystem::init (helios::engine::runtime::world::GameWorld & gameWorld)

inline noexcept virtual

Called when the system is added to a GameWorld.

Parameters

gameWorld

Pointer to the GameWorld this system belongs to.

Definition at line 51 of file ScaleSystem.ixx.

51 void init(helios::engine::runtime::world::GameWorld& gameWorld) noexcept override {

52 System::init(gameWorld);

53 }

update()

void helios::engine::modules::spatial::transform::systems::ScaleSystem::update (helios::engine::runtime::world::UpdateContext & updateContext)

inline noexcept virtual

Updates scale for all entities with dirty ScaleComponents.

For each entity with the required components, calculates the scale factor needed to resize the model from its original dimensions to the desired world-space dimensions.

Parameters

updateContext

Context containing deltaTime and other frame data.

Definition at line 64 of file ScaleSystem.ixx.

64 void update(helios::engine::runtime::world::UpdateContext& updateContext) noexcept override {

65

66 for (auto [entity, mab, sc, tc, active] : gameWorld_->view<

67 helios::engine::modules::rendering::model::components::ModelAabbComponent,

68 helios::engine::modules::spatial::transform::components::ScaleStateComponent,

69 helios::engine::modules::spatial::transform::components::ComposeTransformComponent,

70 helios::engine::mechanics::lifecycle::components::Active

71 >().whereEnabled()) {

72

73 if (!sc->isDirty()) {

74 continue;

75 }

76

77 // Get current model size and desired size

78 auto cscale = mab->aabb().size();

79 auto wscale = sc->scaling();

80

81 auto currentScale = tc->localScaling();

82

83 auto unit = sc->unit();

84

85 // Calculate scale factors: desired_size / current_size

86 // Convert desired size to engine units (meters)

87 auto scale = helios::math::vec3f{

88 wscale[0] != 0 && cscale[0] != 0 ? helios::core::units::from(wscale[0], unit) / cscale[0] : currentScale[0],

89 wscale[1] != 0 && cscale[1] != 0 ? helios::core::units::from(wscale[1], unit) / cscale[1] : currentScale[1],

90 wscale[2] != 0 && cscale[2] != 0 ? helios::core::units::from(wscale[2], unit) / cscale[2] : currentScale[2]

91 };

92

93 tc->setLocalScale(scale);

94 }

95 }

References helios::core::units::from and helios::engine::ecs::System::gameWorld_.

---

The documentation for this class was generated from the following file:

• ScaleSystem.ixx

---

Generated via doxygen2docusaurus 2.0.0 by Doxygen 1.15.0.