user: Give a detailed overview of Dependency graph: Object.to_curve(): syntax, arguments, return values, common patterns.

assistant: Function to get a curve from text and curve objects. It is typically used by exporters, render
engines, and tools that need to access the curve representing the object.

The function takes the evaluated dependency graph as a required parameter and optionally a boolean
apply_modifiers which defaults to false. If apply_modifiers is true and the object is a curve object,
the spline deform modifiers are applied on the control points. Note that constructive modifiers and
modifiers that are not spline-enabled will not be applied. So modifiers like Array will not be applied
and deform modifiers that have Apply On Spline disabled will not be applied.

If the object is a text object. The text will be converted into a 3D curve and returned. Modifiers are
never applied on text objects and apply_modifiers will be ignored. If the object is neither a curve nor
a text object, an error will be reported.

```
import bpy

class OBJECT_OT_object_to_curve(bpy.types.Operator):
    """Convert selected object to curve and show number of splines"""
    bl_label = "DEG Object to Curve"
    bl_idname = "object.object_to_curve"

    def execute(self, context):
        # Access input original object.
        obj = context.object
        if obj is None:
            self.report({'INFO'}, "No active object to convert to curve")
            return {'CANCELLED'}
        if obj.type not in {'CURVE', 'FONT'}:
            self.report({'INFO'}, "Object cannot be converted to curve")
            return {'CANCELLED'}
        depsgraph = context.evaluated_depsgraph_get()
        # Invoke to_curve() without applying modifiers.
        curve_without_modifiers = obj.to_curve(depsgraph)
        self.report({'INFO'}, f"{len(curve_without_modifiers.splines)} splines in a new curve without modifiers.")
        # Remove temporary curve.
        obj.to_curve_clear()
        # Invoke to_curve() with applying modifiers.
        curve_with_modifiers = obj.to_curve(depsgraph, apply_modifiers=True)
        self.report({'INFO'}, f"{len(curve_with_modifiers.splines)} splines in new curve with modifiers.")
        # Remove temporary curve.
        obj.to_curve_clear()
        return {'FINISHED'}

def register():
    bpy.utils.register_class(OBJECT_OT_object_to_curve)

def unregister():
    bpy.utils.unregister_class(OBJECT_OT_object_to_curve)

if __name__ == "__main__":
    register()
```

