Skip to main content

ModifyGizmo

ModifyGizmo [flags] keyword [=value ]

The ModifyGizmo operation changes Gizmo properties. The syntax for the operation depends on what you want to change.

Flags

/N=gizmoNameSpecifies the name of the targeted Gizmo window. If you omit /N then ModifyGizmo operates on the top Gizmo window.
/ZNo error reporting.

General Settings

To modify general settings that affect the Gizmo as a whole use:

ModifyGizmo [flags] keyword  [=value ]

See ModifyGizmo General Settings for details.

Operations

To modify properties of the display list operation use:

ModifyGizmo opName=operationName, operation=opType, data={data format}

See ModifyGizmo for Operations for details.

Objects

To modify the properties of an object use:

ModifyGizmo modifyObject=objName, objectType=type, property={property format}

See ModifyGizmo for Objects for general details. For specific object details see:

ModifyGizmo for Path Objects

ModifyGizmo for Ribbon Objects

ModifyGizmo for Surface Objects

ModifyGizmo for Isosurface Objects

ModifyGizmo for Voxelgram Objects

ModifyGizmo for Scatter Objects

ModifyGizmo for 3D Bar Chart Objects

ModifyGizmo for Image Objects

ModifyGizmo for Axis Objects

ModifyGizmo for Free Axis Cue Objects

ModifyGizmo for Line Objects

ModifyGizmo for Triangle Objects

ModifyGizmo for Quad Objects

ModifyGizmo for Box Objects

ModifyGizmo for Sphere Objects

ModifyGizmo for Cylinder Objects

ModifyGizmo for Disk Objects

ModifyGizmo for Tetrahedron Objects

ModifyGizmo for Pie Wedge Objects

ModifyGizmo for Light Objects

ModifyGizmo for Texture Objects

ModifyGizmo for Matrix4x4 Objects

ModifyGizmo for String Objects

ModifyGizmo for ColorScale Objects

Attributes

To modify the properties of an attribute use:

ModifyGizmo attributeType=type, modifyAttribute={attrName,data...}

See ModifyGizmo for Attributes for details.

See Also

3D Graphics, AppendToGizmo, NewGizmo, ExportGizmo, GetGizmo, GizmoInfo, RemoveFromGizmo

ModifyGizmo General Settings

The syntax for modifying a general Gizmo setting is:

ModifyGizmo keyword [=value]

Keywords

appendRotation={q0, q1, q2, q3}
Applies a rotation to the current orientation. The rotation is specified by the 4-element quaternion.
See Programming Rotations in Gizmo for details.
aspectRatio=modeSpecifies the aspect ratio mode for wave-based data objects.
mode =0:Default. Each dimension is stretched to the full range of the display volume.
mode =1:True aspect ratio. The largest data dimension is fills the +/-1 display volume. The other dimensions are scaled to maintain the correct aspect ratio.
attribute=nameIdentifies a specific attribute by name. For example:
ModifyGizmo setDisplayList=2, attribute=color0
autoScaleSets scalingOption=63, autoScaling=1 and refreshes the display.
autoScaling=modeSets the autoscaling mode for wave-based data objects in the Gizmo display.
mode =0:Turns autoscaling off. Gizmo draws the objects using only the direct transformations that you provide. If an object exceeds the dimensions of the clipping volume it is clipped.
mode =1:Default. Gizmo finds the minima and maxima of wave-based data objects before drawing and attempts to provide an appropriate axis scaling. Gizmo does not take into account operations such as translation, rotation or scaling. If you use these you must provide your own clipping plane via an operation such as Ortho.
See also keywords: aspectRatio, autoScale, scalingOption, and setOuterBox.
See also Gizmo Dimensions.
bringToFrontBrings the Gizmo window to the front.
You can also use DoWindow/F.
clearClears both the Gizmo display window and the associated display list in the info window.
clearAttributeListRemoves all attributes from the attribute list. Attributes that are associated with other objects or attributes in the display list or object list are also removed.
clearDisplayListRemoves all items from the display list. This clears Gizmo display window.
clearObjectListRemoves all objects from the object list. Any objects in the display list are also removed.
closeInfoCloses the Info window.
compileObsolete. Does nothing.
crystalFlag=valTurns on or off a crystallographic drawing mode for scatter objects. This is an advanced feature that is explained in detail in the crystalDemo experiment. Open CrystalDemo experiment
currentGroupObject=groupSpec
If you create group objects using advanced settings, you need to use this keyword to direct further commands to a group object.
groupSpec is built from the full or relative path to the object. The full path starts from the name of the Gizmo window itself, e.g., Gizmo0, and contains sequential names of all child groups separated with a semicolon. For example:
ModifyGizmo currentGroupObject="Gizmo0:group0:subGroup1:subGroup2"
A relative path starts from the current group object. For example, if the current group object is group0 (from the previous example) then you use:
currentGroupObject=":subGroup1:subGroup2"
If you want to move up one level to a parent group you would use:
<code class="igor">ModifyGizmo currentGroupObject=""</code>
defaultLight=modeTurns the default light on or off.
0:Default light off
1:Default light on
The default light, which is a color-neutral ambient light source, is used if you do not append any light object to the display list.
The number of light objects is limited by the OpenGL implementation or by hardware. Typically this number is 8 or larger. If you create 8 light objects and none are appended to the display list, Gizmo may be unable to add the automatic default light.
displayLastObjectAppends the last object in the object list to the end of the display list.
edit={objType, objName}
Opens Gizmo's standard dialog for editing the properties of the object as if you double-clicked the object's icon in the info window.
objType is one of: Attribute, Object, DisplayItem.
objName is the name of an existing object.
endRecMacroEnds a recreation macro. This affects the timing of updates and redrawing of parsed objects. See startRecMacro parameter.
euler={a, b, c}Rotates the display about the specified Euler angles. The angles are in degrees about the X-axis (a), the Y-axis (b) and the Z-axis (c) respectively. The rotation for a positive angle is counterclockwise when looking from the positive side of the axis towards the origin.
See also Programming Rotations in Gizmo.
frameInset= iSpecifies the number of pixels by which to inset the frame of the Gizmo subwindow. This is mostly useful for overlaying panels in graphs to give a fake 3D frame a better appearance.
frameStyle= fSpecifies the frame style for a Gizmo subwindow. Values for frameStyle are:
f =0:None
f =1:Single
f =2:Indented
f =3:Raised
f =4:Text well
The last three styles are fake 3D and will look good only if the background color of the enclosing space and the panel itself is a light shade of gray.
goHomeRotates the Gizmo display to the home orientation.
See Gizmo Object Rotation for a discussion of the home orientation.
home={a,b,c}Defines the home orientation using the Euler angles a, b, c in degrees. You can execute:
ModifyGizmo home={0,0,0}
to reset to the default home orientation.
The initial state of this setting for a given Gizmo window comes from Gizmo miscellanous settings as set via Misc->Miscellaneous Settings.
See Gizmo Object Rotation for a discussion of the home orientation.
hookEvents=valuevalue is a bitwise setting that determine which events activate the hookFunction.
Bit 0:Mouse down
Bit 1:Mouse moved
Bit 2:Display rotated
Bit 3:Window killed
Bit 4:Data range changed
Bit 5:Mouse wheel moved
Bit 6:Projection transformation changed
See Setting Bit Parameters for details about bit settings.
This setting does not affect standard window hooks as described under Window Hook Functions. It affects only the Gizmo-specific hook function set by the hookFunction keyword.
hookFunction=functionName (obsolete)
Specifies the function to be called when certain events happen. Use hookFunction=$"" to specify no hook function. This sets the unnamed hook function and is analogous to SetWindow hook=procName.
Unnamed hook functions are obsolete. See Gizmo Hook Functions for details.
idleEventQuaternion={q0, q1, q2, q3}
Starts idle-event rotation. In each idle event Gizmo rotates the display by the specified quaternion.
See also Programming Rotations in Gizmo.
idleEventRotation={dx, dy}
Starts idle-event rotation using the equivalent mouse translation increments given by dx and dy in pixels.
See also Programming Rotations in Gizmo.
idleEventRotation={angle, axis1, axis2, axis3}
Starts and idle-event rotation about an axis specified by three components. The angle, expressed in degrees, determines the amount of rotation between consecutive idle events. For example, to start a clockwise idle-event rotation about the z-axis use:
ModifyGizmo idleEventRotation={5,0,0,1}
See also Programming Rotations in Gizmo.
infoWindow [= {left, top, right, bottom}]
Specifies the size and position of the info window. If used without arguments it opens the info window at the top-left corner of the active screen.
insertDisplayList=nInserts an item in the display list at zero-based location n. For example, this inserts a translation operation at location 2:
ModifyGizmo insertDisplayList=2,opName=t0,operation=translate,data={1,1,1}
keepPlotSquare=val
val =0:The viewport fills the Gizmo window.
val =1:The viewport is the largest square that fits centered in the Gizmo window.
All other values are reserved for future use.
lockMouseRotation=val
Enables or disables rotation using the mouse.
val =0:Enables rotation with the cursor.
val =1:Disables rotation using the cursor.
makeSurfaceColorWave={srcWave, cTabName, isInverse}
makeColorWave={srcWave, cTabName, isInverse}
makeColorWave is a synonym for the preferred makeSurfaceColorWave keyword.
This keyword does not actually modify the display in Gizmo. It is a convenience function that creates a color wave suitable for Gizmo.
When srcWave is a 2D wave, makeSurfaceColorWave creates a 3D, 4-layer RGBA color wave specifying the color for each Z value in srcWave. If srcWave contains NaNs, they are mapped into RGBA with an alpha value of zero.
When srcWave is a 1D wave with n rows, the operation creates an (nx4) RGBA wave using the specified color table.
The output wave is created in the current data folder and has the same name as srcWave with an "_C" suffix. If a wave of that name exists, it is overwritten.
cTabName is the name of one of the built-in color tables, e.g., Grays, Rainbow, etc.
If isInverse is 0, the minimum Z data value in srcWave is mapped to the first color in the color table and the maximum Z data value in srcWave is mapped to the last color in the color table. If isInverse is 1 the mapping is reversed.
See Gizmo Colors, Material and Lights[Color Waves] for further details and for discussion of a situation where this feature is useful.
makeTripletColorWave={srcWave, cTabName, isInverse}
This keyword does not actually modify the display in Gizmo. It is a convenience function that creates a color wave suitable for Gizmo.
If srcWave is a triplet wave, the operation uses the data in the Z column of srcWave.
If srcWave is not a triplet wave the operation uses the data in the first column of srcWave.
cTabName is the name of one of the built-in color tables, e.g., Grays, Rainbow, etc.
If isInverse is 0, the minimum Z data value in srcWave is mapped to the first color in the color table and the maximum Z data value in srcWave is mapped to the last color in the color table. If isInverse is 1 the mapping is reversed.
The output wave is created in the current data folder and has the same name as srcWave with an "_C" suffix. If a wave of that name exists, it is overwritten.
Despite the name "makeTripletWave", the output wave is a 2D wave with 4 columns having the same number of rows as srcWave. Each row contains an RGBA color taken from a built-in color table specified by cTabName. Alpha values are set to 1 except when the Z value is NaN, in which case alpha is set to zero.
mass=valuevalue affects the manual rotation of objects by giving the displayed objects "inertia". By default, mass=2. A larger value slows rotation and a smaller value speeds rotation.
matchRotation=gizmoName
Sets the orientation of the target Gizmo window to that of the Gizmo window specified by gizmoName.
namedHook={hookName, procName}
hookName is the name of the Gizmo window hook you are installing. procName is the name of the Igor procedure to which hooks will be sent.
See Gizmo Named Hook Functions for details.
namedHookStr={hookName, procNameStr}
Use this version to install a named hook function when your function is part of an independent module and needs to be called using a compound name as in IM#funcName. In this case you pass the procedure name as a string.
object=nameIdentifies a specific object by name. For example:
ModifyGizmo setDisplayList=2, object=surface0
offsetQuat={q0, q1, q2, q3}
Specifies an offset quaternion for synchronized rotation. When you set Gizmo0 to be synchronized with Gizmo1, using syncRotation, you can add the offset quaternion to Gizmo0 so that whenever Gizmo1 is rotated, Gizmo0 is rotated to the orientation of Gizmo1 and then rotated further by the offset quaternion. You can enable/disable the use of the offset quaternion with the keyword useOffsetQuat.
See also Programming Rotations in Gizmo.
outputResFactor=fSpecifies the factor by which the output resolution is greater than screen resolution. The factor affects output copied to the clipboard, printed or exported as an image. By default outputResFactor=2.
See also Exporting Gizmo Windows.
pan={x, y}Pans the Gizmo display by x in the x-direction and y in the y-direction. Both x and y are in +/-1 display volume units.
pathToRibbon={srcTriplet, columnNum, setValue}
Creates a triplet wave representing a ribbon from srcTriplet, which must be single- or double-precision floating point, by setting alternating values of the specified columnNum to the setValue.
printDrawingTimePrints a message in the history showing the time that it took to draw the last Gizmo image.
The last drawing time may be significantly shorter than the initial drawing time because Gizmo attempts to preserve vertex buffer objects when the underlying data waves have not changed. For example, the time it takes to draw a surface on rotation is shorter than the time to draw a surface when the surface data changed.
removeObjectAttribute={objectName, attributeName}
Removes the specified embedded attribute from the named object.
resumeUpdatesUse resumeUpdates at the end of a sequence of commands to allow the resumption of normal updates. See also stopUpdates below.
saveGroupRecreation=macroName
Saves a recreation macro for the current group object, as set by the currentGroupObject keyword. The recreation macro is saved using the specified macro name to the built-in procedure window.
scalingMode=mNormally you will not need to use this keyword. When you use the setOuterBox keyword, Gizmo internally executes scalingMode=8. When you apply autoscaling Gizmo sets scalingMode=2. Other scaling modes are reserved.
See also Gizmo Dimensions.
scalingOption=flagflags is a bitwise setting that determines whether autoscaling is turned on for each axis end. If a given bit is set, the cooresponding axis end is autoscaled. Otherwise that axis end is controlled by the manual axis range as set by the setOuterBox keyword.
flags is defined as follows:
Bit 0:X axis minimum
Bit 1:X axis maximum
Bit 2:Y axis minimum
Bit 3:Y axis maximum
Bit 4:Z axis minimum
Bit 5:Z axis maximum
See Setting Bit Parameters for details about bit settings.
Using these binary fields a complete auto-scale (for all axes) corresponds to scalingOption=63 and when the range of all axes are specified by the user correspond to scalingOption=0. See also setOuterBox.
flags =63 turns autoscaling on for all axis ends. flags =0 turns autoscaling off for all axis ends.
See also Gizmo Dimensions.
setAttributeName={oldName, newName}
Renames an attribute. oldName must be the name of an existing object. newName must be valid and unique.
setDisplayList=indexSet operations, objects or attributes in the display list. index is a zero-based list index. For example:
ModifyGizmo setDisplayList=0, opName=popMatrix0, operation=PopMatrix
ModifyGizmo setDisplayList=1, object=surface0
ModifyGizmo setDisplayList=2, attribute=color0
If index =-1, the specified object is appended to the end of the display list.
setDisplayListName={oldName, newName}
Renames a display list item. oldName must be the name of an existing display list item. newName must be valid and unique.
setObjectAttribute={objectName, attributeName}
Embeds an attribute, specified by attributeName, in the object specified by objectName. For example:
ModifyGizmo setObjectAttribute={axes0,blueColor}
setObjectName={oldName, newName}
Renames an object list item. oldName must be the name of an existing object list item. newName must be valid and unique.
setOuterBox={xmin, xmax, ymin, ymax, zmin, zmax}
Sets the display range for wave-based data objects to the specified user values.
This feature is useful if you want to force the limits of the graph in any dimension. To revert to autoscaling, execute:
ModifyGizmo scalingMode=2
You can also use the scalingOption keyword to select which of the outer box limits actually affect the display.
See also Gizmo Dimensions.
setQuaternion={q0, q1, q2, q3}
Sets the internal quaternion that governs the orientation of the Gizmo display.
See Programming Rotations in Gizmo for details.
You may find it easier to use the euler keyword.
setRotationMatrix=mWave
Sets the 16 elements of the rotation matrix to the 2D (4x4) wave mWave. The rotation matrix represents the current transformation.
This is equivalent to setQuaternion above. Gizmo uses quaternions internally. The specified rotation matrix is converted to a quaternion on input.
If you intend to perform repeated rotation operations you should consider using quaternions instead.
See also Programming Rotations in Gizmo.
setRotationMatrix={v0,... v15}
Sets the rotation matrix to the 16 elements specified as {00,01,02,03,10,11,12,13,...} where the first digit specifies the matrix-element's row and the second its column. This is an alternative to setting the rotation matrix using a 4x4 wave.
See also Programming Rotations in Gizmo.
showAxisCue=valShows or hides the built-in axis cue that indicates the orientation of the X, Y and Z axes.
val =0:Hides the axis cue.
val =1:Shows the axis cue.
See also the freeAxesCue keyword in the AppendToGizmo operation.
showInfoOpens the Gizmo info window assocated with the targeted Gizmo display window. If the info window is already open, it just brings it to the front.
showTime=modeTurns on or off printing into the history area the time it took to complete drawing the Gizmo plot. This is a debugging aid which you will generally not need to use.
startRecMacro=versionStarts a recreation macro for a Gizmo plot. Commands that appear between startRecMacro and endRecMacro are executed without immediate update.
version was added in Igor Pro 7.00. See Gizmo Recreation Macro Changes for details.
This keyword is automatically generated by Igor when it creates a recreation macro. You should not need to use it.
stopRotationStops idle-event rotation of the display.
stopUpdatesSuspends updating the Gizmo display for subsequent ModifyGizmo commands until resumeUpdates is called. Use this to allow quick execution of multiple ModifyGizmo commands followed by a single update at the end of the process.
syncRotation=gizmoName
Synchronizes the rotation of the targeted Gizmo to that of gizmoName. After you execute this command, the targeted Gizmo will rotate in sync with gizmoName. To clear this setting use syncRotation=$"".
It is possibly to cross-synchronize Gizmos as in:
ModifyGizmo/N=Gizmo0 syncRotation=gizmo1
ModifyGizmo/N=Gizmo1 syncRotation=gizmo0
See also the offsetQuat keyword.
See also Programming Rotations in Gizmo.
update=modeForces an update of the Gizmo Display window. mode is:
0:Performs a silent update mostly during idle events.
1:Checks if any object needs updating or if the rotation changed and updates only if necessary.
2:Forces an immediate update that includes reloading all the waves, finding the minima and maxima, computing their scale factors and redrawing the associated objects.
useOffsetQuat=modeControls whether the offset quaternion is used during synchronized rotation. mode is:
0:Disable using an offset quaternion.
1:Enable using an offset quaternion when in syncRotation.
See offsetQuat above for details.
userString={name, str}This keyword is for backward compatibility only. New code should use the more flexible SetWindow with the userData keyword.
Stores arbitrary user-specified data which can later be retrieved using name. This is used by advanced programmers to associate procedure settings with a given Gizmo window.
name is a standard IGOR name.
str is limited to 255 bytes.
If you issue this command for an existing name, it overwrites the previous value with the new str.
See also GetGizmo userString.
zoomMode=modeDetermines if the mouse scroll wheel rotates or zooms the Gizmo display:
0:Mouse wheel rotates.
1:Mouse wheel zooms.
zoomFactor=fSpecifies the level of zoom.
f is a positive number with f=1.0 giving default zoom.
f > 1 zooms out relative to the default.
f < 1 zooms in relative to the default.

