Introduction | Background Render | Batch Render | Network Render | Internet Render | Config File | Command Line

LightWave 3D ScreamerNet LWSN Command Line Parameters for ScreamerNet LWSN on Mac OS X & Windows – Mastering LightWave 3D ScreamerNet LWSNLightWave 3D ScreamerNet LWSN is a command line executable that runs in the Mac OS X Terminal or Windows Command Prompt. The following is a complete description of each of the available LightWave 3D ScreamerNet LWSN Command Line Parameters. You can use a variety of command line parameters to manually configure and launch LWSN in Terminal/Command. Or you can use our drag and drop GUI front end – DLI_SNUB-Launcher™ to interactively build the command lines in a Mac friendly error-free manner that is drag-and-drop-dead-easy™, even on Windows.


LightWave 3D ScreamerNet LWSN Command Line Parameters
Online Documentation Contents


Interactively Building ScreamerNet UB Command Lines with DreamLight SNUB-Launcher

DLI SNUB Launcher Main GUI Interface for Mac OS X & WindowsWhile you can of course type your ScreamerNet LWSN command lines in Terminal/Command manually, it can become quite error prone and tedious, especially if you change your Content Directory or other settings regularly. To avoid such issues we wrote a neat little utility, DLI_SNUB-Launcher™ (DreamLight Interactive ScreamerNet Universal Binary Launcher) originally in Apple’s Xcode and subsequently rewritten in the cross-platform LiveCode to provide an interactive graphical user interface (GUI) to take the drudgery out of it and to prevent syntax errors which can make setting up ScreamerNet LWSN more difficult than it really needs to be. Using its simple drag-and-drop interface you can quickly and easily set up complicated LWSN command lines that are validated with at-a-glance color coding and ready to go. Then with a single button you can launch multiple ScreamerNet LWSN nodes for rendering. It’s also a standalone render droplet meaning that you can simply drag and drop scenes on it and it’ll launch ScreamerNet LWSN and render them for you in the background while you continue to work in LightWave Layout.

Even if you prefer to use Terminal/Command to launch LWSN manually you can still use DLI_SNUB-Launcher to build and verify your command lines and then copy/paste them into Terminal to execute them. It’s also a very handy reference resource since every setting has detailed pop-up descriptions and the help menu links directly to the online manual and even includes direct links to all the content in this Mastering LightWave ScreamerNet white paper. And as an added bonus we’ve even included a custom professionally designed sample scene, DLI_SuperBalls, with a prebuilt Content Folder that you can use to test your ScreamerNet LWSN setup, benchmark the speed of your computers and even use as a sample of advanced nodal surfacing and LightWave 3D’s built-in instancing.

DLI_SNUB-Launcher IconDownload the FREE LITE version of DLI_SNUB-Launcher today. It is fully functional and only limited by the number of nodes it can launch and which custom settings it will save.


General LightWave 3D Command Line Syntax

LightWave 3D’s general command line syntax is as follows, all on one line with a space separating each parameter. Do not separate a parameter from its value with a space. All parameter letters must be in lowercase. Enclose all paths with double quotes, especially if the path contains spaces. This syntax is used in the Mac OS X terminal or Windows Command Prompt command line when launching ScreamerNet LWSN.

[-0] [-c<config directory>] [-p<plugin config dir>]

The following general command line parameters may be used when launching most of the LightWave applications from the command line, including ScreamerNet LWSN.


Hub Switch

-0: (dash zero) Optional: Disables the Hub

Though not used with ScreamerNet LWSN, this parameter was previously used when launching LightWave Layout and/or Modeler to disable the Hub, because the Hub ,was sometimes the source of problems. The easiest way to disable the current Hub is to simply rename the Hub application to something else, like Disabled-Hub, in which case it will no longer automatically launch with Layout or Modeler.


Command Line Path Parameters

