General Usage Instructions
First, make sure to open the material browser from Autodesk® Revit® ,first. It will load project material temporary thumbnails somewhere in C:\Users\YourName\AppData\Local\Temp. Then, you can open SuperPaint Browser. It will cache all those thumbnails. This process only needs to be done once for each project if file is been used recently so temporary thumbnails aren't been deleted by OS. If it still has missing thumbnails, a "Missing Thumbnail" selection will be added to the Material class dropdown box. Those materials are either edited or created by API or Dynamo. If you want to cache those missing thumbnails, you need to open the Revit material browser and check each material individually. Click on each material's appearance asset tab and wait till updating... disappear and a new thumbnail will get generated. After that, you can click on reload button of the SuperPaint Browser. It will update those material's thumbnails and save them for next time use. This add-in helps you to cache those temporary thumbnails, so you don't have to wait extra time for those thumbnails to be regenerated in each session. Please note that some material still can't be cached due to the API limit.
All four functions: Remove Paint/ Paint System/ Paint Family/ Paint Topo are dynamic loops for continued Painting. During each execution loop, you can change the material selection in the SuperPaint browser at any time, it will apply new material to the next execution. To exit the function, hit ESC on the keyboard or mouse right-click “Cancel” Menu Item.
Fix Asset Name function is for fixing the materials which have invalid characters in their asset names. The Revit material browser can't create a temporary thumbnail and leaves it blank.
The rest of the functions are quite intuitive. Please follow the demo video on YouTube to learn those features.
Currently, the Paint Family function supports the following categories:
- All custom instance families (Except Imported CAD objects in them)
- For System families:
- wall/ Floor/ Roof/ Ceiling
- Structure Foundation/ Building Pad/ Column
- Railings (Revit versions after 2019 only)
- Fascia/Gutter/Roof Soffit/SlabEdge
#categories will be expanded based on customer requests.
#You need to have a face associated with a material parameter to be able to use the Paint family function. If no associated parameter is found with the picked face, the process will fail.
#When using the Paint Family tool, if the selected face is painted, then the paint will get removed and use the original material to find the correct material parameter to set.
# Paint Family function is based on face's material value, not by geometry. If the same family instance has several parameters with the same material value, all those parameters' values will be set the same as the new material. Type/ Instance/ Global Parameters are all supported.
#You need to have the right to access C:\Users\YourName\AppData\Local\Temp folder. Otherwise, the app won't cache material thumbnails for you. If you do encounter this problem, please ask Google for How to take ownership of the folder in WinXX. Make sure to check "Replace all child object permission entries with inheritable permission entries from this object" in the Advanced setting.
# Cached thumbnail files are saved in C:\Users\YourName\Documents\SuperPaint\. You can specify how long they will be kept in the folder in settings. Default is set to 14 days.
The installer that ran when you downloaded this app/plug-in from Autodesk App Store will start installing the app/plug-in. OR, simply double-click the downloaded installer to install the app/plugin.
To uninstall this plug-in, exit the Autodesk product if you are currently running it, simply rerun the installer, and select the "Uninstall" button. OR, click Control Panel > Programs > Programs and Features (Windows 7/8.1/10/11) and uninstall as you would any other application from your system.
1).Paint Import CAD objects is not supported
2).Not working in editing In-Place family mode.
|Version Number||Version Description|
|For Win 11: thumbnails stacking error fixed.|
|Fix: 1). Temp folder access error Add: 1).View menu: -Add selecting custom cached thumbnails saved location. 2).Thumbnail click: -Showing material's properties in property browser. (Editing material's instance properties has never been this easy.) 3).Thumbnail right click menu: -Copy material between opened projects or families. -Add Delete material function. -Add right click in thumbnail listview's blank area to show material parameter(In Family environment:parameter; In Project environmnet:Global parameter) assigned material and affected elements. (Very useful before you need to delete some material parameter to see what will be affected.)|
|-Add 2023 support -Improve Paint nested Family(SuperComponent) speed.|
|-Add Thumbnail cache days: Forever option -Fix in Windows 11, form Expand\Collapse button missing issue|
|-Add Fascia/Gutter/Roof Soffit/SlabEdge support for Paint Family function -Fix Form display Topmost issue -Re-design Form Expand\Collapse button|
|First public version|