MultiresModifier(Modifier)
==========================

.. currentmodule:: bpy.types

base classes --- :class:`bpy_struct`, :class:`Modifier`

.. class:: MultiresModifier(Modifier)

   Multiresolution mesh modifier

   .. attribute:: boundary_smooth

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

      :type: Literal[:ref:`rna_enum_subdivision_boundary_smooth_items`]

   .. attribute:: filepath

      Path to external displacements file (default "", never None, blend relative ``//`` prefix supported)

      :type: str

   .. data:: is_external

      Store multires displacements outside the .blend file, to save memory (default False, readonly)

      :type: bool

   .. attribute:: levels

      Number of subdivisions to use in the viewport (in [0, 255], default 0)

      :type: int

   .. attribute:: quality

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

      :type: int

   .. attribute:: render_levels

      The subdivision level visible at render time (in [0, 255], default 0)

      :type: int

   .. attribute:: sculpt_levels

      Number of subdivisions to use in sculpt mode (in [0, 255], default 0)

      :type: int

   .. attribute:: show_only_control_edges

      Skip drawing/rendering of interior subdivided edges (default True)

      :type: bool

   .. data:: total_levels

      Number of subdivisions for which displacements are stored (in [0, 255], default 0, readonly)

      :type: int

   .. attribute:: use_creases

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

      :type: bool

   .. attribute:: use_custom_normals

      Interpolates existing custom normals to resulting mesh (default False)

      :type: bool

   .. attribute:: use_sculpt_base_mesh

      Make Sculpt Mode tools deform the base mesh while previewing the displacement of higher subdivision levels (default False)

      :type: bool

   .. attribute:: uv_smooth

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

      :type: Literal[:ref:`rna_enum_subdivision_uv_smooth_items`]

   .. classmethod:: bl_rna_get_subclass(id, default=None, /)
   
      :param id: The RNA type identifier.
      :type id: str
      :param default: The value to return when not found.
      :type default: :class:`bpy.types.Struct` | None
      :return: The RNA type or default when not found.
      :rtype: :class:`bpy.types.Struct`


   .. classmethod:: bl_rna_get_subclass_py(id, default=None, /)
   
      :param id: The RNA type identifier.
      :type id: str
      :param default: The value to return when not found.
      :type default: type | None
      :return: The class or default when not found.
      :rtype: type


Inherited Properties
--------------------

.. hlist::
   :columns: 2

   - :class:`bpy_struct.id_data`
   - :class:`Modifier.name`
   - :class:`Modifier.type`
   - :class:`Modifier.show_viewport`
   - :class:`Modifier.show_render`
   - :class:`Modifier.show_in_editmode`
   - :class:`Modifier.show_on_cage`
   - :class:`Modifier.show_expanded`
   - :class:`Modifier.is_active`
   - :class:`Modifier.use_pin_to_last`
   - :class:`Modifier.is_override_data`
   - :class:`Modifier.use_apply_on_spline`
   - :class:`Modifier.execution_time`
   - :class:`Modifier.persistent_uid`

Inherited Functions
-------------------

.. hlist::
   :columns: 2

   - :class:`bpy_struct.as_pointer`
   - :class:`bpy_struct.driver_add`
   - :class:`bpy_struct.driver_remove`
   - :class:`bpy_struct.get`
   - :class:`bpy_struct.id_properties_clear`
   - :class:`bpy_struct.id_properties_ensure`
   - :class:`bpy_struct.id_properties_ui`
   - :class:`bpy_struct.is_property_hidden`
   - :class:`bpy_struct.is_property_overridable_library`
   - :class:`bpy_struct.is_property_readonly`
   - :class:`bpy_struct.is_property_set`
   - :class:`bpy_struct.items`
   - :class:`bpy_struct.keyframe_delete`
   - :class:`bpy_struct.keyframe_insert`
   - :class:`bpy_struct.keys`
   - :class:`bpy_struct.path_from_id`
   - :class:`bpy_struct.path_from_module`
   - :class:`bpy_struct.path_resolve`
   - :class:`bpy_struct.pop`
   - :class:`bpy_struct.property_overridable_library_set`
   - :class:`bpy_struct.property_unset`
   - :class:`bpy_struct.rna_ancestors`
   - :class:`bpy_struct.type_recast`
   - :class:`bpy_struct.values`
   - :class:`Modifier.bl_rna_get_subclass`
   - :class:`Modifier.bl_rna_get_subclass_py`

