Open FirstFrame · Tour · Run it yourself · Add a camera
FirstFrame is a free website for learning how a camera works before you buy one. You practise on a 3D Canon EOS R100, a common first mirrorless camera, built from Canon's own photos and measurements. You can press its buttons, open its doors, change lenses and take practice photos. After each photo, the site tells you why it came out bright, dark, sharp or blurred.
It runs in your web browser. You don't need a camera, an account or any download, and nothing you do is tracked.
- The whole site has a darker, film-set look: black backgrounds, warm white text and one amber colour for anything you can click. There is still a light theme behind the toggle in the top corner.
- The lenses now sit in a rail beside the 3D camera. Scroll over the rail to roll through them; the lens in the middle grows and lights up. Drag it onto the camera to fit it. On a phone the rail becomes a strip you swipe under the camera.
- Scrolling is smoother and faster.
- The site has a new logo: a camera lens seen from the front. It also shows in the browser tab and on a phone home screen.
- The camera model is more accurate. The Canon name on the front matches Canon's photo, the sockets behind the side covers are real, and the battery and SD card come all the way out.
- Search engines and AI search tools can now read what the site is about, and shared links show a proper preview card.
- People who want to buy a first camera and understand it first.
- People who own a camera but find its buttons and menus confusing.
- Teachers who want a free practice tool that students can open without signing up.
| Topic | Where to find it |
|---|---|
| How aperture, shutter speed and ISO work together | Simulator, Academy lessons 3 to 7 |
| What the Auto, P, Tv, Av and M modes do | Simulator mode dial, lesson 8 |
| Focus, depth of field and a blurred background | Simulator, lessons 4 and 10 |
| Why backlit faces go dark, and how to read a histogram | Lesson 9, mission Rescue the silhouette |
| White balance, picture styles, and RAW versus JPEG | Lessons 11 and 15 |
| Focal length, crop factor and which lens suits what | Lens rail, Lenses & Gear, lesson 12 |
| The name and job of every button, dial and port | 3D Camera |
| How the battery and card go in, and how a flash fits | 3D Camera |
- Turn the camera around and zoom in. Click any of its 57 parts to see Canon's name for it, what it does, what is printed on it, and the lesson that explains it. The guided tour visits each part in turn.
- Press the controls: the power switch, the mode dial, the flash, MENU and the arrow keys. The screen on the back runs a copy of the camera's menu, and whatever you change there also changes in the simulator.
- Pick a lens from the rail on the left and drag it onto the camera. The zoom ring turns, and the opening inside the lens gets bigger or smaller as you change the f-number. Press the lens release button to take it off.
- Open the side covers to see the USB-C, micro-HDMI, microphone and remote sockets, each made to its real size.
- Open the bottom door and take out the LP-E17 battery and the SD card. Arrows show which way round each one goes back in.
- Put a Speedlite EL-100 flash on top, tilt its head to bounce the light, and watch it fire when you press the shutter.
- Switch on X-ray or slide the exploded view to see the sensor, the shutter and other parts inside.
| Ports behind the covers | Battery and SD card out | Speedlite on the hot shoe |
|---|---|---|
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
- Eleven scenes, each set up to teach one thing: a spinning fan, a waterfall, a passing car, a candlelit table, a night street, and 3D scenes in a concert hall, on a Venice lagoon and at Potsdamer Platz.
- A viewfinder with live exposure numbers and a histogram. Click to choose where to focus, then half-press the shutter.
- All the settings a beginner needs, from aperture, shutter speed and ISO to white balance, focus mode, drive and flash.
- The photo behaves like a real one. A slow shutter blurs movement, a wide aperture blurs the background, a high ISO adds grain, and too much light washes out the bright parts. After each shot you get a short note on what worked and what to change.
- Meet your camera
- How a camera captures light
- The exposure triangle
- Aperture and depth of field
- Shutter speed and motion
- Long exposures and tripods
- ISO and noise
- Shooting modes: from Auto to Manual
- Metering and histograms
- Autofocus and manual focus
- White balance and colour
- Lenses and crop factor
- Composition basics
- Cheat sheet by subject
- RAW vs JPEG and basic editing
Each lesson has an interactive lab that changes one thing at a time, so you see cause and effect, plus a short quiz.
Freeze the fan · Creamy background · Silky waterfall · Pan with the car · Candlelight, no flash · Rescue the silhouette · Light trails · Sharp from front to back · Pan with the cyclist
Each mission drops you into a scene with a goal. Your photo is scored on blur, exposure, noise and focus for up to three stars, with hints if you get stuck.
This page covers the R100's specifications in plain words, what it is good and bad at, and ten lenses explained by what they are for:
| Lens | Role |
|---|---|
| RF-S 18-45mm F4.5-6.3 IS STM | the kit lens |
| RF 50mm F1.8 STM | the first upgrade |
| RF-S 55-210mm F5-7.1 IS STM | reach for sport and wildlife |
| RF-S 10-18mm F4.5-6.3 IS STM | ultra-wide |
| RF-S 18-150mm F3.5-6.3 IS STM | one lens for everything |
| RF 16mm F2.8 STM | small, bright, wide prime |
| RF 28mm F2.8 STM | pancake |
| RF 35mm F1.8 MACRO IS STM | bright normal lens with close focus |
| RF 85mm F2 MACRO IS STM | portraits |
| RF 100-400mm F5.6-8 IS USM | birds and distant action |
The glossary explains 40 photography words in plain language, and you can search it. The portfolio keeps your practice photos in your browser, with the settings you used and the feedback you got.
On a tablet, the part details and the camera screen move below the 3D view. On a phone, the lens rail turns into a strip you swipe, and a lighter 3D model loads so the page stays quick.
- 3D Camera: take the guided tour, so you know what each button is called and where it is.
- Academy lessons 1 to 3: learn the exposure triangle.
- Simulator in Av mode: shoot the Golden Hour Portrait at f/4.5 and then f/11, and compare the backgrounds.
- Simulator in Tv mode: shoot the Spinning Fan at 1/30 s and then 1/1000 s.
- Missions: try Freeze the fan, Creamy background and Candlelight, no flash. These are the situations that make people upgrade from a phone.
- Lens rail and Lenses & Gear: decide whether the kit lens is enough, or whether a 50 mm f/1.8 or a telephoto fits how you want to shoot.
- 3D Camera again: take the battery and card out, open the ports and add a flash, so nothing surprises you on day one.
FirstFrame is a static site: plain HTML, CSS and JavaScript with no build step. Serve the folder rather than opening index.html from disk, because the 3D model loads over HTTP.
git clone https://github.com/perumallavishnu/FirstFrame.gitcd FirstFramepython -m http.server 8765 --bind 127.0.0.1Then open http://localhost:8765 in a recent Chrome, Edge, Firefox or Safari. Any static server works, for example npx serve ..
Requirements:
- A browser with WebGL 2.
- An internet connection on first load. Three.js, the Draco decoder, GSAP and Lenis come from jsDelivr or cdnjs, and the fonts from Google Fonts.
To force a 3D model size, add ?lod=mobile or ?lod=desktop to the URL.
The live site is a static deploy on Vercel. .vercelignore keeps Canon's reference photos, the Blender source and the build tools off the public site.
npx vercel deploy --prodThese need Node.js 18 or newer, with no packages.
node --test tests/camera.test.jsnode scripts/validate-camera-profile.js- Tests (13): the exposure maths and the camera rules. They cover Av, Tv and M behaviour, exposure compensation, lens aperture limits and flash sync, and check that every control path changes the same camera state.
- Validator: checks that every registered part has its mesh and hotspot anchor in both 3D model files.
| Area | Files |
|---|---|
| App shell, routing, pages | index.html, js/app.js, js/pages.js, js/landing.js |
| Theme and motion | css/theme.css (palette, grain, scrollbars, reveals), js/smooth.js (GSAP clock + Lenis), DESIGN.md |
| Brand | assets/brand/lens-logo.svg, favicon.svg, icon-*.png, apple-touch-icon.png, site.webmanifest |
| Search and sharing | <head> of index.html (title, description, Open Graph, JSON-LD), the About section in index.html, robots.txt, sitemap.xml, llms.txt, favicon.ico, assets/brand/og-image.jpg |
| Camera state, exposure solver, autofocus | js/cam_core.js, js/physics.js, js/params.js |
| One action dispatcher for every control | js/cam_actions.js (docs) |
| Image renderer (WebGL2) and scenes | js/gl_*.js, js/render*.js, js/scenes3d.js |
| Simulator UI, viewfinder, rear-screen menu | js/sim_ui.js, js/sim_view.js, js/menu.js |
| 3D page, lens rail | js/explore.js, css/explore.css |
| 3D viewer and GLB adapter | js/cam3d.js, js/cam3d_glb.js, fallback js/cam3d_model.js |
| Lessons, labs, missions, glossary | js/lessons*.js, js/labs.js, js/missions.js, js/analyze.js |
| Camera profile: 57 parts with Canon's names and sources | js/camera/eos_r100_profile.js |
| 3D models (Draco GLB) | assets/models/canon-eos-r100/Canon_EOS_R100.glb, ..._mobile.glb |
| Blender source and build pipeline | blender/eos-r100/ |
Tech:
- Vanilla JavaScript with no framework.
- Three.js r160 as ES modules, plus WebGL2.
- GSAP and Lenis for motion and scrolling.
- Blender 5.2 for the model.
- Browser storage only: no server, database or tracking.
The camera isn't modelled by eye.
- Shell: a visual hull of six Canon product photos (front, back, top, bottom and both sides), each scaled to Canon's published size of 116.3 × 85.5 × 68.8 mm.
- Controls, seams and printing: measured from the photos and placed on the real surface.
| Check | Result |
|---|---|
| Outline vs Canon's photos | 93 to 97% match in every view |
| Lens lengths (photo profiles) | within 1 mm of Canon's specs |
| USB-C / micro-HDMI openings | 8.34 × 2.56 mm / 6.4 × 2.8 mm |
| LP-E17 battery / SD card | 33.0 × 14.0 × 49.4 mm / 24 × 32 × 2.1 mm |
| Front wordmark | 22.2 × 4.5 mm, measured from Canon's front photo |
The full write-up is in docs/R100_MODEL_REPORT.md: method, accuracy tables, known approximations and how to rebuild.
Rebuilding needs Blender 5.2, plus Python 3 with numpy, scipy and Pillow. Start by fetching Canon's reference photos, which aren't in this repo because they're Canon's copyright:
python -I blender/eos-r100/tools/fetch_refs.pyThen run masks.py → hull.py → sdf_to_mesh.py → build_r100.py → export_glb.py, as described in the report.
Two pieces make every new camera as accurate as the R100:
-
docs/NEW_CAMERA_INTAKE.md: fill-in-the-name research prompts. Each answer must carry a source link, and they cover:
- the specs;
- every part on the maker's diagrams;
- the complete menu;
- how the controls behave;
- battery, card and ports;
- lenses.
The guide also lists the official photos to download and the folder to put everything in.
-
The camera-model-builder skill: the step-by-step method:
- sourcing;
- calibration;
- visual hull;
- parts and markings;
- lenses and connectors;
- validation;
- export and app integration.
Every camera must pass its accuracy gates: size within 1 mm, and an outline match of at least 92% in every view.
In a Claude Code session in this repo, say "Build the Nikon Z50 II from intake/nikon-z50-ii", or just "add the Sony a6400", and the skill takes it from there.
- This is a learning simulator, not the real camera. Exposure, depth of field, motion blur, noise and autofocus follow real optics closely enough to learn from. Image quality, autofocus speed and menu depth are simplified.
- Only some modes are simulated. P, Tv, Av, M, A+ and three scene modes work. Hybrid Auto, creative filters and movie mode are explained rather than simulated.
- Approximate parts are marked as approximate:
- The access lamp, the DC cord hole, and which holes are the microphone and which the speaker are placed from Canon's diagrams.
- The RF 85 mm and RF 100-400 mm lenses are built from published sizes, because Canon has no product photos of them.
- The inside of the camera is an illustration.
- Sources: every specification and part name links to Canon's manual or specification pages.
There's no account, sign-up, analytics or tracking. Lesson progress, mission stars and your photos are saved only in your browser's local storage, and clearing your browser data removes them.
- Not made by or affiliated with Canon Inc. Canon, EOS, Speedlite and RF are trademarks of Canon Inc., used here only to describe real equipment. The wordmark on the model is set in a similar typeface; it isn't Canon's logo artwork.
- Reference material: Canon's EOS R100 Advanced User Guide and Canon product pages. These were used to build the model and are not redistributed here.
- Logo: the FirstFrame lens mark was drawn for this project as an SVG.
- Libraries:
- Blender skill pack: arjun988/blender-skills (MIT), in
.claude/skills/.
No licence has been chosen yet, so all rights are reserved by the author for now. Open an issue if you'd like to use or contribute to the project.