ModifyGizmo for Attributes

The syntax for modifying a Gizmo attribute is:

ModifyGizmo attributeType=type, modifyAttribute={attrName,data...}

type is one of the built-in attributes types listed below.

attrName is the name of the particular attribute that you want to modify.

data depends on the requirements of the specific attribute. The table below lists all of the attribute types and their corresponding data requirements.

Keywords

attributeType=color, modifyAttribute={attrName , R, G, B, A }
R, G, B, and A are values in the range [0,1] specifying the attribute's color.
attributeType=ambient, modifyAttribute={attrName , R, G, B, A, mode }
R, G, B, and A are values in the range [0,1] specifying the attribute's color.
mode is 1028 (GL_FRONT), 1029 (GL_BACK) or 1032 (GL_FRONT_AND_BACK).
attributeType=diffuse, modifyAttribute={attrName , R, G, B, A, mode }
R, G, B, and A are values in the range [0,1] specifying the attribute's color.
mode is 1028 (GL_FRONT), 1029 (GL_BACK) or 1032 (GL_FRONT_AND_BACK).
attributeType=specular, modifyAttribute={attrName , R, G, B, A, mode }
R, G, B, and A are values in the range [0,1] specifying the attribute's color.
mode is 1028 (GL_FRONT), 1029 (GL_BACK) or 1032 (GL_FRONT_AND_BACK).
attributeType=shininess, modifyAttribute={attrName , vFront , vBack }
vFront and vBack are the front and back shininess in the range [0,128].
attributeType=emission, modifyAttribute={attrName , R, G, B, A, mode }
R, G, B, and A are values in the range [0,1] specifying the attribute's color.
mode is 1028 (GL_FRONT), 1029 (GL_BACK) or 1032 (GL_FRONT_AND_BACK).
attributeType=blendFunc, modifyAttribute={attrName , srcMode , dstMode }
srcMode and dstMode are each one of the following constants:
0x0000:GL_ZERO
0x0001:GL_ONE
0x0306:GL_DST_COLOR
0x0307:GL_ONE_MINUS_DST_COLOR
0x0302:GL_SRC_ALPHA
0x0303:GL_ONE_MINUS_SRC_ALPHA
0x0305:GL_ONE_MINUS_DST_ALPHA
0x0308:GL_SRC_ALPHA_SATURATE
For details see Gizmo Colors, Material and Lights[Transparency and Translucency].
attributeType=alphaTestFunc, modifyAttribute={attrName , testFormat , ref }
testFormat is one of the following constants:
0x0200:GL_NEVER
0x0207:GL_ALWAYS
0x0201:GL_LESS
0x0203:GL_LEQUAL
0x0206:GL_GEQUAL
0x0204:GL_GREATER
0x0205:GL_NOTEQUAL
0x0206:GL_GEQUAL
ref is a reference value in the range [0,1].
attributeType=pointSize, modifyAttribute={attrName , size } (obsolete)
size is a point size in pixels.
The pointSize attribute is obsolete and does nothing because of changes in OpenGL.
attributeType=lineWidth, modifyAttribute={attrName , width }
width is a line width in pixels.
The lineWidth attribute is obsolete and does nothing because of changes in OpenGL.
attributeType=quadridDrawStyle, modifyAttribute={attrName , style } (deprecated)
style is an OpenGL constant.
The quadricDrawStyle attribute is deprecated. It is now a built-in attribute of quadric objects.
attributeType=quadricNormals, modifyAttribute={attrName , normals } (deprecated)
normals is an OpenGL constant.
The quadricNormals attribute is deprecated. It is now a built-in attribute of quadric objects.
attributeType=quadricOrientation, modifyAttribute={attrName , orientation } (deprecated)
orientation is an OpenGL constant.
The quadricOrientation attribute is deprecated. It is now a built-in attribute of quadric objects.

ModifyGizmo for Operations

The syntax for modifying a Gizmo operation is:

ModifyGizmo opName=name, operation=type, data={dataVal [, dataVal]...}

The command affects only the particular named operation identified by name and type. For example, if you added a translate operation which you named "t1" the syntax is:

ModifyGizmo opName=t1, operation=translate, data={1,1,1}

The operation parameter translate identifies the type of operation that is to be performed and t1 identifies the specific operation. The data format is unique for each operation.

