8000 GitHub - Dominic-DK/BubbleBloom: 물속 유리꽃이 공기를 머금고 피었다가 방울을 쏘는 iOS 물리 시뮬레이션 (Swift · RealityKit · Metal · Blender) · GitHub
[go: up one dir, main page]

Skip to content

About

물속 유리꽃이 공기를 머금고 피었다가 방울을 쏘는 iOS 물리 시뮬레이션 (Swift · RealityKit · Metal · Blender)

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

21 Commits

Folders and files

Repository files navigation

물꽃 BubbleBloom

영감의 원천: 이 인스타그램 릴스 (2026년 7월 20일, @chinpike 게시) 물속에 놓인 종 모양 유리꽃이 받침의 가는 관으로 들어온 공기를 머금고 고개를 들었다가 방울을 놓고 다시 숙이는 실제 작품 영상입니다. 이 앱은 그 움직임을 화면 속 물리로 다시 만들어 본 개인 연습이며, 원작과는 관계가 없습니다. 게시 계정은 여러 영상을 모아 올리는 곳이라 실제 작가와 작품명은 아직 확인하지 못했습니다. 알고 계신 분은 이슈로 알려 주시면 출처를 바로 고치겠습니다.

Inspired by this Instagram reel (posted by @chinpike, a curation account). The original glass artist is not yet identified. If you know who made it, please open an issue so we can credit them properly.

물속에 잠긴 유리꽃이 줄기로 들어온 공기를 머금고 천천히 고개를 들었다가, 꼭대기에서 공기방울을 톡 쏘아 보내고 다시 숙이는 iOS 앱입니다. 물리 시뮬레이션은 Swift로, 3D 모델과 환경은 Blender 스크립트로, 유리·물·모래 질감은 RealityKit의 Metal 셰이더로 만들었습니다.

A glass flower sits underwater. Air rises through its stem, the flower slowly lifts, releases a bubble at the top, and bows again. Native Swift + RealityKit + Metal, models generated by Blender scripts. Every physics constant can be tuned live from an in-app panel.

물속 유리꽃이 공기를 머금고 들렸다가 방울을 쏘는 모습 물리 조절 패널

실행하기

Xcode 16 이상, iOS 18 이상, XcodeGen이 필요합니다. 셰이더 컴파일에 메탈 툴체인이 없다는 오류가 나면 xcodebuild -downloadComponent MetalToolchain을 한 번 실행하세요.

xcodegen generate
open BubbleBloom.xcodeproj

실기기에 올릴 때는 Xcode의 Signing에서 본인 팀을 고르거나, 명령줄에서 팀 번호를 넘깁니다. 번들 ID가 겹치면 project.yml의 PRODUCT_BUNDLE_IDENTIFIER를 바꾸세요.

xcodebuild -project BubbleBloom.xcodeproj -scheme BubbleBloom -configuration Release \
  -destination 'generic/platform=iOS' DEVELOPMENT_TEAM=<본인 팀 번호> -allowProvisioningUpdates build

실시간 조절

화면 아래 버튼을 누르면 물리 조절 패널이 열립니다. 처음엔 꽃 받침 아래만 덮어서 꽃을 보면서 슬라이더를 움직일 수 있고, 위로 끌어올리면 전체 값이 보입니다. 바꾼 값은 기기에 저장되고, 각 줄의 되돌리기 버튼이나 왼쪽 위 "기본값"으로 원래대로 돌아갑니다. "값 복사"는 지금 값을 텍스트로 복사해서 이슈나 PR에 붙이기 좋게 해줍니다. 꽃 주변을 드래그하면 물을 휘저을 수 있습니다.

