{"id":29089983,"url":"https://github.com/serhatkildaci/usdztopng","last_synced_at":"2026-05-07T01:36:16.366Z","repository":{"id":301230562,"uuid":"1008591416","full_name":"serhatkildaci/USDZtoPNG","owner":"serhatkildaci","description":"🎯 Professional macOS app that converts USDZ 3D models to high-quality PNG images with advanced rotation controls and studio lighting","archived":false,"fork":false,"pushed_at":"2025-06-25T19:37:42.000Z","size":0,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-25T20:32:11.480Z","etag":null,"topics":["3d","3d-models","converter","image-processing","macos","mvvm","png","rendering","scenekit","swift","swiftui","usdz"],"latest_commit_sha":null,"homepage":null,"language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/serhatkildaci.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-25T19:32:49.000Z","updated_at":"2025-06-25T19:37:45.000Z","dependencies_parsed_at":"2025-06-25T20:42:33.472Z","dependency_job_id":null,"html_url":"https://github.com/serhatkildaci/USDZtoPNG","commit_stats":null,"previous_names":["serhatkildaci/usdztopng"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/serhatkildaci/USDZtoPNG","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/serhatkildaci%2FUSDZtoPNG","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/serhatkildaci%2FUSDZtoPNG/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/serhatkildaci%2FUSDZtoPNG/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/serhatkildaci%2FUSDZtoPNG/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/serhatkildaci","download_url":"https://codeload.github.com/serhatkildaci/USDZtoPNG/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/serhatkildaci%2FUSDZtoPNG/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262371698,"owners_count":23300599,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["3d","3d-models","converter","image-processing","macos","mvvm","png","rendering","scenekit","swift","swiftui","usdz"],"created_at":"2025-06-28T04:06:29.107Z","updated_at":"2026-05-07T01:36:16.313Z","avatar_url":"https://github.com/serhatkildaci.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"# USDZtoPNG\n\nA powerful, modern macOS application that converts USDZ 3D model files to high-quality PNG images with professional rendering, advanced lighting, and precise control over camera positioning and model rotation.\n\n[![macOS](https://img.shields.io/badge/macOS-14.0+-blue.svg)](https://www.apple.com/macos/)\n[![Swift](https://img.shields.io/badge/Swift-6.0-orange.svg)](https://swift.org/)\n[![SwiftUI](https://img.shields.io/badge/SwiftUI-Latest-green.svg)](https://developer.apple.com/swiftui/)\n[![Architecture](https://img.shields.io/badge/Architecture-MVVM-purple.svg)](https://en.wikipedia.org/wiki/Model%E2%80%93view%E2%80%93viewmodel)\n[![License](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n\n## 🎯 Overview\n\nUSDZtoPNG bridges the gap between 3D content creation and 2D presentation needs with professional-grade rendering capabilities. Whether you're working in e-commerce, creating product documentation, or preparing marketing materials, this app provides a seamless way to generate studio-quality images from USDZ 3D models with precise control over every aspect of the rendering process.\n\n## ✨ Key Features\n\n### 🎮 **Advanced Rotation Controls**\n- **Individual Axis Control**: Separate X, Y, Z rotation sliders (-180° to +180°)\n- **Random Rotation Options**: Toggle random rotation for each axis independently\n- **Mixed Mode Support**: Combine manual and random rotations (e.g., fixed X/Z, random Y)\n- **Real-time Degree Display**: Live feedback showing exact rotation values\n- **One-Click Reset**: Instantly return all rotations to default settings\n\n### 🎯 **Core Functionality**\n- **Modern Drag \u0026 Drop Interface**: Simply drop USDZ files onto the app\n- **Batch Processing**: Convert multiple files simultaneously with progress tracking\n- **High-Quality Output**: 1200x1200 resolution with 4x multisampling antialiasing\n- **Real-time Preview**: See results before exporting with live camera adjustments\n\n### 📐 **Camera \u0026 Positioning**\n- **Smart Auto-Positioning**: Automatic camera distance based on model bounding sphere\n- **Manual Distance Control**: Fine-tune viewing distance with precision slider\n- **Optimal Framing**: Models automatically centered and properly scaled\n- **Look-At Constraints**: Camera always focuses on model center\n\n### 🔧 **Advanced Settings**\n- **Flexible Camera Distance**: 1x to 10x multiplier with 0.5 step precision\n- **Quality Controls**: Multiple antialiasing options (None, 2x, 4x)\n- **Output Formats**: PNG, JPEG, TIFF support with quality settings\n- **Background Options**: Customizable background colors\n\n## 📱 Screenshots\n\n### Main Interface\n![Main Application Interface](images/mainAppUpload.png)\n*Clean, modern interface with drag-and-drop functionality and real-time preview*\n\n### Rendered Output Preview\n![Rendered 3D Model](images/mainImage.png)\n*High-quality rendered output with professional lighting and precise rotation control*\n\n### File Import Options\n![Import Interface](images/import.png)\n*Multiple import options including drag-and-drop and file browser integration*\n\n### Advanced Settings Panel\n![Professional Settings](images/settings.png)\n*Comprehensive camera, rotation, and quality controls in an intuitive settings interface*\n\n## 🚀 Getting Started\n\n### Prerequisites\n\n- **macOS 14.0 (Sonoma)** or later\n- **Xcode 15.0+** (for building from source)\n- USDZ files to convert (supports all standard USDZ formats)\n\n### Installation\n\n#### Option 1: Download Release (Recommended)\n1. Download the latest release from the [Releases](../../releases) page\n2. Drag `USDZtoPNG.app` to your Applications folder\n3. Launch the app and grant necessary permissions when prompted\n\n#### Option 2: Build from Source\n1. Clone this repository:\n   ```bash\n   git clone https://github.com/yourusername/USDZtoPNG.git\n   cd USDZtoPNG\n   ```\n\n2. Open the project in Xcode:\n   ```bash\n   open USDZtoPNG.xcodeproj\n   ```\n\n3. Select your development team in **Signing \u0026 Capabilities**\n\n4. Build and run the project (`⌘R`)\n\n## 🎮 Usage Guide\n\n### Single File Conversion\n1. **Launch** USDZtoPNG\n2. **Import** a USDZ file by:\n   - Dragging and dropping onto the app window, or\n   - Using the import button to browse for files\n3. **Preview** the rendered result in real-time\n4. **Adjust Settings** (optional):\n   - Camera distance for closer/further views\n   - Individual X, Y, Z rotations for perfect angles\n   - Enable random rotation on specific axes\n5. **Export** by clicking \"Export PNG\" and choosing save location\n\n### Advanced Rotation Control\n- **Manual Rotation**: Use individual sliders for precise X, Y, Z positioning\n- **Random Rotation**: Toggle random rotation for any combination of axes\n- **Mixed Mode**: Set some axes manually while others randomize\n- **Real-time Feedback**: See degree values update as you adjust\n- **Quick Reset**: Use \"Reset All\" to return to default orientation\n\n### Batch Processing\n1. Click **\"Import Multiple\"** or drag multiple USDZ files simultaneously\n2. **Configure Settings** that will apply to all files\n3. **Select Output Directory** for batch export\n4. **Monitor Progress** with real-time processing indicators\n5. **Review Results** in the completion summary\n\n### Camera \u0026 Quality Settings\n- **Distance Control**: Adjust how close the camera is positioned (1x-10x)\n- **Quality Options**: Choose antialiasing level (None/2x/4x)\n- **Output Format**: Select PNG, JPEG, or TIFF with quality settings\n- **Background**: Customize background color for your renders\n\n## 🔧 Technical Details\n\n### Modern Architecture\n- **Framework**: SwiftUI with modern async/await patterns\n- **Architecture**: MVVM with dedicated ViewModels and Services\n- **3D Rendering**: SceneKit with custom lighting and camera systems\n- **File Handling**: UniformTypeIdentifiers for robust USDZ support\n- **Security**: App Sandbox with user-selected file access\n- **Concurrency**: Actor-isolated rendering for thread safety\n\n### Professional Rendering Pipeline\n1. **Scene Loading**: Parse USDZ with comprehensive error handling\n2. **Model Analysis**: Calculate optimal bounding sphere and dimensions\n3. **Content Positioning**: Smart centering and scaling algorithms\n4. **Lighting Setup**: Configure 6-light professional studio system\n5. **Camera Positioning**: Set distance and constraints based on model size\n6. **Rotation Application**: Apply manual and/or random rotations per axis\n7. **High-Quality Render**: Generate images with advanced antialiasing\n8. **Format Export**: Convert to selected format with quality settings\n\n### Performance Optimizations\n- **Background Processing**: All rendering operations off main thread\n- **Memory Management**: Efficient handling of large 3D models and textures\n- **Component Isolation**: Prevent unnecessary UI re-renders\n- **Lazy Loading**: Efficient list rendering for large file collections\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🎯 Why Choose USDZtoPNG?\n\n- **Professional Results**: Studio-quality renders out of the box\n- **Total Control**: Control over every aspect of rendering\n- **Performance Focused**: Optimized for speed and efficiency\n- **User Friendly**: Complex 3D rendering made simple\n- **Future Proof**: Continuously updated with latest features\n\n---\n\n**Made with ❤️ for the 3D content community**\n\n*Transform your USDZ models into stunning images with professional precision and creative control.* ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fserhatkildaci%2Fusdztopng","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fserhatkildaci%2Fusdztopng","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fserhatkildaci%2Fusdztopng/lists"}