Given Objects

The Given section shows all the given objects for the tool—all the objects that don’t depend on any other objects in the tool. When using the tool in a sketch, these are the objects which you “match” in a sketch by clicking the tool. Given objects are listed in the order in which you must match them, which by default is the order chosen by the tool’s author when the tool was created.

You can change the order of given objects by dragging individual given objects up or down in Script View.

In some tools, the Given section may be divided into two parts, labeled Assuming and Given. The Assuming part contains assumed objects—given objects that are automatically matched to sketch objects having the same label when the tool is used in a sketch. The Given part contains the remaining given objects—the given objects that must be matched explicitly.

Assumed objects don’t need to be matched explicitly when you use the tool, unless the sketch does not contain objects to match with the same label. (By default, a tool’s given objects are explicit, as opposed to assumed. But when a tool is designed to be used repeatedly in the same sketch, in some situations the tool author finds it convenient to change some explicitly given objects into assumed objects to make the tool more convenient to use.) For more information about assumed objects and how to indicate them, see Advanced Tool Topics.