# 3dAlbumApp

**Repository Path**: shiter007/3dAlbumApp

## Basic Information

- **Project Name**: 3dAlbumApp
- **Description**: 3d photo album,play pics or videos using ar mode.made by trae deepseek3.1
- **Primary Language**: Swift
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-26
- **Last Updated**: 2025-08-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 3D Album Project----trae deepseek3.1

-------made by trae deepseek3.1 
-------by gohuster

A macOS application that displays photos in an interactive 3D circular album using Apple's SceneKit framework.

## Features

- 3D circular photo arrangement
- Interactive camera controls
- Rotate functionality with buttons
- **Local media file support** - reads images and videos from local folders
- File picker interface for selecting custom folders
- **Photo scaling** - click to zoom individual photos with smooth animations
- **AR模式** - 自动幻灯片播放功能
- **随机缩放** - 随机选择图片进行缩放
- **自动播放控制** - 可手动停止自动播放
- **视频自动缩放** - 视频播放时自动放大屏幕
- Support for multiple image formats (JPG, PNG, GIF, BMP, TIFF)
- Support for multiple video formats (MOV, MP4, AVI, M4V)
- Native macOS SwiftUI interface

## Requirements

- macOS 12.0 or later
- Xcode 14.0 or later
- Swift 5.9

## Building and Running

1. Open Terminal
2. Navigate to the project directory:
   ```bash
   cd /Users/mac/project/3dmacos
   ```

3. Build the project:
   ```bash
   swift build
   ```

4. Run the application:
   ```bash
   swift run
   ```

## Project Structure

- `Package.swift` - Swift Package Manager configuration
- `Sources/3DAlbumApp.swift` - Main application code with SceneKit implementation
- `README.md` - This documentation file

## How to Use

### Using Local Media Files

1. **Automatic Detection**: The app automatically searches your Pictures folder for media files
2. **Custom Folder**: Click "选择文件夹" to choose a different folder containing your photos/videos
3. **Supported Formats**:
   - Images: JPG, JPEG, PNG, GIF, BMP, TIFF
   - Videos: MOV, MP4, AVI, M4V

### Default Behavior
- If no media files are found, the app displays sample placeholder content
- The app searches in this order: User's Pictures folder → App Resources folder

## Controls

- **Mouse Drag**: Rotate the camera around the album
- **Scroll Wheel**: Zoom in/out
- **Rotate Left/Right Buttons**: Rotate the entire album
- **选择文件夹 Button**: Open file picker to select custom media folder
- **随机缩放图片 Button**: Randomly zoom a photo in the album
- **AR模式 Button**: Toggle automatic slideshow mode
- **停止自动播放 Button**: Stop automatic playback (visible in AR mode)
- **Click on any photo**: Click any photo to zoom it (automatically resets after 3 seconds)

## Customization

You can modify:
- Number of photos in the album
- Photo arrangement radius
- Photo plane dimensions
- Lighting and camera positions
- Rotation speed and animations
- AR mode playback timing
- Random selection algorithm
- Video zoom scale and duration

## License

This project is open source and available under the MIT License.