/*
 * Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF licenses this file to You under the Apache License, Version 2.0
 * (the "License"); you may not use this file except in compliance with
 * the License.  You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

/**
 * Bridges between Apache SIS data stores and Java Image I/O.
 * This package provides {@link org.apache.sis.storage.DataStore} implementations wrapping
 * {@link javax.imageio.ImageReader} and {@link javax.imageio.ImageWriter} instances.
 * The data stores delegate the reading and writing of pixel values to the wrapped reader or writer,
 * completed with an additional source of information for georeferencing the image.
 * A commonly-used convention is the <i>World File</i> format.
 *
 * <h2>Limitations</h2>
 * The World File reader and writer currently have the following limitations.
 * Those limitations may be addressed in a future SIS version.
 *
 * <ul>
 *   <li>Image metadata are ignored. Some metadata that a future version could use are:
 *       title, author, description, creation time, <i>etc.</i></li>
 *   <li>Deferred reading of tiles (using {@code ImageReader.readTileRaster(…)})
 *       is not yet implemented.</li>
 *   <li>Resources have no identifier if the data store is writable,
 *       because image indices are no longer stable identifiers in such case.</li>
 * </ul>
 *
 * <p><b>TODO:</b> avoid extending internal classes directly,
 * then move in a public package with {@code imageio} package name.</p>
 *
 * @author  Martin Desruisseaux (Geomatys)
 *
 * @see <a href="https://en.wikipedia.org/wiki/World_file">World File format description on Wikipedia</a>
 */
package org.apache.sis.storage.image;
