Skip to content

Aerilius/sketchup-attribute-inspector

Repository files navigation

logo

Attribute Inspector

A viewer and editor for SketchUp entity and model attributes

This is a viewer for entity and model attributes. Attributes in SketchUp are additional pieces of information that can be stored with entities like groups, components, scenes. For example one can store a part number, unit price, weight or other annotations with an entity and read or modify that information later. All attributes are included in SketchUp's report feature.

This inspector tries to keep the user interface minimal and very efficient: Just like SketchUp's inspector dialogs, you select one or more entities and it instantly displays their attributes. Your inputs are immediately saved to the entities.

logo

Installation

  • Go to the releases page (↑) and download the latest .rbz file. Open in SketchUp Window → Extension Manager and select the .rbz file.

  • Alternatively, you can install the contents of the src directory into your plugins folder.

    If you choose to run from source rather than use the release rbz file, you'll need to run from the sketchup-attribute-inspector folder:

    npm install
    npm build

    (or with hot-patching during development, instead of build)

    npm run dev-server

Usage

Menu: WindowAttribute Inspector

The dialog shows the attribute dictionaries of the currently selected drawing element. Use SketchUp's selection tool to select other elements.

Click the +, buttons on the left pane to add or remove an attribute dictionary, and click +, on the right pane to add or remove an attribute. Since attribute dictionaries are entities, they can themselves have attribute dictionaries. You can also create such nested dictionaries by selecting the parent dictionary in the left pane and clicking the └+ button.

To select other types of entities, choose the type from the dropdown:

  • drawing elements: Use SketchUp's selection tool to select one or more drawing elements in the model (edges, faces, groups…)
  • component definitions: Use SketchUp's selection tool to select components/groups/images
  • materials: Use the materials browser and select a material. Attribute Inspector will show the current material (could be not working on OS X due to API bug)
  • layers: Use the layer manager and check the radio button of the layer
  • scenes: Use the scenes manager and double-click the scene (to make it the current scene)
  • styles: Use the styles manager and double-click the style

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/Aerilius/sketchup-attribute-inspector/issues.

Development

This project requires ruby, ruby-bundler and npm.

First, run npm install and bundle install to install requirements.

Run bundle exec rake test to run the tests.

To release a new version, update the version number in version.rb, and then run npm run release (npm run build and bundle exec rake release).

To build a new installation package , run bundle exec rake build_rbz.

License

This extension is available as open source under the terms of the MIT License.