Mathworks MATLAB BUILDER EX RELEASE NOTES

Download

MATLAB Notes

Builder™ EX Release

How to Contact The MathWorks

www.mathworks. comp.soft-sys.matlab Newsgroup www.mathworks.com/contact_TS.html Technical Support

suggest@mathworks.com Product enhancement suggestions

bugs@mathwo doc@mathworks.com Documentation error reports service@mathworks.com Order status, license renewals, passcodes

info@mathwo

com

rks.com

Web

Bug reports

Sales, prici

ng, and general information

508-647-7000 (Phone)

508-647-7001 (Fax)

The MathWorks, Inc. 3 Apple Hill Drive Natick, MA 01760-2098

For contact information about worldwide offices, see the MathWorks Web site.

MATLAB

The software described in this document is furnished under a license agreement. The software may be used or copied only under the terms of the license agreement. No part of this manual may be photocopied or reproduced in any form without prior written consent from The MathW orks, Inc.

FEDERAL ACQUISITION: This provision applies to all acquisitions of the Program and Documentation by, for, or through the federal government of the United States. By accepting delivery of the Program or Documentation, the government hereby agrees that this software or documentation qualifies as commercial computer software or commercial computer software documentation as such terms are used or defined in FAR 12.212, DFARS Part 227.72, and DFARS 252.227-7014. Accordingly, the terms and conditions of this Agreement and only those rights specified in this Agreement, shall pertain to and govern theuse,modification,reproduction,release,performance,display,anddisclosureoftheProgramand Documentation by the federal government (or other entity acquiring for or through the federal government) and shall supersede any conflicting contractual terms or conditions. If this License fails to meet the government’s needs or is inconsistent in any respect with federal procurement law, the government agrees to return the Program and Docu mentation, unused, to The MathWorks, Inc.

Trademarks

MATLAB and Simulink are registered trademarks of The MathWorks, Inc. See

www.mathworks.com/trademarks for a list of additional trademarks. Other product or brand

names may be trademarks or registered trademarks of their respective holders.

Patents

The MathWorks products are protected by one or more U.S. patents. Please see

www.mathworks.com/patents for more information.

Builder™ EX Release Notes

Summary by Version ............................... 1

Contents

Version 1.2.15 (R2010a) MATLAB

Software

Version 1.2.13 (R2009b) MATLAB

Software

Version 1.2.12 (R2009a) MATLAB

Software

Version 1.2.11 (R2008b) MATLAB

Software

Version 1.2.10 (R2008a) MATLAB

Software

Version 1.2.9 (R2007b) MATLAB® Builder™ EX

Software

Version 1.2.8 (R2007a) MATLAB® Builder™ EX

Software

........................................ 4

........................................ 5

........................................ 6

........................................ 7

........................................ 9

........................................ 10

........................................ 12

Builder EX

Version 1.2.7 (R2006b) MATLAB® Builder™ EX

Software

Version 1.2.6 (R2006a) MATLAB® Builder™ EX

Software

Version 1.2.5 (R14SP3) MATLAB® Builder™ EX

Software

Version 1.2.4 (R14SP2) MATLAB® Builder™ EX

Software

........................................ 15

........................................ 16

........................................ 17

........................................ 18

iii

Version 1.2.2 (R14SP1) MATLAB® Builder™ EX

Software

Version 1.2.1 (R 14 +) MATLAB ® Builder™ EX

Software

........................................ 19

........................................ 20

Version 1.2 (R14) MATLAB® Builder™ EX Software

Version 1.1 (R13) MATLAB® Builder™ EX Software

Compatibility Summary for MATLAB® Builder™ EX

Software

........................................ 24

... 21

... 22

iv Contents

SummarybyVersion

This table provides quick access to what’s new in each version. For clarification, see “Using Release Notes” on page 2 .

MATLAB®Builder™ EX Release No tes

Version (Release)

Latest Versi V1.2.15 (R2010a)

V1.2.13 (R2009b)

