# LiveKeyItem

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

Inherits from: [KeyItem](https://humgen3d.com/docs/api/keyitem)

Source: https://github.com/OliverJPost/HumGen3D/blob/main/human/keys/keys.py#L214

Item representing a livekey, used for changing the value and converting it.

## Attributes

### path

```python
LiveKeyItem.path
```

Source: https://github.com/OliverJPost/HumGen3D/blob/main/human/keys/keys.py#L226

### value

```python
LiveKeyItem.value: float
```

Get current value from temp_key or stored list on human.

Source: https://github.com/OliverJPost/HumGen3D/blob/main/human/keys/keys.py#L229

### name

```python
LiveKeyItem.name
```

*inherited from KeyItem*

Source: https://github.com/OliverJPost/HumGen3D/blob/main/human/keys/keys.py#L171

### category

```python
LiveKeyItem.category
```

*inherited from KeyItem*

Source: https://github.com/OliverJPost/HumGen3D/blob/main/human/keys/keys.py#L172

### subcategory

```python
LiveKeyItem.subcategory
```

*inherited from KeyItem*

Source: https://github.com/OliverJPost/HumGen3D/blob/main/human/keys/keys.py#L174

## Methods

### set_without_update()

```python
LiveKeyItem.set_without_update(value: float)
```

Set the value of the livekey without updating the human rig and clothing.

This can be used for faster livekey changes. Call
`{human}.keys.update_human_from_key_change()`
when done with setting your livekeys.

Parameters:
- `value` (float): value to set the livekey to

Source: https://github.com/OliverJPost/HumGen3D/blob/main/human/keys/keys.py#L260

### to_shapekey()

```python
LiveKeyItem.to_shapekey(transfer_value: bool = False) -> ShapeKeyItem
```

Convert this livekey to a Blender shape key on the human.

Parameters:
- `transfer_value` (bool, default False): Move the current value of the livekey onto the shape key. The livekey then no longer shapes the basis of the body, the shape key does. Without this the livekey keeps working and the shape key is added at a value of 0.

Returns: [ShapeKeyItem](https://humgen3d.com/docs/api/shapekeyitem) — shapekey item representing the converted livekey

Source: https://github.com/OliverJPost/HumGen3D/blob/main/human/keys/keys.py#L295

### as_bpy()

```python
LiveKeyItem.as_bpy() -> BpyLiveKey
```

Get a pointer to a CollectionProperty item representing this livekey.

This is useful for sliders in the UI.

Returns: BpyLiveKey — CollectionProperty item representing this livekey

Source: https://github.com/OliverJPost/HumGen3D/blob/main/human/keys/keys.py#L355

### draw_prop()

```python
LiveKeyItem.draw_prop(layout: bpy.types.UILayout, value_propname: Literal['value', 'value_limited', 'value_positive_limited'] = 'value') -> bpy.types.UILayout
```

Draw the livekey as a slider in the UI.

Parameters:
- `layout` (bpy.types.UILayout): layout to draw the livekey in
- `value_propname` (Literal['value', 'value_limited', 'value_positive_limited'], default 'value'): name of the property to draw. Defaults to "value".

Returns: bpy.types.UILayout — bpy.types.UILayout: layout with the slider drawn in it, as row.

Source: https://github.com/OliverJPost/HumGen3D/blob/main/human/keys/keys.py#L370