Products
  • Wolfram|One

    The definitive Wolfram Language and notebook experience

  • Mathematica

    The original technical computing environment

  • Wolfram Notebook Assistant + LLM Kit

    All-in-one AI assistance for your Wolfram experience

  • System Modeler
  • Wolfram Player
  • Finance Platform
  • Wolfram Engine
  • Enterprise Private Cloud
  • Application Server
  • Wolfram|Alpha Notebook Edition
  • Wolfram Cloud App
  • Wolfram Player App

More mobile apps

Core Technologies of Wolfram Products

  • Wolfram Language
  • Computable Data
  • Wolfram Notebooks
  • AI & Linguistic Understanding

Deployment Options

  • Wolfram Cloud
  • wolframscript
  • Wolfram Engine Community Edition
  • Wolfram LLM API
  • WSTPServer
  • Wolfram|Alpha APIs

From the Community

  • Function Repository
  • Community Paclet Repository
  • Example Repository
  • Neural Net Repository
  • Prompt Repository
  • Wolfram Demonstrations
  • Data Repository
  • Group & Organizational Licensing
  • All Products
Consulting & Solutions

We deliver solutions for the AI era—combining symbolic computation, data-driven insights and deep technical expertise

  • Data & Computational Intelligence
  • Model-Based Design
  • Algorithm Development
  • Wolfram|Alpha for Business
  • Blockchain Technology
  • Education Technology
  • Quantum Computation

WolframConsulting.com

Wolfram Solutions

  • Data Science
  • Artificial Intelligence
  • Biosciences
  • Healthcare Intelligence
  • Sustainable Energy
  • Control Systems
  • Enterprise Wolfram|Alpha
  • Blockchain Labs

More Wolfram Solutions

Wolfram Solutions For Education

  • Research Universities
  • Colleges & Teaching Universities
  • Junior & Community Colleges
  • High Schools
  • Educational Technology
  • Computer-Based Math

More Solutions for Education

  • Contact Us
Learning & Support

Get Started

  • Wolfram Language Introduction
  • Fast Intro for Programmers
  • Fast Intro for Math Students
  • Wolfram Language Documentation

More Learning

  • Highlighted Core Areas
  • Demonstrations
  • YouTube
  • Daily Study Groups
  • Wolfram Schools and Programs
  • Books

Grow Your Skills

  • Wolfram U

    Courses in computing, science, life and more

  • Community

    Learn, solve problems and share ideas.

  • Blog

    News, views and insights from Wolfram

  • Resources for

    Software Developers

Tech Support

  • Contact Us
  • Support FAQs
  • Support FAQs
  • Contact Us
Company
  • About Wolfram
  • Career Center
  • All Sites & Resources
  • Connect & Follow
  • Contact Us

Work with Us

  • Student Ambassador Initiative
  • Wolfram for Startups
  • Student Opportunities
  • Jobs Using Wolfram Language

Educational Programs for Adults

  • Summer School
  • Winter School

Educational Programs for Youth

  • Middle School Camp
  • High School Research Program
  • Computational Adventures

Read

  • Stephen Wolfram's Writings
  • Wolfram Blog
  • Wolfram Tech | Books
  • Wolfram Media
  • Complex Systems

Educational Resources

  • Wolfram MathWorld
  • Wolfram in STEM/STEAM
  • Wolfram Challenges
  • Wolfram Problem Generator

Wolfram Initiatives

  • Wolfram Science
  • Wolfram Foundation
  • History of Mathematics Project

Events

  • Stephen Wolfram Livestreams
  • Online & In-Person Events
  • Contact Us
  • Connect & Follow
