Igor Pro 6.1 New Features Details

Below are the details of changes made for Igor Pro 6.1 since the last revision of Igor Pro 6.0.

System Requirements

On Macintosh, Igor Pro 6.1 requires Mac OS X 10.4 or later and runs natively on both PowerPC and Intel-based Macintoshes.

On Windows, Igor Pro 6.1 runs under Windows XP, Windows Vista and Windows 7.

Version Compatibility

Igor Pro 6.1 can read files created by all earlier versions of Igor.

If you don't use features new in Igor Pro 6.1, then experiment files that it writes are readable by earlier versions.

Once you use features added in Igor Pro 6.1 and save an experiment file, that file may cause errors if you try to read it in an earlier version of Igor. Just in case you need to go back to an earlier version of Igor, it is a good idea to make backup copies of all your Igor files now.

On Macintosh, the Igor 6.1 switch from PICT to PDF can result in missing graphics when changed notebooks are viewed with Igor 6.0 or earlier. See Notebook Improvements 6.1 for more information.

Some obsolete features of earlier versions of Igor Pro are no longer supported. See Features Removed From Igor Pro 6.1 .

Some behaviors have changed slightly in Igor Pro 6. These changes may affect some existing Igor experiments. See Behavior Changes In Igor Pro 6.1 for details.

Features Removed From Igor Pro 6.1

Macintosh: The obsolete PostScript PICT export format has been removed.

Removed FBinRead and FBinWrite 80 and 96 bit SANE types so /F=6 or 7 is now an error. This is because these types have not been around for 15 years or so. If anyone actually still needs these, they could be resurrected; just let us know.

Guide To Igor Pro 6.1 Improvements

Here are the Igor Pro 6.1 improvements discussed on this page.

New Graphics

Long File Names on Macintosh

User Interface Changes

Behavior Changes

Dialog Improvements

Graphing Improvements

Table Improvements

Page Layout Improvements

Notebook Improvements

Help Improvements

Graphics Export Improvements

Procedure Window Improvements

Gizmo Improvements

Drawing Improvements

Annotation Improvements

Control Improvements

Control Panel Improvements

Analysis Improvements

Statistics Improvements

Matrix Improvements

Curve Fitting Improvements

Image Plot Improvements

Image Processing Improvements

Data Import And Export Improvements

File Command Improvements

Programming Improvements

New and Improved XOPs

Miscellaneous Improvements

New And Improved Example Experiments

New And Improved WaveMetrics Procedure Files

XOP Toolkit Improvements

Bug Fixes

New Graphics

The principal change in 6.1 is the use of more modern graphics code for drawing graphs, tables and page layouts. On Macintosh this involves the radical change of using Apple's Quartz routines rather than the ancient QuickDraw routines . On Windows just slightly more advanced code is used with a small amount of GDI+ instead of GDI .

On Macintosh, the new code does not support exporting graphics in Apple's old PICT format. If you need to export as PICT, you can make Igor use the old graphics code by executing this:

SetIgorOption UseOldGraphics=1

When this command is executed, all graphs and page layout windows are redrawn using the old code. You can also turn the old graphics code on if you have a problem with the new code. In this case, please let us know why you needed to do that so we can address the problem.

New features related to the new graphics code:

Draw text, Draw Pictures and TextBox, Tag and Legend annotations can now be rotated at arbitrary angles. Note: The rotation point for TextBox, Tag and Legend annotations is set by the equivalent anchor point at the nearest multiple of 90 degrees.

Contour labels automatically use arbitrary rotation.

Dashed line drawing is improved.

Fill patterns as used by draw tools and graph fill modes can use a transparent background to support overlap of different patterns. See Drawing Improvements 6.1 and Graphing Improvements 6.1.

There are 12 additional marker types and you can define your own markers. See Graphing Improvements 6.1.

Macintosh only changes:

Text and line drawing is antialiased.

PDF is now the native picture format and replaces the obsolete QuickDraw PICT format.

PDF pictures can be imported from files (using Misc->Pictures) or from the clipboard (using Edit->Paste) and can be placed in graphs, page layouts and formatted notebooks.

EPS pictures placed in graphs and layouts are auto-converted to PDF on the fly and consequently can be used without a postscript printer and are rendered on the screen in high resolution with no need for a preview portion.

The transparency of imported PNG or TIFF pictures is honored except for Igor PDF and EPS export formats.

Long File Names on Macintosh

Igor Pro now supports long file names (up to 255 characters) on Macintosh as well as Windows. Previously it was limited to 31-character file names on Macintosh. Most WaveMetrics XOPs now also support long file names on Macintosh.

The following Igor Pro features will not work with long file names on Mac OS X because Igor calls Apple routines that do not support long file names for these features:

If you are an XOP programmer and want to support long file names on Macintosh you need to recompile your XOP with XOP Toolkit 5.09. As of June, 2009, XOP Toolkit 5.09 is not yet shipping. Send a note to support@wavemetrics.com if you want to get a beta version.

User Interface Changes

Changing a global variable using a control now marks the experiment as being modified.

Checking the Auto-compile menu also compiles the procedures immediately.

On Macintosh, the preference setting for cmd-H (Miscellaneous Settings dialog, Text Editing Settings Category) has been changed. When unchecked, cmd-E becomes "Enter Selection for Find" which is standard on OS X. Also, the find string is placed on the global find pasteboard and read from it on activate. Consequently, the Windows->Send Behind and Windows->Bring to Front are now ctrl-cmd-E and shift-ctrl-cmd-E.

The Edit->Insert Text menu item is now Edit->Insert File. This change was made because you can now insert the contents of a picture file into a formatted text notebook.

Igor now also loads extensions, procedures, and help files from a new "Igor Pro User Files" folder, whose location guarantees write access by the user even if they don't have administrator privileges:

Mac OS X: /Users/<user>/Documents/WaveMetrics/Igor Pro 6 User Files/
Windows: <My Documents>\WaveMetrics\Igor Pro 6 User Files\

You can change this location using the Miscellaneous Settings dialog.

The Igor Pro 6 User Files folder and the standard Igor Pro Folder can be shown in the Finder/Windows Explorer by selecting new items in Igor's Help Menu.

