"test.bird.BirdViewTest",

    public static void sleep (int delay) {

        try {

            Thread.sleep (delay);

        } catch (InterruptedException e) {

            e.printStackTrace ();

        }

    }

/*

 * The contents of this file are subject to the terms of the Common Development

 * and Distribution License (the License). You may not use this file except in

 * compliance with the License.

 *

 * You can obtain a copy of the License at http://www.netbeans.org/cddl.html

 * or http://www.netbeans.org/cddl.txt.

 *

 * When distributing Covered Code, include this CDDL Header Notice in each file

 * and include the License file at http://www.netbeans.org/cddl.txt.

 * If applicable, add the following below the CDDL Header, with the fields

 * enclosed by brackets [] replaced by your own identifying information:

 * "Portions Copyrighted [year] [name of copyright owner]"

 *

 * The Original Software is NetBeans. The Initial Developer of the Original

 * Software is Sun Microsystems, Inc. Portions Copyright 1997-2007 Sun

 * Microsystems, Inc. All Rights Reserved.

 */

package test.bird;

import org.netbeans.api.visual.widget.BirdViewController;

import test.SceneSupport;

import test.general.StringGraphScene;

import java.awt.*;

/**

 * @author David Kaspar

 */

public class BirdViewTest {

    public static void main (String[] args) {

        StringGraphScene scene = new StringGraphScene ();

        for (int a = 0; a < 100; a ++)

            scene.addNode ("node" + String.valueOf (a)).setPreferredLocation (new Point (SceneSupport.randInt (1000), SceneSupport.randInt (1000)));

        BirdViewController birdViewController = scene.createBirdView ();

        scene.createView (); // main view has to be created before showing the bird view

        birdViewController.show ();

        SceneSupport.show (scene);

        SceneSupport.sleep (2000);

        birdViewController.setZoomFactor (5.0);

        birdViewController.setWindowSize (new Dimension (400, 400));

        SceneSupport.sleep (2000);

        birdViewController.hide ();

        SceneSupport.sleep (2000);

        birdViewController.show ();

    }

}

        <change>

            <api name="general"/>

            <summary>Bird view support added</summary>

            <version major="2" minor="7"/>

            <date day="27" month="7" year="2007"/>

            <author login="dkaspar"/>

            <compatibility addition="yes"/>

            <description>

                Bird view is a window that is always under your mouse-cursor and shows the scene with a specified zoom factor.

                A bird view can be created using Scene.createBirdView method. To enable bird view you need to call the show method on returned controller instance.

            </description>

            <class package="org.netbeans.api.visual.widget" name="Scene" link="yes"/>

            <issue number="108510"/>

        </change>

/*

 * The contents of this file are subject to the terms of the Common Development

 * and Distribution License (the License). You may not use this file except in

 * compliance with the License.

 *

 * You can obtain a copy of the License at http://www.netbeans.org/cddl.html

 * or http://www.netbeans.org/cddl.txt.

 *

 * When distributing Covered Code, include this CDDL Header Notice in each file

 * and include the License file at http://www.netbeans.org/cddl.txt.

 * If applicable, add the following below the CDDL Header, with the fields

 * enclosed by brackets [] replaced by your own identifying information:

 * "Portions Copyrighted [year] [name of copyright owner]"

 *

 * The Original Software is NetBeans. The Initial Developer of the Original

 * Software is Sun Microsystems, Inc. Portions Copyright 1997-2007 Sun

 * Microsystems, Inc. All Rights Reserved.

 */

package org.netbeans.api.visual.widget;

import org.netbeans.modules.visual.widget.BirdViewWindow;

import java.awt.*;

/**

 * This class controls a bird view created for a specific scene. The bird is tracking mouse-cursor over the main scene view.

 * You can specify a separate zoom-factor and you can enable and disable it by calling <code>show</code> and <code>hide</code> methods.

 * <p>

 * When a bird view is enabled then it consumes all events of a main scene view therefore you cannot do anything except

 * watch the scene with bird view.

 *

 * @since 2.7

 * @author David Kaspar

 */

public final class BirdViewController {

    private BirdViewWindow birdView;

    BirdViewController (Scene scene) {

        birdView = new BirdViewWindow (scene);

    }

    /**

     * Sets a zoom factor of the bird view.

     * @param zoomFactor the zoom factor

     * @since 2.7

     */

    public void setZoomFactor (double zoomFactor) {

        birdView.setZoomFactor (zoomFactor);

    }

    /**

     * Sets a size of the bird view window.

     * @param size the window size

     * @since 2.7

     */

    public void setWindowSize (Dimension size) {

        birdView.setWindowSize (size);

    }

