createFramebuffer()

Creates a new p5.Framebuffer object with the same WebGL context as the graphics buffer.

p5.Framebuffer objects are separate drawing surfaces that can be used as textures in WebGL mode. They're similar to p5.Graphics objects and generally run much faster when used as textures. Creating a p5.Framebuffer object in the same context as the graphics buffer makes this speedup possible.

The parameter, options, is optional. An object can be passed to configure the p5.Framebuffer object. The available properties are:

• format: data format of the texture, either UNSIGNED_BYTE, FLOAT, or HALF_FLOAT. Default is UNSIGNED_BYTE.
• channels: whether to store RGB or RGBA color channels. Default is to match the graphics buffer which is RGBA.
• depth: whether to include a depth buffer. Default is true.
• depthFormat: data format of depth information, either UNSIGNED_INT or FLOAT. Default is FLOAT.
• stencil: whether to include a stencil buffer for masking. depth must be true for this feature to work. Defaults to the value of depth which is true.
• antialias: whether to perform anti-aliasing. If set to true, as in { antialias: true }, 2 samples will be used by default. The number of samples can also be set, as in { antialias: 4 }. Default is to match setAttributes() which is false (true in Safari).
• width: width of the p5.Framebuffer object. Default is to always match the graphics buffer width.
• height: height of the p5.Framebuffer object. Default is to always match the graphics buffer height.
• density: pixel density of the p5.Framebuffer object. Default is to always match the graphics buffer pixel density.
• textureFiltering: how to read values from the p5.Framebuffer object. Either LINEAR (nearby pixels will be interpolated) or NEAREST (no interpolation). Generally, use LINEAR when using the texture as an image and NEAREST if reading the texture as data. Default is LINEAR.

If the width, height, or density attributes are set, they won't automatically match the graphics buffer and must be changed manually.