fop/src/org/apache/fop/render/Renderer.java

/*
 * $Id$
 * Copyright (C) 2001 The Apache Software Foundation. All rights reserved.
 * For details on use and redistribution please refer to the
 * LICENSE file included with these sources.
 */
package org.apache.fop.render;

// FOP
import org.apache.fop.image.ImageArea;
import org.apache.fop.apps.FOPException;
import org.apache.fop.area.*;
import org.apache.fop.area.inline.*;
import org.apache.fop.layout.FontInfo;
import org.apache.fop.fo.FOUserAgent;

import org.apache.log.Logger;

// Java
import java.io.OutputStream;
import java.io.IOException;
import java.util.HashMap;

/**
 * Interface implemented by all renderers.
 * This interface is used to control the rendering of pages
 * and to let block and inline level areas call the appropriate
 * method to render themselves
 *
 * a Renderer implementation takes areas/spaces and produces output in
 * some format.
 */
public interface Renderer {

    public void startRenderer(OutputStream outputStream)
    throws IOException;

    public void stopRenderer()
    throws IOException;

    /**
     * Set the logger
     */
    public void setLogger(Logger logger);

    /**
     * Set the User Agent
     */
    public void setUserAgent(FOUserAgent agent);

    /**
     * set up the given FontInfo
     */
    public void setupFontInfo(FontInfo fontInfo);

    /**
     * set up renderer options
     */
    public void setOptions(HashMap options);

    /**
     * set the producer of the rendering
     */
    public void setProducer(String producer);

    public void startPageSequence(Title seqTitle);

    public void renderPage(PageViewport page)
    throws IOException, FOPException;


    public void renderContainer(Container cont);
/*
    public void renderInlineViewport(org.apache.fop.area.inline.Viewport view);

    public void renderWord(Word area);
*/
    public void renderCharacter(org.apache.fop.area.inline.Character ch);

    public void renderInlineSpace(Space space);
/*
    public void renderForeignObject(ForeignObject area);

    public void renderImage(Image area);

    public void renderLeader(Leader area);
*/
}