Wolfram|Alpha
  • Your Account
  • User Portal
  • Wolfram Cloud
  • Products
    • Wolfram|One
    • Mathematica
    • Wolfram Notebook Assistant + LLM Kit
    • System Modeler
    • Wolfram Player
    • Finance Platform
    • Wolfram|Alpha Notebook Edition
    • Wolfram Engine
    • Enterprise Private Cloud
    • Application Server
    • Wolfram Cloud App
    • Wolfram Player App

    More mobile apps

    • Core Technologies
      • Wolfram Language
      • Computable Data
      • Wolfram Notebooks
      • AI & Linguistic Understanding
    • Deployment Options
      • Wolfram Cloud
      • wolframscript
      • Wolfram Engine Community Edition
      • Wolfram LLM API
      • WSTPServer
      • Wolfram|Alpha APIs
    • From the Community
      • Function Repository
      • Community Paclet Repository
      • Example Repository
      • Neural Net Repository
      • Prompt Repository
      • Wolfram Demonstrations
      • Data Repository
    • Group & Organizational Licensing
    • All Products
  • Consulting & Solutions

    We deliver solutions for the AI era—combining symbolic computation, data-driven insights and deep technical expertise

    WolframConsulting.com

    Wolfram Solutions

    • Data Science
    • Artificial Intelligence
    • Biosciences
    • Healthcare Intelligence
    • Sustainable Energy
    • Control Systems
    • Enterprise Wolfram|Alpha
    • Blockchain Labs

    More Wolfram Solutions

    Wolfram Solutions For Education

    • Research Universities
    • Colleges & Teaching Universities
    • Junior & Community Colleges
    • High Schools
    • Educational Technology
    • Computer-Based Math

    More Solutions for Education

    • Contact Us
  • Learning & Support

    Get Started

    • Wolfram Language Introduction
    • Fast Intro for Programmers
    • Fast Intro for Math Students
    • Wolfram Language Documentation

    Grow Your Skills

    • Wolfram U

      Courses in computing, science, life and more

    • Community

      Learn, solve problems and share ideas.

    • Blog

      News, views and insights from Wolfram

    • Resources for

      Software Developers
    • Tech Support
      • Contact Us
      • Support FAQs
    • More Learning
      • Highlighted Core Areas
      • Demonstrations
      • YouTube
      • Daily Study Groups
      • Wolfram Schools and Programs
      • Books
    • Support FAQs
    • Contact Us
  • Company
    • About Wolfram
    • Career Center
    • All Sites & Resources
    • Connect & Follow
    • Contact Us

    Work with Us

    • Student Ambassador Initiative
    • Wolfram for Startups
    • Student Opportunities
    • Jobs Using Wolfram Language

    Educational Programs for Adults

    • Summer School
    • Winter School

    Educational Programs for Youth

    • Middle School Camp
    • High School Research Program
    • Computational Adventures

    Read

    • Stephen Wolfram's Writings
    • Wolfram Blog
    • Wolfram Tech | Books
    • Wolfram Media
    • Complex Systems
    • Educational Resources
      • Wolfram MathWorld
      • Wolfram in STEM/STEAM
      • Wolfram Challenges
      • Wolfram Problem Generator
    • Wolfram Initiatives
      • Wolfram Science
      • Wolfram Foundation
      • History of Mathematics Project
    • Events
      • Stephen Wolfram Livestreams
      • Online & In-Person Events
    • Contact Us
    • Connect & Follow
  • Wolfram|Alpha
  • Wolfram Cloud
  • Your Account
  • User Portal
Wolfram Language & System Documentation Center
Lighting
  • See Also
    • AmbientLight
    • DirectionalLight
    • PointLight
    • SpotLight
    • RGBColor
    • Specularity
    • Glow
    • ColorFunction
    • NormalsFunction
  • Related Guides
    • 3D Graphics Options
    • Colors
    • Graphics Directives
    • Graphics Options & Styling
  • Tech Notes
    • Three-Dimensional Graphics Directives
    • See Also
      • AmbientLight
      • DirectionalLight
      • PointLight
      • SpotLight
      • RGBColor
      • Specularity
      • Glow
      • ColorFunction
      • NormalsFunction
    • Related Guides
      • 3D Graphics Options
      • Colors
      • Graphics Directives
      • Graphics Options & Styling
    • Tech Notes
      • Three-Dimensional Graphics Directives

Lighting

is an option for Graphics3D and related functions that specifies what simulated lighting to use in coloring 3D surfaces.

Details
Details and Options Details and Options
Examples  
Basic Examples  
Scope  
Lighting Specification  
Lighting Positions  
Lighting Attenuation  
Generalizations & Extensions  
Applications  
Properties & Relations  
Possible Issues  
Neat Examples  
See Also
Tech Notes
Related Guides
History
Cite this Page
BUILT-IN SYMBOL
  • See Also
    • AmbientLight
    • DirectionalLight
    • PointLight
    • SpotLight
    • RGBColor
    • Specularity
    • Glow
    • ColorFunction
    • NormalsFunction
  • Related Guides
    • 3D Graphics Options
    • Colors
    • Graphics Directives
    • Graphics Options & Styling
  • Tech Notes
    • Three-Dimensional Graphics Directives
    • See Also
      • AmbientLight
      • DirectionalLight
      • PointLight
      • SpotLight
      • RGBColor
      • Specularity
      • Glow
      • ColorFunction
      • NormalsFunction
    • Related Guides
      • 3D Graphics Options
      • Colors
      • Graphics Directives
      • Graphics Options & Styling
    • Tech Notes
      • Three-Dimensional Graphics Directives