Tip: Holding down the shift key changes one Help menu item so that both folders are opened at the same time, making it easy to drag shortcuts/aliases from the Igor Pro Folder hierarchy into the appropriate User Files folders: Igor Extensions, Igor Help, Igor Procedures, and User Procedures.

For further discussion of Igor Pro User Files, see Special Folders.

Improved error reporting when an error occurs during the saving of a file. A side effect of this change is that if you try to save a file for which you don't have write permission, you will get an error. Previously the save would succeed because the safe-save technique that Igor uses does not write directly to the file. See "How Experiments Are Saved" if you want to know more about this.

Added a server-friendly license activation option so that multi-user license holders don't need to enter the license activation on every computer. You need administrator privileges to install a "server license".

Graph axis mouse wheel support: Vertical wheel expands or contracts the axis range about the mouse location. Press option with the mouse near an axis end to scale that end. Horizontal wheel shifts range up or down and does not depend on mouse position. Both horizontal and vertical work by 20% increments. On Windows, horizontal wheel support requires Vista.

Added mouse wheel support for cursor info panel. Hover over mover area to adjust point index. Hover over name area to switch between traces; hold option (alt) to switch both cursors between traces.

Change in behavior: Option (alt) drag in a graph now offsets only those axes that overlap with the (original) mouse location.

In order to improve speed and responsiveness when editing large control panels, various optimizations have been done involving the use of the tool palette. These involve redrawing only those items that need updating. If you discover any redraw problems such as droppings left behind as an object is dragged around, please let us know how to reproduce it.

Macintosh only: When in New Graphics mode, export modes that previously used QuickDraw PICT format now use PDF instead and the names used in the mode popup menu of the export and save graphics dialog have been changed to match. LoRes PDF replaces PICT, Quartz PDF replaces HiRes PICT and Igor PDF replaces PDF. Note that LoRes PDF is not of much use and just fills the spot that PICT used to occupy. In general, as long as your destination program supports PDF, you should always export as Quartz PDF. (However, if you have a publisher that insists on CMYK, you will need to use Igor PDF.)

Macintosh only: In any text document, right-clicking on a misspelled word will add a Spelling submenu with guesses if any are available. Guesses will be grayed out if document is read-only. If spelling is correct, menu will show "Look Up in Dictionary."

Macintosh only: Enabled Services menu.

The state of the color checkbox in the export graphics dialogs is no longer sticky and not set by preferences. This had caused too much confusion. If you really want to decolorize on export, you will have to uncheck the Color setting each time.

Got rid of the warning about high resolution taking a lot of memory when you export a graphic from the Export Graphics dialog.

The From Target checkbox in the Insert Points and Delete Points dialogs no longer changes the values in the Dimension, First Point and Number of Points controls.

The DelayUpdate feature of page layouts is now a global setting instead of a per-document setting. Previously the DelayUpdate setting was set individually for each document. It was not saved so it reverted to the default state (on) whenever you recreated a page layout. Now it is set globally for all layouts. When you change the DelayUpdate setting using the Misc icon in the page layout tool palette, it is changed for all existing and future layouts instead of just the layout you set.

Procedure windows in independent modules will no longer appear in the Find Text dialog unless you execute:

SetIgorOption IndependentModuleDev=1

Behavior Changes

Changed wave[val]= expr to round val in user functions (as has been done in macros forever).

Macintosh only: When in New Graphics mode, export modes that previously used QuickDraw PICT format now use PDF instead. See the /e flag for SavePICT. The only mode that still uses a QuickDraw format is the bitmap PICT. Some older programs, for example Microsoft Office prior to 2008, may require the old PICT format. In an emergency, you can cause Igor to revert to the old graphics using

SetIgorOption UseOldGraphics=1

To avoid crashing, DoIgorMenu is no longer allowed to invoke the "New Experiment", "Open Experiment", or "Revert Experiment" items in the "File" menu while running in a function or macro (an error is returned). Use the Operation Queue, instead.

When Igor automatically looks through all files in a given folder, such as when it opens help files in the Igor Help Files folder or procedure files in the Igor Procedures folder, it now ignores files whose names start with dot. This is to avoid problems caused by Apple's annoying habit of creating such files on non-HFS server volumes whenever you write a file to the volumes.

Macintosh: Temporary files created by Igor now end with ".noindex" to prevent Spotlight from indexing them and interfering with the save process.

Notebook subwindows in control panels now save their normal ruler (formatted text notebooks) or text formats (plain text notebooks) in recreation macros.

In ThreadSafe user-defined functions, acessing waves now requires a wave reference. Previously, you could execute Duplicate jack, fred and if jack was not a wave reference then a wave by that name would be looked up in the current data folder at run-time. This type of use is often a programming error. Executing SetIgorOption RequireWaveRef= 3 will turn this on for all functions and programmers are encouraged to use this mode and to fix any problems found. The default value for RequireWaveRef is 1 (require wave refs for ThreadSafe) and can be set to zero to revert to the previous behavior. See ThreadSafe Functions.

Dialog Improvements

The Pictures dialog has been revamped and is now also used as subdialog to insert pictures in axis labels or textboxes.

Change to Copy Proc Picture in Pictures dialog: No longer has side effect of converting a picture type other than PNG or JPEG into PNG. If option key is pressed, can create Proc Picture using the native format. But, this should be used carefully if at all since such formats are generally not cross-platform.

Modify Axis dialog now shows fractions of seconds in the manual range limit boxes in the Range tab. The behavior of the axis range settings when you have multiple axes selected has been improved. The Tick Label Rotation and Axis Label Rotation settings on the Label Options tab now support setting arbitrary angles between -90 and 270 degrees.

The Annotation dialog can adjust inter-line spacing with a new Line Spacing dialog which inserts or edits the new \sb and \sa escape codes.

The Save Graphics and Export Graphics dialogs now remember your custom size settings as preferences.

The Save Graphics dialog now offers transparency for PNG file export. On Macintosh, it also offers to suppress smoothing of fonts, which may be required to get text to have transparent background.

The Save Graphics dialog now does not offer custom resolution setting for QuickTime-based formats. This was never supported, and now the dialog is smart enough to know it.

New Graph Dialog: Axis fields in the trace list (more options mode only) are now menus. The space allocated to the various parts of the list is now controlled by draggable dividers in the column titles.

