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 |