Merge branch 'master' into autobuild/alpha

Author: c-lipka

.travis.yml

@@ -7,15 +7,15 @@ branches:
   except:
   - /^v[0-9]/
 
-os:
-- linux
-- osx
 
 language: cpp
 
-compiler:
-- gcc
-- clang
+matrix:
+  include:
+  - os: linux
+    compiler: gcc
+  - os: osx
+    compiler: clang
 
 sudo: false
 

appveyor.yml

@@ -43,7 +43,7 @@ before_build:
     (Get-Content source\base\build.h).replace('//{POV_AUTOBUILD_2}', $env:pov_autobuild_2) | Set-Content source\base\build.h
     (Get-Content source\base\build.h).replace('//{POV_AUTOBUILD_3}', $env:pov_autobuild_3) | Set-Content source\base\build.h
     (Get-Content source\base\build.h).replace('YOUR NAME (YOUR EMAIL)', $env:pov_authorized_by) | Set-Content source\base\build.h
-    (Get-Content source\base\build.h).replace('#error Please fill in BUILT_BY, then remove this line', '') | Set-Content source\base\build.h
+    (Get-Content source\base\build.h).replace('#error "Please fill in BUILT_BY, then remove this line"', '') | Set-Content source\base\build.h
 
 build:
   project: windows/vs10/povray.sln

changes.txt

@@ -49,6 +49,22 @@ Prior to the release of 3.7.1, the following items still need urgent attention:
 New Features
 ------------
 
+- A new finish parameter, `use_alpha`, has been added to suppress highlights
+  and reflections depending on pigment transparency.
+
+- Array elements no longer have to be of the same type.
+
+- Support for variable-size arrays has been added.
+
+- A new data container, `dictionary`, has been added to support structured
+  storage of data.
+
+- Pseudo-dictionaries `local` and `global` have been added, allowing to
+  specifically access local or global identifiers, respectively.
+
+- A new special pigment pattern, `user_defined`, has been added to define the
+  pigment colour directly in terms of a set of functions.
+
 - A new pattern, `potential`, has been added to define a pattern based on the
   potential field of a blob or isosurface object.
 
@@ -86,9 +102,6 @@ New Features
   assignments. The main purpose is to allow macros to return a set of values
   rather than just a single one.
 
-- `local()` and `global()` pseudo-functions have been added to specifically
-  refer to a local or global identifier, respectively.
-
 - The macro syntax has been extended to allow for optional parameters.
 
 - Light sources' distance-based fading can now be set to obey an inverse-power
@@ -196,16 +209,35 @@ Fixed or Mitigated Issues Reported by Static Code Analysis
 
 Coverity Scan defects targeted deliberately:
 
+- CID 967251: 'Constant' variable guards dead code
+- CID 967254: 'Constant' variable guards dead code
+- CID 967261: Logically dead code
+- CID 967262: Logically dead code
+- CID 967273: Explicit null dereferenced
+- CID 967296: Parse Warning
+- CID 967297: Parse Warning
 - CID 967377: Uninitialized pointer field
 - CID 967400: Uninitialized pointer field
+- CID 967410: Structurally dead code
+- CID 967412: Structurally dead code
+- CID 1129008: Division or modulo by zero
 - CID 1129016: Uninitialized pointer read
 - CID 1129017: Uninitialized scalar variable
 - CID 1372548: Non-virtual destructor
 - CID 1372552: Unchecked return value
 - CID 1372555: Operands don't affect result
 - CID 1372556: Wrong operator used
 - CID 1372557: Wrong operator used
+- CID 1372558: Resource leak in object
+- CID 1372560: Logically dead code
 - CID 1372562: Non-array delete for scalars
+- CID 1372566: Unchecked dynamic_cast
+- CID 1372567: Unchecked dynamic_cast
+- CID 1372603: Resource leak
+- CID 1372604: Dereference before null check
+- CID 1372605: Dereference before null check
+- CID 1372606: Dereference before null check
+- CID 1372607: Dereference before null check
 - CID 1372608: Sizeof not portable
 - CID 1372626: Uninitialized scalar variable
 - CID 1372636: Uninitialized pointer field
@@ -224,6 +256,12 @@ Coverity Scan defects targeted deliberately:
 - CID 1372655: Structurally dead code
 - CID 1372656: Structurally dead code
 - CID 1372657: Unused value
+- CID 1373648: Out-of-bounds access
+- CID 1373649: Free of address-of expression
+- CID 1373651: Logically dead code
+- CID 1373652: Dereference before null check
+- CID 1373653: Write to pointer after free
+- CID 1373654: Use after free
 
 Coverity Scan defects eliminated in passing:
 
@@ -342,6 +380,8 @@ Reported via GitHub:
 - #49 ("Latest version from Git won't build with MS Visual Studio 2015")
 - #50 ("Make error in Ubuntu 14.04")
 - #53 ("Standard include files may mess up the language version")