operation=clearColor, data={R, G, B, A }
R, G, B, and A are values in the range [0,1] specifying the color of the Gizmo display window background.
operation=clearTexture
This operation takes no parameters.
Tests if 1D or 2D textures are enabled and if so they are disabled. Also disabled are S and T texture coordinates generation.
operation=clipPlane, data={plane, A, B, C, D }
Creates a user-defined clipping plane.
plane is a plane number in the range [0,5].
A, B, C, and D are constants that specify the plane as the locus of points (x,y,z) such that Ax+By+Cz+D=0.
Gizmo assumes that the OpenGL implementation supports a maximum of 6 clipping planes so using setOuterBox (axis range) and user-defined clipping planes are mutually exclusive.
operation=colorMaterial, data={face, mode }
Applies color material properties to any face of the object.
face is 1028 (GL_FRONT), 1029 (GL_BACK) or 1032 (GL_FRONT_AND_BACK).
mode is one of the following:
0x1600:GL_EMISSION - object surfaces emit light of the color specified.
0x1200:GL_AMBIENT - affects only ambient illumination.
0x1201:GL_DIFFUSE - affects only diffuse illumination.
0x1202:GL_SPECULAR - rarely used.
0x1602:GL_AMBIENT_AND_DIFFUSE - most commonly used.
When you add a ColorMaterial operation to the display list, Gizmo automatically enables it so you do not need to precede it with Enable(ColorMaterial). However, you must add to the display list a Disable(colorMaterial) when you do not want it to affect subsequent objects. Disabling colorMaterial also improves display performance.
operation=dataTranslate, data={dtx, dty, dtz }
Specifies the amount of translation of an object from its initial position in each dimension.
dtx, dty, and dtz are translation parameters in data coordinates.
See also translate below for translation in +/-1 display volume units coordinates.
operation=disable, data={constant }
Disables an OpenGL feature.
constant is an OpenGL constant. There are 48 OpenGL constants for the enable and disable keywords. Examples are GL_BLEND, GL_TEXTURE_2D, and GL_LIGHT0.
operation=enable, data={constant }
Disables an OpenGL feature.
constant is an OpenGL constant. There are 48 OpenGL constants for the enable and disable keywords. Examples are GL_BLEND, GL_TEXTURE_2D, and GL_LIGHT0.
operation=frontFace, data={direction }
direction is one of the following:
0x0900:GL_CW
0x0901:GL_CCW
In Igor 6 the default was GL_CW. It is now GL_CCW.
operation=frustrum, data={left, right, bottom, top, zNear, zFar }
Multiplies the current transformation matrix by a perspective specified by the 6 clipping planes.
left, right, bottom, top, zNear, and zFar are coordinates in +/-1 display units.
Frustrum is similar to perspective operation but with slightly different and more flexible choice of parameters. See Gizmo Projections for details.
operation=lightModel, data={selector, p1, p2, p3, p4 }
The meaning of p1, p2, p3, and p4 depends on selector :
selector = 0x0B53 (ambient)
p1 through p4 are RGBA values in the range [0,1] of ambient components.
selector = 0x81F8 (color control)
p1 is 0x81F9 for GL_SINGLE_COLOR or 0x81FA for GL_SEPARATE_SPECULAR_COLOR. Pass zero for p2 , p3 , and p4 .
selector = 0x0B51 (local viewer)
p1 is 0 for viewing in the Z direction, 1 for viewing from the origin of the eye coordinate system. Pass zero for p2 , p3 , and p4 .
selector = 0x0B52 (two sided)
p1 is 0 for computing lighting only for the front surface, 1 for computing lighting for both sides of the surface. Pass zero for p2 , p3 , and p4 .
operation=loadIdentity
This operation takes no parameters.
Replaces the current transformation matrix with an identity matrix; used to initialize matrix transformations.
operation=loadMatrix, data={matrixWave }
Loads matrixWave as the current transformation matrix.
matrixWave is a 2D wave with 4 rows and 4 columns.
operation=lookAt, data={ex, ey, ez, cx, cy, cz, ux, uy, uz }
Defines a viewing transformation defined by the eye position (ex,ey,ez), the position of a reference point (cx,cy,cz) and the up vector (ux,uy,uz).
ex, ey, and ez are X, Y, and Z components of the eye position expressed in +/-1 display volume coordinates.
cx, cy, and cz are X, Y, and Z components of the center of the scene (reference point) expressed in +/-1 display volume coordinates.
ux, uy, and uz are X, Y, and Z components of the up vector expressed in +/-1 display volume coordinates.
operation=mainTransform
This operation takes no parameters.
The main transform represents the orientation of the display volume as controlled by the keyboard and mouse. If you insert this operation in the middle of the display list, only items that appear below the main transform will rotate with the mouse while items that appear above it will be unaffected.
operation=matrixMode, data={mode }
Specifies if the current transformation matrix is the model view or the projection matrix.
mode is one of the following:
0x1700:GL_MODELVIEW
0x1701:GL_PROJECTION
operation=matrixMultiply, data={matrixWave }
Multiply the current transformation matrix by the matrix represented by matrixWave .
matrixWave is a 2D wave with 4 rows and 4 columns.
operation=orth, data={left, right, bottom, top, zNear, zFar }
Defines the spatial dimensions of the 3D display volume. You may have to modify them if you experience any unwanted clipping.
left, right, bottom, top, zNear, and zFar are coordinates in +/-1 display units.
See Gizmo Projections for details.
operation=perspective, data={fov, aspect, zNear, zFar }
Specifies a perspective projection of the viewing volume. This is the default perspective.
fov, aspect, zNear, and zFar are coordinates in +/-1 display units.
fov is the field of view in the Y-direction (angle in degrees), aspect is the ratio of the X and Y directions for the clipping planes, and the two Z values specify the front (zNear ) and rear (zFar ) clipping planes.
See Gizmo Projections for details.
operation=popAttribute
This operation takes no parameters.
Pops the top attribute from the attribute stack, reverting to the state as saved by the last pushAttribute operation.
operation=popMatrix
This operation takes no parameters.
Pops the top transformation matrix from the transformation matrix stack, reverting to the state as saved by the last pushMatrix operation.
operation=pushAttribute, data={mask }
Specifies the attributes to push onto the attribute stack. This operation is used to save a drawing state for temporary change which can be reverted by a popAttribute operation.
mask is an OpenGL constant. To push all attributes use 0x000FFFFF (GL_ALL_ATTRIB_BITS).
operation=pushMatrix
This operation takes no parameters.
Pushes the current transformation matrix to the top of the transformation matrix stack.
The pushMatrix operation is used for temporary drawing with a different transformation. It pushes the current transformation matrix onto the transformation matrix stack. Follow this by an operation that changes the transformation matrix, such as loadMatrix or matrixMultiply, and some drawing commands. Clean up with a popMatrix operation to restore the original transformation matrix.
operation=rotate, data={angle, ax, ay, az }
Rotates the display.
angle is the angle in degrees about which you want to rotate.
ax, ay, and az are X, Y, and Z components of a vector about which to perform the rotation.
operation=scale, data={sx, sy, sz }
Scales the display relative to the current scaling.
sx, sy, and sz are X, Y, and Z scaling factors. A scaling factor of 1 leaves the scaling unchanged.
operation=shadingModel, data={model }
Specifies the shading model to use.
model is one fo the following:
0x1D00:GL_FLAT
0x1D01:GL_SMOOTH
By default Gizmo uses smooth shading unless there is a shading model operation in the display list.
operation=translate, data={dx, dy, dz }
Scales the display relative to the current scaling using +/-1 display volume units. See also dataTranslate.
dx, dy, and dz are X, Y, and Z translation components in +/-1 display volume units.
operation=viewport, data={left, bottom, width, height }
Specifies the viewport rectangle.
left, bottom, width, and height are coordinates in screen pixels.
The initial values for left and bottom are (0,0).
You should not need to use this operation as Gizmo automatically updates the viewport to the full size of the Gizmo display window.

ModifyGizmo for Objects

The syntax for modifying a Gizmo object is:

ModifyGizmo modifyObject=objName, objectType=type, property={propertyName,data}

objName is the name that was assigned to the object.

type is the generic object type, e.g., path, ribbon, surface, etc.

propertyName specifies the property to be modified.

data represents a variable number of parameters that depend on the type of property being modified.

The following sections describe modification of the supported object types. They are arranged in the order of appearance in the object menu (+ icon under the object list) of the Gizmo info window. The sections are:

ModifyGizmo for Path Objects

ModifyGizmo for Ribbon Objects

ModifyGizmo for Surface Objects

ModifyGizmo for Isosurface Objects

ModifyGizmo for Voxelgram Objects

ModifyGizmo for Scatter Objects

ModifyGizmo for 3D Bar Chart Objects

ModifyGizmo for Image Objects

ModifyGizmo for Axis Objects

ModifyGizmo for Free Axis Cue Objects

ModifyGizmo for Line Objects

ModifyGizmo for Triangle Objects

ModifyGizmo for Quad Objects

ModifyGizmo for Box Objects

ModifyGizmo for Sphere Objects

ModifyGizmo for Cylinder Objects

ModifyGizmo for Disk Objects

ModifyGizmo for Tetrahedron Objects

ModifyGizmo for Pie Wedge Objects

ModifyGizmo for Light Objects

ModifyGizmo for Texture Objects

ModifyGizmo for Matrix4x4 Objects

ModifyGizmo for String Objects

ModifyGizmo for ColorScale Objects

ModifyGizmo for Path Objects

The syntax for modifying a Gizmo path object is:

ModifyGizmo modifyObject=objName, objectType=path, property={propertyName,data}

For background information and examples see Gizmo Data Objects[Path Plots].

All of the properties supported for path objects also apply to ribbon objects.

Keywords

property={calcNormals, enable }
Enables (enable =1) or disables (enable =0) the calculation of normals for the object.
Normals are required for lighting/shading and smoothing effects. Calculation of normals takes graphics resources so it should be turned off unless it is needed.
calcNormals is not relevant if you are drawing a simple line path. It is used in when drawing paths as 3D tubes and for ribbon objects.
property={clipped, mode }
Determines if the path/ribbon object is clipped by the global clipping planes.
mode =0:Not clipped.
mode =1:Clipped.
By default clipping is on. For more information see Gizmo Clipping.
property={CTABAlpha, alpha }
Sets the alpha component for colors for the object when those colors are derived from an Igor color table.
alpha is an alpha value the range [0,1]. For more information see Transparency and Translucency.
property={CTABScaling, mode }
mode is a bitwise setting that controls the path coloring when using a color table.
One and only one bit from bit 0 through 4 must be set. In addition, any of bits 5, 6, 8 or 9 may be set.
Bit 0:From min X to max X
Bit 1:From min Y to max Y
Bit 2:From min Z to max Z
Bit 3:From 0 to max sqrt(X^2+Y^2)
Bit 4:From 0 to max sqrt(X^2+Y^2+Z^2)
Bit 5:Minimum value and color specified
Bit 6:Maximum value and color specified
Bit 7:Not used - set to 0
Bit 8:Color table maps plot-global X range
Bit 9:Color table maps plot-global Y range
See Setting Bit Parameters for details about bit settings.
For more information see Color Tables in Gizmo.
property={drawEndCaps, mode }
drawEndCaps applies only when drawing tubes.
mode =0:The ends of each segment are not capped.
mode =2:The ends of segments are capped with a plane perpendicular to the segment.
property={drawTube, mode }
mode =0:Draws a standard path plot.
mode =1:Draws the path as a tube with a fixed radius.
mode =2:Draws the path as a tube with user-specified radii at every vertex.
property={fixedRadius, radius }
When drawing a path as a tube of fixed radius, radius is used for every vertex of the tube. radius is expressed in +/-1 display volume units.
property={inverseCTab, mode }
Specifies if the color table used to draw the path is inverted.
mode =0:Not inverted.
mode =1:Inverted.
property={linewidth, width } (deprecated)
Specifies the line width in points.
This property is deprecated.
property={lineWidthType, type } (deprecated)
Specifies how line width is determined.
type =0:Not specified by this object.
type =1:Specified by this object.
This property is deprecated.
property={pathColor, R, G, B, A }
R, G, B, A values in the range [0,1] specify a single color for the whole path.
property={pathCTab, name }
name specifies a built-in Igor color table to use for path colors. For more information see Color Tables in Gizmo.
property={pathColorType, type }
Specifies the type of path coloring:
type =1:Constant color. Use pathColor to specify the color.
type =2:Color wave. Use pathColorWave to specify the color wave.
type =3:Color table. Use pathCTab to specify the color table.
property={pathColorWave, wave }
wave contains R, G, B, A values in the range [0,1] specifying the color of each vertex. For more information see Color Waves.
property={pathRadiusWave, wave }
wave is the name of a 1D SP or DP wave containing the radius of the path tube (see drawTube above). The radius wave provides a single scalar for each vertex in the path. The radius wave may contain arbitrary values for points in the path wave that contain NaN. Although there is a single radius value for each path vertex, the cross-section of the tube is, in general, not circular because of different scaling along the three axes. See also fixedRadius above.
property={maxRGBA, value, R, G, B, A }
In X, Y, or Z range, use an unscaled maximum value followed by 4 values for R, G, B, and A in the range [0,1]. In radial modes, use scaled [0,1] value followed by R, G, B, A.
property={minRGBA, value, R, G, B, A }
In X, Y, or Z range, use an unscaled minimum value followed by 4 values for R, G, B, and A in the range [0,1]. In radial modes, use scaled [0,1] value followed by R, G, B, A.
property={numSegments, n }
n is the number of segments in the cross-section of a tube. n must be 4 or more. It is 20 by default.
property={srcWave, wave }
wave identifies the triplet wave describing the X, Y and Z coordinates for each point on the path.
property={quaternary, mode }
Used to match a scatter plot quaternary property.
mode =0:Disables the quaternary display of the data.
mode =1:Enables quaternary display of data.

ModifyGizmo for Ribbon Objects

The syntax for modifying a Gizmo ribbon object is:

ModifyGizmo modifyObject=objName, objectType=ribbon, property={propertyName,data}

All ribbon object properties are identical to path object properties above. See ModifyGizmo for Path Objects.

For more information also see Ribbon Plots.

ModifyGizmo for Surface Objects

The syntax for modifying a Gizmo surface object is:

ModifyGizmo modifyObject=objName, objectType=surface, property={propertyName,data}

