Mathworks MATLAB BUILDER JA RELEASE NOTES

Download

MATLAB Notes

Builder™ JA 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™ JA Release Notes

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

Contents

Version 2.1 (R2010a) MATLAB

Version 2.0.4 (R2009b) MATLAB

Software

Version 2.0.3 (R2009a) MATLAB

Software

Version 2.0.2 (R2008b) MATLAB

Software

Version 2.0.1 (R2008a) MATLAB

Software

Version 2.0 (R2007b) MATLAB® Builder for Java™

Software

Version 1.1 (R2007a) M ATLAB® Builder for Java™

Software

Version 1.0 (R2006b) MATLAB® Builder for Java™

Software

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

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

........................................ 8

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

........................................ 11

........................................ 14

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

Builder JA Software .. 3

Builder JA

Compatibility Summary for MATL AB® Builder™ JA

Software

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

iii

iv Contents

SummarybyVersion

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

MATLAB®Builder™ JA Release Notes

Version (Release)

Latest Versi V2.1 (R2010a

V2.0.4 (R2009b)

V2.0.3 (R2009a)

V2.0.2 (

V 2.0.1 (R2008a)

V2.0 (R2007b)

R2007a)

V1.1 (

V1.0 (R2006b)

)

R2008b)

New Features and Changes

Yes Details

Yes

Detai

Yes Details

Ver sion Compatibilit Consideratio

No Bug Reports

Yes Summary

No Bug Repor

Yes Summary

No Bug Reports No

Yes Summa

No Bug Reports No

No No No

Fixed Bugs

and Known

Problems

Bug Reports No

Bug Re

ports

Related Documentation at Web Site

Printable Release Notes: PDF

Current product documentation

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

MATLAB®Builder™ JA Release Notes

Review the release notes for other MathWorks™ products required for this product (for example, MATLAB

or Simulink®). Determine if enhancements,

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.

What Is in the Release Notes

New Features and Changes

• New functionality

• Changes to existing functionality

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.

Version 2.1 (R2010a) MATLAB®Builder™ JA Software

Version 2.1 (R2010a) MATLAB Builder JA Software

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

New Features and Changes

Yes Details below

Version Compatibility Considerations

No Bug Reports

Fixed Bugs an d Known Problems

Related Documentation at Web Site

Printable Release Notes: PDF

Current product documentation

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.

Native Data Types Available for Cell Arrays and Data Structures

MATLAB Programmers now have the option of using native Java™ data types for cell array and data structure handling. These native types provide data in a more useful, easy-to-process output. See “Using Native Java with Cell Arrays and Struct Arrays” for more information about using the feature with MATLAB

Builder™ JA.

MATLAB®Builder™ JA Release Notes

Version 2.0.4 (R2009b) MATLAB Builder JA Software

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

New Features and Changes

Yes Details below

Version Compatibility Considerations

Yes Summary

Fixed Bugs an d Known Problems

Bug Reports

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.

Alternate Graphic Renderers Now Available

Graphic renderers Z-Buffer and OpenGL are now available for invocation. See “Supported Renderers for WebFigures” for more information.

Mac 64-Bit Support Available

Support for Macintosh®64-bit processors is now available.

JRE Auto-Detection Available for Web Applications

TheJavaRuntime(JRE)auto-detection code (previously available for MATLAB Builder JA co mpo n ents) is now available to Web applications, through support on Web servers.

New Video Demo Available

Watch a video about deploying applications using MATLAB Builder JA.

Version 2.0.4 (R2009b) MATLAB®Builder™ JA So ftware

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).

MATLAB®Builder™ JA Release Notes

Version 2.0.3 (R2009a) MATLAB Builder JA Software

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

New Features and Changes

Yes Details below

Version Compatibility Considerations

None Bug Reports

Fixed Bugs an d Known Problems

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 M ATLAB Builder JA deployment requirements.

Ability to S pecify Run-Time Options to the MATLAB Compiler Runtime (MCR)

You can now specify run-time options -nojvm, -nodisplay,and-logfile to the MATLAB Compiler Runtime (MCR). For more information about this feature, see “Dynamically Specifying Run-Time Options to the MCR” in the product user guide.

Version 2.0.3 (R2009a) MATLAB®Builder™ JA So ftware

Enhanced Javado

Auto-generated interest to Java Classes and Met

Sun™ Javadoc has been enhanced to include information of

developers. For more information, see “Learning About Java hods by Exploring the Javadoc” in the product user guide.

MATLAB®Builder™ JA Release Notes

