Creates and returns a new
def setup(): global pg py5.size(200, 200) pg = py5.create_graphics(100, 100) def draw(): pg.begin_draw() pg.background(102) pg.stroke(255) pg.line(pg.width*0.5, pg.height*0.5, py5.mouse_x, py5.mouse_y) pg.end_draw() py5.image(pg, 50, 50)
Creates and returns a new
Py5Graphics object. Use this class if you need to draw into an off-screen graphics buffer. The first two parameters define the width and height in pixels. The third, optional parameter specifies the renderer. It can be defined as
SVG. If the third parameter isn’t used, the default renderer is set. The
SVG renderers require the filename parameter.
It’s important to consider the renderer used with
create_graphics() in relation to the main renderer specified in size(). For example, it’s only possible to use
create_graphics() when one of them is defined in size().
P3D use OpenGL for drawing, and when using an OpenGL renderer it’s necessary for the main drawing surface to be OpenGL-based. If
P3D are used as the renderer in size(), then any of the options can be used with
create_graphics(). If the default renderer is used in size(), then only the default,
SVG can be used with
It’s important to run all drawing functions between the Py5Graphics.begin_draw() and Py5Graphics.end_draw(). As the exception to this rule, smooth() should be run on the Py5Graphics object before Py5Graphics.begin_draw(). See the reference for smooth() for more detail.
create_graphics() function should almost never be used inside
draw() because of the memory and time needed to set up the graphics. One-time or occasional use during
draw() might be acceptable, but code that calls
create_graphics() at 60 frames per second might run out of memory or freeze your Sketch.
Unlike the main drawing surface which is completely opaque, surfaces created with
create_graphics() can have transparency. This makes it possible to draw into a graphics and maintain the alpha channel. By using save() to write a
TGA file, the transparency of the graphics object will be honored.
Underlying Processing method: createGraphics
create_graphics( w: int, # width in pixels h: int, # height in pixels /, ) -> Py5Graphics create_graphics( w: int, # width in pixels h: int, # height in pixels renderer: str, # Either P2D, P3D, or PDF /, ) -> Py5Graphics create_graphics( w: int, # width in pixels h: int, # height in pixels renderer: str, # Either P2D, P3D, or PDF path: str, # the name of the file (can be an absolute or relative path) /, ) -> Py5Graphics
Updated on March 06, 2023 02:49:26am UTC