Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Pre-requisites

  • Visual Studio Code  [for Windows use VSCode version 1.72.1]
    https://code.visualstudio.com/download

  • ARES Commander 2024 x64 and , any other Graebert OEM Applications [ARES verticals (ARES Mechanical , ARES Maps, etc.].) & Graebert OEM Applications.

Platform support
Greabert LISP Extension available on Windows, Mac & Linux OS.

System RequirementsYou need to fulfill the current

  • Current system requirements of ARES Commander 2024 x64

...

...

  • .

  • Current system requirements for Visual Studio Code

...

Setup

To install Graebert LISP Extension [FLISP] plugin:

  1. Do one of the following:
    Type LISPIDE.
    - or -
    Type VLIDE.
    The following message displays: “Do you want to Install the Graebert LISP Extension?“.

  2. Confirm by clicking OK.
    Graebert LISP Extension will install using VLIDE command from VS Code Market Place.

Alternatively, you can install the Graebert LISP Extension directly from Market Place by searching Extension Section(Ctrl+shift+X) of VS Code.

FLISP Extension adds in %userprofile%/.vscode of the system. You can see the Extension Profile in the VS Code application.

...

Debugging

  1. Run ARES Commander 2024 or later.

...

  1. In the Options dialog box, select System Options > Lisp Debugger and select Enable Debugging.

...

  1. Image Added

...

  1. Close ARES Commander to save the settings and launch it again.

...

  1. From the Visual Studio Code Menu select Run

...

  1. > Add Configuration.

...

  1. Add the Launch and Attach configuration options:

    • FLISP Debug: Attach

...

    • FLISP Debug:

...

    • Launch

      Image Modified

      Launch and Attach

...

    • configuration options are added.

      Image Modified

...

  1. FLISP Debug: Attach

...

  1. From the Run and Debug

...

  1. side palette of

...

  1. Visual Studio Code, select FLISP Debug:Attach

...

  1. and click Run (or press F5).

...


  1. The list of all running ARES Commander applications and OEMs

...

  1. appears. On attach

...

  1. , the status bar color changes from blue to orange

...

  1. . LISP files

...

  1. automatically load

...

  1. .

...


  1. You can run the

...

  1. LISP command in ARES Commander and debug the

...

  1. LISP functions.

    Tip: Pressing Ctrl+Shift+D displays the Run and Debug palette.

    Image Modified

...

  1. FLISP Debug: launch
    First, you need to

...

  1. specify the path to ARES Commander executable

...

  1. file (ARESC.exe or the file corresponding to any other Graebert OEM application) in the Extension setting of Graebert LISP Extension.

...


  1. From the Run and Debug

...

  1. side palette of

...

  1. Visual Studio Code, select FLISP Debug:

...

  1. Launch and click Run (or press F5

...

  1. ).
    When launching ARES Commander, the status bar

...

  1. color changes from blue to orange

...

  1. . LISP files

...

  1. automatically load

...

  1. .

...

  1. You can run the

...

  1. LISP command in ARES Commander and debug the

...

  1. LISP functions.

    Image Modified

Features:

LISP Editor:

  • Syntax Highlighting

  • Snippet Completion for LISP & DCL

  • Smart Brackets

  • Comment Toggling

  • AutoComplete for LISP & DCL

  • Go-To-Definition and Peek Definition

  • Localization

  • LISP Encryption / Protection

  • Add & Update Header

  • Insert Region

  • Online Help

  • Load Current LISP File

  • Create Workspace

...

  • Attach/Launch

  • Start Debugging

  • Breakpoints

  • Step Over/In/Out

  • Variables [show last value]

  • Watch

  • Call Stack

  • Debug Console

  • Break On Error

  • Hover

 LISP Encryption / Protection

1.Click via Right Mouse Click to the top of your Lisp-file or press the shortcut keys CTRL+Shift+P to open the Command Palette…

...

2. Now select in the upcoming Combobox “FLISP: Protect LISP File

...

3. Before the protection you can configure a 2 characters key binding string, which is used for the encryption. This is not mandatory. It also works without these characters.

...

4. The resulting encrypted files can be found in a subfolder below the working or source files LISP folder. The protection tool encrypts all found LISP files of this folder and saved the encrypted copies under the subfolder \Out. A message is shown in the the right left corner of Microsoft Visual Code, where the files can be found.

...