Painting Palette

The Painting palette and the controls that can be found on it are described in the table below. When controls also bring up additional dialogs, these are referenced for more information.

What It Does

The Painting palette displays information and controls for managing painting features.

Painting Palette Fields

Control

Type

What it does

Opens this dialog box

Notes

Painter > Filtering | Image

dropdown

The image filtering to use when
copying textures using the clone tools (CloneStamp and PaintThrough). One of:

Nearest - preserves edge detail, but gives quite "blocky" textures.

Bilinear - gives good results, but can produce square artifacts at extreme zoom.

Bicubic - provides more rounded results, slightly blurrier but without the square artifacts.

 

 

Painter > SourceGrade | Enabled

checkbox

Enables source image grading.

Used this to grade your source image when cloning from or painting through an image.

 

 

Painter > SourceGrade | Blackpoint

text field, slider

Sets the blackpoint of the RGB values.

 

Blackpoint is the color value at which the input is
considered to be 100% black.

Painter > SourceGrade | Whitepoint

text field, slider

Sets the whitepoint of the RGB values.

 

Whitepoint is the color value at which the input is considered to be 100% white.

Painter > SourceGrade | Lift

text field, slider

Lifts the blackpoint, while keeping the
whitepoint the same.

 

 

Painter > SourceGrade | Gain

text field, slider

Adjusts the whitepoint, while keeping the blackpoint the same

 

 

Painter > SourceGrade | Multiply

text field, slider

Multiplies the value to lighten the texture while preserving the blackpoint.

 

 

Painter > SourceGrade | Offset

text field, slider

Specifies a fixed value to add in order to lighten the texture.

 

Adding negative values essentially darkens the
texture.

Painter > SourceGrade | Gamma

text field, slider

Adjusts the midtones, while keeping the
whitepoint and blackpoint the same.

 

 

Painter > SourceGrade | Rgb

text field, slider

Changes the overall color saturation for all three color components of the source image. Moving this also moves the separate Red, Green, and Blue sliders.

 

 

Painter > SourceGrade | Red

text field, slider

Changes the color saturation in the Red component of the source image.

 

 

Painter > SourceGrade | Green

text field, slider

Changes the color saturation in the Green component of the source image.

 

 

Painter > SourceGrade | Blue

text field, slider

Changes the color saturation in the Blue component of the source image.

 

 

Painter > SourceGrade | Contrast

text field, slider

Changes the contrast of the source image.

 

 

Painter > SourceGrade |
Saturation

text field, slider

Changes the color saturation of the source image. Used in addition to the RGB sliders.

 

 

Painter > SourceGrade | Value

curve editor

Allows you to edit the color value curve for the source image.

 

 

PaintBuffer > PaintBuffer | ColorDepth

dropdown

Color depth of the paint buffer. 8, 16, or 32-bit color.

 

 

PaintBuffer > PaintBuffer | BufferSize

dropdown

Onscreen resolution of the paint
buffer. This controls the amount of detail you can use when painting, not the resolution of the patches in your project.

 

 

PaintBuffer > PaintBuffer | Clamp

checkbox

If this is checked, Mari restricts the range of the image to values between 0 and 1.

 

 

PaintBuffer > Transform |
Translation

text fieldes

The amount that the buffer has been translated (moved onscreen) from the default.

 

 

PaintBuffer > Transform | Scale

text fieldes

The amount that the buffer has been scaled (resized) from the default.

 

 

PaintBuffer > Transform |
Rotation

text field, slider

The amount that the buffer has been rotated from the default.

 

 

PaintBuffer > Transform | Reset

button

Resets the paint buffer to the default values, removing any translations or distortions you have applied.

 

 

PaintBuffer > Transform | Resetonbake

dropdown

Either:

Enabled - the paint buffer
automatically resets to default
settings every time you bake the paint.

Disabled - any changes you have made to the paint buffer stay until you manually click the Reset
button.

 

 

Projection Settings > Masking |
Masking Disabled

checkbox

Disables all masking,
regardless of channel, and overrides the Masking Enabled setting.

 

