Fernal

돌보는 방식대로 자라는 데스크톱 3D 식물

바탕화면 위 투명한 창에서 나무 한 그루가 며칠에 걸쳐 자랍니다. 물, 영양, 온도, 습도, 채광, 애정도 여섯 값이 가지의 길이와 각도, 잎의 수와 크기를 정합니다.

Windows 10, 11(64비트)용이며 관리자 권한 없이 설치됩니다. 화면 글자는 한국어입니다.

  1. 성장 20%: 잎이 몇 장 달린 가는 묘목이 청자 화분에 서 있다
    20%
  2. 성장 35%: 줄기 위쪽에 작은 가지와 잎이 모여 있다
    35%
  3. 성장 50%: 큰 가지가 양옆으로 벌어지고 수관이 성기게 덮였다
    50%
  4. 성장 75%: 수관이 넓어지고 한쪽으로 기운 비대칭 모양이 드러난다
    75%
  5. 성장 100%: 잎이 무성한 다 자란 나무
    100%
같은 씨앗(시드)의 나무가 20, 35, 50, 75, 100%20, 50, 100% 자란 모습. 다 자라면 가지가 약 900~1,500개, 잎이 약 3,000~4,800장이 됩니다.

하루 동안 자라는 모습

새벽에 묘목으로 시작한 나무가 해가 하늘을 건너는 동안 자라고, 해가 지면 달빛 아래에서 흔들립니다. 앱의 3D 장면을 프레임마다 그대로 찍어 만든 8초짜리 타임랩스입니다.

실제로는 시간 배속 8에서 하루 안팎이 걸립니다. 바람은 GPU 셰이더가 움직이고, 해와 달은 서울의 실제 태양 위치를 따라갑니다.

06:00에서 21:00까지, 성장 20%에서 100%까지

도구창은 한 문장으로 말합니다

창을 우클릭하거나 트레이 아이콘을 누르면 물 주기, 영양제, 온도 조절, 스프레이, 설정 창을 열 수 있습니다. 도구창은 맨 위에 식물 상태를 한 문장으로 보여 줍니다.

“흙이 말라 가요”

그 아래에 알맞은 범위가 표시된 게이지와 동작 버튼이 있고, 버튼을 누르면 “물을 줬어요”처럼 짧게 결과를 알려 줍니다. 해와 달은 실제 시각에 맞춰 창 위쪽을 지나가고, 온도와 채광은 사는 도시의 오늘 날씨를 따릅니다. 프로그램이 꺼져 있던 시간은 다시 켤 때 최대 7일까지 이어서 계산합니다.

돌봄바뀌는 값
물 주기흙의 수분 +0.2
영양제영양 +0.3
스프레이습도 +0.15
창에 마우스를 올리거나 클릭애정도 +0.05
온도 조절 슬라이더−10~+10 °C
바탕화면 왼쪽에 나무가 떠 있고, 오른쪽에 디버그 도구, 온도 조절(난방으로 4°C 올리는 중), 물 주기(흙이 알맞게 촉촉해요) 창이 반투명하게 열려 있다
식물 창 옆에 디버그 도구, 온도 조절, 물 주기 창을 연 모습. 디버그 도구는 Ctrl+Shift+D로 여는 숨은 창입니다.

세 가지 나무, 낮과 밤

해가 지평선 아래로 내려가면 반대편에서 달이 뜨고, 조명은 따뜻한 햇빛에서 푸른 달빛으로 바뀝니다.

  • 세계수, 낮: 호박빛 잎이 빛나고 금빛 줄기에 균열이 비친다. 위에 해가 떠 있다 세계수, 밤: 달 아래에서 잎끝이 빛나고 금빛 입자가 떠오른다

    세계수

    균열이 빛나는 금빛 껍질, 끝이 밝게 빛나는 호박색 잎, 떠오르는 금빛 입자.

  • 일반 나무, 낮: 여러 겹의 초록 잎이 햇빛을 받아 밝다 일반 나무, 밤: 같은 나무가 달빛 아래 짙은 초록으로 보인다

    일반 나무

    여러 겹의 초록 잎. 활력이 떨어지면 잎이 한 장씩 금빛과 녹슨 빛으로 물들고, 가끔 잎이 떨어집니다.

  • 열매 나무, 낮: 초록 잎 사이에 주황색 감이 여럿 달려 있다 열매 나무, 밤: 달빛 아래 짙은 잎 사이로 감이 보인다

    열매 나무

    일반 나무에 감이 열립니다. 애정도가 높을수록 열매가 많아집니다.