Version 2.0.2 (R2008b) MATLAB Builder JA Software

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

New Features and Changes

Yes Details below

Version Compatibility Considerations

Yes Summary

Fixed Bugs an d Known Problems

Bug Reports No

Related Documentation at Web Site

Applications Created with Parallel Computing Toolbox Now Can Be Compiled

MATLAB applications that use the Parallel Computing Toolbox™ are now able to be compiled. Resulting executables and components can scale to multicore and multiprocessing environments usin g MATLAB Distributed Computing S erver. For more information, see “Improving Data Access Using the M CR User Data Interface and MATLAB Builder JA” in the product user guide.

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.

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

-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

Version 2.0.2 (R2008b) MATLAB®Builder™ JA So ftware

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

MATLAB®Builder™ JA Release Notes

Version 2.0.1 (R2008a) MATLAB Builder JA Software

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

New Features and Changes

Yes Details below

Version Compatibility Considerations

No Bug Reports No

Fixed Bugs an d Known Problems

Related Documentation at Web Site

MATLAB Application Deployment Web Example Guide Available

A new publication, the MATLAB Application Deployment Web Example Guide, is now available from the MATLAB

JA, and MATLAB Builder NE roadmap pages. From MATLAB, select Help > Product Help and select the product from the left pane.

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.

Compiler™, MATLAB Builder

Version 2.0 (R2007b) MATLAB® Builder for Java™ Software

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

New Features and Changes

Yes Details below

Version Compatibility Considerations

Yes Summary

New features and changes introduced in this version are:

• “Support for RMI” on page 11

• “Interactive MATLAB Graphics Support (WebFigures)” on page 11

• “Enhanced CTF Archives” on page 12

• “Web Deployment Documentation” on page 12

• “Enhanced Javadoc Support” on page 12

• “Functions Being Rem oved” on page 12

Fixed Bugs an d Known Problems

Bug Reports No

Related Documentation at Web Site

Support for RMI

The Sun Microsystems® Java™ native RPC mechanism, RMI, is now supported for “Creating Scalable W eb Applications Using RMI”. RMI support enables automatic generation of interface code for Java re moting , allowing components to be started in separate processes.

Interactive MATLAB Graphics Support (WebFigures)

Interactive graphics are now available for user-developed Web applications, using AJAX technology to enable rotating, zooming, and panning. See “Deploying a Java Component Over the Web” for more information.

MATLAB®Builder™ JA Release Notes

Function Being Removed

buildmcr

comtool

dotnettool

Enhanced CTF Arc

Output JAR files convenient depl

containing embedded CTF files are now produced for more

oyment.

Web Deploymen

The basics of W Web graphics, User’s Guide

Enhanced Ja

Sun Microsy Web site and component

Functions

The follo

wing functions were removed in R2007b:

What Happens When You Run the Function?

Errors

Undefined Function Error

eb deployment with MATLAB Builder for Java, interactive

and performance features using RMI are now included in the

documentation.

vadoc Support

stems® Javadoc™ is now searchable from the MathWorks

is also available within packaged MATLAB B uilder for Java

Being Removed

hives

t Documentation

Use This Instead Compatibility

Considerations

MCRInstaller.exe

(Windows),

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

deploytool

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

Mig

dep

ploytool

rate to

loytool

grate to

Version 2.0 (R2007b) MATLAB® Builder for Java™ Software

Function Being Removed

mxltool

opennbl

openmxl

opencbl

What Happens When You Run the Function?

Undefined Function Error

Use This Instead Compatibility

Considerations

deploytool

Migrate to

deploytool.

Migrate to

deploytool.

Migrate to

deploytool.

Migrate to

deploytool

MATLAB®Builder™ JA Release Notes

Version 1.1 (R2007a) MATLAB® Builder for Java™ Software

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

New Features and Changes

Yes Details below

Version Compatibility Considerations

No Bug Reports No

New features and changes introduced in this version are:

• “Support Added for Win 64, M ac, Intel Mac, and Solaris 64” on page 14

• “Support Dropped for Solaris 2” on page 14

• “Java Objects Accessible by the MATLAB Java Interface” on page 15

• “Conversion Methods Available for Java Primitive Types” on page 15

• “Image Conversion from RGB to Java AWT Format Available” on page 15

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

Fixed Bugs an d Known Problems

Related Documentation at Web Site

Support Added for Win 64, Mac, Intel Mac, and Solaris 64

Support has been added for the following operating systems:

• Windows

64-bit

• Macintosh

• Intel

• Solaris™ 64-bit

