[JAVA3D] NewTextureLoader class (no image observer)

[Dennis J Bouvier]

For those interested in a texture loader without having to
have the image observers passed around in your program here
is an alternative.

The NewTextureLoader class extends TextureLoader creating constructors
that don't require an image observer.  The technique is to supply
a single awt.component to server as the image observer for all
NewTextureLoader objects.  This is done with the setImageObserver
method for the class.

Attached is the javadoc for the class.

Example uses of this class and much more information on using
textures in the Java 3D API is in Chapter 7 of The Java 3D API
Tutorial (soon to be published).

Find the Java 3D Tutorial, "Getting Started with the Java 3D API", at
java.sun.com/products/javamedia/3d/collateral

--
-----
Dennis J Bouvier
[EMAIL PROTECTED]
Find the Java 3D Tutorial "Getting Started with the Java 3D API" at
java.sun.com/products/javamedia/3d/collateral

Title: : Class NewTextureLoader

Class  Deprecated   PREV CLASS   NEXT CLASS FRAMES    NO FRAMES SUMMARY:  INNER | FIELD | CONSTR | METHOD DETAIL:  FIELD | CONSTR | METHOD Class NewTextureLoader java.lang.Object | +--com.sun.j3d.utils.image.TextureLoader | +--NewTextureLoader public class NewTextureLoader extends com.sun.j3d.utils.image.TextureLoader Fields inherited from class com.sun.j3d.utils.image.TextureLoader GENERATE_MIPMAP   Constructor Summary NewTextureLoader(java.awt.Image image)           Constructs a NewTextureLoader object loading the specified iamge in default (RGBA) format. NewTextureLoader(java.awt.Image image, int flags)           Constructs a NewTextureLoader object loading the specified image and option flags in the default (RGBA) format. NewTextureLoader(java.awt.Image image, java.lang.String format)           Constructs a NewTextureLoader object loading the specified file using the specified format. NewTextureLoader(java.awt.Image image, java.lang.String format, int flags)           Constructs a NewTextureLoader object loading the specified file with specified format and flags. NewTextureLoader(java.lang.String fname)           Constructs a NewTextureLoader object loading the specified file using the default format (RGBA). NewTextureLoader(java.lang.String fname, int flags)           Constructs a NewTextureLoader object loading the specified file with the specified flags. NewTextureLoader(java.lang.String fname, java.lang.String format)           Constructs a NewTextureLoader object loading the specified file using the specified format. NewTextureLoader(java.lang.String fname, java.lang.String format, int flags)           Constructs a NewTextureLoader object loading the specified file using the specified format and flags. NewTextureLoader(java.net.URL url)           Constructs a NewTextureLoader object loading the specified URL using the default format. NewTextureLoader(java.net.URL url, int flags)           Constructs a NewTextureLoader object loading the specified URL using the specified flags. NewTextureLoader(java.net.URL url, java.lang.String format)           Constructs a NewTextureLoader object loading the specified URL using the specified format. NewTextureLoader(java.net.URL url, java.lang.String format, int flags)           Constructs a NewTextureLoader object loading the specified URL using the specified format and flags.   Method Summary static java.awt.Component getImageObserver()           Retreve the object used as the image observer for NewTextureLoader objects. static void setImageObserver(java.awt.Component imageObserver)           Specify an object to server as the image observer.   Methods inherited from class com.sun.j3d.utils.image.TextureLoader getImage, getScaledImage, getScaledImage, getTexture   Methods inherited from class java.lang.Object clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait   Constructor Detail NewTextureLoader public NewTextureLoader(java.awt.Image image) Constructs a NewTextureLoader object loading the specified iamge in default (RGBA) format. The an image observer must be set using the setImageObserver() method before using this constructor. Parameters: image - the image object to load NewTextureLoader public NewTextureLoader(java.awt.Image image, int flags) Constructs a NewTextureLoader object loading the specified image and option flags in the default (RGBA) format. The an image observer must be set using the setImageObserver() method before using this constructor. Parameters: image - the image object to load flags - the flags to use in construction (e.g. generate mipmap) NewTextureLoader public NewTextureLoader(java.awt.Image image, java.lang.String format) Constructs a NewTextureLoader object loading the specified file using the specified format. The an image observer must be set using the setImageObserver() method before using this constructor. Parameters: image - the image object to load format - specificaiton of which channels to use (e.g. RGB) NewTextureLoader public NewTextureLoader(java.awt.Image image, java.lang.String format, int flags) Constructs a NewTextureLoader object loading the specified file with specified format and flags. The an image observer must be set using the setImageObserver() method before using this constructor. Parameters: image - the image object to load format - specificaiton of which channels to use (e.g. RGB) flags - the flags to use in construction (e.g. generate mipmap) NewTextureLoader public NewTextureLoader(java.lang.String fname) Constructs a NewTextureLoader object loading the specified file using the default format (RGBA). The an image observer must be set using the setImageObserver() method before using this constructor. Parameters: fname - the name of the file to load NewTextureLoader public NewTextureLoader(java.lang.String fname, int flags) Constructs a NewTextureLoader object loading the specified file with the specified flags. The an image observer must be set using the setImageObserver() method before using this constructor. Parameters: fname - the name of the file to load flags - the flags to use in construction (e.g. generate mipmap) NewTextureLoader public NewTextureLoader(java.lang.String fname, java.lang.String format) Constructs a NewTextureLoader object loading the specified file using the specified format. The an image observer must be set using the setImageObserver() method before using this constructor. Parameters: fname - the name of the file to load format - specificaiton of which channels to use (e.g. RGB) NewTextureLoader public NewTextureLoader(java.lang.String fname, java.lang.String format, int flags) Constructs a NewTextureLoader object loading the specified file using the specified format and flags. The an image observer must be set using the setImageObserver() method before using this constructor. Parameters: fname - the name of the file to load format - specificaiton of which channels to use (e.g. RGB) flags - the flags to use in construction (e.g. generate mipmap) NewTextureLoader public NewTextureLoader(java.net.URL url) Constructs a NewTextureLoader object loading the specified URL using the default format. The an image observer must be set using the setImageObserver() method before using this constructor. Parameters: url - specifies the URL of the image to load NewTextureLoader public NewTextureLoader(java.net.URL url, int flags) Constructs a NewTextureLoader object loading the specified URL using the specified flags. The an image observer must be set using the setImageObserver() method before using this constructor. Parameters: url - specifies the URL of the image to load flags - the flags to use in construction (e.g. generate mipmap) NewTextureLoader public NewTextureLoader(java.net.URL url, java.lang.String format) Constructs a NewTextureLoader object loading the specified URL using the specified format. The an image observer must be set using the setImageObserver() method before using this constructor. Parameters: url - specifies the URL of the image to load format - specificaiton of which channels to use (e.g. RGB) NewTextureLoader public NewTextureLoader(java.net.URL url, java.lang.String format, int flags) Constructs a NewTextureLoader object loading the specified URL using the specified format and flags. The an image observer must be set using the setImageObserver() method before using this constructor. Parameters: url - specifies the URL of the image to load format - specificaiton of which channels to use (e.g. RGB) flags - the flags to use in construction (e.g. generate mipmap) Method Detail setImageObserver public static void setImageObserver(java.awt.Component imageObserver) Specify an object to server as the image observer. Use this method once before constructing any texture loaders. Parameters: imageObserver - the object to be used in subsequent NewTextureLoader constuctions getImageObserver public static java.awt.Component getImageObserver() Retreve the object used as the image observer for NewTextureLoader objects. Use this method when the image observer is needed. Returns: the object used in as the image observer in subsequent NewTextureLoader constuctions  Class  Deprecated   PREV CLASS   NEXT CLASS FRAMES    NO FRAMES SUMMARY:  INNER | FIELD | CONSTR | METHOD DETAIL:  FIELD | CONSTR | METHOD