For more information also see Surface Plots.

Keywords

property={backColor, R, G, B, A }
R, G, B, and A in the range [0,1] specify the color of the back side of the surface.
property={calcNormals, enable }
Enables (enable =1) or disables (enable =0) the calculation of normals for the object.
Normals are required for lighting/shading and smoothing effects. Calculation of normals takes graphics resources so it should be turned off unless it is needed.
property={clipped, mode }
Determines if the surface is clipped by the global clipping planes.
mode =0:Not clipped.
mode =1:Clipped.
By default clipping is on. For more information see Gizmo Clipping.
property={fillMode, mode }
Specifies the surface fill mode:
mode =1:Wireframe or grid
mode =2:Color fill
mode =4:Point cloud
mode =5:Scatter
mode =3:Color fill and wireframe
property={frontColor, R, G, B, A }
R, G, B, and A in the range [0,1] specify the color of the front side of the surface. The front color applies when fillMode is set for color fill and when surfaceColorType is set to a constant color.
property={inverseLineCTab, mode }
Specifies if the color table used to draw the surface grid lines is inverted.
mode =0:Not inverted
mode =1:Inverted
property={inverseSurfaceCTab, mode }
Specifies if the color table used to draw the surface is inverted.
mode =0:Not inverted
mode =1:Inverted
property={lineColor, R, G, B, A }
R, G, B, and A in the range [0,1] specify the color of grid lines. This property applies when drawing a wireframe/grid and when lineColorType is set to a constant color.
property={lineColorType, type }
Specifies the type of grid line coloring:
type =1:Constant color. Use lineColor to specify the color.
type =2:Color table. Use lineCTab to specify the color table.
type =3:Color wave. Use lineColorWave to specify the color wave.
property={lineColorWave, wave }
wave contains R, G, B, A values in the range [0,1] for coloring grid lines. The same wave can be used for grid-line color and for the surface. For more information see Color Waves.
property={lineCTab, name }
name specifies a built-in Igor color table to use for grid line colors. For more information see Color Tables in Gizmo.
property={lineCTABAlpha, alpha }
Sets the alpha component for colors for the grid lines when those colors are derived from an Igor color table.
alpha is an alpha value the range [0,1]. For more information see Transparency and Translucency.
property={lineCTABScaling, mode }
Same as surfaceCTABScaling below but applies to the grid lines.
property={lineMaxRGBA, value, R, G, B, A }
In X, Y, or Z range, use an unscaled maximum value followed by 4 values for R, G, B, and A in the range [0,1]. In radial modes, use scaled [0,1] value followed by R, G, B, A.
property={lineMinRGBA, value, R, G, B, A }
In X, Y, or Z range, use an unscaled minimum value followed by 4 values for R, G, B, and A in the range [0,1]. In radial modes, use scaled [0,1] value followed by R, G, B, A.
property={linewidth, width } (deprecated)
Specifies the grid line width in points.
This property is deprecated.
property={lineWidthType, type } (deprecated)
Specifies how grid line width is determined.
type =0:Not specified by the surface object
type =1:Specified by the surface object
This property is deprecated.
property={plane, index }
index is a zero-based integer specifying the plane of the volumetric data that is to be displayed.
This property applies when srcMode=32 (Z slices), 64 (Y slices) or 128 (X slices). For Z slices index specifies the layer of the source wave, for Y slices it specifies the column, and for X-slices it specifies the row.
property={srcMode, format }
Specifies the source wave data format:
format =0:Matrix wave. A 2D wave containing MxN Z values on a rectangular grid. The X and Y dimensions are optionally specified by wave scaling.
format =1:Triangles wave. A triplet wave in which each row corresponds to a sequential vertex and the columns correspond to the X, Y and Z components.
format =4:Parametric data. A 3D MxNx3 wave where the MxN vertices are specified by the X, Y and Z values in the corresponding layers.
format =8:Sequential quads. An Mx4x3 wave that describes M quads, each consisting of 4 vertices and X, Y and Z values in the corresponding layers.
format =16:Disjoint quads. An Mx12 wave that describes M quads where the 12 rows correspond to the X, Y and Z components of each quad's vertices. For the purpose of calculating normals, it is assumed that the order of the vertices is the same throughout the wave.
format =32:Z slices of a volumetric (3D) wave.
format =64:Y-slices of a volumetric (3D) wave.
format =128:X-slices of a volumetric (3D) wave.
For more information see Gizmo Wave Data Formats.
property={srcWave, wave }
Specifies the source wave for the surface.
property={surfaceColorType, type }
Specifies the type of surface coloring:
type =1:Constant color. Use frontColor and backColor to specify the surface color.
type =2:Color table. Use surfaceCTab to specify the color table.
type =3:Color wave. Use surfaceColorWave to specify the color wave.
property={surfaceColorWave, wave }
wave contains R, G, B, A values in the range [0,1] for coloring the surface. For more information see Color Waves.
property={surfaceCTab, name }
name specifies a built-in Igor color table to use for surface colors. For more information see Color Tables in Gizmo.
property={surfaceCTABScaling, mode }
mode is a bitwise setting that controls the surface coloring when using a color table.
One and only one bit from bit 0 through 4 must be set. In addition, any of bits 5, 6, 7, 8 or 9 may be set.
Bit 0:From min X to max X
Bit 1:From min Y to max Y
Bit 2:From min Z to max Z
Bit 3:From 0 to max sqrt(X^2+Y^2)
Bit 4:From 0 to max sqrt(X^2+Y^2+Z^2)
Bit 5:Minimum value and color specified
Bit 6:Maximum value and color specified
Bit 7:Set for volume slices
Bit 8:Color table maps plot-global X range
Bit 9:Color table maps plot-global Y range
See Setting Bit Parameters for details about bit settings.
For more information see Color Tables in Gizmo.
property={surfaceMaxRGBA, value, R, G, B, A }
In X, Y, or Z range, use an unscaled maximum value followed by 4 values for R, G, B, and A in the range [0,1]. In radial modes, use scaled [0,1] value followed by R, G, B, A.
property={surfaceMinRGBA, value, R, G, B, A }
In X, Y, or Z range, use an unscaled minimum value followed by 4 values for R, G, B, and A in the range [0,1]. In radial modes, use scaled [0,1] value followed by R, G, B, A.
property={surfaceCTABAlpha, alpha }
Sets the alpha component for colors for the surface when those colors are derived from an Igor color table.
alpha is an alpha value the range [0,1]. For more information see Transparency and Translucency.
property={xStep, step }
Specifies the X sampling of the grid lines in a wireframe. Set this to 1 to show all grid lines, 2 to show every other grid line, etc.
property={yStep, step }
Specifies the Y sampling of the grid lines in a wireframe. Set this to 1 to show all grid lines, 2 to show every other grid line, etc.

ModifyGizmo for Isosurface Objects

The syntax for modifying a Gizmo isosurface object is:

ModifyGizmo modifyObject=objName, objectType=isosurface, property={propertyName,data}

For more information also see Isosurface Plots.

Keywords

property={backColor, R, G, B, A }
R, G, B, and A in the range [0,1] specify the color of the back side of the surface. This property applies when fillMode=2 and surfaceColorType=1.
property={calcNormals, enable }
Enables (enable =1) or disables (enable =0) the calculation of normals for the object.
Normals are required for lighting/shading and smoothing effects. Calculation of normals takes graphics resources so it should be turned off unless it is needed.
property={clipped, mode }
Determines if the surface is clipped by the global clipping planes.
mode =0:Not clipped
mode =1:Clipped
By default clipping is on. For more information see Gizmo Clipping.
property={fillMode, mode }
Specifies the surface fill mode The following values may be combined:
mode=1:Wireframe or grid
mode=2:Color fill
mode=4:Point cloud
property={frontColor, R, G, B, A }
R, G, B, and A in the range [0,1] specify the color of the front side of the surface. The front color applies when fillMode=2 and when surfaceColorType=1.
property={isovalue, value }
Specifies a real, finite scalar value at which the surface is formed.
property={lineColor, R, G, B, A }
Specifies the color of the isosurface point cloud when lineColorType is set to 1. R, G, B, and A in the range [0,1].
This property was added in Igor Pro 9.00.
property={lineColorType, type }
Specifies the coloring of the isosurface point cloud:
type =0:Constant color that is determined by the last color setting in the display list prior to drawing the cloud.
type =1:Constant color. Use the lineColor property to specify the RGBA components.
This property was added in Igor Pro 9.00.
property={surfaceColorType, type }
Specifies the type of surface coloring:
type =0:No color. Surface color is specified outside the object.
type =1:Constant color surface. Use frontColor and backColor to specify the surface color.
property={saveToWave, outWaveNameStr }
Creates a wave containing triangles that describe the isosurface.
outWaveNameStr is a string containing the name to use for the output wave. The output wave is a triplet wave created in the current data folder. Each row contains the X, Y and Z coordinates of a single vertex and every three consecutive rows define a triangle from the isosurface. The triangles are not ordered in any way. The DepthSortingDemo experiment illustrates the use of this wave.
property={useTBB, mode }
Determines if the surface is clipped by the global clipping planes.
mode =0:Do not use automatic multithreading to compute the surface.
mode =1:Default. Use automatic multithreading to compute the surface.

ModifyGizmo for Voxelgram Objects

The syntax for modifying a Gizmo voxelgram object is:

ModifyGizmo modifyObject=objName, objectType=voxelgram, property={propertyName,data}

For more information also see Voxelgram Plots.

Keywords

property={boxSize, bx, by, bz }
When drawing a voxelgram in cubes mode, you can specify the relative size of the cube. By default, bx =by =bz =1 and the cube occupies half the size of the voxel cell in each dimension. You can set bx =by =bz =2 to draw box markers that completely fill the voxel cell. The accepted range for bx, by, and bz is (0,2].
property={calcNormals, enable }
Enables (enable =1) or disables (enable =0) the calculation of normals for the object.
Normals are required for lighting/shading and smoothing effects. Calculation of normals takes graphics resources so it should be turned off unless it is needed.
property={clipped, mode }
Determines if the voxelgram is clipped by the global clipping planes.
mode =0:Not clipped
mode =1:Clipped
By default clipping is on. For more information see Gizmo Clipping.
property={mode, mode }
Specifies how voxels are displayed:
mode =0:Voxels displayed as points
mode =1:Voxels displayed as cubes
property={srcWave, wave }
Specifies the source wave for the voxelgram. This must be a real-valued 3D wave.
property={tolerance, tolValue }
tolValue is a non-negative number which determines the neighborhood around the specified values where accepted voxels are marked.
If tolValue is set to zero then only voxels having exactly the specified values will be marked. This sometimes causes problems when one attempts to mark integer values in an SP or DP wave.
property={minRGBA, levelIndex, levelValue, R, G, B, A }
levelIndex specifies the index of the level for the color.
levelValue is a real, finite scalar value at which the points or cubes are drawn.
R, G, B, and A are values in the range [0,1] specifying the color to use for voxels.

ModifyGizmo for Scatter Objects

The syntax for modifying a Gizmo scatter object is:

ModifyGizmo modifyObject=objName, objectType=scatter, property={propertyName,data}

For more information also see 3D Scatter Plots.

Keywords

