from typing import Tuple
from PIL.Image import Image
from moderngl_window.meta.base import ResourceDescription
[docs]class TextureDescription(ResourceDescription):
"""Describes a texture to load.
Example:
.. code:: python
# Loading a 2d texture
TextureDescription(path='textures/wood.png')
# Loading a 2d texture with mimpmaps with anisotropy
TextureDescription(path='textures/wood.png', mipmap=True, anisotropy=16.0)
# Loading texture array containing 10 layers
TextureDescription(path='textures/tiles.png', layers=10, kind='array')
"""
default_kind = '2d'
resource_type = 'textures'
[docs] def __init__(self, path: str = None, kind: str = None, flip=True, mipmap=False,
mipmap_levels: Tuple[int, int] = None, anisotropy=1.0,
image=None, layers=None,
pos_x: str = None, pos_y: str = None, pos_z: str = None,
neg_x: str = None, neg_y: str = None, neg_z: str = None,
**kwargs):
"""Describes a texture resource
Args:
path (str): path to resource relative to search directories
flip (boolean): Flip the image horizontally
mipmap (bool): Generate mipmaps. Will generate max possible levels unless
`mipmap_levels` is defined.
mipmap_levels (tuple): (base, max_level) controlling mipmap generation.
When defined the `mipmap` parameter is automatically `True`.
anisotropy (float): Number of samples for anisotropic filtering
kind (str): The kind of loader to use
image: PIL image for when loading embedded resources
layers: (int): Number of layers for texture arrays
neg_x (str): Path to negative x texture in a cube map
neg_y (str): Path to negative y texture in a cube map
neg_z (str): Path to negative z texture in a cube map
pos_x (str): Path to positive x texture in a cube map
pop_y (str): Path to positive y texture in a cube map
pos_z (str): Path to positive z texture in a cube map
**kwargs: Any optional/custom attributes
"""
kwargs.update({
"path": path,
"kind": kind,
"flip": flip,
"mipmap": mipmap,
"mipmap_levels": mipmap_levels,
"anisotropy": anisotropy,
"layers": layers,
"image": image,
"neg_x": neg_x,
"neg_y": neg_y,
"neg_z": neg_z,
"pos_x": pos_x,
"pos_y": pos_y,
"pos_z": pos_z,
})
super().__init__(**kwargs)
@property
def flip(self) -> bool:
"""bool: If the image should be flipped horizontally"""
return self._kwargs.get('flip')
@property
def mipmap(self) -> bool:
"""bool: If mipmaps should be generated"""
return self._kwargs.get('mipmap')
@mipmap.setter
def mipmap(self, value: float):
self._kwargs['mipmap'] = value
@property
def mipmap_levels(self) -> Tuple[int, int]:
"""Tuple[int, int]: base, max_level for mipmap generation"""
return self._kwargs.get('mipmap_levels')
@property
def layers(self) -> int:
"""int: Number of layers in texture array"""
return self._kwargs.get('layers')
@property
def anisotropy(self) -> float:
"""float: Number of samples for anisotropic filtering"""
return self._kwargs.get('anisotropy')
@property
def image(self) -> Image:
"""Image: PIL image when loading embedded resources"""
return self._kwargs.get('image')
@property
def pos_x(self):
"""str: Path to positive x in a cubemap texture"""
return self._kwargs.get('pos_x')
@property
def pos_y(self):
"""str: Path to positive y in a cubemap texture"""
return self._kwargs.get('pos_y')
@property
def pos_z(self):
"""str: Path to positive z in a cubemap texture"""
return self._kwargs.get('pos_z')
@property
def neg_x(self):
"""str: Path to negative x in a cubemap texture"""
return self._kwargs.get('neg_x')
@property
def neg_y(self):
"""str: Path to negative y in a cubemap texture"""
return self._kwargs.get('neg_y')
@property
def neg_z(self):
"""str: Path to negative z in a cubemap texture"""
return self._kwargs.get('neg_z')