Lighting

Lighting

is an option for Graphics3D and related functions that specifies what simulated lighting to use in coloring 3D surfaces.

Details

  • The following settings can be given:
  • Automaticdefault lighting schemes
    Noneno lighting
    "light"named lighting
    {s1,s2,…}light sources s1, s2, …
  • Possible named lighting settings "light" include:
  • "Standard"colored light sources in default positions
    "Neutral"white light sources in default positions
    "Accent"a directional white light source in default direction
    "ThreePoint"three directional white light sources in default directions
  • Each light source si can be of the following forms:
  • AmbientLightuniform ambient light
    DirectionalLightdirectional light
    PointLightspherical point light
    SpotLightspotlight
  • Lighting{s1,…} combines the light sources si with any inherited light sources. To prevent combining with inherited light sources, use Lighting{None, s1,…}.
  • Lighting->Automatic uses ambient light together with four light sources fixed relative to the final displayed image.
  • Lighting can be specified separately for particular objects in Graphics3D by giving a style option Style[obj,Lighting->spec].

Examples

open all close all

Basic Examples  (4)

Default lighting on gray specular sphere:

Neutral lighting on gray specular sphere:

Directional light from the top of the specular surface:

Specify lighting for each object:

Scope  (24)

Lighting Specification  (18)

Default lighting on a white surface:

Default lighting when ColorFunction is specified:

No lighting means diffuse or specular colors will not be visible:

Using Glow specifies pure color without interaction with lights:

Ambient light is uniformly applied to all the surfaces in the scene:

Ambient light gives overall lighting on the scene:

Directional light is specified by a color and a vector defined by two points:

Directional lights with different colors:

Directional lights with different directions:

Directional lights on a specular surface:

Specify a spherical point light source by a color and a position:

Point lights with different colors:

Point lights at various positions:

Point lights on specular surfaces:

Specify spotlight by position, target position, and half-angle:

Spotlights with different colors:

Spotlights from different positions:

Spotlights with different half-angles:

Spotlights on specular surfaces:

Lighting Positions  (3)

Specify the light source position in the graphics coordinate system by default:

The light source moves with the graphic when the view point changes:

Specify the light position by a fraction of the graphics coordinates using Scaled:

The light source moves with the graphic when the view point changes:

Specify the light position in the view coordinate system using ImageScaled:

The light source position is always fixed relative to the view point:

Lighting Attenuation  (3)

By default, point lights are not affected by the distance from an object:

Specify a point light that attenuates with respect to the distance:

Specify a point light that attenuates by the square of the distance:

By default, spotlights fall off sharply outside the cone:

Spotlights with different spot exponent has intensity :

Spotlight without attenuation:

Spotlight with linear attenuation:

Spotlight with quadratic attenuation:

Generalizations & Extensions  (8)

Predefined colored lighting:

The colored lighting is equivalent to the following explicit setting:

Predefined accent lighting:

The accent lighting is equivalent to the following explicit setting:

Predefined neutral lighting:

The neutral lighting is equivalent to the following explicit setting:

Predefined three-point lighting:

The three-point lighting is equivalent to the following explicit setting:

Specify lighting for each object:

Specify lighting within the graphics:

If not specified, the target direction is given toward the center of the objects:

Specify diffuse and specular colors separately for both objects and lights:

Applications  (3)

Set up four white spheres on a plane:

Directional light:

Point light:

Spotlight:

Different light instruments at the corner points:

Build a scene with multiple objects and light sources:

Animate the spotlights:

Properties & Relations  (8)

Surface color and lighting interact with each other:

Diffuse object and lighting colors can be exchanged and produce the same effect:

Specular object and lighting colors can be exchanged and produce the same effect:

Specularity gives mirror-like reflection:

The final color is a linear combination of all the surface colors as well as lighting:

