Database¶

class Database¶

property read_only¶

The database read only status.

Type: bool, read-only

property active_material_group¶

The active material group.

Type: MaterialGroup
Raises: ReadOnlyError -- If Database is in read only mode.

property active_texture_group¶

The active texture group.

Type: TextureGroup
Raises: ReadOnlyError -- If Database is in read only mode.

property active_background_group¶

The active background group.

Type: BackgroundGroup
Raises: ReadOnlyError -- If Database is in read only mode.

property active_environment_group¶

The active environment group.

Type: EnvironmentGroup
Raises: ReadOnlyError -- If Database is in read only mode.

property active_overlay_group¶

The active overlay group.

Type: OverlayGroup
Raises: ReadOnlyError -- If Database is in read only mode.

property active_postprocess_group¶

The active postprocess group.

Type: PostprocessGroup
Raises: ReadOnlyError -- If Database is in read only mode.

property active_sensor_group¶

The active sensor group.

Type: SensorGroup
Raises: ReadOnlyError -- If Database is in read only mode.

property active_material¶

The active material.

Type: Material or None
Raises: ReadOnlyError -- If Database is in read only mode.

property active_background¶

The active background.

Type: Background or None
Raises: ReadOnlyError -- If Database is in read only mode.

property active_environment¶

The active environment.

Type: Environment or None
Raises: ReadOnlyError -- If Database is in read only mode.

property active_overlay¶

The active overlay.

Type: Overlay or None
Raises: ReadOnlyError -- If Database is in read only mode.

property active_postprocess¶

The active postprocess.

Type: Postprocess or None
Raises: ReadOnlyError -- If Database is in read only mode.

property active_sensor¶

The active sensor.

Type: Sensor or None
Raises: ReadOnlyError -- If Database is in read only mode.

save()¶

Save the database.

Returns: True if successful.
Return type: bool
Raises: ReadOnlyError -- If Database is in read only mode.

save_and_clean(save_cache)¶

Save and clean the database.

Parameters: save_cache (bool) -- Whether to save the cache or not.
Returns: True if successful.
Return type: bool
Raises: ReadOnlyError -- If Database is in read only mode.

save_as(filename, save_cache)¶

Save the database to another file.

Parameters

filename (str) -- The new database filename.
save_cache (bool) -- Whether to save the cache or not.

Returns

True if successful.

Return type

bool

Raises

ReadOnlyError -- If Database is in read only mode.

close()¶: Close the database

Note

The database is not automatically saved. Call save() or save_as() before close() if you want to do so.

find_camera(id)¶

Find a camera by id.

Parameters: id (str) -- Camera id to find.
Returns: The camera found or None if not found.
Return type: Camera or None

list_cameras(recursive = True)¶

List the cameras of the database.

Parameters: recursive (bool) -- If True, list all cameras in the database, otherwise only the root cameras are returned.
Returns: The list of cameras in the database.
Return type: list(Camera)

create_camera(group = None)¶

Create a camera.

Parameters: group (CameraGroup or None) -- Group of the new camera, or None to put the camera at the root of the hierarchy.
Returns: The new camera.
Return type: Camera
Raises: ReadOnlyError -- If Database is in read only mode.

find_camera_group(id)¶

Find a camera group by id.

Parameters: id (str) -- Camera group id to find.
Returns: The camera group found or None if not found.
Return type: CameraGroup or None

list_camera_groups(recursive = True)¶

List the camera groups of the database.

Parameters: recursive (bool) -- If True, list all camera groups in the database, otherwise only the root groups are returned.
Returns: The list of camera groups in the database.
Return type: list(CameraGroup)

create_camera_group(name, parent_group = None)¶

Create a camera group.

Parameters

name (str) -- Name of the new group.
parent_group (CameraGroup or None) -- Parent group of the new group, or None to put the group at the root of the hierarchy.

Returns

The new group.

Return type

CameraGroup

Raises

ReadOnlyError -- If Database is in read only mode.

find_model(id)¶

Find a model by id.

