# CinePrompt Studio - Cinematography Edition (v3.3)

## Overview

CinePrompt Studio is a sophisticated AI-powered cinematography prompt generation tool designed for professional filmmakers, directors of photography, and visual artists. It generates highly detailed, technically accurate prompts for text-to-image AI systems, emphasizing deep texture, atmospheric quality, and cinematic lighting.

The application leverages Google's Gemini AI to transform creative concepts into comprehensive cinematography descriptions that incorporate:
- Professional camera bodies and cinema lenses
- Film stock characteristics and texture engines
- Advanced lighting techniques
- Atmospheric and environmental details
- Deep material and surface textures

## Key Features

### 🎬 Professional Cinematography Tools
- **6 Cinema Cameras**: ARRI ALEXA 65, RED V-RAPTOR 8K VV, Sony FX9, ARRI ALEXA Mini LF, Blackmagic URSA Mini Pro 12K, Panasonic Varicam Pure
- **7 Cinema Lenses**: Panavision Primo 70, ARRI Master Prime, Cooke S7/i Full Frame Plus, Zeiss Supreme Prime, Canon CN-E Primes, Sigma Cine FF High Speed, Panavision C-Series Anamorphic
- **Camera/Lens Compatibility Matrix**: Intelligent filtering based on sensor formats

### 🎨 27 Application Presets Including:
- **Documentary Styles**: Ken Burns, Frederick Wiseman, Herzog, Errol Morris
- **Drama Styles**: Prestige Drama, Psychological Thriller, Period Piece
- **Auteur Styles**: Symmetrical Whimsy, IMAX Scale Epic, Clinical Thriller, Gothic Fantasy, Dreamlike Memory, Neon Noir, Raw Documentary, Mythic Western, Surreal Drama
- **Commercial Styles**: Product Beauty, Fashion Editorial, Automotive, Music Video

### 🎭 Advanced Features
- **Film Stock & Texture Engine**: Deep texture generation for photorealistic materials
- **Smart Fill System**: Contextual detail generation with Creative Freedom slider (0.0-1.0)
- **Focus Physics Toggle**: Switch between Realism and Stylistic rendering
- **Master System Prompt**: Emphasis on TEXTURE, ATMOSPHERE, and LIGHT

### 🔧 Technical Capabilities
- Real-time prompt preview with syntax highlighting
- Copy-to-clipboard functionality
- Responsive dark theme UI
- Comprehensive tooltip information for all equipment
- AI-optimized prompt generation via Gemini API

## Installation

### Prerequisites
- Node.js 18.0 or higher
- npm or yarn package manager
- Google Gemini API key

### Setup Instructions

1. **Clone the repository**
```bash
git clone git@bitbucket.org:zlalani/sb-prompt-studio.git
cd sb-prompt-studio
```

2. **Install dependencies**
```bash
npm install
# or
yarn install
```

3. **Configure environment variables**
Create a `.env` file in the root directory:
```env
VITE_GEMINI_API_KEY=your_gemini_api_key_here
```

4. **Start the development server**
```bash
npm run dev
# or
yarn dev
```

5. **Build for production**
```bash
npm run build
# or
yarn build
```

## Configuration

### Gemini API Setup
1. Visit [Google AI Studio](https://makersuite.google.com/app/apikey)
2. Generate an API key
3. Add the key to your `.env` file
4. Ensure the key has proper permissions for generative AI requests

### Camera/Lens Compatibility
The application enforces sensor format compatibility:
- **Full Frame**: Compatible with all lenses
- **Super 35**: Limited to S35-compatible lenses
- **Large Format**: Requires large format lenses
- **Vista Vision**: Specific lens requirements

## Usage Guide

### Basic Workflow
1. **Enter Creative Concept**: Describe your scene or vision
2. **Select Application**: Choose from 27 preset styles
3. **Choose Camera & Lens**: System filters compatible options
4. **Configure Settings**:
   - Film Stock & Texture (if applicable)
   - Focus Physics (Realism vs Stylistic)
   - Creative Freedom (0.0-1.0 slider)
5. **Generate Prompt**: Click to create AI-optimized description
6. **Copy & Use**: Copy the generated prompt for your AI image generator

### Advanced Tips
- **Texture Emphasis**: Version 3.0+ focuses heavily on material textures
- **Lighting Details**: Each application includes specific lighting setups
- **Smart Fill**: Higher Creative Freedom values add more contextual details
- **Auteur Styles**: Pre-configured with specific camera/lens pairings for consistency

## Technical Architecture

### Technology Stack
- **Frontend Framework**: React 18.3 with Hooks
- **Build Tool**: Vite 6.0
- **Styling**: Tailwind CSS
- **AI Integration**: Google Generative AI (Gemini)
- **Icons**: Lucide React
- **State Management**: React useState/useEffect

### Component Structure
```
src/
├── components/
│   └── CinePromptStudio.jsx  # Main application component
├── main.jsx                   # Application entry point
├── index.css                  # Global styles
└── App.jsx                    # Root component wrapper
```

### Key Functions
- `generateOptimizedPrompt()`: Core AI prompt generation
- `getSmartFillContext()`: Contextual detail generation
- `getCameraTextureKeywords()`: Camera-specific texture mapping
- `getAspectRatioProse()`: Format-specific descriptions
- `getNegativeConstraints()`: Quality control parameters

## Version History

### v3.3 (Current)
- Updated camera/lens pairings based on stress testing
- Symmetrical Whimsy now uses Cooke S7/i
- Gothic Fantasy now uses Panavision C-Series

### v3.1
- Added 9 new Auteur Style applications
- Expanded Smart Fill context system
- Enhanced texture descriptions

### v3.0
- Major pivot to pure text-to-image generation
- Removed all image reference features
- Added Film Stock & Texture Engine
- Deep emphasis on TEXTURE, ATMOSPHERE, and LIGHT

### v2.0
- Initial refactor with Master Logic document
- Camera/lens compatibility matrix
- Creative Freedom slider
- Reference image support (removed in v3.0)

## Development

### Local Development
```bash
# Install dependencies
npm install

# Start dev server
npm run dev

# Run build
npm run build

# Preview production build
npm run preview
```

### Project Structure
```
CinePrompt_Studio/
├── src/               # Source code
├── public/            # Static assets
├── LOGO/             # Logo files
├── TESTS/            # Test files (gitignored)
├── .env              # Environment variables (gitignored)
├── package.json      # Dependencies
├── vite.config.js    # Vite configuration
└── README.md         # This file
```

## License

Proprietary - All rights reserved

## Support

For issues, feature requests, or questions, please contact the development team or submit an issue to the Bitbucket repository.

---

**CinePrompt Studio** - Bringing cinematic vision to AI-generated imagery through the power of professional cinematography knowledge.