V1.2.12 (R2009a)

V1.2.11

V1.2.10 (R2008a)

V1.2.9 (R2007b)

8 (R2007a)

V1.2.

V1.2.7 (R2006b)

(R2008b)

New Features and Changes

Yes Details

No No Bug Reports

Yes

Detai

Yes Details

Ver sion Compatibilit Consideratio

No Bug Reports

Yes Summary

No Bug Repor

Yes Summary

Yes Summa

No Bug Reports

Yes Summary

Fixed Bugs and Known Problems

Includes fix

Bug Reports Includes fixes

Includes

Bug Reports Includes fixes

Includes fixes

Bug Re Inclu

Includes fixes

Bug Reports Includes fixes

fixes

ports

des fixes

Related Documentation at Web Site

Printable Release Notes: PDF

Current product documentation

V1.2.6 (R2006a)

.2.5 (R14SP3)

V1.2.4 (R14SP2)

V1.2.2 (R14SP1)

No No Bug

No No Bug Reports

No No

Reports

ludes fixes

Inc

Includes fixes

ixed bugs

MATLAB®Builder™ EX Release Notes

Version (Release)

V1.2.1 (R14+)

V1.2 (R14)

V1.1 (R13)

New Features and Changes

No No

Yes Details

Ver sion Compatibility Considerations

Yes Summary

No No No

Fixed Bugs and Known Problems

Fixed bugs

No No

Related Documentation at Web Site

Using Release Notes

Use release notes when upgrading to a newer version to learn about:

• New features

• Changes

• Potential impact on your existing files and practices

Review the release notes for other MathWorks™ products required for this product (for example, MATLAB bugs, or compatibility considerations in other products impact you.

If you are upgrading from a software version other than the m ost recent one, review the current release notes and all interim versions. For example, when you upg rade from V1.0 to V1.2, review the release notes for V1.1 and V1.2.

or Simulink®). Determine if enhancements,

What Is in the Release Notes

New Features and Changes

• New functionality

• Changes to existing functionality

SummarybyVersion

Version Compatibility Con si derations

When a new feature or change introduces a reported incompatibility between versions, the Compatibility Considerations subsection explains the impact.

Compatibility issues reported after the product release appear under Bug Reports at The MathWorks™ Web site. Bug fixes can sometimes result in incompatibilities, so review the fixed bugs in Bug Reports for any compatibility impact.

Fixed Bugs and Known Problems

The MathWorks offers a user-searchable Bug Reports database so you can view Bug Reports. The development team updates this database at release time and as more information becomes available. Bug Reports include provisions for any known workarounds or file replacem ents. Information is available for bugs existing in or fixed in Release 14SP2 or later. Information is not avail able for all bugs in earlier releases.

Access Bug Reports using y our MathWorks Account.

MATLAB®Builder™ EX Release Notes

Version 1.2.15 (R2010a) MATLAB Builder EX Software

This table summarizes what’s new in Version 1.2.15 (R2010a):

New Features and Changes

Yes No Bug Reports

Version Compatibility Considerations

New features and changes introduced in this version are:

Fixed Bugs an d Known Problems

Includes fixes

Deployment Tool Now Available from Command Line

You can now invoke the Deployment Tool GUI from the command line. See “Using the Command Line (mcc)” for more information.

Related Documentation at Web Site

Printable Release Notes: PDF

Current product documentation

Version 1.2.13 (R2009b) MATLAB®Builder™ EX So ftware

Version 1.2.13 (R2009b) MATLAB Builder EX Software

This table summarizes what’s new in Version 1.2.13 (R2009b):

New Features and Changes

Yes Yes

Version Compatibility Considerations

Summary

New features and changes introduced in this version are:

Redesigned Deployment Tool GUI

The new Deployment Tool (deploytool) interface features in tu iti ve task-based navigation, a cancellable progress dialog, fast loading of previously-created projects, and ability to add supporting files as folders. The GUI also features new context sensitive help.

New Format for Deployment Tool Projects