property={color, R, G, B, A }
R, G, B, and A specify a single color for all markers.
property={CTabAlpha, alpha }
Sets the alpha component for colors for the markers when those colors are derived from an Igor color table.
alpha is an alpha value the range [0,1]. For more information see Transparency and Translucency.
property={CTABScaling, mode }
mode is a bitwise setting that controls the marker coloring when using a color table.
One and only one bit from bit 0 through 4 must be set. In addition, any of bits 5, 6, 8 or 9 may be set.
Bit 0:From min X to max X
Bit 1:From min Y to max Y
Bit 2:From min Z to max Z
Bit 3:From 0 to max sqrt(X^2+Y^2)
Bit 4:From 0 to max sqrt(X^2+Y^2+Z^2)
Bit 5:Minimum value and color specified
Bit 6:Maximum value and color specified
Bit 7:Not used - set to 0
Bit 8:Color table maps plot-global X range
Bit 9:Color table maps plot-global Y range
See Setting Bit Parameters for details about bit settings.
For more information see Color Tables in Gizmo.
property={colorWave, wave }
wave is a 2D wave containing R, G, B, A values in the range [0,1] specifying the color of each marker. For an Mx3 scatter source wave the colorWave is Mx4 with RGBA values in each row. For more information see Color Waves.
property={dropLines, val }
Controls the drawing of drop lines. val is a bitwise setting with zero or more of the following bits set:
Bit 0:To minimum X plane
Bit 1:To maximum X plane
Bit 2:To minimum Y plane
Bit 3:To maximum Y plane
Bit 4:To minimum Z plane
Bit 5:To maximum Z plane
Bit 6:To the X-axis (cube center)
Bit 7:To Y-axis
Bit 8:To Z-axis
Bit 9:To the center of the cube
Bit 10:To the origin
Bit 11:To a fixed X level
Bit 12:To a fixed Y level
Bit 13:To a fixed Z level
See Setting Bit Parameters for details about bit settings.
property={dropLineColorType, type }
Specifies the type of drop line coloring:
type =0:Same color as the marker object.
type =1:R, G, B, A values specified by the dropLineRGBA keyword.
property={dropLineLevelX, level }
The X value to which the drop line extends when bit 11 of the dropLines keyword is set.
property={dropLineLevelY, level }
The Y value to which the drop line extends when bit 12 of the dropLines keyword is set.
property={dropLineLevelZ, level }
The Z value to which the drop line extends when bit 13 of the dropLines keyword is set.
property={dropLineRGBA, R, G, B, A }
R, G, B, and A in the range [0,1] specify the color of all drop lines.
property={dropLineWidth, width } (deprecated)
Specifies the drop line width in pixels.
This property is deprecated.
property={fontName, fontNameStr }
fontNameStr is the name of a font, such as "Arial", to use to draw the axis label.
property={inverseCTab, mode }
Specifies if the color table used to draw the markers is inverted.
mode =0:Not inverted
mode =1:Inverted
property={markerCTab, name }
name specifies a built-in Igor color table to use for marker colors. The scatterColorType property must be set to 3. For more information see Color Tables in Gizmo.
property={markerType, type }
Specifies how markers are selected:
type =0:Constant marker type. Use the shape property to specify the marker.
type =1:Marker type specified by a marker wave. Use the typeWave property to identify the wave.
property={maxRGBA, value, R, G, B, A }
In X, Y, or Z range, use an unscaled maximum value followed by 4 values for R, G, B, and A in the range [0,1]. In radial modes, use scaled [0,1] value followed by R, G, B, A.
property={minRGBA, value, R, G, B, A }
In X, Y, or Z range, use an unscaled minimum value followed by 4 values for R, G, B, and A in the range [0,1]. In radial modes, use scaled [0,1] value followed by R, G, B, A.
property={objectName, name }
The name of an object in the object list to draw as a marker.
property={quadricFacets, numFacets }
numFacets is the number of facets of a quadric object used as a marker. This applies to sphere, cylinder and disk shapes. The number of facets is used for the slices and stacks of the quadrics. By default, quadricFacets=10. Set the number higher to draw smoother quadrics or lower if you are concerned about performance.
property={quaternary, mode }
Used to match a scatter plot quaternary property.
mode =0:Disables quaternary interpretation.
mode =1:Interprets the triplet source as fractional values of 3 out of 4 mixture components. The internal scaling involves the following transformation for fractional components a,b,c:
d = 1.0-a-b-c
x = ((a-0.25)+0.5*(b-0.25)+0.5*(d-0.25))/0.8165
y = ((b-0.25)+(d-0.25)/3)/0.9428
z = d-0.25
You can create a frame corresponding to the tetrahedron or its vertices by transforming the points corresponding to the triplets {{1,0,0},{0,1,0},{0,0,1},{0,0,0}}. The results are the following XYZ triplets:
0.61237 -0.353557 -0.25
0 0.707114 -0.25
-0.61237 -0.353557 -0.25
0 0 0.75
property={rotateFirst, mode }
Specifies the order of rotate and scale operations.
mode =0:First scale the marker and then rotate.
mode =1:First rotate the marker and then scale.
This property is useful when scaling is not isotropic.
property={rotationType, type }
Specifies how markers are rotated.
type =0:No rotation.
type =1:Rotation specified by the rotationWave property.
property={rotationWave, wave }
Specifies the 2D Mx4 rotation wave for the markers. For each marker the rotation wave has a corresponding row of data containing four entries in this order: the angle in degrees, the rotation axis components in the X, Y, and Z directions.
property={scatterColorType, type }
Specifies the type of marker coloring:
type =0:Constant color. Use the color property to specify the color of all markers.
type =1:Color wave. Use the colorWave property to specify the color wave.
type =2:No color. Gizmo uses the last color selected in the drawing environment.
type =3:Color table. Use markerCTab to specify the color table.
property={shape, val }
Specifies the marker shape. val is one of the following:
1:Point
2:Sphere
3:Cylinder
4:Disk
5:Box
6:Axis object
7:Any other object in the object list.
Not valid for use with markerType=1.
8:Text. This is not valid for use with markerType=1.
9:Cone
10:Double Cone
11:Cone and Disk
12:Ring
13:Double Ring
14:Sphere shell
15:Cylinder shell
16:Cone shell
property={size, val }
Specifies the marker size. val is a scalar value relative to the axis coordinate system as set by Gizmo→Axis Range. See also Gizmo Dimensions.
property={size, type }
Specifies how markers are sized:
type =0:Constant size. Use the size property to specify a uniform marker size.
type =1:Size wave. Use the sizeWave property to identify the wave.
property={sizeWave, wave }
wave is a 2D 3 column wave specifying the marker size for each scatter point. The three columns contain the scaling factors in the X, Y and Z directions respectively.
A size of 1 corresponds to a sphere that occupies most of the display volume. Typically, scatter objects are best represented by significantly smaller values.
property={srcWave, wave }
wave identifies the triplet wave describing the X, Y and Z coordinates for each point in the scatter plot.
property={textWave, wave }
wave identifies wave containing the text to display for each marker when shape=8. The wave must have one row per marker. For practical reasons each text wave point should contain no more than a few characters.
property={typeWave, wave }
wave identifies a 1D wave specifying the integer marker type for each corresponding marker. See the shape property for available marker types and values. typeWave should contain the same number of points as in the scatter wave. There is no error if typeWave is longer.

ModifyGizmo for 3D Bar Chart Objects

The syntax for modifying a Gizmo 3D bar chart object is:

ModifyGizmo modifyObject=objName, objectType=bar3D, property={propertyName,data}

For more information also see 3D Bar Plots.

Keywords

property={calcNormals, enable }
Enables (enable =1) or disables (enable =0) the calculation of normals for the object.
Normals are required for lighting/shading and smoothing effects. Calculation of normals takes graphics resources so it should be turned off unless it is needed.
property={colorType, type }
Specifies the type of grid line coloring:
type =0:No color. Gizmo uses the last color selected in the drawing environment.
type =1:Constant color. Use colorValue to specify the color.
type =2:Color wave. Use colorWave to specify the color wave.
property={colorValue, colorNum, R, G, B, A }
Set colorNum to 0; other values are reserved. The remaining components are in the range [0,1]. This color is used when colorType=1 for all bars.
property={colorWave, wave }
wave is a 2D wave containing RGBA values in the range [0,1] specifying the color of each bar.
The dimensions of the color wave depends on the number of bars and on srcMode. When drawing a basic 3D bar chart (srcMode=0) the color wave is a 4-layer wave with the same number of rows and columns as srcWave. The layers of colorWave contain the color R, G, B, and A components respectively.
When drawing a refined 3D bar chart (srcMode=1) the color wave is a 4 column 2D wave where the columns contain the R, G, B, and A color components and the rows correspond to the bars (rows of srcWave).
property={srcMode, mode }
mode =0:Basic 3D bar chart
mode =1:Refined 3D bar chart
property={srcWave, wave }
wave identifies the source wave for the 3D bar chart chart.
When srcMode=0 wave is a 2D numeric wave containing non-negative entries that represent bar heights.
When srcMode=1 wave is a 6-column numeric wave with columns defined as follows:
Column 0:X center of the bar.
Column 1:Y center of the bar.
Column 2:Lower Z value.
Column 3:Upper Z value.
Column 4:Width of the bar in the X direction.
Column 5:Width of the bar in the Y direction.
property={xBarWidth, width }
When using basic mode (srcMode=0) this value determines the X direction width of all bars. width is a positive value.
property={yBarWidth, width }
When using basic mode (srcMode=0) this value determines the Y direction width of all bars. width is a positive value.

ModifyGizmo for Image Objects

The syntax for modifying a Gizmo image object is:

ModifyGizmo modifyObject=objName, objectType=image, property={propertyName,data}

For more information also see Gizmo Image Plots.

Keywords

property={alpha, alpha }
Sets the alpha component for the whole image.
alpha is an alpha value the range [0,1]. For more information see Transparency and Translucency.
property={alphaType, type }
Specifies how alpha is determined for the image:
type =1:Automatically assigned alpha.
type =2:Single value alpha for the whole image as specified by the alpha property.
type =3:Alpha provided by srcWave.
For more information see Transparency and Translucency.
property={calcNormals, enable }
Enables (enable =1) or disables (enable =0) the calculation of normals for the object.
Normals are required for lighting/shading and smoothing effects. Calculation of normals takes graphics resources so it should be turned off unless it is needed.
property={dataMatch, mode}
Rotates the image to match the display of numeric data objects (e.g., surface, path, scatter objects):
mode =0:The image is subject to user-specified rotation.
mode =1:The image is rotated to match data orientation (default).
property={orientation, type }
Sets the orientation of the image:
type =1:The image is displayed in the XY plane.
type =2:The image is displayed in the YZ plane.
type =3:The image is displayed in the ZX plane.
property={rotation, angle , axisX , axisY , axisZ }
Sets the rotation of the image.
angle is in degrees.
axisX , axisY , axisZ are normalized components of the vector about which the rotation is to be performed.
property={rotationType, type }
Enables or disables rotation of the image.
type =0:Rotation is disabled
type =1:Rotation is enabled
property={scale, scaleX , scaleY , scaleZ }
Sets the scaling of the image in the X, Y and Z directions.
property={scaleType, type }
Enables or disables scaling of the image.
type =0:Scaling is disabled
type =1:Scaling is enabled
property={srcWave, wave }
Specifies the source wave for the image. The wave is a 3D unsigned-byte numeric wave and can have 3 layers for RGB or 4 layers for RGBA.
property={translate, tX , tY , tZ }
Sets the translation of the image in the X, Y and Z directions relative to the origin. The parameters are translation components in +/-1 display volume units.
property={translationType, type }
Enables or disables translation of the image.
type =0:Translation is disabled
type =1:Translation is enabled

ModifyGizmo for Axis Objects

The syntax for modifying a Gizmo axis object is:

ModifyGizmo modifyObject=objName, objectType=axes, property={axisNumber,propertyName,data}

For more information also see Gizmo Axis and Axis Cue Objects.

The property keyword for axis objects is different from other objects. It starts with an axis number that identifies the axis or grid to be modified. This axis number precedes the property name. For example:

ModifyGizmo ModifyObject=axes0, property={-1,axisColor,0,0,0,1}

In this example, the axis number -1 indicates that the axisColor property modification applies to all axes.

This table lists the axes and their corresponding axis numbers:

AxisAxis Number
Any custom axis0
All axes-1
X00
X19
X210
X311
Y01
Y16
Y27
Y38
Z02
Z13
Z24
Z35

For grid-related properties, the property keyword starts with a grid number:

Grid PlaneGrid Number
All grids-1
XY Plane min Z0
XY Plane max Z1
XZ Plane min Y2
XZ Plane max Y3
YZ Plane min X4
YZ Plane max X5

Keywords

