Get information about the current client. For the purposes of Finale Lua, the client is the Finale application that’s running on someones machine. Therefore, the client has details about the user’s setup, such as their Finale version, plugin version, and operating system.
One of the main uses of using client details is to check its capabilities. As such, the bulk of this library is helper functions to determine what the client supports.
client.get_raw_finale_version(major, minor, build)
Returns a raw Finale version from major, minor, and (optional) build parameters. For 32-bit Finale this is the internal major Finale version, not the year.
| Input | Type | Description |
|---|---|---|
major |
number |
Major Finale version |
minor |
number |
Minor Finale version |
build (optional) |
number |
zero if omitted |
| Return type | Description |
|---|---|
number |
client.get_lua_plugin_version()
Returns a number constructed from finenv.MajorVersion and finenv.MinorVersion. The reason not
to use finenv.StringVersion is that StringVersion can contain letters if it is a pre-release
version.
| Return type | Description |
|---|---|
number |
client.supports(feature)
Checks the client supports a given feature. Returns true if the client supports the feature, false otherwise.
To assert the client must support a feature, use client.assert_supports.
For a list of valid features, see the features table in the codebase.
| Input | Type | Description |
|---|---|---|
feature |
string |
The feature the client should support. |
| Return type | Description |
|---|---|
boolean |
client.assert_supports(feature)
Asserts that the client supports a given feature. If the client doesn’t support the feature, this function will throw an friendly error then exit the program.
To simply check if a client supports a feature, use client.supports.
For a list of valid features, see the features table in the codebase.
| Input | Type | Description |
|---|---|---|
feature |
string |
The feature the client should support. |
| Return type | Description |
|---|---|
boolean |
client.encode_with_client_codepage(input_string)
If the client supports LuaOSUtils, the filepath is encoded from UTF-8 to the current client encoding. On macOS, this is always also UTF-8, so the situation where the string may be re-encoded is only on Windows. (Recent versions of Windows also allow UTF-8 as the client encoding, so it may not be re-encoded even on Windows.)
If LuaOSUtils is not available, the string is returned unchanged.
A primary use-case for this function is filepaths. Windows requires 8-bit filepaths to be encoded with the client codepage.
| Input | Type | Description |
|---|---|---|
input_string |
string |
the UTF-encoded string to re-encode |
| Return type | Description |
|---|---|
string |
the string re-encoded with the clieng codepage |