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™ NE Release Notes
Summary by Version ...............................1
Contents
Version 3.1 (R2010a) MATLAB
®
Version 3.0.2 (R2009b) MATLAB
Software
........................................5
Version 3.0.1 (R 20 0 9a) MATL AB
Software
Version 3.0 (R2008b) MATLAB
........................................7
®
Version 2.2.2 (R 20 0 8a) MATL AB
Software
........................................12
Version 2.2.1 (R2007b) MATLAB
Software
Version 2.2 (R2007a) MATLAB
Version 2.1 (R2006b) MATLAB
Version 2.0 (R2006a) MATLAB
........................................14
®
®
®
Builder NE Software ..4
®
Builder NE
®
Builder NE
Builder NE Software ..9
®
Builder NE
®
Builder NE
Builder NE Software ..16
Builder NE Software ..19
Builder NE Software ..22
Compatibility Summary for MATLAB
Software
........................................23
®
Builder NE
iii
ivContents
SummarybyVersion
This table provides quick access to what’s new in each version. For
clarification, see “Using Release Notes” on page 2 .
MATLAB®Builder™ NE Release Notes
Version
(Release)
Latest Versi
V3.1 (R2010a
V3.0.2 (R2009b)
V3.0.1 (R2009a)
V3.0 (R2
V2.2.2 (R2008a)
V2.2.1 (R2007b)
R2007a)
V2.2 (
V2.1 (R2006b)
on
)
008b)
New Features
and Changes
Yes
Details
Yes
Details
Yes
Details
Yes
Details
Yes
Details
Yes
ls
Detai
Yes
Details
Yes
Details
Version
Compatibilit
Consideratio
NoBug Reports
Yes
Summary
NoBug Repor
Yes
Summary
NoBug Reports
Yes
Summa
NoBug 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 R elease
Notes: PDF
Current product
documentation
No
No
No
No
No
No
No
V2.0 (R2006a)
Yes
Det
NoNoNo
ails
1
MATLAB®Builder™ NE Release Notes
Using Release No
Use release note
• New features
• Changes
• Potential imp
Review the re
product (for
bugs, or comp
If you are up
review the c
you upgrad
What Is in t
New Featu
• New func
• Changes
s when upgrading to a new er version to learn about:
act o n your existing files and practices
lease notes for other M athWorks™ products required for this
example, MATLAB
atibility considerations in other products impact you.
grading from a softw are version other than the most recent one,
urrent release notes and all interim versions. For example, when
e from V1.0 to V1.2, review the release notes for V1.1 and V1.2.
he Release Notes
res and Changes
tionality
to existing functionality
tes
®
or Simulink®). Determine if enhancements,
Versio
When a n
versi
impac
Comp
Repo
in in
comp
Fix
The
vi
n Compatibility Considerations
ew feature or change introduces a reported incompatibil ity between
ons, the Compatibility Considerations subsection explains the
t.
atibility issues reported after the product release appear under Bug
rts at The MathWorks™ Web site. Bug fixes can sometimes result
compatibilities, so review the fixed bugs in Bug Reports for any
atibility impact.
ed Bugs and Known Problems
MathWorks offers a user-searchable Bug Reports database so you can
ew Bug Reports. The development team updates this database at release
2
SummarybyVersion
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™ NE Release Notes
Version 3.1 (R2010a) MATLAB Builder NE Software
This table summarizes what’s new in Version 3.1 (R2010a):
New Features and
Changes
Yes
Details below
Version
Compatibility
Considerations
NoBug Reports
New features and changes introduced in this version are:
Fixed Bugs an d
Known Problems
Includes fixes
Related
Documentation at
Web Site
Printable Release
Notes: PDF
Current product
documentation
Native Data Types Available for Cell Arrays and
Data Structures
MATLAB Programmers now have the option of using native .NE T data types
for cell array and data structure h andl ing. These native types provide data
in a more useful, easy-to-process output. See “Using the Native .NET API:
The Cell and Struct Example” for more information about using the feature
with MATLAB
®
Builder™ NE.
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.
New Video Demo Available
Watch a video about deploying applications using MATLAB Builder NE.
Support for .NET Framework Versions 3.0 and 3.5
In addition to supporting Microsoft®.NET Framework 2.0, MATLAB Builder
NE now a ls o supports versions 3.0 and 3.5.
4
Version 3.0.2 (R2009b) MATLAB®Builder™ NE Software
Version 3.0.2 (R2009b) MATLAB Builder NE Software
This table summarizes what’s new in Version 3.0.2 (R2009b):
New Features and
Changes
Yes
Details below
Version
Compatibility
Considerations
Yes
Summary
New features and changes introduced in this version are:
• “Redesigned Deployment Tool GUI ” on page 5
• “Memory Management Reliability, Performance Improved for H osted
Applications” on page 5
• “Alternate Graphic R enderers Now Available” on page 6
• “Enhanced Auto-Generated Documentation” on page 6
• “New Format for Deployment Tool Projects” on page 6
Fixed Bugs an d
Known Problems
Bug Reports
Includes fixes
Related
Documentation at
Web Site
Printable Release
Notes: PDF
Current product
documentation
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.
Memory Management Reliability, Performance
Improved for Hosted Applications
Several enhancements have increased the reliability and performance
of memory management in hosted applications such as ASP.NET and
MicrosoftWindows
memory management have been deprecated in this release.
®
services. As a result, previous manual methods of
5
MATLAB®Builder™ NE Release Notes
Alternate Graph
Graphic rendere
“Supported Rend
Enhanced Auto
Compiled Comp
This document
integrating
Windows envi
for more info
New Format f
If you have
R2009b, th
changed in
dep
loytool
Tool (
rs Z-Buffer and OpenGL are now available for invocation. See
erers for WebFigures” for more information.
-Generated Documentation
onents now feature expanded MWArray API docum entation.
ation is of particular interest to the .NET developer who is
components produced by MATLAB Builder NE into enterprise
ronments. See “Using Enhanced XML Documentation Files”
rmation.
or Deployment Tool Projects
projects that were created with the Deployment Tool prior to
ose projects will continue t o work. However, projects created or
R2009b cannot be opened in previous versions of Deployment
).
ic Renderers Now Available
6
Version 3.0.1 (R2009a) MATLAB®Builder™ NE Software
Version 3.0.1 (R2009a) MATLAB Builder NE Software
This table summarizes what’s new in Version 3.0.1 (R2009a):
New Features and
Changes
Yes
Details below
Version
Compatibility
Considerations
NoBug Reports
New features and changes introduced in this version are:
• “Reduced MCR Size Saves on T ransfer Time” on page 7
• “Customized readme.txt Produced with Each Compilation” on page 7
• “Specify Run-Time Options to the MATLAB Compiler Runtime (MCR)”
on page 7
Fixed Bugs an d
Known Problems
Includes fixes
Related
Documentation at
Web Site
Printable Release
Notes: PDF
Current product
documentation
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 NE deplo yment requirements.
Specify Run-Time Options to the MATLAB Compiler
Runtime (MCR)
You can now specify run-time options -nojvm and -logfile to the MA TLAB
Compiler Runtime (MCR). For more information about this feature, see
7
MATLAB®Builder™ NE Release Notes
“Dynamically Specifying Run-Time Options to the MCR” in the product user
guide.
8
Version 3.0 (R2008b) MATLAB®Builder™ NE So ftware
Version 3.0 (R2008b) MATLAB Builder NE Software
This table summarizes what’s new in Version 3.0 (R2008b):
New Features and
Changes
Yes
Details below
Version
Compatibility
Considerations
Yes
Summary
New features and changes introduced in this version are:
• “.NET Components Now Available for Remoting to Distributed .NET
Frameworks” on page 9
• “Web Deployment of MATLAB Figures A vailable” on page 10
• “CTF Archives Now E mbedde d in a Single Binary Executable for
Convenient Deployment of .NET and COM Components” on page 10
• “Applications Created with Parallel Computing Toolbox Now Able to Be
Compiled” on page 10
• “Support Dropped for .NET Framework Version 1.1 in R2008b” on page 10
• “Warning Results When Running Figure-Generating Applications or
Printing with -nojvm Flag” on page 10
• “MWException Replaced by .NET Exception Class” on page 11
Fixed Bugs an d
Known Problems
Bug Reports
Includes fixes
Related
Documentation at
Web Site
No
• “Same Name Class Objects Shared Between MCR Instances Do Not Work
Correctly ” on page 11
.NET Components Now Available for Remoting to
Distributed .NET Frameworks
.NET components can now be created that are ready for interfacing
with distributed .NET Frameworks. For more information, see “Sharing
Components Across Distributed Applications Using .NET Remoting” in the
MATLAB Builder NE User’s Guide.
9
MATLAB®Builder™ NE Release Notes
Web Deployment of MATLAB Figures Available
Manipulation of MATLAB figures over the We b is now available through
implementation of the W eb Figures feature. For more information, see
“Deploying a MATLAB Figure Over the Web Using WebFigures” in the
MATLAB Builder NE User’s Guide.
CTF Archives Now Embedded in a Single Binary
Executable for Convenient Deployment of .NET and
COM Components
As of R2008b, CTF data is now automatically embedded directly in .NET and
COM components by default for convenient deployment of applications. See
“Overriding Default CTF Archive Embedding for Components Using the MCR
Component Cache” and “About Embedded CTF Archives” in the MATLAB
Builder NE User’s Guide.
Applications Created with Parallel Computing
Toolbox Now Able to Be Compile d
MATLAB applications that make use of the Parallel Computing Toolbox™
(PCT)arenowabletobecompiled. Resultingexecutablesandcomponents
can scale to multicore and multiprocessing environments using MATLAB
Distributed Computing Server™. See “Improving Data Access Using the
MCR User Data Interface and MATLAB Builder NE” in the MATLAB Builder
NE User’s Guide.
®
10
Support Dropped for .NET Framework Version 1.1
in R2008b
MATLAB Builder NE no longer supports Microsoft .NET Framework 1 .1.
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
-R
Version 3.0 (R2008b) MATLAB®Builder™ NE So ftware
-nojvm, will not result in displayable graphics. In a future release, the
-nojvm option will no longer support figure-generating or printing and will
be removed.
MWException Replaced by .NET Exception Class
In order to better support the .NET Remoting feature (see “Sharing
Components A cross Distributed Applications Using .NET Remoting”) in this
release, the
or an in the encapsulated MATLAB code is being replaced by the .NET
Exception class. You should modify your code accordingly to test for a
standard .NET
MWException thrown by an error in the generated component
Exception rather than MWException.
Same Name Class Objects Shared Between MCR
Instances Do Not Work Correctly
IfthesameclassnameisusedintwoormoreseparateMCRinstanceswithin
thesameprocess,theobjectwillnotwork correctly. This bug impacts all
component based targets: C/C++ shared libraries , COM/.Net targets, and
Java targets. This bug does not affect standalone executables. This is due to a
bug in the MATLAB Object System and is being addressed.
11
MATLAB®Builder™ NE Release Notes
Version 2.2.2 (R2008a) MATLAB Builder NE Software
This table summarizes what’s new in Version 2.2.2 (R2008a):
New Features and
Changes
Yes
Details below
Version
Compatibility
Considerations
NoBug Reports
New features and changes introduced in this version are:
• “Improved Error Diagnostics Available” on page 12
• “Support Being Dropped for .NET Framework Version 1.1 in R2008b” on
page 12
• “MATLAB Application Deployment Web Example Guide Available” on
page 12
Fixed Bugs an d
Known Problems
Includes fixes
Related
Documentation at
Web Site
No
Improved Error Diagnostics Available
You can receive enhanced error reporting information by using mstack traces.
See “Enhanced Error Diagnostics Using mstack Trace” in the MATLAB
Builder NE User’s Guide documentation for details.
Support Being Dropped for .NET Framework Version
1.1 in R2008b
MATLAB Builder NE will no longer support Microsoft .NET Framework 1.1
in R2008b. Please plan accordingly.
12
MATLAB Application Deployment Web Example
Guide Available
A new publication, the MATLAB Application Deployment Web Example
Guide, is now available from the MATLAB
NE, and MA TLAB Builder JA roadmap pages.
®
Compiler™, MATLAB Builder
Version 2.2.2 (R2008a) MATLAB®Builder™ NE Software
The guide provides full examples of common tasks performed by the MATLAB
programmer, IT specialist, and others who play significant roles in deploying
MATLAB applications to the Web.
13
MATLAB®Builder™ NE Release Notes
Version 2.2.1 (R2007b) MATLAB Builder NE Software
This table summarizes what’s new in Version 2.2.1 (R2007b):
New Features and
Changes
Yes
Details below
Functi
Remove
buildmcr
comtool
on Being
d
Version
Compatibility
Considerations
Yes
Summary
Fixed Bugs an d
Known Problems
Bug Reports
Includes fixes
Functions Being Removed
The following functions were removed in R2007b:
What Happens
When You Run the
Function?
s
Error
Undefined Function
Error
Use This InsteadCompatibility
MCRInstaller.exe
(Windows),
MCRInstaller.bin (UNIX),
MCRInstaller.dmg (Mac)
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.
14
Version 2.2.1 (R2007b) MATLAB®Builder™ NE Software
Function Being
Removed
dotnettool
mxltool
opennbl
openmxl
opencbl
What Happens
When You Run the
Function?
Undefined Function
Error
Undefined Function
Error
Undefined Function
Error
Undefined Function
Error
Undefined Function
Error
Use This InsteadCompatibility
Considerations
deploytool
deploytool
deploytool
deploytool
deploytool
Migrate to
deploytool.
Migrate to
deploytool.
Migrate to
deploytool.
Migrate to
deploytool
Migrate to
deploytoo
l
.
.
15
MATLAB®Builder™ NE Release Notes
Version 2.2 (R2007a) MATLAB Builder NE Software
This table summarizes what’s new in Version 2.2 (R2007a):
New Features and
Changes
Yes
Details below
Version
Compatibility
Considerations
NoBug Reports
Fixed Bugs an d
Known Problems
Related
Documentation at
Web Site
No
Includes fixes
New features and changes introduced in this version are:
• “Support Added for Win64” on page 16
• “Issues with the Microsoft Windows Vista Operating System ” on page 16
• “Unsupported MATLAB Data Types” on page 18
Support Added for Win64
Support has been added for the Windows 64-bit operating system.
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.
16
• With User Account Control (UAC) enabled, a standard user is not able to
write to a folder in the
c:\Program Files folder. See the MATLAB Release
Notes for more details re garding this issue.
• With User Account Control (UAC) enabled, a standard user is not able to
• 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.
17
MATLAB®Builder™ NE Release Notes
Printing with Vista 64-bit installed results in an error message that lists a
manifest as missing. Please check
for updates on these issues.
Unsupported MATLAB Data Types
The MATLAB Builder NE product does not support MATLAB object data
types (for example, Time Series Objects) and most unsigned numeric types.
http://www.mathworks.com/support/
18
Version 2.1 (R2006b) MATLAB®Builder™ NE So ftware
Version 2.1 (R2006b) MATLAB Builder NE Software
This table summarizes what’s new in Version 2.1 (R2006b):
New Features and
Changes
Yes
Details below
Version
Compatibility
Considerations
Yes
Summary
New features and changes introduced in this version are:
• “New User Interface” on page 19
• “Support for Shared Assemblies” on page 20
• “Support for Nested Namespace s” on page 20
• “Support for .NET Framework Version” on page 20
• “Additional Support for Microsoft Visual Studio .NET Users” on page 21
• “Known Issues” on page 2 1
Fixed Bugs an d
Known Problems
Bug Reports
Includes fixes
Seealso“Known
Issues” on page 21.
Related
Documentation at
Web Site
No
New User Interface
This release of MATLAB Builder for .NET provides a new graphical user
interface for creating and building projects. Issue the
inMATLABtousethenewGUI.
deploytool command
Compatibility Considerations
Projects built with the previous user interface cannot be used with the
new interface. For the current release, you can still issue the
command to access projects from a previous release. The next release of
MATLAB Builder for .NET will no longer support
from the previous user interface.
dotnettool, or projects
dotnettool
19
MATLAB®Builder™ NE Release Notes
Support for Shared Assemblies
When you create a .NET component using the mcc command or the
Deployment Tool, you can tell builder to create a shared assembly . Click MoreSettings in the De pl o y ment To o l dialog box, and select .NET Component in
the navigation pane.
Support for Nested Namespaces
MATLAB Builder for .NET now supports nested namespaces, which you can
use to create a hierarchical naming structure for types.
Support for .NET Framework Version
You can now specify which version of the .NET Framework you want to use
when compiling a component using the
You can specify any of the following three values.
mcc command of the Deployment Tool.
Version Valu e
0.0
1.1
2.0
Meaning
Use the latest supported version of the framework
that is available on the system.
Use Version 1.1
Use Version 2.0
Compatibility Considerations
In previo us releases, y ou can spe cify a version number w hen creating a .NET
component, but the value was not used. In this release, the version numbers
specify which version of the .NET Framework to use. Note also that the
interpretation of version number with MATLAB Builder for .NET is different
from COM Builder. In COM Builder, the version number specifies the version
of the component being created.
20
Version 2.1 (R2006b) MATLAB®Builder™ NE So ftware
Additional Support for Microsoft Visual Studio .NET
Users
MWArray.dll Added to Reference Tab
MATLAB Builder for .NET now adds the MWArray.dll containing the data
conversion classes to the list of .NET components accessible from the AddReference tab in Microsoft Visual Studio .NET.
Sample Applications on Visual Studio .NET 2005
The set of sample applications in
matlabroot\toolbox\dotnetbuilder\Examples now includes applica tion s
for Visual Studio .NET 2005, as well as for Visual Studio .NET 2003.
Known Issues
The following issue is known and a patch to fix the problem is available at
the linked bug report.
Data Returned by ToArray Referencing Sparse Format May
Be Corrupt
The data returned by calling ToArray on a MWNumericArray
or MWLogicalArray object that references a MATLAB array
stored in sparse format may be incorrect or corrupted. More
information and a patch that corrects this issue may be found
at the Customer Bug Reports area of the MathWorks Web site:
http://www.mathworks.com/support/bugreports/index.html?release=R2006b.
At the Bug Reports page, select R2006b in the Release list, and select
MATLAB Builder for .NET in the Product list.
This bug does not affect normal (non-sparse) arrays, nor does it affect other
methods of retrieving data from a sparse array, such as
and
getData.
get, getDouble,
21
MATLAB®Builder™ NE Release Notes
Version 2.0 (R2006a) MATLAB Builder NE Software
This table summarizes what’s new in Version 2.0 (R2006a):
New Features and
Changes
Yes
Details below
Version
Compatibility
Considerations
NoNoNo
MATLAB Builder for .NET extends MATLAB Compiler with tools for
automatically generating independent .NET assemblies or Common Object
Model (COM) objects from your MATLAB algorithms.
These tools allow you to do the following:
• Convert your MATLAB algorithms into .NET or COM components via a
graphics user interface
• Create .NET assemblies that can be called from C#, VB.NET, or any other
CLS-compliant technology
• Create COM o bjects that can be called from Visual Basic, ASP, Microsoft
Excel, or any other COM-compliant technology
• Support conversion between native .NET and COM data types and the
MATLAB array data types, using data conversion classes
• Enable unlimited free desktop and Web deployment of independent
components
Fixed Bugs an d
Known Problems
Related
Documentation at
Web Site
22
Compatibility Summary for MATLAB®Builder™ NE Software
Compatibility Summary for MATLAB Builder NE 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
Compatibility Impact
Latest Version
V3.1 (R2010a)
V3.0.2 (R2009b)See “New Format for Deployment Tool Projects”
V3.0.1 (R2009a)
V3.0 (R2008b)See “Warning R esults When Running
V2.2.2 (R2008a)
V2.2.1 (R2007b)See “Functions Being Removed” on page 14.
V2.2 (R2007a)
V2.1 (R2006b)See the Compatibility Considerations
V2.0 (R2006a)
None
on page 6
None
Figure-Generating Applications or Printing
with -nojvm Flag” on page 10.
None
None
subheading for each of these new features or
changes:
• “New User Interface” on page 19
• “Support for . NE T Framework Version” on
page 20
None
23
Loading...
+ hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.