property={axisNumber, autoTickLength, mode}
mode=0:Tick mark lengths are determined by the userTickLength property described below.
mode=1:Tick mark lengths are determined automatically (default).
This property was added in Igor Pro 9.00.
property={axisNumber, axisColor, R, G, B, A }
R, G, B, and A specify the axis line color.
property={axisNumber, axisLabel, mode }
mode =0:Hide axis label.
mode =1:Show axis label.
property={axisNumber, axisLabelCenter, center }
center is a single number designating the offset of the label in the direction of text progression. The label is drawn centered by default.
property={axisNumber, axisLabelDistance, distance }
distance a single value that is added to the perpendicular distance between the axis and the label. distance is in +/-1 display volume units.
property={axisNumber, axisLabelFont, fontNameStr }
fontNameStr is the name of a font, such as "Arial", to use to draw the axis label.
property={axisNumber, axisLabelFlip, flip }
Determines if the Z0, Z1, Z2 or Z3 axes only are flipped. The flip is a 180 degree rotation about an axis pointing along the height of the first character.
flip =0:Don't flip the axis label.
flip =1:Flip the axis label.
property={axisNumber, axisLabelRGB, R, G, B }
R, G, B values specifying the axis label color. Values are in the range of [0,1] and alpha is assumed 1.
property={axisNumber, axisLabelRGBA, R, G, B, A }
R, G, B, and A specify the axis label color. Values are in the range of [0,1].
property={axisNumber, axisLabelScale, scale } (deprecated)
scale is a scale factor for drawing the axis label.
This property is deprecated.
property={axisNumber, axisLabelTilt, tilt }
tilt is the tilt angle in degrees for rotating the label about the direction of text progression.
property={axisNumber, axisLabelText, text }
text is the axis label text, limited to 255 bytes. No label is drawn until this property is specified.
property={axisNumber, axisMinValue, value }
value specifies the scalar value for the start of a custom axis. If tick mark labels are drawn they use the range [axisMinValue,axisMaxValue].
property={axisNumber, axisMaxValue, value }
value specifies the scalar value for the end of a custom axis. If tick mark labels are drawn they use the range [axisMinValue,axisMaxValue].
property={axisNumber, axisMode, mode } (deprecated)
mode =0:Data object axes.
mode =1:Drawing non-data objects.
This property is deprecated.
property={axisNumber, axisRange, x0, y0, z0, x1, y1, z1 }
Specifies the XYZ vertices of a custom axis in +/-1 display volume coordinates.
property={axisNumber, axisScale, scale }
Specifies the axis scaling, which is 1 by default. Any other value is equivalent to a uniform scaling operation using scale in all dimensions. This affects both the axis sizes and the locations of the tick marks and tick mark labels.
property={axisNumber, axisScalingMode, value }
Single scalar value that controls the maximum extent of the box frame. By default it is 1, but smaller values may be useful if you are just plotting drawing objects, not wave-based data objects.
property={axisNumber, axisType, constant }
constant identifies each axis and the role that it has in the axis object. This may affect other features such as grids or planes.
To make an axis invisible you, use the visible property.
Supported axis types are:
Custom axis:0x00100000
Triplet axes:0x00200000
Box axes:0x00400000
For triplet and box axes the axisType is OR'ed with (1<< axisNumber). For example, to define a triplet axis object use:
property={0,axisType,2097153}
property={1,axisType,2097154}
property={2,axisType,2097156}
The axis constants for triplet axes are:
X0:2097153
Y0:2097154
Z0:2097156
The axis constants for box axes are:
X0:4194305
X1:4194816
X2:4195328
X3:4196352
Y0:4194306
Y1:4194368
Y2:4194432
Y3:4194560
Z0:4194308
Z1:4194312
Z2:4194320
Z3:4194336
property={axisNumber, canonicalTick, value }
Specifies the axis value at which the canonical tick mark is drawn in manual tick marks mode. Starting from this value, tick marks are drawn in both directions at distances specified by canonicalIncrement. If value is outside the range of the axis then tick marks are not drawn.
property={axisNumber, canonicalIncrement, increment }
Specifies the tick mark increment in manual tick marks mode. If the increment is too small you could exceed the maximum number of tick marks.
property={axisNumber, canonicalPower, power }
Draws tick marks with a factored 10power.
property={axisNumber, canonicalDigits, digits }
digits is an integer specifying number of digits used after the decimal point when labeling manual tick marks.
property={axisNumber, fontName, fontNameStr }
fontNameStr is the name of a font, such as "Arial", to use to draw tick mark labels.
property={axisNumber, fontScaleFactor, scale }
Controls the font size of tick mark labels. This is equivalent to using the scale operation prior to drawing the text.
property={gridPlaneNumber, gridLinesColor, R, G, B, A }
R, G, B, and A specify the color of grid lines. Values are in the range of [0,1].
property={gridPlaneNumber, gridLineWidth, width } (deprecated)
Specifies the width of the line used to drawing all grid lines for the specified plane.
This property is deprecated.
property={gridPlaneNumber, gridPlaneColor, R, G, B, A }
R, G, B, and A specify the color of painted grid plane. Values are in the range of [0,1].
property={gridPlaneNumber, gridPrimaryCount, count }
Specifies the number of grid lines in the primary direction if not attached to tick marks.
property={gridPlaneNumber, gridSecondaryCount, count }
Specifies the number of grid lines in the secondary direction if not attached to tick marks.
property={gridPlaneNumber, gridType, type }
type is a bitwise setting. type =0 gives no grid.
Bit 0:Painted plane
Bit 1:Primary grid lines
Bit 2:Primary grids matching tick marks
Bit 3:Secondary grids
Bit 4:Secondary grids matching tick marks
Bit 5:Allow drawing lines
See Setting Bit Parameters for details about bit settings.
property={axisNumber, highTrip, trip }
trip is the axis value above which tick mark labels are represented in engineering notation.
property={axisNumber, labelBillboarding, mode }
Enables or disables the billboarding of an axis label. Billboarding is an attempt to draw the label facing the viewer. It is on by default.
mode =0:Disables billboarding
mode =1:Enables billboarding
property={axisNumber, labelColor, R, G, B, A }
Specifies tick mark label color. Values are in the range of [0,1].
property={axisNumber, labelOffset, x, y, z }
Offsets tick mark labels. x, y, and z are in +/-1 display volume coordinates. The effect is the same as adding a translate operation before drawing each tick mark label.
property={axisNumber, labelRotationAxis, axisX , axisY , axisZ } (deprecated)
axisX , axisY , axisZ are normalized components of the vector about which tick mark label rotation is to be performed.
This property is deprecated.
property={axisNumber, labelRotationAngle, angle } (deprecated)
angle is the angle in degrees of tick mark label rotation. Positive angles give counterclockwise rotation. You must define the rotation axis before using this property.
This property is deprecated.
property={axisNumber, lineWidth, width } (deprecated)
width is the axis line width in points.
This property is deprecated.
property={axisNumber, lowTrip, trip }
trip is the axis value below which tick mark labels are represented in engineering notation.
property={axisNumber, numTicks, num }
num is the requested number of tick marks in auto mode. The requested value may not be attained if the resulting intervals do not fall on "nice" limits.
property={axisNumber, ticks, mode }
Controls the display of tick marks and tick mark labels.
mode =0:Disable tick marks
mode =1:Enable tick marks
mode =2:Enable tick mark labels
mode =3:Enable both tick marks and tick mark labels
property={axisNumber, tickEnable, startValue, endValue }
Sets the axis range within which tick mark labels are drawn. Tick marks outside the specified range are not drawn.
property={axisNumber, tickScaling, scale }
Specifies the axis scaling for tick mark length, which is a function of the maximum dimension of the plot. Default tickmark length is 0.02.
property={axisNumber, tickLabelWave, wave }
wave is a text wave containing one column of entries that provide tick mark labels that are drawn at positions specified by tickLevelWave. Avoid long strings so that labels do not overlap.
property={axisNumber, tickLevelWave, wave }
wave is a numeric wave containing values at which you want to draw tick marks. The number of entries in this wave must match the number of entries in the tickLabelWave. Gizmo draws the tick marks for levels between the minimum and maximum values of the data along the particular axis. You must also set tickmarkType=3, described below.
property={axisNumber, tickMarkType, type }
Specifies how tick mark positions are determined.
type =0:Default. Automatic tick marks.
type =1:Manual tick marks using canonical tick mark values.
type =3:Manual tick marks specified by tickLevelWave and tickLabelWave.
property={axisNumber, userTickLength, dx, dy, dz}
Specifies the 3D size of the tick marks in scaled units (for +-1 box). These values are used only when the autoTickLength is set to 0.
This property was added in Igor Pro 9.00.
property={axisNumber, visible, mode }
mode =0:Hides the axis.
mode =1:Shows the axis.
property={-1, volumeGrids, mode }
Controls the drawing of volume grids. Volume grids are equally-spaced lines through the volume parallel to the X, Y or Z axis.
mode is a bitwise setting. mode =0 gives no grid.
Bit 0:Draw volume grid parallel to the X axis.
Bit 1:Draw volume grid parallel to the Y axis.
Bit 2:Draw volume grid parallel to the Z axis.
See Setting Bit Parameters for details about bit settings.
Unlike exterior grid lines (see gridType), volume grids are hard wired to the locations of tick marks on the corresponding axes.
Use -1 for the axis number parameter.
property={axisNumber, volumeGridsRGBA, R, G, B, A }
Controls the color of volume grids.
R, G, B, and A specify the grid line color. Values are in the range of [0,1].
axisNumber is a bitwise setting.
Bit 0:Apply color to the X axis.
Bit 1:Apply color to the Y axis.
Bit 2:Apply color to the Z axis.
See Setting Bit Parameters for details about bit settings.
property={axisNumber, volumeGridsLineWidth, width } (deprecated)
width is the volume grid line width in points.
axisNumber is a bitwise setting.
Bit 0:Apply width to the X axis.
Bit 1:Apply width to the Y axis.
Bit 2:Apply width to the Z axis.
See Setting Bit Parameters for details about bit settings.
This property is deprecated.

ModifyGizmo for Free Axis Cue Objects

The syntax for modifying a Gizmo free axis cue object is:

ModifyGizmo modifyObject=objName, objectType=freeAxisCue, property={propertyName,data}

For more information also see Gizmo Axis and Axis Cue Objects.

Keywords

property={colorType, type }
Specifies the type of grid line coloring:
type =0:No color. Gizmo uses the last color selected in the drawing environment.
type =1:Default. The axes are drawn using default colors.
property={labels, val }val is a binary field flag that controls the display of the X, Y and Z labels on the corresponding axes.
vallabels
0none
1X-axis label
2Y-axis label
4Z-axis label
7X, Y and Z labels (default)
property={offset, x, y, z }
Offsets the origin of the free axis cue relative to the origin of the display volume. x, y, and z are in +/-1 display volume coordinates.
property={scale, val }
Specifies a scaling factor for isotropic scaling.

ModifyGizmo for Line Objects

The syntax for modifying a Gizmo line object is:

ModifyGizmo modifyObject=objName, objectType=line, property={propertyName,data}

For more information also see Gizmo Drawing Objects[Line Objects].

Keywords

property={arrowMode, mode }
mode is a bitwise setting that controls properties of the line.
Bit 0:Arrowhead at the start point.
Bit 1:Arrowhead at the end point.
Bit 2:Arrowhead at the center of the segment.
Bit 3:Reversed arrowhead at the center of the segment.
Bit 4:Line drawn as a cylinder.
See Setting Bit Parameters for details about bit settings.
property={colorType, type }
Specifies the type of line coloring:
type =0:No color. Gizmo uses the last color selected in the drawing environment.
type =1:Constant color. Use colorValue to specify the color.
type =2:Full color specified by two sets of RGBA values using the colorValue keyword.
property={colorValue, vertex, R, G, B, A }
Specifies the line color.
vertex is 0 for the start of the line, 1 for the end of the line.
If colorType=1 then setting vertex 0 sets the color for the entire object. If colorType=2 then you can set each vertex independently.
R, G, B, and A specify the vertex color. Values are in the range of [0,1].
property={cylinderEndRadius, diameter }
Specifies the ending diameter when drawing a line as a cylinder (arrowMode=16). diameter is in +/-1 display volume units. The default is 0.03.
property={cylinderStartRadius, diameter }
Specifies the starting diameter when drawing a line as a cylinder (arrowMode=16). diameter is in +/-1 display volume units. The default is 0.03.
property={endArrowBase, diameter }
Specifies the diameter of the base of an end arrow expressed in +/-1 display volume units. The default is 0.04.
property={endArrowHeight, height }
Specifies the height of an end arrow expressed in +/-1 display volume units. The default is 0.06.
The arrow cone is set so that the apex position is at the end of the line object and the base is drawn at arrow-height units towards the start of the line.
property={midArrowBase, diameter }
Specifies the diameter of the base of a midpoint arrow expressed in +/-1 display volume units. The default is 0.04.
property={midArrowHeight, height }
Specifies the height of a midpoint arrow expressed in +/-1 display volume units.
property={startArrowBase, diameter }
Specifies the diameter of the base of a start arrow expressed in +/-1 display volume units. The default is 0.04.
property={startArrowHeight, height }
Specifies the height of a start arrow expressed in +/-1 display volume units from the apex (at the start point of the line) in the direction of the end point.
property={vertex, xA, yA, zA, xB, yB, zB }
Specifies the start and end vertices of the line expressed in +/-1 XYZ display volume coordinates.

ModifyGizmo for Triangle Objects

The syntax for modifying a Gizmo triangle object is:

ModifyGizmo modifyObject=objName, objectType=triangle, property={propertyName,data}

For more information also see Gizmo Drawing Objects[Triangle Objects].

Keywords

property={calcNormals, enable }
Enables (enable =1) or disables (enable =0) the calculation of normals for the object.
Normals are required for lighting/shading and smoothing effects. Calculation of normals takes graphics resources so it should be turned off unless it is needed.
property={clipped, mode }
Determines if the triangle object is clipped by the global clipping planes.
mode =0:Not clipped
mode =1:Clipped
By default clipping is on. For more information see Gizmo Clipping.
property={colorType, type }
Specifies the type of triangle coloring:
type =0:No color. Gizmo uses the last color selected in the drawing environment.
type =1:Constant color. Use colorValue to specify the color.
type =2:Full color specified by three sets of RGBA values using the colorValue keyword.
property={colorValue, vertex, R, G, B, A }
Specifies the triangle color.
vertex is 0, 1 or 2.
If colorType=1 then setting vertex 0 sets the color for the entire object. If colorType=2 then you can set each vertex independently.
R, G, B, and A specify the vertex color. Values are in the range of [0,1].
property={vertex, xA, yA, zA, xB, yB, zB, xC, yC, zC }
Specifies the three vertices of the triangle expressed in +/-1 XYZ display volume coordinates.

