Arch Reference

Description


The Reference tool allows you to place an object in the current document that copies its shape and colors from an Part-based object (including Arch BuildingPart) stored in another FreeCAD file. If that FreeCAD file changes, the reference object is marked to be reloaded.

Usage

 * 1) Press the  button
 * 2) Press the "Choose file..." button and select an existing FreeCAD file
 * 3) Select one of the included Part-based objects from the drop-down list
 * 4) Press OK

Options

 * The reference object can be moved and rotated, the current position will be retained after reloading the object
 * If the original object gets moved in containing file, this movement will reflect in the reference object
 * By right-clicking a Reference object in the tree view, you have the options to reload the original object, or open the containing file
 * To reference several object at once, place them inside an Arch BuildingPart
 * When turning off the Update Colors view property of the Reference, it son't reload the original colors anymore, so you can safely change them

Properties

 * : The base file this component is built upon
 * : The part to use from the base file
 * : If true, the colors from the linked file will be kept updated

Scripting
The Reference tool can by used in macros and from the python console by using the following function:

creates a Reference object from the given object in the given file.

Example: