Creates a canvas element on the web page.
createCanvas()
creates the main drawing canvas for a sketch. It should only be called once at the beginning of setup(). Calling createCanvas()
more than once causes unpredictable behavior.
The first two parameters, width
and height
, are optional. They set the dimensions of the canvas and the values of the width and height system variables. For example, calling createCanvas(900, 500)
creates a canvas that's 900×500 pixels. By default, width
and height
are both 100.
The third parameter is also optional. If either of the constants P2D
or WEBGL
is passed, as in createCanvas(900, 500, WEBGL)
, then it will set the sketch's rendering mode. If an existing HTMLCanvasElement is passed, as in createCanvas(900, 500, myCanvas)
, then it will be used by the sketch.
The fourth parameter is also optional. If an existing HTMLCanvasElement is passed, as in createCanvas(900, 500, WEBGL, myCanvas)
, then it will be used by the sketch.
Note: In WebGL mode, the canvas will use a WebGL2 context if it's supported by the browser. Check the webglVersion system variable to check what version is being used, or call setAttributes({ version: 1 })
to create a WebGL1 context.
示例
语法
createCanvas([width], [height], [renderer], [canvas])
createCanvas([width], [height], [canvas])
参数
width of the canvas. Defaults to 100.
height of the canvas. Defaults to 100.
either P2D or WEBGL. Defaults to P2D
.
existing canvas element that should be used for the sketch.