Scene Files Review

Guidelines

NOTE: This whole thing is a DRAFT ONLY for now!

• Feel free to create new pages for the individual scenes to review, if you find something worth of note. (Please use Markdown edit mode.)
• Feel free to add comments if you find something worth of note that hasn't been mentioned yet.
• Feel free to add files that have slipped through the cracks somehow.
• Please do NOT delete comments made by others.
• Please do NOT tick off boxes unless you're sure about it.

Also, feel free to leave a comment at the bottom of this page if you have any suggestions how to improve this vetting process.

We have the following groups of scenes (and similar) to review:

Sample Scenes

• scenes/advanced: Complex sample scenes.
• scenes/animations: Sample animations.
• scenes/camera: Sample scenes demonstrating cameras and camera parameters.
• scenes/incdemo: Sample scenes demonstrating the include files shipping with POV-Ray.
• scenes/interior: Sample scenes demonstrating object interiors and interior parameters.
• scenes/language: Sample scenes demonstrating scene description language features.
• scenes/lights: Sample scenes demonstrating light sources and light source parameters.
• scenes/objectmods: Sample scenes demonstrating generic object modifiers.
• scenes/objects: Sample scenes demonstrating geometric primitives and CSG geometry.
• scenes/output: Sample scenes demonstrating image output options.
• scenes/portfolio: Sample scenes demonstrating all available features of particular types.
• scenes/radiosity: Sample scenes demonstrating radiosity.
• scenes/textures: Sample scenes demonstrating textures and texture parameters.

Odds & Ends

• scenes/bsp/Tango.pov: Sample scene demonstrating the BSP bounding tree.
• scenes/qtvr/qtvrpanorama.pov: Sample scene demonstrating how to create QTVR panorama movies.
• scenes/subsurface/subsurface.pov: Sample scene demonstrating subsurface light transport.
• scenes/templates: Code snippets to use as building blocks for your own scene.

Related Files

• include: The include files shipping with POV-Ray
• Insert Menu: Code snippets provided for use with POV-Ray for Windows

Review Criteria

For now, please review each scene under the following criteria:

• Does it match formal standards?
  • Does it carry licensing information in its header comments?
• Does it match basic technical standards?
  • Does it render without any warnings?
  • Does it start with a #version directive?
  • Does it start with at least a #version 3.7; directive (or is there a variant of the scene that does)?
  • Does it provide information about the recommended resolution in a standardized format, that is:
    • as part of its accompanying INI file, if any (e.g. +w800 +h600), and/or
    • as a dedicated comment line in its header (e.g. // +w800 +h600)?
  • Is there a corresponding image in the scenes/previews tree? If so,
    • does the preview image file name exactly match the scene directory or file name?
    • Is the preview image up to date?

If an image is flawless with respect to these criteria, please tick off the "Passes baseline checks" box. Otherwise, please leave a corresponding comment, either here in the Wiki or on issue #419

At a later stage, we might also want to review the scenes under the following criteria:

• Does it match further technical standards?
  • (TBD)
• Does it match aesthetic standards?
  • Does it look reasonably bright (neither washed out nor overly dark)?
  • Does it look undistorted (when rendered at the recommended resolution)?
  • Is it free from artifacts?
  • Is it free from other oddities?

Suggested Improvements

(TBD)