When specifying command line path parameters, the following rules of thumb may be helpful:

  • Type the parameter letter, such as -c or -p, in lowercase.
  • Use a plain dash before the parameter letter.
  • Do not put a space between the parameter letter and the associated path.
  • Enclose all paths in double quotes (straight double quotes, not curly quotes) if the path contains any spaces or you must escape any special characters. I find it easiest to just be consistent and simply enclose all paths in double quotes. Only enclose the path, not the leading parameter.
  • Avoid using spaces in file or folder names inside the content directory, use underscore.
  • For paths on volumes other than the system volume on Mac OS X, start the paths with "/Volumes/volumename/" replacing volumename with the actual volume name.
  • For paths in the current user’s home folder, start the paths with
    "/Users/userx/" on Mac OS X or "C:\Users\userx" on Windows, replacing userx with the current user name.
  • Use full paths for your ScreamerNet LWSN paths because Content Directory relative paths may not work properly in ScreamerNet UB on Mac OS X.
  • Beginning with Mac OS X 10.7 Lion, the user’s Library folder is hidden, so you need to use the Finder’s Go->Go to Folder… menu command with ~/Library in the text field to view any of the current user’s Library folders from within the Finder.

NOTE: When typing paths in the Mac OS X Terminal you can usually start a path with a tilde ‘~‘ character preceding a forward slash, as in ~/ to represent "/Users/username/" where username is the current user. However ScreamerNet UB lwsn itself doesn’t currently understand this convention, so the tilde won’t work if it’s embedded in a parameter that’s passed to LightWave, for instance enclosed in double quotes, or following a parameter switch such as -c or -d, etc. It will work in a few instances if used BEFORE the first double quote for the rest of the path, in a parameter that doesn’t start with any switch, such as when passing a job, ack, or scene file path: ~/"Documents/LWContent/MyScene.lws" which is expanded to: "/Users/username/Documents/LWContent/MyScene.lws" by the terminal BEFORE being passed to ScreamerNet. Due to these issues it’s advisable to avoid the ~/ shortcut altogether in LWSN paths and just use the full path instead because it is more reliable for all parameters.

Due to some inconsistencies that I’ve run into with LWSN handling paths between Mac OS X and Windows I find it best to end paths to folders on Mac OS X with a trailing forward slash, but to end paths to folders on Windows without a trailing backslash.


-c Config Directory

-c : Optional: Path to the folder that contains the config file.

An example of the parameter with the initially searched Config Directory path on Mac OS X is as follows:

-c"/Applications/NewTek/LightWave3D_2015.2/Preferences/"

There are two default Config Directory locations that are checked by LightWave 3D on Mac OS X. The first location looked for is a custom folder that you may have created named Preferences inside the current LightWave3D application folder. So that would be a convenient place to keep your config files if you would like all users of the Mac to share the same config files and/or if you’d like to use different sets of config files for different builds of LightWave.

If no such Preferences folder exists the next default location searched is the current user’s Library/Application Support/NewTek/LightWave/2015.2/ folder.

This full path would be as follows on Mac OS X:
"/Users/username/Library/Application Support/NewTek/LightWave/2015.2/"

This full path would be as follows on Windows:
"C:\Users\userx\.NewTek\LightWave\2015.2"

Where username is replaced with the actual name of the current user and 2015.2 is replaced with the version of LightWave being used.

Because this default location is in the current user’s home folder, each different user account on the computer would have their own set of config files. On Mac OS X 10.7 Lion and later the user’s Library folder is hidden so you need to use the Finder’s Go->Go to Folder… menu command with ~/Library in the text field to access the user’s Library folders from within the Finder.

For more information see: Managing LightWave 3D ScreamerNet LWSN Config Files.

This parameter may be used to specify a different folder location for the config files if desired.


-p Plugin Directory

-p : Optional: Path to the folder that contains the plugin database file. This is not the path to the actual plugins themselves. This is the path to the text file that lists all the paths to the actual plugins. This is typically the same path as that of the Config Directory.