If you have projects that were cre ated with the Deployment Tool prior to R2009b, those projects will continue to work. However, projects created or changed in R2009b cannot be opened in previous versions of Deployment Tool (

deploytool).

Fixed Bugs an d Known Problems

Bug Reports Includes fixes

Related Documentation at Web Site

Printable Release Notes: PDF

Current product documentation

MATLAB®Builder™ EX Release Notes

Version 1.2.12 (R2009a) MATLAB Builder EX Software

This table summarizes what’s new in Version 1.2.12 (R2009a):

New Features and Changes

Yes No Bug Reports

Version Compatibility Considerations

New features and changes introduced in this version are:

Fixed Bugs an d Known Problems

Includes fixes

Reduced MCR Size Saves on Transfer Time

MCR copying and transfer time has been improved by 50% following a reduction in the file’s contents. The change will not reduce processor time or memory consumption since the deleted files were not loaded into RAM.

Customized readme.txt Produced with Each Compilation

An enhanced version of the readme.txt file, which is generated with each successful compilation, is now customi zed to include specific instructions about MATLAB

Builder™ EX deploymen t requirements.

Related Documentation at Web Site

Printable Release Notes: PDF

Current product documentation

Version 1.2.11 (R2008b) MATLAB®Builder™ EX So ftware

Version 1.2.11 (R2008b) MATLAB Builder EX Software

This table summarizes what’s new in Version 1.2.11 (R2008b):

New Features and Changes

Yes Yes

Version Compatibility Considerations

Summary

New features and changes introduced in this version are:

Applications Created with Parallel Computing Toolbox Can Be Compiled

You can now compile MATLAB applications that use the Parallel Computing Toolbox. Resulting executables and components can scale to multicore and multiprocessing environments using MATLAB Distributed Computing Server. See “Improving Data Access Using the MCR User Data Interface, COM C omponents, and MATLAB Builder EX” for more information.

Warning Results When Running Figure-Generating Applications or Printing with -nojvm Flag

As of R2008b, running a figure-generating application or printing with the

-nojvm option results in a warning message. In some cases, figure rende ring

may succeed, and in other cases it may not. Similarly, various MATLAB graphics functions dependent on Java,suchasgraphicspassedwith

-nojvm

-nojvm option will no longer support figure-generating or printing and will

be removed.

Fixed Bugs an d Known Problems

Bug Reports Includes fixes

, will not result in displayable graphics. In a future release, the

Related Documentation at Web Site

-R

Same Name Class Objects Shared Between MCR Instances Will Not Work Correctly

IfthesameclassnameisusedintwoormoreseparateMCRinstanceswithin thesameprocess,theobjectwillnotwork correctly. This bug impacts all component based targets: C/C++ shared libraries , COM/.Net targets, and

MATLAB®Builder™ EX Release Notes

Java targets. This bug does not affect standalone executables. This is due to a bug in the MATLAB Object System and is being addressed.

Version 1.2.10 (R2008a) MATLAB®Builder™ EX So ftware

Version 1.2.10 (R2008a) MATLAB Builder EX Software

This table summarizes what’s new in Version 1.2.10 (R2008a):

New Features and Changes

No No Bug Reports

Version Compatibility Considerations

Fixed Bugs an d Known Problems

Includes fixes

Related Documentation at Web Site

MATLAB®Builder™ EX Release Notes

Version 1.2.9 (R2007b) MATLAB® Builder™ EX Software

This table summarizes what’s new in Version 1.2.9 (R2007b):

New Features and Changes

Yes Details below

Function Being Removed

buildmcr

comtool

dotnettool

mxltool

opennbl

Version Compatibility

Fixed Bugs an d Known Problems

Considerations

Yes Summary

Bug Reports Includes fixes

Functions Being Removed

The following functions were removed in R2007b:

What Happens When You Run the Function?

Errors

Undefined Function Error

Use This Instead Compatibility

MCRInstaller.exe

(Windows),

