/*
 * @(#)VideoRenderer.java	1.11 02/08/21
 *
 * Copyright (c) 1996-2002 Sun Microsystems, Inc.  All rights reserved.
 */

package javax.media.renderer;

import java.awt.Component;
import java.awt.Rectangle;
import javax.media.Renderer;

/**
 * An interface for renderers that render video to a display or
 * any other such device.
 * @since JMF 2.0
 */
public interface VideoRenderer extends javax.media.Renderer {

    /**
     * Returns an AWT component that it will render to. Returns null
     * if it is not rendering to an AWT component.
     * @return  the component that will used for rendering.
     */
    public java.awt.Component getComponent();

    /**
     * Requests the renderer to draw into a specified AWT component.
     * @param comp the component to be used for rendering.
     * @return false if the renderer cannot draw into the specified
     * component.
     */
    public boolean setComponent(java.awt.Component comp);

    /**
     * Sets the region in the component where the video is to be
     * rendered to. Video is to be scaled if necessary. If <code>rect</code>
     * is null, then the video occupies the entire component.
     * @param rect the rect that defines the region to be rendered to.
     */
    public void setBounds(java.awt.Rectangle rect);

    /**
     * Returns the region in the component where the video will be
     * rendered to. Returns null if the entire component is being used.
     * @return the region where the video will be rendered.
     */
    public java.awt.Rectangle getBounds();
}