An example of this parameter is as follows on Mac OS X:
-p"/Users/username/Library/Application Support/NewTek/LightWave/2015.2/"

An example of this parameter is as follows on Windows:
-p"C:\Users\userx\.NewTek\LightWave\2015.2"

If not specified, the Config Directory path will be used. This parameter may be used to specify a different folder location for the plugin database file if desired.


General ScreamerNet LWSN Command Line Syntax

There are a few common command line parameters that are used to tell ScreamerNet LWSN what to do. The following general command line parameters may be used when running ScreamerNet LWSN in any mode. Additional mode specific command line parameters are discussed later.

The general command line syntax is as follows, all on one line.

-<mode#> [-c<config directory>] [-d<content directory>] [-l<log file>] [-q]


Rendering Mode

-<mode#> : The mode number parameter specifies which rendering mode to use.

-2 : Signifies batch or network rendering mode which may render multiple scenes on multiple render nodes (instances of LWSN) on one or more computers. This mode requires the use of a network controller such as the built-in Network Render panel in Layout or a separate network render controller like DreamLight Constellation.

-3 : Signifies standalone rendering mode which renders a single scene on a single render node. This mode allows LWSN to render scenes in the background without using a render controller. You can render a scene with LWSN in mode -3 manually from the command line or you can simply drag and drop a scene on DLI_SNUB-Launcher to render in LWSN in mode -3.


-c Config Directory

-c : Optional: Path to the folder that contains the config file.

This full path would be as follows on Mac OS X:
-c"/Users/username/Library/Application Support/NewTek/LightWave/2015.2/"

This full path would be as follows on Windows:
-c"C:\Users\userx\.NewTek\LightWave\2015.2"

This parameter is explained in more detail above under Command Line Path Parameters.


-d Content Directory

-d : Optional: Path to the folder that contains your content.

An example of this parameter with a sample Content Directory path could be as follows on Mac OS X:
-d"/Users/userx/Documents/LWContent/"

or the following example on Windows:
-d"C:\Users\userx\Documents\LWContent

Where userx should be replaced with the current user name. This example would be to use a folder named LWContent in your Documents folder as your content folder. If this option is not specified, the content directory defaults to the content directory specified in the config file through LightWave. Therefore, if you set your content directory in LightWave itself, and you have ScreamerNet LWSN on the same computer using the same config file as LightWave Layout (which it does by default), you do not need to specify this option in the ScreamerNet LWSN command line, unless you wish to use a content directory that is different than the one currently set in LightWave. You would also need to specify this path if you were running ScreamerNet LWSN on a different computer than you are running LightWave.

Please review Config Files: Content Directory, for important information about properly using LightWave’s Content Directory.


-l Log File

-l : Optional: Path to a text file to write the ScreamerNet LWSN output into instead of displaying it in the Terminal/Command window.

An example of this parameter with a sample Log File path could be as follows on Mac OS X:
-l"/Users/username/Documents/LWContent/Logs/ScreamerNetLog.txt"

An example of this parameter with a sample Log File path could be as follows on Windows:
-l"C:\Users\username\Documents\LWContent\Logs\ScreamerNetLog.txt"

Where username should be replaced with the current user name. This example would use a Log File named ScreamerNetLog.txt in a LWContent/Logs/ folder in the current user’s Documents folder. If this option is not specified then the text messages generated as output would appear in the Mac OS X terminal window that is running ScreamerNet LWSN. The current user must have read/write permissions for this file.


-q Quiet Mode

-q : Optional: Suppresses most terminal output during frame rendering, still reports as each frame finishes.

Normally while ScreamerNet LWSN is busy rendering it outputs quite a bit of text information to the terminal interface. This can be useful for monitoring progress and troubleshooting problems such as missing plug-ins, etc. Once everything is up and running however, all this text writing to the terminal may be unnecessary. The -q parameter turns off all the output during the rendering of an individual frame. You’ll still get text output during the scene loading and between rendered frames, but not during frame rendering.

