..
  Copyright Contributors to the Open Shading Language project.
  SPDX-License-Identifier: CC-BY-4.0


.. image::
    ../../ASWF/logos/openshadinglanguage-stacked-Shaded.png


=============================================
Open Shading Language |version| Documentation
=============================================

.. only:: not latex



    Editor: Larry Gritz, OSL Chief Architect

    Open Shading Language (OSL) is a small but rich language for programmable
    shading in advanced renderers and other applications, ideal for describing
    materials, lights, displacement, and pattern generation.

    Quick Links:
    `GitHub repository <https://github.com/AcademySoftwareFoundation/OpenShadingLanguage>`_ /
    `Developer mail list <https://lists.aswf.io/g/osl-dev>`_ /
    `BSD License <https://github.com/AcademySoftwareFoundation/OpenShadingLanguage/blob/master/LICENSE.md>`_


------------

.. default-role:: code


.. only:: not latex

    Contents
    --------

.. toctree::
   :caption: Introduction

   copyr

.. toctree::
   :caption: The OSL Language Specification
   :maxdepth: 2
   :numbered: 2

   intro
   bigpicture
   lexical
   grosssyntax
   datatypes
   syntax
   stdlib
   grammar
   shadergroups
   glossary


.. comment
    This is where we would put additional documentation sections
    in the future.


.. comment
    Helpful links when writing documentation:

    Doxygen docs:
        http://www.doxygen.nl/manual/index.html
    Sphinx docs:
        http://www.sphinx-doc.org/en/master/contents.html
        http://www.sphinx-doc.org/en/master/usage/restructuredtext/domains.html#cpp-domain
    Breathe docs:
        https://github.com/michaeljones/breathe
        https://breathe.readthedocs.io/en/latest/directives.html
    RST:

    sphinx-tabs plugin for Sphinx:
        https://pypi.org/project/sphinx-tabs/
        https://sphinx-tabs.readthedocs.io/en/latest/#

