QuickStart Guide - Sample Macros

## 4.2 Sample Macros

Found in directory `$DXROOT/samples/macros`.

`ArrangeMemberMacro.net` Allows you to independently arrange a number of interactive windows within a larger window.

`AutoScaleMacro.net` Automatically scales an object to a user-specified aspect ratio. It is used by the ScatterData example visual program.

`BandColorsMacro.net` "Bands" a 2-dimensional data set and applies a user-specified set of colors to the bands. It is used by the BandedColors example visual program.

`CappedIsoMacro.net` caps an isosurface by the boundary of the data. Used by CappedIso.net.

`ClipSurfaceMacro.net` clips a surface by a plane. Is used by the macro ClipVolumeMacro.net.

`ClipVolumeMacro` clips a surface in a volume by a plane, capping the hole with a plane from the volume. Can be nested. Is used by VolumeClip.net.

`ConvertColorNameListMacro.net` Converts a list of color names to a list of RGB vectors. It is used by the BandedColorsMacro macro.

`DrapeMacro.net` drapes one 2-dimensional field over another, using one of them to deform the surface.

`FactorialMacro.net` Used by Factorial.net to compute a factorial.

`FormatListMacro.net` Formats a list of values into a list of strings.

`Image2Macro.net` Implements much of the functionality of the Image tool with SuperviseWindow, SuperviseState, and Display. Used by Image_wo_UI.net.

`InsetImageMacro.net` Allows you to inset an independently interactive window within a larger window.

`InterpolatePositionsMacro.net` Used by the FlyThrough example visual program (see "3-Dimensional Data"). It interpolates data values within a list of 3-dimensional positions.

`MakeLineMacro.net` Used by the PlotLine2 example visual program (see "3-Dimensional Data").

The macro takes as input a data field, two points defining the start and end of a line, and the number of samples to be placed along the line. The macro has two outputs:

- a line that can be displayed in the Image window
- the data to be plotted, which has two components:
  - the "positions" component is the distance along the line
  - the "data" component is the data value at each position.

  `Make3DFieldMacro.net` Given three fields with scalar data components, creates an output field where the x's are the data components of the first field, the y's are the data components of the second field, and the z's are the date components of the third field. It is used by the ScatterData example visual program.

  `MapOnStatesMacro.net` Allows you to map data onto a map of the United States. It is used by the CensusData and ZipCodes example visual programs.

  `MatteMacro.net` Used by Bounce.net. It mattes two images together.

  `PickPlotMacro.net` Extracts the transformed x,y position from a picked point in a plot.

  `UnsquishGlyphMacro.net` Provides a simple solution for the "squished glyph" syndrome, when data are scaled before rendering. It is used by the ScatterData example visual program.

  [ OpenDX Home at IBM | OpenDX.org ]