edu.uci.ics.jung.visualization.VisualizationModel Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of jung-visualization Show documentation

Core visualization support for the JUNG project

The newest version!

/*
 * Copyright (c) 2005, The JUNG Authors
 * All rights reserved.
 *
 * This software is open-source under the BSD license; see either "license.txt"
 * or https://github.com/jrtom/jung/blob/master/LICENSE for a description.
 *
 * Created on May 4, 2005
 */

package edu.uci.ics.jung.visualization;

import java.awt.Dimension;

import javax.swing.event.ChangeListener;

import edu.uci.ics.jung.algorithms.layout.Layout;
import edu.uci.ics.jung.algorithms.layout.util.Relaxer;
import edu.uci.ics.jung.visualization.util.ChangeEventSupport;

/**
 * Interface for the state holding model of the VisualizationViewer.
 * Refactored and extracted from the 1.6.0 version of VisualizationViewer
 * 
 * @author Tom Nelson 
 */
public interface VisualizationModel extends ChangeEventSupport {

	Relaxer getRelaxer();

	/**
     * set the graph Layout
     * @param layout the layout to use
     */
    void setGraphLayout(Layout layout);
    
    /**
     * Sets the graph Layout and initialize the Layout size to
     * the passed dimensions. The passed Dimension will often be
     * the size of the View that will display the graph.
     * @param layout the layout to use
     * @param d the dimensions to use
     */
    void setGraphLayout(Layout layout, Dimension d);

    /**
     * @return the current graph layout
     */
    Layout getGraphLayout();

    /**
     * Register l as a listeners to changes in the model. The View registers
     * in order to repaint itself when the model changes.
     * @param l the listener to add
     */
    void addChangeListener(ChangeListener l);

    /**
     * Removes a ChangeListener.
     * @param l the listener to be removed
     */
    void removeChangeListener(ChangeListener l);

    /**
     * Returns an array of all the ChangeListeners added
     * with addChangeListener().
     *
     * @return all of the ChangeListeners added or an empty
     *         array if no listeners have been added
     */
    ChangeListener[] getChangeListeners();
}