+- #129 ("Port of FS331 - Intersection causes quadric to disappear")
+- #153 ("vector list trailing comma error sor lathe sphere_sweep")
 
 Reported via FlySpray:
 
@@ -354,9 +394,15 @@ Reported via FlySpray:
 - FS#316 ("inverse keyword does not work properly with fractals")
 - FS#317 ("problem with +D option at specific output file dimensions")
 - FS#318 ("method 3 (default) scattering media is too bright & causes artifacts when nested")
+- FS#331 ("Intersection causes quadric to disappear")
+- FS#336 ("#fopen w/o OPEN_TYPE crash povray (segfault)")
 
 Reported via the Newsgroups:
 
+- <[email protected]>
+  (2002-01-21, povray.beta-test, "<1, 0, 0> + 1*t")
+  Inconsistency in automatic scalar-to-vector promotion.
+
 - <[email protected]>
   (2014-08-12, povray.binaries.images, "unexplained")
   Precision issue led to `<1,1,1>.grey` not evaluating to 1 on sone systems.
@@ -414,6 +460,10 @@ Reported via the Newsgroups:
   (2016-08-17, povray.binaries.scene-files, "Wrong normal direction on triangle{ }s")
   Bug in flat trianges that could cause interior_texture to show on the wrong side.
 
+- <[email protected]>
+  (2016-10-20, povray.programming, "Re: solving polynomials")
+  Misplaced `break` in polynomial solving code.
+
 Reported via Windows Crash Reports:
 
 - crash report #???, dump file #988

platform/unix/syspovtimer.cpp

@@ -80,7 +80,7 @@ void Delay(unsigned int msec)
     POV_ASSERT(msec < 1000); // On some systems, usleep() does not support sleeping for 1 second or more.
     usleep (msec * (useconds_t)1000);
 #else
-#error Bad compile-time configuration.
+#error "Bad compile-time configuration."
 #endif
 }
 

source-doc/compiler.md

@@ -6,7 +6,7 @@ General Presumptions
 
 While POV-Ray is being developed with portability high in mind, the C++ standard allows for some degrees of freedom that
 we consider too exotic to cater to. We therefore presume all compilers and runtime environments to adhere to the
-following additional restrictions:
+following restrictions:
 
   - **Char Size**: The `char` data type is currently presumed to be exactly 8 bits wide.
 
@@ -19,7 +19,11 @@ following additional restrictions:
     separator, in include directives.
 
   - **Integer Division**: Integer division is presumed to round towards zero. This also implies that the remainder (as
-    computed by the modulus operator `%`) is negative (or zero) if the dividend and divisor have different sign.
+    computed by the modulus operator `%`) is negative (or zero) if the dividend and divisor have different signs.
+
+Failure to meet the above restrictions will cause in undefined behaviour.
+
+Further restrictions may apply, but shall prompt a compile-time error if not satisfied.
 
 
 POVMS Additional Restrictions

source-doc/styleguide.md

@@ -223,6 +223,10 @@ Miscellaneous Coding Rules
   - **Locale**: Do not tamper with the C locale (i.e. do not call `setlocale` or any other function doing the same job),
     as plenty of code in POV-Ray relies on it remaining set to the default.
 
+  - **Optimization**: Do not over-optimize your code. While we do want POV-Ray to be fast, we also want it to be
+    reasonably maintainable, and modern compilers generally do a good enough job at automatic optimization that you can
+    focus on keeping your code robust and easy to understand.
+
 
 Code Documentation
 ==================

source/base/build.h

@@ -55,7 +55,7 @@
 /// Specifies the person or organization responsible for this build.
 /// @attention Please set this to your real name, and/or include a working email or website address to contact you.
 #define BUILT_BY "YOUR NAME (YOUR EMAIL)"
-#error Please fill in BUILT_BY, then remove this line
+#error "Please fill in BUILT_BY, then remove this line"
 #endif
 
 #endif // POVRAY_BASE_BUILD_H

source/base/colour.cpp

@@ -54,7 +54,7 @@ namespace pov_base
 
 #else
 
-    #error TODO!
+    #error "TODO!"
 
 #endif
 

source/base/colour.h

@@ -578,7 +578,7 @@ class GenericRGBColour
             mColour[BLUE]  = col.mColour[2];
         }
 #else
-        #error TODO!
+        #error "TODO!"
 #endif
 };
 
@@ -1736,7 +1736,7 @@ class GenericColour
             mColour[2] = col.blue();
         }
 #else
-        #error TODO!
+        #error "TODO!"
 #endif
 };
 

source/base/image/gif.cpp

@@ -125,8 +125,7 @@ Image *Read (IStream *file, const Image::ReadOptions& options, bool IsPOTFile)
         {
             case EOF:
                 throw POV_EXCEPTION(kFileDataErr, "Unexpected EOF reading GIF file");
-                finished = true;
-                break ;
+                break;
 
             case ';': /* End of the GIF dataset. */
                 finished = true;