ModifyGizmo for Quad Objects

The syntax for modifying a Gizmo quad object is:

ModifyGizmo modifyObject=objName, objectType=quad, property={propertyName,data}

For more information also see Gizmo Drawing Objects[Quad Objects].

Keywords

property={calcNormals, enable }
Enables (enable =1) or disables (enable =0) the calculation of normals for the object.
Normals are required for lighting/shading and smoothing effects. Calculation of normals takes graphics resources so it should be turned off unless it is needed.
property={clipped, mode }
Determines if the quad object is clipped by the global clipping planes.
mode =0:Not clipped
mode =1:Clipped
By default clipping is on. For more information see Gizmo Clipping.
property={colorType, type }
Specifies the type of quad coloring:
type =0:No color. Gizmo uses the last color selected in the drawing environment.
type =1:Constant color. Use colorValue to specify the color.
type =2:Full color specified by four sets of RGBA values using the colorValue keyword.
property={colorValue, vertex, R, G, B, A }
Specifies the quad color.
vertex is 0, 1, 2 or 3.
If colorType=1 then setting vertex 0 sets the color for the entire object. If colorType=2 then you can set each vertex independently.
R, G, B, and A specify the vertex color. Values are in the range of [0,1].
property={vertex, xA, yA, zA, xB, yB, zB, xC, yC, zC, xD, yD, zD }
Specifies the four vertices of the quad expressed in +/-1 XYZ display volume coordinates.

ModifyGizmo for Box Objects

The syntax for modifying a Gizmo box object is:

ModifyGizmo modifyObject=objName, objectType=box, property={propertyName,data}

For more information also see Gizmo Drawing Objects[Box Objects].

Keywords

property={calcNormals, enable }
Enables (enable =1) or disables (enable =0) the calculation of normals for the object.
Normals are required for lighting/shading and smoothing effects. Calculation of normals takes graphics resources so it should be turned off unless it is needed.
property={clipped, mode }
Determines if the box object is clipped by the global clipping planes.
mode =0:Not clipped
mode =1:Clipped
By default clipping is on. For more information see Gizmo Clipping.
property={colorType, type }
Specifies the type of box coloring:
type =0:No color. Gizmo uses the last color selected in the drawing environment.
type =1:Constant color. Use colorValue to specify the color.
type =2:Full color specified by 24 sets of RGBA values using the colorValue keyword.
property={vertex, xA, yA, zA, ... xX, yX, zX }
Specifies the 24 vertices of the box expressed in +/-1 XYZ display volume coordinates.
property={colorValue, vertex, R, G, B, A }
Specifies the box color.
vertex is a number between 0 and 23.
If colorType=1 then setting vertex 0 sets the color for the entire object. If colorType=2 then you can set each vertex independently.
R, G, B, and A specify the vertex color. Values are in the range of [0,1].
property={faceColor, faceNum, R, G, B, A }
Specifies the color of a specific face.
faceNum is a number between 0 and 5.
Note that colorType must be set to 2 in order to display the box in more than one color.
R, G, B, and A specify the vertex color. Values are in the range of [0,1].
property={dimensions, length, width, height }
Specifies the box dimensions in +/-1 XYZ display volume coordinates.

ModifyGizmo for Sphere Objects

The syntax for modifying a Gizmo sphere object is:

ModifyGizmo modifyObject=objName, objectType=sphere, property={propertyName,data}

For more information also see Gizmo Drawing Objects[Sphere Objects].

Keywords

property={color, R, G, B, A }
R, G, B, and A specify the sphere color if colorType=1. Values are in the range of [0,1].
property={colorType, type }
Specifies the type of sphere coloring:
type =0:No color. Gizmo uses the last color selected in the drawing environment.
type =1:Constant color. Use color to specify the color.
property={drawStyle, style }
Specifies the style of sphere drawing:
style =100010:Draw a point at every vertex.
style =100011:Draw lines between vertices.
style =100012:Fill the polygons (default).
style =100013:Draw silhouette (deprecated).
property={normals, mode }
Controls the calculation of normals for the object.
mode =100000:Compute smooth normals (default).
mode =100001:Compute flat normals.
mode =100002:Don't compute normals.
Normals are required for lighting/shading and smoothing effects. Calculation of normals takes graphics resources so it should be turned off unless it is needed.
property={orientation, type }
Sets the orientation of the normals:
type =100020:Normals point outside (default).
type =100021:Normals point inside.
property={radius, val }
radius is a positive number specifying the sphere radius.
property={slices, numSlices }
numSlices is a positive number specifying the number of longitudinal divisions. A higher number of slices and stacks produces a smoother sphere.
property={stacks, numStacks }
numStacks is a positive number specifying the number of latitudinal divisions. A higher number of slices and stacks produces a smoother sphere.
property={useGlobalAttributes, mode }
mode =0:Disable global attributes.
mode =1:Enable global attributes (default).
A sphere object has internal drawStyle, normals, and orientation attributes. To use these internal attributes you must disable global attributes.

ModifyGizmo for Cylinder Objects

The syntax for modifying a Gizmo cylinder object is:

ModifyGizmo modifyObject=objName, objectType=cylinder, property={propertyName,data}

For more information also see Gizmo Drawing Objects[Cylinder Objects].

Keywords

property={baseRadius, radius }
radius is a positive number specifying the radius of the cylinder's base in +/-1 display volume units. You can create a cone by specifying different values for baseRadius and topRadius.
property={color, R, G, B, A }
R, G, B, and A specify the cylinder color if colorType=1. Values are in the range of [0,1].
property={colorType, type }
Specifies the type of cylinder coloring:
type =0:No color. Gizmo uses the last color selected in the drawing environment.
type =1:Constant color. Use color to specify the color.
property={drawStyle, style }
Specifies the style of cylinder drawing:
style =100010:Draw a point at every vertex.
style =100011:Draw lines between vertices.
style =100012:Fill the polygons (default).
style =100013:Draw silhouette (deprecated).
property={colorType, height }
Specifies the height of the cylinder in +/-1 display volume units.
property={normals, mode }
Controls the calculation of normals for the object.
mode =100000:Compute smooth normals (default).
mode =100001:Compute flat normals.
mode =100002:Don't compute normals.
Normals are required for lighting/shading and smoothing effects. Calculation of normals takes graphics resources so it should be turned off unless it is needed.
property={orientation, type }
Sets the orientation of the normals:
type =100020:Normals point outside (default).
type =100021:Normals point inside.
property={slices, numSlices }
numSlices is a positive number specifying the number of divisions around the cylinder. A higher number of slices and stacks produces a smoother cylinder.
property={stacks, numStacks }
numStacks is a positive number specifying the number of divisions along the cylinder's height. A higher number of slices and stacks produces a smoother cylinder.
property={topRadius, radius }
radius is a positive number specifying the radius of the cylinder's top in +/-1 display volume units. You can create a cone by specifying different values for baseRadius and topRadius.
property={useGlobalAttributes, mode }
mode =0:Disable global attributes.
mode =1:Enable global attributes (default).
A cylinder object has internal drawStyle, normals, and orientation attributes. To use these internal attributes you must disable global attributes.

ModifyGizmo for Disk Objects

The syntax for modifying a Gizmo disk object is:

ModifyGizmo modifyObject=objName, objectType=disk, property={propertyName,data}

For more information also see Gizmo Drawing Objects[Disk Objects].

Keywords

property={color, R, G, B, A }
R, G, B, and A specify the disk color if colorType=1. Values are in the range of [0,1].
property={colorType, type }
Specifies the type of disk coloring:
type =0:No color. Gizmo uses the last color selected in the drawing environment.
type =1:Constant color. Use color to specify the color.
property={drawStyle, style }
Specifies the style of disk drawing:
style =100010:Draw a point at every vertex.
style =100011:Draw lines between vertices.
style =100012:Fill the polygons (default).
style =100013:Draw silhouette (deprecated).
property={innerRadius, radius }
radius is a positive number, less than outerRadius, specifying the radius of central hole in disk in +/-1 display volume units. Use zero for a disk with no hole.
property={normals, mode }
Controls the calculation of normals for the object.
mode =100000:Compute smooth normals (default).
mode =100001:Compute flat normals.
mode =100002:Don't compute normals.
Normals are required for lighting/shading and smoothing effects. Calculation of normals takes graphics resources so it should be turned off unless it is needed.
property={orientation, type }
Sets the orientation of the normals:
type =100020:Normals point outside (default).
type =100021:Normals point inside.
property={outerRadius, radius }
radius is a positive number, greater than innerRadius, specifying the radius of disk rim in +/-1 display volume units.
property={slices, numSlices }
numSlices is a positive number specifying the number of longitudinal divisions around the disk. A higher number of slices produces a smoother disk.
property={startAngle, angle }
angle is the starting angle of the disk in the range 0 to 360. It is relative to the Y axis specified in degrees clockwise.
property={sweepAngle, angle }
angle is the angular extent of the disk in the range 0 to 360. It is specified in degrees clockwise.
property={rings, numRings }
numRings is a positive number specifying the number of latitudinal divisions in the disk. A higher number of rings produces a smoother disk.
property={useGlobalAttributes, mode }
mode =0:Disable global attributes.
mode =1:Enable global attributes (default).
A disk object has internal drawStyle, normals, and orientation attributes. To use these internal attributes you must disable global attributes.

ModifyGizmo for Tetrahedron Objects

The syntax for modifying a Gizmo tetrahedron object is:

ModifyGizmo modifyObject=objName, objectType=tetrahedron, property={propertyName,data}

For more information also see Gizmo Drawing Objects[Tetrahedron Objects].

Keywords

property={calcNormals, enable }
Enables (enable =1) or disables (enable =0) the calculation of normals for the object.
Normals are required for lighting/shading and smoothing effects. Calculation of normals takes graphics resources so it should be turned off unless it is needed.
property={clipped, mode }
Determines if the tetrahedron object is clipped by the global clipping planes.
mode =0:Not clipped
mode =1:Clipped
By default clipping is on. For more information see Gizmo Clipping.
property={colorType, type }
Specifies the type of tetrahedron line coloring:
type =0:No color. Gizmo uses the last color selected in the drawing environment.
type =1:Constant color specified by wireRGBA keyword.
property={RGBA0, R, G, B, A }
Specifies the color for vertex 0.
R, G, B, and A specify the vertex color. Values are in the range of [0,1].
property={RGBA1, R, G, B, A }
Specifies the color for vertex 1.
R, G, B, A values are in the range of [0,1].
property={RGBA2, R, G, B, A }
Specifies the color for vertex 2.
R, G, B, A values are in the range of [0,1].
property={RGBA3, R, G, B, A }
Specifies the color for vertex 3.
R, G, B, A values are in the range of [0,1].
property={sphereRGBA, R, G, B, A }
Specifies the color for spheres drawn at the vertices.
R, G, B, A values are in the range of [0,1].
property={style, mode }
Controls the drawing style for the tetrahedron.
mode is a bitwise setting.
Bit 0:Draw wires (lines) between vertices.
Bit 1:Fill the triangle faces.
Bit 2:Draw a sphere at each vertex.
See Setting Bit Parameters for details about bit settings.
property={vertex0, x, y, z }
Specifies the X, Y, Z coordinates of vertex 0 using +/-1 display volume coordinates.
property={vertex1, x, y, z }
Specifies the X, Y, Z coordinates of vertex 1 using +/-1 display volume coordinates.
property={vertex2, x, y, z }
Specifies the X, Y, Z coordinates of vertex 2 using +/-1 display volume coordinates.
property={vertex3, x, y, z }
Specifies the X, Y, Z coordinates of vertex 3 using +/-1 display volume coordinates.
property={wireRGBA, R, G, B, A }
Specifies the color for wires (lines) drawn between the vertices.
R, G, B, A values are in the range of [0,1].

ModifyGizmo for Pie Wedge Objects

The syntax for modifying a Gizmo pie wedge object is:

ModifyGizmo modifyObject=objName, objectType=piewedge, property={propertyName,data}

For more information also see Gizmo Drawing Objects[Pie Wedge Objects].

Keywords

