user: Provide the full official documentation entry for RenderLayer(bpy_struct), preserving all code examples.

assistant: # RenderLayer(bpy_struct)

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

*class* bpy.types.RenderLayer(*bpy_struct*)
:   name
    :   View layer name

        Type:
        :   string, default “”, (readonly, never None)

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

    use_ao
    :   Render Ambient Occlusion in this Layer

        Type:
        :   boolean, default False, (readonly)

    use_grease_pencil
    :   Render Grease Pencil on this layer

        Type:
        :   boolean, default False, (readonly)

    use_motion_blur
    :   Render motion blur in this Layer, if enabled in the scene

        Type:
        :   boolean, default False, (readonly)

    use_pass_ambient_occlusion
    :   Deliver Ambient Occlusion pass

        Type:
        :   boolean, default False, (readonly)

    use_pass_combined
    :   Deliver full combined RGBA buffer

        Type:
        :   boolean, default False, (readonly)

    use_pass_diffuse_color
    :   Deliver diffuse color pass

        Type:
        :   boolean, default False, (readonly)

    use_pass_diffuse_direct
    :   Deliver diffuse direct pass

        Type:
        :   boolean, default False, (readonly)

    use_pass_diffuse_indirect
    :   Deliver diffuse indirect pass

        Type:
        :   boolean, default False, (readonly)

    use_pass_emit
    :   Deliver emission pass

        Type:
        :   boolean, default False, (readonly)

    use_pass_environment
    :   Deliver environment lighting pass

        Type:
        :   boolean, default False, (readonly)

    use_pass_glossy_color
    :   Deliver glossy color pass

        Type:
        :   boolean, default False, (readonly)

    use_pass_glossy_direct
    :   Deliver glossy direct pass

        Type:
        :   boolean, default False, (readonly)

    use_pass_glossy_indirect
    :   Deliver glossy indirect pass

        Type:
        :   boolean, default False, (readonly)

    use_pass_material_index
    :   Deliver material index pass

        Type:
        :   boolean, default False, (readonly)

    use_pass_mist
    :   Deliver mist factor pass (0.0 to 1.0)

        Type:
        :   boolean, default False, (readonly)

    use_pass_normal
    :   Deliver normal pass

        Type:
        :   boolean, default False, (readonly)

    use_pass_object_index
    :   Deliver object index pass

        Type:
        :   boolean, default False, (readonly)

    use_pass_position
    :   Deliver position pass

        Type:
        :   boolean, default False, (readonly)

    use_pass_shadow
    :   Deliver shadow pass

        Type:
        :   boolean, default False, (readonly)

    use_pass_subsurface_color
    :   Deliver subsurface color pass

        Type:
        :   boolean, default False, (readonly)

    use_pass_subsurface_direct
    :   Deliver subsurface direct pass

        Type:
        :   boolean, default False, (readonly)

    use_pass_subsurface_indirect
    :   Deliver subsurface indirect pass

        Type:
        :   boolean, default False, (readonly)

    use_pass_transmission_color
    :   Deliver transmission color pass

        Type:
        :   boolean, default False, (readonly)

    use_pass_transmission_direct
    :   Deliver transmission direct pass

        Type:
        :   boolean, default False, (readonly)

    use_pass_transmission_indirect
    :   Deliver transmission indirect pass

        Type:
        :   boolean, default False, (readonly)

    use_pass_uv
    :   Deliver texture UV pass

        Type:
        :   boolean, default False, (readonly)

    use_pass_vector
    :   Deliver speed vector pass

        Type:
        :   boolean, default False, (readonly)

    use_pass_z
    :   Deliver depth values pass

        Type:
        :   boolean, default False, (readonly)

    use_sky
    :   Render Sky in this Layer

        Type:
        :   boolean, default False, (readonly)

    use_solid
    :   Render Solid faces in this Layer

        Type:
        :   boolean, default False, (readonly)

    use_strand
    :   Render Strands in this Layer

        Type:
        :   boolean, default False, (readonly)

    use_volumes
    :   Render volumes in this Layer

        Type:
        :   boolean, default False, (readonly)

    load_from_file(*filepath*, *\**, *x=0*, *y=0*)
    :   Copies the pixels of this renderlayer from an image file

        Parameters:
        :   - **filepath** (*string**,* *(**never None**)*) – File Path, File path to load into this render tile, must be no smaller than the renderlayer
            - **x** (*int in* *[**0**,* *inf**]**,* *(**optional**)*) – Offset X, Offset the position to copy from if the image is larger than the render layer
            - **y** (*int in* *[**0**,* *inf**]**,* *(**optional**)*) – Offset Y, Offset the position to copy from if the image is larger than the render layer

    *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