Explore platform

datagen.api.catalog.hair

class datagen.api.catalog.hair

This class gives you access to the catalog of hair assets. When you get a 3D asset from this catalog, it comes in the form of a datagen.api.assets.Hair object.

You can query the hair catalog using these functions:

get(self, id: str = None, limit: int = None, **attributes) → Union[Hair, List[Hair]]:

Gets hair assets from the asset catalog.

Parameters:

• id (str) – Optional. Searches for a specific hair asset matching the chosen UUID.

• limit (int) –

  Optional. Caps the number of datagen.api.assets.Hair objects that will be included in the response.

  • If limit=1, returns a single datagen.api.assets.Hair object.

  • If limit>1, returns an object of type List[datagen.api.assets.Hair] (even if there turns out to be only one matching hair asset in that list).

• attributes (Any) – Optional. A dictionary of attributes matching one or more of the properties in datagen.api.catalog.attributes.HairAttributes.

Returns:

The hair asset or assets that match your search query

Return type:

• List[datagen.api.assets.Hair] in the form of a lazy list

• datagen.api.assets.Hair when limit=1 or when an id is provided

count(self, **attributes) → int:

Queries the catalog for the number of hair assets matching a request

Parameters:

attributes (Any) – Optional. A dictionary of attributes matching one or more of the properties in datagen.api.catalog.attributes.HairAttributes.

Returns:

The number of hair assets in the catalog matching your query.

Return type:

int