/*
 *      @(#)NewTextureLoades.java 1.0 99/10/21
 *
 * Copyright (c) 1996-1999 Sun Microsystems, Inc. All Rights Reserved.
 *
 * Sun grants you ("Licensee") a non-exclusive, royalty free, license to use,
 * modify and redistribute this software in source and binary code form,
 * provided that i) this copyright notice and license appear on all copies of
 * the software; and ii) Licensee does not utilize the software in a manner
 * which is disparaging to Sun.
 *
 * This software is provided "AS IS," without a warranty of any kind. ALL
 * EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY
 * IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR
 * NON-INFRINGEMENT, ARE HEREBY EXCLUDED. SUN AND ITS LICENSORS SHALL NOT BE
 * LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF USING, MODIFYING
 * OR DISTRIBUTING THE SOFTWARE OR ITS DERIVATIVES. IN NO EVENT WILL SUN OR ITS
 * LICENSORS BE LIABLE FOR ANY LOST REVENUE, PROFIT OR DATA, OR FOR DIRECT,
 * INDIRECT, SPECIAL, CONSEQUENTIAL, INCIDENTAL OR PUNITIVE DAMAGES, HOWEVER
 * CAUSED AND REGARDLESS OF THE THEORY OF LIABILITY, ARISING OUT OF THE USE OF
 * OR INABILITY TO USE SOFTWARE, EVEN IF SUN HAS BEEN ADVISED OF THE
 * POSSIBILITY OF SUCH DAMAGES.
 *
 * This software is not designed or intended for use in on-line control of
 * aircraft, air traffic, aircraft navigation or aircraft communications; or in
 * the design, construction, operation or maintenance of any nuclear
 * facility. Licensee represents and warrants that it will not use or
 * redistribute the Software for such purposes.
 */

