SubsurfModifier(Modifier)

base classes — bpy_struct, Modifier

class bpy.types.SubsurfModifier(Modifier)

Subdivision surface modifier

adaptive_object_edge_length

Target object space edge length for adaptive subdivision (in [0.0001, 1000], default 0.01)

Type:

float

adaptive_pixel_size

Target polygon pixel size for adaptive subdivision (in [0.1, 1000], default 1.0)

Type:

float

adaptive_space

How to adaptively subdivide the mesh (default 'PIXEL')

• PIXEL Pixel – Subdivide polygons to reach a specified pixel size on screen.

• OBJECT Object – Subdivide to reach a specified edge length in object space. This is required to use adaptive subdivision for instanced meshes.

Type:

Literal[‘PIXEL’, ‘OBJECT’]

boundary_smooth

Controls how open boundaries are smoothed (default 'ALL')

Type:

Literal[Subdivision Boundary Smooth Items]

levels

Number of subdivisions to perform in the 3D viewport (in [0, 11], default 1)

Type:

int

open_adaptive_subdivision_panel

(default False)

Type:

bool

open_advanced_panel

(default False)

Type:

bool

quality

Accuracy of vertex positions, lower value is faster but less precise (in [1, 10], default 3)

Type:

int

render_levels

Number of subdivisions to perform when rendering (in [0, 11], default 2)

Type:

int

show_only_control_edges

Skip displaying interior subdivided edges (default True)

Type:

bool

subdivision_type

Select type of subdivision algorithm (default 'CATMULL_CLARK')

• CATMULL_CLARK Catmull-Clark – Create a smooth curved surface using the Catmull-Clark subdivision scheme.

• SIMPLE Simple – Subdivide faces without changing shape.

Type:

Literal[‘CATMULL_CLARK’, ‘SIMPLE’]

use_adaptive_subdivision

Adaptively subdivide mesh based on camera distance (default False)

Type:

bool

use_creases

Use mesh crease information to sharpen edges or corners (default True)

Type:

bool

use_custom_normals

Interpolates existing custom normals to resulting mesh (default False)

Type:

bool

use_limit_surface

Place vertices at the surface that would be produced with infinite levels of subdivision (smoothest possible shape) (default True)

Type:

bool

uv_smooth

Controls how smoothing is applied to UVs (default 'PRESERVE_BOUNDARIES')

Type:

Literal[Subdivision Uv Smooth Items]

classmethod bl_rna_get_subclass(id, default=None, /)

Parameters:

• id (str) – The RNA type identifier.

• default (bpy.types.Struct | None) – The value to return when not found.

Returns:

The RNA type or default when not found.

Return type:

bpy.types.Struct

classmethod bl_rna_get_subclass_py(id, default=None, /)

Parameters:

• id (str) – The RNA type identifier.

• default (type | None) – The value to return when not found.

Returns:

The class or default when not found.

Return type:

type

Inherited Properties

bpy_struct.id_data Modifier.name Modifier.type Modifier.show_viewport Modifier.show_render Modifier.show_in_editmode Modifier.show_on_cage

Modifier.show_expanded Modifier.is_active Modifier.use_pin_to_last Modifier.is_override_data Modifier.use_apply_on_spline Modifier.execution_time Modifier.persistent_uid

Inherited Functions

bpy_struct.as_pointer bpy_struct.driver_add bpy_struct.driver_remove bpy_struct.get bpy_struct.id_properties_clear bpy_struct.id_properties_ensure bpy_struct.id_properties_ui 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_from_module bpy_struct.path_resolve bpy_struct.pop bpy_struct.property_overridable_library_set bpy_struct.property_unset bpy_struct.rna_ancestors bpy_struct.type_recast bpy_struct.values Modifier.bl_rna_get_subclass Modifier.bl_rna_get_subclass_py