스크린샷의 회색 바탕 자리에는 실제로 창 뒤의 바탕화면이 비쳐 보입니다. 화분은 직접 만든 .glb, .gltf 모델로 바꿀 수 있습니다.

돌보는 대로 자랍니다

나무는 줄기에서 큰 가지, 작은 가지, 잔가지로 같은 규칙을 축척만 바꿔 되풀이해 만듭니다. 여섯 환경 값은 이 규칙의 매개변수가 됩니다. 가지마다 쓰는 난수는 시드와 가지 번호로 고정되어 있어서, 값을 바꾸면 새 나무가 생기지 않고 같은 나무가 이어서 모양을 바꿉니다.

값무엇이 바뀌나측정한 상관계수 r
물모든 가지의 길이와 잎 크기. 0.2 아래로 마르면 가지가 처집니다.가지 수 0.98, 잎 수 0.97, 키 0.99
영양마디마다 나는 곁가지 수가지 수 0.97
습도잎 수(활력과 함께)잎 수 0.96
채광해 쪽으로 기우는 정도와 자라는 속도기울기 1.00
애정도열매 수(열매 나무)열매 수 1.00
온도모양이 아니라 자라는 속도. 22 °C에서 가장 빠릅니다.잎 수는 역U자

한 값만 바꾸고 나머지는 기본값(물 0.6, 영양 0.5, 22 °C, 습도 0.5, 채광 0.6, 애정도 0.5)에 둔 채, 다 자란 나무를 시드 5개로 만들어 평균을 낸 뒤 구한 피어슨 상관계수입니다. 기울기는 해를 동쪽에 두었을 때 가지 끝의 평균 위치를 키로 나눈 값입니다.

  • 잎 수는 습도와 활력에 비례합니다

    ρ=H⋅V

    잎 밀도 ρ는 습도 H와 활력 V의 곱입니다. 활력은 여섯 값이 각자의 알맞은 범위에서 얼마나 벗어났는지를 가중 평균한 0~1 점수입니다.

  • 곁가지 수는 영양을 따릅니다

    𝔼[n]=pom(1.5+2N)

    한 매듭에 붙는 곁가지 수의 기댓값. po는 가지 순서별 계수, m은 축 끝 보정값, N은 영양입니다.

  • 자라는 속도는 22 °C에서 가장 빠른 종 모양입니다

    dAdt=s⋅exp(−(T−2210)2)⋅(0.3+0.7L)⋅V

    식물의 나이 A가 늘어나는 속도. s는 시간 배속, T는 온도, L은 채광입니다. 온도 항은 12 °C와 32 °C에서 1/e로 떨어지고, 밤에도 채광 항이 0.3으로 남아 낮의 약 40% 속도로 계속 자랍니다.

Qt for Python으로 만든 구조

식물 장면 하나만 Qt Quick 3D(QML)이고, 도구창과 메뉴, 트레이, 설정, 디버그 도구는 모두 Qt Widgets 파이썬 코드입니다. 시뮬레이션과 나무 생성은 Qt 없이 도는 순수 파이썬 계층으로 나눠 따로 테스트합니다.

  1. 환경 시뮬레이션sim.py
  2. 가지 골격 생성tree.py
  3. numpy 정점 배열mesh.py
  4. PlantGeometryQQuick3DGeometry
  5. 3D 장면Scene.qml

1초마다 QTimer가 시뮬레이션을 한 단계 진행합니다. 성장 매개변수가 의미 있게 바뀔 때만 골격을 다시 만들고, 나이만 바뀌면 정점의 길이와 굵기만 다시 계산합니다.