Parameters: id (str) -- Model id to find.
Returns: The model found or None if not found.
Return type: Model or None

list_models()¶

List the models of the database.

Returns: The list of models in the database.
Return type: list(Model)

create_material_group(name)¶

Create a new material group.

Parameters: name (str) -- Name of the group.
Returns: The newly created group.
Return type: MaterialGroup
Raises: ReadOnlyError -- If Database is in read only mode.

find_material_group(id)¶

Find a material group by id.

Parameters: id (str) -- Material group id to find.
Returns: The material group found or None if not found.
Return type: MaterialGroup or None

list_material_groups()¶

List the material groups of the database.

Returns: The list of material groups in the database.
Return type: list(MaterialGroup)

create_texture_group(name)¶

Create a new texture group.

Parameters: name (str) -- Name of the group.
Returns: The newly created group.
Return type: TextureGroup
Raises: ReadOnlyError -- If Database is in read only mode.

find_texture_group(id)¶

Find a texture group by id.

Parameters: id (str) -- Texture group id to find.
Returns: The texture group found or None if not found.
Return type: TextureGroup or None

list_texture_groups()¶

List the texture groups of the database.

Returns: The list of texture groups in the database.
Return type: list(TextureGroup)

create_background_group(name)¶

Create a new background group.

Parameters: name (str) -- Name of the group.
Returns: The newly created group.
Return type: BackgroundGroup
Raises: ReadOnlyError -- If Database is in read only mode.

find_background_group(id)¶

Find a background group by id.

Parameters: id (str) -- Background group id to find.
Returns: The background group found or None if not found.
Return type: BackgroundGroup or None

list_background_groups()¶

List the background groups of the database.

Returns: The list of background groups in the database.
Return type: list(BackgroundGroup)

create_environment_group(name)¶

Create a new environment group.

Parameters: name (str) -- Name of the group.
Returns: The newly created group.
Return type: EnvironmentGroup
Raises: ReadOnlyError -- If Database is in read only mode.

find_environment_group(id)¶

Find a environment group by id.

Parameters: id (str) -- Environment group id to find.
Returns: The environment group found or None if not found.
Return type: EnvironmentGroup or None

list_environment_groups()¶

List the environment groups of the database.

Returns: The list of environment groups in the database.
Return type: list(EnvironmentGroup)

create_overlay_group(name)¶

Create a new overlay group.

Parameters: name (str) -- Name of the group.
Returns: The newly created group.
Return type: OverlayGroup
Raises: ReadOnlyError -- If Database is in read only mode.

find_overlay_group(id)¶

Find a overlay group by id.

Parameters: id (str) -- Overlay group id to find.
Returns: The overlay group found or None if not found.
Return type: OverlayGroup or None

list_overlay_groups()¶

List the overlay groups of the database.

Returns: The list of overlay groups in the database.
Return type: list(OverlayGroup)

create_postprocess_group(name)¶

Create a new postprocess group.

Parameters: name (str) -- Name of the group.
Returns: The newly created group.
Return type: PostprocessGroup
Raises: ReadOnlyError -- If Database is in read only mode.

find_postprocess_group(id)¶

Find a postprocess group by id.

Parameters: id (str) -- Postprocess group id to find.
Returns: The postprocess group found or None if not found.
Return type: PostprocessGroup or None

list_postprocess_groups()¶

List the postprocess groups of the database.

Returns: The list of postprocess groups in the database.
Return type: list(PostprocessGroup)

create_sensor_group(name)¶

Create a new sensor group.

Parameters: name (str) -- Name of the group.
Returns: The newly created group.
Return type: SensorGroup
Raises: ReadOnlyError -- If Database is in read only mode.

find_sensor_group(id)¶

Find a sensor group by id.

Parameters: id (str) -- Sensor group id to find.
Returns: The sensor group found or None if not found.
Return type: SensorGroup or None

list_sensor_groups()¶

List the sensor groups of the database.

Returns: The list of sensor groups in the database.
Return type: list(SensorGroup)