Global Methods

Most of the actions you can perform from Lua are done by calling methods on objects associated with the current job. There are a few methods which operate Globally on the application and they are documented here.

IsAspire()

---

Returns true if the script is running inside Aspire.

Returns false if the script is running inside VCarve Pro or Cut2D Pro

IsBetaBuild()

---

Returns true if this is a Beta build rather than a release build

GetAppVersion()

---

Returns application version number as a double (e.g 4.004 for Aspire V4.0)

GetBuildVersion()

---

Returns application internal build version which is the same for both Aspire and VCarve Pro. This is different to the AppVersion above as Aspire 4.004 will report e.g. 7.004 which matches VCarve Pro 7.004 as they are built off the same code base, and have the same script level support.

MessageBox( string text)

---

Displays a message box with passed text to user. The text can include HTML formatting. text – string – text to display in the message box.

Usage Syntax:

Example Code:
-- VECTRIC LUA SCRIPT
-- require("mobdebug").start()
require "strict"
 -- =======================]]
function main()
  MessageBox("Hello World!!!")
  return true
end -- Function

Example Code:

This code displays all of the application internal build information. See MessageBox image below

  -- VECTRIC LUA SCRIPT
  -- require("mobdebug").start()
  require "strict"
  -- --------------------------------------------------------------- 
  -- |  ThisAppInfo() Collects information about the application and 
  -- |  provides the user with the following:
  -- |    Application name. 
  -- |    Version is a Beta/Pro.
  -- |    The version number.
  -- |    The build number.
  -- ---------------------------------------------------------------
    function ThisAppInfo()
      local ThisApp = ""  -- Sets ThisApp as a string
      local AppVersion   = tostring(GetAppVersion())   -- Gets the App Version
      local BuildVersion = tostring(GetBuildVersion()) -- Gets the Build Version

      if IsAspire() then -- Set the Re
        ThisApp = "\nApplication: Aspire"
      else
        ThisApp = "\nApplication: VCarve Pro or Cut2D Pro   "
      end -- if end

      if IsBetaBuild() then
        ThisApp = ThisApp .."\nRelease: Is for Beta Testing"
      else
        ThisApp = ThisApp .."\nRelease: Is for Production"
      end -- if end

      ThisApp = ThisApp .. "\nVersion No: " .. AppVersion ..
                           "\nCompile No: " .. BuildVersion

      MessageBox([[ Current Application Information ]] .. "\n"
              .. [[---------------------------------]] .. ThisApp)
    end -- function end
  -- =============================================================]]
    function main() 
       ThisAppInfo()
       return true
    end -- function end 
  -- =============================================================]]

References

Please Note: The base material for the contents found in this WiKi was sourced from Vectric Lua Interface for Gadgets, version 10.0, published August 21 2019. by Vectric Ltd. Most current document from Vertric can be downloaded at Vertric Developer Information