투명 오버레이 창QQuickViewFramelessWindowHintWindowStaysOnTopHintWindowTransparentForInput
창을 만들기 전에 QQuickWindow.setDefaultAlphaBuffer(True)로 알파 채널을 받고, 창과 3D 배경을 모두 투명하게 해 바탕화면이 비치게 했습니다. 테두리 없이 항상 위에 뜨며, 클릭 통과 모드는 실행 중에 setFlag로 켜고 끕니다.
파이썬과 QML을 잇는 브리지QObjectPropertysetContextProperty
Bridge(QObject)가 해의 고도와 방위각, 테마 색, 활력, 바람 세기 등 18개 값을 Property로 내보냅니다. 값이 바뀔 때만 변경 시그널을 보내고, QML은 이 속성에 바인딩되어 저절로 다시 그립니다. 데이터는 파이썬에서 QML로 한 방향으로만 흐릅니다.
절차적 메시QQuick3DGeometrysetVertexData
가지, 잎, 열매를 QQuick3DGeometry를 상속한 PlantGeometry로 그립니다. 정점 하나는 40바이트이고, 잎 수천 장을 메시 하나로 합쳐 드로우콜을 줄였습니다. 다 자란 나무(정점 약 4.4만 개)의 배열 계산은 약 7 ms, GPU 업로드는 약 4 ms입니다.
셰이더와 입자CustomMaterialExtendedSceneEnvironmentParticleSystem3D
직접 쓴 GLSL 셰이더 7개로 바람 흔들림, 잎의 역광 투과, 세계수의 균열 발광, 감 열매, 해와 달 원반을 그립니다. 바람은 정점 셰이더에서 계산해 파이썬은 프레임마다 아무 일도 하지 않습니다. 입자는 세계수의 금빛 입자와 일반 나무의 떨어지는 잎입니다.
Qt Widgets 도구창QPainterWA_TranslucentBackgroundQPropertyAnimation
paintEvent에서 QPainter로 반투명 유리 카드 GlassPanel을 직접 그리고, 범위가 함께 보이는 게이지와 세그먼트 선택기도 커스텀 위젯으로 만들었습니다. 도구창은 action(str, float) 시그널만 보내고, 상태는 컨트롤러가 받아서 바꿉니다.
타이머와 스레드QTimerQThreadPoolQRunnable
1초 주기 타이머가 시뮬레이션과 게이지를 갱신하고, 50 ms 단발 타이머는 슬라이더를 연달아 움직여도 골격 재생성을 한 번으로 모읍니다. 날씨와 도시 검색 요청은 별도 스레드에서 처리하고 결과는 시그널로 메인 스레드에 돌려줍니다.
시스템 통합QSystemTrayIconQShortcutQStandardPaths
트레이에 상주하며, 클릭 통과 중에는 트레이 메뉴가 유일한 조작 수단입니다. Ctrl+Shift+D로 숨은 디버그 도구를 열고, 상태는 %APPDATA%\Fernal\state.json에 저장합니다.

바인딩은 Qt 공식 바인딩인 PySide6(LGPL)를 썼습니다. PyQt6와 API가 거의 같아서 Signal, Property를 pyqtSignal, pyqtProperty로 바꿔 읽으면 구조가 그대로 통합니다.

측정한 결과

자동 테스트111건 모두 통과. 위젯 테스트는 QTest.mouseClick으로 실제 클릭을 흉내 내고, 앱 테스트는 실제 QQuickView를 만들어 검사합니다.
CPU코어 1개의 약 10%(세계수 테마 12~13%)
GPU약 9%(8~10%)
메모리약 200MB, 72초 동안 늘지 않음
다 자라기까지첫 실행부터 낮 기준 약 10시간
코드앱 파이썬 3,629줄, QML 631줄, 셰이더 229줄, 테스트 1,451줄

앞으로 할 일

  • 성장 35~50% 구간에서 가지 끝의 약 40~50%가 잎 없이 드러납니다. 잎이 더 일찍 돋게 해 이 비율을 10% 아래로 낮춥니다.
  • Qt 기본 렌더 스레드를 되살리고, 창이 가려졌을 때 프레임 수를 낮춰 노트북 전력을 아낍니다.
  • 실제 날짜에 따른 단풍과 낙엽, 광합성에 따른 탄소 분배 같은 생물학적 모델을 더합니다.
  • 설치 파일 코드 서명, 자동 업데이트, macOS와 Linux 지원.

수식 전체와 분석은 프로젝트 보고서에, 조작법과 옵션은 README에 있습니다.

내려받기

  • Windows 10, 11(64비트)
  • 관리자 권한 없이 사용자 단위로 설치됩니다.
  • 제거는 설정 > 앱에서 합니다. 식물 상태는 %APPDATA%\Fernal에 남습니다.

설치 파일에 코드 서명이 없어서 Windows SmartScreen이 경고할 수 있습니다. 이때는 “추가 정보”를 누른 뒤 “실행”을 누르세요.

소스에서 실행하기

Python 3.14와 requirements.txt의 패키지(PySide6 6.11 이상, numpy)가 필요합니다.

python -m venv .venv
.venv\Scripts\pip install -r requirements.txt
.venv\Scripts\pythonw -m fernal
밤의 세계수: 달 아래에서 호박빛 잎이 빛난다
밤에도 낮의 약 40% 속도로 자랍니다.