commit 1e2d352630d1f0e2dfebfbbdbedff17f914f66d9
parent 0b8a5a0aecb1c14f488f06f6bacc0fb6978d6148
Author: Eduardo Fontana Lazzari <edufonlaz@gmail.com>
Date: Mon, 12 May 2025 17:01:07 +0200
Doc: Add right-hand rule convention to star-phor-input(5)
The absence of a triangle orientation convention in the man page could
be considered a documentation flaw. Although s3d uses the left-hand
convention as a legacy of Embree, we choose the right-hand convention,
as it is arguably the de facto standard in scientific computing and
computer-aided design.
Diffstat:
1 file changed, 6 insertions(+), 3 deletions(-)
diff --git a/doc/star-phor-input.scd b/doc/star-phor-input.scd
@@ -33,9 +33,12 @@ star-phor-input - photoreactive system description files
A photoreactive system description consists of a list of surfaces and volumes.
Each of these elements is defined by a set of properties, which may represent
either geometrical characteristics or physical properties. The only supported
-geometrical data format is the triangular mesh stored in STL files. The geometry
-(or the set of geometries) associated with a volume must form a closed enclosure
-to ensure that every part of the system domain consists of a single medium with
+geometrical data format is the triangular mesh stored in STL files. Triangles in
+STL files are assumed to follow the right-hand rule convention to determine
+their orientation; that is, the front face of a triangle is the side from which
+its vertices appear arranged in counter-clockwise order. The geometry (or the
+set of geometries) associated with a volume must form a closed enclosure to
+ensure that every part of the system domain consists of a single medium with
consistent properties.
Properties are specified either as a single-line entry or as a multi-line block,
