LazC Wizard

• Create, Edit, Compile/Build "C" projects using the Lazarus IDE and "Tiny C Compiler"!

Getting Started

1. Install Tiny C Compiler [TCC]

• 1.1 TCC Windows Install
  • TCC Win32
  • TCC Win64
    • download and unzip the "tcc-0.9.27-win?-bin.zip"
• 1.2 TCC Linux Install
  • Linux
    • download and unpack "tcc-0.9.27.tar.bz2"
      • $cd "to unpacked tcc directory"
      • $chmod +x configure
      • $./configure
      • $make clean all
      • $sudo make install

2. Install LazC Wizard

• 2.1. Download zip or Clone

• 2.2 Intall [unzip it!]:

  • 2.2.1 Lazarus IDE menu "Package" --> "Open Package File (.lpk)"
    • Open "LazCWizard.lpk" (folder "LazCWizard")
    • Compile
    • Use --> Install
• • 2.2.2 Lazarus IDE menu "Package" --> "Open Package File (.lpk)"
    • Open "lazcwcompletion.lpk" [folder "LazCWizardUtils"]
    • Compile
    • Use --> "Install"

3. Using LazC Wizard

• 3.1 Creating a executable New Project

  • 3.1.1 Lazarus IDE: "Project" --> "New Project"--> LazCW Project
    • "Path to TinyCC executable"
      • ex."C:\tcc-0.9.27\tcc" [win]
      • ex."/usr/local/bin" [linux]
    • "Path to Projects Folder [workspace]"
      • ex. "C:\tcc-0.9.27\Projects"
    • "New Project Name"
      • ex. "LazCProject1" --> produce "lazcproject1.c"
    • "[.] Launch Terminal"
    • "(.) Executable"
• • 3.1.2 Lazarus IDE: "Run" --> "[LazCW] Compile/Build "C"
    • Success! From terminal execute your "lazcproject1" !!

• 3.2 Creating a Shared Library (.dll/.so)

  • 3.2.1 Lazarus IDE: "Project" --> "New Project" --> "LazCW Project"

    • New Project Name
      • ex."LazCShared1" --> produce "lazcshared1.c"
    • [.] Launch Terminal
    • (.) Shared Lib

  • 3.2.2 Lazarus IDE "Run" --> "[LazCW] Compile/Build/ "C"

    • Go to your project folder "LazCShared1"
    • Windows:
      • lazcshared1.dll
      • lazcshared1.pp (auto generated pascal unit interface header file!)
        • warning: may require some modification/fixes
    • linux:
      • liblazcshared1.so
      • lazcshared1.pp (auto generated pascal unit interface header file!)
        • warning: may require some modification/fixes

• 3.3 Using the "lazcshared1" Library in a Pascal program

  • 3.3.1 Lazarus IDE: "Project" --> "New Project" --> "Program"
    • ex. "Project1" and "save all" to the same .dll/.so folder
    • Open/Edit "Project1.lpr" add these [code] lines:

               uses
                   lazcshared1;  // <--- library  header unit...
               begin
                   writeln('sum = ', addTwo(5,8) );  //addTwo from "lazcshared1.pp"
               end.

  • 3.3.2 Lazarus IDE: "Run" --> "build"
    • Go to your project folder "LazCShared1" and execute:
      • Windows
        • Project1.exe
      • Linux
        • $export LD_LIBRARY_PATH=./ [linux]
        • $.\project1
          • or
        • $.\run.sh project1

• 3.4 [HOW TO] Building a csum.dll/libcsum.so library from a [tested] "C" code and using it into a Pascal program

  • 3.4.1 Editing and testing the "csum.c" code

    • Lazarus IDE "Project" --> "New Project" --> "LazCW Project"
    • New Project Name
      • ex. "LazCProject2" --> produce "lazcproject2.c"
    • [.] Launch Terminal
    • (.) Executable

  • 3.4.2 Lazarus IDE "File" --> "New" --> "[LazCW] Create a new .h file"

    • [Save as] ex. "csum.h" and add this "interface" c code line:

           int addTwoInt(int a, int b); 

  • 3.4.3 Lazarus IDE "File" --> "New" --> "[LazCW] Create a new .c file"

    • [Save as] ex. "csum.c" and add this "implementation" c code lines:

           int addTwoInt(int a, int b) {
                return (a+b);
           }

  • 3.4.4 Open "lazcproject2.c" and add these [code] lines:

             #include "csum.h"
             main() {
                 printf("\n Hello C World! \n"); 
                 printf("\n sum = %d \n", addTwoInt(5,8) ); /*hint:tcc comments*/
             }

  • 3.4.5 [Test it !] Lazarus IDE "Run" --> "[LazCW] Compile/Build C"

    • Success! From terminal execute your "lazcproject2" !!
      • lazcproject2.exe [win]
      • $.\lazcproject2 [linux]

  • 3.4.6 Building the "csum" Library using the tested csum.c/csum.h code

    • Lazarus IDE Editor [right click] "lazcproject2.c" and "Close Page"

    • Lazarus IDE "File" --> "Project" --> "Project Inspector..."

      • Select "lazcproject2.c" and remove/delete it!

    • Lazarus IDE "File" --> "Project" --> "Project Options..."

      • Select "[LazCW] C Projec Options"
      • Launch Terminal = yes
      • Main Unit = csum.c
      • Build Mode = dll [win]
        • or
      • Build Mode = so [linux]

    • Open e edit "csum.h": add extern directive:

          extern int addTwoInt(int a, int b);

    • Lazarus IDE "Run" --> "[LazCW] Compile/Build C"

      • Go to your project folder "LazCProject2"
        • Windows
          • csum.dll
          • csum.pp (auto generated pascal unit interface header file!)
            • warning: may require some modification/fixes
        • Linux
          • libcsum.so
          • csum.pp (auto generated pascal unit] interface header file!)
            -warning: may require some modification/fixes

• 3.5 Using the "csum" Library in a Pascal program

  • 3.5.1 Lazarus IDE "Project" --> "New Project" --> "Program"

    • ex. "Project2" and "Save All" to the same [dll/so] folder.

    • Open "Project2.lpr" and add these code lines:

              uses
                  ..., csum;  // <--- library header unit...
              begin
                  writeln('sum = ', addTwoInt(5,8) );  //  addTwoInt from "csum.pp"
              end.

  • 3.5.2 Lazarus IDE "Run" --> "Build"

    • Go to your project folder "LazCProject2" and execute it!
      • Windows
        • project2.exe
      • Linux
        • $export LD_LIBRARY_PATH=./
        • $.\project2
          • or:
        • $.\run.sh project2

• Enjoy yourself!

• Thanks to All!