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