Changed New Notebook dialog to use the entered name as the window name in addition to using it as the file name (if the notebook is later saved to disk).

Graphing Improvements

Log axes now support round to nice values. SetAxis/A/N=2 is same as SetAxis/A/N=1 for now.

Free axes now used to calculate margins if they have a zero offset and all axes on a given plot edge are used in the calculation. Also we now measure rather than estimate axis label size in calculating margins. This is mainly for multi-line axis labels. In case the above causes problems, can turn the new features off or on using:

SetIgorOption NewAxisMargin= <val>	// bit 0 to enable free axes if zero offset, bit 1 to measure axis label rather than estimate 

Extended range of date/time for display (such as axis ticks and tables) and input. Previously had been limited to 1904 to 2040. Now there is no practical limit except on Windows where dates must be greater than Jan 1, 1601.

Added new modes for image display of complex data. See ModifyImage imCmplxMode keyword.

You can now use overlapping fill patterns where one or more is transparent. However this does not work when exported on Windows as EMF or WMF. To use transparent patterns, use the new ModifyGraph keyword patBkgColor. New Graphics mode only.

You can now cause dashed lines to use round endcaps using the new ModifyGraph keyword lOptions. New graphics only.

There are 12 additional marker types (number 51 through 62). New graphics only.

You can now create custom markers. See the SetWindow keyword markerHook. New graphics only.

You can now insert pictures in-line in fancy text (TextBoxes, axis labels etc.) New graphics only. This is used to insert math expressions that would be hard to create using standard Igor escape codes. See the \$PICT$ escape code for TextBox.

Axis labels can now be multi-line.

Textbox "\\W1dd" is a marker with no line stroke.

Added ModifyGraph useBarStrokeRGB=1 and barStrokeRGB=(r,g,b) to draw Histogram Bars with an outline that is a different color than the fill color. Updated Modify Trace Appearance dialog.

Added ModifyGraph zpatNum=zwave to vary the fill pattern for each point in Histogram Bars and Fill To Zero mode. Updated Set as f(z) dialog.

Tags attached to traces can auto-rotate parallel or perpendicular to the attachment point. Contour labels use this feature with new values for the ModifyContour labelHV keyword.

Tags can now specify an arrow pointing back at the tag or in both directions using /L=3 or 4.

Trace Instance numbers are no longer limited to #999. They're now limited to #9999999.

ModifyGraph zColor subtly changes the mapping of f(z) values to colors, similar to the way Igor 6 now maps color table colors for images (see Image Plot Improvements for Igor 6.0 ). This eliminates the problem that only half of the first and last colors are used. Details follow:

Igor versions before 6.1 mapped the values to colors by rounding to the nearest color table index:

index= round((z-zmin)/(zmax-zmin)*(numColors-1))

which meant only half of the first and last colors were used.

In this example the fz wave supplies the z values, zmin is 3, zmax is 17, and the dbZ14 color table has 14 colors, indexed from 0 to 13.

Make/O/N=300 yy=1, fz		// yy = 1
SetScale/I x 0,20,"", yy fz
fz= x				// fz = 0 to 20
Display yy; AppendToGraph/L=fzLeft fz
ModifyGraph zColor(yy)={fz,3,17,dBZ14}

z values greater than zmax (greater than 17) are shown as white:

ModifyGraph zColorMax(yy)=(65535,65535,65535)

z values less than zmin (less than 3) are shown as black:

ModifyGraph zColorMin(yy)=(0,0,0)

Notice that the first and last colors (cyan and magenta) are half the width of the others:

First and last color bar are half as wide as the other color bars

Igor 6.1 maps the f(z) values to colors by truncating to the nearest color table index:

index= floor((z-zmin)/(zmax-zmin)*numColors)

which uses the first and last colors for as many values as the other colors:

First and last color bar are same width as the other color bars

The old way can be re-instated by executing:

SetIgorOption preIgor6ColorScaling=1.
For more about zColor, zColorMax and zColorMin, see Setting Trace Properties from an Auxiliary (Z) Wave.

Table Improvements

Allowed column widths in tables to be odd numbers of pixels since we no longer use dotted lines for grid lines.

Changed the Show Column Info Tags feature to show tags when you hover over the name area of a wave column as well as over the data area.

If you start to change the value of a cell in a table and then change the viewed layer or chunk, the cell entry is accepted before the viewed layer or chunk is changed. Same if you start to change the viewed dimensions while an entry is in progress.

A date is now accepted in a column formated as date/time. Previously you had to enter a date/time.

Restored pre-Igor-6 behavior in tables where selection range is preserved when you move the target cell via the keyboard.

Improved table behavior when you press shift-arrow-key and cmd-shift-arrow-key (Macintosh) or Ctrl-shift-arrow-key (Windows).

Improved feedback when user tries to change a locked wave in a table.

Page Layout Improvements

SavePICT/W=(0,0,0,0) exports using a full page.

Improved PageLayout WYSIWYG for graph alignment.

The desktop region in page layout windows is now drawn as solid gray instead of as a gray pattern.

Added 12.5 percent and 6.5 percent zoom levels for page layouts. This is intended to make it easier to work with very large page sizes.

The page layout fidelity setting no longer has any effect on drawing graph objects.

Notebook Improvements

Changed notebook object picture updating to be cross-platform. Previously, the Notebook specialUpdate keyword could update pictures of graphs, tables and page layouts that were created from windows in the current experiment but only on Macintosh and only for the Mac PICT format. This now works on both Macintosh and Windows and for all supported clipboard formats. To create a picture that can update, copy the window to the clipboard and paste into a formatted notebook. With the exception of Macintosh PICTs, existing pictures in Notebooks do not have the information needed for the update and will need to be regenerated.

Backwards compatibility note: Although these pictures in Notebooks will be visible when passed back to Igor Pro 6.0, when Macintosh PICTs are updated, they will be converted to the new Macintosh standard format, PDF. This is not supported prior to 6.1 and therefore these pictures will show up as gray boxes.

You can now embed notebook subwindows in panels. This is useful for both displaying multiline text to the user and also for getting multiline text input. See Notebooks as Subwindows in Control Panels and the Notebook in Panel example experiment. See the NewNotebook flag /HOST and the Notebook keywords autoSave, zdata, zdataEnd, getData and setData and the flag /OPTS.