Directional light yields rays parallel to the specified direction:

Point light yields rays toward all the directions from the position:

A spotlight emits conic rays toward the specified direction:

Possible Issues  (5)

The default lighting may not be suitable for light surface colors:

Neutral lighting can be used to reflect surface colors more naturally:

If a color function is given to a plot, then neutral lighting is used automatically:

Restore the default colored lighting:

Flat surfaces may show little or no reflection:

A spotlight on a sphere may display a jagged boundary:

Increasing the spot exponent may reduce the effect:

Inline Lighting directives specifying light sources add those sources to any inherited specification:

Set LightingNone on the graphic to override the default LightingAutomatic setting:

Similarly, a sequence of Lighting{s1,…} specifications cumulatively adds the lights together:

Use list braces to ensure the lighting specification does not leak into subsequent specifications:

Neat Examples  (2)

Random light setups for ring models:

A simple light show:

See Also

AmbientLight  DirectionalLight  PointLight  SpotLight  RGBColor  Specularity  Glow  ColorFunction  NormalsFunction

Tech Notes

    ▪
  • Three-Dimensional Graphics Directives

Related Guides

    ▪
  • 3D Graphics Options
  • ▪
  • Colors
  • ▪
  • Graphics Directives
  • ▪
  • Graphics Options & Styling

History

Introduced in 1988 (1.0) | Updated in 2007 (6.0) ▪ 2014 (10.0) ▪ 2020 (12.1) ▪ 2021 (12.3) ▪ 2021 (13.0)

Wolfram Research (1988), Lighting, Wolfram Language function, https://reference.wolfram.com/language/ref/Lighting.html (updated 2021).

Text

Wolfram Research (1988), Lighting, Wolfram Language function, https://reference.wolfram.com/language/ref/Lighting.html (updated 2021).

CMS

Wolfram Language. 1988. "Lighting." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2021. https://reference.wolfram.com/language/ref/Lighting.html.

APA

Wolfram Language. (1988). Lighting. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/Lighting.html

BibTeX

@misc{reference.wolfram_2025_lighting, author="Wolfram Research", title="{Lighting}", year="2021", howpublished="\url{https://reference.wolfram.com/language/ref/Lighting.html}", note=[Accessed: 01-December-2025]}

BibLaTeX

@online{reference.wolfram_2025_lighting, organization={Wolfram Research}, title={Lighting}, year={2021}, url={https://reference.wolfram.com/language/ref/Lighting.html}, note=[Accessed: 01-December-2025]}

Top
Introduction for Programmers
Introductory Book
Wolfram Function Repository | Wolfram Data Repository | Wolfram Data Drop | Wolfram Language Products
Top
  • Products
  • Wolfram|One
  • Mathematica
  • Notebook Assistant + LLM Kit
  • System Modeler

  • Wolfram|Alpha Notebook Edition
  • Wolfram|Alpha Pro
  • Mobile Apps

  • Wolfram Player
  • Wolfram Engine

  • Volume & Site Licensing
  • Server Deployment Options
  • Consulting
  • Wolfram Consulting
  • Repositories
  • Data Repository
  • Function Repository
  • Community Paclet Repository
  • Neural Net Repository
  • Prompt Repository

  • Wolfram Language Example Repository
  • Notebook Archive
  • Wolfram GitHub
  • Learning
  • Wolfram U
  • Wolfram Language Documentation
  • Webinars & Training
  • Educational Programs

  • Wolfram Language Introduction
  • Fast Introduction for Programmers
  • Fast Introduction for Math Students
  • Books

  • Wolfram Community
  • Wolfram Blog
  • Public Resources
  • Wolfram|Alpha
  • Wolfram Problem Generator
  • Wolfram Challenges

  • Computer-Based Math
  • Computational Thinking
  • Computational Adventures

  • Demonstrations Project
  • Wolfram Data Drop
  • MathWorld
  • Wolfram Science
  • Wolfram Media Publishing
  • Customer Resources
  • Store
  • Product Downloads
  • User Portal
  • Your Account
  • Organization Access

  • Support FAQ
  • Contact Support
  • Company
  • About Wolfram
  • Careers
  • Contact
  • Events
Wolfram Community Wolfram Blog
Legal & Privacy Policy
WolframAlpha.com | WolframCloud.com
© 2025 Wolfram
© 2025 Wolfram | Legal & Privacy Policy |
English