/*
 * This file is part of McIDAS-V
 *
 * Copyright 2007-2025
 * Space Science and Engineering Center (SSEC)
 * University of Wisconsin - Madison
 * 1225 W. Dayton Street, Madison, WI 53706, USA
 * https://www.ssec.wisc.edu/mcidas/
 * 
 * All Rights Reserved
 * 
 * McIDAS-V is built on Unidata's IDV and SSEC's VisAD libraries, and
 * some McIDAS-V source code is based on IDV and VisAD source code.  
 * 
 * McIDAS-V is free software; you can redistribute it and/or modify
 * it under the terms of the GNU Lesser Public License as published by
 * the Free Software Foundation; either version 3 of the License, or
 * (at your option) any later version.
 * 
 * McIDAS-V is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU Lesser Public License for more details.
 * 
 * You should have received a copy of the GNU Lesser Public License
 * along with this program.  If not, see https://www.gnu.org/licenses/.
 */

package edu.wisc.ssec.mcidasv.ui;

import java.awt.BorderLayout;
import java.awt.Component;
import java.awt.Dimension;
import java.awt.DisplayMode;
import java.awt.FlowLayout;
import java.awt.GraphicsDevice;
import java.awt.GraphicsEnvironment;
import java.awt.MouseInfo;
import java.awt.Point;
import java.awt.PointerInfo;
import java.awt.event.ComponentAdapter;
import java.awt.event.ComponentEvent;
import java.awt.event.MouseAdapter;
import java.awt.event.MouseEvent;

import javax.swing.BorderFactory;
import javax.swing.JButton;
import javax.swing.JFrame;
import javax.swing.JTree;
import javax.swing.JWindow;
import javax.swing.SwingUtilities;
import javax.swing.border.BevelBorder;
import javax.swing.tree.DefaultMutableTreeNode;
import javax.swing.tree.DefaultTreeModel;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

/**
 * A popup window that attaches itself to a parent and can display an 
 * component without preventing user interaction like a {@code JComboBox}.
 */
public class ComponentPopup extends JWindow {
    
    private static final Logger logger =
        LoggerFactory.getLogger(ComponentPopup.class);
    
    private static final long serialVersionUID = 7394231585407030118L;

    /**
     * Number of pixels to use to compensate for when the mouse is moved slowly
     * thereby hiding this popup when between components.
     */
    private static final int FLUFF = 3;

    /**
     * Get the calculated total screen size.
     * 
     * @return The dimensions of the screen on the default screen device.
     */
    protected static Dimension getScreenSize() {
        GraphicsEnvironment genv = GraphicsEnvironment
            .getLocalGraphicsEnvironment();
        GraphicsDevice gdev = genv.getDefaultScreenDevice();
        DisplayMode dmode = gdev.getDisplayMode();

        return new Dimension(dmode.getWidth(), dmode.getHeight());
    }

    /**
     * Does the component contain the screen relative point.
     * 
     * @param comp The component to check.
     * @param point Screen relative point.
     * @param fluff Size in pixels of the area added to both sides of the
     *        component in the x and y directions and used for the contains
     *        calculation.
     * @return True if the the point lies in the area plus or minus the fluff
     *         factor in either direction.
     */
    public boolean containsPoint(Component comp, Point point, int fluff) {
        if (!comp.isVisible()) {
            return false;
        }
        Point my = comp.getLocationOnScreen();
        boolean containsX = point.x > my.x - FLUFF && point.x < my.x + getWidth() + FLUFF;
        boolean containsY = point.y > my.y - FLUFF && point.y < my.y + getHeight() + FLUFF;
        return containsX && containsY;
    }

    /**
     * Does the component contain the screen relative point.
     * 
     * @param comp The component to check.
     * @param point Screen relative point.
     * @return True if the the point lies in the same area occupied by the
     *         component.
     */
    public boolean containsPoint(Component comp, Point point) {
        return containsPoint(comp, point, 0);
    }

    /**
     * Determines if the mouse is on me.
     */
    private final MouseAdapter ourHideAdapter;

    /**
     * Determines if the mouse is on my dad.
     */
    private final MouseAdapter parentsHideAdapter;

    /**
     * What to do if the parent compoentn state changes.
     */
    private final ComponentAdapter parentsCompAdapter;

    private Component parent;

