Stuff! Extension Documentation
9/2/98
When the Stuff! extension is loaded, it checks for the existence
of each of the controls and scripts below before installing it. The
extension then automatically unloads itself, leaving the controls and
scripts in place.
Controls and scripts need to be removed manually from a project.
Warning: all extensions should be unloaded before customizing a
project's GUI; otherwise, their controls will become part of the project
and may be duplicated when the extension is reloaded!
The Stuff! extension comes with the following controls:
Projects:
"Project|Copy" menu item
Open project button
Views:
"Theme|Legend Text Item" menu item
View position copy/paste button
View mask button
Image registration tool
Layouts:
"Edit|Duplicate" menu item
Clear selection button
Legend text size button
Arrowhead button
Textfile tool
Point-and-click scalebar tool
The extension adds the following scripts to the project:
Doc.Clone
View.LegendTextItem
View.CopyView
View.CopyView.Update
View.Mask
View.GeoRefImage
View.ImageThemesUpdate
Graphic.AddArrowhead
Graphic.Duplicate
Graphic.IsOneLine
Layout.LegendTextSize
Layout.LegendTSUpdate
Layout.PutTextFile
Layout.Scalebar
Layout.ScalebarUpdate
Layout.UnselectAllGraphics
The extension assumes that the following scripts are already present in
the project:
Project.Open
View.ActiveThemesUpdate
Graphic.HasSelectionUpdate
USING THE "PROJECT|COPY" MENU ITEM
When the menu entry is clicked, a copy of each of the selected
document(s) will be added to the project.
USING THE "THEME|LEGEND TEXT ITEM" MENU ITEM
One theme should be active, and must be an FTheme. After clicking the
menu entry, a dialog will appear listing the available items. If a
one-to-many relationship exists between the legend's value field and the
label field, the first value encountered will be used.
USING THE COPYVIEW BUTTON
- Go to the desired source view and click the CopyView button (both
source and destination views must have defined map units).
- If the button has been used earlier in the session, a dialog will
appear asking "Paste extent and scale?"; click "No".
- Reply "Yes" to the "Copy extent and scale?" dialog.
- Go to the desired destination view and click the button again.
- This time, reply "Yes" to the "Paste extent and scale?" dialog.
- As long as the clipboard is not used for other purposes (e.g.
copying themes), you may paste to as many views as you wish. Typically,
one would copy desired themes to all views first, then copy position.
USING THE MASK BUTTON
- Invoke the Palette Manager (Control-P) and set the desired
properties for fill and outline (usually white, no outline).
- Select the feature to represent the mask.
- Click the Mask button. The graphic will be selected after it's
created.
USING THE IMAGE REGISTRATION TOOL
- Enable the tool by making the image the active theme.
- Zoom to the first of the two points to georeference.
- Activate the tool by clicking on its icon.
- Click on the desired point and hit the "OK" button.
- Go to the next of the two points to georeference.
- Repeat step 3 and click on the desired second point.
- A message box will appear, asking if you wish to use the current
point to complete the rectangle. If you reply "No", the point will
displace the first point, and another point will need to be collected to
complete the rectangle.
- Enter the desired X and Y coordinates of the two points in the
dialog box that appears and hit "OK".
- This process may be repeated as often as you like until you find
two points that give you the best result.
NOTE: This tool cannot be used to rotate or warp images. Results will
be best if you georeference according to the projection of the image.
For example, if you scanned a polyconic image and the coverages are in
UTM, project the coverages to polyconic before bringing them into
ArcView.
USING THE "EDIT|DUPLICATE" MENU ITEM
Clicking the menu item (or pressing Control-D) will duplicate any
selected graphics in the layout, offsetting them by 0.125 page units and
reselecting them.
USING THE CLEAR SELECTION BUTTON
Clicking the button will unselect any selected graphics in the
layout.
USING THE TEXTSIZE BUTTON
- Select the legend frame for which you want to set the text size.
- Click the legend text size button.
- Enter the desired text size and click the OK button.
USING THE ARROWHEAD BUTTON
- Select the desired line.
- Click the arrowhead button.
- Enter the desired arrowhead size -- defaults are as follows:
Layouts: size = line thickness x 10
Views:
(The defaults may be changed as desired by editing the script.)
- The arrowhead will be created as a polygon with no outline and
solid fill with color equal to that of the line -- the arrowhead and
line will automatically be grouped.
- To edit the arrowhead, ungroup and reselect it.
USING THE TEXTFILE TOOL
- Pick the tool.
- Point to the desired location of the lower left corner of the text
and click once.
- Enter the filename. Text will not automatically wrap: the
textfile must be preformatted with line breaks.
USING THE SCALEBAR TOOL
- Select the View Frame for which you want the scalebar.
- Pick the scalebar tool.
- Point to the desired location of the lower left corner of the
scalebar and click once.
- Enter units, interval size, number of intervals, and number of left
divisions (see the Help topic: "Scale bar frame tool" for more
information). The default values are as follows:
Units: View units
Interval Size: 1 Layout unit
Number of Intervals: 2
Number of Left Divisions: 2
The default style is "Split filled bar scale". This may be changed by
double clicking the scalebar after it's created. The text font and size
may be altered via the palette (Ctrl-P).
Enjoy!