# MetaBall(ID)

base classes — `bpy_struct`, `ID`

class `bpy.types.``MetaBall`(ID)

  Metaball data-block to defined blobby surfaces

  `animation_data`

    Animation data for this data-block

    Type: | `AnimData`, (readonly)

  `cycles`

    Cycles mesh settings

    Type: | `CyclesMeshSettings`, (readonly)

  `elements`

    Meta elements

    Type: | `MetaBallElements` `bpy_prop_collection` of `MetaElement`, (readonly)

  `is_editmode`

    True when used in editmode

    Type: | boolean, default False, (readonly)

  `materials`

    Type: | `IDMaterials` `bpy_prop_collection` of `Material`, (readonly)

  `render_resolution`

    Polygonization resolution in rendering

    Type: | float in [0.005, 10000], default 0.2

  `resolution`

    Polygonization resolution in the 3D viewport

    Type: | float in [0.005, 10000], default 0.4

  `texspace_location`

    Texture space location

    Type: | float array of 3 items in [-inf, inf], default (0.0, 0.0, 0.0)

  `texspace_size`

    Texture space size

    Type: | float array of 3 items in [-inf, inf], default (0.0, 0.0, 0.0)

  `threshold`

    Influence of meta elements

    Type: | float in [0, 5], default 0.6

  `update_method`

    Metaball edit update behavior

    - `UPDATE_ALWAYS` Always, While editing, update metaball always.
    - `HALFRES` Half, While editing, update metaball in half resolution.
    - `FAST` Fast, While editing, update metaball without polygonization.
    - `NEVER` Never, While editing, don’t update metaball at all.

    Type: | enum in [‘UPDATE_ALWAYS’, ‘HALFRES’, ‘FAST’, ‘NEVER’], default ‘UPDATE_ALWAYS’

  `use_auto_texspace`

    Adjust active object’s texture space automatically when transforming object

    Type: | boolean, default True

  `transform`(matrix)

    Transform meta elements by a matrix

    Parameters: | matrix (float multi-dimensional array of 4 * 4 items in [-inf, inf]) – Matrix

  `update_gpu_tag`()

    update_gpu_tag

  classmethod `bl_rna_get_subclass`(id, default=None)

    Parameters: | id (string) – The RNA type identifier.
    Returns: | The RNA type or default when not found.
    Return type: | `bpy.types.Struct` subclass

  classmethod `bl_rna_get_subclass_py`(id, default=None)

    Parameters: | id (string) – The RNA type identifier.
    Returns: | The class or default when not found.
    Return type: | type

Inherited Properties

`bpy_struct.id_data` `ID.name` `ID.name_full` `ID.is_evaluated` `ID.original` `ID.users` | `ID.use_fake_user` `ID.tag` `ID.is_library_indirect` `ID.library` `ID.override_library` `ID.preview`

Inherited Functions

`bpy_struct.as_pointer` `bpy_struct.driver_add` `bpy_struct.driver_remove` `bpy_struct.get` `bpy_struct.is_property_hidden` `bpy_struct.is_property_overridable_library` `bpy_struct.is_property_readonly` `bpy_struct.is_property_set` `bpy_struct.items` `bpy_struct.keyframe_delete` `bpy_struct.keyframe_insert` `bpy_struct.keys` `bpy_struct.path_from_id` `bpy_struct.path_resolve` `bpy_struct.pop` | `bpy_struct.property_overridable_library_set` `bpy_struct.property_unset` `bpy_struct.type_recast` `bpy_struct.values` `ID.evaluated_get` `ID.copy` `ID.override_create` `ID.user_clear` `ID.user_remap` `ID.make_local` `ID.user_of_id` `ID.animation_data_create` `ID.animation_data_clear` `ID.update_tag`

References

`bpy.context.meta_ball` `BlendData.metaballs` | `BlendDataMetaBalls.new` `BlendDataMetaBalls.remove`