    /**
     * Create an instance associated with the given parent.
     * 
     * @param parent The component to attach this instance to.
     */
    public ComponentPopup(Component parent) {
        ourHideAdapter = new MouseAdapter() {

            @Override
            public void mouseExited(MouseEvent evt) {
                PointerInfo info = MouseInfo.getPointerInfo();
                boolean onParent = containsPoint(ComponentPopup.this.parent,
                    info.getLocation());

                if (isVisible() && !onParent) {
                    setVisible(false);
                }
            }
        };
        parentsHideAdapter = new MouseAdapter() {

            @Override
            public void mouseExited(MouseEvent evt) {
                PointerInfo info = MouseInfo.getPointerInfo();
                boolean onComponent = containsPoint(ComponentPopup.this,
                    info.getLocation());
                if (isVisible() && !onComponent) {
                    setVisible(false);
                }
            }
        };
        parentsCompAdapter = new ComponentAdapter() {

            @Override
            public void componentHidden(ComponentEvent evt) {
                setVisible(false);
            }

            @Override
            public void componentResized(ComponentEvent evt) {
                showPopup();
            }
        };
        setParent(parent);
    }

    /**
     * Set our parent. If there is currently a parent remove the associated
     * listeners and add them to the new parent.
     * 
     * @param comp
     */
    public void setParent(Component comp) {
        if (parent != null) {
            parent.removeMouseListener(parentsHideAdapter);
            parent.removeComponentListener(parentsCompAdapter);
        }

        parent = comp;
        parent.addComponentListener(parentsCompAdapter);
        parent.addMouseListener(parentsHideAdapter);
    }

    /**
     * Show this popup above the parent. It is not checked if the component will
     * fit on the screen.
     */
    public void showAbove() {
        Point loc = parent.getLocationOnScreen();
        int x = loc.x;
        int y = loc.y - getHeight();
        showPopupAt(x, y);
    }

    /**
     * Show this popup below the parent. It is not checked if the component will
     * fit on the screen.
     */
    public void showBelow() {
        Point loc = parent.getLocationOnScreen();
        int x = loc.x;
        int y = loc.y + parent.getHeight();
        showPopupAt(x, y);
    }

    /**
     * Do we fit between the top of the parent and the top edge of the screen.
     * 
     * @return True if we fit between the upper edge of our parent and the top
     *         edge of the screen.
     */
    protected boolean fitsAbove() {
        Point loc = parent.getLocationOnScreen();
        int myH = getHeight();
        return loc.y - myH > 0;
    }

    /**
     * Do we fit between the bottom of the parent and the edge of the screen.
     * 
     * @return True if we fit between the bottom edge of our parent and the
     *         bottom edge of the screen.
     */
    protected boolean fitsBelow() {
        Point loc = parent.getLocationOnScreen();
        Dimension scr = getScreenSize();
        int myH = getHeight();
        return loc.y + parent.getHeight() + myH < scr.height;
    }

    /**
     * Show at the specified X and Y.
     * 
     * @param x
     * @param y
     */
    public void showPopupAt(int x, int y) {
        setLocation(x, y);
        setVisible(true);
    }

    /**
     * Show this popup deciding whether to show it above or below the parent
     * component.
     */
    public void showPopup() {
        if (fitsBelow()) {
            showBelow();
        } else {
            showAbove();
        }
    }

    /**
     * Overridden to make sure our hide listeners are added to child components.
     * 
     * @see javax.swing.JWindow#addImpl(java.awt.Component, java.lang.Object, int)
     */
    protected void addImpl(Component comp, Object constraints, int index) {
        super.addImpl(comp, constraints, index);
        comp.addMouseListener(ourHideAdapter);
    }

    /**
     * Test method.
     */
    private static void createAndShowGui() {
        DefaultMutableTreeNode root = new DefaultMutableTreeNode("ROOT");
        DefaultTreeModel model = new DefaultTreeModel(root);
        JTree tree = new JTree(model);
        tree.setBorder(BorderFactory.createBevelBorder(BevelBorder.LOWERED));

        root.add(new DefaultMutableTreeNode("Child 1"));
        root.add(new DefaultMutableTreeNode("Child 2"));
        root.add(new DefaultMutableTreeNode("Child 3"));

        for (int i = 0; i < tree.getRowCount(); i++) {
            tree.expandPath(tree.getPathForRow(i));
        }
        final JButton button = new JButton("Popup");
        final ComponentPopup cp = new ComponentPopup(button);
        cp.add(tree, BorderLayout.CENTER);
        cp.pack();
        button.addActionListener(evt -> cp.showPopup());

        JFrame frame = new JFrame("ComponentPopup");
        frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        frame.setLayout(new FlowLayout());
        frame.add(button);
        frame.pack();
        frame.setVisible(true);
    }

    /**
     * Test method.
     * 
     * @param args
     */
    public static void main(String[] args) {
        try {
            javax.swing.UIManager.setLookAndFeel(javax.swing.UIManager
                .getCrossPlatformLookAndFeelClassName());
        } catch (Exception e) {
            logger.error("Problem changing LAF", e);
        }
        SwingUtilities.invokeLater(ComponentPopup::createAndShowGui);
    }

}