You can open UTF-16 (two-byte Unicode) text files as plain text notebooks. Igor does not recognize non-ASCII characters, but does ignore the byte-order mark at the start of the file (BOM) and null bytes contained in UTF-16 text files. If you open a UTF-16 file and then save it from Igor, it will be saved as plain ASCII, not UTF-16, and some information may be lost.

The Notebook operation supports a writeProtect keyword to turn write-protect on or off.

You can insert the contents of a picture file into a formatted text notebook. To support this the Edit->Insert Text menu item is now Insert File.

The Notebook operation has an insertPicture keyword for programmatically inserting the contents of a picture file into a formatted text notebook.

You can now save a picture in a notebook as a picture file. You must select one picture and one picture only and then choose File->Save Graphics.

The Notebook operation has a savePicture keyword for programmatically saving the contents of a notebook picture in a file.

The Notebook operation has new keywords: headerPos, footerPos, headerControl, footerControl. You still can not programmatically set the contents of the headers and footers but these keywords allow you to control if and where they appear.

You can activate the Igor-object window associated with an Igor-object picture in a notebook by double-clicking the picture. If the window does not exist but the associated window recreation macro does exist, Igor runs the window recreation macro.

The SpecialCharacterInfo function now takes "WINTYPE" and "OBJECTNAME" keywords which work only with Igor-object pictures. Also you can get information about the selected special character without knowing its name.

Added "Show File in Finder/Windows Explorer" button to Notebook info dialogs.

Help Improvements

Added Built-in Structure Reference section to the Igor Reference help file. This means you can right-click the name of a built-in structure, such as WMWinHookStruct, and choose "Help For WMWinHookStruct" from the contextual menu.

The Igor Help Browser's Search Igor Files tab has a new checkbox for searching the Igor Pro User Files folders.

Many of the technical notes have been updated, including fixing missing graphics on Windows.

Tech Note 021 Ternary Graphs has been marked Obsolete. It has been replaced by the Ternary Diagram Package, available via Windows->New->Packages->Ternary Diagram.

Added "Show File in Finder/Windows Explorer" button to Help info dialogs.

Graphics Export Improvements

Relaxed plot size limits when exporting graphs using special plot size modes.

Improved the ability to export huge graphics by automatically scaling back resolution as numeric limits are reached.

Font embedding for Igor PDF and EPS export now supports multibyte fonts (i.e., Japanese.)

Added support for underline text in Igor pdf export.

Macintosh only: Transparent PNGs created via SavePICT/TRAN=1 now use the full alpha channel to support antialiasing and font smoothing. However, due to limitations of the OS, this does not work well for smooth text under OS X 10.4 or Japanese 10.5. For these operating systems, you can use /TRAN=2 to turn off the problematic font smoothing.

Axis labels now honor embedded superscript (\S), subscript (\B) and mainline (\M) escape codes in wave units. For example:

Make jack=sin(x/8);
SetScale x, 0, 0, "g/cm\\S3\\M", jack
Display jack

You can now specify custom RGB to CMYK for eps and Igor pdf export. This is for the situation where a publisher dictates that specific CMYK values be used. To do so, create a 7 column float or double wave named M_IgorRGBtoCMYK (in the root data folder) where the first 3 columns are Igor RGB values and the last 4 are the desired CMYK values on a scale of 0 to 1. Not used for images within eps or pdf and not used for tiff export currently. For example:

Make/O jack=sin(x/8);Display jack
ModifyGraph rgb=(65535,0,0)	// force red
Make/N=(2,7)/O M_IgorRGBtoCMYK
M_IgorRGBtoCMYK[0]={{65535},{0},{0},{1},{0},{0},{0}}	// red=>cyan
M_IgorRGBtoCMYK[1]={{0},{0},{0},{0},{1},{0},{0}}	// black=>magenta
SavePICT/C=2/EF=1/E=-8	// export as cmyk Igor pdf

Note: a much more user friendly package is available through the IgorRGBtoCMYKPanel.ipf procedure file:

#include <IgorRGBtoCMYKPanel>

The IgorRGBtoCMYKPanel procedure implements a table-like editor to override the conversions Igor will perform when exporting RGB graphics in the CMYK format. See Exporting Colors (Macintosh) or Exporting Colors (Windows) for details.

Added a method to force discrete pixels in PDF export of image. Mainly for use on Macintosh where Quartz drawing of an image smears out the pixels (but Adobe Reader does not). To force drawing each pixel of an image as an individual rectangle, use:

SetIgorOption MaxDimForImagePixels= value

where value is greater than the smallest dimension of the problematic image. The default value is 20 so if you have a 100x50 image, use a value > 50. For example, on Macintosh:

Make/O/N=(50,40) jack=x*y
NewImage jack;MoveWindow 121,91,682,537
ModifyImage jack ctab= {*,*,Rainbow,0}

Now copy to the clipboard as a Quartz PDF and read into Preview.app via New From Clipboard. Then execute:

SetIgorOption MaxDimForImagePixels=41

and do it again to see the difference.

UPDATE: As of 6.20B02 you also have to execute this:

SetIgorOption imagedraw, TinyBlitOK=0

Procedure Window Improvements

Checking the Auto-compile menu also compiles the procedures immediately.

Added new ability to prevent procedure windows from being listed in the Procedures submenu using:

#pragma hide=1

Only hides if window is also marked as read-only and, obviously, only after a compile. Such windows will show if you execute:

SetIgorOption IndependentModuleDev=1

Also see Invisible Procedure Files.

Added "Show File in Finder/Windows Explorer" button to Procedure info dialogs.

A procedure window created by Igor by including a file into an independent module that was (unwisely) edited would happily vanish without saving any of the revisions. Now Igor will put up a dialog allowing you to save a copy of the changed procedure window as a file. You should, however, be editing the original procedure file, not the temporary copy made by the including-into-an-independent-module process. You can guess why the author added this feature.

Increased the maximum number of help template characters that will be inserted in a procedure file from 120 to 400.

You can open UTF-16 (two-byte Unicode) text files as procedure windows. Igor does not recognize non-ASCII characters, but does ignore the byte-order mark at the start of the file (BOM) and null bytes contained in UTF-16 text files. If you open a UTF-16 file and then save it from Igor, it will be saved as plain ASCII, not UTF-16, and some information may be lost.

