9.1 Attachments

Attachments are not yet implemented for the topography dataset.

9.2 Topography Objects

Two topography object types are implemented:

• surface : A triangulated surface is constructed from the dataset. From 4 neighboring grid-points - {u,v} {u+step,v} {u,v+step} {u+step,v+step} - a middle point is interpolated and 4 triangles are formed, resulting in a surface.
• contour : Contour lines are generated from the dataset and are height-scaled, starting at lstart , ending at lend , contouring every lstep

A new object is created with the command new :

Syntax: .topo new [-name NAME] [-type TYPE] [-set SET] [-sel SEL]

If no name is given, the dataset-name is used. TYPE defaults to surface . SET can be a list with PVs (Table 18 (P. 42)) and SEL can include all selecteable element properties (see Table 19 (P. 43)).

Topography Dataset Element Properties

property	S3	G4	L5	R6	Description
color	X				color of element
u			X	X	u-value of original topograph
v			X	X	v-value of original topograph
h			X	X	height

9.3 Topography Dataset Commands

Following are all topography dataset commands:

new : create a new object (see "9.2 Topography Objects" on page 42)

set get : retrieve or modify a dataset property (Table 18 (P. 42))

Syntax: .topo set PV[, PV ...] 
        .topo get P

restrict : shadow out a subset of the dataset which will not be considered in selection or property setting (see "5.1.7 Dataset Restriction" on page 25)

Syntax: .topo restrict SELECTION

delete : remove one or more objects

Syntax: .topo delete obj [obj2 ...]

attach : will attach topograph to a structure dataset (not yet implemented)

grab reset fix center : transformation related commands (see "5.1.8 Transformation" on page 25)

9.4 Topography Object Commands

Commands directed against a topography object are issued as

Syntax: .topo.obj command [parameters]

Following is a list of all topography object commands:

renew : Similar to new command, except the type and name are already determined, so only selection and setting is possible. If either selection or setting (or both) are omitted, the current selection resp. setting is maintained.

Syntax: .topo.obj renew [-selection SEL] [-set SET]

show hide : turns display of the object in the graphics window on or off. Identical to clicking on the object name in the object menu (see see "4.12 The GUI" on page 20)

Syntax: .topo.obj show
        .topo.obj hide

set get : modify or retrieve topo object properties (See Table 18 (P. 42) and see "5.1.5 Modifying Objects" on page 23).

Syntax: .topo.obj get P
        .topo.obj set PV [-selection SEL] [-range [src=SRC][,PROP=prop][val=VAL1:VAL2]]

render : modifies the graphical appearance of an object (see "9.5 Render & Graphical Appearance" on page 44).

9.5 Render & Graphical Appearance

The command render modifies the graphical appearance of a topograph object:

Syntax: .topo.obj render PV [,PV ...]

Several rendering modes are available, specified as:

Syntax: .topo.obj render MODE

where MODE is one of:

• dot : (object type surface ) vertices are displayed as points only
• line : (object type surface ) faces are outlined
• fill : (object type surface ) default mode, faces are filled and lit

  Topography Dataset Render Properties

  Property	Description	Default
  t	transparency, 1.0 is opaque, 0.0 is fully transparent	1.0
  light1	lighting is only applied to the front face, leaving the backside practically unlit and dark
  light2	lighting is applied to both sides of the surface	X

9.6 Example

Following is an example using a 6-fold symmetrized correlation average of an AFM-topograph of an HPI layer7:

// load a topography dataset
load hpi.tiff
// set scaling (in nm)
.hpi set scalexy=33,scalez=3
// create a new object (of default type surface)
.hpi new -name s
// create a new contour object
.hpi new -name c -type contour -set lstep=0.1 
// color contour lines
.hpi.c set color=yellow
// color surface with range
.hpi.s set color=red4:yellow -range prop=h,val=0:1