MCRInstaller.bin (UNIX), MCRInstaller.dmg (Mac)

deploytool

Related Documentation at Web Site

Considerations

See “What Is The MATLAB Compiler Runtime (MCR)?” in the MATLAB Compiler User’s Guide documentation.

Migrate to

deploytool.

Migrate to

deploytool.

Migrate to

deploytool.

Migrate to

deploytool.

Version 1.2.9 (R2007b) MATLAB® Builder™ EX Software

Function Being Removed

openmxl

opencbl

What Happens When You Run the Function?

Undefined Function Error

Use This Instead Compatibility

Considerations

deploytool

Migrate to

deploytool.

Migrate to

deploytool.

MATLAB®Builder™ EX Release Notes

Version 1.2.8 (R2007a) MATLAB® Builder™ EX Software

This table summarizes what’s new in Version 1.2.8 (R2007a):

New Features and Changes

Yes Details below

Version Compatibility Considerations

No Bug Reports

New features and changes introduced in this version are:

• “Support Added for Win 64” on page 12

• “Qualified Against Excel 2007 Beta” on page 12

• “Issues with the Microsoft Windows Vista Operating System ” on page 12

Fixed Bugs an d Known Problems

Includes fixes

Related Documentation at Web Site

Support Added for Win 64

Support has been added for the Windows 64-bit operating system.

Qualified Against Excel 2007 Beta

MATLAB® Builder for Excel® has been qualified against the Excel 2007 Beta version.

Issues with the Microsoft Windows Vista Operating System

The following are known issues with Windows Vista™ as of this release. To resolve these issues, ensure you are logged in as Administrator.

• With User Account Control (UAC) enabled, a standard user is not able to

write to a folder in the Notes for more details re garding this issue.

c:\Program Files folder. See the MATLAB Release

Version 1.2.8 (R2007a) MATLAB® Builder™ EX Software

• With User Account Control (UAC) enabled, a standard user is not able to

mbuild -setup attempts to register mwcomutil.dll,

the following errors are displayed:

Trying to update options file:

C:\Users\qe\AppData\Roaming\MathWorks\MATLAB\R2007a\compopts.bat

From template:

C:\PROGRA~1\MATLAB\R2007a\bin\win64\mbuildopts\msvc80compp.bat

Done . . .

--> "C:\PROGRA~1\MATLAB\R2007a\bin\win64\mwregsvr C:\PROGRA~1\MATLAB\R2007a\bin\

win64\mwcomutil.dll"

Error: DllRegisterServer in C:\PROGRA~1\MATLAB\R2007a\bin\win6 4\mwcomutil.dll

failed

Undefined subroutine &mexsetup::expire called at C:\PROGRA~1\MATLAB\R2007a\bin\/

mexsetup.pm line 839.

This is also the case when MATLAB Builder for Excel invokes mbuild in an attempt to register DLLs after a compilation completes.

• The following message is displayed when MATLAB Builder for .NET,

attempts to install a DLL into the Global Assembly Cache from a network location:

Unhandled Exception: System.IO.FileLoadException: could not load file or assembly

'GACInstaller, Version=1.0.2568.30711, Culture=neutral, Public KeyToken=null' or

one of its dependencies. Failed t o grant permission to execute. (Exception from

HRESULT: 0x80131418)

File name: 'GACInstaller, Version=1.0.2568.30711, Culture=neutral,

PublicKeyToken=null' ---> System.Security.Policy.PolicyException: Execution

permission cannot be acquired.

at System.Security.SecurityManager.ResolvePolicy(Evidence evidence,

PermissionSet reqdPset, PermissionSet optPset, PermissionSet denyPset,

PermissionSet& denied, Boolean checkExecutionPermission)

at System.Security.SecurityManager.ResolvePolicy(Evidence evidence,

PermissionSet reqdPset, PermissionSet optPset, PermissionSet denyPset,

PermissionSet& denied, Int32& securitySpecialFlags, Boolean

checkExecutionPermission)

MATLAB®Builder™ EX Release Notes