/**
 *  A texture loading utility that doesn't require an image observer
 *  for constructing objects.  This class extends the TextureLoader
 *  class of the com.sun.j3d.utils.image package.
 *
 */

import com.sun.j3d.utils.image.TextureLoader;
import javax.media.j3d.*;
import javax.vecmath.*;


public class NewTextureLoader extends TextureLoader {
    static java.awt.Component observer;

    /**
     * Specify an object to server as the image observer.
     * Use this method once before constructing any texture loaders.
     * @param imageObserver     the object to be used in subsequent
     * NewTextureLoader constuctions
     */
    public static void setImageObserver(java.awt.Component imageObserver){
        observer = imageObserver;
    }

    /**
     * Retreve the object used as the image observer for NewTextureLoader
     * objects.
     * Use this method when the image observer is needed.
     * @return the object used in as the image observer in subsequent
     * NewTextureLoader constuctions
     */
    public static java.awt.Component getImageObserver(){
        return observer;
    }

    // constructors without an image observer argument
    /**
     * Constructs a NewTextureLoader object loading the specified iamge in
     * default (RGBA) format.
     * The an image observer must be set using the setImageObserver() method
     * before using this constructor.
     * @param image     the image object to load
     */
    public NewTextureLoader(java.awt.Image image){
        super(image, observer);
    }

    /**
     * Constructs a NewTextureLoader object loading the specified image
     * and option flags in the default (RGBA) format.
     * The an image observer must be set using the setImageObserver() method
     * before using this constructor.
     * @param image     the image object to load
     * @param flags     the flags to use in construction (e.g. generate mipmap)
     */
    public NewTextureLoader(java.awt.Image image, int flags){
        super( image, flags, observer);
    }

