# PhotoWall

**Repository Path**: GProReat_admin/photo-wall

## Basic Information

- **Project Name**: PhotoWall
- **Description**: 照片墙，放置文件到photos目录，可以自己动加载
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-12
- **Last Updated**: 2026-06-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

🌸 Interactive Hanging Photo Wall & Multi-Track Editor
这是一个基于 LÖVE (Love2D) 引擎与 Box2D (love.physics) 物理引擎开发的高交互、高动态的物理悬挂照片墙系统。

项目融合了自适应多轨相机编辑器、拟真日式风铃动力学、多重底片揭开滤镜渲染以及智能交互猫咪指向系统，兼具艺术观赏性与实用演示编辑功能。

🌟 核心特性 (Key Features)
1. 🎞️ 三轨独立关键帧编辑器 (Multi-Track Timeline Editor)
独立轴向控制：重构了传统单轴时间线，划分为 Camera X、Camera Y、Camera Zoom (缩放) 三条完全独立的控制轨道。
独立增删帧器：点击各轨行头的 [ + ] 与 [ - ] 按钮，实现在当前时间游标（Time Cursor）处对特定轨道进行关键帧的插入与剔除。
节点拖拽微调：可以在时间轴上直接拉动特定轨道的值，或配合左侧控制板的滑块高亮修改各节点的数值。支持一键 [S] 保存数据持久化到本地。
2. 🐱 智能猫咪指向交互 (Smart Cat Claw Interaction)
高精度左上指向：卡牌触发放大特写时，右下角的猫咪会自动伸出白手套爪子精准斜指向左上方的焦点照片（指向角 
−
135
∘
−135 
∘
 ），眼球同步回眸。
等比自适应收放：实时跟踪照片的缩放尺度 displayScale。卡片放大时爪子探出，卡片复原缩小至原位（displayScale = 1.0）时，爪子自动收回腹下恢复安稳睡眠。
四猫切换：支持一键切装黑猫、橘猫、白猫与暹罗咖啡猫四种不同外观。
3. 🌬️ 温馨阳光庭院与物理风铃 (Atmospheric Sunlit Garden & Wind Chimes)
拟真钟摆风铃：利用简谐振动物理刚度与空气动力学阻尼，模拟日式玻璃风铃。
风幡迎风飞扬：风起时，风铃下挂的蓝色纸片（Tanzaku）会产生大角度顺风飘荡和随风抖动特效。
离散高低差悬挂：生成照片时采用负相关悬索机制——照片挂钉点越靠下，悬绳段自动折叠缩短，创造出超高离散度、决不穿底的照片墙参差美学。
气候系统配合：周期性自动在院内刮起强风，纸屑、落叶随风狂舞，照片卡牌受风力作用互相摩擦、碰撞和摆动。
4. 🎭 4 种过渡曝光底片效果 (Slide Reveal Animations)
8张照片依次曝光揭开时，会随机分配并轮流切换以下特效：

明黄闪烁开幕：卡牌闪耀高饱和度的明黄色弧光闪烁，最终闪出底层贴图。
斜向切片渐显：如同一层蒙版胶片由左下角滑移掀开至右上角。
百叶窗滑动展卷：5条平行细缝栅格同步横向展布开来。
光圈圆洞扩散：以卡片中心为圆心产生光圈圆洞，逐渐扩散暴露出精美原图。
🎮 操作控制指南 (Controls)
按键 (Key)	功能描述 (Description)
Tab 键	核心切换：隐藏/展示多轨时间轴编辑器界面 (暂停时可物理抓取照片)
Space 空格	播放 / 暂停相机自动导轨录制巡航状态
S 键	将当前编辑好的三轨关键帧数据写盘保存至 keyframes_multi_track.txt
O 键	顺次切换右下角猫咪的样式与品种 (黑猫/橘猫/白猫/暹罗猫)
P 键	循环切换视差背景墙材质 (红砖墙 / 极简白墙 / 复古木护墙 / 物理风铃庭院)
H 键	打开或关闭简易使用悬浮指导弹窗
Esc 键	优雅退出程序
鼠标左键	编辑状态下双击或拖拽滑块/关键帧点；播放状态下可直接拖拽照片发生碰撞摇晃
🛠️ 项目目录结构 (Directory Structure)
.
├── main.lua                # 主程序逻辑 (已包含物理世界、渲染器及UI系统)
├── conf.lua                # 窗口参数配制 (建议宽: 1200, 高: 800)
├── keyframes_multi_track.txt # 三轨关键帧保存自动存盘文件 (运行后自动生成)
└── photos/                 # 自定义图像文件夹 
    ├── 1.png
    ├── 2.jpg
    └── ...                 # 支持放置任意 jpg/png 格式，程序会自动等比裁剪防拉伸
🚀 快速开始 (Getting Started)
下载并安装 LÖVE 引擎 (推荐版本 v11.x 及以上)。
在项目根目录下创建 photos/ 文件夹，并放入任意 8 张您的精美照片。
执行如下命令运行项目：
love .