40:null 41:["$","title",null,{"children":"Instanced WebGL Circles | Daniel | Observable"}] 47:T885,draw = regl({ vert: ` precision highp float; attribute float theta; attribute vec2 circlePoint; varying vec3 vColor; uniform vec2 aspectRatio; uniform float time; const float PI = 3.1415926535; void main () { // Use lots of sines and cosines to place the circles vec2 circleCenter = vec2(cos(theta), sin(theta)) * (0.6 + 0.2 * cos(theta * 6.0 + cos(theta * 8.0 + time))); // Modulate the circle sizes around the circle and in time float circleSize = 0.2 + 0.12 * cos(theta * 9.0 - time * 2.0); vec2 xy = circleCenter + circlePoint * circleSize; // Define some pretty colors float th = 8.0 * theta + time * 2.0; vColor = 0.6 + 0.4 * vec3( cos(th), cos(th - PI / 3.0), cos(th - PI * 2.0 / 3.0) ); gl_Position = vec4(xy / aspectRatio, 0, 1); }`, frag: ` precision highp float; varying vec3 vColor; uniform float alpha; void main () { gl_FragColor = vec4(vColor, alpha); }`, attributes: { // This attribute defines what we draw; we fundamentally draw circle vertices circlePoint: circleInstanceGeometry, // This attribute allows us to compute where we draw each circle. the divisor // means we step through one value *per circle*. theta: {buffer: instanceTheta, divisor: 1}, }, uniforms: { // Scale so that it fits in the view whether it's portrait or landscape: aspectRatio: ctx => ctx.framebufferWidth > ctx.framebufferHeight ? [ctx.framebufferWidth / ctx.framebufferHeight, 1] : [1, ctx.framebufferHeight / ctx.framebufferWidth], time: regl.context('time'), // Decrease opacity when there are more circles alpha: Math.max(0, Math.min(1, 0.15 * 2000 / numCircleInstances)), }, blend: { // Additive blending enable: true, func: {srcRGB: 'src alpha', srcAlpha: 1, dstRGB: 1, dstAlpha: 1}, equation: {rgb: 'add', alpha: 'add'} }, // GL_LINES are in general *pretty bad*, but they're good for some things primitive: 'line strip', depth: {enable: false}, count: numCircleDivisions + 1, instances: numCircleInstances, })48:[] 45:{"id":"c42d6042975733e3","slug":null,"title":"Instanced WebGL Circles","thumbnail":"fc34f6d97cdd63522b2a77bde94051e0f8ff7dbefa383d9e5865e03ab008a4a2","access_level":"public","create_time":"$D2023-07-07T14:08:47.303Z","update_time":"$D2023-07-07T14:08:47.303Z","view_time":null,"first_public_time":"$D2023-07-07T14:08:47.303Z","has_unpublished_edits":null,"fork":{"id":"5f7ba4d775a49df0","slug":"instanced-webgl-circles","title":"Instanced WebGL Circles","owner":{"id":"f1b8352b963a77b4","login":"rreusser","name":"Ricky Reusser"}},"stars":0,"starred":false,"owner":{"type":"team","id":"4d6171341eb7bd46","login":"danielbreton29","name":"Daniel ","avatar_url":null,"tier":"starter_2024","bio":"","following":false},"version":219,"publish_version":null,"role":null,"authored":false,"authors":[{"type":"individual","id":"8ef55a43453835e5","login":"danielbreton29","name":"Daniel ","avatar_url":null,"tier":null,"bio":"","following":false}],"members":[{"type":"individual","id":"8ef55a43453835e5","login":"danielbreton29","name":"Daniel ","avatar_url":null,"tier":null,"role":"editor"}],"comments":[],"custom_thumbnail":false,"trashed":false,"lapsed":null,"subscribed":null,"forks":0,"collection":null,"type":"notebook","body":{"titling":"auto","title":"Instanced WebGL Circles","cells":[{"id":0,"value":"md`# Instanced WebGL Circles\n\nA question came up of how to draw lots of circles efficiently. The most efficient method I know of uses WebGL with the [\\`ANGLE_instanced_arrays\\`](https://developer.mozilla.org/en-US/docs/Web/API/ANGLE_instanced_arrays) extension to place and scale many identical circle instances.\n\nIt seemed like a fun exercise and a good way to incrementally iterate on my Observable skills, so here we are. I'm going to use the [regl](https://github.com/regl-project/regl) WebGL wrapper because it adds tons of convenience with very few of its own abstractions. Still, this method should generalize to WebGL and most other WebGL libraries without too much translation.`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":96,"value":"md`First, we create and view a regl context. We configure a couple options while setting it up:\n\n- Disable antialiasing. Very expensive; not that helpful here.\n- Limit the pixel ratio to 1.5. More pixels make for a lot more fragments but doesn't actually look that much better.\n- Use the [\\`ANGLE_instanced_arrays\\`](https://developer.mozilla.org/en-US/docs/Web/API/ANGLE_instanced_arrays) extension to draw lots of circles with a single WebGL draw call.`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":4,"value":"viewof regl = reglCanvas(\n width,\n Math.max(400, width * 0.6), // height\n Math.min(devicePixelRatio, 1.5), // pixel ratio\n {\n extensions: ['ANGLE_instanced_arrays'],\n attributes: { antialias: false, depth: false}\n }\n)","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":34,"value":"viewof numCircleInstances = {\n const form = html``;\n form.i.oninput = () => form.o.value = `circle instance count = ${(form.value = form.i.valueAsNumber).toFixed(0)}`;\n form.i.oninput();\n return form;\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":38,"value":"viewof numCircleDivisions = {\n const form = html``;\n form.i.oninput = () => form.o.value = `circle divisions = ${(form.value = form.i.valueAsNumber).toFixed(0)}`;\n form.i.oninput();\n return form;\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":107,"value":"md`Below is our main iteration loop. We simply clear the screen and execute a single draw command to draw ${numCircleInstances} circles each with ${numCircleDivisions} divisions, totaling ${numCircleInstances * (numCircleDivisions + 1)} vertices.`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":21,"value":"loop = {\n while (true) {\n regl.poll();\n regl.clear({ color: [0.05, 0.05, 0.05, 1] });\n draw();\n yield;\n }\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":113,"value":"md`We now define what a single circle looks like. We can get away with a regular JavaScript \\`Array\\` of ${tex`(x, y)`} pairs. [\\`regl\\` is smart enough](https://github.com/regl-project/regl/blob/master/API.md#buffers) to do some basic flattening into a typed array so that we don't have to.`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":42,"value":"circleInstanceGeometry = Array.from(Array(numCircleDivisions + 1).keys()).map(i => {\n var theta = Math.PI * 2 * i / numCircleDivisions;\n return [Math.cos(theta), Math.sin(theta)];\n});","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":117,"value":"md`Next, we define a list of ${tex`\\theta`} values we'll use in the vertex shader to place each instance.`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":45,"value":"instanceTheta = Array.from(Array(numCircleInstances).keys()).map(i => \n i / numCircleInstances * 2 * Math.PI\n);","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":123,"value":"md`Finally we define the actual draw command. One subtle thing to note here is that due to Observable data flow, this command is recreated each time the parameters above are changed. The proper way to avoid this would be to create buffers (\\`circleInstanceGeometryBuffer = regl.buffer(circleInstanceGeometry)\\` and the same for \\`instanceTheta\\`), then pass the buffers as a regl property to the draw command *when the command is invoked*.\n\nThis small change would decouple the command definition from the variables above so that Observable would not recreate the command. That said, I've not done this here for two reasons. The addition adds some complexity to the code, and recreating commands many times doesn't seem to cause problems—though I suspect there probably is an upper limit to how many commands you can allocate before things just stop working.`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":47,"value":"$47","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":210,"value":"createREGL = require('regl')","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":209,"value":"function reglCanvas (width, height, dpi, reglOptions) {\n dpi = dpi === undefined ? devicePixelRatio : dpi;\n reglOptions = reglOptions || {}\n var canvas = document.createElement(\"canvas\");\n canvas.width = dpi * width;\n canvas.height = dpi * height;\n canvas.style.width = width + \"px\";\n const regl = createREGL(Object.assign({}, reglOptions, {pixelRatio: dpi, canvas}));\n canvas.value = regl;\n canvas.__reglConfig = {dpi, reglOptions}\n return canvas;\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"}],"files":"$W48","stdlib":"1"}} 46:"$45:body"