VS:Vectorworks 2019 Development: Difference between revisions

From Vectorworks Developer
Jump to navigation Jump to search
No edit summary
 
(3 intermediate revisions by the same user not shown)
Line 3: Line 3:
== Version Information ==
== Version Information ==


=== Unicode ===
Vectorworks 2019 is a Unicode application. Internally, Vectorworks uses UTF-16. To provide easier transition of Vector Scripts, the script engine uses [https://en.wikipedia.org/wiki/UTF-8 UTF-8 Encoding].
Vectorworks 2019 is a Unicode application. Internally, Vectorworks uses UTF-16. To provide easier transition of Vector Scripts, the script engine uses [https://en.wikipedia.org/wiki/UTF-8 UTF-8 Encoding].


Line 8: Line 9:


In contract to previous version, Vector Script STRING type size was increased from 255 to 2048 bytes, which translates to a different maximum number of characters, depending on the symbols used as in UTF-8 some symbols can be represented by 4 bytes (for example)
In contract to previous version, Vector Script STRING type size was increased from 255 to 2048 bytes, which translates to a different maximum number of characters, depending on the symbols used as in UTF-8 some symbols can be represented by 4 bytes (for example)
=== Mac File Path Change ===
The Vectorscript functions [[VS:GetFile]], [[VS:PutFile]], [[VS:GetFolderPath]] and [[VS:FindFileInPluginFolder]] return a file path. For Vectorworks 2019, on the Macintosh platform, the path returned will be in the Posix format, rather than in the deprecated HFS format. If a Vectorscipt calls one of these functions and passes the file path returned into another Vectorscript function, no change should be needed. If a Vectorscipt calls one of these functions and checks that an HFS file path is returned on the Macintosh platform, the Vectorscript will probably need to be modified.


== New Features ==
== New Features ==
- Line Type API Change, see [[Line Type Reengineering Conversion Guide for Plug-ins]]


== New Functions ==


[[VS:Vectorworks 2019 New Functions]]


== New Functions ==
== Obsoleted Functions ==


[[VS:Vectorworks 2019 New Functions]]
[[VS:Obsolete Functions Table]]

Latest revision as of 14:58, 10 December 2018

.VectorScript|VectorScript ..VS:Function Reference|Function Reference ..VS:Function_Reference_Appendix|Appendix

Version Information

Unicode

Vectorworks 2019 is a Unicode application. Internally, Vectorworks uses UTF-16. To provide easier transition of Vector Scripts, the script engine uses UTF-8 Encoding.

Similarly to Vectorworks 2018, all sources files for Vector Script should be in UTF-8 text file encoding with or without BOM (Byte Order Mark).

In contract to previous version, Vector Script STRING type size was increased from 255 to 2048 bytes, which translates to a different maximum number of characters, depending on the symbols used as in UTF-8 some symbols can be represented by 4 bytes (for example)

Mac File Path Change

The Vectorscript functions VS:GetFile, VS:PutFile, VS:GetFolderPath and VS:FindFileInPluginFolder return a file path. For Vectorworks 2019, on the Macintosh platform, the path returned will be in the Posix format, rather than in the deprecated HFS format. If a Vectorscipt calls one of these functions and passes the file path returned into another Vectorscript function, no change should be needed. If a Vectorscipt calls one of these functions and checks that an HFS file path is returned on the Macintosh platform, the Vectorscript will probably need to be modified.

New Features

- Line Type API Change, see Line Type Reengineering Conversion Guide for Plug-ins

New Functions

VS:Vectorworks 2019 New Functions

Obsoleted Functions

VS:Obsolete Functions Table