Surface - Transform

The Surface - Transform menu selection is enabled when the optional Surface Tools extension has been installed and the focus is on a surface window or on a surface layer in a map window. If you have not activated the Surface Tools extension with a valid Surface Tools serial number you will not be able to use the Surface - Transform command.

 

images\dlg_surface_transform.gif

 

Launching the Transform command in the Surface menu launches the Transform dialog.

 

 

Scope

The pixels in the surface that will be affected by the formula. Allows choice of [All Pixels], [Invisible Pixels] or any selection or saved selection made in the surface.

Surfaces

A list of all surfaces in the project. Double-click on a surface name to add it to the Formula pane at the current cursor position.

Formula

Allows entry of any formula that will transform the surface as desired. For details on formulas, operators and examples see the Transforming Surfaces topic.

Save result as new component

If not checked (the default) the formula operates on the surface that had the focus when the dialog was launched, if the surface is not read-only. If checked, the system will first make a copy of the context surface and will then execute the formula in the context of that copy.

OK

Execute the formula and make any changes directed to the surface.

Cancel

Exit the dialog without making any changes.

 

The Scope specifies the pixels that will be affected by the transformation, and can be [All Pixels], [Invisible Pixels] or any selection or saved selection made in the surface. Formulas can contain numbers, names of surfaces (names of surfaces must be enclosed in square brackets [ ] if the name contains a space character), arithmetic operations and functions. Formulas are case insensitive. When we press the OK button, each pixel in the surface in the scope will be replaced with the value of the formula for that pixel.

 

If we would like to preserve the original surface unmodified we can check the Save result as new component box and the system will create a new surface (a copy of the surface which had the focus when the dialog was launched) and put the results of the formula there. The Save result as new component also allows us to surface transformations on a surface that is a read-only component, such as perhaps a surface that has been linked into a project from an Enterprise storage using the Enterprise Edition of Manifold System.

 

See Also

 

Surface Tools

Transforming Surfaces

Transform Dialog Functions and Operators