Difference between revisions of "Documentation:ToDo ChangeListReview"

From POV-Wiki
Jump to navigation Jump to search
m (continued list cleanup)
m (updates)
 
(18 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
==Change Log Extracts==
 
==Change Log Extracts==
These are [http://www.povray.org/beta/changes.txt change-log] extracts that might be useful with helping to update the documentation. There are some items still to be done, they're categorized, while items that have been [[Documentation:ToDo\CLReview#Completed Items|completed]] are at the bottom of this page.
+
The [http://www.povray.org/beta/changes.txt change-log] has been reviewed and these items below have been added into the documentation.  --[[User:Jholsenback|jholsenback]] 19:35, 27 October 2010 (UTC)
===What's New===
+
===Whats New===
These are items that can be added to the yet to be written, <em>What's New in POV-Ray 3.7</em> section basically as is, or one-liners.
+
* A platform independent change summary has been completed
 
+
:* See it [[Doc:Tutorial Section 1#Changes and New Features Summary|here]]: --[[User:Jholsenback|jholsenback]] 16:21, 23 August 2010 (UTC)  
# Added "out-of-the-box" transparency support for GIF files.
+
* The Windows change summary has been completed
# Added support for PNG sRGB chunks.
+
:* See it [[Doc:Windows Section 1#What's new in POV-Ray for Windows|here]]: --[[User:Jholsenback|jholsenback]] 18:37, 22 October 2010 (UTC)
# Windows console version now sends stream output to stderr by default.
+
* Setup (WIP) a Mac OS change summary
# Added Control-A support in windows version commandline input box (select all).
+
:* See it [[Doc:Mac OS Section 1#What's new in POV-Ray for Mac OS|here]]: --[[User:Jholsenback|jholsenback]] 19:35, 27 October 2010 (UTC)
# Changed windows version render window keypress code to hand focus to main window for any key, not just escape.
+
* Setup (WIP) a Unix change summary
# Expanded number of available insert menu ID's to about 9000. Added support for loading of JPG and PNG files as insert menu hints. The search order is PNG, then JPG and if they don't exist then BMP.
+
:* See it [[Doc:Unix Section 2#What's new in POV-Ray for Unix|here]]: --[[User:Jholsenback|jholsenback]] 19:35, 27 October 2010 (UTC)
# Windows editor tab/indent settings are no longer per-file+global default; changing one affects all files.
+
===Radiosity===
# Added display of filename when hovering over an editor tab.
 
# Added right-click menu to editor tabs allowing opening of folder in explorer and copy of filename to clipboard.
 
# New thread-safe random number generator added.
 
 
 
===Photons===
 
# Refer [http://bugs.povray.org/task/93?project=2&order=id&sort=desc&pagenum=4 FS#93] (Photons are unnaturally amplified by pass_through objects)<br>As the error is also present in POV-Ray 3.6, behavior has necessarily changed with this fix; pass_through objects will now affect the color of photons on their way to their target, according to pigment filter/transmit, interior fade, and media (which implies that opaque objects will block photons even when declared pass_through); it needs to be seen whether this new behavior will be accepted by the users, or whether some additional mechanism will have to be implemented to choose between old and new behavior for compatibility with legacy scenes. At present, behavior can only be changed at compile time with the preprocessor defines PT_FILTER_BEFORE_TARGET and PT_AMPLIFY_BUG in photons.cpp.
 
# Added multiple-thread support to photon shooting code. To take advantage of this at the moment, your scene will need multiple light sources.
 
 
 
===Linux/Unix===
 
# Linux: rework <code>--benchmark</code>. The built-in benchmark now accepts <code>+L<path></code> command-line options and does no longer read any INI file but the provided one.
 
# Added preliminary Linux support for these two features
 
#* CPU timer; might return incorrect results depending on the platform.
 
#* signal catching (e.g. when aborting a render by hitting Ctrl+C).
 
# Added support for 'pause when done' in linux build.
 
# Added support for <code>--benchmark</code> on unix works together with <code>+wt</code> and print built-in features with <code>--version</code>
 
# Unix default file gamma changed from from 1.0 to 2.2.
 
 
 
===Image Related===
 
# Added experimental support for reading the pixel resolution of an image map. This is done by giving an image map pigment identifier to <code>max_extent()</code>, which will then return the resolution of the image map as the x and y values of the returned vector.
 
# Partial fix for broken alpha channel output; v3.6 behavior is now reproduced exactly (including bugs), regardless of version. Further changes will address the premultiplied-alpha issue (which was already handled wrong in 3.6) and possibly add options for use cases where v3.6 behavior might be undesired.
 
# Changes to input image transparency handling:
 
#* For <code>material_map</code>, <em>no</em> alpha premultiplication handling is done whatsoever; instead, the data as stored in the file is used.
 
#* For <code>bump_map</code> and <code>image_pattern</code>, images with alpha channel are treated as if they had a black background (unless the alpha channel itself is used).
 
# Changed antialiasing to compare gamma-adjusted colours instead of linear colours, to improve antialiasing of darker regions.
 
#* Note that this gamma-adjustment is only applied to copies of the sample values, and does not affect averaging of the sample values, which is still performed on the original linear data. It is also independent of both preview display and output file gamma.
 
#* The antialiasing gamma-adjustment is controlled by the new ini-file / command-line options <code>Antialias_Gamma=x</code> and <code>+AGx</code> respectively, defaulting to 2.5. Note that this differs from Display_Gamma and File_Gamma defaults, as it is intended to fit human vision rather than typical CRT characteristics. Nevertheless, the value specified is once again the inverse of the gamma actually applied, in order to use the more familiar value range.
 
# Changed input file gamma syntax for individual files; as an alternative to the <code>file_gamma</code> keyword, the parser will now also accept the <code>gamma</code> keyword originally introduced for specifying gamma in color values. (To specify the default input file gamma in the global_settings section, <code>file_gamma</code> is still mandatory though, as <code>gamma</code> would be ambiguous and misleading.)
 
# Added <code>premultiplied</code> BOOL parameter to input image file syntax.
 
#* Like the gamma/file_gamma parameter, it must immediately follow the filename (though the order of gamma/file_gamma and premultiplied does not matter).
 
#* The boolean parameter specifies whether the file is stored in <code>premultiplied</code> <em>associated</em> or non-premultiplied <em>straight</em> alpha format, overriding the file format specific default. This keyword has no effect on files without an alpha channel.
 
# Added support for using the sRGB transfer function for output file gamma the syntax is <code>File_Gamma=sRGB</code>. <em>SRGB</em> and <em>srgb</em> are supported as well.
 
#* Note that when <code>File_Gamma=sRGB</code> is used with PNG output file format, POV-Ray writes an sRGB chunk, thereby claiming that the output conforms to the sRGB color space; however, this claim is not necessarily true, as POV-Ray is currently not color space aware; it depends on whether your scene input data conforms to the sRGB color space.
 
#* The other gamma INI file parameters <code>Antialias_Gamma</code> and <code>Display_Gamma</code> do NOT support the <em>sRGB</em> value at present.
 
 
 
===Identifiers and Keywords===
 
The following needs to be added to the identifiers and keywords [[Doc:Reference_Section_2#Identifiers_and_Keywords|list]]. A review of the syntax diagrams in the main and quick reference sections should also be done to double check!
 
 
 
# aoi
 
# area_illumination
 
# deprecated
 
# cubic (pattern)
 
# cubic (warp)
 
# elseif
 
# for
 
# file_gamma
 
# gamma
 
# maximum_reuse
 
# mm_per_unit
 
# no_radiosity
 
# premultiplied
 
# sint16be, sint16le
 
# sint32be, sint32le
 
# srgb
 
# subsurface
 
# uint8, sint8
 
# uint16be, uint16le
 
 
 
===Windows===
 
# Added 'alternate render file' feature to povwin IDE. See [[Doc:ToDo\CLReview#Windows Editor Changes|comments]] below.
 
# Added extensions .MCR and .MAC to the list of files povwin considers include files (i.e. which are filtered<br>as such in the various file dialogs and assigned the POV file type for the editor syntax highlighting).
 
# Added .INI file type to povwin editor syntax highlighting.
 
# Added window menu to povwin IDE. Entries are MRU-sorted.
 
# Added these POVWIN features
 
#* <em>file modified</em> indicator to filename shown in POVWIN main window caption.
 
#* notification for when auto-reload results in files being auto-saved.
 
# Added ability to close edit tab in windows version by middle-clicking on it. (NB this means on the tab itself, not the contents of the tab). Also, Ctrl-W now defaults to closing the current editor file.
 
# Added <code>/EDITDLLPATH</code> command-line parameter, which overrides the default edit DLL locations for the windows version.
 
# Added SEH and minidump generation to windows code. After an unhandled exception POVWIN will now offer the option of creating a minidump (brief or full) for submission to the team to assist in tracking down crashes.
 
# Added ability to specify thread count from Windows version render menu (unsaved setting)
 
# Default output file type is now PNG (SYS format is still mapped to BMP though): done --[[User:Jholsenback|jholsenback]] 11:44, 8 July 2010 (UTC)
 
 
 
====Windows Editor Changes====
 
There been two notable changes to the POVWIN IDE.
 
# Firstly, it now has a Window menu, which is located where the GUIEXT menu used to be (the latter has moved to within the Options menu). While technically a Window menu is not necessary, as all open files are visible in tabs, the addition of this menu provides two advantages:
 
#* We can provide the option of showing all tabs on a single line, with a scroller to view non-visible ones. This has not yet been added but will be at a later point.
 
#* The MRU arrangement of the window menu makes it trivial to toggle between files without taking your eyes off the text or using the mouse. The most recently view window (i.e. the current one) will always be entry 1 in the list. The second most recently viewed (i.e. the last window viewed before switching to the current one) will always be entry 2 in the list, and so forth. Given that entries 1 through 10 in the list are given the menu mnemonics 1 through 0 respectively, it is therefore clear that to toggle between the current and previous files all you need to do is hit Alt-W then 2. To go to the third oldest, Alt-W then 3, and so forth. Currently, the MRU list is not saved on exit. This will be added. We may also add keyboard accelerators (e.g. ALT-2, ALT-3 etc) as a shortcut for Alt-W 2, etc.
 
# Secondly, there is now an 'alternate render file' feature. This is intended to make things easier when editing macro or include files. While it is possible to use SDL to detect whether a macro/include file is being rendered directly and to pull in supporting code, that approach is not very flexible. The alternate render file feature allows a render to be started on an include file, and instead of the include file being rendered directly (as would have happened previously), the source file that most recently included that file in a render will be rendered instead.
 
<p class="Note"><strong>Note:</strong> by 'source file', we mean either a .POV or .INI file.</p>
 
:: For this feature to work, you need to have rendered a file which includes the target file during the current editing session (the association between include files and source files is not persisted when POVWIN exits). Additionally you need to have requested to render a source file which does not have the .POV or .INI extension. When you request the render, a message box will appear asking you what to do. You can choose to render the alternate file this time only, to render the alternate file each time you render this one, or to render this one each time (i.e. disable the alternate file option). In all cases, the choice you give only persists for the current editing session; it is not restored when you re-launch POVWIN. this is by design.
 
 
 
====Render Window====
 
<p>Due to issues with CPU usage, the new render window is now by default off. To work well this feature requires that hardware-assisted alpha blending is available on the target system, and as of the time of writing this is not common enough to justify turning it on by default.</p>
 
<p class="Note"><strong>Note:</strong> it will remain turned on if you already had it on (e.g. from a previous beta).</p>
 
<p>The new render window mode is only available on Windows 2000 or later. The presence of this code may case the beta to be unable to load on Windows 9x systems; if this occurs it will be fixed in the next beta.</p>
 
<p class="Note"><strong>Note:</strong> that we have not tested this new code on a Windows 2000 system, so we can't comment on how well it will work on those systems.</p>
 
<p>To activate the new render window, open the 'Render Window' sub-menu in the 'Options' menu, and select the 'Use New-style Render Window' entry.</p>
 
<p>The new render window is designed to help users get around the issue of the render window getting in the way when doing edit/render/fix cycles. It supports a 'transparency' mode that is in effect two things: both optical transparency (or more specifically translucency), and input transparency (more specifically, the Windows WS_EX_TRANSPARENT style).</p>
 
<p>'Input transparency' means that the window is transparent to input - so if you move your mouse over it or attempt to click on it, the mouse messages are in fact sent to whatever is underneath the window. In effect therefore it is as if the window were not there - even if you can still see it.</p>
 
<p>The effect of this is that, coupled with translucency, you can both see what is under the window (e.g. the POV-Ray editor), and also work with it (typing or selecting with the mouse, etc).</p>
 
<p>'Input Transparency' is enabled whenever you set the translucency of the render window to 25% or more (see below). At settings less than this, the render window will behave more or less as normal (though without some of the features of the classic render window, such as the ability to be de-coupled from the main window such that it does not get hidden when the main window is minimized).</p>
 
<p>To set the translucency of the render window, either rotate your mouse wheel when the render window has focus (this is the preferred method), or alternatively right-click on the window's title bar and choose a setting from the context menu that is provided.</p>
 
<p>When the render window has input focus, translucency is removed and it becomes opaque. It will switch back once another window gets focus, or if you adjust the translucency using one of the above methods.</p>
 
<p>If you want to work with input transparency, it is important that you understand that this means you can't work with the render window in the manner you are accustomed to, since of course the window will pass input to the application below it. To allow for interaction with the window in this circumstance, we have added a feature whereby hovering the mouse over the render window's caption for a short time, or clicking on the title bar, will activate the window, make it opaque, and allow input to be processed normally.</p>
 
<p>Of course the ability to click on the caption means that it's not completely input transparent, and we might disable this feature later if the hover feature works out well.</p>
 
<p>You will know if your mouse is over the appropriate area of the window since the cursor will turn to a hourglass shape during the 'hover' time.</p>
 
<p>Provided that the window is left in input transparency mode, if you move your mouse out of the window for a short time, it will automatically snap back into its former translucent mode.</p>
 
<p>You can tell if the window is in input transparency mode by looking for a '[T]' at the start of the render window caption. If present, then it's going to pass input to the application underneath it. While adjusting the translucency with the mouse wheel, the caption will display the new translucency setting and, if appropriate, a comment that the window has switched to passing input. (Recall however that this doesn't kick in until you switch focus to another window).</p>
 
 
 
===Miscellaneous===
 
# Added RTR (real-time raytracing), clockless animation, and video capture support (windows only). POV-Ray now has some highly experimental support for a real-time raytracing loop. This is basically a mode where a single pre-parsed scene is rendered multiple times with no re-parsing inbetween frames. The camera is moved according to camera definitions provided in the main scene file. Additionally, on windows, a live video stream (e.g. from a webcam) may be mapped into the image in exactly the same way that a normal image map may be. Please refer to the full [http://www.povray.org/beta/rtr/ documentation] on these features. done: --[[User:Jholsenback|jholsenback]] 18:44, 14 July 2010 (UTC)
 
# Added <code>#declare atand = function (x) {degrees(atan(x))}</code> to "math.inc".
 
# You now have the ability to specify the render block size via either an INI-style option <code>Render_Block_Size=n</code> or on the command-line <code>+BSn</code>, where 'n' is an integer larger than or equal to 4. This represents the edge size of the square used to distribute work to the render threads, and thus the number of pixels in each block will be n squared. The default value is 32. If you specify a value that is greater than the larger of the width or height of the image being rendered, it is clipped to that value. Using render block sizes of less than eight can impact performance, particularly on large images that render quickly, as it significantly increases the amount of message traffic between the render backend and the graphical frontend (which communicate using a shared-memory queue).
 
# Some changes to sky_sphere handling:
 
#* Using filter in a sky_sphere with layered pigments now has the same effect as in a large sphere with a multi-layered texture. (For compatibility with legacy scenes, specifying a #version < 3.7 will revert to the old, poorly specified behavior.)
 
#* Using <code>Output_Gamma=on</code> with legacy scenes (#version < 3.7) will now suppress sky spheres and background except in reflections, for backward compatibility with v3.6.
 
# Implemented adaptive radiosity pretrace. When a second parameter is specified after the <code>nearest_count</code> keyword, pretrace will stop re-iterating over areas where, on average, that many (average-quality) samples are already present per ray.
 
# Parser now checks for plausible relation between radiosity <code>minimum_reuse</code> and <code>maximum_reuse</code>:
 
#* If ony one value is specified, parser will warn if minimum_reuse > maximum_reuse/2, and adjust the unspecified value accordingly.
 
#* If both values are specified, parser will warn if minimum_reuse > maximum_reuse/2, but not modify any of the values; if minimum_reuse >= maximum_reuse; the parser will raise an error.
 
# Added <code>emission</code> parameter to the finish block. done: --[[User:Jholsenback|jholsenback]] 13:16, 13 July 2010 (UTC)
 
#* syntax and effect are virtually identical to ambient, except that emission is unaffected by the global ambient_light parameter, which will now effectively be set to 0 if radiosity is active, except in legacy scenes having #version set to < 3.7
 
#* The intention is to simplify the use of materials designed for non-radiosity scenes in scenes with radiosity, or the design of scenes that can be rendered with or without radiosity.
 
# The version directive and command-line setting no longer provide compatibility with most rendering bugs in versions prior to POV-Ray 3.5. However, compatibility with the scene language is provided for scenes as old as POV-Ray 1.0 just as in all previous versions of POV-Ray. Nevertheless, we strongly recommend you update scenes at least to POV-Ray 3.5 syntax if you plan to use them in future versions of POV-Ray. done: --[[User:Jholsenback|jholsenback]] 13:16, 13 July 2010 (UTC)
 
# This version uses multi-threaded rendering by default. The ability to render in more than one thread is primarily of use to those users who have SMP machines (i.e. more than one CPU). There have been reports of benefits for users of hyperthreading systems, particularly with higher thread counts (e.g. 16 threads). You can render in only one thread by using the <code>/THREADS 1</code> switch in the Windows version. Note that parsing and photon building will only use one thread no matter how many are specified. However photon scenes will benefit from multiple threads once photon building has completed.
 
# Mosaic preview now works again. The same issue as mentioned in the above section on render block size apply; we don't recommend using an end preview size of less than 8. Note that unless you specify an end preview size the code will default to using <code>+ep2</code>, so it is strongly recommended that you do provide it.
 
# Added #elseif statement; the #if, #ifdef and #ifndef directives syntax is changed as follows:
 
<pre>
 
IF_DIRECTIVE:
 
  #if ( Cond ) TOKENS... [ELSE_DIRECTIVE] #end
 
IFDEF_DIRECTIVE:
 
  #ifdef ( IDENTIFIER ) TOKENS... [ELSE_DIRECTIVE] #end
 
IFNDEF_DIRECTIVE:
 
  #ifndef ( IDENTIFIER ) TOKENS... [ELSE_DIRECTIVE] #end
 
 
 
ELSE_DIRECTIVE:
 
  #else TOKENS... |
 
  #elseif ( Cond ) TOKENS... [ELSE_DIRECTIVE]
 
</pre>
 
* Example:
 
<pre>
 
#if (Foo)
 
  #debug "Foo is true\n"
 
#elseif (Bar)
 
  #debug "Foo is false, but Bar is true\n"
 
#else
 
  #debug "Foo and Bar are both false\n"
 
#end
 
</pre>
 
 
 
==In Progress==
 
# Changed alpha handling for image file input and output:
 
#* Previous versions of POV-Ray always expected straight (non-premultiplied) alpha for file input, while always writing associated (premultiplied) alpha for output; this has been changed on a per-file-format basis to use the same alpha handling mode for input and output alike:
 
#** PNG will use straight alpha as per specification.
 
#** OpenEXR and TIFF will use associated alpha as per specifications.
 
#** TGA and BMP 32-bit RGBA (an inofficial extension to BMP) will use straight alpha, retaining file input compatibility for now, until a final decision has been made on these formats.
 
# When generating non-premultiplied alpha output to a classic low-dynamic-range file format (e.g. PNG), transparency of particularly bright areas will now be reduced, in order to better preserve highlights on transparent objects. (Note that this mechanism has some limitations with colored highlights.)
 
# When used with file formats for which alpha output is currently not supported by POV-Ray (or only via an inofficial extension, as with BMP), turning on alpha output via Output_Alpha=on or +UA will now generate a warning.
 
* I'm currently working on the above 3 items: --[[User:Jholsenback|jholsenback]] 17:28, 19 July 2010 (UTC)
 
 
 
==Completed Items==
 
====Radiosity====
 
 
* Speed up radiosity pretrace option
 
* Speed up radiosity pretrace option
:* Check [[Doc:Reference_Section_1.3#Radiosity_Vain_Pretrace|here]]: --[[User:Jholsenback|jholsenback]] 18:38, 23 May 2010 (UTC)
+
:* See it [[Doc:Reference_Section_1.3#Radiosity_Vain_Pretrace|here]]: --[[User:Jholsenback|jholsenback]] 18:38, 23 May 2010 (UTC)
 
* Revival of Radiosity Load/Save
 
* Revival of Radiosity Load/Save
:* Check [[Doc:Reference_Section_1.3#Radiosity_Load_and_Save|here]]: --[[User:Jholsenback|jholsenback]] 18:39, 23 May 2010 (UTC)
+
:* See it [[Doc:Reference_Section_1.3#Radiosity_Load_and_Save|here]]: --[[User:Jholsenback|jholsenback]] 18:39, 23 May 2010 (UTC)
 
* New radiosity &quot;high reproducibility&quot; mode
 
* New radiosity &quot;high reproducibility&quot; mode
:* Check [[Doc:Reference_Section_1.3#Radiosity_High_Reproducibility|here]]: --[[User:Jholsenback|jholsenback]] 18:39, 23 May 2010 (UTC)
+
:* See it [[Doc:Reference_Section_1.3#Radiosity_High_Reproducibility|here]]: --[[User:Jholsenback|jholsenback]] 18:39, 23 May 2010 (UTC)
 
* Radiosity <code>maximum_reuse</code> parameter
 
* Radiosity <code>maximum_reuse</code> parameter
:* Check [[Doc:Reference_Section_3.2#maximum_reuse|here]]: --[[User:Jholsenback|jholsenback]] 15:12, 31 May 2010 (UTC)
+
:* See it [[Doc:Reference_Section_3.2#maximum_reuse|here]]: --[[User:Jholsenback|jholsenback]] 15:12, 31 May 2010 (UTC)
 
* Added <code>no_radiosity</code> keyword
 
* Added <code>no_radiosity</code> keyword
:* Check [[Doc:Reference_Section_3.2#no_radiosity|here]]: --[[User:Jholsenback|jholsenback]] 15:14, 31 May 2010 (UTC)
+
:* See it [[Doc:Reference_Section_3.2#No Radiosity|here]]: --[[User:Jholsenback|jholsenback]] 15:14, 31 May 2010 (UTC)
 +
* Implemented adaptive radiosity pretrace.
 +
:* See it [[Doc:Reference_Section_3.2#nearest_count|here]]: --[[User:Jholsenback|jholsenback]] 15:25, 6 August 2010 (UTC)
 +
* Parser now checks for plausible relation between radiosity <code>minimum_reuse</code> and <code>maximum_reuse</code>:
 +
:* See it [[Doc:Reference_Section_3.2#maximum_reuse|here]]: --[[User:Jholsenback|jholsenback]] 15:25, 6 August 2010 (UTC)
  
====New Features====
+
===New Features===
 
* Diffuse backside illumination
 
* Diffuse backside illumination
:* Check [[Doc:Reference_Section_5.1#Diffuse|here]]:--[[User:Jholsenback|jholsenback]] 13:39, 6 April 2010 (UTC)
+
:* See it [[Doc:Reference_Section_5.1#Diffuse|here]]:--[[User:Jholsenback|jholsenback]] 13:39, 6 April 2010 (UTC)
 +
* Added a new list pattern type: <code>cubic</code>
 +
:* See it [[Doc:Reference_Section_5.3#Cubic|here]]: --[[User:Jholsenback|jholsenback]] 19:11, 15 April 2010 (UTC)
 +
* Added a new warp type: <code>cubic</code>
 +
:* See it [[Doc:Reference_Section_5.6#Mapping_using_warps|here]]: --[[User:Jholsenback|jholsenback]] 19:11, 15 April 2010 (UTC)
 
*AOI Pattern
 
*AOI Pattern
:* Check [[Doc:Reference_Section_5.3#Aoi|here]]: --[[User:Jholsenback|jholsenback]] 01:50, 18 May 2010 (UTC)
+
:* See it [[Doc:Reference_Section_5.3#Aoi|here]]: --[[User:Jholsenback|jholsenback]] 01:50, 18 May 2010 (UTC)
 
* Slope Pattern extension
 
* Slope Pattern extension
:* Check [[Doc:Reference_Section_5.5#Slope|here]]: --[[User:Jholsenback|jholsenback]] 11:40, 19 May 2010 (UTC)
+
:* See it [[Doc:Reference_Section_5.5#Slope|here]]: --[[User:Jholsenback|jholsenback]] 11:40, 19 May 2010 (UTC)
 
* Subsurface scattering
 
* Subsurface scattering
:* Check [[Doc:Reference_Section_5.1#Subsurface_Light_Transport|here]]: --[[User:Jholsenback|jholsenback]] 17:55, 27 May 2010 (UTC)
+
:* See it [[Doc:Reference_Section_5.1#Subsurface_Light_Transport|here]]: --[[User:Jholsenback|jholsenback]] 17:55, 27 May 2010 (UTC)
 +
* Added support for full area light diffuse and specular illumination
 +
:* See it [[Doc:Reference_Section_4.4#Area_Lights|here]]: --[[User:Jholsenback|jholsenback]] 14:36, 14 June 2010 (UTC)
 +
* Added <code>emission</code> parameter to the finish block
 +
:* See it [[Doc:Reference_Section_5.1#Emission|here]]: --[[User:Jholsenback|jholsenback]] 13:16, 13 July 2010 (UTC)
 +
* Added RTR (real-time raytracing), clockless animation, and video capture support
 +
:* See it [[Doc:Reference_Section_1#Real-Time_Raytracing|here]]: --[[User:Jholsenback|jholsenback]] 18:44, 14 July 2010 (UTC)
 +
* Added <code>atand</code> function to &quot;math.inc&quot;.
 +
:* See it [[Doc:Reference_Section_7.2#Float_functions_and_macros|here]]: --[[User:Jholsenback|jholsenback]] 15:25, 6 August 2010 (UTC)
 +
* You now have the ability to specify the render block size
 +
:* See it [[Doc:Reference_Section_1.3#Render_Block_Size|here]]: --[[User:Jholsenback|jholsenback]] 15:25, 6 August 2010 (UTC)
  
====Gamma====
+
===Gamma===
 
* Non-legacy scene default gamma handling for image input files
 
* Non-legacy scene default gamma handling for image input files
:* Check [[Doc:Reference_Section_3.1#Image_File_Gamma|here]]: --[[User:Jholsenback|jholsenback]] 09:49, 5 May 2010 (UTC)
+
:* See it [[Doc:Reference_Section_3.1#Image_File_Gamma|here]]: --[[User:Jholsenback|jholsenback]] 09:49, 5 May 2010 (UTC)
 
* <code>assumed_gamma</code> and <code>File_Gamma</code>
 
* <code>assumed_gamma</code> and <code>File_Gamma</code>
:* Check [[Doc:Reference_Section_3.1#Global_Settings|here]], [[Doc:Reference_Section_3.1#Assumed_Gamma|here]], [[Doc:Reference_Section_3.1#Image_File_Gamma|here]] and [[Doc:Reference_Section_3.1#Scene_File_Gamma|here]]: --[[User:Jholsenback|jholsenback]] 13:32, 11 June 2010 (UTC)
+
:* See it [[Doc:Reference_Section_3.1#Global_Settings|here]], [[Doc:Reference_Section_3.1#Assumed_Gamma|here]], [[Doc:Reference_Section_3.1#Image_File_Gamma|here]] and [[Doc:Reference_Section_3.1#Scene_File_Gamma|here]]: --[[User:Jholsenback|jholsenback]] 13:32, 11 June 2010 (UTC)
 
* <code>gamma</code> keyword to specify gamma pre-corrected colours
 
* <code>gamma</code> keyword to specify gamma pre-corrected colours
:* Check [[Doc:Reference_Section_2.1#Specifying_Colors|here]]: --[[User:Jholsenback|jholsenback]] 14:51, 9 July 2010 (UTC)
+
:* See it [[Doc:Reference_Section_2.1#Specifying_Colors|here]]: --[[User:Jholsenback|jholsenback]] 14:51, 9 July 2010 (UTC)
  
==== SDL====
+
=== SDL===
 
* Added ability to declare an identifier as deprecated
 
* Added ability to declare an identifier as deprecated
:* Check [[Doc:Reference_Section_2.4#Deprecation_Support|here]]: --[[User:Jholsenback|jholsenback]] 13:21, 31 March 2010 (UTC)
+
:* See it [[Doc:Reference_Section_2.4#Deprecation_Support|here]]: --[[User:Jholsenback|jholsenback]] 13:21, 31 March 2010 (UTC)
 +
* Added comparison (<code>=</code>, <code>!=</code>, <code><</code>, <code><=</code>, <code>></code>, <code>>=</code>) support for strings
 +
:* See it [[Doc:Reference_Section_2.3#String_Relational_Operators|here]]: --[[User:Jholsenback|jholsenback]] 14:15, 6 April 2010 (UTC)
 
* <code>#break</code> directive behavior  
 
* <code>#break</code> directive behavior  
:* Check [[Doc:Reference_Section_2.5#The_.23switch.2C_.23case.2C_.23range_and_.23break_Directives|here]]: --[[User:Jholsenback|jholsenback]] 18:11, 26 May 2010 (UTC)
+
:* See it [[Doc:Reference_Section_2.5#The_.23switch.2C_.23case.2C_.23range_and_.23break_Directives|here]]: --[[User:Jholsenback|jholsenback]] 18:11, 26 May 2010 (UTC)
 
* ARRAYS_WriteDF3 macro
 
* ARRAYS_WriteDF3 macro
:* Check [[Doc:Reference_Section_7#arrays.inc|here]]: --[[User:Jholsenback|jholsenback]] 17:26, 3 June 2010 (UTC)
+
:* See it [[Doc:Reference_Section_7#arrays.inc|here]]: --[[User:Jholsenback|jholsenback]] 17:26, 3 June 2010 (UTC)
* Added binary #write capability
+
* Added binary <code>#write</code> capability
:* Check [[Doc:Reference_Section_2.5#The_.23write_Directive|here]]: --[[User:Jholsenback|jholsenback]] 17:26, 3 June 2010 (UTC)
+
:* See it [[Doc:Reference_Section_2.5#The_.23write_Directive|here]]: --[[User:Jholsenback|jholsenback]] 17:26, 3 June 2010 (UTC)
 +
* Changed bounding method command-line option from <code>+b2</code> to <code>+bm2</code>
 +
:* See it [[Doc:Reference_Section_1.3#BSP_Bounding|here]]: --[[User:Jholsenback|jholsenback]] 12:37, 15 June 2010 (UTC)
 +
* BSP (Binary Space Partitioning) tree bounding is now available
 +
:* See it [[Doc:Reference_Section_1.3#BSP_Bounding|here]]: --[[User:Jholsenback|jholsenback]] 12:37, 15 June 2010 (UTC)
 +
* Changed WorkThreads INI option to <code>Work_Threads</code> for consistency
 +
:* See it [[Doc:Reference_Section_1.3#Symmetric_MultiProcessing|here]]: --[[User:Jholsenback|jholsenback]] 18:53, 16 June 2010 (UTC)
 +
* The version directive, command-line setting no longer provide compatibility
 +
:* See it [[Doc:Reference_Section_2.5#The_.23version_Directive|here]]: --[[User:Jholsenback|jholsenback]] 13:16, 13 July 2010 (UTC)
 +
* Added <code>#elseif</code> directive
 +
:* See it [[Doc:Reference_Section_2.5#The_.23if....23else....23end_Directives|here]] and [[Doc:Reference_Section_2.5#The_.23ifdef_and_.23ifndef_Directives|here]]: --[[User:Jholsenback|jholsenback]] 13:39, 1 August 2010 (UTC)
 +
* The following keywords have been added to the identifiers and keywords list
 +
:* See them [[Doc:Reference_Section_2#Identifiers_and_Keywords|here]]: --[[User:Jholsenback|jholsenback]] 09:52, 17 August 2010 (UTC)
 +
# aoi
 +
# area_illumination
 +
# atand
 +
# cubic <em>pattern</em>
 +
# cubic <em>warp</em>
 +
# deprecated
 +
# elseif
 +
# emission <em>finish</em>
 +
# file_gamma
 +
# for
 +
# gamma
 +
# maximum_reuse
 +
# mm_per_unit
 +
# no_radiosity
 +
# premultiplied
 +
# sint8, sint16be, sint16le
 +
# sint32be, sint32le
 +
# srgb
 +
# subsurface
 +
# uint8
 +
# uint16be, uint16le
  
====Images====
+
===Images and Image Related===
 +
* Added HDR file support (RGBE, as used in Radiance)and EXR file support
 +
:* See it [[Doc:Reference_Section_1.1#Output_File_Type|here]]: --[[User:Jholsenback|jholsenback]] 08:01, 8 April 2010 (UTC)
 
* PPM and 16-bit greyscale output
 
* PPM and 16-bit greyscale output
:* Check [[Doc:Reference_Section_3.1#HF_Gray_16|here]]: --[[User:Jholsenback|jholsenback]] 09:47, 5 May 2010 (UTC)
+
:* See it [[Doc:Reference_Section_3.1#HF_Gray_16|here]]: --[[User:Jholsenback|jholsenback]] 09:47, 5 May 2010 (UTC)
 
* bicubic image interpolation
 
* bicubic image interpolation
:* Check [[Doc:Reference_Section_5.6#The_interpolate_Option|here]]: --[[User:Jholsenback|jholsenback]] 11:37, 8 July 2010 (UTC)
+
:* See it [[Doc:Reference_Section_5.6#The_interpolate_Option|here]]: --[[User:Jholsenback|jholsenback]] 11:37, 8 July 2010 (UTC)
 
* chroma sub-sampling in JPEG output
 
* chroma sub-sampling in JPEG output
:* Check [[Doc:Reference_Section_1.1#Output_File_Type|here]]: --[[User:Jholsenback|jholsenback]] 11:37, 8 July 2010 (UTC)
+
:* See it [[Doc:Reference_Section_1.1#Output_File_Type|here]]: --[[User:Jholsenback|jholsenback]] 11:37, 8 July 2010 (UTC)
* alpha handling and <code>+UA</code>
+
* Default output file type is now PNG
:* Check [[Doc:Reference_Section_3.1#Background|here]]: --[[User:Jholsenback|jholsenback]] 13:54, 16 July 2010 (UTC)
+
:* See it [[Doc:Reference_Section_1.1#Output_File_Type|here]]: --[[User:Jholsenback|jholsenback]] 11:44, 8 July 2010 (UTC)
 +
* <code>background</code> alpha handling
 +
:* See it [[Doc:Reference_Section_3.1#Background|here]]: --[[User:Jholsenback|jholsenback]] 13:54, 16 July 2010 (UTC)
 
* <code>sky_sphere</code>  with layered pigment and filter
 
* <code>sky_sphere</code>  with layered pigment and filter
:* Check [[Doc:Reference_Section_3.1#Sky_Sphere|here]]: --[[User:Jholsenback|jholsenback]] 13:54, 16 July 2010 (UTC)
+
:* See it [[Doc:Reference_Section_3.1#Sky_Sphere|here]]: --[[User:Jholsenback|jholsenback]] 13:54, 16 July 2010 (UTC)
 
+
* Changed alpha handling for image file input and output
====Continue Here====
+
:* See it [[Doc:Reference_Section_5#Using_the_Alpha_Channel|here]]: --[[User:Jholsenback|jholsenback]] 12:31, 25 July 2010 (UTC)
 
+
* Changed input file gamma syntax for individual files
* Added support for specifying grayscale output via INI file or command-line.
+
:* See it [[Doc:Reference_Section_5#The_Gamma_Option|here]]: --[[User:Jholsenback|jholsenback]] 10:59, 30 July 2010 (UTC)
<p>This is intended to replace the use of <code>hf_gray_16</code> in <code>global_settings</code>. If encountered, <code>hf_gray_16</code> has no effect on the output type and will additionally generate a warning message (as before).</p>
+
* Added <code>premultiplied</code> BOOL parameter to input image file syntax
<p>Currently only PNG file support is provided with grayscale output; others will be added over time.</p>
+
:* See it [[Doc:Reference_Section_5#Using_the_Alpha_Channel|here]]: --[[User:Jholsenback|jholsenback]] 10:59, 30 July 2010 (UTC)
<p class="Note"><strong>Update:</strong> As of beta 37, PPM (or rather, effectively PGM) file support has been added for this feature.</p>
+
* Added experimental support for reading the pixel resolution of an image map.
<p>Grayscale output may be specified via <code>Grayscale_Output=true</code> as an INI option, or <code>+Fxg</code> (for output type 'x') as a command-line option. For example, <code>+Fng</code> for PNG grayscale output.</p>
+
:* See it [[Doc:Reference_Section_2.1#Functions|here]]: --[[User:Jholsenback|jholsenback]] 13:48, 31 July 2010 (UTC)
<p class="Warning"><strong>Caveat:</strong> grayscale output implies the maximum bit-depth the format supports for PNG this is 16. it is not valid to specify bits per color channel with 'g' (e.g. <code>+Fng16</code> is not allowed, and nor for that matter is <code>+Fn16g</code>). If bits per channel is provided via an INI option, it is ignored.</p>
+
* Added <code>Antialias_Gamma=</code><em>n.n</em>
:* section done --[[User:Jholsenback|jholsenback]] 09:50, 5 May 2010 (UTC)
+
:* See it [[Doc:Reference_Section_1.3#Anti-Aliasing_Options|here]]: --[[User:Jholsenback|jholsenback]] 19:04, 1 August 2010 (UTC)
 
+
* Changes to input image transparency handling for <code>material_map</code>, <code>bump_map</code> and <code>image_pattern</code>
* Added a new list pattern type: <code>cubic</code>.
+
:* See it [[Doc:Reference_Section_5#Using_the_Alpha_Channel|here]]: --[[User:Jholsenback|jholsenback]] 12:43, 4 August 2010 (UTC)
<p>It takes six texture elements and maps each one to each of the six pyramids centered at each half-axis (thus effectively mapping each texture element to each side of a origin-centered cube).</p>
+
* Added support for using the sRGB transfer function for output file gamma.
* Added a new warp type: <code>cubic</code>.
+
:* See it [[Doc:Reference_Section_3.1#Scene_File_Gamma|here]]: --[[User:Jholsenback|jholsenback]] 12:43, 4 August 2010 (UTC)
<p> It takes no parameters, and maps an area in the x-y plane between <0,0> and <1,1> around the origin in the same way as uv-mapping an origin-centered cube-shaped box would. Naturally the warp works with any object whereas the uv-mapping only works for the box object.</p>
+
* Mosaic preview performance note
<p>See the documentation of box uv-mapping for details.</p>
+
:* See it [[Doc:Reference_Section_1.1#Mosaic_Preview|here]]: --[[User:Jholsenback|jholsenback]] 15:25, 6 August 2010 (UTC)
:* BOTH cubic descriptive entries have been done, except the keyword & identifiers entries --[[User:Jholsenback|jholsenback]] 19:11, 15 April 2010 (UTC)
 
* Added experimental support for full area light diffuse and specular illumination.
 
<p>By default this is off and thus area lights will work as previously, but the new feature can be turned on by specifying the new <code>area_illumination</code> keyword (followed by an optional on/off keyword) in the light source definition. The settings which determine the quality of the lighting are the Size_1 and Size_2 parameters of the area light (similarly to how they determine the quality of the shadows).</p>
 
:* Descriptive entries done, except the keyword & identifiers entry. --[[User:Jholsenback|jholsenback]] 14:36, 14 June 2010 (UTC)
 
 
 
* Added comparison (<code>=</code>, <code>!=</code>, <code><</code>, <code><=</code>, <code>></code>, <code>>=</code>) support for strings. added: --[[User:Jholsenback|jholsenback]] 14:15, 6 April 2010 (UTC)
 
 
 
* Changed bounding method command-line option from <code>+b2</code> to <code>+bm2</code> done: --[[User:Jholsenback|jholsenback]] 12:37, 15 June 2010 (UTC)
 
* Changed WorkThreads INI option to <code>Work_Threads</code> for consistency. add auto setting of thread count, the number of threads is now set as the number of detected CPUs, or 4 otherwise. done: --[[User:Jholsenback|jholsenback]] 18:53, 16 June 2010 (UTC)
 
 
 
* BSP (Binary Space Partitioning) tree bounding is now available. done: --[[User:Jholsenback|jholsenback]] 12:37, 15 June 2010 (UTC)
 
 
 
* Added HDR file support (RGBE, as used in Radiance).
 
* Added EXR file support using [http://www.openexr.org OpenEXR] library.
 
:* both these have been done --[[User:Jholsenback|jholsenback]] 08:01, 8 April 2010 (UTC)
 

Latest revision as of 19:35, 27 October 2010

Change Log Extracts

The change-log has been reviewed and these items below have been added into the documentation. --jholsenback 19:35, 27 October 2010 (UTC)

Whats New

  • A platform independent change summary has been completed
  • The Windows change summary has been completed
  • Setup (WIP) a Mac OS change summary
  • Setup (WIP) a Unix change summary

Radiosity

  • Speed up radiosity pretrace option
  • Revival of Radiosity Load/Save
  • New radiosity "high reproducibility" mode
  • Radiosity maximum_reuse parameter
  • Added no_radiosity keyword
  • Implemented adaptive radiosity pretrace.
  • Parser now checks for plausible relation between radiosity minimum_reuse and maximum_reuse:

New Features

  • Diffuse backside illumination
  • Added a new list pattern type: cubic
  • Added a new warp type: cubic
  • AOI Pattern
  • Slope Pattern extension
  • Subsurface scattering
  • Added support for full area light diffuse and specular illumination
  • Added emission parameter to the finish block
  • Added RTR (real-time raytracing), clockless animation, and video capture support
  • Added atand function to "math.inc".
  • You now have the ability to specify the render block size

Gamma

  • Non-legacy scene default gamma handling for image input files
  • assumed_gamma and File_Gamma
  • gamma keyword to specify gamma pre-corrected colours

SDL

  • Added ability to declare an identifier as deprecated
  • Added comparison (=, !=, <, <=, >, >=) support for strings
  • #break directive behavior
  • ARRAYS_WriteDF3 macro
  • Added binary #write capability
  • Changed bounding method command-line option from +b2 to +bm2
  • BSP (Binary Space Partitioning) tree bounding is now available
  • Changed WorkThreads INI option to Work_Threads for consistency
  • The version directive, command-line setting no longer provide compatibility
  • Added #elseif directive
  • The following keywords have been added to the identifiers and keywords list
  1. aoi
  2. area_illumination
  3. atand
  4. cubic pattern
  5. cubic warp
  6. deprecated
  7. elseif
  8. emission finish
  9. file_gamma
  10. for
  11. gamma
  12. maximum_reuse
  13. mm_per_unit
  14. no_radiosity
  15. premultiplied
  16. sint8, sint16be, sint16le
  17. sint32be, sint32le
  18. srgb
  19. subsurface
  20. uint8
  21. uint16be, uint16le

Images and Image Related

  • Added HDR file support (RGBE, as used in Radiance)and EXR file support
  • PPM and 16-bit greyscale output
  • bicubic image interpolation
  • chroma sub-sampling in JPEG output
  • Default output file type is now PNG
  • background alpha handling
  • sky_sphere with layered pigment and filter
  • Changed alpha handling for image file input and output
  • Changed input file gamma syntax for individual files
  • Added premultiplied BOOL parameter to input image file syntax
  • Added experimental support for reading the pixel resolution of an image map.
  • Added Antialias_Gamma=n.n
  • Changes to input image transparency handling for material_map, bump_map and image_pattern
  • Added support for using the sRGB transfer function for output file gamma.
  • Mosaic preview performance note