Gizmo Improvements

Added support for EPS export.

#include <All Gizmo Procedures> includes the procedures into an independent module so they'll continue working if the user's own procedures don't compile.

The Gizmo menus have been revised.

Drawing Improvements

Draw patterns can be transparent using "magic" white background color value of (65534,65534,65534). Does not work with emf or wmf export. Example:

SetDrawEnv fillpat= 5,fillfgc= (65535,0,0)
DrawRect 0.15,0.18,0.50,0.60
SetDrawEnv fillpat= 6,fillfgc= (0,0,65535),fillbgc= (65534,65534,65534)
DrawRect 0.34,0.12,0.64,0.70

Draw text can be mutli-line and use all the escape codes of TextBoxes.

When DrawPICT is used in an independent module and you need to access the picture gallery, you can now do so using a new prefix name, GalleryGlobal. For example:

DrawPICT 0,0,1,1,GalleryGlobal#PICT_0

Annotation Improvements

New escape codes for textboxes to provide tweaks to line spacing. See the \sa and \sb escape codes for TextBox.

Annotations can be rotated in one-degree increments using New Graphics .

Tag arrow heads can be added on either or both ends of the tag attachment line.

Control Improvements

A SetVariable control can now be used without a global variable. See the _STR: and _NUM: syntax for the value keyword. ControlInfo reads back the string from SetVariable when using new _STR: mode.

You can now use ctrl-return to enter a carriage return in a string SetVariable. A carriage return in a string SetVariable or a \r in a textbox now shows as a symbol representing a carriage return.

SetVariable can now use fancy text using the escape codes defined for the TextBox operation if noedit=2.

New mousewheel event codes for SetVariable: See events 4 and 5.

Additional keywords for coloring user-defined controls:

ValDisplay only:

Most user-defined control titles now accept styled text commands. The control dialogs have an Insert popup to make this easier.

ControlInfo for Button and CustomGaget controls now return tick count of last mouse up in V_value. This can sometimes make it possible to use buttons without setting an execution proc.

The value expression for ValDisplay can now be _NUM:<numeric expression>. This avoids the need to set a dependency on a global variable.

Renamed previously undocumented control action structure field blockRentry to blockReentry and added support to all controls. When set by the user action function, additional events for that control will be ignored until the function returns. This is only needed on Macintosh but is supported on Windows.

ListBox disable=2 is now supported.

The foreground color of cells in a Listbox control now follows the color specified by selWave even if the cells are selected. Previously the foreground color was ignored for selected cells.

Added keyboard event (event 12) to the Listbox action. Sets the row member of the WMListboxAction structure to the character code; use num2char to get a string for the character typed. Also sets the eventMod member appropriately.

Added the clickEventModifiers keyword to the Listbox command to tell listbox controls to ignore right clicks and clicks with modifier keys. That allows the listbox action procedure to receive the mousedown and mouseup events for their own purposes, allowing a contextual menu to be put up by the action procedure even on checkbox and editable cells.

Added the titleWave keyword to the Listbox command to specify column titles using a text wave instead of the listwave dimension labels. This allows more than 31 characters in a column title, which is especially useful with styled text.

Added setEditCell keyword to the Listbox command to allow programmatic initiation of cell editing.

Control Panel Improvements

You can now embed notebook subwindows in panels. This is useful for both displaying multiline text to the user and also for getting multiline text input. See Notebooks as Subwindows in Control Panels and the Notebook in Panel example experiment. See the NewNotebook flag /HOST and the Notebook keywords autoSave, zdata, zdataEnd, getData and setData and the flag /OPTS.

Panel windows can now be the target of ShowInfo and HideInfo for use with any graph subwindows. You must use an explicit name via the /W flag to target a panel window. Without the flag, the top graph window will be the target.

Panel windows can now be used as progress indicator windows during long calculations. See the DoUpdate /W and /E flags and the ValDisplay mode=4 setting. See Progress Windows for example code.

You can now create a snapshot picture of a control panel. Use SavePICT/SNAP=1. Note that scroll bars and the content of Notebook subwindows will not be captured.

Windows only: Changed the window coordinates for floating panels to be consistently screen coordinates. Previously, NewPanel/FLT=1/W=(x0,y0,x1,y1) would use screen coordinates except the y values were offset by 20. Previously, GetWindow's wsize keyword would return coordinates relative to the MDI frame. Now they are screen coordinates but, for consistency, measured in Points, not pixels. Previously, MoveWindow would offset a floating panel by 20 points.

Controls outside of a tab/groupbox frame but inside the enclosure are no longer considered inside the tab/groupbox, so the control background is rendered correctly. (This affected only controls positioned in the tab or groupbox title areas.)

ListBox special kind=1 now supports tables in addition to graphs. Only presentation portion is provided.

Analysis Improvements

Added /TIME=secs flag to Loess operation to warn or abort if the calculation time exceeds that number of seconds.

WaveCRC now returns a consistent value for the header CRC value that previously changed when other waves were created or killed.

Loess properly aborts if the user presses command-period (Macintosh) or Ctrl+Break (Windows).

New Mulit-peak Fit 2 package. See New And Improved WaveMetrics Procedure Files for details on the new package.

Added new operation LombPeriodogram.

Added /MPCT flag to Smooth to compute percentile, min, and max value in the smoothing window.

The revamped Smooth dialog now has Percentile, Min, and Max algorithms and a few more options for Loess smoothing. The replacement value interface is hopefully more obvious.

Added /AUTO and /NODC options to the Correlate operation, and revamped the Correlate dialog accordingly.

Added /DIML flag to Sort and IndexSort.

The Optimize and FindRoots operations are now thread-safe, with the exception of FindRoots for polynomial roots (/P flag).

IntegrateODE now has a /STOP flag that allows you to specify a wave with stopping conditions on the Y values and derivatives. Your derivative function can also request a stop by returning 1 from the function.

Statistics Improvements

Added /NAPR flag in StatsSRTest to allow the use of the normal approximation even when the number of points is less than 150.

Added Jack-Knife analysis and a new flag /MC to StatsResample.

Added new operation StatsSample.

Added /AEVR flag to StatsTTest.

Added calculation of P-values in all four tests in StatsCircularTwoSampleTest.

Matrix Improvements

