🎛️ :: fn main()의 콜백 함수

nannou v0.19 앱 & 윈도우 빌더 옵션 모음

nannou에서는 app(model).update(update).event(event).view(view)... 형태로 콜백 함수를 등록합니다.
이때 각 콜백은 정해진 시그니처(인자 타입)를 가지는데, 실제로 모든 인자를 다 쓰는 경우는 드뭅니다.

컴파일러는 "안 쓰는 변수"에 경고를 내기 때문에, 필요 없는 인자는 _ 혹은 _name으로 처리하면 됩니다.

함수	시그니처	인자 설명	주로 필요한 상황
model	fn(&App) -> Model	app: 전역 앱 상태	- 윈도우 크기/위치 가져올 때 - 텍스처, 캡처 초기화
update	fn(&App, &mut Model, Update)	app: 전역 정보 model: 사용자 정의 상태 update: 델타타임 등	- 모델 값 매 프레임 갱신 - 애니메이션, 물리 시뮬레이션
event	fn(&App, &mut Model, Event)	event: 모든 입력/윈도우 이벤트	- 마우스/키보드 제어 - 윈도우 크기 변경 반응
view	fn(&App, &Model, Frame)	app: draw 핸들 접근 model: 현재 상태 읽기 frame: 이번 프레임 캔버스	- 화면 그리기
exit	fn(&App, &mut Model)	앱 종료 시 호출	- 파일 저장, 리소스 해제

---

🎯 각 인자의 필요성 가이드

&App

• 전역 앱 상태를 의미

  • app.draw() → 그림 그릴 때
  • app.time → 경과 시간 참조
  • app.window_rect() → 윈도우 크기/좌표 사용

• 안 쓰는 경우: 단순히 모델 값만 갱신할 때

&mut Model 혹은 &Model

• 사용자 정의 상태 구조체

  • 위치, 색상, 속도 등 상태를 저장/변경할 때
  • update에서 &mut Model → 값 변경
  • view에서 &Model → 값 읽기

• 안 쓰는 경우: 상태 없이 랜덤 그림만 그리고 싶을 때

Update

• 프레임별 갱신 정보 (delta time 포함)

  • 시간 기반 애니메이션 (프레임 레이트 무관)
  • update.since_last → 경과 시간 활용

• 안 쓰는 경우: frame count 기반 애니메이션만 할 때

Event

• 모든 입력 이벤트가 들어오는 관문

  • 키보드 입력 (KeyPressed, KeyReleased)
  • 마우스 입력 (MouseMoved, MousePressed, MouseReleased)
  • 윈도우 이벤트 (Resized, Moved)

• 안 쓰는 경우: 입력을 쓰지 않고 자동으로 그림만 갱신할 때

Frame

• 현재 프레임의 캔버스

  • draw.to_frame(app, &frame) → 실제 화면에 출력

• 안 쓰는 경우: view를 안 쓰는 경우는 거의 없음 (항상 필요)

---

🎯 메소드 별 인자 및 함수 가이드

메소드/옵션	위치 (App vs Window)	인자 또는 넘겨주는 함수	함수(콜백) 시그니처	역할 요약
app(model)	App 빌더 시작	model: fn(&App) -> Model	fn(&App) -> Model	앱 상태 만들기
.update(update)	App	update: fn(&App, &mut Model, Update)	fn(&App, &mut Model, Update)	매 프레임 상태 갱신
.event(event)	App	event: fn(&App, &mut Model, Event)	fn(&App, &mut Model, Event)	전역 입력 / 이벤트 처리
.simple_window(view)	App	view: fn(&App, &Model, Frame)	fn(&App, &Model, Frame)	단순 윈도우 + 뷰 만들기
.size(w, h)	App	w: u32, h: u32	—	윈도우 너비/높이 설정
.loop_mode(mode)	App	mode: LoopMode	—	실행 방식 조정 (vsync, 고정 속도 등)
.exit(exit_fn)	App	exit_fn: fn(&App, Model)	fn(&App, Model)	앱 종료 시 호출
.run()	App	—	—	앱 시작

---

메소드/옵션	위치 (Window)	인자 또는 넘겨주는 함수	함수(콜백) 시그니처	역할 요약
.view(view_fn)	Window	fn(&App, &Model, Frame)	fn(&App, &Model, Frame)	해당 윈도우 그리기 함수
.raw_view(raw_view_fn)	Window	fn(&App, &Model, RawFrame)	fn(&App, &Model, RawFrame)	저수준 렌더링
.sketch(sketch_fn)	Window	fn(&App, Frame)	fn(&App, Frame)	간단한 스케치 모드
.event(event_fn)	Window	fn(&App, &mut Model, WindowEvent)	fn(&App, &mut Model, WindowEvent)	윈도우 이벤트 전체
.raw_event(raw_event_fn)	Window	fn(&App, &mut Model, winit::WindowEvent)	fn(&App, &mut Model, WindowEventRaw)	원시 윈도우 이벤트 처리
.key_pressed(f) / .key_released(f)	Window	fn(&App, &mut Model, Key)	fn(&App, &mut Model, Key)	키 입력 처리
.received_character(f)	Window	fn(&App, &mut Model, char)	fn(&App, &mut Model, char)	문자 입력 처리
.mouse_moved(f)	Window	fn(&App, &mut Model, Point2)	fn(&App, &mut Model, Point2)	마우스 움직임 감지
.mouse_pressed(f) / .mouse_released(f)	Window	fn(&App, &mut Model, MouseButton)	fn(&App, &mut Model, MouseButton)	마우스 버튼
.mouse_wheel(f)	Window	fn(&App, &mut Model, MouseScrollDelta)	fn(&App, &mut Model, MouseScrollDelta)	휠/스크롤
.mouse_entered(f) / .mouse_exited(f)	Window	fn(&App, &mut Model)	fn(&App, &mut Model)	마우스 윈도우 안팎 이동
.touch(f)	Window	fn(&App, &mut Model, TouchEvent)	fn(&App, &mut Model, TouchEvent)	터치 입력
.touchpad_pressure(f)	Window	fn(&App, &mut Model, TouchpadPressure)	fn(&App, &mut Model, TouchpadPressure)	터치패드 압력감지
.moved(f)	Window	fn(&App, &mut Model, Point2)	fn(&App, &mut Model, Point2)	윈도우 위치 바뀜
.resized(f)	Window	fn(&App, &mut Model, Size2)	fn(&App, &mut Model, Size2)	윈도우 크기 변경
.focused(f) / .unfocused(f)	Window	fn(&App, &mut Model)	fn(&App, &mut Model)	윈도우 포커스 획득/상실
.closed(f)	Window	fn(&App, &mut Model)	fn(&App, &mut Model)	윈도우 닫힘
.hovered_file(f) / .dropped_file(f)	Window	fn(&App, &mut Model, PathBuf)	fn(&App, &mut Model, PathBuf)	파일 드래그해서 가져오기 etc.
.clear_color(color)	Window	color: IntoLinSrgba<f32>	—	배경색 지정
.max_capture_frame_jobs(n)	Window	n: u32	—	캡처 프레임 작업 동시 실행 최대 개수

---

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

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