bevy-cameras

사용 방법

설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.

npx skills add https://github.com/chrisgliddon/bevy-skills --skill bevy-cameras

시작 전 확인

설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.

원본 Skill 문서

원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.

Bevy 0.19 — Cameras

When to use this skill

Spawning the main game camera.
Rendering to a texture (mini-map, portal, post-process target).
Wanting a drop-in free-look or pan controller without writing your own.
Configuring multiple cameras with different order for overlays.
Setting ambient brightness on a per-camera basis.
Building a third-person pivot/boom camera with fixed-pose interpolation and Rapier

obstruction casts.

Canonical pattern

FreeCamera/PanCamera are gated behind Cargo features. In Cargo.toml:

toml

bevy = { version = "0.19", features = ["free_camera", "pan_camera"] }

rust

use bevy::asset::RenderAssetUsages;
use bevy::camera::RenderTarget;
use bevy::camera_controller::free_camera::{FreeCamera, FreeCameraPlugin};
use bevy::prelude::*;

fn main() {
    App::new()
        .add_plugins(DefaultPlugins)
        .add_plugins(FreeCameraPlugin) // adds the input wiring
        .add_systems(Startup, setup)
        .run();
}

fn setup(mut commands: Commands, mut images: ResMut<Assets<Image>>) {
    // 1. Main camera with the built-in free-look controller.
    commands.spawn((
        Camera3d::default(),
        FreeCamera::default(),
        Transform::from_xyz(0.0, 4.0, 8.0).looking_at(Vec3::ZERO, Vec3::Y),
    ));

    // 2. A texture target for an off-screen render pass (mini-map, portal).
    let size = bevy::render::render_resource::Extent3d {
        width: 512,
        height: 512,
        depth_or_array_layers: 1,
    };
    let mut image = Image::new_fill(
        size,
        bevy::render::render_resource::TextureDimension::D2,
        &[0; 4],
        bevy::render::render_resource::TextureFormat::Bgra8UnormSrgb,
        RenderAssetUsages::default(),
    );
    image.texture_descriptor.usage =
        bevy::render::render_resource::TextureUsages::TEXTURE_BINDING
            | bevy::render::render_resource::TextureUsages::COPY_DST
            | bevy::render::render_resource::TextureUsages::RENDER_ATTACHMENT;
    let image_handle = images.add(image);

    // 3. A second camera that draws into the texture.
    //    RenderTarget is now a *separate* component, not Camera.target.
    commands.spawn((
        Camera3d::default(),
        Camera { order: -1, ..default() }, // -1 = render before the main camera
        RenderTarget::Image(image_handle.into()),
        Transform::from_xyz(10.0, 5.0, 0.0).looking_at(Vec3::ZERO, Vec3::Y),
    ));
}

Choosing a projection

rust

use bevy::prelude::*;
use bevy::camera::Projection;

# fn _proj(mut commands: Commands) {
// Default perspective (45° vertical FOV).
commands.spawn((Camera3d::default(), Projection::default()));

// Orthographic for top-down or strategy views.
commands.spawn((
    Camera3d::default(),
    Projection::Orthographic(OrthographicProjection {
        scale: 10.0,
        ..OrthographicProjection::default_3d()
    }),
));
# }

Ambient light: world default vs per-camera

rust

use bevy::prelude::*;
use bevy::light::GlobalAmbientLight;

# fn _amb(app: &mut App, mut commands: Commands) {
// World default — applies everywhere unless a camera overrides.
app.insert_resource(GlobalAmbientLight {
    brightness: 200.0,
    ..default()
});

// Per-camera override (`AmbientLight` is a Component).
commands.spawn((Camera3d::default(), AmbientLight { brightness: 1000.0, ..default() }));
# }

Bevy 0.19 gotchas

`RenderTarget` is a separate component. Camera { target: ... } is an old

shape. Spawn RenderTarget alongside Camera3d / Camera.

`AmbientLight` is no longer a `Resource`. It's a per-camera component. The world default lives in the GlobalAmbientLight resource.
`ImageRenderTarget::scale_factor` is `f32` (used to be wrapped in FloatOrd).
Camera `order` is signed. Lower values render first. Use order: -1 for off-screen passes you'll sample in the main pass.
`FreeCamera` / `PanCamera` need their plugin and Cargo feature. Add

features = ["free_camera", "pan_camera"]; spawning only the component does not install its input systems.

Imports: bevy::camera::RenderTarget, bevy::camera_controller::{free_camera::*, pan_camera::*}, bevy::light::GlobalAmbientLight. None are in the prelude.

사용 방법

시작 전 확인

Bevy 0.19 — Cameras

When to use this skill

Canonical pattern

Choosing a projection

Ambient light: world default vs per-camera

Bevy 0.19 gotchas

See also

더 많은 Skills

bevy-diagnostics-profiling

bevy-ecs-components

bevy-custom-assets