• Printing from a compiled applicati on is not currently available with

Microsoft Windows Vista. The following message is displayed if you attempt to print on systems with the Microsoft Windows Vista 32-bit operating system installed:

PrintImage Error

StartPage failed with error 6: Th e handle is invalid.

Printing with Vista 64-bit installed results in an error message that lists a manifest as missing. Please check for updates on these issues.

http://www.mathworks.com/support/

Version 1.2.7 (R2006b) MATLAB® Builder™ EX Software

This table summarizes what’s new in Version 1.2.7 (R2006b):

New Features and Changes

Yes Details below

Version Compatibility Considerations

Yes—Details labeled as Compatibility Considerations, below. See also Summary.

New features and changes introduced in this version are

Fixed Bugs an d Known Problems

Bug Reports Includes fixes

Related Documentation at Web Site

New User Interface

This release of MATLAB Builder for Excel provides a new graphical user interface (GUI) called the Deploy ment Tool. You can use this tool to create and build projects. To launch the Deployment Tool, enter the command in MATLAB.

Compatibility Considerations

Projects built with the previous user interface cannot be used with the new interface. For R2006b, you can still issue the projects from a previous release.

mxltool command to access

deploytool

MATLAB®Builder™ EX Release Notes

Version 1.2.6 (R2006a) MATLAB® Builder™ EX Software

This table summarizes what’s new in Version 1.2.6 (R2006a):

New Features and Changes

No No Bug Reports

Version Compatibility Considerations

Fixed Bugs an d Known Problems

Includes fixes

Related Documentation at Web Site

Version 1.2.5 (R14SP3) MATLAB® Builder™ EX Software

This table summarizes what’s new in Version 1.2.5 (R14SP3):

New Features and Changes

No No Bug Reports

Version Compatibility Considerations

Fixed Bugs an d Known Problems

Includes fixes

Related Documentation at Web Site

MATLAB®Builder™ EX Release Notes

Version 1.2.4 (R14SP2) MATLAB® Builder™ EX Software

This table summarizes what’s new in Version 1.2.4 (R14SP2):

New Features and Changes

No No

Version Compatibility Considerations

Fixed Bugs

This release includes the following bug fixes:

• Components generated by MATLAB Builder for Excel now pass an output

variable containing a structure within a structure to the client code correctly.

• Components generated by MATLAB Builder for Excel no longer return a

complex output variable as an empty variant to the client application.

Fixed Bugs an d Known Problems

Fixed bugs

Related Documentation at Web Site

Version 1.2.2 (R14SP1) MATLAB® Builder™ EX Software

This table summarizes what’s new in Version 1.2.2 (R14SP1):

New Features and Changes

No No

Version Compatibility Considerations

Fixed Bugs

This release includes the followin g bug fix:

• MATLAB figure windows no longer hang when opened through a

component created with MATLAB Builder for Excel. In Version 1.2.1, you had to use the task manager to dismiss the window. To fix this bug, the Create a singleton MCR option in New Project Settings tells MATLAB Compiler to generate code such that it creates only one instance of the MCR per application.

Fixed Bugs an d Known Problems

Fixed bugs

Related Documentation at Web Site

MATLAB®Builder™ EX Release Notes

Version 1.2.1 (R14+) MATLAB® Builder™ EX Software

This table summarizes what’s new in Version 1.2.1 (R14+):

New Features and Changes

No No

Version Compatibility Considerations

Fixed Bugs

This release includes the followin g bug fix:

• When a packaged component that is generated by MATLAB Builder for

Excel is deployed to a machine that does not have MATLAB installed, users receive the following error message when MCRInstaller is installed with the package:

LoadLibrary (component_name failed The specified module could not be found)

As a workaround, register the component manually using the regsvr32 utility. To do this, enter

regsvr32 component_name.dll

at the Windows command prompt.

Fixed Bugs an d Known Problems

Fixed bugs

Related Documentation at Web Site

