This script measures the distance between 2 points, and converts it to a real world equivalent.
It also can create a mesh and text object to display the result in a renderable format.
The script was developed commercially for: Render Reality LLC.
A big thank you to the company for allowing the script to be released under the GPL license!
Requirements
This script is written for use with blender 2.43 and up to 2.49.
The Gui
The Top
At the very top you can see what version of the script you are using.
In the results and messages block you normally get to see the measurement result.
In case of an error a message explaining the error should appear.
Object settings
Here you can set a nr of general things concerning the objects the script creates.
Text
When selected the script will create a 3d text object to display the measurement result.
Arrow
When selected the script will create a 3d mesh object to display what points were measured.
Clean
When selected the script will remove any previous measurement objects made between these two measured points.Will not work in case you renamed your objects after the last run of the script. May not work correctly if the object names are very long. May not work if you edited your meshes since the previous run. Cleaned objects won’t be truly removed until your save and reload your file twice!
Tip: if you deselect Text and Arrow but have Clean selected you can remove the measurement object and clean your scene.
Layers
In the block of small toggle buttons you can select on what layers the measurement objects should be created.
Color
In this dropdown box you can select what the initial color of the measurement material should be. The script will only create the material once. You can adapt the material after it has been created.
Arrow style
Arrow type
In the arrow type dropdown box you can select what arrow shape you want created.
Arrow alignment
Here you can set how the arrow and text objects for the measurement will align. The options are front, top, rear & bottom. If your measurement aligns to the left and you want it aligned to the right switch from front to rear or top to bottom to invert the objects.
Arrow scale
In the scale setting you set the relative size of the arrow object. The arrow will always stretch between the measured points. Changing the scale will make the arrow fatter or skinnier.
Text style
Bevel
Will set the bevel value for the created text object.
Ext
Will set the extrusion level (depth) of the created text object.
Size
Sets the size of the created text object.
Offset
Sets the offset of the created text object.
Tip:
if you create a larger arrow object you want to change this value.
Measurement settings
Measure the distance in
Here you can select what object types you want to measure between or in.
Measurement Constraint
Here you can constrain the measurement to a specific axis. So if you select X for instance only the distance along the x axis will be measured.
Tip Remember that when you do a “closest/furthest” measurement the script will first get the location and then constrain the result to that axis! So if you constrain along the x axis, you will still get the closest points but perhaps not the closest along the x axis!
Constrain objects
This option is only available if the measurement constraint option is active. When selected the created objects displaying the measurement will also align on the axis to which the measurement was constrained. The objects will be positioned relative to the point measured in the object/vert/edge/face you selected second. This selection can give you multiple options in the next box. Two objects Selecting this allows you to measure the distance between two object centers of selected objects.
Two meshes
Selecting two meshes gives you a nr of choices that should explain themselves. One mesh Selecting one mesh allows you not only to measure between some preset defaults but selected parts as well. You must select the parts in edit mode. Edit mode will be exited by the script!
Output style
In this section you set what measurement result format you want.
Measurement output type
Here you set the largest value you want to measure in.
Measurement levels
Only available if your largest value isn’t the smallest available or blender units. Here you set the smallest increment in your measurement result. So if your output type is in km and you set the levels to mm you might get: 1 km 1 m 1 cm 1 m
Measurement detail
Here you can select how much detail you want in the smallest increment of your measurement. If the smallest measurement is in inches the selector will allow you to set divisions, otherwise it’s how many digits behind the comma.
Input style
Here you set how a blender unit is interpreted by the script.
Measurement input type
You can set here to what base value the blender unit should be converted.
Scale
The scale value what a blender unit converts to in the base value.
Major functions
Here you can set what action the script should undertake.
Measure
When clicked the script will measure accoring to your settings and selections.
Exit
When clicked the script will exit. Alternatively you can click the escape button on your keyboard.
That’s it
Dolf
