Struct Projectile 

pub struct Projectile { /* private fields */ }

A projectile with position, velocity, and acceleration.

Projectiles simulate simple physics-based motion, updating position based on velocity and velocity based on acceleration each frame.

Example

use harmonica::{fps, Point, Vector, Projectile, GRAVITY};

// Create a ball thrown upward
let mut ball = Projectile::new(
    fps(60),
    Point::new(0.0, 0.0, 0.0),
    Vector::new(5.0, 20.0, 0.0),  // Initial velocity
    GRAVITY,
);

// Simulate for 1 second
for _ in 0..60 {
    let pos = ball.update();
    println!("Ball at y={}", pos.y);
}

Implementations

impl Projectile

pub const fn new( delta_time: f64, position: Point, velocity: Vector, acceleration: Vector, ) -> Self

Creates a new projectile with the given parameters.

Arguments

• delta_time - Time step per update (use fps to compute)
• position - Initial position
• velocity - Initial velocity
• acceleration - Constant acceleration (e.g., gravity)

Example

use harmonica::{fps, Point, Vector, Projectile, TERMINAL_GRAVITY};

let projectile = Projectile::new(
    fps(60),
    Point::new(10.0, 0.0, 0.0),
    Vector::new(5.0, 2.0, 0.0),
    TERMINAL_GRAVITY,
);

pub fn update(&mut self) -> Point

Updates the projectile’s position and velocity for one frame.

Returns the new position after the update.

Example

use harmonica::{fps, Point, Vector, Projectile, GRAVITY};

let mut p = Projectile::new(
    fps(60),
    Point::origin(),
    Vector::new(10.0, 0.0, 0.0),
    GRAVITY,
);

// Update returns the new position
let new_pos = p.update();

pub const fn position(&self) -> Point

Returns the current position of the projectile.

pub const fn velocity(&self) -> Vector

Returns the current velocity of the projectile.

pub const fn acceleration(&self) -> Vector

Returns the acceleration of the projectile.

pub fn set_position(&mut self, pos: Point)

Sets the position of the projectile.

pub fn set_velocity(&mut self, vel: Vector)

Sets the velocity of the projectile.

pub fn set_acceleration(&mut self, acc: Vector)

Sets the acceleration of the projectile.

Trait Implementations

impl Clone for Projectile

fn clone(&self) -> Projectile

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Projectile

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for Projectile

fn eq(&self, other: &Projectile) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for Projectile

impl StructuralPartialEq for Projectile