When enabled, a icon
displays in the status bar.

Projection Settings > Masking |
Mask Preview Color

swatch

What color to display the
masking on-screen.

 

 

Projection Settings > Masking | MaskPreviewEnabled

checkbox

Shows the masking. Areas that are covered by the current defined mask(s) are shown colored. This includes all the masking currently in use – for example, if you have both the edge mask and depth mask turned on, Mari shows the effects of both
simultaneously.

 

When enabled, a icon
displays in the status bar.

Projection Settings > Painting |
PaintingMode

dropdown

The blending mode used when the paint bakes down onto the channel surface. The default is Normal (paint in the buffer overwrites the surface), but Mari supports a number of other blending modes.

 

 

Projection Settings > Painting |
Painting
Opacity

text field, slider, reset

How opaque the paint is. This is a multiplier on the paint
buffer contents. At 1.0, the paint bakes down to the
surface with the same opacity as it is in the buffer. At 0.5, the paint applied to the surface is half as transparent as when it's in the buffer.

 

 

Projection Settings > Projection |
ProjectionFilter

dropdown

The image filtering to use when calculating how to apply the paint buffer onto the
surface. One of:

Nearest - preserves edge detail, but gives quite "blocky" textures.

Bilinear - gives good results, but can produce square
artifacts at extreme zoom.

 

 

Projection Settings > Projection |
BakeBehavior

dropdown

One of:

Manual - you have to bake manually. After a bake, the paint stays in the paint
buffer until you manually clear it.

ClearOnly - you have to bake manually. After a bake, the paint buffer clears
automatically.

AutoBakeAndClear - Mari bakes, and then clears the paint buffer, whenever you move the model.

 

 

Projection Settings > Projection |
Projection

dropdown

One of:

Front - paint only applies to the front of the model, as it is visible in the current view.

Through - paint applies to all surfaces on the model under your brush, whether or not there is something in front of them.

 

 

Projection Settings > Projection |
ProjectOn

dropdown

Either:

All - you can paint on all areas on your model(s),
selected or not.

SelectedOnly - you can only paint on the currently
selected areas.

 

 

Projection Settings > EdgeMask

toggle

Whether the edge mask is turned on or not. If this is on, but MaskPreviewEnabled is off, the model is masked but you won't see the masking. That is, you can see the mask's effects, but not the mask itself.

 

When enabled, a icon
displays in the status bar.

Projection Settings > EdgeMask >
General | FalloffEnd

text field, slider, reset

Controls where the edge mask ends on the model. The higher the value, the closer, more
forward facing the mask
finishes.

 

Range: 0.00 to 1.00 Reset: 0.00

Projection Settings > EdgeMask >
General | FalloffStart

text field, slider, reset

Controls where the edge mask starts on the model. The higher the value, the more
forward facing the masking starts. If this is higher than the FalloffEnd, areas facing the view are paintable, and areas oblique to the view are masked. If this is lower, facing areas are masked and oblique areas are paintable.

 

Range: 0.00 to 1.00 Reset: 0.00

Projection Settings > ChannelMask

toggle

Whether the channel mask is turned on or not. If this is on, but MaskPreviewEnabled is off, the model is masked but you won't see the masking. That is, you can see the mask's effects, but not the mask itself.

 

When enabled, a icon
displays in the status bar.

Projection Settings > ChannelMask > General | MaskChannel

dropdown

Sets the channel holding the mask for the paint buffer. This mask sets the paintable area within the buffer.

 

 

Projection Settings > ChannelMask > General | MaskAmount

text field, slider, reset

The amount that the mask affects the paint buffer. 1.0 means that the mask
absolutely controls where you can paint; the effects of the mask decrease as the value gets lower.

 

 

Projection Settings > ChannelMask > General | MaskContrast

text field, slider, reset

The contrast applied to the
original channel to derive the mask. At 1.0, the mask comes directly from the original
channel. Lower values make the mask fuzzier than the input channel, higher values make it sharper than the input channel.

 

 

Projection Settings > ChannelMask > General | Mask Curve