Mac

Support Dropped for Solaris 2

Support has been dropped for the Solaris 2 operating system. It has been replaced by suppo rt for Solaris 64.

Version 1.1 (R2007a) MATLAB® Builder for Java™ Software

Java Objects Acc Interface

Java objects can and be fully acc

Conversion Me

now b e passed by reference to compiled MATLAB functions

essible by the MATLAB Java interface.

thods Available for Java Primitive

Types

Conversion m data into Jav

Image Conve

ethods are now available that force MATLAB numeric array

a primitive numeric types.

rsion from RGB to Java AWT Format

Available

Conversio now availa

Issues wi

n of R GB image data to Java AWT image object data format is

ble.

th the Microsoft Windows Vista O perating

System

The foll resolve

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

essible by the MATLAB Java

• With Us

write t Notes f

• With U

regis the fo

er Account Control (UAC) enabled, a standard user is not able to

o a folder in the

or more details regarding this issue.

ser Account Control (UAC) enabled, a standard user is not able to

ter DLLs. When

llowing 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\

c:\Program Files folder. See the MATLAB Release

mbuild -setup attempts to register mwcomutil.dll,

MATLAB®Builder™ JA Release Notes

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.

PermissionSet reqdPset, PermissionSet optPset, PermissionSet denyPset,

PermissionSet& denied, Boolean checkExecutionPermission)

PermissionSet reqdPset, PermissionSet optPset, PermissionSet denyPset,

PermissionSet& denied, Int32& securitySpecialFlags, Boolean

checkExecutionPermission)

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

• 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

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

for updates on these issues.

Version 1.0 (R2006b) MATLAB® Builder for Java™ Software

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

New Features and Changes

Yes Details below

Version Compatibility Considerations

No Bug Reports

New feature

• “Introduc

• “Support f

• “Deploym

• “Known Is

Introdu

MATLAB Use thi that co as a met

When y

rting files generated by the builder as well as the MATLAB Component

suppo

ime (MCR), which is provided by the product. Your users do not have to

Runt

hase and install MATLAB.

purc

s and changes introduced in this version are:

ing MATLAB

or MATLAB Features in Java” on page 17

ent Tool User Interface” on page 18

sues” on page 18

cing MATLAB Builder for Java

Builder for Java™ is an extension to MATLAB Compiler software.

s builder to wrap MATLAB functions into one or more Java classes

mprise a Java package. E ach of the MATLAB functions is encapsulated

hod of a Java class and can be invoked from within a Java application.

ou distribute the application to your users, you must include

Fixed Bugs an d Known Problems

Seealso“Known Issues” on page 18.

Builder for Java” on page 17

Related Documentation at Web Site

Supp

MAT arr cal pr

ort for MATLAB Features in Java

LAB Builder for Java provides robust data conversion, indexing, and

ay formatting capabilities to preserve the flexibility of MATLAB when

led from Java code. To support the MATLAB data types, the builder

ovides the

MWArray class hierarchy. You can use MWArray and other Java

MATLAB®Builder™ JA Release Notes

class members in your application to convert native arrays to MATLAB arrays and vice versa. bui ld er also provides automatic data conversion for passing arguments that are Java types.

MATLAB Builder for Java provides custom error handling so that errors originating from MATLAB functions are reported as standard exception s. The error description contains specific references to the MATLAB code, thus simplifying the debugging process.

Deployment Tool User Interface

To use the builder, open the Deployment Tool by issuing the following MATLAB command:

deploytool

You can use the Deployment Tool to create a project that encapsulates MATLAB code. You can perform the following tasks using the D eplo yment Tool:

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 can 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 Java in the Product list.

Version 1.0 (R2006b) MATLAB® Builder for Java™ Software

This bug does not affect normal (nonsparse) arrays, nor does it affect other methods of retrieving data from a sparse array, such as and

getData.

get, getDouble,

MATLAB®Builder™ JA Release Notes

Compatibility Summary for MATLAB® Builder™ JA 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 V2.1 (R2010a)

V2.0.4 (R2009b) See “New Format for Deployment

V2.0.3 (R2009a)

V2.0.2 (R2008b) See “Warning Results W hen Running

V2.0.1 (R2008a)

V2.0 (R2007b) See “Functions Being Removed” on

V1.1 (R2007a)

V1.0 (R2006b)

None

Tool Projects” on page 5.

None.

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

None

page 12.

None

Mathworks MATLAB BUILDER JA RELEASE NOTES

Specifications and Main Features

Frequently Asked Questions

User Manual