Tutorial: Creating a graphic user interface for your plugin with some components.

Plugin Example: A simple interface with some features.

 public class GuiBuildExample01 extends Plugin implements PluginImageAnalysis, ActionListener
{

    private IcyFrame frame;
    private JButton actionButton;
    private JButton exitButton;

    @Override
    public void compute()
    {
        // build frame and others controls
        frame = new IcyFrame("Plugin with panel", true, true);
        actionButton = new JButton("Action");
        exitButton = new JButton("Close");
        final JLabel sequenceLabel = new JLabel("", SwingConstants.CENTER);
        final JLabel sequenceNumberLabel = new JLabel();

        // build the global event listener
        final MainListener mainListener = new MainAdaptater()
        {
            // event on sequence focus change
            @Override
            public void sequenceFocused(MainEvent event)
            {
                // get the focused sequence (same as getFocusedSequence())
                final Sequence sequence = (Sequence) event.getSource();

                if (sequence != null)
                    sequenceLabel.setText(sequence.getName());
                else
                    sequenceLabel.setText("no sequence");

                // update the number of opened sequence
                sequenceNumberLabel.setText("" + getSequences().size());
            }
        };

        // get selected sequence
        final Sequence sequenceFocused = getFocusedSequence();

        // if we have one, show his name in the label
        if (sequenceFocused != null)
            sequenceLabel.setText(sequenceFocused.getName());
        else
            sequenceLabel.setText("no sequence");

        // create center panel as a big PAGE panel made from severals LINE panel
        final JPanel centerPanel = GuiUtil.createPageBoxPanel(Box.createVerticalStrut(4),
                GuiUtil.createLineBoxPanel(new JLabel("CurrentSequenceFocused : "), sequenceLabel),
                Box.createVerticalStrut(4),
                GuiUtil.createLineBoxPanel(new JLabel("Number of current sequence opened : "), sequenceNumberLabel),
                Box.createVerticalGlue(), Box.createVerticalStrut(4));
        // set a border to center panel
        centerPanel.setBorder(BorderFactory.createEtchedBorder());

        // create bottom panel as a simple LINE panel
        final JPanel bottomPanel = GuiUtil.createLineBoxPanel(Box.createHorizontalGlue(), Box.createHorizontalStrut(8),
                actionButton, Box.createHorizontalStrut(8), exitButton, Box.createHorizontalStrut(8));
        // set a border to bottom panel
        bottomPanel.setBorder(BorderFactory.createEtchedBorder());

        // use the BorderLayout so we can define resizeable part (CENTER alignment)
        frame.setLayout(new BorderLayout());

        // panel in CENTER alignment can be resized both in width and height
        frame.add(centerPanel, BorderLayout.CENTER);
        // panel in NORTH / SOUTH alignment can only be resized in width
        frame.add(bottomPanel, BorderLayout.SOUTH);

        actionButton.addActionListener(this);
        exitButton.addActionListener(this);

        // add main listener
        // WARNING : don't forget to remove it when plugin exit or instance will never die
        Icy.getMainInterface().addListener(mainListener);

        // add a listener to frame events
        frame.addFrameListener(new IcyFrameAdapter()
        {
            // called when frame is closed
            @Override
            public void icyFrameClosed(IcyFrameEvent e)
            {
                // remove the main listener so there is no more reference on plugin instance
                Icy.getMainInterface().removeListener(mainListener);
            }
        });

        // set size
        frame.setSize(new Dimension(480, 340));
        // add frame to application desktop
        addIcyFrame(frame);
        // center
        frame.center();
        // and finally make it visible
        frame.setVisible(true);
    }

    @Override
    public void actionPerformed(ActionEvent e)
    {
        if (e.getSource() == actionButton)
            MessageDialog.showDialog("Perform an action", "Number of sequence : " + getSequences().size());
        else if (e.getSource() == exitButton)
            frame.close();
    }
}

Author:

Fabrice & Stephane