Skip to main content

AppendToGizmo

AppendToGizmo [flags] keyword [=value ]

The AppendToGizmo operation appends a Gizmo object or attribute operation to the top Gizmo window or to the Gizmo window specified by the /N flag.

Flags

/DAppends the item to the bottom of the display list.
/N=gizmoNameSpecifies the name of the targeted Gizmo window. If you omit /N then AppendToGizmo operates on the top Gizmo window.
/ZNo error reporting.

Keywords

attributeTells Gizmo that the remainder of the command refers to an attribute. For example:
AppendToGizmo attribute pointSize=1.0, name=ps0
alphaTestFunc={alphaTFuncSpec, reference}
Discards pixels for which the alpha value fails the selected test relative to the constant reference value.
alphaTFuncSpec is one of the following values:
0x0200:GL_NEVER
0x0202:GL_EQUAL
0x0203:GL_LEQUAL
0x0204:GL_GREATER
0x0205:GL_NOTEQUAL
0x0206:GL_GEQUAL
0x0207:GL_ALWAYS
reference is a value in the range [0,1].
ambient={R , G , B , A , face }
Sets material properties.
R , G , B , and A are values are in the range [0,1].
The face is one of:
0x0404:GL_FRONT
0x0405:GL_BACK
0x0408:GL_FRONT_AND_BACK
axes=typeAppends a default axis object.
type is one of the following:
boxAxes12 axes, one on each side of the display volume
tripletAxesXYZ triplet drawn at the origin
customAxisA single user-specified linear axis
defaultAxesA boxAxes object is added only if there is no axis object of any type in the display list. The object is first added to the object list and then added to the display list.
bar3d=bar3dWaveSpecifies the data wave for a 3D Bar plot.
For more information see 3D Bar Plots.
blendFunction={source, dest }
Appends an attribute which specifies the blending operation when blending is enabled.
source is one of the following values:
0x0000:GL_ZERO
0x0001:GL_ONE
0x0300:GL_SRC_COLOR
0x0301:GL_ONE_MINUS_SRC_COLOR
0x0306:GL_DST_COLOR
0x0307:GL_ONE_MINUS_DST_COLOR
0x0302:GL_SRC_ALPHA
0x0303:GL_ONE_MINUS_SRC_ALPHA
0x0304:GL_DST_ALPHA
0x0305:GL_ONE_MINUS_DST_ALPHA
0x8001:GL_CONSTANT_COLOR
0x8002:GL_ONE_MINUS_CONSTANT_COLOR
0x8003:GL_CONSTANT_ALPHA
0x8004:GL_ONE_MINUS_CONSTANT_ALPHA
0x0308:GL_SRC_ALPHA_SATURATE
dest is one of the following values:
0x0000:GL_ZERO
0x0001:GL_ONE
0x0300:GL_SRC_COLOR,
0x0301:GL_ONE_MINUS_SRC_COLOR
0x0306:GL_DST_COLOR
0x0307:GL_ONE_MINUS_DST_COLOR
0x0302:GL_SRC_ALPHA
0x0303:GL_ONE_MINUS_SRC_ALPHA
0x0304:GL_DST_ALPHA
0x0305:GL_ONE_MINUS_DST_ALPHA
0x8001:GL_CONSTANT_COLOR
0x8002:GL_ONE_MINUS_CONSTANT_COLOR
0x8003:GL_CONSTANT_ALPHA
0x8004:GL_ONE_MINUS_CONSTANT_ALPHA
For example:
AppendToGizmo attribute blendFunction={0x302,0x303}, name=blendFunc0
box={length, width, height }
Append a default box object of dimensions length, width and height specified in +/-1 display volume coordinates. Use the name keyword to assign the new object a name. For example:
AppendToGizmo box={1,1,1}, name=box0
For more information see Box Objects.
color={R, G, B, A}Appends a color attribute with RGBA components in the range [0,1]. For example:
AppendToGizmo attribute color={1.0,0.0,0.0,1.0}, name=color0
colorScale=name (deprecated)
Appends a default colorscale object named name.
Gizmo colorscales are deprecated; use standard annotation instead. See Changes to Gizmo Text for details.
cylinder={baseRadius, topRadius, height, slices, rings}
Appends a cylinder object. For example:
AppendToGizmo cylinder={1,1,1,25,5}, name=cylinder0
For more information see Cylinder Objects.
disk={innerRadius, outerRadius, slices, rings, startAngle, sweepAngle}
Appends a disk object. For example:
AppendToGizmo disk={0,1,20,20,0,360}, name=disk0
For more information see Disk Objects.
default3DBarChart=srcWave
Appends and displays a default 3D Bar plot for a 2D wave srcWave. For example:
AppendToGizmo default3DBarChart=my2DWave
defaultIsoSurface=src3DWave
Appends and displays a default iso-surface. For example:
AppendToGizmo defaultIsoSurface=src3DWave
Gizmo sets the isosurface value as the mean value of
The defaultIsoSurface keyword was added in Igor Pro 9.00.
defaultPath=srcTripletWave
Appends and displays a default path plot for a 3-column 2D wave srcTripletWave. For example, this draws a path object using a black 1-unit wide line and default axes:
AppendToGizmo defaultPath=srcTripletWave
The defaultPath keyword was added in Igor Pro 9.00.
defaultScatter=srcWave
Appends and displays a default scatter plot for the triplet wave srcWave. For example:
AppendToGizmo defaultScatter=myTripletWave
defaultSurface=srcWave
Appends and displays a default surface plot for the 2D wave srcWave. For example:
AppendToGizmo defaultSurface=my2DWave
The defaultPath keyword was added in Igor Pro 9.00.
defaultVolumeSlices=src3DWave
Appends and displays three surface objects representing X, Y and Z slices through the center of the volume data together with default axes. For example:
AppendToGizmo defaultVolumeSlices=src3DWave
The three orthogonal slices are drawn using the rainbow color table.
The defaultVolumeSlices keyword was added in Igor Pro 9.00.
defaultVoxelgram=src3DWave
Appends and displays a default voxelgram. For example:
AppendToGizmo defaultVoxelgram=src3DWave
Gizmo sets the voxelgram value as the mean value of
The defaultVoxelgram keyword was added in Igor Pro 9.00.
diffuse={R, G, B, A, face }
Sets material properties.
RGBA values are in the range [0,1].
face is one of:
0x0404:GL_FRONT
0x0405:GL_BACK
0x0408:GL_FRONT_AND_BACK
emission={R, G, B, A, face }
Set material properties.
RGBA values are in the range [0,1].
face is one of:
0x0404:GL_FRONT
0x0405:GL_BACK
0x0408:GL_FRONT_AND_BACK
freeAxesCue={xOff, yOff, zOff, scale}
Appends an axis cue object at offset xOff, yOff, zOff expressed in +/-1 display volume coordinates and using an isotropic scale factor. For example:
AppendToGizmo freeAxesCue={0.5,0,0,1},name=fAxes0
groupAppends a default empty group object. For example:
AppendToGizmo group, name=group0
For more information see Group Objects.
image=imageWaveAppends a Gizmo image object.
imageWave is a 3D unsigned-byte wave.
For more information see Gizmo Image Plots.
isosurface=srcWaveAppends an isosurface object using srcWave as the data wave. For example:
Make/O/N=(10,20,30) data=enoise(10)
AppendToGizmo isosurface=data,name=iso0
For more information see Isosurface Plots.
matrix4x4=matWaveAppends a matrix4x4 object based on the 2D (4x4) real data wave matWave.
light=lightTypeAppends a default light.
lightType is a keyword, either directional or positional.
For more information see Gizmo Lights.
line={x1, y1, z1, x2, y2, z2 }
Appends a line object between the two vertices specified in +/1- display volume coordinates. For example:
AppendToGizmo line={-1,-1,-1,1,1,1}, name=line0
lineWidth=width (deprecated)
Appends a line width attribute that sets the width of a line in pixels.
name=objNameProvides the name for objects that are created with parameters. For example:
AppendToGizmo disk={0,1,20,20,0,360},name=disk0
path=srcWaveAppends a path object for the data in the triplet wave srcWave.
For more information see Path Plots.
pieWedge=nameAppends a piewedge object with the specified name. For example:
AppendToGizmo pieWedge=pieWedge0
For more information see Pie Wedge Objects.
pointSize=size (deprecated)
Appends an attribute that sets the size of a point in pixels.
quad={x1, y1, z1, x2, y2, z2, x3, y3, z3, x4, y4, z4 }
Appends a quad object spanning the specified +/-1 display coordinates. For example, to append a quad that fills the bottom z-axis of the cube:
AppendToGizmo quad={-1,-1,-1,-1,1,-1,1,1,-1,1,-1,-1}, name=quad0
For more information see Quad Objects.
quadricDrawStyle=drawStyle (deprecated)
Appends an attribute that determines the drawing style of quadric objects (spheres, cylinders and disks). Supported draw styles are:
100010:Point - surface vertices are marked by points.
100011:Line - surface polygons are drawn as lines.
100012:Fill - surfaces are drawn as filled polygons.
quadricOrientation=orientation (deprecated)
100021:Inside - normals are drawn inward.
100122:Outside - normals are drawn outward.
quadricNormals=normals (deprecated)
100002:None--normals are not computed.
100001:Flat--one normal is generated per polygon.
100000:Smooth--one normal is generated per vertex.
ribbon=ribbonWaveAppends a default ribbon object for the triplet wave ribbonWave.
For more information on ribbon objects see Ribbon Plots.
scatter=srcWaveAppends a scatter object using the 3 column triplet wave srcWave as the data wave. For example:
Make/N=(20,3) dataWave=gnoise(10)
AppendToGizmo scatter=dataWave, name=scatter0
For more information on ribbon objects see 3D Scatter Plots.
surface=srcWaveAppends a surface object using a 2D srcWave. For example:
Make/N=(20,30) my2Dwave=x*y
AppendToGizmo surface=my2Dwave, name=surface0
For more information on ribbon objects see Surface Plots.
sphere={radius, slices, stacks}
Appends a sphere object.
radius is expressed in +/-1 display volume coordinates.
slices and stacks determine how many facets are used to draw the surface. For example:
AppendToGizmo sphere={1,10,15}, name=sphere0
For more information see Sphere Objects.
string=strData (deprecated)
strData is the text to display.
Gizmo strings are deprecated; use standard annotation instead. See Changes to Gizmo Text for details.
specular={R, G, B, A, face }
Sets material properties.
RGBA values are in the range [0,1].
face is one of:
0x0404:GL_FRONT
0x0405:GL_BACK
0x0408:GL_FRONT_AND_BACK
strFont=fontName (deprecated)
Sets the font used for string objects.
Use standard annotation instead. See Changes to Gizmo Text for details.
shininess={value, face }
Appends an attribute which characterizes material properties.
value is in the range [0,128]. A higher value makes the reflection more specular (shiny).
face is one of:
0x0404:GL_FRONT
0x0405:GL_BACK
0x0408:GL_FRONT_AND_BACK
tetrahedron=nameAppends a tetrahedron with the specified name.
For more information see Tetrahedron Objects.
triangle={x1, y1, z1, x2, y2, z2, x3, y3, z3 }
Appends a triangle with the specified vertices expressed in +/-1 display volume coordinates. For example:
AppendToGizmo triangle={0,0,0,1,1,1,1,-1,-1}
For more information see Triangle Objects.
texture=nameAppends a texture object with the specified name.
For more information see Texture Objects.
voxelgram=srcWaveAppends a voxelgram object using the 3D real-valued wave srcWave as the data wave.
For more information on voxelgrams see Voxelgram Plots.

See Also

3D Graphics

ModifyGizmo, NewGizmo, ExportGizmo, GetGizmo, GizmoInfo, RemoveFromGizmo