Bonzai3d | Command Extensions

Maxwell Commands

All Maxwell commands can be found in the Bonzai3d main menubar: Extensions > Maxwell Render >.

Focus Camera

The Focus Camera command focuses the camera on the plane of selected entities (individual or multiple objects, segments, points, etc.) Unlike Bonzai3d's Fit All command, Focus Camera leaves the view cropping and orientation unchanged.

Workstation Transfer

Collects all the Maxwell-related resources your project needs into one location, so you can move your project to another computer.

The following resources will be copied to the selected destination folder:

• Referenced MXMs
• Bitmap images, IOR, and IES files that each referenced MXM makes reference to
• Saved versions of any embedded bitmaps in the Bonzai3d project file
• IBL files (MXR, HDR)
• IES files referenced by the IES light type

MXS scenes are not collected, as they are not necessary for this type of transfer.

Of course, you will also need to transfer your Bonzai3d project, component libraries, etc.

Package for Renderfarm

Builds a Maxwell scene, then packages it, along with all required resources, in a single folder. This folder may be moved to another computer or environment for rendering.

Resources collected:

• MXS file
• Bitmap images, IOR, and IES files that each embedded MXM makes reference to
• Saved versions of any embedded bitmaps in the Bonzai3d project file
• IBL files (MXI, EXR, HDR)
• IES files referenced by the IES light type

Referenced MXMs are not collected (they are embedded in the MXS).

Project Settings

Invokes the Project Settings dialog. Settings defines here are on a per-project basis. (They apply to all open windows of the current project, and are saved at project level.)

• Resource Manager: This important service warrants its own section. See Bonzai3d | Resource Manager.
• Autotranslate 'Shaded' Renderer
  
  • Search for missing bitmap textures: When enabled, if Bonzai3d cannot report a valid file path to a bitmap texture file, the Maxwell plugin will attempt to find it using its Resource Manager.  It is highly recommended that this option be kept at the default: enabled.
  • Allow project-embedded bitmaps to be exported: When enabled, if Bonzai3d cannot find a valid path to a 'Shaded' renderer bitmap texture (and the Maxwell plugin also cannot, if Search for missing bitmap textures is enabled), a version of the bitmap embedded in the Bonzai3d project will be used instead. This version may be reduced in resolution or quality, so the option to disable is provided. When disabled, and a valid path cannot be found, a rendering error will occur instead, letting you know that you need to add a Resource Library path to the original texture.

Log

The Log is used to diagnose problems and evaluate performance. (Project translation time is logged).

A new log is begun when a Maxwell Render is initiated or Fire is enabled. The log will stay in memory until a new render is initiated.

• Log Entries: Each line indicates the severity, context, and data associated with the entry. Any errors will be highlighted in blue so they are easy to spot.
• Text field: This field (below the list) is a duplicate of the currently selected log entry in a form that can be copied. (You can copy a filename here, then search for it in your favorite file search utility.)
• Save Log: Saves the log as a text file; useful for emailing to technical support.

Object Modifiers...

The Object Modifier library is used to create object modifier definitions, which may be then applied to any number of Bonzai3d objects.

• Create a Grass Object Modifier: See Bonzai3d | Grass
• Create a Scatter Object Modifier: See Bonzai3d | Scatter
  
• Apply an Object Modifier: See Bonzai3d | Object Attributes and Modifiers

System Settings...

Settings defined at this level are system-level-- they will affect all open projects. They are automatically saved when Bonzai3d is closed, an restored when Bonzai3d is reopened.

• Output Paths
  
  • Convert Whitespace To: [spaces, underscores, dashes] Controls how spaces are treated in automatically generated filenames. For workflows that involve remote servers, you may wish to select ‘underscores’ or ‘dashes,’ for maximum file system compatibility.
• Material Preview
  
  • Time: Time is the maximum time the material preview will render before stopping, in seconds.
  • Sampling Level: Rendering will also stop if it reaches the specified Sampling Level (if it is unable to reach the specified SL before the Time has been met).
  • Use Fill Light: A 2’ x 2’ key light at camera left always illuminates the material preview object (sphere, cube, etc.). Enabling this checkbox adds a 2’ x 2’ fill light to the preview at camera right. Enabling the Fill light will result in a better material preview in most cases.
  • Use Kicker Light: Enabling this checkbox adds a 2’ x 2’ kicker light to the preview above and behind the material preview object. Enabling the Kicker light will provide a clear highlight along the top of the object, which is useful for certain shiny or metallic objects that otherwise may only reflect the empty (black) scene above.
  • Set all to MXED: All materials in the project using referenced MXMs will have their previews updated to the MXED preview embedded in the MXM file. Note that all MXMs will opened (and searched for, if not found at the specified location), so this process may take some time with projects referencing many MXMs.
• Warnings
  • Ask to Add Default Sky: Upon opening a Bonzai3d file without a Maxwell Sky/Sun, prompt to add one automatically. (It is possible to store a Physical Sky or other default light in your Bonzai3d template file, as well.)

About

Presents versioning and compatibility information.

Maxwell Documentation

Launches the online Maxwell Render documentation.

Plugin Documentation

Launches the online Maxwell for Bonzai3d documentation.

Forum

For convenience, Maxwell for Bonzai3d support is available though the AutoDesSys forum here.

This command presents versioning and system information suitable for posting to the public support forum, then opens the forum web page.

• Select the Forum command.
• Copy the system information provided and click OK. The forum web page should pop up after a moment.
• On the forum web page, click on 'Start a New Thread' if you need to post an inquiry. Paste the system info provided into your post.