Layer.detach

Layer.detach([layername:String]);

Remove a layer from the canvas. This layer is not destroyed, and can be reattached later.

• layername: Optional. The name of the layer to detach. Leave blank to detach all layers, including the "screen".

Example:

import haxegon.*;

class Main{
  function init(){
    Layer.create("foreground");
    Layer.attach("foreground");
		
    Layer.drawto("foreground");
    for (i in 0 ... 200){
      //Draw 200 random circles on the "foreground" layer
      Gfx.fillcircle(Random.int(0, Gfx.screenwidth), Random.int(0, Gfx.screenheight), Random.int(50, 80), Col.hsl(Random.int(0, 360), 0.5, 0.5), 0.5);
    }
    Gfx.drawtoscreen();
  }
  
  function update(){
    //Press any key to attach and detach the "foreground" layer
    if (Input.justpressed(Key.ANY)){
      if (Layer.attached("foreground")){
	Layer.detach("foreground");
      }else{
	Layer.attach("foreground");
      }
    }
  }
}