{"record":{"id":"dc3518529c79683d","repo":"remotion-dev/remotion","slug":"vignette-program-link-failed-log-no-log","errorCode":null,"errorMessage":"Vignette program link failed: ${log ?? '(no log)'}","messagePattern":"Vignette program link failed: (.+?)","errorType":"exception","errorClass":"Error","httpStatus":null,"severity":"error","filePath":"packages/effects/src/vignette.ts","lineNumber":299,"sourceCode":"};\n\nconst linkProgram = (\n\tgl: WebGL2RenderingContext,\n\tvs: WebGLShader,\n\tfs: WebGLShader,\n): WebGLProgram => {\n\tconst program = gl.createProgram();\n\tif (!program) {\n\t\tthrow new Error('Failed to create WebGL program');\n\t}\n\n\tgl.attachShader(program, vs);\n\tgl.attachShader(program, fs);\n\tgl.linkProgram(program);\n\tif (!gl.getProgramParameter(program, gl.LINK_STATUS)) {\n\t\tconst log = gl.getProgramInfoLog(program);\n\t\tgl.deleteProgram(program);\n\t\tthrow new Error(`Vignette program link failed: ${log ?? '(no log)'}`);\n\t}\n\n\treturn program;\n};\n\nconst createProgram = (\n\tgl: WebGL2RenderingContext,\n\tvertexSource: string,\n\tfragmentSource: string,\n): WebGLProgram => {\n\tconst vs = compileShader(gl, gl.VERTEX_SHADER, vertexSource);\n\tconst fs = compileShader(gl, gl.FRAGMENT_SHADER, fragmentSource);\n\tconst program = linkProgram(gl, vs, fs);\n\tgl.deleteShader(vs);\n\tgl.deleteShader(fs);\n\treturn program;\n};\n","sourceCodeStart":281,"sourceCodeEnd":317,"githubUrl":"https://github.com/remotion-dev/remotion/blob/78fe4bb3fdb5a2cd68724393d63cb223db333fa7/packages/effects/src/vignette.ts#L281-L317","documentation":"Thrown by vignette's linkProgram when gl.linkProgram reports LINK_STATUS === false. The program info log is appended (or '(no log)'). Vignette's shaders are hardcoded library GLSL, so a link failure implies a driver/GPU issue (e.g. conflicting shader stage features, context loss, or a driver bug) rather than user input.","triggerScenarios":"linkProgram attaches the compiled VIGNETTE_VS/VIGNETTE_FS and calls gl.linkProgram; the driver returns LINK_STATUS false. Occurs on context loss, driver bugs, or GLSL feature mismatches between stages on a given GPU.","commonSituations":"Context loss mid-setup; buggy/outdated drivers; software rendering rejecting the linked program; Studio with many effects stressing the driver.","solutions":["Reload the page/Studio to reset the context and retry linking.","Update GPU drivers / enable hardware WebGL2.","Reduce concurrent WebGL effects.","Capture the info log and report to @remotion/effects if it reproduces on supported hardware."],"exampleFix":"// before\nconst effect = vignette({amount: 0.6});\n\n// after\nconst effect = (() => {\n  try { return vignette({amount: 0.6}); } catch (err) { console.warn(err); return null; }\n})();","handlingStrategy":"try-catch","validationCode":null,"typeGuard":null,"tryCatchPattern":"let effect = null;\ntry {\n  effect = vignette({amount: 0.6});\n} catch (err) {\n  console.warn('vignette program link failed (driver/GPU issue), skipping', err);\n}","preventionTips":["Keep GPU drivers current so the hardcoded GLSL links cleanly.","Use hardware-accelerated WebGL2.","Handle context loss/restore events and rebuild effects.","Reduce concurrent shader-heavy effects to avoid link-time context loss."],"tags":["webgl2","shader","gpu","context-loss","vignette"],"backgroundTag":null,"analyzedSha":"78fe4bb3fdb5a2cd68724393d63cb223db333fa7","analyzedAt":"2026-08-12T17:18:50.444Z","schemaVersion":2},"datasetVersion":"2026-08-12T18:17:37.767Z"}