Synchronize Material Viewport Color

Version: 1.0.2

Author: Qiu Feng arcqiufeng@hotmail.com

Design Purpose

In Blender's Viewport Solid Display mode, color rendering follows an independent mechanism. The colors displayed in this mode are decoupled from the Principled BSDF shader in the Material Properties panel, meaning the viewport does not automatically sync with the actual material colors. Although texture maps display normally, the base color of the material requires manual parameter copying and pasting to achieve synchronization.

In design modeling scenarios that require real-time updates, the need to display material colors in real time is particularly urgent. While designers can model in Material Preview or Rendered modes, these approaches are inefficient. Enabling the Solid Display mode to intuitively present colors synchronized with material properties allows designers to make design decisions efficiently through immediate visual feedback, precisely control the overall visual effect, and reduce post-production adjustment costs.

Functional Features

1. Automatically sets the diffuse color, metallic度 (metallic), and roughness for viewport display based on material nodes. It also automatically switches the Solid Display mode to Textured to show both material colors and textures simultaneously.
2. Compatible with Principled BSDF, Glass BSDF, Metal BSDF, and Emission nodes.
3. For translucent materials,适度 (moderately) adds transparency to the solid color.

Supported Versions

Blender 4.2 and above

Usage Instructions

1. After installing the add-on, right-click an object (multiple selection allowed) in the 3D Viewport. The item "Synchronize Material Viewport Color" will appear in the menu.
2. Click the item to set the viewport display properties based on the material nodes.

Notes

1. This add-on only affects viewport display and does not modify rendering results.
2. The add-on has only been tested in Blender 4.2 and above. Its compatibility with older versions requires self-testing.
3. Due to the author's limitations, the add-on has only been tested on Windows. Its functionality on Mac or Linux platforms requires self-testing.

Version History

1.0.2

• Removed real-time synchronization functionality.

1.0.1

• Initial release.

同步材质视口颜色

版本：1.0.2

作者：Qiu Feng arcqiufeng@hotmail.com

设计目的

在 Blender 的视口实体显示模式下，颜色显示遵循独立机制。该模式下的颜色显示与材质属性面板中原理化 BSDF 着色器相互独立，致使视口无法自动同步实际材质颜色。虽纹理贴图能正常显示，但材质的基础色彩仍需手动复制粘贴参数才能实现同步。

在设计建模同步场景里，实时显示材质颜色的需求尤为迫切。尽管设计师可在材质预览或渲染模式下进行建模操作，然而这种方式效率较低。若能在实体显示模式下直观呈现与材质属性同步的色彩效果，设计师便能借助即时视觉反馈，高效做出设计决策，精准把控整体视觉效果，进而降低后期调整成本。

功能特性

1. 依据材质节点，自动设定视口显示的漫反射颜色、金属度和粗糙度。并自动把实体显示模式改为纹理以同时显示材质颜色和纹理。
2. 兼容原理化 BSDF、玻璃 BSDF、金属 BSDF、自发光节点。
3. 针对半透明材质，在实体颜色中适度添加透明度。

支持版本

Blender 4.2 及以上版本

使用说明

1. 安装插件后，在 3D 视图中右键点击对象(允许多选)，菜单里会出现“同步材质视口颜色”选项。
2. 点击该选项，即可依据材质节点设置视口显示属性。

注意事项

1. 该插件仅对视口显示产生影响，不会修改渲染结果。
2. 该插件仅在 Blender 4.2 及以上版本测试过。是否能在旧版本中正常运行，需自行测试。
3. 由于作者自身条件限制，该插件仅在Windows平台下测试过。是否能在Mac或Linux平台下运行，需自行测试。

版本历史

1.0.2

• 去除实时同步功能。

1.0.1

• 初始版本