mirror of
https://github.com/bevyengine/bevy
synced 2024-11-30 00:20:20 +00:00
4d3f43131e
# Objective The documentation for [`Transform::align`](https://docs.rs/bevy/0.14.0-rc.3/bevy/transform/components/struct.Transform.html#method.align) mentions a hypothetical ship model. Showing this concretely would be a nice improvement over using a cube. > For example, if a spaceship model has its nose pointing in the X-direction in its own local coordinates and its dorsal fin pointing in the Y-direction, then align(Dir3::X, v, Dir3::Y, w) will make the spaceship’s nose point in the direction of v, while the dorsal fin does its best to point in the direction w. ## Solution This commit makes the ship less hypothetical by using a kenney ship model in the example. The local axes for the ship needed to change to accommodate the gltf, so the hypothetical in the documentation and this example's local axes don't necessarily match. Docs use `align(Dir3::X, v, Dir3::Y, w)` and this example now uses `(Vec3::NEG_Z, *first, Vec3::X, *second)`. I manually modified the `craft_speederD` Node's `translation` to be 0,0,0 in the gltf file, which means it now differs from kenney's original model. Original ship from: https://kenney.nl/assets/space-kit ## Testing ``` cargo run --example align ```    |
||
|---|---|---|
| .. | ||
| AlienCake | ||
| animated | ||
| AnisotropyBarnLamp | ||
| barycentric | ||
| CornellBox | ||
| cube | ||
| cubes | ||
| DepthOfFieldExample | ||
| extras | ||
| FlightHelmet | ||
| FlightHelmetLowPoly | ||
| GolfBall | ||
| IrradianceVolumeExample | ||
| ship | ||
| SimpleSkin | ||
| sphere | ||
| terrain | ||
| TonemappingTest | ||
| torus | ||
| VolumetricFogExample | ||
| Box0.bin | ||