def import_landmark_files(pattern, max_landmarks=None, verbose=False):
r"""Multiple landmark file import generator.
Note that this is a generator function.
Parameters
----------
pattern : `str`
The glob path pattern to search for images.
max_landmark_files : positive `int`, optional
If not ``None``, only import the first ``max_landmark_files`` found.
Else, import all.
verbose : `bool`, optional
If ``True`` progress of the importing will be dynamically reported.
Yields
------
:map:`LandmarkGroup`
Landmark found to match the glob pattern provided.
Raises
------
ValueError
If no landmarks are found at the provided glob.
"""
for asset in _import_glob_generator(pattern,
mesh_landmark_types,
max_assets=max_landmarks,
verbose=verbose):
yield asset
def import_landmark_files(pattern, max_landmarks=None, verbose=False):
r"""Multiple landmark file import generator.
Note that this is a generator function.
Parameters
----------
pattern : `str`
The glob path pattern to search for images.
max_landmark_files : positive `int`, optional
If not ``None``, only import the first ``max_landmark_files`` found.
Else, import all.
verbose : `bool`, optional
If ``True`` progress of the importing will be dynamically reported.
Yields
------
:map:`LandmarkGroup`
Landmark found to match the glob pattern provided.
Raises
------
ValueError
If no landmarks are found at the provided glob.
"""
for asset in _import_glob_generator(pattern, mesh_landmark_types, max_assets=max_landmarks, verbose=verbose):
yield asset
def import_meshes(pattern,
max_meshes=None,
landmark_resolver=same_name,
textures=True,
verbose=False):
r"""Multiple mesh import generator.
Makes it's best effort to import and attach relevant related
information such as landmarks. It searches the directory for files that
begin with the same filename and end in a supported extension.
If texture coordinates and a suitable texture are found the object
returned will be a :map:`TexturedTriMesh`.
Note that this is a generator function. This allows for pre-processing
of data to take place as data is imported (e.g. cleaning meshes
as they are imported for memory efficiency).
Parameters
----------
pattern : `str`
The glob path pattern to search for textures and meshes.
max_meshes : positive `int`, optional
If not ``None``, only import the first ``max_meshes`` meshes found.
Else, import all.
landmark_resolver : `function`, optional
This function will be used to find landmarks for the
mesh. The function should take one argument (the mesh itself) and
return a dictionary of the form ``{'group_name': 'landmark_filepath'}``
Default finds landmarks with the same name as the mesh file.
texture : `bool`, optional
If ``False``, don't search for textures.
verbose : `bool`, optional
If ``True`` progress of the importing will be dynamically reported.
Yields
------
:map:`TriMesh` or :map:`TexturedTriMesh`
Meshes found to match the glob pattern provided.
Raises
------
ValueError
If no meshes are found at the provided glob.
"""
kwargs = {'texture': textures}
for asset in _import_glob_generator(pattern,
mesh_types,
max_assets=max_meshes,
landmark_resolver=landmark_resolver,
landmark_ext_map=mesh_landmark_types,
importer_kwargs=kwargs,
verbose=verbose):
yield asset
def import_meshes(pattern, max_meshes=None, landmark_resolver=same_name, textures=True, verbose=False):
r"""Multiple mesh import generator.
Makes it's best effort to import and attach relevant related
information such as landmarks. It searches the directory for files that
begin with the same filename and end in a supported extension.
If texture coordinates and a suitable texture are found the object
returned will be a :map:`TexturedTriMesh`.
Note that this is a generator function. This allows for pre-processing
of data to take place as data is imported (e.g. cleaning meshes
as they are imported for memory efficiency).
Parameters
----------
pattern : `str`
The glob path pattern to search for textures and meshes.
max_meshes : positive `int`, optional
If not ``None``, only import the first ``max_meshes`` meshes found.
Else, import all.
landmark_resolver : `function`, optional
This function will be used to find landmarks for the
mesh. The function should take one argument (the mesh itself) and
return a dictionary of the form ``{'group_name': 'landmark_filepath'}``
Default finds landmarks with the same name as the mesh file.
texture : `bool`, optional
If ``False``, don't search for textures.
verbose : `bool`, optional
If ``True`` progress of the importing will be dynamically reported.
Yields
------
:map:`TriMesh` or :map:`TexturedTriMesh`
Meshes found to match the glob pattern provided.
Raises
------
ValueError
If no meshes are found at the provided glob.
"""
kwargs = {"texture": textures}
for asset in _import_glob_generator(
pattern,
mesh_types,
max_assets=max_meshes,
landmark_resolver=landmark_resolver,
landmark_ext_map=mesh_landmark_types,
importer_kwargs=kwargs,
verbose=verbose,
):
yield asset