Added new functions to MatrixOP: replace(), replaceNaNs(), minVal(), maxVal(), clip(), and scale().

Changed MatrixOP to return a matrix of NaN values when inverting a singular matrix.

MatrixOP convolve() now supports an efficient direct kernel convolution with padding or data reflection at boundaries.

MatrixOP now supports a /FREE flag to store the output in a free wave.

Curve Fitting Improvements

Changed some flags and added some new flags to CurveFit, FuncFit and FuncFitMD to make it easier to write compiled (function) code with options. Before, flags had to be present or not present which can't be compiled into a choice. Now some arguments have been added, and a new flag (/NWOK) has been added to make it possible to compile choices.

Added /ODRT flag to CurveFit parameters (the flags at the end of the command). Sets convergence tolerance for ODR fitting.

Removed upper limit on V_FitMaxIters. See Special Variables for Curve Fitting.

Added error message if you try to add confidence bands or prediction bands to an ODR (Orthogonal Distance Regression) fit. See Also: Errors in Variables: Orthogonal Distance Regression.

Image Plot Improvements

ModifyImage plane now indexes through higher dimensions (chunks). For example if an image has 4 planes and two chunks, plane= 4 would show plane 0 of chunk 1.

New rgbMult keyword for ModifyImage. Direct color values are multiplied by this.

Image Processing Improvements

Added /DEST=destinationWave flag to ImageInterpolate.

ImageRegistration now supports the individual registration of layers in a 3D stack. You can also use the operation to transform any image with a user-defined set of parameters. This is mostly useful for transforming multiple images based on the registration of a single frame.

Added /BRXY flag to ImageStats to allow for specification of multiple beams using an XY pair of waves.

Added the flag /Igor to ImageSave to force TIFF file saving using Igor's code.

Data Import And Export Improvements

Dramatically speeded up loading of very long 1D text waves using LoadWave.

You can disable interpretation of escape sequences when loading text using LoadWave. Set bit 3 of the loadFlags parameter of the /V flag.

Added "skip thousands separator" bit to numConversionFlags parameter in LoadWave /V flag. This works with Load Delimited Text only (/J). It is only for when you have an unfortunately-formatted data file that uses thousands separators (e.g., "1,234" instead of "1234").

The LoadWave operation can handle UTF-16 (two-byte Unicode) text files. It does not recognize non-ASCII characters, but does ignore the byte-order mark at the start of the file (BOM) and null bytes contained in UTF-16 text files.

LoadWave/J now accepts date/time values in ISO-8601-style: <date> T <time>. It does not support ISO-8601 time zone designations.

The GBLoadWave operation now supports very big files. See GBLoadWave and Very Big Files for details.

Changed LoadData operation so that it creates the variable V_flag and sets it to the number of objects loaded, or to -1 if the user cancelled the open file dialog.

The length of the objectNameList used with SaveData/J is now unlimited.

Now support save and restore of DataFolderRef (DFREF) and wave reference waves in packed experiments. These types can not be stored in unpacked experiments or via SaveData and they will not show up in the data browser. They will be ignored by previous versions of Igor. See Data Folder References.

File Command Improvements

You can now display an Open File dialog that supports selecting multiple files. See Displaying a Multi-Selection Open File Dialog.

PathInfo's new /SHOW flag opens the specified folder in the Finder (Macintosh) or Windows Explorer (Windows).

Added a "Igor Pro User Files" option to SpecialDirPath.

In the SetFileFolderInfo /RO command on Macintosh, bit 1 has no effect. Use /RO=0 or /RO=1 but not /RO=2 or /RO=3.

The FSetPos and FStatus operations now support very big files (greater than 2GB). FSetPos now supports setting the current position in files up to about 4.5E15 bytes. FStatus now supports reporting the current file position (through V_filePos) and the total file size (through V_eof) for files up to about 4.5E15 bytes.

The GBLoadWave operation now supports very big files. See "GBLoadWave and Very Big Files" in GBLoadWave Help.ihf for details.

The Open operation, when used to display an Open File or Save File dialog, now supports file name extensions longer than three characters via the new /F flag.

Added /D=2 flag to Open operation to make it easier to create utility routines that take pathName and fileName parameters. See Displaying an Open File Dialog and Using Open in a Utility Routine for an example.

The IndexedFile function ignores dot-underscore files (e.g., "._wave0.ibw") created by Apple's SMB software unless the specified file type is "????" (any file type).

On Macintosh, eliminated the limit on number of files that Igor can open at one time.

Programming Improvements

New MultiThread keyword provides automatic parallel processing of wave assignment statements. See Automatic parallel processing with MultiThread.

The following functions can now take a null local string variable without throwing an error: exists, str2num, char2num, strlen and SelectString. When given a null string, exists returns 0 while str2num, char2num and strlen return NaN. (This is not a change in the return values - the lack of a run time error is the change.)

A killed wave in a WAVE reference now act like a NULL wave. This is to fix crashes resulting from code like this:

WAVE awave
foo()	 // a function that kills awave
Display awave

Programmers can now use a shortcut when creating a WAVE reference variable while using $ <str>. See the /WAVE=<name> discussion in Automatic Creation of WAVE References.

You can now create free waves in functions using the new /FREE flag with either Make or Duplicate. This flag is not allowed on the command line and is not allowed with $ or folder syntax.

New built-in wave reference function, NewFreeWave.

You can now create and pass in a free wave to a user-defined function using {a,b,...} syntax as illustrated here:

Function foo(w)
    WAVE w
    print w

Function bar()

See Free Waves.

Added GetErrMessage function (which is pretty useful in combination with Execute).

GetSelection for procedure windows works just like for notebooks except that the name is actually a title wrapped in $"".

Added optional dfr parameter to GetDataFolder; when supplied, it is used in place of the current data folder.

New data folder reference type provides direct access to data folders and supports free data folders. You can create waves containing data folder references and can create user-defined functions that return such references. See Data Folder References and DFREF , Data Folder Reference Functions and Free Data Folders. Here are functions that are used with data folder references:

You can now create user-defined functions that return wave references. See Wave Reference Functions.

You can now create waves that contain wave references. See Wave Reference Waves and Free Waves.

New optional selector for WaveType.

Now allow unlimited number of datafolders to be queued via ThreadGroupPutDF.