    /**
     * Constructs a NewTextureLoader object loading the specified file
     * using the specified format.
     * The an image observer must be set using the setImageObserver() method
     * before using this constructor.
     * @param image     the image object to load
     * @param format    specificaiton of which channels to use (e.g. RGB)
     */
    public NewTextureLoader(java.awt.Image image, java.lang.String format){
        super( image, format, observer);
    }

    /**
     * Constructs a NewTextureLoader object loading the specified file
     * with specified format and flags.
     * The an image observer must be set using the setImageObserver() method
     * before using this constructor.
     * @param image     the image object to load
     * @param format    specificaiton of which channels to use (e.g. RGB)
     * @param flags     the flags to use in construction (e.g. generate mipmap)
     */
    public NewTextureLoader(java.awt.Image image, java.lang.String format, int flags){
        super( image, format, flags, observer);
    }

    /**
     * Constructs a NewTextureLoader object loading the specified file
     * using the default format (RGBA).
     * The an image observer must be set using the setImageObserver() method
     * before using this constructor.
     * @param fname     the name of the file to load
     */
    public NewTextureLoader(java.lang.String fname){
        super( fname, observer);
    }

    /**
     * Constructs a NewTextureLoader object loading the specified file
     * with the specified flags.
     * The an image observer must be set using the setImageObserver() method
     * before using this constructor.
     * @param fname     the name of the file to load
     * @param flags     the flags to use in construction (e.g. generate mipmap)
     */
    public NewTextureLoader(java.lang.String fname, int flags){
        super( fname, flags, observer);
    }

    /**
     * Constructs a NewTextureLoader object loading the specified file
     * using the specified format.
     * The an image observer must be set using the setImageObserver() method
     * before using this constructor.
     * @param fname     the name of the file to load
     * @param format    specificaiton of which channels to use (e.g. RGB)
     */
    public NewTextureLoader(java.lang.String fname, java.lang.String format){
        super( fname, format, observer);
    }

    /**
     * Constructs a NewTextureLoader object loading the specified file
     * using the specified format and flags.
     * The an image observer must be set using the setImageObserver() method
     * before using this constructor.
     * @param fname     the name of the file to load
     * @param format    specificaiton of which channels to use (e.g. RGB)
     * @param flags     the flags to use in construction (e.g. generate mipmap)
     */
    public NewTextureLoader(java.lang.String fname, java.lang.String format, int 
flags){
        super( fname, format, flags, observer);
    }

    /**
     * Constructs a NewTextureLoader object loading the specified URL
     * using the default format.
     * The an image observer must be set using the setImageObserver() method
     * before using this constructor.
     * @param url       specifies the URL of the image to load
     */
    public NewTextureLoader(java.net.URL url){
        super(url, observer);
    }

    /**
     * Constructs a NewTextureLoader object loading the specified URL
     * using the specified flags.
     * The an image observer must be set using the setImageObserver() method
     * before using this constructor.
     * @param url       specifies the URL of the image to load
     * @param flags     the flags to use in construction (e.g. generate mipmap)
     */
    public NewTextureLoader(java.net.URL url, int flags){
        super(url, flags, observer);
    }

    /**
     * Constructs a NewTextureLoader object loading the specified URL
     * using the specified format.
     * The an image observer must be set using the setImageObserver() method
     * before using this constructor.
     * @param url       specifies the URL of the image to load
     * @param format    specificaiton of which channels to use (e.g. RGB)
     */
    public NewTextureLoader(java.net.URL url, java.lang.String format){
        super(url, format, observer);
    }

    /**
     * Constructs a NewTextureLoader object loading the specified URL
     * using the specified format and flags.
     * The an image observer must be set using the setImageObserver() method
     * before using this constructor.
     * @param url       specifies the URL of the image to load
     * @param format    specificaiton of which channels to use (e.g. RGB)
     * @param flags     the flags to use in construction (e.g. generate mipmap)
     */
    public NewTextureLoader(java.net.URL url, java.lang.String format, int flags){
        super(url, format, flags, observer);
    }

} // end of TexturedPlane class