SpotLightHardness

Returns or changes the hardness of a spot light.  Spotlight hardness controls the fully illuminated region.

Syntax

rhinoscriptsyntax.SpotLightHardness (object_id, hardness=None)

rhinoscript.light.SpotLightHardness (object_id, hardness=None)

Parameters

object_id

Required.  String or Guid.  The light object's identifier.

hardness

Optional.  Number.  The new hardness value.  A spot light's hardness values ranges from 0.0 to 1.0.  If omitted, the current hardness value is returned.

Returns

Number

If hardness is not specified, then  the current hardness value if successful.

Number

If hardness is specified, then the previous hardness value if successful.

Example

import rhinoscriptsyntax as rs

id = rs.GetObject("Select a light", rs.filter.light)

if id: rs.SpotLightHardness(id, 0.75)

Also See

AddSpotLight

IsSpotLight

SpotLightRadius

SpotLightShadowIntensity