```
public class IIOImage
extends Object
```
A simple container class to aggregate an image, a set of thumbnail (preview) images, and an object representing metadata associated with the image.
The image data may take the form of either a RenderedImage, or a Raster. Reader methods that return an IIOImage will always return a BufferedImage using the RenderedImage reference. Writer methods that accept an IIOImage will always accept a RenderedImage, and may optionally accept a Raster.
Exactly one of getRenderedImage and getRaster will return a non-null value. Subclasses are responsible for ensuring this behavior.

See Also:
ImageReader.readAll(int, ImageReadParam), ImageReader.readAll(java.util.Iterator), ImageWriter.write(javax.imageio.metadata.IIOMetadata, IIOImage, ImageWriteParam), ImageWriter.write(IIOImage), ImageWriter.writeToSequence(IIOImage, ImageWriteParam), ImageWriter.writeInsert(int, IIOImage, ImageWriteParam)

Field Summary

Fields
Modifier and Type	Field and Description
`protected RenderedImage`	`image` The `RenderedImage` being referenced.
`protected IIOMetadata`	`metadata` An `IIOMetadata` object containing metadata associated with the image.
`protected Raster`	`raster` The `Raster` being referenced.
`protected List<? extends BufferedImage>`	`thumbnails` A `List` of `BufferedImage` thumbnails, or `null`.

Erste Seite von API Java Inhaltsverzeichnis Haut

Constructor Summary

Constructors
Constructor and Description
`IIOImage(Raster raster, List<? extends BufferedImage> thumbnails, IIOMetadata metadata)` Constructs an `IIOImage` containing a `Raster`, and thumbnails and metadata associated with it.
`IIOImage(RenderedImage image, List<? extends BufferedImage> thumbnails, IIOMetadata metadata)` Constructs an `IIOImage` containing a `RenderedImage`, and thumbnails and metadata associated with it.

Erste Seite von API Java Inhaltsverzeichnis Haut

Method Summary

Methods
Modifier and Type	Method and Description
`IIOMetadata`	`getMetadata()` Returns a reference to the current `IIOMetadata` object, or `null` is none is set.
`int`	`getNumThumbnails()` Returns the number of thumbnails stored in this `IIOImage`.
`Raster`	`getRaster()` Returns the currently set `Raster`, or `null` if only a `RenderedImage` is available.
`RenderedImage`	`getRenderedImage()` Returns the currently set `RenderedImage`, or `null` if only a `Raster` is available.
`BufferedImage`	`getThumbnail(int index)` Returns a thumbnail associated with the main image.
`List<? extends BufferedImage>`	`getThumbnails()` Returns the current `List` of thumbnail `BufferedImage`s, or `null` if none is set.
`boolean`	`hasRaster()` Returns `true` if this `IIOImage` stores a `Raster` rather than a `RenderedImage`.
`void`	`setMetadata(IIOMetadata metadata)` Sets the `IIOMetadata` to a new object, or `null`.
`void`	`setRaster(Raster raster)` Sets the current `Raster`.
`void`	`setRenderedImage(RenderedImage image)` Sets the current `RenderedImage`.
`void`	`setThumbnails(List<? extends BufferedImage> thumbnails)` Sets the list of thumbnails to a new `List` of `BufferedImage`s, or to `null`.

Erste Seite von API Java Inhaltsverzeichnis Haut

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - image
```
protected RenderedImage image
```
    The RenderedImage being referenced.
  - raster
```
protected Raster raster
```
    The Raster being referenced.
  - thumbnails
```
protected List<? extends BufferedImage> thumbnails
```
    A List of BufferedImage thumbnails, or null. Non-BufferedImage objects must not be stored in this List.
  - metadata
```
protected IIOMetadata metadata
```
    An IIOMetadata object containing metadata associated with the image.
- Constructor Detail
  - IIOImage
```
public IIOImage(RenderedImage image,
        List<? extends BufferedImage> thumbnails,
        IIOMetadata metadata)
```
    Constructs an IIOImage containing a RenderedImage, and thumbnails and metadata associated with it.
    All parameters are stored by reference.
    The thumbnails argument must either be null or contain only BufferedImage objects.
    
    Parameters:
    image - a RenderedImage.
    thumbnails - a List of BufferedImages, or null.
    metadata - an IIOMetadata object, or null.
    
    Throws:
    
    IllegalArgumentException - if image is null.
  - IIOImage
```
public IIOImage(Raster raster,
        List<? extends BufferedImage> thumbnails,
        IIOMetadata metadata)
```
    Constructs an IIOImage containing a Raster, and thumbnails and metadata associated with it.
    All parameters are stored by reference.
    
    Parameters:
    raster - a Raster.
    thumbnails - a List of BufferedImages, or null.
    metadata - an IIOMetadata object, or null.
    
    Throws:
    
    IllegalArgumentException - if raster is null.
- Method Detail
  - getRenderedImage
```
public RenderedImage getRenderedImage()
```
    Returns the currently set RenderedImage, or null if only a Raster is available.
    
    Returns:
    a RenderedImage, or null.
    See Also:
    setRenderedImage(java.awt.image.RenderedImage)
  - setRenderedImage
