user: How do I use ParticleSettingsTextureSlot(TextureSlot) in Blender? Include parameters, examples, warnings and best practices.

assistant: # ParticleSettingsTextureSlot(TextureSlot)

base classes — [`bpy_struct`](bpy.types.bpy_struct.html#bpy.types.bpy_struct "bpy.types.bpy_struct"), [`TextureSlot`](bpy.types.TextureSlot.html#bpy.types.TextureSlot "bpy.types.TextureSlot")

*class* bpy.types.ParticleSettingsTextureSlot(*TextureSlot*)
:   Texture slot for textures in a Particle Settings data-block

    clump_factor
    :   Amount texture affects child clump

        Type:
        :   float in [-inf, inf], default 1.0

    damp_factor
    :   Amount texture affects particle damping

        Type:
        :   float in [-inf, inf], default 1.0

    density_factor
    :   Amount texture affects particle density

        Type:
        :   float in [-inf, inf], default 1.0

    field_factor
    :   Amount texture affects particle force fields

        Type:
        :   float in [-inf, inf], default 1.0

    gravity_factor
    :   Amount texture affects particle gravity

        Type:
        :   float in [-inf, inf], default 1.0

    kink_amp_factor
    :   Amount texture affects child kink amplitude

        Type:
        :   float in [-inf, inf], default 1.0

    kink_freq_factor
    :   Amount texture affects child kink frequency

        Type:
        :   float in [-inf, inf], default 1.0

    length_factor
    :   Amount texture affects child hair length

        Type:
        :   float in [-inf, inf], default 1.0

    life_factor
    :   Amount texture affects particle life time

        Type:
        :   float in [-inf, inf], default 1.0

    mapping
    :   - `FLAT`
          Flat – Map X and Y coordinates directly.
        - `CUBE`
          Cube – Map using the normal vector.
        - `TUBE`
          Tube – Map with Z as central axis.
        - `SPHERE`
          Sphere – Map with Z as central axis.

        Type:
        :   enum in [`'FLAT'`, `'CUBE'`, `'TUBE'`, `'SPHERE'`], default `'FLAT'`

    mapping_x
    :   Type:
        :   enum in [`'NONE'`, `'X'`, `'Y'`, `'Z'`], default `'X'`

    mapping_y
    :   Type:
        :   enum in [`'NONE'`, `'X'`, `'Y'`, `'Z'`], default `'Y'`

    mapping_z
    :   Type:
        :   enum in [`'NONE'`, `'X'`, `'Y'`, `'Z'`], default `'Z'`

    object
    :   Object to use for mapping with Object texture coordinates

        Type:
        :   [`Object`](bpy.types.Object.html#bpy.types.Object "bpy.types.Object")

    rough_factor
    :   Amount texture affects child roughness

        Type:
        :   float in [-inf, inf], default 1.0

    size_factor
    :   Amount texture affects physical particle size

        Type:
        :   float in [-inf, inf], default 1.0

    texture_coords
    :   Texture coordinates used to map the texture onto the background

        - `GLOBAL`
          Global – Use global coordinates for the texture coordinates.
        - `OBJECT`
          Object – Use linked object’s coordinates for texture coordinates.
        - `UV`
          UV – Use UV coordinates for texture coordinates.
        - `ORCO`
          Generated – Use the original undeformed coordinates of the object.
        - `STRAND`
          Strand / Particle – Use normalized strand texture coordinate (1D) or particle age (X) and trail position (Y).

        Type:
        :   enum in [`'GLOBAL'`, `'OBJECT'`, `'UV'`, `'ORCO'`, `'STRAND'`], default `'UV'`

    time_factor
    :   Amount texture affects particle emission time

        Type:
        :   float in [-inf, inf], default 1.0

    twist_factor
    :   Amount texture affects child twist

        Type:
        :   float in [-inf, inf], default 1.0

    use_map_clump
    :   Affect the child clumping

        Type:
        :   boolean, default False

    use_map_damp
    :   Affect the particle velocity damping

        Type:
        :   boolean, default False

    use_map_density
    :   Affect the density of the particles

        Type:
        :   boolean, default False

    use_map_field
    :   Affect the particle force fields

        Type:
        :   boolean, default False

    use_map_gravity
    :   Affect the particle gravity

        Type:
        :   boolean, default False

    use_map_kink_amp
    :   Affect the child kink amplitude

        Type:
        :   boolean, default False

    use_map_kink_freq
    :   Affect the child kink frequency

        Type:
        :   boolean, default False

    use_map_length
    :   Affect the child hair length

        Type:
        :   boolean, default False

    use_map_life
    :   Affect the life time of the particles

        Type:
        :   boolean, default False

    use_map_rough
    :   Affect the child rough

        Type:
        :   boolean, default False

    use_map_size
    :   Affect the particle size

        Type:
        :   boolean, default False

    use_map_time
    :   Affect the emission time of the particles

        Type:
        :   boolean, default True

    use_map_twist
    :   Affect the child twist

        Type:
        :   boolean, default False

    use_map_velocity
    :   Affect the particle initial velocity

        Type:
        :   boolean, default False

    uv_layer
    :   UV map to use for mapping with UV texture coordinates

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

    velocity_factor
    :   Amount texture affects particle initial velocity

        Type:
        :   float in [-inf, inf], default 1.0

    *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