Blendflakes
Introduction
This is a simple script that, like pyflakes for python scripts, checks a Blendfile for 'niceness' From our perspective, it does checks that make it easier for people to understand/use each other's library files, and uses/enforces/creates a text description file with the same name, so that we can describe our groups:
libraryfile.blend and libraryfile.txt
errors/warnings are written to libraryfile.err
Installation and Usage
Installation
- Start a new file and go to the User Preferences, select the Addons tab, and click on "Install Addon..." in the lower part of the window.
- Browse to the file blendflakes.py (usually in tubeSVN/lib/python/addons,) select it and hit Enter
- Check the activation box next to the addon, and then press "Save As Default" at the bottom of the window.
Usage
- Open a model file you want to check.
- Press 'w' and select Show Warnings/Errors in library file (you can also use the spacebar search)
- Blender will output all warnings by default, and select offending objects.
- If you use w and want to change options, do so in the last operator region in the toolbar, then press w again (If you use spacebar search you will get a popup anyway)
- warnings are shown in the info area (drag down the header)
- if export is checked, they are saved to libraryfile.err (where libraryfile is the name of your .blend file)
- If you have a lot of warnings you might want to uncheck some of them and tackle them a few at a time.
List of Warnings
Following is a list of the things we check for:
Default Data Name
Data not Named(default name)
The Object Data (e.g. Mesh or Curve) has a default name like Cube, Cone, Armature, (note not the object name)
Action
Change the object data names, preferebly to match their Objects. You can use the outliner, the properties editor, python console or an AddOn to do this. If Select was checked, the offending objects will be selected.
Out of Sync Data Name
Data Name not equal Object Name
The object data and object names do not match; i.e. Cube with the mesh Sphere; the script is smart enough to deal with multi-user data differently.
Action
Change the object data names to match their Objects. You can use the outliner, the properties editor, python console or an AddOn to do this. If Select was checked, the offending objects will be selected.
Group Unrecorded
Groups not in text file
Their is a group in the Blend file that is not in the description file
Action
Open the libraryfile.txt and add your group into it as follows: group name description of what the group is for (specify if it is for linking e.g.) comma seperated list of layers (starting with 0) that the group duplis. similar to the above, but for un-duplid layers blank line
Groups in Blend
Groups text file not in Blend
There is a group in the text file that is not in the .blend.
Action
Either delete it's lines from the text file (see above) if it is not needed, or create and use it in the .blend.
Group Descriptions
Group in text file without description
The Group description in the text file is a blank line.
Action
Open the libraryfile.txt and find the group. immeadiatly after it is a blank line, please type a meaningful description into this line, then save and commit.
Group Duplis
Group dupli layers don't match text file
the dupli layers (the ones that are in the group box in the property editor) don't match what it says in the description file.
Action
Either change the buttons in the .blend file to match the .txt file, or vice-versa, depending on what you think is correct. Please note that numbering here starts from zero, not one.
Group layers
Groups with objects in unspecified layers
txt
Action
txt
Unknown Groups
Objects not in groups
txt
Action
txt
Unknown Layers
Objects unspecified layers
txt
Action
txt
Copied Object Name
Object Name Copied (use _n not .nnn)
txt
Action
txt
Default Object Name
Object not Named(default name)
txt
Action
txt