# large_image_source_openjpeg package

## Submodules

## large_image_source_openjpeg.girder_source module

### *class* large_image_source_openjpeg.girder_source.OpenjpegGirderTileSource(\*args, \*\*kwargs)

Bases: [`OpenjpegFileTileSource`](#large_image_source_openjpeg.OpenjpegFileTileSource), [`GirderTileSource`](../girder_large_image/girder_large_image.html.md#girder_large_image.girder_tilesource.GirderTileSource)

Provides tile access to Girder items with a jp2 file or other files that
the openjpeg library can read.

Initialize the tile class.  See the base class for other available
parameters.

* **Parameters:**
  **path** – a filesystem path for the tile source.

#### cacheName *= 'tilesource'*

#### mayHaveAdjacentFiles(largeImageFile)

#### name *= 'openjpeg'*

## Module contents

### *class* large_image_source_openjpeg.OpenjpegFileTileSource(\*args, \*\*kwargs)

Bases: [`FileTileSource`](../large_image/large_image.tilesource.html.md#large_image.tilesource.base.FileTileSource)

Provides tile access to jp2 files and other files the openjpeg library can
read.

Initialize the tile class.  See the base class for other available
parameters.

* **Parameters:**
  **path** – a filesystem path for the tile source.

#### cacheName *= 'tilesource'*

#### extensions *: dict[str | None, [SourcePriority](../large_image/large_image.html.md#large_image.constants.SourcePriority)]* *= {'j2c': SourcePriority.PREFERRED, 'j2k': SourcePriority.PREFERRED, 'jp2': SourcePriority.PREFERRED, 'jpf': SourcePriority.PREFERRED, 'jpx': SourcePriority.PREFERRED, None: SourcePriority.LOW}*

#### getAssociatedImagesList()

Return a list of associated images.

* **Returns:**
  the list of image keys.

#### getInternalMetadata(\*\*kwargs)

Return additional known metadata about the tile source.  Data returned
from this method is not guaranteed to be in any particular format or
have specific values.

* **Returns:**
  a dictionary of data or None.

#### getNativeMagnification()

Get the magnification at a particular level.

* **Returns:**
  magnification, width of a pixel in mm, height of a pixel in mm.

#### getTile(x, y, z, pilImageAllowed=False, numpyAllowed=False, \*\*kwargs)

Get a tile from a tile source, returning it as an binary image, a PIL
image, or a numpy array.

* **Parameters:**
  * **x** – the 0-based x position of the tile on the specified z level.
    0 is left.
  * **y** – the 0-based y position of the tile on the specified z level.
    0 is top.
  * **z** – the z level of the tile.  May range from [0, self.levels],
    where 0 is the lowest resolution, single tile for the whole source.
  * **pilImageAllowed** – True if a PIL image may be returned.
  * **numpyAllowed** – True if a numpy image may be returned.  ‘always’
    to return a numpy array.
  * **sparseFallback** – if False and a tile doesn’t exist, raise an
    error.  If True, check if a lower resolution tile exists, and, if
    so, interpolate the needed data for this tile.
  * **frame** – the frame number within the tile source.  None is the
    same as 0 for multi-frame sources.
* **Returns:**
  either a numpy array, a PIL image, or a memory object with an
  image file.

#### mimeTypes *: dict[str | None, [SourcePriority](../large_image/large_image.html.md#large_image.constants.SourcePriority)]* *= {'image/j2c': SourcePriority.PREFERRED, 'image/jp2': SourcePriority.PREFERRED, 'image/jpx': SourcePriority.PREFERRED, None: SourcePriority.FALLBACK}*

#### name *= 'openjpeg'*

### large_image_source_openjpeg.canRead(\*args, \*\*kwargs)

Check if an input can be read by the module class.

### large_image_source_openjpeg.open(\*args, \*\*kwargs)

Create an instance of the module class.