Increased the maximum dimension length in user defined Structures to 400 from 100 for all types except STRUCT.

Added new /C (continue) flag for PauseForUser when you have something to do while waiting. After handling any events, PauseForUser returns immediately after setting V_Flag to the truth that the target window exists. Typical use would be for automatic continue after some delay.

Made PauseForUser on Windows suppress clicks on most non-target windows.

Conditional ops (<, > etc) are now defined for complex. The imaginary part is ignored on input and set to zero on output.

ProcedureText can return all of the text in a specified procedure window.

DisplayProcedure now groks procedure name paths like WMGP#GizmoBoxAxes#DrawAxis to display static functions (even in an indepdendent module). See The IndependentModule Pragma.

WinRecreation can return file information (symbolic path, full path, file name) for a specified procedure window.

SetIgorOption poundDefine=name and SetIgorOption poundUndefine=name enable the procedure window's Compile button. See Conditional Compilation.

It is now possible to attach user data to a graph trace. See ModifyGraph for Traces, information on the userData keyword. Also see the GetUserData function.

Bit 2 omits hidden traces from the output of TraceNameList.

Added /N option to PopupContextualMenu to allow contextual menus using the standard user-defined menu mechanism.

The Debugger's breakpoints follow the text (mostly).

The Debugger has a new "Show Wave Scaling" menu item in the Waves in Current or Root Data Folder popup menu.

The Debugger optionally shows waves as a graph trace or image plot, with a limited selection of appearance options available from a right-click contextual menu.

Debugging on Error breaks into the debugger on stack exhaustion.

New mouse wheel event for named window hooks. See SetWindow eventCode= 22 with new fields wheelDx and wheelDy. Values are typically +1 or -1 with wheelDy being set by the vertical mouse wheel. On Windows, horizontal mouse wheel requires Vista.

New "spinUpdate" window hook eventCode=23, called for progress windows during execution of user code. Allows semi-automatic progress updates. See SetWindow and Progress Windows for details.

The window hook "modified" event is now sent from notebook windows or subwindows. It is an error to try to kill the notebook window or its parent window during a window hook "modified" event. See SetWindow.

On Windows, "activate" and "deactivate" events are sent to window hook functions (see SetWindow) even when a panel or graph is minimized.

GetWindow now can tell you if a window is maximized or active.

ChildWindowList now returns empty list if error rather than raising an error.

The Display, Edit, Layout, NewLayout, NewNotebook and NewPanel operations now accept /K=3 to mean hide the window instead of killing it. This is intended for advanced packages. If you use this feature, the only way to kill the window is via DoWindow/K.

Added GuideNameList function.

Added cd and pwd operations.

Added the YYYY-MM-DD format to Secs2Date.

Changed DateTime to include fractional seconds.

In wfprintf operation, if refNum is 1, Igor will print to the history area instead of to a file. This is provided for debugging purposes.

Added a special-purpose feature for Bela Farago whereby text sent to history area is carbon-copied to a notebook. See History Carbon Copy.

The Display, Edit, Layout, NewLayout, NewNotebook and NewPanel operations now accept /K=3 to mean hide the window instead of killing it. This is intended for advanced packages. If you use this feature, the only way to kill the window is via DoWindow/K.

Added /KILL flag to SavePackagePreferences operation.

In the SaveData operation, Save Graph Copy and Save Table Copy, a message is now added to the saved experiment's history containing the parent experiment name and date/time.

Added dialogsOK keyword to CtrlNamedBackground to allow suppressing task that does naughty things.

Can now set the delay between the start of a control procedure and the spinning beachball. Use new flag for DoUpdate/SPIN=s where s is the delay in ticks (60 per second.) Unless used with the /W flag, it just sets the delay and an update is not done.

Added run time error when writing to a text wave fails.

You can now use structures defined in independent modules in global procs using imName#structName.

New and Improved XOPs

The new SQL XOP provides access to relational databases from Igor procedures. It uses ODBC (Open Database Connectivity) libraries and drivers on Mac OS X and Windows to provide this access. SQL XOP (file name SQL.xop) was created by WaveMetrics in 2007. It is unrelated to SQLXOP (file name SQLXOP.xop) which was created by Bruxton Corporation in the 1990's and which runs on Windows only.

