Skip to content

About

Learn photography before you buy a camera. A free, in-browser 3D Canon EOS R100 with a camera simulator, 15 lessons and 9 photo missions.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

FirstFrame: learn photography on a real camera, in your browser, before you buy one

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.

FirstFrame home page

What's new

  • 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.

Who it is for

  • 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.

What you'll understand before you buy

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

A tour of the app

3D Camera: hold the EOS R100

The 3D camera explorer with the lens rail

  • 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
USB-C and HDMI sockets LP-E17 battery and SD card Speedlite EL-100
MIC and remote jacks Battery contacts Top controls

Simulator: take pictures and see why they look that way

The camera simulator

  • 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.

Academy: 15 short lessons

Academy lessons

  1. Meet your camera
  2. How a camera captures light
  3. The exposure triangle
  4. Aperture and depth of field
  5. Shutter speed and motion
  6. Long exposures and tripods
  7. ISO and noise
  8. Shooting modes: from Auto to Manual
  9. Metering and histograms
  10. Autofocus and manual focus
  11. White balance and colour
  12. Lenses and crop factor
  13. Composition basics
  14. Cheat sheet by subject
  15. 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.

Missions: 9 photo challenges

Missions

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.

Lenses & Gear: what the camera can and can't do

Camera specifications

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

Glossary and Portfolio

Glossary

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 tablets and phones

FirstFrame on a tablet

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.

A path if you're thinking of buying a camera

  1. 3D Camera: take the guided tour, so you know what each button is called and where it is.
  2. Academy lessons 1 to 3: learn the exposure triangle.
  3. Simulator in Av mode: shoot the Golden Hour Portrait at f/4.5 and then f/11, and compare the backgrounds.
  4. Simulator in Tv mode: shoot the Spinning Fan at 1/30 s and then 1/1000 s.
  5. Missions: try Freeze the fan, Creamy background and Candlelight, no flash. These are the situations that make people upgrade from a phone.
  6. 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.
  7. 3D Camera again: take the battery and card out, open the ports and add a flash, so nothing surprises you on day one.

Run it yourself

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.git
cd FirstFrame
python -m http.server 8765 --bind 127.0.0.1

Then 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.

Deploy

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 --prod

Tests and checks

These need Node.js 18 or newer, with no packages.

node --test tests/camera.test.js
node 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.

How it is built

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 3D model

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.py

Then run masks.py → hull.py → sdf_to_mesh.py → build_r100.py → export_glb.py, as described in the report.

Adding more cameras

Two pieces make every new camera as accurate as the R100:

  1. 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.

  2. 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.

Accuracy and honesty

  • 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.

Privacy

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.

Credits

  • 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/.

Licence

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.

About

Learn photography before you buy a camera. A free, in-browser 3D Canon EOS R100 with a camera simulator, 15 lessons and 9 photo missions.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages