Mathworks MATLAB BUILDER EX RELEASE NOTES

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
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
© COPYRIGHT 2002–20 10 by The MathWorks, Inc.
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
®
Builder EX
®
Builder EX
®
Builder EX
®
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)
on
(R2008b)
New Features and Changes
Yes Details
Yes Details
Yes Details
Yes Details
No No Bug Reports
Yes
ls
Detai
Yes Details
Yes Details
Ver sion Compatibilit Consideratio
No Bug Reports
Yes Summary
No Bug Repor
Yes Summary
Yes Summa
No Bug Reports
Yes Summary
ry
y
ns
Fixed Bugs and Known Problems
Includes fix
Bug Reports Includes fixes
ts
Includes
Bug Reports Includes fixes
Includes fixes
Bug Re Inclu
Includes fixes
Bug Reports Includes fixes
fixes
ports
des fixes
es
Related Documentation at Web Site
Printable Release Notes: PDF
Current product documentation
No
No
No
No
No
No
No
V1.2.6 (R2006a)
.2.5 (R14SP3)
V1
V1.2.4 (R14SP2)
V1.2.2 (R14SP1)
No No Bug
No No Bug Reports
No No
No No
Reports
ludes fixes
Inc
Includes fixes
ixed bugs
F
ixed bugs
F
No
No
No
No
1
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
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
No
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
2
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.
3
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
4
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
5
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
6
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
No
-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
7
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.
8
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
No
9
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
Undefined Function Error
Undefined Function Error
Undefined Function Error
Use This Instead Compatibility
MCRInstaller.exe
(Windows),
MCRInstaller.bin (UNIX), MCRInstaller.dmg (Mac)
deploytool
deploytool
deploytool
deploytool
Related Documentation at Web Site
No
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.
10
Version 1.2.9 (R2007b) MATLAB® Builder™ EX Software
Function Being Removed
openmxl
opencbl
What Happens When You Run the Function?
Undefined Function Error
Undefined Function Error
Use This Instead Compatibility
Considerations
deploytool
deploytool
Migrate to
deploytool.
Migrate to
deploytool.
11
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
No
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.
12
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
register DLLs. When
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)
13
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/
14
Version 1.2.7 (R2006b) MATLAB® Builder™ EX Software
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
No
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
15
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
No
16
Version 1.2.5 (R14SP3) MATLAB® Builder™ EX Software
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
No
17
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
No
18
Version 1.2.2 (R14SP1) MATLAB® Builder™ EX Software
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
No
19
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
No
20
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
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.
21
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
22
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
23
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
7.
None
page 10.
None
Considerations subheading for “New U ser Interface” on page 15.
None
None
None
None
None
24
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
25
Loading...