class_docstr: A plugin to  make old (v2.9) plugins compatible with v3.0
  
  .. depreciated:: 2.9
      `legacy_get_reader` will be removed in a future version of imageio.
      `legacy_get_writer` will be removed in a future version of imageio.
  
  This plugin is a wrapper around the old FormatManager class and exposes
  all the old plugins via the new API. On top of this it has
  ``legacy_get_reader`` and ``legacy_get_writer`` methods to allow using
  it with the v2.9 API.
  
  Methods
  -------
  read(index=None, **kwargs)
      Read the image at position ``index``.
  write(image, **kwargs)
      Write image to the URI.
  iter(**kwargs)
      Iteratively yield images from the given URI.
  get_meta(index=None)
      Return the metadata for the image at position ``index``.
  legacy_get_reader(**kwargs)
      Returns the v2.9 image reader. (depreciated)
  legacy_get_writer(**kwargs)
      Returns the v2.9 image writer. (depreciated)
  
  Examples
  --------
  
  >>> import imageio.v3 as iio
  >>> with iio.imopen("/path/to/image.tiff", "r", legacy_mode=True) as file:
  >>>     reader = file.legacy_get_reader()  # depreciated
  >>>     for im in file.iter():
  >>>         print(im.shape)
class_docstr_tok: ["A","plugin","to","make","old","(","v2.9",")","plugins","compatible","with","v3.0","..","depreciated",":",":","2.9","`","legacy_get_reader","`","will","be","removed","in","a","future","version","of","imageio",".","`","legacy_get_writer","`","will","be","removed","in","a","future","version","of","imageio",".","This","plugin","is","a","wrapper","around","the","old","FormatManager","class","and","exposes","all","the","old","plugins","via","the","new","API",".","On","top","of","this","it","has","``","legacy_get_reader","``","and","``","legacy_get_writer","``","methods","to","allow","using","it","with","the","v2.9","API",".","Methods","--","--","--","-","read","(","index=None",",","*","*","kwargs",")","Read","the","image","at","position","``","index","``",".","write","(","image",",","*","*","kwargs",")","Write","image","to","the","URI",".","iter","(","*","*","kwargs",")","Iteratively","yield","images","from","the","given","URI",".","get_meta","(","index=None",")","Return","the","metadata","for","the","image","at","position","``","index","``",".","legacy_get_reader","(","*","*","kwargs",")","Returns","the","v2.9","image","reader",".","(","depreciated",")","legacy_get_writer","(","*","*","kwargs",")","Returns","the","v2.9","image","writer",".","(","depreciated",")","Examples","--","--","--","--",">",">",">","import","imageio.v3","as","iio",">",">",">","with","iio.imopen","(","``","\/path\/to\/image.tiff","''",",","``","r","''",",","legacy_mode=True",")","as","file",":",">",">",">","reader","=","file.legacy_get_reader","(",")","#","depreciated",">",">",">","for","im","in","file.iter","(",")",":",">",">",">","print","(","im.shape",")"]
docstr: Standardized ndimage metadata.
  
  Parameters
  ----------
  index : int
      The index of the ndimage for which to return properties. If the
      index is out of bounds a ``ValueError`` is raised. If ``None``,
      return the properties for the ndimage stack. If this is impossible,
      e.g., due to shape mismatch, an exception will be raised.
  
  Returns
  -------
  properties : ImageProperties
      A dataclass filled with standardized image metadata.
docstr_tok: ["Standardized","ndimage","metadata",".","Parameters","--","--","--","--","--","index",":","int","The","index","of","the","ndimage","for","which","to","return","properties",".","If","the","index","is","out","of","bounds","a","``","ValueError","``","is","raised",".","If","``","None","``",",","return","the","properties","for","the","ndimage","stack",".","If","this","is","impossible",",","e.g.",",","due","to","shape","mismatch",",","an","exception","will","be","raised",".","Returns","--","--","--","-","properties",":","ImageProperties","A","dataclass","filled","with","standardized","image","metadata","."]
code: def properties(self, index=None):
      """Standardized ndimage metadata.
  
      Parameters
      ----------
      index : int
          The index of the ndimage for which to return properties. If the
          index is out of bounds a ``ValueError`` is raised. If ``None``,
          return the properties for the ndimage stack. If this is impossible,
          e.g., due to shape mismatch, an exception will be raised.
  
      Returns
      -------
      properties : ImageProperties
          A dataclass filled with standardized image metadata.
  
      """
  
      if index is None:
          index = _legacy_default_index(self._format)
  
      # for backwards compatibility ... actually reads pixel data :(
      if index is Ellipsis:
          image = self.read(index=0)
          n_images = self.legacy_get_reader().get_length()
          return ImageProperties(
              shape=(n_images, *image.shape),
              dtype=image.dtype,
              n_images=n_images,
              is_batch=True,
          )
  
      image = self.read(index=index)
      return ImageProperties(
          shape=image.shape,
          dtype=image.dtype,
          is_batch=False,
      )
  
file_path: imageio/imageio/core/legacy_plugin_wrapper.py
imports: from pathlib import Path
  import numpy
  from ..config import known_extensions
  from .request import InitializationError, IOMode
  from .v3_plugin_api import ImageProperties, PluginV3
label_desc: Use image node_id 7 for calling the LegacyPlugin obj's underlying member method code with example usage: obj.properties(index) and returns: ImageProperties, ImageProperties