curve editor, reset

Sets how the channel masking works.

The x axis is the color of the source pixel (black to the left, white to the right). The y axis is how paintable the target pixel is. By default, the curve runs from the bottom at the left up to the top at the right - so black pixels are totally masked, white pixels are totally
paintable, and there's a
constant curve between the two. Use this if you want to change which pixel values are masked.

 

 

Projection Settings > ChannelMask > General | Invert

check box

Whether to invert the input from the mask. If this is
selected, the mask data is black on white rather than white on black.

 

 

Projection Settings > Ambient
Occlusion Mask

toggle

Whether the ambient
occlusion mask is turned on or not. If this is on, but
Mask
PreviewEnabled is off, the model is masked but you won't see the masking. That is, you can see the mask's effects, but not the mask itself.

Before using this, you should calculate the ambient
occlusion for each object in the project (Objects menu, select AmbientOcclusion).

 

When ambient occlusion
masking is enabled, a icon displays in the status bar.

Projection Settings >
AmbientOcclusionMask > General | Mask Amount

text field, slider, reset

The amount of ambient
occlusion masking to apply.

 

 

Projection Settings >
AmbientOcclusionMask > General |
MaskContrast

text field, slider, reset

The contrast applied to the ambient occlusion to derive the mask. At 1.0, the mask comes directly from the
calculated ambient occlusion. Lower values make the mask fuzzier than the ambient
occlusion, higher values make it sharper.

 

 

Projection Settings >
AmbientOcclusionMask > General |
MaskCurve

curve editor, reset

Controls how the ambient occlusion pixel values relate to the degree of masking. The horizontal axis is the darkness of the occluded pixels (black to the left, white to the right), the vertical axis is the degree of
visibility. By default, this is a direct line, where white pixels are totally masked, black pixels are totally unmasked, and 50% gray is 50% masked.

 

 

Projection Settings >
AmbientOcclusionMask > General |
Invert

checkbox

If this is selected, the mask data is black on white rather than white on black.

 

 

Projection Settings > DepthMask

toggle

Whether the depth mask is turned on or not.

 

When enabled, a icon
displays in the status bar.

Projection Settings > DepthMask > General | Start

text field, slider, reset

The depth in the scene for the depth masking to start.

 

 

Projection Settings > DepthMask > General | End

text field, slider, reset

The depth in the scene for the depth masking to finish.

 

 

Projection Settings > DepthMask > General | Falloff

text field, slider, reset

How fast the depth masking applies. Lower values make the mask apply slowly, higher values make it apply more quickly.

 

 

Projection Settings > BackfaceMask

toggle

Whether the backface mask is turned on or not.

 

When enabled, a icon
displays in the status bar.

Projection Settings > Fractal Noise Mask

toggle

Whether the fractal noise mask is turned on or not.

 

When enabled, a icon
displays in the status bar.

Projection Settings > Fractal Noise Mask > General | Seed

text field, slider, reset

Changes the pattern of the noise by moving the pattern through 3D space.

 

 

Projection Settings > Fractal Noise Mask > General | Contrast

text field, slider, reset

Controls the level of contrast applied to the fractal noise
features to derive the mask.

 

 

Projection Settings > Fractal Noise Mask > General | Roughness

text field, slider, reset

Determines the roughness of the fractal noise features.

 

 

Projection Settings > Fractal Noise Mask > General | Size

text field, slider, reset

Determines the size of the fractal noise features.

 

 

Projection Settings > Fractal Noise Mask > General | Mask Amount

text field, slider, reset

The amount that the mask affects the paint buffer. 1.0 means that the mask
absolutely controls where you can paint; the effects of the mask decrease as the value gets lower.

 

 

ProjectionSettings > Fractal Noise Mask > General | Mask Curve

curve editor, reset

Controls how the fractal noise relates to the degree of
masking, based on the above fields. This allows you to fine tune the contrast and pattern appearance of the fractal noise mask.

 

 

Projection Settings > Fractal Noise Mask > General | Invert

checkbox

If this is selected, the mask data is black on white rather than white on black.