🎛️ :: Nannou의 명시적 정의 구조체

Nannou 프레임워크에서 명시적으로 정의된 구조체들은 프레임워크의 핵심 기능을 제공하며, 사용자가 이름을 변경할 수 없는 고정된 타입들입니다. App과 Update 외에도 Nannou는 다양한 구조체와 타입을 제공하여 창 관리, 그래픽 렌더링, 이벤트 처리 등을 지원합니다.

Rust에는 클래스의 개념이 없습니다. 자주 쓰이는 App과 Update는 클래스가 아니라 구조체(struct)로 구현되어 있습니다. 이 구조체들은 Nannou 내부에서 애플리케이션 상태와 업데이트 정보를 관리하는 데 사용됩니다.
Rust에서는 객체 지향 프로그래밍을 트레이트(trait)와 구조체(struct)를 조합해 구현하며, App과 Update도 이 방식으로 설계되었습니다.

Nannou에서 명시적으로 정의된 주요 구조체들

Nannou에서 명시적으로 정의된 주요 구조체에는 App, Update, Frame, Draw, Window, Event, LoopMode, Sketch, Vec2/Vec3, Rgb/Rgba 등이 있습니다. 이들은 Nannou의 핵심 API로, 이름을 변경할 수 없으며 프레임워크의 동작을 제어하는 데 필수적입니다. 사용자 정의 구조체(예: Model)와 달리, 이들은 nannou::prelude에 정의된 고정된 타입입니다.

🧰 App

• Nannou 애플리케이션의 전반적인 상태와 컨텍스트를 관리하는 핵심 구조체입니다. 창 생성, 이벤트 루프 관리, 드로잉 컨텍스트 제공 등의 기능을 수행합니다.

• 주요 메서드:

  • app.new_window(): 새 창을 생성.
  • app.draw(): 드로잉 컨텍스트를 반환.
  • app.main_window(): 메인 창에 접근.

• 사용 예:

fn model(app: &App) -> Model {
    let _window = app.new_window().size(512, 512).view(view).build().unwrap();
    Model { /* ... */ }
}

🧰 Update

• 애플리케이션의 상태 갱신 시 사용되는 구조체로, 프레임 간 시간 정보를 제공합니다. update 함수의 매개변수로 전달됩니다.

• 주요 필드:

  • since_last: 마지막 프레임 이후 경과 시간 (std::time::Duration).
  • since_start: 애플리케이션 시작 이후 경과 시간.

• 사용 예:

fn update(_app: &App, model: &mut Model, update: Update) {
    model.position += update.since_last.as_secs_f32() * 100.0;
}

🧰 Frame

• 렌더링할 단일 프레임을 나타내는 구조체입니다. view 함수에서 드로잉 결과를 프레임에 기록할 때 사용됩니다.
• 주요 역할: 드로잉 명령을 프레임에 적용하고, 이를 화면에 렌더링합니다.
• 사용 예:

fn view(app: &App, model: &Model, frame: Frame) {
    let draw = app.draw();
    draw.background().color(BLACK);
    draw.to_frame(app, &frame).unwrap();
}

🧰 Draw

• Nannou의 드로잉 API를 제공하는 구조체로, 도형, 선, 텍스처 등을 그릴 때 사용됩니다. app.draw()를 호출하여 얻습니다.

• 주요 메서드:

  • draw.ellipse(), draw.rect(), draw.line() 등: 기본 도형 그리기.
  • draw.to_frame(): 드로잉 결과를 프레임에 적용.

• 사용 예:

let draw = app.draw();
draw.ellipse().xy(vec2(0.0, 0.0)).radius(50.0).color(RED);

🧰 Window

• Nannou 애플리케이션의 창을 나타내는 구조체입니다. 창의 크기, 제목, 이벤트 처리 등을 설정할 때 사용됩니다.

• 주요 메서드:

  • window.size(), window.set_title(): 창 속성 설정.
  • window.view(): 창에 렌더링할 뷰 함수 지정.

• 사용 예:

let _window = app.new_window().size(800, 600).title("My App").view(view).build().unwrap();

🧰 Event

• 마우스, 키보드, 창 이벤트 등 다양한 사용자 입력과 시스템 이벤트를 처리하는 구조체입니다. event 함수에서 사용됩니다.
• 주요 필드: 다양한 이벤트 타입(예: MouseMoved, KeyPressed)을 포함하는 열거형(enum)과 관련.
• 사용 예:

fn event(_app: &App, model: &mut Model, event: Event) {
    match event {
        Event::WindowEvent { simple: Some(event), .. } => {
            if let WindowEvent::KeyPressed(Key::Space) = event {
                model.color = rgb(0.0, 1.0, 0.0); // 스페이스바로 색상 변경
            }
        }
        _ => {}
    }
}

🧰 LoopMode

• 애플리케이션의 루프 모드를 설정하는 구조체로, 프레임 업데이트 방식(예: 고정 프레임 속도, 수요 기반 렌더링)을 제어합니다.
• 주요 사용: app.set_loop_mode(LoopMode::Rate(fps))로 프레임 속도를 설정.
• 사용 예:

fn model(app: &App) -> Model {
    app.set_loop_mode(LoopMode::Rate(60.0)); // 60 FPS로 설정
    Model { /* ... */ }
}

🧰 Sketch

• 간단한 스케치 애플리케이션을 만들 때 사용되는 구조체로, nannou::sketch 모듈에서 제공됩니다. App을 단순화한 인터페이스입니다.
• 주요 사용: 빠르게 프로토타이핑할 때 유용.
• 사용 예:

use nannou::prelude::*;
fn main() {
    nannou::sketch(view).run();
}
fn view(app: &App, frame: Frame) {
    let draw = app.draw();
    draw.background().color(WHITE);
    draw.to_frame(app, &frame).unwrap();
}

🧰 Vec2, Vec3, Point2, Point3

• 2D 및 3D 벡터와 점을 나타내는 구조체들로, 위치, 이동, 회전 등을 처리할 때 사용됩니다. glam 라이브러리에서 가져온 타입입니다.
• 주요 사용: 그래픽 애플리케이션에서 좌표와 변환을 다룰 때 필수적.
• 사용 예:

let position = vec2(100.0, 200.0); // 2D 벡터
draw.ellipse().xy(position).radius(20.0).color(BLUE);

🧰 Rgb, Rgba, Hsl, Hsla

• 색상을 나타내는 구조체들로, RGB, RGBA, HSL, HSLA 색상 모델을 지원합니다.
• 주요 사용: 드로잉 시 색상 지정.
• 사용 예:

draw.rect().w_h(100.0, 100.0).color(Rgb::new(1.0, 0.0, 0.0)); // 빨간색 사각형

✅ ⚙️🛠️📄📚🎨🖼️🧩🧠🧮🕹️🧿⏳🎛️🔮🌌🪩🗂️📝🧰🔒

아보카도
Sample
Important
Highlighting
비색
적황색
purple
hot pink
yellow
살구색
orange
green
blue