From BlenderWiki

Jump to: navigation, search

Texture Painting

Material Texture Slot Support

Texture painting has a new system to determine images and UV mapthat will be used during painting. The old workflow of switching to the UV editor and assiging an image is substituted by a workflow more tied to the mesh's materials.

The system now also includes code to automatically set a material, uv map (if missing) and diffuse texture for painting. Note here, the UV map generated just maps the whole UV space to each face and is not optimal at all for all but the most simple use cases (painting on a plane wall/floor for instance).

The UI now automatically detects any material textures that are candidates for painting and displays them under the new Slot tab. To paint on a certain slot just click on it. For blender internal, there is a drop down that allows the addition of additional slots. Slots added here are directly added on the material. Clicking on a slot here will also display the image on image editors, if any are open.

For Blender Internal, texture paint slots are material texture slots that use images and UV mapping. The UV map that is used during painting is either the assigned on the UV slot of the material texture UV slot, or the active UV layer of the mesh (this is the highlighted UV map under the mesh tab in the properties screen) if no UV map has been assigned.

For cycles, all texture images on the material's node tree are added on the layer tab and the texture paint slot UV map is always the active UV map of the mesh. Custom UV maps in the node tree are not used yet, but may be in the future.

Sharpen Tool

Based on unsharp masking, a new tool has been added as a negative to the soften brush. By selecting "Sharpen" in the UI or pressing CtrlLMB Template-LMB.png with the soften tool, the sharpen tool is used instead. Also, the soften tool has been imporoved as well, by allowing custom blur kernel sizes, as well as an extra blur kernel, gaussian apart from box. A sharpen threshold value controls the threshold for edge detection for application of the sharpen tool.

Sharpen filters need subtlety, make sure that low brush strength is used.

Fill Tool

In texture painting, a new fill tool is available. To use it, while in an image paint mode, select the fill tool from the Brush sub-menu in the header/footer. It can be used to fill the image with a the brush color. For projective texturing it will use the options for projective painting to paint the model. That means that occluded, backfacing, stenciled and normal culled faces will not get filled unless the options are deactivated in the projection paint panel. Also, it is still currently limited to filling the part of the mesh within screen boundaries (will be fixed).

The fill tool allows the use of gradient to fill the image. This gradient may defined by clicking the "Use Gradient" checkbox. There are two modes available, radial and linear, each filling the image in the respective way. To define the gradient colors, a color band widget appears in the brush color section, that helps the user define the gradient color and alpha. To apply the gradient, the user must click and drag on the image to define the gradient line, or radius, if radial gradient is used.

Mask Tool

The mask tool is used in projective texturing and it allows easy use of the previous stencil feature. The stencil feature actually maps an image to the mesh and uses image intensity to mask out certain parts of the mesh out during painting. It is also possible to invert and deactivate the stencil in the options tab/panel. Also visual feedback is now provided when using stencils.

Gradient Strokes

In texture painting, the user can use a gradient as a source for color. This gradient may defined by clicking the "Use Gradient" checkbox. The gradient source drop down menu allows three sources for gradient colors, pressure repeat and clamp. To define the gradient colors, a color band widget appears in the brush color section, that helps the user define the gradient color. Alpha is not yet taken into consideration for blending operations.

The gradient sources operate as follows:

Pressure will choose a gradient color from the color band according to the stylus pressure, while clamp and repeat will alter the color automatically by the distance covered by the brush and as specified by the gradient spacing field, with clamp using the last color of the color band after the specified and repeat resetting the color to the first color in the color band and repeating the pattern.

Brush Opacity Control

It is now possible to explicitly disable opacity masking by clicking the accumulate checkbox under the colour wheel in the brush. This will allow a stroke to accumulate on itself, just like an airbrush would do. When accumulate option is active, a lock icon is present next to the strength of the brush that allows attenuating the brush strength according to spacing.

Mask Pressure support

