package org.jzy3d.plot3d.rendering.canvas;

import com.jogamp.opengl.GLAnimatorControl;
import com.jogamp.opengl.util.Animator;

/** 
 * An {@link IScreenCanvas} defines a panel into which rendering occurs,
 * and that can be integrated in an existing GUI. An {@link IScreenCanvas}
 * implementation allows to render 3d content for a given Windowing toolkit:
 * 

 * 
{@link CanvasAWT} is a base implementation suitable for AWT, Swing or SWT applications.
 * 
{@link CanvasNewtAwt} is a new implementation (since 0.9.1) using JOGL's recommended windowing toolkit.
 * 
{@link CanvasSwing} is a deprecated implementation for Swing (since 0.9.1)
 * 
 *  
 * An {@link IScreenCanvas} provides access to an {@link Animator} instance.
 * This offers the alternative of repaint-on-demand-model based on Controllers, 
 * and repaint-continuously model based on the Animator (default behaviour).
 * 
 * The actual {@link IScreenCanvas} initialize by a given chart will depend on:
 * 

 * 
The Windowing toolkit parameter of the chart (new Chart("awt"))
 * 
The Windowing toolkit parameters supported by {@link ChartComponentFactory.initializeCanvas(...)}
 * 
 * 
 * In other word, if creating another canvas implementation is required, 
 * simply extends the component factory.  
 * 
 * @author Martin Pernollet
 */
public interface IScreenCanvas extends ICanvas{
	public void display();
	public GLAnimatorControl getAnimator();
	
}