Contents
Overall
This SDK release fixes important problems
New Additions and Modifications
- Fixed the problem where an app.xml did not read on Windows Simulator.
All
- From this version, made a change for the content protection mechanism to use individual keys. Following this change, a key must be prepared in advance to build an application for, and execute an application on, a device. For details on how to create keys, refer to the applicable document.
PSM Studio
New Additions and Modifications
- The restriction that applied in 0.99.20; when performing debug execution on PlayStation(R)Vita and selecting the [Execute] - [Stop] buttons, the PlayStation(R)Vita unit crashes, or the PSM Studio is not recognized as a target upon subsequent startup even if normal termination is observed; has been fixed.
Limitations
- When PSM Studio carries out execute-with-debug on a PlayStation(R)Vita target and the application is subsequently terminated from the PS button, PSM Studio cannot detect the termination and a state misalignment occurs. Terminate the application from PSM Studio. If a problem exists, manually terminate debug on PSM Studio.
PSM Publishing Utility
New Additions and Modifications
In addition to the feature to edit app.xml provided in 0.99, the following new features are provided.
- Management of keys for content protection
- Management of packages and applications
- Master package submission
Made a change to automatically add default_copyright.txt of SCE to the app.xml Copyright content (upon creating a master package). There is no need to manually copy and paste as in 0.99.
Limitations
- When obtaining a list of applications for an Android device, the application running on the device is terminated.
- Dependent on the timing to connect PlayStation(R)Vita to a USB, the Publishing Utility may be unable to successfully obtain an installed application. To recover from this problem, restart PlayStation(R)Vita.
New Additions and Modifications
- Released PSM Development Assistant (for PlayStation(R)Vita) supporting PSM SDK 1.00.00 as a patch package. To use PSM Development Assistant (for PlayStation(R)Vita) for PSM SDK 1.00.00, the system software version of the PlayStation(R)Vita unit must be 1.80 or later.
All
This SDK release fixes important problems
New Additions and Modifications
- Fixed the problem where a sub-thread did not stop upon terminating the application running on an Android or Windows device.
PSM Studio
Limitations
[Important Notes]
When carrying out debug-execution on a PlayStation(R)Vita target and selecting [Execute] > [Stop], PlayStation(R)Vita may crash; or even when normal termination is reached, PSM Studio may not be detected as a target upon the next startup. To work around this problem, carry out termination processing from PSM Studio by peeling LiveArea(TM) from the PS button of PlayStation(R)Vita.
This problem does not occur for executions without debugs.
PSM Development Assistant (for PlayStation(R)Vita)
New Additions and Modifications
- Released PSM Development Assistant (for PlayStation(R)Vita) supporting PSM SDK 0.99.20 as a patch package.
- Fixed the problem where a crash occurred in Mono under certain conditions.
Services
New Additions and Modifications
- Fixed the problem where the purchase history could not be saved for the InAppPurchaseDialog in the Android development environment. (Note, however, that the button to reset the purchase history still does not work properly. To reset the purchase history, re-install the application.)
Environment
New Additions and Modifications
- Fixed the problem where the value of GamePadButtonMeaning did not return correctly for certain devices.
All
New Additions and Modifications
- Fixed the problem regarding the stability of applications while they are running.
All
This SDK release fixes important problems
Services
New Additions and Modifications
- Made a change so that multiple instances of InAppPurchaseDialog cannot be created at the same time.
UI Composer
New Additions and Modifications
- Removed restriction where startup could only be be carried out from "Run as Administrator".
PSM Publishing Utility
New Additions and Modifications
- Made a change so that the master package cannot be created if a rating check has not been performed.
- Fixed the problem where creation of the master package failed when no product of an In-App Purchase was registered.
- Fixed the problem where managed heap was clipped to 32MiB or less upon rereading app.xml.
- Changed the minimum value of managed heap to 5MiB.
- Fixed the problem regarding the specifications for the parental lock level.
All
Notes on Migrating Projects Created Using Ver. 0.98 to Ver. 0.99
Implemented the "app.xml" application configuration file. Following, "app.cfg" will be removed.
- Given the above, a patch file, project_conv_098to099.bat, will be provided to convert .cs and .csproj app.cfg. To convert the project, carry out one of the following.
Execute on the Console Screen
- Open [Start] - [All Programs] - [Accessories] - [Command Prompt]
- Enter cd "%SCE_PSM_SDK%/tools/" and move the current directory.
- Specify the [sample098_project_folder] top folder of the project to convert to project_conv_098to099.bat and execute.
> project_conv_098to099.bat [sample098_project_folder]
Execute on the Explorer
- On the Explorer, drag-and-drop [sample098_project_folder] to project_conv_098to099.bat.
New Additions and Modifications
Changed the SDK name from "PlayStation(R)Suite SDK" to "PlayStation(R)Mobile SDK".
Changed the API namespace from "Sce.Pss" to "Sce.PlayStation".
Supported signature verification/encryption of files included in an application package.
Changed the number of subdirectories (including files) that can be created under the Application/, Documents/, and Temp/ directories from 5 to 6.
- "/Application/1/2/3/4/5/6.dat" -> OK (same for Documents/, Temp/)
- "/Application/1/2/3/4/5/6/7.dat" -> NG (same for Documents/, Temp/)
Audio
New Additions and Modifications
- Added the Position property to the BgmPlayer class.
Environment
New Additions and Modifications
Eliminated the following class.
- PersistentMemory
Limitations
- The SystemEvent.OnRestored event does not currently operate properly on PlayStation(R)Vita.
Graphics
New Additions and Modifications
- Changed the default screen size to 960x544, the same as PlayStation(R)Vita.
- Changed the value of TextureWrapMode.
Limitations
- PlayStation(R)Vita has the following limitations.
- GraphicsContext.SetVertexBuffer() only applies the first VertexBuffer.
- GraphicsContext.SetPolygonOffset() is not supported. Specified parameters are ignored.
- Texture2D.GenerateMipmap() may not operate correctly.
- TextureCube is not supported. An exception occurs upon creation.
Input
New Additions and Modifications
- Set a dead-band around the central peripheral of the analog stick for GamePad.
Imaging
New Additions and Modifications
- Added the ReadBuffer method to the Image class.
Model
New Additions and Modifications
Corrected the MDX file format and changed the version to 1.00.
MDX files of the old format cannot be used as they are. To use, use the source code project instead of the already-built assembly of the Model API, and replace Md.Loader.cs included in the project with MdxLoader095.cs.
- Implemented the following features.
- Read of the block name and bounding sphere
- Motion transition and motion repeat mode
- UV offset/scale and UV animation
- Material without texture
- Updated the toolkit used by the converter.
- Crosswalk 2013.0
- FBXSDK 2011.3
Services
New Additions and Modifications
- Newly-set up the Sce.PlayStation.Core.Services namespace.
- Newly-set up the API InAppPurchase Dialog for In-App Purchase.
UI Composer
New Additions and Modifications
Added the custom widget feature that enables placement of user-defined widgets
- Removed the custom panel feature provided until 0.98
- For a UIC file to which a custom panel is placed, the custom panel is internally converted to custom widgets
- The addition of the custom panel to WidgetList will be disabled
Enabled file opening by dragging-and-dropping a project file (*.uic) to the running UIComposer.
- Made Anchor.None the initial value of Widget Anchor.
- However, those with limitations on size conversion including CheckBox, DateTimePicker, Slider, ProgressBar, and PopupList are exempt.
Limitations
- Will only start from "Run as Administrator".
UI Toolkit
New Additions and Modifications
- Added a feature for operating on the focus using the gamepad.
- For details, see [UI Toolkit Programming Guide] - [Basic Concepts] - [Operations with Gamepad].
- Changed the key event distribution mechanism.
- For details, see [UI Toolkit Programming Guide] - [Basic Concepts] - [Key Event Distribution].
- Added a feature for specifying the pixel density.
- For details, see [UI Toolkit Programming Guide] - [Basic Concepts] - [Pixel Density].
Changed the Font type property to the UIFont type for each widget.
Changed the Hiding and Hidden event types of Dialog from EventHandler to EventHandler<DialogEventArgs>.
Fixed the problem where scrolling could not be performed correctly when a widget with a different scrolling direction is placed with a parent.
Fixed the problem where too many instances of an item are created with the ListPanel.Move method.
Fixed the problem where immediately after a dialog is closed, a different dialog cannot be displayed.
Deleted the APIs that were obsolete in version 0.98.
PSM Studio
New Additions and Modifications
- Changed the base to MonoDevelop 2.8.8.4.
- Fixed the problem where text was not displayed on the application output window when carrying out debug execution on PlayStation(R)Vita.
- Edits app.xml in coordination with the PSM Publishing Utility.
- Added feature of signature verification/encryption. Content Protection (Plain, Signed, SignedAndEcnrypted) can be selected from File - Property.
Limitations
- On rare occasions, app.exe.mdb is dominated by a process and build fails. When this problem occurs, restart PSM Studio.
- The opening of a project may fail. Close the project once and reopen it.
PSM Publishing Utility
New Additions and Modifications
- New Release
- Creates meta data and creates the master package.
PSM Development Assistant (for PlayStation(R)Vita)
New Additions and Modifications
Following the naming change in SDK, renamed to "PlayStation Mobile Development Assistant".
Released PSM Development Assistant (for PlayStation(R)Vita) 0.99 as a patch package. A version update to 0.99 is possible by selecting the update icon displayed on LiveArea(TM) of PSM Development Assistant (for PlayStation(R)Vita) 0.98 and applying it. To use PSM Development Assistant (for PlayStation(R)Vita) 0.99, the system software version of the PlayStation(R)Vita unit must be 1.69 or later.
In the combination of PSM Studio (formerly: PSS Studio) released in SDK 0.98 and the PSM Development Assistant (for PlayStation(R)Vita) 0.99, note that correct execution cannot be carried out. Always use PSM Development Assistant (for PlayStation(R)Vita) of a version compatible with the SDK version.
- Combinations with correct operation:
- SDK 0.98 and PSM Studio & PSM Development Assistant (for PlayStation(R)Vita) 0.98
- SDK 0.99 and PSM Studio & PSM Development Assistant (for PlayStation(R)Vita) 0.99
- Combinations without correct operation (error upon installation):
- SDK 0.98 and PSM Studio & PSM Development Assistant (for PlayStation(R)Vita) 0.99
- SDK 0.99 and PSM Studio & PSM Development Assistant (for PlayStation(R)Vita) 0.98
Changed image assets.
Added busy dialog displaying "Installing..." during installation from PSM Studio. Locked PS button during installation.
Added item for debug setting within the options menu and a link to the Developer Forum website. The ticket information of the InAppPurchaseDialog on PlayStation(R)Vita is reset by selecting [Debug Settings]-[Reset Ticket Information].
Adjusted the content and the scroll operation of the Intellectual Property Notices page.
Document
New Additions and Modifications
- Added the following documents.
- GameEngine2D Overview
- Basic Usage of the 2D Physical Simulation Physics 2D Library
- In-App Purchase
- About Build Action
- About the Folder Configuration of a PSM Application
- Safe Application Implementation
- Setting Signature and Encryption
- About Uninstallation
- Overview of Creating and Submitting a Master
- Using Publishing Utility
All
New Additions and Modifications
Enabled development and execution on PlayStation(R)Vita of a PSM application. For details, see "Procedure for Executing on PlayStation(R)Vita" in the document.
Added ShallowClone() method to replace the copy constructor of the following classes.
- Texture2D
- TextureCube
- VertexBuffer
- Image
- Font
Changed the directory structure. The files in the application package must be positioned within the Application/ directory. ( "texture/foo.jpg" -> "/Application/texture/foo.jpg" )
Up to five subdirectories (including files) can be created under the Application/, Documents/, and Temp/ directories.
- "/Application/1/2/3/4/5.dat" -> OK (same for Documents/, Temp/)
- "/Application/1/2/3/4/5/6.dat" -> NG (same for Documents/, Temp/)
Sample is installed in the following location by default.
- Windows XP: "C:/Documents and Settings/All Users/Documents/psm/"
- Windows 7: "C:/Users/Public/Documents/psm/"
Changed the name of the program for executing a PSM application on a device to PlayStation(R)Mobile Development Assistant.
Changed the method for starting a PSM application on a device.
- Signing in is no longer required.
- A network connection is required.
Limitations
- When using Windows XP, a USB driver must be installed manually when connecting to PS Vita for the first time. For details, see "Settings to Execute on PlayStation(R)Vita" in the document.
Core
New Additions and Modifications
- Added the following APIs.
- Matrix4.InverseAffine()
- Matrix4.MultiplyAffine()
- Matrix4.TransformProjection()
- Quaternion.Lerp()
- Quaternion.Log()
- Quaternion.Exp()
- Quaternion.Transform()
Environment
New Additions and Modifications
Eliminated the following class.
- Storage
Graphics
New Additions and Modifications
- Added the following APIs.
- Constructor of ShaderProgram that takes ShaderProgramOption as an argument
- The following APIs will be eliminated.
- Function for storing Primitive[] in VertexBuffer
- MirroredRepeat mode of TextureWrapMode
Limitations
- PlayStation(R)Vita has the following limitations.
- GraphicsContext.SetVertexBuffer() only applies the first VertexBuffer.
- GraphicsContext.SetPolygonOffset() is not supported. Specified parameters are ignored.
- ShaderProgramOption is not supported. Specified parameters are ignored.
- Texture2D.GenerateMipmap() may not operate correctly.
- TextureCube is not supported. An exception occurs upon creation.
Imaging
New Additions and Modifications
- A constructor version that receives a bitmap image has been added to the Image class.
- For the Image class, the order of the arguments for the constructor Image(ImageSize size, ImageColor color, ImageMode mode) has been changed to Image(ImageMode mode, ImageSize size, ImageColor color).
UI Toolkit
New Additions and Modifications
- Dispose() in the Widget and UIElement classes has been changed from a virtual function to a non-virtual function; Dispose(bool) and DisposeSelf() have been newly added as virtual functions.
- The RenderToFrameBuffer method has been added to the Widget class.
- The UnloadFromCache instance method has been added to the ImageAsset class.
- Fixed the problem where display was not correct when linefeed code was included in the Label character string.
- Fixed the problem where the values of WorldPosition and LocalPosition of DragEventsArgs become reversed.
- Fixed the problem where the value of MoveTarget of SlideTransition becomes reversed.
PSM UI Composer
New Additions and Modifications
- A preview feature was added.
- For details, refer to "Layout Guide" in the document.
In addition, small adjustments were made and problems were fixed.
PSM Studio
Limitations
- When debugging is executed with a PlayStation(R)Vita target, text is not output to the application output pad. Text output functions correctly when executed without debugging.
- Given a problem in Windows 7, white colored text over a light colored background makes the items difficult to decipher when menu items are selected.
- With the build actions None and Resource, files are not copied to the device. Use Contents.
Model
Limitations
- The Model file format is currently being developed. Changes may occur for future versions.
- HighLevel.Model is currently being developed. All features have not yet been implemented.
New Additions and Modifications
Vector/Matrix
- Added restriction to the argument of an API for obtaining reference arguments. Prohibited to specify the same variable as that of the this or ref arguments to the out argument.
Graphics
- Added restriction items regarding shader descriptions to the Graphics Overview.
Input
- Added Enter and Back to GamePadButtons. The values abstracted according to GamePadButtonMeaning for the circle and cross buttons will be obtained. In addition, this allows the status of the Android Back button to be obtained.
Imaging
- A constructor version that receives a different Font object has been added to the Font class.
GameEngine2D
- Newly added GameEngine2D. A 2D game engine.
UI Toolkit
- Added a feature for playing back animation formats (*.uim and *.uia). - It can play back animation converted from motion XML or XFL (XML format Flash project file). - For details, refer to "Adobe Flash Integration" in the document.
- Added the coordinate conversion system API to Widget and UIElement. - Added the LocalToWorld property to Widget and UIElement. - Added the ConvertScreenToLocal, ConvertLocalToScreen, and ConvertLocalToOtherWidget methods to Widget.
- Eliminated SpinBox, added DatePicker and TimePicker to replace it.
- Added pause and repeat features to Effect. - Added the Pause, Resume, OnPause, OnResume, and OnRepeat methods. - Added the Paused and Repeating properties to Effect.
- Renamed the Effect.IsPlay property to Playing.
- Renamed the Button.BackgroundColor property to BackgroundFilterColor. - Added the Dialog.BackgroundFilterColor property.
- Added the ListItemsChanged event (notifies of a change in ListItems) to PopupList. - Changed the ListItems property type to PopupListItemCollection.
- Added to and changed the hit determination API. - Added the UISystem.FindHitWidget method. - Changed the Widget.HitTest method from protected to public.
PSM UI Composer
- Widgets can now be locked/unlocked with the object tree.
- The display of widgets in the layout canvas can now be switched on and off with the object tree.
- The UI Composer display language (English/Japanese) can now be changed in the environment settings.
- In addition, small adjustments and fixes were made.
Physics2D
- Arranged the class names. Deleted Pss from the end of class names, for example changing BodyPss to Body.
Model
- The Model file format is currently being developed. Changes may occur for future versions.
- HighLevel.Model is currently being developed. All features have not yet been implemented.
- Changed the model converter to allow loading of *.x files.
Mono
- Enabled the CoreCLR security model.
- Fixed cases where crashes occur when the managed heap is used up.
- Deleted the API interface of the BCL.
- Fixed various problems related to the termination processing.
- Fixed the mono_100ns_ticks calculation overflow problem in Win32.
PSM Studio
- Placed a link to the Developer Community site on the PSM Studio Welcome screen.
- Fixed the problem where the "Disable All Break points" selection was possible even if there were no break points to disable.
- Adjusted the PSM Studio window layout and behavior in multiple display environments.
- Fixed the problem where programs would not start up correctly from PSM Studio when a PSM program was already running on a device.
- Fixed the problem where an error would occur with [Window] > [Split Vertically] / [Split Horizontally] in the menu.
- In addition, small adjustments and fixes were made.
OSC Customize Tool
- New release.
Other Changes
- psschecker.apk eliminated/integrated with psslauncher.apk.
- Prepared documents in chm format.
First Public Release Version
Limitations
- Imaging
- Even if an image file is saved in Android using Image.Export(), the image will not be automatically detected by the Gallery application. Re-mounting the SD card, etc. and performing a media scan is required.
- Model
- The Model file format is currently being developed. Changes may occur for future versions.
- HighLevel.Model is currently being developed. All features have not yet been implemented.
- UI Composer
- Regardless of the Widget "Position Selector" setting, the upper left coordinate will change when the Position property is changed.
- Since the settings UI of some properties will not be displayed correctly, some settings can not be made with the tool.
- Undo/Redo cannot be performed correctly for the deletion of the layouts of Scene, etc.