Filter Functions

A list of the filters available in Mari, where to find them, and how to apply them can be found in the table below.

Function

How to access it

What it does

Opens this dialog box

Notes

Apply Invert
filter

Menubar | Filters > Invert

Inverts the colors in the selection’s alpha channel. Replaces colors with their “opposite” in the color chart. For example, replaces a color with a float value of 0.3 with a color with float value 0.7.

Apply Invert

 

Apply
Luminosity
filter

Menubar | Filters >
Luminosity

Outputs just the
luminosity value of each pixel in the selection. That is, it outputs a grayscale image based on the
brightness of every pixel in the original image.

Apply
Luminosity

 

Apply In Blur
filter

Menubar | Filters > Blur > Blur

Applies a standard blur to the selection.

Apply Blur

You can select the blur radius - the number of pixels Mari uses when
calculating the blur value for each pixel. The higher the radius, the more blurred the results. If you use a larger blur radius, you may get slight lines on the boundaries between patches. This is an artifact of the way that Mari handles patch edges.

This filter is not supported with Ptex channels.

Apply Soften Blur filter

Menubar | Filters > Blur > Soften

Applies a subtle softening blur. This is a quick,
predefined blur filter. If you need more control over the degree or type of blurring, use either the standard Blur or
Gaussian
Blur filters.

Apply Soften

This filter is not supported with Ptex channels.

Apply
Gaussian Blur filter

Menubar | Filters > Blur > Gaussian

Applies a Gaussian blur. Compared to the
standard Blur filter, this gives you much finer
control over the degree of blurring, and the option of using much higher blur values.

Apply
Gaussian

You can select the blur radius. The higher the radius, the more blurred the results. If you use a higher blur radius, you may see artifacts along the boundaries of
geometry shells and UV patches.

This filter is not supported with Ptex channels.

Apply Gamma
filter

Menubar | Filters > Gamma

Changes the gamma levels in the selection.

Apply Gamma

Do Inverse reverses the gamma conversion. That is, a higher setting for Gamma results in a more washed-out looking image.

Apply sRGB To Linear
Filter

Menubar | Filters > sRGB To Linear

Applies an sRGB to linear colorspace conversion.

Apply sRGB To Linear

Checking Invert applies a linear to sRGB colorspace conversion.

Apply Hue
filter
Menubar | Filters > Hue Changes the hue,
saturation, and value of the colors on the model.
Apply Hue

To change the hue of the colors, set the value for Hue. This moves the
colors around the color wheel. The rotation value is the degree around the color wheel that each color shifts, between 0 and 360 (which both
correspond to the original colors). The options to change the Saturation are:

Saturation - how much saturation is applied. Select a multiplier from 0 to 2, where 1.00 is the original saturation value.

Offset - an offset value to add to the initial
saturation value, before applying the scale.

You can also edit the
Saturation curve. This controls how the filter translates current
saturation values to new values. For each input value along the bottom of the graph, the output value is set from the
position of the line above that point. Edit the curve by:

 

 

 

 

pulling the anchor points,

clicking between anchor points to add a new point, and

right-clicking to select from a set of preset
values.

You can edit the Scale, Offset and Value curve for the value of the colors in the same way.

Apply
Brightness
filter

Menubar | Filters > Brightness

Changes the brightness of the paint, either overall or for specific color
channels. You can also change the contrast.

Apply
Brightness

You can either change the brightness of all color channels at once, or one- by-one. Changing the main Brightness control changes (overwrites) any changes you make to brightness values for
individual color channels.

Apply
Contrast filter

Menubar | Filters > Contrast

Changes the contrast of the paint.

Apply
Contrast

You can select the amount of contrast using the slider.

Apply Clamp filter

Menubar | Filters > Clamp

Clamps color values to lie within the specified upper and lower values.

Apply Clamp

Set the Upper Value and Lower Value by
adjusting the sliders or entering values in the entry boxes.

Select the individual Color Component to clamp in the dropdown menu.

Apply Levels
filter
Menubar | Filters > Levels Changes the color levels in the paint, by setting the white point, midtone, and black point. Apply Levels

You can change the levels of all color components or each color component
separately. You can set the:

Color Component - whether this affects all color components, or a specific one (Red, Green, or Blue).

White Point - the upper limit of displayed color
intensity. Areas with a value higher than this are mapped to 1 (white).

