Reference:Scene Parsing Options
POV-Ray reads in your scene file and processes it to create an internal
model of your scene. The process is called parsing. As your file
is parsed other files may be read along the way. This section covers options
concerning what to parse, where to find it and what version specific
assumptions it should make while parsing it.
Constant
Declare=IDENTIFIER=FLOAT |
Declares an identifier with a float value |
You can declare a constant in an INI file, and that constant will be available to the scene. Since INI file statements may also be placed on the command-line, you can therefore also declare on the command-line (though there is no switch for it).
Declare=MyValue=24
This would be the same as a #declare MyValue=24; in a scene file. The value on the
right-hand side must be a constant float value. As of version 3.8 the value reaches the scene
in full double precision; earlier versions kept about seven significant digits.
A possible use could be switching off radiosity or photons from command-line:
--in INI-file / on command-line
Declare=RAD=0
--in scenefile
global_settings {
#if (RAD)
radiosity {
...
}
#end
}
A string can be declared as well. Put the text in double quotes and the whole setting
after Declare= in single quotes:
Declare='MyName="text"'
This would be the same as a #declare MyName="text"; in a scene file. Without the
single quotes the setting is not accepted. Note Most (Unix) shells will require backslash quoting of the apostrophes.
As in a string literal in a scene file, a backslash in the text starts an escape sequence
(\n, \t, \\, \uNNNN and so on). This matters for
file names on Windows. Write them with forward slashes or with doubled backslashes:
Declare='MyFile="C:/temp/new.png"' Declare='MyFile="C:\\temp\\new.png"'
Written with single backslashes, C:\temp\new.png would not name that file:
\t is read as a tab and \n as a line feed, while a sequence such as
\d is reported as an illegal escape sequence. As of version 3.8 POV-Ray warns when a
declared string looks like a file name written that way.
Include File Name
Include_Header=file |
Sets primary include file name to file |
+HIfile |
Same as Include_Header=file |
This option allows you to include a file as the first include file of a scene file. You can for example use this option to always include a specific set of default include files used by all your scenes.
Library Paths
Library_Path=path |
Add path to list of library paths |
+Lpath |
Same as Library_Path=path |
POV-Ray looks for files in the current directory. If it does not find a file it needs it looks in various other library directories which you specify. POV-Ray does not search your operating system path. It only searches the current directory and directories which you specify with this option. For example the standard include files are usually kept in one special directory. You tell POV-Ray to look there with...
Library_Path=c:\povray3\include
You must not specify any final path separators ("\" or "/") at the end.
Multiple uses of this option switch do not override previous settings. If you specify the exact same path twice it is only counted once. The current directory will be searched first followed by the indicated library directories in the order in which you specified them.
Language Version
Version=n.n |
Set initial language compatibility to version n.n |
+MVn.n |
Same as Version=n.n |
See also: Version Directive