filmRig.package
README.md
lens
Real lenses and lens looks for filmRig. Lenses by focal length on a 35 mm full-frame camera (wide18, standard35, portrait50, tele85, long135, macro) set the field of view (2 x atan(12 / f)) and a matching depth of field: deep focus wide, shallow long, a paper-thin close-focus plane for the macro; a film takes lens = "..." and a shot can take its own. Looks: one name puts a whole photographic look on this peer's picture using the engine's own systems: field of view, depth of field (DepthOfField system, with automatic focus on the shot's target and rack focus), vignette, bloom, chromatic aberration and colour grade (built-in post-process shaders), film grain and lens flare (LensFx system). restore() takes it all off and gives the world back its own depth of field and lens settings.
Looks (look = "..."; the old lens = "<look>" spelling still works): clean, anamorphic, vintage16mm, dreamy, noir, goldenHour, or a table ({ base = "noir", grain = 0.08 }). Quality auto | high | low: auto is low in the browser, on Android and on small screens, which drops depth of field, aberration and flare and lightens grain and bloom.
Lens.apply(lens, quality), Lens.restore(), Lens.setFocus(m), Lens.resolveQuality(q), Lens.lookOf(lens), Lens.register(name, look). Called by filmRig.Film.