Midtone - the middle point between white and black. Mari remaps the values so that this is the middle of the range between the white point and black point. Moving this pushes the values towards that end of the spectrum.

Black Point - the lower limit of displayed color intensity. Areas with a value lower than this are mapped to 0 (black).

 

 

 

 

White Output Level - how strongly to output the white in the filtered image. Higher values show the entire white output, lower values show decreasing amounts.

Black Output Level - how strongly to output the black in the filtered image. Higher values show the entire black output, lower values show decreasing amounts.

Apply Color Curves filter

Menubar | Filters > Color Curves

Changes the color curve for each color
component (RGB) in the painting.

Apply Color Curves

You can also edit each color curve, controlling how each color
component appears on-screen. This controls how the filter translates current color values to new values. For each input value along the bottom of the graph, the output value is set from the position of the line above that point. Edit the curve by:

pulling the anchor points,

clicking between anchor points to add a new anchor point,

right-clicking to select from a set of preset
values.

Apply Color Switches filter

Menubar | Filters > Color Switches

Turns individual color components on or off.

Apply Color Switches

Use the checkboxes to select which color
components are
displayed. When Mari applies the filter, it removes any unchecked color components from the painting.

Apply Tone
Mapping filter

Menubar | Filters > Tone Mapping

Varies the “exposure” of the painting.

Apply Tone Mapping

You can set the:

White Point - the upper limit of color intensity displayed; any colors of greater intensity map to white.

Exposure - lower
exposures give darker images; higher
exposures give lighter ones.

Apply Copy
Channel filter

Menubar | Filters > Copy Channel

Copies the value from one RGB color
component to the other two. The result is a
grayscale image with the intensity values from the selected component.

Apply Copy Channel

Select the source
component from the list. When you apply the filter, Mari copies the selected component over the other two components.

Apply
Premultiply Alpha filter

Menubar | Filters > Premultiply Alpha

Either pre- or post-
multiplies the alpha in the selected image. If you are painting using an image without premultiplied alpha onto one with it, use this filter to perform the premultiplication, so the images match and you avoid lines around the outside of the patch. Post-multiply works the same, but in reverse (removes
premultiplication to match images that do not have premultiplied alphas).

Apply
Premultiply Alpha

If the Postmultiply box is checked, the
premultiplied alpha is removed.

Apply Edge Detect filter

Menubar | Filters > Edge Detect

Finds “edges”
(transitions between
colors) in the image and heightens them.

Apply Edge Detect

This filter is not supported with Ptex channels.

Apply Emboss
filter

Menubar | Filters > Emboss

Applies an “emboss” effect, so that textures look “raised” on the
surface.

Apply Emboss

This filter is not supported with Ptex channels.

Apply Sharpen
filter

Menubar | Filters > Sharpen

Removes 'fuzziness' and clarifies detail in the image.

Apply Sharpen

You can set the amount of sharpening. Higher values mean more sharpening, while a value of 0.00 is the picture without the filter applied.

This filter is not supported with Ptex channels.

Apply High Pass Filter

Menubar | Filters > High Pass

Removes low frequency information from the image while maintaining higher frequency detail.

This can be useful for quickly creating specular maps where only the higher frequency image highlights are
maintained.

Apply High Pass

You can set the kernel size (the amount of filtering) by adjusting the Radius.

If you use a large radius, you may get slight lines on the boundaries between patches. This is an artifact of the way that Mari handles patch edges.

This filter is not supported with Ptex channels.

Apply OCIO Colorspace
filter

Menubar | Filters > OCIO Colorspace

Applies a a given OCIO colorspace to the current channel or painting.

Apply OCIO Colorspace

Set the colorspace of the current channel or painting in the Input Colorspace dropdown.

Set the colorspace correction to apply to the current channel or painting in the Output Colorspace dropdown.

Apply Add Noise filter

Menubar | Filters > Add Noise

Applies noise to the
current channel or
painting.

Apply Add Noise

Use the Amount slider to adjust how much noise is applied and select the component you want to affect from the Color Component dropdown.

For additive grayscale noise that modifies the intensity while retaining the original color, check the Grayscale
checkbox.

You can regenerate the noise using different
random samples by
dragging on the Seed slider.

Adjust the size of the noise applied by
dragging on the Size slider.