src.gov.nasa.worldwind.data.BasicDataRasterReaderFactory Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of worldwindx Show documentation

World Wind is a collection of components that interactively display 3D geographic information within Java applications or applets.

There is a newer version: 2.0.0-986

Show newest version

/*
 * Copyright (C) 2012 United States Government as represented by the Administrator of the
 * National Aeronautics and Space Administration.
 * All Rights Reserved.
 */

package gov.nasa.worldwind.data;

import gov.nasa.worldwind.avlist.AVList;
import gov.nasa.worldwind.util.Logging;

/**
 * Implements a {@link gov.nasa.worldwind.data.DataRasterReaderFactory} with a default list of readers. The list
 * includes the following readers:
 *  *  {@link gov.nasa.worldwind.data.RPFRasterReader}
 *  {@link gov.nasa.worldwind.data.DTEDRasterReader}
 *  {@link gov.nasa.worldwind.data.GDALDataRasterReader}
 *  {@link gov.nasa.worldwind.data.GeotiffRasterReader}
 *  {@link gov.nasa.worldwind.data.BILRasterReader}
 *  {@link gov.nasa.worldwind.data.ImageIORasterReader}

 * 
 * 
 * To specify a different factory, set the {@link gov.nasa.worldwind.avlist.AVKey#DATA_RASTER_READER_FACTORY_CLASS_NAME}
 * value in {@link gov.nasa.worldwind.Configuration}, either directly or via the World Wind configuration file. To add
 * readers to the default set, create a subclass of this class, override {@link #findReaderFor(Object,
 * gov.nasa.worldwind.avlist.AVList)}, and specify the new class to the configuration.
 *
 * @author tag
 * @version $Id: BasicDataRasterReaderFactory.java 1511 2013-07-17 17:34:00Z dcollins $
 */
public class BasicDataRasterReaderFactory implements DataRasterReaderFactory
{
    /** The default list of readers. */
    protected DataRasterReader[] readers = new DataRasterReader[]
        {
            // NOTE: Update the javadoc above if this list changes.
            new RPFRasterReader(),
            new DTEDRasterReader(),
            new GDALDataRasterReader(),
            new GeotiffRasterReader(),
            new BILRasterReader(),
            new ImageIORasterReader(),
        };

    /** {@inheritDoc} */
    public DataRasterReader[] getReaders()
    {
        return readers;
    }

    /** {@inheritDoc} */
    public DataRasterReader findReaderFor(Object source, AVList params)
    {
        if (source == null)
        {
            String message = Logging.getMessage("nullValue.SourceIsNull");
            Logging.logger().severe(message);
            throw new IllegalArgumentException(message);
        }

        return findReaderFor(source, params, readers);
    }

    /** {@inheritDoc} */
    public DataRasterReader findReaderFor(Object source, AVList params, DataRasterReader[] readers)
    {
        if (source == null)
        {
            String message = Logging.getMessage("nullValue.SourceIsNull");
            Logging.logger().severe(message);
            throw new IllegalArgumentException(message);
        }

        if (readers == null)
        {
            String message = Logging.getMessage("nullValue.ReaderIsNull");
            Logging.logger().severe(message);
            throw new IllegalArgumentException(message);
        }

        for (DataRasterReader reader : readers)
        {
            if (reader != null && reader.canRead(source, params))
                return reader;
        }

        return null;
    }
}