# BodySettings

> Human Generator for Blender documentation. Web version: https://humgen3d.com/docs/api/bodysettings

Reached as: `human.body`

Source: https://github.com/OliverJPost/HumGen3D/blob/main/human/body/body.py#L19

Class to edit body proportions of the human.

The body proportions are changed by changing the values of the LiveKeys stored
in the folder `livekeys/body_proportions`. These are accessible in the API under
`human.body.keys`.

Note: By default Human Generator does not come with shape keys for changing body
proportions, but either by users converting them or by new 3rd party packs adding
them you can expect shape keys too.

For more info on LiveKeys see LiveKeys.

## Attributes

### keys

```python
human.body.keys: list[Union[ShapeKeyItem, LiveKeyItem]]
```

*read-only*

Access ShapeKeyItems and LiveKeyItems for changing body proportions.

Gets all LiveKeyItems and ShapeKeyItems from the global Human Generator
key collection (`Human.keys.all_keys`) that belong to the body proportion
category.

Source: https://github.com/OliverJPost/HumGen3D/blob/main/human/body/body.py#L42

## Methods

### randomize()

```python
human.body.randomize(category: str = ALL, use_locks: bool = False, context: C = None)
```

Randomizes the values of the body keys of this human.

Uses a random value retreived from a normal distrubition with mean 0 and sigma
of 0.5.

Parameters:
- `category` (str, default ALL): Category of keys to randomize. Defaults to ALL.
- `use_locks` (bool, default False): Whether to use locks shown in UI. Defaults to False.
- `context` (C, default None): Blender context

Source: https://github.com/OliverJPost/HumGen3D/blob/main/human/body/body.py#L58

### reset_values()

```python
human.body.reset_values(context: C = None)
```

Reset all body keys to their default values.

Parameters:
- `context` (C, default None): Blender context

Source: https://github.com/OliverJPost/HumGen3D/blob/main/human/body/body.py#L101