Here’s an example of what the output for one frame normally looks like, without the -q parameter:

Scene loaded.
 Allocating frame buffers.
 Allocating segment buffers.
 Frame: 1.
 Segment: 1/1.
 Pass: 1/1.
 Updating geometry.
 Moving DLI_Floor_01F (1).
 Moving DLI_SuperBall_01H.
 Moving DLI_Floor_01F (2).
 Preprocessing Frame....
 Computing preliminary radiosity solution....
 Rendering frame 1, segment 1/1, pass 1/1.
 Image Reconstruction.
 Image Reconstruction : 0%.
 Image Reconstruction : 4%.
 Image Reconstruction : 8%.
 Image Reconstruction : 13%.
 Image Reconstruction : 17%.
 Image Reconstruction : 22%.
 Image Reconstruction : 26%.
 Image Reconstruction : 31%.
 Image Reconstruction : 35%.
 Image Reconstruction : 40%.
 Image Reconstruction : 44%.
 Image Reconstruction : 49%.
 Image Reconstruction : 53%.
 Image Reconstruction : 58%.
 Image Reconstruction : 62%.
 Image Reconstruction : 67%.
 Image Reconstruction : 71%.
 Image Reconstruction : 75%.
 Image Reconstruction : 80%.
 Image Reconstruction : 84%.
 Image Reconstruction : 89%.
 Image Reconstruction : 93%.
 Image Reconstruction : 98%.
 Freeing segment buffers.
 Allocating filter buffer.
 Freeing filter buffer.
 Allocating segment buffers.
 Writing RGB image to /Users/userx/Documents/DLI_SuperBalls/Renders/DLI_LW11-SuperBalls-Anim_001.jpg.
 Frame completed.
 Last Frame Rendered: 1.
 Rendering Time: 1m 9s (69.3 seconds).
 Freeing segment buffers.
 Freeing frame buffers.

Here’s what the the same output looks like with the -q parameter included:

Scene loaded.
 Last Frame Rendered: 1

-t Time Check Interval

-t : Optional: Time check interval in seconds.

An example of this parameter with a sample Time Check Interval could be as follows:

-t60

This sample would have ScreamerNet LWSN attempt to check the job file every 60 seconds for status or abort commands when rendering in batch/network mode -2. Other commands in mode -2 are ignored while a frame is rendering. When rendering in standalone mode-3 ScreamerNet LWSN would report its current status every 60 seconds with this option.

Normally, once ScreamerNet LWSN begins rendering a frame, it does not check the job file for any further instructions until the frame finishes rendering. During the initial setup and testing of your render farm or when testing a new scene, it may be useful to allow ScreamerNet to check the job file for abort or status commands. Particularly if individual frames take a long time to render. This way, if you notice a problem at the beginning of rendering (a missing plug-in for instance), you can abort the rendering without having to wait for all your nodes to finish rendering an entire frame each or force quitting each node.

For instance, if your frames use ray tracing, area lights, radiosity, caustics, SSS, high antialiasing levels, motion blur and/or depth of field, they may take a long time to render. In this case you could set -t to 60 seconds, then ScreamerNet would try to check the job file every 60 seconds to see if the job should be aborted or if status information should be written to the output. During certain processing, ScreamerNet may still take longer than 60 seconds before it can check, but it doesn’t have to wait for an entire frame to render before being able to stop or report status. Once you are sure everything is running smoothly, it may be best to remove this option, so that no extra time is taken checking the job file or reporting status unnecessarily, especially if you are network rendering many frames.


Standalone Mode (-3) LWSN Command Line Syntax

The standalone mode (-3) specific command line syntax is as follows, all on one line.

-3 [-c<config directory>] [-d<content directory>] [-l<log file>] [-q] <scene file> <first frame> <last frame> [<frame step>]

