Difference between revisions of "Reference:Introduction"
m |
Jholsenback (talk | contribs) m (additions and changes) |
||
Line 59: | Line 59: | ||
##[[Reference:Tracing Options|Tracing Options]] | ##[[Reference:Tracing Options|Tracing Options]] | ||
#<strong>[[Reference:Scene Description Language|Scene Description Language]]</strong> | #<strong>[[Reference:Scene Description Language|Scene Description Language]]</strong> | ||
− | ##[[Reference: | + | ##[[Reference:Language Basics|Language Basics]] |
###[[Reference:Keywords|Keywords]] | ###[[Reference:Keywords|Keywords]] | ||
###[[Reference:Identifiers|Identifiers]] | ###[[Reference:Identifiers|Identifiers]] | ||
Line 79: | Line 79: | ||
###[[Reference:User Message Directives|User Message Directives]] | ###[[Reference:User Message Directives|User Message Directives]] | ||
###[[Reference:User Defined Macros|User Defined Macros]] | ###[[Reference:User Defined Macros|User Defined Macros]] | ||
− | #<strong>Scene</strong> | + | #<strong>[[Reference:Scene Description File|Scene Description File]]</strong> |
##[[Reference:Global Settings|Global Settings]] | ##[[Reference:Global Settings|Global Settings]] | ||
+ | ###[[Reference:Global Settings#ADC_Bailout|adc_bailout]] | ||
+ | ###[[Reference:Global Settings#Ambient_Light|ambient_light]] | ||
+ | ###[[Reference:Global Settings#Assumed_Gamma|assumed_gama]] | ||
+ | ###[[Reference:Global Settings#HF_Gray_16|hf_gray_16]] | ||
+ | ###[[Reference:Global Settings#Irid_Wavelength|irid_wavelength]] | ||
+ | ###[[Reference:Global Settings#Charset|charset]] | ||
+ | ###[[Reference:Global Settings#Max_Trace_Level|max_trace_level]] | ||
+ | ###[[Reference:Global Settings#Mm_Per_Unit|mm_per_unit]] | ||
+ | ###[[Reference:Global Settings#Number_Of_Waves|number_of_waves]] | ||
+ | ###[[Reference:Global Settings#Noise_generator|noise_generator]] | ||
+ | ###[[Reference:Global Settings#Subsurface|subsurface]] | ||
##[[Reference:Camera|Camera]] | ##[[Reference:Camera|Camera]] | ||
− | + | ###[[Reference:Camera#Placing the Camera|Placing the Camera]] | |
− | ###[[Reference: | + | ###[[Reference:Camera#Types of Projection|Types of Projections]] |
− | ###[[Reference: | + | ###[[Reference:Camera#Placing the Camera|Placing the Camera]] |
− | ###[[Reference: | + | ###[[Reference:Camera#Focal Blur|Focal Blur]] |
− | ###[[Reference: | + | ###[[Reference:Camera#Camera Ray Perturbation|Camera Ray Perturbation]] |
− | ###[[Reference: | + | ###[[Reference:Camera#Camera Identifiers|Camera Identifiers]] |
− | # | + | ##[[Reference:Lighting Types|Lighting Types]] |
− | ##[[Reference: | + | ###[[Reference:Light Source|Light Sources]] |
− | ###[[Reference:Light Source#Point Lights|Point Lights]] | + | ####[[Reference:Light Source#Point Lights|Point Lights]] |
− | ###[[Reference:Light Source#Spotlights|Spotlights]] | + | ####[[Reference:Light Source#Spotlights|Spotlights]] |
− | ###[[Reference:Light Source#Cylindrical Lights|Cylindrical Lights]] | + | ####[[Reference:Light Source#Cylindrical Lights|Cylindrical Lights]] |
− | ###[[Reference:Light Source#Parallel Lights|Parallel Lights]] | + | ####[[Reference:Light Source#Parallel Lights|Parallel Lights]] |
− | ###[[Reference:Light Source#Area Lights|Area Lights]] | + | ####[[Reference:Light Source#Area Lights|Area Lights]] |
− | ##[[Reference:Light Group|Light Groups]] | + | ###[[Reference:Light Group|Light Groups]] |
− | ##[[Reference:Radiosity|Radiosity]] | + | ###[[Reference:Radiosity|Radiosity]] |
− | ##[[Reference:Photons|Photons]] | + | ###[[Reference:Photons|Photons]] |
− | # | + | ##[[Reference:Transformations|Transformations]] |
− | ##[[Reference: | + | ###[[Reference:Transformations#Translate|translate]] |
− | ###[[Reference: | + | ###[[Reference:Transformations#Scale|scale]] |
− | ###[[Reference: | + | ###[[Reference:Transformations#Rotate|rotate]] |
− | ###[[Reference: | + | ###[[Reference:Transformations#Matrix|matrix]] |
− | + | ##[[Reference:Object|Objects]] | |
− | ###[[Reference: | + | ###[[Reference:Object#Finite Solid Primitives|Finite Solid Primitives]] |
− | ###[[Reference: | + | ####[[Reference:Blob|Blob]] |
− | ###[[Reference: | + | ####[[Reference:Box|Box]] |
− | ###[[Reference: | + | ####[[Reference:Cone|Cone]] |
− | ###[[Reference: | + | ####[[Reference:Cylinder|Cylinder]] |
− | ###[[Reference: | + | ####[[Reference:Height Field|Height Field]] |
− | ###[[Reference: | + | ####[[Reference:Isosurface|Isosurface]] |
− | ###[[Reference: | + | ####[[Reference:Julia Fractal|Julia Fractal]] |
− | ###[[Reference: | + | ####[[Reference:Lathe|Lathe]] |
− | ###[[Reference: | + | ####[[Reference:Ovus|Ovus]] |
− | ###[[Reference: | + | ####[[Reference:Parametric|Parametric]] |
− | ###[[Reference: | + | ####[[Reference:Prism|Prism]] |
− | ###[[Reference: | + | ####[[Reference:Sphere|Sphere]] |
− | ##[[Reference: | + | ####[[Reference:Sphere Sweep|Sphere Sweep]] |
− | ###[[Reference: | + | ####[[Reference:Superellipsoid|Superquadric Ellipsoid]] |
− | ###[[Reference: | + | ####[[Reference:Sor|Surface of Revolution]] |
− | ###[[Reference: | + | ####[[Reference:Text|Text]] |
− | ###[[Reference: | + | ####[[Reference:Torus|Torus]] |
− | ###[[Reference: | + | ###[[Reference:Object#Finite Patch Primitives|Finite Patch Primitives]] |
− | ###[[Reference: | + | ####[[Reference:Bicubic Patch|Bicubic Patch]] |
− | ###[[Reference: | + | ####[[Reference:Disc|Disc]] |
− | ##[[Reference: | + | ####[[Reference:Mesh|Mesh]] |
− | ###[[Reference: | + | ####[[Reference:Mesh2|Mesh2]] |
− | ###[[Reference: | + | ####[[Reference:Polygon|Polygon]] |
− | ###[[Reference: | + | ####[[Reference:Triangle|Triangle]] |
− | ###[[Reference: | + | ####[[Reference:Smooth Triangle|Smooth Triangle]] |
− | ###[[Reference: | + | ###[[Reference:Object#Infinite Solid Primitives|Infinite Solid Primitives]] |
− | ###[[Reference: | + | ####[[Reference:Plane|Plane]] |
− | ##[[Reference: | + | ####[[Reference:Poly|Poly]] |
− | ###[[Reference: | + | ####[[Reference:Cubic|Cubic]] |
− | ###[[Reference: | + | ####[[Reference:Quartic|Quartic]] |
− | ###[[Reference: | + | ####[[Reference:Polynomial|Polynomial]] |
− | ###[[Reference: | + | ####[[Reference:Quadric|Quadric]] |
− | ###[[Reference: | + | ###[[Reference:Object#Constructive Solid Geometry|Constructive Solid Geometry]] |
− | ##[[Reference:Object# | + | ####[[Reference:Object#Inside and Outside|Inside and Outside]] |
− | # | + | ####[[Reference:Union|Union]] |
− | ##[[Reference: | + | ####[[Reference:Intersection|Intersection]] |
− | ##[[Reference: | + | ####[[Reference:Difference|Difference]] |
− | ##[[Reference: | + | ####[[Reference:Merge|Merge]] |
− | ##[[Reference: | + | ###[[Reference:Object#Object Modifiers|Object Modifiers]] |
− | ##[[Reference: | + | ##[[Reference:Texture|Textures]] |
− | ##[[Reference: | + | ###[[Reference:Pigment|Pigment]] |
− | ##[[Reference: | + | ###[[Reference:Normal|Normal]] |
− | ##[[Reference: | + | ###[[Reference:Finish|Finish]] |
− | ##[[Reference: | + | ####[[Reference:Finish#Ambient|Ambient]] |
− | ##[[Reference: | + | ####[[Reference:Finish#Emission|Emission]] |
− | # | + | ####[[Reference:Finish#Diffuse Reflection Items|Diffuse Reflection Items]] |
− | ##[[Reference: | + | ####[[Reference:Finish#Highlights|Highlights]] |
− | ##[[Reference: | + | ####[[Reference:Finish#Specular Reflection|Specular Reflection]] |
− | ##[[Reference: | + | ####[[Reference:Finish#Conserve Energy for Reflection|Conserve Energy for Reflection]] |
− | # | + | ####[[Reference:Finish#Iridescence|Iridescence]] |
− | ##[[Reference: | + | ###[[Reference:Halo|Halo]] |
− | ###[[Reference: | + | ###[[Reference:Patterned Textures|Patterned Textures]] |
− | ###[[Reference: | + | ###[[Reference:Layered Textures|Layered Textures]] |
− | ###[[Reference: | + | ###[[Reference:UV Mapping|UV Mapping]] |
− | ###[[Reference: | + | ###[[Reference:Triangle Texture Interpolation|Triangle Texture Interpolation]] |
− | ###[[Reference: | + | ###[[Reference:Interior Texture|Interior Texture]] |
− | ###[[Reference: | + | ###[[Reference:Cutaway Textures|Cutaway Textures]] |
− | + | ##[[Reference:Pattern|Patterns]] | |
− | ###[[Reference: | + | ###[[Reference:Pattern#General Patterns|General Patterns]] |
− | ###[[Reference: | + | ####[[Reference:Agate Pattern|Agate]] |
− | ###[[Reference: | + | ####[[Reference:Boxed Pattern|Boxed]] |
− | ###[[Reference: | + | ####[[Reference:Bozo Pattern|Bozo]] |
− | ###[[Reference: | + | ####[[Reference:Brick Pattern|Brick]] |
− | ###[[Reference: | + | ####[[Reference:Bumps Pattern|Bumps]] |
− | ###[[Reference: | + | ####[[Reference:Cubic Pattern|Cubic]] |
− | ###[[Reference: | + | ####[[Reference:Cylindrical Pattern|Cylindrical]] |
− | ###[[Reference: | + | ####[[Reference:Density_File Pattern|Density_File]] |
− | ###[[Reference: | + | ####[[Reference:Dents Pattern|Dents]] |
− | ###[[Reference: | + | ####[[Reference:Facets Pattern|Facets]] |
− | ###[[Reference: | + | ####[[Reference:Fractal Pattern|Fractal Patterns]] |
− | ###[[Reference: | + | ####[[Reference:Function Pattern|Function as pattern]] |
− | ###[[Reference: | + | ####[[Reference:Gradient Pattern|Gradient]] |
− | ###[[Reference: | + | ####[[Reference:Granite Pattern|Granite]] |
− | ###[[Reference: | + | ####[[Reference:Hexagon Pattern|Hexagon]] |
− | ###[[Reference: | + | ####[[Reference:Leopard Pattern|Leopard]] |
− | ###[[Reference: | + | ####[[Reference:Marble Pattern|Marble]] |
− | ###[[Reference: | + | ####[[Reference:Onion Pattern|Onion]] |
− | ###[[Reference: | + | ####[[Reference:Pavement Pattern|Pavement]] |
− | ###[[Reference: | + | ####[[Reference:Pigment Pattern|Pigment Pattern]] |
− | ###[[Reference: | + | ####[[Reference:Planar Pattern|Planar]] |
− | ###[[Reference: | + | ####[[Reference:Quilted Pattern|Quilted]] |
− | ###[[Reference: | + | ####[[Reference:Radial Pattern|Radial]] |
− | ###[[Reference: | + | ####[[Reference:Ripples Pattern|Ripples]] |
− | ###[[Reference: | + | ####[[Reference:Spherical Pattern|Spherical]] |
− | ##[[Reference:Pattern | + | ####[[Reference:Spiral1 Pattern|Spiral1]] |
− | ###[[Reference: | + | ####[[Reference:Spiral2 Pattern|Spiral2]] |
− | ###[[Reference: | + | ####[[Reference:Spotted Pattern|Spotted]] |
− | ###[[Reference: | + | ####[[Reference:Square Pattern|Square]] |
− | ###[[Reference: | + | ####[[Reference:Tiling Pattern|Tiling]] |
− | ###[[Reference: | + | ####[[Reference:Waves Pattern|Waves]] |
− | ##[[Reference:Pattern | + | ####[[Reference:Wood Pattern|Wood]] |
− | ###[[Reference: | + | ####[[Reference:Wrinkles Pattern|Wrinkles]] |
− | ###[[Reference: | + | ###[[Reference:Pattern#Discontinuous Patterns|Discontinuous Patterns]] |
− | ##[[Reference:Pattern | + | ####[[Reference:Cells Pattern|Cells]] |
− | ###[[Reference: | + | ####[[Reference:Checker Pattern|Checker]] |
− | ###[[Reference: | + | ####[[Reference:Crackle Pattern|Crackle Patterns]] |
− | ##[[Reference:Pattern | + | ####[[Reference:Object Pattern|Object Pattern]] |
− | # | + | ####[[Reference:Triangular Pattern|Triangular]] |
− | + | ###[[Reference:Pattern#Normal-Dependent Patterns|Normal-Dependent Patterns]] | |
− | ###[[Reference: | + | ####[[Reference:Aoi Pattern|Aoi]] |
− | ###[[Reference: | + | ####[[Reference:Slope Pattern|Slope]] |
− | ###[[Reference: | + | ###[[Reference:Pattern#Special Patterns|Special Patterns]] |
− | ###[[Reference: | + | ####[[Reference:Average Pattern|Average]] |
− | ###[[Reference: | + | ####[[Reference:Image Pattern|Image Pattern]] |
− | ###[[Reference: | + | ###[[Reference:Pattern#Pattern Modifiers|Pattern Modifiers]] |
− | ###[[Reference: | + | ##[[Reference:Atmospheric Effects|Atmospheric Effects]] |
− | ###[[Reference: | + | ###[[Reference:Atmospheric Effects#Atmospheric Media|Atmospheric Media]] |
− | + | ###[[Reference:Atmospheric Effects#Background|Background]] | |
− | ###[[Reference: | + | ###[[Reference:Atmospheric Effects#Fog|Fog]] |
− | ###[[Reference: | + | ###[[Reference:Atmospheric Effects#Sky Sphere|Sky Sphere]] |
− | ###[[Reference: | + | ###[[Reference:Atmospheric Effects#Rainbow|Rainbow]] |
− | ###[[Reference: | + | ##[[Reference:Media|Media]] |
− | ###[[Reference: | + | ###[[Reference:Media#Media Types|Media Types]] |
− | + | ###[[Reference:Media#Sampling Parameters & Methods|Sampling Parameters & Methods]] | |
− | ###[[Reference: | + | ###[[Reference:Media#Density|Density]] |
− | ###[[Reference: | + | ##[[Reference:Include Files|Include Files]] |
− | ###[[Reference: | + | ###[[Reference:Include Files#Main Files|Main Files]] |
− | + | ####[[Reference:Arrays.inc|arrays.inc]] | |
− | ###[[Reference: | + | ####[[Reference:Chars.inc|chars.inc]] |
− | ###[[Reference: | + | ####[[Reference:Colors.inc|colors.inc]] |
− | ###[[Reference: | + | ####[[Reference:Consts.inc|consts.inc]] |
− | ###[[Reference: | + | ####[[Reference:Debug.inc|debug.inc]] |
− | ###[[Reference: | + | ####[[Reference:Finish.inc|finish.inc]] |
− | ###[[Reference: | + | ####[[Reference:Functions.inc|functions.inc]] |
− | ###[[Reference: | + | ####[[Reference:Glass.inc|glass.inc, glass_old.inc]] |
− | ###[[Reference: | + | ####[[Reference:Math.inc|math.inc]] |
− | ###[[Reference: | + | ####[[Reference:Metals.inc|metals.inc]] |
− | # | + | ####[[Reference:Golds.inc|golds.inc]] |
− | ###[[Reference: | + | ####[[Reference:Rand.inc|rand.inc]] |
− | ###[[Reference: | + | ####[[Reference:Shapes.inc|shapes.inc]] |
− | ### | + | ####[[Reference:Shapes2.inc|shapes2.inc]] |
− | + | ####[[Reference:Shapesq.inc|shapesq.inc]] | |
− | ###[[Reference: | + | ####[[Reference:Skies.inc|skies.inc]] |
− | # | + | ####[[Reference:Stars.inc|stars.inc]] |
− | # | + | ####[[Reference:Stones.inc|stones.inc]] |
− | ###[[Reference:Font Files|font files (*.ttf)]] | + | ####[[Reference:Stdinc.inc|stdinc.inc]] |
− | ###[[Reference:Color_Map Files|color_map files (*.map)]] | + | ####[[Reference:Strings.inc|strings.inc]] |
− | ###[[Reference:Image Files|image files (*.png, *.pot, *.df3)]] | + | ####[[Reference:Textures.inc|textures.inc]] |
+ | ####[[Reference:Transforms.inc|transforms.inc]] | ||
+ | ####[[Reference:Woodmaps.inc|woodmaps.inc]] | ||
+ | ####[[Reference:Woods.inc|woods.inc]] | ||
+ | ####[[Reference:Logo.inc|logo.inc]] | ||
+ | ####[[Reference:Rad_def.inc|rad_def.inc]] | ||
+ | ####[[Reference:Screen.inc|screen.inc]] | ||
+ | ####[[Reference:Sunpos.inc|sunpos.inc]] | ||
+ | ###[[Reference:Include Files#Old Files|Old Files]] | ||
+ | ####[[Reference:Glass_old.inc|glass_old.inc]] | ||
+ | ####[[Reference:Shapes_old.inc|shapes_old.inc]] | ||
+ | ####[[Reference:Stage1.inc|stage1.inc]] | ||
+ | ####[[Reference:Stdcam.inc|stdcam.inc]] | ||
+ | ####[[Reference:Stones1.inc|stones1.inc]] | ||
+ | ####[[Reference:Stones2.inc|stones2.inc]] | ||
+ | ###[[Reference:Include Files#Other Files|Older Files]] | ||
+ | ####[[Reference:Font Files|font files (*.ttf)]] | ||
+ | ####[[Reference:Color_Map Files|color_map files (*.map)]] | ||
+ | ####[[Reference:Image Files|image files (*.png, *.pot, *.df3)]] |
Revision as of 17:08, 11 April 2012
This book provides a reference for the Persistence of Vision Ray-Tracer (POV-Ray). The documentation applies to all platforms to which this version of POV-Ray is ported. The platform-specific documentation is available for each platform separately.
This book is divided into these main parts:
- This introduction together with a complete reference on POV-Ray Options which explains options (set either by command line switches or by INI file keywords) that tell POV-Ray how to render the scenes.
- A complete reference on Scene Description Language in which you describe the scene.
- A complete reference on the Standard Include Files that come with the POV-Ray package, to be used in your scenes.
- Finally, a consolidation of the POV-Ray Scene Description Language in the Quick Reference.
This book covers only the generic parts of the program which are common to each version.
Note: Each version has platform-specific documentation not included here.
We recommend you finish reading the tutorial book then read the platform-specific information before using this reference.
The platform-specific docs will show you how to render a sample scene and will give you detailed description of the platform-specific features.
The Windows version documentation is available on the POV-Ray program's Help menu or by pressing the F1 key while in the program.
The Mac platform documentation is available via the Help menu as well as for viewing using a regular web browser. Details may be found in the POV-Ray MacOS Read Me which contains information specific to the Mac version of POV-Ray. It is best to read this document first.
The Unix / Linux version documentation can be found at the same place as
the platform independent part. Usually that is
/usr/local/share/povray-3.?/html
More about the notation used throughout this book may be found in the section Notation and Basic Assumptions.
Contents
- Command-line Options
- Scene Description Language
- Scene Description File
- Global Settings
- Camera
- Lighting Types
- Transformations
- Objects
- Textures
- Patterns
- Atmospheric Effects
- Media
- Include Files
- Main Files
- arrays.inc
- chars.inc
- colors.inc
- consts.inc
- debug.inc
- finish.inc
- functions.inc
- glass.inc, glass_old.inc
- math.inc
- metals.inc
- golds.inc
- rand.inc
- shapes.inc
- shapes2.inc
- shapesq.inc
- skies.inc
- stars.inc
- stones.inc
- stdinc.inc
- strings.inc
- textures.inc
- transforms.inc
- woodmaps.inc
- woods.inc
- logo.inc
- rad_def.inc
- screen.inc
- sunpos.inc
- Old Files
- Older Files
- Main Files