{"id":"astrolabe-align","version":"1.0.0","title":"Astrolabe","summary":"A polished brass astrolabe: the open-work rete turning over its engraved plate while the sighting rule sweeps from star to star. Loops perfectly.","kind":"object","target":"three","collections":["chrome-glass","hypnotic-loops","product-reveals"],"tags":["astrolabe","astronomy","brass","medieval","navigation","stars","engraved","instrument","loop","3d"],"loopable":true,"motion":"procedural","durationSeconds":16,"status":"published","media":{"poster":"https://aipixelwizard.com/media/astrolabe-align/1.0.0/poster.webp","preview":"https://aipixelwizard.com/media/astrolabe-align/1.0.0/preview.mp4","sample":"https://aipixelwizard.com/media/astrolabe-align/1.0.0/sample.mp4","sampleBytes":2860126,"sampleNote":"Pre-rendered with the default settings. Customised settings must be exported locally (npm run render)."},"urls":{"page":"https://aipixelwizard.com/visuals/astrolabe-align","manifest":"https://aipixelwizard.com/api/v1/visuals/astrolabe-align/versions/1.0.0","agentMd":"https://aipixelwizard.com/registry/astrolabe-align/1.0.0/agent.md","files":"https://aipixelwizard.com/registry/astrolabe-align/1.0.0/","demo":"https://aipixelwizard.com/registry/astrolabe-align/1.0.0/index.html"},"description":"An astrolabe, the medieval computer of the heavens, seen face-on: the mater engraved with its degree scale and the hours in Roman numerals, the plate with its circles of altitude, the open-work rete turning over it with its ring of the zodiac and pointers to the stars, and the alidade, the sighting rule, sweeping across as if lining up each star in turn. Choose the metal, how many stars the rete points to, the turns per loop, the seed, the backdrop and whether the camera sways.","role":"Object (3D, three.js): a scholarly hero object for astronomy, navigation, history and time content.","useCases":["An astronomy or history-of-science title scene","A navigation, exploration or time-keeping story","A brand story about craft and precision"],"synonyms":["medieval astrolabe","astronomical instrument","star finder","brass instrument","navigation instrument"],"digest":"798685405c505af7d7f01c860e58faa37e3d7d54bef840361ab4a9ae08422864","implementation":{"target":"three","runtime":"browser","language":"javascript","module":"esm","entry":"src/astrolabe-align.js","exports":[{"name":"createAstrolabe","signature":"createAstrolabe({ metal?, stars?, turns?, seed? }) => { group, setProgress(progress), dispose() }","description":"The instrument as a group of meshes (radius 3, face towards +z); add it with an environment map and a light."},{"name":"METALS","signature":"METALS: { brass, gold, silver, bronze }","description":"Metal finishes: colour (sRGB) and roughness."}],"reusable":["src/astrolabe-align.js"],"demo":"demo.js","harness":"index.html"},"dependencies":[{"id":"three","version":"0.185.1","scope":"source","reason":"Renderer, geometry and physical materials."},{"id":"chrome-material","version":"1.1.0","scope":"demo","reason":"Studio environment light and backdrop."},{"id":"apw-runtime","version":"1.0.0","scope":"demo","reason":"Demo harness."}],"uses":[],"usedBy":[],"params":[{"key":"metal","label":"Metal","type":"select","default":"brass","options":[{"value":"brass","label":"Brass"},{"value":"gold","label":"Gold"},{"value":"silver","label":"Silver"},{"value":"bronze","label":"Antique bronze"}]},{"key":"stars","label":"Stars","help":"Pointers on the rete.","type":"integer","min":4,"max":20,"step":1,"default":12},{"key":"turns","label":"Turns per loop","type":"integer","min":1,"max":3,"step":1,"default":1},{"key":"seed","label":"Seed","type":"integer","min":1,"max":999,"step":1,"default":3},{"key":"background","label":"Backdrop","type":"color","default":"#13233a"},{"key":"orbit","label":"Camera sway","type":"boolean","default":true}],"presets":[{"id":"default","label":"Brass, twelve stars","params":{}},{"id":"silver","label":"Silver, night blue","params":{"metal":"silver","background":"#0c1830","seed":8}},{"id":"gold","label":"Gold, many stars","params":{"metal":"gold","stars":18,"background":"#1c1424"}},{"id":"fast","label":"Fast rete","params":{"turns":3,"stars":8}}],"output":{"width":1080,"height":1080,"fps":30,"durationSeconds":16,"posterSeconds":3,"alpha":false,"motion":"procedural","loop":{"seamless":true,"cycleSeconds":16,"method":"The rete turns a whole number of times per loop, the alidade swings in sines of whole cycles and the camera sway is a sine of the loop, so the last frame meets the first."},"seed":{"param":"seed","behavior":"Seed places the star pointers on the rete: same seed, same star map."}},"composition":{"inputs":"Time within the loop; the metal, stars, turns, seed, backdrop and camera sway.","outputs":"A full frame rendered in 3D with a studio environment.","coordinates":"The astrolabe is centred on the origin in the xy plane with radius 3, face towards +z; its throne rises to y ≈ 3.9.","lighting":"A warm key light with a shadow map and the studio environment.","timing":"setProgress(progress) sets the rete and alidade angles; frames render in any order.","compatibleWith":["chrome-material","orbit-camera","kinetic-title","number-reveal"],"notes":["The degree scale, hour numerals and altitude circles are engraved once on a canvas texture; the rete is extruded 2D shapes (ring, cross-piece, leaf pointers and star discs)."]},"reuse":["Astronomy title: Brass, twelve stars.","Night-sky scene: Silver, night blue.","Luxury craft loop: Gold, many stars."],"integration":{"newProject":"Create a WebGLRenderer with a studio environment (see chrome-material), add createAstrolabe().group and call astrolabe.setProgress(progress) each frame.","existingProject":"Copy src/astrolabe-align.js; add astrolabe.group to your scene with an environment map."},"performance":{"notes":"About 60 meshes and one shadow map with anti-aliasing. A few milliseconds a frame on an integrated Intel GPU.","limits":"Software WebGL renders in about a second a frame."},"limitations":["The plate's circles are a stylised projection, not an exact stereographic chart for a latitude.","The rete's pointers do not point at real stars."],"license":{"spdx":"MIT","notice":"Copyright (c) 2026 AI Pixel Wizard. Released under the MIT License. See LICENSE in this folder.","thirdParty":[]},"rights":{"approvedForPublicRelease":true},"provenance":"Adapted from the owner's threejs-sketches/objects-scenes/astrolabe-align (MIT) and rebuilt for AI Pixel Wizard in October 2026 as an original object: an engraved mater and plate, an extruded open-work rete with seeded star pointers, a sweeping alidade and whole-turn motion for an exact loop.","changelog":[{"version":"1.0.0","date":"2026-10-05","notes":"Initial release."}],"verification":{"testedOn":"2026-10-06","inputs":{"astrolabe-align@1.0.0":"798685405c505af7d7f01c860e58faa37e3d7d54bef840361ab4a9ae08422864","three@0.185.1":"664ca387e5fab46ff2daaa6895e1d015426850891af5ea5082cbbcc3985b068c","chrome-material@1.1.0":"ecb41776bfc1ee88997604f916a5ffe833f971d7edcc97c855697a5792d6f1dd","apw-runtime@1.0.0":"5be859cdac74823ba0bcc32c6daf06688a871104d24db5d4ceaffffd84d7c40d"},"environment":"Chrome 154.0.8037.97 headless on Linux 7.0.0-38-generic (x64), Node 22.14.0","renderer":"WebGL 2 via SwiftShader (software)","width":1080,"height":1080,"fps":30,"frames":480,"renderSeconds":1104.3,"loopCheck":{"checked":true,"seamless":true,"maxDifference":0,"note":"Frame 0 vs end state (progress 1): mean |Δ| 0.0000, max |Δ| 0 of 255."},"determinism":{"checked":true,"identical":true},"errors":[],"media":{"poster":"/media/astrolabe-align/1.0.0/poster.webp","preview":"/media/astrolabe-align/1.0.0/preview.mp4","sample":"/media/astrolabe-align/1.0.0/sample.mp4","sampleBytes":2860126}},"files":[{"path":"LICENSE","size":1072,"sha256":"8a5f3a96f07e11522ec4bdd0a583356f99bad1245920f9709cee09b995a45153","contentType":"text/plain; charset=utf-8","url":"https://aipixelwizard.com/registry/astrolabe-align/1.0.0/LICENSE"},{"path":"asset.json","size":7409,"sha256":"b5553234293e4cdce2c3074365279e208efc0780db05e5b8798ff5e5d131f1a0","contentType":"application/json; charset=utf-8","url":"https://aipixelwizard.com/registry/astrolabe-align/1.0.0/asset.json"},{"path":"demo.js","size":2233,"sha256":"8a920f4181c950f089aba7bf3bf76dc817053bf462f1e201d1dcbdd8fa6d9839","contentType":"text/javascript; charset=utf-8","url":"https://aipixelwizard.com/registry/astrolabe-align/1.0.0/demo.js"},{"path":"index.html","size":529,"sha256":"919327d8f95248b1f04901247b439ec7a54a87d79e43e7232aba58de0b94a099","contentType":"text/html; charset=utf-8","url":"https://aipixelwizard.com/registry/astrolabe-align/1.0.0/index.html"},{"path":"src/astrolabe-align.js","size":9523,"sha256":"9a7ebe0c279b114fe09e655d6f116be8a44ce6f0359a834b312266853dd02eb6","contentType":"text/javascript; charset=utf-8","url":"https://aipixelwizard.com/registry/astrolabe-align/1.0.0/src/astrolabe-align.js"}],"warnings":[]}