MegaPOV Documentation

MegaPOV 1.2.1

24 August 2005

Abstract

This documentation contains a complete set of information about MegaPOV. Here you can find descriptions from either script and patch writer point of view. This work is supposed to be an addition to complete the POV-Ray™ Documentation.


Table of Contents

1. Introduction
1.1. What is MegaPOV?
1.2. What's new
1.2.1. MegaPOV 1.2.1 - 24 August 2005
1.2.2. MegaPOV 1.2 - 4 July 2005
1.2.3. Previous versions of MegaPOV
1.3. Why should i use MegaPOV?
1.4. Enabling MegaPOV features
1.5. Where do I find MegaPOV?
1.5.1. Sources and binaries
1.5.2. Documentation and samples
1.5.3. Discussions
2. MegaPOV References
2.1. Options
2.1.1. Frame_Step
2.1.2. HDR (High Dynamic Range) image output
2.2. Expressions
2.2.1. Language directives
2.2.2. Built-in tokens
2.2.3. Functions
2.2.4. Internal functions
2.2.5. Polynomial solver in parser
2.2.6. Splines
2.2.7. Transforms
2.3. Camera
2.3.1. user_defined camera type
2.4. Objects
2.4.1. Common features
2.4.2. Text
2.4.3. Cloth simulation
2.4.4. Isosurface
2.4.5. Light Sources
2.5. Effects
2.5.1. Glow
2.5.2. Motion blur
2.5.3. Fur
2.6. Textures and patterns
2.6.1. Angle of incidence
2.6.2. Listed pattern
2.6.3. Projection pattern
2.6.4. Displace warp for patterns
2.6.5. Noise pigment
2.6.6. HDR (High Dynamic Range) image type
2.6.7. Bicubic interpolation for images
2.6.8. New camera_view pigment
2.7. Global Settings
2.7.1. Film exposure simulation
2.7.2. Custom tone mapping function
2.7.3. Radiosity
2.7.4. Mechanics simulation patch
2.7.5. Post processing
3. MegaPOV Include files
3.1. The 'mp_functions.inc' include file
3.2. The 'mp_consts.inc' include file
3.2.1. Output types for camera_view pigment
3.3. The 'mp_types.inc' include file
3.3.1. The Type_Of(Id) macro
3.3.2. The Type_Of_Spline(Id) macro
3.3.3. The Type_Of_Object(Id) macro
3.3.4. The Type_Of_Camera(Id) macro
3.4. The 'mechsim.inc' include file
3.4.1. general aspects
3.4.2. constants
3.4.3. The Vector_Function() macro
3.4.4. The Object generation macros
3.4.5. The topology generation macros
3.5. The 'pprocess.inc' include file
3.5.1. Macros with effects
3.5.2. Shared predefined effects
3.6. The 'tone_mapping.inc' include file
3.6.1. The Clip_Colors() macro
3.6.2. The Film_Exposure() macro
3.6.3. The Film_Exposure_Invert() macro
3.6.4. The Gamma_Correct() macro
3.6.5. The Brightness_Contrast() macro
4. Tutorials
4.1. Objects
4.1.1. Cloth simulation
4.2. Simulation
4.2.1. Mechanics simulation tutorial
4.3. HDRI (High dynamic range illumination)
4.3.1. HDRI tutorial
5. Internals
5.1. Sources
5.1.1. Understanding the POV-Ray source structure
5.1.2. Creating your own patches
5.2. Binaries
5.2.1. compiling on Windows systems
5.2.2. compiling on Macintosh systems
5.2.3. compiling on Unix systems
5.3. Parser
5.3.1. Adding tokens
5.4. Patterns
5.4.1. Reducing memory usage
5.5. Expressions
5.5.1. Polynomial solver
5.6. Multi-format Documentation with DocBook
5.6.1. Environment for DocBook documentation
5.6.2. Editing DocBook documentation
5.6.3. Converting DocBook documents
6. Appendices
6.1. MegaPOV-Team
6.2. Contribution
6.3. MegaPOV before POV-Ray 3.6
6.3.1. MegaPOV history
6.3.2. Authors of patches in MegaPOV below version 1.0
Index

List of Figures

2.1. Force based environment collisions illustration
2.2. Impact based environment collisions illustration
2.3. Mass-mass collisions illustration
2.4. Mass-face collisions illustration
2.5. Connection-connection collisions illustration
3.1. patch connection numbers

List of Tables

2.1. The following time formatting strings are available:
2.2. HDR image ambient variations
2.3. Exposure influence comparison
2.4. internal sequence
2.5. halton sequence
3.1. MechSim_Show_Grid() variations
3.2. MechSim_Show_Patch() variations
3.3. MechSim_Show_Patch() variations
4.1. Example for high dynamic range of raytraced scene
4.2. Views and illumination maps from the scene
4.3. The illumination maps being used in a scene
6.1. Current MegaPOV-Team Members

List of Examples

2.1. Influence of Frame_Step on generated files
2.2. Using the #set directive
2.3. date function usage
2.4. Using the timer function
2.5. Averaging frames with output_filename function
2.6. Polynomial solver usage
2.7. Conversion from the sor object definition to the sor_spline type in spline
2.8. Alternative forms of user_defined camera type definition
2.9. HDR image example
2.10. Bicubic interpolation for an image map
2.11. Various values for film exposure simulations
2.12. Exponential tone mapping
2.13. Adaptive time stepping
2.14. An example for a complete collision{} section:
2.15. Mass interaction
2.16. Constant downward force in Mechanics simulation
2.17. Attachment in Mechanics simulation
2.18. The simulation data file format
2.19. The internal post process function asking for red color at the middle of image
2.20. Post processing which does nothing (only duplicate the original image)
2.21. Post processing which turns the rendered image into a gray scale image
3.1. MechSim_Show_Objects() macro usage
3.2. MechSim_Show_All_Objects() macro usage
3.3. MechSim_Show_Grid() macro usage
3.4. MechSim_Show_Patch() macro usage
3.5. MechSim_Show_Sphere() macro usage
3.6. VE_Elements array generation
3.7. MechSim_Generate_Grid_Fn() macro usage
3.8. MechSim_Generate_Grid() macro usage
3.9. MechSim_Generate_Grid_Std() macro usage
3.10. MechSim_Generate_Box() macro usage
3.11. MechSim_Generate_Block() macro usage
3.12. MechSim_Generate_Patch() macro usage
3.13. MechSim_Generate_Patch_Std() macro usage
3.14. MechSim_Generate_Line() macro usage
3.15. MechSim_Generate_Line() macro usage
3.16. MechSim_Generate_Sphere() macro usage
3.17. Find edge macro
5.1. Typical patch markup