Capturing Objects from Blender
7. Capturing Objects from Blender
Capture is the reverse direction: instead of sending Revit data to Blender, it pulls Blender-modelled objects into Revit as Generic Model families.
Click Capture in the Sync panel.
Prerequisites
BlenderSync for Blender must be running and must have objects ready to serve. How you prepare objects on the Blender side is covered in the BlenderSync for Blender manual at blender.gotheresoftware.no.
What happens in Revit
When you click Capture, BlenderSync sends a request to the server. The server responds with a list of objects. For each object, BlenderSync creates or updates a Generic Model family in your Revit project.
Naming: Each family is named BSYNC_<Name> — for example, BSYNC_Chair. If the object has no name, the family is named BSYNC_CapturedObject.
Where to find them: After a successful Capture, the new families appear in the Revit Project Browser under Families → Generic Models.
Re-running Capture
Running Capture again updates existing families rather than creating duplicates. BlenderSync matches returned objects to existing families first by their internal source ID, then by family name. If a match is found, the geometry is replaced in-place.
Instances you have already placed in the model keep their position — only the underlying family geometry is updated.
Materials
RGB color values from Blender are applied as Revit materials on a per-face basis. The alpha channel is not used.
Units
Geometry from Blender is in meters. BlenderSync converts to Revit's internal units automatically. No unit configuration is needed.
Partial failures
If some objects fail and others succeed, the successful ones are still applied. Check the session log for the attempted / applied / failed counts for that capture operation.
If Capture returns nothing
- If the server has no objects ready, nothing is created or changed in Revit. The status bar reflects the result.
- If the server is unreachable, the operation is recorded as a transport failure. The status bar is updated. No changes are made to the Revit model.
Capture imports all objects the server currently offers — it is not selective. To control what is captured, manage which objects are available on the Blender side.