🦀
chip6. キー入力で極座標カメラを動かす
はじめに
2023/08/11時点の内容です。
- rustc 1.71.1
- bevy 0.11.0
bevyは開発初期段階のOSSで、まだまだ破壊的なアップデートが入ります。
でも、面白いですよ。
3rd Anniversaryおめでとう。
Happy birthday, bevy🎉🎉🎉
前回
閑話:ソースコード分割
ソースコードが長くなってきたので、3つに分けました。
- main.rs : これまで通りメインの処理
- const_defs.rs : マジックナンバーを書いておく
- spawn_objs.rs : オブジェクトをspawnする関数を分離
srcに横並びに配置
キーアサイン
極座標カメラのr・Θ・φを増減させるキーは下表のとおりにしました。
動作 | r・Θ・φ | キー | 補足 |
---|---|---|---|
ズームアウト | r増▲ | [z] | 上限あり(適当に) |
ズームイン | r減▼ | [x] | 下限は、近づき過ぎて宝箱にめり込まない程度 |
仰角アップ | Θ増▲ | [↑] | 上限は、直上ちょっと手前 |
仰角ダウン | Θ減▼ | [↓] | 下限は、地面すれすれあたり |
右回転 | φ増▲ | [→] | 上限なし(2π以上になったら2πを引く) |
左回転 | φ減▼ | [←] | 下限なし(0より小さくなったら2πを足す) |
キー入力で極座標カメラを動かす
r・Θ・φを左上に表示するようにしました。Θとφの単位は「度」。
キー入力で動かしてます
main.rs
//external crates
use bevy::
{ prelude::*,
render::*, render::settings::*,
core_pipeline::clear_color::*,
};
//standard library
use std::f32::consts::*;
//internal submodules
mod spawn_objs;
mod const_defs;
use const_defs::*;
//------------------------------------------------------------------------------
fn main()
{ //Note:手元の環境だとVulkanのままでは影が描画されなかったので、DX12へ切り替えた。
let backends = Some ( Backends::DX12 );
let wgpu_settings = WgpuSettings { backends, ..default() };
let backend_dx12 = RenderPlugin { wgpu_settings };
App::new()
.add_plugins
( DefaultPlugins //各種の面倒を見てもらう
.set( backend_dx12 ) //Note:この行をコメントアウトするとbackendがデフォルト選択される
)
.add_systems
( Startup,
( spawn_objs::camera3d_and_light, //3Dカメラとライトを作る
spawn_objs::locked_chest, //3Dオブジェクトを作る
spawn_objs::camera2d, //2Dカメラを作る(情報表示用)
spawn_objs::display_board, //UIテキストを作る(情報表示用)
)
)
.add_systems
( Update,
( //極座標を更新する
( catch_input_from_keyboard, //キー入力による更新
// catch_input_from_mouse,
// catch_input_from_gamepad,
)
.before( move_orbit_camera ), //実行順の制御
bevy::window::close_on_esc, //[ESC]キーで終了
move_orbit_camera, //極座標カメラを動かす
show_parameter, //情報を表示する
)
)
.run();
}
//------------------------------------------------------------------------------
//極座標の型
#[derive( Clone, Copy )]
struct Orbit
{ r : f32, //極座標のr(注目点からカメラまでの距離)
theta: f32, //極座標のΘ(注目点から見たカメラの垂直角度)
phi : f32, //極座標のφ(注目点から見たカメラの水平角度)
}
//極座標から直交座標へ変換するメソッド
impl Orbit
{ fn into_vec3( self ) -> Vec3
{ let x = self.r * self.theta.sin() * self.phi.sin();
let y = self.r * self.theta.cos() * -1.0;
let z = self.r * self.theta.sin() * self.phi.cos();
Vec3::new( x, y, z )
}
}
//------------------------------------------------------------------------------
//極座標カメラに付けるComponent
#[derive( Component )]
struct OrbitCamera { orbit: Orbit }
//極座標カメラの初期位置
impl Default for OrbitCamera
{ fn default() -> Self
{ Self
{ orbit: Orbit
{ r : ORBIT_CAMERA_INIT_R,
theta: ORBIT_CAMERA_INIT_THETA,
phi : ORBIT_CAMERA_INIT_PHI,
}
}
}
}
//UIテキストに付けるComponent
#[derive( Component )]
struct DisplayBoard;
//------------------------------------------------------------------------------
//キー入力によって極座標カメラの位置を更新する
fn catch_input_from_keyboard
( mut q_camera: Query<&mut OrbitCamera>,
time: Res<Time>,
inkey: Res<Input<KeyCode>>,
)
{ let Ok ( mut camera ) = q_camera.get_single_mut() else { return };
let orbit = &mut camera.orbit;
let time_delta = time.delta().as_secs_f32(); //前回の実行からの経過時間
for keycode in inkey.get_pressed()
{ match keycode
{ KeyCode::Z =>
orbit.r = ( orbit.r + time_delta ).min( ORBIT_CAMERA_MAX_R ),
KeyCode::X =>
orbit.r = ( orbit.r - time_delta ).max( ORBIT_CAMERA_MIN_R ),
KeyCode::Up =>
orbit.theta = ( orbit.theta + time_delta ).min( ORBIT_CAMERA_MAX_THETA ),
KeyCode::Down =>
orbit.theta = ( orbit.theta - time_delta ).max( ORBIT_CAMERA_MIN_THETA ),
KeyCode::Left =>
{ orbit.phi -= time_delta;
orbit.phi += if orbit.phi < 0.0 { TAU } else { 0.0 };
}
KeyCode::Right =>
{ orbit.phi += time_delta;
orbit.phi -= if orbit.phi >= TAU { TAU } else { 0.0 };
}
_ => (),
}
}
}
//------------------------------------------------------------------------------
//極座標カメラを動かす
fn move_orbit_camera
( mut q_camera: Query<( &OrbitCamera, &mut Transform )>,
)
{ let Ok ( ( camera, mut transform ) ) = q_camera.get_single_mut() else { return };
//カメラの位置と向きを更新する
let translation = camera.orbit.into_vec3();
*transform = Transform::from_translation( translation )
.looking_at( Vec3::ZERO, Vec3::Y );
}
//------------------------------------------------------------------------------
//極座標の情報を表示する
fn show_parameter
( mut q_text: Query<&mut Text, With<DisplayBoard>>,
q_camera: Query<&OrbitCamera>,
)
{ let Ok ( mut text ) = q_text.get_single_mut() else { return };
let Ok ( camera ) = q_camera.get_single() else { return };
let orbit = &camera.orbit;
let r = orbit.r;
let theta = orbit.theta.to_degrees(); //ラジアンから度へ変換
let phi = orbit.phi.to_degrees(); //ラジアンから度へ変換
let info = format!( " r:{r:3.02}\n theta:{theta:06.02}\n phi:{phi:06.02}" );
text.sections[ 0 ].value = info;
}
const_defs.rs
use super::*;
//2Dカメラの画像を3Dカメラの画像の上にのせる(レンダリングの順位)
pub const CAMERA2D_ORDER: isize = 1;
pub const CAMERA3D_ORDER: isize = 0;
//2Dカメラの画像の背景を透過させる
pub const CAMERA2D_BGCOLOR: ClearColorConfig = ClearColorConfig::None;
//光源
pub const LIGHT_BRIGHTNESS: f32 = 15000.0; //明るさ
pub const LIGHT_POSITION: Vec3 = Vec3::new( 30.0, 100.0, 40.0 ); //位置
//UIテキスト
pub const UI_TEXT_FONT_SIZE: f32 = 50.0;
//極座標カメラの設定値
pub const ORBIT_CAMERA_INIT_R : f32 = 3.0; //初期値
pub const ORBIT_CAMERA_INIT_THETA: f32 = PI * 0.7; //初期値(ラジアン)
pub const ORBIT_CAMERA_INIT_PHI : f32 = 0.0; //初期値(ラジアン)
pub const ORBIT_CAMERA_MAX_R : f32 = 5.0; //最大値
pub const ORBIT_CAMERA_MIN_R : f32 = 1.0; //最小値
pub const ORBIT_CAMERA_MAX_THETA: f32 = PI * 0.99; //最大値(ラジアン)
pub const ORBIT_CAMERA_MIN_THETA: f32 = PI * 0.51; //最小値(ラジアン)
spawn_objs.rs
use super::*;
//3Dカメラと光源を作る
pub fn camera3d_and_light( mut cmds: Commands )
{ //3Dカメラ
let orbit_camera = OrbitCamera::default();
let vec3 = orbit_camera.orbit.into_vec3();
cmds.spawn( ( Camera3dBundle::default(), orbit_camera ) )
.insert( Camera { order: CAMERA3D_ORDER, ..default() } )
.insert
( Transform::from_translation( vec3 ) //カメラの位置
.looking_at( Vec3::ZERO, Vec3::Y ) //カメラレンズの向き
);
//光源
let light = DirectionalLight
{ illuminance: LIGHT_BRIGHTNESS,
shadows_enabled: true, //影の描画を有効化
..default()
};
cmds.spawn( DirectionalLightBundle::default() )
.insert( light )
.insert
( Transform::from_translation( LIGHT_POSITION ) //光源の位置
.looking_at( Vec3::ZERO, Vec3::Z ) //光源の向き
);
}
//------------------------------------------------------------------------------
//2Dカメラを作る
pub fn camera2d( mut cmds: Commands )
{ cmds.spawn( Camera2dBundle::default() )
.insert( Camera { order: CAMERA2D_ORDER, ..default() } )
.insert( Camera2d { clear_color: CAMERA2D_BGCOLOR } );
}
//UIテキストを作る
pub fn display_board( mut cmds: Commands )
{ let textstyle = TextStyle { font_size: UI_TEXT_FONT_SIZE, ..default() };
let text = Text::from_section( "", textstyle ); //placeholderのみ
cmds.spawn( ( TextBundle { text, ..default() }, DisplayBoard ) );
}
//------------------------------------------------------------------------------
//3Dオブジェクトを作る(宝箱)
pub fn locked_chest
( mut cmds: Commands,
mut meshes: ResMut<Assets<Mesh>>,
mut materials: ResMut<Assets<StandardMaterial>>,
)
{ //地面
cmds.spawn( PbrBundle::default() )
.insert( meshes.add( shape::Plane::from_size( 2.0 ).into() ) )
.insert( Transform::from_translation( Vec3::ZERO ) )
.insert( materials.add( Color::rgb( 0.5, 0.7, 0.3 ).into() ) );
//宝箱
cmds.spawn( PbrBundle::default() )
.insert( materials.add( Color::NONE.into() ) ) //透明
.insert( Transform::from_translation( Vec3::new( 0.0, 0.5, 0.0 ) ) )
.with_children
( | cmds |
{ //本体
let shape_box = shape::Box::new( 0.7, 0.3, 0.4 );
cmds.spawn( PbrBundle::default() )
.insert( meshes.add( shape_box.into() ) )
.insert( Transform::from_translation( Vec3::Y * -0.35 ) )
.insert( materials.add( Color::MAROON.into() ) );
//上蓋
let shape_cylinder = shape::Cylinder { height: 0.695, radius: 0.195, ..default() };
cmds.spawn( PbrBundle::default() )
.insert( meshes.add( shape_cylinder.into() ) )
.insert
( Transform::from_translation( Vec3::Y * -0.2 )
.with_rotation( Quat::from_rotation_z( PI * 0.5 ) )
)
.insert( materials.add( Color::MAROON.into() ) );
//錠前
let shape_cube = shape::Cube::new( 0.1 );
cmds.spawn( PbrBundle::default() )
.insert( meshes.add( shape_cube.into() ) )
.insert( Transform::from_translation( Vec3::Y * -0.2 + Vec3::Z * 0.17 ) )
.insert( materials.add( Color::GRAY.into() ) )
.with_children
( | cmds |
{ //鍵穴
let cylinder = shape::Cylinder { height: 0.11, radius: 0.01, ..default() };
cmds.spawn( PbrBundle::default() )
.insert( meshes.add( cylinder.into() ) )
.insert
( Transform::from_translation( Vec3::Y * 0.02 )
.with_rotation( Quat::from_rotation_x( PI * 0.5 ) )
)
.insert( materials.add( Color::BLACK.into() ) );
let shape_box = shape::Box::new( 0.01, 0.04, 0.11 );
cmds.spawn( PbrBundle::default() )
.insert( meshes.add( shape_box.into() ) )
.insert( Transform::from_translation( Vec3::Y * 0.0 ) )
.insert( materials.add( Color::BLACK.into() ) );
}
);
}
);
}
Discussion