Layer/Scene Visibility Map v2 (VisMap2) Documentation


© 2009, Martin Rinehart (MartinRinehart at gmail dot com)

Do I Need VisMap?

Do you have non-trivial models with lots of scenes and layers? If you do, VisMap is for you.

VisMap v2?

Version 2 handles much bigger models with aplomb. (For VisMap, size = number of scenes * number of layers.)

What Does VisMap Do?

These docs (these very short docs!), answer that question. Read (mostly look at the pictures), download and install, where indicated. Check the "Details" and "Known Gotchas" after you try it out. (The download packet does not repeat these docs. You may want to bookmark them.)

When loaded, VisMap waits for you to click a "Get Data from Model" button. When first loaded, VisMap waits for you to click a "Get Data from Model" button.

VisMap provides a visual map. Checkboxes show which SketchUp model layers are visible in which scenes. With data, VisMap shows which layers are visible in which scenes. By clicking the individual layer/scene checkboxes, you can set or unset visibility.

VisMap provides a visual map. Checkboxes show which SketchUp model layers are visible in which scenes. Here the checkbox left of the stairs layer was clicked. The stairs layer is now visible in every scene.

VisMap provides a visual map. Checkboxes show which SketchUp model layers are visible in which scenes. Here the checkbox left of the stairs layer was clicked again, turning the checkmark off. The layer is now invisible in all scenes.

The checkboxes above the scene numbers work the same way, turning the column all on or all off with a single click.

The sample model shown here has relatively few scenes and layers. VisMap 2 has many features for those who have much larger models. Begin by noting that there is a vertical line every fifth scene, and the layers are color-organized in groups of three. Together these make it easy to find the right checkbox in even the biggest model. Here are some more:

Frames can be resized to gain space for more data. The bars separating the frames can be dragged, to eliminate the title and button frames.

The scene list window can be closed. If you have scene names like these, the scene list window can be closed.

The "B" and "s" buttons control the dislpay If that's not enough, the B (Bigger) and s (smaller) buttons (you can see them in the above screenshot, here they're hidden) can squeeze lots of layers and scenes onto your monitor.

Cost and License

VisMap is free.

VisMap was written by me, Martin Rinehart. I am a human being. Human-written software has bugs. Worse, I cannot guarantee that my site has not been hacked and that the VisMap download has not been replaced by someone's malware. Proceed at your own risk.

Download

If you have VisMap or VisMap Pro installed, VisMap 2 installs happily beside them. Eventually you will probably want to uninstall the older versions. Uninstall instructions are at the bottom of this documentation.

VisMap2.zip

Review the Download

Before extracting the files, check that you have: A vismap2\ subdirectory containing: You can preview the .gif (a big and a little ruby). The rest can be opened with any text editor. File sizes above are given as I write this documentation. I will no doubt change the files more often than the doc. Don't let minor differences worry you. Major differences? I've been hacked; you've got malware. Use the DOS window to delete (it bypasses the Recycle Bin) and please contact me immediately.

To Install, Extract to Your Plugins Directory

Where Is My Plugins Directory?

Open the Ruby Console window. Type into the white input line what you see here. The second line at the top is your Plugins directory.

Using the Ruby Console to find the Plugins directory.

After extracting the plugins' files, restart SketchUp.

Try It!

Open a model with scenes and layers. Save As... "testing.skp". Click Plugins/VisMap v2. Enjoy.

Details

If you make any scene/layer combination invisible, the checkmarks left of that combination's layer and above that combination's scene are cleared.

VisMap cannot make a scene's active layer invisible.

The selections you make here are not sent to your model until you click the "Send Data" button. (First time? Play here until you totally get it. Then "Get Data" again and get serious.) Even after "Send Data", changes are not permanent until you save your model.

"Send Data" updates every changed scene.

If you add or delete scenes or layers, be sure to click "Get Data". If you change visibilites in your model, also click this button. Last, if you open a different model, be very sure you click "Get Data".

If you click "Send Data" the Ruby program checks to see that it receives the right number of visible/invisible specifications. If you add a layer, for instance, and forget to "Get Data" it tells you:

Do not use the backward slash, double quote or single quote (apostrophe) characters in your layer and scene names.

Known Gotchas

If you change visibilities via the Layers window, then click "Get Data" you won't see your changes. Reason: your model is not changed until you update your scene. Update, then "Get Data". (If you change visibility with VisMap, updates are automatic.)

Number of scenes multiplied by number of layers cannot exceed 12k.

In the rare case where your model changes do not effect the total visibilities (add a seventh layer to a six-layer model and delete the seventh scene leaving a six-scene model) you will get totally inappropriate settings. Make it a habit to click "Get Data" after any layer or scene is inserted or deleted.

The Ruby code attempts to escape embedded quote characters in layer and scene names. This is not reliable. Having no embedded quotes is reliable.

There are unresolved issues with using VisMap on very large files.

Uninstalling VisMap

In your PlugIns directory delete: If you are detective Monk, in the Registry Editor delete HKEY_CURRENT_USER/Software/Google/SketchUp7/WebDialog_VisMap_vnnn.

Uninstalling VisMap Pro

In your PlugIns directory delete: If you are detective Monk, in the Registry Editor delete HKEY_CURRENT_USER/Software/Google/SketchUp7/WebDialog_VisMap_p_vnnn.

Uninstalling VisMap 2

In your PlugIns directory delete: If you are detective Monk, in the Registry Editor delete HKEY_CURRENT_USER/Software/Google/SketchUp7/WebDialog_VisMap2_vnnn.


Martin Rinehart (MartinRinehart at gmail dot com)