src/share/classes/sun/swing/JLightweightFrame.java

Print this page




  12  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  13  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  14  * version 2 for more details (a copy is included in the LICENSE file that
  15  * accompanied this code).
  16  *
  17  * You should have received a copy of the GNU General Public License version
  18  * 2 along with this work; if not, write to the Free Software Foundation,
  19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any
  23  * questions.
  24  */
  25 
  26 package sun.swing;
  27 
  28 import java.awt.BorderLayout;
  29 import java.awt.Color;
  30 import java.awt.Component;
  31 import java.awt.Container;

  32 import java.awt.EventQueue;
  33 import java.awt.Graphics;
  34 import java.awt.Graphics2D;
  35 import java.awt.Rectangle;





  36 import java.awt.image.BufferedImage;
  37 import java.awt.image.DataBufferInt;


  38 import java.security.AccessController;
  39 
  40 import javax.swing.JLayeredPane;
  41 import javax.swing.JPanel;
  42 import javax.swing.JRootPane;
  43 import javax.swing.LayoutFocusTraversalPolicy;
  44 import javax.swing.RootPaneContainer;
  45 
  46 import sun.awt.LightweightFrame;
  47 import sun.security.action.GetPropertyAction;
  48 
  49 /**
  50  * The frame serves as a lightweight container which paints its content
  51  * to an offscreen image and provides access to the image's data via the
  52  * {@link LightweightContent} interface. Note, that it may not be shown
  53  * as a standalone toplevel frame. Its purpose is to provide functionality
  54  * for lightweight embedding.
  55  *
  56  * @author Artem Ananiev
  57  * @author Anton Tarasov


  63     private LightweightContent content;
  64 
  65     private Component component;
  66     private JPanel contentPane;
  67 
  68     private BufferedImage bbImage;
  69 
  70     /**
  71      * {@code copyBufferEnabled}, true by default, defines the following strategy.
  72      * A duplicating (copy) buffer is created for the original pixel buffer.
  73      * The copy buffer is synchronized with the original buffer every time the
  74      * latter changes. {@code JLightweightFrame} passes the copy buffer array
  75      * to the {@link LightweightContent#imageBufferReset} method. The code spot
  76      * which synchronizes two buffers becomes the only critical section guarded
  77      * by the lock (managed with the {@link LightweightContent#paintLock()},
  78      * {@link LightweightContent#paintUnlock()} methods).
  79      */
  80     private boolean copyBufferEnabled;
  81     private int[] copyBuffer;
  82 


  83     /**
  84      * Constructs a new, initially invisible {@code JLightweightFrame}
  85      * instance.
  86      */
  87     public JLightweightFrame() {
  88         super();
  89         copyBufferEnabled = "true".equals(AccessController.
  90             doPrivileged(new GetPropertyAction("jlf.copyBufferEnabled", "true")));
  91 
  92         add(rootPane, BorderLayout.CENTER);
  93         setFocusTraversalPolicy(new LayoutFocusTraversalPolicy());
  94         if (getGraphicsConfiguration().isTranslucencyCapable()) {
  95             setBackground(new Color(0, 0, 0, 0));
  96         }
  97     }
  98 
  99     /**
 100      * Sets the {@link LightweightContent} instance for this frame.
 101      * The {@code JComponent} object returned by the
 102      * {@link LightweightContent#getComponent()} method is immediately
 103      * added to the frame's content pane.
 104      *
 105      * @param content the {@link LightweightContent} instance
 106      */
 107     public void setContent(LightweightContent content) {




 108         this.content = content;
 109         this.component = content.getComponent();
 110 




























 111         initInterior();
 112     }
 113 
 114     @Override
 115     public Graphics getGraphics() {
 116         if (bbImage == null) return null;
 117 
 118         Graphics2D g = bbImage.createGraphics();
 119         g.setBackground(getBackground());
 120         g.setColor(getForeground());
 121         g.setFont(getFont());
 122         return g;
 123     }
 124 
 125     /**
 126      * {@inheritDoc}
 127      *
 128      * @see LightweightContent#focusGrabbed()
 129      */
 130     @Override


 185                             if (copyBufferEnabled) {
 186                                 syncCopyBuffer(false, clip.x, clip.y, clip.width, clip.height);
 187                             }
 188                             content.imageUpdated(clip.x, clip.y, clip.width, clip.height);
 189                         }
 190                     });
 191                 } finally {
 192                     if (!copyBufferEnabled) {
 193                         content.paintUnlock();
 194                     }
 195                 }
 196             }
 197             @Override
 198             protected boolean isPaintingOrigin() {
 199                 return true;
 200             }
 201         };
 202         contentPane.setLayout(new BorderLayout());
 203         contentPane.add(component);
 204         setContentPane(contentPane);










 205     }
 206 
 207     @SuppressWarnings("deprecation")
 208     @Override public void reshape(int x, int y, int width, int height) {
 209         super.reshape(x, y, width, height);
 210 
 211         if (width == 0 || height == 0) {
 212             return;
 213         }
 214         if (!copyBufferEnabled) {
 215             content.paintLock();
 216         }
 217         try {
 218             if ((bbImage == null) || (width != bbImage.getWidth()) || (height != bbImage.getHeight())) {
 219                 boolean createBB = true;
 220                 int newW = width;
 221                 int newH = height;
 222                 if (bbImage != null) {
 223                     int oldW = bbImage.getWidth();
 224                     int oldH = bbImage.getHeight();




  12  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  13  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  14  * version 2 for more details (a copy is included in the LICENSE file that
  15  * accompanied this code).
  16  *
  17  * You should have received a copy of the GNU General Public License version
  18  * 2 along with this work; if not, write to the Free Software Foundation,
  19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any
  23  * questions.
  24  */
  25 
  26 package sun.swing;
  27 
  28 import java.awt.BorderLayout;
  29 import java.awt.Color;
  30 import java.awt.Component;
  31 import java.awt.Container;
  32 import java.awt.Dimension;
  33 import java.awt.EventQueue;
  34 import java.awt.Graphics;
  35 import java.awt.Graphics2D;
  36 import java.awt.Rectangle;
  37 import java.awt.event.ComponentEvent;
  38 import java.awt.event.ComponentListener;
  39 import java.awt.event.ContainerAdapter;
  40 import java.awt.event.ContainerEvent;
  41 import java.awt.event.ContainerListener;
  42 import java.awt.image.BufferedImage;
  43 import java.awt.image.DataBufferInt;
  44 import java.beans.PropertyChangeEvent;
  45 import java.beans.PropertyChangeListener;
  46 import java.security.AccessController;
  47 
  48 import javax.swing.JLayeredPane;
  49 import javax.swing.JPanel;
  50 import javax.swing.JRootPane;
  51 import javax.swing.LayoutFocusTraversalPolicy;
  52 import javax.swing.RootPaneContainer;
  53 
  54 import sun.awt.LightweightFrame;
  55 import sun.security.action.GetPropertyAction;
  56 
  57 /**
  58  * The frame serves as a lightweight container which paints its content
  59  * to an offscreen image and provides access to the image's data via the
  60  * {@link LightweightContent} interface. Note, that it may not be shown
  61  * as a standalone toplevel frame. Its purpose is to provide functionality
  62  * for lightweight embedding.
  63  *
  64  * @author Artem Ananiev
  65  * @author Anton Tarasov


  71     private LightweightContent content;
  72 
  73     private Component component;
  74     private JPanel contentPane;
  75 
  76     private BufferedImage bbImage;
  77 
  78     /**
  79      * {@code copyBufferEnabled}, true by default, defines the following strategy.
  80      * A duplicating (copy) buffer is created for the original pixel buffer.
  81      * The copy buffer is synchronized with the original buffer every time the
  82      * latter changes. {@code JLightweightFrame} passes the copy buffer array
  83      * to the {@link LightweightContent#imageBufferReset} method. The code spot
  84      * which synchronizes two buffers becomes the only critical section guarded
  85      * by the lock (managed with the {@link LightweightContent#paintLock()},
  86      * {@link LightweightContent#paintUnlock()} methods).
  87      */
  88     private boolean copyBufferEnabled;
  89     private int[] copyBuffer;
  90     
  91     private PropertyChangeListener layoutSizeListener;
  92 
  93     /**
  94      * Constructs a new, initially invisible {@code JLightweightFrame}
  95      * instance.
  96      */
  97     public JLightweightFrame() {
  98         super();
  99         copyBufferEnabled = "true".equals(AccessController.
 100             doPrivileged(new GetPropertyAction("jlf.copyBufferEnabled", "true")));
 101 
 102         add(rootPane, BorderLayout.CENTER);
 103         setFocusTraversalPolicy(new LayoutFocusTraversalPolicy());
 104         if (getGraphicsConfiguration().isTranslucencyCapable()) {
 105             setBackground(new Color(0, 0, 0, 0));
 106         }
 107     }
 108 
 109     /**
 110      * Sets the {@link LightweightContent} instance for this frame.
 111      * The {@code JComponent} object returned by the
 112      * {@link LightweightContent#getComponent()} method is immediately
 113      * added to the frame's content pane.
 114      *
 115      * @param content the {@link LightweightContent} instance
 116      */
 117     public void setContent(final LightweightContent content) {
 118         if (content == null) {
 119             System.err.println("JLightweightFrame.setContent: content may not be null!");
 120             return;
 121         }
 122         this.content = content;
 123         this.component = content.getComponent();
 124 
 125         layoutSizeListener = new PropertyChangeListener() {
 126             @Override
 127             public void propertyChange(PropertyChangeEvent e) {
 128                 Dimension d = (Dimension)e.getNewValue();
 129                 
 130                 if ("preferredSize".equals(e.getPropertyName())) {
 131                     content.preferredSizeChanged(d.width, d.height);
 132                     
 133                 } else if ("maximumSize".equals(e.getPropertyName())) {
 134                     content.maximumSizeChanged(d.width, d.height);
 135                     
 136                 } else if ("minimumSize".equals(e.getPropertyName())) {
 137                     content.minimumSizeChanged(d.width, d.height);
 138                 }
 139             }
 140         };
 141         this.component.addPropertyChangeListener("preferredSize", layoutSizeListener);
 142         Dimension d = this.component.getPreferredSize();
 143         content.preferredSizeChanged(d.width, d.height);
 144         
 145         this.component.addPropertyChangeListener("maximumSize", layoutSizeListener);
 146         d = this.component.getMaximumSize();
 147         content.maximumSizeChanged(d.width, d.height);
 148         
 149         this.component.addPropertyChangeListener("minimumSize", layoutSizeListener);
 150         d = this.component.getMinimumSize();
 151         content.minimumSizeChanged(d.width, d.height);
 152         
 153         initInterior();
 154     }
 155 
 156     @Override
 157     public Graphics getGraphics() {
 158         if (bbImage == null) return null;
 159 
 160         Graphics2D g = bbImage.createGraphics();
 161         g.setBackground(getBackground());
 162         g.setColor(getForeground());
 163         g.setFont(getFont());
 164         return g;
 165     }
 166 
 167     /**
 168      * {@inheritDoc}
 169      *
 170      * @see LightweightContent#focusGrabbed()
 171      */
 172     @Override


 227                             if (copyBufferEnabled) {
 228                                 syncCopyBuffer(false, clip.x, clip.y, clip.width, clip.height);
 229                             }
 230                             content.imageUpdated(clip.x, clip.y, clip.width, clip.height);
 231                         }
 232                     });
 233                 } finally {
 234                     if (!copyBufferEnabled) {
 235                         content.paintUnlock();
 236                     }
 237                 }
 238             }
 239             @Override
 240             protected boolean isPaintingOrigin() {
 241                 return true;
 242             }
 243         };
 244         contentPane.setLayout(new BorderLayout());
 245         contentPane.add(component);
 246         setContentPane(contentPane);
 247         
 248         contentPane.addContainerListener(new ContainerAdapter() {
 249             @Override
 250             public void componentRemoved(ContainerEvent e) {
 251                 Component c = JLightweightFrame.this.component;
 252                 if (e.getChild() == c) {
 253                     c.removePropertyChangeListener(layoutSizeListener);
 254                 }
 255             }
 256         });
 257     }
 258 
 259     @SuppressWarnings("deprecation")
 260     @Override public void reshape(int x, int y, int width, int height) {
 261         super.reshape(x, y, width, height);
 262 
 263         if (width == 0 || height == 0) {
 264             return;
 265         }
 266         if (!copyBufferEnabled) {
 267             content.paintLock();
 268         }
 269         try {
 270             if ((bbImage == null) || (width != bbImage.getWidth()) || (height != bbImage.getHeight())) {
 271                 boolean createBB = true;
 272                 int newW = width;
 273                 int newH = height;
 274                 if (bbImage != null) {
 275                     int oldW = bbImage.getWidth();
 276                     int oldH = bbImage.getHeight();