base class — [`bpy_struct`](bpy.types.bpy_struct.html#bpy.types.bpy_struct "bpy.types.bpy_struct")

*class* bpy.types.Depsgraph(*bpy_struct*)
:   ids
    :   All evaluated data-blocks

        Type:
        :   [`bpy_prop_collection`](bpy.types.bpy_prop_collection.html#bpy.types.bpy_prop_collection "bpy.types.bpy_prop_collection") of [`ID`](bpy.types.ID.html#bpy.types.ID "bpy.types.ID"), (readonly)

    mode
    :   Evaluation mode

        - `VIEWPORT`
          Viewport – Viewport non-rendered mode.
        - `RENDER`
          Render – Render.

        Type:
        :   enum in [`'VIEWPORT'`, `'RENDER'`], default `'VIEWPORT'`, (readonly)

    object_instances
    :   All object instances to display or render (Warning: Only use this as an iterator, never as a sequence, and do not keep any references to its items)

        Type:
        :   [`bpy_prop_collection`](bpy.types.bpy_prop_collection.html#bpy.types.bpy_prop_collection "bpy.types.bpy_prop_collection") of [`DepsgraphObjectInstance`](bpy.types.DepsgraphObjectInstance.html#bpy.types.DepsgraphObjectInstance "bpy.types.DepsgraphObjectInstance"), (readonly)

    objects
    :   Evaluated objects in the dependency graph

        Type:
        :   [`bpy_prop_collection`](bpy.types.bpy_prop_collection.html#bpy.types.bpy_prop_collection "bpy.types.bpy_prop_collection") of [`Object`](bpy.types.Object.html#bpy.types.Object "bpy.types.Object"), (readonly)

    scene
    :   Original scene dependency graph is built for

        Type:
        :   [`Scene`](bpy.types.Scene.html#bpy.types.Scene "bpy.types.Scene"), (readonly)

    scene_eval
    :   Scene at its evaluated state

        Type:
        :   [`Scene`](bpy.types.Scene.html#bpy.types.Scene "bpy.types.Scene"), (readonly)

    updates
    :   Updates to data-blocks

        Type:
        :   [`bpy_prop_collection`](bpy.types.bpy_prop_collection.html#bpy.types.bpy_prop_collection "bpy.types.bpy_prop_collection") of [`DepsgraphUpdate`](bpy.types.DepsgraphUpdate.html#bpy.types.DepsgraphUpdate "bpy.types.DepsgraphUpdate"), (readonly)

    view_layer
    :   Original view layer dependency graph is built for

        Type:
        :   [`ViewLayer`](bpy.types.ViewLayer.html#bpy.types.ViewLayer "bpy.types.ViewLayer"), (readonly)

    view_layer_eval
    :   View layer at its evaluated state

        Type:
        :   [`ViewLayer`](bpy.types.ViewLayer.html#bpy.types.ViewLayer "bpy.types.ViewLayer"), (readonly)

    debug_relations_graphviz(*\**, *filepath=''*)
    :   debug_relations_graphviz

        Parameters:
        :   **filepath** (*string**,* *(**optional**,* *never None**)*) – File Name, Optional output path for the graphviz debug file

        Returns:
        :   Dot Graph, Graph in dot format

        Return type:
        :   string

    debug_stats_gnuplot(*filepath*, *output_filepath*)
    :   debug_stats_gnuplot

        Parameters:
        :   - **filepath** (*string**,* *(**never None**)*) – File Name, Output path for the gnuplot debug file
            - **output_filepath** (*string**,* *(**never None**)*) – Output File Name, File name where gnuplot script will save the result

    debug_tag_update()
    :   debug_tag_update

    debug_stats()
    :   Report the number of elements in the Dependency Graph

        Returns:
        :   result

        Return type:
        :   string, (never None)

    update()
    :   Re-evaluate any modified data-blocks, for example for animation or modifiers. This invalidates all references to evaluated data-blocks from this dependency graph.

    id_eval_get(*id*)
    :   id_eval_get

        Parameters:
        :   **id** ([`ID`](bpy.types.ID.html#bpy.types.ID "bpy.types.ID")) – Original ID to get evaluated complementary part for

        Returns:
        :   Evaluated ID for the given original one

        Return type:
        :   [`ID`](bpy.types.ID.html#bpy.types.ID "bpy.types.ID")

    id_type_updated(*id_type*)
    :   id_type_updated

        Parameters:
        :   **id_type** (enum in [Id Type Items](bpy_types_enum_items/id_type_items.html#rna-enum-id-type-items)) – ID Type

        Returns:
        :   Updated, True if any data-block with this type was added, updated or removed

        Return type:
        :   boolean

    *classmethod* bl_rna_get_subclass(*id*, *default=None*, */*)
    :   Parameters:
        :   **id** (*str*) – The RNA type identifier.

        Returns:
        :   The RNA type or default when not found.

        Return type:
        :   [`bpy.types.Struct`](bpy.types.Struct.html#bpy.types.Struct "bpy.types.Struct") subclass

    *classmethod* bl_rna_get_subclass_py(*id*, *default=None*, */*)
    :   Parameters:
        :   **id** (*str*) – The RNA type identifier.

        Returns:
        :   The class or default when not found.

        Return type:
        :   type

### Inherited Properties

|  |  |
| --- | --- |
| - [`bpy_struct.id_data`](bpy.types.bpy_struct.html#bpy.types.bpy_struct.id_data "bpy.types.bpy_struct.id_data") |  |

### Inherited Functions

|  |  |
| --- | --- |
| - [`bpy_struct.as_pointer`](bpy.types.bpy_struct.html#bpy.types.bpy_struct.as_pointer "bpy.types.bpy_struct.as_pointer") - [`bpy_struct.driver_add`](bpy.types.bpy_struct.html#bpy.types.bpy_struct.driver_add "bpy.types.bpy_struct.driver_add") - [`bpy_struct.driver_remove`](bpy.types.bpy_struct.html#bpy.types.bpy_struct.driver_remove "bpy.types.bpy_struct.driver_remove") - [`bpy_struct.get`](bpy.types.bpy_struct.html#bpy.types.bpy_struct.get "bpy.types.bpy_struct.get") - [`bpy_struct.id_properties_clear`](bpy.types.bpy_struct.html#bpy.types.bpy_struct.id_properties_clear "bpy.types.bpy_struct.id_properties_clear") - [`bpy_struct.id_properties_ensure`](bpy.types.bpy_struct.html#bpy.types.bpy_struct.id_properties_ensure "bpy.types.bpy_struct.id_properties_ensure") - [`bpy_struct.id_properties_ui`](bpy.types.bpy_struct.html#bpy.types.bpy_struct.id_properties_ui "bpy.types.bpy_struct.id_properties_ui") - [`bpy_struct.is_property_hidden`](bpy.types.bpy_struct.html#bpy.types.bpy_struct.is_property_hidden "bpy.types.bpy_struct.is_property_hidden") - [`bpy_struct.is_property_overridable_library`](bpy.types.bpy_struct.html#bpy.types.bpy_struct.is_property_overridable_library "bpy.types.bpy_struct.is_property_overridable_library") - [`bpy_struct.is_property_readonly`](bpy.types.bpy_struct.html#bpy.types.bpy_struct.is_property_readonly "bpy.types.bpy_struct.is_property_readonly") - [`bpy_struct.is_property_set`](bpy.types.bpy_struct.html#bpy.types.bpy_struct.is_property_set "bpy.types.bpy_struct.is_property_set") - [`bpy_struct.items`](bpy.types.bpy_struct.html#bpy.types.bpy_struct.items "bpy.types.bpy_struct.items") | - [`bpy_struct.keyframe_delete`](bpy.types.bpy_struct.html#bpy.types.bpy_struct.keyframe_delete "bpy.types.bpy_struct.keyframe_delete") - [`bpy_struct.keyframe_insert`](bpy.types.bpy_struct.html#bpy.types.bpy_struct.keyframe_insert "bpy.types.bpy_struct.keyframe_insert") - [`bpy_struct.keys`](bpy.types.bpy_struct.html#bpy.types.bpy_struct.keys "bpy.types.bpy_struct.keys") - [`bpy_struct.path_from_id`](bpy.types.bpy_struct.html#bpy.types.bpy_struct.path_from_id "bpy.types.bpy_struct.path_from_id") - [`bpy_struct.path_from_module`](bpy.types.bpy_struct.html#bpy.types.bpy_struct.path_from_module "bpy.types.bpy_struct.path_from_module") - [`bpy_struct.path_resolve`](bpy.types.bpy_struct.html#bpy.types.bpy_struct.path_resolve "bpy.types.bpy_struct.path_resolve") - [`bpy_struct.pop`](bpy.types.bpy_struct.html#bpy.types.bpy_struct.pop "bpy.types.bpy_struct.pop") - [`bpy_struct.property_overridable_library_set`](bpy.types.bpy_struct.html#bpy.types.bpy_struct.property_overridable_library_set "bpy.types.bpy_struct.property_overridable_library_set") - [`bpy_struct.property_unset`](bpy.types.bpy_struct.html#bpy.types.bpy_struct.property_unset "bpy.types.bpy_struct.property_unset") - [`bpy_struct.rna_ancestors`](bpy.types.bpy_struct.html#bpy.types.bpy_struct.rna_ancestors "bpy.types.bpy_struct.rna_ancestors") - [`bpy_struct.type_recast`](bpy.types.bpy_struct.html#bpy.types.bpy_struct.type_recast "bpy.types.bpy_struct.type_recast") - [`bpy_struct.values`](bpy.types.bpy_struct.html#bpy.types.bpy_struct.values "bpy.types.bpy_struct.values") |

### References

|  |  |
| --- | --- |
| - [`BlendDataMeshes.new_from_object`](bpy.types.BlendDataMeshes.html#bpy.types.BlendDataMeshes.new_from_object "bpy.types.BlendDataMeshes.new_from_object") - [`Context.evaluated_depsgraph_get`](bpy.types.Context.html#bpy.types.Context.evaluated_depsgraph_get "bpy.types.Context.evaluated_depsgraph_get") - [`ID.evaluated_get`](bpy.types.ID.html#bpy.types.ID.evaluated_get "bpy.types.ID.evaluated_get") - [`Object.calc_matrix_camera`](bpy.types.Object.html#bpy.types.Object.calc_matrix_camera "bpy.types.Object.calc_matrix_camera") - [`Object.camera_fit_coords`](bpy.types.Object.html#bpy.types.Object.camera_fit_coords "bpy.types.Object.camera_fit_coords") - [`Object.closest_point_on_mesh`](bpy.types.Object.html#bpy.types.Object.closest_point_on_mesh "bpy.types.Object.closest_point_on_mesh") - [`Object.crazyspace_eval`](bpy.types.Object.html#bpy.types.Object.crazyspace_eval "bpy.types.Object.crazyspace_eval") - [`Object.ray_cast`](bpy.types.Object.html#bpy.types.Object.ray_cast "bpy.types.Object.ray_cast") - [`Object.to_curve`](bpy.types.Object.html#bpy.types.Object.to_curve "bpy.types.Object.to_curve") | - [`Object.to_mesh`](bpy.types.Object.html#bpy.types.Object.to_mesh "bpy.types.Object.to_mesh") - [`RenderEngine.bake`](bpy.types.RenderEngine.html#bpy.types.RenderEngine.bake "bpy.types.RenderEngine.bake") - [`RenderEngine.draw`](bpy.types.RenderEngine.html#bpy.types.RenderEngine.draw "bpy.types.RenderEngine.draw") - [`RenderEngine.render`](bpy.types.RenderEngine.html#bpy.types.RenderEngine.render "bpy.types.RenderEngine.render") - [`RenderEngine.update`](bpy.types.RenderEngine.html#bpy.types.RenderEngine.update "bpy.types.RenderEngine.update") - [`RenderEngine.view_draw`](bpy.types.RenderEngine.html#bpy.types.RenderEngine.view_draw "bpy.types.RenderEngine.view_draw") - [`RenderEngine.view_update`](bpy.types.RenderEngine.html#bpy.types.RenderEngine.view_update "bpy.types.RenderEngine.view_update") - [`Scene.ray_cast`](bpy.types.Scene.html#bpy.types.Scene.ray_cast "bpy.types.Scene.ray_cast") - [`ViewLayer.depsgraph`](bpy.types.ViewLayer.html#bpy.types.ViewLayer.depsgraph "bpy.types.ViewLayer.depsgraph") |