property={calcNormals, enable }
Enables (enable =1) or disables (enable =0) the calculation of normals for the object.
Normals are required for lighting/shading and smoothing effects. Calculation of normals takes graphics resources so it should be turned off unless it is needed.
property={clipped, mode }
Determines if the pie wedge object is clipped by the global clipping planes.
mode =0:Not clipped
mode =1:Clipped
By default clipping is on. For more information see Gizmo Clipping.
property={colorType, type }
Specifies the type of pie wedge coloring:
type =0:No color. Gizmo uses the last color selected in the drawing environment.
type =1:Constant color. The top, bottom and sides are drawing using the color set by topRGBA.
type =2:Separate colors. The top and bottom are drawn using the color set by topRGBA. The sides are drawn using the color set by sideRGBA.
property={endAngle, angle }
angle is the angle at which the wedge ends. It is relative to the positive X axis specified in degrees counter-clockwise.
property={rMax, radius }
radius is the maximum radius for the wedge. The radius is measured in +/-1 display volume units. A full wedge has a maximum radius of 1.
property={rMin, radius }
radius is the minimum radius for the wedge. The radius is measured in +/-1 display volume units. A full wedge has a minimum radius of 0.
property={radialOffset, offset }
offset is a single offset in +/-1 display volume units along the direction of the radius pointing from the origin and bisecting the wedge angle. The radial offset uses the X and Y components of translate (see below) so the two properties are not independent.
property={sideRGBA, R, G, B, A }
R, G, B, and A in the range [0,1] specify the color of the sides of the wedge.
property={slices, numSlices }
numSlices is the number of polygonal wedges between startAngle and endAngle. More slices gives a smoother pie wedge.
property={startAngle, angle }
angle is the angle at which the wedge starts. It is relative to the positive X axis specified in degrees counter-clockwise.
property={topRGBA, R, G, B, A }
R, G, B, and A in the range [0,1] specify the color of the top and bottom of the wedge.
property={translate, tX , tY , tZ }
Sets the translation of the pie wedge in the X, Y and Z directions relative to the origin. The parameters are translation components in +/-1 display volume units. See also radialOffset above.
property={zMax, max }
max is the the Z value of the top of the wedge measured in +/-1 display volume units.
property={zMin, min }
min is the the Z value of the bottom of the wedge measured in +/-1 display volume units.

ModifyGizmo for Light Objects

The syntax for modifying a Gizmo light object is:

ModifyGizmo modifyObject=objName, objectType=light, property={propertyName,data}

For more information also see Gizmo Lights.

Keywords

property={ambient, R, G, B, A }
R, G, B, and A in the range [0,1] specify the color of ambient, direction-independent light components. When adding a single light it is helpful to specify minimum ambient components of {0.2,0.2,0.2,1}.
property={cutoff, angle }
angle is the half-angle of the cone of the spotlight in degrees from 0 to 180. This applies to positional light sources only.
property={constAttenuation, attenuation }
attenuation is the light attenuation factor defined as
1/(Kc +kl * d +Kq * d2)
where Kc is the constant attenuation, Kl is the linear attenuation, Kq is the quadratic attenuation and d is the distance. This applies to positional lights only.
property={diffuse, R, G, B, A }
R, G, B, and A in the range [0,1] specify the color of diffuse components of a light. Diffuse effects depend on the light direction and on the material properties of the surface.
property={direction, x, y, z }
Specifies the X, Y, Z components of a vector specifying the light direction.
property={exponent, exp }
exp is the value of light intensity attenuation. Intensity falloff is given by the cosine of the angle between the direction of the light and the illuminated vertex. The exponent is the power of the cosine in the attenuation factor.
property={linearAttenuation, attenuation }
See constAttenuation. This applies to positional lights only.
property={position, x, y, z, w }
Specifies the position of the light source using homogeneous coordinates. The light source is directional when W=0 and the position is unimportant. See Gizmo Positional Lights for details.
property={quadraticAttenuation, attenuation }
See constAttenuation. This applies to positional lights only.
property={specular, R, G, B, A }
R, G, B, and A in the range [0,1] specify the color of specular components of a light. Specular effects depend both on the direction of the light and on material properties. It is usually difficult to adjust specular components.

ModifyGizmo for Texture Objects

The syntax for modifying a Gizmo texture object is:

ModifyGizmo modifyObject=objName, objectType=texture, property={propertyName,data}

For more information also see Advanced Gizmo Techniques[Texture Objects].

Keywords

property={dim, mode }
Specifies the dimensionality of the texture wave.
mode =0x0DE1:2D texture (default)
mode =0x0DE0:1D texture
property={dataFormat, mode }
Specifies the the format of the pixel data.
mode =0x1903:GL_RED
mode =0x1907:GL_RGB
mode =0x1908:GL_RGBA
property={dataType, type }
Specifies the data type of the texture wave.
type =0:Signed byte
type =1:Unsigned byte
type =2:Signed 16-bit word
type =3:Unsigned 16-bit word
type =4:Signed 32-bit word
type =5:Unsigned 32-bit word
type =6:Single-precision floating point
type =10:Double-precision floating point
property={direction, mode }
Specifies the direction for a 1D texture.
mode =0x2000:GL_S
mode =0x0DE0:GL_T
property={envMode, mode }
Specifies how the texture parameters are interpreted.
mode =0x2100:GL_MODULATE
mode =0x2101:GL_DECAL
mode =0x0BE2:GL_BLEND
mode =0x1E01:GL_REPLACE
property={height, value }
Specifies the height of the source image in pixels. For best performance use a power of 2.
property={magMode, mode }
Sets the texture magnifying filter.
mode =0x2601:GL_LINEAR (default)
mode =0x2600:GL_NEAREST
property={minMode, mode }
Sets the texture minifying filter.
mode =0x2601:GL_LINEAR (default)
mode =0x2600:GL_NEAREST
mode =0x2700:GL_NEAREST_MIPMAP_NEAREST
mode =0x2701:GL_LINEAR_MIPMAP_NEAREST
mode =0x2702:GL_NEAREST_MIPMAP_LINEAR
mode =0x2703:GL_LINEAR_MIPMAP_LINEAR
property={priority, value }
value is a scalar in the range [0,1] that lets you assign priority to a texture object. 0 indicates lowest priority. Textures with priority 1 are most likely to be resident in memory.
property={sCoordinates, p1, p2, p3, p4 }
p1, p2, p3, and p4 control the generation of texture coordinates for the S-direction. For example, if the texture generation function is GL_OBJECT_LINEAR the computed S coordinate is:
s = p1*x + p2*y + p3*z + p4*w
property={sGenMode, mode }
Sets the texture coordinates generation mode for the S-direction.
mode =0x2400:GL_EYE_LINEAR
mode =0x2401:GL_OBJECT_LINEAR
mode =0x2402:GL_SPHERE_MAP
property={srcWave, wave }
Specifies the wave containing the texture information.
IGOR stores images in 3-layer RGB or 4-layer RGBA waves. These are not directly compatible with OpenGL texture formats. Use ImageTransform with the keyword imageToTexture to convert IGOR image waves to texture waves.
property={tCoordinates, p1, p2, p3, p4 }
p1, p2, p3, and p4 control the generation of texture coordinates for the T-direction. For example, if the texture generation function is GL_OBJECT_LINEAR the computed S coordinate is:
t=p1*x + p2*y + p3*z + p4*w
property={tGenMode, mode }
Sets the texture coordinates generation mode for the T-direction.
mode =0x2400:GL_EYE_LINEAR
mode =0x2401:GL_OBJECT_LINEAR
mode =0x2402:GL_SPHERE_MAP
property={width, value }
Specifies the width of the source image in pixels. For best performance use a power of 2.
property={wrapSMode, mode }
Determines how the texture is applied in the S-direction.
mode =0x2901:GL_REPEAT
mode =0x2900:GL_CLAMP
property={wrapTMode, mode }
Determines how the texture is applied in the T-direction.
mode =0x2901:GL_REPEAT
mode =0x2900:GL_CLAMP

ModifyGizmo for Matrix4x4 Objects

The syntax for modifying a Gizmo 4x4 matrix object is:

ModifyGizmo modifyObject=objName, objectType=matrix4x4, property={propertyName,data}

For more information also see Advanced Gizmo Techniques[Matrix4x4 Objects].

Keywords

property={srcWave, wave }wave is a 2D single-precision or double-precision floating point wave with 4 rows and 4 columns.

ModifyGizmo for String Objects

The syntax for modifying a Gizmo string object is:

ModifyGizmo modifyObject=objName, objectType=string, property={propertyName,data}

String objects are deprecated.

For more information also see Gizmo Drawing Objects[String Objects].

Keywords

property={font, fontNameStr}
fontNameStr is the name of a font, such as "Arial", to use to draw the string.
property={size, value}
value is an integer that specifies the font size for the string.
property={string, text}
text is the string text, limited to 255 bytes.

ModifyGizmo for ColorScale Objects

The syntax for modifying a Gizmo colorscale object is:

ModifyGizmo modifyObject=objName, objectType=colorscale, property={propertyName,data}

ColorScale objects are deprecated.

For more information also see Gizmo Drawing Objects[ColorScale Objects].

Keywords

property={alpha, value }
Sets the alpha the alpha value associated with the color table in the range [0,1].
property={axisRGB, R, G, B }
R, G, B values for painting the axis. Values are in the range of [0,1] and alpha is assumed 1.
property={calcNormals, enable }
Enables (enable =1) or disables (enable =0) the calculation of normals for the object.
Normals are required for lighting/shading and smoothing effects. Calculation of normals takes graphics resources so it should be turned off unless it is needed.
property={clipped, mode }
Determines if the colorscale is clipped by the global clipping planes.
mode =0:Not clipped
mode =1:Clipped
By default clipping is on. For more information see Gizmo Clipping.
property={colorTable, name }
name specifies a built-in Igor color table to use for the colorscale colors. For more information see Color Tables in Gizmo.
property={colorWave, wave }
wave is a 2D wave containing RGB or RGBA values in the range [0,1] where each row corresponds to one color. The colorscale is divided into segments representing the total number of rows. There should be more than one valid row.
property={CTABScaling, mode }
mode is a bitwise setting that controls the marker coloring when using a color table.
One and only one bit from bit 0 through 4 must be set. In addition, any of bits 5, 6, 8 or 9 may be set.
Bit 0:From min X to max X
Bit 1:From min Y to max Y
Bit 2:From min Z to max Z
Bit 3:From 0 to max sqrt(X^2+Y^2)
Bit 4:From 0 to max sqrt(X^2+Y^2+Z^2)
Bit 5:Minimum value and color specified
Bit 6:Maximum value and color specified
Bit 7:Not used - set to 0
Bit 8:Color table maps plot-global X range
Bit 9:Color table maps plot-global Y range
See Setting Bit Parameters for details about bit settings.
For more information see Color Tables in Gizmo.
property={drawAxis, mode }
mode =0:Do not draw an axis.
mode =1:Draw an axis.
property={depth, value }
value is the depth of the colorscale bar in +/-1 display volume units. It is set to 0 by default. Positive values produce a 3D cube-like colorscale.
property={dependsOn, objectName }
The colorscale may be independent. Use this keyword if you want to attach it to a particular object for the purposes of obtaining the minimum and maximum values.
property={drawFrame, mode }
mode =0:Do not draw a frame.
mode =1:Draw a frame.
property={frameLineWidth, width }
width is a positive number.
property={inverseCTab, mode }
Specifies if the color table used to draw the colorscale is inverted.
mode =0:Not inverted
mode =1:Inverted
property={maxRGBA, value, R, G, B, A }
Use an unscaled maximum value followed by 4 values for R, G, B, and A in the range [0,1].
property={minRGBA, value, R, G, B, A }
Use an unscaled minimum value followed by 4 values for R, G, B, and A in the range [0,1].
property={mode, mode }
mode =1:The colorscale minimum and maximum values are independent.
mode =2:The colorscale minimum and maximum values depend on a single object.
mode =3:The colorscale minimum and maximum values depend on all data objects.
property={translate, tX, tY, tZ }
Sets the translation of the colorscale in the X, Y and Z directions relative to the origin. The parameters are translation components in +/-1 display volume units.
property={position, x0, y0, z0, x1, y1, z1 }
Specifies the XYZ locations of the start and end points of the colorscale in +/-1 display volume coordinates.
property={rotation, rX, rY, rZ }
Sets the rotation of the colorscale.
rX, rY, rZ are the rotations about the X, Y and Z axes in degrees.
property={scale, sX, sY, sZ }
Sets the scaling of the colorscale.
sX, sY, sZ are the scaling factors in the direction of the axes.
property={tickLength, length }
length is the length of the tick marks in +/-1 display volume units.
property={tickMarks, minValue, incrementValue, numTicks }
minValue, incrementValue, and numTicks specify the locations of tick marks. These are similar to using canonical tick marks on a regular axis.
property={width, value }
value is the width of the colorscale bar in +/-1 display volume units. The default is 0.1.