```
public void setRenderedImage(RenderedImage image)
```
    Sets the current RenderedImage. The value is stored by reference. Any existing Raster is discarded.
    
    Parameters:
    image - a RenderedImage.
    
    Throws:
    
    IllegalArgumentException - if image is null.
    See Also:
    getRenderedImage()
  - hasRaster
```
public boolean hasRaster()
```
    Returns true if this IIOImage stores a Raster rather than a RenderedImage.
    
    Returns:
    true if a Raster is available.
  - getRaster
```
public Raster getRaster()
```
    Returns the currently set Raster, or null if only a RenderedImage is available.
    
    Returns:
    a Raster, or null.
    See Also:
    setRaster(java.awt.image.Raster)
  - setRaster
```
public void setRaster(Raster raster)
```
    Sets the current Raster. The value is stored by reference. Any existing RenderedImage is discarded.
    
    Parameters:
    raster - a Raster.
    
    Throws:
    
    IllegalArgumentException - if raster is null.
    See Also:
    getRaster()
  - getNumThumbnails
```
public int getNumThumbnails()
```
    Returns the number of thumbnails stored in this IIOImage.
    
    Returns:
    the number of thumbnails, as an int.
  - getThumbnail
```
public BufferedImage getThumbnail(int index)
```
    Returns a thumbnail associated with the main image.
    
    Parameters:
    index - the index of the desired thumbnail image.
    
    Returns:
    a thumbnail image, as a BufferedImage.
    
    Throws:
    
    IndexOutOfBoundsException - if the supplied index is negative or larger than the largest valid index.
    
    ClassCastException - if a non-BufferedImage object is encountered in the list of thumbnails at the given index.
    See Also:
    getThumbnails(), setThumbnails(java.util.List<? extends java.awt.image.BufferedImage>)
  - getThumbnails
```
public List<? extends BufferedImage> getThumbnails()
```
    Returns the current List of thumbnail BufferedImages, or null if none is set. A live reference is returned.
    
    Returns:
    the current List of BufferedImage thumbnails, or null.
    See Also:
    getThumbnail(int), setThumbnails(java.util.List<? extends java.awt.image.BufferedImage>)
  - setThumbnails
```
public void setThumbnails(List<? extends BufferedImage> thumbnails)
```
    Sets the list of thumbnails to a new List of BufferedImages, or to null. The reference to the previous List is discarded.
    The thumbnails argument must either be null or contain only BufferedImage objects.
    
    Parameters:
    thumbnails - a List of BufferedImage thumbnails, or null.
    See Also:
    getThumbnail(int), getThumbnails()
  - getMetadata
```
public IIOMetadata getMetadata()
```
    Returns a reference to the current IIOMetadata object, or null is none is set.
    
    Returns:
    an IIOMetadata object, or null.
    See Also:
    setMetadata(javax.imageio.metadata.IIOMetadata)
  - setMetadata
```
public void setMetadata(IIOMetadata metadata)
```
    Sets the IIOMetadata to a new object, or null.
    
    Parameters:
    metadata - an IIOMetadata object, or null.
    See Also:
    getMetadata()

Deutsche Übersetzung

Sie haben gebeten, diese Seite auf Deutsch zu besuchen. Momentan ist nur die Oberfläche übersetzt, aber noch nicht der gesamte Inhalt.

Wenn Sie mir bei Übersetzungen helfen wollen, ist Ihr Beitrag willkommen. Alles, was Sie tun müssen, ist, sich auf der Website zu registrieren und mir eine Nachricht zu schicken, in der Sie gebeten werden, Sie der Gruppe der Übersetzer hinzuzufügen, die Ihnen die Möglichkeit gibt, die gewünschten Seiten zu übersetzen. Ein Link am Ende jeder übersetzten Seite zeigt an, dass Sie der Übersetzer sind und einen Link zu Ihrem Profil haben.

Vielen Dank im Voraus.

Dokument erstellt 11/06/2005, zuletzt geändert 04/03/2020
Quelle des gedruckten Dokuments:https://www.gaudry.be/de/java-api-rf-javax/imageio/IIOImage.html

Die Infobro ist eine persönliche Seite, deren Inhalt in meiner alleinigen Verantwortung liegt. Der Text ist unter der CreativeCommons-Lizenz (BY-NC-SA) verfügbar. Weitere Informationen auf die Nutzungsbedingungen und dem Autor.

Referenzen

Manuel PHP : https://docs.oracle.com

Diese Verweise und Links verweisen auf Dokumente, die während des Schreibens dieser Seite konsultiert wurden, oder die zusätzliche Informationen liefern können, aber die Autoren dieser Quellen können nicht für den Inhalt dieser Seite verantwortlich gemacht werden.
Der Autor Diese Website ist allein dafür verantwortlich, wie die verschiedenen Konzepte und Freiheiten, die mit den Nachschlagewerken gemacht werden, hier dargestellt werden. Denken Sie daran, dass Sie mehrere Quellinformationen austauschen müssen, um das Risiko von Fehlern zu reduzieren.

Inhaltsverzeichnis Haut

Class IIOImage

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

image

raster

thumbnails

metadata

Constructor Detail

IIOImage

IIOImage

Method Detail

getRenderedImage

setRenderedImage

hasRaster

getRaster

setRaster

getNumThumbnails

getThumbnail

getThumbnails

setThumbnails

getMetadata

setMetadata

Referenzen