bright

prop
SYNOPSIS
    int P_BRIGHT  "Bright"

    int Set(P_BRIGHT, int value)
    int Query(P_BRIGHT)
      or
    int SetBright(int value)
    int QueryBright()

DESCRIPTION
    The amount of light the object emits on its own. It radiates both
    outwards and inwards.

    Default value is 0 for things, resp. 75% of MAX_SUNBRIGHT for rooms.

    The brightness of the midday sun is defined in <config.h>
    as MAX_SUNBRIGHT, darkness are all values <= 0.
    The various brightnesses of the daytimes are defined in <nightday.h>.

    For rooms, any change to P_BRIGHT, P_INDOORS, P_OUTDOORS, or P_INT_LIGHT
    disables the default lighting.

EXAMPLE
    -- Emit some light. Using an absolute value looks easy, but makes
       the object code quite vulnerable.
    Set(P_BRIGHT, 10);

    -- Emit as much light as 1/10th of the sun, but at least 1.
    Set(P_BRIGHT, (MAX_SUNBRIGHT/10) || 1);

    -- Emit as much light as the sun at dawn.
    Set(P_BRIGHT, ND_REL_STATE(ND_DAWN, MAX_SUNBRIGHT));

AVAILABILITY
    Include: <properties.h>
             <config.h>  : MAX_SUNBRIGHT
             <nightday.h>: ND_REL_STATE() and the ND_states

    Availability: /std/thing(/restrictions) and descendants.
                  /std/room(/restrictions) and descendants.

SEE ALSO
    thing(S), room(S), container(S), light(P)