Save an image, text, json, csv, wav, or html. Prompts download to the client's computer. Note that it is not recommended to call save() within draw if it's looping, as the save() function will open a new save dialog every frame.

The default behavior is to save the canvas as an image. You can optionally specify a filename. For example:


 save();
 save('myCanvas.jpg'); // save a specific canvas with a filename

Alternately, the first parameter can be a pointer to a canvas p5.Element, an Array of Strings, an Array of JSON, a JSON object, a p5.Table, a p5.Image, or a p5.SoundFile (requires p5.sound). The second parameter is a filename (including extension). The third parameter is for options specific to this type of object. This method will save a file that fits the given parameters. For example:


 // Saves canvas as an image
 save('myCanvas.jpg');

 // Saves pImage as a png image
 let img = createImage(10, 10);
 save(img, 'my.png');

 // Saves canvas as an image
 let cnv = createCanvas(100, 100);
 save(cnv, 'myCanvas.jpg');

 // Saves p5.Renderer object as an image
 let gb = createGraphics(100, 100);
 save(gb, 'myGraphics.jpg');

 let myTable = new p5.Table();

 // Saves table as html file
 save(myTable, 'myTable.html');

 // Comma Separated Values
 save(myTable, 'myTable.csv');

 // Tab Separated Values
 save(myTable, 'myTable.tsv');

 let myJSON = { a: 1, b: true };

 // Saves pretty JSON
 save(myJSON, 'my.json');

 // Optimizes JSON filesize
 save(myJSON, 'my.json', true);

 // Saves array of strings to a text file with line breaks after each item
 let arrayOfStrings = ['a', 'b'];
 save(arrayOfStrings, 'my.txt');