Example: DefaultChannels.mtd

The default channel presets file is included in Mari in the ../Bundle/Media/Settings directory (on Windows)(DefaultChannels.mtd). We recommend you create your custom channels file by copying this and editing it, rather than starting from scratch.

Note:  The fileSpace and colorSpaceConfig parameters are not present in the DefaultChannels.mtd file, but you can add them to it, see Reviewing the Custom Channel Preset File Format

Note:   The example below shows the parameters of the color channel. These parameters apply to all channels.

<!DOCTYPE MariML>
<Mari Version="2" >
 <MriSerializableObject Type="MriSerializableObject" >
  <objectName Type="QString" ></objectName>
  <selected Type="bool" >false</selected>
  <m_Channels Type="MriChannelInfo" ContainerType="QVector" >

   <MriChannelInfo Type="MriChannelInfo" >
    <objectName Type="QString" ></objectName>
    <selected Type="bool" >false</selected>
    <channelName Type="QString" >color</channelName>
    <fileFormat Type="QString" ></fileFormat>
    <path Type="QString" ></path>
    <scalar Type="bool" >false</scalar>
    <width Type="int" >4096</width>
    <height Type="int" >4096</height>
    <channels Type="QString" >RGBA</channels>
    <depth Type="QString" >Byte</depth>
    <color Type="MriColor" >(0.5,0.5,0.5,1)</color>
    <category Type="QString" >General</category>
    <fileSpace Type="QString" >Vector</fileSpace>
    <colorSpaceConfig Type="MriColorSpaceConfig" >0|1|2|3|4|5|6|7|8|9|10</colorSpaceConfig>
   </MriChannelInfo>

colorSpaceConfig Parameter

As the colorSpaceConfig parameter is a bit more complex than the other parameters, it is explained in detail below:

Note:  Automatic is the default value.

Key

Description

Data type with an example value

0

colorspace filename

string (for example, nuke-default or Automatic)

1

data colorspace

string (for example, rec709 or Automatic)

2

output colorspace

string (for example, rec709 or Automatic)

3

working colorspace

string (for example, rec709 or Automatic)

4

automatic colorspace 0

int (for example, 0, 1, 2)
Sets the automatic value for the data colorspace, assigning certain colorspace values to set integers.

5

automatic colorspace 1

int (for example, 0, 1, 2)
Sets the automatic value for the output colorspace, assigning certain colorspace values to set integers.

6

raw mode enabled

bool (int) Enables (1) or disables (0) raw mode

7

scalar mode enabled

bool (int) Enables (1) or disables (0) scalar mode

8

automatic data colorspace

string (for example, rec709)
Specifies which colorspace is chosen when using Automatic value.

Note:  Setting this value overwrites 4 automatic colorspace 0.

9

automatic output colorspace

string (for example, rec709)
Specifies which colorspace is chosen when using Automatic value.

Note:  Setting this value overwrites 5 automatic colorspace 1.

10

automatic working colorspace

string (for example, rec709)
Specifies which colorspace is chosen when using Automatic value.

Below is an example of the colorSpaceConfig parameter:

<colorSpaceConfig Type="MriColorSpaceConfig">nuke-default|rec709|Automatic|Automatic|0|0|0|0|Cineon|Cineon|Cineon</colorSpaceConfig>

This creates a channel with rec709 data colorspace, but Cineon working and output colorspaces. Raw and Scalar are off.