UI: Inaccurate Text -- Texture Paint -> Viewport Overlay -> "Stencil Opacity" -- does not affect Stencil, does affect the Stencil Mask Opacity #80031

New Issue

gamepad.coder · 2020-08-23T03:00:01+02:00

gamepad.coder commented

2020-08-23 03:00:01 +02:00

Blender Version
Broken: v2.83.5

Short description of error :
3D Viewport -> Texture Paint mode -> Show Overlays -> dropdown options

Texture Paint -> Slider has text "Stencil Opacity"

This text needs to say "Stencil Mask Opacity",
since it does not affect the stencil opacity of the Draw tool.

Python tooltip :
Python: View3DOverlay.texture_paint_mode_opacity
bpy.data.screens["Texture Paint"].overlay.texture_paint_mode_opacity

Ambiguity :
When using a texture as a brush for the Draw tool in Texture Paint mode, when the Mapping is set to "Stencil"
(via Properties Editor -> Active Tool and Workspace settings tab -> Brush Settings -> Texture -> Mapping -> "Stencil")
the user will expect this overlay setting to affect the Draw Tool's Stencil opacity.

The setting which changes the Draw Tool's Stencil visual opacity :
3D Viewport in Paint Mode (with Draw tool selected) -> Sidebar -> Tool tab -> Brush Settings panel -> Cursor -> Texture Opacity
or :
Properties Editor -> Active Tool and Workspace settings tab -> Brush Settings -> Cursor -> Texture Opacity

Exact steps for others to reproduce the error :

Related posts & Related instances where this has confused users :

If it's helpful, I think this is the original refactor + larger context, for reference:
https://developer.blender.org/D5279

The ambiguous text "Stencil Opacity" in the overlay resulted in the following bug reports:
https://developer.blender.org/T69172
https://developer.blender.org/T66968

The following is a good example of impact,
the linked answer inaccurately references this Stencil Mask Opacity slider (currently titled "Stencil Opacity")
as a solution for changing the Stencil's visual opacity:
https://blender.stackexchange.com/a/171004/103940

For what it's worth :

Using the Texture Paint mode for the first time, this was very confusing, and took me an hour to piece together the information.

Trying to figure out how to adjust the transparency of the stencil tool for better visibility of the object behind it was very difficult,
and several search results suggested changing this Stencil Mask Opacity setting, inaccurately.

Suggested Change :

Change the following Overlay setting's slider to have the following text :

3D Viewport -> in Texture Paint mode -> Show Overlays -> dropdown options

Texture Paint -> change the Slider's text to "Stencil Mask Opacity" instead.

(~Have a great day~)

**Blender Version** Broken: v2.83.5 **Short description of error :** `3D Viewport` -> `Texture Paint mode` -> `Show Overlays` -> dropdown options - > `Texture Paint` -> Slider has text "**Stencil Opacity**" This text needs to say "**Stencil Mask Opacity**", since it does *not* affect the stencil opacity of the Draw tool. **Python tooltip :** Python: View3DOverlay.texture_paint_mode_opacity bpy.data.screens["Texture Paint"].overlay.texture_paint_mode_opacity **Ambiguity :** When using a texture as a brush for the Draw tool in Texture Paint mode, when the Mapping is set to "Stencil" (via `Properties Editor` -> `Active Tool and Workspace settings` tab -> `Brush Settings` -> `Texture` -> `Mapping` -> "Stencil") the user will expect this overlay setting to affect the **Draw Tool's Stencil opacity**. **The setting which changes the Draw Tool's Stencil visual opacity :** `3D Viewport` in `Paint Mode` (with Draw tool selected) -> `Sidebar` -> `Tool` tab -> `Brush Settings` panel -> `Cursor` -> `Texture Opacity` or : `Properties Editor` -> `Active Tool and Workspace settings` tab -> `Brush Settings` -> `Cursor` -> `Texture Opacity` **Exact steps for others to reproduce the error :** ![blend.dev.#69172.p1_sizeOptimized.gif](https://archive.blender.org/developer/F8805164/blend.dev.#69172.p1_sizeOptimized.gif) ![blend.dev.#69172.p2a_sizeOptimized.gif](https://archive.blender.org/developer/F8805171/blend.dev.#69172.p2a_sizeOptimized.gif) **Related posts & Related instances where this has confused users :** If it's helpful, I think this is the original refactor + larger context, for reference: https://developer.blender.org/D5279 The ambiguous text "Stencil Opacity" in the overlay resulted in the following bug reports: https://developer.blender.org/T69172 https://developer.blender.org/T66968 The following is a good example of impact, the linked answer inaccurately references this Stencil Mask Opacity slider (currently titled "Stencil Opacity") as a solution for changing the Stencil's visual opacity: https://blender.stackexchange.com/a/171004/103940 **For what it's worth :** Using the Texture Paint mode for the first time, this was very confusing, and took me an hour to piece together the information. Trying to figure out how to adjust the transparency of the stencil tool for better visibility of the object behind it was very difficult, and several search results suggested changing this Stencil Mask Opacity setting, inaccurately. **Suggested Change :** Change the following Overlay setting's slider to have the following text : `3D Viewport` -> in `Texture Paint` mode -> `Show Overlays` -> dropdown options - > `Texture Paint` -> change the Slider's text to "**Stencil Mask Opacity**" instead. (~Have a great day~)

gamepad.coder commented

2020-08-23 03:00:01 +02:00

Added subscriber: @Gamepad-Coder