Macintosh: the MLLoadWave XOP is now universal (Intel as well as PowerPC). The old PPC-only MLLoadWave_OSX XOP (in "More Extensions:File Loaders:PPC Extensions") has been removed from the distribution. To use the new XOP, remove the old alias from Igor Extensions and activate the new MLLoadWave XOP by adding its alias to Igor Extensions (preferably in the Igor Pro 6 User Files folder opened from Igor's Help menu). See "Using MLLoadWave on Mac OS X" in the MLLoadWave Help.ihf file for details on Macintosh configuration requirements for MLLoadWave.

The Interpolate XOP now disallows use of NaNs in the X dest wave in "X coords from dest" mode (/I=3). This never worked. Use the built-in interp function, instead.

In the Interpolate XOP, changed linear interpolation behavior when using "X coords from dest" mode (/I=3). Previously if destination X values exceeded the maximum input X value, the extra destination points were clamped to the last input Y value. Now the extra destination points are extrapolated from the last two input points.

Added a TDM file loader for loading (and saving) National Instruments' TDM files. See TDM XOP for details.

Windows: Fixed a crash in HDF5 XOP that occurred if you tried to open a non-HDF5 file or an HDF5 file written by the HDF5 1.8 library. This crash does not occur on Macintosh.

Windows: Fixed a bug in the GBLoadWave XOP that prevented it from working with very large files (>2GB).

The GBLoadWave XOP and dialog now properly escapes backslashes in UNC file paths (\\Server\Share) on Windows, and supports long file names on Macintosh.

The SndLoadSaveWave XOP reads files with long names on Mac OS X, properly escapes backslashes in UNC file paths (\\Server\Share) on Windows.

The JCAMPLoadWave XOP has been recompiled to support long file names. Also added new error message stating that XYXY data is not supported, and suggesting that it can be loaded as Delimited Text with comma delimiter. Relaxed line-length restriction to allow non-standard files with lines longer than 80 characters.

Macintosh: Universal versions of NIGPIB XOP and NIGPIB2 XOP are now shipping. These require a recent version of the NI-488 driver from National Instruments. The "NIGPIB Mac ReadMe.txt" file, in "More Extensions/Data Acquisition", explains how to choose the right XOP for your situation.

Created an updated Macintosh HDF5XOP using HDF5 library version 1.8.2. This was done to keep in sync with the Windows version which was updated in Igor Pro 6.10B06.

Windows: New DSXOP supports DirectShow video acquisition under Windows XP and Windows VISTA.

Miscellaneous Improvements

Added the ExperimentModified operation.

Added the IgorVersion function.

Window titles can now be up to 255 characters instead of up to 40.

Igor object picture information is now preserved when you copy a picture between graphs, tables, layouts, notebooks and the picture gallery.

Added IgorExchange item to help menu. This leads to http://www.IgorExchange.com , the user-to-user support web site.

The file information dialog that appears when you click the tiny page icon in the lower-left corner of help, notebook, and procedure windows has a new "Show File in Finder/Windows Explorer" button.

SaveExperiment/P=<path> now presets Save File dialog folder.

On Windows, a check is now done on page setups to prevent numeric overflow.

Igor stores the paper width and height in printer units in a signed 16-bit integer. If the paper size is very large and the printer resolution is large, this can cause an overflow error. If you attempt to set a combination of paper size and resolution such that it would cause overflow, Igor now clips the paper size and tells you to reduce the paper size or the printer resolution.

For example, if you create a custom paper size of 54 x 42 inches, the largest printer resolution that you can use is 600 DPI. If you use 1200 DPI, Igor will clip the paper size and warn you.

Changed the Pictures dialog's list of names to one column, putting any error or commentary text below the list. Added a Copy Picture button. Fixed the Convert to PNG button not enabling.

New And Improved Example Experiments

Added Multi-peak fit 2 Demo.pxp as an introduction to the new Mulit-peak Fit 2 package. See below in New And Improved WaveMetrics Procedure Files 6.1 for details on the new package.

Added Cursor Moved Hook Demo.pxp in the Examples->Techniques folder.

Added Trace Graph.pxp in the Examples->Techniques folder.

Added Volume Grids.pxp.

Added snakeDemo.pxp.

Added BackgroundImageDemo.pxp.

Added Circular Two Sample Test.pxp.

Added MultiThreadMandelbrot.pxp.

Added Ternary Diagram Demo.pxp.

New And Improved WaveMetrics Procedure Files

#include <all gizmo procedures&gr; includes the procedures into an independent module so they'll continue working if the user's own procedures don't compile.

Added new Ternary Diagram package, which you will find under Windows→New→Packages.

Brand-new revised version of Split Axis package has nice control panel GUI, handles images and contours, keeps track of its axes so that they can be listed in menus sensibly, and can be removed easily. See the Graph menu's Package submenu.

New version of Global Fit 2.ipf has new data set selector panel. Hopefully it will make it easier to select waves when working with lots of data sets.

Modified ColorWaveEditor to take advantage of the new /N option for PopupContextualMenu. Now you change the color by clicking on a row to bring up a contextual menu.

Added Select Points for Mask procedure package, an updated and improved version of Data Mask for Fit. The name was changed to reflect the fact that it has wider applicability than just making a mask wave for fitting. It is now available via the Graph→Packages menu.

The ODE Panel and FitODE procedure files have been updated to offer the latest IntegrateODE options, and to modernize the GUI.

Multi-peak Fit 2 is a complete rewrite of the Multi-peak Fit package:

Routines in KillWaves.ipf have been updated to work with waves in all data folders. The side effect of bringing windows to the front in order to remove waves from them has been removed.

Upgraded CopyImageSubset.ipf slightly to use all of the ModifyImage recreation settings in the created image plot.

Added IgorThief.ipf.

Added Resize Controls Panel.ipf and Resize Controls.ipf:

The Resize Controls Panel.ipf procedure file implements a table-like editor to set the resize behavior of controls in panel. When the panel is resized, each edge of each control is (optionally) moved or resized according to the selected mode.

This is especially useful for panels with lists, sliders or subwindows. Controls can be moved relative to the panel's or subwindows' edges or centers, or relative to user guides.

Resize Controls.ipf contains the minimum necessary code once the editing is completed.

Added Rewrite Control Positions.ipf, which implements a panel that solves a tedious Igor programming problem: rewriting the code that creates panels with controls after adjusting the size or position of those controls. It also updates the title and optionally the disable and userdata keywords for controls, and detects changes in the SetWindow userdata values.

New IgorRGBtoCMYKPanel.ipf implements a GUI for editing root:M_IgorRGBtoCMYK (which specifies custom RGB to CMYK for EPS and Igor PDF export) and for gathering colors used in the top graph.

ColorSpaceConversions.ipf now contains a function that replicates Igor's RGB->CMYK conversion and a function that approximates a CMYK→RGB conversion.

Graph Utility Procs.ipf contains new functions for gathering colors used in the top or a named graph. Also has CopyImageSettings and CopyContourSettings in addition to CopyTraceSettings. Added optional graphName input parameter to CopyAxisSettings.

Image Processing procedures updated to use built-in StringByKey, etc instead of the ancient Strings as Lists.ipf.

ControlBarManagerProcs.ipf's MoveControls function now uses ModifyControl instead of Execute-ing Button, PopupMenu, etc commands.

SaveRestoreWindowCoords.ipf now works better on Windows with maximized windows by saving the restored/normal (not maximized) coordinates. Removed the obsolete WC_WindowCoordinatesGetNumsMW function.

Sonogram.ipf implements a "0 dB Max" feature to normalize the image to a maximum of 0 (dB).

Fixed a bug in Transpose Waves in Table.ipf- it failed to handle liberally-named waves.

PopupWaveSelector.ipf should now create a popup window of consistent size on Windows. It also computes the size of the group box used to frame SetVariable popupWaveSelector widgets better. On Windows, it positions the drop-down arrow on the little button in a SetVariable widget better.

XOP Toolkit Improvements

If you are an XOP programmer and want to support long file names on Macintosh you need to recompile your XOP with XOP Toolkit 5.09. As of June, 2009, XOP Toolkit 5.09 is not yet shipping. Send a note to support@wavemetrics.com if you want to get a beta version.

Bug Fixes

See Changes Since Igor 6.10 for a detailed bug fix list.