ODDSPRIG EYE STUDIO -- HUMAN AND AI MANUAL Generator 0.2.0. Authoring and exports run locally in your browser. HUMAN WORKFLOW 1. Choose a named look, enter a description, or edit the existing controls. 2. Drag to orbit; scroll to zoom. Front, Iris, Side and Light II aid inspection. 3. Keep current anatomy locks form during Generate variation. That button chooses a new seed; save the recipe to reproduce the result. 4. Choose 720, 1080, game (2048), close (4096), or master (8192) export detail. 5. Export 3D asset saves GLB. Export asset + texture maps saves a ZIP. Export iris PNG saves a color texture. Save/load recipe preserves parameters. TEXTURE SIZES AND SCALE 720 and 1080 mean exact 720 x 720 and 1080 x 1080 iris color textures, not 16:9 frames. Normal and roughness maps also use those square sizes. Sclera maps use a 2:1 unwrap: 720 x 360 or 1080 x 540 at these tiers. At larger tiers, normal maps cap at 4096, roughness at 2048, sclera width at 4096. PNG is a surface texture; the pupil aperture is geometry in the GLB. GLB uses metres, +Y up, +Z forward, globe-centre pivot; diameter controls scale. Compound eyes export geometry/materials and have no iris PNG maps. LOOKS AND RESEARCH Sixteen named looks vary existing anatomy, pigment, warmth, fibers and ring. Ceratosaurus presets are artistic assets, with no authentic color/genotype claim. Human research examples retain their study records and illustrative limitations. Palette and pigment overrides are recorded; prompt provenance retains edit flags. Old 0.1.0 recipes load with the original natural palette; new records use 0.2.0. BROWSER CONTROLS (window.EyeStudio) Setters update the editor. Export methods return data without forcing downloads. await EyeStudio.ready(30000); EyeStudio.setPreset('ceratosaurus-amber'); EyeStudio.setExportTier('720'); EyeStudio.setConfig({seed:6501,pupil:0.28}); await EyeStudio.ready(); const state = EyeStudio.getState(); const record = EyeStudio.exportRecipe(); const colorPNG = await EyeStudio.exportPNG('irisColor','720'); // Blob const glb = await EyeStudio.exportGLB('720'); // Uint8Array listPresets() returns copies; reset() restores defaults/close; getInstructions() returns this TXT URL. exportPNG map names: irisColor, irisNormal, irisRoughness, scleraColor. ready(timeoutMs) waits for the latest preview, accepts 1..30000 ms, and rejects on failure. getState() reports config, tier, revisions, readiness, working/exporting and errors. ready() does not wait for research loading; inspect researchReady before using prompts. New configurations reject unknown keys, invalid types, nonfinite values and invalid ranges. Aspect selects pupil geometry; shape alone supplies an aspect; both must agree. Programmatic exports reject while preview/export work is busy; wait for ready(). HTTP API -- /api/game-assets/eye/ GET schema; GET presets; POST validate; POST recipe. POST requires application/json; limit 32768 UTF-8 bytes and 5 seconds to read the body. Body is a partial configuration or {"config":{...},"tier":"720"}. Example: {"config":{"seed":6501,"palette":"amber","diameter":48},"tier":"720"} An exact named look uses config returned by GET presets. Validate returns valid/config/tier. Recipe returns loadable oddsprig.eye JSON; HTTP does not render PNG or GLB. Errors use {error:{code,message}}: invalid configuration 400, timeout 408, oversized 413, wrong content type 415, wrong method 405 with Allow. Browser exports return actual assets. DETERMINISM Normalized HTTP recipes have no timestamps or random draws. Reuse the full configuration and generator version. The saved seed drives procedural variation; Canvas rasterization and PNG encoding can differ across browser implementations.