    /**

     * Enables the bird view. It means that the bird view window will be visible while a mouse cursor is over the visible

     * area of the main scene view.

     * <p>

     * Note: Has to be invoked after <code>Scene.createView</code> method.

     * <p>

     * Note: An user has to initially move cursor over the visible area of the main scene view

     * to show the window up for the first time after the method call.

     * @since 2.7

     */

    public void show () {

        birdView.invokeShow ();

    }

    /**

     * Disables the bird view. It means the bird view window is hidden and the main scene view is not blocked for events.

     * @since 2.7

     */

    public void hide () {

        birdView.invokeHide ();

    }

}

import org.netbeans.api.visual.laf.LookFeel;

    }

    /**

     * Creates a bird view with specific zoom factor.

     * @return the bird view controller

     * @since 2.7

     */

    public BirdViewController createBirdView () {

        return new BirdViewController (this);

<td>createBirdView

<td>Creates a bird view of the scene. It is enough to create one bird view and reuse it all the time. The bird view is tracking mouse cursor and when the cursor is over visible area of the scene view, then an additional always-on-top window is shown and shows pointed part of the scene with specified zoom factor. The method returns <code>BirdViewController</code> which allows control over the bird view. When the bird view is enabled, then it consumes all events of the scene view.

<tr>

/*

 * The contents of this file are subject to the terms of the Common Development

 * and Distribution License (the License). You may not use this file except in

 * compliance with the License.

 *

 * You can obtain a copy of the License at http://www.netbeans.org/cddl.html

 * or http://www.netbeans.org/cddl.txt.

 *

 * When distributing Covered Code, include this CDDL Header Notice in each file

 * and include the License file at http://www.netbeans.org/cddl.txt.

 * If applicable, add the following below the CDDL Header, with the fields

 * enclosed by brackets [] replaced by your own identifying information:

 * "Portions Copyrighted [year] [name of copyright owner]"

 *

 * The Original Software is NetBeans. The Initial Developer of the Original

 * Software is Sun Microsystems, Inc. Portions Copyright 1997-2007 Sun

 * Microsystems, Inc. All Rights Reserved.

 */

package org.netbeans.modules.visual.widget;

import org.netbeans.api.visual.action.WidgetAction;

import org.netbeans.api.visual.widget.Scene;

import org.netbeans.api.visual.widget.Widget;

import javax.swing.*;

import javax.swing.border.BevelBorder;

import javax.swing.border.CompoundBorder;

import javax.swing.border.EmptyBorder;

import javax.swing.border.LineBorder;

import javax.swing.event.AncestorEvent;

import javax.swing.event.AncestorListener;

import java.awt.*;

import java.awt.event.MouseEvent;

import java.awt.event.MouseMotionListener;

import java.awt.geom.AffineTransform;

/**

 * @author David Kaspar

 */

public class BirdViewWindow extends JWindow implements MouseMotionListener {

    private Scene scene;

    private BirdViewComponent birdView;

    private boolean shown = false;

    private double zoomFactor = 3.0;

    private Point scenePoint;

    private WidgetAction action = new SceneTrackAction ();

    private ViewAncestorListener ancestorListener = new ViewAncestorListener ();

    public BirdViewWindow (final Scene scene) {

        this.scene = scene;

        setSize (new Dimension (256, 256));

        setLayout (new BorderLayout ());

        setAlwaysOnTop (true);

        JPanel pane = new JPanel ();

        pane.setBorder (new CompoundBorder (new LineBorder (Color.BLACK, 1), new EmptyBorder (1, 1, 1, 1)));

        pane.setLayout (new BorderLayout ());

        add (pane, BorderLayout.CENTER);

        birdView = new BirdViewComponent ();

        birdView.setDoubleBuffered (true);

        birdView.setBorder (new BevelBorder (BevelBorder.RAISED));

        pane.add (birdView, BorderLayout.CENTER);

    }

    public void invokeShow () {

        if (scene.getView () == null)

            return;

        if (shown)

            return;

        shown = true;

        birdView.addMouseMotionListener (this);

        scene.getPriorActions ().addAction (action);

        scene.getView ().addAncestorListener (ancestorListener);

        updateForViewPoint (null);

    }

    public void invokeHide () {

        if (! shown)

            return;

        shown = false;

        birdView.removeMouseMotionListener (this);

        scene.getPriorActions ().removeAction (action);

        scene.getView ().removeAncestorListener (ancestorListener);

        updateForViewPoint (null);

    }

    public void invokeRepaint () {

        birdView.repaint ();

    }

    public void setZoomFactor (double zoomFactor) {

        this.zoomFactor = zoomFactor;

        invokeRepaint ();

    }

    public void setWindowSize (Dimension size) {

        Dimension previousSize = getSize ();

        setSize (size);

        if (isShowing ()) {

            Point location = getLocation ();

            setLocation (location.x + (previousSize.width - size.width) / 2, location.y + (previousSize.height - size.height) / 2);

            validate ();

        }

    }

    private void updateForViewPoint (Point viewPoint) {

        JComponent view = scene.getView ();

        if (! shown  ||  viewPoint == null  ||  ! view.getVisibleRect ().contains (viewPoint)) {

            scenePoint = null;

            setVisible (false);

            dispose ();

            return;

        }

        scenePoint = scene.convertViewToScene (viewPoint);

        Point viewOrigin = view.getLocationOnScreen ();

        Dimension size = getSize ();

        setBounds (viewOrigin.x + viewPoint.x - size.width / 2, viewOrigin.y + viewPoint.y - size.height / 2, size.width, size.height);

        setVisible (true);

        birdView.repaint();

    }

    private void updateForBirdViewPoint (Point birdViewPoint) {

        JComponent view = scene.getView ();

        if (view.isShowing ()  &&  isShowing ()) {

            Point viewOrigin = view.getLocationOnScreen ();

            Point birdViewOrigin = getLocationOnScreen ();

            Dimension size = getSize ();

            updateForViewPoint (new Point (birdViewPoint.x + birdViewOrigin.x - viewOrigin.x, birdViewPoint.y + birdViewOrigin.y - viewOrigin.y));

        } else

            updateForViewPoint (null);

    }

    public void mouseDragged (MouseEvent e) {

        updateForBirdViewPoint (e.getPoint ());

    }

    public void mouseMoved (MouseEvent e) {

        updateForBirdViewPoint (e.getPoint ());

    }

    private class SceneTrackAction implements WidgetAction {

        public State mouseClicked (Widget widget, WidgetMouseEvent event) {

            return State.CONSUMED;

        }

        public State mousePressed (Widget widget, WidgetMouseEvent event) {

            return State.CONSUMED;

        }

        public State mouseReleased (Widget widget, WidgetMouseEvent event) {

            return State.CONSUMED;

        }

        public State mouseEntered (Widget widget, WidgetMouseEvent event) {

            return State.CONSUMED;

        }

        public State mouseExited (Widget widget, WidgetMouseEvent event) {

            return State.CONSUMED;

        }

        public State mouseDragged (Widget widget, WidgetMouseEvent event) {

            updateForViewPoint (widget.getScene ().convertSceneToView (widget.convertLocalToScene (event.getPoint ())));

            return State.CONSUMED;

        }

        public State mouseMoved (Widget widget, WidgetMouseEvent event) {

            updateForViewPoint (widget.getScene ().convertSceneToView (widget.convertLocalToScene (event.getPoint ())));

            return State.CONSUMED;

        }

        public State mouseWheelMoved (Widget widget, WidgetMouseWheelEvent event) {

            return State.CONSUMED;

        }

        public State keyTyped (Widget widget, WidgetKeyEvent event) {

            return State.CONSUMED;

        }

        public State keyPressed (Widget widget, WidgetKeyEvent event) {

            return State.CONSUMED;

        }

        public State keyReleased (Widget widget, WidgetKeyEvent event) {

            return State.CONSUMED;

        }

        public State focusGained (Widget widget, WidgetFocusEvent event) {

            return State.CONSUMED;

        }

        public State focusLost (Widget widget, WidgetFocusEvent event) {

            return State.CONSUMED;

        }

        public State dragEnter (Widget widget, WidgetDropTargetDragEvent event) {

            return State.CONSUMED;

        }

        public State dragOver (Widget widget, WidgetDropTargetDragEvent event) {

            return State.CONSUMED;

        }

        public State dropActionChanged (Widget widget, WidgetDropTargetDragEvent event) {

            return State.CONSUMED;

        }

        public State dragExit (Widget widget, WidgetDropTargetEvent event) {

            return State.CONSUMED;

        }

        public State drop (Widget widget, WidgetDropTargetDropEvent event) {

            return State.CONSUMED;

        }

    }

    private class BirdViewComponent extends JComponent {

        public void paint (Graphics g) {

            Graphics2D gr = (Graphics2D) g;

            super.paint (g);

            if (scenePoint == null) {

                gr.setColor (Color.BLACK);

                gr.fill (getBounds ());

                return;

            }

            Dimension size = getSize ();

            AffineTransform previousTransform = gr.getTransform ();

            gr.translate (size.width / 2, size.height / 2);

            gr.scale (zoomFactor, zoomFactor);

            gr.translate (- scenePoint.x, - scenePoint.y);

            scene.paint (gr);

            gr.setTransform (previousTransform);

        }

    }

    private class ViewAncestorListener implements AncestorListener {

        public void ancestorAdded (AncestorEvent event) {

        }

        public void ancestorRemoved (AncestorEvent event) {

            invokeHide ();

        }

        public void ancestorMoved (AncestorEvent event) {

        }

    }

}

<li><strong>test.bird.BirdViewTest</strong> - how to use bird view

<li>In-place editing