{"type":"doc","content":[{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"The plug-in set comes with four main components: the ","type":"text"},{"text":"mxiReader","type":"text","marks":[{"type":"link","attrs":{"href":"#Nukeplugincomponents-mxi_reader"}}]},{"text":", the ","type":"text"},{"text":"MxiMixer","type":"text","marks":[{"type":"link","attrs":{"href":"#Nukeplugincomponents-mxi_mixer"}}]},{"text":", the ","type":"text"},{"text":"MxiRender ","type":"text","marks":[{"type":"link","attrs":{"href":"#Nukeplugincomponents-mxi_render"}}]},{"text":"and the ","type":"text"},{"text":"MxiMask","type":"text","marks":[{"type":"link","attrs":{"href":"#Nukeplugincomponents-mxi_mask"}}]},{"text":".","type":"text"}]},{"type":"bodiedExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"section","parameters":{"macroParams":{},"macroMetadata":{"schemaVersion":{"value":"1"},"title":"Section"}}},"content":[{"type":"extension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"legacy-content","text":"","parameters":{"cxhtml":"

mxi_reader

The mxiReader

The mxiReader is an image file reader for Nuke that allows you to load MXI files or sequences into Nuke with full 32 bit color information. Once it’s installed, simply open the MXI file(s) as you do any other files in Nuke.
The MXI reader loads all the channels available in the MXI file as independent Nuke channels:

Render: Loaded into the rgb main layer.
: If Multilight was enabled, each light creates a new layer using the light name assigned in Maxwell Render, Maya, 3DS MAX, etc.
: If Multilight was enabled, each light creates a new layer using the light name assigned in Maxwell Render, with the SHADOW_ prefix.
: Creates a layer named ALPHA.
: Creates a layer named Z.
: Creates a layer named MOTION.
: Creates a layer named OBJECTID.
: Creates a layer named MATERIALID.
: Creates a layer named ROUGHNESS.
: Creates a layer named FRESNEL.
: Creates a layer named NORMALS.
: Creates a layer named POSITION.
: Creates a layer named UV.
: Creates a layer for each custom alpha channel group set in the scene, with the alpha_ prefix.

Nuke channel names can only have alphanumeric characters and underscores, so any other characters (like ":", "!", etc.) will be replaced by underscore characters. Each 3D software has its own naming convention so be careful if you use light names in your scripts.

","nestedContent":{"type":"doc","content":[{"type":"bodiedExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"column","parameters":{"macroParams":{},"macroMetadata":{"schemaVersion":{"value":"1"},"title":"Column"}}},"content":[{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"mxi_reader"},"legacyAnchorId":{"value":"Nukeplugincomponents-mxi_reader"}},"macroMetadata":{"schemaVersion":{"value":"1"},"title":"Anchor"}}}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"The mxiReader","type":"text"}]},{"type":"paragraph","content":[{"text":"The mxiReader is an image file reader for Nuke that allows you to load MXI files or sequences into Nuke with full 32 bit color information. Once it’s installed, simply open the MXI file(s) as you do any other files in Nuke.","type":"text"},{"type":"hardBreak"},{"text":" The MXI reader loads all the channels available in the MXI file as independent Nuke channels:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Render: Loaded into the rgb main layer.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Light channels","type":"text","marks":[{"type":"link","attrs":{"href":"https://nextlimitsupport.atlassian.net/wiki/spaces/mxdocsv3/pages/5368770"}}]},{"text":": If Multilight was enabled, each light creates a new layer using the light name assigned in Maxwell Render, Maya, 3DS MAX, etc.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Shadow channels","type":"text","marks":[{"type":"link","attrs":{"href":"https://nextlimitsupport.atlassian.net/wiki/spaces/mxdocsv3/pages/5368451"}}]},{"text":": If Multilight was enabled, each light creates a new layer using the light name assigned in Maxwell Render, with the SHADOW_ prefix.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Alpha channel","type":"text","marks":[{"type":"link","attrs":{"href":"https://nextlimitsupport.atlassian.net/wiki/spaces/mxdocsv3/pages/5368448"}}]},{"text":": Creates a layer named ALPHA.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Z-buffer channel","type":"text","marks":[{"type":"link","attrs":{"href":"https://nextlimitsupport.atlassian.net/wiki/spaces/mxdocsv3/pages/5368444"}}]},{"text":": Creates a layer named Z.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Motion Vector channel","type":"text","marks":[{"type":"link","attrs":{"href":"https://nextlimitsupport.atlassian.net/wiki/spaces/mxdocsv3/pages/5368446"}}]},{"text":": Creates a layer named MOTION.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Object ID channel","type":"text","marks":[{"type":"link","attrs":{"href":"https://nextlimitsupport.atlassian.net/wiki/spaces/mxdocsv3/pages/5368447"}}]},{"text":": Creates a layer named OBJECTID.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Material ID channel","type":"text","marks":[{"type":"link","attrs":{"href":"https://nextlimitsupport.atlassian.net/wiki/spaces/mxdocsv3/pages/5368447"}}]},{"text":": Creates a layer named MATERIALID.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Roughness channel","type":"text","marks":[{"type":"link","attrs":{"href":"https://nextlimitsupport.atlassian.net/wiki/spaces/mxdocsv3/pages/5368441"}}]},{"text":": Creates a layer named ROUGHNESS.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Fresnel channel","type":"text","marks":[{"type":"link","attrs":{"href":"https://nextlimitsupport.atlassian.net/wiki/spaces/mxdocsv3/pages/5368443"}}]},{"text":": Creates a layer named FRESNEL.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Normals channel","type":"text","marks":[{"type":"link","attrs":{"href":"https://nextlimitsupport.atlassian.net/wiki/spaces/mxdocsv3/pages/5368438"}}]},{"text":": Creates a layer named NORMALS.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Position channel","type":"text","marks":[{"type":"link","attrs":{"href":"https://nextlimitsupport.atlassian.net/wiki/spaces/mxdocsv3/pages/5368439"}}]},{"text":": Creates a layer named POSITION.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"UV channel","type":"text","marks":[{"type":"link","attrs":{"href":"https://nextlimitsupport.atlassian.net/wiki/spaces/mxdocsv3/pages/5368061"}}]},{"text":": Creates a layer named UV.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Custom Alpha channels","type":"text","marks":[{"type":"link","attrs":{"href":"https://nextlimitsupport.atlassian.net/wiki/spaces/mxdocsv3/pages/5368083"}}]},{"text":": Creates a layer for each custom alpha channel group set in the scene, with the alpha_ prefix.","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"Nuke channel names can only have alphanumeric characters and underscores, so any other characters (like \":\", \"!\", etc.) will be replaced by underscore characters. Each 3D software has its own naming convention so be careful if you use light names in your scripts.","type":"text"}]}]}]}],"version":1},"reason":"A column macro in a rich body macro can't be created or edited in the new editor."}}},{"type":"extension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"legacy-content","text":"","parameters":{"cxhtml":"

The mxiReader Read knob has the following controls. These are not interactive, so they can be slow y some cases (specially when diffraction and scattering are enabled):

mxi_mixer

The MxiMixer

The MxiMixer node allows the user to use the Maxwell Render Multilight feature in Nuke. To load an MxiMixer node in Nuke you have three choices:

Press the x key, or go to File > Script Command and type in "MxiMixer". Select TCL and click OK.
Go to the Maxwell Nodes menu and select MxiMixer (see ).
Type CTRL+M (see ).This creates a new node in the node graph viewer. Attach the MXI file node output to the MxiMixer node input, and the MxiMixer output to a Viewer node (or any other node you need).

The MxiMixer node allows you to mix up to 32 different lights. You can select the lights you want to mix from the MXI file/sequence, or automatically fill the panel with all the lights in the MXI file by using the “Set Channels” button.

You can adjust the intensity of each light independently, and you can even over-expose the lights. The Global Intensity slider allows you to control all the lights’ intensity at once.
The intensity sliders can also be animated. You can work with either a single MXI or with an MXI sequence.

The range of the intensity sliders depends on the type of light. The correspondence with the intensity values in the Maxwell Render Multilight panel is stright-forward. Each light have its own "Mute" and "Solo" options.

Furthermore, you can load .emixer files. Those files are generated in Maxwell Render when you animate lights over time. Simply open the .emixer file in the “Emixer File” dialog, and click on “Load Emixer”.

To take the most of the feature in Nuke, launch your renders in Maxwell Render using "Intensity Multilight" instead of "Color Multilight". The Color Multilight feature can only be used in Maxwell Render, and produces huge MXI files that would be hard to manage in Nuke.

maxwell_simulens

The MaxwellSimulens

MaxwellSimulens node allows the Nuke user to apply the effects available in Maxwell Render to any HDR image in Nuke, including MXIs, EXRs, TIFFs...

mxi_render

The MxiRender

Using the MxiRender node the user can resume a render. Just attach an mxiReader node to a MxiRender node, click on “Get Data from MXI”, check that the fields are correct and click on “Render”. Maxwell Render will then be launched by a command line, resuming your MXI. When the MxiRender node gets the data from the MXI, it puts the target sampling level to the current sampling level + 1 by default. This avoids the risk of resuming a render with a target sampling level less than or equal to the current sampling level.

mxi_mask

The MxiMask

This node takes most of the Material ID and Object ID buffers. It allows the user to create masks for any object or material in the scene easily. The MxiMask node panel has the following parameters:

Objects/Materials: List of objects/materials of the scene, depending on the ID Source value. Reads the objects/materials list from the MXS indicated below.
Read MXS: Reads the MXS File parameter to fill the Objects/Materials list. If MXS File textbox is empty, it tries to find out the source MXS from what the MXI was created.
MXS File: Scene from what the MXI was generated.
ID Source: Selects between Material and Object ID layers.
Invert output: Inverts the generated mask.
Threshold: Sets the “hard edge” of the mask. Any value below the threshold will produce a 0 (mask all), and any value above will produce a 1 (mask none).
Feather: Sets the “soft edge” of the mask. It will produce values between 0.0 and 1.0 for any value of the image below the threshold.
Gradient: Sets the way the “soft edge” is attenuated between 0.0 and 1.0. It is a pow function of the mask value.

","nestedContent":{"type":"doc","content":[{"type":"bodiedExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"column","parameters":{"macroParams":{},"macroMetadata":{"schemaVersion":{"value":"1"},"title":"Column"}}},"content":[{"type":"paragraph","content":[{"type":"hardBreak"},{"text":" ","type":"text"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"mxi_mask"},"legacyAnchorId":{"value":"Nukeplugincomponents-mxi_mask"}},"macroMetadata":{"schemaVersion":{"value":"1"},"title":"Anchor"}}}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"The MxiMask","type":"text"}]},{"type":"paragraph","content":[{"text":"This node takes most of the Material ID and Object ID buffers. It allows the user to create masks for any object or material in the scene easily. The MxiMask node panel has the following parameters:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Objects/Materials: List of objects/materials of the scene, depending on the ID Source value. Reads the objects/materials list from the MXS indicated below.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Read MXS: Reads the MXS File parameter to fill the Objects/Materials list. If MXS File textbox is empty, it tries to find out the source MXS from what the MXI was created.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"MXS File: Scene from what the MXI was generated.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ID Source: Selects between Material and Object ID layers.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Invert output: Inverts the generated mask.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Threshold: Sets the “hard edge” of the mask. Any value below the threshold will produce a 0 (mask all), and any value above will produce a 1 (mask none).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Feather: Sets the “soft edge” of the mask. It will produce values between 0.0 and 1.0 for any value of the image below the threshold.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Gradient: Sets the way the “soft edge” is attenuated between 0.0 and 1.0. It is a pow function of the mask value.","type":"text"}]}]}]}]}],"version":1},"reason":"A column macro in a rich body macro can't be created or edited in the new editor."}}}]},{"type":"bodiedExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"section","parameters":{"macroParams":{},"macroMetadata":{"schemaVersion":{"value":"1"},"title":"Section"}}},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Using the \"Reload Selected/All\" scripts","type":"text"}]},{"type":"paragraph","content":[{"text":"The scripts available in the Maxwell Utilities menu allow the user to reload all/selected file nodes. The advantage of this is that the metadata of the nodes are reloaded too, so when you are using the constant refinement feature you will be sure that you have your MXIs fully updated in Nuke.","type":"text"},{"type":"hardBreak"},{"text":" Note that these scripts are only needed when you use the metadata of the MXIs (the mxiReader metadata is used in the MxiRender node, for example, or in any script you made) and you need these values updated. ","type":"text"},{"type":"hardBreak"},{"text":" ","type":"text"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"mxi_color_adjustments"},"legacyAnchorId":{"value":"Nukeplugincomponents-mxi_color_adjustments"}},"macroMetadata":{"schemaVersion":{"value":"1"},"title":"Anchor"}}}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Using the \"Color Adjustments\" script","type":"text"}]},{"type":"paragraph","content":[{"text":"The Maxwell Color Adjustments script is available through the ","type":"text"},{"text":"Maxwell Nodes menu","type":"text","marks":[{"type":"link","attrs":{"href":"https://nextlimitsupport.atlassian.net/wiki/pages/createpage.action?spaceKey=knfaq&title=Nuke%20plugin%20-%20requirements%20and%20installation"}}]},{"text":", or typing the ALT+M shortcut. The script attaches as many HueShift nodes as the MXI file lights have to the MXI file node, and an MxiMixer node to mix the lights. The goal of the script is to mimic (not faithfully recreate) the Maxwell Render Color MultiLight feature.","type":"text"}]},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"paragraph","content":[{"text":"Note that the MXI doesn’t need to be rendered with the Color MultiLight option enabled, only with the classic Intensity MultiLight on.","type":"text"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"Each HueShift node controls one light channel, so you can shift the colors of each light independently. The second goal of this script is to provide an example of how you can access the MXI node meta-data and use it to make your own scripts easily. Keep in mind that this Color Adjustment script is an accessory and is just an example, so you could use any other color correction tools you might prefer to adjust the intensity and color of each emitter light.","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"panel","attrs":{"panelType":"error"},"content":[{"type":"paragraph","content":[{"text":"Important Note","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"As Nuke cannot manage all the spectral information from Maxwell Render images that MultiLight can, these Color Adjustment nodes can only mimic the high precision spectral changes that Maxwell Render performs, so this poses some limitations. These Color Adjustment nodes performs a hue-saturation shift, so it is not possible to change the color of a pure white emitter (and in general with pure white, grey or black pure desaturated emitters).","type":"text"}]}]}]},{"type":"bodiedExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"section","parameters":{"macroParams":{},"macroMetadata":{"schemaVersion":{"value":"1"},"title":"Section"}}},"content":[{"type":"extension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"legacy-content","text":"","parameters":{"cxhtml":"35%

falsetruepage@all10

Nuke plugin components