Based on feedback from, a mask cut-off function was added to the mask textures. It allows to clip the mask result based on pressure, creating areas of no paint when low pressure is applied to the brush, similar to how a real brush would behave.

There are two modes in the tool, Ramp and Cutoff.

  • Cutoff simply selects between 0 and 1 based on stylus pressure
  • Ramp distributes the mask effect above the pressure value.
Mask Pressure modes in action.

A picture showing the result is above:

From top to bottom:

  • Strength pressure influence ON:
    • No mask influence
    • Cutoff mask influence
    • Ramp mask influence
  • Strength pressure influence OFF:
    • No mask influence
    • Cutoff mask influence
    • Ramp mask influence

Drag Dot Stroke Mode Support

Drag dot style strokes leave only one dab on the mesh surface which can be placed by dragging on the mesh surface or the image editor.

Anchored Stroke Mode Support

Anchored strokes are done on a specific spot on the mesh. As the user drags the mouse, the size of the dab changes, but the location stays constant. There is also an edge to edge mode where the dab is positioned between the initial and current mouse position.

Moarz Blend Modes

16 new blend modes have been added, as part of a patch written by Fredrik Hansson

They are:

  • Overlay
  • Hard light
  • Color burn
  • Linear burn
  • Color dodge
  • Screen
  • Soft light
  • Pin light
  • Vivid light
  • Linear light
  • Difference
  • Exclusion
  • Hue
  • Saturation
  • Luminosity
  • Color

Docuentation for those can be found temporarily here:

All Modes

New Stroke Modes

Line strokes

Select "Line" under the stroke drop down menu or when pressing E Clicking and dragging lets the user define a line in screen space. The line dabs are separated by the spacing parameter in the stroke panel, similar to space strokes. This stroke mode is available to all paint modes.

Curved strokes

Curve stroke tool UI.

Select "Curve" under the stroke drop down menu or when pressing E. The user can define additional curve control points by using CtrlLMB Template-LMB.png. The user can define the curve better by dragging the mouse before releasing the mouse button. The curve handles can be dragged around with LMB Template-LMB.png. To ensure the handles of a control point form a smooth result, drag them around using ⇧ ShiftLMB Template-LMB.png. To delete a curve point use X The curve dabs are separated by the spacing parameter in the stroke panel, similar to space strokes. This stroke mode is available to all paint modes. To confirm and execute the curved stroke, press ↵ Enter or use the Draw Curve button at the stroke panel. Stroke Curves are reusable and can be stored and selected by using the dropdown menu at the stroke panel. They also support a few transform operators such as grabbing, scaling and rotating. The handles can be selected individually by using RMB Template-RMB.png, extend the selection by ⇧ ShiftRMB Template-RMB.png and deselected/all selected by using A.

Unified Color

Similar to unified strength and unified size, unified color, accessible from the options panel, allows color brushes to share colors.


Colour palettes are supported in texture and vertex paint mode. To add a palette you can find a palette block under the brush colours in the toolbar. Palette colours can be added in two ways. Pressing the + icon in the palette will copy the current brush colour into the palette, and sampling with S and pressing LMB Template-LMB.png.

The palette colours can be changed by CtrlLMB Template-LMB.png and using the colour swatch.

To delete a palette colour, hover over it and press Del. Colour drag'n drop support has now been added too.

Brushes can use two colours. One is the primary colour and the second, displayed below the primary is the background or secondary colour. To paint with the secondary colour use CtrlLMB Template-LMB.png To switch between the two colors use X

Usability improvements

  • Better colour sampling in the 3d viewport, samples colour from the texture of the mesh, making it easier to paint similar colours by sampling directly on a mesh.
  • You can deactivate mesh display in the uv editor while in one of the image paint modes by unticking "Draw Texture Paint UVs" in the view menu.
  • Radial operators (F, ⇧ ShiftF, CtrlF, CtrlD) now have a precision mode by holding shift.