Verify that the current working folder is the one that contains the component generated by MATLAB Builde r for Excel.

Version 1.2 (R14) MATLAB® Builder™ EX Software

This table summarizes what’s new in Version 1.2 (R14):

New Features and Changes

Yes Details below

Version Compatibility Considerations

Yes—Details labeled as Compatibility Considerations, below. See also Summary.

This version includes the following ne w feature:

Fixed Bugs an d Known Problems

No No

Related Documentation at Web Site

New Product Name

The name of this product has been changed from MATLAB®Builder for

Excel

Compatibility Consideration

Various screens within this product have been changed for consistency with similar products. Note, however, that the functionality is unchanged from previous releases.

to MATLAB Builder EX.

MATLAB®Builder™ EX Release Notes

Version 1.1 (R13) MATLAB® Builder™ EX Software

This table summarizes what’s new in Version 1.1 (R13):

New Features and Changes

Yes Details below

Version Compatibility Considerations

Fixed Bugs an d Known Problems

Related Documentation at Web Site

No No No

Note MATLAB Builder for Excel 1.0 was initially released in Web-downloadable form after Release 12.1 was released, but before Release

13.

MATLAB Builder for Excel provides the capability to incorporate seamlessly and quickly MATLAB models and functions into Excel worksheets. A graphical user interface enables you to build and deploy Excel Add-Ins containing functionality designed in MATLAB but accessed from the Excel environment.

Using MATLAB Builder for Excel to create a deployable application is a simple process requiring a sequence of six steps:

1 Creating a project

2 Managing MATLAB and MEX-files

3 Building a project

4 Testing the model

5 Creating an Excel Add-In

6 Packaging and distributing the component

The new feature introduced in Version 1.1 is the Function Wizard.

Function Wizard

The Function Wiz compiled MATLAB cells in the wor to Excel worksh programming i

ard lets you pass Microsoft Excel worksheet values to a

model and to return model output to a cell or range of

ksheet. The Function Wizard provides an intuitive interface

eets. Knowledge of Visual Basic for Applications (VBA)

s not required.

Version 1.1 (R13) MATLAB® Builder™ EX Software

The Function W such as range Function Wiz functions to see the User

Note At thi struct, or

ard to control the placement and output of data from MATLAB

the worksheets. For complete documentation of this new feature,

’s Guide.

s release the Function Wizard is not able to process the sparse,

complex data types.

izard reflects any changes that you make in the works h ee t s,

selections. Going in the opposite direction, you can use the

MATLAB®Builder™ EX Release Notes

Compatibility Summary for MATLAB® Builder™ EX Software

This table summarizes new features and changes that might cause incompatibilities when you upgrade from an earlier version, or wh en you use files on multiple versions. Details are provided in the description of the new feature or change.

Version (Release) New Features and Changes with

Version Compatib ility Impact

Latest Version V1.2.15 (R2010a)

V1.2.13 (R2009b) See “New Format for Deployment

None

Tool Projects” on page 5.

V1.2.12 (R2009a)

V1.2.11 (R2008b) See “Warning Results When Running

V1.2.10 (R2008a)

V1.2.9 (R2007b) See “Functions Being Removed” on

V1.2.8 (R2007a)

V1.2.7 (R2006b) See the Co mpatibility

V1.2.6 (R2006a)

V1.2.5 (R14SP3)

V1.2.4 (R14SP2)

V1.2.2 (R14SP1)

V1.2.1 (R14+)

None

Figure-Generating Applications or Printing with -nojvm Flag” on page

None

page 10.

None

Considerations subheading for “New U ser Interface” on page 15.

None

Compatibility Summary for MATLAB® Builder™ EX Software

Version (Release) New Features and Changes with

Version Compatib ility Impact

V1.2 (R14) See the Compatibility

Considerations subheading

for “New Product Name” on page 21.

V1.1 (R13)

None

Mathworks MATLAB BUILDER EX RELEASE NOTES

Specifications and Main Features

Frequently Asked Questions

User Manual