Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-6633275

Need to support shaped/translucent windows

XMLWordPrintable

    • b12
    • generic, x86, sparc
    • generic, linux, solaris_2.4, windows_95, windows_2000, windows_xp

        The Consumer JRE should support shaped/translucent windows. The following API is proposed for this:

        package com.sun.awt;

        /**
         * <b>WARNING</b>: This class is an implementation detail and only meant
         * for use within the core platform. You should NOT depend upon it! This
         * API may change drastically between dot dot release, and it may even be
         * removed.
         */
        public final class AWTUtilities {

            /**
             * The AWTUtilities class should not be instantiated
             */
            private AWTUtilities() {
            }

            public static enum Translucency {
                /**
                 * Represents image data that is guaranteed to be completely opaque,
                 * meaning that all pixels have an alpha value of 1.0.
                 */
                OPAQUE,

                /**
                 * Represents image data each pixel of which is guaranteed to be either
                 * completely opaque, with an alpha value of 1.0, or completely transparent,
                 * with an alpha value of 0.0.
                 */
                PERPIXEL_OPAQUE,

                /**
                 * Represents image data all of the pixels of which have the same alpha value
                 * between or including 0.0 and 1.0.
                 */
                TRANSLUCENT,

                /**
                 * Represents image data that contains or might contain pixels with arbitrary
                 * alpha values between and including 0.0 and 1.0.
                 */
                PERPIXEL_TRANSLUCENT;
            }


            /**
             * Returns whether the given level of translucency is supported by
             * the current configuration.
             *
             * The translucencyKind argument is one of the OPAQUE, PERPIXEL_OPAQUE,
             * TRANSLUCENT, or PERPIXEL_TRANSLUCENT constants. Passing any other value
             * (or any bitwise combination of the constants) results in
             * return value of false.
             *
             * The level of support depends on the capabilities of the native system.
             *
             * Note that this method may sometimes return the value
             * indicating that the particular level is supported, but
             * the native windowing system may still not support the
             * given level of translucency (due to the bugs in
             * the windowing system).
             *
             * @param translucencyKind a kind of translucency support
             * (either OPAQUE, PERPIXEL_OPAQUE,
             * TRANSLUCENT, or PERPIXEL_TRANSLUCENT)
             * @return whether the given translucency kind is supported
             * @throws IllegalArgumentException if the translucencyKind argument is not one of the defined constants.
             */
            public static boolean isTranslucencySupported(Translucency translucencyKind);


            /**
             * Set the opacity of the window. The opacity is at the range [0..1].
             * Note that setting the opacity level of 0 may or may not disable
             * the mouse event handling on this window. This is
             * a platform-dependent behavior.
             *
             * In order for this method to enable the translucency effect,
             * the isTranslucencySupported() method should indicate that the
             * TRANSLUCENT level of translucency is supported.
             *
             * @param window the window to set the opacity level to
             * @param opacity the opacity level to set to the window
             * @throws NullPointerException if the window argument is null
             * @throws IllegalArgumentException if the opacity is out of the range [0..1]
             * @throws UnsupportedOperationException if the TRANSLUCENT translucency kind is not supported
             */
            public static void setWindowOpacity(Window window, float opacity);

            /**
             * Get the opacity of the window. If the opacity has not
             * yet being set, this method returns 1.0.
             *
             * @param window the window to get the opacity level from
             * @throws NullPointerException if the window argument is null
             */
            public static float getWindowOpacity(Window window);

            /**
             * Returns the object implementing the Shape interface previously
             * set with the call to the setWindowShape() method.
             * If no shape has been set yet, this method returns null.
             * @param window the window to get the shape from
             * @throws NullPointerException if the window argument is null
             */
            public static Shape getWindowShape(Window window);

            /**
             * Sets a shape object for the given window.
             * If the shape argument is null, this methods restores
             * the default shape making the window rectangular.
             * Note that in order to set a shape, the window must be undecorated.
             * @param window the window to set the shape to
             * @param shape the shape to set to the window
             * @throws NullPointerException if the window argument is null
             * @throws UnsupportedOperationException if the PERPIXEL_OPAQUE translucency kind is not supported
             */
            public static void setWindowShape(Window window, Shape shape);

            /**
             * Enables the per-pixel alpha support for the given window.
             * Once the window becomes non-opaque (the isOpaque is set to false),
             * the drawing sub-system is starting to respect the alpha value of each
             * separate pixel. If a pixel gets painted with alpha color component
             * equal to zero, it becomes visually transparent, if the alpha of the
             * pixel is equal to 255, the pixel is fully opaque. Interim values
             * of the alpha color component make the pixel semi-transparent (i.e.
             * translucent).
             * <p>Note that in order for the window to support the per-pixel alpha
             * mode, the window must be created using the GraphicsConfiguration
             * obtained with the {@link getTranslucencyCompatibleGraphicsConfiguration}
             * method.
             * <p>Also note that some native systems enable the per-pixel translucency
             * mode for any window created using the translucency-compatible
             * graphics configuration. However, it is highly recommended to always
             * invoke the setWindowOpaque() method for these windows, at least for the sake of
             * cross-platform compatibility reasons.
             *
             * @param window the window to set the shape to
             * @param isOpaque whether the window must be opaque (true), or translucent (false)
             * @throws NullPointerException if the window argument is null
             * @throws IllegalArgumentException if the window uses a GraphicsConfiguration other than returned by the getTranslucencyCompatibleGraphicsConfiguration() method.
             * @throws UnsupportedOperationException if the PERPIXEL_TRANSLUCENT translucency kind is not supported
             */
            public static void setWindowOpaque(Window window, boolean isOpaque);

            /**
             * Returns whether the window is opaque or translucent.
             *
             * @param window the window to set the shape to
             * @return whether the window is currently opaque (true) or translucent (false)
             * @throws NullPointerException if the window argument is null
             */
            public static boolean isWindowOpaque(Window window);

            /**
             * Returns a GraphicsConfigurations that are capable of displaying translucent windows.
             * All windows that are intended to be used with setWindowOpaque() method
             * must be created using one of the GraphicsConfiguration returned with this method.
             * <p>Note that some native systems enable the per-pixel translucency
             * mode for any window created using the translucency-compatible
             * graphics configuration. However, it is highly recommended to always
             * invoke the setWindowOpaque() method for these windows, at least for the sake of
             * cross-platform compatibility reasons.
             *
             * @return a GraphicsConfiguration capable of displaying translucent windows.
             */
            public static Set<GraphicsConfiguration> getTranslucencyCompatibleGraphicsConfigurations();
        }

              anthony Anthony Petrov (Inactive)
              anthony Anthony Petrov (Inactive)
              Votes:
              0 Vote for this issue
              Watchers:
              2 Start watching this issue

                Created:
                Updated:
                Resolved:
                Imported:
                Indexed: