develop
Render a developed preview by adjusting film stock, exposure, grain, or print paper. Only the fields you pass change; returns the developed preview image.
Instructions
Change the film recipe (only the fields you pass) and return the developed preview.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| film | No | Camera film stock (negative, slide/positive or cine). See list_stocks. Default 'kodak_portra_400'. Changing film also switches to its recommended paper unless print is given. | |
| grain | No | Stochastic silver-halide grain. Only rendered in quality='full' (previews skip it for speed). Default True. | |
| No | Print paper or cine print film. Ignored for slide films and when scan_negative is on. Default 'kodak_portra_endura'. | ||
| reset | No | Start from the default recipe before applying the given fields. | |
| quality | No | 'preview' (fast, no grain) or 'full' (grain and all spatial effects, slower). | preview |
| contrast | No | Multiplier on the film's characteristic-curve gamma. >1 like push processing, <1 like pull. Range 0.5 to 1.6. Default 1.0. | |
| couplers | No | Strength of DIR inhibitor couplers (inter-layer effects). Higher = more saturation and local contrast/acutance, 0 = off. Range 0.0 to 2.0. Default 1.0. | |
| halation | No | Red/orange glow around highlights from light bouncing off the film base, plus in-emulsion scatter. Default True. | |
| preflash | No | Uniform pre-exposure of the paper. Lowers print contrast and opens up the shadows. Try 0.005-0.05. Range 0.0 to 0.1. Default 0.0. | |
| diffusion | No | Strength of a Pro-Mist style diffusion filter on the camera, in filter grades (0, 1/8, 1/4, 1/2, 1, 2). 0 = no filter. Range 0.0 to 2.0. Default 0.0. | |
| grain_size | No | Grain particle area in µm². Roughly 0.1 ≈ ISO 100, 0.4 ≈ ISO 400; bigger = coarser. Range 0.02 to 2.0. Default 0.2. | |
| exposure_ev | No | Exposure compensation of the virtual camera in stops, on top of auto exposure. +1 = one stop over. Negative film holds highlights gracefully; underexposure gets muddy and grainy. Range -4.0 to 4.0. Default 0.0. | |
| auto_exposure | No | Meter the scene like a camera so midgray lands on the film's midgray before compensation. Default True. | |
| scan_negative | No | Scan the developed film itself instead of printing it (orange-masked negative, or the slide for positive films). Default False. | |
| film_format_mm | No | Long edge of the film frame in mm (35 = 135, 60/120 = medium format). Smaller formats = bigger grain and halation relative to the frame. Range 8.0 to 120.0. Default 35.0. | |
| m_filter_shift | No | Magenta filtration shift from neutral, Kodak CC units. +M makes the print greener, -M makes it more magenta. Range -40.0 to 40.0. Default 0.0. | |
| print_exposure | No | Enlarger exposure multiplier (like print time). >1 = darker print, <1 = lighter print. Range 0.2 to 3.0. Default 1.0. | |
| scatter_amount | No | In-emulsion light scatter (softness). 1 = physical default, 0 = none. Range 0.0 to 2.0. Default 1.0. | |
| y_filter_shift | No | Yellow filtration shift from neutral, Kodak CC units. +Y makes the print bluer/cooler, -Y makes it yellower/warmer. Range -40.0 to 40.0. Default 0.0. | |
| halation_amount | No | Multiplier on halation strength (1 = physical default for this stock). Try 3-8 for a CineStill-like glow. Range 0.0 to 10.0. Default 1.0. | |
| diffusion_family | No | Diffusion filter family. Default 'black_pro_mist'. | |
| highlight_boost_ev | No | Reconstructs clipped highlights before they hit the film, so light sources bloom and halate more realistically. Range 0.0 to 4.0. Default 0.0. | |
| print_compensation | No | Like a lab printer: compensate print exposure for exposure_ev, so exposure_ev mostly changes tonality (highlight/shadow latitude, grain, saturation) rather than brightness. Turn off to make exposure_ev brighten/darken the print directly. Default True. |