The first five parameters are explained above under General ScreamerNet Command Line Syntax.


Scene File

<scene file>: Full path to the scene file.

A sample of a full scene path could be as follows on Mac OS X:
"/Users/username/Documents/DLI_SuperBalls/Scenes/SuperBalls-Anim.lws"

A sample of a full scene path could be as follows on Windows:
"C:\Users\username\Documents\DLI_SuperBalls\Scenes\SuperBalls-Anim.lws"

Where username is replaced with the current user name. Be sure to use a full path to the scene file rather than a Content Directory relative path because Content Directory relative paths may not work on some versions of ScreamerNet UB LWSN on the Mac. Also be sure to enclose the entire path in double quotes, especially if it contains spaces or other special characters.


Render Frame Range

<first frame>: First frame to render. Normally less than last frame but may be greater than last frame if frame step is negative.

<last frame>: Last frame to render. Normally greater than or equal to first frame but may be less than first frame if frame step is negative.

[<frame step>]: Optional: defaults to 1, may be positive or negative.

Frame step specifies which frames to render between the first and last frame, and in what order. When set to 1, ScreamerNet would render every frame from the first frame, up to the last frame. When set to 2, ScreamerNet would render every other frame from the first frame up to the last frame. If set to -1, ScreamerNet would render every frame from the first frame, down to the last frame and in this case the first frame should be greater than the last frame to render in reverse order. Note that LWSN in standalone mode -3 only renders single frame ranges, it does not render arbitrary or keyframe settings that LightWave Layout does.


Batch/Network Mode (-2) LWSN Command Line Syntax

The batch & network mode (-2) specific command line syntax is as follows, all on one line.

-2 [-c<config directory>] [-d<content directory>] [-l<log file>] [-q] [-t<check interval>] <job file> <ack file>

The first five parameters are explained above under General ScreamerNet Command Line Syntax.


Job File

<job file> : job# File path & node number for lwsn to read commands from.

A sample job file path could be as follows on Mac OS X:
"/Users/username/Documents/DLI_SuperBalls/Commands/job1"

A sample job file path could be as follows on Windows:
"C:\Users\username\Documents\DLI_SuperBalls\Commands\job1"

This example reads the job1 text file in a Commands folder in a DLI_SuperBalls folder in the user’s Documents folder, where username should be replaced with the current user name.

The number should immediately follow the word “job” without any spaces and there must be no file extension, such as ".txt" added to the end of the path.

Make sure that your job# and ack# both use the same number. This number is what actually determines the CPU number of the ScreamerNet render node so that the ScreamerNet network controller may communicate with this LWSN render node.

For additional information please review Config Files: Command Directory.


Ack File

<ack file> : ack# (acknowledgment) File path & node number for lwsn to write replies to.

A sample ack file path could be as follows on Mac OS X:
"/Users/username/Documents/DLI_SuperBalls/Commands/ack1"

A sample ack file path could be as follows on Windows:
"C:\Users\username\Documents\DLI_SuperBalls\Commands\ack1"

This example writes to the ack1 file in a Commands folder in a DLI_Superballs folder in the user’s Documents folder, where username should be replaced with the current user name. The current user must have read/write permissions for this file.

For additional information please review Job File above & Config Files: Command Directory.


DreamLight Constellation Network Render Controller

DreamLight Constellation 3D Icon LogoDreamLight® Constellation is our cross-platform network render controller that combined with DLI_SNUB-Launcher™ makes configuring, launching and controlling LightWave 3D ScreamerNet LWSN for standalone, batch, network and internet rendering, drag-and-drop-dead-easy™.

Created by Michael Scaramozzino - LightWave 3D Artist Profile
Author of Creating a 3D Animated CGI Short & Mastering LightWave ScreamerNet


Introduction | Background Render | Batch Render | Network Render | Internet Render | Config File | Command Line

DreamLight wrote the book: Creating a 3D Animated CGI Short. See what we can do for you.