묶음 값 하는 일
공기 공기량, 꽉 찬 공기량, 들리기 시작점 공기가 얼마나 빨리 차고, 어느 시점부터 꽃이 들리는지
부력 쉴 때 부력, 최대 부력 쉴 때 얼마나 숙이는지, 꼭대기에서 얼마나 감속하는지
줄기와 꽃머리 줄기 길이, 강성, 꽃머리 관성 낭창함과 묵직함
물 저항 피어날 때, 발사 직후, 전환 시간, 가라앉을 때 올라갈 때와 쏜 뒤, 숙일 때 각각의 출렁임
방울 발사 맺히기 시작 각도, 발사 각도 범위, 꼭대기 머무름, 반동, 방울 속도, 숙이는 시간 방울이 언제 맺혀 언제 떠나고, 꽃이 얼마나 젖혀지는지
진동 진동 세기 발사·터짐·맺힘 진동 전체 배율

시뮬레이터에서 패널이 열린 채로 시작하려면 실행 인자 -openTuning을 주세요.

구조

Sources/
  BloomSimulation.swift  줄기(탄성 관절 16개)와 공기·부력·방울의 2D 물리. 화면과 무관하게 돌아간다.
  BloomScene.swift       시뮬레이션 결과를 RealityKit 장면(줄기 메시, 꽃머리, 방울, 수면)으로 옮긴다.
  Shaders.metal          유리 굴절·프레넬, 공기 주머니, 수조 광선추적, 모래 커스틱, 수면.
  TuningPanel.swift      실시간 조절 패널.
  Haptics.swift          발사·수면 터짐·방울 맺힘 진동.
  WaterGrade.swift       장면 위에 얹는 색감 층.
Blender/                 꽃머리·받침·구슬 모델, 모래 높이 지도, 환경맵을 만드는 스크립트.
Resources/               위 스크립트가 만든 결과물(USDZ, PNG).
Tools/headless/          화면 없이 물리만 돌려 움직임을 숫자로 요약하는 도구.

한 주기는 세 단계입니다. 충전 단계에서는 공기가 꽃머리에 고이며 부력이 매끄러운 곡선으로 붙어서, 꽃이 숙인 채 쉬다가 천천히 들리기 시작해 가속하고 꼭대기에서 감속합니다. 맺힘 단계에서는 꽃 각도가 정해진 값을 넘으면 입구에 방울이 부풀고, 발사 각도에 닿거나 꼭대기에서 잠깐 머문 뒤 방울이 튀어나가며 그 반작용이 줄기를 뒤로 젖힙니다. 숙임 단계에서는 부력이 빠지면서 꽃이 고개를 숙이고, 물 저항이 단계별로 바뀌어 묵직하게 내려앉습니다. 줄기는 관절마다 암시적으로 적분해서 끝쪽 관성이 작아도 발산하지 않습니다.

값 바꾼 뒤 움직임 확인하기

swiftc -O Tools/headless/main.swift Sources/BloomSimulation.swift -o /tmp/bloom-headless
/tmp/bloom-headless                               # 기본값
/tmp/bloom-headless recoilImpulse=0.08 sinkDrag=0.1
발사 각도        36°, 34°, 35°, 37°   (수직에서 잰 꽃 각도)
반동으로 젖혀짐  10°, 8°, 10°, 11°
쉬는 각도        146°
주기             5.9초

모델 다시 만들기

Blender 5.2에서 확인했습니다. 스크립트를 배경 모드로 실행합니다.

blender -b -P Blender/build_models.py -- Resources
blender -b -P Blender/build_sand.py -- Resources/SandHeight.png
blender -b -P Blender/build_environment.py -- Resources/TankEnvironment.png

꽃머리 유리의 두께는 모델의 UV v 채널에 구워 두고 셰이더가 읽습니다. 새 파일을 Resources에 추가했다면 xcodegen generate를 다시 실행해야 번들에 들어갑니다.

알아 둘 점

RealityKit 재질(특히 CustomMaterial)을 매 프레임 다시 지정하면 시뮬레이터에서는 멀쩡해도 실기기에서 화면이 깜빡입니다. 움직이는 값은 엔티티 위치·투명도, 메시 재생성으로 처리하고 재질은 만들 때 한 번만 지정하세요.

라이선스

MIT

About

물속 유리꽃이 공기를 머금고 피었다가 방울을 쏘는 iOS 물리 시뮬레이션 (Swift · RealityKit · Metal · Blender)

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

0