JimAndi Toolbox: Difference between revisions

From SDK
Jump to navigation Jump to search
No edit summary
Tag: Manual revert
 
(346 intermediate revisions by the same user not shown)
Line 1: Line 1:
[[Category:SDK]]
[[Category:SDK]]
[[File:Back.jpg|right|50px|link=Vectric Lua Interface for Gadgets]]
==Table and Array Tools==
This object is a name-value pair that represents a Document Variable within a [[VectricJob]].
This object is a name-value pair that represents a Document Variable within a [[VectricJob]].


==== JimAndi Toolbox ====
===ArrayClear===
<nowiki>
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
-- =====================================================]]
ArrayClear - Clears the data from a data array.
╔╦╗╔═╗╔╗ ╦  ╔═╗  ╔═╗╔╗╔╔╦╗  ╔═╗╦═╗╦═╗╔═╗╦ ╦  ╔╦╗╔═╗╔═╗╦  ╔═╗
 
║ ╠═╣╠╩╗║  ║╣  ╠═╣║║║ ║║  ╠═╣╠╦╝╠╦╝╠═╣╚╦╝  ║ ║ ║║ ║║  ╚═╗
local tbl = {1, 2, 5, 6}
╩ ╩ ╩╚═╝╩═╝╚═╝  ╩ ╩╝╚╝═╩╝  ╩ ╩╩╚═╩╚═╩ ╩ ╩    ╩ ╚═╝╚═╝╩═╝╚═╝
 
function ArrayTools()
tbl = ArrayClear(tbl)
-- =====================================================]]
 
  function ArrayClear(arrayName)
returns tbl = {}
    for _,v in ipairs(arrayName) do
<nowiki> function ArrayClear(arrayName)
      table.remove(arrayName, i)
  for _,v in ipairs(arrayName) do
    end -- for end
    table.remove(arrayName, i)
    return true
  end -- for end
  end -- function end
  return true
  -- =====================================================]]
   end -- function end </nowiki>
  function NameCheck(Name, Defalt, ListName)              -- Checks if Name in in the list of it is default name
 
    if Name ~= Defalt then
----
      for i=1, ListName do
        if Name == i then
          return true
        end
      end
      return false
    else
      return  true
    end
  end -- NameCheck function end
  -- =====================================================]]
  function RemoveDuplicates(tab, order)                   -- returns table of unique items in "A" acending or "D" decending
    local hashSet = {}
    local new = {}
    local value
    for i = 1, #tab do
      value = (tab[i])
      if hashSet[value] == nil then
        table.insert(new, value)
        hashSet[value] = true
      end
    end
    if string.upper(order) =="A" then
      table.sort(new)
    else
      table.sort(new, function(a, b) return a > b end)
    end
    return new
  end
  -- =====================================================]]
  function RemoveTableItem(tabName, tabItem)
    for x = 1 in ipairs(tabName) do
      if tabName[x] == tabItem then
        table.remove(tabName, i)
      end
    end -- for end
    return true
   end -- function end
  -- =====================================================]]
  function TableLength(tbl)                              -- tbl returns table count
    -- tbl = {7, 6, 5, 4, 3, 2, 1}
    local count = 0
    for _ in pairs(tbl) do
      count = count + 1
    end
    return count
  end
  -- =====================================================]]
  function FindDups(checktbl, duptbl, cleantbl)          -- Find all duplicate items and returns both dup and clean tables
    function tLength(tbl) -- tLength returns table count
      local count = 0
      for _ in pairs(tbl) do
        count = count + 1
      end
      return count
    end
    -- =================================
    local trip = false
    for i=1, tLength(checktbl) do
      for x=1, tLength(cleantbl) do
        if cleantbl[x] == checktbl[i] then
          trip = true
        end
      end
      if trip then
        table.insert(duptbl,  checktbl[i])
      else
        table.insert(cleantbl, checktbl[i])
      end
      trip = false
    end
    return table.sort(duptbl), table.sort(cleantbl) -- returns both dup and clean table
  end -- function end
  -- =====================================================]]
  function ReverseTable(tbl)                              -- Reverse table order
  --tbl = {7, 6, 7, A, 5, 4, 3, A, 2, 1}
    local n = #tbl
    local i = 1
    while i < n do
      tbl[i],tbl[n] = tbl[n],tbl[i]
      i = i + 1
      n = n - 1
    end
    return tbl
  end
  -- =====================================================]]
end -- ArrayTools function end


</nowiki>
===NameCheck===
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
Checks if Name is in the list of it is default name.


This object is a name-value pair that represents a Document Variable within a [[VectricJob]].
a = {1, 2, 5, 6}


  <nowiki>  
Words = NameCheck(a, 5) -- returns true
  <nowiki> function NameCheck(Name, Defalt, ListName)
-- =====================================================]]
    if Name ~= Defalt then
╔═╗╔═╗╔╗╔╦  ╦╔═╗╦═╗╔╦╗╦╔═╗╔╗╔  ╔╦╗╔═╗╔═╗╦  ╔═╗
      for i=1, ListName do
║  ║ ║║║║╚╗╔╝║╣ ╠╦╝ ║ ║║ ║║║║  ║ ║ ║║ ║║  ╚═╗
        if Name == i then
╚═╝╚═╝╝╚╝ ╚╝ ╚═╝╩╚═ ╩ ╩╚═╝╝╚╝  ╩ ╚═╝╚═╝╩═╝╚═╝
          return true
function ConvertingTools()
        end
-- ====================================================]]
      end
function bool2S(x)                                     -- Converts true or false to text
      return false
  if x then
    else
    return "true"
      return true
  else
    end
    return "false"
  end -- function end </nowiki>
   end
 
end --function end
----
 
===RemoveDuplicates===
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
Returns table of unique items in "A" acending or "D" decending
 
local tbl = {1, 2, 5, 3, 5, 6, 4}
 
tbl = ArrayClear(tbl, "A")
 
returns tbl = {1, 2, 3, 4, 5, 6}
  <nowiki> function RemoveDuplicates(tab, order)
    local hashSet = {}
    local new = {}
    local value
    for i = 1, #tab do
      value = (tab[i])
      if hashSet[value] == nil then
        table.insert(new, value)
        hashSet[value] = true
      end
    end
    if string.upper(order) =="A" then
      table.sort(new)
    else
      table.sort(new, function(a, b) return a > b end)
    end
    return new
  end -- function end </nowiki>
 
----
 
===RemoveTableItem===  
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
Returns table with item removed.
 
local tbl = {1, 2, 3, 4, 5, 6}
 
tbl = RemoveTableItem(tbl, 4)
 
returns tbl = {1, 2, 3, 5, 6}
 
<nowiki>  function RemoveTableItem(tabName, tabItem)
    for x = 1 in ipairs(tabName) do
      if tabName[x] == tabItem then
          table.remove(tabName, i)
      end
    end -- for end
    return true
   end -- function end </nowiki>
----
 
===TableLength===
 
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
 
<nowiki> Returns table item count
local tbl = {1, 2, 3, 4, 5, 6}
tbl = TableLength(tbl)
 
returns tbl = 6
-- =====================================================]]
-- =====================================================]]
function D2S8(d)                                       --  Converts a Number (Double) to a String with 8 places
  function TableLength(tbl)
   return string.format("%.8f", d)
    -- tbl = {7, 6, 5, 4, 3, 2, 1}
end -- function end
    local count = 0
    for _ in pairs(tbl) do
      count = count + 1
    end
    return count
  end -- function end </nowiki>
 
----
 
===FindDups===
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
Find all duplicate items and returns two tables the dup and clean tables
 
Returns table item count
 
local tbl = {1, 2, 2, 4, 4, 6}
 
local tbl1 = {}
 
local tbl2 = {}
 
tbl1, tbl2 = TableLength(tbl)
 
returns tbl1, tbl2 = 6
  <nowiki> function FindDups(checktbl, duptbl, cleantbl)
    function tLength(tbl) -- tLength returns table count
      local count = 0
      for _ in pairs(tbl) do
        count = count + 1
      end
      return count
    end
    -- =================================
    local trip = false
    for i=1, tLength(checktbl) do
      for x=1, tLength(cleantbl) do
        if cleantbl[x] == checktbl[i] then
          trip = true
        end
      end
      if trip then
        table.insert(duptbl,   checktbl[i])
      else
        table.insert(cleantbl, checktbl[i])
      end
      trip = false
    end
    return table.sort(duptbl), table.sort(cleantbl)
  end -- function end </nowiki>
 
----
 
===ReverseTable===
 
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
 
Returns a reversed table
 
local tbl = {1, 2, 3, 4, 5, 6}
 
tbl = ReverseTable(tbl)
 
returns tbl = {6, 5, 4, 3, 2, 1}
 
<nowiki> function ReverseTable(tbl)
    --tbl = {7, 6, 7, A, 5, 4, 3, A, 2, 1}
    local n = #tbl
    local i = 1
    while i < n do
      tbl[i],tbl[n] = tbl[n],tbl[i]
      i = i + 1
      n = n - 1
    end
    return tbl
  end -- function end </nowiki>
 
----
 
==Conversion Tools==
[[File:Back.jpg|right|50px|link=Vectric Lua Interface for Gadgets]]
This collection of functions that assist in the conversion activities.
 
===Bool2Str===
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
<nowiki> bool2Str - Converts true or false as a string.
local x = true
tbl = bool2Str(x)
-- =====================================================]]
-- =====================================================]]
function D2S4(d)                                       -- Converts a Number (Double) to a String with 4 places
returns "true"
   return string.format("%.4f", d)
  function Bool2Str(x)
end -- function end
    if x then
      return "true"
    else
      return "false"
    end
  end --function end </nowiki>
 
----
 
===D2S8===
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
  D2S8 - Converts a Number (Double) to a String with 8 places
   <nowiki>function D2S8(d)                               -- Converts a Number (Double) to a String with 8 places
-- local x =12.2351
-- returns "12.23510000"
-- =====================================================]]
-- =====================================================]]
function toint(number)
    return string.format("%.8f", d)
  return math.floor(tonumber(number) or error("Could not cast '" .. tostring(number) .. "' to number.'"))
  end -- end function </nowiki>
end
 
----
 
===D2S4===
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
<nowiki> D2S4 - Converts a Number (Double) to a String with 4 places
local x =12.23
  = D2S4(x)
 
returns x = "12.2300"
-- =====================================================]]
  function D2S4(d)
    return string.format("%.4f", d)
  end -- end function </nowiki>
 
----
 
===Toint===
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
<nowiki> Toint - Converts a Double Number to a intiger
local x = 12.23
  = toint(x)
 
returns x = 12
  function toint(number)
    return math.floor(tonumber(number) or error("Could not cast '" .. tostring(number) .. "' to number.'"))
  end -- end function </nowiki>
 
----
 
===Rounder===
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
 
  return tonumber(string.format("%." .. (idp or 0) .. "f", n
<nowiki>
-- =====================================================]]
-- =====================================================]]
function Rounder(num, idp)                              --  Rounds a Number (Double) up or down
function Rounder(num, idp)                              --  Rounds a Number (Double) up or down
   return tonumber(string.format("%." .. (idp or 0) .. "f", num))
   return tonumber(string.format("%." .. (idp or 0) .. "f", num))
end -- end function
end -- end function </nowiki>
 
----
 
===RUsame===
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
<nowiki>
-- =====================================================]]
-- =====================================================]]
function RUsame(num, comp)                              --  Rounds a Number (Double) up or down
function RUsame(num, comp)                              --  Rounds a Number (Double) up or down
Line 160: Line 278:
     return false
     return false
   end -- if end
   end -- if end
end -- end function
end -- end function </nowiki>
-- =====================================================]]
 
function WithIn(Num, Mat, Tol)                         --  Retuns true if number is within tolerance with match
===WithIn===
  if ((Num >= (Mat - Tol)) and (Num <= (Mat + Tol))) then
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
    return true
Retuns true if number is within tolerance with match
  end -- if end
 
  return false
 
end -- end function
<nowiki> function WithIn(Num, Mat, Tol)
-- =====================================================]]
    if ((Num >= (Mat - Tol)) and (Num <= (Mat + Tol))) then
function Double2Fraction(Num)                          --  Converts a Measurement (Double) to a Fractional String
      return true
    end -- if end
    return false
  end -- end function </nowiki>
 
----
 
===Double2Fraction===
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
Converts a Measurement (Double) to a Fractional String
 
local txt = Double2Fraction(1.25)
 
returns txt ="1-1/4"
<nowiki> function Double2Fraction(Num)
   local Frac = "Error"
   local Frac = "Error"
   if Num then
   if Num then
Line 341: Line 473:
   end
   end
   return Frac
   return Frac
end -- function end
end -- end function </nowiki>
-- =====================================================]]
 
end -- Convert Tools end
----
 
==Time and Date Tools==
[[File:Back.jpg|right|50px|link=Vectric Lua Interface for Gadgets]]
This collection of functions are utilized in the date and time calculations.
 
===StartDateTime===
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
StartDateTime - Returns the Date and Time.


</nowiki>
local dt= StartDateTime(true)


This object is a name-value pair that represents a Document Variable within a [[VectricJob]].
returns tbl = "10/02/23"


  <nowiki>  
  <nowiki>  function StartDateTime(LongShort)
-- =====================================================]]
╔╦╗╦╔╦╗╔═╗  ╔╦╗╔═╗╔═╗╦  ╔═╗
║ ║║║║║╣    ║ ║ ║║ ║║  ╚═╗
╩ ╩╩ ╩╚═╝  ╩ ╚═╝╚═╝╩═╝╚═╝
function DateTimeTools()
-- =====================================================]]
   function StartDateTime(LongShort)
--[[ Date Value Codes
--[[ Date Value Codes
--  |   %a  abbreviated weekday name (e.g., Wed)
--  |   %a  abbreviated weekday name (e.g., Wed)
--  |    %A  full weekday name (e.g., Wednesday)
--  |    %A  full weekday name (e.g., Wednesday)
--  |    %b  abbreviated month name (e.g., Sep)
--  |    %b  abbreviated month name (e.g., Sep)
Line 382: Line 514:
       return os.date("%Y%m%d%H%M")
       return os.date("%Y%m%d%H%M")
     end
     end
   end
   end </nowiki>
-- =====================================================]]
 
   function StartDate(LongShort)
----
 
===StartDate===
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
StartDate - Returns the Date and Time.
 
local dt= StartDate(true)
 
returns tbl = "10/02/23"
   <nowiki> function StartDate(LongShort)
--[[ Date Value Codes
--[[ Date Value Codes
--  |   %a  abbreviated weekday name (e.g., Wed)
--  |   %a  abbreviated weekday name (e.g., Wed)
--  |    %A  full weekday name (e.g., Wednesday)
--  |    %A  full weekday name (e.g., Wednesday)
--  |    %b  abbreviated month name (e.g., Sep)
--  |    %b  abbreviated month name (e.g., Sep)
Line 410: Line 551:
       return os.date("%Y%m%d")    -- "20220901"
       return os.date("%Y%m%d")    -- "20220901"
     end
     end
   end
   end </nowiki>
-- ====================================================]]
 
function Wait(time)
----
 
===Wait===
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
Wait - Waits for a duration.
 
local dt = Wait(true)
 
returns tbl = "10/02/23"
 
  <nowiki> function Wait(time)
     local duration = os.time() + time
     local duration = os.time() + time
     while os.time() < duration do end
     while os.time() < duration do end
end
    end
-- =====================================================]]
end -- function end </nowiki>
end -- Date Time Tools function end
 
----
 
==Debugging Tools==
[[File:Back.jpg|right|50px|link=Vectric Lua Interface for Gadgets]]
This collection of functions assist in the debugging of code.


</nowiki>
===DMark - places a circle and notation to assist in geometry debugging===
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
Draws a circle and marks on the drawing for debugging purposes.


This object is a name-value pair that represents a Document Variable within a [[VectricJob]].
call = DebugMarkPoint("Note: Hi", Pt1)


  <nowiki>  
  <nowiki> function DMark(Note, Pt)
-- =====================================================]]
   -- ==== Sub Function
╔╦╗╔═╗╔╗ ╦ ╦╔═╗  ╔╦╗╔═╗╔═╗╦  ╔═╗
║║║╣ ╠╩╗║ ║║ ╦  ║ ║ ║║ ║║  ╚═╗
═╩╝╚═╝╚═╝╚═╝╚═╝  ╩ ╚═╝╚═╝╩═╝╚═╝
function DebugTools()
-- =====================================================]]
  function DMark(Note, Pt)
   --[[-- ==MarkPoint==
    | Code sourced from Vectric Lua Interface for Gadgets, version 2.05, published September 12, 2018. by Vectric Ltd.
    | Draws mark on the drawing
    | call = DebugMarkPoint("Note: Hi", Pt1)
    ]]
     local function DrawCircle(job, Cpt, CircleRadius, LayerName)  -- Draws a circle
     local function DrawCircle(job, Cpt, CircleRadius, LayerName)  -- Draws a circle
  --[[ draws a circle based on user inputs
    | job - current validated job unique ID
    | Cpt - (2Dpoint) center of the circle
    | CircleRadius - radius of the circle
    | Layer - layer name to draw circle (make layer if not exist)
    ]]
       local pa  = Polar2D(Cpt, 180.0, CircleRadius)
       local pa  = Polar2D(Cpt, 180.0, CircleRadius)
       local pb  = Polar2D(Cpt,  0.0, CircleRadius)
       local pb  = Polar2D(Cpt,  0.0, CircleRadius)
Line 451: Line 592:
       return true
       return true
     end -- function end
     end -- function end
   -- ====]]
   -- ====
     local BubbleSize = 1.25
     local BubbleSize = 1.25
     if not Project.DebugAngle then
     if not Project.DebugAngle then
Line 479: Line 620:
     end
     end
     return true
     return true
   end -- function end
   end -- function end </nowiki>
-- =====================================================]]
 
function StatusMessage(Type, Header, Question, ErrorNumber)
----
  --[[
 
  Useage:          type    Header Info              Question or Message                                 Err No.
===StatusMessage===
    StatusMessage("Error", "Base Cabinet Settings", "Face Frame Bottom Rail Width - value cannot be 0.", "(9000)")
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
    Note: if the debug flag is on (true) a message box shows the message length, dialog size and error number
Useage: (Type of Message, Dialog Header, Question or Message, Err No.)
  ]]
 
StatusMessage("Error", "Base Cabinet Settings", "Face Frame Bottom Rail Width - value cannot be 0.", "(9000)")
 
Note: if the debug flag is on (true) a message box shows the message length, dialog size and error number
<nowiki>function StatusMessage(Type, Header, Question, ErrorNumber)
 
   local dialog
   local dialog
   local X = 460
   local X = 460
Line 533: Line 679:
   end
   end
   return true
   return true
end
end </nowiki>
-- =====================================================]]
 
  function DebugMarkPoint(Note, Pt, Size, LayerName)
----
  --[[-- ==MarkPoint==
 
  | Code sourced from Vectric Lua Interface for Gadgets, version 2.05, published September 12, 2018. by Vectric Ltd.
 
  | Draws mark on the drawing
===DebugMarkPoint===
  | call = DebugMarkPoint("Note: Hi", Pt1, 0.125, "Jim")
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
  ]]
Used in debugging drawing issues - Draws a Circle and Text at the provided point(x,y)  
 
call = DebugMarkPoint("Note: Hi", Pt1, 0.125, "Jim")
<nowiki>function DebugMarkPoint(Note, Pt, Size, LayerName)
     if Size == nil then
     if Size == nil then
       Size = 0.125
       Size = 0.125
Line 547: Line 696:
       LayerName = "Debug"
       LayerName = "Debug"
     end
     end
  -- ==== Sub Function
     local function DrawCircle(job, Cpt, CircleRadius, LayerName)  -- Draws a circle
     local function DrawCircle(job, Cpt, CircleRadius, LayerName)  -- Draws a circle
  -- | draws a circle based on user inputs
  -- | job - current validated job unique ID
  -- | Cpt - (2Dpoint) center of the circle
  -- | CircleRadius - radius of the circle
  -- | Layer - layer name to draw circle (make layer if not exist)
       local pa = Polar2D(Cpt, 180.0, CircleRadius)
       local pa = Polar2D(Cpt, 180.0, CircleRadius)
       local pb = Polar2D(Cpt,  0.0, CircleRadius)
       local pb = Polar2D(Cpt,  0.0, CircleRadius)
Line 560: Line 705:
       layer:AddObject(CreateCadContour(line), true)
       layer:AddObject(CreateCadContour(line), true)
       return true
       return true
     end -- function end
     end -- sub function end
   -- ====]]
   -- ====
     local job = VectricJob()
     local job = VectricJob()
     local Pt1 = Polar2D(Pt, Project.DebugAngle, Size * 2.0)
     local Pt1 = Polar2D(Pt, Project.DebugAngle, Size * 2.0)
Line 575: Line 720:
     DrawCircle(job, Pt, Size, LayerName)
     DrawCircle(job, Pt, Size, LayerName)
     return true
     return true
   end -- function end
   end -- function end </nowiki>
-- =====================================================]]
 
  function ShowDialogSize()                            -- Returns Dialog X and Y size
----
 
===ShowDialogSize===
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
Returns Dialog size in a message box showing the X and Y vaalues.
<nowiki> function ShowDialogSize()
     DisplayMessageBox(tostring(dialog.WindowWidth) .. " x " ..  tostring(dialog.WindowHeight))
     DisplayMessageBox(tostring(dialog.WindowWidth) .. " x " ..  tostring(dialog.WindowHeight))
   end -- function end
   end -- function end</nowiki>
-- =====================================================]]
end -- End Debug


</nowiki>
----


This object is a name-value pair that represents a Document Variable within a [[VectricJob]].
==Dialog and Menu Tools==
[[File:Back.jpg|right|50px|link=Vectric Lua Interface for Gadgets]]
This object is a name-value pair that represents a Document.


<nowiki>
===DialogSize===
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
-- =====================================================]]
Returns Dialog size in a message box showing the X and Y vaalues.
╔╦╗╦╔═╗╦  ╔═╗╔═╗  ╔╦╗╔═╗╔═╗╦  ╔═╗
  <nowiki> function DialogSize(Str)                                -- Returns the X and Y value of the dialogue
  ║║║╠═╣║  ║ ║║ ╦  ║ ║ ║║ ║║  ╚═╗
═╩╝╩╩ ╩╩═╝╚═╝╚═╝  ╩ ╚═╝╚═╝╩═╝╚═╝
function DialogTools()
-- =====================================================]]
function DialogSize(Str)                                -- Returns the X and Y value of the dialogue
   local InText = string.find(string.upper(Str) , "X")
   local InText = string.find(string.upper(Str) , "X")
   local DialogX = All_Trim(string.sub(Str, 1, InText - 1))
   local DialogX = All_Trim(string.sub(Str, 1, InText - 1))
   local DialogY = All_Trim(string.sub(Str, InText + 1))
   local DialogY = All_Trim(string.sub(Str, InText + 1))
   return tonumber(DialogX), tonumber(DialogY)
   return tonumber(DialogX), tonumber(DialogY)
end -- end function
end -- function end</nowiki>
-- =====================================================]]
 
function ProgressBarAmount(TotalRecords, Record)        -- Calculates the percent amount of progression based on total process
----
 
===ProgressBarAmount===
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
Returns Dialog size in a message box showing the X and Y vaalues.
<nowiki> function ProgressBarAmount(TotalRecords, Record)        -- Calculates the percent amount of progression based on total process
   --[[
   --[[
   local MyProgressBar
   local MyProgressBar
Line 612: Line 762:
     MyProgressBar:Finished()                                                  -- Close Progress Bar
     MyProgressBar:Finished()                                                  -- Close Progress Bar
   ]]
   ]]
  local X1 = (100.0 / TotalRecords)
    local X1 = (100.0 / TotalRecords)
  local X2 = X1 * Record
    local X2 = X1 * Record
  local X3 = math.abs(X2)
    local X3 = math.abs(X2)
  local X4 = (math.floor(X3))
    local X4 = (math.floor(X3))
  return (math.floor(math.abs((100.0 / TotalRecords) * Record)))
    return (math.floor(math.abs((100.0 / TotalRecords) * Record)))
end -- function end
  end -- function end</nowiki>
-- =====================================================]]
 
function OnLuaButton_InquiryGearCalulate(dialog)
----
 
===OnLuaButton_InquiryGearCalulate===
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
Returns Dialog size in a message box showing the X and Y vaalues.
<nowiki> function OnLuaButton_InquiryGearCalulate(dialog)
   Gear.Addendum        = dialog:GetDoubleField("Gear.Addendum")
   Gear.Addendum        = dialog:GetDoubleField("Gear.Addendum")
   Gear.Dedendum        = dialog:GetDoubleField("Gear.Dedendum")
   Gear.Dedendum        = dialog:GetDoubleField("Gear.Dedendum")
Line 645: Line 800:


   return true
   return true
end -- function end
end -- function end</nowiki>
-- =====================================================]]
 
function InquiryDropList(Header, Quest, DX, DY, DList)
----
 
===InquiryDropList===
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
Returns Dialog size in a message box showing the X and Y vaalues.
<nowiki> function InquiryDropList(Header, Quest, DX, DY, DList)
--[[
--[[
     Drop list foe user input
     Drop list foe user input
Line 670: Line 830:
       return dialog:GetDropDownListValue("ListBox")
       return dialog:GetDropDownListValue("ListBox")
     end
     end
end
end -- function end</nowiki>
-- =====================================================]]
 
function InquiryFileBox(Header, Quest, DefaltPath)
----
 
===InquiryFileBox===
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
Returns Dialog size in a message box showing the X and Y vaalues.
<nowiki> function InquiryFileBox(Header, Quest, DefaltPath)
--[[
--[[
     Dialog Box for user to pick a file
     Dialog Box for user to pick a file
Line 708: Line 873:
       return dialog:GetTextField("ReadFile")
       return dialog:GetTextField("ReadFile")
     end -- if end
     end -- if end
end -- function end
  end -- function end</nowiki>
-- =====================================================]]
 
function InquiryPathBox(Header, Quest, DefaltPath)
----
 
===InquiryPathBox===
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
Returns Dialog size in a message box showing the X and Y vaalues.
<nowiki> function InquiryPathBox(Header, Quest, DefaltPath)
--[[
--[[
     Number Box for user input with default value
     Number Box for user input with default value
Line 746: Line 916:
       return dialog:GetTextField("DInput")
       return dialog:GetTextField("DInput")
     end -- if end
     end -- if end
  end -- function end
  end -- function end</nowiki>
-- =====================================================]]
 
function InquiryAreYouSureYesNo(Header, Question1, Question2)
----
 
===InquiryAreYouSureYesNo===
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
Returns Dialog size in a message box showing the X and Y vaalues.
<nowiki> function InquiryAreYouSureYesNo(Header, Question1, Question2)
  --[[
  --[[
     Drop list for user to input project info
     Drop list for user to input project info
Line 768: Line 943:
       return true
       return true
     end
     end
  end
  end -- function end</nowiki>
-- =====================================================]]
 
function InquiryDoubleBox(Header, Quest, DefaltN)
----
 
===InquiryDoubleBox===
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
Returns Dialog size in a message box showing the X and Y vaalues.
<nowiki> function InquiryDoubleBox(Header, Quest, DefaltN)
--[[
--[[
-- nquiryNumberBox for user input with default number value
-- nquiryNumberBox for user input with default number value
Line 788: Line 968:
     return dialog:GetDoubleField("NumberInput")
     return dialog:GetDoubleField("NumberInput")
   end
   end
end -- function end
end -- function end</nowiki>
-- =====================================================]]
 
function InquiryIntegerBox(Header, Quest, DefaltI)
----
 
===InquiryIntegerBox===
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
Returns Dialog size in a message box showing the X and Y vaalues.
<nowiki> function InquiryIntegerBox(Header, Quest, DefaltI)
--[[
--[[
-- InquiryIntegerBox for user input with default number value
-- InquiryIntegerBox for user input with default number value
Line 808: Line 993:
     return dialog:GetIntegerField("IntegerInput")
     return dialog:GetIntegerField("IntegerInput")
   end
   end
end -- function end
end -- function end</nowiki>
-- =====================================================]]
 
function InquiryTextgBox(Header, Quest, DefaltS)
----
 
===InquiryTextgBox===
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
Returns Dialog size in a message box showing the X and Y vaalues.
<nowiki> function InquiryTextgBox(Header, Quest, DefaltS)
--[[
--[[
-- InquiryStringBox for user input with default number value
-- InquiryStringBox for user input with default number value
Line 828: Line 1,018:
     return dialog:GetTextField("NumberInput")
     return dialog:GetTextField("NumberInput")
   end
   end
end -- function end
end -- function end</nowiki>
-- =====================================================]]
 
function OnLuaButton_InquiryError(Message)
----
 
===OnLuaButton_InquiryError===
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
Returns Dialog size in a message box showing the X and Y vaalues.
<nowiki> function OnLuaButton_InquiryError(Message)
     --[[
     --[[
     Provides user information on an Error
     Provides user information on an Error
Line 847: Line 1,042:
   WriteRegistry()
   WriteRegistry()
   return  true
   return  true
end
end -- function end</nowiki>
-- =====================================================]]
 
function PresentMessage(Header, Type, Line)
----
 
===PresentMessage===
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
Returns Dialog size in a message box showing the X and Y vaalues.
<nowiki> function PresentMessage(Header, Type, Line)
     --[[
     --[[
     Provides user information on an Error
     Provides user information on an Error
Line 866: Line 1,066:
   dialog:ShowDialog()
   dialog:ShowDialog()
   return  true
   return  true
end
end -- function end</nowiki>
-- =====================================================]]
 
function OnLuaButton_InquiryAbout()
===OnLuaButton_InquiryAbout===
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
Returns Dialog size in a message box showing the X and Y vaalues.
<nowiki> function OnLuaButton_InquiryAbout()
local myHtml = [[<html><head><title>About</title>]] .. DialogWindow.Style ..[[</head><body text = "#000000"><table width="680" border="0" cellpadding="0"> <tr> <td align="center" nowrap="nowrap" class="header1-c" id="SysName">Easy Cabinet Maker</td> </tr> <tr> <td align="center" nowrap="nowrap" id="Version" class="ver-c">Version</td> </tr> <tr> <td align="center" nowrap="nowrap"><hr></td> </tr> <tr> <td align="center" nowrap="nowrap" class="header2-c">Disclaimer</td> </tr> <tr> <td align="center" class="p1-l"><p class="p1-l">The ]] .. Dovetail.AppName .. [[ Gadget is a plugin for Vectric software, V-Carve Pro and Aspire.<br> Gadgets are an entirely optional add-in to Vectric's core software products.<br> They are provided 'as-is', without any express or implied warranty, and you make use of them entirely at your own risk.<br> In no event will the author(s) or Vectric Ltd. be held liable for any damages arising from their use.<br> <br> Permission is granted to anyone to use this software for any purpose, including commercial applications, and to alter it and redistribute it freely, subject to the following restrictions:<br> 1. The origin of this software must not be misrepresented; you must not claim that you wrote the original software.<br> * If you use this software in a product, an acknowledgement in the product documentation would be appreciated but is not required.<br> 2. Altered source versions must be plainly marked as such, and must not be misrepresented as being the original software.<br> 3. This notice may not be removed or altered from any source distribution.<br> <br>The author heavily utilized the SDK documentation and supplied code samples in addition to the outstanding user community on the Vectric User forum.</p></td> </tr> <tr> <td align="center"><a href="https://forum.vectric.com" class="webLink-c">Vectric User Forum</a></td> </tr> <tr> <td align="center"><span class="header2-c">JimAndi</span></td> </tr> <tr> <td align="center"><span class="h1-c">Houston, TX.</span></td> </tr> <tr> <td><hr></td> </tr> <tr> <td width="30%" align="center" style = "width: 15%"><input id = "ButtonOK" class = "FormButton" name = "ButtonOK" type = "button" value = "OK"></td> </tr></table></body></html>]]
local myHtml = [[<html><head><title>About</title>]] .. DialogWindow.Style ..[[</head><body text = "#000000"><table width="680" border="0" cellpadding="0"> <tr> <td align="center" nowrap="nowrap" class="header1-c" id="SysName">Easy Cabinet Maker</td> </tr> <tr> <td align="center" nowrap="nowrap" id="Version" class="ver-c">Version</td> </tr> <tr> <td align="center" nowrap="nowrap"><hr></td> </tr> <tr> <td align="center" nowrap="nowrap" class="header2-c">Disclaimer</td> </tr> <tr> <td align="center" class="p1-l"><p class="p1-l">The ]] .. Dovetail.AppName .. [[ Gadget is a plugin for Vectric software, V-Carve Pro and Aspire.<br> Gadgets are an entirely optional add-in to Vectric's core software products.<br> They are provided 'as-is', without any express or implied warranty, and you make use of them entirely at your own risk.<br> In no event will the author(s) or Vectric Ltd. be held liable for any damages arising from their use.<br> <br> Permission is granted to anyone to use this software for any purpose, including commercial applications, and to alter it and redistribute it freely, subject to the following restrictions:<br> 1. The origin of this software must not be misrepresented; you must not claim that you wrote the original software.<br> * If you use this software in a product, an acknowledgement in the product documentation would be appreciated but is not required.<br> 2. Altered source versions must be plainly marked as such, and must not be misrepresented as being the original software.<br> 3. This notice may not be removed or altered from any source distribution.<br> <br>The author heavily utilized the SDK documentation and supplied code samples in addition to the outstanding user community on the Vectric User forum.</p></td> </tr> <tr> <td align="center"><a href="https://forum.vectric.com" class="webLink-c">Vectric User Forum</a></td> </tr> <tr> <td align="center"><span class="header2-c">JimAndi</span></td> </tr> <tr> <td align="center"><span class="h1-c">Houston, TX.</span></td> </tr> <tr> <td><hr></td> </tr> <tr> <td width="30%" align="center" style = "width: 15%"><input id = "ButtonOK" class = "FormButton" name = "ButtonOK" type = "button" value = "OK"></td> </tr></table></body></html>]]
   local dialog = HTML_Dialog(true, myHtml, 720, 468, "About")
   local dialog = HTML_Dialog(true, myHtml, 720, 468, "About")
Line 876: Line 1,079:
   Project.AboutXY = tostring(dialog.WindowWidth) .. " x " .. tostring(dialog.WindowHeight)
   Project.AboutXY = tostring(dialog.WindowWidth) .. " x " .. tostring(dialog.WindowHeight)
   return  true
   return  true
end
end -- function end</nowiki>
-- =====================================================]]
 
function Color_HTML ()
----
 
 
===Color_HTML ===
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
Returns Dialog size in a message box showing the X and Y vaalues.
<nowiki> function Color_HTML ()
   MessageBox(" X = " .. tostring(dialog.WindowWidth) ..
   MessageBox(" X = " .. tostring(dialog.WindowWidth) ..
             " Y = " .. tostring(dialog.WindowHeight)
             " Y = " .. tostring(dialog.WindowHeight)
Line 916: Line 1,125:
</table>
</table>
]] -- end HTML
]] -- end HTML
end -- HTML Function end
end -- function end</nowiki>
-- =====================================================]]
 
function Style ()
----
 
 
===Style===
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
Returns Dialog size in a message box showing the X and Y vaalues.
<nowiki> function Style()
-- =====================================================]]
-- =====================================================]]
DialogWindow.Style = [[ <style>
DialogWindow.Style = [[ <style>
Line 1,209: Line 1,424:
}
}
</style>]]
</style>]]
end
end -- function end</nowiki>
-- =====================================================]]
 
function Orgin ()                                      -- Anchor Point
----
 
===Orgin===
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
Returns Dialog size in a message box showing the X and Y vaalues.
<nowiki> function Orgin()                                      -- Anchor Point
-- ================================
-- ================================
   DialogWindow.Orgin = [[<table><tr><td colspan="2" class="h2-l">Anchor Point</td></tr><tr class="MyLeft"><td class="MyLeft"><table class="MyCenter"><tr><td><input type="radio" name="DrawingOrigin" checked="checked" value="V1"></td><td><hr></td><td valign="top"><input type="radio" name="DrawingOrigin" checked="checked" value="V2"></td></tr><tr><td class="auto-style9">|</td><td><input type="radio" name="DrawingOrigin" checked="checked" value="V3"></td><td valign="top">|</td></tr><tr><td><input type="radio" name="DrawingOrigin" checked="checked" value="V4"></td><td><hr></td><td valign="top"><input type="radio" name="DrawingOrigin" checked="checked" value="V5"></td></tr></table></td><td width="81%"><table><tr class="MyLeft"><td>X</td><td><input name="OriginX0" type="text" id="OriginX" size="8" maxlength="8"></td></tr><tr class="MyLeft"><td>Y</td><td><input name="OriginY0" type="text" id="OriginY" size="8" maxlength="8"></td></tr></table></td></tr></table>]]
   DialogWindow.Orgin = [[<table><tr><td colspan="2" class="h2-l">Anchor Point</td></tr><tr class="MyLeft"><td class="MyLeft"><table class="MyCenter"><tr><td><input type="radio" name="DrawingOrigin" checked="checked" value="V1"></td><td><hr></td><td valign="top"><input type="radio" name="DrawingOrigin" checked="checked" value="V2"></td></tr><tr><td class="auto-style9">|</td><td><input type="radio" name="DrawingOrigin" checked="checked" value="V3"></td><td valign="top">|</td></tr><tr><td><input type="radio" name="DrawingOrigin" checked="checked" value="V4"></td><td><hr></td><td valign="top"><input type="radio" name="DrawingOrigin" checked="checked" value="V5"></td></tr></table></td><td width="81%"><table><tr class="MyLeft"><td>X</td><td><input name="OriginX0" type="text" id="OriginX" size="8" maxlength="8"></td></tr><tr class="MyLeft"><td>Y</td><td><input name="OriginY0" type="text" id="OriginY" size="8" maxlength="8"></td></tr></table></td></tr></table>]]
end -- HTML Function end
end -- function end</nowiki>
-- =====================================================]]
 
function GetColor(str)                                  -- returns the RGB value for the standard color names
----
 
 
===GetColor===
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
Returns Dialog size in a message box showing the X and Y vaalues.
<nowiki> function GetColor(str)                                  -- returns the RGB value for the standard color names
-- str = "Purple"
-- str = "Purple"
-- returns = 128 0 128
-- returns = 128 0 128
Line 1,246: Line 1,472:
     end
     end
     return Red, Green, Blue
     return Red, Green, Blue
  end -- function end
end -- function end</nowiki>
-- =====================================================]]
 
function StatusMessage(Type, Header, Question, length) -- Standardize messaging dialogues
----
 
 
===StatusMessage===
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
Returns Dialog size in a message box showing the X and Y vaalues.
<nowiki> function StatusMessage(Type, Header, Question, length) -- Standardize messaging dialogues
   -- StatusMessage("Alert",    "Alert Test",    "This is a test of Alert",    165)
   -- StatusMessage("Alert",    "Alert Test",    "This is a test of Alert",    165)
   -- StatusMessage("Question", "Question Test",  "This is a test of Question", 165)
   -- StatusMessage("Question", "Question Test",  "This is a test of Question", 165)
Line 1,281: Line 1,513:
   dialog:ShowDialog()
   dialog:ShowDialog()
   return true
   return true
end
end -- function end </nowiki>
-- =====================================================]]
end -- Dialog Tools function end


===DialogStringChecks===
<nowiki>function DialogStringChecks()
  local MyTrue = false
  if Milling.LNBottomProfile == "" then
    MessageBox("Error: Bottom Profile layer name cannot be blank")
    OnLuaButton_InquiryLayers()
  elseif  Milling.LNSideProfile  == "" then
    MessageBox("Error: Side Profile layer name cannot be blank")
    OnLuaButton_InquiryLayers()
  elseif  Milling.LNSidePocket  == "" then
    MessageBox("Error: Side Pocket layer name cannot be blank")
    OnLuaButton_InquiryLayers()
  elseif Milling.LNFrontProfile == "" then
    MessageBox("Error: Front Profile layer name cannot be blank")
    OnLuaButton_InquiryLayers()
  elseif Milling.LNFrontPocket  == "" then
    MessageBox("Error: Front Pocket layer name cannot be blank")
    OnLuaButton_InquiryLayers()
  elseif Milling.LNBackProfile  == "" then
    MessageBox("Error: Back Profile layer name cannot be blank")
    OnLuaButton_InquiryLayers()
  elseif Milling.LNBackPocket == "" then
    MessageBox("Error: Back Pocket layer name cannot be blank")
    OnLuaButton_InquiryLayers()
  elseif Milling.LNDrawNotes == "" then
    MessageBox("Error: Draw Notes layer name cannot be blank")
    OnLuaButton_InquiryLayers()
  elseif Milling.LNPartLabels == "" then
    MessageBox("Error: Part Lables layer name cannot be blank")
    OnLuaButton_InquiryLayers()
  elseif Milling.LNBlume == "" then
    MessageBox("Error: Blume layer name cannot be blank")
    OnLuaButton_InquiryLayers()
  elseif Project.ProjectName == "" then
    MessageBox("Error: Project Name cannot be blank")
    OnLuaButton_InquiryProjectInfo()
  elseif Project.ContactEmail  == "" then
    MessageBox("Error: Contact Email cannot be blank")
    OnLuaButton_InquiryProjectInfo()
  elseif Project.ContactName == "" then
    MessageBox("Error: Contact Name cannot be blank")
    OnLuaButton_InquiryProjectInfo()
  elseif Project.ContactPhoneNumber == "" then
    MessageBox("Error: Project Name cannot be blank")
    OnLuaButton_InquiryProjectInfo()
  elseif Project.DrawerID == "" then
    MessageBox("Error: Contact Phone Number cannot be blank")
    OnLuaButton_InquiryProjectInfo()
  elseif Project.ProjectPath == "" then
    MessageBox("Error: Project Path cannot be blank")
    OnLuaButton_InquiryProjectInfo()
  else
    MyTrue = true
  end -- if end
  return MyTrue
end -- function end</nowiki>
----


</nowiki>
==Directory and File Tools==
 
[[File:Back.jpg|right|50px|link=Vectric Lua Interface for Gadgets]]
This object is a name-value pair that represents a Document Variable within a [[VectricJob]].
This object is a name-value pair that represents a Document.
 
<nowiki>
-- =====================================================]]
╔╦╗╦╦═╗╔═╗╔═╗╔╦╗╔═╗╦═╗╦ ╦  ╔╦╗╔═╗╔═╗╦  ╔═╗
║║║╠╦╝║╣ ║  ║ ║ ║╠╦╝╚╦╝  ║ ║ ║║ ║║  ╚═╗
═╩╝╩╩╚═╚═╝╚═╝ ╩ ╚═╝╩╚═ ╩    ╩ ╚═╝╚═╝╩═╝╚═╝
function DirectoryTools()
-- =====================================================]]
  function MakeFolder(xPath)
    os.execute( "mkdir  " .. xPath)
    return true
  end -- function end
-- =====================================================]]
  function PathFix(xPath)
    return string.gsub(xPath, "\\", "/")
  end -- function end
-- =====================================================]]
  function FileExists(name)
-- FileExists(name
-- DisplayMessageBox(name)
    local f=io.open(name,"r")
    if f~=nil then
      io.close(f)
      return true
    else
      return false
    end
  end -- function end
-- =====================================================]]
  function DirectoryProcessor(job, dir_name, filter, do_sub_dirs, function_ptr)
      local num_files_processed = 0
      local directory_reader = DirectoryReader()
      local cur_dir_reader = DirectoryReader()
      directory_reader:BuildDirectoryList(dir_name, do_sub_dirs)
      directory_reader:SortDirs()
      local number_of_directories = directory_reader:NumberOfDirs()
      for i = 1, number_of_directories do
        local cur_directory = directory_reader:DirAtIndex(i)
        -- get contents of current directory
        -- dont include sub dirs, use passed filter
        cur_dir_reader:BuildDirectoryList(cur_directory.Name, false)
        cur_dir_reader:GetFiles(filter, true, false)
        -- call passed method for each file:
        local num_files_in_dir = cur_dir_reader:NumberOfFiles()
        for j=1, num_files_in_dir  do
          local file_info = cur_dir_reader:FileAtIndex(j)
          if not function_ptr(job, file_info.Name) then
            return true
          end -- if end
          num_files_processed = num_files_processed + 1
        end -- for end
        -- empty out our directory object ready for next go
        cur_dir_reader:ClearDirs()
        cur_dir_reader:ClearFiles()
      end -- for end
      return num_files_processed
  end -- function end
-- =====================================================]]
end -- Directory Tools end
 


</nowiki>
----


This object is a name-value pair that represents a Document Variable within a [[VectricJob]].
===MakeFolder()===
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
Returns Dialog size in a message box showing the X and Y values.
<nowiki> function MakeFolder(xPath)
    os.execute( "mkdir  " .. xPath)
    return true
  end -- function end</nowiki>


<nowiki>
----
-- =====================================================]]
╔╦╗╦═╗╔═╗╦ ╦╦╔╗╔╔═╗  ╔╦╗╔═╗╔═╗╦  ╔═╗
║║╠╦╝╠═╣║║║║║║║║ ╦  ║ ║ ║║ ║║  ╚═╗
═╩╝╩╚═╩ ╩╚╩╝╩╝╚╝╚═╝  ╩ ╚═╝╚═╝╩═╝╚═╝
function DrawTools()
  -- =====================================================]]
  function LayerClear(LayerName)
  local Mylayer = Milling.job.LayerManager:GetLayerWithName(LayerName)
    if Mylayer.IsEmpty then
        Milling.job.LayerManager:RemoveLayer(Mylayer)
    end -- if end
  return true
end -- function end


  -- ====================================================]]
===PathFix()===
  function Scale(Num)
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
  local mtl_block = MaterialBlock()
<nowiki> function PathFix(xPath)             -- Returns path with /
  if mtl_block.InMM then
     return string.gsub(xPath, "\\", "/")
     return Num * 25.4
   end -- function end</nowiki>
  else
    return Num
   end
end -- end function


  -- =====================================================]]
----
  function AssyHoler(pt1, pt2, PartName)                  -- Draws Assy Holes in a stight line
  local Ang1 = GetPolarDirection(pt1, pt2)
  local Ang2 = GetPolarDirection(pt2, pt1)
  pt1 = Polar2D(pt1, Ang1, Milling.AssemblyHoleStartEnd)
  DrawCircle(pt1, Milling.AssemblyHoleRad, Milling.LNAssemblyHole .. PartName)
  pt2 = Polar2D(pt2, Ang2, Milling.AssemblyHoleStartEnd)
  DrawCircle(pt2, Milling.AssemblyHoleRad, Milling.LNAssemblyHole .. PartName)
  local Dist = GetDistance(pt1, pt2)
  if Project.Debugger then
    DMark("pt1", pt1)
    DMark("pt2", pt2)
  end
  BaseScrew(2)
  Milling.AssemblyHoleSpace = ((Milling.AssemblyHoleMaxSpace + Milling.AssemblyHoleMinSpace) * 0.5)
  HoleCount = Round(math.floor(Dist / Milling.AssemblyHoleSpace))
  HoleSpacing = (Dist / HoleCount)
  HoleCount = (Dist / HoleSpacing)
  if (Dist > (HoleSpacing * 2.0)) then
    for i = HoleCount, 1, -1 do
      pt1 = Polar2D(pt1, Ang1, HoleSpacing)
      DrawCircle(pt1, Milling.AssemblyHoleRad, Milling.LNAssemblyHole .. PartName)
      if Project.Debugger then
        DMark("pt1w", pt1)
      end
      BaseScrew(1)
    end -- for end
  elseif (Dist > HoleSpacing) then
    ptC = Polar2D(pt1, Ang1, Dist / 2.0)
    if Project.Debugger then
      DMark("ptC", ptC)
    end
    DrawCircle(ptC, Milling.AssemblyHoleRad, Milling.LNAssemblyHole .. PartName)
  else
    -- Done No Holes
  end
  return true
end -- end AssyHoler function
  -- =====================================================]]
  function DrawBoneCenter2Pts(pt1, pt2, SlotWidth, BitRadius)
    Local Project = {}
    Project.job  = VectricJob()
    Project.ang  = GetPolarDirection(pt1, pt2)
    Project.dis  = H(SlotWidth)
    Project.bit  = math.sin(math.rad(45.0)) * BitRadius
    Project.ptA  = Polar2D(pt1, Project.ang +  90.0, Project.dis)
    Project.ptAa  = Polar2D(Project.ptA, Project.ang, Project.bit)
    Project.ptAb  = Polar2D(Project.ptA, Project.ang + 270.0, Project.bit)
    Project.ptB  = Polar2D(pt1, Project.ang + 270.0, Project.dis)
    Project.ptBa  = Polar2D(Project.ptB, Project.ang +  90.0, Project.bit)
    Project.ptBb  = Polar2D(Project.ptB, Project.ang, Project.bit)
    Project.ptC  = Polar2D(pt2, Project.ang + 270.0, Project.dis)
    Project.ptCa  = Polar2D(Project.ptC, Project.ang +  90.0, Project.bit)
    Project.ptCb  = Polar2D(Project.ptC, Project.ang - 180.0, Project.bit)
    Project.ptD  = Polar2D(pt2, Project.ang +  90.0, Project.dis)
    Project.ptDa  = Polar2D(Project.ptD, Project.ang - 180.0, Project.bit)
    Project.ptDb  = Polar2D(Project.ptD, Project.ang + 270.0, Project.bit)
    Project.line  = Contour(0.0)
    Project.layer = Project.job.LayerManager:GetLayerWithName("DogBone")
    Project.line:AppendPoint(Project.ptAa)
    Project.line:ArcTo(Project.ptAb, 1.0)
    Project.line:LineTo(Project.ptBa)
    Project.line:ArcTo(Project.ptBb, 1.0)
    Project.line:LineTo(Project.ptCb)
    Project.line:ArcTo(Project.ptCa, 1.0)
    Project.line:LineTo(Project.ptDb)
    Project.line:ArcTo(Project.ptDa, 1.0)
    Project.line:LineTo(Project.ptAa)
    Project.layer:AddObject(CreateCadContour(Project.line), true)
    return true
  end -- function end
  -- =====================================================]]
  function InsideCornerNipper(AngPlung, BitRadius, CornerPt)
  local NipLength = math.sin(math.rad(45.0)) * ((BitRadius + 0.04) * 2.0)
  local Pt1, Pt2 = Point2D()
  if Material.Orientation == "V" then
    Pt1 = Polar2D(CornerPt, (AngPlung + 90.0) - 45.0, NipLength)
    Pt2 = Polar2D(CornerPt, (AngPlung + 90.0) + 45.0, NipLength)
  else
    Pt1 = Polar2D(CornerPt, (AngPlung + 180.0) - 45.0, NipLength)
    Pt2 = Polar2D(CornerPt, (AngPlung + 180.0) + 45.0, NipLength)
  end
  return Pt1, Pt2
end
  -- =====================================================]]
  function AddGroupToJob(job, group, layer_name)
    --[[  --------------- AddGroupToJob --------------------------------------------------|
  |  Add passed group to the job - returns object created
  |  Parameters:
  |    job              -- job we are working with
  |    group            -- group of contours to  add to document
  |    layer_name      -- name of layer group will be created on|
  |  Return Values:
  |    object created to represent group in document
  ]]
    --  create a CadObject to represent the  group
    local cad_object = CreateCadGroup(group);
    -- create a layer with passed name if it doesnt already exist
    local layer = job.LayerManager:GetLayerWithName(layer_name)
    -- and add our object to it
    layer:AddObject(cad_object, true)
    return cad_object
  end


  -- =====================================================]]
===IsDir()===
  function DrawArc(PtS, PtE, ArcRadius, Layer)
 
  --[[Draw Arc
Validates a directory path
  function main(script_path)
  local MyPt1 = Point2D(3.5,3.8)
  local MyPt2 = Point2D(3.5,6.8)
  local layer = "My Arc"
  DrawArc(MyPt1, MyPt2, -0.456, Layer)
  return true
  end -- function end
  -- -----------------------------------------------------]]
      local job = VectricJob()
      if not job.Exists then
        DisplayMessageBox("Error: No job loaded")
        return false
      end
      local line = Contour(0.0)
      local layer = job.LayerManager:GetLayerWithName(Layer)
      line:AppendPoint(PtS)
      line:ArcTo(PtE,1);
      layer:AddObject(CreateCadContour(line), true)
      return true
    end -- function end


  -- =====================================================]]
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
  function DrawEllipse(CenterPt, LongAxe, ShortAxe, Layer)
<nowiki>function IsDir(path)                     -- Returns true if path is found
    local LongAngle = 90.0
     local function exists(file)
    local ValueAB = (LongAxe - ShortAxe) * 0.50
       local ok, err, code = os.rename(file, file)
    local ValueAC = ValueAB * math.cos(math.rad(LongAngle))
       if not ok then
    local job = VectricJob()
         if code == 13 then
    local LRad = LongAxe * 0.50
           return true
    local ptT = Polar2D(CenterPt, LongAngle, LRad)
    local X = 0.0
    local pty = Point2D(0.0,0.0)
    local ptx  = Point2D(0.0,0.0)
    local mylayer = job.LayerManager:GetLayerWithName(Layer)
    local line = Contour(0.0)
          line:AppendPoint(ptT)
    while (X < 360.0) do
      pty = Polar2D(CenterPt, LongAngle + X, LRad)
      ValueAC = ValueAB * math.cos(math.rad(LongAngle + X))
      if ((LongAngle + X) >= 90.0) then
        ptx = Polar2D(pty, 180.0, ValueAC)
      else
        ptx = Polar2D(pty,  0.0, ValueAC)
      end
      line:LineTo(ptx)
      X = X + 1
    end -- while end
      line:LineTo(ptT)
    mylayer:AddObject(CreateCadContour(line), true)
    return true
  end -- function end
  -- =====================================================]]
  function DrawEllipse1(DrawEllipse_CenterPt, DrawEllipse_LongAxe, DrawEllipse_ShortAxe, DrawEllipse_LongAxeAngle, DrawEllipse_Layer)
    -- ---------------------------------------------------]]
    function H(x)                                        -- Returns half the value
      return x * 0.5
     end -- function end
    -- ---------------------------------------------------]]
    function Polar2D(pt, ang, dis)                        -- Calculate a new point based on reference point, angle and distance.
    -- Returns a 2Dpoint(x, y)
      return Point2D((pt.X + dis * math.cos(math.rad(ang))), (pt.Y + dis * math.sin(math.rad(ang))))
    end -- End Function
    -- ---------------------------------------------------]]
    function GetDistance(objA, objB)
       local xDist = objB.x - objA.x
      local yDist = objB.y - objA.y
      return math.sqrt((xDist ^ 2) + (yDist ^ 2))
    end -- function end
    -- ---------------------------------------------------]]
    function Radius2Bulge (p1, p2, Rad)
      local chord = math.sqrt(((p2.x - p1.x) ^ 2) + ((p2.y - p1.y) ^ 2))
      local seg = (Rad - (0.5 * (math.sqrt((4.0 * Rad^2) - chord^2))))
      local bulge = (2 * seg) / chord
      return bulge
    end -- function end
    -- ---------------------------------------------------]]
  function GetPolarAngle(Start, Corner, End)
    local function GetPolarDirection(point1, point2)              --
      local ang = math.abs(math.deg(math.atan((point2.Y - point1.Y) / (point2.X - point1.X))))
       if point1.X < point2.X then
         if point1.Y < point2.Y then
          ang = ang + 0.0
        else
          ang = 360.0 - ang
        end -- if end
      else
        if point1.Y < point2.Y then
           ang = 180.0 - ang
        else
          ang = ang + 180.0
         end -- if end
         end -- if end
       end -- if end
       end -- if end
      if ang >=360 then
       return ok, err
        ang = ang -360.0
      end -- if end
       return ang
     end -- function end
     end -- function end
     return math.abs(GetPolarDirection(Corner, Start) - GetPolarDirection(Corner, End))
     return exists(path.."/")
   end -- function end
   end -- function end</nowiki>
    -- ---------------------------------------------------]]
 


    -- Call = DrawEllipse(2DPoint(20.0, 20.0), 20.0, 10.0, 0.0, "Jim")
----
    local job = VectricJob()
    local EndRadius = 0.0
    local TopRadius = 0.0
    local ptT = Polar2D(DrawEllipse_CenterPt,  (90.0 + DrawEllipse_LongAxeAngle), H(DrawEllipse_ShortAxe))
    local ptB = Polar2D(DrawEllipse_CenterPt, (270.0 + DrawEllipse_LongAxeAngle), H(DrawEllipse_ShortAxe))
    local ptR = Polar2D(DrawEllipse_CenterPt,  (0.0 + DrawEllipse_LongAxeAngle), H(DrawEllipse_LongAxe))
    local ptL = Polar2D(DrawEllipse_CenterPt, (180.0 + DrawEllipse_LongAxeAngle), H(DrawEllipse_LongAxe))
    local ptC = DrawEllipse_CenterPt
    --[[
      DMark("ptC", ptC)
      DMark("ptT", ptT)
      DMark("ptB", ptB)
      DMark("ptL", ptL)
      DMark("ptR", ptR)
  ]]
    local C_Offset = H(DrawEllipse_LongAxe - DrawEllipse_ShortAxe)
    local LT_SlopeDist = H(GetDistance(ptL, ptT) - H(DrawEllipse_LongAxe - DrawEllipse_ShortAxe))
    local LT_Dist  = GetDistance(ptL, ptT)
    local LT_Angle = math.abs(90.0 - GetAngle(ptT, ptL, ptC))
    local pt_a = Polar2D(ptL, LT_Angle + DrawEllipse_LongAxeAngle, LT_SlopeDist)
    local aT_Dist  = GetDistance(pt_a, ptT)
    local aC_Dist = aT_Dist / (math.tan(math.rad(LT_Angle)))
    local Tc_Dist = math.sqrt(aT_Dist^2 + aC_Dist^2)
    local pt_c = Polar2D(ptT, (270.0 + DrawEllipse_LongAxeAngle), Tc_Dist)
    local cC_Dist  = GetDistance(pt_c, ptC)
    local b_Dist = math.tan(math.rad(LT_Angle)) * cC_Dist
    local pt_b = Polar2D(ptC, (180.0 + DrawEllipse_LongAxeAngle), b_Dist)
    local pt_d = Polar2D(ptB,  (90.0 + DrawEllipse_LongAxeAngle), Tc_Dist)
    local pt_e = Polar2D(ptC,  (0.0 + DrawEllipse_LongAxeAngle), b_Dist)
    local pt1  = Polar2D(pt_d, (270.0 + DrawEllipse_LongAxeAngle) - LT_Angle, Tc_Dist)
    local pt2  = Polar2D(pt_d, (270.0 + DrawEllipse_LongAxeAngle) + LT_Angle, Tc_Dist)
    local pt3  = Polar2D(pt_c,  (90.0 + DrawEllipse_LongAxeAngle) - LT_Angle, Tc_Dist)
    local pt4  = Polar2D(pt_c,  (90.0 + DrawEllipse_LongAxeAngle) + LT_Angle, Tc_Dist)
    --[[
      DMark("pt1", pt1)
      DMark("pt2", pt2)
      DMark("pt3", pt3)
      DMark("pt4", pt4)
      local line = Contour(0.0)
      local layer = job.LayerManager:GetLayerWithName(DrawEllipse_Layer)
      line:AppendPoint(pt1)
      line:LineTo(pt2)
      line:LineTo(pt3)
      line:LineTo(pt4)
      line:LineTo(pt1)
      layer:AddObject(CreateCadContour(line), true)
  ]]
    local T_Sec  = GetDistance(ptC, ptT) - H(GetDistance(pt1, pt4))
    local R_Sec  = GetDistance(ptC, ptR) - H(GetDistance(pt1, pt2))
    local T_Chor  = GetDistance(pt1, pt2)
    local R_Chor  = GetDistance(pt1, pt4)
    local T_Bulge = Radius2Bulge (pt1, pt2, Tc_Dist)
    local L_Bulge = Radius2Bulge (pt1, pt4, GetDistance(ptL, pt_b))


    local line = Contour(0.0)
===FileExists()===
    local layer = job.LayerManager:GetLayerWithName(DrawEllipse_Layer)
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
    line:AppendPoint(pt1)
Returns Dialog size in a message box showing the X and Y values.
    line:ArcTo(pt2, T_Bulge)
<nowiki> function FileExists(name)
    line:ArcTo(pt3, L_Bulge)
-- FileExists(name
    line:ArcTo(pt4, T_Bulge)
-- DisplayMessageBox(name)
    line:ArcTo(pt1, L_Bulge)
     local f=io.open(name,"r")
    layer:AddObject(CreateCadContour(line), true)
     if f~=nil then
    job:Refresh2DView()
       io.close(f)
    return true
  end -- Draw Ellipse function end
  -- =====================================================]]
  function DrawBox(p1, p2, p3, p4, Layer)
    --[[ Draw Box
    function main(script_path)
    local MyPt1 = Point2D(1.0,1.0)
    local MyPt2 = Point2D(1.0,3.0)
     local MyPt3 = Point2D(3.0,1.0)
    local MyPt4 = Point2D(3.0,3.0)
    local layer = "My Box"
    DrawBox(MyPt1 ,MyPt2, MyPt3, MyPt4, Layer)
     return true
    end -- function end
  -- -----------------------------------------------------]]
      local job = VectricJob()
      if not job.Exists then
        DisplayMessageBox("Error: No job loaded")
        return false
      end -- if end
      local line = Contour(0.0)
       local layer = job.LayerManager:GetLayerWithName(Layer)
      line:AppendPoint(p1)
      line:LineTo(p2)
      line:LineTo(p3)
      line:LineTo(p4)
      line:LineTo(p1)
      layer:AddObject(CreateCadContour(line), true)
       return true
       return true
     end -- function end
     else
  -- =====================================================]]
  function DrawCircle(Pt1, CenterRadius, Layer)
    --[[ ==Draw Circle==
    function main(script_path)
    local MyPt1 = Point2D(1.0,1.0)
    local MyRad = 3.0
    local layer = "My Box"
    DrawCircle(MyPt1, MyRad, Layer)
    return true
    end -- function end
  -- -----------------------------------------------------]]
    local job = VectricJob()
    if not job.Exists then
      DisplayMessageBox("Error: No job loaded")
      return false
    end -- if end
    local pa = Polar2D(Pt1,  180.0, CenterRadius)
    local pb = Polar2D(Pt1,    0.0, CenterRadius)
    local Contour = Contour(0.0)
    local layer = job.LayerManager:GetLayerWithName(Layer)
    Contour:AppendPoint(pa)
    Contour:ArcTo(pb, 1)
    Contour:ArcTo(pa, 1)
    layer:AddObject(CreateCadContour(Contour), true)
    return true
  end -- function end
  -- =====================================================]]
  function DrawLine(Pt1, Pt2, Layer)
  --[[Draws a line from Pt1 to Pt2 on the layer name.
  function main(script_path)
  local MyPt1 = Point2D(3.5,3.8)
  local MyPt2 = Point2D(3.5,6.8)
  local layer = "My Line"
  DrawLine(MyPt1 , MyPt2, MyPt3, Layer)
  return true
  end -- function end
  -- -----------------------------------------------------]]
    local job = VectricJob()
    if not job.Exists then
      DisplayMessageBox("Error: No job loaded")
       return false
       return false
     end
     end
    local line = Contour(0.0)
  end -- function end</nowiki>
    local layer = job.LayerManager:GetLayerWithName(Layer)
 
    line:AppendPoint(Pt1)
----
    line:LineTo(Pt2)
 
    layer:AddObject(CreateCadContour(line), true)
===DirectoryProcessor()===
    return true
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
   end -- function end
 
  -- =====================================================]]
Returns number of files that were processed by an operation.
  function DrawStar(pt1, InRadius ,OutRadius, layer)     --This draw function requires the center point, inter star radius, outer star radius and layer name.
 
   --[[
<nowiki> function DirectoryProcessor(job, dir_name, filter, do_sub_dirs, function_ptr)
    function main(script_path)
      local num_files_processed = 0
      local MyPt = Point2D(3.5,3.8)
      local directory_reader = DirectoryReader()
      local InRadius = 9.0
      local cur_dir_reader = DirectoryReader()
      local OutRadius= 20.0
      directory_reader:BuildDirectoryList(dir_name, do_sub_dirs)
      local layer = "My Star"
      directory_reader:SortDirs()
      DrawStar(MyPt , InRadius ,OutRadius, layer)
      local number_of_directories = directory_reader:NumberOfDirs()
      return true
      for i = 1, number_of_directories do
    end -- function end
        local cur_directory = directory_reader:DirAtIndex(i)
        -- get contents of current directory
        -- dont include sub dirs, use passed filter
        cur_dir_reader:BuildDirectoryList(cur_directory.Name, false)
        cur_dir_reader:GetFiles(filter, true, false)
        -- call passed method for each file:
        local num_files_in_dir = cur_dir_reader:NumberOfFiles()
        for j=1, num_files_in_dir  do
          local file_info = cur_dir_reader:FileAtIndex(j)
          if not function_ptr(job, file_info.Name) then
            return true
          end -- if end
          num_files_processed = num_files_processed + 1
        end -- for end
        -- empty out our directory object ready for next go
        cur_dir_reader:ClearDirs()
        cur_dir_reader:ClearFiles()
      end -- for end
      return num_files_processed
   end -- function end </nowiki>
----
 
==Drawing Tools==
[[File:Back.jpg|right|50px|link=Vectric Lua Interface for Gadgets]]
This object is a name-value pair that represents a Document Variable within a [[VectricJob]].
 
----
 
===DrawArrowLineArrow===
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
Draws a dimension line with arrow heads and extension leaders
<nowiki>function DrawArrowLineArrow(Pt1, Ext1, Pt2, Ext2, Off, Str, Layer, scale)
  -- DrawArrowLineArrow(pt1, true, pt3, true, 2.5, "122.5", "TestLayer", 6.0) -- both
   -- DrawArrowLineArrow(pt1, true, pt3, false, 2.5, "122.5", "TestLayer", 6.0) -- first leader only
  -- DrawArrowLineArrow(pt1, false, pt3, true, 2.5, "122.5", "TestLayer", 6.0) -- second leader only
   -- -----------------------------------------------------]]
   -- -----------------------------------------------------]]
     local job = VectricJob()
     local job = VectricJob()
Line 1,747: Line 1,689:
       DisplayMessageBox("Error: No job loaded")
       DisplayMessageBox("Error: No job loaded")
       return false
       return false
     end
     end -- if end
     local p1 = Polar2D(pt1, 18.0,  OutRadius)
     local DimArrow1Angle = GetPolarDirection(Pt1, Pt2, Polar2D(Pt2, 0.0, 1.0))
     local p2 = Polar2D(pt1, 54.0, InRadius)
    local DimArrow2Angle = DimArrow1Angle + 180.0
     local p3 = Polar2D(pt1, 90.0, OutRadius)
    local LederAng      = DimArrow1Angle + 90.0
     local p4 = Polar2D(pt1, 126.0, InRadius)
    local LedDrop        = LederAng + 180.0
     local p5 = Polar2D(pt1, 162.0, OutRadius)
    local TxtCenter      = GetDistance(Pt1, Pt2) * 0.5
     local p6 = Polar2D(pt1, 198.0, InRadius)
    local ArrowLen      = 0.125 * scale
     local p7 = Polar2D(pt1, 234.0, OutRadius)
    local StrSet        = (string.len(Str) * ArrowLen) * 0.5
     local p8 = Polar2D(pt1, 270.0, InRadius)
     local PT01A          = Polar2D(Pt1, LederAng, ArrowLen * 2.0)
     local p9 = Polar2D(pt1, 306.0, OutRadius)
    local PT02A          = Polar2D(PT01A, LederAng, Off)
     local p0 = Polar2D(pt1, 342.0, InRadius)
    local PT03A          = Polar2D(PT02A, LederAng, ArrowLen)
     local line = Contour(0.0)
     local PT01B          = Polar2D(Pt2, LederAng, ArrowLen * 2.0)
  -- local layers = job.LayerManager:GetLayerWithName(layer)
    local PT02B          = Polar2D(PT01B, LederAng, Off)
     line:AppendPoint(p1);
     local PT03B          = Polar2D(PT02B, LederAng, ArrowLen)
     line:LineTo(p2);  line:LineTo(p3)
     local Apt1          = Polar2D(PT02A, DimArrow1Angle + 15.0, ArrowLen)
     line:LineTo(p4);  line:LineTo(p5)
     local Apt2          = Polar2D(PT02A, DimArrow1Angle - 15.0, ArrowLen)
     line:LineTo(p6);  line:LineTo(p7)
     local TxtPt1        = Polar2D(Polar2D(PT02A, DimArrow1Angle, TxtCenter), DimArrow1Angle + 90.0, ArrowLen)
     line:LineTo(p8);  line:LineTo(p9)
     local TxtPt          = Polar2D(TxtPt1, DimArrow2Angle, StrSet)
     line:LineTo(p0);  line:LineTo(p1)
    local ArrowHead      = (ArrowLen * 0.333)
     layer:AddObject(CreateCadContour(line), true)
    local line1          = Contour(0.0)
     job:Refresh2DView()
    local layer1        = job.LayerManager:GetLayerWithName(Layer)
    line1:AppendPoint(Apt1)
    line1:LineTo(PT02A)
    line1:LineTo(Apt2)
    line1:LineTo(Apt1)
    layer1:AddObject(CreateCadContour(line1), true)
     local Apt3 = Polar2D(PT02B, DimArrow2Angle + 15.0, ArrowLen)
     local Apt4 = Polar2D(PT02B, DimArrow2Angle - 15.0, ArrowLen)
     local line2 = Contour(0.0)
    local layer2 = job.LayerManager:GetLayerWithName(Layer)
     line2:AppendPoint(Apt3)
     line2:LineTo(PT02B)
    line2:LineTo(Apt4)
     line2:LineTo(Apt3)
    layer2:AddObject(CreateCadContour(line2), true)
     if Ext1 then
      local lineA = Contour(0.0)
      local layerA = job.LayerManager:GetLayerWithName(Layer)
      lineA:AppendPoint(PT01A)
      lineA:LineTo(PT03A)
      layerA:AddObject(CreateCadContour(lineA), true)
     end -- if end
    if Ext2 then
      local lineB = Contour(0.0)
      local layerB = job.LayerManager:GetLayerWithName(Layer)
      lineB:AppendPoint(PT01B)
      lineB:LineTo(PT03B)
      layerB:AddObject(CreateCadContour(lineB), true)
    end -- if end
    local lineC = Contour(0.0)
    local layerC = job.LayerManager:GetLayerWithName(Layer)
     lineC:AppendPoint(PT02A)
    lineC:LineTo(PT02B)
     layerC:AddObject(CreateCadContour(lineC), true)
     DrawWriter(Double2Fraction(Str), TxtPt, ArrowLen, Layer, DimArrow1Angle)
     return true
     return true
   end -- function end
   end -- function end</nowiki>
  -- =====================================================]]
 
  function DrawTriangle(p1, p2, p3, Layer)
----
  --[[Draw Triangle
 
    function main(script_path)
===LayerClear===
      local MyPt1 = Point2D(3.5,3.8)
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
      local MyPt2 = Point2D(3.5,6.8)
Deletes Layer if empty.
      local MyPt3 = Point2D(9.8,6.8)
 
      local layer = "My Triangle"
<nowiki>function LayerClear(LayerName)
      DrawTriangle(MyPt1 , MyPt2, MyPt3, Layer)
  local Mylayer = Milling.job.LayerManager:GetLayerWithName(LayerName)
      return true
  if Mylayer.IsEmpty then
    end -- function end
    Milling.job.LayerManager:RemoveLayer(Mylayer)
  -- -----------------------------------------------------]]
  end -- if end
  return true
end -- function end</nowiki>
 
----
 
===LeaderLine===
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
<nowiki>function DrawLeader(Pt1, Pt2, Pt3, Str, Layer, scale)  --Draws a leader with text
  --[[
  DrawLeader(pt1, pt2, "122.5", "TestLayer", 6.0)
  --]]
     local job = VectricJob()
     local job = VectricJob()
     if not job.Exists then
     if not job.Exists then
       DisplayMessageBox("Error: No job loaded")
       DisplayMessageBox("Error: No job loaded")
       return false
       return false
     end
     end -- if end
     local line = Contour(0.0)
     local ArrowLen      = 0.125 * scale
     local layer = job.LayerManager:GetLayerWithName(Layer)
    local DimArrowAngle  = GetPolarDirection(Pt1, Pt2, Polar2D(Pt2, 0.0, 1.0))
     line:AppendPoint(p1)
    local TxtAngle      = GetPolarDirection(Pt2, Pt3, Polar2D(Pt3, 0.0, 1.0))
     line:LineTo(p2)
    local TxtPt          = Polar2D(Polar2D(Pt3, TxtAngle, ArrowLen), TxtAngle-45, H(ArrowLen))
     line:LineTo(p3)
    local Apt1          = Polar2D(Pt1, DimArrowAngle + 15.0, ArrowLen)
     line:LineTo(p1)
    local Apt2          = Polar2D(Pt1, DimArrowAngle - 15.0, ArrowLen)
     layer:AddObject(CreateCadContour(line), true)
    local ArrowHead      = ArrowLen * 0.333
     job:Refresh2DView()
    local line1          = Contour(0.0)
     local layer1        = job.LayerManager:GetLayerWithName(Layer)
     line1:AppendPoint(Pt1)
     line1:LineTo(Apt2) ;  line1:LineTo(Apt1) ; line1:LineTo(Pt1)
    layer1:AddObject(CreateCadContour(line1), true)
     local lineC = Contour(0.0)
    local layerC = job.LayerManager:GetLayerWithName(Layer)
    lineC:AppendPoint(Pt1)
    lineC:LineTo(Pt2)
     lineC:LineTo(Pt3)
     layerC:AddObject(CreateCadContour(lineC), true)
     if IsAllNumber(Str) then
      DrawWriter(Double2Fraction(Str), TxtPt, ArrowLen, Layer, TxtAngle)
    else
      DrawWriter(Str, TxtPt, ArrowLen, Layer, TxtAngle)
    end -- if end
     return true
     return true
   end -- function end
   end -- function end</nowiki>
  -- =====================================================]]
 
   function Radius2Bulge (p1, p2, Rad)
----
    local chord = math.sqrt(((p2.x - p1.x) ^ 2) + ((p2.y - p1.y) ^ 2))
 
    local seg = (Rad - (0.5 * (math.sqrt((4.0 * Rad^2) - chord^2))))
===Scale===
    local bulge = (2 * seg) / chord
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
    return bulge
Provides the correct scale rate-based drawing units.
  end
 
  -- =====================================================]]
<nowiki>function Scale(Num)
  function ChordSeg2Radius (Chr, Seg)
  local mtl_block = MaterialBlock()
    local rad = (((Chr * Chr)/(Seg * 4)) + Seg) / 2.0
  if mtl_block.InMM then
    return rad
    return Num * 25.4
  end -- end Function
  else
    return Num
  end
end -- function end</nowiki>
 
----
 
===AssyHoler===
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
Draws Assy Holes in a stright line (Rabbet and/or Dado).
 
<nowiki>function AssyHoler(pt1, pt2, PartName)                  -- Draws Assy Holes in a stright line
    local Ang1 = GetPolarDirection(pt1, pt2)
    local Ang2 = GetPolarDirection(pt2, pt1)
            pt1 = Polar2D(pt1, Ang1, Milling.AssemblyHoleStartEnd)
    DrawCircle(pt1, Milling.AssemblyHoleRad, Milling.LNAssemblyHole .. PartName)
            pt2 = Polar2D(pt2, Ang2, Milling.AssemblyHoleStartEnd)
    DrawCircle(pt2, Milling.AssemblyHoleRad, Milling.LNAssemblyHole .. PartName)
    local Dist = GetDistance(pt1, pt2)
    if Project.Debugger then
        DMark("pt1", pt1)
        DMark("pt2", pt2)
    end -- if end
    BaseScrew(2)
    Milling.AssemblyHoleSpace = ((Milling.AssemblyHoleMaxSpace + Milling.AssemblyHoleMinSpace) * 0.5)
    HoleCount = Round(math.floor(Dist / Milling.AssemblyHoleSpace))
    HoleSpacing = (Dist / HoleCount)
    HoleCount = (Dist / HoleSpacing)
    if (Dist > (HoleSpacing * 2.0)) then
    for i = HoleCount, 1, -1 do
      pt1 = Polar2D(pt1, Ang1, HoleSpacing)
      DrawCircle(pt1, Milling.AssemblyHoleRad, Milling.LNAssemblyHole .. PartName)
      if Project.Debugger then
>      DMark("pt1w", pt1)
      end -- if end
      BaseScrew(1)
    end -- for end
  elseif (Dist > HoleSpacing) then
    ptC = Polar2D(pt1, Ang1, Dist / 2.0)
    if Project.Debugger then
      DMark("ptC", ptC)
    end -- if end
    DrawCircle(ptC, Milling.AssemblyHoleRad, Milling.LNAssemblyHole .. PartName)
  else
    -- Done No Holes
  end -- if end
  return true
end -- function end</nowiki>
 
----
 
===DrawBoneCenter2Pts===
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
Draws dog bone joints.
 
<nowiki>function DrawBoneCenter2Pts(pt1, pt2, SlotWidth, BitRadius)
  Local Project = {}
  Project.job  = VectricJob()
  Project.ang  = GetPolarDirection(pt1, pt2)
  Project.dis  = H(SlotWidth)
  Project.bit  = math.sin(math.rad(45.0)) * BitRadius
  Project.ptA  = Polar2D(pt1, Project.ang +  90.0, Project.dis)
  Project.ptAa  = Polar2D(Project.ptA, Project.ang, Project.bit)
  Project.ptAb  = Polar2D(Project.ptA, Project.ang + 270.0, Project.bit)
  Project.ptB  = Polar2D(pt1, Project.ang + 270.0, Project.dis)
  Project.ptBa  = Polar2D(Project.ptB, Project.ang +  90.0, Project.bit)
  Project.ptBb  = Polar2D(Project.ptB, Project.ang, Project.bit)
  Project.ptC   = Polar2D(pt2, Project.ang + 270.0, Project.dis)
  Project.ptCa  = Polar2D(Project.ptC, Project.ang +  90.0, Project.bit)
  Project.ptCb  = Polar2D(Project.ptC, Project.ang - 180.0, Project.bit)
  Project.ptD  = Polar2D(pt2, Project.ang +  90.0, Project.dis)
  Project.ptDa  = Polar2D(Project.ptD, Project.ang - 180.0, Project.bit)
  Project.ptDb  = Polar2D(Project.ptD, Project.ang + 270.0, Project.bit)
  Project.line  = Contour(0.0)
  Project.layer = Project.job.LayerManager:GetLayerWithName("DogBone")
  Project.line:AppendPoint(Project.ptAa)
  Project.line:ArcTo(Project.ptAb, 1.0)
  Project.line:LineTo(Project.ptBa)
  Project.line:ArcTo(Project.ptBb, 1.0)
  Project.line:LineTo(Project.ptCb)
  Project.line:ArcTo(Project.ptCa, 1.0)
  Project.line:LineTo(Project.ptDb)
  Project.line:ArcTo(Project.ptDa, 1.0)
  Project.line:LineTo(Project.ptAa)
  Project.layer:AddObject(CreateCadContour(Project.line), true)
  return true
end -- function end</nowiki>
 
----
 
===InsideCornerNipper===
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
Draws the nipping of a corner for easy fitting.
 
<nowiki>function InsideCornerNipper(AngPlung, BitRadius, CornerPt)
  local NipLength = math.sin(math.rad(45.0)) * ((BitRadius + 0.04) * 2.0)
  local Pt1, Pt2 = Point2D()
  if Material.Orientation == "V" then
    Pt1 = Polar2D(CornerPt, (AngPlung + 90.0) - 45.0, NipLength)
    Pt2 = Polar2D(CornerPt, (AngPlung + 90.0) + 45.0, NipLength)
  else
    Pt1 = Polar2D(CornerPt, (AngPlung + 180.0) - 45.0, NipLength)
    Pt2 = Polar2D(CornerPt, (AngPlung + 180.0) + 45.0, NipLength)
  end
  return Pt1, Pt2
end -- function end</nowiki>
 
----
 
===AddGroupToJob===
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
Builds a Grouping from the layer selection.
 
<nowiki>function AddGroupToJob(job, group, layer_name)
  --[[  --------------- AddGroupToJob --------------------------------------------------|
  |  Add passed group to the job - returns object created
  |  Parameters:
  |    job              -- job we are working with
  |    group            -- group of contours to  add to document
  |    layer_name      -- name of layer group will be created on|
  |  Return Values:
  |    object created to represent group in document
  ]]
  --  create a CadObject to represent the  group
  local cad_object = CreateCadGroup(group);
  -- create a layer with passed name if it doesnt already exist
  local layer = job.LayerManager:GetLayerWithName(layer_name)
  -- and add our object to it
  layer:AddObject(cad_object, true)
  return cad_object
  end -- function end</nowiki>
 
----
 
===DrawArc===
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
Draws an Arc from points provided.
 
<nowiki>function DrawArc(PtS, PtE, ArcRadius, Layer)
  --[[Draw Arc
  function main(script_path)
  local MyPt1 = Point2D(3.5,3.8)
  local MyPt2 = Point2D(3.5,6.8)
  local layer = "My Arc"
  DrawArc(MyPt1, MyPt2, -0.456, Layer)
  return true
  end -- function end
  -- -----------------------------------------------------]]
      local job = VectricJob()
      if not job.Exists then
        DisplayMessageBox("Error: No job loaded")
        return false
      end
      local line = Contour(0.0)
      local layer = job.LayerManager:GetLayerWithName(Layer)
      line:AppendPoint(PtS)
      line:ArcTo(PtE,1);
      layer:AddObject(CreateCadContour(line), true)
      return true
    end -- function end</nowiki>
 
----
 
===DrawEllipse===
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
Draws a DrawEllipse from points provided.


  -- ====================================================]]
<nowiki>function DrawEllipse(CenterPt, LongAxe, ShortAxe, Layer)
  function CreateJob(job_name, width, height, thickness, in_mm, job_origin, z_on_surface)
  local LongAngle = 90.0
--[[ ----------- CreateJob -------------------------------------------------
  local ValueAB = (LongAxe - ShortAxe) * 0.50
  | This function was provided "as is" by Vectric technical team and a part of the gadget API documentation.
  local ValueAC = ValueAB * math.cos(math.rad(LongAngle))
  | Create a new empty job with the passed settings
  local job = VectricJob()
]]
  local LRad = LongAxe * 0.50
  -- we fill in most of our bounds in a Box2D
  local ptT = Polar2D(CenterPt, LongAngle, LRad)
  local job_bounds = Box2D()
  local X = 0.0
  local blc = Point2D(0, 0)
  local pty = Point2D(0.0,0.0)
  local trc = Point2D(width, height)
  local ptx = Point2D(0.0,0.0)
  local origin_offset = Vector2D(0,0)
  local mylayer = job.LayerManager:GetLayerWithName(Layer)
  -- calculate bottom left corner offset for chosen origin
  local line = Contour(0.0)
  if Template.DXFOrientation == "Vertical" then
        line:AppendPoint(ptT)
    trc = Point2D(height, width)
    while (X < 360.0) do
    if (job_origin == "BLC") then
        pty = Polar2D(CenterPt, LongAngle + X, LRad)
      origin_offset:Set(0, 0)
     ValueAC = ValueAB * math.cos(math.rad(LongAngle + X))
    elseif (job_origin == "BRC") then
     if ((LongAngle + X) >= 90.0) then
      origin_offset:Set(height, 0)
       ptx = Polar2D(pty, 180.0, ValueAC)
    elseif (job_origin == "TRC") then
      origin_offset:Set(height, width)
    elseif (job_origin == "TLC") then
      origin_offset:Set(0, width)
     elseif (job_origin == "CENTRE") then
      origin_offset:Set(height / 2, width / 2)
     elseif (job_origin == "CENTER") then
       origin_offset:Set(height / 2, width / 2)
     else
     else
       MessageBox("Unknown XY origin specified " .. job_origin)
       ptx = Polar2D(pty,  0.0, ValueAC)
     end
     end
  else
     line:LineTo(ptx)
     if (job_origin == "BLC") then
     X = X + 1
      origin_offset:Set(0, 0)
  end -- while end
     elseif (job_origin == "BRC") then
  line:LineTo(ptT)
      origin_offset:Set(width, 0)
  mylayer:AddObject(CreateCadContour(line), true)
    elseif (job_origin == "TRC") then
  return true
      origin_offset:Set(width, height)
end -- function end</nowiki>
    elseif (job_origin == "TLC") then
 
      origin_offset:Set(0, height)
----
    elseif (job_origin == "CENTRE") then
      origin_offset:Set(width / 2, height / 2)
    elseif (job_origin == "CENTER") then
      origin_offset:Set(width / 2, height / 2)
    else
      MessageBox("Unknown XY origin specified " .. job_origin)
    end
  end
  -- subtract the origin offset vector from our 'standard' corner positions to get position for corners for requested origin
  blc = blc - origin_offset
  trc = trc - origin_offset
  job_bounds:Merge(blc)
  job_bounds:Merge(trc)
  local success = CreateNewJob(job_name,job_bounds,thickness,in_mm,z_on_surface)
  return success
end
  -- =====================================================]]
  function DrawFontGrid(job)
    local pt = Point2D(0.3,0.3)
    local scl  = 1.0 -- (scl * 0.5)
    local pA0  = pt
    local ang  = 0.0
    local pA1  = Polar2D(pt, ang + 90.0000, (0.2500 * scl))
    local pA2  = Polar2D(pt, ang + 90.0000, (0.5000 * scl))
    local pA3  = Polar2D(pt, ang + 90.0000, (0.7500 * scl))
    local pA4  = Polar2D(pt, ang + 90.0000, (1.0000 * scl))
    local pA5  = Polar2D(pt, ang + 90.0000, (1.2500 * scl))
    local pA6  = Polar2D(pt, ang + 90.0000, (1.5000 * scl))
    local pA7  = Polar2D(pt, ang + 90.0000, (1.7500 * scl))
    local pA8  = Polar2D(pt, ang + 90.0000, (2.0000 * scl))
    local pA9  = Polar2D(pt, ang + 90.0000, (2.2500 * scl))
    local pA10 = Polar2D(pt, ang + 90.0000, (2.5000 * scl))


    PointCircle(pA0)
===DrawEllipse1===
    PointCircle(pA1)
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
    PointCircle(pA2)
Draws a DrawEllipse from points provided.
    PointCircle(pA3)
    PointCircle(pA4)
    PointCircle(pA5)
    PointCircle(pA6)
    PointCircle(pA7)
    PointCircle(pA8)
    PointCircle(pA9)
    PointCircle(pA10)


    local pB0 = Polar2D(pt, ang + 0.0000, (0.2500 * scl))
  <nowiki>function DrawEllipse1(DrawEllipse_CenterPt, DrawEllipse_LongAxe, DrawEllipse_ShortAxe, DrawEllipse_LongAxeAngle, DrawEllipse_Layer)
    local pB1  = Polar2D(pt, ang + 45.0000, (0.3536 * scl))
    -- ---------------------------------------------------]]
    local pB2  = Polar2D(pt, ang + 63.4352, (0.5590 * scl))
    function H(x)                                        -- Returns half the value
    local pB3 = Polar2D(pt, ang + 71.5651, (0.7906 * scl))
      return x * 0.5
    local pB4  = Polar2D(pt, ang + 75.9638, (1.0308 * scl))
    end -- function end
    local pB5  = Polar2D(pt, ang + 78.6901, (1.2748 * scl))
    -- ---------------------------------------------------]]
    local pB6 = Polar2D(pt, ang + 80.5376, (1.5207 * scl))
    function Polar2D(pt, ang, dis)                        -- Calculate a new point based on reference point, angle and distance.
    local pB7 = Polar2D(pt, ang + 81.8699, (1.7678 * scl))
    -- Returns a 2Dpoint(x, y)
    local pB8 = Polar2D(pt, ang + 82.8750, (2.0156 * scl))
      return Point2D((pt.X + dis * math.cos(math.rad(ang))), (pt.Y + dis * math.sin(math.rad(ang))))
    local pB10 = Polar2D(pt, ang + 84.2894, (2.5125 * scl))
    end -- End Function
    -- ---------------------------------------------------]]
    function GetDistance(objA, objB)
      local xDist = objB.x - objA.x
      local yDist = objB.y - objA.y
      return math.sqrt((xDist ^ 2) + (yDist ^ 2))
    end -- function end
    -- ---------------------------------------------------]]
    function Radius2Bulge (p1, p2, Rad)
      local chord = math.sqrt(((p2.x - p1.x) ^ 2) + ((p2.y - p1.y) ^ 2))
      local seg = (Rad - (0.5 * (math.sqrt((4.0 * Rad^2) - chord^2))))
      local bulge = (2 * seg) / chord
      return bulge
    end -- function end
    -- ---------------------------------------------------]]
  function GetPolarAngle(Start, Corner, End)
    local function GetPolarDirection(point1, point2)              --
      local ang = math.abs(math.deg(math.atan((point2.Y - point1.Y) / (point2.X - point1.X))))
      if point1.X < point2.X then
        if point1.Y < point2.Y then
          ang = ang + 0.0
        else
          ang = 360.0 - ang
        end -- if end
      else
        if point1.Y < point2.Y then
          ang = 180.0 - ang
        else
          ang = ang + 180.0
        end -- if end
      end -- if end
      if ang >=360 then
        ang = ang -360.0
      end -- if end
      return ang
    end -- function end
    return  math.abs(GetPolarDirection(Corner, Start) - GetPolarDirection(Corner, End))
  end -- function end
    -- ---------------------------------------------------]]
    -- Call = DrawEllipse(2DPoint(20.0, 20.0), 20.0, 10.0, 0.0, "Jim")
    local job = VectricJob()
    local EndRadius = 0.0
    local TopRadius = 0.0
    local ptT = Polar2D(DrawEllipse_CenterPt, (90.0 + DrawEllipse_LongAxeAngle), H(DrawEllipse_ShortAxe))
    local ptB = Polar2D(DrawEllipse_CenterPt, (270.0 + DrawEllipse_LongAxeAngle), H(DrawEllipse_ShortAxe))
    local ptR = Polar2D(DrawEllipse_CenterPt,   (0.0 + DrawEllipse_LongAxeAngle), H(DrawEllipse_LongAxe))
    local ptL = Polar2D(DrawEllipse_CenterPt, (180.0 + DrawEllipse_LongAxeAngle), H(DrawEllipse_LongAxe))
    local ptC = DrawEllipse_CenterPt
    --[[
      DMark("ptC", ptC)
      DMark("ptT", ptT)
      DMark("ptB", ptB)
      DMark("ptL", ptL)
      DMark("ptR", ptR)]]
    local C_Offset = H(DrawEllipse_LongAxe - DrawEllipse_ShortAxe)
    local LT_SlopeDist = H(GetDistance(ptL, ptT) - H(DrawEllipse_LongAxe - DrawEllipse_ShortAxe))
    local LT_Dist  = GetDistance(ptL, ptT)
    local LT_Angle = math.abs(90.0 - GetAngle(ptT, ptL, ptC))
    local pt_a = Polar2D(ptL, LT_Angle + DrawEllipse_LongAxeAngle, LT_SlopeDist)
    local aT_Dist  = GetDistance(pt_a, ptT)
    local aC_Dist = aT_Dist / (math.tan(math.rad(LT_Angle)))
    local Tc_Dist = math.sqrt(aT_Dist^2 + aC_Dist^2)
    local pt_c = Polar2D(ptT, (270.0 + DrawEllipse_LongAxeAngle), Tc_Dist)
    local cC_Dist = GetDistance(pt_c, ptC)
    local b_Dist = math.tan(math.rad(LT_Angle)) * cC_Dist
    local pt_b = Polar2D(ptC, (180.0 + DrawEllipse_LongAxeAngle), b_Dist)
    local pt_d = Polar2D(ptB,  (90.0 + DrawEllipse_LongAxeAngle), Tc_Dist)
    local pt_e = Polar2D(ptC,   (0.0 + DrawEllipse_LongAxeAngle), b_Dist)
    local pt1 = Polar2D(pt_d, (270.0 + DrawEllipse_LongAxeAngle) - LT_Angle, Tc_Dist)
    local pt2  = Polar2D(pt_d, (270.0 + DrawEllipse_LongAxeAngle) + LT_Angle, Tc_Dist)
    local pt3  = Polar2D(pt_c, (90.0 + DrawEllipse_LongAxeAngle) - LT_Angle, Tc_Dist)
    local pt4 = Polar2D(pt_c, (90.0 + DrawEllipse_LongAxeAngle) + LT_Angle, Tc_Dist)
    --[[
      DMark("pt1", pt1)
      DMark("pt2", pt2)
      DMark("pt3", pt3)
      DMark("pt4", pt4)
      local line = Contour(0.0)
      local layer = job.LayerManager:GetLayerWithName(DrawEllipse_Layer)
      line:AppendPoint(pt1)
      line:LineTo(pt2)
      line:LineTo(pt3)
      line:LineTo(pt4)
      line:LineTo(pt1)
      layer:AddObject(CreateCadContour(line), true)]]
    local T_Sec  = GetDistance(ptC, ptT) - H(GetDistance(pt1, pt4))
    local R_Sec  = GetDistance(ptC, ptR) - H(GetDistance(pt1, pt2))
    local T_Chor  = GetDistance(pt1, pt2)
    local R_Chor  = GetDistance(pt1, pt4)
    local T_Bulge = Radius2Bulge (pt1, pt2, Tc_Dist)
    local L_Bulge = Radius2Bulge (pt1, pt4, GetDistance(ptL, pt_b))
    local line = Contour(0.0)
    local layer = job.LayerManager:GetLayerWithName(DrawEllipse_Layer)
    line:AppendPoint(pt1)
    line:ArcTo(pt2, T_Bulge)
    line:ArcTo(pt3, L_Bulge)
    line:ArcTo(pt4, T_Bulge)
    line:ArcTo(pt1, L_Bulge)
    layer:AddObject(CreateCadContour(line), true)
    job:Refresh2DView()
    return true
  end -- function end</nowiki>


    PointCircle(pB0)
----
    PointCircle(pB1)
    PointCircle(pB2)
    PointCircle(pB3)
    PointCircle(pB4)
    PointCircle(pB5)
    PointCircle(pB7)
    PointCircle(pB8)
    PointCircle(pB10)


    local pC0 = Polar2D(pt, ang +  0.0000, (0.5000 * scl))
===DrawBox===
    local pC1 = Polar2D(pt, ang + 26.5650, (0.5590 * scl))
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
    local pC2 = Polar2D(pt, ang + 45.0000, (0.7071 * scl))
Draws a Box from points provided.
    local pC3 = Polar2D(pt, ang + 56.3099, (0.9014 * scl))
    local pC4 = Polar2D(pt, ang + 63.4342, (1.1180 * scl))
    local pC5 = Polar2D(pt, ang + 68.1993, (1.3463 * scl))
    local pC6 = Polar2D(pt, ang + 71.5650, (1.5811 * scl))
    local pC7 = Polar2D(pt, ang + 63.4342, (1.1180 * scl))
    local pC8 = Polar2D(pt, ang + 74.0550, (1.8201 * scl))
    local pC10 = Polar2D(pt, ang + 78.6899, (2.5495 * scl))


    PointCircle(pC0)
<nowiki>function DrawBox(p1, p2, p3, p4, Layer)
    PointCircle(pC1)
    --[[ Draw Box
    PointCircle(pC2)
    function main(script_path)
    PointCircle(pC3)
    local MyPt1 = Point2D(1.0,1.0)
    PointCircle(pC4)
    local MyPt2 = Point2D(1.0,3.0)
    PointCircle(pC6)
    local MyPt3 = Point2D(3.0,1.0)
    PointCircle(pC8)
    local MyPt4 = Point2D(3.0,3.0)
    PointCircle(pC10)
    local layer = "My Box"
    DrawBox(MyPt1 ,MyPt2, MyPt3, MyPt4, Layer)
    return true
    end -- function end
  -- -----------------------------------------------------]]
      local job = VectricJob()
      if not job.Exists then
        DisplayMessageBox("Error: No job loaded")
        return false
      end -- if end
      local line = Contour(0.0)
      local layer = job.LayerManager:GetLayerWithName(Layer)
      line:AppendPoint(p1)
      line:LineTo(p2)
      line:LineTo(p3)
      line:LineTo(p4)
      line:LineTo(p1)
      layer:AddObject(CreateCadContour(line), true)
      return true
end -- function end</nowiki>


    local pD0 = Polar2D(pt, ang +  0.0000, (0.6250 * scl))
----
    local pD1 = Polar2D(pt, ang + 21.8014, (0.6731 * scl))
    local pD2 = Polar2D(pt, ang + 33.6901, (0.9014 * scl))
    local pD4 = Polar2D(pt, ang + 57.9946, (1.1792 * scl))
    local pD7 = Polar2D(pt, ang + 70.3462, (1.8583 * scl))
    local pD8 = Polar2D(pt, ang + 72.6460, (2.0954 * scl))


    PointCircle(pD0)
===DrawCircle===
    PointCircle(pD1)
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
    PointCircle(pD2)
Draws a circle.
    PointCircle(pD4)
    PointCircle(pD7)
    PointCircle(pD8)


    local pE0 = Polar2D(pt, ang +  0.0000, (0.7500 * scl))
<nowiki>function DrawCircle(Pt1, CenterRadius, Layer)
    local pE1 = Polar2D(pt, ang + 18.4346, (0.7906 * scl))
  --[[ ==Draw Circle==
    local pE2 = Polar2D(pt, ang + 33.6901, (0.9014 * scl))
    function main(script_path)
    local pE3 = Polar2D(pt, ang + 45.0000, (1.0607 * scl))
    local MyPt1 = Point2D(1.0,1.0)
    local pE5 = Polar2D(pt, ang + 59.0371, (1.4578 * scl))
    local MyRad = 3.0
    local pE6 = Polar2D(pt, ang + 63.4349, (1.6771 * scl))
    local layer = "My Box"
    local pE7 = Polar2D(pt, ang + 66.4349, (1.9039 * scl))
    DrawCircle(MyPt1, MyRad, Layer)
    local pE8 = Polar2D(pt, ang + 69.4440, (2.1360 * scl))
    return true
    end -- function end
  -- -----------------------------------------------------]]
    local job = VectricJob()
    if not job.Exists then
      DisplayMessageBox("Error: No job loaded")
      return false
    end -- if end
    local pa = Polar2D(Pt1,   180.0, CenterRadius)
    local pb = Polar2D(Pt1,     0.0, CenterRadius)
    local Contour = Contour(0.0)
    local layer = job.LayerManager:GetLayerWithName(Layer)
    Contour:AppendPoint(pa)
    Contour:ArcTo(pb, 1)
    Contour:ArcTo(pa, 1)
    layer:AddObject(CreateCadContour(Contour), true)
    return true
end -- function end</nowiki>


    PointCircle(pE0)
----
    PointCircle(pE1)
    PointCircle(pE2)
    PointCircle(pE3)
    PointCircle(pE5)
    PointCircle(pE6)
    PointCircle(pE7)
    PointCircle(pE8)


    local pF0 = Polar2D(pt, ang +  0.0000, (1.0000 * scl))
    local pF1 = Polar2D(pt, ang + 14.0360, (1.0308 * scl))
    local pF2 = Polar2D(pt, ang + 26.5651, (1.1180 * scl))
    local pF3 = Polar2D(pt, ang + 36.8699, (1.2500 * scl))
    local pF4 = Polar2D(pt, ang + 45.0000, (1.4142 * scl))
    local pF5 = Polar2D(pt, ang + 51.3425, (1.6006 * scl))
    local pF6 = Polar2D(pt, ang + 56.3099, (1.8025 * scl))
    local pF7 = Polar2D(pt, ang + 60.2551, (2.0156 * scl))
    local pF8 = Polar2D(pt, ang + 63.4349, (2.2361 * scl))


    PointCircle(pF0)
===DrawLine===
    PointCircle(pF1)
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
    PointCircle(pF2)
Draws a Line from points provided.
    PointCircle(pF3)
    PointCircle(pF4)
    PointCircle(pF5)
    PointCircle(pF6)
    PointCircle(pF7)
    PointCircle(pF8)


    local pG0 = Polar2D(pt, ang +  0.0000, (1.2500 * scl))
<nowiki>function DrawLine(Pt1, Pt2, Layer)
    local pG1 = Polar2D(pt, ang + 11.3099, (1.2748 * scl))
  --[[Draws a line from Pt1 to Pt2 on the layer name.
    local pG2 = Polar2D(pt, ang + 21.8014, (1.3463 * scl))
  function main(script_path)
    local pG3 = Polar2D(pt, ang + 30.9638, (1.4577 * scl))
  local MyPt1 = Point2D(3.5,3.8)
    local pG4 = Polar2D(pt, ang + 38.6598, (1.6008 * scl))
  local MyPt2 = Point2D(3.5,6.8)
    local pG5 = Polar2D(pt, ang + 45.0000, (1.7678 * scl))
  local layer = "My Line"
    local pG6 = Polar2D(pt, ang + 50.1944, (1.9526 * scl))
  DrawLine(MyPt1 , MyPt2, MyPt3, Layer)
    local pG7 = Polar2D(pt, ang + 54.4623, (2.1506 * scl))
  return true
    local pG8 = Polar2D(pt, ang + 57.9946, (2.3585 * scl))
  end -- function end
    local pG10 = Polar2D(pt,59.0362, (2.9155 * scl))
  -- -----------------------------------------------------]]
    local job = VectricJob()
    if not job.Exists then
      DisplayMessageBox("Error: No job loaded")
      return false
    end
    local line = Contour(0.0)
    local layer = job.LayerManager:GetLayerWithName(Layer)
    line:AppendPoint(Pt1)
    line:LineTo(Pt2)
    layer:AddObject(CreateCadContour(line), true)
    return true
end -- function end</nowiki>


    PointCircle(pG0)
----
    PointCircle(pG1)
    PointCircle(pG2)
    PointCircle(pG3)
    PointCircle(pG4)
    PointCircle(pG5)
    PointCircle(pG6)
    PointCircle(pG7)
    PointCircle(pG8)
    PointCircle(pG10)


    local pH0  = Polar2D(pt, ang + 0.0000, (1.5000 * scl))
===DrawStar===
    local pH10 = Polar2D(pt, 63.4349,      (2.7951 * scl))
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
    PointCircle(pH0)
Draws a Star from points provided.
    PointCircle(pH10)
    job:Refresh2DView()
    return true
  end


  -- =====================================================]]
<nowiki>function DrawStar(pt1, InRadius ,OutRadius, layer)      --This draw function requires the center point, inter star radius, outer star radius and layer name.
  function DrawWriterOld(what, where, size, lay, ang)
  --[[
    local group
    function main(script_path)
  --[[ How to use:
      local MyPt = Point2D(3.5,3.8)
  |    local TextMessage = "Your Text Here"
      local InRadius = 9.0
  |    local TextPt = Point2D(3.5,3.8)
      local OutRadius= 20.0
  |    local TextHight = 0.5
      local layer = "My Star"
  |    local TextLayer = "Jim Anderson"
      DrawStar(MyPt , InRadius ,OutRadius, layer)
  |    local TextAng = 20.0
      return true
  |    DrawWriter(TextMessage ,local TextPt , TextHight , TextLayer,TextAng )
    end -- function end
  |    -- ==Draw Writer==
  -- -----------------------------------------------------]]
  |    -- Utilizing a provided string of text, the program walks the string and reproduces each letter (parametrically) on the drawing using vectors.
    local job = VectricJob()
  function main()
    if not job.Exists then
      -- create a layer with passed name if it doesn't already exist
      DisplayMessageBox("Error: No job loaded")
    local job = VectricJob()
      return false
    if not job.Exists then
    end
        DisplayMessageBox("No job loaded")
    local p1 =  Polar2D(pt1,  18.0,  OutRadius)
        return false;
    local p2 =  Polar2D(pt1,  54.0,  InRadius)
    end
    local p3 =  Polar2D(pt1,  90.0,  OutRadius)
    local TextMessage = "A B C D E F G H I J K L M N O P Q R S T U V W X Y Z 1 2 3 4 5
    local p4 =  Polar2D(pt1,  126.0, InRadius)
    local p5 =  Polar2D(pt1,  162.0, OutRadius)
    local p6 =  Polar2D(pt1,  198.0, InRadius)
    local p7 =  Polar2D(pt1,  234.0, OutRadius)
    local p8 =  Polar2D(pt1,  270.0, InRadius)
    local p9 =  Polar2D(pt1,  306.0, OutRadius)
    local p0 =  Polar2D(pt1,  342.0, InRadius)
    local line = Contour(0.0)
    -- local layers = job.LayerManager:GetLayerWithName(layer)
    line:AppendPoint(p1);
    line:LineTo(p2);  line:LineTo(p3)
    line:LineTo(p4);  line:LineTo(p5)
    line:LineTo(p6);  line:LineTo(p7)
    line:LineTo(p8);  line:LineTo(p9)
    line:LineTo(p0);  line:LineTo(p1)
    layer:AddObject(CreateCadContour(line), true)
    job:Refresh2DView()
    return true
end -- function end</nowiki>
 
----
 
===DrawTriangle===
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
Draws a Triangle from points provided.
 
<nowiki>function DrawTriangle(p1, p2, p3, Layer)
  --<nowiki>[[Draw Triangle
    function main(script_path)
      local MyPt1 = Point2D(3.5,3.8)
      local MyPt2 = Point2D(3.5,6.8)
      local MyPt3 = Point2D(9.8,6.8)
      local layer = "My Triangle"
      DrawTriangle(MyPt1 , MyPt2, MyPt3, Layer)
      return true
    end -- function end
    local job = VectricJob()
    if not job.Exists then
      DisplayMessageBox("Error: No job loaded")
      return false
    end
    local line = Contour(0.0)
    local layer = job.LayerManager:GetLayerWithName(Layer)
    line:AppendPoint(p1)
    line:LineTo(p2)
    line:LineTo(p3)
    line:LineTo(p1)
    layer:AddObject(CreateCadContour(line), true)
    job:Refresh2DView()
    return true
  end -- function end
  -- =====================================================]]
  function Radius2Bulge


    if letter == 91 then
  <nowiki> function Write_CSV(xFilename) -- Writes the values to a csv format file
      line:AppendPoint(pC0) ; line:LineTo(pB0) ;  line:LineTo(pB8) ;  line:LineTo(pC8) ;  group:AddTail(line) ;
  -- Usage: Write_CSV("C:\\Path\\MyName.csv")
    end
  -- Door.CSVPath = dialog:GetTextField("DoorCSVPath")
    if letter == 92 then
  -- local filename = Path .. "\\" .. Name .. ".csv"
      line:AppendPoint(pA4) ; line:LineTo(pG4) ;  group:AddTail(line) ;
  local filename = xFilename
    end
  local file = io.open(filename, "w")
    if letter == 93 then
  if file then  -- if the file was opened
      line:AppendPoint(pE0) ; line:LineTo(pF0) ;  line:LineTo(pF8) ;  line:LineTo(pE8) ;  group:AddTail(line) ;
     file:write("Count,Height,Width\n"-- Header Line
    end
     if Door.Unit then
    if letter == 94 then
       file:write("1,110,595\n");   file:write("1,150,75\n");     file:write("1,175,395\n");    file:write("1,140,495\n")
      line:AppendPoint(pD8) ;  line:LineTo(pG6) ;  line:LineTo(pG5) ;  line:LineTo(pD7) ;  line:LineTo(pA5) ;  line:LineTo(pA6) ;
       file:write("1,175,445\n");   file:write("1,175,595\n");   file:write("2,200,100\n");    file:write("3,250,125\n")
      line:LineTo(pD8) ; group:AddTail(line) ;
       file:write("1,300,150\n");   file:write("2,350,175\n");   file:write("3,400,200\n");    file:write("1,450,225\n")
    end
       file:write("2,500,250\n");   file:write("3,550,275\n");   file:write("1,600,300\n");     file:write("2,650,325\n")
    if letter == 95 then
       file:write("3,700,350\n");   file:write("1,750,375\n");   file:write("2,800,400\n");    file:write("3,850,425\n");
      line:AppendPoint(pA0) ;  line:LineTo(pF0) ;  group:AddTail(line) ;
       file:write("1,900,450\n");   file:write("2,950,475\n");   file:write("3,1000,500\n");   file:write("1,1050,525\n");
    end
       file:write("2,1100,550\n");   file:write("3,1150,575\n");   file:write("1,1200,600\n");   file:write("2,1250,625\n");
    if letter == 96 then
       file:write("3,1300,650\n");   file:write("1,1350,675\n");   file:write("2,1400,700\n");   file:write("3,1450,725\n");
      line:AppendPoint(pA4) ;  line:LineTo(pG4) ; group:AddTail(line) ;
       file:write("1,1500,750\n");   file:write("2,1550,775\n");   file:write("3,1600,800\n");   file:write("1,1650,825\n");
    end
       file:write("2,1700,850\n");   file:write("3,1750,875\n");   file:write("1,1800,900\n");   file:write("2,1850,925\n");
    -- Start of Lower Case
       file:write("3,1900,950\n");   file:write("1,1950,975\n");   file:write("2,2000,1000\n");   file:write("3,2050,1025\n");
     if letter == 97 then
       file:write("1,2100,1050\n");  file:write("2,2150,1075\n");  file:write("3,2200,1100\n");   file:write("1,2250,1125\n");
      line:AppendPoint(pA0) ; line:LineTo(pD8) ;  line:LineTo(pG0) ;  line:LineTo(pF3) ;  line:LineTo(pB3) ;
       file:write("2,2300,1150\n");  file:write("3,2350,1175\n");  file:write("1,2400,1200\n");   file:write("2,2450,1225\n")
      line:LineTo(pA0) ;  group:AddTail(line) ;
     else
    end
       file:write("1,04.5000,23.2500\n");  file:write("1,06.0000,03.3125\n");  file:write("1,06.5000,15.5000\n");  file:write("1,05.3750,19.5000\n");
     if letter == 98 then
       file:write("1,07.1875,17.5000\n");  file:write("1,06.1875,23.5000\n");  file:write("2,07.8750,03.8750\n");  file:write("3,09.8750,05.0000\n");
       line:AppendPoint(pA4) ; line:LineTo(pF4) ; line:LineTo(pG5) ; line:LineTo(pG7) ;  line:LineTo(pF8) ;  line:LineTo(pA8) ;
       file:write("1,11.7500,05.8750\n");  file:write("2,13.7500,06.6750\n");  file:write("3,15.7500,07.8750\n");  file:write("1,17.1250,08.8250\n");
      line:LineTo(pA0) ;  line:LineTo(pF0) ;  line:LineTo(pG1) ;  line:LineTo(pG3) ;  line:LineTo(pF4) ;  group:AddTail(line) ;
       file:write("2,19.5000,09.5000\n");  file:write("3,21.1250,10.3750\n");  file:write("1,23.6250,11.1250\n");  file:write("2,25.5000,12.1250\n");
     end
       file:write("3,27.6250,13.7500\n");  file:write("1,29.5000,14.7500\n");  file:write("2,31.4375,15.7500\n");  file:write("3,33.4375,16.7500\n");
    if letter == 99 then
       file:write("1,35.4375,17.7500\n");  file:write("2,37.4375,18.6250\n");  file:write("3,39.3750,19.6250\n");  file:write("1,41.3750,20.6250\n");
      line:AppendPoint(pG2) ;  line:LineTo(pF0) ;  line:LineTo(pB0) ;  line:LineTo(pA2) ;  line:LineTo(pA6) ;  line:LineTo(pB8) ;
       file:write("2,43.3750,21.6250\n");  file:write("3,45.1875,22.6250\n");  file:write("1,47.2500,23.6250\n");  file:write("2,49.1875,24.6250\n");
       line:LineTo(pF8) ; line:LineTo(pG6) ; group:AddTail(line) ;
       file:write("3,51.1250,25.5000\n");  file:write("1,53.1250,26.5000\n");  file:write("2,55.1250,27.5000\n");  file:write("3,57.1250,28.5000\n");
    end
       file:write("1,59.1250,29.5000\n");  file:write("2,61.2500,30.5000\n");  file:write("3,62.9375,31.4375\n");  file:write("1,64.9375,32.4375\n");
    if letter == 100 then
       file:write("2,66.9375,33.4375\n");  file:write("3,68.8125,34.4375\n");  file:write("1,70.8750,35.3750\n");  file:write("2,72.9375,36.4375\n");
      line:AppendPoint(pA0) ;  line:LineTo(pF0) ;  line:LineTo(pG2) ; line:LineTo(pG6) ;  line:LineTo(pF8) ;  line:LineTo(pA8) ;
       file:write("3,74.8750,37.4375\n");  file:write("1,76.9375,38.3750\n");  file:write("2,78.7500,39.3750\n");  file:write("3,80.7500,40.3750\n");
      line:LineTo(pA0) ;  group:AddTail(line) ;
       file:write("1,82.6250,41.3750\n");  file:write("2,84.6250,42.3750\n");  file:write("3,86.6250,43.3750\n");  file:write("1,88.5000,44.2500\n");
    end
       file:write("2,90.6250,45.2500\n");  file:write("3,92.6250,46.2500\n");  file:write("1,94.4375,47.2500\n");  file:write("2,95.4375,48.2500\n")
     if letter == 101 then
     end -- if end
      line:AppendPoint(pG0) ;  line:LineTo(pA0) ;  line:LineTo(pA8) ;  line:LineTo(pF8) ;  group:AddTail(line) ;  line = Contour(0.0) ;
     file:close() -- closes the open file
       line:AppendPoint(pA4) ; line:LineTo(pD4) ; group:AddTail(line) ;
  end -- if end
     end
  return true
    if letter == 102 then
end -- function end </nowiki>
      line:AppendPoint(pA0) ;  line:LineTo(pA8) ;  line:LineTo(pG8) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pA4) ;
 
       line:LineTo(pF4) ; group:AddTail(line) ;
----
    end
 
    if letter == 103 then
==Text File Tools==
      line:AppendPoint(pG6) ; line:LineTo(pG7) ;  line:LineTo(pF8) ;  line:LineTo(pB8) ;  line:LineTo(pA6) ;  line:LineTo(pA2) ;
[[File:Back.jpg|right|50px|link=Vectric Lua Interface for Gadgets]]
       line:LineTo(pB0) ;  line:LineTo(pF0) ;  line:LineTo(pG2) ; line:LineTo(pG3) ; line:LineTo(pE3) ; line:LineTo(pE2) ;  group:AddTail(line) ;
This object is a name-value pair that represents a Document Variable within a [[VectricJob]].
     end
    if letter == 104 then
      line:AppendPoint(pA0) ;  line:LineTo(pA8) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pG0) ;  line:LineTo(pG8) ;
       group:AddTail(line) ; line = Contour(0.0) ;  line:AppendPoint(pA4) ; line:LineTo(pG4) ; group:AddTail(line) ;
    end
    if letter == 105 then
       line:AppendPoint(pB0) ; line:LineTo(pB8) ; group:AddTail(line) ; line = Contour(0.0) ;  line:AppendPoint(pA0) ;  line:LineTo(pC0) ;
       group:AddTail(line) ; line = Contour(0.0) ;  line:AppendPoint(pA8) ; line:LineTo(pC8) ; group:AddTail(line) ;  pH0 = pE0 ;
    end
    if letter == 106 then
       line:AppendPoint(pA2) ; line:LineTo(pB0) ; line:LineTo(pF0) ;  line:LineTo(pG2) ;  line:LineTo(pG8) ; line:LineTo(pC8) ;
       group:AddTail(line) ;
    end
    if letter == 107 then
      line:AppendPoint(pA0) ; line:LineTo(pA8) ; group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pA2) ;  line:LineTo(pG7) ;
       group:AddTail(line) ; line = Contour(0.0) ;  line:AppendPoint(pD4) ; line:LineTo(pG0) ; group:AddTail(line) ;
    end
    if letter == 108 then
       line:AppendPoint(pA8) ;  line:LineTo(pA0) ;  line:LineTo(pG0) ; group:AddTail(line) ;
    end
    if letter == 109 then
       line:AppendPoint(pA0) ;  line:LineTo(pA8) ;  line:LineTo(pD4) ; line:LineTo(pG8) ;  line:LineTo(pG0) ;  group:AddTail(line) ;
     end
    if letter == 110 then
       line:AppendPoint(pA0) ;  line:LineTo(pA8) ;  line:LineTo(pF0) ;  line:LineTo(pF8) ;  group:AddTail(line) ;  pH0 = pG0 ;
    end
    if letter == 111 then
       line:AppendPoint(pB0) ;  line:LineTo(pA2) ;  line:LineTo(pA6) ;  line:LineTo(pB8) ;  line:LineTo(pF8) ;  line:LineTo(pG6) ;
       line:LineTo(pG2) ;  line:LineTo(pF0) ;  line:LineTo(pB0) ;  group:AddTail(line) ;
    end
    if letter == 112 then
       line:AppendPoint(pA0) ;  line:LineTo(pA8) ;  line:LineTo(pF8) ;  line:LineTo(pG7) ;  line:LineTo(pG5) ;  line:LineTo(pF4) ;
       line:LineTo(pA4) ;  group:AddTail(line) ;
    end
    if letter == 113 then
      line:AppendPoint(pB0) ;  line:LineTo(pA2) ;  line:LineTo(pA6) ;  line:LineTo(pB8) ;  line:LineTo(pF8) ;  line:LineTo(pG6) ;
       line:LineTo(pG2) ;  line:LineTo(pF0) ;  line:LineTo(pB0) ;  group:AddTail(line) ;  line = Contour(0.0) ; line:AppendPoint(pG0) ;  line:LineTo(pD4) ; group:AddTail(line)
    end
    if letter == 114 then
       line:AppendPoint(pA0) ;  line:LineTo(pA8) ;  line:LineTo(pF8) ;  line:LineTo(pG7) ;  line:LineTo(pG5) ;  line:LineTo(pF4) ;
       line:LineTo(pA4) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pD4) ;  line:LineTo(pG0) ; group:AddTail(line) ;
    end
    if letter == 115 then
       line:AppendPoint(pG5) ;  line:LineTo(pG6) ;  line:LineTo(pF8) ;  line:LineTo(pB8) ;  line:LineTo(pA6) ;  line:LineTo(pA5) ;
       line:LineTo(pG3) ;  line:LineTo(pG2) ;  line:LineTo(pF0) ;  line:LineTo(pB0) ;  line:LineTo(pA2) ;  line:LineTo(pA3) ;  group:AddTail(line) ;
    end
    if letter == 116 then
       line:AppendPoint(pA8) ;  line:LineTo(pG8) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pD8) ;
       line:LineTo(pD0) ;  group:AddTail(line) ;
    end
    if letter == 117 then
      line:AppendPoint(pA8) ;  line:LineTo(pA2) ;  line:LineTo(pB0) ;  line:LineTo(pF0) ;  line:LineTo(pG2) ;  line:LineTo(pG8) ;
       group:AddTail(line) ;
    end
    if letter == 118 then
      line:AppendPoint(pA8) ;  line:LineTo(pD0) ;  line:LineTo(pG8) ;  group:AddTail(line) ;
     end
    if letter == 119 then
      line:AppendPoint(pA8) ;  line:LineTo(pB0) ;  line:LineTo(pD4) ;  line:LineTo(pF0) ;  line:LineTo(pG8) ;  group:AddTail(line) ;
    end
     if letter == 120 then
      line:AppendPoint(pA0) ;  line:LineTo(pG8) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pA8) ;
      line:LineTo(pG0) ;  group:AddTail(line) ;
    end
    if letter == 121 then
      line:AppendPoint(pA8) ;  line:LineTo(pD4) ;  line:LineTo(pG8) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pD0) ;
      line:LineTo(pD4) ;  group:AddTail(line) ;
    end
    if letter == 122 then
      line:AppendPoint(pA8) ; line:LineTo(pG8) ;  line:LineTo(pA0) ;  line:LineTo(pG0) ;  group:AddTail(line) ;
    end
    -- End of Lower Case
    if letter == 123 then
      line:AppendPoint(pD0) ;  line:LineTo(pC0) ;  line:LineTo(pB1) ;  line:LineTo(pB2) ;  line:LineTo(pC3) ;  line:LineTo(pA4) ;
      line:LineTo(pC5) ;  line:LineTo(pB6) ;  line:LineTo(pB7) ;  line:LineTo(pC8) ;  line:LineTo(pD8) ;  group:AddTail(line) ;
    end
    if letter == 124 then
      line:AppendPoint(pA0) ;  line:LineTo(pA10) ;  line:LineTo(pC10) ;  line:LineTo(pC0) ;  line:LineTo(pA0) ;  group:AddTail(line) ;
    end
    if letter == 125 then
      line:AppendPoint(pD0) ;  line:LineTo(pE0) ;  line:LineTo(pF1) ;  line:LineTo(pF2) ;  line:LineTo(pE3) ;  line:LineTo(pG4) ;
      line:LineTo(pE5) ;  line:LineTo(pF6) ;  line:LineTo(pF7) ;  line:LineTo(pE8) ;  line:LineTo(pD8) ;  group:AddTail(line) ;
    end
    if letter == 126 then
      line:AppendPoint(pA2) ;  line:LineTo(pA3) ;  line:LineTo(pB5) ;  line:LineTo(pF3) ;  line:LineTo(pG5) ;
      line:LineTo(pG4) ;  line:LineTo(pF2) ;  line:LineTo(pB4) ;  line:LineTo(pA2) ;  group:AddTail(line) ;
    end
    return pH0
  end -- function end


  -- ==============================================================================
===LengthOfFile===
  local function AddGroupToJob(job, group, layer_name)
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
    --  create a CadObject to represent the  group
Returns file line count
    local cad_object = CreateCadGroup(group);
    -- create a layer with passed name if it doesnt already exist
    local layer = job.LayerManager:GetLayerWithName(layer_name)
    -- and add our object to it
    layer:AddObject(cad_object, true)
    return cad_object
  end -- end function


  -- =========================================================================
<nowiki> function LengthOfFile(filename)
     local job = VectricJob()
    Returns: number]]
    if not job.Exists then
    local len = 0
       DisplayMessageBox("Error: Not finding a job loaded")
     if FileExists(filename) then
      return false
      local file = io.open(filename)
      if file then
       for _ in file:lines() do
        len = len + 1
      end
      file:close()
    end -- if end
     end
     end
     local strlen = string.len(what)
     return len
    local strup = string.upper(what)
end -- function end </nowiki>
    local x = strlen
----
    local i = 1
    local y = ""
    local ptx = where
    group = ContourGroup(true)
    while i <=  x do
      y = string.byte(string.sub(strup, i, i))
      ptx = MonoFont(job, ptx, y, size, lay, ang)
      i = i + 1
    end -- while end;
    AddGroupToJob(job, group, lay)
    job:Refresh2DView()
    return true ;
  end -- Draw Text function end


  -- =====================================================]]
===NameValidater - Checks File Name for Valid Chars===
  function DrawWriter(what, where, size, lay, ang)
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
    local group
Returns file line count
  --[[ How to use:
 
  |    local TextMessage = "Your Text Here"
<nowiki> function NameValidater(FileName)
  |    local TextPt = Point2D(3.5,3.8)
    local MyTrue = true
  |    local TextHight = 0.5
    local strlen = string.len(FileName)
  |    local TextLayer = "Jim Anderson"
    local strup = string.upper(FileName)
  |    local TextAng = 20.0
    local i = 1
  |    DrawWriter(TextMessage ,local TextPt , TextHight , TextLayer,TextAng )
    local y = ""
  |    -- ==Draw Writer==
    while i <= strlen do
  |    -- Utilizing a provided string of text, the program walks the string and reproduces each letter (parametrically) on the drawing using vectors.
      y = string.byte(string.sub(strup, i, i))
  function main()
      if y == 32 then  --  Space
       -- create a layer with passed name if it doesn't already exist
        MyTrue = false
    local job = VectricJob()
        break
    if not job.Exists then
      elseif y == 45 then  -- Dash
        DisplayMessageBox("No job loaded")
        MyTrue = false
        return false;
        break
    end
      elseif y == 127 then  -- Delete
    local TextMessage = "Aa Bb Cc Dd Ee Ff Gg Hh Ii Jj Kk Ll Mm Nn Oo Pp Qq Rr Ss Tt Uu Vv Ww Xx Yy Zz 1 2 3 4 5 6 7 8 9 0 ! @ # $ % & * ( ) { } [ ] ? , . : ; '' ' _ - + = ~ ^ < > |"
        MyTrue = false
    local TextPt = Point2D(0.1, 2.0)
        break
    local TextHight = 0.25
      elseif y == 126 then  -- Delete
    local TextLayer = "Gadget Text"
        MyTrue = false
    local TextAng = 10.0
        break
    DrawWriter(TextMessage, TextPt, TextHight, TextLayer, TextAng)
 
    job:Refresh2DView()
      elseif y == 123 then  -- Open brace
    return true
        MyTrue = false
  end
        break
  -- -----------------------------------------------------]]
      elseif y == 124 then  -- Pipe
  -- ==============================================================================
        MyTrue = false
  local function Polar2D(pt, ang, dis)
        break
    return Point2D((pt.X + dis * math.cos(math.rad(ang))), (pt.Y + dis * math.sin(math.rad(ang))))
      elseif y == 125 then  -- Close brace
  end
        MyTrue = false
  -- ==============================================================================
        break
  local function MonoFont(job, pt, letter, scl, lay, ang)
 
    scl = (scl * 0.5) ;
      elseif  -- Illegal Filename Characters
    local pA0 = pt ;
      (y == 33) or -- ! Exclamation mark
    local pA1 = Polar2D(pt, ang + 90.0000, (0.2500 * scl)) ;  local pA2 = Polar2D(pt, ang + 90.0000, (0.5000 * scl)) ;
      (y == 34) or -- " Double Quotes
    local pA3 = Polar2D(pt, ang + 90.0000, (0.7500 * scl)) ;  local pA4 = Polar2D(pt, ang + 90.0000, (1.0000 * scl)) ;
      (y == 35) or -- # Hash
    local pA5 = Polar2D(pt, ang + 90.0000, (1.2500 * scl)) ;  local pA6 = Polar2D(pt, ang + 90.0000, (1.5000 * scl)) ;
      (y == 36) or -- $ Dollar
    local pA7 = Polar2D(pt, ang + 90.0000, (1.7500 * scl)) ;  local pA8 = Polar2D(pt, ang + 90.0000, (2.0000 * scl)) ;
      (y == 37) or -- % Percent
    local pA9 = Polar2D(pt, ang + 90.0000, (2.2500 * scl)) ;  local pA10 = Polar2D(pt, ang + 90.0000, (2.5000 * scl)) ;
      (y == 38) or -- & Ampersand
    local pB0 = Polar2D(pt, ang +  0.0000, (0.2500 * scl)) ;  local pB1 = Polar2D(pt, ang + 45.0000, (0.3536 * scl)) ;
      (y == 39) or -- ' Apostrophe
    local pB2 = Polar2D(pt, ang + 63.4352, (0.5590 * scl)) ;  local pB3 = Polar2D(pt, ang + 71.5651, (0.7906 * scl)) ;
      (y == 42) or -- * Asterisk
    local pB4 = Polar2D(pt, ang + 75.9638, (1.0308 * scl)) ;  local pB5 = Polar2D(pt, ang + 78.6901, (1.2748 * scl)) ;
      (y == 43) or -- + Plus
    local pB6 = Polar2D(pt, ang + 80.5376, (1.5207 * scl)) ;  local pB7 = Polar2D(pt, ang + 81.8699, (1.7678 * scl)) ;
      (y == 44) or -- , Comma
    local pB8 = Polar2D(pt, ang + 82.8750, (2.0156 * scl)) ;  local pB10 = Polar2D(pt, ang + 84.2894, (2.5125 * scl)) ;
      (y == 47) or -- / Slash
    local pC0 = Polar2D(pt, ang +  0.0000, (0.5000 * scl)) ;  local pC1 = Polar2D(pt, ang + 26.5650, (0.5590 * scl)) ;
      (y == 58) or -- : Colon
    local pC2 = Polar2D(pt, ang + 45.0000, (0.7071 * scl)) ;  local pC3 = Polar2D(pt, ang + 56.3099, (0.9014 * scl)) ;
      (y == 59) or -- ; Semi-colon
    local pC4 = Polar2D(pt, ang + 63.4342, (1.1180 * scl)) ;  local pC5 = Polar2D(pt, ang + 68.1993, (1.3463 * scl)) ;
      (y == 60) or -- < Less than
    local pC6 = Polar2D(pt, ang + 71.5650, (1.5811 * scl)) ;  local pC7 = Polar2D(pt, ang + 63.4342, (1.1180 * scl)) ;
       (y == 62) or -- > Greater than
    local pC8 = Polar2D(pt, ang + 75.9640, (2.0616 * scl)) ;  local pC10 = Polar2D(pt, ang + 78.6899, (2.5495 * scl)) ;
      (y == 63) or -- ? Question mark
    local pD0 = Polar2D(pt, ang +  0.0000, (0.6250 * scl)) ;  local pD1 = Polar2D(pt, ang + 21.8014, (0.6731 * scl)) ;
      (y == 64) or -- @ At
    local pD2 = Polar2D(pt, ang + 33.6901, (0.9014 * scl)) ;  local pD4 = Polar2D(pt, ang + 57.9946, (1.1792 * scl)) ;
      (y == 92) or -- \ Backslash
    local pD7 = Polar2D(pt, ang + 70.3462, (1.8583 * scl)) ;  local pD8 = Polar2D(pt, ang + 72.6460, (2.0954 * scl)) ;
      (y == 96) or -- ` Single Quotes
    local pE0 = Polar2D(pt, ang +  0.0000, (0.7500 * scl)) ;  local pE1 = Polar2D(pt, ang + 18.4346, (0.7906 * scl)) ;
      (y == 123) or -- { Open brace
    local pE2 = Polar2D(pt, ang + 33.6901, (0.9014 * scl)) ;  local pE3 = Polar2D(pt, ang + 45.0000, (1.0607 * scl)) ;
      (y == 124) or -- | Pipe
    local pE5 = Polar2D(pt, ang + 59.0371, (1.4578 * scl)) ;  local pE6 = Polar2D(pt, ang + 63.4349, (1.6771 * scl)) ;
      (y == 125)   -- } Close brace
    local pE7 = Polar2D(pt, ang + 66.4349, (1.9039 * scl)) ;  local pE8 = Polar2D(pt, ang + 69.4440, (2.1360 * scl)) ;
      then
    local pF0 = Polar2D(pt, ang +  0.0000, (1.0000 * scl)) ;  local pF1 = Polar2D(pt, ang + 14.0360, (1.0308 * scl)) ;
        MyTrue = false
    local pF2 = Polar2D(pt, ang + 26.5651, (1.1180 * scl)) ;  local pF3 = Polar2D(pt, ang + 36.8699, (1.2500 * scl)) ;
        break
    local pF4 = Polar2D(pt, ang + 45.0000, (1.4142 * scl)) ;  local pF5 = Polar2D(pt, ang + 51.3425, (1.6006 * scl)) ;
      elseif (y <= 31) then -- Control Codes
    local pF6 = Polar2D(pt, ang + 56.3099, (1.8025 * scl)) ;  local pF7 = Polar2D(pt, ang + 60.2551, (2.0156 * scl)) ;
        MyTrue = false
    local pF8 = Polar2D(pt, ang + 63.4349, (2.2361 * scl)) ;  local pG0 = Polar2D(pt, ang +  0.0000, (1.2500 * scl)) ;
        break
    local pG1 = Polar2D(pt, ang + 11.3099, (1.2748 * scl)) ;  local pG2 = Polar2D(pt, ang + 21.8014, (1.3463 * scl)) ;
      elseif (y >= 48) and (y <= 57) then -- Numbers
    local pG3 = Polar2D(pt, ang + 30.9638, (1.4577 * scl)) ;  local pG4 = Polar2D(pt, ang + 38.6598, (1.6008 * scl)) ;
        MyTrue = false
    local pG5 = Polar2D(pt, ang + 45.0000, (1.7678 * scl)) ;  local pG6 = Polar2D(pt, ang + 50.1944, (1.9526 * scl)) ;
        break
    local pG7 = Polar2D(pt, ang + 54.4623, (2.1506 * scl)) ;  local pG8 = Polar2D(pt, ang + 57.9946, (2.3585 * scl)) ;
      elseif (y >= 65) and (y <= 90) then -- Uppercase A to Z
    local pG10 = Polar2D(pt,59.0362, (2.9155 * scl))      ;  local pH0 = Polar2D(pt, ang +  0.0000, (1.5000 * scl)) ;
        MyTrue = false
    local pH10 = Polar2D(pt,63.4349, (2.7951 * scl))      ;  local layer = job.LayerManager:GetLayerWithName(lay) ;
        break
    local line = Contour(0.0) ;
      elseif (y >= 97) and (y <= 122) then -- Lowercase A to Z
  -- ------------------------------------------------------------------
        MyTrue = false
    if letter == 32 then
        break
      pH0 = pH0
      elseif (y >= 65) and (y <= 90) then -- Uppercase A to Z
    end
        MyTrue = false
    if letter == 33 then
        break
      line:AppendPoint(pB0) ;  line:LineTo(pE0) ;  line:LineTo(pE2) ;  line:LineTo(pB2) ;  line:LineTo(pB0) ;  group:AddTail(line) ;
      end -- if end
      line = Contour(0.0) line:AppendPoint(pB3) ;  line:LineTo(pE3) ;  line:LineTo(pE8) ;  line:LineTo(pB8) ;  line:LineTo(pB3) ;  group:AddTail(line) ;
      i = i + 1  end -- while end;
    end
    return MyTrue
    if letter == 34 then
end -- function end </nowiki>
      line:AppendPoint(pA7) ;  line:LineTo(pB10) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pB7) ;  line:LineTo(pC10) ;
----
      group:AddTail(line) ;  pH0 = pE0
 
    end
===CopyFileFromTo===
    if letter == 35 then
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
      line:AppendPoint(pA2) ;  line:LineTo(pG2) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pA6) ;
Copy Old File to Newfile
      line:LineTo(pG6) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pB0) ;  line:LineTo(pB8) ;  group:AddTail(line) ;
      line = Contour(0.0) ;  line:AppendPoint(pF0) ;  line:LineTo(pF8) ;  group:AddTail(line) ;
    end
    if letter == 36 then
      line:AppendPoint(pA1) ;  line:LineTo(pB0) ;  line:LineTo(pF0) ;  line:LineTo(pG1) ;  line:LineTo(pG3) ;  line:LineTo(pF4) ;
      line:LineTo(pB4) ;  line:LineTo(pA5) ;  line:LineTo(pA7) ;  line:LineTo(pB8) ;  line:LineTo(pF8) ;  line:LineTo(pG7) ;  group:AddTail(line) ;
      line = Contour(0.0) ;  line:AppendPoint(pC0) ;  line:LineTo(pE0) ;  line:LineTo(pE8) ;  line:LineTo(pC8) ;  line:LineTo(pC0) ;  group:AddTail(line) ;
    end
    if letter == 37 then
      line:AppendPoint(pC6) ;  line:LineTo(pC8) ;  line:LineTo(pA8) ;  line:LineTo(pA6) ;  line:LineTo(pE6) ;  line:LineTo(pG8) ;
      line:LineTo(pA0) ;  line:LineTo(pC2) ;  line:LineTo(pG2) ;  line:LineTo(pG0) ;  line:LineTo(pE0) ;  line:LineTo(pE2) ;  group:AddTail(line) ;
    end
    if letter == 38 then
      line:AppendPoint(pG2) ;  line:LineTo(pG1) ;  line:LineTo(pF0) ;  line:LineTo(pB0) ;  line:LineTo(pA1) ;  line:LineTo(pA3) ;
      line:LineTo(pE6) ;  line:LineTo(pE7) ;  line:LineTo(pD8) ;  line:LineTo(pB8) ;  line:LineTo(pA7) ;  line:LineTo(pA6) ;  line:LineTo(pG0) ;
      group:AddTail(line) ;
    end
    if letter == 39 then
      line:AppendPoint(pA7) ;  line:LineTo(pB10) ;  group:AddTail(line) ;  pH0 = pC0
    end
    if letter == 40 then
      line:AppendPoint(pB8) ;  line:LineTo(pA5) ;  line:LineTo(pA3) ;  line:LineTo(pB0) ;  group:AddTail(line) ;  pH0 = pD0
    end
    if letter == 41 then
      line:AppendPoint(pA8) ;  line:LineTo(pB5) ;  line:LineTo(pB3) ;  line:LineTo(pA0) ;  group:AddTail(line) ;  pH0 = pG0
    end
    if letter == 42 then
      line:AppendPoint(pA2) ;  line:LineTo(pG6) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pA6) ;  line:LineTo(pG2) ;
      group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pA4) ;  line:LineTo(pG4) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pD7) ;
      line:LineTo(pD1) ;  group:AddTail(line) ;
    end
    if letter == 43 then
      line:AppendPoint(pA4) ;  line:LineTo(pG4) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pD1) ;  line:LineTo(pD7) ;
      group:AddTail(line)
    end
    if letter == 44 then
      line:AppendPoint(pC0) ;  line:LineTo(pE2) ;  line:LineTo(pC2) ;  line:LineTo(pC4) ;  line:LineTo(pF4) ;  line:LineTo(pF2) ;
      line:LineTo(pD0) ;  line:LineTo(pC0) ;  group:AddTail(line) ;
    end
    if letter == 45 then
      line:AppendPoint(pA4) ;  line:LineTo(pG4) ;  group:AddTail(line) ;
    end
    if letter == 46 then
      line:AppendPoint(pA1) ;  line:LineTo(pB1) ;  line:LineTo(pB0) ;  line:LineTo(pA0) ;  line:LineTo(pA1) ;  group:AddTail(line) ;  pH0 = pD0 ;
    end
    if letter == 47 then
      line:AppendPoint(pA0) ;  line:LineTo(pF8) ;  group:AddTail(line) ;  pH0 = pG0 ;
    end
    if letter == 48 then
      line:AppendPoint(pB0) ;  line:LineTo(pA2) ;  line:LineTo(pA6) ;  line:LineTo(pB8) ;  line:LineTo(pF8) ;  line:LineTo(pG6) ;
      line:LineTo(pG2) ;  line:LineTo(pF0) ;  line:LineTo(pB0) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pG8) ;  line:LineTo(pA0) ; group:AddTail(line) ;
    end
    if letter == 49 then
      line:AppendPoint(pA6) ;  line:LineTo(pD8) ;  line:LineTo(pD0) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pA0) ;
      line:LineTo(pG0) ;  group:AddTail(line) ;
    end
    if letter == 50 then
      line:AppendPoint(pA6) ;  line:LineTo(pA7) ;  line:LineTo(pB8) ;  line:LineTo(pF8) ;  line:LineTo(pG7) ;  line:LineTo(pG5) ;
      line:LineTo(pA2) ;  line:LineTo(pA0) ;  line:LineTo(pG0) ;  group:AddTail(line) ;
    end
    if letter == 51 then
      line:AppendPoint(pA7) ;  line:LineTo(pB8) ;  line:LineTo(pF8) ;  line:LineTo(pG7) ;  line:LineTo(pG5) ;  line:LineTo(pF4) ;
      line:LineTo(pG3) ;  line:LineTo(pG1) ;  line:LineTo(pF0) ;  line:LineTo(pB0) ;  line:LineTo(pA1) ;  group:AddTail(line) ;  line = Contour(0.0) ;
      line:AppendPoint(pF4) ;  line:LineTo(pB4) ;  group:AddTail(line) ;
    end
    if letter == 52 then
      line:AppendPoint(pF0) ;  line:LineTo(pF8) ;  line:LineTo(pA2) ;  line:LineTo(pG2) ;  group:AddTail(line) ;
    end
    if letter == 53 then
      line:AppendPoint(pG8) ;  line:LineTo(pA8) ;  line:LineTo(pA5) ;  line:LineTo(pF4) ;  line:LineTo(pG3) ;  line:LineTo(pG1) ;
      line:LineTo(pF0) ;  line:LineTo(pB0) ;  line:LineTo(pA1) ;  line:LineTo(pA2) ;  group:AddTail(line) ;
    end
    if letter == 54 then
      line:AppendPoint(pG7) ;  line:LineTo(pF8) ;  line:LineTo(pB8) ;  line:LineTo(pA7) ;  line:LineTo(pA1) ;  line:LineTo(pB0) ;
      line:LineTo(pF0) ;  line:LineTo(pG1) ;  line:LineTo(pG3) ;  line:LineTo(pF4) ;  line:LineTo(pB4) ;  line:LineTo(pA2) ;  group:AddTail(line) ;
    end
    if letter == 55 then
      line:AppendPoint(pB0) ;  line:LineTo(pG8) ;  line:LineTo(pA8) ;  group:AddTail(line) ;
    end
    if letter == 56 then
      line:AppendPoint(pA1) ;  line:LineTo(pB0) ;  line:LineTo(pF0) ;  line:LineTo(pG1) ;  line:LineTo(pG3) ;  line:LineTo(pF4) ;
      line:LineTo(pG5) ;  line:LineTo(pG7) ;  line:LineTo(pF8) ;  line:LineTo(pB8) ;  line:LineTo(pA7) ;  line:LineTo(pA5) ;  line:LineTo(pB4) ;
      line:LineTo(pA3) ;  line:LineTo(pA1) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pB4) ;  line:LineTo(pF4) ;  group:AddTail(line) ;
    end
    if letter == 57 then
      line:AppendPoint(pA1) ;  line:LineTo(pB0) ;  line:LineTo(pF0) ;  line:LineTo(pG3) ;  line:LineTo(pG7) ;  line:LineTo(pF8) ;
      line:LineTo(pB8) ;  line:LineTo(pA7) ;  line:LineTo(pA5) ;  line:LineTo(pB4) ;  line:LineTo(pF4) ;  line:LineTo(pG5) ;  group:AddTail(line) ;
    end
    if letter == 58 then
      line:AppendPoint(pB8) ;  line:LineTo(pA8) ;  line:LineTo(pA7) ;  line:LineTo(pB7) ;  line:LineTo(pB8) ;  line:LineTo(pA8) ;
      group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pA1) ;  line:LineTo(pB1) ;  line:LineTo(pB0) ;  line:LineTo(pA0) ;  line:LineTo(pA1) ;
      group:AddTail(line) ;  pH0 = pD0 ;
    end
    if letter == 59 then
      line:AppendPoint(pB8) ;  line:LineTo(pA8) ;  line:LineTo(pA7) ;  line:LineTo(pB7) ;  line:LineTo(pB8) ;  line:LineTo(pA8) ;
      group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pB3) ;  line:LineTo(pB4) ;  line:LineTo(pA4) ;  line:LineTo(pA3) ;  line:LineTo(pB3) ;
      line:LineTo(pA0) ;  group:AddTail(line) ;  pH0 = pD0 ;
    end
    if letter == 60 then
      line:AppendPoint(pF8) ;  line:LineTo(pA4) ;  line:LineTo(pG0) ;  group:AddTail(line)
    end
    if letter == 61 then
      line:AppendPoint(pA2) ;  line:LineTo(pG2) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pA6) ;
      line:LineTo(pG6) ;  group:AddTail(line) ;
    end
    if letter == 62 then
      line:AppendPoint(pA8) ;  line:LineTo(pF4) ;  line:LineTo(pA0) ;  group:AddTail(line) ;
    end
    if letter == 63 then
      line:AppendPoint(pB5) ;  line:LineTo(pA6) ;  line:LineTo(pA7) ;  line:LineTo(pB8) ;  line:LineTo(pE8) ;  line:LineTo(pF7) ;
      line:LineTo(pF5) ;  line:LineTo(pC3) ;  line:LineTo(pC2) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pB0) ;  line:LineTo(pE0) ;
      line:LineTo(pE1) ;  line:LineTo(pB1) ;  line:LineTo(pB0) ;  group:AddTail(line) ;
    end
    if letter == 64 then
      line:AppendPoint(pG0) ;  line:LineTo(pB0) ;  line:LineTo(pA2) ;  line:LineTo(pA6) ;  line:LineTo(pB8) ;  line:LineTo(pF8) ;
      line:LineTo(pG6) ;  line:LineTo(pG3) ;  line:LineTo(pE2) ;  line:LineTo(pB2) ;  line:LineTo(pB5) ;  line:LineTo(pE5) ;  line:LineTo(pE2) ;
      group:AddTail(line)
    end
    if letter == 65 then
      line:AppendPoint(pA0) ;  line:LineTo(pD8) ;  line:LineTo(pG0) ;  line:LineTo(pF3) ;  line:LineTo(pB3) ;
      line:LineTo(pA0) ;  group:AddTail(line) ;
    end
    if letter == 66 then
      line:AppendPoint(pA4) ;  line:LineTo(pF4) ;  line:LineTo(pG5) ;  line:LineTo(pG7) ;  line:LineTo(pF8) ;  line:LineTo(pA8) ;
      line:LineTo(pA0) ;  line:LineTo(pF0) ;  line:LineTo(pG1) ;  line:LineTo(pG3) ;  line:LineTo(pF4) ;  group:AddTail(line) ;
    end
    if letter == 67 then
      line:AppendPoint(pG2) ;  line:LineTo(pF0) ;  line:LineTo(pB0) ;  line:LineTo(pA2) ;  line:LineTo(pA6) ;  line:LineTo(pB8) ;
      line:LineTo(pF8) ;  line:LineTo(pG6) ;  group:AddTail(line) ;
    end
    if letter == 68 then
      line:AppendPoint(pA0) ;  line:LineTo(pF0) ;  line:LineTo(pG2) ;  line:LineTo(pG6) ;  line:LineTo(pF8) ;  line:LineTo(pA8) ;
      line:LineTo(pA0) ;  group:AddTail(line) ;
    end
    if letter == 69 then
      line:AppendPoint(pG0) ;  line:LineTo(pA0) ;  line:LineTo(pA8) ;  line:LineTo(pF8) ;  group:AddTail(line) ;  line = Contour(0.0) ;
      line:AppendPoint(pA4) ;  line:LineTo(pD4) ;  group:AddTail(line) ;
    end
    if letter == 70 then
      line:AppendPoint(pA0) ;  line:LineTo(pA8) ;  line:LineTo(pG8) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pA4) ;
      line:LineTo(pF4) ;  group:AddTail(line) ;
    end
    if letter == 71 then
      line:AppendPoint(pG6) ;  line:LineTo(pG7) ;  line:LineTo(pF8) ;  line:LineTo(pB8) ;  line:LineTo(pA6) ;  line:LineTo(pA2) ;
      line:LineTo(pB0) ;  line:LineTo(pF0) ;  line:LineTo(pG2) ;  line:LineTo(pG3) ;  line:LineTo(pE3) ;  line:LineTo(pE2) ;  group:AddTail(line) ;
    end
    if letter == 72 then
      line:AppendPoint(pA0) ;  line:LineTo(pA8) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pG0) ;  line:LineTo(pG8) ;
      group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pA4) ;  line:LineTo(pG4) ;  group:AddTail(line) ;
    end
    if letter == 73 then
      line:AppendPoint(pB0) ;  line:LineTo(pB8) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pA0) ;  line:LineTo(pC0) ;
      group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pA8) ;  line:LineTo(pC8) ;  group:AddTail(line) ;  pH0 = pE0 ;
    end
    if letter == 74 then
      line:AppendPoint(pA2) ;  line:LineTo(pB0) ;  line:LineTo(pF0) ;  line:LineTo(pG2) ;  line:LineTo(pG8) ;  line:LineTo(pC8) ;
      group:AddTail(line) ;
    end
    if letter == 75 then
      line:AppendPoint(pA0) ;  line:LineTo(pA8) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pA2) ;  line:LineTo(pG7) ;
      group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pD4) ;  line:LineTo(pG0) ;  group:AddTail(line) ;
    end
    if letter == 76 then
      line:AppendPoint(pA8) ;  line:LineTo(pA0) ;  line:LineTo(pG0) ;  group:AddTail(line) ;
    end
    if letter == 77 then
      line:AppendPoint(pA0) ;  line:LineTo(pA8) ;  line:LineTo(pD4) ;  line:LineTo(pG8) ;  line:LineTo(pG0) ;  group:AddTail(line) ;
    end
    if letter == 78 then
      line:AppendPoint(pA0) ;  line:LineTo(pA8) ;  line:LineTo(pF0) ;  line:LineTo(pF8) ;  group:AddTail(line) ;  pH0 = pG0 ;
    end
    if letter == 79 then
      line:AppendPoint(pB0) ;  line:LineTo(pA2) ;  line:LineTo(pA6) ;  line:LineTo(pB8) ;  line:LineTo(pF8) ;  line:LineTo(pG6) ;
      line:LineTo(pG2) ;  line:LineTo(pF0) ;  line:LineTo(pB0) ;  group:AddTail(line) ;
    end
    if letter == 80 then
      line:AppendPoint(pA0) ;  line:LineTo(pA8) ;  line:LineTo(pF8) ;  line:LineTo(pG7) ;  line:LineTo(pG5) ;  line:LineTo(pF4) ;
      line:LineTo(pA4) ;  group:AddTail(line) ;
    end
    if letter == 81 then
      line:AppendPoint(pB0) ;  line:LineTo(pA2) ;  line:LineTo(pA6) ;  line:LineTo(pB8) ;  line:LineTo(pF8) ;  line:LineTo(pG6) ;
      line:LineTo(pG2) ;  line:LineTo(pF0) ;  line:LineTo(pB0) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pG0) ;  line:LineTo(pD4) ; group:AddTail(line)
    end
    if letter == 82 then
      line:AppendPoint(pA0) ;  line:LineTo(pA8) ;  line:LineTo(pF8) ;  line:LineTo(pG7) ;  line:LineTo(pG5) ;  line:LineTo(pF4) ;
      line:LineTo(pA4) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pD4) ;  line:LineTo(pG0) ;  group:AddTail(line) ;
    end
    if letter == 83 then
      line:AppendPoint(pG5) ;  line:LineTo(pG6) ;  line:LineTo(pF8) ;  line:LineTo(pB8) ;  line:LineTo(pA6) ;  line:LineTo(pA5) ;
      line:LineTo(pG3) ;  line:LineTo(pG2) ;  line:LineTo(pF0) ;  line:LineTo(pB0) ;  line:LineTo(pA2) ;  line:LineTo(pA3) ;  group:AddTail(line) ;
    end
    if letter == 84 then
      line:AppendPoint(pA8) ;  line:LineTo(pG8) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pD8) ;
      line:LineTo(pD0) ;  group:AddTail(line) ;
    end
    if letter == 85 then
      line:AppendPoint(pA8) ;  line:LineTo(pA2) ;  line:LineTo(pB0) ;  line:LineTo(pF0) ;  line:LineTo(pG2) ;  line:LineTo(pG8) ;
      group:AddTail(line) ;
    end
    if letter == 86 then
      line:AppendPoint(pA8) ;  line:LineTo(pD0) ;  line:LineTo(pG8) ;  group:AddTail(line) ;
    end
    if letter == 87 then
      line:AppendPoint(pA8) ;  line:LineTo(pB0) ;  line:LineTo(pD4) ;  line:LineTo(pF0) ;  line:LineTo(pG8) ;  group:AddTail(line) ;
    end
    if letter == 88 then
      line:AppendPoint(pA0) ;  line:LineTo(pG8) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pA8) ;
      line:LineTo(pG0) ;  group:AddTail(line) ;
    end
    if letter == 89 then
      line:AppendPoint(pA8) ;  line:LineTo(pD4) ;  line:LineTo(pG8) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pD0) ;
      line:LineTo(pD4) ;  group:AddTail(line) ;
    end
    if letter == 90 then
      line:AppendPoint(pA8) ;  line:LineTo(pG8) ;  line:LineTo(pA0) ;  line:LineTo(pG0) ;  group:AddTail(line) ;
    end


    if letter == 91 then
  <nowiki> function CopyFileFromTo(OldFile, NewFile)
      line:AppendPoint(pC0) ; line:LineTo(pB0) ;  line:LineTo(pB8) ;  line:LineTo(pC8) ;  group:AddTail(line) ;
     if FileExists(NewFile) then
    end
       DisplayMessageBox("File copy " .. File .. " failed. \n\nFile found at: " .. NewFile .. "\n" )
     if letter == 92 then
       return false
      line:AppendPoint(pA4) ;  line:LineTo(pG4) ;  group:AddTail(line) ;
     elseif not FileExists(OldFile) then
    end
       DisplayMessageBox("File copy of " .. File .. " failed. \n\nFile not found at: " .. OldFile .. "\n" )
    if letter == 93 then
       return false
       line:AppendPoint(pE0) ;  line:LineTo(pF0) ; line:LineTo(pF8) ;  line:LineTo(pE8) ;  group:AddTail(line) ;
     else
    end
       local fileR = io.open(OldFile)     -- reader file
    if letter == 94 then
       local fileW = io.open(NewFile, "w") -- writer file
       line:AppendPoint(pD8) ;  line:LineTo(pG6) ;  line:LineTo(pG5) ;  line:LineTo(pD7) ;  line:LineTo(pA5) ;  line:LineTo(pA6) ;
       if fileR and fileW then  -- if both files are open
      line:LineTo(pD8) ;  group:AddTail(line) ;
        for Line in fileR:lines() do
     end
          fileW:write(Line .. "\n")
    if letter == 95 then
        end -- for end
      line:AppendPoint(pA0) ;  line:LineTo(pF0) ;  group:AddTail(line) ;
       end
    end
       if fileR then fileR:close() end
    if letter == 96 then
       if fileW then fileW:close() end
       line:AppendPoint(pA4) ;  line:LineTo(pG4) ;  group:AddTail(line) ;
       return true
    end
     end -- for end
    -- Start of Lower Case
end -- function end </nowiki>
    if letter == 97 then
----
      line:AppendPoint(pA0) ;  line:LineTo(pD8) ;  line:LineTo(pG0) ;  line:LineTo(pF3) ;  line:LineTo(pB3) ;
      line:LineTo(pA0) ;  group:AddTail(line) ;
    end
    if letter == 98 then
      line:AppendPoint(pA4) ;  line:LineTo(pF4) ;  line:LineTo(pG5) ;  line:LineTo(pG7) ;  line:LineTo(pF8) ;  line:LineTo(pA8) ;
      line:LineTo(pA0) ;  line:LineTo(pF0) ;  line:LineTo(pG1) ;  line:LineTo(pG3) ;  line:LineTo(pF4) ;  group:AddTail(line) ;
    end
    if letter == 99 then
      line:AppendPoint(pG2) ;  line:LineTo(pF0) ;  line:LineTo(pB0) ;  line:LineTo(pA2) ;  line:LineTo(pA6) ;  line:LineTo(pB8) ;
      line:LineTo(pF8) ;  line:LineTo(pG6) ;  group:AddTail(line) ;
    end
    if letter == 100 then
      line:AppendPoint(pA0) ;  line:LineTo(pF0) ;  line:LineTo(pG2) ;  line:LineTo(pG6) ;  line:LineTo(pF8) ;  line:LineTo(pA8) ;
      line:LineTo(pA0) ;  group:AddTail(line) ;
    end
    if letter == 101 then
      line:AppendPoint(pG0) ;  line:LineTo(pA0) ;  line:LineTo(pA8) ;  line:LineTo(pF8) ;  group:AddTail(line) ;  line = Contour(0.0) ;
      line:AppendPoint(pA4) ;  line:LineTo(pD4) ;  group:AddTail(line) ;
    end
    if letter == 102 then
      line:AppendPoint(pA0) ;  line:LineTo(pA8) ;  line:LineTo(pG8) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pA4) ;
      line:LineTo(pF4) ;  group:AddTail(line) ;
    end
    if letter == 103 then
      line:AppendPoint(pG6) ;  line:LineTo(pG7) ;  line:LineTo(pF8) ;  line:LineTo(pB8) ;  line:LineTo(pA6) ;  line:LineTo(pA2) ;
      line:LineTo(pB0) ;  line:LineTo(pF0) ;  line:LineTo(pG2) ;  line:LineTo(pG3) ;  line:LineTo(pE3) ;  line:LineTo(pE2) ;  group:AddTail(line) ;
    end
    if letter == 104 then
      line:AppendPoint(pA0) ;  line:LineTo(pA8) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pG0) ;  line:LineTo(pG8) ;
      group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pA4) ;  line:LineTo(pG4) ;  group:AddTail(line) ;
    end
    if letter == 105 then
      line:AppendPoint(pB0) ;  line:LineTo(pB8) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pA0) ;  line:LineTo(pC0) ;
      group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pA8) ;  line:LineTo(pC8) ;  group:AddTail(line) ;  pH0 = pE0 ;
    end
    if letter == 106 then
      line:AppendPoint(pA2) ;  line:LineTo(pB0) ;  line:LineTo(pF0) ;  line:LineTo(pG2) ;  line:LineTo(pG8) ;  line:LineTo(pC8) ;
       group:AddTail(line) ;
     end
    if letter == 107 then
       line:AppendPoint(pA0) ;  line:LineTo(pA8) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pA2) ;  line:LineTo(pG7) ;
       group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pD4) ;  line:LineTo(pG0) ;  group:AddTail(line) ;
    end
    if letter == 108 then
       line:AppendPoint(pA8) ;  line:LineTo(pA0) ;  line:LineTo(pG0) ;  group:AddTail(line) ;
    end
    if letter == 109 then
      line:AppendPoint(pA0) ; line:LineTo(pA8) ;  line:LineTo(pD4) ;  line:LineTo(pG8) ;  line:LineTo(pG0) ;  group:AddTail(line) ;
    end
    if letter == 110 then
      line:AppendPoint(pA0) ;  line:LineTo(pA8) ;  line:LineTo(pF0) ;  line:LineTo(pF8) ;  group:AddTail(line) ;  pH0 = pG0 ;
    end
    if letter == 111 then
      line:AppendPoint(pB0) ;  line:LineTo(pA2) ;  line:LineTo(pA6) ;  line:LineTo(pB8) ;  line:LineTo(pF8) ;  line:LineTo(pG6) ;
      line:LineTo(pG2) ;  line:LineTo(pF0) ;  line:LineTo(pB0) ;  group:AddTail(line) ;
    end
    if letter == 112 then
      line:AppendPoint(pA0) ;  line:LineTo(pA8) ;  line:LineTo(pF8) ;  line:LineTo(pG7) ;  line:LineTo(pG5) ;  line:LineTo(pF4) ;
      line:LineTo(pA4) ;  group:AddTail(line) ;
    end
    if letter == 113 then
      line:AppendPoint(pB0) ;  line:LineTo(pA2) ;  line:LineTo(pA6) ;  line:LineTo(pB8) ;  line:LineTo(pF8) ;  line:LineTo(pG6) ;
      line:LineTo(pG2) ;  line:LineTo(pF0) ;  line:LineTo(pB0) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pG0) ;  line:LineTo(pD4) ; group:AddTail(line)
    end
    if letter == 114 then
      line:AppendPoint(pA0) ;  line:LineTo(pA8) ;  line:LineTo(pF8) ;  line:LineTo(pG7) ;  line:LineTo(pG5) ;  line:LineTo(pF4) ;
      line:LineTo(pA4) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pD4) ;  line:LineTo(pG0) ;  group:AddTail(line) ;
    end
    if letter == 115 then
      line:AppendPoint(pG5) ;  line:LineTo(pG6) ;  line:LineTo(pF8) ;  line:LineTo(pB8) ;  line:LineTo(pA6) ;  line:LineTo(pA5) ;
      line:LineTo(pG3) ;  line:LineTo(pG2) ;  line:LineTo(pF0) ;  line:LineTo(pB0) ;  line:LineTo(pA2) ;  line:LineTo(pA3) ;  group:AddTail(line) ;
    end
    if letter == 116 then
      line:AppendPoint(pA8) ;  line:LineTo(pG8) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pD8) ;
      line:LineTo(pD0) ;  group:AddTail(line) ;
    end
    if letter == 117 then
      line:AppendPoint(pA8) ;  line:LineTo(pA2) ;  line:LineTo(pB0) ;  line:LineTo(pF0) ;  line:LineTo(pG2) ;  line:LineTo(pG8) ;
       group:AddTail(line) ;
    end
    if letter == 118 then
       line:AppendPoint(pA8) ;  line:LineTo(pD0) ;  line:LineTo(pG8) ;  group:AddTail(line) ;
    end
    if letter == 119 then
      line:AppendPoint(pA8) ;  line:LineTo(pB0) ;  line:LineTo(pD4) ;  line:LineTo(pF0) ;  line:LineTo(pG8) ;  group:AddTail(line) ;
    end
    if letter == 120 then
       line:AppendPoint(pA0) ;  line:LineTo(pG8) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pA8) ;
      line:LineTo(pG0) ;  group:AddTail(line) ;
    end
    if letter == 121 then
      line:AppendPoint(pA8) ;  line:LineTo(pD4) ;  line:LineTo(pG8) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pD0) ;
      line:LineTo(pD4) ;  group:AddTail(line) ;
    end
    if letter == 122 then
       line:AppendPoint(pA8) ;  line:LineTo(pG8) ;  line:LineTo(pA0) ;  line:LineTo(pG0) ;  group:AddTail(line) ;
     end
    -- End of Lower Case
    if letter == 123 then
      line:AppendPoint(pD0) ;  line:LineTo(pC0) ;  line:LineTo(pB1) ;  line:LineTo(pB2) ;  line:LineTo(pC3) ;  line:LineTo(pA4) ;
      line:LineTo(pC5) ;  line:LineTo(pB6) ;  line:LineTo(pB7) ;  line:LineTo(pC8) ;  line:LineTo(pD8) ;  group:AddTail(line) ;
    end
    if letter == 124 then
      line:AppendPoint(pA0) ;  line:LineTo(pA10) ;  line:LineTo(pC10) ;  line:LineTo(pC0) ;  line:LineTo(pA0) ;  group:AddTail(line) ;
    end
    if letter == 125 then
      line:AppendPoint(pD0) ;  line:LineTo(pE0) ;  line:LineTo(pF1) ;  line:LineTo(pF2) ;  line:LineTo(pE3) ;  line:LineTo(pG4) ;
      line:LineTo(pE5) ;  line:LineTo(pF6) ;  line:LineTo(pF7) ;  line:LineTo(pE8) ;  line:LineTo(pD8) ;  group:AddTail(line) ;
    end
    if letter == 126 then
      line:AppendPoint(pA2) ;  line:LineTo(pA3) ;  line:LineTo(pB5) ;  line:LineTo(pF3) ;  line:LineTo(pG5) ;
      line:LineTo(pG4) ;  line:LineTo(pF2) ;  line:LineTo(pB4) ;  line:LineTo(pA2) ;  group:AddTail(line) ;
    end
    return pH0
  end -- function end


  -- ==============================================================================
===ValidateName===
  local function AddGroupToJob(job, group, layer_name)
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
    --  create a CadObject to represent the group
Returns True if the file name is safe to use
    local cad_object = CreateCadGroup(group);
    -- create a layer with passed name if it doesnt already exist
    local layer = job.LayerManager:GetLayerWithName(layer_name)
    -- and add our object to it
    layer:AddObject(cad_object, true)
    return cad_object
  end -- end function


   -- =========================================================================
<nowiki> function ValidateName(FileName)
    local job = VectricJob()
   local MyTrue = true
    if not job.Exists then
  local strlen = string.len(FileName)
      DisplayMessageBox("Error: Not finding a job loaded")
  local strup = string.upper(FileName)
      return false
  local i = 1
    end
  local y = ""
    local strlen = string.len(what)
  while i <=  strlen do
    local strup = what
    y = string.byte(string.sub(strup, i, i))
    local x = strlen
    if y == 32 then -- Space
    local i = 1
      MyTrue = true
    local y = ""
    elseif y == 45 then -- hyphn
    local ptx = where
       MyTrue = true
    group = ContourGroup(true)
    elseif (y >= 48) and (y <= 57) then -- numbers
    while i <=  x do
      MyTrue = true
      y = string.byte(string.sub(strup, i, i))
    elseif (y >= 65) and (y <= 90) then -- Uppercase
       if (y >= 97) and (y <= 122) then -- Lower case
      MyTrue = true
        ptx = MonoFont(job, ptx, y, (size * 0.75), lay, ang)
    else
        ptx = Polar2D(ptx, ang, size * 0.05)
      MyTrue = false
      else -- Upper case
       break
        ptx = MonoFont(job, ptx, y, size, lay, ang)
    end -- if end
        ptx = Polar2D(ptx, ang, size * 0.07)
    i = i + 1
       end
  end -- while end
      i = i + 1
  return MyTrue
    end -- while end;
  end -- function end </nowiki>
     AddGroupToJob(job, group, lay)
 
     job:Refresh2DView()
----
    return true
 
   end -- Draw Text function end
===FileExists===
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
Returns True if file is found
 
<nowiki> function FileExists(name) 
  -- call = ans = FileExists("sample.txt")
     local f=io.open(name,"r")
     if f~=nil then io.close(f) return true else io.close(f) return false end
   end -- function end </nowiki>
----
 
===FileAccess===
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
Returns true if file is available for update.


  -- ====================================================]]
  <nowiki> function FileAccess(FileName)
  function Holer(pt, ang, dst, dia, lay)
    if (not(os.rename(FileName, FileName))) then
       local job = VectricJob()
       StatusMessage("Error", FileName, "The Gadget cannot access the ".. FileName ..
      if not job.Exists then
        " The OS has blocked write access. " ..
         DisplayMessageBox("Error: No job loaded")
         "Verify the full path is correct and No application has the file open. ", "(1405)")
         return false
         return false
      end
  else
    --Caller: Holer(ptx, anx, BaseDim.HoleSpace, Milling.ShelfPinRadius, Milling.LNSideShelfPinDrill .. "-Base")
      local function AddGroupToJob(job, group, layer_name)
        local cad_object = CreateCadGroup(group);
        local layer = job.LayerManager:GetLayerWithName(layer_name)
        layer:AddObject(cad_object, true)
        return cad_object
      end
    local group = ContourGroup(true)
    group:AddTail(CreateCircle(pt.x, pt.y, dia, 0.0, 0.0))
    pt = Polar2D(pt, ang, dst)
    group:AddTail(CreateCircle(pt.x, pt.y, dia, 0.0, 0.0))
    AddGroupToJob(job, group, lay)
     return true
     return true
   end -- function end
   end -- if end
end -- function end </nowiki>
----


-- =====================================================]]
===IsDir===
end -- DrawTools function end
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
Returns true if path is found


<nowiki> function IsDir(path)                                  --
  local function exists(file)
    local ok, err, code = os.rename(file, file)
    if not ok then
      if code == 13 then
        return true
      end
    end
    return ok, err
  end
  return exists(path.."/")
end -- function end </nowiki>
----


</nowiki>
===Sheetlabel===
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
Returns file line count of a txt (assic) file


<nowiki> function Sheetlabel(Wpt, xTextHeight,  xThickness, xType, YY) -- Constructs sheet label
  local pt1Text = Point2D()
  local Pang    = 0.0
  local Tang    = 0.0
  if YY then
    pt1Text = Polar2D(Polar2D(Wpt, 90.0,  YY), 90.0,  6.0 * JimAndi.Cal)
    Pang = 270.0
    Tang = 0.0
  else
    if Material.Orientation == "V" then
      pt1Text = Polar2D(Wpt, 90.0, Milling.MaterialBlockWidth + (4.0 * JimAndi.Cal))
    else
      pt1Text = Polar2D(Wpt, 90.0,  Milling.MaterialBlockHeight + (4.0 * JimAndi.Cal))
    end
    Pang = 270.0
    Tang = 0.0
  end
  DrawWriter(Project.ProgramName, pt1Text, Milling.TextHeight * 3.0, JimAndi.LNDrawNotes, Tang)
  pt1Text = Polar2D(pt1Text, Pang, Milling.TextHeight * 3.35)
  DrawWriter("Cabinet ID: " .. Project.DrawerID, pt1Text, JimAndi.TextHeight * 2.0, JimAndi.LNDrawNotes, Tang)
  pt1Text = Polar2D(pt1Text, Pang, Milling.TextHeight * 2.75)
  DrawWriter("Cabinet Name: " .. Project.CabinetName, pt1Text, JimAndi.TextHeight * 2.0, JimAndi.LNDrawNotes, Tang)
  pt1Text = Polar2D(pt1Text, Pang, Milling.TextHeight * 2.75)
  if xThickness then
    DrawWriter("Material: " .. xThickness .. " " .. xType, pt1Text, JimAndi.TextHeight * 2.0, JimAndi.LNDrawNotes, Tang)
  end -- if end
end -- function end </nowiki>
----
===DiskRights===
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
Returns true if you have write access to path.
<nowiki> function DiskRights(path)                            --
  local xx = io.open(path, "w")
  if xx == nil then
      io.close()
      return false
  else
      xx:close()
      return true
  end
end -- function end </nowiki>
----
==Geometry Tools==
[[File:Back.jpg|right|50px|link=Vectric Lua Interface for Gadgets]]
This object is a name-value pair that represents a Document Variable within a [[VectricJob]].
This object is a name-value pair that represents a Document Variable within a [[VectricJob]].


<nowiki>
===SheetNew===
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
-- =====================================================]]
 
╔╦╗╔═╗╔╦╗╔═╗  ╔═╗═╗ ╦╔═╗╔═╗╦═╗╔╦╗  ╔╦╗╔═╗╔═╗╦  ╔═╗
Adds a new sheet to the drawing
║║╠═╣ ║ ╠═╣  ║╣ ╔╩╦╝╠═╝║ ║╠╦╝ ║    ║ ║ ║║ ║║  ╚═╗
 
═╩╝╩ ╩ ╩ ╩ ╩ ╚═╝╩ ╚═╩  ╚═╝╩╚═ ╩    ╩ ╚═╝╚═╝╩═╝╚═╝
  <nowiki> function SheetNew()                                     -- Adds a new sheet to the drawing
function ExportTools()
  if GetVersion() >= 10.5 then then
-- =====================================================]]
    local layer_manager = Milling.job.LayerManager
function LogWriter(LogName, xText)
    -- get current sheet count - note sheet 0 the default sheet counts as one sheet
  -- Adds a new xText Line to a app log file
    local orig_num_sheets = layer_manager.NumberOfSheets
  -- local LogName = Door.CSVPath .. "\\" .. Door.RuntimeLog .. ".txt"
    -- get current active sheet index
  local fileW = io.open(LogName,  "a")
    local orig_active_sheet_index = layer_manager.ActiveSheetIndex
  if fileW then
    -- set active sheet to last sheet
     fileW:write(xText .. "\n")
    local num_sheets = layer_manager.NumberOfSheets
     fileW:close()
    layer_manager.ActiveSheetIndex = num_sheets - 1
    -- Add a new sheet
    layer_manager:AddNewSheet()
    -- set active sheet to last sheet we just added
     num_sheets = layer_manager.NumberOfSheets
    layer_manager.ActiveSheetIndex = num_sheets - 1
     Milling.job:Refresh2DView()
   end -- if end
   end -- if end
  Maindialog:UpdateLabelField("Door.Alert", "Note: Errors are logged in the CSF file folder.")
   return true
   return true
end -- function end
end </nowiki>
-- =====================================================]]
 
function Write_CSV(xFilename) -- Writes the values to a csv format file
----
-- Usage: Write_CSV("C:\\Path\\MyName.csv")
 
-- Door.CSVPath = dialog:GetTextField("DoorCSVPath")
===GetDiameterAndCentre===
-- local filename = Path .. "\\" .. Name .. ".csv"
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
   local filename = xFilename
<nowiki>function GetDiameterAndCentre(cadcontour, point2d)
   xFilename
  local contour = cadcontour:GetContour()
   local file = io.open(filename, "w")
  local arc = contour:GetFirstSpan()
   if file then  -- if the file was opened
  local point3d = Point3D();
    file:write("Count,Height,Width\n") -- Header Line
   arc = CastSpanToArcSpan(arc)
    if Door.Unit then
   local diameter = arc:RadiusAndCentre(point3d) * 2.0
      file:write("1,110,595\n");    file:write("1,150,75\n");    file:write("1,175,395\n");    file:write("1,140,495\n")
   point2d = Point2D(point3d.x, point3d.y)
      file:write("1,175,445\n");    file:write("1,175,595\n");    file:write("2,200,100\n");    file:write("3,250,125\n")
   -- MessageBox("Diameter = " .. diameter)
      file:write("1,300,150\n");    file:write("2,350,175\n");    file:write("3,400,200\n");    file:write("1,450,225\n")
  return diameter, point2d
      file:write("2,500,250\n");    file:write("3,550,275\n");    file:write("1,600,300\n");    file:write("2,650,325\n")
end</nowiki>
      file:write("3,700,350\n");    file:write("1,750,375\n");    file:write("2,800,400\n");     file:write("3,850,425\n");
 
      file:write("1,900,450\n");    file:write("2,950,475\n");    file:write("3,1000,500\n");    file:write("1,1050,525\n");
----
      file:write("2,1100,550\n");   file:write("3,1150,575\n");   file:write("1,1200,600\n");    file:write("2,1250,625\n");
 
      file:write("3,1300,650\n");   file:write("1,1350,675\n");   file:write("2,1400,700\n");    file:write("3,1450,725\n");
===IsCircle===
      file:write("1,1500,750\n");   file:write("2,1550,775\n");   file:write("3,1600,800\n");    file:write("1,1650,825\n");
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
      file:write("2,1700,850\n");   file:write("3,1750,875\n");   file:write("1,1800,900\n");    file:write("2,1850,925\n");
<nowiki>function IsCircle(cadcontour)                           -- Returns True if conture is a circle
      file:write("3,1900,950\n");   file:write("1,1950,975\n");   file:write("2,2000,1000\n");  file:write("3,2050,1025\n");
  local contour = cadcontour:GetContour()
      file:write("1,2100,1050\n");  file:write("2,2150,1075\n");  file:write("3,2200,1100\n");   file:write("1,2250,1125\n");
  -- Does it consist only of arcs?
      file:write("2,2300,1150\n");  file:write("3,2350,1175\n");  file:write("1,2400,1200\n");  file:write("2,2450,1225\n")
  if contour.ContainsBeziers then
     else
     return false
      file:write("1,04.5000,23.2500\n");  file:write("1,06.0000,03.3125\n");  file:write("1,06.5000,15.5000\n");  file:write("1,05.3750,19.5000\n");
  end
      file:write("1,07.1875,17.5000\n");  file:write("1,06.1875,23.5000\n");  file:write("2,07.8750,03.8750\n");  file:write("3,09.8750,05.0000\n");
   if not contour.ContainsArcs then
      file:write("1,11.7500,05.8750\n");  file:write("2,13.7500,06.6750\n");  file:write("3,15.7500,07.8750\n");  file:write("1,17.1250,08.8250\n");
    return false
      file:write("2,19.5000,09.5000\n");  file:write("3,21.1250,10.3750\n");  file:write("1,23.6250,11.1250\n");  file:write("2,25.5000,12.1250\n");
   end
      file:write("3,27.6250,13.7500\n");  file:write("1,29.5000,14.7500\n");  file:write("2,31.4375,15.7500\n");  file:write("3,33.4375,16.7500\n");
   -- Does is contain 4 contours?
      file:write("1,35.4375,17.7500\n");  file:write("2,37.4375,18.6250\n");  file:write("3,39.3750,19.6250\n");  file:write("1,41.3750,20.6250\n");
   if contour.Count ~= 4 then
      file:write("2,43.3750,21.6250\n");  file:write("3,45.1875,22.6250\n");  file:write("1,47.2500,23.6250\n");  file:write("2,49.1875,24.6250\n");
    return false
      file:write("3,51.1250,25.5000\n");  file:write("1,53.1250,26.5000\n");  file:write("2,55.1250,27.5000\n");  file:write("3,57.1250,28.5000\n");
   end
      file:write("1,59.1250,29.5000\n");  file:write("2,61.2500,30.5000\n");  file:write("3,62.9375,31.4375\n");  file:write("1,64.9375,32.4375\n");
   -- Check the arcs end and initial points make a square.
      file:write("2,66.9375,33.4375\n");  file:write("3,68.8125,34.4375\n");  file:write("1,70.8750,35.3750\n");  file:write("2,72.9375,36.4375\n");
   local arcs = {}
      file:write("3,74.8750,37.4375\n");  file:write("1,76.9375,38.3750\n");  file:write("2,78.7500,39.3750\n");  file:write("3,80.7500,40.3750\n");
   local count = 1;
      file:write("1,82.6250,41.3750\n");  file:write("2,84.6250,42.3750\n"); file:write("3,86.6250,43.3750\n");  file:write("1,88.5000,44.2500\n");
   local pos = contour:GetHeadPosition()
       file:write("2,90.6250,45.2500\n");  file:write("3,92.6250,46.2500\n");  file:write("1,94.4375,47.2500\n");  file:write("2,95.4375,48.2500\n")
   local object
     end -- if end
   while pos ~= nil do
    file:close()-- closes the open file
    object, pos = contour:GetNext(pos)
   end -- if end
     arcs[count] = object
   return true
    count = count + 1
end
  end
-- =====================================================]]
  local x_1 =(arcs[1]).StartPoint2D.x
end -- ExportTools function end
  local y_1 =(arcs[1]).StartPoint2D.y
  local x_3 =(arcs[3]).StartPoint2D.x
  local y_3 =(arcs[3]).StartPoint2D.y
  local x_2 =(arcs[2]).StartPoint2D.x
  local y_2 =(arcs[2]).StartPoint2D.y
  local x_4 =(arcs[4]).StartPoint2D.x
  local y_4 =(arcs[4]).StartPoint2D.y
  local horizontal_distance = (x_1 - x_3)*(x_1 - x_3) + (y_1 - y_3)*(y_1 - y_3)
  local vertical_distance = (x_4 - x_2)*(x_4 - x_2) + (y_2 - y_4)*(y_2 - y_4)
  if math.abs(horizontal_distance - vertical_distance) > 0.04 then
    return false
  end
  -- Check the bulge factor is 90
  local bulge = 0;
  for _, arc_span in ipairs(arcs) do
    bulge = CastSpanToArcSpan(arc_span).Bulge;
    if math.abs(math.abs(bulge- g_bulge90) > 0.04 then
       return false
     end
   end
   return true
end</nowiki>


----


</nowiki>
===SheetSet===
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
<nowiki>function SheetSet(Name)                    -- Move focus to a named sheet
  local job = VectricJob()
  local sheet_manager = job.SheetManager
  local sheet_ids = sheet_manager:GetSheetIds()
  for id in sheet_ids do
    if(sheet_manager:GetSheetName(id) == Name) then
    sheet_manager.ActiveSheetId = id
    end
  end
end</nowiki>


This object is a name-value pair that represents a Document Variable within a [[VectricJob]].
----


<nowiki>
===SheetNextSize===
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
-- =====================================================]]
  <nowiki>function SheetNextSize(X, Y)               -- Make New Sheet to size (x, y)
╔╦╗═╗ ╦╔╦╗ ╔═╗╦╦  ╔═╗  ╔╦╗╔═╗╔═╗╦  ╔═╗
  if X == nil then
║ ╔╩╦╝ ║  ╠╣ ║║  ║╣    ║ ║ ║║ ║║  ╚═╗
    X = Milling.MaterialBlockWidth
╩ ╩ ╚═ ╩  ╚  ╩╩═╝╚═╝  ╩ ╚═╝╚═╝╩═╝╚═╝
   else
function FileTools()
    X = X + (2 * Milling.Cal)
-- =====================================================]]
  end
   function LengthOfFile(filename)                       -- Returns file line count
  if Y == nil then
--[[Counts the lines in a file
     Y = Milling.MaterialBlockHeight
    Returns: number]]
  else
     local len = 0
     Y = Y + (2 * Milling.Cal)
     if FileExists(filename) then
  end
      local file = io.open(filename)
  Milling.Sheet = Milling.Sheet + 1
      if file then
  local sheet_manager = Milling.job.SheetManager
      for _ in file:lines() do
  local sheet_ids = sheet_manager:GetSheetIds()
        len = len + 1
  for id in sheet_ids do
      end
    if(sheet_manager:GetSheetName(id) == "Sheet 1") then
      file:close()
    sheet_manager:CreateSheets(1, id, Box2D(Point2D(0, 0), Point2D(X, Y)))
    end -- if end
     end
     end
    return len
  end
  end -- function end
  SheetSet("Sheet " .. tostring(Milling.Sheet))
  -- =====================================================]]
  return true
  function NameValidater(FileName)
end</nowiki>
    local MyTrue = true
 
     local strlen = string.len(FileName)
----
    local strup = string.upper(FileName)
 
    local i = 1
===GetPolarAngle===
    local y = ""
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
    while i <=  strlen do
<nowiki>function GetPolarAngle(Start, Corner, End)           -- Returns the Polar Angle
      y = string.byte(string.sub(strup, i, i))
  local function GetPolarDirection(point1, point2) 
       if y == 32 then   --  Space
     local ang = math.abs(math.deg(math.atan((point2.Y - point1.Y) / (point2.X - point1.X))))
         MyTrue = false
    if point1.X < point2.X then
         break
       if point1.Y < point2.Y then
       elseif y == 45 then  -- Dash
         ang = ang + 0.0
         MyTrue = false
      else
         break
         ang = 360.0 - ang
       elseif y == 127 then  -- Delete
       end -- if end
        MyTrue = false
    else
        break
      if point1.Y < point2.Y then
       elseif y == 126 then  -- Delete
         ang = 180.0 - ang
        MyTrue = false
      else
        break
         ang = ang + 180.0
       end -- if end
    end -- if end
    if ang >=360 then
       ang = ang -360.0
    end -- if end
    return ang
  end -- function end
  return  math.abs(GetPolarDirection(Corner, Start) - GetPolarDirection(Corner, End))
end -- function end</nowiki>


      elseif y == 123 then  -- Open brace
----
        MyTrue = false
        break
      elseif y == 124 then  -- Pipe
        MyTrue = false
        break
      elseif y == 125 then  -- Close brace
        MyTrue = false
        break


      elseif  -- Illegal Filename Characters
===GetOrientation===
      (y == 33) or -- ! Exclamation mark
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
      (y == 34) or -- " Double Quotes
<nowiki>function GetOrientation(point1, point2)                 -- Orientation of left, right, up or down
      (y == 35) or -- # Hash
  if DecimalPlaces(point1.X,8) == DecimalPlaces(point2.X,8) then
      (y == 36) or -- $ Dollar
    if point1.Y < point2.Y then
      (y == 37) or -- % Percent
       return 90.0
      (y == 38) or -- & Ampersand
    else
       (y == 39) or -- ' Apostrophe
       return 270.0
       (y == 42) or -- * Asterisk
    end
       (y == 43) or -- + Plus
  elseif DecimalPlaces(point1.Y,8) == DecimalPlaces(point2.Y,8) then
       (y == 44) or -- , Comma
    if point1.X < point2.X then
      (y == 47) or -- / Slash
       return 0.0
      (y == 58) or -- : Colon
    else
      (y == 59) or -- ; Semi-colon
       return 180.0
      (y == 60) or -- < Less than
    end
      (y == 62) or -- > Greater than
  else
      (y == 63) or -- ? Question mark
    return nil
      (y == 64) or -- @ At
  end
      (y == 92) or -- \ Backslash
end -- function end</nowiki>
      (y == 96) or -- ` Single Quotes
 
      (y == 123) or -- { Open brace
----
      (y == 124) or -- | Pipe
 
      (y == 125)   -- } Close brace
===GetPolarDirection===
      then
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
        MyTrue = false
<nowiki>function GetPolarDirection(point1, point2)             -- Retuens and amgle from two points
        break
  local ang = math.abs(math.deg(math.atan((point2.Y - point1.Y) / (point2.X - point1.X))))
      elseif (y <= 31) then -- Control Codes
  if point1.X < point2.X then
        MyTrue = false
    if point1.Y < point2.Y then
        break
      ang = ang + 0.0
       elseif (y >= 48) and (y <= 57) then -- Numbers
    else
        MyTrue = false
       ang = 360.0 - ang
        break
    end -- if end
      elseif (y >= 65) and (y <= 90) then -- Uppercase A to Z
  else
        MyTrue = false
    if point1.Y < point2.Y then
        break
       ang = 180.0 - ang
       elseif (y >= 97) and (y <= 122) then -- Lowercase A to Z
    else
        MyTrue = false
       ang = ang + 180.0
        break
    end -- if end
       elseif (y >= 65) and (y <= 90) then -- Uppercase A to Z
  end -- if end
        MyTrue = false
  if ang >=360 then
        break
     ang = ang -360.0
      end -- if end
      i = i + 1  end -- while end;
     return MyTrue
   end -- if end
   end -- if end
-- =====================================================]]
  return ang
  function CopyFileFromTo(OldFile, NewFile)             -- Copy Old File to Newfile
end -- function end</nowiki>
    if FileExists(NewFile) then
 
      DisplayMessageBox("File copy " .. File .. " failed. \n\nFile found at: " .. NewFile  .. "\n" )
----
      return false
 
     elseif not FileExists(OldFile) then
===CenterArc===
      DisplayMessageBox("File copy of " .. File .. " failed. \n\nFile not found at: " .. OldFile .. "\n" )
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
      return false
<nowiki>function CenterArc(A, B, RadiusD)                       -- Returns 2DPoint from Arc point and Radius
    else
  local radius = ((tonumber(RadiusD) or 0) * g_var.scl)
      local fileR = io.open(OldFile)      -- reader file
  local horda = (A - B).Length
      local fileW = io.open(NewFile, "w") -- writer file
  if math.abs(radius) < (horda / 2) and radius ~= 0 then
      if fileR and fileW then  -- if both files are open
--D("Too small radius " .. radius .. "\nreplaced by the smallest possible " .. (horda / 2))
        for Line in fileR:lines() do
     radius = (horda / 2)
          fileW:write(Line .. "\n")
  end
        end -- for end
  return Point2D(((A.x + B.x) / 2 + (B.y - A.y) * math.sqrt(math.abs(radius) ^ 2 - (horda / 2) ^ 2) / horda), ((A.y + B.y) / 2 + (A.x - B.x) * math.sqrt(math.abs(radius) ^ 2 - (horda / 2) ^ 2) / horda))
      end
end -- function end</nowiki>
      if fileR then fileR:close() end
 
      if fileW then fileW:close() end
----
      return true
 
    end -- for end
===Polar2D===
  end -- function end
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
-- =====================================================]]
 
   function ValidateName(FileName)                       -- Returns True if the file name is safe to use
The Polar2D function will calculate a new point in space based on a Point of reference, Angle of direction, and Projected distance. Returns 2DPoint from Known Point, Angle direction, and Projected distance.
   local MyTrue = true
 
  local strlen = string.len(FileName)
<nowiki>function Polar2D(pt, ang, dis)                      
  local strup = string.upper(FileName)
-- The Polar2D function will calculate a new point in space based on a Point of reference, Angle of direction, and Projected distance.
  local i = 1
-- ::''Returns a 2Dpoint(x, y)''
  local y = ""
  return Point2D((pt.X + dis * math.cos(math.rad(ang))), (pt.Y + dis * math.sin(math.rad(ang))))
  while i <=  strlen do
end -- End Function</nowiki>
    y = string.byte(string.sub(strup, i, i))
 
    if y == 32 then -- Space
----
      MyTrue = true
 
    elseif y == 45 then -- hyphn
===GetDistance===
      MyTrue = true
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
    elseif (y >= 48) and (y <= 57) then -- numbers
 
      MyTrue = true
Returns Double from two Points
     elseif (y >= 65) and (y <= 90) then -- Uppercase
 
       MyTrue = true
  <nowiki>function GetDistance(objA, objB)                       -- Returns Double from two Points
  local xDist = objB.x - objA.x
  local yDist = objB.y - objA.y
  return math.sqrt((xDist ^ 2) + (yDist ^ 2))
end -- function end</nowiki>
 
----
 
===GetAngle===
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
<nowiki>
  -- ===========================================================]]
   </nowiki>function GetAngle(point1, point2)
   local ang = math.abs(math.deg(math.atan((point2.Y - point1.Y) / (point2.X - point1.X))))
  if point1.X < point2.X then
     if point1.Y < point2.Y then
       ang = ang + 0.0
     else
     else
       MyTrue = false
       ang = 360.0 - ang
      break
     end -- if end
     end -- if end
    i = i + 1
  end -- while end
  return MyTrue
end -- if end
-- =====================================================]]
  function FileExists(name)                            -- Returns True if file is found
  -- call = ans = FileExists("sample.txt")
    local f=io.open(name,"r")
    if f~=nil then io.close(f) return true else io.close(f) return false end
  end -- end function
  -- ===================================================]]
  function FileAccess(FileName)                        -- Returns true if file is available for update.
    if (not(os.rename(FileName, FileName))) then
      StatusMessage("Error", FileName, "The Gadget cannot access the ".. FileName ..
        " The OS has blocked write access. " ..
        "Verify the full path is correct and No application has the file open. ", "(1405)")
        return false
   else
   else
     return true
     if point1.Y < point2.Y then
      ang = 180.0 - ang
    else
      ang = ang + 180.0
    end -- if end
  end -- if end
  if ang >=360.0 then
    ang = ang -360.0
   end -- if end
   end -- if end
end -- function end
  return ang
-- =====================================================]]
end -- function end</nowiki>
   function isdir(path)                                 -- Returns true if path is found
----
   local function exists(file)
 
    local ok, err, code = os.rename(file, file)
===Arc2Bulge===
    if not ok then
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
      if code == 13 then
<nowiki>
        return true
  -- ===========================================================]]
      end
   </nowiki>function Arc2Bulge(p1, p2, Rad)                         -- Returns the Bulge factor for an arc
    end
   local chord = math.sqrt(((p2.x - p1.x) ^ 2) + ((p2.y - p1.y) ^ 2))
    return ok, err
  local seg = (Rad - (0.5 * (math.sqrt((4.0 * Rad^2) - chord^2))))
  end
  local bulge = (2 * seg) / chord
  return exists(path.."/")
  return bulge
end
end -- function end</nowiki>
 
----
 
===TrigIt===
Calculates Right Angle
 
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
<nowiki>function TrigIt()                                       -- Calculates Right Angle
-- ==Trig Function==
-- VECTRIC LUA SCRIPT
-- =====================================================]]
-- =====================================================]]
  function Sheetlabel(Wpt, xTextHeight, xThickness, xType, YY) -- Constructs sheet label
-- Gadgets are an entirely optional add-in to Vectric's core software products.
   local pt1Text = Point2D()
-- They are provided 'as-is', without any express or implied warranty, and you
  local Pang    = 0.0
--  make use of them entirely at your own risk.
  local Tang    = 0.0
-- In no event will the author(s) or Vectric Ltd. be held liable for any damages
  if YY then
--   arising from their use.
    pt1Text = Polar2D(Polar2D(Wpt, 90.0,  YY), 90.0,  6.0 * JimAndi.Cal)
-- Permission is granted to anyone to use this software for any purpose,
    Pang = 270.0
-- including commercial applications, and to alter it and redistribute it freely,
    Tang = 0.0
-- subject to the following restrictions:
   else
-- 1. The origin of this software must not be misrepresented; you must not
    if Material.Orientation == "V" then
--    claim that you wrote the original software.
      pt1Text = Polar2D(Wpt, 90.0, Milling.MaterialBlockWidth + (4.0 * JimAndi.Cal))
-- 2. If you use this software in a product, an acknowledgement in the product
    else
--    documentation would be appreciated but is not required.
      pt1Text = Polar2D(Wpt, 90.0, Milling.MaterialBlockHeight + (4.0 * JimAndi.Cal))
-- 3. Altered source versions must be plainly marked as such, and must not be
    end
--    misrepresented as being the original software.
    Pang = 270.0
-- 4. This notice may not be removed or altered from any source distribution.
    Tang = 0.0
--
  end
-- Right Triangle TrigFunction is written by Jim Anderson of Houston Texas 2020
  DrawWriter(Project.ProgramName, pt1Text, Milling.TextHeight * 3.0, JimAndi.LNDrawNotes, Tang)
  pt1Text = Polar2D(pt1Text, Pang, Milling.TextHeight * 3.35)
  DrawWriter("Cabinet ID: " .. Project.DrawerID, pt1Text, JimAndi.TextHeight * 2.0, JimAndi.LNDrawNotes, Tang)
  pt1Text = Polar2D(pt1Text, Pang, Milling.TextHeight * 2.75)
  DrawWriter("Cabinet Name: " .. Project.CabinetName, pt1Text, JimAndi.TextHeight * 2.0, JimAndi.LNDrawNotes, Tang)
  pt1Text = Polar2D(pt1Text, Pang, Milling.TextHeight * 2.75)
  if xThickness then
    DrawWriter("Material: " .. xThickness .. " " .. xType, pt1Text, JimAndi.TextHeight * 2.0, JimAndi.LNDrawNotes, Tang)
  end -- if end
end -- function end
-- =====================================================]]
-- =====================================================]]
  function DiskRights(path)                            -- Returns true if you have write access to path.
-- Code Debugger
  xx = io.open(path, "w")
-- require("mobdebug").start()
  if xx == nil then
      io.close()
      return false
  else
      xx:close()
      return true
  end
end -- function rights
-- =====================================================]]
-- =====================================================]]
end -- FileTools function end
-- Global Variables --
 
    Trig = {}
 
</nowiki>
 
This object is a name-value pair that represents a Document Variable within a [[VectricJob]].
 
<nowiki>
-- =====================================================]]
-- =====================================================]]
╔═╗╔═╗╔═╗╔╦╗╔═╗╔╦╗╦═╗╦ ╦  ╔╦╗╔═╗╔═╗╦  ╔═╗
   function TrigTest() -- Test the All Right Angle
║ ╦║╣ ║ ║║║║║╣  ║ ╠╦╝╚╦╝   ║ ║ ║║ ║║  ╚═╗
    TrigClear()
╚═╝╚═╝╚═╝╩ ╩╚═╝ ╩ ╩╚═ ╩    ╩ ╚═╝╚═╝╩═╝╚═╝
    Trig.A  = 0.0
function GeometryTools()
    Trig.B  = 0.0
-- =====================================================]]
    Trig.C  = 90.0
function SheetNew()                                    -- Adds a new sheet to the drawing
    Trig.Opp = 3.0  -- Rise  or (B2C)
  if GetVersion() >= 10.5 then then
    Trig.Adj = 4.0  -- Base  or (A2C)
     local layer_manager = Milling.job.LayerManager
    Trig.Hyp = 0.0  -- Slope or (A2B)
    -- get current sheet count - note sheet 0 the default sheet counts as one sheet
    Trig.Slope = 0.0
    local orig_num_sheets = layer_manager.NumberOfSheets
    Trig.Area = 0.0
     -- get current active sheet index
    Trig.OutRadius = 0.0
    local orig_active_sheet_index = layer_manager.ActiveSheetIndex
    Trig.InRadius = 0.0
    -- set active sheet to last sheet
    Trig.Parameter = 0.0
    local num_sheets = layer_manager.NumberOfSheets
    TrigIt()
    layer_manager.ActiveSheetIndex = num_sheets - 1
    DisplayMessageBox("Test 1: \n" ..
    -- Add a new sheet
     " Trig.A  = " .. tostring(Trig.A) .. " \n" ..
    layer_manager:AddNewSheet()
     " Trig.= " .. tostring(Trig.B) .. " \n" ..
    -- set active sheet to last sheet we just added
     " Trig.= " .. tostring(Trig.C) .. " \n" ..
    num_sheets = layer_manager.NumberOfSheets
    " Trig.Opp = * " .. tostring(Trig.Opp) .. " \n" ..
     layer_manager.ActiveSheetIndex = num_sheets - 1
    " Trig.Adj = * " .. tostring(Trig.Adj) .. " \n" ..
    Milling.job:Refresh2DView()
    " Trig.Hyp = " .. tostring(Trig.Hyp) .. " \n" ..
  end -- if end
    " Trig.Slope = " .. tostring(Trig.Slope) .. " \n" ..
  return true
    " Trig.Area = " .. tostring(Trig.Area) .. " \n" ..
end
    " Trig.Parameter = " .. tostring(Trig.Parameter) .. " \n" ..
-- =====================================================]]
    " Trig.OutRadius = " .. tostring(Trig.OutRadius) .. " \n" ..
function GetDiameterAndCentre(cadcontour, point2d)
    " Trig.InRadius = " .. tostring(Trig.InRadius) .. " \n"
  local contour = cadcontour:GetContour()
    )
  local arc = contour:GetFirstSpan()
    -- =====================================================]]
  local point3d = Point3D();
    TrigClear()
  arc = CastSpanToArcSpan(arc)
    Trig.A  = 0.0
  local diameter = arc:RadiusAndCentre(point3d) * 2.0
    Trig.B  =  0.0
  point2d = Point2D(point3d.x, point3d.y)
     Trig.C  = 90.0
  -- MessageBox("Diameter = " .. diameter)
     Trig.Opp =  0.0  -- Rise  or (B2C)
  return diameter, point2d
    Trig.Adj = 4.0  -- Base  or (A2C)
end
     Trig.Hyp = 5.0  -- Slope or (A2B)
-- =====================================================]]
    Trig.Slope = 0.0
function IsCircle(cadcontour)                           -- Returns True if conture is a circle
     Trig.Area = 0.0
  local contour = cadcontour:GetContour()
     Trig.OutRadius = 0.0
  -- Does it consist only of arcs?
     Trig.InRadius = 0.0
  if contour.ContainsBeziers then
    Trig.Parameter = 0.0
     return false
    TrigIt()
  end
    DisplayMessageBox("Test 2: \n" ..
  if not contour.ContainsArcs then
    " Trig.A  = " .. tostring(Trig.A) .. " \n" ..
     return false
    " Trig.B  = " .. tostring(Trig.B) .. " \n" ..
  end
    " Trig.C  = " .. tostring(Trig.C) .. " \n" ..
  -- Does is contain 4 contours?
    " Trig.Opp = * " .. tostring(Trig.Opp) .. " \n" ..
  if contour.Count ~= 4 then
    " Trig.Adj = * " .. tostring(Trig.Adj) .. " \n" ..
     return false;
     " Trig.Hyp = " .. tostring(Trig.Hyp) .. " \n" ..
  end
     " Trig.Slope = " .. tostring(Trig.Slope) .. " \n" ..
  -- Check the arcs end and initial points make a square.
     " Trig.Area =  " .. tostring(Trig.Area) .. " \n" ..
  local arcs = {}
     " Trig.Parameter =  " .. tostring(Trig.Parameter) .. " \n" ..
  local count = 1;
    " Trig.OutRadius =  " .. tostring(Trig.OutRadius) .. " \n" ..
  local pos = contour:GetHeadPosition()
    " Trig.InRadius =  " .. tostring(Trig.InRadius) .. " \n"
  local object
    )
  while pos ~= nil do
    -- =====================================================]]
     object, pos = contour:GetNext(pos)
    TrigClear()
     arcs[count] = object
    Trig.A  = 0.0
     count = count + 1
    Trig.B  = 0.0
  end
     Trig.C  = 90.0
  local x_1 =(arcs[1]).StartPoint2D.x
     Trig.Opp = 3.0  -- Rise  or (B2C)
  local y_1 =(arcs[1]).StartPoint2D.y
     Trig.Adj =  0.0  -- Base  or (A2C)
  local x_3 =(arcs[3]).StartPoint2D.x
    Trig.Hyp = 5.0  -- Slope or (A2B)
  local y_3 =(arcs[3]).StartPoint2D.y
    Trig.Slope = 0.0
  local x_2 =(arcs[2]).StartPoint2D.x
    Trig.Area = 0.0
  local y_2 =(arcs[2]).StartPoint2D.y
    Trig.OutRadius = 0.0
  local x_4 =(arcs[4]).StartPoint2D.x
    Trig.InRadius = 0.0
  local y_4 =(arcs[4]).StartPoint2D.y
    Trig.Parameter = 0.0
  local horizontal_distance = (x_1 - x_3)*(x_1 - x_3) + (y_1 - y_3)*(y_1 - y_3)
    TrigIt()
  local vertical_distance = (x_4 - x_2)*(x_4 - x_2) + (y_2 - y_4)*(y_2 - y_4)
    DisplayMessageBox("Test 3: \n" ..
  if math.abs(horizontal_distance - vertical_distance) > 0.04 then
    " Trig.A  = " .. tostring(Trig.A) .. " \n" ..
     return false
    " Trig.B  = " .. tostring(Trig.B) .. " \n" ..
  end
    " Trig.C  = " .. tostring(Trig.C) .. " \n" ..
  -- Check the bulge factor is 90
     " Trig.Opp = * " .. tostring(Trig.Opp) .. " \n" ..
  local bulge = 0;
    " Trig.Adj = " .. tostring(Trig.Adj) .. " \n" ..
  for _, arc_span in ipairs(arcs) do
    " Trig.Hyp = * " .. tostring(Trig.Hyp) .. " \n" ..
     bulge = CastSpanToArcSpan(arc_span).Bulge;
     " Trig.Slope = " .. tostring(Trig.Slope) .. " on 12 inch \n" ..
     if math.abs(math.abs(bulge)  - g_bulge90) > 0.04 then
     " Trig.Area =  " .. tostring(Trig.Area) .. " \n" ..
      return false
    " Trig.Parameter =  " .. tostring(Trig.Parameter) .. " \n" ..
     end
    " Trig.OutRadius =  " .. tostring(Trig.OutRadius) .. " \n" ..
  end
    " Trig.InRadius =  " .. tostring(Trig.InRadius) .. " \n"
  return true
    )
end
    -- =====================================================]]
-- =====================================================]]
    TrigClear()
function SheetSet(Name)                                 -- Move focus to a named sheet
    Trig.A  =  36.86897645844
  local job = VectricJob()
     Trig.B  = 0.0
  local sheet_manager = job.SheetManager
    Trig.C  = 90.0
  local sheet_ids = sheet_manager:GetSheetIds()
    Trig.Opp =  3.0  -- Rise  or (B2C)
  for id in sheet_ids do
     Trig.Adj = 0.0 -- Base  or (A2C)
     if(sheet_manager:GetSheetName(id) == Name) then
    Trig.Hyp = 0.0 -- Slope or (A2B)
     sheet_manager.ActiveSheetId = id
     Trig.Slope =  0.0
     end
    Trig.Area =  0.0
  end
    Trig.OutRadius = 0.0
end
    Trig.InRadius = 0.0
-- ====================================================]]
     Trig.Parameter = 0.0
function SheetNextSize(X, Y)                            -- Make New Sheet to size (x, y)
     TrigIt()
  if X == nil then
     DisplayMessageBox("Test 4: \n" ..
     X = Milling.MaterialBlockWidth
    " Trig.A = * " .. tostring(Trig.A) .. " \n" ..
  else
    " Trig.B  =  " .. tostring(Trig.B) .. " \n" ..
    X = X + (2 * Milling.Cal)
    " Trig.C  =  " .. tostring(Trig.C) .. " \n" ..
  end
    " Trig.Opp = * " .. tostring(Trig.Opp) .. " \n" ..
  if Y == nil then
    " Trig.Adj =  " .. tostring(Trig.Adj) .. " \n" ..
    Y = Milling.MaterialBlockHeight
    " Trig.Hyp =  " .. tostring(Trig.Hyp) .. " \n" ..
  else
    " Trig.Slope =  " .. tostring(Trig.Slope) .. " on 12 inch \n" ..
    Y = Y + (2 * Milling.Cal)
    " Trig.Area =  " .. tostring(Trig.Area) .. " \n" ..
  end
    " Trig.Parameter =  " .. tostring(Trig.Parameter) .. " \n" ..
  Milling.Sheet = Milling.Sheet + 1
    " Trig.OutRadius =  " .. tostring(Trig.OutRadius) .. " \n" ..
  local sheet_manager = Milling.job.SheetManager
    " Trig.InRadius =  " .. tostring(Trig.InRadius) .. " \n"
  local sheet_ids = sheet_manager:GetSheetIds()
    )
  for id in sheet_ids do
    -- =====================================================]]
     if(sheet_manager:GetSheetName(id) == "Sheet 1") then
     TrigClear()
    sheet_manager:CreateSheets(1, id, Box2D(Point2D(0, 0), Point2D(X, Y)))
    Trig.A  =  36.86897645844
     end
     Trig.= 0.0
  end
     Trig.C  = 90.0
  SheetSet("Sheet " .. tostring(Milling.Sheet))
     Trig.Opp =  0.0  -- Rise  or (B2C)
  return true
    Trig.Adj =  4.0  -- Base  or (A2C)
end
    Trig.Hyp = 0.0  -- Slope or (A2B)
-- =====================================================]]
    Trig.Slope = 0.0
function GetPolarAngle(Start, Corner, End)             -- Returns the Polar Angle
    Trig.Area = 0.0
  local function GetPolarDirection(point1, point2)              --
    Trig.OutRadius = 0.0
     local ang = math.abs(math.deg(math.atan((point2.Y - point1.Y) / (point2.X - point1.X))))
    Trig.InRadius = 0.0
     if point1.X < point2.X then
    Trig.Parameter = 0.0
      if point1.Y < point2.Y then
    TrigIt()
        ang = ang + 0.0
    DisplayMessageBox("Test 5: \n" ..
      else
    " Trig.A  = * " .. tostring(Trig.A) .. " \n" ..
        ang = 360.0 - ang
    " Trig.B  = " .. tostring(Trig.B) .. " \n" ..
      end -- if end
    " Trig.C  = " .. tostring(Trig.C) .. " \n" ..
     else
    " Trig.Opp = " .. tostring(Trig.Opp) .. " \n" ..
      if point1.Y < point2.Y then
     " Trig.Adj = * " .. tostring(Trig.Adj) .. " \n" ..
        ang = 180.0 - ang
     " Trig.Hyp = " .. tostring(Trig.Hyp) .. " \n" ..
      else
     " Trig.Slope = " .. tostring(Trig.Slope) .. " on 12 inch \n" ..
        ang = ang + 180.0
     " Trig.Area = " .. tostring(Trig.Area) .. " \n" ..
      end -- if end
    " Trig.Parameter =  " .. tostring(Trig.Parameter) .. " \n" ..
     end -- if end
    " Trig.OutRadius =  " .. tostring(Trig.OutRadius) .. " \n" ..
    if ang >=360 then
    " Trig.InRadius =  " .. tostring(Trig.InRadius) .. " \n"
      ang = ang -360.0
    )
     end -- if end
    -- =====================================================]]
     return ang
    TrigClear()
  end -- function end
    Trig.= 36.86897645844
  return math.abs(GetPolarDirection(Corner, Start) - GetPolarDirection(Corner, End))
    Trig.= 0.0
end -- function end
    Trig.C  = 90.0
-- =====================================================]]
    Trig.Opp =  0.0  -- Rise  or (B2C)
function GetOrientation(point1, point2)                -- Orientation of left, right, up or down
     Trig.Adj = 0.0  -- Base  or (A2C)
  if DecimalPlaces(point1.X,8) == DecimalPlaces(point2.X,8) then
    Trig.Hyp =  5.0  -- Slope or (A2B)
    if point1.Y < point2.Y then
    Trig.Slope =  0.0
      return 90.0
    Trig.Area =  0.0
     else
    Trig.OutRadius =  0.0
      return 270.0
    Trig.InRadius =  0.0
     end
    Trig.Parameter =  0.0
  elseif DecimalPlaces(point1.Y,8) == DecimalPlaces(point2.Y,8) then
    TrigIt()
     if point1.X < point2.X then
    DisplayMessageBox("Test 6: \n" ..
      return 0.0
    " Trig.A  = * " .. tostring(Trig.A) .. " \n" ..
     else
    " Trig.B  =  " .. tostring(Trig.B) .. " \n" ..
      return 180.0
    " Trig.C  =  " .. tostring(Trig.C) .. " \n" ..
    end
    " Trig.Opp =  " .. tostring(Trig.Opp) .. " \n" ..
  else
    " Trig.Adj =  " .. tostring(Trig.Adj) .. " \n" ..
    return nil
    " Trig.Hyp = * " .. tostring(Trig.Hyp) .. " \n" ..
  end
    " Trig.Slope =  " .. tostring(Trig.Slope) .. " on 12 inch \n" ..
end -- function end
    " Trig.Area =  " .. tostring(Trig.Area) .. " \n" ..
-- =====================================================]]
    " Trig.Parameter =  " .. tostring(Trig.Parameter) .. " \n" ..
function GetPolarDirection(point1, point2)             -- Retuens and amgle from two points
    " Trig.OutRadius =  " .. tostring(Trig.OutRadius) .. " \n" ..
  local ang = math.abs(math.deg(math.atan((point2.Y - point1.Y) / (point2.X - point1.X))))
    " Trig.InRadius =  " .. tostring(Trig.InRadius) .. " \n"
  if point1.X < point2.X then
    )
     if point1.Y < point2.Y then
    TrigClear()
      ang = ang + 0.0
    Trig.A  =  0.0
     else
    Trig.B  =  0.0
      ang = 360.0 - ang
    Trig.C  = 90.0
    end -- if end
    Trig.Opp =  3.0  -- Rise  or (B2C)
  else
    Trig.Adj =  0.0  -- Base  or (A2C)
    if point1.Y < point2.Y then
    Trig.Hyp =  0.0  -- Slope or (A2B)
      ang = 180.0 - ang
    Trig.Slope =  9.0
     else
    Trig.Area =  0.0
      ang = ang + 180.0
    Trig.OutRadius =  0.0
    end -- if end
    Trig.InRadius =  0.0
  end -- if end
    Trig.Parameter =  0.0
  if ang >=360 then
    TrigIt()
     ang = ang -360.0
    DisplayMessageBox("Test 7: \n" ..
  end -- if end
    " Trig.A  =  " .. tostring(Trig.A) .. " \n" ..
  return ang
    " Trig.B  =  " .. tostring(Trig.B) .. " \n" ..
end -- function end
    " Trig.C  =  " .. tostring(Trig.C) .. " \n" ..
-- =====================================================]]
    " Trig.Opp = * " .. tostring(Trig.Opp) .. " \n" ..
function CenterArc(A, B, RadiusD)                       -- Retuns 2DPoint from Arc point and Radius
    " Trig.Adj =  " .. tostring(Trig.Adj) .. " \n" ..
  local radius = ((tonumber(RadiusD) or 0) * g_var.scl)
    " Trig.Hyp =  " .. tostring(Trig.Hyp) .. " \n" ..
  local horda = (A - B).Length
    " Trig.Slope = * " .. tostring(Trig.Slope) .. " on 12 inch \n" ..
  if math.abs(radius) < (horda / 2) and radius ~= 0 then
    " Trig.Parameter =  " .. tostring(Trig.Parameter) .. " \n" ..
--D("Too small radius " .. radius .. "\nreplaced by the smallest possible " .. (horda / 2))
    " Trig.Area =  " .. tostring(Trig.Area) .. " \n" ..
     radius = (horda / 2)
    " Trig.Parameter =  " .. tostring(Trig.Parameter) .. " \n" ..
  end
    " Trig.Circumscribing =  " .. tostring(Trig.Circumscribing) .. " \n" ..
  return Point2D(((A.x + B.x) / 2 + (B.y - A.y) * math.sqrt(math.abs(radius) ^ 2 - (horda / 2) ^ 2) / horda), ((A.y + B.y) / 2 + (A.x - B.x) * math.sqrt(math.abs(radius) ^ 2 - (horda / 2) ^ 2) / horda))
    " Trig.Inscribing =  " .. tostring(Trig.Inscribing) .. " \n"
end
    )
    -- =====================================================]]
    TrigClear()
    Trig.A  =  0.0
    Trig.B  =  0.0
    Trig.C  = 90.0
    Trig.Opp =  0.0  -- Rise  or (B2C)
    Trig.Adj =  0.0  -- Base  or (A2C)
    Trig.Hyp =  0.0  -- Slope or (A2B)
    Trig.Slope =  9.0
    Trig.Area =  0.0
    Trig.OutRadius =  0.0
    Trig.InRadius =  0.0
    Trig.Parameter =  0.0
    TrigIt()
    DisplayMessageBox("Test Error: \n" ..
      " Trig.A  =  " .. tostring(Trig.A) .. " \n" ..
      " Trig.B  =  " .. tostring(Trig.B) .. " \n" ..
      " Trig.C  =  " .. tostring(Trig.C) .. " \n" ..
      " Trig.Opp = * " .. tostring(Trig.Opp) .. " \n" ..
      " Trig.Adj =  " .. tostring(Trig.Adj) .. " \n" ..
      " Trig.Hyp =  " .. tostring(Trig.Hyp) .. " \n" ..
      " Trig.Slope = * " .. tostring(Trig.Slope) .. " on 12 inch \n" ..
      " Trig.Parameter =  " .. tostring(Trig.Parameter) .. " \n" ..
      " Trig.Area =  " .. tostring(Trig.Area) .. " \n" ..
      " Trig.Parameter =  " .. tostring(Trig.Parameter) .. " \n" ..
      " Trig.Circumscribing =  " .. tostring(Trig.Circumscribing) .. " \n" ..
      " Trig.Inscribing =  " .. tostring(Trig.Inscribing) .. " \n"
    )
    return true
  end -- function end --
-- =====================================================]]
-- =====================================================]]
function Polar2D(pt, ang, dis)                         -- Retuns 2DPoint from Known Point, Angle direction, and Projected distance.
  function TrigClear()   -- Clears and resets Trig Table
-- The Polar2D function will calculate a new point in space based on a Point of reference, Angle of direction, and Projected distance.
    Trig.A  =  0.0
-- ::''Returns a 2Dpoint(x, y)''
    Trig.B  =  0.0
  return Point2D((pt.X + dis * math.cos(math.rad(ang))), (pt.Y + dis * math.sin(math.rad(ang))))
    Trig.C  = 90.0
end -- End Function
    Trig.Opp =  0.0  -- Rise  or (B2C)
    Trig.Adj =  0.0  -- Base  or (A2C)
    Trig.Hyp =  0.0  -- Slope or (A2B)
    Trig.Slope =  0.0
    return true
  end -- function end
-- =====================================================]]
-- =====================================================]]
function GetDistance(objA, objB)                       -- Returns Double from two Points
      local function BSA()
  local xDist = objB.x - objA.x
        Trig.B  = (Trig.C - Trig.A)
  local yDist = objB.y - objA.y
        Trig.Slope = math.tan(math.rad(Trig.A)) * 12.0
  return math.sqrt((xDist ^ 2) + (yDist ^ 2))
        Trig.Area =  (Trig.Opp * Trig.Adj) * 0.5
end -- function end
        Trig.Inscribing = ((Trig.Opp + Trig.Adj) - Trig.Hyp) * 0.5
-- =====================================================]]
        Trig.Circumscribing =  Trig.Hyp * 0.5
function GetAngle(point1, point2)
        Trig.Parameter = Trig.Opp + Trig.Adj + Trig.Hyp
  local ang = math.abs(math.deg(math.atan((point2.Y - point1.Y) / (point2.X - point1.X))))
      end
  if point1.X < point2.X then
      if Trig.A == 0.0 and Trig.B > 0.0 and Trig.Slope == 0.0 then
    if point1.Y < point2.Y then
        Trig.A = Trig.C - Trig.B
      ang = ang + 0.0
      elseif Trig.A == 0.0 and Trig.B == 0.0 and Trig.Slope > 0.0 then
    else
        Trig.A = math.deg(math.atan(Trig.Slope / 12.0))
      ang = 360.0 - ang
      end -- if end
    end -- if end
-- test 4
  else
      if (Trig.A > 0.0) and (Trig.Opp >  0.0) then -- A and Rise or (B2C)
    if point1.Y < point2.Y then
        Trig.Adj = Trig.Opp / (math.tan(math.rad(Trig.A)))
      ang = 180.0 - ang
        Trig.Hyp = math.sqrt((Trig.Opp * Trig.Opp ) + ( Trig.Adj * Trig.Adj))
    else
        BSA()
       ang = ang + 180.0
        return true
    end -- if end
      -- test 6
  end -- if end
      elseif (Trig.A > 0.0) and (Trig.Hyp >  0.0)  then -- A and Slope or (A2B)
  if ang >=360.0 then
        Trig.Adj = math.cos(math.rad(Trig.A)) * Trig.Hyp
    ang = ang -360.0
        Trig.Opp = math.sqrt((Trig.Hyp * Trig.Hyp ) - ( Trig.Adj * Trig.Adj))
  end -- if end
        BSA()
  return ang
        return true
end -- function end
       -- test 5
-- =====================================================]]
      elseif (Trig.A > 0.0) and (Trig.Adj >  0.0)  then -- A and Base or (A2C)
function Arc2Bulge(p1, p2, Rad)                         -- Returns the Bulge factor for an arc
        Trig.Opp = math.tan(math.rad(Trig.A)) * Trig.Adj
  local chord = math.sqrt(((p2.x - p1.x) ^ 2) + ((p2.y - p1.y) ^ 2))
        Trig.Hyp = math.sqrt((Trig.Opp * Trig.Opp ) + ( Trig.Adj * Trig.Adj))
  local seg = (Rad - (0.5 * (math.sqrt((4.0 * Rad^2) - chord^2))))
        BSA()
  local bulge = (2 * seg) / chord
        return true
  return bulge
        -- test 1
end -- function end
      elseif (Trig.Opp >  0.0) and (Trig.Adj >  0.0) then -- Rise and Base
-- =====================================================]]
        Trig.Hyp = math.sqrt((Trig.Opp * Trig.Opp ) + ( Trig.Adj * Trig.Adj))
function TrigIt()                                       -- Calulates Right Angle
        Trig.A  = math.deg(math.atan(Trig.Opp / Trig.Adj))
-- ==Trig Function==
        BSA()
-- VECTRIC LUA SCRIPT
        return true
-- =====================================================]]
      elseif (Trig.Adj >  0.0) and (Trig.Hyp >  0.0) then -- Rise and Slope
-- Gadgets are an entirely optional add-in to Vectric's core software products.
-- test 2
-- They are provided 'as-is', without any express or implied warranty, and you
        Trig.Opp = math.sqrt((Trig.Hyp * Trig.Hyp ) - ( Trig.Adj * Trig.Adj))
--  make use of them entirely at your own risk.
        Trig.A  = math.deg(math.atan(Trig.Opp / Trig.Adj))
-- In no event will the author(s) or Vectric Ltd. be held liable for any damages
        BSA()
--  arising from their use.
        return true
-- Permission is granted to anyone to use this software for any purpose,
      elseif (Trig.Opp >  0.0) and (Trig.Hyp >  0.0) then -- Base and Slope
-- including commercial applications, and to alter it and redistribute it freely,
-- test 3
-- subject to the following restrictions:
        Trig.Adj = math.sqrt((Trig.Hyp * Trig.Hyp ) - ( Trig.Opp * Trig.Opp))
-- 1. The origin of this software must not be misrepresented; you must not
        Trig.A  = math.deg(math.atan(Trig.Opp / Trig.Adj))
--    claim that you wrote the original software.
        BSA()
-- 2. If you use this software in a product, an acknowledgement in the product
        return true
--    documentation would be appreciated but is not required.
      else
-- 3. Altered source versions must be plainly marked as such, and must not be
        DisplayMessageBox("Error: Trig Values did not match requirements: \n" ..
--    misrepresented as being the original software.
                          " Trig.A  =  " .. tostring(Trig.A) .. " \n" ..
-- 4. This notice may not be removed or altered from any source distribution.
                          " Trig.B  =  " .. tostring(Trig.B) .. " \n" ..
--
                          " Trig.C  =  " .. tostring(Trig.C) .. " \n" ..
-- Right Triangle TrigFunction is written by Jim Anderson of Houston Texas 2020
                          " Trig.Opp =  " .. tostring(Trig.Opp) .. " \n" ..
                          " Trig.Adj =  " .. tostring(Trig.Adj) .. " \n" ..
                          " Trig.Hyp =  " .. tostring(Trig.Hyp) .. " \n" ..
                          " Trig.Slope =  " .. tostring(Trig.Slope) .. " on 12 inch \n" ..
                          " Trig.Area =  " .. tostring(Trig.Area) .. " \n" ..
                          " Trig.Parameter =  " .. tostring(Trig.Parameter) .. " \n" ..
                          " Trig.OutRadius =  " .. tostring(Trig.OutRadius) .. " \n" ..
                          " Trig.InRadius =  " .. tostring(Trig.InRadius) .. " \n"
                          )
        return false
      end
    end -- function end
-- =====================================================]]
-- =====================================================]]
-- Code Debugger
end -- Geometry Tools end
-- require("mobdebug").start()
 
-- =====================================================]]
</nowiki>
-- Global Variables --
 
    Trig = {}
==INI File Tools==
-- =====================================================]]
[[File:Back.jpg|right|50px|link=Vectric Lua Interface for Gadgets]]
   function TrigTest() -- Test the All Right Angle
These functions manipulate the INI files for the storage and retrieval of data.
    TrigClear()
 
    Trig.A  = 0.0
 
    Trig.= 0.0
===INI_NameStrip===
     Trig.C  = 90.0
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
     Trig.Opp 3.0  -- Rise  or (B2C)
Convert string to the correct data type.
     Trig.Adj =  4.0  -- Base  or (A2C)
 
    Trig.Hyp =  0.0  -- Slope or (A2B)
Local Words = NameStrip("KPSDFKSPSK - 34598923", "-") -- returns "KPSDFKSPSK"
    Trig.Slope = 0.0
 
    Trig.Area = 0.0
 
    Trig.OutRadius = 0.0
'''Source Code'''
    Trig.InRadius = 0.0
 
    Trig.Parameter =  0.0
<nowiki> function INI_NameStrip(str, var)
    TrigIt()
    if "" == str then
    DisplayMessageBox("Test 1: \n" ..
      DisplayMessageBox("Error in string")
    " Trig.A  =  " .. tostring(Trig.A) .. " \n" ..
    else
    " Trig.B  =  " .. tostring(Trig.B) .. " \n" ..
      if string.find(str, var) then
     " Trig.C  = " .. tostring(Trig.C) .. " \n" ..
        local j = assert(string.find(str, var) - 1)
    " Trig.Opp = * " .. tostring(Trig.Opp) .. " \n" ..
        return All_Trim(string.sub(str, 1, j))
    " Trig.Adj = * " .. tostring(Trig.Adj) .. " \n" ..
      else
     " Trig.Hyp = " .. tostring(Trig.Hyp) .. " \n" ..
        return str
    " Trig.Slope = " .. tostring(Trig.Slope) .. " \n" ..
      end
    " Trig.Area =  " .. tostring(Trig.Area) .. " \n" ..
    end
    " Trig.Parameter =  " .. tostring(Trig.Parameter) .. " \n" ..
  end -- function end </nowiki>
    " Trig.OutRadius =  " .. tostring(Trig.OutRadius) .. " \n" ..
----
    " Trig.InRadius = " .. tostring(Trig.InRadius) .. " \n"
 
    )
===INI_HeadStrip===
    -- =====================================================]]
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
    TrigClear()
Convert string to the correct data type.
     Trig.A  =  0.0
 
     Trig.B  =  0.0
<nowiki>
    Trig.C  = 90.0
  function INI_HeadStrip(str, var)                            -- convert string to the correct data type
    Trig.Opp =  0.0  -- Rise  or (B2C)
-- Local Words = HeadStrip("LastName23 = Smith", "=") -- returns "Smith"
    Trig.Adj =  4.0  -- Base  or (A2C)
    if "" == str then
    Trig.Hyp =  5.0  -- Slope or (A2B)
      DisplayMessageBox("Error in string")
    Trig.Slope = 0.0
    else
    Trig.Area = 0.0
      if string.find(str, var) then
    Trig.OutRadius =  0.0
        local j = assert(string.find(str, var) + 1)
    Trig.InRadius =  0.0
        return All_Trim(string.sub(str, j))
    Trig.Parameter =  0.0
      else
    TrigIt()
        return str
    DisplayMessageBox("Test 2: \n" ..
      end
    " Trig.A = " .. tostring(Trig.A) .. " \n" ..
    end
    " Trig.= " .. tostring(Trig.B) .. " \n" ..
  end -- function end </nowiki>
    " Trig.C  =  " .. tostring(Trig.C) .. " \n" ..
----
    " Trig.Opp = * " .. tostring(Trig.Opp) .. " \n" ..
 
    " Trig.Adj = * " .. tostring(Trig.Adj) .. " \n" ..
===INI_AreDupGroups===
     " Trig.Hyp =  " .. tostring(Trig.Hyp) .. " \n" ..
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
    " Trig.Slope =  " .. tostring(Trig.Slope) .. " \n" ..
Checks if there are duplicate groups.
    " Trig.Area =  " .. tostring(Trig.Area) .. " \n" ..
 
    " Trig.Parameter =  " .. tostring(Trig.Parameter) .. " \n" ..
<nowiki>function INI_AreDupGroups(xPath, xFile)
     " Trig.OutRadius =  " .. tostring(Trig.OutRadius) .. " \n" ..
    local GroupNames = {}
     " Trig.InRadius =  " .. tostring(Trig.InRadius) .. " \n"
    local CleanNames = {}
    )
    local DupGroups  = {}
    -- =====================================================]]
      GroupNames = INI_ReadGroups(xFile, aName)
    TrigClear()
      CleanNames = RemoveDups(GroupNames)
    Trig.A  =  0.0
    if TableLength(GroupNames) == TableLength(CleanNames)then
    Trig.B  =  0.0
      return true
    Trig.C  = 90.0
    else
    Trig.Opp =  3.0  -- Rise  or (B2C)
      return false
    Trig.Adj = 0.0  -- Base  or (A2C)
    end
    Trig.Hyp =  5.0  -- Slope or (A2B)
   end -- function end </nowiki>
    Trig.Slope =  0.0
----
    Trig.Area =  0.0
 
    Trig.OutRadius = 0.0
===INI_FixDupGroups===
    Trig.InRadius =  0.0
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
    Trig.Parameter =  0.0
Find and fix duplicate groups
    TrigIt()
 
    DisplayMessageBox("Test 3: \n" ..
  <nowiki>function INI_FixDupGroups(xPath, xFile)
    " Trig.A  = " .. tostring(Trig.A) .. " \n" ..
     local GroupNames = {}
     " Trig.B  =  " .. tostring(Trig.B) .. " \n" ..
     local CleanNames = {}
    " Trig.C  =  " .. tostring(Trig.C) .. " \n" ..
    local DupGroups = {}
    " Trig.Opp = * " .. tostring(Trig.Opp) .. " \n" ..
      GroupNames = INI_ReadGroups(xFile, aName)
    " Trig.Adj = " .. tostring(Trig.Adj) .. " \n" ..
     return true
    " Trig.Hyp = * " .. tostring(Trig.Hyp) .. " \n" ..
  end -- function end</nowiki>
    " Trig.Slope = " .. tostring(Trig.Slope) .. " on 12 inch \n" ..
----
    " Trig.Area = " .. tostring(Trig.Area) .. " \n" ..
 
    " Trig.Parameter = " .. tostring(Trig.Parameter) .. " \n" ..
===INI_DeleteGroup===
    " Trig.OutRadius = " .. tostring(Trig.OutRadius) .. " \n" ..
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
     " Trig.InRadius =  " .. tostring(Trig.InRadius) .. " \n"
Deletes only the first find of xGroup
     )
 
    -- =====================================================]]
  <nowiki>function INI_DeleteGroup(xPath, xFile, xGroup)
    TrigClear()
-- Deletes old ini (.bak) file
     Trig.A  = 36.86897645844
-- Copy's the .ini to a backup (.bak) new file
     Trig.B  = 0.0
-- Reads the new backup file and writes a new file to the xGroup value
    Trig.C  = 90.0
-- Stops Writing lines until next Group is found
    Trig.Opp = 3.0  -- Rise  or (B2C)
-- Writes to end of file
    Trig.Adj =  0.0  -- Base  or (A2C)
-- Call: DeleteGroup("C:\\Users\\James\\OneDrive\\Documents\\DoorGadget\\Clients\\Marcin", "ProjectList", "Boston")
    Trig.Hyp 0.0  -- Slope or (A2B)
     local OfileName = xPath .. "\\" .. xFile .. ".bak"
    Trig.Slope =  0.0
    if FileExists(OfileName) then
    Trig.Area = 0.0
      os.remove(OfileName)
    Trig.OutRadius = 0.0
    end
    Trig.InRadius = 0.0
    local NfileName = xPath .. "\\" .. xFile .. ".ini"
    Trig.Parameter =  0.0
--    os.rename(NfileName, OfileName) -- makes backup copy file
    TrigIt()
     if CopyFileFromTo(NfileName, OfileName) then
    DisplayMessageBox("Test 4: \n" ..
      local fileR  = io.open(OfileName)
     " Trig.A  = * " .. tostring(Trig.A) .. " \n" ..
      local fileW  = io.open(NfileName,  "w")
     " Trig.B  = " .. tostring(Trig.B) .. " \n" ..
      local groups  = false
     " Trig.C  = " .. tostring(Trig.C) .. " \n" ..
      local writit = true
     " Trig.Opp = * " .. tostring(Trig.Opp) .. " \n" ..
      local MyTxt  = ""
    " Trig.Adj = " .. tostring(Trig.Adj) .. " \n" ..
      local txt = ""
    " Trig.Hyp =  " .. tostring(Trig.Hyp) .. " \n" ..
      if fileR and fileW then  -- files are open
    " Trig.Slope = " .. tostring(Trig.Slope) .. " on 12 inch \n" ..
        for Line in fileR:lines() do  -- read each line of the backup file
    " Trig.Area = " .. tostring(Trig.Area) .. " \n" ..
          txt = Line -- copy line from file to txt
    " Trig.Parameter = " .. tostring(Trig.Parameter) .. " \n" ..
          if All_Trim(Line) == "[" .. All_Trim(xGroup) .. MyTxt .. "]" then  -- look for a match
    " Trig.OutRadius =  " .. tostring(Trig.OutRadius) .. " \n" ..
            groups = true
    " Trig.InRadius =  " .. tostring(Trig.InRadius) .. " \n"
            txt = ""
     )
          end -- if end
     -- =====================================================]]
          if groups and MyTxt == "" then  -- if group is true turn off the write function
    TrigClear()
            writit = false
    Trig.A  = 36.86897645844
            if "[" == string.sub(All_Trim(txt), 1, 1) then  -- turns write function on if next group is found
    Trig.B  = 0.0
              groups = false
    Trig.C = 90.0
              xGroup = "-"
    Trig.Opp =  0.0  -- Rise  or (B2C)
              writit = true
    Trig.Adj =  4.0  -- Base  or (A2C)
              MyTxt  = "--"
    Trig.Hyp =  0.0  -- Slope or (A2B)
            else
     Trig.Slope =  0.0
              writit = false
     Trig.Area = 0.0
            end -- if end
     Trig.OutRadius = 0.0
          end -- if end
    Trig.InRadius = 0.0
          if writit then
    Trig.Parameter = 0.0
            fileW:write(txt .. "\n")
     TrigIt()
            txt = ""
     DisplayMessageBox("Test 5: \n" ..
          end -- if end
    " Trig.A  = * " .. tostring(Trig.A) .. " \n" ..
        end -- for end
     " Trig.B  = " .. tostring(Trig.B) .. " \n" ..
        os.remove(OfileName)
    " Trig.= " .. tostring(Trig.C) .. " \n" ..
      end -- if end
     " Trig.Opp = " .. tostring(Trig.Opp) .. " \n" ..
      if fileR then fileR:close() end
    " Trig.Adj = * " .. tostring(Trig.Adj) .. " \n" ..
      if fileW then fileW:close() end
    " Trig.Hyp = " .. tostring(Trig.Hyp) .. " \n" ..
     end
    " Trig.Slope = " .. tostring(Trig.Slope) .. " on 12 inch \n" ..
     return true
    " Trig.Area = " .. tostring(Trig.Area) .. " \n" ..
  end -- function end</nowiki>
    " Trig.Parameter = " .. tostring(Trig.Parameter) .. " \n" ..
----
    " Trig.OutRadius =  " .. tostring(Trig.OutRadius) .. " \n" ..
 
     " Trig.InRadius = " .. tostring(Trig.InRadius) .. " \n"
===INI_RenameGroup===
     )
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
    -- =====================================================]]
Renames a group
    TrigClear()
 
    Trig.A  =  36.86897645844
  <nowiki>function INI_RenameGroup(xOldGroup, xNewGroup)
    Trig.B  = 0.0
--Deletes old ini Hardware.bak file
    Trig.C  = 90.0
--Copys the ini file to a backup copy file
     Trig.Opp =  0.0  -- Rise  or (B2C)
--Reads the backup file and writes a new ini file to the xGroup
     Trig.Adj =  0.0  -- Base  or (A2C)
--Writes new file with new group to the new ini file
    Trig.Hyp =  5.0  -- Slope or (A2B)
  local NfileName = Project.AppPath .. "\\" .. "EasyDrawerHardware" .. ".ini"
    Trig.Slope =  0.0
  local OfileName = Project.AppPath .. "\\" .. "EasyDrawerHardware" .. ".bak"
    Trig.Area =  0.0
  os.remove(OfileName)
    Trig.OutRadius =  0.0
  CopyFileFromTo(NfileName, OfileName) -- makes backup file
    Trig.InRadius =  0.0
  local fileR = io.open(OfileName)
    Trig.Parameter =  0.0
  local fileW = io.open(NfileName, "w")
    TrigIt()
  if fileR and fileW then
    DisplayMessageBox("Test 6: \n" ..
     local groups = false
    " Trig.A  = * " .. tostring(Trig.A) .. " \n" ..
    local txt = ""
    " Trig.B  =  " .. tostring(Trig.B) .. " \n" ..
    for Line in fileR:lines() do
    " Trig.C  =  " .. tostring(Trig.C) .. " \n" ..
      if All_Trim(Line) == "[" .. All_Trim(xOldGroup) .. txt .. "]" then -- Group
    " Trig.Opp =  " .. tostring(Trig.Opp) .. " \n" ..
        fileW:write(xNewGroup .. "\n")
    " Trig.Adj =  " .. tostring(Trig.Adj) .. " \n" ..
        txt = "-"
    " Trig.Hyp = * " .. tostring(Trig.Hyp) .. " \n" ..
      else
    " Trig.Slope =  " .. tostring(Trig.Slope) .. " on 12 inch \n" ..
        fileW:write(Line .. "\n")
    " Trig.Area =  " .. tostring(Trig.Area) .. " \n" ..
      end -- if end
    " Trig.Parameter =  " .. tostring(Trig.Parameter) .. " \n" ..
    end -- for end
    " Trig.OutRadius =  " .. tostring(Trig.OutRadius) .. " \n" ..
    fileR:close()
    " Trig.InRadius =  " .. tostring(Trig.InRadius) .. " \n"
     fileW:close()
    )
     os.remove(OfileName)
    TrigClear()
  end -- if end
    Trig.A  =  0.0
  return true
    Trig.B  =  0.0
end -- function end</nowiki>
    Trig.C  = 90.0
----
    Trig.Opp =  3.0  -- Rise  or (B2C)
 
    Trig.Adj =  0.0  -- Base  or (A2C)
===INI_DeleteItem===
    Trig.Hyp =  0.0  -- Slope or (A2B)
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
    Trig.Slope =  9.0
Deleates a group
    Trig.Area =  0.0
 
    Trig.OutRadius =  0.0
  <nowiki>function INI_DeleteItem(xPath, xFile, xGroup, xItem)
    Trig.InRadius =  0.0
-- Deletes old ini (.bak) file
    Trig.Parameter =  0.0
-- Copys the .ini to a backup (.bak) new file
    TrigIt()
-- Reads the new backup file and writes a new file to the xGroup value
    DisplayMessageBox("Test 7: \n" ..
-- Stops Writing lines until next Group is found
    " Trig.A  =  " .. tostring(Trig.A) .. " \n" ..
-- Writes to end of file
    " Trig.B  =  " .. tostring(Trig.B) .. " \n" ..
-- DeleteGroup("C:\\Users\\James\\OneDrive\\Documents\\DoorGadget\\Clients\\Marcin", "ProjectList", "Boston")
    " Trig.C  =  " .. tostring(Trig.C) .. " \n" ..
  local NfileName = xPath .. "\\" .. xFile .. ".ini"
    " Trig.Opp = * " .. tostring(Trig.Opp) .. " \n" ..
  local OfileName = xPath .. "\\" .. xFile .. ".bak"
    " Trig.Adj =  " .. tostring(Trig.Adj) .. " \n" ..
  os.remove(OfileName)
    " Trig.Hyp =  " .. tostring(Trig.Hyp) .. " \n" ..
  CopyFileFromTo(NfileName, OfileName) -- makes backup copy file
    " Trig.Slope = * " .. tostring(Trig.Slope) .. " on 12 inch \n" ..
  local fileR = io.open(OfileName)
    " Trig.Parameter =  " .. tostring(Trig.Parameter) .. " \n" ..
  local fileW = io.open(NfileName,  "w")
    " Trig.Area =  " .. tostring(Trig.Area) .. " \n" ..
  if fileR and fileW then
    " Trig.Parameter =  " .. tostring(Trig.Parameter) .. " \n" ..
    local groups = false
    " Trig.Circumscribing =  " .. tostring(Trig.Circumscribing) .. " \n" ..
    local writit = true
    " Trig.Inscribing =  " .. tostring(Trig.Inscribing) .. " \n"
     local txt = ""
    )
    for Line in fileR:lines() do
    -- =====================================================]]
      txt = Line
    TrigClear()
      if All_Trim(Line) == "[" .. All_Trim(xGroup) .. "]" then
    Trig.A  =  0.0
        groups = true
    Trig.B  =  0.0
      end -- if end
    Trig.C  = 90.0
      if groups then
    Trig.Opp =  0.0  -- Rise  or (B2C)
  -- ===================
    Trig.Adj =  0.0  -- Base  or (A2C)
        if xItem == string.sub(Line, 1, string.len(xItem)) then  -- Item
    Trig.Hyp =  0.0  -- Slope or (A2B)
          writit = false
    Trig.Slope =  9.0
          groups = false
    Trig.Area =  0.0
        end -- if end
    Trig.OutRadius =  0.0
      end -- if end
    Trig.InRadius =  0.0
  -- ===================
    Trig.Parameter =  0.0
      if writit then
    TrigIt()
        fileW:write(txt .. "\n")
    DisplayMessageBox("Test Error: \n" ..
      end -- if end
      " Trig.A  =  " .. tostring(Trig.A) .. " \n" ..
      writit = true
      " Trig.B  =  " .. tostring(Trig.B) .. " \n" ..
    end -- for end
      " Trig.C  =  " .. tostring(Trig.C) .. " \n" ..
    os.remove(OfileName)
      " Trig.Opp = * " .. tostring(Trig.Opp) .. " \n" ..
     fileR:close()
      " Trig.Adj =  " .. tostring(Trig.Adj) .. " \n" ..
     fileW:close()
      " Trig.Hyp =  " .. tostring(Trig.Hyp) .. " \n" ..
  end -- if end
      " Trig.Slope = * " .. tostring(Trig.Slope) .. " on 12 inch \n" ..
  return true
      " Trig.Parameter =  " .. tostring(Trig.Parameter) .. " \n" ..
end -- function end</nowiki>
      " Trig.Area =  " .. tostring(Trig.Area) .. " \n" ..
----
      " Trig.Parameter =  " .. tostring(Trig.Parameter) .. " \n" ..
 
      " Trig.Circumscribing =  " .. tostring(Trig.Circumscribing) .. " \n" ..
===INI_ValidateGroup===
      " Trig.Inscribing =  " .. tostring(Trig.Inscribing) .. " \n"
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
    )
Reads INI file and returns true if group is found
    return true
 
  end -- function end --
  <nowiki>function INI_ValidateGroup(xFile, xGroup)
-- =====================================================]]
  -- Reads INI file and returns true if the group is found
  function TrigClear()  -- Clears and resets Trig Table
  local fileR = io.open(xFile)
    Trig.A  =  0.0
  local group = false
    Trig.B  =  0.0
  for Line in fileR:lines() do
    Trig.C  = 90.0
    if string.upper(All_Trim(Line)) == "[" .. string.upper(All_Trim(xGroup)) .. "]" then  -- Group
    Trig.Opp =  0.0  -- Rise  or (B2C)
    group = true
    Trig.Adj =  0.0  -- Base  or (A2C)
    break
    Trig.Hyp =  0.0  -- Slope or (A2B)
    end -- if end
    Trig.Slope =  0.0
  end -- for end
    return true
  fileR:close()
  end -- function end
  return group
-- =====================================================]]
end -- function end</nowiki>
      local function BSA()
----
        Trig.B  = (Trig.C - Trig.A)
 
        Trig.Slope = math.tan(math.rad(Trig.A)) * 12.0
===INI_ValidateItem===
        Trig.Area =  (Trig.Opp * Trig.Adj) * 0.5
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
        Trig.Inscribing = ((Trig.Opp + Trig.Adj) - Trig.Hyp) * 0.5
Reads INI file and returns true if group and item is found
        Trig.Circumscribing =  Trig.Hyp * 0.5
 
        Trig.Parameter = Trig.Opp + Trig.Adj + Trig.Hyp
  <nowiki>function INI_ValidateItem(xFile, xGroup, xItem)
      end
     local fileR = io.open(xFile)
      if Trig.A == 0.0 and Trig.B > 0.0 and Trig.Slope == 0.0 then
     if fileR then
        Trig.A = Trig.C - Trig.B
      local group = false
      elseif Trig.A == 0.0 and Trig.B == 0.0 and Trig.Slope > 0.0 then
      local item = false
        Trig.A = math.deg(math.atan(Trig.Slope / 12.0))
      local ItemLen = string.len(xItem)
      end -- if end
      for Line in fileR:lines() do
-- test 4
        if All_Trim(Line) == "[" .. string.upper(All_Trim(xGroup)) .. "]" then -- Group
      if (Trig.A > 0.0) and (Trig.Opp >  0.0) then -- A and Rise or (B2C)
        group = true
        Trig.Adj =  Trig.Opp / (math.tan(math.rad(Trig.A)))
        end -- if end
        Trig.Hyp = math.sqrt((Trig.Opp * Trig.Opp ) + ( Trig.Adj * Trig.Adj))
        if group then
        BSA()
          if string.upper(xItem) == string.upper(string.sub(Line, 1, string.len(xItem)))  then  -- Item
        return true
            item = true
      -- test 6
            break
      elseif (Trig.A > 0.0) and (Trig.Hyp >  0.0)  then -- A and Slope or (A2B)
          end -- if end
        Trig.Adj = math.cos(math.rad(Trig.A)) * Trig.Hyp
        end -- if end
        Trig.Opp = math.sqrt((Trig.Hyp * Trig.Hyp ) - ( Trig.Adj * Trig.Adj))
      end -- for end
        BSA()
      fileR:close()
        return true
     end -- if end
      -- test 5
     return group
      elseif (Trig.A > 0.0) and (Trig.Adj >  0.0)  then -- A and Base or (A2C)
  end -- function end</nowiki>
        Trig.Opp = math.tan(math.rad(Trig.A)) * Trig.Adj
----
        Trig.Hyp = math.sqrt((Trig.Opp * Trig.Opp ) + ( Trig.Adj * Trig.Adj))
 
        BSA()
===INI_StrValue===
        return true
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
        -- test 1
Reads INI file and returns string value
      elseif (Trig.Opp >  0.0) and (Trig.Adj >  0.0) then -- Rise and Base
 
        Trig.Hyp = math.sqrt((Trig.Opp * Trig.Opp ) + ( Trig.Adj * Trig.Adj))
  <nowiki>function INI_StrValue(str, ty)
        Trig.A  = math.deg(math.atan(Trig.Opp / Trig.Adj))
-- Convert string to the correct data type
        BSA()
     if nil == str then
        return true
      DisplayMessageBox("Error in Ini file - looking for a " .. ty .. " value")
      elseif (Trig.Adj >  0.0) and (Trig.Hyp >  0.0) then -- Rise and Slope
     else
-- test 2
      if "" == All_Trim(str) then
        Trig.Opp = math.sqrt((Trig.Hyp * Trig.Hyp ) - ( Trig.Adj * Trig.Adj))
        DisplayMessageBox("Error in Ini file - looking for a " .. ty .. " value")
        Trig.A  = math.deg(math.atan(Trig.Opp / Trig.Adj))
      else
        BSA()
        local j = (string.find(str, "=") + 1)
        return true
        if ty == "D" then -- Double
      elseif (Trig.Opp >  0.0) and (Trig.Hyp >  0.0) then -- Base and Slope
          return tonumber(string.sub(str, j))
-- test 3
        end -- if end
        Trig.Adj = math.sqrt((Trig.Hyp * Trig.Hyp ) - ( Trig.Opp * Trig.Opp))
        if ty == "I" then  -- Intiger
        Trig.A  = math.deg(math.atan(Trig.Opp / Trig.Adj))
          return math.floor(tonumber(string.sub(str, j)))
        BSA()
        end -- if end
        return true
        if ty == "S" then -- String
      else
          return All_Trim(string.sub(str, j))
        DisplayMessageBox("Error: Trig Values did not match requirements: \n" ..
        end -- if end
                          " Trig.A  =  " .. tostring(Trig.A) .. " \n" ..
        if ty == "B" then  -- Bool
                          " Trig.B  =  " .. tostring(Trig.B) .. " \n" ..
          if "TRUE" == All_Trim(string.sub(str, j)) then
                          " Trig.C  =  " .. tostring(Trig.C) .. " \n" ..
            return true
                          " Trig.Opp =  " .. tostring(Trig.Opp) .. " \n" ..
          else
                          " Trig.Adj =  " .. tostring(Trig.Adj) .. " \n" ..
            return false
                          " Trig.Hyp =  " .. tostring(Trig.Hyp) .. " \n" ..
          end -- if end
                          " Trig.Slope =  " .. tostring(Trig.Slope) .. " on 12 inch \n" ..
        end -- if end
                          " Trig.Area =  " .. tostring(Trig.Area) .. " \n" ..
      end -- if end
                          " Trig.Parameter =  " .. tostring(Trig.Parameter) .. " \n" ..
     end -- if end
                          " Trig.OutRadius =  " .. tostring(Trig.OutRadius) .. " \n" ..
     return nil
                          " Trig.InRadius =  " .. tostring(Trig.InRadius) .. " \n"
  end -- function end</nowiki>
                          )
----
        return false
 
      end
===INI_GetValue===
    end -- function end
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
-- =====================================================]]
Reads INI file and returns value
end -- Geometry Tools end
 
  <nowiki>function INI_GetValue(xPath, FileName, GroupName, ItemName, ValueType)
    -- ==INI_GetValue(xPath, FileName, GroupName, ItemName, ValueType)==
    -- Returns a value from a file, group, and Item
    -- Usage: XX.YY = GetIniValue("C:/temp", "ScrewDia", "[Screws]", "Diameter", "D")
    local filenameR = xPath .. "\\" .. FileName .. ".ini"
    local FL = LengthOfFile(filenameR)
    local file = io.open(filenameR, "r")
    local dat = "."
    local ItemNameLen = string.len(ItemName)
    if file then
      while (FL >= 1) do
        dat = string.upper(All_Trim(file:read()))
        if dat == "[" .. string.upper(GroupName) .. "]" then
          break
        else
          FL = FL - 1
        end -- if end
      end -- while end
      while (FL >= 1) do
        dat = string.upper(All_Trim(file:read()))
        if string.upper(ItemName) == string.sub(dat, 1, ItemNameLen) then
          break
        else
          FL = FL - 1
          if FL == 0 then
            dat = "Error - item not found"
            break
          end -- if end
        end -- if end
      end -- while end
      file:close()-- closes the open file
     end -- if end
     local XX = StrIniValue(dat, ValueType)
     return XX
  end -- function end</nowiki>
----
 
===INI_GetIDFor===
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
Reads INI file and returns ID for a value
 
  <nowiki>function INI_GetIDFor(xPath, FileName, GroupName, ItemValue)
     -- == INI_GetIDFor(xPath, FileName, GroupName, ItemValue) ==
     -- Returns a ItemID from a file, group, and ItemValue
    -- Usage: XX.YY = INI_GetIDFor("C:/temp", "UserList", "[Users]", "Anderson")
    -- returns: "UserLastName22"
     local filenameR = xPath .. "\\" .. FileName .. ".ini"
    local FL = LengthOfFile(filenameR)
    local file = io.open(filenameR, "r")
     if file then
      local dat = "."
      local ItemValueLen = string.len(ItemValue)
      while (FL >= 1) do
        dat = string.upper(All_Trim(file:read()))
        if dat == "[" .. string.upper(GroupName) .. "]" then
          break
        else
          FL = FL - 1
        end -- if end
      end -- while end
      while (FL >= 1) do
        dat = string.upper(All_Trim(file:read()))
        if string.upper(ItemValue) == HeadStrip(dat, "=") then
          break
        else
          FL = FL - 1
          if FL == 0 then
            dat = "Error - item not found"
            break
          end -- if end
        end -- if end
      end -- while end
      file:close()-- closes the open file
    end -- if end
     local XX = NameStrip(dat, "=")
     return XX
  end -- function end</nowiki>
----
 
===INI_ReadGroups===
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
Reads INI file group and returns true if found
 
  <nowiki>function INI_ReadGroups(xFile, aName)
  --[[Reads INI and returns a list contain the [Headers] as Array
  IniFile = {} Global variables
  xPath = script_path
  ]]
    local filename = xFile
    local file = io.open(filename, "r")
    if file then
      local fLength = (LengthOfFile(filename) - 1)
      local dat = All_Trim(file:read())
      while (fLength >= 1) do
        if "[" == string.sub(dat, 1, 1) then
          table.insert (aName, string.sub(dat, 2, -2))
        end
        dat = file:read()
        if dat then
          dat = All_Trim(dat)
        else
          file:close()-- closes the open file
          return true
        end
        fLength = fLength - 1
      end -- while
     end -- if
    if file then file:close() end
     return true
  end -- function end</nowiki>
----


</nowiki>
===INI_ProjectHeaderReader===
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
Reads INI file group and returns the INI Header values of a ini file and uploads to "IniFile" Array


This object is a name-value pair that represents a Document Variable within a [[VectricJob]].
  <nowiki>function INI_ProjectHeaderReader(xPath)
 
    local filename = xPath .. "/CabinetProjects.ini"
<nowiki>  
    local file = io.open(filename, "r")
     if file then
-- =====================================================]]
       local Cabing = (LengthOfFile(filename) - 1)
╦╔╗╔╦  ╔═╗╦╦  ╔═╗  ╔╦╗╔═╗╔═╗╦  ╔═╗
      local dat = All_Trim(file:read())
║║║║║  ╠╣ ║║  ║╣    ║ ║ ║║ ║║  ╚═╗
       while (Cabing >= 1) do
╩╝╚╝╩  ╚  ╩╩═╝╚═╝  ╩ ╚═╝╚═╝╩═╝╚═╝
         if "[" == string.sub(dat, 1, 1) then
function INITools()
          table.insert (Projects, string.sub(dat, 2, -2))
  -- =====================================================]]
        end
  function NameStrip(str, var)                            -- convert string to the correct data type
        dat = file:read()
-- Local Words = NameStrip("KPSDFKSPSK - 34598923", "-") -- returns "KPSDFKSPSK"
        if dat then
     if "" == str then
          dat = All_Trim(dat)
       DisplayMessageBox("Error in string")
        else
    else
          return true
       if string.find(str, var) then
        end
         local j = assert(string.find(str, var) - 1)
         Cabing = Cabing - 1
        return All_Trim(string.sub(str, 1, j))
      else
         return str
       end
       end
      file:close()
     end
     end
   end -- function end
    return true
  -- =====================================================]]
   end -- function end</nowiki>
  function HeadStrip(str, var)                           -- convert string to the correct data type
----
-- Local Words = HeadStrip("LastName23 = Smith", "=") -- returns "Smith"
 
    if "" == str then
===INI_AddNewProject===
      DisplayMessageBox("Error in string")
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
    else
Appends a New Project to CabinetProjectQuestion.ini
      if string.find(str, var) then
 
        local j = assert(string.find(str, var) + 1)
  <nowiki>function INI_AddNewProject(xPath, xGroup)
        return All_Trim(string.sub(str, j))
    local filename = xPath .. "/ProjectList.ini"
      else
    local file = io.open(filename, "a")
        return str
    if file then
      end
      file:write("[" .. All_Trim(xGroup) .. "] \n")
      file:write("load_date = " .. StartDate(true) .. " \n")
      file:write("#====================================== \n")
      file:close()-- closes the open file
     end
     end
   end -- function end
    return true
  -- =====================================================]]
   end -- function end</nowiki>
   function INI_AreDupGroups(xPath, xFile)                 -- Are there duplicate groups
----
     local GroupNames = {}
 
     local CleanNames = {}
===INI_StdHeaderReader===
     local DupGroups  = {}
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
       GroupNames = INI_ReadGroups(xFile, aName)
Gets the INI Header values of a ini file and uploads to "IniFile" Array
       CleanNames = RemoveDups(GroupNames)
 
    if TableLength(GroupNames) == TableLength(CleanNames)then
   <nowiki>function INI_StdHeaderReader(xPath, Fname)
      return true
     local filename = xPath .. "\\" .. Fname .. ".ini"
    else
     local file = io.open(filename, "r")
       return false
     if file then
      local WallMilling = (LengthOfFile(filename) - 1)
       local dat = All_Trim(file:read())
       while (WallMilling >= 0) do
        if "[" == string.sub(dat, 1, 1) then
          table.insert (IniFile, string.sub(dat, 2, -2))
        end -- if end
        dat = file:read()
        if dat then
          dat = All_Trim(dat)
        else
          return true
        end -- if end
        WallMilling = WallMilling - 1
      end -- while end
       file:close()
     end
     end
   end -- function end
    return true
   end -- function end</nowiki>
----
 
===INI_ReadProjectinfo===
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
Reads an ini files group and sets the table.names


   -- =====================================================]]
   <nowiki>function INI_ReadProjectinfo(Table, xPath, xGroup, xFile)
  function INI_FixDupGroups(xPath, xFile)                 -- Find and fix duplicate groups
    Table.ProjectContactEmail      = GetIniValue(xPath, xFile, xGroup, "ProjectQuestion.ProjectContactEmail", "S")
     local GroupNames = {}
    Table.ProjectContactName        = GetIniValue(xPath, xFile, xGroup, "ProjectQuestion.ProjectContactName", "S")
     local CleanNames = {}
     Table.ProjectContactPhoneNumber = GetIniValue(xPath, xFile, xGroup, "ProjectQuestion.ProjectContactPhoneNumber", "S")
     local DupGroups  = {}
     Table.ProjectName              = GetIniValue(xPath, xFile, xGroup, "ProjectQuestion.ProjectName", "S")
      GroupNames = INI_ReadGroups(xFile, aName)
     Table.ProjectPath              = GetIniValue(xPath, xFile, xGroup, "ProjectQuestion.ProjectPath", "S")
    Table.StartDate                = GetIniValue(xPath, xFile, xGroup, "ProjectQuestion.StartDate", "S")
     return true
     return true
   end -- function end
   end -- function end</nowiki>
----


  -- =====================================================]]
===INI_UpdateItem===
  function INI_DeleteGroup(xPath, xFile, xGroup)          -- Deletes only the first find of xGroup
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
-- Deletes old ini (.bak) file
Deletes old ini (.bak) file
-- Copy's the .ini to a backup (.bak) new file
 
-- Reads the new backup file and writes a new file to the xGroup value
Copys the .ini to a backup (.bak) new file
-- Stops Writing lines until next Group is found
 
-- Writes to end of file
Reads the new backup file and writes a new file to the xGroup
-- Call: DeleteGroup("C:\\Users\\James\\OneDrive\\Documents\\DoorGadget\\Clients\\Marcin", "ProjectList", "Boston")
 
Writes new xValue for the for the xItem
 
Reads and writes a new file to end of file
 
  <nowiki>function INI_UpdateItem(xPath, xFile, xGroup, xItem, xValue)
    local NfileName = xPath .. "\\" .. xFile .. ".ini"
     local OfileName = xPath .. "\\" .. xFile .. ".bak"
     local OfileName = xPath .. "\\" .. xFile .. ".bak"
     if FileExists(OfileName) then
     os.remove(OfileName)
      os.remove(OfileName)
     if CopyFileFromTo(NfileName, OfileName) then-- makes backup file
     end
       local fileR = io.open(OfileName)
    local NfileName = xPath .. "\\" .. xFile .. ".ini"
       local fileW = io.open(NfileName,  "w")
--    os.rename(NfileName, OfileName) -- makes backup copy file
       if fileR and fileW then
    if CopyFileFromTo(NfileName, OfileName) then
        local groups = false
       local fileR   = io.open(OfileName)
        local txt = ""
       local fileW   = io.open(NfileName,  "w")
         for Line in fileR:lines() do
       local groups = false
           txt = Line
      local writit  = true
           if All_Trim(Line) == "[" .. All_Trim(xGroup) .. "]" then -- Group
      local MyTxt  = ""
      local txt = ""
      if fileR and fileW then  -- files are open
         for Line in fileR:lines() do -- read each line of the backup file
           txt = Line -- copy line from file to txt
           if All_Trim(Line) == "[" .. All_Trim(xGroup) ..  MyTxt .. "]" then -- look for a match
             groups = true
             groups = true
            txt = ""
           end -- if end
           end -- if end
           if groups and MyTxt == "" then  -- if group is true turn off the write function
           if xItem == string.sub(Line, 1, string.len(xItem)) then  -- Item
            writit = false
            if groups then
            if "[" == string.sub(All_Trim(txt), 1, 1) then  -- turns write function on if next group is found
              txt = xItem .. " = " .. xValue
               groups = false
               groups = false
              xGroup = "-"
              writit = true
              MyTxt  = "--"
            else
              writit = false
             end -- if end
             end -- if end
           end -- if end
           end -- if end
           if writit then
           fileW:write(txt .. "\n")
            fileW:write(txt .. "\n")
          txt = ""
            txt = ""
          end -- if end
         end -- for end
         end -- for end
         os.remove(OfileName)
         os.remove(OfileName)
      end -- if end
        fileR:close()
      if fileR then fileR:close() end
        fileW:close()
      if fileW then fileW:close() end
      end
     end
     end
     return true
     return true
   end -- function end
   end -- function end</nowiki>
----
 
===INI_ReadProject===
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
Reads the ini file for project data
 
  <nowiki>function INI_ReadProject(xPath, xFile, xGroup)
  -- Milling = {}
    Milling.LayerNameBackPocket          = GetIniValue(xPath, xFile, xGroup, "Milling.LayerNameBackPocket", "S")
    Milling.LayerNameTopBottomCenterDado = GetIniValue(xPath, xFile, xGroup, "Milling.LayerNameTopBottomCenterDado", "S")
    Milling.LayerNameDrawNotes          = GetIniValue(xPath, xFile, xGroup, "Milling.LayerNameDrawNotes", "S")
    Milling.LayerNameDrawFaceFrame      = GetIniValue(xPath, xFile, xGroup, "Milling.LayerNameDrawFaceFrame", "S")
    Milling.BackPocketDepthWall          = GetIniValue(xPath, xFile, xGroup, "Milling.BackPocketDepthWall", "N")
    Milling.BlindDadoSetbackWall        = GetIniValue(xPath, xFile, xGroup, "Milling.BlindDadoSetbackWall", "N")
    Milling.CabDepthWall                = GetIniValue(xPath, xFile, xGroup, "Milling.CabDepthWall", "N")
    return true
  end -- function end</nowiki>
----
 
===INI_TestDeleteDups===
[[File:TopOfPage.png|right|30px|link=JimAndi Toolbox]]
Reads the ini file for dups and deletes


   -- =====================================================]]
   <nowiki>function INI_TestDeleteDups()
  function INI_RenameGroup(xOldGroup, xNewGroup)         -- Renames a group
    --[[ Requires 3 global variables
--Deletes old ini Hardware.bak file
    clean  = {}
--Copys the ini file to a backup copy file
    dups  = {}
--Reads the backup file and writes a new ini file to the xGroup
    Names = {}
--Writes new file with new group to the new ini file
    ]]
  local NfileName = Project.AppPath .. "\\" .. "EasyDrawerHardware" .. ".ini"
    local myPath = "C:\\Users\\CNC\\Documents\\test"
  local OfileName = Project.AppPath .. "\\" .. "EasyDrawerHardware" .. ".bak"
    local myName = "Tester"
  os.remove(OfileName)
    local myfile = "C:\\Users\\CNC\\Documents\\test\\Tester.ini"
  CopyFileFromTo(NfileName, OfileName) -- makes backup file
    INI_ReadGroups(myfile, Names)
   local fileR = io.open(OfileName)
    FindDups(Names, dups, clean)
   local fileW = io.open(NfileName, "w")
    for i,v in ipairs(dups) do
   if fileR and fileW then
      INI_DeleteGroup(myPath, myName, v)
    local groups = false
    end
    local txt = ""
    return true
end -- function end</nowiki>
 
==Data Import Tools==
[[File:Back.jpg|right|50px|link=Vectric Lua Interface for Gadgets]]
This object is used to import data to a gadget.
 
===Read_CSV===
Reads a CSV file based on header and format (Requires modifications per usage)
<nowiki> function Read_CSV(xFile, Header)
  --Read_CSV(Door.CSVFile, true)
   local fileR = io.open(xFile)
   local xLine = ""
  local result = {}
   if fileR then
     for Line in fileR:lines() do
     for Line in fileR:lines() do
       if All_Trim(Line) == "[" .. All_Trim(xOldGroup) .. txt .. "]" then -- Group
      xLine = Line
        fileW:write(xNewGroup .. "\n")
       if Header then
         txt = "-"
         Header = false
       else
       else
         fileW:write(Line .. "\n")
         xLine = All_Trim(Line)
      end -- if end
        for match in (xLine..","):gmatch("(.-)"..",") do
    end -- for end
          table.insert(result, match)
    fileR:close()
        end -- for end
    fileW:close()
        Door.Count    = tonumber(result[1])
     os.remove(OfileName)
        Door.Height    = tonumber(result[2])
   end -- if end
        Door.Width    = tonumber(result[3])
 
        result = {}
        while Door.Count > 0 do
          if      Door.Style == StyleA.Name then
            DoorStyleA()
          elseif  Door.Style == StyleB.Name then
            DoorStyleB()
          elseif  Door.Style == StyleC.Name then
            DoorStyleC()
          elseif  Door.Style == StyleE.Name then
            DoorStyleE()
          elseif  Door.Style == StyleF.Name then
            DoorStyleF()
          elseif  Door.Style == StyleG.Name then
            DoorStyleG()
          else
            DisplayMessageBox("No Style Select!")
          end --if end
          Door.Count =  Door.Count - 1
        end -- for end
      end --if end
      Door.Record = Door.Record + 1
      MyProgressBar:SetPercentProgress(ProgressAmount(Door.Record))
     end --for end
   end --if end
   return true
   return true
end -- function end
end -- function end </nowiki>
----
 
==Job Tools==
[[File:Back.jpg|right|50px|link=Vectric Lua Interface for Gadgets]]
This object is a name-value pair that represents a Document Variable within a [[VectricJob]].


  -- =====================================================]]
<nowiki>function ValidJob()
  function INI_DeleteItem(xPath, xFile, xGroup, xItem)
  -- A better error message
-- Deletes old ini (.bak) file
    local job = VectricJob()
-- Copys the .ini to a backup (.bak) new file
    if not job.Exists then
-- Reads the new backup file and writes a new file to the xGroup value
      DisplayMessageBox("Error: Cannot run Gadget, no drawing found \n" ..
-- Stops Writing lines until next Group is found
                        "Please create a new file (drawing) and \n" ..
-- Writes to end of file
                        "specify the material dimensions \n"
-- DeleteGroup("C:\\Users\\James\\OneDrive\\Documents\\DoorGadget\\Clients\\Marcin", "ProjectList", "Boston")
      )
  local NfileName = xPath .. "\\" .. xFile .. ".ini"
      return false
  local OfileName = xPath .. "\\" .. xFile .. ".bak"
     else
  os.remove(OfileName)
       return true
  CopyFileFromTo(NfileName, OfileName) -- makes backup copy file
    end  -- if end
  local fileR = io.open(OfileName)
   end -- ValidJob end
  local fileW = io.open(NfileName,  "w")
</nowiki>
  if fileR and fileW then
 
    local groups = false
----
     local writit = true
    local txt = ""
    for Line in fileR:lines() do
       txt = Line
      if All_Trim(Line) == "[" .. All_Trim(xGroup) .. "]" then
        groups = true
      end -- if end
      if groups then
  -- ===================
        if xItem == string.sub(Line, 1, string.len(xItem))  then -- Item
          writit = false
          groups = false
        end -- if end
      end -- if end
   -- ===================
      if writit then
        fileW:write(txt .. "\n")
      end -- if end
      writit = true
    end -- for end
    os.remove(OfileName)
    fileR:close()
    fileW:close()
  end -- if end
  return true
end -- function end


-- =======================================================]]
===MoveSetectedVectors===
  function INI_ValidateGroup(xFile, xGroup)               -- Reads INI file and returns true if group is found
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
  -- Reads INI file and returns true if the group is found
<nowiki>function MoveSetectedVectors(job, NewBasePoint)
  local fileR = io.open(xFile)
    local Selection = job.Selection
  local group = false
     if Selection.IsEmpty then
  for Line in fileR:lines() do
      MessageBox("LayoutImportedVectors: No vectors selected!")
     if string.upper(All_Trim(Line)) == "[" .. string.upper(All_Trim(xGroup)) .. "]" then  -- Group
      return false
    group = true
     end
    break
     local MySelection = Selection:GetBoundingBox();
     end -- if end
     if not NewBasePoint then
  end -- for end
       NewBasePoint = Point2D(0,0)
  fileR:close()
    end
  return group
    local MyNewLocatioin = BasePoint - MySelection.BLC
end -- function end
    local Txform = TranslationMatrix2D(MyNewLocatioin)
-- =======================================================]]
    Selection:Transform(Txform)
  function INI_ValidateItem(xFile, xGroup, xItem)        -- Reads INI file and returns true if group and item is found
     return true
     local fileR = io.open(xFile)
   end </nowiki>
     if fileR then
----
       local group = false
      local item = false
      local ItemLen = string.len(xItem)
      for Line in fileR:lines() do
        if All_Trim(Line) == "[" .. string.upper(All_Trim(xGroup)) .. "]" then  -- Group
        group = true
        end -- if end
        if group then
          if string.upper(xItem) == string.upper(string.sub(Line, 1, string.len(xItem)))  then  -- Item
            item = true
            break
          end -- if end
        end -- if end
      end -- for end
      fileR:close()
    end -- if end
     return group
   end -- function end


  -- =====================================================]]
===FixPath===
   function INI_StrValue(str, ty)
   <nowiki>function FixPath(path)                               -- Lua Returns a fixed path
-- Convert string to the correct data type
     return path:gsub("%\\", "/")
    if nil == str then
      DisplayMessageBox("Error in Ini file - looking for a " .. ty .. " value")
     else
      if "" == All_Trim(str) then
        DisplayMessageBox("Error in Ini file - looking for a " .. ty .. " value")
      else
        local j = (string.find(str, "=") + 1)
        if ty == "D" then -- Double
          return tonumber(string.sub(str, j))
        end -- if end
        if ty == "I" then  -- Intiger
          return math.floor(tonumber(string.sub(str, j)))
        end -- if end
        if ty == "S" then  -- String
          return All_Trim(string.sub(str, j))
        end -- if end
        if ty == "B" then  -- Bool
          if "TRUE" == All_Trim(string.sub(str, j)) then
            return true
          else
            return false
          end -- if end
        end -- if end
      end -- if end
    end -- if end
    return nil
   end -- function end
   end -- function end


  -- =====================================================]]
----
   function INI_GetValue(xPath, FileName, GroupName, ItemName, ValueType)
 
    -- ==INI_GetValue(xPath, FileName, GroupName, ItemName, ValueType)==
   function FixPath(myPath) {                            -- JavaScript Tool Returns a fixed path
    -- Returns a value from a file, group, and Item
     /* myPath  = "C:\\User\\Bob\\Home\\Drawings"; */
     -- Usage: XX.YY = GetIniValue("C:/temp", "ScrewDia", "[Screws]", "Diameter", "D")
     /* NewPath = "C:/User/Bob/Home/Drawings"; */
     local filenameR = xPath .. "\\" .. FileName .. ".ini"
     var NewPath = "";
    local FL = LengthOfFile(filenameR)
     var myLetter = "";
     local file = io.open(filenameR, "r")
     var CheckPathLen = myPath.length;
     local dat = "."
     for (let i = 0; i < myPath.length; i++) {
     local ItemNameLen = string.len(ItemName)
      myLetter = myPath.charAt(i)
     if file then
      if myLetter.charCodeAt(0) == 92 {
      while (FL >= 1) do
        NewPath = NewPath + "/";
        dat = string.upper(All_Trim(file:read()))
      } else {
        if dat == "[" .. string.upper(GroupName) .. "]" then
         NewPath = NewPath + myLetter;
          break
      }
         else
    }
          FL = FL - 1
    return NewPath;
        end -- if end
  }</nowiki>
      end -- while end
 
      while (FL >= 1) do
----
        dat = string.upper(All_Trim(file:read()))
 
        if string.upper(ItemName) == string.sub(dat, 1, ItemNameLen) then
===RotateSetectedVectors===
          break
 
        else
  <nowiki>function RotateSetectedVectors(job, NewBasePoint, NewAngle)
          FL = FL - 1
    local Selection = job.Selection
          if FL == 0 then
    if not NewBasePoint then
            dat = "Error - item not  found"
      NewBasePoint = Point2D(0,0)
            break
          end -- if end
        end -- if end
      end -- while end
      file:close()-- closes the open file
     end -- if end
     end -- if end
    local XX = StrIniValue(dat, ValueType)
     if not NewAngle then
    return XX
       NewAngle = 0.0
  end -- function end
    end -- if end
 
    if Selection.IsEmpty then
  -- =====================================================]]
      MessageBox("Error: Rotation function: No vectors selected!")
  function INI_GetIDFor(xPath, FileName, GroupName, ItemValue)
       return false
    -- == INI_GetIDFor(xPath, FileName, GroupName, ItemValue) ==
    -- Returns a ItemID from a file, group, and ItemValue
    -- Usage: XX.YY = INI_GetIDFor("C:/temp", "UserList", "[Users]", "Anderson")
    -- returns: "UserLastName22"
    local filenameR = xPath .. "\\" .. FileName .. ".ini"
    local FL = LengthOfFile(filenameR)
    local file = io.open(filenameR, "r")
     if file then
       local dat = "."
      local ItemValueLen = string.len(ItemValue)
      while (FL >= 1) do
        dat = string.upper(All_Trim(file:read()))
        if dat == "[" .. string.upper(GroupName) .. "]" then
          break
        else
          FL = FL - 1
        end -- if end
      end -- while end
      while (FL >= 1) do
        dat = string.upper(All_Trim(file:read()))
        if string.upper(ItemValue) == HeadStrip(dat, "=")  then
          break
        else
          FL = FL - 1
          if FL == 0 then
            dat = "Error - item not  found"
            break
          end -- if end
        end -- if end
       end -- while end
      file:close()-- closes the open file
     end -- if end
     end -- if end
     local XX = NameStrip(dat, "=")
     local MySelection = Selection:GetBoundingBox();
     return XX
    local MyNewLocatioin = BasePoint - MySelection.BLC
   end -- function end
    local Txform = RotationMatrix2D(NewBasePoint, NewAngle)
    Selection:Transform(Txform)
     return true
   end </nowiki>
 
----


  -- =====================================================]]
===GetUnits===
  function INI_ReadGroups(xFile, aName)
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
  --[[Reads INI and returns a list contain the [Headers] as Array
<nowiki>function GetUnits(UTable)                               -- returns Drawing Units data
  IniFile = {} Global variables
     local mtl_block = MaterialBlock()
  xPath = script_path
     if mtl_block.InMM then
  ]]
       UTable.Units  = "Drawing Units: mm"
    local filename = xFile
       UTable.Unit = true
     local file = io.open(filename, "r")
       UTable.UnitCheck = {"metric", "kilometer", "kilometers", "kh", "meter", "meters", "m", "decimeter", "decimeters", "dm", "centimeter", "centimeters", "cm", "millimeter", "millimeters", "mm"}
     if file then
      UTable.Cal = 25.4
       local fLength = (LengthOfFile(filename) - 1)
    else
       local dat = All_Trim(file:read())
      UTable.Units  = "Drawing Units: inches"
       while (fLength >= 1) do
      UTable.Unit = false
        if "[" == string.sub(dat, 1, 1) then
      UTable.UnitCheck = {"imperial", "miles", "mile", "mi", "yards", "yard", "yd", "feet", "foot", "ft", "inches", "inch", "in", "fractions", "fraction"}
          table.insert (aName, string.sub(dat, 2, -2))
      UTable.Cal = 1.0
        end
     end
        dat = file:read()
        if dat then
          dat = All_Trim(dat)
        else
          file:close()-- closes the open file
          return true
        end
        fLength = fLength - 1
      end -- while
     end -- if
    if file then file:close() end
     return true
     return true
   end
   end -- end function</nowiki>
 
----


  -- =====================================================]]
===CheckTheUnits===
  function INI_ProjectHeaderReader(xPath)
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
  -- ==ProjectHeaderReader(xPath)==
<nowiki>function CheckTheUnits(UTable, Value)                     -- Checks if the unit of messure in of drawing units
  -- Gets the INI Header values of a ini file and uploads to "IniFile" Array
   local goodtogo = false
  --[[
   for i=1, #UTable.UnitCheck  do
  Gets the INI Header values of a ini file and uploads to "IniFile" Array
     if string.upper(Value) == string.upper(UTable.UnitCheck[i]) then
   IniFile = {} Global variables
      goodtogo = true
   xPath = script_path
      break
  ]]
    end -- if end
    local filename = xPath .. "/CabinetProjects.ini"
  end -- for end
     local file = io.open(filename, "r")
  if goodtogo then
    if file then
      local Cabing = (LengthOfFile(filename) - 1)
      local dat = All_Trim(file:read())
      while (Cabing >= 1) do
        if "[" == string.sub(dat, 1, 1) then
          table.insert (Projects, string.sub(dat, 2, -2))
        end
        dat = file:read()
        if dat then
          dat = All_Trim(dat)
        else
          return true
        end
        Cabing = Cabing - 1
      end
      file:close()
    end
     return true
     return true
   end -- function end
  else
    return false
   end -- if end
end -- function end</nowiki>


----


  -- =====================================================]]
===GetMatlBlk===
  function INI_AddNewProject(xPath, xGroup)
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
  -- Appends a New Project to CabinetProjectQuestion.ini
<nowiki>function GetMatlBlk(Table)
  -- ==AddNewProject(xPath)==
     local mtl_block = MaterialBlock()
  -- Appends a New Project to CabinetProjectQuestion.ini
     if mtl_block.InMM then
     local filename = xPath .. "/ProjectList.ini"
       Table.Units = "Drawing Units: mm"
    local file = io.open(filename, "a")
       Table.Unit = true
     if file then
    else
       file:write("[" .. All_Trim(xGroup) .. "] \n")
      Table.Units = "Drawing Units: inches"
       file:write("load_date = " .. StartDate(true) .. " \n")
       Table.Unit = false
       file:write("#====================================== \n")
      file:close()-- closes the open file
     end
     end
     return true
     if mtl_block.Width> mtl_block.Height then
  end -- function end
      Table.MaterialThickness = mtl_block.Height
 
      Table.MaterialLength = mtl_block.Width
  -- =====================================================]]
      Table.Orantation = "H"
  function INI_StdHeaderReader(xPath, Fname)
     else
  -- ==StdHeaderReader(xPath, Fname)==
       Table.MaterialThickness = mtl_block.Width
  -- Gets the INI Header values of a ini file and uploads to "IniFile" Array
       Table.MaterialLength = mtl_block.Height
  --[[
       Table.Orantation = "V"
  Gets the INI Header values of a ini file and uploads to "IniFile" Array
    end
  IniFile = {} Global variables
    Table.FrontThickness = Dovetail.MaterialThickness
  xPath = script_path
    Table.SideThickness = Dovetail.MaterialThickness
  ]]
    if mtl_block.Height == mtl_block.Width then
    local filename = xPath .. "\\" .. Fname .. ".ini"
         MessageBox("Error! Material block cannot square")
    local file = io.open(filename, "r")
     if file then
       local WallMilling = (LengthOfFile(filename) - 1)
       local dat = All_Trim(file:read())
       while (WallMilling >= 0) do
        if "[" == string.sub(dat, 1, 1) then
          table.insert (IniFile, string.sub(dat, 2, -2))
        end -- if end
        dat = file:read()
        if dat then
          dat = All_Trim(dat)
        else
          return true
        end -- if end
         WallMilling = WallMilling - 1
      end -- while end
      file:close()
     end
     end
     return true
     return true
   end -- function end
   end -- end function</nowiki>


----


  -- =====================================================]]
===GetBoxJointMaterialSettings===
  function INI_ReadProjectinfo(Table, xPath, xGroup, xFile)
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
-- ProjectQuestion = {}
<nowiki>function GetBoxJointMaterialSettings(Table)
-- ==ReadProjectinfo(xPath, xGroup, xFile)==
    local mtl_block = MaterialBlock()
-- Reads an ini files group and sets the table.names
    --local units
     Table.ProjectContactEmail       = GetIniValue(xPath, xFile, xGroup, "ProjectQuestion.ProjectContactEmail", "S")
     if mtl_block.InMM then
    Table.ProjectContactName        = GetIniValue(xPath, xFile, xGroup, "ProjectQuestion.ProjectContactName", "S")
       Table.Units = "Drawing Units: mm"
    Table.ProjectContactPhoneNumber = GetIniValue(xPath, xFile, xGroup, "ProjectQuestion.ProjectContactPhoneNumber", "S")
      Table.Unit = true
    Table.ProjectName              = GetIniValue(xPath, xFile, xGroup, "ProjectQuestion.ProjectName", "S")
     else
    Table.ProjectPath              = GetIniValue(xPath, xFile, xGroup, "ProjectQuestion.ProjectPath", "S")
       Table.Units = "Drawing Units: inches"
    Table.StartDate                = GetIniValue(xPath, xFile, xGroup, "ProjectQuestion.StartDate", "S")
       Table.Unit = false
    return true
  end -- function end
 
 
  -- =====================================================]]
  function INI_UpdateItem(xPath, xFile, xGroup, xItem, xValue)
  -- Deletes old ini (.bak) file
  -- Copys the .ini to a backup (.bak) new file
  -- Reads the new backup file and writes a new file to the xGroup
  -- Writes new xValue for the for the xItem
  -- Reads and writes a new file to end of file
     local NfileName = xPath .. "\\" .. xFile .. ".ini"
    local OfileName = xPath .. "\\" .. xFile .. ".bak"
    os.remove(OfileName)
    if CopyFileFromTo(NfileName, OfileName) then-- makes backup file
       local fileR = io.open(OfileName)
      local fileW = io.open(NfileName,  "w")
       if fileR and fileW then
        local groups = false
        local txt = ""
        for Line in fileR:lines() do
          txt = Line
          if All_Trim(Line) == "[" .. All_Trim(xGroup) .. "]" then -- Group
            groups = true
          end -- if end
          if xItem == string.sub(Line, 1, string.len(xItem))  then  -- Item
            if groups then
              txt = xItem .. " = " .. xValue
              groups = false
            end -- if end
          end -- if end
          fileW:write(txt .. "\n")
          txt = ""
        end -- for end
        os.remove(OfileName)
        fileR:close()
        fileW:close()
      end
     end
     end
     return true
     if mtl_block.Width > mtl_block.Height then
  end -- function end
      Table.MaterialThickness = mtl_block.Height
 
      Table.MaterialLength = mtl_block.Width
 
      Table.Orantation = "H"
  -- =====================================================]]
     else
  function INI_ReadProject(xPath, xFile, xGroup)
      Table.MaterialThickness = mtl_block.Width
  -- Milling = {}
      Table.MaterialLength = mtl_block.Height
    Milling.LayerNameBackPocket          = GetIniValue(xPath, xFile, xGroup, "Milling.LayerNameBackPocket", "S")
      Table.Orantation = "V"
    Milling.LayerNameTopBottomCenterDado = GetIniValue(xPath, xFile, xGroup, "Milling.LayerNameTopBottomCenterDado", "S")
     end
    Milling.LayerNameDrawNotes          = GetIniValue(xPath, xFile, xGroup, "Milling.LayerNameDrawNotes", "S")
     if mtl_block.Height == mtl_block.Width then
    Milling.LayerNameDrawFaceFrame      = GetIniValue(xPath, xFile, xGroup, "Milling.LayerNameDrawFaceFrame", "S")
       MessageBox("Error! Material block cannot square")
     Milling.BackPocketDepthWall          = GetIniValue(xPath, xFile, xGroup, "Milling.BackPocketDepthWall", "N")
    Milling.BlindDadoSetbackWall        = GetIniValue(xPath, xFile, xGroup, "Milling.BlindDadoSetbackWall", "N")
    Milling.CabDepthWall                = GetIniValue(xPath, xFile, xGroup, "Milling.CabDepthWall", "N")
     return true
  end -- function end
 
 
  -- =====================================================]]
  function INI_TestDeleteDups()
     --[[ Requires 3 global variables
    clean  = {}
    dups  = {}
    Names  = {}
    ]]
    local myPath = "C:\\Users\\CNC\\Documents\\test"
    local myName = "Tester"
    local myfile = "C:\\Users\\CNC\\Documents\\test\\Tester.ini"
    INI_ReadGroups(myfile, Names)
    FindDups(Names, dups, clean)
    for i,v in ipairs(dups) do
       INI_DeleteGroup(myPath, myName, v)
     end
     end
     return true
     -- Display material XY origin
  -- =====================================================]]
    local xy_origin_text = "invalid"
 
    local xy_origin = mtl_block.XYOrigin
end -- INI_Tools()
    if xy_origin == MaterialBlock.BLC then
 
        Table.xy_origin_text = "Bottom Left Corner"
-- =====================================================]]
      if Table.Orantation == "V" then
end -- INI Tools end
        Table.Direction1 = 90.0
 
        Table.Direction2 = 0.0
</nowiki>
        Table.Direction3 = 270.0
 
        Table.Direction4 = 180.0
This object is a name-value pair that represents a Document Variable within a [[VectricJob]].
         Table.Bulge = 1.0
 
  <nowiki>
-- =====================================================]]
╔╦╗╔═╗╔╦╗╔═╗  ╦╔╦╗╔═╗╔═╗╦═╗╔╦╗  ╔╦╗╔═╗╔═╗╦  ╔═╗
║║╠═╣ ║ ╠═╣  ║║║║╠═╝║ ║╠╦╝ ║    ║ ║ ║║ ║║  ╚═╗
═╩╝╩ ╩ ╩ ╩ ╩  ╩╩ ╩╩  ╚═╝╩╚═ ╩    ╩ ╚═╝╚═╝╩═╝╚═╝
function ImportTools()
-- =====================================================]]
function Read_CSV(xFile, Header)
  --Read_CSV(Door.CSVFile, true)
  local fileR = io.open(xFile)
  local xLine = ""
  local result = {}
  if fileR then
    for Line in fileR:lines() do
      xLine = Line
      if Header then
         Header = false
       else
       else
         xLine = All_Trim(Line)
         Table.Direction1 = 0.0
         for match in (xLine..","):gmatch("(.-)"..",") do
        Table.Direction2 = 90.0
          table.insert(result, match)
        Table.Direction3 = 180.0
         end -- for end
         Table.Direction4 = 270.0
         Door.Count    = tonumber(result[1])
        Table.Bulge = -1.0
         Door.Height    = tonumber(result[2])
      end
         Door.Width    = tonumber(result[3])
    elseif xy_origin == MaterialBlock.BRC then
 
      Table.xy_origin_text = "Bottom Right Corner"
         result = {}
      if Table.Orantation == "V" then
         while Door.Count > 0 do
        Table.Direction1 = 90.0
          if      Door.Style == StyleA.Name then
         Table.Direction2 = 180.0
            DoorStyleA()
         Table.Direction3 = 270.0
          elseif  Door.Style == StyleB.Name then
         Table.Direction4 = 0.0
            DoorStyleB()
         Table.Bulge = -1.0
          elseif Door.Style == StyleC.Name then
      else
            DoorStyleC()
         Table.Direction1 = 180.0
          elseif  Door.Style == StyleE.Name then
         Table.Direction2 = 90.0
            DoorStyleE()
        Table.Direction3 = 0.0
          elseif  Door.Style == StyleF.Name then
        Table.Direction4 = 270.0
            DoorStyleF()
        Table.Bulge = 1.0
          elseif  Door.Style == StyleG.Name then
      end
            DoorStyleG()
    elseif xy_origin == MaterialBlock.TRC then
          else
      Table.xy_origin_text = "Top Right Corner"
            DisplayMessageBox("No Style Select!")
      if Table.Orantation == "V" then
          end --if end
        Table.Direction1 = 270.0
          Door.Count = Door.Count - 1
        Table.Direction2 = 180.0
         end -- for end
        Table.Direction3 = 90.0
       end --if end
        Table.Direction4 = 0.0
      Door.Record = Door.Record + 1
        Table.Bulge = 1.0
       MyProgressBar:SetPercentProgress(ProgressAmount(Door.Record))
      else
    end --for end
        Table.Direction1 = 180.0
  end --if end
        Table.Direction2 = 270.0
  return true
        Table.Direction3 = 0.0
end -- function end
        Table.Direction4 = 90.0
-- =====================================================]]
         Table.Bulge = -1.0
end -- ImportTools function end
       end
 
    elseif xy_origin == MaterialBlock.TLC then
</nowiki>
       Table.xy_origin_text = "Top Left Corner"
 
      if Table.Orantation == "V" then
This object is a name-value pair that represents a Document Variable within a [[VectricJob]].
        Table.Direction1 = 270.0
 
        Table.Direction2 = 0.0
<nowiki>
        Table.Direction3 = 90.0
        Table.Direction4 = 180.0
-- =====================================================]]
        Table.Bulge = -1.0
  ╦╔═╗╔╗  ╔╦╗╔═╗╔═╗╦  ╔═╗
      else
║║ ║╠╩╗  ║ ║ ║║ ║║  ╚═╗
        Table.Direction1 = 0.0
╚╝╚═╝╚═╝  ╩ ╚═╝╚═╝╩═╝╚═╝
        Table.Direction2 = 270.0
function JobTools()
        Table.Direction3 = 180.0
-- =====================================================]]
        Table.Direction4 = 90.0
  function ValidJob()
        Table.Bulge = 1.0
  -- A better error message
      end
     local job = VectricJob()
    elseif xy_origin == MaterialBlock.CENTRE then -- NOTE: English spelling for Centre!
    if not job.Exists then
      Table.xy_origin_text = "Center"
      DisplayMessageBox("Error: Cannot run Gadget, no drawing found \n" ..
      if Table.Orantation == "V" then
                        "Please create a new file (drawing) and \n" ..
        Table.Direction1 = 0.0
                        "specify the material dimensions \n"
        Table.Direction2 = 0.0
      )
        Table.Direction3 = 0.0
       return false
        Table.Direction4 = 0.0
    else
        Table.Bulge = 1.0
      return true
      else
    end  -- if end
        Table.Direction1 = 0.0
  end -- ValidJob end
        Table.Direction2 = 0.0
-- =====================================================]]
        Table.Direction3 = 0.0
  function MoveSetectedVectors(job, NewBasePoint)
        Table.Direction4 = 0.0
    local Selection = job.Selection
        Table.Bulge = -1.0
    if Selection.IsEmpty then
      end
      MessageBox("LayoutImportedVectors: No vectors selected!")
        MessageBox("Error! " .. xy_origin_text .. " Must be set at a corner of the Material")
       return false
     else
        Table.xy_origin_text = "Unknown XY origin value!"
        MessageBox("Error! " .. xy_origin_text .. " Must be set at a corner of the Material")
       if Table.Orantation == "V" then
        Table.Direction1 = 0
        Table.Direction2 = 0
        Table.Direction3 = 0
        Table.Direction4 = 0
      else
        Table.Direction1 = 0
        Table.Direction2 = 0
        Table.Direction3 = 0
        Table.Direction4 = 0
       end
     end
     end
     local MySelection = Selection:GetBoundingBox();
     -- Setup Fingers and Gaps
     if not NewBasePoint then
    Table.NoFingers0 = 1 + (Rounder(BoxJoint.MaterialLength / BoxJoint.MaterialThickness, 0))
      NewBasePoint = Point2D(0,0)
     Table.NoFingers2 = Rounder(BoxJoint.NoFingers0 / 2, 0)
     end
     Table.FingerSize = BoxJoint.MaterialLength /  BoxJoint.NoFingers0
     local MyNewLocatioin = BasePoint - MySelection.BLC
     Table.NoFingers1 = BoxJoint.NoFingers0 - BoxJoint.NoFingers2
    local Txform = TranslationMatrix2D(MyNewLocatioin)
    Selection:Transform(Txform)
     return true
     return true
  end -- function end</nowiki>
----
===GetMaterialSettings===
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
<nowiki>function GetMaterialSettings(Table)
  local MaterialBlock = MaterialBlock()
  Table.MaterialBlockThickness = MaterialBlock.Thickness
  Table.xy_origin = MaterialBlock.XYOrigin
  if MaterialBlock.InMM then
    Table.Units  = "Drawing Units: mm"
    Table.Unit = true
    Table.Cal = 25.4
  else
    Table.Units  = "Drawing Units: inches"
    Table.Unit = false
    Table.Cal = 1.0
   end
   end
-- =====================================================]]
  --local units
  function FixPath(path)                                -- Lua Returns a fixed path
if MaterialBlock.Width > MaterialBlock.Height then
     return path:gsub("%\\", "/")
     Table.Orantation = "H" -- Horizontal
  end -- function end
elseif MaterialBlock.Width < MaterialBlock.Height then
-- =====================================================]]
    Table.Orantation = "V" -- Vertical
  function FixPath(myPath) {                            -- JavaScript Tool Returns a fixed path
   else
    /* myPath  = "C:\\User\\Bob\\Home\\Drawings"; */
     Table.Orantation = "S" -- Squair
    /* NewPath = "C:/User/Bob/Home/Drawings"; */
end
    var NewPath = "";
  if Table.xy_origin == MaterialBlock.BLC then
    var myLetter = "";
     Table.XYorigin = "Bottom Left Corner"
    var CheckPathLen = myPath.length;
  elseif Table.xy_origin == MaterialBlock.BRC then
    for (let i = 0; i < myPath.length; i++) {
    Table.XYorigin = "Bottom Right Corner"
      myLetter = myPath.charAt(i)
  elseif Table.xy_origin == MaterialBlock.TRC then
      if myLetter.charCodeAt(0) == 92 {
     Table.XYorigin = "Top Right Corner"
        NewPath = NewPath + "/";
      } else {
        NewPath = NewPath + myLetter;
      }
    }
    return NewPath;
  }
  -- =====================================================]]
   function GetUnits(UTable)                              -- returns Drawing Units data
    local mtl_block = MaterialBlock()
     if mtl_block.InMM then
      UTable.Units  = "Drawing Units: mm"
      UTable.Unit = true
      UTable.UnitCheck = {"metric", "kilometer", "kilometers", "kh", "meter", "meters", "m", "decimeter", "decimeters", "dm", "centimeter", "centimeters", "cm", "millimeter", "millimeters", "mm"}
      UTable.Cal = 25.4
     else
      UTable.Units  = "Drawing Units: inches"
      UTable.Unit = false
      UTable.UnitCheck = {"imperial", "miles", "mile", "mi", "yards", "yard", "yd", "feet", "foot", "ft", "inches", "inch", "in", "fractions", "fraction"}
      UTable.Cal = 1.0
    end
    return true
  end -- end function
  -- =====================================================]]
function CheckTheUnits(UTable, Value)                    -- Checks if the unit of messure in of drawing units
  local goodtogo = false
  for i=1, #UTable.UnitCheck  do
     if string.upper(Value) == string.upper(UTable.UnitCheck[i]) then
      goodtogo = true
      break
    end -- if end
  end -- for end
  if goodtogo then
    return true
   else
   else
     return false
     Table.XYorigin = "Top Left Corner"
   end -- if end
   end -- if end
end -- function end
  Table.UnitDisplay  = "Note: Units: (" .. Table.Units ..")"
  -- =====================================================]]
  return true
  function GetMatlBlk(Table)
end -- end function</nowiki>
     local mtl_block = MaterialBlock()
 
    if mtl_block.InMM then
----
      Table.Units = "Drawing Units: mm"
 
      Table.Unit = true
===IsSingleSided===
     else
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
       Table.Units = "Drawing Units: inches"
<nowiki>function IsSingleSided(Table)
       Table.Unit = false
     local SingleSided = Table.job.IsSingleSided
     end
     if not SingleSided then
    if mtl_block.Width> mtl_block.Height then
       DisplayMessageBox("Error: Job must be a single sided job")
      Table.MaterialThickness = mtl_block.Height
       return false
      Table.MaterialLength = mtl_block.Width
     end  -- if end
      Table.Orantation = "H"
  end -- function end</nowiki>
    else
 
      Table.MaterialThickness = mtl_block.Width
----
      Table.MaterialLength = mtl_block.Height
 
      Table.Orantation = "V"
===IsDoubleSided===
    end
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
    Table.FrontThickness = Dovetail.MaterialThickness
<nowiki>function IsDoubleSided(Table)
    Table.SideThickness = Dovetail.MaterialThickness
  if not Table.job.IsDoubleSided then
    if mtl_block.Height == mtl_block.Width then
    DisplayMessageBox("Error: Job must be a Double Sided Project")
        MessageBox("Error! Material block cannot square")
     return false
     end
  else
     return true
     return true
   end -- end function
   end -- if end
  -- =====================================================]]
end-- function end</nowiki>
   function GetBoxJointMaterialSettings(Table)
 
     local mtl_block = MaterialBlock()
----
     --local units
 
     if mtl_block.InMM then
===ShowSetting===
      Table.Units = "Drawing Units: mm"
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
      Table.Unit = true
<nowiki>function ShowSetting(Table)
     else
  local name = ""
      Table.Units = "Drawing Units: inches"
      DisplayMessageBox(
      Table.Unit = false
    name .. " MaterialThickness = " .. tostring(Table.MaterialThickness) .."\n" ..
     end
    name .. " BottleRad        = " .. tostring(Table.BottleRad)        .."\n" ..
     if mtl_block.Width > mtl_block.Height then
    name .. " SideLenght        = " .. tostring(Table.SideLenght)        .."\n" ..
      Table.MaterialThickness = mtl_block.Height
    name .. " SideHight        = " .. tostring(Table.SideHight)        .."\n" ..
      Table.MaterialLength = mtl_block.Width
    name .. " EndLenght        = " .. tostring(Table.EndLenght)        .."\n" ..
       Table.Orantation = "H"
    name .. " EndHight          = " .. tostring(Table.EndHight)          .."\n" ..
    name .. " TopLenght        = " .. tostring(Table.TopLenght)        .."\n" ..
    name .. " TopWidht          = " .. tostring(Table.TopWidht)          .."\n" ..
    name .. " HandleLenght      = " .. tostring(Table.HandleLenght)      .."\n" ..
    name .. " HandleWidht      = " .. tostring(Table.HandleWidht)      .."\n" ..
    name .. " HandleRad        = " .. tostring(Table.HandleRad)        .."\n" ..
    name .. " MillingBitRad    = " .. tostring(Table.MillingBitRad)    .."\n" ..
    "\n")
end -- function end</nowiki>
 
----
 
===MakeLayers===
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
<nowiki>function MakeLayers()
  local Red, Green, Blue = 0, 0, 0
   local function GetColor(str) -- returns color value for a Color Name
    local sx = str
    local Red = 0
     local Green = 0
     local Blue = 0
     local Colors = {}
    Colors.Black = "0,0,0"
    Colors.Red = "255,0,0"
     Colors.Blue = "0,0,255"
    Colors.Yellow = "255,255,0"
     Colors.Cyan = "0,255,255"
     Colors.Magenta = "255,0,255"
    Colors.Green = "0,128,0"
    if "" == str then
       DisplayMessageBox("Error: Empty string passed")
     else
     else
       Table.MaterialThickness = mtl_block.Width
       str = Colors[str]
       Table.MaterialLength = mtl_block.Height
       if "string" == type(str) then
      Table.Orantation = "V"
        if string.find(str, ",") then
    end
          Red  = tonumber(string.sub(str, 1, assert(string.find(str, ",") - 1)))
    if mtl_block.Height == mtl_block.Width then
          str = string.sub(str, assert(string.find(str, ",") + 1))
      MessageBox("Error! Material block cannot square")
          Green = tonumber(string.sub(str, 1, assert(string.find(str, ",") - 1)))
    end
          Blue  = tonumber(string.sub(str, assert(string.find(str, ",") + 1)))
    -- Display material XY origin
         end
    local xy_origin_text = "invalid"
    local xy_origin = mtl_block.XYOrigin
    if xy_origin == MaterialBlock.BLC then
        Table.xy_origin_text = "Bottom Left Corner"
      if Table.Orantation == "V" then
        Table.Direction1 = 90.0
        Table.Direction2 = 0.0
         Table.Direction3 = 270.0
        Table.Direction4 = 180.0
        Table.Bulge = 1.0
       else
       else
         Table.Direction1 = 0.0
         DisplayMessageBox("Error: Color " .. sx .. " not Found" )
        Table.Direction2 = 90.0
         Red = 0
         Table.Direction3 = 180.0
         Green = 0
         Table.Direction4 = 270.0
         Blue = 0
         Table.Bulge = -1.0
       end
       end
     elseif xy_origin == MaterialBlock.BRC then
     end
      Table.xy_origin_text = "Bottom Right Corner"
    return Red, Green, Blue
      if Table.Orantation == "V" then
  end
         Table.Direction1 = 90.0
  local layer = Milling.job.LayerManager:GetLayerWithName(Milling.LNBackPocket)
         Table.Direction2 = 180.0
         Red, Green, Blue = GetColor(Milling.LNBackPocketColor)
        Table.Direction3 = 270.0
        layer:SetColor (Red, Green, Blue)
         Table.Direction4 = 0.0
         layer = Milling.job.LayerManager:GetLayerWithName(Milling.LNBackProfile)
         Table.Bulge = -1.0
         Red, Green, Blue = GetColor(Milling.LNBackProfileColor)
      else
         layer:SetColor (Red, Green, Blue)
        Table.Direction1 = 180.0
  return true
        Table.Direction2 = 90.0
end -- function end</nowiki>
        Table.Direction3 = 0.0
 
        Table.Direction4 = 270.0
----
         Table.Bulge = 1.0
 
      end
===MyLayerClear===
    elseif xy_origin == MaterialBlock.TRC then
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
      Table.xy_origin_text = "Top Right Corner"
<nowiki>function MyLayerClear(LayerName)
      if Table.Orantation == "V" then
  local Mylayer = Milling.job.LayerManager:GetLayerWithName(LayerName)
        Table.Direction1 = 270.0
    if Mylayer.IsEmpty then
        Table.Direction2 = 180.0
         Milling.job.LayerManager:RemoveLayer(Mylayer)
        Table.Direction3 = 90.0
    end -- if end
        Table.Direction4 = 0.0
  return true
        Table.Bulge = 1.0
end -- function end</nowiki>
      else
 
        Table.Direction1 = 180.0
----
        Table.Direction2 = 270.0
 
        Table.Direction3 = 0.0
===LayerClear===
        Table.Direction4 = 90.0
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
        Table.Bulge = -1.0
<nowiki>function LayerClear()                      --  calling MyLayerClear
      end
  MyLayerClear(Milling.LNBackPocket  .. "-Wall")
    elseif xy_origin == MaterialBlock.TLC then
  MyLayerClear(Milling.LNBackPocket  .. "-Base")
      Table.xy_origin_text = "Top Left Corner"
  MyLayerClear(Milling.LNBackProfile .. "-Wall")
      if Table.Orantation == "V" then
  MyLayerClear(Milling.LNBackProfile .. "-Base")
        Table.Direction1 = 270.0
  MyLayerClear("PartLabels")
        Table.Direction2 = 0.0
  return true
        Table.Direction3 = 90.0
end -- function end
        Table.Direction4 = 180.0
</nowiki>
        Table.Bulge = -1.0
 
      else
==Logic and Test Tools==
        Table.Direction1 = 0.0
[[File:Back.jpg|right|50px|link=Vectric Lua Interface for Gadgets]]
        Table.Direction2 = 270.0
These functions are named as per there function or action.
        Table.Direction3 = 180.0
 
        Table.Direction4 = 90.0
----
        Table.Bulge = 1.0
 
      end
===CheckNumber===
    elseif xy_origin == MaterialBlock.CENTRE then -- NOTE: English spelling for Centre!
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
      Table.xy_origin_text = "Center"
<nowiki>function CheckNumber(num)
       if Table.Orantation == "V" then
  if type(num) == "number" then
        Table.Direction1 = 0.0
    return true
        Table.Direction2 = 0.0
  else
        Table.Direction3 = 0.0
  return false
        Table.Direction4 = 0.0
  end -- if end
        Table.Bulge = 1.0
end -- function end</nowiki>
      else
 
        Table.Direction1 = 0.0
----
        Table.Direction2 = 0.0
 
        Table.Direction3 = 0.0
===AboveZero===
        Table.Direction4 = 0.0
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
        Table.Bulge = -1.0
<nowiki>function AboveZero(num)
       end
  if (type(num) == "number") and (num > 0.0)then
        MessageBox("Error! " .. xy_origin_text .. " Must be set at a corner of the Material")
    return true
  else
  return false
  end -- if end
end -- function end
 
</nowiki>
 
----
 
 
===IsNumber()===
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
  <nowiki>function IsNumber(Val)                    --Return true if Val is number
    if tonumber(x) ~= nil then
       return true
    end -- if end
    return false
  end -- end function</nowiki>
 
----
 
===IsEven()===
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
<nowiki>function IsEven(IsEven_Number)            -- Returns True/False if number is even
    if (IsEven_Number % 2 == 0) then
       return true
     else
     else
        Table.xy_origin_text = "Unknown XY origin value!"
      return false
        MessageBox("Error! " .. xy_origin_text .. " Must be set at a corner of the Material")
    end -- if end
      if Table.Orantation == "V" then
  end -- function end</nowiki>
        Table.Direction1 = 0
 
        Table.Direction2 = 0
----
        Table.Direction3 = 0
 
        Table.Direction4 = 0
===IsOdd()===
      else
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
        Table.Direction1 = 0
<nowiki>function IsOdd(IsOdd_Number)                          -- Returns True/False if number is odd
        Table.Direction2 = 0
     if(IsOdd_Number%2 == 0) then
        Table.Direction3 = 0
      return false
        Table.Direction4 = 0
     end -- end if
      end
    end
    -- Setup Fingers and Gaps
    Table.NoFingers0 = 1 + (Rounder(BoxJoint.MaterialLength / BoxJoint.MaterialThickness, 0))
     Table.NoFingers2 = Rounder(BoxJoint.NoFingers0 / 2, 0)
    Table.FingerSize = BoxJoint.MaterialLength /  BoxJoint.NoFingers0
     Table.NoFingers1 = BoxJoint.NoFingers0 - BoxJoint.NoFingers2
     return true
     return true
   end -- function end
   end -- function end</nowiki>
-- =====================================================]]
 
function GetMaterialSettings(Table)
----
  local MaterialBlock = MaterialBlock()
 
  Table.MaterialBlockThickness = MaterialBlock.Thickness
===IsNegative()===
  Table.xy_origin = MaterialBlock.XYOrigin
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
  if MaterialBlock.InMM then
<nowiki>function IsNegative(x)                     -- Returns True/False if number is a negative number  
    Table.Units  = "Drawing Units: mm"
   if x >=0.0 then
    Table.Unit = true
    Table.Cal = 25.4
  else
    Table.Units  = "Drawing Units: inches"
    Table.Unit = false
    Table.Cal = 1.0
  end
  --local units
if MaterialBlock.Width > MaterialBlock.Height then
    Table.Orantation = "H" -- Horizontal
elseif MaterialBlock.Width < MaterialBlock.Height then
    Table.Orantation = "V"  -- Vertical
  else
    Table.Orantation = "S" -- Squair
end
  if Table.xy_origin == MaterialBlock.BLC then
    Table.XYorigin = "Bottom Left Corner"
  elseif Table.xy_origin == MaterialBlock.BRC then
    Table.XYorigin = "Bottom Right Corner"
  elseif Table.xy_origin == MaterialBlock.TRC then
    Table.XYorigin = "Top Right Corner"
  else
    Table.XYorigin = "Top Left Corner"
  end -- if end
  Table.UnitDisplay  = "Note: Units: (" .. Table.Units ..")"
  return true
end -- end function
-- =====================================================]]
function IsSingleSided(Table)
    local SingleSided = Table.job.IsSingleSided
    if not SingleSided then
      DisplayMessageBox("Error: Job must be a single sided job")
      return false
    end -- if end
   end --IsSingleSided function end
-- =====================================================]]
function IsDoubleSided(Table)
  if not Table.job.IsDoubleSided then
    DisplayMessageBox("Error: Job must be a Double Sided Project")
     return false
     return false
   else
   else
     return true
     return true
   end -- if end
   end -- if end
end-- IsDoubleSided function
end -- function end</nowiki>
-- =====================================================]]
 
function ShowSetting(Table)
----
   local name = ""
===IsAllNumber()===
      DisplayMessageBox(
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
    name .. " MaterialThickness = " .. tostring(Table.MaterialThickness) .."\n" ..
 
    name .. " BottleRad        = " .. tostring(Table.BottleRad)        .."\n" ..
<nowiki>function IsAllNumber(str)                 -- Returns True/False if finds all numbers in string
     name .. " SideLenght        = " .. tostring(Table.SideLenght)       .."\n" ..
   local out = true                                   
     name .. " SideHight        = " .. tostring(Table.SideHight)         .."\n" ..
  local let = ""
    name .. " EndLenght        = " .. tostring(Table.EndLenght)         .."\n" ..
  for i = 1, #str do
    name .. " EndHight          = " .. tostring(Table.EndHight)         .."\n" ..
     let = str:byte(i)
    name .. " TopLenght        = " .. tostring(Table.TopLenght)         .."\n" ..
     if (let ~= 48) and (let ~= 49) and (let ~= 50) and (let ~= 51) and
    name .. " TopWidht          = " .. tostring(Table.TopWidht)         .."\n" ..
      (let ~= 52) and (let ~= 53) and (let ~= 54) and (let ~= 55) and
    name .. " HandleLenght      = " .. tostring(Table.HandleLenght)     .."\n" ..
      (let ~= 56) and (let ~= 57) and (let ~= 46) then
    name .. " HandleWidht       = " .. tostring(Table.HandleWidht)      .."\n" ..
       out = false
     name .. " HandleRad        = " .. tostring(Table.HandleRad)        .."\n" ..
     end -- if end
    name .. " MillingBitRad    = " .. tostring(Table.MillingBitRad)    .."\n" ..
  end -- for end
    "\n")
  return out        -- send out the return
end -- ShowSettings function end
end -- function end</nowiki>
-- =====================================================]]
 
function MakeLayers()
----
  local Red, Green, Blue = 0, 0, 0
 
   local function GetColor(str) -- returns color value for a Color Name
===NonNumber()===
    local sx = str
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
    local Red = 0
<nowiki>function NonNumber(Val)                   -- Return true if val is not number
    local Green = 0
    if tonumber(x) ~= nil then
    local Blue = 0
      return false
    local Colors = {}
    end -- if end
    Colors.Black = "0,0,0"
    return true
    Colors.Red = "255,0,0"
   end -- end function</nowiki>
     Colors.Blue = "0,0,255"
 
    Colors.Yellow = "255,255,0"
----
    Colors.Cyan = "0,255,255"
 
     Colors.Magenta = "255,0,255"
===NumberType()===
    Colors.Green = "0,128,0"
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
     if "" == str then
<nowiki>function NumberType(Val)                  -- Return true if val is not number
      DisplayMessageBox("Error: Empty string passed")
     if math.type(x) == "integer" then
    else
      return "integer"
      str = Colors[str]
     else
      if "string" == type(str) then
      return "float"
        if string.find(str, ",") then
     end -- if end
          Red   = tonumber(string.sub(str, 1, assert(string.find(str, ",") - 1)))
  end -- end function</nowiki>
          str  = string.sub(str, assert(string.find(str, ",") + 1))
 
          Green = tonumber(string.sub(str, 1, assert(string.find(str, ",") - 1)))
----
          Blue  = tonumber(string.sub(str, assert(string.find(str, ",") + 1)))
 
        end
==Math Tools==
      else
[[File:Back.jpg|right|50px|link=Vectric Lua Interface for Gadgets]]
        DisplayMessageBox("Error: Color " .. sx .. " not Found" )
This object is a name-value pair that represents a Document Variable within a [[VectricJob]].
        Red = 0
 
        Green = 0
----
        Blue = 0
 
      end
===ArcSegment()===
    end
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
    return Red, Green, Blue
<nowiki>function ArcSegment(p1, p2, Rad)                       -- Returns the Arc Segment
  end
   local chord = math.sqrt(((p2.x - p1.x) ^ 2) + ((p2.y - p1.y) ^ 2))
  local layer = Milling.job.LayerManager:GetLayerWithName(Milling.LNBackPocket)
  local segment = (Rad - (0.5 * (math.sqrt((4.0 * Rad^2) - chord^2))))
        Red, Green, Blue = GetColor(Milling.LNBackPocketColor)
  return segment
        layer:SetColor (Red, Green, Blue)
end -- function end</nowiki>
        layer = Milling.job.LayerManager:GetLayerWithName(Milling.LNBackProfile)
 
        Red, Green, Blue = GetColor(Milling.LNBackProfileColor)
----
        layer:SetColor (Red, Green, Blue)
 
   return true
===D(x) Doubles x===
end -- function end
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
  -- =====================================================]]
<nowiki>function D(x)                                          -- Returns double the value
function MyLayerClear(LayerName)
  return x * 2.0
   local Mylayer = Milling.job.LayerManager:GetLayerWithName(LayerName)
end -- function end</nowiki>
    if Mylayer.IsEmpty then
 
        Milling.job.LayerManager:RemoveLayer(Mylayer)
----
    end -- if end
 
   return true
===H(x) Halfs x===
end -- function end
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
-- =====================================================]]
<nowiki>function H(x)                                           -- Returns half the value
function LayerClear()                                   -- calling MyLayerClear
  return x * 0.5
   MyLayerClear(Milling.LNBackPocket  .. "-Wall")
end -- function end</nowiki>
   MyLayerClear(Milling.LNBackPocket  .. "-Base")
 
   MyLayerClear(Milling.LNBackProfile .. "-Wall")
----
   MyLayerClear(Milling.LNBackProfile .. "-Base")
 
  MyLayerClear("PartLabels")
===C(x) Returns x by scale===
   return true
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
end -- function end
<nowiki>function C(x)                                           -- Returns scale value
-- =====================================================]]
   return x * Project.Cal
end -- function end</nowiki>
 
----
 
===ChordSag2Radius()===
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
<nowiki>function ChordSag2Radius (Chr, Seg)                     -- Returns the Rad from Chord and Seg
   local rad = ((((Chr * Chr)/(Seg * 4)) + Seg) / 2.0)
   return rad
end -- function end</nowiki>
 
----
 
===RadSag2Chord()===
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
<nowiki>function RadSag2Chord(Rad, Seg)                         -- Returns the Chord from Rad and Seg
   local Ang = 2 * math.acos(1 - (Seg/Rad))
   local Chord = (2 * Rad) * math.sin(Ang * 0.5)
   return Chord
end -- function end</nowiki>
 
----
 
===RadChord2Segment()===
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
<nowiki>function RadChord2Segment (Rad, Chord)      -- Returns the Arc Segment from Rad and Chord
   local segment = (Rad - (0.5 * (math.sqrt((4.0 * Rad^2) - Chord^2))))
   return segment
end -- function end</nowiki>
 
----
 
===RoundTo()===
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
<nowiki>function RoundTo(Num, Per)                  -- Returns the number from
  local Head = Num < 0 and math.ceil(Num) or math.floor(Num)
  local Tail = Num - Head
  local Value = Head + tonumber(string.sub(tostring(Tail), 1, Per + 2))
  return Value
end -- function end</nowiki>


-- =====================================================]]
----
end -- Job Tools end


</nowiki>
===Round()===
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
<nowiki>function Round(x)
  return x>=0 and math.floor(x+0.5) or math.ceil(x-0.5)
end</nowiki>


This object is a name-value pair that represents a Document Variable within a [[VectricJob]].
----


  <nowiki>  
===DecimalPlaces()===
   
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
-- =====================================================]]
  <nowiki>function DecimalPlaces(Dnum, Plac)
╔═╗╔═╗╦╔═╗  ╔╦╗╔═╗╔═╗╦  ╔═╗
  return tonumber(string.sub(tostring(Dnum) .. "000000000000000000000000000000000000",1, string.len(tostring(math.floor(Dnum))) + 1 + Plac))
║  ║ ║║ ╦║║     ║ ║ ║║ ║║  ╚═╗
end</nowiki>
╩═╝╚═╝╚═╝╩╚═╝  ╩ ╚═╝╚═╝╩═╝╚═╝
 
function LogicTools()
----
-- =====================================================]]
 
function DialogStringChecks()
===ToInteger()===
  local MyTrue = false
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
  if Milling.LNBottomProfile == "" then
  <nowiki>function ToInteger( x )
    MessageBox("Error: Bottom Profile layer name cannot be blank")
     local num = tonumber( x )
    OnLuaButton_InquiryLayers()
    return num < 0 and math.ceil( num ) or math.floor( num )
  elseif  Milling.LNSideProfile  == "" then
end </nowiki>
    MessageBox("Error: Side Profile layer name cannot be blank")
 
    OnLuaButton_InquiryLayers()
----
  elseif  Milling.LNSidePocket  == "" then
 
    MessageBox("Error: Side Pocket layer name cannot be blank")
===TrigIt===
     OnLuaButton_InquiryLayers()
Finds all 5 properties of a triangle
  elseif Milling.LNFrontProfile == "" then
 
    MessageBox("Error: Front Profile layer name cannot be blank")
<nowiki>function TrigIt(A, B, AB, AC, BC)
     OnLuaButton_InquiryLayers()
-- Sub Function to help other functions
  elseif Milling.LNFrontPocket  == "" then
-- Call = A, B, AB, AC, BC = Trig(A, B, AB, AC, BC)
    MessageBox("Error: Front Pocket layer name cannot be blank")
-- C is the corner, A = small ang and B is the big angle
    OnLuaButton_InquiryLayers()
-- returns all values
  elseif Milling.LNBackProfile  == "" then
-- A, B = angles
     MessageBox("Error: Back Profile layer name cannot be blank")
-- C = 90.0 Deg
    OnLuaButton_InquiryLayers()
-- B to C (BC) is Run - Base - adjacent
  elseif Milling.LNBackPocket == "" then
-- A to C (AC) is Rise - Height - opposite
    MessageBox("Error: Back Pocket layer name cannot be blank")
-- A to B (AB) is Slope - hypotenuse
    OnLuaButton_InquiryLayers()
     if (B > 0.0) and (A == 0.0) then
  elseif Milling.LNDrawNotes == "" then
      A = math.deg(math.rad(90) - math.rad(B))
    MessageBox("Error: Draw Notes layer name cannot be blank")
     end
    OnLuaButton_InquiryLayers()
    if (A > 0.0) and (B == 0.0) then
  elseif Milling.LNPartLabels == "" then
      B = math.deg(math.rad(90) - math.rad(A))
    MessageBox("Error: Part Lables layer name cannot be blank")
    end
     OnLuaButton_InquiryLayers()
     if  (AC > 0.0) and (BC > 0.0) then
  elseif Milling.LNBlume == "" then
      AB = math.sqrt((AC ^ 2) + (BC ^ 2))
    MessageBox("Error: Blume layer name cannot be blank")
      A = math.deg(math.atan(BC/AC))
    OnLuaButton_InquiryLayers()
      B = math.deg(math.rad(90) - math.rad(A))
  elseif Project.ProjectName == "" then
     elseif (AB > 0.0) and (BC > 0.0) then
    MessageBox("Error: Project Name cannot be blank")
      AB = math.sqrt((AB ^ 2) - (BC ^ 2))
    OnLuaButton_InquiryProjectInfo()
      A = math.deg(math.atan(BC/AC))
  elseif Project.ContactEmail  == "" then
      B = math.deg(math.rad(90) - math.rad(A))
    MessageBox("Error: Contact Email cannot be blank")
     elseif (AB > 0.0) and (AC > 0.0) then
     OnLuaButton_InquiryProjectInfo()
      AB = math.sqrt((AB ^ 2) - (AC ^ 2))
  elseif Project.ContactName == "" then
      A = math.deg(math.atan(BC/AC))
    MessageBox("Error: Contact Name cannot be blank")
      B = math.deg(math.rad(90) - math.rad(A))
    OnLuaButton_InquiryProjectInfo()
     elseif (A > 0.0) and (AC > 0.0) then
  elseif Project.ContactPhoneNumber == "" then
      AB = AC / math.cos(math.rad(A))
    MessageBox("Error: Project Name cannot be blank")
      BC = AB * math.sin(math.rad(A))
    OnLuaButton_InquiryProjectInfo()
     elseif (A > 0.0) and (BC > 0.0) then
  elseif Project.DrawerID == "" then
      AB = BC / math.sin(math.rad(A))
    MessageBox("Error: Contact Phone Number cannot be blank")
      AC = AB * math.cos(math.rad(A))
     OnLuaButton_InquiryProjectInfo()
    elseif (A > 0.0) and (AB > 0.0) then
  elseif Project.ProjectPath == "" then
      BC = AB * math.sin(math.rad(A))
    MessageBox("Error: Project Path cannot be blank")
      AC = AB * math.cos(math.rad(A))
    OnLuaButton_InquiryProjectInfo()
     else
  else
      MessageBox("Error: No Missing Value")
     MyTrue = true
    end -- if end
  end -- if end
    return A, B, AB, AC, BC
  return MyTrue
  end</nowiki>
end -- function end
-- =====================================================]]
function CheckNumber(num)
  if type(num) == "number" then
    return true
  else
  return false
  end -- if end
end -- function end
-- =====================================================]]
function AboveZero(num)
  if (type(num) == "number") and (num > 0.0)then
     return true
  else
  return false
  end -- if end
end -- function end
-- =====================================================]]
end -- LogicTools function end


</nowiki>
----


==Registry Read and Write Tools==
[[File:Back.jpg|right|50px|link=Vectric Lua Interface for Gadgets]]
This object is a name-value pair that represents a Document Variable within a [[VectricJob]].
This object is a name-value pair that represents a Document Variable within a [[VectricJob]].


<nowiki>
----
 
-- =====================================================]]
===DocVarChk()===
╔═╗╔═╗╔═╗╦╔╗╔╔═╗  ╔╦╗╔═╗╔═╗╦  ╔═╗
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
║  ║ ║║ ╦║ ╦║║║║║ ╦   ║ ║ ║║ ║║  ╚═╗
  <nowiki>function DocVarChk(Name, Value)
╩═╝╚═╝╚═╝╚═╝╩╝╚╝╚═╝   ╩ ╚═╝╚═╝╩═╝╚═╝
   local job = VectricJob()
function LoggingTools()
   local document_variable_list = job.DocumentVariables
-- =====================================================]]
  return document_variable_list:DocumentVariableExists(Name)
  function LogWriter(xPath, xFile, xText)
end -- function end</nowiki>
   -- Writes new xText Line to a log file
 
    local LogName = xPath .. "\\" .. xFile .. ".txt"
----
    local fileW = io.open(LogName,  "a")
 
    if fileW then
===DocVarGet()===
      fileW:write(xText .. "\n")
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
      fileW:close()
<nowiki>function DocVarGet(Name)
    end
   local job = VectricJob()
    return true
  local document_variable_list = job.DocumentVariables
  end -- function end
  return document_variable_list:GetDocumentVariable(Name, 0.0)
  -- =====================================================]]
end -- function end</nowiki>
  function LogWriter(LogName, xText)
 
   -- Adds a new xText Line to a app log file
----
  -- local LogName = Door.CSVPath .. "\\" .. Door.RuntimeLog .. ".txt"
 
    local fileW = io.open(LogName,  "a")
===DocVarSet()===
    if fileW then
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
      fileW:write(xText .. "\n")
<nowiki>function DocVarSet(Name, Value)
      fileW:close()
   local job = VectricJob()
    end -- if end
  local document_variable_list = job.DocumentVariables
    Maindialog:UpdateLabelField("Door.Alert", "Note: Errors are logged in the CSF file folder.")
  return document_variable_list:SetDocumentVariable(Name, Value)
    return true
end -- function end</nowiki>
  end -- function end
 
-- =====================================================]]
----
end -- Logging Tools Function End


</nowiki>
===RegistryReadMaterial()===
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
<nowiki>function RegistryReadMaterial()                -- Read from Registry Material values for LUA Bit
  local RegistryRead              = Registry("Material")
  Milling.SafeZGap                = Rounder(RegistryRead:GetString("SafeZGap",              "0.500"), 4)
  Milling.StartZGap              = Rounder(RegistryRead:GetString("StartZGap",            "0.500"), 4)
  Milling.HomeX                  = Rounder(RegistryRead:GetString("HomeX",                "0.000"), 4)
  Milling.HomeY                  = Rounder(RegistryRead:GetString("HomeY",                "0.000"), 4)
  Milling.HomeZGap                = Rounder(RegistryRead:GetString("HomeZGap",              "0.750"), 4)
  return true
end -- function end</nowiki>


This object is a name-value pair that represents a Document Variable within a [[VectricJob]].
----


<nowiki>
===RegistryLastTenFiles()===
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
-- =====================================================]]
<nowiki>function RegistryLastTenFiles(FileName)        -- Adds to the top ten Log file list
╔╦╗╔═╗╔╦╗╦ ╦ ╔╦╗╔═╗╔═╗╦  ╔═╗
  local Registry = Registry(RegName)
║║║╠═╣ ║ ╠═╣  ║ ║ ║║ ║║  ╚═╗
  LogFile.File10 = Registry:GetString("LogFile.File09", "No Log Yet" )
╩ ╩╩ ╩ ╩ ╩ ╩  ╩ ╚═╝╚═╝╩═╝╚═╝
  LogFile.File09 = Registry:GetString("LogFile.File08", "No Log Yet" )
function MathTools()
  LogFile.File08 = Registry:GetString("LogFile.File07", "No Log Yet" )
-- =====================================================]]
  LogFile.File07 = Registry:GetString("LogFile.File06", "No Log Yet" )
function ArcSegment (p1, p2, Rad)                       -- Returns the Arc Segment
  LogFile.File06 = Registry:GetString("LogFile.File05", "No Log Yet" )
   local chord = math.sqrt(((p2.x - p1.x) ^ 2) + ((p2.y - p1.y) ^ 2))
  LogFile.File05 = Registry:GetString("LogFile.File04", "No Log Yet" )
   local segment = (Rad - (0.5 * (math.sqrt((4.0 * Rad^2) - chord^2))))
  LogFile.File04 = Registry:GetString("LogFile.File03", "No Log Yet" )
   return segment
  LogFile.File03 = Registry:GetString("LogFile.File02", "No Log Yet" )
end -- function end
  LogFile.File02 = Registry:GetString("LogFile.File01", "No Log Yet" )
-- =====================================================]]
  LogFile.File01 = FileName
function D(x)                                           -- Returns double the value
  return FileName
   return x * 2.0
end -- function end</nowiki>
end -- function end
 
-- =====================================================]]
----
function H(x)                                           -- Returns half the value
 
   return x * 0.5
===RegistryRead()===
end -- function end
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
-- =====================================================]]
  <nowiki>function RegistryRead()                       -- Read from Registry values
function C(x)                                          -- Returns scale value
  local RegistryRead = Registry("RegName")
   return x * Project.Cal
  local Yes_No      = RegistryRead:GetBool("BaseDim.Yes_No", ture)
end -- function end
  local CabHeight    = RegistryRead:GetDouble("BaseDim.CabHeight", 35.500)
-- =====================================================]]
  local CabCount    = RegistryRead:GetInt("BaseDim.CabCount", 36)
function ChordSag2Radius (Chr, Seg)                    -- Returns the Rad from Chord and Seg
  local Name        = RegistryRead:GetString("BaseDim.Name", "Words")
  local rad = ((((Chr * Chr)/(Seg * 4)) + Seg) / 2.0)
 
  return rad
  Milling.MillTool1.FeedRate                = RegistryRead:GetDouble("Milling.MillTool1.FeedRate",              30.000)
end -- function end
  Milling.MillTool1.InMM                    = RegistryRead:GetBool("Milling.MillTool1.InMM ",                  false)
-- =====================================================]]
  Milling.MillTool1.Name                    = RegistryRead:GetString("Milling.MillTool1.Name",                  "No Tool Selected")
function RadSag2Chord(Rad, Seg)                        -- Returns the Chord from Rad and Seg
  Milling.MillTool1.BitType                = RegistryRead:GetString("Milling.MillTool1.BitType",              "END_MILL") -- BALL_NOSE, END_MILL, VBIT
  local Ang = 2 * math.acos(1 - (Seg/Rad))
  Milling.MillTool1.RateUnits              = RegistryRead:GetInt("Milling.MillTool1.RateUnits",                4)
  local Chord = (2 * Rad) * math.sin(Ang * 0.5)
  Milling.MillTool1.SpindleSpeed            = RegistryRead:GetInt("Milling.MillTool1.SpindleSpeed",            20000)
  return Chord
  Milling.MillTool1.ToolNumber              = RegistryRead:GetInt("Milling.MillTool1.ToolNumber",              1)
end -- function end
  Milling.MillTool1.Stepdown                = RegistryRead:GetDouble("Milling.MillTool1.Stepdown",              0.2000)
-- =====================================================]]
  Milling.MillTool1.Stepover                = RegistryRead:GetDouble("Milling.MillTool1.Stepover",              0.0825)
function RadChord2Segment (Rad, Chord)      -- Returns the Arc Segment from Rad and Chord
  Milling.MillTool1.ToolDia                = RegistryRead:GetDouble("Milling.MillTool1.ToolDia",               0.1250)
  local segment = (Rad - (0.5 * (math.sqrt((4.0 * Rad^2) - Chord^2))))
   Milling.MillTool1.PlungeRate              = RegistryRead:GetDouble("Milling.MillTool1.PlungeRate",            15.000)
  return segment
 
end -- function end
   Milling.MillTool2.FeedRate                = RegistryRead:GetDouble("Milling.MillTool2.FeedRate",              30.000)
-- =====================================================]]
   Milling.MillTool2.InMM                    = RegistryRead:GetBool("Milling.MillTool2.InMM ",                  false)
function RoundTo(Num, Per)                  -- Returns the number from
  Milling.MillTool2.Name                    = RegistryRead:GetString("Milling.MillTool2.Name",                  "No Tool Selected")
  local Head = Num < 0 and math.ceil(Num) or math.floor(Num)
  Milling.MillTool2.BitType                = RegistryRead:GetString("Milling.MillTool2.BitType",              "BALL_NOSE") -- BALL_NOSE, END_MILL, VBIT
  local Tail = Num - Head
  Milling.MillTool2.RateUnits              = RegistryRead:GetInt("Milling.MillTool2.RateUnits",                4)
  local Value = Head + tonumber(string.sub(tostring(Tail), 1, Per + 2))
  Milling.MillTool2.SpindleSpeed            = RegistryRead:GetInt("Milling.MillTool2.SpindleSpeed",            20000)
  return Value
  Milling.MillTool2.ToolNumber              = RegistryRead:GetInt("Milling.MillTool2.ToolNumber",              2)
end -- function end
  Milling.MillTool2.Stepdown                = RegistryRead:GetDouble("Milling.MillTool2.Stepdown",              0.2000)
-- =====================================================]]
  Milling.MillTool2.Stepover                = RegistryRead:GetDouble("Milling.MillTool2.Stepover",              0.0825)
function Round(x)
  Milling.MillTool2.ToolDia                = RegistryRead:GetDouble("Milling.MillTool2.ToolDia",              0.1250)
  return x>=0 and math.floor(x+0.5) or math.ceil(x-0.5)
  Milling.MillTool2.PlungeRate              = RegistryRead:GetDouble("Milling.MillTool2.PlungeRate",            15.000)
end
 
-- =====================================================]]
  Milling.MillTool3.FeedRate                = RegistryRead:GetDouble("Milling.MillTool3.FeedRate",              30.000)
function DecimalPlaces(Dnum, Plac)
  Milling.MillTool3.InMM                    = RegistryRead:GetBool("Milling.MillTool3.InMM",                    false)
  return tonumber(string.sub(tostring(Dnum)  .. "000000000000000000000000000000000000",1, string.len(tostring(math.floor(Dnum))) + 1 + Plac))
  Milling.MillTool3.Name                    = RegistryRead:GetString("Milling.MillTool3.Name",                  "No Tool Selected")
end
  Milling.MillTool3.BitType                = RegistryRead:GetString("Milling.MillTool3.BitType",              "END_MILL") -- BALL_NOSE, END_MILL, VBIT
-- =====================================================]]
   Milling.MillTool3.RateUnits              = RegistryRead:GetInt("Milling.MillTool3.RateUnits",                4)
function tointeger( x )
  Milling.MillTool3.SpindleSpeed            = RegistryRead:GetInt("Milling.MillTool3.SpindleSpeed",            20000)
    local num = tonumber( x )
  Milling.MillTool3.ToolNumber              = RegistryRead:GetInt("Milling.MillTool3.ToolNumber",              3)
    return num < 0 and math.ceil( num ) or math.floor( num )
  Milling.MillTool3.Stepdown                = RegistryRead:GetDouble("Milling.MillTool3.Stepdown",              0.2000)
end
  Milling.MillTool3.Stepover                = RegistryRead:GetDouble("Milling.MillTool3.Stepover",              0.0825)
-- =====================================================]]
  Milling.MillTool3.ToolDia                = RegistryRead:GetDouble("Milling.MillTool3.ToolDia",              0.1250)
-- ===TrigIt===
  Milling.MillTool3.PlungeRate              = RegistryRead:GetDouble("Milling.MillTool3.PlungeRate",            15.000)
-- Finds all 5 properties of a triangle
 
  function TrigIt(A, B, AB, AC, BC)
  Milling.MillTool4.FeedRate                = RegistryRead:GetDouble("Milling.MillTool4.FeedRate",              30.000)
-- Sub Function to help other functions
  Milling.MillTool4.InMM                    = RegistryRead:GetBool("Milling.MillTool4.InMM ",                  false)
-- Call = A, B, AB, AC, BC = Trig(A, B, AB, AC, BC)
  Milling.MillTool4.Name                    = RegistryRead:GetString("Milling.MillTool4.Name",                  "No Tool Selected")
-- C is the corner, A = small ang and B is the big angle
  Milling.MillTool4.PlungeRate              = RegistryRead:GetDouble("Milling.MillTool4.PlungeRate",            15.000)
-- returns all values
  Milling.MillTool4.RateUnits              = RegistryRead:GetInt("Milling.MillTool4.RateUnits",                4)
-- A, B = angles
  Milling.MillTool4.SpindleSpeed            = RegistryRead:GetInt("Milling.MillTool4.SpindleSpeed",            20000)
-- C = 90.0 Deg
  Milling.MillTool4.Stepdown                = RegistryRead:GetDouble("Milling.MillTool4.Stepdown",              0.2000)
-- B to C (BC) is Run - Base - adjacent
  Milling.MillTool4.Stepover                = RegistryRead:GetDouble("Milling.MillTool4.Stepover",              0.0825)
-- A to C (AC) is Rise - Height - opposite
  Milling.MillTool4.ToolDia                = RegistryRead:GetDouble("Milling.MillTool4.ToolDia",              0.1250)
-- A to B (AB) is Slope - hypotenuse
  Milling.MillTool4.ToolNumber              = RegistryRead:GetInt("Milling.MillTool4.ToolNumber",              5)
    if (B > 0.0) and (A == 0.0) then
 
      A = math.deg(math.rad(90) - math.rad(B))
  Milling.MillTool5.FeedRate                = RegistryRead:GetDouble("Milling.MillTool5.FeedRate",              30.000)
    end
  Milling.MillTool5.InMM                    = RegistryRead:GetBool("Milling.MillTool5.InMM ",                  false)
    if (A > 0.0) and (B == 0.0) then
  Milling.MillTool5.Name                    = RegistryRead:GetString("Milling.MillTool5.Name",                  "No Tool Selected")
      B = math.deg(math.rad(90) - math.rad(A))
   Milling.MillTool5.PlungeRate              = RegistryRead:GetDouble("Milling.MillTool5.PlungeRate",            15.000)
    end
  Milling.MillTool5.RateUnits              = RegistryRead:GetInt("Milling.MillTool5.RateUnits",                4)
    if  (AC > 0.0) and (BC > 0.0) then
  Milling.MillTool5.SpindleSpeed            = RegistryRead:GetInt("Milling.MillTool5.SpindleSpeed",            20000)
      AB = math.sqrt((AC ^ 2) + (BC ^ 2))
  Milling.MillTool5.Stepdown                = RegistryRead:GetDouble("Milling.MillTool5.Stepdown",              0.2000)
      A = math.deg(math.atan(BC/AC))
  Milling.MillTool5.Stepover                = RegistryRead:GetDouble("Milling.MillTool5.Stepover",              0.0825)
      B = math.deg(math.rad(90) - math.rad(A))
  Milling.MillTool5.ToolDia                = RegistryRead:GetDouble("Milling.MillTool5.ToolDia",              0.1250)
    elseif (AB > 0.0) and (BC > 0.0) then
  Milling.MillTool5.ToolNumber              = RegistryRead:GetInt("Milling.MillTool5.ToolNumber",              6)
      AB = math.sqrt((AB ^ 2) - (BC ^ 2))
   return true
      A = math.deg(math.atan(BC/AC))
end -- function end</nowiki>
      B = math.deg(math.rad(90) - math.rad(A))
    elseif (AB > 0.0) and (AC > 0.0) then
      AB = math.sqrt((AB ^ 2) - (AC ^ 2))
      A = math.deg(math.atan(BC/AC))
      B = math.deg(math.rad(90) - math.rad(A))
    elseif (A > 0.0) and (AC > 0.0) then
      AB = AC / math.cos(math.rad(A))
      BC = AB * math.sin(math.rad(A))
    elseif (A > 0.0) and (BC > 0.0) then
      AB = BC / math.sin(math.rad(A))
      AC = AB * math.cos(math.rad(A))
    elseif (A > 0.0) and (AB > 0.0) then
      BC = AB * math.sin(math.rad(A))
      AC = AB * math.cos(math.rad(A))
    else
      MessageBox("Error: No Missing Value")
    end -- if end
    return A, B, AB, AC, BC
  end
-- =====================================================]]
  function Maximum (a)                                  -- Returns the Max number from an array
-- print(maximum({8,10,23,12,5}))    --> 23  3
    local mi = 1 -- maximum index
    local m = a[mi]  -- maximum value
    for i,val in ipairs(a)  do
      if val > m then
        mi = i
        m = val
      end -- if end
    end
    return m, mi
  end  -- function end
-- =====================================================]]
  function IsEven(IsEven_Number)                        -- Returns True/False if number is even
    if (IsEven_Number % 2 == 0) then
      return true
    else
      return false
    end -- if end
  end -- function end
-- =====================================================]]
  function IsOdd(IsOdd_Number)                            -- Returns True/False if number is odd
    if(IsOdd_Number%2 == 0) then
      return false
    end -- end if
    return true
  end -- function end
-- =====================================================]]
end -- Math Tools function End
 
</nowiki>


This object is a name-value pair that represents a Document Variable within a [[VectricJob]].
----


<nowiki>
===RegistryWrite()===
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
-- =====================================================]]
  <nowiki>function RegistryWrite()                       -- Write to Registry values
╦═╗╔═╗╔═╗╦╔═╗╔╦╗╦═╗╦ ╦ ╔╦╗╔═╗╔═╗╦  ╔═╗
   local RegistryWrite = Registry("RegName")
╠╦╝║╣ ║ ╦║╚═╗ ║ ╠╦╝╚╦╝  ║ ║ ║║ ║║  ╚═╗
   local RegValue
╩╚═╚═╝╚═╝╩╚═╝ ╩ ╩╚═ ╩    ╩ ╚═╝╚═╝╩═╝╚═╝
   RegValue = RegistryWrite:SetBool("ProjectQuestion.CabinetName", true)
function RegistryTools()
  RegValue = RegistryWrite:SetDouble("BaseDim.CabDepth", 23.0000)
-- =====================================================]]
   RegValue = RegistryWrite:SetInt("BaseDim.CabHeight", 35)
function DocVarChk(Name, Value)
   RegValue = RegistryWrite:SetString("BaseDim.CabLength", "Words")
   local job = VectricJob()
 
   local document_variable_list = job.DocumentVariables
  RegValue = RegistryWrite:SetDouble("Milling.MillTool1.FeedRate" ,     Milling.MillTool1.FeedRate)
   return document_variable_list:DocumentVariableExists(Name)
   RegValue = RegistryWrite:SetBool("Milling.MillTool1.InMM",            Milling.MillTool1.InMM)
end -- function end
   RegValue = RegistryWrite:SetString("Milling.MillTool1.Name",         Milling.MillTool1.Name)
-- =====================================================]]
  RegValue = RegistryWrite:SetString("Milling.MillTool1.BitType",      Milling.MillTool1.BitType)
function DocVarGet(Name)
   RegValue = RegistryWrite:SetDouble("Milling.MillTool1.PlungeRate" ,  Milling.MillTool1.PlungeRate)
   local job = VectricJob()
   RegValue = RegistryWrite:SetInt("Milling.MillTool1.RateUnits",       Milling.MillTool1.RateUnits)
   local document_variable_list = job.DocumentVariables
  RegValue = RegistryWrite:SetInt("Milling.MillTool1.SpindleSpeed",     Milling.MillTool1.SpindleSpeed)
  return document_variable_list:GetDocumentVariable(Name, 0.0)
   RegValue = RegistryWrite:SetDouble("Milling.MillTool1.Stepdown" ,     Milling.MillTool1.Stepdown)
end -- function end
  RegValue = RegistryWrite:SetDouble("Milling.MillTool1.Stepover" ,     Milling.MillTool1.Stepover)
-- =====================================================]]
   RegValue = RegistryWrite:SetDouble("Milling.MillTool1.ToolDia" ,     Milling.MillTool1.ToolDia)
function DocVarSet(Name, Value)
  RegValue = RegistryWrite:SetInt("Milling.MillTool1.ToolNumber",       Milling.MillTool1.ToolNumber)
   local job = VectricJob()
 
   local document_variable_list = job.DocumentVariables
   RegValue = RegistryWrite:SetDouble("Milling.MillTool2.FeedRate" ,     Milling.MillTool2.FeedRate)
  return document_variable_list:SetDocumentVariable(Name, Value)
  RegValue = RegistryWrite:SetBool("Milling.MillTool2.InMM",           Milling.MillTool2.InMM)
end -- function end
   RegValue = RegistryWrite:SetString("Milling.MillTool2.Name",         Milling.MillTool2.Name)
-- =====================================================]]
  RegValue = RegistryWrite:SetString("Milling.MillTool2.BitType",       Milling.MillTool2.BitType)
function RegistryReadMaterial()               -- Read from Registry Material values for LUA Bit
   RegValue = RegistryWrite:SetDouble("Milling.MillTool2.PlungeRate" ,  Milling.MillTool2.PlungeRate)
   local RegistryRead              = Registry("Material")
   RegValue = RegistryWrite:SetInt("Milling.MillTool2.RateUnits",        Milling.MillTool2.RateUnits)
   Milling.SafeZGap                = Rounder(RegistryRead:GetString("SafeZGap",             "0.500"), 4)
   RegValue = RegistryWrite:SetInt("Milling.MillTool2.SpindleSpeed",     Milling.MillTool2.SpindleSpeed)
   Milling.StartZGap              = Rounder(RegistryRead:GetString("StartZGap",             "0.500"), 4)
   RegValue = RegistryWrite:SetDouble("Milling.MillTool2.Stepdown" ,     Milling.MillTool2.Stepdown)
   Milling.HomeX                  = Rounder(RegistryRead:GetString("HomeX",                 "0.000"), 4)
   RegValue = RegistryWrite:SetDouble("Milling.MillTool2.Stepover" ,     Milling.MillTool2.Stepover)
   Milling.HomeY                  = Rounder(RegistryRead:GetString("HomeY",                 "0.000"), 4)
   RegValue = RegistryWrite:SetDouble("Milling.MillTool2.ToolDia" ,     Milling.MillTool2.ToolDia)
   Milling.HomeZGap                = Rounder(RegistryRead:GetString("HomeZGap",             "0.750"), 4)
   RegValue = RegistryWrite:SetInt("Milling.MillTool2.ToolNumber",       Milling.MillTool2.ToolNumber)
   return true
 
end -- function end
   RegValue = RegistryWrite:SetDouble("Milling.MillTool3.FeedRate" ,     Milling.MillTool3.FeedRate)
-- =====================================================]]
   RegValue = RegistryWrite:SetBool("Milling.MillTool3.InMM",           Milling.MillTool3.InMM)
function RegistryLastTenFiles(FileName)       -- Adds to the top ten Log file list
   RegValue = RegistryWrite:SetString("Milling.MillTool3.Name",         Milling.MillTool3.Name)
   local Registry = Registry(RegName)
   RegValue = RegistryWrite:SetString("Milling.MillTool3.BitType",       Milling.MillTool3.BitType)
   LogFile.File10 = Registry:GetString("LogFile.File09", "No Log Yet" )
   RegValue = RegistryWrite:SetDouble("Milling.MillTool3.PlungeRate",    Milling.MillTool3.PlungeRate)
   LogFile.File09 = Registry:GetString("LogFile.File08", "No Log Yet" )
   RegValue = RegistryWrite:SetInt("Milling.MillTool3.RateUnits",        Milling.MillTool3.RateUnits)
   LogFile.File08 = Registry:GetString("LogFile.File07", "No Log Yet" )
   RegValue = RegistryWrite:SetInt("Milling.MillTool3.SpindleSpeed",    Milling.MillTool3.SpindleSpeed)
   LogFile.File07 = Registry:GetString("LogFile.File06", "No Log Yet" )
   RegValue = RegistryWrite:SetDouble("Milling.MillTool3.Stepdown" ,     Milling.MillTool3.Stepdown)
   LogFile.File06 = Registry:GetString("LogFile.File05", "No Log Yet" )
   RegValue = RegistryWrite:SetDouble("Milling.MillTool3.Stepover" ,     Milling.MillTool3.Stepover)
   LogFile.File05 = Registry:GetString("LogFile.File04", "No Log Yet" )
   RegValue = RegistryWrite:SetDouble("Milling.MillTool3.ToolDia" ,     Milling.MillTool3.ToolDia)
   LogFile.File04 = Registry:GetString("LogFile.File03", "No Log Yet" )
   RegValue = RegistryWrite:SetInt("Milling.MillTool3.ToolNumber",       Milling.MillTool3.ToolNumber)
   LogFile.File03 = Registry:GetString("LogFile.File02", "No Log Yet" )
   LogFile.File02 = Registry:GetString("LogFile.File01", "No Log Yet" )
   LogFile.File01 = FileName
   return FileName
end -- function end
-- =====================================================]]
function RegistryRead()                       -- Read from Registry values
   local RegistryRead = Registry("RegName")
   local Yes_No      = RegistryRead:GetBool("BaseDim.Yes_No", ture)
   local CabHeight    = RegistryRead:GetDouble("BaseDim.CabHeight", 35.500)
   local CabCount    = RegistryRead:GetInt("BaseDim.CabCount", 36)
   local Name        = RegistryRead:GetString("BaseDim.Name", "Words")


   Milling.MillTool1.FeedRate                = RegistryRead:GetDouble("Milling.MillTool1.FeedRate",             30.000)
   RegValue = RegistryWrite:SetDouble("Milling.MillTool4.FeedRate" ,     Milling.MillTool4.FeedRate)
   Milling.MillTool1.InMM                    = RegistryRead:GetBool("Milling.MillTool1.InMM ",                   false)
   RegValue = RegistryWrite:SetBool("Milling.MillTool4.InMM",           Milling.MillTool4.InMM)
   Milling.MillTool1.Name                    = RegistryRead:GetString("Milling.MillTool1.Name",                 "No Tool Selected")
   RegValue = RegistryWrite:SetString("Milling.MillTool4.Name",         Milling.MillTool4.Name)
   Milling.MillTool1.BitType                = RegistryRead:GetString("Milling.MillTool1.BitType",               "END_MILL") -- BALL_NOSE, END_MILL, VBIT
   RegValue = RegistryWrite:SetDouble("Milling.MillTool4.PlungeRate" ,  Milling.MillTool4.PlungeRate)
   Milling.MillTool1.RateUnits              = RegistryRead:GetInt("Milling.MillTool1.RateUnits",               4)
  RegValue = RegistryWrite:SetInt("Milling.MillTool4.RateUnits",       Milling.MillTool4.RateUnits)
   Milling.MillTool1.SpindleSpeed            = RegistryRead:GetInt("Milling.MillTool1.SpindleSpeed",             20000)
   RegValue = RegistryWrite:SetInt("Milling.MillTool4.SpindleSpeed",     Milling.MillTool4.SpindleSpeed)
  Milling.MillTool1.ToolNumber              = RegistryRead:GetInt("Milling.MillTool1.ToolNumber",              1)
   RegValue = RegistryWrite:SetDouble("Milling.MillTool4.Stepdown" ,     Milling.MillTool4.Stepdown)
   Milling.MillTool1.Stepdown                = RegistryRead:GetDouble("Milling.MillTool1.Stepdown",             0.2000)
   RegValue = RegistryWrite:SetDouble("Milling.MillTool4.Stepover" ,     Milling.MillTool4.Stepover)
   Milling.MillTool1.Stepover                = RegistryRead:GetDouble("Milling.MillTool1.Stepover",             0.0825)
   RegValue = RegistryWrite:SetDouble("Milling.MillTool4.ToolDia" ,     Milling.MillTool4.ToolDia)
   Milling.MillTool1.ToolDia                = RegistryRead:GetDouble("Milling.MillTool1.ToolDia",               0.1250)
   RegValue = RegistryWrite:SetInt("Milling.MillTool4.ToolNumber",       Milling.MillTool4.ToolNumber)
   Milling.MillTool1.PlungeRate              = RegistryRead:GetDouble("Milling.MillTool1.PlungeRate",           15.000)
  return true
end -- function end</nowiki>


  Milling.MillTool2.FeedRate                = RegistryRead:GetDouble("Milling.MillTool2.FeedRate",              30.000)
----
  Milling.MillTool2.InMM                    = RegistryRead:GetBool("Milling.MillTool2.InMM ",                  false)
  Milling.MillTool2.Name                    = RegistryRead:GetString("Milling.MillTool2.Name",                  "No Tool Selected")
  Milling.MillTool2.BitType                = RegistryRead:GetString("Milling.MillTool2.BitType",              "BALL_NOSE") -- BALL_NOSE, END_MILL, VBIT
  Milling.MillTool2.RateUnits              = RegistryRead:GetInt("Milling.MillTool2.RateUnits",                4)
  Milling.MillTool2.SpindleSpeed            = RegistryRead:GetInt("Milling.MillTool2.SpindleSpeed",            20000)
  Milling.MillTool2.ToolNumber              = RegistryRead:GetInt("Milling.MillTool2.ToolNumber",              2)
  Milling.MillTool2.Stepdown                = RegistryRead:GetDouble("Milling.MillTool2.Stepdown",              0.2000)
  Milling.MillTool2.Stepover                = RegistryRead:GetDouble("Milling.MillTool2.Stepover",              0.0825)
  Milling.MillTool2.ToolDia                = RegistryRead:GetDouble("Milling.MillTool2.ToolDia",              0.1250)
  Milling.MillTool2.PlungeRate              = RegistryRead:GetDouble("Milling.MillTool2.PlungeRate",            15.000)


  Milling.MillTool3.FeedRate                = RegistryRead:GetDouble("Milling.MillTool3.FeedRate",              30.000)
===REG_CheckRegistryBool()===
  Milling.MillTool3.InMM                    = RegistryRead:GetBool("Milling.MillTool3.InMM",                    false)
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
  Milling.MillTool3.Name                    = RegistryRead:GetString("Milling.MillTool3.Name",                  "No Tool Selected")
<nowiki>function REG_CheckRegistryBool()              -- Checks Registry for Bool values
  Milling.MillTool3.BitType                = RegistryRead:GetString("Milling.MillTool3.BitType",               "END_MILL")  -- BALL_NOSE, END_MILL, VBIT
   local RegistryRead = Registry("RegName")
   Milling.MillTool3.RateUnits              = RegistryRead:GetInt("Milling.MillTool3.RateUnits",                4)
   if RegistryRead:BoolExists("ProjectQuestion.Runtool") then
   Milling.MillTool3.SpindleSpeed            = RegistryRead:GetInt("Milling.MillTool3.SpindleSpeed",            20000)
    DisplayMessageBox("Alert: The Runtool value is saved.")
  Milling.MillTool3.ToolNumber              = RegistryRead:GetInt("Milling.MillTool3.ToolNumber",              3)
   else
   Milling.MillTool3.Stepdown                = RegistryRead:GetDouble("Milling.MillTool3.Stepdown",              0.2000)
    DisplayMessageBox("Alert: The Runtool value is not saved.")
   Milling.MillTool3.Stepover                = RegistryRead:GetDouble("Milling.MillTool3.Stepover",              0.0825)
   end -- if end
   Milling.MillTool3.ToolDia                = RegistryRead:GetDouble("Milling.MillTool3.ToolDia",              0.1250)
   return true
  Milling.MillTool3.PlungeRate              = RegistryRead:GetDouble("Milling.MillTool3.PlungeRate",            15.000)
end -- function end</nowiki>


  Milling.MillTool4.FeedRate                = RegistryRead:GetDouble("Milling.MillTool4.FeedRate",              30.000)
----
  Milling.MillTool4.InMM                    = RegistryRead:GetBool("Milling.MillTool4.InMM ",                  false)
  Milling.MillTool4.Name                    = RegistryRead:GetString("Milling.MillTool4.Name",                  "No Tool Selected")
  Milling.MillTool4.PlungeRate              = RegistryRead:GetDouble("Milling.MillTool4.PlungeRate",            15.000)
  Milling.MillTool4.RateUnits              = RegistryRead:GetInt("Milling.MillTool4.RateUnits",                4)
  Milling.MillTool4.SpindleSpeed            = RegistryRead:GetInt("Milling.MillTool4.SpindleSpeed",            20000)
  Milling.MillTool4.Stepdown                = RegistryRead:GetDouble("Milling.MillTool4.Stepdown",              0.2000)
  Milling.MillTool4.Stepover                = RegistryRead:GetDouble("Milling.MillTool4.Stepover",              0.0825)
  Milling.MillTool4.ToolDia                = RegistryRead:GetDouble("Milling.MillTool4.ToolDia",              0.1250)
  Milling.MillTool4.ToolNumber              = RegistryRead:GetInt("Milling.MillTool4.ToolNumber",              5)


  Milling.MillTool5.FeedRate                = RegistryRead:GetDouble("Milling.MillTool5.FeedRate",              30.000)
===REG_CheckRegistryDouble()===
  Milling.MillTool5.InMM                    = RegistryRead:GetBool("Milling.MillTool5.InMM ",                  false)
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
   Milling.MillTool5.Name                    = RegistryRead:GetString("Milling.MillTool5.Name",                  "No Tool Selected")
<nowiki>function REG_CheckRegistryDouble()             -- Checks Registry for Double values
   Milling.MillTool5.PlungeRate              = RegistryRead:GetDouble("Milling.MillTool5.PlungeRate",            15.000)
   local RegistryRead = Registry("RegName")
  Milling.MillTool5.RateUnits              = RegistryRead:GetInt("Milling.MillTool5.RateUnits",                4)
   if RegistryRead:DoubleExists("ProjectQuestion.ProjectCost") then
  Milling.MillTool5.SpindleSpeed            = RegistryRead:GetInt("Milling.MillTool5.SpindleSpeed",            20000)
    DisplayMessageBox("Alert: The project cost is saved.")
   Milling.MillTool5.Stepdown                = RegistryRead:GetDouble("Milling.MillTool5.Stepdown",              0.2000)
   else
  Milling.MillTool5.Stepover                = RegistryRead:GetDouble("Milling.MillTool5.Stepover",              0.0825)
    DisplayMessageBox("Alert: The Project Cost is not saved.")
  Milling.MillTool5.ToolDia                = RegistryRead:GetDouble("Milling.MillTool5.ToolDia",              0.1250)
   end -- if end
   Milling.MillTool5.ToolNumber              = RegistryRead:GetInt("Milling.MillTool5.ToolNumber",              6)
   return true
   return true
end -- function end
end -- function end</nowiki>
-- =====================================================]]
 
function RegistryWrite()                      -- Write to Registry values
----
  local RegistryWrite = Registry("RegName")
  local RegValue
  RegValue = RegistryWrite:SetBool("ProjectQuestion.CabinetName", true)
  RegValue = RegistryWrite:SetDouble("BaseDim.CabDepth", 23.0000)
  RegValue = RegistryWrite:SetInt("BaseDim.CabHeight", 35)
  RegValue = RegistryWrite:SetString("BaseDim.CabLength", "Words")


  RegValue = RegistryWrite:SetDouble("Milling.MillTool1.FeedRate" ,    Milling.MillTool1.FeedRate)
===REG_CheckRegistryInt()===
  RegValue = RegistryWrite:SetBool("Milling.MillTool1.InMM",            Milling.MillTool1.InMM)
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
  RegValue = RegistryWrite:SetString("Milling.MillTool1.Name",          Milling.MillTool1.Name)
<nowiki>function REG_CheckRegistryInt()               -- Checks Registry for Int values
   RegValue = RegistryWrite:SetString("Milling.MillTool1.BitType",      Milling.MillTool1.BitType)
   local RegistryRead = Registry("RegName")
   RegValue = RegistryWrite:SetDouble("Milling.MillTool1.PlungeRate" ,  Milling.MillTool1.PlungeRate)
   if RegistryRead:IntExists("ProjectQuestion.ProjectCount") then
  RegValue = RegistryWrite:SetInt("Milling.MillTool1.RateUnits",        Milling.MillTool1.RateUnits)
    DisplayMessageBox("Alert: The Project Count is saved.")
   RegValue = RegistryWrite:SetInt("Milling.MillTool1.SpindleSpeed",    Milling.MillTool1.SpindleSpeed)
   else
   RegValue = RegistryWrite:SetDouble("Milling.MillTool1.Stepdown" ,    Milling.MillTool1.Stepdown)
    DisplayMessageBox("Alert: The Project Count is not saved.")
   RegValue = RegistryWrite:SetDouble("Milling.MillTool1.Stepover" ,    Milling.MillTool1.Stepover)
   end -- if end
  RegValue = RegistryWrite:SetDouble("Milling.MillTool1.ToolDia" ,      Milling.MillTool1.ToolDia)
   return true
  RegValue = RegistryWrite:SetInt("Milling.MillTool1.ToolNumber",      Milling.MillTool1.ToolNumber)
end -- function end</nowiki>
 
----


  RegValue = RegistryWrite:SetDouble("Milling.MillTool2.FeedRate" ,    Milling.MillTool2.FeedRate)
===REG_CheckRegistryString()===
  RegValue = RegistryWrite:SetBool("Milling.MillTool2.InMM",            Milling.MillTool2.InMM)
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
  RegValue = RegistryWrite:SetString("Milling.MillTool2.Name",          Milling.MillTool2.Name)
<nowiki>function REG_CheckRegistryString()             -- Checks Registry for String values
   RegValue = RegistryWrite:SetString("Milling.MillTool2.BitType",      Milling.MillTool2.BitType)
   local RegistryRead = Registry("RegName")
   RegValue = RegistryWrite:SetDouble("Milling.MillTool2.PlungeRate" ,  Milling.MillTool2.PlungeRate)
   if RegistryRead:StringExists("ProjectQuestion.ProjectPath") then
  RegValue = RegistryWrite:SetInt("Milling.MillTool2.RateUnits",        Milling.MillTool2.RateUnits)
    DisplayMessageBox("Alert: The Project path is saved.")
   RegValue = RegistryWrite:SetInt("Milling.MillTool2.SpindleSpeed",    Milling.MillTool2.SpindleSpeed)
   else
  RegValue = RegistryWrite:SetDouble("Milling.MillTool2.Stepdown" ,    Milling.MillTool2.Stepdown)
    DisplayMessageBox("Alert: The Project path is not saved.")
   RegValue = RegistryWrite:SetDouble("Milling.MillTool2.Stepover" ,    Milling.MillTool2.Stepover)
   end
   RegValue = RegistryWrite:SetDouble("Milling.MillTool2.ToolDia" ,      Milling.MillTool2.ToolDia)
   return true
  RegValue = RegistryWrite:SetInt("Milling.MillTool2.ToolNumber",      Milling.MillTool2.ToolNumber)
end -- function end</nowiki>


  RegValue = RegistryWrite:SetDouble("Milling.MillTool3.FeedRate" ,    Milling.MillTool3.FeedRate)
==String Tools==
  RegValue = RegistryWrite:SetBool("Milling.MillTool3.InMM",           Milling.MillTool3.InMM)
[[File:Back.jpg|right|50px|link=Vectric Lua Interface for Gadgets]]
  RegValue = RegistryWrite:SetString("Milling.MillTool3.Name",         Milling.MillTool3.Name)
This object is a name-value pair that represents a Document Variable within a [[VectricJob]].
  RegValue = RegistryWrite:SetString("Milling.MillTool3.BitType",       Milling.MillTool3.BitType)
----
  RegValue = RegistryWrite:SetDouble("Milling.MillTool3.PlungeRate",    Milling.MillTool3.PlungeRate)
 
   RegValue = RegistryWrite:SetInt("Milling.MillTool3.RateUnits",        Milling.MillTool3.RateUnits)
===StringToArraySplit===
  RegValue = RegistryWrite:SetInt("Milling.MillTool3.SpindleSpeed",    Milling.MillTool3.SpindleSpeed)
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
  RegValue = RegistryWrite:SetDouble("Milling.MillTool3.Stepdown" ,     Milling.MillTool3.Stepdown)
<nowiki>function StringToArraySplit(s, delimiter)
   RegValue = RegistryWrite:SetDouble("Milling.MillTool3.Stepover" ,    Milling.MillTool3.Stepover)
--[[
   RegValue = RegistryWrite:SetDouble("Milling.MillTool3.ToolDia" ,      Milling.MillTool3.ToolDia)
split_string = StringToArraySplit("Hello World,Jim,Bill,Tom", ",")
   RegValue = RegistryWrite:SetInt("Milling.MillTool3.ToolNumber",      Milling.MillTool3.ToolNumber)
Returns = array
-- split_string[1] = "Hello World,)
-- split_string[2] = "Jim"
]]
   result = {};
  for match in (s..delimiter):gmatch("(.-)"..delimiter) do
      table.insert(result, match)
   end
   return result
end
   </nowiki>
 
----


  RegValue = RegistryWrite:SetDouble("Milling.MillTool4.FeedRate" ,     Milling.MillTool4.FeedRate)
===WrapString===
   RegValue = RegistryWrite:SetBool("Milling.MillTool4.InMM",           Milling.MillTool4.InMM)
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
  RegValue = RegistryWrite:SetString("Milling.MillTool4.Name",         Milling.MillTool4.Name)
<nowiki>
  RegValue = RegistryWrite:SetDouble("Milling.MillTool4.PlungeRate" ,   Milling.MillTool4.PlungeRate)
function WrapString(Str, Wid)                           -- wraps text at the nearest space and puts a return char in the space location
   RegValue = RegistryWrite:SetInt("Milling.MillTool4.RateUnits",        Milling.MillTool4.RateUnits)
   --[[  How to use:
   RegValue = RegistryWrite:SetInt("Milling.MillTool4.SpindleSpeed",    Milling.MillTool4.SpindleSpeed)
  Call WrapString(string, Number)
   RegValue = RegistryWrite:SetDouble("Milling.MillTool4.Stepdown" ,    Milling.MillTool4.Stepdown)
WrapString("Jim is a tall man that lives in Texas. He was raised in North East Texas on 1000 acres from 1970 to 1982. This is a man that knows numbers of great people from a round the world.", 40)
   RegValue = RegistryWrite:SetDouble("Milling.MillTool4.Stepover" ,    Milling.MillTool4.Stepover)
returns "Jim is a tall man that lives in Texas.\n
  RegValue = RegistryWrite:SetDouble("Milling.MillTool4.ToolDia" ,     Milling.MillTool4.ToolDia)
          He was raised in North East Texas on\n
  RegValue = RegistryWrite:SetInt("Milling.MillTool4.ToolNumber",       Milling.MillTool4.ToolNumber)
          1000 acres from 1970 to 1982. This is a man\n
  return true
          that knows numbers of great people from\n
end -- function end
          a round the world."
-- =====================================================]]
]]
function REG_CheckRegistryBool()              -- Checks Registry for Bool values
  local Wider = Wid
   local RegistryRead = Registry("RegName")
   local Posx = string.len(Str)
  if RegistryRead:BoolExists("ProjectQuestion.Runtool") then
   local StrLen = string.len(Str)
    DisplayMessageBox("Alert: The Runtool value is saved.")
   local pt = 0
  else
  local function FindSpace(MyStr)
     DisplayMessageBox("Alert: The Runtool value is not saved.")
   local Pos = string.len(MyStr)
   end -- if end
   local str = MyStr
   return true
    if string.find(MyStr, " ") ~= nil then
      while Pos>0 do
        Pos = Pos - 1
          if (string.byte(string.sub(str,-1)) == 32) then
            break
          else
            str = string.sub(str, 1, Pos)
          end
        end
    end
    return Pos
  end
   if StrLen > Wider then
    while Wider < Posx do
      pt = FindSpace(string.sub(Str,1, Wider))
      Str = string.sub(Str, 1, pt) .. "\n" ..  string.sub(Str, pt +2)
      Wider = Wider + Wid
     end
   end
   return Str
end -- function end
end -- function end
-- =====================================================]]
   </nowiki>
function REG_CheckRegistryDouble()            -- Checks Registry for Double values
 
   local RegistryRead = Registry("RegName")
----
  if RegistryRead:DoubleExists("ProjectQuestion.ProjectCost") then
 
    DisplayMessageBox("Alert: The project cost is saved.")
===CleanString===
  else
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
    DisplayMessageBox("Alert: The Project Cost is not saved.")
<nowiki>
  end -- if end
function CleanString(inStr)                         -- Check for ascii letters below 127
  return true
   local outStr, str1 = ""
end -- function end
   local inStrLen = string.len(inStr)
-- =====================================================]]
   for i = 1, inStrLen ,1 do
function REG_CheckRegistryInt()               -- Checks Registry for Int values
     str1 = string.sub(inStr, i, i)
   local RegistryRead = Registry("RegName")
    if string.byte(str1) <= 127 then
   if RegistryRead:IntExists("ProjectQuestion.ProjectCount") then
    outStr=outStr .. str1
    DisplayMessageBox("Alert: The Project Count is saved.")
     end
   else
     DisplayMessageBox("Alert: The Project Count is not saved.")
  end -- if end
  return true
end -- function end
-- =====================================================]]
function REG_CheckRegistryString()             -- Checks Registry for String values
  local RegistryRead = Registry("RegName")
  if RegistryRead:StringExists("ProjectQuestion.ProjectPath") then
    DisplayMessageBox("Alert: The Project path is saved.")
  else
     DisplayMessageBox("Alert: The Project path is not saved.")
   end
   end
   return true
   return outStr
end -- function end
end -- function end
-- =====================================================]]
  </nowiki>
end -- Registry end


</nowiki>
----


This object is a name-value pair that represents a Document Variable within a [[VectricJob]].
===GetDiameterAndCentre===
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
<nowiki>
function CheckString(YourStr)                          -- Check string for specal bite chars for HTML
  local function FindLetter(TheStr, TestChar)
    local outStr = false
    local strChar = ""
    local TheStrLen = string.len(TheStr)
    for i = 1, TheStrLen ,1 do
      strChar = string.sub(TheStr, i, i)
      if string.byte(strChar) == string.byte(TestChar) then
        outStr = true
        break
      end
    end
    return outStr
  end -- function end
  </nowiki>


<nowiki>
----
 
-- =====================================================]]
===GetDiameterAndCentre===
╔═╗╔╦╗╦═╗╦╔╗╔╔═╗ ╔╦╗╔═╗╔═╗╦ ╔═╗
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
╚═╗ ║ ╠╦╝║║║║║ ╦   ║ ║ ║║ ║║ ╚═╗
  <nowiki>
╚═╝ ╩ ╩╚═╩╝╚╝╚═╝   ╩ ╚═╝╚═╝╩═╝╚═╝
  local StrTest = false
function StringTools()
  StrTest = SwitchLetter(YourStr,  "&")  -- Non frendly File Name letters
-- =====================================================]]
  StrTest = SwitchLetter(YourStr, "#")
function StringToArraySplit(s, delimiter)
   StrTest = SwitchLetter(YourStr, "@")
--[[
   StrTest = SwitchLetter(YourStr,  "^")
split_string = StringToArraySplit("Hello World,Jim,Bill,Tom", ",")
  StrTest = SwitchLetter(YourStr,  "$")
Returns = array
    return outStr
-- split_string[1] = "Hello World,)
end -- function end
-- split_string[2] = "Jim"
  </nowiki>
]]
 
   result = {};
----
   for match in (s..delimiter):gmatch("(.-)"..delimiter) do
 
      table.insert(result, match)
===MakeHTMLReady()===
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
<nowiki>
function MakeHTMLReady(MyStr)                         -- fix's string with special bite chars for HTML
  local function SwitchLetter(MyStr, MyChar, NewStr)
  local outStr, str1 = ""
   local inStrLen = string.len(MyStr)
   for i = 1, inStrLen ,1 do
    str1 = string.sub(MyStr, i, i)
    if string.byte(str1) == string.byte(MyChar) then
    outStr=outStr .. NewStr
    else
        outStr=outStr .. str1
    end
   end
   end
   return result
   return outStr
end
end -- function end
-- =====================================================]]
  </nowiki>
function WrapString(Str, Wid)                           -- wraps text at the nearest space and puts a return char in the space location
 
   --[[  How to use:
----
   Call WrapString(string, Number)
 
WrapString("Jim is a tall man that lives in Texas. He was raised in North East Texas on 1000 acres from 1970 to 1982. This is a man that knows numbers of great people from a round the world.", 40)
===SwitchLetterTest===
returns "Jim is a tall man that lives in Texas.\n
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
          He was raised in North East Texas on\n
<nowiki>function SwitchLetterTest(MyStr)
          1000 acres from 1970 to 1982. This is a man\n
   local outStr = ""
          that knows numbers of great people from\n
   outStr = SwitchLetter(MyStr, "!", "&#33;")
          a round the world."
  outStr = SwitchLetter(outStr, "#", "&#35;")
]]
  outStr = SwitchLetter(outStr, "$", "&#36;")
   local Wider = Wid
  outStr = SwitchLetter(outStr, "%", "&#37;")
   local Posx = string.len(Str)
   outStr = SwitchLetter(outStr, "&", "&#38;")
   local StrLen = string.len(Str)
   outStr = SwitchLetter(outStr, "'", "&#39;")
   local pt = 0
   outStr = SwitchLetter(outStr, "(", "&#40;")
   local function FindSpace(MyStr)
   outStr = SwitchLetter(outStr, ")", "&#41;")
   local Pos = string.len(MyStr)
   outStr = SwitchLetter(outStr, "*", "&#42;")
   local str = MyStr
   outStr = SwitchLetter(outStr, "+", "&#43;")
    if string.find(MyStr, " ") ~= nil then
   outStr = SwitchLetter(outStr, ",", "&#44;")
      while Pos>0 do
  outStr = SwitchLetter(outStr, "-", "&#45;")
        Pos = Pos - 1
  outStr = SwitchLetter(outStr, ".", "&#46;")
          if (string.byte(string.sub(str,-1)) == 32) then
  outStr = SwitchLetter(outStr, "/", "&#47;")
            break
  outStr = SwitchLetter(outStr, ":", "&#58;")
          else
  outStr = SwitchLetter(outStr, ";", "&#59;")
            str = string.sub(str, 1, Pos)
  outStr = SwitchLetter(outStr, "<", "&#60;")
          end
   outStr = SwitchLetter(outStr, "=", "&#61;")
        end
   outStr = SwitchLetter(outStr, ">", "&#62;")
    end
  outStr = SwitchLetter(outStr, "?", "&#63;")
    return Pos
  outStr = SwitchLetter(outStr, "@", "&#64;")
   end
  outStr = SwitchLetter(outStr, "[", "&#91;")
   if StrLen > Wider then
  outStr = SwitchLetter(outStr, "]", "&#93;")
    while Wider < Posx do
  outStr = SwitchLetter(outStr, "^", "&#94;")
      pt = FindSpace(string.sub(Str,1, Wider))
  outStr = SwitchLetter(outStr, "_", "&#95;")
      Str = string.sub(Str, 1, pt) .. "\n" ..  string.sub(Str, pt +2)
  outStr = SwitchLetter(outStr, "`", "&#96;")
      Wider = Wider + Wid
  outStr = SwitchLetter(outStr, "{", "&#123")
    end
  outStr = SwitchLetter(outStr, "|", "&#124")
   end
   outStr = SwitchLetter(outStr, "}", "&#125")
   return Str
   outStr = SwitchLetter(outStr, "~", "&#126")
    return outStr
end -- function end
end -- function end
-- =====================================================]]
  </nowiki>
function CleanString(inStr)                             -- Check for ascii letters below 127
 
----
 
===SwitchLetter()===
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
<nowiki>function SwitchLetter(MyStr, MyChar, NewStr)           -- swwap a leter for another letter
   local outStr, str1 = ""
   local outStr, str1 = ""
   local inStrLen = string.len(inStr)
   local inStrLen = string.len(MyStr)
   for i = 1, inStrLen ,1 do
   for i = 1, inStrLen ,1 do
     str1 = string.sub(inStr, i, i)
     str1 = string.sub(MyStr, i, i)
     if string.byte(str1) <= 127 then
     if string.byte(str1) == string.byte(MyChar) then
     outStr=outStr .. str1
     outStr=outStr .. NewStr
    else
        outStr=outStr .. str1
     end
     end
   end
   end
   return outStr
   return outStr
end -- function end
end -- function end
   -- =====================================================]]
   </nowiki>
function CheckString(YourStr)                         -- Check string for specal bite chars for HTML
 
  local function FindLetter(TheStr, TestChar)
----
     local outStr = false
 
    local strChar = ""
===PadC===
     local TheStrLen = string.len(TheStr)
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
    for i = 1, TheStrLen ,1 do
<nowiki>function PadC(str, lenth)                       -- Adds spaces to front and back to center text in lenth
      strChar = string.sub(TheStr, i, i)
-- Local Word = PadC("K", 12) -- returns "     K      "
      if string.byte(strChar) == string.byte(TestChar) then
  if type(str) ~= "string" then
        outStr = true
     str = tostring(str)
        break
  end
      end
  if string.len(str) < lenth then
    end
  local a = math.floor(lenth - string.len(str) * 0.5) - 2
    return outStr
   local b = math.ceil(lenth - string.len(str) * 0.5) - 2
  end -- function end
   --print ("a = " .. a)
-- =====================================================]]
   for _ = 1, a, 1 do
   local StrTest = false
     str = " " .. str
  StrTest = SwitchLetter(YourStr,  "&") -- Non frendly File Name letters
   end
   StrTest = SwitchLetter(YourStr,  "#")
   for _ = 1, b, 1 do
  StrTest = SwitchLetter(YourStr,  "@")
     str = str .. " "
   StrTest = SwitchLetter(YourStr, "^")
  StrTest = SwitchLetter(YourStr, "$")
     return outStr
end -- function end
-- =====================================================]]
function MakeHTMLReady(MyStr)                          -- fixs string with specal bite chars for HTML
  local function SwitchLetter(MyStr, MyChar, NewStr)
  local outStr, str1 = ""
   local inStrLen = string.len(MyStr)
   for i = 1, inStrLen ,1 do
     str1 = string.sub(MyStr, i, i)
    if string.byte(str1) == string.byte(MyChar) then
    outStr=outStr .. NewStr
    else
        outStr=outStr .. str1
    end
   end
   end
   return outStr
  --print ("str len = " .. #str)
  end
   return str
end -- function end
end -- function end
-- =====================================================]]
  </nowiki>
  local outStr = ""
 
  outStr = SwitchLetter(MyStr, "!", "&#33;")
----
  outStr = SwitchLetter(outStr, "#", "&#35;")
 
  outStr = SwitchLetter(outStr, "$", "&#36;")
===PadR()===
   outStr = SwitchLetter(outStr, "%", "&#37;")
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
  outStr = SwitchLetter(outStr, "&", "&#38;")
<nowiki>function PadR(str, len)                       -- Adds spaces to Back of string
  outStr = SwitchLetter(outStr, "'", "&#39;")
-- Local Word = Pad("KPSDFKSPSK", 12) -- returns "KPSDFKSPSK  "
   outStr = SwitchLetter(outStr, "(", "&#40;")
   if type(str) ~= "string" then
   outStr = SwitchLetter(outStr, ")", "&#41;")
    str = tostring(str)
  outStr = SwitchLetter(outStr, "*", "&#42;")
   end
   outStr = SwitchLetter(outStr, "+", "&#43;")
   while string.len(str) < len do
   outStr = SwitchLetter(outStr, ",", "&#44;")
    str = str .. " "
  outStr = SwitchLetter(outStr, "-", "&#45;")
   end
  outStr = SwitchLetter(outStr, ".", "&#46;")
   return str
  outStr = SwitchLetter(outStr, "/", "&#47;")
end -- function end</nowiki>
  outStr = SwitchLetter(outStr, ":", "&#58;")
 
  outStr = SwitchLetter(outStr, ";", "&#59;")
----
  outStr = SwitchLetter(outStr, "<", "&#60;")
 
  outStr = SwitchLetter(outStr, "=", "&#61;")
===PadL()===
  outStr = SwitchLetter(outStr, ">", "&#62;")
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
  outStr = SwitchLetter(outStr, "?", "&#63;")
<nowiki>function PadL(str, len)             -- Adds spaces to Front of string
  outStr = SwitchLetter(outStr, "@", "&#64;")
-- Local Word = Pad("KPSDFKSPSK", 12) -- returns " KPSDFKSPSK"
  outStr = SwitchLetter(outStr, "[", "&#91;")
   if type(str) ~= "string" then
  outStr = SwitchLetter(outStr, "]", "&#93;")
    str = tostring(str)
  outStr = SwitchLetter(outStr, "^", "&#94;")
   end
  outStr = SwitchLetter(outStr, "_", "&#95;")
   while string.len(str) < len do
  outStr = SwitchLetter(outStr, "`", "&#96;")
     str = " " .. str
   outStr = SwitchLetter(outStr, "{", "&#123")
   end
  outStr = SwitchLetter(outStr, "|", "&#124")
   return str
  outStr = SwitchLetter(outStr, "}", "&#125")
end -- function end</nowiki>
   outStr = SwitchLetter(outStr, "~", "&#126")
 
    return outStr
----
end -- function end
 
-- =====================================================]]
===NumberPad()===
function SwitchLetter(MyStr, MyChar, NewStr)            -- swwap a leter for another letter
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
   local outStr, str1 = ""
<nowiki>function NumberPad(str, front, back) -- Adds spaces to front and zeros to the back of string
  local inStrLen = string.len(MyStr)
  local mychar
  for i = 1, inStrLen ,1 do
  local  a,b,c,d = 0,0,0,0
     str1 = string.sub(MyStr, i, i)
  local x,y,z = "","",""
    if string.byte(str1) == string.byte(MyChar) then
    outStr=outStr .. NewStr
    else
        outStr=outStr .. str1
    end
   end
   return outStr
end -- function end
-- =====================================================]]
function PadC(str, lenth)                       -- Adds spaces to front and back to center text in lenth
-- Local Word = PadC("K", 12) -- returns "     K      "
   if type(str) ~= "string" then
   if type(str) ~= "string" then
     str = tostring(str)
     str = tostring(str)
   end
   end
  if string.len(str) < lenth then
   c = string.len(str)
  local a = math.floor(lenth - string.len(str) * 0.5) - 2
   for i = 1, c, 1 do
  local b = math.ceil(lenth - string.len(str) * 0.5) - 2
     mychar = string.byte(string.sub(str, i,i))
  --print ("a = " .. a)
     if mychar == 46 then
  for _ = 1, a, 1 do
       b = i
    str =  " " .. str
  end
  for _ = 1, b, 1 do
    str =  str .. " "
  end
  --print ("str len = " .. #str)
  end
  return str
end -- function end
-- =====================================================]]
function PadR(str, len)                        -- Adds spaces to Back of string
-- Local Word = Pad("KPSDFKSPSK", 12) -- returns "KPSDFKSPSK  "
  if type(str) ~= "string" then
    str = tostring(str)
  end
  while string.len(str) < len do
    str = str .. " "
  end
  return str
end -- function end
-- =====================================================]]
function PadL(str, len)              -- Adds spaces to Front of string
-- Local Word = Pad("KPSDFKSPSK", 12) -- returns "  KPSDFKSPSK"
  if type(str) ~= "string" then
    str = tostring(str)
  end
  while string.len(str) < len do
    str = " " .. str
  end
  return str
end -- function end
-- =====================================================]]
function NumberPad(str, front, back) -- Adds spaces to front and zeros to the back of string
  local mychar
  local  a,b,c,d = 0,0,0,0
  local x,y,z = "","",""
  if type(str) ~= "string" then
    str = tostring(str)
  end
   c = string.len(str)
   for i = 1, c, 1 do
     mychar = string.byte(string.sub(str, i,i))
     if mychar == 46 then
       b = i
     end
     end
   end
   end
Line 5,549: Line 5,931:
   return str
   return str
end -- function end
end -- function end
-- =====================================================]]
  </nowiki>
function All_Trim(s)                          -- Trims spaces off both ends of a string
 
----
 
===All_Trim()===
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
<nowiki>function All_Trim(s)                          -- Trims spaces off both ends of a string
   return s:match( "^%s*(.-)%s*$" )
   return s:match( "^%s*(.-)%s*$" )
end -- function end
end -- function end
-- =====================================================]]
  </nowiki>
function Make_Proper_Case(str)
 
----
 
===MakeProperCase()===
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
<nowiki>function MakeProperCase(str)
   local str=string.gsub(string.lower(str),"^(%w)", string.upper)
   local str=string.gsub(string.lower(str),"^(%w)", string.upper)
   return string.gsub(str,"([^%w]%w)", string.upper)
   return string.gsub(str,"([^%w]%w)", string.upper)
end
end
-- =====================================================]]
  </nowiki>
function ifT(x)                                -- Converts Boolean True or False to String "Yes" or "No"
 
----
 
===ifT()===
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
<nowiki>function ifT(x)                                -- Converts Boolean True or False to String "Yes" or "No"
-- ===ifT(x)===
-- ===ifT(x)===
   if x then
   if x then
Line 5,567: Line 5,964:
   end-- if end
   end-- if end
end -- function end
end -- function end
-- =====================================================]]
  </nowiki>
function ifY(x)                                -- Converts String "Yes" or "No" to Boolean True or False
 
----
 
===ifY()===
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
<nowiki>function ifY(x)                                -- Converts String "Yes" or "No" to Boolean True or False
-- ===ifY(x)===
-- ===ifY(x)===
   if string.upper(x) == "YES" then
   if string.upper(x) == "YES" then
Line 5,575: Line 5,977:
     return false
     return false
   end-- if end
   end-- if end
end -- function end
end -- function end</nowiki>
-- =***************************************************=]]
end -- String function end


</nowiki>
==Seed Documents==
[https://jimandi.com/SDK/index.php/JimAndi_Toolbox (top)]
[[File:Back.jpg|right|50px|link=Vectric Lua Interface for Gadgets]]


This object is a name-value pair that represents a Document Variable within a [[VectricJob]].
This object is a name-value pair that represents a Document Variable within a [[VectricJob]].


  <nowiki>  
  <nowiki>-- =====================================================]]
-- =====================================================]]
╔═╗╔═╗╔═╗╔╦╗  ╔═╗╦ ╦╔╗╔╔═╗╔╦╗╦╔═╗╔╗╔
╔═╗╔═╗╔═╗╔╦╗  ╔═╗╦ ╦╔╗╔╔═╗╔╦╗╦╔═╗╔╗╔
╚═╗║╣ ║╣  ║║  ╠╣ ║ ║║║║║  ║ ║║ ║║║║
╚═╗║╣ ║╣  ║║  ╠╣ ║ ║║║║║  ║ ║║ ║║║║
╚═╝╚═╝╚═╝═╩╝  ╚  ╚═╝╝╚╝╚═╝ ╩ ╩╚═╝╝╚╝
╚═╝╚═╝╚═╝═╩╝  ╚  ╚═╝╝╚╝╚═╝ ╩ ╩╚═╝╝╚╝
function SeedTool()
-- =====================================================]]
-- =====================================================]]
   -- VECTRIC LUA SCRIPT
   -- VECTRIC LUA SCRIPT
Line 5,638: Line 6,037:


   return true
   return true
end  -- function end
end  -- function end</nowiki>
-- ==================== End ============================]]
-- =====================================================]]
end -- Seed Tools function end
 
</nowiki>


==Setup Tools==
[[File:Back.jpg|right|50px|link=Vectric Lua Interface for Gadgets]]
This object is a name-value pair that represents a Document Variable within a [[VectricJob]].
This object is a name-value pair that represents a Document Variable within a [[VectricJob]].


  <nowiki>  
  <nowiki>-- =====================================================]]
-- =====================================================]]
╔═╗╔═╗╔╦╗╦ ╦╔═╗
╔═╗╔═╗╔╦╗╦ ╦╔═╗
╚═╗║╣  ║ ║ ║╠═╝
╚═╗║╣  ║ ║ ║╠═╝
Line 5,708: Line 6,102:
</nowiki>
</nowiki>


==Toolpathing Tools==
[[File:Back.jpg|right|50px|link=Vectric Lua Interface for Gadgets]]
This object is a name-value pair that represents a Document Variable within a [[VectricJob]].
This object is a name-value pair that represents a Document Variable within a [[VectricJob]].


<nowiki>
----
 
-- =====================================================]]
===CreateLayerProfileToolpath===
╔╦╗╔═╗╔═╗╦  ╔═╗╔═╗╔╦╗╦ ╦╔═╗
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
║ ║ ║║ ║║  ╠═╝╠═╣ ║ ╠═╣╚═╗
<nowiki>function CreateLayerProfileToolpath(name, layer_name, start_depth, cut_depth, tool_dia, tool_stepdown, tool_in_mm)
╩ ╚═╝╚═╝╩═╝╩  ╩ ╩ ╩ ╩ ╩╚═╝
function Toolpaths()
-- =====================================================]]
  function CreateLayerProfileToolpath(name, layer_name, start_depth, cut_depth, tool_dia, tool_stepdown, tool_in_mm)
     -- clear current selection
     -- clear current selection
     local selection = job.Selection
     local selection = job.Selection
Line 5,832: Line 6,224:
     end
     end
     return true
     return true
end -- end function
end -- end function</nowiki>
-- =====================================================]]
 
  function CreateProfileToolpath(name, start_depth, cut_depth, tool_dia, tool_stepdown, tool_in_mm)
----
 
===CreateProfileToolpath===
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
<nowiki>function CreateProfileToolpath(name, start_depth, cut_depth, tool_dia, tool_stepdown, tool_in_mm)
     -- Create tool we will use to machine vectors
     -- Create tool we will use to machine vectors
     local tool = Tool("Lua End Mill", Tool.END_MILL) -- BALL_NOSE, END_MILL, VBIT
     local tool = Tool("Lua End Mill", Tool.END_MILL) -- BALL_NOSE, END_MILL, VBIT
Line 5,933: Line 6,329:
     end
     end
     return true
     return true
end -- end function
end -- end function</nowiki>
-- =====================================================]]
 
  function CreatePocketingToolpath(name, start_depth, cut_depth, tool_dia, tool_stepdown, tool_stepover_percent, tool_in_mm)
----
 
===CreatePocketingToolpath===
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
<nowiki>function CreatePocketingToolpath(name, start_depth, cut_depth, tool_dia, tool_stepdown, tool_stepover_percent, tool_in_mm)
   -- Create tool we will use to machine vectors
   -- Create tool we will use to machine vectors
     local tool = Tool("Lua End Mill",Tool.END_MILL) -- BALL_NOSE, END_MILL, VBIT
     local tool = Tool("Lua End Mill",Tool.END_MILL) -- BALL_NOSE, END_MILL, VBIT
Line 6,006: Line 6,406:
     end
     end
     return true
     return true
end -- end function
end -- end function</nowiki>
-- =====================================================]]
 
  function CreateDrillingToolpath(name, start_depth, cut_depth, retract_gap, tool_dia, tool_stepdown, tool_in_mm)
----
 
===CreateDrillingToolpath===
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
<nowiki>function CreateDrillingToolpath(name, start_depth, cut_depth, retract_gap, tool_dia, tool_stepdown, tool_in_mm)
   -- Create tool we will use to machine vectors
   -- Create tool we will use to machine vectors
     local tool = Tool("Lua Drill", Tool.THROUGH_DRILL) -- BALL_NOSE, END_MILL, VBIT, THROUGH_DRILL
     local tool = Tool("Lua Drill", Tool.THROUGH_DRILL) -- BALL_NOSE, END_MILL, VBIT, THROUGH_DRILL
Line 6,053: Line 6,457:
     end
     end
     return true
     return true
end -- end function
end -- end function</nowiki>
-- =====================================================]]
 
  function CreateVCarvingToolpath(name, start_depth, flat_depth, vbit_angle, vbit_dia, vbit_stepdown, tool_stepover_percent, tool_in_mm)
----
 
===CreateVCarvingToolpath===
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
<nowiki>function CreateVCarvingToolpath(name, start_depth, flat_depth, vbit_angle, vbit_dia, vbit_stepdown, tool_stepover_percent, tool_in_mm)
     --[[ -------------- CreateVCarvingToolpath --------------
     --[[ -------------- CreateVCarvingToolpath --------------
     |
     |
Line 6,087: Line 6,495:
     tool.ClearStepover = vbit_dia * (tool_stepover_percent / 100) * 2 -- used for vbit only
     tool.ClearStepover = vbit_dia * (tool_stepover_percent / 100) * 2 -- used for vbit only
     -- Create object used to set home position and safez gap above material surface
     -- Create object used to set home position and safez gap above material surface
     local pos_data = ToolpathPosData()
     local pos_data = ToolpathPosData()  
     -- vcarve_data:SetHomePosition(0, 0, 1.0)
     vcarve_data:SetHomePosition(Milling.HomeX, Milling.HomeY, Milling.HomeZGap ) -- vcarve_data:SetHomePosition(0, 0, 1.0)
     vcarve_data:SetHomePosition(Milling.HomeX, Milling.HomeY, Milling.HomeZGap )
     vcarve_data.SafeZGap = Milling.SafeZGap -- vcarve_data.SafeZGap = 0.5
    -- vcarve_data.SafeZGap = 0.5
     local vcarve_data = VCarveParameterData() -- Create object used to pass pocketing options - used for area clearance only
     vcarve_data.SafeZGap = Milling.SafeZGap
     vcarve_data.StartDepth = start_depth    -- start depth for toolpath
    -- Create object used to pass pocketing options - used for area clearance only
     vcarve_data.DoFlatBottom = flat_depth > 0.0    -- flag indicating if we are creating a flat bottomed toolpath
     local vcarve_data = VCarveParameterData()
     vcarve_data.FlatDepth = flat_depth   -- cut depth for toolpath this is depth below start depth
    -- start depth for toolpath
     vcarve_data.ProjectToolpath = false    -- if true in Aspire, project toolpath onto composite model
     vcarve_data.StartDepth = start_depth
     vcarve_data.UseAreaClearTool = true    -- set flag indicating we are using flat tool
    -- flag indicating if we are creating a flat bottomed toolpath
     local pocket_data = PocketParameterData()    -- Create object used to pass pocketing options - used for area clearance only
     vcarve_data.DoFlatBottom = flat_depth > 0.0
     pocket_data.StartDepth = start_depth    -- start depth for toolpath
    -- cut depth for toolpath this is depth below start depth
     pocket_data.CutDepth = flat_depth    -- cut depth for toolpath this is depth below start depth
     vcarve_data.FlatDepth = flat_depth
     pocket_data.CutDirection = ProfileParameterData.CLIMB_DIRECTION    -- direction of cut for offet clearance - ProfileParameterData.CLIMB_DIRECTION or ProfileParameterData.CONVENTIONAL_DIRECTION - NOTE: enum from ProfileParameterData
    -- if true in Aspire, project toolpath onto composite model
 
     vcarve_data.ProjectToolpath = false
     -- if true use raster clearance strategy , else use offset area clearance
    -- set flag indicating we are using flat tool
     vcarve_data.UseAreaClearTool = true
    -- Create object used to pass pocketing options - used for area clearance only
     local pocket_data = PocketParameterData()
    -- start depth for toolpath
     pocket_data.StartDepth = start_depth
    -- cut depth for toolpath this is depth below start depth
     pocket_data.CutDepth = flat_depth
    -- direction of cut for offet clearance - ProfileParameterData.CLIMB_DIRECTION
    -- or ProfileParameterData.CONVENTIONAL_DIRECTION - NOTE: enum from ProfileParameterData
    pocket_data.CutDirection = ProfileParameterData.CLIMB_DIRECTION
     -- if true use raster clearance strategy , else use offset area clearance
     pocket_data.DoRasterClearance = false
     pocket_data.DoRasterClearance = false
     -- set flag indicating we are using flat tool
     -- set flag indicating we are using flat tool
Line 6,139: Line 6,535:
     area_clear_tool.SpindleSpeed = 20000
     area_clear_tool.SpindleSpeed = 20000
     area_clear_tool.ToolNumber = 2
     area_clear_tool.ToolNumber = 2
     -- Create object which can be used to automatically select geometry
     local geometry_selector = GeometrySelector()    -- Create object which can be used to automatically select geometry
    local geometry_selector = GeometrySelector()
     -- Create our toolpath
     -- Create our toolpath
     local toolpath_manager = ToolpathManager()
     local toolpath_manager = ToolpathManager()
     local toolpath_id = toolpath_manager:CreateVCarvingToolpath(name,tool,area_clear_tool,vcarve_data,pocket_data,pos_data,geometry_selector,create_2d_previews,display_warnings)
     local toolpath_id = toolpath_manager:CreateVCarvingToolpath(name,tool, area_clear_tool,vcarve_data, pocket_data,pos_data,geometry_selector, create_2d_previews,display_warnings)
     if toolpath_id == nil then
     if toolpath_id == nil then
       DisplayMessageBox("Error creating toolpath")
       DisplayMessageBox("Error creating toolpath")
Line 6,149: Line 6,544:
     end
     end
     return true
     return true
end -- end function
end -- end function</nowiki>
-- =====================================================]]
 
  function CreatePrismToolpath(name, start_depth, cut_depth, vbit_angle, vbit_dia, vbit_stepdown, tool_stepover_percent, tool_in_mm)
----
 
===CreatePrismToolpath===
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
<nowiki>function CreatePrismToolpath(name, start_depth, cut_depth, vbit_angle, vbit_dia, vbit_stepdown, tool_stepover_percent, tool_in_mm)
   --[[ ------------------- CreatePrismToolpath -------------------
   --[[ ------------------- CreatePrismToolpath -------------------
   |
   |
Line 6,200: Line 6,599:
     if min_bevel_depth > cut_depth then
     if min_bevel_depth > cut_depth then
       DisplayMessageBox("A prism will not be fully formed with a depth of " .. cut_depth .. "\r\n" ..
       DisplayMessageBox("A prism will not be fully formed with a depth of " .. cut_depth .. "\r\n" ..
                         "A depth of " .. min_bevel_depth .. " is required to fully form the prism"
                         "A depth of " .. min_bevel_depth .. " is required to fully form the prism")
                        )
     end -- if end
     end -- if end
     -- Create object which can be used to automatically select geometry
     -- Create object which can be used to automatically select geometry
Line 6,217: Line 6,615:
     end -- if end
     end -- if end
     return true
     return true
end -- end function
end -- end function</nowiki>
-- =====================================================]]
 
  function CreateFlutingToolpath(name, start_depth, cut_depth, tool_dia, tool_stepdown, tool_in_mm)
----
 
===CreateFlutingToolpath===
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
<nowiki>function CreateFlutingToolpath(name, start_depth, cut_depth, tool_dia, tool_stepdown, tool_in_mm)
     --[[ ----------------- CreateFlutingToolpath -----------------
     --[[ ----------------- CreateFlutingToolpath -----------------
   | Create a flutting toolpath within the program for the currently selected vectors
   | Create a flutting toolpath within the program for the currently selected vectors
Line 6,251: Line 6,653:
     pos_data:SetHomePosition(0, 0, 1.0)
     pos_data:SetHomePosition(0, 0, 1.0)
     pos_data.SafeZGap = 5.0
     pos_data.SafeZGap = 5.0
     -- Create object used to pass fluting options
     -- Create object used to pass fluting options
     local fluting_data = FlutingParameterData()
     local fluting_data = FlutingParameterData()
     -- start depth for toolpath
     -- start depth for toolpath
     fluting_data.StartDepth = start_depth
     fluting_data.StartDepth = start_depth
     -- cut depth for toolpath this is depth below start depth
     -- cut depth for toolpath this is depth below start depth
     fluting_data.CutDepth = cut_depth
     fluting_data.CutDepth = cut_depth
     -- type of fluting FULL_LENGTH, RAMP_START or RAMP_START_END
     -- type of fluting FULL_LENGTH, RAMP_START or RAMP_START_END
     fluting_data.FluteType = FlutingParameterData.RAMP_START_END
     fluting_data.FluteType = FlutingParameterData.RAMP_START_END
     -- type of ramping RAMP_LINEAR, RAMP_SMOOTH
     -- type of ramping RAMP_LINEAR, RAMP_SMOOTH
     fluting_data.RampType = FlutingParameterData.RAMP_LINEAR
     fluting_data.RampType = FlutingParameterData.RAMP_LINEAR
     -- if true use ratio field for controling ramp length else absolute length value
     -- if true use ratio field for controling ramp length else absolute length value
     fluting_data.UseRampRatio = false
     fluting_data.UseRampRatio = false
     -- length of ramp as ratio of flute length(range 0 - 1.0)
     -- length of ramp as ratio of flute length(range 0 - 1.0)
     -- (for start and end - ratio is of half length)
     -- (for start and end - ratio is of half length)
     fluting_data.RampRatio = 0.2
     fluting_data.RampRatio = 0.2
     -- length to ramp over - if UseRampRatio == false
     -- length to ramp over - if UseRampRatio == false
     fluting_data.RampLength = 15
     fluting_data.RampLength = 15
     -- if true in Aspire, project toolpath onto composite model
     -- if true in Aspire, project toolpath onto composite model
     fluting_data.ProjectToolpath = false
     fluting_data.ProjectToolpath = false
     -- Create object which can be used to automatically select geometry
     -- Create object which can be used to automatically select geometry
     local geometry_selector = GeometrySelector()
     local geometry_selector = GeometrySelector()
     -- if this is true we create 2d toolpaths previews in 2d view, if false we dont
     -- if this is true we create 2d toolpaths previews in 2d view, if false we dont
     local create_2d_previews = true
     local create_2d_previews = true
     -- if this is true we will display errors and warning to the user
     -- if this is true we will display errors and warning to the user
     local display_warnings = true
     local display_warnings = true
     -- Create our toolpath
     -- Create our toolpath
     local toolpath_manager = ToolpathManager()
     local toolpath_manager = ToolpathManager()
     local toolpath_id = toolpath_manager:CreateFlutingToolpath(name, tool, fluting_data, pos_data, geometry_selector, create_2d_previews, display_warnings)
     local toolpath_id = toolpath_manager:CreateFlutingToolpath(name, tool, fluting_data, pos_data, geometry_selector, create_2d_previews, display_warnings)
     if toolpath_id == nil then
     if toolpath_id == nil then
       DisplayMessageBox("Error creating toolpath")
       DisplayMessageBox("Error creating toolpath")
       return false
       return false
     else
     else
       return true
       return true
     end
     end
 
    end -- end function</nowiki>
 
----


    end -- end function
===SelectVectorsOnLayer===
-- =====================================================]]
[[File:TopOfPage.png|right|50px|link=JimAndi Toolbox]]
  function SelectVectorsOnLayer(layer, selection, select_closed, select_open, select_groups)
<nowiki>function SelectVectorsOnLayer(layer, selection, select_closed, select_open, select_groups)
     -- Please Note: SelectVectorsOnLayer is provided by Vectric and can be found in the SDK and Sample Gadget files.
     -- Please Note: SelectVectorsOnLayer is provided by Vectric and can be found in the SDK and Sample Gadget files.
     --[[  ---------------- SelectVectorsOnLayer ----------------
     --[[  ---------------- SelectVectorsOnLayer ----------------
Line 6,340: Line 6,746:
     return objects_selected
     return objects_selected
   end -- function end
   end -- function end
-- =====================================================]]
</nowiki>  
end -- Toolpaths function end
[[Category:SDK]]
 
-- =====================================================]]
 
</nowiki>
 
 
[[File:Back.jpg|right|50px|link=Vectric Lua Interface for Gadgets]]
==References==
==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 [https://gadgets.vectric.com/developerinfo.html Vertric Developer Information]
'''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 [https://gadgets.vectric.com/developerinfo.html Vertric Developer Information]

Latest revision as of 10:21, 16 November 2024

Back.jpg

Table and Array Tools

This object is a name-value pair that represents a Document Variable within a VectricJob.

ArrayClear

TopOfPage.png

ArrayClear - Clears the data from a data array.

local tbl = {1, 2, 5, 6}

tbl = ArrayClear(tbl)

returns tbl = {}

 function ArrayClear(arrayName)
   for _,v in ipairs(arrayName) do
     table.remove(arrayName, i)
   end -- for end
   return true
  end -- function end 

NameCheck

TopOfPage.png

Checks if Name is in the list of it is default name.

a = {1, 2, 5, 6}

Words = NameCheck(a, 5) -- returns true

  function NameCheck(Name, Defalt, ListName)
     if Name ~= Defalt then
       for i=1, ListName do
         if Name == i then
           return true
         end
       end
       return false
     else
       return  true
     end
  end -- function end 

RemoveDuplicates

TopOfPage.png

Returns table of unique items in "A" acending or "D" decending

local tbl = {1, 2, 5, 3, 5, 6, 4}

tbl = ArrayClear(tbl, "A")

returns tbl = {1, 2, 3, 4, 5, 6}
  function RemoveDuplicates(tab, order)
     local hashSet = {}
     local new = {}
     local value
     for i = 1, #tab do
       value = (tab[i])
       if hashSet[value] == nil then
         table.insert(new, value)
         hashSet[value] = true
       end
     end
     if string.upper(order) =="A" then
       table.sort(new)
     else
       table.sort(new, function(a, b) return a > b end)
     end
     return new
  end -- function end 

RemoveTableItem

TopOfPage.png

Returns table with item removed.

local tbl = {1, 2, 3, 4, 5, 6}

tbl = RemoveTableItem(tbl, 4)

returns tbl = {1, 2, 3, 5, 6}
  function RemoveTableItem(tabName, tabItem)
     for x = 1 in ipairs(tabName) do
       if tabName[x] == tabItem then
          table.remove(tabName, i)
       end
     end -- for end
     return true
  end -- function end 

TableLength

TopOfPage.png
 Returns table item count
 local tbl = {1, 2, 3, 4, 5, 6}
 tbl = TableLength(tbl)

 returns tbl = 6
-- =====================================================]]
  function TableLength(tbl)
     -- tbl = {7, 6, 5, 4, 3, 2, 1}
     local count = 0
     for _ in pairs(tbl) do
       count = count + 1
     end
     return count
  end -- function end 

FindDups

TopOfPage.png

Find all duplicate items and returns two tables the dup and clean tables

Returns table item count

local tbl = {1, 2, 2, 4, 4, 6}

local tbl1 = {}

local tbl2 = {}

tbl1, tbl2 = TableLength(tbl)

returns tbl1, tbl2 = 6

 function FindDups(checktbl, duptbl, cleantbl)
     function tLength(tbl) -- tLength returns table count
       local count = 0
       for _ in pairs(tbl) do
         count = count + 1
       end
       return count
     end
     -- =================================
     local trip = false
     for i=1, tLength(checktbl) do
       for x=1, tLength(cleantbl) do
         if cleantbl[x] == checktbl[i] then
           trip = true
         end
       end
       if trip then
         table.insert(duptbl,   checktbl[i])
       else
         table.insert(cleantbl, checktbl[i])
       end
       trip = false
     end
     return table.sort(duptbl), table.sort(cleantbl)
  end -- function end 

ReverseTable

TopOfPage.png

Returns a reversed table

local tbl = {1, 2, 3, 4, 5, 6}

tbl = ReverseTable(tbl)

returns tbl = {6, 5, 4, 3, 2, 1}

 function ReverseTable(tbl)
    --tbl = {7, 6, 7, A, 5, 4, 3, A, 2, 1}
     local n = #tbl
     local i = 1
     while i < n do
       tbl[i],tbl[n] = tbl[n],tbl[i]
       i = i + 1
       n = n - 1
     end
     return tbl
  end -- function end 

Conversion Tools

Back.jpg

This collection of functions that assist in the conversion activities.

Bool2Str

TopOfPage.png

bool2Str - Converts true or false as a string. local x = true tbl = bool2Str(x) -- =====================================================]] returns "true" function Bool2Str(x) if x then return "true" else return "false" end end --function end


D2S8

TopOfPage.png
 D2S8 - Converts a Number (Double) to a String with 8 places

 function D2S8(d)                               -- Converts a Number (Double) to a String with 8 places
-- local x =12.2351
-- returns "12.23510000"
-- =====================================================]]
    return string.format("%.8f", d)
  end -- end function 

D2S4

TopOfPage.png
 D2S4 - Converts a Number (Double) to a String with 4 places
 local x =12.23
  = D2S4(x)

 returns x = "12.2300"
-- =====================================================]]
  function D2S4(d) 
    return string.format("%.4f", d)
  end -- end function 

Toint

TopOfPage.png
 Toint - Converts a Double Number to a intiger
 local x = 12.23
  = toint(x)

 returns x = 12
  function toint(number)
    return math.floor(tonumber(number) or error("Could not cast '" .. tostring(number) .. "' to number.'"))
  end -- end function 

Rounder

TopOfPage.png
 return tonumber(string.format("%." .. (idp or 0) .. "f", n

-- =====================================================]]
function Rounder(num, idp)                              --  Rounds a Number (Double) up or down
  return tonumber(string.format("%." .. (idp or 0) .. "f", num))
end -- end function 

RUsame

TopOfPage.png
-- =====================================================]]
function RUsame(num, comp)                              --  Rounds a Number (Double) up or down
  local function toint(number)
    return math.floor(tonumber(number) or error("Could not cast '" .. tostring(number) .. "' to number.'"))
  end
  local function Rounder(num, idp)                      --  Rounds a Number (Double) up or down
    return tonumber(string.format("%." .. (idp or 0) .. "f", num))
  end -- end function
        num = math.abs(num)
  local idp = #comp
  local Mynum = Rounder(num, idp)
  local Myint = toint(Mynum)
  local Myval = tonumber(tostring(Myint) .. "." .. comp)
  if (Mynum == Myval) then
    return true
  else
    return false
  end -- if end
end -- end function 

WithIn

TopOfPage.png

Retuns true if number is within tolerance with match


 function WithIn(Num, Mat, Tol)
    if ((Num >= (Mat - Tol)) and (Num <= (Mat + Tol))) then
      return true
    end -- if end
    return false
  end -- end function 

Double2Fraction

TopOfPage.png

Converts a Measurement (Double) to a Fractional String

local txt = Double2Fraction(1.25)

returns txt ="1-1/4"

 function Double2Fraction(Num)
  local Frac = "Error"
  if Num then
    Frac = tostring(Num)
  end
  if (not Milling.Unit) and Num then
    local AmountValuex = math.floor(math.abs(Num))
    local DicValue    = Num - AmountValuex
    local AmountValue = tostring(AmountValuex)
    Frac              = tostring(DicValue)

    if Project.Fractions == "No Fractions" then
      Frac = tostring(Num)

    elseif Project.Fractions == "1/8" then
      if     DicValue >= 0.9375 then
        AmountValue = tostring(AmountValuex + 1)
        Frac = "0"
      elseif DicValue >= 0.8125 then Frac = "7/8" .. string.char(34)
      elseif DicValue >= 0.6875 then Frac = "3/4" .. string.char(34)
      elseif DicValue >= 0.5625 then Frac = "5/8" .. string.char(34)
      elseif DicValue >= 0.4375 then Frac = "1/2" .. string.char(34)
      elseif DicValue >= 0.3125 then Frac = "3/8" .. string.char(34)
      elseif DicValue >= 0.1875 then Frac = "1/4" .. string.char(34)
      elseif DicValue >= 0.0625 then Frac = "1/8" .. string.char(34)
      else
        Frac = "0"
      end
    elseif Project.Fractions == "1/16" then
      if     DicValue >= 0.96875 then
        AmountValue = tostring(AmountValuex + 1)
        Frac = "0"
      elseif DicValue >= 0.90625 then Frac = "15/16" .. string.char(34)
      elseif DicValue >= 0.84375 then Frac = "7/8"   .. string.char(34)
      elseif DicValue >= 0.78125 then Frac = "13/16" .. string.char(34)
      elseif DicValue >= 0.71875 then Frac = "3/4"   .. string.char(34)
      elseif DicValue >= 0.65625 then Frac = "11/16" .. string.char(34)
      elseif DicValue >= 0.59375 then Frac = "5/8"   .. string.char(34)
      elseif DicValue >= 0.53125 then Frac = "9/16"  .. string.char(34)
      elseif DicValue >= 0.46875 then Frac = "1/2"   .. string.char(34)
      elseif DicValue >= 0.40625 then Frac = "7/16"  .. string.char(34)
      elseif DicValue >= 0.34375 then Frac = "3/8"   .. string.char(34)
      elseif DicValue >= 0.28125 then Frac = "5/16"  .. string.char(34)
      elseif DicValue >= 0.21875 then Frac = "1/4"   .. string.char(34)
      elseif DicValue >= 0.15625 then Frac = "3/16"  .. string.char(34)
      elseif DicValue >= 0.09375 then Frac = "1/8"   .. string.char(34)
      elseif DicValue >= 0.03125 then Frac = "1/16"  .. string.char(34)
      else
        Frac = "0"
      end -- If end
    elseif Project.Fractions == "1/32" then
      if     DicValue >= 0.984375 then
        AmountValue = tostring(AmountValuex + 1)
        Frac = "0"
      elseif DicValue >= 0.953126 then Frac = "31/32" .. string.char(34)
      elseif DicValue >= 0.921876 then Frac = "15/16" .. string.char(34)
      elseif DicValue >= 0.890626 then Frac = "29/32" .. string.char(34)
      elseif DicValue >= 0.859376 then Frac = "7/8"   .. string.char(34)
      elseif DicValue >= 0.828126 then Frac = "27/32" .. string.char(34)
      elseif DicValue >= 0.796876 then Frac = "13/16" .. string.char(34)
      elseif DicValue >= 0.765626 then Frac = "25/32" .. string.char(34)
      elseif DicValue >= 0.737376 then Frac = "3/4"   .. string.char(34)
      elseif DicValue >= 0.703126 then Frac = "23/32" .. string.char(34)
      elseif DicValue >= 0.671876 then Frac = "11/16" .. string.char(34)
      elseif DicValue >= 0.640626 then Frac = "21/32" .. string.char(34)
      elseif DicValue >= 0.609376 then Frac = "5/8"   .. string.char(34)
      elseif DicValue >= 0.578126 then Frac = "19/32" .. string.char(34)
      elseif DicValue >= 0.541260 then Frac = "9/16"  .. string.char(34)
      elseif DicValue >= 0.515626 then Frac = "17/32" .. string.char(34)
      elseif DicValue >= 0.484376 then Frac = "1/2"   .. string.char(34)
      elseif DicValue >= 0.468760 then Frac = "15/32" .. string.char(34)
      elseif DicValue >= 0.421876 then Frac = "7/16"  .. string.char(34)
      elseif DicValue >= 0.390626 then Frac = "13/32" .. string.char(34)
      elseif DicValue >= 0.359376 then Frac = "3/8"   .. string.char(34)
      elseif DicValue >= 0.328126 then Frac = "11/32" .. string.char(34)
      elseif DicValue >= 0.296876 then Frac = "5/16"  .. string.char(34)
      elseif DicValue >= 0.265626 then Frac = "9/32"  .. string.char(34)
      elseif DicValue >= 0.234376 then Frac = "1/4"   .. string.char(34)
      elseif DicValue >= 0.203126 then Frac = "7/32"  .. string.char(34)
      elseif DicValue >= 0.171876 then Frac = "3/16"  .. string.char(34)
      elseif DicValue >= 0.140626 then Frac = "5/32"  .. string.char(34)
      elseif DicValue >= 0.109376 then Frac = "1/8"   .. string.char(34)
      elseif DicValue >= 0.078126 then Frac = "3/32"  .. string.char(34)
      elseif DicValue >= 0.046876 then Frac = "1/16"  .. string.char(34)
      elseif DicValue >= 0.015626 then Frac = "1/32"  .. string.char(34)
      else
        Frac = "0"
      end -- If end
    elseif Project.Fractions == "1/64" then
      if     DicValue >= 0.9921875 then
        AmountValue = tostring(AmountValuex + 1)
        Frac = "0"
        elseif DicValue >= 0.9765625 then Frac = "62/64" .. string.char(34)
        elseif DicValue >= 0.9609375 then Frac = "31/32" .. string.char(34)
        elseif DicValue >= 0.9453125 then Frac = "61/64" .. string.char(34)
        elseif DicValue >= 0.9296875 then Frac = "15/16" .. string.char(34)
        elseif DicValue >= 0.9140625 then Frac = "59/64" .. string.char(34)
        elseif DicValue >= 0.8984375 then Frac = "29/32" .. string.char(34)
        elseif DicValue >= 0.8828125 then Frac = "57/64" .. string.char(34)
        elseif DicValue >= 0.8671875 then Frac = "7/8"   .. string.char(34)
        elseif DicValue >= 0.8515625 then Frac = "55/64" .. string.char(34)
        elseif DicValue >= 0.8359375 then Frac = "27/32" .. string.char(34)
        elseif DicValue >= 0.8203125 then Frac = "53/64" .. string.char(34)
        elseif DicValue >= 0.8046875 then Frac = "13/16" .. string.char(34)
        elseif DicValue >= 0.7890625 then Frac = "51/64" .. string.char(34)
        elseif DicValue >= 0.7734375 then Frac = "25/32" .. string.char(34)
        elseif DicValue >= 0.7578125 then Frac = "49/64" .. string.char(34)
        elseif DicValue >= 0.7421875 then Frac = "3/4"   .. string.char(34)
        elseif DicValue >= 0.7265625 then Frac = "47/64" .. string.char(34)
        elseif DicValue >= 0.7109375 then Frac = "23/32" .. string.char(34)
        elseif DicValue >= 0.6953125 then Frac = "45/64" .. string.char(34)
        elseif DicValue >= 0.6796875 then Frac = "11/16" .. string.char(34)
        elseif DicValue >= 0.6640625 then Frac = "43/64" .. string.char(34)
        elseif DicValue >= 0.6484375 then Frac = "21/32" .. string.char(34)
        elseif DicValue >= 0.6328125 then Frac = "41/64" .. string.char(34)
        elseif DicValue >= 0.6171875 then Frac = "5/8"   .. string.char(34)
        elseif DicValue >= 0.6015625 then Frac = "39/64" .. string.char(34)
        elseif DicValue >= 0.5859375 then Frac = "19/32" .. string.char(34)
        elseif DicValue >= 0.5703125 then Frac = "37/64" .. string.char(34)
        elseif DicValue >= 0.5546875 then Frac = "9/16"  .. string.char(34)
        elseif DicValue >= 0.5390625 then Frac = "35/64" .. string.char(34)
        elseif DicValue >= 0.5234375 then Frac = "17/32" .. string.char(34)
        elseif DicValue >= 0.5078125 then Frac = "33/64" .. string.char(34)
        elseif DicValue >= 0.4921875 then Frac = "1/2"   .. string.char(34)
        elseif DicValue >= 0.4765625 then Frac = "31/64" .. string.char(34)
        elseif DicValue >= 0.4609375 then Frac = "15/32" .. string.char(34)
        elseif DicValue >= 0.4453125 then Frac = "29/32" .. string.char(34)
        elseif DicValue >= 0.4296875 then Frac = "7/16"  .. string.char(34)
        elseif DicValue >= 0.4140625 then Frac = "27/64" .. string.char(34)
        elseif DicValue >= 0.3984375 then Frac = "13/32" .. string.char(34)
        elseif DicValue >= 0.3828125 then Frac = "25/64" .. string.char(34)
        elseif DicValue >= 0.3671875 then Frac = "3/8"   .. string.char(34)
        elseif DicValue >= 0.3515625 then Frac = "23/64" .. string.char(34)
        elseif DicValue >= 0.3359375 then Frac = "11/32" .. string.char(34)
        elseif DicValue >= 0.3203125 then Frac = "21/64" .. string.char(34)
        elseif DicValue >= 0.3046875 then Frac = "5/16"  .. string.char(34)
        elseif DicValue >= 0.2890625 then Frac = "19/64" .. string.char(34)
        elseif DicValue >= 0.2734375 then Frac = "9/32"  .. string.char(34)
        elseif DicValue >= 0.2578125 then Frac = "17/64" .. string.char(34)
        elseif DicValue >= 0.2421875 then Frac = "1/4"   .. string.char(34)
        elseif DicValue >= 0.2265625 then Frac = "15/64" .. string.char(34)
        elseif DicValue >= 0.2109375 then Frac = "7/32"  .. string.char(34)
        elseif DicValue >= 0.1953125 then Frac = "13/64" .. string.char(34)
        elseif DicValue >= 0.1796875 then Frac = "3/16"  .. string.char(34)
        elseif DicValue >= 0.1640625 then Frac = "11/64" .. string.char(34)
        elseif DicValue >= 0.1484375 then Frac = "5/32"  .. string.char(34)
        elseif DicValue >= 0.1328125 then Frac = "9/64"  .. string.char(34)
        elseif DicValue >= 0.1171875 then Frac = "1/8"   .. string.char(34)
        elseif DicValue >= 0.1015625 then Frac = "7/64"  .. string.char(34)
        elseif DicValue >= 0.0859375 then Frac = "3/32"  .. string.char(34)
        elseif DicValue >= 0.0703125 then Frac = "5/64"  .. string.char(34)
        elseif DicValue >= 0.0546875 then Frac = "1/16"  .. string.char(34)
        elseif DicValue >= 0.0390625 then Frac = "3/64"  .. string.char(34)
        elseif DicValue >= 0.0234375 then Frac = "1/32"  .. string.char(34)
        elseif DicValue >= 0.0078125 then Frac = "1/64"  .. string.char(34)
        else
          Frac = "0"
        end -- If end
      end
    if Project.Fractions == "No Fractions" then
      Frac = tostring(Num)
    else
      if Frac == "0" then
        Frac = AmountValue .. string.char(34)
      else
        if AmountValue ~= "0" then
          Frac = AmountValue .. "-" .. Frac
        end
      end
    end
  end
  return Frac
end -- end function 

Time and Date Tools

Back.jpg

This collection of functions are utilized in the date and time calculations.

StartDateTime

TopOfPage.png

StartDateTime - Returns the Date and Time.

local dt= StartDateTime(true)

returns tbl = "10/02/23"

   function StartDateTime(LongShort)
--[[ Date Value Codes
--  |    %a  abbreviated weekday name (e.g., Wed)
--  |    %A  full weekday name (e.g., Wednesday)
--  |    %b  abbreviated month name (e.g., Sep)
--  |    %B  full month name (e.g., September)
--  |    %c  date and time (e.g., 09/16/98 23:48:10)
--  |    %d  day of the month (16) [01-31]
--  |    %H  hour, using a 24-hour clock (23) [00-23]
--  |    %I  hour, using a 12-hour clock (11) [01-12]
--  |    %M  minute (48) [00-59]
--  |    %m  month (09) [01-12]
--  |    %p  either "am" or "pm" (pm)
--  |    %S  second (10) [00-60]
--  |    %w  weekday (3) [0-6 = Sunday-Saturday]
--  |    %x  date (e.g., 09/16/98)
--  |    %X  time (e.g., 23:48:10)
--  |    %Y  full year (e.g., 1998)
--  |    %y  two-digit year (98) [00-99]
--  |    %%  the character `%´ ]]
    if LongShort then
      return os.date("%b %d, %Y") .. " - " .. os.date("%I") .. ":" .. os.date("%m") .. os.date("%p")
    else
      return os.date("%Y%m%d%H%M")
    end
  end 

StartDate

TopOfPage.png

StartDate - Returns the Date and Time.

local dt= StartDate(true)

returns tbl = "10/02/23"

  function StartDate(LongShort)
--[[ Date Value Codes
--  |    %a  abbreviated weekday name (e.g., Wed)
--  |    %A  full weekday name (e.g., Wednesday)
--  |    %b  abbreviated month name (e.g., Sep)
--  |    %B  full month name (e.g., September)
--  |    %c  date and time (e.g., 09/16/98 23:48:10)
--  |    %d  day of the month (16) [01-31]
--  |    %H  hour, using a 24-hour clock (23) [00-23]
--  |    %I  hour, using a 12-hour clock (11) [01-12]
--  |    %M  minute (48) [00-59]
--  |    %m  month (09) [01-12]
--  |    %p  either "am" or "pm" (pm)
--  |    %S  second (10) [00-60]
--  |    %w  weekday (3) [0-6 = Sunday-Saturday]
--  |    %x  date (e.g., 09/16/98)
--  |    %X  time (e.g., 23:48:10)
--  |    %Y  full year (e.g., 1998)
--  |    %y  two-digit year (98) [00-99]
--  |    %%  the character `%´ ]]

    if LongShort then
      return os.date("%b %d, %Y")  -- "Sep 01, 2022"
    else
      return os.date("%Y%m%d")     -- "20220901"
    end
  end 

Wait

TopOfPage.png

Wait - Waits for a duration.

local dt = Wait(true)

returns tbl = "10/02/23"

   function Wait(time)
    local duration = os.time() + time
    while os.time() < duration do end
    end
 end -- function end 

Debugging Tools

Back.jpg

This collection of functions assist in the debugging of code.

DMark - places a circle and notation to assist in geometry debugging

TopOfPage.png

Draws a circle and marks on the drawing for debugging purposes.

call = DebugMarkPoint("Note: Hi", Pt1)

 function DMark(Note, Pt)
  -- ==== Sub Function
    local function DrawCircle(job, Cpt, CircleRadius, LayerName)  -- Draws a circle
      local pa   = Polar2D(Cpt, 180.0, CircleRadius)
      local pb   = Polar2D(Cpt,   0.0, CircleRadius)
      local line = Contour(0.0)
      line:AppendPoint(pa); line:ArcTo(pb,1); line:ArcTo(pa,1)
      local layer = job.LayerManager:GetLayerWithName(LayerName)
      layer:AddObject(CreateCadContour(line), true)
      return true
    end -- function end
  -- ====
    local BubbleSize = 1.25
    if not Project.DebugAngle then
      Project.DebugAngle = 0.0
    end
    Project.DebugAngle = Project.DebugAngle + 2.0
    if Project.DebugAngle >= 90.0 and Project.DebugAngle <= 358.0 then
      Project.DebugAngle = 272.0
    elseif Project.DebugAngle >= 360.0 then
      Project.DebugAngle = 2.0
    end
    if Pt then
      local job = VectricJob()
      local Pt1 = Polar2D(Pt, Project.DebugAngle, BubbleSize)
      local Pt2 = Polar2D(Pt1, 0.0, BubbleSize * 0.25)
      local Pt3 = Polar2D(Pt2, 315.0, BubbleSize * 0.0883883476483188 * 4.0)
      local line = Contour(0.0)
      local layer = job.LayerManager:GetLayerWithName("Debug")
      line:AppendPoint(Pt)
      line:LineTo(Pt1)
      line:LineTo(Pt2)
      layer:AddObject(CreateCadContour(line), true)
      DrawWriter(Note, Pt3, BubbleSize * 0.5, "Debug", 0.0)
      DrawCircle(job, Pt, BubbleSize * 0.5, "Debug")
    else
      DisplayMessageBox("Issue with Point for - " .. Note)
    end
    return true
  end -- function end 

StatusMessage

TopOfPage.png

Useage: (Type of Message, Dialog Header, Question or Message, Err No.)

StatusMessage("Error", "Base Cabinet Settings", "Face Frame Bottom Rail Width - value cannot be 0.", "(9000)")

Note: if the debug flag is on (true) a message box shows the message length, dialog size and error number

function StatusMessage(Type, Header, Question, ErrorNumber)

  local dialog
  local X = 460
  local Y = 124
  local step = 35
  Question = WrapString(Question, step)
  local QL = string.len(Question)
  if (QL > step) and (QL < step * 2) then
    Y = Y + 12
  elseif (QL > (step * 2) +1) and (QL < 105) then
    Y = Y + 24
  elseif (QL > (step * 3) +1) and (QL < (step * 4)) then
    Y = Y + 36
  elseif (QL > (step * 4) +1) and (QL < (step * 5)) then
    Y = Y + 48
  elseif (QL > (step * 5) +1) and (QL < (step * 6)) then
    Y = Y + 60
  elseif (QL > (step * 6) +1) and (QL < (step * 7)) then
    Y = Y + 72
  elseif (QL > (step * 7) +1) and (QL < (step * 8)) then
    Y = Y + 84
  elseif (QL > (step * 8) +1) and (QL < (step * 9)) then
    Y = Y + 96
  elseif (QL > (step * 9) +1) and (QL < (step * 10)) then
    Y = Y + 108
  elseif (QL > (step * 10) +1) and (QL < (step * 11)) then
    Y = Y + 120
  else
    Y = Y + 150
  end
  if Project.Debugger then
    Queston = Question .. " - " .. ErrorNumber
  end
  if Type == "Alert" then
    dialog = HTML_Dialog(true, DialogWindow.myHtml16, X, Y, Header)
  else -- "Error"
    dialog = HTML_Dialog(true, DialogWindow.myHtml17, X, Y, Header)
  end -- if end
  if Project.Debugger then
    Question = Question .. " " .. ErrorNumber
  end
  dialog:AddLabelField("Question", Type .. ": " .. Question)
  dialog:ShowDialog()
  if Project.Debugger then
    DisplayMessageBox("Question Len " .. " = " .. tostring(string.len(Question)) .. ": \nWindow = " .. tostring(dialog.WindowWidth) .. " x " .. tostring(dialog.WindowHeight))
  end
  return true
end 


DebugMarkPoint

TopOfPage.png

Used in debugging drawing issues - Draws a Circle and Text at the provided point(x,y)

call = DebugMarkPoint("Note: Hi", Pt1, 0.125, "Jim")

function DebugMarkPoint(Note, Pt, Size, LayerName)
    if Size == nil then
      Size = 0.125
    end
    if LayerName == nil then
      LayerName = "Debug"
    end
  -- ==== Sub Function
    local function DrawCircle(job, Cpt, CircleRadius, LayerName)  -- Draws a circle
      local pa = Polar2D(Cpt, 180.0, CircleRadius)
      local pb = Polar2D(Cpt,   0.0, CircleRadius)
      local line = Contour(0.0)
      line:AppendPoint(pa); line:ArcTo(pb,1);   line:ArcTo(pa,1)
      local layer = job.LayerManager:GetLayerWithName(LayerName)
      layer:AddObject(CreateCadContour(line), true)
      return true
    end -- sub function end
  -- ====
    local job = VectricJob()
    local Pt1 = Polar2D(Pt, Project.DebugAngle, Size * 2.0)
    local Pt2 = Polar2D(Pt1, 0.0, 0.500 * Size)
    local Pt3 = Polar2D(Pt2, 315.0, (0.500 * Size) * 1.4142135623731)
    local line = Contour(0.0)
    local layer = job.LayerManager:GetLayerWithName(LayerName)
    line:AppendPoint(Pt)
    line:LineTo(Pt1)
    line:LineTo(Pt2)
    layer:AddObject(CreateCadContour(line), true)
    DrawWriter(Note, Pt3, Size, LayerName, 0.0)
    DrawCircle(job, Pt, Size, LayerName)
    return true
  end -- function end 

ShowDialogSize

TopOfPage.png

Returns Dialog size in a message box showing the X and Y vaalues.

 function ShowDialogSize()
    DisplayMessageBox(tostring(dialog.WindowWidth) .. " x " ..  tostring(dialog.WindowHeight))
  end -- function end

Dialog and Menu Tools

Back.jpg

This object is a name-value pair that represents a Document.

DialogSize

TopOfPage.png

Returns Dialog size in a message box showing the X and Y vaalues.

 function DialogSize(Str)                                -- Returns the X and Y value of the dialogue
  local InText = string.find(string.upper(Str) , "X")
  local DialogX = All_Trim(string.sub(Str, 1, InText - 1))
  local DialogY = All_Trim(string.sub(Str, InText + 1))
  return tonumber(DialogX), tonumber(DialogY)
 end -- function end

ProgressBarAmount

TopOfPage.png

Returns Dialog size in a message box showing the X and Y vaalues.

 function ProgressBarAmount(TotalRecords, Record)        -- Calculates the percent amount of progression based on total process
  --[[
  local MyProgressBar
    MyProgressBar = ProgressBar("Working", ProgressBar.LINEAR)                -- Setup Type of progress bar
    MyProgressBar:SetPercentProgress(0)                                       -- Sets progress bar to zero
    MyProgressBar:SetPercentProgress(ProgressAmount(Door.Records, myRecord))  -- sends percent of process progress bar (adds to the bar)
    MyProgressBar:SetPercentProgress(ProgressAmount(12000, 416))              -- sends percent of process progress bar (adds to the bar)
    MyProgressBar:SetText("Compete")                                          -- Sets the label to Complete
    MyProgressBar:Finished()                                                  -- Close Progress Bar
  ]]
    local X1 = (100.0 / TotalRecords)
    local X2 = X1 * Record
    local X3 = math.abs(X2)
    local X4 = (math.floor(X3))
    return (math.floor(math.abs((100.0 / TotalRecords) * Record)))
  end -- function end

OnLuaButton_InquiryGearCalulate

TopOfPage.png

Returns Dialog size in a message box showing the X and Y vaalues.

 function OnLuaButton_InquiryGearCalulate(dialog)
  Gear.Addendum         = dialog:GetDoubleField("Gear.Addendum")
  Gear.Dedendum         = dialog:GetDoubleField("Gear.Dedendum")
  Gear.AddendumDiameter = dialog:GetDoubleField("Gear.AddendumDiameter")
  Gear.DedendumDiameter = dialog:GetDoubleField("Gear.DedendumDiameter")
  Gear.ToothTickness    = dialog:GetDoubleField("Gear.ToothTickness")
  Gear.Slotwidth        = dialog:GetDoubleField("Gear.Slotwidth")
  Gear.PitchAmount      = dialog:GetDoubleField("Gear.PitchAmount")
  Gear.FilletRadius     = dialog:GetDoubleField("Gear.FilletRadius")
  Gear.ToplandAmount    = dialog:GetDoubleField("Gear.ToplandAmount")
  Gear.FaceFlankRadius  = dialog:GetDoubleField("Gear.FaceFlankRadius")
  Gear.ToothCount       = dialog:GetDropDownListValue("Gear.ToothCount")
  Gear.ShowLines        = dialog:GetDropDownListValue("Gear.ShowLines")

  dialog:UpdateDoubleField("Gear.Addendum",                      Gear.Addendum)
  dialog:UpdateDoubleField("Gear.Dedendum",                      Gear.Dedendum)
  dialog:UpdateDoubleField("Gear.AddendumDiameter",              Gear.AddendumDiameter)
  dialog:UpdateDoubleField("Gear.DedendumDiameter",              Gear.DedendumDiameter)
  dialog:UpdateDoubleField("Gear.ToothTickness",                 Gear.ToothTickness)
  dialog:UpdateDoubleField("Gear.Slotwidth",                     Gear.Slotwidth)
  dialog:UpdateDoubleField("Gear.PitchAmount",                   Gear.PitchAmount)
  dialog:UpdateDoubleField("Gear.FilletRadius",                  Gear.FilletRadius)
  dialog:UpdateDoubleField("Gear.ToplandAmount",                 Gear.ToplandAmount)
  dialog:UpdateDoubleField("Gear.FaceFlankRadius",               Gear.FaceFlankRadius)

  return true
 end -- function end

InquiryDropList

TopOfPage.png

Returns Dialog size in a message box showing the X and Y vaalues.

 function InquiryDropList(Header, Quest, DX, DY, DList)
--[[
    Drop list foe user input
    Caller: local y = InquiryDropList("Cabinet Maker", "Select Cabinet Style", 290, 165, IniFile)
    Dialog Header = "Cabinet Maker"
    Quest = "Select Cabinet Style"
    Selection Array = IniFile
    Returns = String
]]
    local myHtml = [[<!DOCTYPE HTML><html lang="en"><head><title>My List Box</title><style>.FormButton{font-weight:700;width:75px;font-size:12px;white-space:nowrap;font-family:Arial,Helvetica,sans-serif font-size: 12px}.h1-l{font-size:12px;font-weight:700;text-align:left;white-space:nowrap}.h1-c{font-size:12px;font-weight:700;text-align:center;white-space:nowrap}table{width:100%;border:0}body,td,th{background-color:#3a4660;background-position:center;overflow:hidden;font-family:arial,helvetica,sans-serif;font-size:12px;color:#fff;background-image:url(']].. DialogWindow.myBackGround ..[[')}html{overflow:hidden}</style></head><body><table><tr><td class="h1-l" id="Questions"><strong class="h2">Message Here</strong></td></tr><tr><td class="h1-c"><select name="DList" size="10" class="h1-c" id="ListBox"><option>My Default 1</option><option selected="selected">My Default 2</option><option>My Default 3</option><option>My Default 4</option></select></td></tr><tr><th class="h1-l" colspan="3" id="QuestionID"></th></tr></table><table><tr><td class="h1-c"><input id="ButtonCancel" class="FormButton" name="ButtonCancel" type="button" value="Cancel"></td><td></td><td class="h1-c"><input id="ButtonOK" class="FormButton" name="ButtonOK" type="button" value="OK"></td></tr></table></body></html>]] ;

    local dialog = HTML_Dialog(true, myHtml, DX, DY, Header)
          dialog:AddLabelField("Questions", Quest)
          dialog:AddDropDownList("ListBox", "DEFAULT")
          dialog:AddDropDownListValue("ListBox", "DEFAULT")
    for index, value in pairs(DList) do
        dialog:AddDropDownListValue("ListBox", value)
    end
    if not dialog:ShowDialog() then
      return "."
    else
      return dialog:GetDropDownListValue("ListBox")
    end
 end -- function end

InquiryFileBox

TopOfPage.png

Returns Dialog size in a message box showing the X and Y vaalues.

 function InquiryFileBox(Header, Quest, DefaltPath)
--[[
    Dialog Box for user to pick a file
    Caller: local X = InquiryFileBox("Select File", "Where is the file location?", "C:\\")
    Dialog Header = "File Name"
    User Question = "Path name?"
    Default Value = "C:\\"
    Returns = String
  ]]
  local myHtml = [[<html> <head> <title>Easy Tools</title> <style type = "text/css">  html {overflow: hidden; } body {
             background-color: #EBEBEB; overflow:hidden; font-family: Arial, Helvetica, sans-serif; font-size: 12px; } body, td,
             th {font-family: Arial, Helvetica, sans-serif ; font-size: 12px ; color: #000 ; } .FormButton {font-weight: bold ;
             width: 100% ; font-family: Arial, Helvetica, sans-serif ; font-size: 12px ; } body { background-color: #EBEBEB; }
             </style> </head> <body bgcolor = "#EBEBEB" text = "#000000"> <table width = "470" border = "0" cellpadding = "0">
             <tr> <th align = "left" valign = "top" bgcolor = "#EBEBEB" id = "QuestionID"><strong>Message Here</strong></th>
             <th align = "left" valign = "middle" bgcolor = "#EBEBEB"> </th> </tr> <tr>
             <th width = "381" align = "right" valign = "middle" bgcolor = "#EBEBEB" id = "QuestionID">
             <input name = "ReadFile" type = "text" id = "ReadFile" size = "60"></th>
             <th width = "83" align = "center" valign = "middle" bgcolor = "#EBEBEB"> <span style="width: 15%">
             <input id = "FilePicker" class = "FilePicker" name = "FilePicker" type = "button" value = "Path">
             </span></th> </tr> <tr> <td colspan = "2" align = "center" valign = "middle" bgcolor = "#EBEBEB">
             <table border = "0" width = "100%"> <tr align = "right"> <td style = "width: 20%"> </td>
             <td style = "width: 20%"></td> <td style = "width: 25%"></td> <td style = "width: 15%">
             <input id = "ButtonCancel" class = "FormButton" name = "ButtonCancel" type = "button" value = "Cancel"> </td>
             <td style = "width: 15%"> <input id = "ButtonOK" class = "FormButton" name = "ButtonOK" type = "button" value = "OK">
             </td> </tr> </table> </td> </tr> </table> </body>  </html>]]
  -- =============================================
  local dialog = HTML_Dialog(true, myHtml, 505, 150, Header)
    dialog:AddLabelField("QuestionID", Quest)
    dialog:AddTextField("ReadFile", DefaltPath )
    dialog:AddFilePicker(true, "FilePickerButton", "ReadFile", true)
    if not dialog:ShowDialog() then
      return ""
    else
      return dialog:GetTextField("ReadFile")
    end -- if end
  end -- function end

InquiryPathBox

TopOfPage.png

Returns Dialog size in a message box showing the X and Y vaalues.

 function InquiryPathBox(Header, Quest, DefaltPath)
--[[
    Number Box for user input with default value
    Caller: local X = InquiryPathBox("Select Path", "Where is the file location?", "C:\\")
    Dialog Header = "Tool Name"
    User Question = "Path name?"
    Default Value = "C:\\"
    Returns = String
  ]]
  local myHtml = [[ <html> <head> <title>Easy Tools</title> <style type = "text/css">  html {overflow: hidden; } body {
             background-color: #EBEBEB; overflow:hidden; font-family: Arial, Helvetica, sans-serif; font-size: 12px; } body, td,
             th {font-family: Arial, Helvetica, sans-serif ; font-size: 12px ; color: #000 ; } .FormButton {font-weight: bold ;
             width: 100% ; font-family: Arial, Helvetica, sans-serif ; font-size: 12px ; } body { background-color: #EBEBEB; }
             </style> </head> <body bgcolor = "#EBEBEB" text = "#000000"> <table width = "470" border = "0" cellpadding = "0">
             <tr> <th align = "left" valign = "top" bgcolor = "#EBEBEB" id = "QuestionID"><strong>Message Here</strong></th>
             <th align = "left" valign = "middle" bgcolor = "#EBEBEB"> </th> </tr> <tr>
             <th width = "381" align = "right" valign = "middle" bgcolor = "#EBEBEB" id = "QuestionID">
             <input name = "DInput" type = "text" id = "DInput" size = "60"></th>
             <th width = "83" align = "center" valign = "middle" bgcolor = "#EBEBEB"> <span style="width: 15%">
             <input id = "DirectoryPicker" class = "DirectoryPicker" name = "DirectoryPicker" type = "button" value = "Path">
             </span></th> </tr> <tr> <td colspan = "2" align = "center" valign = "middle" bgcolor = "#EBEBEB">
             <table border = "0" width = "100%"> <tr align = "right"> <td style = "width: 20%"> </td>
             <td style = "width: 20%"></td> <td style = "width: 25%"></td> <td style = "width: 15%">
             <input id = "ButtonCancel" class = "FormButton" name = "ButtonCancel" type = "button" value = "Cancel"> </td>
             <td style = "width: 15%"> <input id = "ButtonOK" class = "FormButton" name = "ButtonOK" type = "button" value = "OK">
             </td> </tr> </table> </td> </tr> </table> </body>  </html>]]
  -- =============================================
  local dialog = HTML_Dialog(true, myHtml, 505, 150, Header)
    dialog:AddLabelField("QuestionID", Quest)
    dialog:AddTextField("DInput", DefaltPath )
    dialog:AddDirectoryPicker("DirectoryPicker",  "DInput",  true)
    if not dialog:ShowDialog() then
      return ""
    else
      return dialog:GetTextField("DInput")
    end -- if end
 end -- function end

InquiryAreYouSureYesNo

TopOfPage.png

Returns Dialog size in a message box showing the X and Y vaalues.

 function InquiryAreYouSureYesNo(Header, Question1, Question2)
 --[[
     Drop list for user to input project info
     Caller = local y = InquiryAreYouSureYesNo("Pie Question", "Do you want free pie")
     Dialog Header = "Pie Question"
     User Question1 = "Do you want a Free Pie"
     User Question2 = "You only get one"
     Returns = true / false
   ]]
    local myHtml = [[ <html><head><title>Yes or No Question</title>]] .. DialogWindow.Style ..[[</head><body><table><tr><td colspan="3" class="h2-lw" id="Question1">Question1</td></tr><tr><td colspan="3" class="h2-lw" id="Question2">Question2</td></tr><tr><td class="h2-l"> </td></tr><tr><td colspan="3" class="h2-l">Are you sure?</td></tr><tr><td class="h2-l"> </td></tr></table><table><tr><td colspan="3"><h2><span></span></h2></td></tr>
   <tr><td class="h1-l"><input id="ButtonOK" class="FormButton FormBut" name="ButtonOK" type="button" value="  Yes  "> </td> <td class="h1-r"> <input id="ButtonCancel" class="FormButton FormBut" name="ButtonCancel" type="button" value="  No  "></td></tr></table></body></html>]]
-- =========================================================
    local dialog = HTML_Dialog(true, myHtml, 440, 218, Header)
    dialog:AddLabelField("Question1", Question1)
    dialog:AddLabelField("Question2", Question2)
    if not dialog:ShowDialog() then
      return false
    else
      return true
    end
 end -- function end

InquiryDoubleBox

TopOfPage.png

Returns Dialog size in a message box showing the X and Y vaalues.

 function InquiryDoubleBox(Header, Quest, DefaltN)
--[[
-- nquiryNumberBox for user input with default number value
-- Caller: local x = InquiryNumberBox("Cabinet Maker", "Enter the cabinet height", 30.0)
-- Dialog Header: "Cabinet Maker"
-- User Question: "Enter the cabinet height"
-- Default value = 30.0
-- Returns = double
]]
   local myHtml = [[<html><head><title>Get Double Value</title><style type="text/css">html{overflow:hidden}body{background-color:#ebebeb;overflow:hidden;font-family:Arial,Helvetica,sans-serif;font-size:12px;text:#000}.h1-l{font-family:Arial,Helvetica,sans-serif;font-size:12px;font-weight:700;text-align:left;white-space:nowrap}.h1-r{font-family:Arial,Helvetica,sans-serif;font-size:12px;font-weight:700;text-align:right;white-space:nowrap}.h1-c{font-family:Arial,Helvetica,sans-serif;font-size:12px;font-weight:700;text-align:center;white-space:nowrap}table{width:100%;border:0;cellpadding:0}.FilePicker{font-weight:700;font-family:Arial,Helvetica,sans-serif;font-size:12px;width:50px}.FormButton{font-weight:700;width:65px;font-family:Arial,Helvetica,sans-serif;font-size:12px}</style></head><body><table><tr><td id="QuestionID" class="h1-r"><strong>Message Here</strong></td><td><input type="text" id="NumberInput" size="5"></td></tr><tr><td colspan="2"></td></tr></table><table><tr class="h1-c"><td><input id="ButtonCancel" class="FormButton" name="ButtonCancel" type="button" value="Cancel"></td><td><input id="ButtonOK" class="FormButton" name="ButtonOK" type="button" value="OK"></td></tr></table></body></html>]]
   local dialog = HTML_Dialog(true, myHtml, 260, 125, Header)
   dialog:AddLabelField("QuestionID", Quest) ;
   dialog:AddDoubleField("NumberInput", DefaltN) ;
  if not dialog:ShowDialog() then
    return -1
  else
    return dialog:GetDoubleField("NumberInput")
  end
 end -- function end

InquiryIntegerBox

TopOfPage.png

Returns Dialog size in a message box showing the X and Y vaalues.

 function InquiryIntegerBox(Header, Quest, DefaltI)
--[[
-- InquiryIntegerBox for user input with default number value
-- Caller: local x = InquiryIntegerBox("Cabinet Maker", "Enter the door count", 4)
-- Dialog Header: "Cabinet Maker"
-- User Question: "Enter the door count"
-- Default value = 4
-- Returns = integer
]]
   local myHtml = [[<html><head><title>Get Integer</title><style type="text/css">html{overflow:auto}body{background-color:#ebebeb}table{width:100%;border:0}body,td,th{font-family:Arial,Helvetica,sans-serif;font-size:12px;color:#000}.FormButton{font-weight:700;width:85px;font-family:Arial,Helvetica,sans-serif;font-size:12px}body{background-color:#ebebeb;text:#000}</style></head><body><table><tr><td id="QuestionID"><strong>Message Here</strong></td><td><input type="text" id="IntegerInput" size="10"></td></tr><tr><td colspan="2"></td></tr></table><table><tr><td><input id="ButtonCancel" class="FormButton" name="ButtonCancel" type="button" value="Cancel"></td><td><input id="ButtonOK" class="FormButton" name="ButtonOK" type="button" value="OK"></td></tr></table></body></html>]]
   local dialog = HTML_Dialog(true, myHtml, 505, 140, Header)
   dialog:AddLabelField("QuestionID", Quest)
   dialog:AddIntegerField("IntegerInput", DefaltI)
  if not dialog:ShowDialog() then
    return -1
  else
    return dialog:GetIntegerField("IntegerInput")
  end
 end -- function end

InquiryTextgBox

TopOfPage.png

Returns Dialog size in a message box showing the X and Y vaalues.

 function InquiryTextgBox(Header, Quest, DefaltS)
--[[
-- InquiryStringBox for user input with default number value
-- Caller: local x = InquiryTextgBox("Cabinet Maker", "Enter the cabinet Name", "Jim")
-- Dialog Header: "Cabinet Maker"
-- User Question: "Enter the cabinet Name"
-- Default value = Jim
-- Returns = string
]]
   local myHtml = [[<html><head><title>Get Number</title><style type="text/css">html{overflow:auto}body{background-color:#ebebeb}table{width:100%;border:0}body,td,th{font-family:Arial,Helvetica,sans-serif;font-size:12px;color:#000}.FormButton{font-weight:700;width:85px;font-family:Arial,Helvetica,sans-serif;font-size:12px}body{background-color:#ebebeb;text:#000}</style></head><body><table><tr><td id="QuestionID"><strong>Message Here</strong></td><td><input type="text" id="StringInput" size="10"></td></tr><tr><td colspan="2"></td></tr></table><table><tr><td><input id="ButtonCancel" class="FormButton" name="ButtonCancel" type="button" value="Cancel"></td><td><input id="ButtonOK" class="FormButton" name="ButtonOK" type="button" value="OK"></td></tr></table></body></html>]]
   local dialog = HTML_Dialog(true, myHtml, 505, 140, Header)
   dialog:AddLabelField("QuestionID", Quest)
   dialog:AddTextField("StringInput", DefaltS)
  if not dialog:ShowDialog() then
    return -1
  else
    return dialog:GetTextField("NumberInput")
  end
 end -- function end

OnLuaButton_InquiryError

TopOfPage.png

Returns Dialog size in a message box showing the X and Y vaalues.

 function OnLuaButton_InquiryError(Message)
    --[[
     Provides user information on an Error
     Caller = local ItWorked = OnLuaButton_InquiryError("No number found")
     Dialog Header = "Something Error"
     User Message = "No Number etc..."
     Returns = True
   ]]
  local myHtml = [[<html><head><title>Error</title><style type = "text/css">.FormButton{font-weight:bold;width:75px;font-family:Arial,Helvetica,sans-serif;font-size:12px;white-space:nowrap}.Error{font-family:Arial,Helvetica,sans-serif;font-size:18px;font-weight:bold;color:#F00;text-align:left;white-space:nowrap;padding-right:4px;padding-left:10px;padding-top:4px;padding-bottom:4px}.ErrorMessage{font-family:Arial,Helvetica,sans-serif;font-size:12px;color:#000;font-weight:bold;text-align:left;white-space:nowrap;padding-right:4px;padding-left:10px;padding-top:4px;padding-bottom:4px}.ErrorTable{background-color:#FFF white-space:nowrap}html{overflow:hidden}</style></head><body text = "#000000"><table width="100%" border="0" cellpadding="0" class="ErrorTable"><tr><th align="center" nowrap="nowrap" class="Error">Error!</th></tr><tr><td id="ErrorMessage"><label class="ErrorMessage">-</label></tr><tr><td width="30%" align="right" style = "width: 15%"><input id = "ButtonOK" class = "FormButton" name = "ButtonOK" type = "button" value = "Exit"></td></tr></table></body></html>]]
  local dialogWide =  (#Message + 300)
  local dialog = HTML_Dialog(true, myHtml, 250, dialogWide, "Gadget Error")
  dialog:AddLabelField("ErrorMessage",   Message)
  dialog:ShowDialog()
  Dovetail.InquiryErrorX = Dialog.WindowWidth
  Dovetail.InquiryErrorY = Dialog.WindowHeight
  WriteRegistry()
  return  true
 end -- function end

PresentMessage

TopOfPage.png

Returns Dialog size in a message box showing the X and Y vaalues.

 function PresentMessage(Header, Type, Line)
    --[[
     Provides user information on an Error
     Caller = local ItWorked = OnLuaButton_InquiryError("No number found")
     Dialog Header = "Something Error"
     User Message = "No Number etc..."
     Returns = True
   ]]
  local myHtml = [[<html><head><title>Error</title>]] .. DialogWindow.Style ..[[</head><body>
  <table><tr><th valign="top" id="MessageType" class="Error">-</th><td id="MessageLine"><label class="ErrorMessage">-</label><td></tr>
<tr><td></td><td align="right"><input id = "ButtonOK" class = "FormButton" name = "ButtonOK" type = "button" value = "OK"></td></tr>
</table></body></html>]]
  local dialog = HTML_Dialog(true, myHtml, 500, 150, Header)
  dialog:AddLabelField("MessageType", Type .. ": ")
  dialog:AddLabelField("MessageLine", Line)
  dialog:ShowDialog()
  return  true
 end -- function end

OnLuaButton_InquiryAbout

TopOfPage.png

Returns Dialog size in a message box showing the X and Y vaalues.

 function OnLuaButton_InquiryAbout()
local myHtml = [[<html><head><title>About</title>]] .. DialogWindow.Style ..[[</head><body text = "#000000"><table width="680" border="0" cellpadding="0"> <tr> <td align="center" nowrap="nowrap" class="header1-c" id="SysName">Easy Cabinet Maker</td> </tr> <tr> <td align="center" nowrap="nowrap" id="Version" class="ver-c">Version</td> </tr> <tr> <td align="center" nowrap="nowrap"><hr></td> </tr> <tr> <td align="center" nowrap="nowrap" class="header2-c">Disclaimer</td> </tr> <tr> <td align="center" class="p1-l"><p class="p1-l">The ]] .. Dovetail.AppName .. [[ Gadget is a plugin for Vectric software, V-Carve Pro and Aspire.<br> Gadgets are an entirely optional add-in to Vectric's core software products.<br> They are provided 'as-is', without any express or implied warranty, and you make use of them entirely at your own risk.<br> In no event will the author(s) or Vectric Ltd. be held liable for any damages arising from their use.<br> <br> Permission is granted to anyone to use this software for any purpose, including commercial applications, and to alter it and redistribute it freely, subject to the following restrictions:<br> 1. The origin of this software must not be misrepresented; you must not claim that you wrote the original software.<br> * If you use this software in a product, an acknowledgement in the product documentation would be appreciated but is not required.<br> 2. Altered source versions must be plainly marked as such, and must not be misrepresented as being the original software.<br> 3. This notice may not be removed or altered from any source distribution.<br> <br>The author heavily utilized the SDK documentation and supplied code samples in addition to the outstanding user community on the Vectric User forum.</p></td> </tr> <tr> <td align="center"><a href="https://forum.vectric.com" class="webLink-c">Vectric User Forum</a></td> </tr> <tr> <td align="center"><span class="header2-c">JimAndi</span></td> </tr> <tr> <td align="center"><span class="h1-c">Houston, TX.</span></td> </tr> <tr> <td><hr></td> </tr> <tr> <td width="30%" align="center" style = "width: 15%"><input id = "ButtonOK" class = "FormButton" name = "ButtonOK" type = "button" value = "OK"></td> </tr></table></body></html>]]
  local dialog = HTML_Dialog(true, myHtml, 720, 468, "About")
  dialog:AddLabelField("SysName", Project.ProgramName)
  dialog:AddLabelField("Version", "Version: " .. Project.ProgramVersion)
  dialog:ShowDialog()
  Project.AboutXY = tostring(dialog.WindowWidth) .. " x " .. tostring(dialog.WindowHeight)
  return  true
 end -- function end


Color_HTML

TopOfPage.png

Returns Dialog size in a message box showing the X and Y vaalues.

 function Color_HTML ()
  MessageBox(" X = " .. tostring(dialog.WindowWidth) ..
             " Y = " .. tostring(dialog.WindowHeight)
 )
-- =====================================================]]
--[[ -- begin HTML for Layer Color
<table>
  <tr>
    <td width="200" align="right" valign="middle" nowrap class="h1-rp">Layer Name</td>
    <td width="300" align="right" valign="middle" nowrap class="h1-l" id="ValueTable">
      <input name="Panel.PinHole" type="text" class="h1-l" id="Panel.PinHole" size="50" maxlength="50"/>
      </td>
    <td width="150"align="right" valign="middle" nowrap class="h1-l"><label for="Panel.LineColor01">Color</label>
      <select name="Panel.LineColor01" id="Panel.LineColor01">
        <option selected="selected">Black</option>
        <option>Blue</option>
        <option>Brown</option>
        <option>Cyan</option>
        <option>Gray</option>
        <option>Green</option>
        <option>Lime</option>
        <option>Magenta</option>
        <option>Maroon</option>
        <option>Navy</option>
        <option>Olive</option>
        <option>Orange</option>
        <option>Purple</option>
        <option>Red</option>
        <option>Silver</option>
        <option>Teal</option>
        <option>White</option>
        <option>Yellow</option>
    </select></td>
  </tr>
</table>
<table width="101%" border="0" id="ButtonTable">
</table>
]] -- end HTML
 end -- function end


Style

TopOfPage.png

Returns Dialog size in a message box showing the X and Y vaalues.

 function Style()
-- =====================================================]]
DialogWindow.Style = [[ <style>
.DirectoryPicker {
  font-weight: bold;
  font-size: 12px;
  white-space: nowrap;
  background-color: #663300;
  color: #FFFFFF;
}
.FormButton {
	font-weight: bold;
	width: 75px;
	font-size: 12px;
	white-space: nowrap;
	background-color: #663300;
	color: #FFFFFF;
}
.FormButton-Help {
	font-weight: bold;
	width: 75px;
	font-size: 12px;
	white-space: nowrap;
	background-color: #663300;
	color: #FFFFFF;
	padding-left: 10;
	padding-right: 10;
}
.LuaButton {
	font-weight: bold;
	font-size: 12px;
	background-color: #663300;
	color: #FFFFFF;
}
.ToolNameLabel {
	font-weight: bolder;
	font-size: 12px;
	text-align: left;
	color: #000;
	width: 70%;
}
.ToolPicker {
	font-weight: bold;
	text-align: center;
	font-size: 12px;
	text-align: center;
	width: 50px;
	background-color: #663300;
	color: #FFFFFF;
}
.alert-c {
	font-size: 14px;
	font-weight: bold;
	text-align: center;
	white-space: nowrap;
}
.alert-l {
	font-size: 14px;
	font-weight: bold;
	text-shadow: 5px 5px 10px #FFF;
	text-align: left;
	width: 100%;
	white-space: nowrap;
}
.alert-r {
	font-size: 14px;
	font-weight: bold;
	text-align: right;
	white-space: nowrap;
}
.error {
	font-size: 18px;
	font-weight: bold;
	color: #FF0000;
	text-align: left;
	white-space: nowrap;
	padding-right: 4px;
	padding-left: 10px;
	padding-top: 4px;
	padding-bottom: 4px;
}
.errorMessage {
	font-size: 12px;
	color: #000;
	font-weight: bold;
	text-align: left;
	white-space: nowrap;
	padding-right: 4px;
	padding-left: 10px;
	padding-top: 4px;
	padding-bottom: 4px;
}
.errorTable {
	background-color: #FFFFFF;
	white-space: nowrap;
}
.p1-l {
	font-size: 12px;
	text-align: left;
}
.h1-c {
	font-size: 12px;
	font-weight: bold;
	text-align: center;
	white-space: nowrap;
}
.h1-cOk {
	font-size: 12px;
	font-weight: bold;
	text-align: center;
	white-space: nowrap;
	width: 15%;
}
.h1-l {
	font-size: 12px;
	font-weight: bold;
	text-align: left;
	white-space: nowrap;
}
.h1-r {
	font-size: 12px;
	font-weight: bold;
	text-align: right;
	white-space: nowrap;
}
.h1-rP {
	font-size: 12px;
	font-weight: bold;
	text-align: right;
	white-space: nowrap;
	padding-right: 4px;
	padding-left: 4px;
}
.h1-rPx {
	font-size: 12px;
	font-weight: bold;
	text-align: right;
	white-space: nowrap;
	padding-right: 8px;
	padding-left: 8px;
}
.h2-c {
	font-size: 14px;
	font-weight: bold;
	text-align: center;
	white-space: nowrap;
	text-shadow: 2px 2px white;
}
.h2-l {
	font-size: 14px;
	font-weight: bold;
	color: #663300;
	text-align: left;
	white-space: nowrap;
	text-shadow: 2px 2px white;
}
.h2-r {
	font-size: 14px;
	font-weight: bold;
	color: #663300;
	text-align: right;
	white-space: nowrap;
	text-shadow: 2px 2px white;
}
.h3-bc {
	font-size: 16px;
	font-weight: bold;
	text-align: center;
	white-space: nowrap;
}
.h3-c {
	font-size: 16px;
	font-weight: bold;
	text-align: center;
	white-space: nowrap;
}
.h3-l {
	font-size: 16px;
	font-weight: bold;
	text-align: left;
	white-space: nowrap;
}
.h3-r {
	font-size: 16px;
	font-weight: bold;
	text-align: right;
	white-space: nowrap;
}
.h4-c {
	font-size: 18px;
	font-weight: bold;
	text-align: center;
	white-space: nowrap;
}
.h4-l {
	font-size: 18px;
	font-weight: bold;
	text-align: left;
	white-space: nowrap;
}
.h4-r {
	font-size: 18px;
	font-weight: bold;
	text-align: right;
	white-space: nowrap;
}
.help_But {
	width: 45px;
}
.MyCenter{
	text-align:center;
	width:10;
}
.MyLeft{
	text-align:left;
	width:10;
}
.MyRight{
	text-align:right;
	width:10;
}
.helplabel-r {
	cursor: pointer;
	white-space: nowrap;
	text-align: right;
}
.helplabel-rp {
	cursor: pointer;
	white-space: nowrap;
	text-align: right;
	padding-right: 8px;
}
.jsTag-no-vis {
	font-size: 10px;
	display: none;
	text-align: center;
	color: #00F;
	visibility: hidden;
}
.jsbutton {
	background-color: #663300;
	border: 2px solid #999;
	border-right-color: #000;
	border-bottom-color: #000;
	border-top-color: #FFF;
	border-left-color: #FFF;
	text-align: center;
	text-decoration: none;
	font-size: 12px;
	margin: 1px 1px;
	color: #FFFFFF;
}
.p1-c {
	font-size: 12px;
	text-align: center;
}
.p1-r {
	font-size: 12px;
	text-align: right;
}
.ver-c {
	font-size: 10px;
	font-weight: bold;
	text-align: center;
	white-space: nowrap;
	color: #ffd9b3;
}
.webLink-c {
	font-size: 16px;
	font-weight: bold;
	background-color: yellow;
	text-align: center;
	white-space: nowrap;
}
body {
	background-color: #3a4660;
	background-position: center;
	overflow: hidden;
	font-family: arial, helvetica, sans-serif;
	font-size: 12px;
	color: #FFFFFF;
	background-image: url(]].. DialogWindow.myBackGround ..[[);
}
html {
	overflow: hidden
}
table {
	width: 100%;
	border: 0;
}
</style>]]
 end -- function end

Orgin

TopOfPage.png

Returns Dialog size in a message box showing the X and Y vaalues.

 function Orgin()                                       -- Anchor Point
-- ================================
  DialogWindow.Orgin = [[<table><tr><td colspan="2" class="h2-l">Anchor Point</td></tr><tr class="MyLeft"><td class="MyLeft"><table class="MyCenter"><tr><td><input type="radio" name="DrawingOrigin" checked="checked" value="V1"></td><td><hr></td><td valign="top"><input type="radio" name="DrawingOrigin" checked="checked" value="V2"></td></tr><tr><td class="auto-style9">|</td><td><input type="radio" name="DrawingOrigin" checked="checked" value="V3"></td><td valign="top">|</td></tr><tr><td><input type="radio" name="DrawingOrigin" checked="checked" value="V4"></td><td><hr></td><td valign="top"><input type="radio" name="DrawingOrigin" checked="checked" value="V5"></td></tr></table></td><td width="81%"><table><tr class="MyLeft"><td>X</td><td><input name="OriginX0" type="text" id="OriginX" size="8" maxlength="8"></td></tr><tr class="MyLeft"><td>Y</td><td><input name="OriginY0" type="text" id="OriginY" size="8" maxlength="8"></td></tr></table></td></tr></table>]]
 end -- function end


GetColor

TopOfPage.png

Returns Dialog size in a message box showing the X and Y vaalues.

 function GetColor(str)                                  -- returns the RGB value for the standard color names
-- str = "Purple"
-- returns = 128 0 128
    local Colors = {}
    Colors.Black  = "0,0,0";       Colors.White  = "255,255,255"; Colors.Red    = "255,0,0"
    Colors.Lime   = "0,255,0";     Colors.Blue   = "0,0,255";     Colors.Yellow = "255,255,0"
    Colors.Cyan   = "0,255,255";   Colors.Magenta = "255,0,255";  Colors.Silver = "192,192,192"
    Colors.Gray   = "128,128,128"; Colors.Maroon = "128,0,0";     Colors.Olive  = "128,128,0"
    Colors.Green  = "0,128,0";     Colors.Purple = "128,0,128";   Colors.Teal   = "0,128,128"
    Colors.Navy   = "0,0,128"
    local Red, Green, Blue = 0
    if "" == str then
      DisplayMessageBox("Error: Empty string passed")
    else
      str = Colors[str]
      if "string" == type(str) then
        if string.find(str, ",") then
          Red  = tonumber(string.sub(str, 1, assert(string.find(str, ",") - 1)))
          str = string.sub(str, assert(string.find(str, ",") + 1))
          Green = tonumber(string.sub(str, 1, assert(string.find(str, ",") - 1)))
          Blue = tonumber(string.sub(str, assert(string.find(str, ",") + 1)))
        end
      else
        DisplayMessageBox("Error: Color Not Found")
        Red = 0
        Green = 0
        Blue = 0
      end
    end
    return Red, Green, Blue
 end -- function end


StatusMessage

TopOfPage.png

Returns Dialog size in a message box showing the X and Y vaalues.

 function StatusMessage(Type, Header, Question, length) -- Standardize messaging dialogues
  -- StatusMessage("Alert",    "Alert Test",     "This is a test of Alert",    165)
  -- StatusMessage("Question", "Question Test",  "This is a test of Question", 165)
  -- StatusMessage("Tick",     "Tick Test",      "This is a test of Tick",     165)
  -- StatusMessage("Minus",    "Minus Test",     "This is a test of Minus",    165)
  -- StatusMessage("Error",    "Error Test",     "This is a test of Error",    165)
  -- StatusMessage("Success",  "Success Test",   "This is a test of Success",  165)
  -- StatusMessage("Blank",    "Blank Test",     "This is a test of Blank",    165)
  local Image = ""
  if     Type == "Alert" then
    Image = AlertImage()
  elseif Type == "Question" then
    Image = QuestionImage()
  elseif Type == "Tick" then
    Image = TickImage()
  elseif Type == "Minus" then
    Image = MinusImage()
  elseif Type == "Error" then
    Image = ErrorImage()
  elseif Type == "Success" then
    Image = SuccessImage()
  else -- "Status"
    Image = TickImage()
  end -- if end
  local help = [[<html><head><title>]] .. Header ..[[</title><style>
.FormButton {font-family: Arial, Helvetica, sans-serif;font-weight: bold;font-size: 12px;white-space: nowrap;background-color: #663300;color: #FFFFFF;width: 75px;
}table {width: 100%;border: 0;}.h2-lm {font-family: Arial, Helvetica, sans-serif;font-size: 14px;font-weight: bold;text-align: left;}.h2-r {font-family: Arial, Helvetica, sans-serif;font-size: 14px;font-weight: bold;text-align: right;white-space: nowrap;}.h2-l {font-family: Arial, Helvetica, sans-serif;font-size: 14px;font-weight: bold;text-align: left;white-space: nowrap;}body {background-color: #3a4660;background-position: center;overflow: hidden;font-family: arial, helvetica, sans-serif;font-size: 12px;color: #FFFFFF;background-image: url(]] .. myBackGround() .. [[);}html {overflow: hidden}</style></head><body><table> <tr>  <td class="h2-l"><]] .. Image .. [[" width="60" height="60"></td>
    <td class="h2-lm" id="Question">]] .. Question .. [[</td></tr><tr><td colspan=2><h2><span></span></h2></td>
    </tr></table><table><tr><td class="h2-r"><input id="ButtonOK" class="FormButton" name="ButtonOK" type="button" value="OK"></td>
    </tr></table></body></html>]]
  local dialog = HTML_Dialog(true, help , 550,  length, Header)
  dialog:ShowDialog()
  return true
end -- function end 

DialogStringChecks

function DialogStringChecks()
  local MyTrue = false
  if Milling.LNBottomProfile == "" then
    MessageBox("Error: Bottom Profile layer name cannot be blank")
    OnLuaButton_InquiryLayers()
  elseif  Milling.LNSideProfile  == "" then
    MessageBox("Error: Side Profile layer name cannot be blank")
    OnLuaButton_InquiryLayers()
  elseif  Milling.LNSidePocket  == "" then
    MessageBox("Error: Side Pocket layer name cannot be blank")
    OnLuaButton_InquiryLayers()
  elseif Milling.LNFrontProfile == "" then
    MessageBox("Error: Front Profile layer name cannot be blank")
    OnLuaButton_InquiryLayers()
  elseif Milling.LNFrontPocket  == "" then
    MessageBox("Error: Front Pocket layer name cannot be blank")
    OnLuaButton_InquiryLayers()
  elseif Milling.LNBackProfile  == "" then
    MessageBox("Error: Back Profile layer name cannot be blank")
    OnLuaButton_InquiryLayers()
  elseif Milling.LNBackPocket == "" then
    MessageBox("Error: Back Pocket layer name cannot be blank")
    OnLuaButton_InquiryLayers()
  elseif Milling.LNDrawNotes == "" then
    MessageBox("Error: Draw Notes layer name cannot be blank")
    OnLuaButton_InquiryLayers()
  elseif Milling.LNPartLabels == "" then
    MessageBox("Error: Part Lables layer name cannot be blank")
    OnLuaButton_InquiryLayers()
  elseif Milling.LNBlume == "" then
    MessageBox("Error: Blume layer name cannot be blank")
    OnLuaButton_InquiryLayers()
  elseif Project.ProjectName == "" then
    MessageBox("Error: Project Name cannot be blank")
    OnLuaButton_InquiryProjectInfo()
  elseif Project.ContactEmail  == "" then
    MessageBox("Error: Contact Email cannot be blank")
    OnLuaButton_InquiryProjectInfo()
  elseif Project.ContactName == "" then
    MessageBox("Error: Contact Name cannot be blank")
    OnLuaButton_InquiryProjectInfo()
  elseif Project.ContactPhoneNumber == "" then
    MessageBox("Error: Project Name cannot be blank")
    OnLuaButton_InquiryProjectInfo()
  elseif Project.DrawerID == "" then
    MessageBox("Error: Contact Phone Number cannot be blank")
    OnLuaButton_InquiryProjectInfo()
  elseif Project.ProjectPath == "" then
    MessageBox("Error: Project Path cannot be blank")
    OnLuaButton_InquiryProjectInfo()
  else
    MyTrue = true
  end -- if end
  return MyTrue
end -- function end

Directory and File Tools

Back.jpg

This object is a name-value pair that represents a Document.


MakeFolder()

TopOfPage.png

Returns Dialog size in a message box showing the X and Y values.

 function MakeFolder(xPath)
    os.execute( "mkdir  " .. xPath)
    return true
  end -- function end

PathFix()

TopOfPage.png
 function PathFix(xPath)              -- Returns path with /
    return string.gsub(xPath, "\\", "/")
  end -- function end

IsDir()

Validates a directory path

TopOfPage.png
function IsDir(path)                     -- Returns true if path is found
    local function exists(file)
      local ok, err, code = os.rename(file, file)
      if not ok then
        if code == 13 then
          return true
        end -- if end
      end -- if end
      return ok, err
    end -- function end
    return exists(path.."/")
  end -- function end



FileExists()

TopOfPage.png

Returns Dialog size in a message box showing the X and Y values.

 function FileExists(name)
-- FileExists(name
-- DisplayMessageBox(name)
    local f=io.open(name,"r")
    if f~=nil then
      io.close(f)
      return true
    else
      return false
    end
  end -- function end

DirectoryProcessor()

TopOfPage.png

Returns number of files that were processed by an operation.

 function DirectoryProcessor(job, dir_name, filter, do_sub_dirs, function_ptr)
      local num_files_processed = 0
      local directory_reader = DirectoryReader()
      local cur_dir_reader = DirectoryReader()
      directory_reader:BuildDirectoryList(dir_name, do_sub_dirs)
      directory_reader:SortDirs()
      local number_of_directories = directory_reader:NumberOfDirs()
      for i = 1, number_of_directories do
        local cur_directory = directory_reader:DirAtIndex(i)
         -- get contents of current directory
         -- dont include sub dirs, use passed filter
        cur_dir_reader:BuildDirectoryList(cur_directory.Name, false)
        cur_dir_reader:GetFiles(filter, true, false)
         -- call passed method for each file:
        local num_files_in_dir = cur_dir_reader:NumberOfFiles()
        for j=1, num_files_in_dir  do
          local file_info = cur_dir_reader:FileAtIndex(j)
          if not function_ptr(job, file_info.Name) then
            return true
          end -- if end
           num_files_processed = num_files_processed + 1
        end -- for end
        -- empty out our directory object ready for next go
        cur_dir_reader:ClearDirs()
        cur_dir_reader:ClearFiles()
      end -- for end
      return num_files_processed
  end -- function end 

Drawing Tools

Back.jpg

This object is a name-value pair that represents a Document Variable within a VectricJob.


DrawArrowLineArrow

TopOfPage.png

Draws a dimension line with arrow heads and extension leaders

function DrawArrowLineArrow(Pt1, Ext1, Pt2, Ext2, Off, Str, Layer, scale)
  -- DrawArrowLineArrow(pt1, true, pt3, true, 2.5, "122.5", "TestLayer", 6.0) -- both
  -- DrawArrowLineArrow(pt1, true, pt3, false, 2.5, "122.5", "TestLayer", 6.0) -- first leader only
  -- DrawArrowLineArrow(pt1, false, pt3, true, 2.5, "122.5", "TestLayer", 6.0) -- second leader only
  -- -----------------------------------------------------]]
    local job = VectricJob()
    if not job.Exists then
      DisplayMessageBox("Error: No job loaded")
      return false
    end -- if end
    local DimArrow1Angle = GetPolarDirection(Pt1, Pt2, Polar2D(Pt2, 0.0, 1.0))
    local DimArrow2Angle = DimArrow1Angle + 180.0
    local LederAng       = DimArrow1Angle + 90.0
    local LedDrop        = LederAng + 180.0
    local TxtCenter      =  GetDistance(Pt1, Pt2) * 0.5
    local ArrowLen       = 0.125 * scale
    local StrSet         = (string.len(Str) * ArrowLen) * 0.5
    local PT01A          = Polar2D(Pt1, LederAng, ArrowLen * 2.0)
    local PT02A          = Polar2D(PT01A, LederAng, Off)
    local PT03A          = Polar2D(PT02A, LederAng, ArrowLen)
    local PT01B          = Polar2D(Pt2, LederAng, ArrowLen * 2.0)
    local PT02B          = Polar2D(PT01B, LederAng, Off)
    local PT03B          = Polar2D(PT02B, LederAng, ArrowLen)
    local Apt1           = Polar2D(PT02A, DimArrow1Angle + 15.0, ArrowLen)
    local Apt2           = Polar2D(PT02A, DimArrow1Angle - 15.0, ArrowLen)
    local TxtPt1         = Polar2D(Polar2D(PT02A, DimArrow1Angle, TxtCenter), DimArrow1Angle + 90.0, ArrowLen)
    local TxtPt          = Polar2D(TxtPt1, DimArrow2Angle, StrSet)
    local ArrowHead      = (ArrowLen * 0.333)
    local line1          = Contour(0.0)
    local layer1         = job.LayerManager:GetLayerWithName(Layer)
    line1:AppendPoint(Apt1)
    line1:LineTo(PT02A)
    line1:LineTo(Apt2)
    line1:LineTo(Apt1)
    layer1:AddObject(CreateCadContour(line1), true)
    local Apt3 = Polar2D(PT02B, DimArrow2Angle + 15.0, ArrowLen)
    local Apt4 = Polar2D(PT02B, DimArrow2Angle - 15.0, ArrowLen)
    local line2 = Contour(0.0)
    local layer2 = job.LayerManager:GetLayerWithName(Layer)
    line2:AppendPoint(Apt3)
    line2:LineTo(PT02B)
    line2:LineTo(Apt4)
    line2:LineTo(Apt3)
    layer2:AddObject(CreateCadContour(line2), true)
    if Ext1 then
      local lineA = Contour(0.0)
      local layerA = job.LayerManager:GetLayerWithName(Layer)
      lineA:AppendPoint(PT01A)
      lineA:LineTo(PT03A)
      layerA:AddObject(CreateCadContour(lineA), true)
    end -- if end
    if Ext2 then
      local lineB = Contour(0.0)
      local layerB = job.LayerManager:GetLayerWithName(Layer)
      lineB:AppendPoint(PT01B)
      lineB:LineTo(PT03B)
      layerB:AddObject(CreateCadContour(lineB), true)
    end -- if end
    local lineC = Contour(0.0)
    local layerC = job.LayerManager:GetLayerWithName(Layer)
    lineC:AppendPoint(PT02A)
    lineC:LineTo(PT02B)
    layerC:AddObject(CreateCadContour(lineC), true)
    DrawWriter(Double2Fraction(Str), TxtPt, ArrowLen, Layer, DimArrow1Angle)
    return true
  end -- function end

LayerClear

TopOfPage.png

Deletes Layer if empty.

function LayerClear(LayerName)
   local Mylayer = Milling.job.LayerManager:GetLayerWithName(LayerName)
   if Mylayer.IsEmpty then
     Milling.job.LayerManager:RemoveLayer(Mylayer)
   end -- if end
   return true
 end -- function end

LeaderLine

TopOfPage.png
function DrawLeader(Pt1, Pt2, Pt3, Str, Layer, scale)   --Draws a leader with text
  --[[
  DrawLeader(pt1, pt2, "122.5", "TestLayer", 6.0)
  --]]
    local job = VectricJob()
    if not job.Exists then
      DisplayMessageBox("Error: No job loaded")
      return false
    end -- if end
    local ArrowLen       = 0.125 * scale
    local DimArrowAngle  = GetPolarDirection(Pt1, Pt2, Polar2D(Pt2, 0.0, 1.0))
    local TxtAngle       = GetPolarDirection(Pt2, Pt3, Polar2D(Pt3, 0.0, 1.0))
    local TxtPt          = Polar2D(Polar2D(Pt3, TxtAngle, ArrowLen), TxtAngle-45, H(ArrowLen))
    local Apt1           = Polar2D(Pt1, DimArrowAngle + 15.0, ArrowLen)
    local Apt2           = Polar2D(Pt1, DimArrowAngle - 15.0, ArrowLen)
    local ArrowHead      = ArrowLen * 0.333
    local line1          = Contour(0.0)
    local layer1         = job.LayerManager:GetLayerWithName(Layer)
    line1:AppendPoint(Pt1)
    line1:LineTo(Apt2) ;  line1:LineTo(Apt1) ; line1:LineTo(Pt1)
    layer1:AddObject(CreateCadContour(line1), true)
    local lineC = Contour(0.0)
    local layerC = job.LayerManager:GetLayerWithName(Layer)
    lineC:AppendPoint(Pt1)
    lineC:LineTo(Pt2)
    lineC:LineTo(Pt3)
    layerC:AddObject(CreateCadContour(lineC), true)
    if IsAllNumber(Str) then
      DrawWriter(Double2Fraction(Str), TxtPt, ArrowLen, Layer, TxtAngle)
    else
      DrawWriter(Str, TxtPt, ArrowLen, Layer, TxtAngle)
    end -- if end
    return true
  end -- function end

Scale

TopOfPage.png

Provides the correct scale rate-based drawing units.

function Scale(Num)
   local mtl_block = MaterialBlock()
   if mtl_block.InMM then
     return Num * 25.4
   else
     return Num
   end
 end -- function end

AssyHoler

TopOfPage.png

Draws Assy Holes in a stright line (Rabbet and/or Dado).

function AssyHoler(pt1, pt2, PartName)                  -- Draws Assy Holes in a stright line
     local Ang1 = GetPolarDirection(pt1, pt2)
     local Ang2 = GetPolarDirection(pt2, pt1)
            pt1 = Polar2D(pt1, Ang1, Milling.AssemblyHoleStartEnd)
     DrawCircle(pt1, Milling.AssemblyHoleRad, Milling.LNAssemblyHole .. PartName)
            pt2 = Polar2D(pt2, Ang2, Milling.AssemblyHoleStartEnd)
     DrawCircle(pt2, Milling.AssemblyHoleRad, Milling.LNAssemblyHole .. PartName)
     local Dist = GetDistance(pt1, pt2)
     if Project.Debugger then
        DMark("pt1", pt1)
        DMark("pt2", pt2)
     end -- if end 
     BaseScrew(2)
     Milling.AssemblyHoleSpace = ((Milling.AssemblyHoleMaxSpace + Milling.AssemblyHoleMinSpace) * 0.5)
     HoleCount = Round(math.floor(Dist / Milling.AssemblyHoleSpace))
     HoleSpacing = (Dist / HoleCount)
     HoleCount = (Dist / HoleSpacing)
     if (Dist > (HoleSpacing * 2.0)) then
     for i = HoleCount, 1, -1 do
       pt1 = Polar2D(pt1, Ang1, HoleSpacing)
       DrawCircle(pt1, Milling.AssemblyHoleRad, Milling.LNAssemblyHole .. PartName)
       if Project.Debugger then
 >       DMark("pt1w", pt1)
       end -- if end
       BaseScrew(1)
     end -- for end
   elseif (Dist > HoleSpacing) then
     ptC = Polar2D(pt1, Ang1, Dist / 2.0)
     if Project.Debugger then
       DMark("ptC", ptC)
     end -- if end
     DrawCircle(ptC, Milling.AssemblyHoleRad, Milling.LNAssemblyHole .. PartName)
   else
     -- Done No Holes
   end -- if end
   return true
 end -- function end

DrawBoneCenter2Pts

TopOfPage.png

Draws dog bone joints.

function DrawBoneCenter2Pts(pt1, pt2, SlotWidth, BitRadius)
   Local Project = {}
   Project.job   = VectricJob()
   Project.ang   = GetPolarDirection(pt1, pt2)
   Project.dis   = H(SlotWidth)
   Project.bit   = math.sin(math.rad(45.0)) * BitRadius
   Project.ptA   = Polar2D(pt1, Project.ang +  90.0, Project.dis)
   Project.ptAa  = Polar2D(Project.ptA, Project.ang, Project.bit)
   Project.ptAb  = Polar2D(Project.ptA, Project.ang + 270.0, Project.bit)
   Project.ptB   = Polar2D(pt1, Project.ang + 270.0, Project.dis)
   Project.ptBa  = Polar2D(Project.ptB, Project.ang +  90.0, Project.bit)
   Project.ptBb  = Polar2D(Project.ptB, Project.ang, Project.bit)
   Project.ptC   = Polar2D(pt2, Project.ang + 270.0, Project.dis)
   Project.ptCa  = Polar2D(Project.ptC, Project.ang +  90.0, Project.bit)
   Project.ptCb  = Polar2D(Project.ptC, Project.ang - 180.0, Project.bit)
   Project.ptD   = Polar2D(pt2, Project.ang +  90.0, Project.dis)
   Project.ptDa  = Polar2D(Project.ptD, Project.ang - 180.0, Project.bit)
   Project.ptDb  = Polar2D(Project.ptD, Project.ang + 270.0, Project.bit)
   Project.line  = Contour(0.0)
   Project.layer = Project.job.LayerManager:GetLayerWithName("DogBone")
   Project.line:AppendPoint(Project.ptAa)
   Project.line:ArcTo(Project.ptAb, 1.0)
   Project.line:LineTo(Project.ptBa)
   Project.line:ArcTo(Project.ptBb, 1.0)
   Project.line:LineTo(Project.ptCb)
   Project.line:ArcTo(Project.ptCa, 1.0)
   Project.line:LineTo(Project.ptDb)
   Project.line:ArcTo(Project.ptDa, 1.0)
   Project.line:LineTo(Project.ptAa)
   Project.layer:AddObject(CreateCadContour(Project.line), true)
   return true
 end -- function end

InsideCornerNipper

TopOfPage.png

Draws the nipping of a corner for easy fitting.

function InsideCornerNipper(AngPlung, BitRadius, CornerPt)
   local NipLength = math.sin(math.rad(45.0)) * ((BitRadius + 0.04) * 2.0)
   local Pt1, Pt2 = Point2D()
   if Material.Orientation == "V" then
     Pt1 = Polar2D(CornerPt, (AngPlung + 90.0) - 45.0, NipLength)
     Pt2 = Polar2D(CornerPt, (AngPlung + 90.0) + 45.0, NipLength)
   else
     Pt1 = Polar2D(CornerPt, (AngPlung + 180.0) - 45.0, NipLength)
     Pt2 = Polar2D(CornerPt, (AngPlung + 180.0) + 45.0, NipLength)
   end
   return Pt1, Pt2
 end -- function end

AddGroupToJob

TopOfPage.png

Builds a Grouping from the layer selection.

function AddGroupToJob(job, group, layer_name)
   --[[  --------------- AddGroupToJob --------------------------------------------------|
   |  Add passed group to the job - returns object created
   |  Parameters:
   |     job              -- job we are working with
   |     group            -- group of contours to   add to document
   |     layer_name       -- name of layer group will be created on|
   |  Return Values:
   |     object created to represent group in document
   ]]
   --  create a CadObject to represent the  group
   local cad_object = CreateCadGroup(group);
   -- create a layer with passed name if it doesnt already exist
   local layer = job.LayerManager:GetLayerWithName(layer_name)
   -- and add our object to it
   layer:AddObject(cad_object, true)
   return cad_object
  end -- function end

DrawArc

TopOfPage.png

Draws an Arc from points provided.

function DrawArc(PtS, PtE, ArcRadius, Layer)
   --[[Draw Arc
   function main(script_path)
   local MyPt1 = Point2D(3.5,3.8)
   local MyPt2 = Point2D(3.5,6.8)
   local layer = "My Arc"
   DrawArc(MyPt1, MyPt2, -0.456, Layer)
   return true
   end -- function end
   -- -----------------------------------------------------]]
       local job = VectricJob()
       if not job.Exists then
         DisplayMessageBox("Error: No job loaded")
         return false
       end
       local line = Contour(0.0)
       local layer = job.LayerManager:GetLayerWithName(Layer)
       line:AppendPoint(PtS)
       line:ArcTo(PtE,1);
       layer:AddObject(CreateCadContour(line), true)
       return true
     end -- function end

DrawEllipse

TopOfPage.png

Draws a DrawEllipse from points provided.

function DrawEllipse(CenterPt, LongAxe, ShortAxe, Layer)
   local LongAngle = 90.0
   local ValueAB = (LongAxe - ShortAxe) * 0.50
   local ValueAC = ValueAB * math.cos(math.rad(LongAngle))
   local job = VectricJob()
   local LRad = LongAxe * 0.50
   local ptT = Polar2D(CenterPt, LongAngle, LRad)
   local X = 0.0
   local pty = Point2D(0.0,0.0)
   local ptx = Point2D(0.0,0.0)
   local mylayer = job.LayerManager:GetLayerWithName(Layer)
   local line = Contour(0.0)
         line:AppendPoint(ptT)
     while (X < 360.0) do
        pty = Polar2D(CenterPt, LongAngle + X, LRad)
    ValueAC = ValueAB * math.cos(math.rad(LongAngle + X))
    if ((LongAngle + X) >= 90.0) then
      ptx = Polar2D(pty, 180.0, ValueAC)
    else
      ptx = Polar2D(pty,   0.0, ValueAC)
    end
    line:LineTo(ptx)
    X = X + 1
   end -- while end
   line:LineTo(ptT)
   mylayer:AddObject(CreateCadContour(line), true)
   return true
 end -- function end

DrawEllipse1

TopOfPage.png

Draws a DrawEllipse from points provided.

function DrawEllipse1(DrawEllipse_CenterPt, DrawEllipse_LongAxe, DrawEllipse_ShortAxe, DrawEllipse_LongAxeAngle, DrawEllipse_Layer)
     -- ---------------------------------------------------]]
     function H(x)                                         -- Returns half the value
       return x * 0.5
     end -- function end
     -- ---------------------------------------------------]]
     function Polar2D(pt, ang, dis)                        -- Calculate a new point based on reference point, angle and distance.
     -- Returns a 2Dpoint(x, y)
       return Point2D((pt.X + dis * math.cos(math.rad(ang))), (pt.Y + dis * math.sin(math.rad(ang))))
     end -- End Function
     -- ---------------------------------------------------]]
     function GetDistance(objA, objB)
       local xDist = objB.x - objA.x
       local yDist = objB.y - objA.y
       return math.sqrt((xDist ^ 2) + (yDist ^ 2))
     end -- function end
     -- ---------------------------------------------------]]
     function Radius2Bulge (p1, p2, Rad)
       local chord = math.sqrt(((p2.x - p1.x) ^ 2) + ((p2.y - p1.y) ^ 2))
       local seg = (Rad - (0.5 * (math.sqrt((4.0 * Rad^2) - chord^2))))
       local bulge = (2 * seg) / chord
       return bulge
     end -- function end
     -- ---------------------------------------------------]]
   function GetPolarAngle(Start, Corner, End)
     local function GetPolarDirection(point1, point2)              --
       local ang = math.abs(math.deg(math.atan((point2.Y - point1.Y) / (point2.X - point1.X))))
       if point1.X < point2.X then
         if point1.Y < point2.Y then
           ang = ang + 0.0
         else
           ang = 360.0 - ang
         end -- if end
       else
         if point1.Y < point2.Y then
           ang = 180.0 - ang
         else
           ang = ang + 180.0
         end -- if end
       end -- if end
       if ang >=360 then
         ang = ang -360.0
       end -- if end
       return ang
     end -- function end
     return  math.abs(GetPolarDirection(Corner, Start) - GetPolarDirection(Corner, End))
   end -- function end
     -- ---------------------------------------------------]]
 
     -- Call = DrawEllipse(2DPoint(20.0, 20.0), 20.0, 10.0, 0.0, "Jim")
     local job = VectricJob()
     local EndRadius = 0.0
     local TopRadius = 0.0
     local ptT = Polar2D(DrawEllipse_CenterPt,  (90.0 + DrawEllipse_LongAxeAngle), H(DrawEllipse_ShortAxe))
     local ptB = Polar2D(DrawEllipse_CenterPt, (270.0 + DrawEllipse_LongAxeAngle), H(DrawEllipse_ShortAxe))
     local ptR = Polar2D(DrawEllipse_CenterPt,   (0.0 + DrawEllipse_LongAxeAngle), H(DrawEllipse_LongAxe))
     local ptL = Polar2D(DrawEllipse_CenterPt, (180.0 + DrawEllipse_LongAxeAngle), H(DrawEllipse_LongAxe))
     local ptC = DrawEllipse_CenterPt
     --[[
       DMark("ptC", ptC)
       DMark("ptT", ptT)
       DMark("ptB", ptB)
       DMark("ptL", ptL)
       DMark("ptR", ptR)]]
     local C_Offset = H(DrawEllipse_LongAxe - DrawEllipse_ShortAxe)
     local LT_SlopeDist = H(GetDistance(ptL, ptT) - H(DrawEllipse_LongAxe - DrawEllipse_ShortAxe))
     local LT_Dist  = GetDistance(ptL, ptT)
     local LT_Angle = math.abs(90.0 - GetAngle(ptT, ptL, ptC))
     local pt_a = Polar2D(ptL, LT_Angle + DrawEllipse_LongAxeAngle, LT_SlopeDist)
     local aT_Dist  = GetDistance(pt_a, ptT)
     local aC_Dist = aT_Dist / (math.tan(math.rad(LT_Angle)))
     local Tc_Dist = math.sqrt(aT_Dist^2 + aC_Dist^2)
     local pt_c = Polar2D(ptT, (270.0 + DrawEllipse_LongAxeAngle), Tc_Dist)
     local cC_Dist  = GetDistance(pt_c, ptC)
     local b_Dist = math.tan(math.rad(LT_Angle)) * cC_Dist
     local pt_b = Polar2D(ptC, (180.0 + DrawEllipse_LongAxeAngle), b_Dist)
     local pt_d = Polar2D(ptB,  (90.0 + DrawEllipse_LongAxeAngle), Tc_Dist)
     local pt_e = Polar2D(ptC,   (0.0 + DrawEllipse_LongAxeAngle), b_Dist)
     local pt1  = Polar2D(pt_d, (270.0 + DrawEllipse_LongAxeAngle) - LT_Angle, Tc_Dist)
     local pt2  = Polar2D(pt_d, (270.0 + DrawEllipse_LongAxeAngle) + LT_Angle, Tc_Dist)
     local pt3  = Polar2D(pt_c,  (90.0 + DrawEllipse_LongAxeAngle) - LT_Angle, Tc_Dist)
     local pt4  = Polar2D(pt_c,  (90.0 + DrawEllipse_LongAxeAngle) + LT_Angle, Tc_Dist)
     --[[
       DMark("pt1", pt1)
       DMark("pt2", pt2)
       DMark("pt3", pt3)
       DMark("pt4", pt4)
       local line = Contour(0.0)
       local layer = job.LayerManager:GetLayerWithName(DrawEllipse_Layer)
       line:AppendPoint(pt1)
       line:LineTo(pt2)
       line:LineTo(pt3)
       line:LineTo(pt4)
       line:LineTo(pt1)
       layer:AddObject(CreateCadContour(line), true)]]
     local T_Sec   = GetDistance(ptC, ptT) - H(GetDistance(pt1, pt4))
     local R_Sec   = GetDistance(ptC, ptR) - H(GetDistance(pt1, pt2))
     local T_Chor  = GetDistance(pt1, pt2)
     local R_Chor  = GetDistance(pt1, pt4)
     local T_Bulge = Radius2Bulge (pt1, pt2, Tc_Dist)
     local L_Bulge = Radius2Bulge (pt1, pt4, GetDistance(ptL, pt_b))
 
     local line = Contour(0.0)
     local layer = job.LayerManager:GetLayerWithName(DrawEllipse_Layer)
     line:AppendPoint(pt1)
     line:ArcTo(pt2, T_Bulge)
     line:ArcTo(pt3, L_Bulge)
     line:ArcTo(pt4, T_Bulge)
     line:ArcTo(pt1, L_Bulge)
     layer:AddObject(CreateCadContour(line), true)
     job:Refresh2DView()
     return true
  end -- function end

DrawBox

TopOfPage.png

Draws a Box from points provided.

function DrawBox(p1, p2, p3, p4, Layer)
     --[[ Draw Box
     function main(script_path)
     local MyPt1 = Point2D(1.0,1.0)
     local MyPt2 = Point2D(1.0,3.0)
     local MyPt3 = Point2D(3.0,1.0)
     local MyPt4 = Point2D(3.0,3.0)
     local layer = "My Box"
     DrawBox(MyPt1 ,MyPt2, MyPt3, MyPt4, Layer)
     return true
     end -- function end
   -- -----------------------------------------------------]]
       local job = VectricJob()
       if not job.Exists then
         DisplayMessageBox("Error: No job loaded")
         return false
       end -- if end
       local line = Contour(0.0)
       local layer = job.LayerManager:GetLayerWithName(Layer)
       line:AppendPoint(p1)
       line:LineTo(p2)
       line:LineTo(p3)
       line:LineTo(p4)
       line:LineTo(p1)
       layer:AddObject(CreateCadContour(line), true)
       return true
 end -- function end

DrawCircle

TopOfPage.png

Draws a circle.

function DrawCircle(Pt1, CenterRadius, Layer)
   --[[ ==Draw Circle==
     function main(script_path)
     local MyPt1 = Point2D(1.0,1.0)
     local MyRad = 3.0
     local layer = "My Box"
     DrawCircle(MyPt1, MyRad, Layer)
     return true
     end -- function end
   -- -----------------------------------------------------]]
     local job = VectricJob()
     if not job.Exists then
       DisplayMessageBox("Error: No job loaded")
       return false
     end -- if end
     local pa = Polar2D(Pt1,   180.0, CenterRadius)
     local pb = Polar2D(Pt1,     0.0, CenterRadius)
     local Contour = Contour(0.0)
     local layer = job.LayerManager:GetLayerWithName(Layer)
     Contour:AppendPoint(pa)
     Contour:ArcTo(pb, 1)
     Contour:ArcTo(pa, 1)
     layer:AddObject(CreateCadContour(Contour), true)
     return true
 end -- function end


DrawLine

TopOfPage.png

Draws a Line from points provided.

function DrawLine(Pt1, Pt2, Layer)
   --[[Draws a line from Pt1 to Pt2 on the layer name.
   function main(script_path)
   local MyPt1 = Point2D(3.5,3.8)
   local MyPt2 = Point2D(3.5,6.8)
   local layer = "My Line"
   DrawLine(MyPt1 , MyPt2, MyPt3, Layer)
   return true
   end -- function end
   -- -----------------------------------------------------]]
     local job = VectricJob()
     if not job.Exists then
       DisplayMessageBox("Error: No job loaded")
       return false
     end
     local line = Contour(0.0)
     local layer = job.LayerManager:GetLayerWithName(Layer)
     line:AppendPoint(Pt1)
     line:LineTo(Pt2)
     layer:AddObject(CreateCadContour(line), true)
     return true
 end -- function end

DrawStar

TopOfPage.png

Draws a Star from points provided.

function DrawStar(pt1, InRadius ,OutRadius, layer)      --This draw function requires the center point, inter star radius, outer star radius and layer name.
   --[[
     function main(script_path)
       local MyPt = Point2D(3.5,3.8)
       local InRadius = 9.0
       local OutRadius= 20.0
       local layer = "My Star"
       DrawStar(MyPt , InRadius ,OutRadius, layer)
       return true
     end -- function end
   -- -----------------------------------------------------]]
     local job = VectricJob()
     if not job.Exists then
       DisplayMessageBox("Error: No job loaded")
       return false
     end
     local p1 =  Polar2D(pt1,  18.0,  OutRadius)
     local p2 =  Polar2D(pt1,  54.0,  InRadius)
     local p3 =  Polar2D(pt1,  90.0,  OutRadius)
     local p4 =  Polar2D(pt1,  126.0, InRadius)
     local p5 =  Polar2D(pt1,  162.0, OutRadius)
     local p6 =  Polar2D(pt1,  198.0, InRadius)
     local p7 =  Polar2D(pt1,  234.0, OutRadius)
     local p8 =  Polar2D(pt1,  270.0, InRadius)
     local p9 =  Polar2D(pt1,  306.0, OutRadius)
     local p0 =  Polar2D(pt1,  342.0, InRadius)
     local line = Contour(0.0)
    -- local layers = job.LayerManager:GetLayerWithName(layer)
     line:AppendPoint(p1);
     line:LineTo(p2);  line:LineTo(p3)
     line:LineTo(p4);  line:LineTo(p5)
     line:LineTo(p6);  line:LineTo(p7)
     line:LineTo(p8);  line:LineTo(p9)
     line:LineTo(p0);  line:LineTo(p1)
     layer:AddObject(CreateCadContour(line), true)
     job:Refresh2DView()
     return true
 end -- function end

DrawTriangle

TopOfPage.png

Draws a Triangle from points provided.

function DrawTriangle(p1, p2, p3, Layer)
   --<nowiki>[[Draw Triangle
     function main(script_path)
       local MyPt1 = Point2D(3.5,3.8)
       local MyPt2 = Point2D(3.5,6.8)
       local MyPt3 = Point2D(9.8,6.8)
       local layer = "My Triangle"
       DrawTriangle(MyPt1 , MyPt2, MyPt3, Layer)
       return true
     end -- function end 
     local job = VectricJob()
     if not job.Exists then
       DisplayMessageBox("Error: No job loaded")
       return false
     end
     local line = Contour(0.0)
     local layer = job.LayerManager:GetLayerWithName(Layer)
     line:AppendPoint(p1)
     line:LineTo(p2)
     line:LineTo(p3)
     line:LineTo(p1)
     layer:AddObject(CreateCadContour(line), true)
     job:Refresh2DView()
     return true
   end -- function end
   -- =====================================================]]
   function Radius2Bulge (p1, p2, Rad)
     local chord = math.sqrt(((p2.x - p1.x) ^ 2) + ((p2.y - p1.y) ^ 2))
     local seg = (Rad - (0.5 * (math.sqrt((4.0 * Rad^2) - chord^2))))
     local bulge = (2 * seg) / chord
     return bulge
   end
   -- =====================================================]]
   function ChordSeg2Radius (Chr, Seg)
     local rad =  (((Chr * Chr)/(Seg * 4)) + Seg) / 2.0
     return rad
 end -- function end

CreateJob

TopOfPage.png

Create a new job/drawing setup.

function CreateJob(job_name, width, height, thickness, in_mm, job_origin, z_on_surface)
 --[[ ----------- CreateJob -------------------------------------------------
   | This function was provided "as is" by Vectric technical team and a part of the gadget API documentation.
   | Create a new empty job with the passed settings]]
   -- we fill in most of our bounds in a Box2D
   local job_bounds = Box2D()
   local blc = Point2D(0, 0)
   local trc = Point2D(width, height)
   local origin_offset = Vector2D(0,0)
   -- calculate bottom left corner offset for chosen origin
   if Template.DXFOrientation == "Vertical" then
     trc = Point2D(height, width)
     if (job_origin == "BLC") then
       origin_offset:Set(0, 0)
     elseif (job_origin == "BRC") then
       origin_offset:Set(height, 0)
     elseif (job_origin == "TRC") then
       origin_offset:Set(height, width)
     elseif (job_origin == "TLC") then
       origin_offset:Set(0, width)
     elseif (job_origin == "CENTRE") then
       origin_offset:Set(height / 2, width / 2)
     elseif (job_origin == "CENTER") then
       origin_offset:Set(height / 2, width / 2)
     else
       MessageBox("Unknown XY origin specified " .. job_origin)
     end
   else
     if (job_origin == "BLC") then
       origin_offset:Set(0, 0)
     elseif (job_origin == "BRC") then
       origin_offset:Set(width, 0)
     elseif (job_origin == "TRC") then
       origin_offset:Set(width, height)
     elseif (job_origin == "TLC") then
       origin_offset:Set(0, height)
     elseif (job_origin == "CENTRE") then
       origin_offset:Set(width / 2, height / 2)
     elseif (job_origin == "CENTER") then
       origin_offset:Set(width / 2, height / 2)
     else
       MessageBox("Unknown XY origin specified " .. job_origin)
     end
   end
   -- subtract the origin offset vector from our 'standard' corner positions to get position for corners for requested origin
   blc = blc - origin_offset
   trc = trc - origin_offset
   job_bounds:Merge(blc)
   job_bounds:Merge(trc)
   local success = CreateNewJob(job_name,job_bounds,thickness,in_mm,z_on_surface)
   return success
 end -- function end

DrawFontGrid - Draws font grid to create letters

TopOfPage.png

Draws the font grid for drawing new letters.

function DrawFontGrid(job)
     local pt = Point2D(0.3,0.3)
     local scl  = 1.0 -- (scl * 0.5)
     local pA0  = pt
     local ang  = 0.0
     local pA1  = Polar2D(pt, ang + 90.0000, (0.2500 * scl))
     local pA2  = Polar2D(pt, ang + 90.0000, (0.5000 * scl))
     local pA3  = Polar2D(pt, ang + 90.0000, (0.7500 * scl))
     local pA4  = Polar2D(pt, ang + 90.0000, (1.0000 * scl))
     local pA5  = Polar2D(pt, ang + 90.0000, (1.2500 * scl))
     local pA6  = Polar2D(pt, ang + 90.0000, (1.5000 * scl))
     local pA7  = Polar2D(pt, ang + 90.0000, (1.7500 * scl))
     local pA8  = Polar2D(pt, ang + 90.0000, (2.0000 * scl))
     local pA9  = Polar2D(pt, ang + 90.0000, (2.2500 * scl))
     local pA10 = Polar2D(pt, ang + 90.0000, (2.5000 * scl))
 
     PointCircle(pA0)
     PointCircle(pA1)
     PointCircle(pA2)
     PointCircle(pA3)
     PointCircle(pA4)
     PointCircle(pA5)
     PointCircle(pA6)
     PointCircle(pA7)
     PointCircle(pA8)
     PointCircle(pA9)
     PointCircle(pA10)
 
     local pB0  = Polar2D(pt, ang +  0.0000, (0.2500 * scl))
     local pB1  = Polar2D(pt, ang + 45.0000, (0.3536 * scl))
     local pB2  = Polar2D(pt, ang + 63.4352, (0.5590 * scl))
     local pB3  = Polar2D(pt, ang + 71.5651, (0.7906 * scl))
     local pB4  = Polar2D(pt, ang + 75.9638, (1.0308 * scl))
     local pB5  = Polar2D(pt, ang + 78.6901, (1.2748 * scl))
     local pB6  = Polar2D(pt, ang + 80.5376, (1.5207 * scl))
     local pB7  = Polar2D(pt, ang + 81.8699, (1.7678 * scl))
     local pB8  = Polar2D(pt, ang + 82.8750, (2.0156 * scl))
     local pB10 = Polar2D(pt, ang + 84.2894, (2.5125 * scl))
 
     PointCircle(pB0)
     PointCircle(pB1)
     PointCircle(pB2)
     PointCircle(pB3)
     PointCircle(pB4)
     PointCircle(pB5)
     PointCircle(pB7)
     PointCircle(pB8)
     PointCircle(pB10)
 
     local pC0 = Polar2D(pt, ang +  0.0000, (0.5000 * scl))
     local pC1 = Polar2D(pt, ang + 26.5650, (0.5590 * scl))
     local pC2 = Polar2D(pt, ang + 45.0000, (0.7071 * scl))
     local pC3 = Polar2D(pt, ang + 56.3099, (0.9014 * scl))
     local pC4 = Polar2D(pt, ang + 63.4342, (1.1180 * scl))
     local pC5 = Polar2D(pt, ang + 68.1993, (1.3463 * scl))
     local pC6 = Polar2D(pt, ang + 71.5650, (1.5811 * scl))
     local pC7 = Polar2D(pt, ang + 63.4342, (1.1180 * scl))
     local pC8 = Polar2D(pt, ang + 74.0550, (1.8201 * scl))
     local pC10 = Polar2D(pt, ang + 78.6899, (2.5495 * scl))
 
     PointCircle(pC0)
     PointCircle(pC1)
     PointCircle(pC2)
     PointCircle(pC3)
     PointCircle(pC4)
     PointCircle(pC6)
     PointCircle(pC8)
     PointCircle(pC10)
 
     local pD0 = Polar2D(pt, ang +  0.0000, (0.6250 * scl))
     local pD1 = Polar2D(pt, ang + 21.8014, (0.6731 * scl))
     local pD2 = Polar2D(pt, ang + 33.6901, (0.9014 * scl))
     local pD4 = Polar2D(pt, ang + 57.9946, (1.1792 * scl))
     local pD7 = Polar2D(pt, ang + 70.3462, (1.8583 * scl))
     local pD8 = Polar2D(pt, ang + 72.6460, (2.0954 * scl))
 
     PointCircle(pD0)
     PointCircle(pD1)
     PointCircle(pD2)
     PointCircle(pD4)
     PointCircle(pD7)
     PointCircle(pD8)
 
     local pE0 = Polar2D(pt, ang +  0.0000, (0.7500 * scl))
     local pE1 = Polar2D(pt, ang + 18.4346, (0.7906 * scl))
     local pE2 = Polar2D(pt, ang + 33.6901, (0.9014 * scl))
     local pE3 = Polar2D(pt, ang + 45.0000, (1.0607 * scl))
     local pE5 = Polar2D(pt, ang + 59.0371, (1.4578 * scl))
     local pE6 = Polar2D(pt, ang + 63.4349, (1.6771 * scl))
     local pE7 = Polar2D(pt, ang + 66.4349, (1.9039 * scl))
     local pE8 = Polar2D(pt, ang + 69.4440, (2.1360 * scl))
 
     PointCircle(pE0)
     PointCircle(pE1)
     PointCircle(pE2)
     PointCircle(pE3)
     PointCircle(pE5)
     PointCircle(pE6)
     PointCircle(pE7)
     PointCircle(pE8)
 
     local pF0 = Polar2D(pt, ang +  0.0000, (1.0000 * scl))
     local pF1 = Polar2D(pt, ang + 14.0360, (1.0308 * scl))
     local pF2 = Polar2D(pt, ang + 26.5651, (1.1180 * scl))
     local pF3 = Polar2D(pt, ang + 36.8699, (1.2500 * scl))
     local pF4 = Polar2D(pt, ang + 45.0000, (1.4142 * scl))
     local pF5 = Polar2D(pt, ang + 51.3425, (1.6006 * scl))
     local pF6 = Polar2D(pt, ang + 56.3099, (1.8025 * scl))
     local pF7 = Polar2D(pt, ang + 60.2551, (2.0156 * scl))
     local pF8 = Polar2D(pt, ang + 63.4349, (2.2361 * scl))
 
     PointCircle(pF0)
     PointCircle(pF1)
     PointCircle(pF2)
     PointCircle(pF3)
     PointCircle(pF4)
     PointCircle(pF5)
     PointCircle(pF6)
     PointCircle(pF7)
     PointCircle(pF8)
 
     local pG0 = Polar2D(pt, ang +  0.0000, (1.2500 * scl))
     local pG1 = Polar2D(pt, ang + 11.3099, (1.2748 * scl))
     local pG2 = Polar2D(pt, ang + 21.8014, (1.3463 * scl))
     local pG3 = Polar2D(pt, ang + 30.9638, (1.4577 * scl))
     local pG4 = Polar2D(pt, ang + 38.6598, (1.6008 * scl))
     local pG5 = Polar2D(pt, ang + 45.0000, (1.7678 * scl))
     local pG6 = Polar2D(pt, ang + 50.1944, (1.9526 * scl))
     local pG7 = Polar2D(pt, ang + 54.4623, (2.1506 * scl))
     local pG8 = Polar2D(pt, ang + 57.9946, (2.3585 * scl))
     local pG10 = Polar2D(pt,59.0362, (2.9155 * scl))
 
     PointCircle(pG0)
     PointCircle(pG1)
     PointCircle(pG2)
     PointCircle(pG3)
     PointCircle(pG4)
     PointCircle(pG5)
     PointCircle(pG6)
     PointCircle(pG7)
     PointCircle(pG8)
     PointCircle(pG10)
 
     local pH0  = Polar2D(pt, ang + 0.0000, (1.5000 * scl))
     local pH10 = Polar2D(pt, 63.4349,      (2.7951 * scl))
     PointCircle(pH0)
     PointCircle(pH10)
     job:Refresh2DView()
     return true
   end
 
 
   -- =========================================================================
   local function AddGroupToJob(job, group, layer_name)
      --  create a CadObject to represent the  group
     local cad_object = CreateCadGroup(group);
      -- create a layer with passed name if it doesnt already exist
     local layer = job.LayerManager:GetLayerWithName(layer_name)
      -- and add our object to it
     layer:AddObject(cad_object, true)
     return cad_object
   end -- end function
 
   -- =========================================================================
     local job = VectricJob()
     if not job.Exists then
       DisplayMessageBox("Error: Not finding a job loaded")
       return false
     end
     local strlen = string.len(what)
     local strup = string.upper(what)
     local x = strlen
     local i = 1
     local y = ""
     local ptx = where
     group = ContourGroup(true)
     while i <=  x do
       y = string.byte(string.sub(strup, i, i))
       ptx = MonoFont(job, ptx, y, size, lay, ang)
       i = i + 1
     end -- while end;
     AddGroupToJob(job, group, lay)
     job:Refresh2DView()
     return true ;
 end -- function end

DrawWriter - Draws Upper and Lower case text on the drawing

TopOfPage.png
function DrawWriter(what, where, size, lay, ang) -- Draws Upper and Lower case text on the drawing.
   --[[ How to use:
   |    local TextMessage = "Your Text Here"
   |    local TextPt = Point2D(3.5,3.8)
   |    local TextHight = 0.5
   |    local TextLayer = "Text Layer"
   |    local TextAng = 20.0
   |    DrawWriter(TextMessage, TextPt , TextHight , TextLayer, TextAng)
   |    -- ==Draw Writer==
   |    -- Utilizing a provided string of text, the program walks the string and reproduces each letter (parametrically) on the drawing using vectors.
   function main()
       -- create a layer with passed name if it doesn't already exist
     local job = VectricJob()
     if not job.Exists then
          DisplayMessageBox("No job loaded")
          return false;
     end
     local TextMessage = "Aa Bb Cc Dd Ee Ff Gg Hh Ii Jj Kk Ll Mm Nn Oo Pp Qq Rr Ss Tt Uu Vv Ww Xx Yy Zz 1 2 3 4 5 6 7 8 9 0 ! @ # $ % & * ( ) { } [ ] ? , . : ; '' ' _ - + = ~ ^ < > |"
     local TextPt = Point2D(0.1, 2.0)
     local TextHight = 0.25
     local TextLayer = "Gadget Text"
     local TextAng = 10.0
     DrawWriter(TextMessage, TextPt, TextHight, TextLayer, TextAng)
     job:Refresh2DView()
     return true
   end
   --]]
   -- =========================================================================
   local function Polar2D(pt, ang, dis)
     return Point2D((pt.X + dis * math.cos(math.rad(ang))), (pt.Y + dis * math.sin(math.rad(ang))))
   end
   -- =========================================================================
   local function MonoFont(job, pt, letter, scl, lay, ang)
     scl = (scl * 0.5) ;
     local pA0 = pt ;
     local pA1  = Polar2D(pt, ang + 90.0000, (0.2500 * scl)) ;  local pA2   = Polar2D(pt, ang + 90.0000, (0.5000 * scl)) ;
     local pA3  = Polar2D(pt, ang + 90.0000, (0.7500 * scl)) ;  local pA4   = Polar2D(pt, ang + 90.0000, (1.0000 * scl)) ;
     local pA5  = Polar2D(pt, ang + 90.0000, (1.2500 * scl)) ;  local pA6   = Polar2D(pt, ang + 90.0000, (1.5000 * scl)) ;
     local pA7  = Polar2D(pt, ang + 90.0000, (1.7500 * scl)) ;  local pA8   = Polar2D(pt, ang + 90.0000, (2.0000 * scl)) ;
     local pA9  = Polar2D(pt, ang + 90.0000, (2.2500 * scl)) ;  local pA10  = Polar2D(pt, ang + 90.0000, (2.5000 * scl)) ;
     local pB0  = Polar2D(pt, ang +  0.0000, (0.2500 * scl)) ;  local pB1   = Polar2D(pt, ang + 45.0000, (0.3536 * scl)) ;
     local pB2  = Polar2D(pt, ang + 63.4352, (0.5590 * scl)) ;  local pB3   = Polar2D(pt, ang + 71.5651, (0.7906 * scl)) ;
     local pB4  = Polar2D(pt, ang + 75.9638, (1.0308 * scl)) ;  local pB5   = Polar2D(pt, ang + 78.6901, (1.2748 * scl)) ;
     local pB6  = Polar2D(pt, ang + 80.5376, (1.5207 * scl)) ;  local pB7   = Polar2D(pt, ang + 81.8699, (1.7678 * scl)) ;
     local pB8  = Polar2D(pt, ang + 82.8750, (2.0156 * scl)) ;  local pB10  = Polar2D(pt, ang + 84.2894, (2.5125 * scl)) ;
     local pC0  = Polar2D(pt, ang +  0.0000, (0.5000 * scl)) ;  local pC1   = Polar2D(pt, ang + 26.5650, (0.5590 * scl)) ;
     local pC2  = Polar2D(pt, ang + 45.0000, (0.7071 * scl)) ;  local pC3   = Polar2D(pt, ang + 56.3099, (0.9014 * scl)) ;
     local pC4  = Polar2D(pt, ang + 63.4342, (1.1180 * scl)) ;  local pC5   = Polar2D(pt, ang + 68.1993, (1.3463 * scl)) ;
     local pC6  = Polar2D(pt, ang + 71.5650, (1.5811 * scl)) ;  local pC7   = Polar2D(pt, ang + 63.4342, (1.1180 * scl)) ;
     local pC8  = Polar2D(pt, ang + 75.9640, (2.0616 * scl)) ;  local pC10  = Polar2D(pt, ang + 78.6899, (2.5495 * scl)) ;
     local pD0  = Polar2D(pt, ang +  0.0000, (0.6250 * scl)) ;  local pD1   = Polar2D(pt, ang + 21.8014, (0.6731 * scl)) ;
     local pD2  = Polar2D(pt, ang + 33.6901, (0.9014 * scl)) ;  local pD4   = Polar2D(pt, ang + 57.9946, (1.1792 * scl)) ;
     local pD7  = Polar2D(pt, ang + 70.3462, (1.8583 * scl)) ;  local pD8   = Polar2D(pt, ang + 72.6460, (2.0954 * scl)) ;
     local pE0  = Polar2D(pt, ang +  0.0000, (0.7500 * scl)) ;  local pE1   = Polar2D(pt, ang + 18.4346, (0.7906 * scl)) ;
     local pE2  = Polar2D(pt, ang + 33.6901, (0.9014 * scl)) ;  local pE3   = Polar2D(pt, ang + 45.0000, (1.0607 * scl)) ;
     local pE5  = Polar2D(pt, ang + 59.0371, (1.4578 * scl)) ;  local pE6   = Polar2D(pt, ang + 63.4349, (1.6771 * scl)) ;
     local pE7  = Polar2D(pt, ang + 66.4349, (1.9039 * scl)) ;  local pE8   = Polar2D(pt, ang + 69.4440, (2.1360 * scl)) ;
     local pF0  = Polar2D(pt, ang +  0.0000, (1.0000 * scl)) ;  local pF1   = Polar2D(pt, ang + 14.0360, (1.0308 * scl)) ;
     local pF2  = Polar2D(pt, ang + 26.5651, (1.1180 * scl)) ;  local pF3   = Polar2D(pt, ang + 36.8699, (1.2500 * scl)) ;
     local pF4  = Polar2D(pt, ang + 45.0000, (1.4142 * scl)) ;  local pF5   = Polar2D(pt, ang + 51.3425, (1.6006 * scl)) ;
     local pF6  = Polar2D(pt, ang + 56.3099, (1.8025 * scl)) ;  local pF7   = Polar2D(pt, ang + 60.2551, (2.0156 * scl)) ;
     local pF8  = Polar2D(pt, ang + 63.4349, (2.2361 * scl)) ;  local pG0   = Polar2D(pt, ang +  0.0000, (1.2500 * scl)) ;
     local pG1  = Polar2D(pt, ang + 11.3099, (1.2748 * scl)) ;  local pG2   = Polar2D(pt, ang + 21.8014, (1.3463 * scl)) ;
     local pG3  = Polar2D(pt, ang + 30.9638, (1.4577 * scl)) ;  local pG4   = Polar2D(pt, ang + 38.6598, (1.6008 * scl)) ;
     local pG5  = Polar2D(pt, ang + 45.0000, (1.7678 * scl)) ;  local pG6   = Polar2D(pt, ang + 50.1944, (1.9526 * scl)) ;
     local pG7  = Polar2D(pt, ang + 54.4623, (2.1506 * scl)) ;  local pG8   = Polar2D(pt, ang + 57.9946, (2.3585 * scl)) ;
     local pG10 = Polar2D(pt,59.0362, (2.9155 * scl))        ;  local pH0   = Polar2D(pt, ang +  0.0000, (1.5000 * scl)) ;
     local pH10 = Polar2D(pt,63.4349, (2.7951 * scl))        ;  local layer = job.LayerManager:GetLayerWithName(lay) ;
     local line = Contour(0.0) ;
    -- ------------------------------------------------------------------------
     if letter == 32 then
       pH0 = pH0
     end
     if letter == 33 then
       line:AppendPoint(pB0) ;  line:LineTo(pE0) ;  line:LineTo(pE2) ;  line:LineTo(pB2) ;  line:LineTo(pB0) ;  group:AddTail(line) ;
       line = Contour(0.0) line:AppendPoint(pB3) ;  line:LineTo(pE3) ;  line:LineTo(pE8) ;  line:LineTo(pB8) ;  line:LineTo(pB3) ;  group:AddTail(line) ;
     end
     if letter == 34 then
       line:AppendPoint(pA7) ;  line:LineTo(pB10) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pB7) ;  line:LineTo(pC10) ;
       group:AddTail(line) ;  pH0 = pE0
     end
     if letter == 35 then
       line:AppendPoint(pA2) ;  line:LineTo(pG2) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pA6) ;
       line:LineTo(pG6) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pB0) ;  line:LineTo(pB8) ;  group:AddTail(line) ;
       line = Contour(0.0) ;  line:AppendPoint(pF0) ;  line:LineTo(pF8) ;  group:AddTail(line) ;
     end
     if letter == 36 then
       line:AppendPoint(pA1) ;  line:LineTo(pB0) ;  line:LineTo(pF0) ;  line:LineTo(pG1) ;  line:LineTo(pG3) ;  line:LineTo(pF4) ;
       line:LineTo(pB4) ;  line:LineTo(pA5) ;  line:LineTo(pA7) ;  line:LineTo(pB8) ;  line:LineTo(pF8) ;  line:LineTo(pG7) ;  group:AddTail(line) ;
       line = Contour(0.0) ;  line:AppendPoint(pC0) ;  line:LineTo(pE0) ;  line:LineTo(pE8) ;  line:LineTo(pC8) ;  line:LineTo(pC0) ;  group:AddTail(line) ;
     end
     if letter == 37 then
       line:AppendPoint(pC6) ;  line:LineTo(pC8) ;  line:LineTo(pA8) ;  line:LineTo(pA6) ;  line:LineTo(pE6) ;  line:LineTo(pG8) ;
       line:LineTo(pA0) ;  line:LineTo(pC2) ;  line:LineTo(pG2) ;  line:LineTo(pG0) ;  line:LineTo(pE0) ;  line:LineTo(pE2) ;  group:AddTail(line) ;
     end
     if letter == 38 then
       line:AppendPoint(pG2) ;  line:LineTo(pG1) ;  line:LineTo(pF0) ;  line:LineTo(pB0) ;  line:LineTo(pA1) ;  line:LineTo(pA3) ;
       line:LineTo(pE6) ;  line:LineTo(pE7) ;  line:LineTo(pD8) ;  line:LineTo(pB8) ;  line:LineTo(pA7) ;  line:LineTo(pA6) ;  line:LineTo(pG0) ;
       group:AddTail(line) ;
     end
     if letter == 39 then
       line:AppendPoint(pA7) ;  line:LineTo(pB10) ;  group:AddTail(line) ;  pH0 = pC0
     end
     if letter == 40 then
       line:AppendPoint(pB8) ;  line:LineTo(pA5) ;  line:LineTo(pA3) ;  line:LineTo(pB0) ;  group:AddTail(line) ;  pH0 = pD0
     end
     if letter == 41 then
       line:AppendPoint(pA8) ;  line:LineTo(pB5) ;  line:LineTo(pB3) ;  line:LineTo(pA0) ;  group:AddTail(line) ;  pH0 = pG0
     end
     if letter == 42 then
       line:AppendPoint(pA2) ;  line:LineTo(pG6) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pA6) ;  line:LineTo(pG2) ;
       group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pA4) ;  line:LineTo(pG4) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pD7) ;
       line:LineTo(pD1) ;  group:AddTail(line) ;
     end
     if letter == 43 then
       line:AppendPoint(pA4) ;  line:LineTo(pG4) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pD1) ;  line:LineTo(pD7) ;
       group:AddTail(line)
     end
     if letter == 44 then
       line:AppendPoint(pC0) ;  line:LineTo(pE2) ;  line:LineTo(pC2) ;  line:LineTo(pC4) ;  line:LineTo(pF4) ;  line:LineTo(pF2) ;
       line:LineTo(pD0) ;  line:LineTo(pC0) ;  group:AddTail(line) ;
     end
     if letter == 45 then
       line:AppendPoint(pA4) ;  line:LineTo(pG4) ;  group:AddTail(line) ;
     end
     if letter == 46 then
       line:AppendPoint(pA1) ;  line:LineTo(pB1) ;  line:LineTo(pB0) ;  line:LineTo(pA0) ;  line:LineTo(pA1) ;  group:AddTail(line) ;  pH0 = pD0 ;
     end
     if letter == 47 then
       line:AppendPoint(pA0) ;  line:LineTo(pF8) ;  group:AddTail(line) ;  pH0 = pG0 ;
     end
     if letter == 48 then
       line:AppendPoint(pB0) ;  line:LineTo(pA2) ;  line:LineTo(pA6) ;  line:LineTo(pB8) ;  line:LineTo(pF8) ;  line:LineTo(pG6) ;
       line:LineTo(pG2) ;  line:LineTo(pF0) ;  line:LineTo(pB0) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pG8) ;  line:LineTo(pA0) ; group:AddTail(line) ;
     end
     if letter == 49 then
       line:AppendPoint(pA6) ;  line:LineTo(pD8) ;  line:LineTo(pD0) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pA0) ;
       line:LineTo(pG0) ;  group:AddTail(line) ;
     end
     if letter == 50 then
       line:AppendPoint(pA6) ;  line:LineTo(pA7) ;  line:LineTo(pB8) ;  line:LineTo(pF8) ;  line:LineTo(pG7) ;  line:LineTo(pG5) ;
       line:LineTo(pA2) ;  line:LineTo(pA0) ;  line:LineTo(pG0) ;  group:AddTail(line) ;
     end
     if letter == 51 then
       line:AppendPoint(pA7) ;  line:LineTo(pB8) ;  line:LineTo(pF8) ;  line:LineTo(pG7) ;  line:LineTo(pG5) ;  line:LineTo(pF4) ;
       line:LineTo(pG3) ;  line:LineTo(pG1) ;  line:LineTo(pF0) ;  line:LineTo(pB0) ;  line:LineTo(pA1) ;  group:AddTail(line) ;  line = Contour(0.0) ;
       line:AppendPoint(pF4) ;  line:LineTo(pB4) ;  group:AddTail(line) ;
     end
     if letter == 52 then
       line:AppendPoint(pF0) ;  line:LineTo(pF8) ;  line:LineTo(pA2) ;  line:LineTo(pG2) ;  group:AddTail(line) ;
     end
     if letter == 53 then
       line:AppendPoint(pG8) ;  line:LineTo(pA8) ;  line:LineTo(pA5) ;  line:LineTo(pF4) ;  line:LineTo(pG3) ;  line:LineTo(pG1) ;
       line:LineTo(pF0) ;  line:LineTo(pB0) ;  line:LineTo(pA1) ;  line:LineTo(pA2) ;  group:AddTail(line) ;
     end
     if letter == 54 then
       line:AppendPoint(pG7) ;  line:LineTo(pF8) ;  line:LineTo(pB8) ;  line:LineTo(pA7) ;  line:LineTo(pA1) ;  line:LineTo(pB0) ;
       line:LineTo(pF0) ;  line:LineTo(pG1) ;  line:LineTo(pG3) ;  line:LineTo(pF4) ;  line:LineTo(pB4) ;  line:LineTo(pA2) ;  group:AddTail(line) ;
     end
     if letter == 55 then
       line:AppendPoint(pB0) ;  line:LineTo(pG8) ;  line:LineTo(pA8) ;  group:AddTail(line) ;
     end
     if letter == 56 then
       line:AppendPoint(pA1) ;  line:LineTo(pB0) ;  line:LineTo(pF0) ;  line:LineTo(pG1) ;  line:LineTo(pG3) ;  line:LineTo(pF4) ;
       line:LineTo(pG5) ;  line:LineTo(pG7) ;  line:LineTo(pF8) ;  line:LineTo(pB8) ;  line:LineTo(pA7) ;  line:LineTo(pA5) ;  line:LineTo(pB4) ;
       line:LineTo(pA3) ;  line:LineTo(pA1) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pB4) ;  line:LineTo(pF4) ;  group:AddTail(line) ;
     end
     if letter == 57 then
       line:AppendPoint(pA1) ;  line:LineTo(pB0) ;  line:LineTo(pF0) ;  line:LineTo(pG3) ;  line:LineTo(pG7) ;  line:LineTo(pF8) ;
       line:LineTo(pB8) ;  line:LineTo(pA7) ;  line:LineTo(pA5) ;  line:LineTo(pB4) ;  line:LineTo(pF4) ;  line:LineTo(pG5) ;  group:AddTail(line) ;
     end
     if letter == 58 then
       line:AppendPoint(pB8) ;  line:LineTo(pA8) ;  line:LineTo(pA7) ;  line:LineTo(pB7) ;  line:LineTo(pB8) ;  line:LineTo(pA8) ;
       group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pA1) ;  line:LineTo(pB1) ;  line:LineTo(pB0) ;  line:LineTo(pA0) ;  line:LineTo(pA1) ;
       group:AddTail(line) ;  pH0 = pD0 ;
     end
     if letter == 59 then
       line:AppendPoint(pB8) ;  line:LineTo(pA8) ;  line:LineTo(pA7) ;  line:LineTo(pB7) ;  line:LineTo(pB8) ;  line:LineTo(pA8) ;
       group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pB3) ;  line:LineTo(pB4) ;  line:LineTo(pA4) ;  line:LineTo(pA3) ;  line:LineTo(pB3) ;
       line:LineTo(pA0) ;  group:AddTail(line) ;  pH0 = pD0 ;
     end
     if letter == 60 then
       line:AppendPoint(pF8) ;  line:LineTo(pA4) ;  line:LineTo(pG0) ;  group:AddTail(line)
     end
     if letter == 61 then
       line:AppendPoint(pA2) ;  line:LineTo(pG2) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pA6) ;
       line:LineTo(pG6) ;  group:AddTail(line) ;
     end
     if letter == 62 then
       line:AppendPoint(pA8) ;  line:LineTo(pF4) ;  line:LineTo(pA0) ;  group:AddTail(line) ;
     end
     if letter == 63 then
       line:AppendPoint(pB5) ;  line:LineTo(pA6) ;  line:LineTo(pA7) ;  line:LineTo(pB8) ;  line:LineTo(pE8) ;  line:LineTo(pF7) ;
       line:LineTo(pF5) ;  line:LineTo(pC3) ;  line:LineTo(pC2) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pB0) ;  line:LineTo(pE0) ;
       line:LineTo(pE1) ;  line:LineTo(pB1) ;  line:LineTo(pB0) ;  group:AddTail(line) ;
     end
     if letter == 64 then
       line:AppendPoint(pG0) ;  line:LineTo(pB0) ;  line:LineTo(pA2) ;  line:LineTo(pA6) ;  line:LineTo(pB8) ;  line:LineTo(pF8) ;
       line:LineTo(pG6) ;  line:LineTo(pG3) ;  line:LineTo(pE2) ;  line:LineTo(pB2) ;  line:LineTo(pB5) ;  line:LineTo(pE5) ;  line:LineTo(pE2) ;
       group:AddTail(line)
     end
     if letter == 65 then
       line:AppendPoint(pA0) ;  line:LineTo(pD8) ;  line:LineTo(pG0) ;  line:LineTo(pF3) ;  line:LineTo(pB3) ;
       line:LineTo(pA0) ;  group:AddTail(line) ;
     end
     if letter == 66 then
       line:AppendPoint(pA4) ;  line:LineTo(pF4) ;  line:LineTo(pG5) ;  line:LineTo(pG7) ;  line:LineTo(pF8) ;  line:LineTo(pA8) ;
       line:LineTo(pA0) ;  line:LineTo(pF0) ;  line:LineTo(pG1) ;  line:LineTo(pG3) ;  line:LineTo(pF4) ;  group:AddTail(line) ;
     end
     if letter == 67 then
       line:AppendPoint(pG2) ;  line:LineTo(pF0) ;  line:LineTo(pB0) ;  line:LineTo(pA2) ;  line:LineTo(pA6) ;  line:LineTo(pB8) ;
       line:LineTo(pF8) ;  line:LineTo(pG6) ;  group:AddTail(line) ;
     end
     if letter == 68 then
       line:AppendPoint(pA0) ;  line:LineTo(pF0) ;  line:LineTo(pG2) ;  line:LineTo(pG6) ;  line:LineTo(pF8) ;  line:LineTo(pA8) ;
       line:LineTo(pA0) ;  group:AddTail(line) ;
     end
     if letter == 69 then
       line:AppendPoint(pG0) ;  line:LineTo(pA0) ;  line:LineTo(pA8) ;  line:LineTo(pF8) ;  group:AddTail(line) ;  line = Contour(0.0) ;
       line:AppendPoint(pA4) ;  line:LineTo(pD4) ;  group:AddTail(line) ;
     end
     if letter == 70 then
       line:AppendPoint(pA0) ;  line:LineTo(pA8) ;  line:LineTo(pG8) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pA4) ;
       line:LineTo(pF4) ;  group:AddTail(line) ;
     end
     if letter == 71 then
       line:AppendPoint(pG6) ;  line:LineTo(pG7) ;  line:LineTo(pF8) ;  line:LineTo(pB8) ;  line:LineTo(pA6) ;  line:LineTo(pA2) ;
       line:LineTo(pB0) ;  line:LineTo(pF0) ;  line:LineTo(pG2) ;  line:LineTo(pG3) ;  line:LineTo(pE3) ;  line:LineTo(pE2) ;  group:AddTail(line) ;
     end
     if letter == 72 then
       line:AppendPoint(pA0) ;  line:LineTo(pA8) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pG0) ;  line:LineTo(pG8) ;
       group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pA4) ;  line:LineTo(pG4) ;  group:AddTail(line) ;
     end
     if letter == 73 then
       line:AppendPoint(pB0) ;  line:LineTo(pB8) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pA0) ;  line:LineTo(pC0) ;
       group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pA8) ;  line:LineTo(pC8) ;  group:AddTail(line) ;  pH0 = pE0 ;
     end
     if letter == 74 then
       line:AppendPoint(pA2) ;  line:LineTo(pB0) ;  line:LineTo(pF0) ;  line:LineTo(pG2) ;  line:LineTo(pG8) ;  line:LineTo(pC8) ;
       group:AddTail(line) ;
     end
     if letter == 75 then
       line:AppendPoint(pA0) ;  line:LineTo(pA8) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pA2) ;  line:LineTo(pG7) ;
       group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pD4) ;  line:LineTo(pG0) ;  group:AddTail(line) ;
     end
     if letter == 76 then
       line:AppendPoint(pA8) ;  line:LineTo(pA0) ;  line:LineTo(pG0) ;  group:AddTail(line) ;
     end
     if letter == 77 then
       line:AppendPoint(pA0) ;  line:LineTo(pA8) ;  line:LineTo(pD4) ;  line:LineTo(pG8) ;  line:LineTo(pG0) ;  group:AddTail(line) ;
     end
     if letter == 78 then
       line:AppendPoint(pA0) ;  line:LineTo(pA8) ;  line:LineTo(pF0) ;  line:LineTo(pF8) ;  group:AddTail(line) ;  pH0 = pG0 ;
     end
     if letter == 79 then
       line:AppendPoint(pB0) ;  line:LineTo(pA2) ;  line:LineTo(pA6) ;  line:LineTo(pB8) ;  line:LineTo(pF8) ;  line:LineTo(pG6) ;
       line:LineTo(pG2) ;  line:LineTo(pF0) ;  line:LineTo(pB0) ;  group:AddTail(line) ;
     end
     if letter == 80 then
       line:AppendPoint(pA0) ;  line:LineTo(pA8) ;  line:LineTo(pF8) ;  line:LineTo(pG7) ;  line:LineTo(pG5) ;  line:LineTo(pF4) ;
       line:LineTo(pA4) ;  group:AddTail(line) ;
     end
     if letter == 81 then
       line:AppendPoint(pB0) ;  line:LineTo(pA2) ;  line:LineTo(pA6) ;  line:LineTo(pB8) ;  line:LineTo(pF8) ;  line:LineTo(pG6) ;
       line:LineTo(pG2) ;  line:LineTo(pF0) ;  line:LineTo(pB0) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pG0) ;  line:LineTo(pD4) ; group:AddTail(line)
     end
     if letter == 82 then
       line:AppendPoint(pA0) ;  line:LineTo(pA8) ;  line:LineTo(pF8) ;  line:LineTo(pG7) ;  line:LineTo(pG5) ;  line:LineTo(pF4) ;
       line:LineTo(pA4) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pD4) ;  line:LineTo(pG0) ;  group:AddTail(line) ;
     end
     if letter == 83 then
       line:AppendPoint(pG5) ;  line:LineTo(pG6) ;  line:LineTo(pF8) ;  line:LineTo(pB8) ;  line:LineTo(pA6) ;  line:LineTo(pA5) ;
       line:LineTo(pG3) ;  line:LineTo(pG2) ;  line:LineTo(pF0) ;  line:LineTo(pB0) ;  line:LineTo(pA2) ;  line:LineTo(pA3) ;  group:AddTail(line) ;
     end
     if letter == 84 then
       line:AppendPoint(pA8) ;  line:LineTo(pG8) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pD8) ;
       line:LineTo(pD0) ;  group:AddTail(line) ;
     end
     if letter == 85 then
       line:AppendPoint(pA8) ;  line:LineTo(pA2) ;  line:LineTo(pB0) ;  line:LineTo(pF0) ;  line:LineTo(pG2) ;  line:LineTo(pG8) ;
       group:AddTail(line) ;
     end
     if letter == 86 then
       line:AppendPoint(pA8) ;  line:LineTo(pD0) ;  line:LineTo(pG8) ;  group:AddTail(line) ;
     end
     if letter == 87 then
       line:AppendPoint(pA8) ;  line:LineTo(pB0) ;  line:LineTo(pD4) ;  line:LineTo(pF0) ;  line:LineTo(pG8) ;  group:AddTail(line) ;
     end
     if letter == 88 then
       line:AppendPoint(pA0) ;  line:LineTo(pG8) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pA8) ;
       line:LineTo(pG0) ;  group:AddTail(line) ;
     end
     if letter == 89 then
       line:AppendPoint(pA8) ;  line:LineTo(pD4) ;  line:LineTo(pG8) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pD0) ;
       line:LineTo(pD4) ;  group:AddTail(line) ;
     end
     if letter == 90 then
       line:AppendPoint(pA8) ;  line:LineTo(pG8) ;  line:LineTo(pA0) ;  line:LineTo(pG0) ;  group:AddTail(line) ;
     end
 
     if letter == 91 then
       line:AppendPoint(pC0) ;  line:LineTo(pB0) ;  line:LineTo(pB8) ;  line:LineTo(pC8) ;  group:AddTail(line) ;
     end
     if letter == 92 then
       line:AppendPoint(pA4) ;  line:LineTo(pG4) ;  group:AddTail(line) ;
     end
     if letter == 93 then
       line:AppendPoint(pE0) ;  line:LineTo(pF0) ;  line:LineTo(pF8) ;  line:LineTo(pE8) ;  group:AddTail(line) ;
     end
     if letter == 94 then
       line:AppendPoint(pD8) ;  line:LineTo(pG6) ;  line:LineTo(pG5) ;  line:LineTo(pD7) ;  line:LineTo(pA5) ;  line:LineTo(pA6) ;
       line:LineTo(pD8) ;  group:AddTail(line) ;
     end
     if letter == 95 then
       line:AppendPoint(pA0) ;  line:LineTo(pF0) ;  group:AddTail(line) ;
     end
     if letter == 96 then
       line:AppendPoint(pA4) ;  line:LineTo(pG4) ;  group:AddTail(line) ;
     end
     -- Start of Lower Case
     if letter == 97 then
       line:AppendPoint(pA0) ;  line:LineTo(pD8) ;  line:LineTo(pG0) ;  line:LineTo(pF3) ;  line:LineTo(pB3) ;
       line:LineTo(pA0) ;  group:AddTail(line) ;
     end
     if letter == 98 then
       line:AppendPoint(pA4) ;  line:LineTo(pF4) ;  line:LineTo(pG5) ;  line:LineTo(pG7) ;  line:LineTo(pF8) ;  line:LineTo(pA8) ;
       line:LineTo(pA0) ;  line:LineTo(pF0) ;  line:LineTo(pG1) ;  line:LineTo(pG3) ;  line:LineTo(pF4) ;  group:AddTail(line) ;
     end
     if letter == 99 then
       line:AppendPoint(pG2) ;  line:LineTo(pF0) ;  line:LineTo(pB0) ;  line:LineTo(pA2) ;  line:LineTo(pA6) ;  line:LineTo(pB8) ;
       line:LineTo(pF8) ;  line:LineTo(pG6) ;  group:AddTail(line) ;
     end
     if letter == 100 then
       line:AppendPoint(pA0) ;  line:LineTo(pF0) ;  line:LineTo(pG2) ;  line:LineTo(pG6) ;  line:LineTo(pF8) ;  line:LineTo(pA8) ;
       line:LineTo(pA0) ;  group:AddTail(line) ;
     end
     if letter == 101 then
       line:AppendPoint(pG0) ;  line:LineTo(pA0) ;  line:LineTo(pA8) ;  line:LineTo(pF8) ;  group:AddTail(line) ;  line = Contour(0.0) ;
       line:AppendPoint(pA4) ;  line:LineTo(pD4) ;  group:AddTail(line) ;
     end
     if letter == 102 then
       line:AppendPoint(pA0) ;  line:LineTo(pA8) ;  line:LineTo(pG8) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pA4) ;
       line:LineTo(pF4) ;  group:AddTail(line) ;
     end
     if letter == 103 then
       line:AppendPoint(pG6) ;  line:LineTo(pG7) ;  line:LineTo(pF8) ;  line:LineTo(pB8) ;  line:LineTo(pA6) ;  line:LineTo(pA2) ;
       line:LineTo(pB0) ;  line:LineTo(pF0) ;  line:LineTo(pG2) ;  line:LineTo(pG3) ;  line:LineTo(pE3) ;  line:LineTo(pE2) ;  group:AddTail(line) ;
     end
     if letter == 104 then
       line:AppendPoint(pA0) ;  line:LineTo(pA8) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pG0) ;  line:LineTo(pG8) ;
       group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pA4) ;  line:LineTo(pG4) ;  group:AddTail(line) ;
     end
     if letter == 105 then
       line:AppendPoint(pB0) ;  line:LineTo(pB8) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pA0) ;  line:LineTo(pC0) ;
       group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pA8) ;  line:LineTo(pC8) ;  group:AddTail(line) ;  pH0 = pE0 ;
     end
     if letter == 106 then
       line:AppendPoint(pA2) ;  line:LineTo(pB0) ;  line:LineTo(pF0) ;  line:LineTo(pG2) ;  line:LineTo(pG8) ;  line:LineTo(pC8) ;
       group:AddTail(line) ;
     end
     if letter == 107 then
       line:AppendPoint(pA0) ;  line:LineTo(pA8) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pA2) ;  line:LineTo(pG7) ;
       group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pD4) ;  line:LineTo(pG0) ;  group:AddTail(line) ;
     end
     if letter == 108 then
       line:AppendPoint(pA8) ;  line:LineTo(pA0) ;  line:LineTo(pG0) ;  group:AddTail(line) ;
     end
     if letter == 109 then
       line:AppendPoint(pA0) ;  line:LineTo(pA8) ;  line:LineTo(pD4) ;  line:LineTo(pG8) ;  line:LineTo(pG0) ;  group:AddTail(line) ;
     end
     if letter == 110 then
       line:AppendPoint(pA0) ;  line:LineTo(pA8) ;  line:LineTo(pF0) ;  line:LineTo(pF8) ;  group:AddTail(line) ;  pH0 = pG0 ;
     end
     if letter == 111 then
       line:AppendPoint(pB0) ;  line:LineTo(pA2) ;  line:LineTo(pA6) ;  line:LineTo(pB8) ;  line:LineTo(pF8) ;  line:LineTo(pG6) ;
       line:LineTo(pG2) ;  line:LineTo(pF0) ;  line:LineTo(pB0) ;  group:AddTail(line) ;
     end
     if letter == 112 then
       line:AppendPoint(pA0) ;  line:LineTo(pA8) ;  line:LineTo(pF8) ;  line:LineTo(pG7) ;  line:LineTo(pG5) ;  line:LineTo(pF4) ;
       line:LineTo(pA4) ;  group:AddTail(line) ;
     end
     if letter == 113 then
       line:AppendPoint(pB0) ;  line:LineTo(pA2) ;  line:LineTo(pA6) ;  line:LineTo(pB8) ;  line:LineTo(pF8) ;  line:LineTo(pG6) ;
       line:LineTo(pG2) ;  line:LineTo(pF0) ;  line:LineTo(pB0) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pG0) ;  line:LineTo(pD4) ; group:AddTail(line)
     end
     if letter == 114 then
       line:AppendPoint(pA0) ;  line:LineTo(pA8) ;  line:LineTo(pF8) ;  line:LineTo(pG7) ;  line:LineTo(pG5) ;  line:LineTo(pF4) ;
       line:LineTo(pA4) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pD4) ;  line:LineTo(pG0) ;  group:AddTail(line) ;
     end
     if letter == 115 then
       line:AppendPoint(pG5) ;  line:LineTo(pG6) ;  line:LineTo(pF8) ;  line:LineTo(pB8) ;  line:LineTo(pA6) ;  line:LineTo(pA5) ;
       line:LineTo(pG3) ;  line:LineTo(pG2) ;  line:LineTo(pF0) ;  line:LineTo(pB0) ;  line:LineTo(pA2) ;  line:LineTo(pA3) ;  group:AddTail(line) ;
     end
     if letter == 116 then
       line:AppendPoint(pA8) ;  line:LineTo(pG8) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pD8) ;
       line:LineTo(pD0) ;  group:AddTail(line) ;
     end
     if letter == 117 then
       line:AppendPoint(pA8) ;  line:LineTo(pA2) ;  line:LineTo(pB0) ;  line:LineTo(pF0) ;  line:LineTo(pG2) ;  line:LineTo(pG8) ;
       group:AddTail(line) ;
     end
     if letter == 118 then
       line:AppendPoint(pA8) ;  line:LineTo(pD0) ;  line:LineTo(pG8) ;  group:AddTail(line) ;
     end
     if letter == 119 then
       line:AppendPoint(pA8) ;  line:LineTo(pB0) ;  line:LineTo(pD4) ;  line:LineTo(pF0) ;  line:LineTo(pG8) ;  group:AddTail(line) ;
     end
     if letter == 120 then
       line:AppendPoint(pA0) ;  line:LineTo(pG8) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pA8) ;
       line:LineTo(pG0) ;  group:AddTail(line) ;
     end
     if letter == 121 then
       line:AppendPoint(pA8) ;  line:LineTo(pD4) ;  line:LineTo(pG8) ;  group:AddTail(line) ;  line = Contour(0.0) ;  line:AppendPoint(pD0) ;
       line:LineTo(pD4) ;  group:AddTail(line) ;
     end
     if letter == 122 then
       line:AppendPoint(pA8) ;  line:LineTo(pG8) ;  line:LineTo(pA0) ;  line:LineTo(pG0) ;  group:AddTail(line) ;
     end
     -- End of Lower Case
     if letter == 123 then
       line:AppendPoint(pD0) ;  line:LineTo(pC0) ;  line:LineTo(pB1) ;  line:LineTo(pB2) ;  line:LineTo(pC3) ;  line:LineTo(pA4) ;
       line:LineTo(pC5) ;  line:LineTo(pB6) ;  line:LineTo(pB7) ;  line:LineTo(pC8) ;  line:LineTo(pD8) ;  group:AddTail(line) ;
     end
     if letter == 124 then
       line:AppendPoint(pA0) ;  line:LineTo(pA10) ;  line:LineTo(pC10) ;  line:LineTo(pC0) ;  line:LineTo(pA0) ;  group:AddTail(line) ;
     end
     if letter == 125 then
       line:AppendPoint(pD0) ;  line:LineTo(pE0) ;  line:LineTo(pF1) ;  line:LineTo(pF2) ;  line:LineTo(pE3) ;  line:LineTo(pG4) ;
       line:LineTo(pE5) ;  line:LineTo(pF6) ;  line:LineTo(pF7) ;  line:LineTo(pE8) ;  line:LineTo(pD8) ;  group:AddTail(line) ;
     end
     if letter == 126 then
       line:AppendPoint(pA2) ;  line:LineTo(pA3) ;  line:LineTo(pB5) ;  line:LineTo(pF3) ;  line:LineTo(pG5) ;
       line:LineTo(pG4) ;  line:LineTo(pF2) ;  line:LineTo(pB4) ;  line:LineTo(pA2) ;  group:AddTail(line) ;
     end
     return pH0
   end -- function end
 
   -- =========================================================================
   local function AddGroupToJob(job, group, layer_name)
      --  create a CadObject to represent the  group
     local cad_object = CreateCadGroup(group);
      -- create a layer with passed name if it doesnt already exist
     local layer = job.LayerManager:GetLayerWithName(layer_name)
      -- and add our object to it
     layer:AddObject(cad_object, true)
     return cad_object
   end -- end function
 
   -- =========================================================================
     local job = VectricJob()
     if not job.Exists then
       DisplayMessageBox("Error: Not finding a job loaded")
       return false
     end
     local strlen = string.len(what)
     local strup = what
     local x = strlen
     local i = 1
     local y = ""
     local ptx = where
     group = ContourGroup(true)
     while i <=  x do
       y = string.byte(string.sub(strup, i, i))
       if (y >= 97) and (y <= 122) then -- Lower case
         ptx = MonoFont(job, ptx, y, (size * 0.75), lay, ang)
         ptx = Polar2D(ptx, ang, size * 0.05)
       else -- Upper case
         ptx = MonoFont(job, ptx, y, size, lay, ang)
         ptx = Polar2D(ptx, ang, size * 0.07)
       end
       i = i + 1
     end -- while end;
     AddGroupToJob(job, group, lay)
     job:Refresh2DView()
     return true
 end -- function end

Holer - Draws two Holes and groups them

TopOfPage.png

Draws circles based on a layout.

function Holer(pt, ang, dst, dia, lay)
       local job = VectricJob()
       if not job.Exists then
         DisplayMessageBox("Error: No job loaded")
         return false
       end
     --Caller: Holer(ptx, anx, BaseDim.HoleSpace, Milling.ShelfPinRadius, Milling.LNSideShelfPinDrill .. "-Base")
       local function AddGroupToJob(job, group, layer_name)
         local cad_object = CreateCadGroup(group);
         local layer = job.LayerManager:GetLayerWithName(layer_name)
         layer:AddObject(cad_object, true)
         return cad_object
       end
     local group = ContourGroup(true)
     group:AddTail(CreateCircle(pt.x, pt.y, dia, 0.0, 0.0))
     pt = Polar2D(pt, ang, dst)
     group:AddTail(CreateCircle(pt.x, pt.y, dia, 0.0, 0.0))
     AddGroupToJob(job, group, lay)
     return true
 end -- function end

Data Export Tools

Back.jpg

This object is a name-value pair that represents a Document Variable within a VectricJob.

LogWriter

TopOfPage.png

Writes a Log items to the log file.

 function LogWriter(LogName, xText)
  -- Adds a new xText Line to a app log file
  -- local LogName = Door.CSVPath .. "\\" .. Door.RuntimeLog .. ".txt"
  local fileW = io.open(LogName,  "a")
  if fileW then
    fileW:write(xText .. "\n")
    fileW:close()
  end -- if end
  Maindialog:UpdateLabelField("Door.Alert", "Note: Errors are logged in the CSF file folder.")
  return true
end -- function end  

Write_CSV

TopOfPage.png

Writes the values to a csv format file.

 function Write_CSV(xFilename) -- Writes the values to a csv format file
 -- Usage: Write_CSV("C:\\Path\\MyName.csv")
 -- Door.CSVPath = dialog:GetTextField("DoorCSVPath")
 -- local filename = Path .. "\\" .. Name .. ".csv"
  local filename = xFilename
  local file = io.open(filename, "w")
  if file then  -- if the file was opened
    file:write("Count,Height,Width\n")  -- Header Line
    if Door.Unit then
      file:write("1,110,595\n");    file:write("1,150,75\n");     file:write("1,175,395\n");     file:write("1,140,495\n")
      file:write("1,175,445\n");    file:write("1,175,595\n");    file:write("2,200,100\n");     file:write("3,250,125\n")
      file:write("1,300,150\n");    file:write("2,350,175\n");    file:write("3,400,200\n");     file:write("1,450,225\n")
      file:write("2,500,250\n");    file:write("3,550,275\n");    file:write("1,600,300\n");     file:write("2,650,325\n")
      file:write("3,700,350\n");    file:write("1,750,375\n");    file:write("2,800,400\n");     file:write("3,850,425\n");
      file:write("1,900,450\n");    file:write("2,950,475\n");    file:write("3,1000,500\n");    file:write("1,1050,525\n");
      file:write("2,1100,550\n");   file:write("3,1150,575\n");   file:write("1,1200,600\n");    file:write("2,1250,625\n");
      file:write("3,1300,650\n");   file:write("1,1350,675\n");   file:write("2,1400,700\n");    file:write("3,1450,725\n");
      file:write("1,1500,750\n");   file:write("2,1550,775\n");   file:write("3,1600,800\n");    file:write("1,1650,825\n");
      file:write("2,1700,850\n");   file:write("3,1750,875\n");   file:write("1,1800,900\n");    file:write("2,1850,925\n");
      file:write("3,1900,950\n");   file:write("1,1950,975\n");   file:write("2,2000,1000\n");   file:write("3,2050,1025\n");
      file:write("1,2100,1050\n");  file:write("2,2150,1075\n");  file:write("3,2200,1100\n");   file:write("1,2250,1125\n");
      file:write("2,2300,1150\n");  file:write("3,2350,1175\n");  file:write("1,2400,1200\n");   file:write("2,2450,1225\n")
    else
      file:write("1,04.5000,23.2500\n");  file:write("1,06.0000,03.3125\n");  file:write("1,06.5000,15.5000\n");  file:write("1,05.3750,19.5000\n");
      file:write("1,07.1875,17.5000\n");  file:write("1,06.1875,23.5000\n");  file:write("2,07.8750,03.8750\n");  file:write("3,09.8750,05.0000\n");
      file:write("1,11.7500,05.8750\n");  file:write("2,13.7500,06.6750\n");  file:write("3,15.7500,07.8750\n");  file:write("1,17.1250,08.8250\n");
      file:write("2,19.5000,09.5000\n");  file:write("3,21.1250,10.3750\n");  file:write("1,23.6250,11.1250\n");  file:write("2,25.5000,12.1250\n");
      file:write("3,27.6250,13.7500\n");  file:write("1,29.5000,14.7500\n");  file:write("2,31.4375,15.7500\n");  file:write("3,33.4375,16.7500\n");
      file:write("1,35.4375,17.7500\n");  file:write("2,37.4375,18.6250\n");  file:write("3,39.3750,19.6250\n");  file:write("1,41.3750,20.6250\n");
      file:write("2,43.3750,21.6250\n");  file:write("3,45.1875,22.6250\n");  file:write("1,47.2500,23.6250\n");  file:write("2,49.1875,24.6250\n");
      file:write("3,51.1250,25.5000\n");  file:write("1,53.1250,26.5000\n");  file:write("2,55.1250,27.5000\n");  file:write("3,57.1250,28.5000\n");
      file:write("1,59.1250,29.5000\n");  file:write("2,61.2500,30.5000\n");  file:write("3,62.9375,31.4375\n");  file:write("1,64.9375,32.4375\n");
      file:write("2,66.9375,33.4375\n");  file:write("3,68.8125,34.4375\n");  file:write("1,70.8750,35.3750\n");  file:write("2,72.9375,36.4375\n");
      file:write("3,74.8750,37.4375\n");  file:write("1,76.9375,38.3750\n");  file:write("2,78.7500,39.3750\n");  file:write("3,80.7500,40.3750\n");
      file:write("1,82.6250,41.3750\n");  file:write("2,84.6250,42.3750\n");  file:write("3,86.6250,43.3750\n");  file:write("1,88.5000,44.2500\n");
      file:write("2,90.6250,45.2500\n");  file:write("3,92.6250,46.2500\n");  file:write("1,94.4375,47.2500\n");  file:write("2,95.4375,48.2500\n")
    end -- if end
    file:close() -- closes the open file
  end -- if end
  return  true
end -- function end 

Text File Tools

Back.jpg

This object is a name-value pair that represents a Document Variable within a VectricJob.

LengthOfFile

TopOfPage.png

Returns file line count

 function LengthOfFile(filename)
    Returns: number]]
    local len = 0
    if FileExists(filename) then
      local file = io.open(filename)
      if file then
      for _ in file:lines() do
        len = len + 1
      end
      file:close()
    end -- if end
    end
    return len
end -- function end 

NameValidater - Checks File Name for Valid Chars

TopOfPage.png

Returns file line count

 function NameValidater(FileName)
    local MyTrue = true
    local strlen = string.len(FileName)
    local strup = string.upper(FileName)
    local i = 1
    local y = ""
    while i <=  strlen do
      y = string.byte(string.sub(strup, i, i))
      if y == 32 then   --  Space
        MyTrue = false
        break
      elseif y == 45 then  -- Dash
        MyTrue = false
        break
      elseif y == 127 then  -- Delete
        MyTrue = false
        break
      elseif y == 126 then  -- Delete
        MyTrue = false
        break

       elseif y == 123 then  -- Open brace
        MyTrue = false
        break
      elseif y == 124 then  -- Pipe
        MyTrue = false
        break
      elseif y == 125 then  -- Close brace
        MyTrue = false
        break

      elseif  -- Illegal Filename Characters
      (y == 33) or -- !	Exclamation mark
      (y == 34) or -- "	Double Quotes
      (y == 35) or -- #	Hash
      (y == 36) or -- $	Dollar
      (y == 37) or -- %	Percent
      (y == 38) or -- &	Ampersand
      (y == 39) or -- '	Apostrophe
      (y == 42) or -- *	Asterisk
      (y == 43) or -- +	Plus
      (y == 44) or -- ,	Comma
      (y == 47) or -- /	Slash
      (y == 58) or -- :	Colon
      (y == 59) or -- ;	Semi-colon
      (y == 60) or -- <	Less than
      (y == 62) or -- >	Greater than
      (y == 63) or -- ?	Question mark
      (y == 64) or -- @	At
      (y == 92) or -- \	Backslash
      (y == 96) or -- `	Single Quotes
      (y == 123) or -- { Open brace
      (y == 124) or -- | Pipe
      (y == 125)    -- } Close brace
      then
        MyTrue = false
        break
      elseif (y <= 31) then -- Control Codes
        MyTrue = false
        break
      elseif (y >= 48) and (y <= 57) then -- Numbers
        MyTrue = false
        break
      elseif (y >= 65) and (y <= 90) then -- Uppercase A to Z
        MyTrue = false
        break
      elseif (y >= 97) and (y <= 122) then -- Lowercase A to Z
        MyTrue = false
        break
      elseif (y >= 65) and (y <= 90) then -- Uppercase A to Z
        MyTrue = false
        break
      end -- if end
      i = i + 1  end -- while end;
    return MyTrue
end -- function end 

CopyFileFromTo

TopOfPage.png

Copy Old File to Newfile

 function CopyFileFromTo(OldFile, NewFile)
    if FileExists(NewFile) then
      DisplayMessageBox("File copy " .. File .. " failed. \n\nFile found at: " .. NewFile  .. "\n" )
      return false
    elseif not FileExists(OldFile) then
      DisplayMessageBox("File copy of " .. File .. " failed. \n\nFile not found at: " .. OldFile .. "\n" )
      return false
    else
      local fileR = io.open(OldFile)      -- reader file
      local fileW = io.open(NewFile, "w") -- writer file
      if fileR and fileW then  -- if both files are open
        for Line in fileR:lines() do
          fileW:write(Line .. "\n")
        end -- for end
      end
      if fileR then fileR:close() end
      if fileW then fileW:close() end
      return true
    end -- for end
end -- function end 

ValidateName

TopOfPage.png

Returns True if the file name is safe to use

 function ValidateName(FileName) 
  local MyTrue = true
  local strlen = string.len(FileName)
  local strup = string.upper(FileName)
  local i = 1
  local y = ""
  while i <=  strlen do
    y = string.byte(string.sub(strup, i, i))
    if y == 32 then -- Space
      MyTrue = true
    elseif y == 45 then -- hyphn
      MyTrue = true
    elseif (y >= 48) and (y <= 57) then -- numbers
      MyTrue = true
    elseif (y >= 65) and (y <= 90) then -- Uppercase
      MyTrue = true
    else
      MyTrue = false
      break
    end -- if end
    i = i + 1
  end -- while end
  return MyTrue
  end -- function end 

FileExists

TopOfPage.png

Returns True if file is found

 function FileExists(name)  
  -- call = ans = FileExists("sample.txt")
    local f=io.open(name,"r")
    if f~=nil then io.close(f) return true else io.close(f) return false end
  end -- function end 

FileAccess

TopOfPage.png

Returns true if file is available for update.

 function FileAccess(FileName) 
    if (not(os.rename(FileName, FileName))) then
      StatusMessage("Error", FileName, "The Gadget cannot access the ".. FileName ..
        " The OS has blocked write access. " ..
        "Verify the full path is correct and No application has the file open. ", "(1405)")
        return false
  else
    return true
  end -- if end
end -- function end 

IsDir

TopOfPage.png

Returns true if path is found

 function IsDir(path)                                  -- 
  local function exists(file)
    local ok, err, code = os.rename(file, file)
    if not ok then
      if code == 13 then
        return true
      end
    end
    return ok, err
  end
  return exists(path.."/")
end -- function end 

Sheetlabel

TopOfPage.png

Returns file line count of a txt (assic) file

 function Sheetlabel(Wpt, xTextHeight,  xThickness, xType, YY) -- Constructs sheet label
  local pt1Text = Point2D()
  local Pang    = 0.0
  local Tang    = 0.0
  if YY then
    pt1Text = Polar2D(Polar2D(Wpt, 90.0,  YY), 90.0,  6.0 * JimAndi.Cal)
    Pang = 270.0
    Tang = 0.0
  else
    if Material.Orientation == "V" then
      pt1Text = Polar2D(Wpt, 90.0, Milling.MaterialBlockWidth + (4.0 * JimAndi.Cal))
    else
      pt1Text = Polar2D(Wpt, 90.0,  Milling.MaterialBlockHeight + (4.0 * JimAndi.Cal))
    end
    Pang = 270.0
    Tang = 0.0
  end
  DrawWriter(Project.ProgramName, pt1Text, Milling.TextHeight * 3.0, JimAndi.LNDrawNotes, Tang)
  pt1Text = Polar2D(pt1Text, Pang, Milling.TextHeight * 3.35)
  DrawWriter("Cabinet ID: " .. Project.DrawerID, pt1Text, JimAndi.TextHeight * 2.0, JimAndi.LNDrawNotes, Tang)
  pt1Text = Polar2D(pt1Text, Pang, Milling.TextHeight * 2.75)
  DrawWriter("Cabinet Name: " .. Project.CabinetName, pt1Text, JimAndi.TextHeight * 2.0, JimAndi.LNDrawNotes, Tang)
  pt1Text = Polar2D(pt1Text, Pang, Milling.TextHeight * 2.75)
  if xThickness then
    DrawWriter("Material: " .. xThickness .. " " .. xType, pt1Text, JimAndi.TextHeight * 2.0, JimAndi.LNDrawNotes, Tang)
  end -- if end
end -- function end 

DiskRights

TopOfPage.png

Returns true if you have write access to path.

 function DiskRights(path)                             -- 
  local xx = io.open(path, "w")
  if xx == nil then
      io.close()
      return false
  else
      xx:close()
      return true
  end
end -- function end 

Geometry Tools

Back.jpg

This object is a name-value pair that represents a Document Variable within a VectricJob.

SheetNew

TopOfPage.png

Adds a new sheet to the drawing

 function SheetNew()                                     -- Adds a new sheet to the drawing
  if GetVersion() >= 10.5 then then
    local layer_manager = Milling.job.LayerManager
    -- get current sheet count - note sheet 0 the default sheet counts as one sheet
    local orig_num_sheets = layer_manager.NumberOfSheets
    -- get current active sheet index
    local orig_active_sheet_index = layer_manager.ActiveSheetIndex
    -- set active sheet to last sheet
    local num_sheets = layer_manager.NumberOfSheets
    layer_manager.ActiveSheetIndex = num_sheets - 1
    -- Add a new sheet
    layer_manager:AddNewSheet()
    -- set active sheet to last sheet we just added
    num_sheets = layer_manager.NumberOfSheets
    layer_manager.ActiveSheetIndex = num_sheets - 1
    Milling.job:Refresh2DView()
  end -- if end
  return true
end   

GetDiameterAndCentre

TopOfPage.png
function GetDiameterAndCentre(cadcontour, point2d)
  local contour = cadcontour:GetContour()
  local arc = contour:GetFirstSpan()
  local point3d = Point3D();
  arc = CastSpanToArcSpan(arc)
  local diameter = arc:RadiusAndCentre(point3d) * 2.0
  point2d = Point2D(point3d.x, point3d.y)
  -- MessageBox("Diameter = " .. diameter)
  return diameter, point2d
end

IsCircle

TopOfPage.png
function IsCircle(cadcontour)                           -- Returns True if conture is a circle
  local contour = cadcontour:GetContour()
  -- Does it consist only of arcs?
  if contour.ContainsBeziers then
    return false
  end
  if not contour.ContainsArcs then
    return false
  end
  -- Does is contain 4 contours?
  if contour.Count ~= 4 then
    return false
  end
  -- Check the arcs end and initial points make a square.
  local arcs = {}
  local count = 1;
  local pos = contour:GetHeadPosition()
  local object
  while pos ~= nil do
    object, pos = contour:GetNext(pos)
    arcs[count] = object
    count = count + 1
  end
  local x_1 =(arcs[1]).StartPoint2D.x
  local y_1 =(arcs[1]).StartPoint2D.y
  local x_3 =(arcs[3]).StartPoint2D.x
  local y_3 =(arcs[3]).StartPoint2D.y
  local x_2 =(arcs[2]).StartPoint2D.x
  local y_2 =(arcs[2]).StartPoint2D.y
  local x_4 =(arcs[4]).StartPoint2D.x
  local y_4 =(arcs[4]).StartPoint2D.y
  local horizontal_distance = (x_1 - x_3)*(x_1 - x_3) + (y_1 - y_3)*(y_1 - y_3)
  local vertical_distance = (x_4 - x_2)*(x_4 - x_2) + (y_2 - y_4)*(y_2 - y_4)
  if math.abs(horizontal_distance - vertical_distance) > 0.04 then
    return false
  end
  -- Check the bulge factor is 90
  local bulge = 0;
  for _, arc_span in ipairs(arcs) do
    bulge = CastSpanToArcSpan(arc_span).Bulge;
    if math.abs(math.abs(bulge)  - g_bulge90) > 0.04 then
      return false
    end
  end
  return true
end

SheetSet

TopOfPage.png
function SheetSet(Name)                    -- Move focus to a named sheet
  local job = VectricJob()
  local sheet_manager = job.SheetManager
  local sheet_ids = sheet_manager:GetSheetIds()
  for id in sheet_ids do
    if(sheet_manager:GetSheetName(id) == Name) then
    sheet_manager.ActiveSheetId = id
    end
  end
end

SheetNextSize

TopOfPage.png
function SheetNextSize(X, Y)               -- Make New Sheet to size (x, y)
  if X == nil then
    X = Milling.MaterialBlockWidth
  else
    X = X + (2 * Milling.Cal)
  end
  if Y == nil then
    Y = Milling.MaterialBlockHeight
  else
    Y = Y + (2 * Milling.Cal)
  end
  Milling.Sheet = Milling.Sheet + 1
  local sheet_manager = Milling.job.SheetManager
  local sheet_ids = sheet_manager:GetSheetIds()
  for id in sheet_ids do
    if(sheet_manager:GetSheetName(id) == "Sheet 1") then
     sheet_manager:CreateSheets(1, id, Box2D(Point2D(0, 0), Point2D(X, Y)))
    end
  end
  SheetSet("Sheet " .. tostring(Milling.Sheet))
  return true
end

GetPolarAngle

TopOfPage.png
function GetPolarAngle(Start, Corner, End)           -- Returns the Polar Angle
  local function GetPolarDirection(point1, point2)   
    local ang = math.abs(math.deg(math.atan((point2.Y - point1.Y) / (point2.X - point1.X))))
    if point1.X < point2.X then
      if point1.Y < point2.Y then
        ang = ang + 0.0
      else
        ang = 360.0 - ang
      end -- if end
    else
      if point1.Y < point2.Y then
        ang = 180.0 - ang
      else
        ang = ang + 180.0
      end -- if end
    end -- if end
    if ang >=360 then
      ang = ang -360.0
    end -- if end
    return ang
  end -- function end
  return  math.abs(GetPolarDirection(Corner, Start) - GetPolarDirection(Corner, End))
end -- function end

GetOrientation

TopOfPage.png
function GetOrientation(point1, point2)                 -- Orientation of left, right, up or down
  if DecimalPlaces(point1.X,8) == DecimalPlaces(point2.X,8) then
    if point1.Y < point2.Y then
      return 90.0
    else
      return 270.0
    end
  elseif DecimalPlaces(point1.Y,8) == DecimalPlaces(point2.Y,8) then
    if point1.X < point2.X then
      return 0.0
    else
      return 180.0
    end
  else
    return nil
  end
end -- function end

GetPolarDirection

TopOfPage.png
function GetPolarDirection(point1, point2)              -- Retuens and amgle from two points
  local ang = math.abs(math.deg(math.atan((point2.Y - point1.Y) / (point2.X - point1.X))))
  if point1.X < point2.X then
    if point1.Y < point2.Y then
      ang = ang + 0.0
    else
      ang = 360.0 - ang
    end -- if end
  else
    if point1.Y < point2.Y then
      ang = 180.0 - ang
    else
      ang = ang + 180.0
    end -- if end
  end -- if end
  if ang >=360 then
    ang = ang -360.0
  end -- if end
  return ang
end -- function end

CenterArc

TopOfPage.png
function CenterArc(A, B, RadiusD)                       -- Returns 2DPoint from Arc point and Radius
  local radius = ((tonumber(RadiusD) or 0) * g_var.scl)
  local horda = (A - B).Length
  if math.abs(radius) < (horda / 2) and radius ~= 0 then
--D("Too small radius " .. radius .. "\nreplaced by the smallest possible " .. (horda / 2))
    radius = (horda / 2)
  end
  return Point2D(((A.x + B.x) / 2 + (B.y - A.y) * math.sqrt(math.abs(radius) ^ 2 - (horda / 2) ^ 2) / horda), ((A.y + B.y) / 2 + (A.x - B.x) * math.sqrt(math.abs(radius) ^ 2 - (horda / 2) ^ 2) / horda))
end -- function end

Polar2D

TopOfPage.png

The Polar2D function will calculate a new point in space based on a Point of reference, Angle of direction, and Projected distance. Returns 2DPoint from Known Point, Angle direction, and Projected distance.

function Polar2D(pt, ang, dis)                        
-- The Polar2D function will calculate a new point in space based on a Point of reference, Angle of direction, and Projected distance.
-- ::''Returns a 2Dpoint(x, y)''
  return Point2D((pt.X + dis * math.cos(math.rad(ang))), (pt.Y + dis * math.sin(math.rad(ang))))
end -- End Function

GetDistance

TopOfPage.png

Returns Double from two Points

 function GetDistance(objA, objB)                        -- Returns Double from two Points
  local xDist = objB.x - objA.x
  local yDist = objB.y - objA.y
  return math.sqrt((xDist ^ 2) + (yDist ^ 2))
end -- function end

GetAngle

TopOfPage.png
  -- ===========================================================]]
  function GetAngle(point1, point2)
 local ang = math.abs(math.deg(math.atan((point2.Y - point1.Y) / (point2.X - point1.X))))
 if point1.X < point2.X then
   if point1.Y < point2.Y then
     ang = ang + 0.0
   else
     ang = 360.0 - ang
   end -- if end
 else
   if point1.Y < point2.Y then
     ang = 180.0 - ang
   else
     ang = ang + 180.0
   end -- if end
 end -- if end
 if ang >=360.0 then
   ang = ang -360.0
 end -- if end
 return ang

end -- function end</nowiki>


Arc2Bulge

TopOfPage.png
  -- ===========================================================]]
  function Arc2Bulge(p1, p2, Rad)                         -- Returns the Bulge factor for an arc
 local chord = math.sqrt(((p2.x - p1.x) ^ 2) + ((p2.y - p1.y) ^ 2))
 local seg = (Rad - (0.5 * (math.sqrt((4.0 * Rad^2) - chord^2))))
 local bulge = (2 * seg) / chord
 return bulge

end -- function end</nowiki>


TrigIt

Calculates Right Angle

TopOfPage.png
function TrigIt()                                       -- Calculates Right Angle
-- ==Trig Function==
-- VECTRIC LUA SCRIPT
-- =====================================================]]
-- Gadgets are an entirely optional add-in to Vectric's core software products.
-- They are provided 'as-is', without any express or implied warranty, and you
--   make use of them entirely at your own risk.
-- In no event will the author(s) or Vectric Ltd. be held liable for any damages
--   arising from their use.
-- Permission is granted to anyone to use this software for any purpose,
-- including commercial applications, and to alter it and redistribute it freely,
-- subject to the following restrictions:
-- 1. The origin of this software must not be misrepresented; you must not
--    claim that you wrote the original software.
-- 2. If you use this software in a product, an acknowledgement in the product
--    documentation would be appreciated but is not required.
-- 3. Altered source versions must be plainly marked as such, and must not be
--    misrepresented as being the original software.
-- 4. This notice may not be removed or altered from any source distribution.
--
-- Right Triangle TrigFunction is written by Jim Anderson of Houston Texas 2020
-- =====================================================]]
-- Code Debugger
-- require("mobdebug").start()
-- =====================================================]]
-- Global Variables --
    Trig = {}
-- =====================================================]]
  function TrigTest() -- Test the All Right Angle
    TrigClear()
    Trig.A  =  0.0
    Trig.B  =  0.0
    Trig.C  = 90.0
    Trig.Opp =  3.0  -- Rise  or (B2C)
    Trig.Adj =  4.0  -- Base  or (A2C)
    Trig.Hyp =  0.0  -- Slope or (A2B)
    Trig.Slope =  0.0
    Trig.Area =  0.0
    Trig.OutRadius =  0.0
    Trig.InRadius =  0.0
    Trig.Parameter =  0.0
    TrigIt()
    DisplayMessageBox("Test 1: \n" ..
    " Trig.A  =  " .. tostring(Trig.A) .. " \n" ..
    " Trig.B  =  " .. tostring(Trig.B) .. " \n" ..
    " Trig.C  =  " .. tostring(Trig.C) .. " \n" ..
    " Trig.Opp = * " .. tostring(Trig.Opp) .. " \n" ..
    " Trig.Adj = * " .. tostring(Trig.Adj) .. " \n" ..
    " Trig.Hyp =  " .. tostring(Trig.Hyp) .. " \n" ..
    " Trig.Slope =  " .. tostring(Trig.Slope) .. " \n" ..
    " Trig.Area =  " .. tostring(Trig.Area) .. " \n" ..
    " Trig.Parameter =  " .. tostring(Trig.Parameter) .. " \n" ..
    " Trig.OutRadius =  " .. tostring(Trig.OutRadius) .. " \n" ..
    " Trig.InRadius =  " .. tostring(Trig.InRadius) .. " \n"
    )
    -- =====================================================]]
    TrigClear()
    Trig.A  =  0.0
    Trig.B  =  0.0
    Trig.C  = 90.0
    Trig.Opp =  0.0  -- Rise  or (B2C)
    Trig.Adj =  4.0  -- Base  or (A2C)
    Trig.Hyp =  5.0  -- Slope or (A2B)
    Trig.Slope =  0.0
    Trig.Area =  0.0
    Trig.OutRadius =  0.0
    Trig.InRadius =  0.0
    Trig.Parameter =  0.0
    TrigIt()
    DisplayMessageBox("Test 2: \n" ..
    " Trig.A  =  " .. tostring(Trig.A) .. " \n" ..
    " Trig.B  =  " .. tostring(Trig.B) .. " \n" ..
    " Trig.C  =  " .. tostring(Trig.C) .. " \n" ..
    " Trig.Opp = * " .. tostring(Trig.Opp) .. " \n" ..
    " Trig.Adj = * " .. tostring(Trig.Adj) .. " \n" ..
    " Trig.Hyp =  " .. tostring(Trig.Hyp) .. " \n" ..
    " Trig.Slope =  " .. tostring(Trig.Slope) .. " \n" ..
    " Trig.Area =  " .. tostring(Trig.Area) .. " \n" ..
    " Trig.Parameter =  " .. tostring(Trig.Parameter) .. " \n" ..
    " Trig.OutRadius =  " .. tostring(Trig.OutRadius) .. " \n" ..
    " Trig.InRadius =  " .. tostring(Trig.InRadius) .. " \n"
    )
    -- =====================================================]]
    TrigClear()
    Trig.A  =  0.0
    Trig.B  =  0.0
    Trig.C  = 90.0
    Trig.Opp =  3.0  -- Rise  or (B2C)
    Trig.Adj =  0.0  -- Base  or (A2C)
    Trig.Hyp =  5.0  -- Slope or (A2B)
    Trig.Slope =  0.0
    Trig.Area =  0.0
    Trig.OutRadius =  0.0
    Trig.InRadius =  0.0
    Trig.Parameter =  0.0
    TrigIt()
    DisplayMessageBox("Test 3: \n" ..
    " Trig.A  =  " .. tostring(Trig.A) .. " \n" ..
    " Trig.B  =  " .. tostring(Trig.B) .. " \n" ..
    " Trig.C  =  " .. tostring(Trig.C) .. " \n" ..
    " Trig.Opp = * " .. tostring(Trig.Opp) .. " \n" ..
    " Trig.Adj =  " .. tostring(Trig.Adj) .. " \n" ..
    " Trig.Hyp = * " .. tostring(Trig.Hyp) .. " \n" ..
    " Trig.Slope =  " .. tostring(Trig.Slope) .. " on 12 inch \n" ..
    " Trig.Area =  " .. tostring(Trig.Area) .. " \n" ..
    " Trig.Parameter =  " .. tostring(Trig.Parameter) .. " \n" ..
    " Trig.OutRadius =  " .. tostring(Trig.OutRadius) .. " \n" ..
    " Trig.InRadius =  " .. tostring(Trig.InRadius) .. " \n"
    )
    -- =====================================================]]
    TrigClear()
    Trig.A  =  36.86897645844
    Trig.B  =  0.0
    Trig.C  = 90.0
    Trig.Opp =  3.0  -- Rise  or (B2C)
    Trig.Adj =  0.0  -- Base  or (A2C)
    Trig.Hyp =  0.0  -- Slope or (A2B)
    Trig.Slope =  0.0
    Trig.Area =  0.0
    Trig.OutRadius =  0.0
    Trig.InRadius =  0.0
    Trig.Parameter =  0.0
    TrigIt()
    DisplayMessageBox("Test 4: \n" ..
    " Trig.A  = * " .. tostring(Trig.A) .. " \n" ..
    " Trig.B  =  " .. tostring(Trig.B) .. " \n" ..
    " Trig.C  =  " .. tostring(Trig.C) .. " \n" ..
    " Trig.Opp = * " .. tostring(Trig.Opp) .. " \n" ..
    " Trig.Adj =  " .. tostring(Trig.Adj) .. " \n" ..
    " Trig.Hyp =  " .. tostring(Trig.Hyp) .. " \n" ..
    " Trig.Slope =  " .. tostring(Trig.Slope) .. " on 12 inch \n" ..
    " Trig.Area =  " .. tostring(Trig.Area) .. " \n" ..
    " Trig.Parameter =  " .. tostring(Trig.Parameter) .. " \n" ..
    " Trig.OutRadius =  " .. tostring(Trig.OutRadius) .. " \n" ..
    " Trig.InRadius =  " .. tostring(Trig.InRadius) .. " \n"
    )
    -- =====================================================]]
    TrigClear()
    Trig.A  =  36.86897645844
    Trig.B  =  0.0
    Trig.C  = 90.0
    Trig.Opp =  0.0  -- Rise  or (B2C)
    Trig.Adj =  4.0  -- Base  or (A2C)
    Trig.Hyp =  0.0  -- Slope or (A2B)
    Trig.Slope =  0.0
    Trig.Area =  0.0
    Trig.OutRadius =  0.0
    Trig.InRadius =  0.0
    Trig.Parameter =  0.0
    TrigIt()
    DisplayMessageBox("Test 5: \n" ..
    " Trig.A  = * " .. tostring(Trig.A) .. " \n" ..
    " Trig.B  =  " .. tostring(Trig.B) .. " \n" ..
    " Trig.C  =  " .. tostring(Trig.C) .. " \n" ..
    " Trig.Opp =  " .. tostring(Trig.Opp) .. " \n" ..
    " Trig.Adj = * " .. tostring(Trig.Adj) .. " \n" ..
    " Trig.Hyp =  " .. tostring(Trig.Hyp) .. " \n" ..
    " Trig.Slope =  " .. tostring(Trig.Slope) .. " on 12 inch \n" ..
    " Trig.Area =  " .. tostring(Trig.Area) .. " \n" ..
    " Trig.Parameter =  " .. tostring(Trig.Parameter) .. " \n" ..
    " Trig.OutRadius =  " .. tostring(Trig.OutRadius) .. " \n" ..
    " Trig.InRadius =  " .. tostring(Trig.InRadius) .. " \n"
    )
    -- =====================================================]]
    TrigClear()
    Trig.A  =  36.86897645844
    Trig.B  =  0.0
    Trig.C  = 90.0
    Trig.Opp =  0.0  -- Rise  or (B2C)
    Trig.Adj =  0.0  -- Base  or (A2C)
    Trig.Hyp =  5.0  -- Slope or (A2B)
    Trig.Slope =  0.0
    Trig.Area =  0.0
    Trig.OutRadius =  0.0
    Trig.InRadius =  0.0
    Trig.Parameter =  0.0
    TrigIt()
    DisplayMessageBox("Test 6: \n" ..
    " Trig.A  = * " .. tostring(Trig.A) .. " \n" ..
    " Trig.B  =  " .. tostring(Trig.B) .. " \n" ..
    " Trig.C  =  " .. tostring(Trig.C) .. " \n" ..
    " Trig.Opp =  " .. tostring(Trig.Opp) .. " \n" ..
    " Trig.Adj =  " .. tostring(Trig.Adj) .. " \n" ..
    " Trig.Hyp = * " .. tostring(Trig.Hyp) .. " \n" ..
    " Trig.Slope =  " .. tostring(Trig.Slope) .. " on 12 inch \n" ..
    " Trig.Area =  " .. tostring(Trig.Area) .. " \n" ..
    " Trig.Parameter =  " .. tostring(Trig.Parameter) .. " \n" ..
    " Trig.OutRadius =  " .. tostring(Trig.OutRadius) .. " \n" ..
    " Trig.InRadius =  " .. tostring(Trig.InRadius) .. " \n"
    )
    TrigClear()
    Trig.A  =  0.0
    Trig.B  =  0.0
    Trig.C  = 90.0
    Trig.Opp =  3.0  -- Rise  or (B2C)
    Trig.Adj =  0.0  -- Base  or (A2C)
    Trig.Hyp =  0.0  -- Slope or (A2B)
    Trig.Slope =  9.0
    Trig.Area =  0.0
    Trig.OutRadius =  0.0
    Trig.InRadius =  0.0
    Trig.Parameter =  0.0
    TrigIt()
    DisplayMessageBox("Test 7: \n" ..
    " Trig.A  =  " .. tostring(Trig.A) .. " \n" ..
    " Trig.B  =  " .. tostring(Trig.B) .. " \n" ..
    " Trig.C  =  " .. tostring(Trig.C) .. " \n" ..
    " Trig.Opp = * " .. tostring(Trig.Opp) .. " \n" ..
    " Trig.Adj =  " .. tostring(Trig.Adj) .. " \n" ..
    " Trig.Hyp =  " .. tostring(Trig.Hyp) .. " \n" ..
    " Trig.Slope = * " .. tostring(Trig.Slope) .. " on 12 inch \n" ..
    " Trig.Parameter =  " .. tostring(Trig.Parameter) .. " \n" ..
    " Trig.Area =  " .. tostring(Trig.Area) .. " \n" ..
    " Trig.Parameter =  " .. tostring(Trig.Parameter) .. " \n" ..
    " Trig.Circumscribing =  " .. tostring(Trig.Circumscribing) .. " \n" ..
    " Trig.Inscribing =  " .. tostring(Trig.Inscribing) .. " \n"
    )
    -- =====================================================]]
    TrigClear()
    Trig.A  =  0.0
    Trig.B  =  0.0
    Trig.C  = 90.0
    Trig.Opp =  0.0  -- Rise  or (B2C)
    Trig.Adj =  0.0  -- Base  or (A2C)
    Trig.Hyp =  0.0  -- Slope or (A2B)
    Trig.Slope =  9.0
    Trig.Area =  0.0
    Trig.OutRadius =  0.0
    Trig.InRadius =  0.0
    Trig.Parameter =  0.0
    TrigIt()
    DisplayMessageBox("Test Error: \n" ..
      " Trig.A  =  " .. tostring(Trig.A) .. " \n" ..
      " Trig.B  =  " .. tostring(Trig.B) .. " \n" ..
      " Trig.C  =  " .. tostring(Trig.C) .. " \n" ..
      " Trig.Opp = * " .. tostring(Trig.Opp) .. " \n" ..
      " Trig.Adj =  " .. tostring(Trig.Adj) .. " \n" ..
      " Trig.Hyp =  " .. tostring(Trig.Hyp) .. " \n" ..
      " Trig.Slope = * " .. tostring(Trig.Slope) .. " on 12 inch \n" ..
      " Trig.Parameter =  " .. tostring(Trig.Parameter) .. " \n" ..
      " Trig.Area =  " .. tostring(Trig.Area) .. " \n" ..
      " Trig.Parameter =  " .. tostring(Trig.Parameter) .. " \n" ..
      " Trig.Circumscribing =  " .. tostring(Trig.Circumscribing) .. " \n" ..
      " Trig.Inscribing =  " .. tostring(Trig.Inscribing) .. " \n"
    )
    return true
  end -- function end --
-- =====================================================]]
  function TrigClear()   -- Clears and resets Trig Table
    Trig.A  =  0.0
    Trig.B  =  0.0
    Trig.C  = 90.0
    Trig.Opp =  0.0  -- Rise  or (B2C)
    Trig.Adj =  0.0  -- Base  or (A2C)
    Trig.Hyp =  0.0  -- Slope or (A2B)
    Trig.Slope =  0.0
    return true
  end -- function end
-- =====================================================]]
      local function BSA()
        Trig.B  = (Trig.C - Trig.A)
        Trig.Slope = math.tan(math.rad(Trig.A)) * 12.0
        Trig.Area =  (Trig.Opp * Trig.Adj) * 0.5
        Trig.Inscribing = ((Trig.Opp + Trig.Adj) - Trig.Hyp) * 0.5
        Trig.Circumscribing =  Trig.Hyp * 0.5
        Trig.Parameter = Trig.Opp + Trig.Adj + Trig.Hyp
      end
      if Trig.A == 0.0 and Trig.B > 0.0 and Trig.Slope == 0.0 then
        Trig.A = Trig.C - Trig.B
      elseif Trig.A == 0.0 and Trig.B == 0.0 and Trig.Slope > 0.0 then
        Trig.A = math.deg(math.atan(Trig.Slope / 12.0))
      end -- if end
-- test 4
      if (Trig.A > 0.0) and (Trig.Opp >  0.0) then -- A and Rise or (B2C)
        Trig.Adj =  Trig.Opp / (math.tan(math.rad(Trig.A)))
        Trig.Hyp = math.sqrt((Trig.Opp * Trig.Opp ) + ( Trig.Adj * Trig.Adj))
        BSA()
        return true
      -- test 6
      elseif (Trig.A > 0.0) and (Trig.Hyp >  0.0)  then -- A and Slope or (A2B)
        Trig.Adj = math.cos(math.rad(Trig.A)) * Trig.Hyp
        Trig.Opp = math.sqrt((Trig.Hyp * Trig.Hyp ) - ( Trig.Adj * Trig.Adj))
        BSA()
        return true
      -- test 5
      elseif (Trig.A > 0.0) and (Trig.Adj >  0.0)  then -- A and Base or (A2C)
        Trig.Opp = math.tan(math.rad(Trig.A)) * Trig.Adj
        Trig.Hyp = math.sqrt((Trig.Opp * Trig.Opp ) + ( Trig.Adj * Trig.Adj))
        BSA()
        return true
        -- test 1
      elseif (Trig.Opp >  0.0) and (Trig.Adj >  0.0) then -- Rise and Base
        Trig.Hyp = math.sqrt((Trig.Opp * Trig.Opp ) + ( Trig.Adj * Trig.Adj))
        Trig.A  = math.deg(math.atan(Trig.Opp / Trig.Adj))
        BSA()
        return true
      elseif (Trig.Adj >  0.0) and (Trig.Hyp >  0.0) then -- Rise and Slope
-- test 2
        Trig.Opp = math.sqrt((Trig.Hyp * Trig.Hyp ) - ( Trig.Adj * Trig.Adj))
        Trig.A  = math.deg(math.atan(Trig.Opp / Trig.Adj))
        BSA()
        return true
      elseif (Trig.Opp >  0.0) and (Trig.Hyp >  0.0) then -- Base and Slope
-- test 3
        Trig.Adj = math.sqrt((Trig.Hyp * Trig.Hyp ) - ( Trig.Opp * Trig.Opp))
        Trig.A  = math.deg(math.atan(Trig.Opp / Trig.Adj))
        BSA()
        return true
      else
        DisplayMessageBox("Error: Trig Values did not match requirements: \n" ..
                          " Trig.A  =  " .. tostring(Trig.A) .. " \n" ..
                          " Trig.B  =  " .. tostring(Trig.B) .. " \n" ..
                          " Trig.C  =  " .. tostring(Trig.C) .. " \n" ..
                          " Trig.Opp =  " .. tostring(Trig.Opp) .. " \n" ..
                          " Trig.Adj =  " .. tostring(Trig.Adj) .. " \n" ..
                          " Trig.Hyp =  " .. tostring(Trig.Hyp) .. " \n" ..
                          " Trig.Slope =  " .. tostring(Trig.Slope) .. " on 12 inch \n" ..
                          " Trig.Area =  " .. tostring(Trig.Area) .. " \n" ..
                          " Trig.Parameter =  " .. tostring(Trig.Parameter) .. " \n" ..
                          " Trig.OutRadius =  " .. tostring(Trig.OutRadius) .. " \n" ..
                          " Trig.InRadius =  " .. tostring(Trig.InRadius) .. " \n"
                          )
        return false
      end
    end -- function end
-- =====================================================]]
end -- Geometry Tools end


INI File Tools

Back.jpg

These functions manipulate the INI files for the storage and retrieval of data.


INI_NameStrip

TopOfPage.png

Convert string to the correct data type.

Local Words = NameStrip("KPSDFKSPSK - 34598923", "-") -- returns "KPSDFKSPSK"


Source Code

 function INI_NameStrip(str, var)
    if "" == str then
      DisplayMessageBox("Error in string")
    else
      if string.find(str, var) then
        local j = assert(string.find(str, var) - 1)
        return All_Trim(string.sub(str, 1, j))
      else
        return str
      end
    end
  end -- function end 

INI_HeadStrip

TopOfPage.png

Convert string to the correct data type.

  function INI_HeadStrip(str, var)                            -- convert string to the correct data type
-- Local Words = HeadStrip("LastName23 = Smith", "=") -- returns "Smith"
    if "" == str then
      DisplayMessageBox("Error in string")
    else
      if string.find(str, var) then
        local j = assert(string.find(str, var) + 1)
        return All_Trim(string.sub(str, j))
      else
        return str
      end
    end
  end -- function end 

INI_AreDupGroups

TopOfPage.png

Checks if there are duplicate groups.

function INI_AreDupGroups(xPath, xFile)
    local GroupNames = {}
    local CleanNames = {}
    local DupGroups  = {}
      GroupNames = INI_ReadGroups(xFile, aName)
      CleanNames = RemoveDups(GroupNames)
    if TableLength(GroupNames) == TableLength(CleanNames)then
      return true
    else
      return false
    end
  end -- function end 

INI_FixDupGroups

TopOfPage.png

Find and fix duplicate groups

 function INI_FixDupGroups(xPath, xFile)
    local GroupNames = {}
    local CleanNames = {}
    local DupGroups  = {}
      GroupNames = INI_ReadGroups(xFile, aName)
    return true
  end -- function end

INI_DeleteGroup

TopOfPage.png

Deletes only the first find of xGroup

 function INI_DeleteGroup(xPath, xFile, xGroup)
-- Deletes old ini (.bak) file
-- Copy's the .ini to a backup (.bak) new file
-- Reads the new backup file and writes a new file to the xGroup value
-- Stops Writing lines until next Group is found
-- Writes to end of file
-- Call: DeleteGroup("C:\\Users\\James\\OneDrive\\Documents\\DoorGadget\\Clients\\Marcin", "ProjectList", "Boston")
    local OfileName = xPath .. "\\" .. xFile .. ".bak"
    if FileExists(OfileName) then
      os.remove(OfileName)
    end
    local NfileName = xPath .. "\\" .. xFile .. ".ini"
--    os.rename(NfileName, OfileName) -- makes backup copy file
    if CopyFileFromTo(NfileName, OfileName) then
      local fileR   = io.open(OfileName)
      local fileW   = io.open(NfileName,  "w")
      local groups  = false
      local writit  = true
      local MyTxt   = ""
      local txt = ""
      if fileR and fileW then  -- files are open
        for Line in fileR:lines() do  -- read each line of the backup file
          txt = Line  -- copy line from file to txt
          if All_Trim(Line) == "[" .. All_Trim(xGroup) ..  MyTxt .. "]" then  -- look for a match
            groups = true
            txt = ""
          end -- if end
          if groups and MyTxt == "" then  -- if group is true turn off the write function
            writit = false
            if "[" == string.sub(All_Trim(txt), 1, 1) then  -- turns write function on if next group is found
              groups = false
              xGroup = "-"
              writit = true
              MyTxt   = "--"
            else
              writit = false
            end -- if end
          end -- if end
          if writit then
            fileW:write(txt .. "\n")
            txt = ""
          end -- if end
        end -- for end
        os.remove(OfileName)
      end -- if end
      if fileR then fileR:close() end
      if fileW then fileW:close() end
    end
    return true
  end -- function end

INI_RenameGroup

TopOfPage.png

Renames a group

 function INI_RenameGroup(xOldGroup, xNewGroup)
--Deletes old ini Hardware.bak file
--Copys the ini file to a backup copy file
--Reads the backup file and writes a new ini file to the xGroup
--Writes new file with new group  to the new ini file
  local NfileName = Project.AppPath .. "\\" .. "EasyDrawerHardware" .. ".ini"
  local OfileName = Project.AppPath .. "\\" .. "EasyDrawerHardware" .. ".bak"
  os.remove(OfileName)
  CopyFileFromTo(NfileName, OfileName) -- makes backup file
  local fileR = io.open(OfileName)
  local fileW = io.open(NfileName, "w")
  if fileR and fileW then
    local groups = false
    local txt = ""
    for Line in fileR:lines() do
      if All_Trim(Line) == "[" .. All_Trim(xOldGroup) .. txt .. "]" then -- Group
        fileW:write(xNewGroup .. "\n")
        txt = "-"
      else
        fileW:write(Line .. "\n")
      end -- if end
    end -- for end
    fileR:close()
    fileW:close()
    os.remove(OfileName)
  end -- if end
  return true
end -- function end

INI_DeleteItem

TopOfPage.png

Deleates a group

 function INI_DeleteItem(xPath, xFile, xGroup, xItem)
-- Deletes old ini (.bak) file
-- Copys the .ini to a backup (.bak) new file
-- Reads the new backup file and writes a new file to the xGroup value
-- Stops Writing lines until next Group is found
-- Writes to end of file
-- DeleteGroup("C:\\Users\\James\\OneDrive\\Documents\\DoorGadget\\Clients\\Marcin", "ProjectList", "Boston")
  local NfileName = xPath .. "\\" .. xFile .. ".ini"
  local OfileName = xPath .. "\\" .. xFile .. ".bak"
  os.remove(OfileName)
  CopyFileFromTo(NfileName, OfileName) -- makes backup copy file
  local fileR = io.open(OfileName)
  local fileW = io.open(NfileName,  "w")
  if fileR and fileW then
    local groups = false
    local writit = true
    local txt = ""
    for Line in fileR:lines() do
      txt = Line
      if All_Trim(Line) == "[" .. All_Trim(xGroup) .. "]" then
        groups = true
      end -- if end
      if groups then
  -- ===================
        if xItem == string.sub(Line, 1, string.len(xItem))  then  -- Item
          writit = false
          groups = false
        end -- if end
      end -- if end
  -- ===================
      if writit then
        fileW:write(txt .. "\n")
      end -- if end
      writit = true
    end -- for end
    os.remove(OfileName)
    fileR:close()
    fileW:close()
  end -- if end
  return true
end -- function end

INI_ValidateGroup

TopOfPage.png

Reads INI file and returns true if group is found

 function INI_ValidateGroup(xFile, xGroup)
  -- Reads INI file and returns true if the group is found
  local fileR = io.open(xFile)
  local group = false
  for Line in fileR:lines() do
    if string.upper(All_Trim(Line)) == "[" .. string.upper(All_Trim(xGroup)) .. "]" then  -- Group
    group = true
    break
    end -- if end
  end -- for end
  fileR:close()
  return group
end -- function end

INI_ValidateItem

TopOfPage.png

Reads INI file and returns true if group and item is found

 function INI_ValidateItem(xFile, xGroup, xItem)
    local fileR = io.open(xFile)
    if fileR then
      local group = false
      local item = false
      local ItemLen = string.len(xItem)
      for Line in fileR:lines() do
        if All_Trim(Line) == "[" ..  string.upper(All_Trim(xGroup)) .. "]" then  -- Group
        group = true
        end -- if end
        if group then
          if string.upper(xItem) == string.upper(string.sub(Line, 1, string.len(xItem)))  then  -- Item
            item = true
            break
          end -- if end
        end -- if end
      end -- for end
      fileR:close()
    end -- if end
    return group
  end -- function end

INI_StrValue

TopOfPage.png

Reads INI file and returns string value

 function INI_StrValue(str, ty)
-- Convert string to the correct data type
    if nil == str then
      DisplayMessageBox("Error in Ini file - looking for a " .. ty .. " value")
    else
      if "" == All_Trim(str) then
        DisplayMessageBox("Error in Ini file - looking for a " .. ty .. " value")
      else
        local j = (string.find(str, "=") + 1)
        if ty == "D" then -- Double
          return tonumber(string.sub(str, j))
        end -- if end
        if ty == "I" then  -- Intiger
          return math.floor(tonumber(string.sub(str, j)))
        end -- if end
        if ty == "S" then  -- String
          return All_Trim(string.sub(str, j))
        end -- if end
        if ty == "B" then  -- Bool
          if "TRUE" == All_Trim(string.sub(str, j)) then
            return true
          else
            return false
          end -- if end
        end -- if end
      end -- if end
    end -- if end
    return nil
  end -- function end

INI_GetValue

TopOfPage.png

Reads INI file and returns value

 function INI_GetValue(xPath, FileName, GroupName, ItemName, ValueType)
    -- ==INI_GetValue(xPath, FileName, GroupName, ItemName, ValueType)==
    -- Returns a value from a file, group, and Item
    -- Usage: XX.YY = GetIniValue("C:/temp", "ScrewDia", "[Screws]", "Diameter", "D")
    local filenameR = xPath .. "\\" .. FileName .. ".ini"
    local FL = LengthOfFile(filenameR)
    local file = io.open(filenameR, "r")
    local dat = "."
    local ItemNameLen = string.len(ItemName)
    if file then
      while (FL >= 1) do
        dat = string.upper(All_Trim(file:read()))
        if dat == "[" .. string.upper(GroupName) .. "]" then
          break
        else
          FL = FL - 1
        end -- if end
      end -- while end
      while (FL >= 1) do
        dat = string.upper(All_Trim(file:read()))
        if string.upper(ItemName) == string.sub(dat, 1, ItemNameLen)  then
          break
        else
          FL = FL - 1
          if FL == 0 then
            dat = "Error - item not  found"
            break
          end -- if end
        end -- if end
      end -- while end
      file:close()-- closes the open file
    end -- if end
    local XX = StrIniValue(dat, ValueType)
    return XX
  end -- function end

INI_GetIDFor

TopOfPage.png

Reads INI file and returns ID for a value

 function INI_GetIDFor(xPath, FileName, GroupName, ItemValue)
    -- == INI_GetIDFor(xPath, FileName, GroupName, ItemValue) ==
    -- Returns a ItemID from a file, group, and ItemValue
    -- Usage: XX.YY = INI_GetIDFor("C:/temp", "UserList", "[Users]", "Anderson")
    -- returns: "UserLastName22"
    local filenameR = xPath .. "\\" .. FileName .. ".ini"
    local FL = LengthOfFile(filenameR)
    local file = io.open(filenameR, "r")
    if file then
      local dat = "."
      local ItemValueLen = string.len(ItemValue)
      while (FL >= 1) do
        dat = string.upper(All_Trim(file:read()))
        if dat == "[" .. string.upper(GroupName) .. "]" then
          break
        else
          FL = FL - 1
        end -- if end
      end -- while end
      while (FL >= 1) do
        dat = string.upper(All_Trim(file:read()))
        if string.upper(ItemValue) == HeadStrip(dat, "=")  then
          break
        else
          FL = FL - 1
          if FL == 0 then
            dat = "Error - item not  found"
            break
          end -- if end
        end -- if end
      end -- while end
      file:close()-- closes the open file
    end -- if end
    local XX = NameStrip(dat, "=")
    return XX
  end -- function end

INI_ReadGroups

TopOfPage.png

Reads INI file group and returns true if found

 function INI_ReadGroups(xFile, aName)
  --[[Reads INI and returns a list contain the [Headers] as Array
  IniFile = {} Global variables
  xPath = script_path
  ]]
    local filename = xFile
    local file = io.open(filename, "r")
    if file then
      local fLength = (LengthOfFile(filename) - 1)
      local dat = All_Trim(file:read())
      while (fLength >= 1) do
        if "[" == string.sub(dat, 1, 1) then
          table.insert (aName, string.sub(dat, 2, -2))
        end
        dat = file:read()
        if dat then
          dat = All_Trim(dat)
        else
          file:close()-- closes the open file
          return true
        end
        fLength = fLength - 1
      end -- while
    end -- if
     if file then file:close() end
    return true
  end -- function end

INI_ProjectHeaderReader

TopOfPage.png

Reads INI file group and returns the INI Header values of a ini file and uploads to "IniFile" Array

 function INI_ProjectHeaderReader(xPath)
    local filename = xPath .. "/CabinetProjects.ini"
    local file = io.open(filename, "r")
    if file then
      local Cabing = (LengthOfFile(filename) - 1)
      local dat = All_Trim(file:read())
      while (Cabing >= 1) do
        if "[" == string.sub(dat, 1, 1) then
          table.insert (Projects, string.sub(dat, 2, -2))
        end
        dat = file:read()
        if dat then
          dat = All_Trim(dat)
        else
          return true
        end
        Cabing = Cabing - 1
      end
      file:close()
    end
    return true
  end -- function end

INI_AddNewProject

TopOfPage.png

Appends a New Project to CabinetProjectQuestion.ini

 function INI_AddNewProject(xPath, xGroup)
    local filename = xPath .. "/ProjectList.ini"
    local file = io.open(filename, "a")
    if file then
      file:write("[" .. All_Trim(xGroup) .. "] \n")
      file:write("load_date = " .. StartDate(true) .. " \n")
      file:write("#====================================== \n")
      file:close()-- closes the open file
    end
    return true
  end -- function end

INI_StdHeaderReader

TopOfPage.png

Gets the INI Header values of a ini file and uploads to "IniFile" Array

 function INI_StdHeaderReader(xPath, Fname)
    local filename = xPath .. "\\" .. Fname .. ".ini"
    local file = io.open(filename, "r")
    if file then
      local WallMilling = (LengthOfFile(filename) - 1)
      local dat = All_Trim(file:read())
      while (WallMilling >= 0) do
        if "[" == string.sub(dat, 1, 1) then
          table.insert (IniFile, string.sub(dat, 2, -2))
        end -- if end
        dat = file:read()
        if dat then
          dat = All_Trim(dat)
        else
          return true
        end -- if end
        WallMilling = WallMilling - 1
      end -- while end
      file:close()
    end
    return true
  end -- function end

INI_ReadProjectinfo

TopOfPage.png

Reads an ini files group and sets the table.names

 function INI_ReadProjectinfo(Table, xPath, xGroup, xFile)
    Table.ProjectContactEmail       = GetIniValue(xPath, xFile, xGroup, "ProjectQuestion.ProjectContactEmail", "S")
    Table.ProjectContactName        = GetIniValue(xPath, xFile, xGroup, "ProjectQuestion.ProjectContactName", "S")
    Table.ProjectContactPhoneNumber = GetIniValue(xPath, xFile, xGroup, "ProjectQuestion.ProjectContactPhoneNumber", "S")
    Table.ProjectName               = GetIniValue(xPath, xFile, xGroup, "ProjectQuestion.ProjectName", "S")
    Table.ProjectPath               = GetIniValue(xPath, xFile, xGroup, "ProjectQuestion.ProjectPath", "S")
    Table.StartDate                 = GetIniValue(xPath, xFile, xGroup, "ProjectQuestion.StartDate", "S")
    return true
  end -- function end

INI_UpdateItem

TopOfPage.png

Deletes old ini (.bak) file

Copys the .ini to a backup (.bak) new file

Reads the new backup file and writes a new file to the xGroup

Writes new xValue for the for the xItem

Reads and writes a new file to end of file

 function INI_UpdateItem(xPath, xFile, xGroup, xItem, xValue)
    local NfileName = xPath .. "\\" .. xFile .. ".ini"
    local OfileName = xPath .. "\\" .. xFile .. ".bak"
    os.remove(OfileName)
    if CopyFileFromTo(NfileName, OfileName) then-- makes backup file
      local fileR = io.open(OfileName)
      local fileW = io.open(NfileName,  "w")
      if fileR and fileW then
        local groups = false
        local txt = ""
        for Line in fileR:lines() do
          txt = Line
          if All_Trim(Line) == "[" .. All_Trim(xGroup) .. "]" then -- Group
            groups = true
          end -- if end
          if xItem == string.sub(Line, 1, string.len(xItem))  then  -- Item
            if groups then
              txt = xItem .. " = " .. xValue
              groups = false
            end -- if end
          end -- if end
          fileW:write(txt .. "\n")
          txt = ""
        end -- for end
        os.remove(OfileName)
        fileR:close()
        fileW:close()
      end
    end
    return true
  end -- function end

INI_ReadProject

TopOfPage.png

Reads the ini file for project data

 function INI_ReadProject(xPath, xFile, xGroup)
  -- Milling = {}
    Milling.LayerNameBackPocket          = GetIniValue(xPath, xFile, xGroup, "Milling.LayerNameBackPocket", "S")
    Milling.LayerNameTopBottomCenterDado = GetIniValue(xPath, xFile, xGroup, "Milling.LayerNameTopBottomCenterDado", "S")
    Milling.LayerNameDrawNotes           = GetIniValue(xPath, xFile, xGroup, "Milling.LayerNameDrawNotes", "S")
    Milling.LayerNameDrawFaceFrame       = GetIniValue(xPath, xFile, xGroup, "Milling.LayerNameDrawFaceFrame", "S")
    Milling.BackPocketDepthWall          = GetIniValue(xPath, xFile, xGroup, "Milling.BackPocketDepthWall", "N")
    Milling.BlindDadoSetbackWall         = GetIniValue(xPath, xFile, xGroup, "Milling.BlindDadoSetbackWall", "N")
    Milling.CabDepthWall                 = GetIniValue(xPath, xFile, xGroup, "Milling.CabDepthWall", "N")
    return true
  end -- function end

INI_TestDeleteDups

TopOfPage.png

Reads the ini file for dups and deletes

 function INI_TestDeleteDups()
    --[[ Requires 3 global variables
    clean  = {}
    dups   = {}
    Names  = {}
    ]]
    local myPath = "C:\\Users\\CNC\\Documents\\test"
    local myName = "Tester"
    local myfile = "C:\\Users\\CNC\\Documents\\test\\Tester.ini"
    INI_ReadGroups(myfile, Names)
    FindDups(Names, dups, clean)
    for i,v in ipairs(dups) do
      INI_DeleteGroup(myPath, myName, v)
    end
    return true
 end -- function end

Data Import Tools

Back.jpg

This object is used to import data to a gadget.

Read_CSV

Reads a CSV file based on header and format (Requires modifications per usage)

 function Read_CSV(xFile, Header)
  --Read_CSV(Door.CSVFile, true)
  local fileR = io.open(xFile)
  local xLine = ""
  local result = {}
  if fileR then
    for Line in fileR:lines() do
      xLine = Line
      if Header then
        Header = false
      else
        xLine = All_Trim(Line)
        for match in (xLine..","):gmatch("(.-)"..",") do
          table.insert(result, match)
        end -- for end
        Door.Count     = tonumber(result[1])
        Door.Height    = tonumber(result[2])
        Door.Width     = tonumber(result[3])

        result = {}
        while Door.Count > 0 do
          if      Door.Style == StyleA.Name then
            DoorStyleA()
          elseif  Door.Style == StyleB.Name then
            DoorStyleB()
          elseif  Door.Style == StyleC.Name then
            DoorStyleC()
          elseif  Door.Style == StyleE.Name then
            DoorStyleE()
          elseif  Door.Style == StyleF.Name then
            DoorStyleF()
          elseif  Door.Style == StyleG.Name then
            DoorStyleG()
          else
            DisplayMessageBox("No Style Select!")
          end --if end
          Door.Count =  Door.Count - 1
        end -- for end
      end --if end
      Door.Record = Door.Record + 1
      MyProgressBar:SetPercentProgress(ProgressAmount(Door.Record))
    end --for end
  end --if end
  return true
end -- function end 

Job Tools

Back.jpg

This object is a name-value pair that represents a Document Variable within a VectricJob.

function ValidJob()
  -- A better error message
    local job = VectricJob()
    if not job.Exists then
      DisplayMessageBox("Error: Cannot run Gadget, no drawing found \n" ..
                        "Please create a new file (drawing) and \n" ..
                        "specify the material dimensions \n"
      )
      return false
    else
      return true
    end  -- if end
  end -- ValidJob end


MoveSetectedVectors

TopOfPage.png
function MoveSetectedVectors(job, NewBasePoint)
    local Selection = job.Selection
    if Selection.IsEmpty then
      MessageBox("LayoutImportedVectors: No vectors selected!")
      return false
    end
    local MySelection = Selection:GetBoundingBox();
    if not NewBasePoint then
      NewBasePoint = Point2D(0,0)
    end
    local MyNewLocatioin = BasePoint - MySelection.BLC
    local Txform = TranslationMatrix2D(MyNewLocatioin)
    Selection:Transform(Txform)
    return true
  end 

FixPath

 function FixPath(path)                                -- Lua Returns a fixed path
    return path:gsub("%\\", "/")
  end -- function end

----

  function FixPath(myPath) {                            -- JavaScript Tool Returns a fixed path
    /* myPath  = "C:\\User\\Bob\\Home\\Drawings"; */
    /* NewPath = "C:/User/Bob/Home/Drawings"; */
    var NewPath = "";
    var myLetter = "";
    var CheckPathLen = myPath.length;
    for (let i = 0; i < myPath.length; i++) {
      myLetter = myPath.charAt(i)
      if myLetter.charCodeAt(0) == 92 {
        NewPath = NewPath + "/";
      } else {
        NewPath = NewPath + myLetter;
      }
    }
    return NewPath;
  }

RotateSetectedVectors

 function RotateSetectedVectors(job, NewBasePoint, NewAngle)
    local Selection = job.Selection
    if not NewBasePoint then
      NewBasePoint = Point2D(0,0)
    end -- if end
    if not NewAngle then
      NewAngle = 0.0
    end -- if end
    if Selection.IsEmpty then
      MessageBox("Error: Rotation function: No vectors selected!")
      return false
    end -- if end
    local MySelection = Selection:GetBoundingBox();
    local MyNewLocatioin = BasePoint - MySelection.BLC
    local Txform = RotationMatrix2D(NewBasePoint, NewAngle)
    Selection:Transform(Txform)
    return true
  end 

GetUnits

TopOfPage.png
function GetUnits(UTable)                               -- returns Drawing Units data
    local mtl_block = MaterialBlock()
    if mtl_block.InMM then
      UTable.Units  = "Drawing Units: mm"
      UTable.Unit = true
      UTable.UnitCheck = {"metric", "kilometer", "kilometers", "kh", "meter", "meters", "m", "decimeter", "decimeters", "dm", "centimeter", "centimeters", "cm", "millimeter", "millimeters", "mm"}
      UTable.Cal = 25.4
    else
      UTable.Units  = "Drawing Units: inches"
      UTable.Unit = false
      UTable.UnitCheck = {"imperial", "miles", "mile", "mi", "yards", "yard", "yd", "feet", "foot", "ft", "inches", "inch", "in", "fractions", "fraction"}
      UTable.Cal = 1.0
    end
    return true
  end -- end function

CheckTheUnits

TopOfPage.png
function CheckTheUnits(UTable, Value)                     -- Checks if the unit of messure in of drawing units
  local goodtogo = false
  for i=1, #UTable.UnitCheck  do
    if string.upper(Value) == string.upper(UTable.UnitCheck[i]) then
      goodtogo = true
      break
    end -- if end
  end -- for end
  if goodtogo then
    return true
  else
    return false
  end -- if end
end -- function end

GetMatlBlk

TopOfPage.png
function GetMatlBlk(Table)
    local mtl_block = MaterialBlock()
    if mtl_block.InMM then
      Table.Units = "Drawing Units: mm"
      Table.Unit = true
    else
      Table.Units = "Drawing Units: inches"
      Table.Unit = false
    end
    if mtl_block.Width> mtl_block.Height then
      Table.MaterialThickness = mtl_block.Height
      Table.MaterialLength = mtl_block.Width
      Table.Orantation = "H"
    else
      Table.MaterialThickness = mtl_block.Width
      Table.MaterialLength = mtl_block.Height
      Table.Orantation = "V"
    end
    Table.FrontThickness = Dovetail.MaterialThickness
    Table.SideThickness = Dovetail.MaterialThickness
    if mtl_block.Height == mtl_block.Width then
        MessageBox("Error! Material block cannot square")
    end
    return true
  end -- end function

GetBoxJointMaterialSettings

TopOfPage.png
function GetBoxJointMaterialSettings(Table)
    local mtl_block = MaterialBlock()
    --local units
    if mtl_block.InMM then
      Table.Units = "Drawing Units: mm"
      Table.Unit = true
    else
      Table.Units = "Drawing Units: inches"
      Table.Unit = false
    end
    if mtl_block.Width > mtl_block.Height then
      Table.MaterialThickness = mtl_block.Height
      Table.MaterialLength = mtl_block.Width
      Table.Orantation = "H"
    else
      Table.MaterialThickness = mtl_block.Width
      Table.MaterialLength = mtl_block.Height
      Table.Orantation = "V"
    end
    if mtl_block.Height == mtl_block.Width then
      MessageBox("Error! Material block cannot square")
    end
    -- Display material XY origin
    local xy_origin_text = "invalid"
    local xy_origin = mtl_block.XYOrigin
    if  xy_origin == MaterialBlock.BLC then
        Table.xy_origin_text = "Bottom Left Corner"
      if Table.Orantation == "V" then
        Table.Direction1 = 90.0
        Table.Direction2 = 0.0
        Table.Direction3 = 270.0
        Table.Direction4 = 180.0
        Table.Bulge = 1.0
      else
        Table.Direction1 = 0.0
        Table.Direction2 = 90.0
        Table.Direction3 = 180.0
        Table.Direction4 = 270.0
        Table.Bulge = -1.0
      end
    elseif xy_origin == MaterialBlock.BRC then
      Table.xy_origin_text = "Bottom Right Corner"
      if Table.Orantation == "V" then
        Table.Direction1 = 90.0
        Table.Direction2 = 180.0
        Table.Direction3 = 270.0
        Table.Direction4 = 0.0
        Table.Bulge = -1.0
      else
        Table.Direction1 = 180.0
        Table.Direction2 = 90.0
        Table.Direction3 = 0.0
        Table.Direction4 = 270.0
        Table.Bulge = 1.0
      end
    elseif xy_origin == MaterialBlock.TRC then
      Table.xy_origin_text = "Top Right Corner"
      if Table.Orantation == "V" then
        Table.Direction1 = 270.0
        Table.Direction2 = 180.0
        Table.Direction3 = 90.0
        Table.Direction4 = 0.0
        Table.Bulge = 1.0
      else
        Table.Direction1 = 180.0
        Table.Direction2 = 270.0
        Table.Direction3 = 0.0
        Table.Direction4 = 90.0
        Table.Bulge = -1.0
      end
    elseif xy_origin == MaterialBlock.TLC then
      Table.xy_origin_text = "Top Left Corner"
      if Table.Orantation == "V" then
        Table.Direction1 = 270.0
        Table.Direction2 = 0.0
        Table.Direction3 = 90.0
        Table.Direction4 = 180.0
        Table.Bulge = -1.0
      else
        Table.Direction1 = 0.0
        Table.Direction2 = 270.0
        Table.Direction3 = 180.0
        Table.Direction4 = 90.0
        Table.Bulge = 1.0
      end
    elseif xy_origin == MaterialBlock.CENTRE then  -- NOTE: English spelling for Centre!
      Table.xy_origin_text = "Center"
      if Table.Orantation == "V" then
        Table.Direction1 = 0.0
        Table.Direction2 = 0.0
        Table.Direction3 = 0.0
        Table.Direction4 = 0.0
        Table.Bulge = 1.0
      else
        Table.Direction1 = 0.0
        Table.Direction2 = 0.0
        Table.Direction3 = 0.0
        Table.Direction4 = 0.0
        Table.Bulge = -1.0
      end
        MessageBox("Error! " .. xy_origin_text .. " Must be set at a corner of the Material")
    else
        Table.xy_origin_text = "Unknown XY origin value!"
        MessageBox("Error! " .. xy_origin_text .. " Must be set at a corner of the Material")
      if Table.Orantation == "V" then
        Table.Direction1 = 0
        Table.Direction2 = 0
        Table.Direction3 = 0
        Table.Direction4 = 0
      else
        Table.Direction1 = 0
        Table.Direction2 = 0
        Table.Direction3 = 0
        Table.Direction4 = 0
      end
    end
    -- Setup Fingers and Gaps
    Table.NoFingers0 = 1 + (Rounder(BoxJoint.MaterialLength / BoxJoint.MaterialThickness, 0))
    Table.NoFingers2 = Rounder(BoxJoint.NoFingers0 / 2, 0)
    Table.FingerSize = BoxJoint.MaterialLength /  BoxJoint.NoFingers0
    Table.NoFingers1 = BoxJoint.NoFingers0 - BoxJoint.NoFingers2
    return true
  end -- function end

GetMaterialSettings

TopOfPage.png
function GetMaterialSettings(Table)
  local MaterialBlock = MaterialBlock()
  Table.MaterialBlockThickness = MaterialBlock.Thickness
  Table.xy_origin = MaterialBlock.XYOrigin
  if MaterialBlock.InMM then
    Table.Units  = "Drawing Units: mm"
    Table.Unit = true
    Table.Cal = 25.4
  else
    Table.Units  = "Drawing Units: inches"
    Table.Unit = false
    Table.Cal = 1.0
  end
  --local units
	if MaterialBlock.Width > MaterialBlock.Height then
    Table.Orantation = "H" -- Horizontal
	elseif MaterialBlock.Width < MaterialBlock.Height then
    Table.Orantation = "V"  -- Vertical
  else
    Table.Orantation = "S" -- Squair
	end
  if Table.xy_origin == MaterialBlock.BLC then
    Table.XYorigin = "Bottom Left Corner"
  elseif Table.xy_origin == MaterialBlock.BRC then
    Table.XYorigin = "Bottom Right Corner"
  elseif Table.xy_origin == MaterialBlock.TRC then
    Table.XYorigin = "Top Right Corner"
  else
    Table.XYorigin = "Top Left Corner"
  end -- if end
  Table.UnitDisplay  = "Note: Units: (" .. Table.Units ..")"
  return true
end -- end function

IsSingleSided

TopOfPage.png
function IsSingleSided(Table)
    local SingleSided = Table.job.IsSingleSided
    if not SingleSided then
      DisplayMessageBox("Error: Job must be a single sided job")
      return false
    end  -- if end
  end -- function end

IsDoubleSided

TopOfPage.png
function IsDoubleSided(Table)
  if not Table.job.IsDoubleSided then
    DisplayMessageBox("Error: Job must be a Double Sided Project")
    return false
  else
    return true
  end  -- if end
end-- function end

ShowSetting

TopOfPage.png
function ShowSetting(Table)
  local name = ""
      DisplayMessageBox(
    name .. " MaterialThickness = " .. tostring(Table.MaterialThickness) .."\n" ..
    name .. " BottleRad         = " .. tostring(Table.BottleRad)         .."\n" ..
    name .. " SideLenght        = " .. tostring(Table.SideLenght)        .."\n" ..
    name .. " SideHight         = " .. tostring(Table.SideHight)         .."\n" ..
    name .. " EndLenght         = " .. tostring(Table.EndLenght)         .."\n" ..
    name .. " EndHight          = " .. tostring(Table.EndHight)          .."\n" ..
    name .. " TopLenght         = " .. tostring(Table.TopLenght)         .."\n" ..
    name .. " TopWidht          = " .. tostring(Table.TopWidht)          .."\n" ..
    name .. " HandleLenght      = " .. tostring(Table.HandleLenght)      .."\n" ..
    name .. " HandleWidht       = " .. tostring(Table.HandleWidht)       .."\n" ..
    name .. " HandleRad         = " .. tostring(Table.HandleRad)         .."\n" ..
    name .. " MillingBitRad     = " .. tostring(Table.MillingBitRad)     .."\n" ..
    "\n")
end -- function end

MakeLayers

TopOfPage.png
function MakeLayers()
  local Red, Green, Blue = 0, 0, 0
  local function GetColor(str) -- returns color value for a Color Name
    local sx = str
    local Red = 0
    local Green = 0
    local Blue = 0
    local Colors = {}
    Colors.Black = "0,0,0"
    Colors.Red = "255,0,0"
    Colors.Blue = "0,0,255"
    Colors.Yellow = "255,255,0"
    Colors.Cyan = "0,255,255"
    Colors.Magenta = "255,0,255"
    Colors.Green = "0,128,0"
    if "" == str then
      DisplayMessageBox("Error: Empty string passed")
    else
      str = Colors[str]
      if "string" == type(str) then
        if string.find(str, ",") then
          Red   = tonumber(string.sub(str, 1, assert(string.find(str, ",") - 1)))
          str  = string.sub(str, assert(string.find(str, ",") + 1))
          Green = tonumber(string.sub(str, 1, assert(string.find(str, ",") - 1)))
          Blue  = tonumber(string.sub(str, assert(string.find(str, ",") + 1)))
        end
      else
        DisplayMessageBox("Error: Color " .. sx .. " not Found" )
        Red = 0
        Green = 0
        Blue = 0
      end
    end
    return Red, Green, Blue
  end
  local layer = Milling.job.LayerManager:GetLayerWithName(Milling.LNBackPocket)
        Red, Green, Blue = GetColor(Milling.LNBackPocketColor)
        layer:SetColor (Red, Green, Blue)
        layer = Milling.job.LayerManager:GetLayerWithName(Milling.LNBackProfile)
        Red, Green, Blue = GetColor(Milling.LNBackProfileColor)
        layer:SetColor (Red, Green, Blue)
  return true
end -- function end

MyLayerClear

TopOfPage.png
function MyLayerClear(LayerName)
  local Mylayer = Milling.job.LayerManager:GetLayerWithName(LayerName)
     if Mylayer.IsEmpty then
        Milling.job.LayerManager:RemoveLayer(Mylayer)
     end -- if end
  return true
end -- function end

LayerClear

TopOfPage.png
function LayerClear()                       --  calling MyLayerClear
  MyLayerClear(Milling.LNBackPocket  .. "-Wall")
  MyLayerClear(Milling.LNBackPocket  .. "-Base")
  MyLayerClear(Milling.LNBackProfile .. "-Wall")
  MyLayerClear(Milling.LNBackProfile .. "-Base")
  MyLayerClear("PartLabels")
  return true
end -- function end

Logic and Test Tools

Back.jpg

These functions are named as per there function or action.


CheckNumber

TopOfPage.png
function CheckNumber(num)
  if type(num) == "number" then
    return true
  else
   return false
  end -- if end
end -- function end

AboveZero

TopOfPage.png
function AboveZero(num)
  if (type(num) == "number") and (num > 0.0)then
    return true
  else
   return false
  end -- if end
end -- function end




IsNumber()

TopOfPage.png
function IsNumber(Val)                     --Return true if Val is number
    if tonumber(x) ~= nil then
      return true
    end -- if end
    return false
  end -- end function

IsEven()

TopOfPage.png
function IsEven(IsEven_Number)             -- Returns True/False if number is even
    if (IsEven_Number % 2 == 0) then
      return true
    else
      return false
    end -- if end
  end -- function end

IsOdd()

TopOfPage.png
function IsOdd(IsOdd_Number)                          -- Returns True/False if number is odd
    if(IsOdd_Number%2 == 0) then
      return false
    end -- end if
    return true
  end -- function end

IsNegative()

TopOfPage.png
function IsNegative(x)                     -- Returns True/False if number is a negative number  
  if x >=0.0 then
    return false
  else
    return true
  end -- if end
end -- function end

IsAllNumber()

TopOfPage.png
function IsAllNumber(str)                  -- Returns True/False if finds all numbers in string
  local out = true                                     
  local let = ""
  for i = 1, #str do
    let = str:byte(i)
    if (let ~= 48) and (let ~= 49) and (let ~= 50) and (let ~= 51) and
       (let ~= 52) and (let ~= 53) and (let ~= 54) and (let ~= 55) and
       (let ~= 56) and (let ~= 57) and (let ~= 46) then
      out = false
    end -- if end
  end -- for end
  return out        -- send out the return
end  -- function end

NonNumber()

TopOfPage.png
function NonNumber(Val)                    -- Return true if val is not number
    if tonumber(x) ~= nil then
      return false
    end -- if end
    return true
  end -- end function

NumberType()

TopOfPage.png
function NumberType(Val)                   -- Return true if val is not number
    if math.type(x) == "integer" then
      return "integer"
    else
      return "float"
    end -- if end
  end -- end function

Math Tools

Back.jpg

This object is a name-value pair that represents a Document Variable within a VectricJob.


ArcSegment()

TopOfPage.png
function ArcSegment(p1, p2, Rad)                       -- Returns the Arc Segment
  local chord = math.sqrt(((p2.x - p1.x) ^ 2) + ((p2.y - p1.y) ^ 2))
  local segment = (Rad - (0.5 * (math.sqrt((4.0 * Rad^2) - chord^2))))
  return segment
end -- function end

D(x) Doubles x

TopOfPage.png
function D(x)                                           -- Returns double the value
  return x * 2.0
end -- function end

H(x) Halfs x

TopOfPage.png
function H(x)                                           -- Returns half the value
  return x * 0.5
end -- function end

C(x) Returns x by scale

TopOfPage.png
function C(x)                                           -- Returns scale value
  return x * Project.Cal
end -- function end

ChordSag2Radius()

TopOfPage.png
function ChordSag2Radius (Chr, Seg)                     -- Returns the Rad from Chord and Seg
  local rad = ((((Chr * Chr)/(Seg * 4)) + Seg) / 2.0)
  return rad
end -- function end

RadSag2Chord()

TopOfPage.png
function RadSag2Chord(Rad, Seg)                         -- Returns the Chord from Rad and Seg
  local Ang = 2 * math.acos(1 - (Seg/Rad))
  local Chord = (2 * Rad) * math.sin(Ang * 0.5)
  return Chord
end -- function end

RadChord2Segment()

TopOfPage.png
function RadChord2Segment (Rad, Chord)       -- Returns the Arc Segment from Rad and Chord
  local segment = (Rad - (0.5 * (math.sqrt((4.0 * Rad^2) - Chord^2))))
  return segment
end -- function end

RoundTo()

TopOfPage.png
function RoundTo(Num, Per)                   -- Returns the number from
  local Head = Num < 0 and math.ceil(Num) or math.floor(Num)
  local Tail = Num - Head
  local Value = Head + tonumber(string.sub(tostring(Tail), 1, Per + 2))
  return Value
end -- function end

Round()

TopOfPage.png
function Round(x)
  return x>=0 and math.floor(x+0.5) or math.ceil(x-0.5)
end

DecimalPlaces()

TopOfPage.png
function DecimalPlaces(Dnum, Plac)
  return tonumber(string.sub(tostring(Dnum)  .. "000000000000000000000000000000000000",1, string.len(tostring(math.floor(Dnum))) + 1 + Plac))
end

ToInteger()

TopOfPage.png
function ToInteger( x )
    local num = tonumber( x )
    return num < 0 and math.ceil( num ) or math.floor( num )
end 

TrigIt

Finds all 5 properties of a triangle

function TrigIt(A, B, AB, AC, BC)
-- Sub Function to help other functions
-- Call = A, B, AB, AC, BC = Trig(A, B, AB, AC, BC)
-- C is the corner, A = small ang and B is the big angle
-- returns all values
-- A, B = angles
-- C = 90.0 Deg
-- B to C (BC) is Run - Base - adjacent
-- A to C (AC) is Rise - Height - opposite
-- A to B (AB) is Slope - hypotenuse
    if (B > 0.0) and (A == 0.0) then
      A = math.deg(math.rad(90) - math.rad(B))
    end
    if (A > 0.0) and (B == 0.0) then
      B = math.deg(math.rad(90) - math.rad(A))
    end
    if  (AC > 0.0) and (BC > 0.0) then
      AB = math.sqrt((AC ^ 2) + (BC ^ 2))
      A = math.deg(math.atan(BC/AC))
      B = math.deg(math.rad(90) - math.rad(A))
    elseif (AB > 0.0) and (BC > 0.0) then
      AB = math.sqrt((AB ^ 2) - (BC ^ 2))
      A = math.deg(math.atan(BC/AC))
      B = math.deg(math.rad(90) - math.rad(A))
    elseif (AB > 0.0) and (AC > 0.0) then
      AB = math.sqrt((AB ^ 2) - (AC ^ 2))
      A = math.deg(math.atan(BC/AC))
      B = math.deg(math.rad(90) - math.rad(A))
    elseif (A > 0.0) and (AC > 0.0) then
      AB = AC / math.cos(math.rad(A))
      BC = AB * math.sin(math.rad(A))
    elseif (A > 0.0) and (BC > 0.0) then
      AB = BC / math.sin(math.rad(A))
      AC = AB * math.cos(math.rad(A))
    elseif (A > 0.0) and (AB > 0.0) then
      BC = AB * math.sin(math.rad(A))
      AC = AB * math.cos(math.rad(A))
    else
      MessageBox("Error: No Missing Value")
    end -- if end
    return A, B, AB, AC, BC
  end

Registry Read and Write Tools

Back.jpg

This object is a name-value pair that represents a Document Variable within a VectricJob.


DocVarChk()

TopOfPage.png
function DocVarChk(Name, Value)
  local job = VectricJob()
  local document_variable_list = job.DocumentVariables
  return document_variable_list:DocumentVariableExists(Name)
end -- function end

DocVarGet()

TopOfPage.png
function DocVarGet(Name)
  local job = VectricJob()
  local document_variable_list = job.DocumentVariables
  return document_variable_list:GetDocumentVariable(Name, 0.0)
end -- function end

DocVarSet()

TopOfPage.png
function DocVarSet(Name, Value)
  local job = VectricJob()
  local document_variable_list = job.DocumentVariables
  return document_variable_list:SetDocumentVariable(Name, Value)
end -- function end

RegistryReadMaterial()

TopOfPage.png
function RegistryReadMaterial()                -- Read from Registry Material values for LUA Bit
  local RegistryRead              = Registry("Material")
  Milling.SafeZGap                = Rounder(RegistryRead:GetString("SafeZGap",              "0.500"), 4)
  Milling.StartZGap               = Rounder(RegistryRead:GetString("StartZGap",             "0.500"), 4)
  Milling.HomeX                   = Rounder(RegistryRead:GetString("HomeX",                 "0.000"), 4)
  Milling.HomeY                   = Rounder(RegistryRead:GetString("HomeY",                 "0.000"), 4)
  Milling.HomeZGap                = Rounder(RegistryRead:GetString("HomeZGap",              "0.750"), 4)
  return true
end -- function end

RegistryLastTenFiles()

TopOfPage.png
function RegistryLastTenFiles(FileName)        -- Adds to the top ten Log file list
  local Registry = Registry(RegName)
  LogFile.File10 = Registry:GetString("LogFile.File09", "No Log Yet" )
  LogFile.File09 = Registry:GetString("LogFile.File08", "No Log Yet" )
  LogFile.File08 = Registry:GetString("LogFile.File07", "No Log Yet" )
  LogFile.File07 = Registry:GetString("LogFile.File06", "No Log Yet" )
  LogFile.File06 = Registry:GetString("LogFile.File05", "No Log Yet" )
  LogFile.File05 = Registry:GetString("LogFile.File04", "No Log Yet" )
  LogFile.File04 = Registry:GetString("LogFile.File03", "No Log Yet" )
  LogFile.File03 = Registry:GetString("LogFile.File02", "No Log Yet" )
  LogFile.File02 = Registry:GetString("LogFile.File01", "No Log Yet" )
  LogFile.File01 = FileName
  return FileName
end -- function end

RegistryRead()

TopOfPage.png
function RegistryRead()                        -- Read from Registry values
  local RegistryRead = Registry("RegName")
  local Yes_No       = RegistryRead:GetBool("BaseDim.Yes_No", ture)
  local CabHeight    = RegistryRead:GetDouble("BaseDim.CabHeight", 35.500)
  local CabCount     = RegistryRead:GetInt("BaseDim.CabCount", 36)
  local Name         = RegistryRead:GetString("BaseDim.Name", "Words")

  Milling.MillTool1.FeedRate                = RegistryRead:GetDouble("Milling.MillTool1.FeedRate",              30.000)
  Milling.MillTool1.InMM                    = RegistryRead:GetBool("Milling.MillTool1.InMM ",                   false)
  Milling.MillTool1.Name                    = RegistryRead:GetString("Milling.MillTool1.Name",                  "No Tool Selected")
  Milling.MillTool1.BitType                 = RegistryRead:GetString("Milling.MillTool1.BitType",               "END_MILL") -- BALL_NOSE, END_MILL, VBIT
  Milling.MillTool1.RateUnits               = RegistryRead:GetInt("Milling.MillTool1.RateUnits",                4)
  Milling.MillTool1.SpindleSpeed            = RegistryRead:GetInt("Milling.MillTool1.SpindleSpeed",             20000)
  Milling.MillTool1.ToolNumber              = RegistryRead:GetInt("Milling.MillTool1.ToolNumber",               1)
  Milling.MillTool1.Stepdown                = RegistryRead:GetDouble("Milling.MillTool1.Stepdown",              0.2000)
  Milling.MillTool1.Stepover                = RegistryRead:GetDouble("Milling.MillTool1.Stepover",              0.0825)
  Milling.MillTool1.ToolDia                 = RegistryRead:GetDouble("Milling.MillTool1.ToolDia",               0.1250)
  Milling.MillTool1.PlungeRate              = RegistryRead:GetDouble("Milling.MillTool1.PlungeRate",            15.000)

  Milling.MillTool2.FeedRate                = RegistryRead:GetDouble("Milling.MillTool2.FeedRate",              30.000)
  Milling.MillTool2.InMM                    = RegistryRead:GetBool("Milling.MillTool2.InMM ",                   false)
  Milling.MillTool2.Name                    = RegistryRead:GetString("Milling.MillTool2.Name",                  "No Tool Selected")
  Milling.MillTool2.BitType                 = RegistryRead:GetString("Milling.MillTool2.BitType",               "BALL_NOSE") -- BALL_NOSE, END_MILL, VBIT
  Milling.MillTool2.RateUnits               = RegistryRead:GetInt("Milling.MillTool2.RateUnits",                4)
  Milling.MillTool2.SpindleSpeed            = RegistryRead:GetInt("Milling.MillTool2.SpindleSpeed",             20000)
  Milling.MillTool2.ToolNumber              = RegistryRead:GetInt("Milling.MillTool2.ToolNumber",               2)
  Milling.MillTool2.Stepdown                = RegistryRead:GetDouble("Milling.MillTool2.Stepdown",              0.2000)
  Milling.MillTool2.Stepover                = RegistryRead:GetDouble("Milling.MillTool2.Stepover",              0.0825)
  Milling.MillTool2.ToolDia                 = RegistryRead:GetDouble("Milling.MillTool2.ToolDia",               0.1250)
  Milling.MillTool2.PlungeRate              = RegistryRead:GetDouble("Milling.MillTool2.PlungeRate",            15.000)

  Milling.MillTool3.FeedRate                = RegistryRead:GetDouble("Milling.MillTool3.FeedRate",              30.000)
  Milling.MillTool3.InMM                    = RegistryRead:GetBool("Milling.MillTool3.InMM",                    false)
  Milling.MillTool3.Name                    = RegistryRead:GetString("Milling.MillTool3.Name",                  "No Tool Selected")
  Milling.MillTool3.BitType                 = RegistryRead:GetString("Milling.MillTool3.BitType",               "END_MILL")  -- BALL_NOSE, END_MILL, VBIT
  Milling.MillTool3.RateUnits               = RegistryRead:GetInt("Milling.MillTool3.RateUnits",                4)
  Milling.MillTool3.SpindleSpeed            = RegistryRead:GetInt("Milling.MillTool3.SpindleSpeed",             20000)
  Milling.MillTool3.ToolNumber              = RegistryRead:GetInt("Milling.MillTool3.ToolNumber",               3)
  Milling.MillTool3.Stepdown                = RegistryRead:GetDouble("Milling.MillTool3.Stepdown",              0.2000)
  Milling.MillTool3.Stepover                = RegistryRead:GetDouble("Milling.MillTool3.Stepover",              0.0825)
  Milling.MillTool3.ToolDia                 = RegistryRead:GetDouble("Milling.MillTool3.ToolDia",               0.1250)
  Milling.MillTool3.PlungeRate              = RegistryRead:GetDouble("Milling.MillTool3.PlungeRate",            15.000)

  Milling.MillTool4.FeedRate                = RegistryRead:GetDouble("Milling.MillTool4.FeedRate",              30.000)
  Milling.MillTool4.InMM                    = RegistryRead:GetBool("Milling.MillTool4.InMM ",                   false)
  Milling.MillTool4.Name                    = RegistryRead:GetString("Milling.MillTool4.Name",                  "No Tool Selected")
  Milling.MillTool4.PlungeRate              = RegistryRead:GetDouble("Milling.MillTool4.PlungeRate",            15.000)
  Milling.MillTool4.RateUnits               = RegistryRead:GetInt("Milling.MillTool4.RateUnits",                4)
  Milling.MillTool4.SpindleSpeed            = RegistryRead:GetInt("Milling.MillTool4.SpindleSpeed",             20000)
  Milling.MillTool4.Stepdown                = RegistryRead:GetDouble("Milling.MillTool4.Stepdown",              0.2000)
  Milling.MillTool4.Stepover                = RegistryRead:GetDouble("Milling.MillTool4.Stepover",              0.0825)
  Milling.MillTool4.ToolDia                 = RegistryRead:GetDouble("Milling.MillTool4.ToolDia",               0.1250)
  Milling.MillTool4.ToolNumber              = RegistryRead:GetInt("Milling.MillTool4.ToolNumber",               5)

  Milling.MillTool5.FeedRate                = RegistryRead:GetDouble("Milling.MillTool5.FeedRate",              30.000)
  Milling.MillTool5.InMM                    = RegistryRead:GetBool("Milling.MillTool5.InMM ",                   false)
  Milling.MillTool5.Name                    = RegistryRead:GetString("Milling.MillTool5.Name",                  "No Tool Selected")
  Milling.MillTool5.PlungeRate              = RegistryRead:GetDouble("Milling.MillTool5.PlungeRate",            15.000)
  Milling.MillTool5.RateUnits               = RegistryRead:GetInt("Milling.MillTool5.RateUnits",                4)
  Milling.MillTool5.SpindleSpeed            = RegistryRead:GetInt("Milling.MillTool5.SpindleSpeed",             20000)
  Milling.MillTool5.Stepdown                = RegistryRead:GetDouble("Milling.MillTool5.Stepdown",              0.2000)
  Milling.MillTool5.Stepover                = RegistryRead:GetDouble("Milling.MillTool5.Stepover",              0.0825)
  Milling.MillTool5.ToolDia                 = RegistryRead:GetDouble("Milling.MillTool5.ToolDia",               0.1250)
  Milling.MillTool5.ToolNumber              = RegistryRead:GetInt("Milling.MillTool5.ToolNumber",               6)
  return true
end -- function end

RegistryWrite()

TopOfPage.png
function RegistryWrite()                       -- Write to Registry values
  local RegistryWrite = Registry("RegName")
  local RegValue
  RegValue = RegistryWrite:SetBool("ProjectQuestion.CabinetName", true)
  RegValue = RegistryWrite:SetDouble("BaseDim.CabDepth", 23.0000)
  RegValue = RegistryWrite:SetInt("BaseDim.CabHeight", 35)
  RegValue = RegistryWrite:SetString("BaseDim.CabLength", "Words")

  RegValue = RegistryWrite:SetDouble("Milling.MillTool1.FeedRate" ,     Milling.MillTool1.FeedRate)
  RegValue = RegistryWrite:SetBool("Milling.MillTool1.InMM",            Milling.MillTool1.InMM)
  RegValue = RegistryWrite:SetString("Milling.MillTool1.Name",          Milling.MillTool1.Name)
  RegValue = RegistryWrite:SetString("Milling.MillTool1.BitType",       Milling.MillTool1.BitType)
  RegValue = RegistryWrite:SetDouble("Milling.MillTool1.PlungeRate" ,   Milling.MillTool1.PlungeRate)
  RegValue = RegistryWrite:SetInt("Milling.MillTool1.RateUnits",        Milling.MillTool1.RateUnits)
  RegValue = RegistryWrite:SetInt("Milling.MillTool1.SpindleSpeed",     Milling.MillTool1.SpindleSpeed)
  RegValue = RegistryWrite:SetDouble("Milling.MillTool1.Stepdown" ,     Milling.MillTool1.Stepdown)
  RegValue = RegistryWrite:SetDouble("Milling.MillTool1.Stepover" ,     Milling.MillTool1.Stepover)
  RegValue = RegistryWrite:SetDouble("Milling.MillTool1.ToolDia" ,      Milling.MillTool1.ToolDia)
  RegValue = RegistryWrite:SetInt("Milling.MillTool1.ToolNumber",       Milling.MillTool1.ToolNumber)

  RegValue = RegistryWrite:SetDouble("Milling.MillTool2.FeedRate" ,     Milling.MillTool2.FeedRate)
  RegValue = RegistryWrite:SetBool("Milling.MillTool2.InMM",            Milling.MillTool2.InMM)
  RegValue = RegistryWrite:SetString("Milling.MillTool2.Name",          Milling.MillTool2.Name)
  RegValue = RegistryWrite:SetString("Milling.MillTool2.BitType",       Milling.MillTool2.BitType)
  RegValue = RegistryWrite:SetDouble("Milling.MillTool2.PlungeRate" ,   Milling.MillTool2.PlungeRate)
  RegValue = RegistryWrite:SetInt("Milling.MillTool2.RateUnits",        Milling.MillTool2.RateUnits)
  RegValue = RegistryWrite:SetInt("Milling.MillTool2.SpindleSpeed",     Milling.MillTool2.SpindleSpeed)
  RegValue = RegistryWrite:SetDouble("Milling.MillTool2.Stepdown" ,     Milling.MillTool2.Stepdown)
  RegValue = RegistryWrite:SetDouble("Milling.MillTool2.Stepover" ,     Milling.MillTool2.Stepover)
  RegValue = RegistryWrite:SetDouble("Milling.MillTool2.ToolDia" ,      Milling.MillTool2.ToolDia)
  RegValue = RegistryWrite:SetInt("Milling.MillTool2.ToolNumber",       Milling.MillTool2.ToolNumber)

  RegValue = RegistryWrite:SetDouble("Milling.MillTool3.FeedRate" ,     Milling.MillTool3.FeedRate)
  RegValue = RegistryWrite:SetBool("Milling.MillTool3.InMM",            Milling.MillTool3.InMM)
  RegValue = RegistryWrite:SetString("Milling.MillTool3.Name",          Milling.MillTool3.Name)
  RegValue = RegistryWrite:SetString("Milling.MillTool3.BitType",       Milling.MillTool3.BitType)
  RegValue = RegistryWrite:SetDouble("Milling.MillTool3.PlungeRate",    Milling.MillTool3.PlungeRate)
  RegValue = RegistryWrite:SetInt("Milling.MillTool3.RateUnits",        Milling.MillTool3.RateUnits)
  RegValue = RegistryWrite:SetInt("Milling.MillTool3.SpindleSpeed",     Milling.MillTool3.SpindleSpeed)
  RegValue = RegistryWrite:SetDouble("Milling.MillTool3.Stepdown" ,     Milling.MillTool3.Stepdown)
  RegValue = RegistryWrite:SetDouble("Milling.MillTool3.Stepover" ,     Milling.MillTool3.Stepover)
  RegValue = RegistryWrite:SetDouble("Milling.MillTool3.ToolDia" ,      Milling.MillTool3.ToolDia)
  RegValue = RegistryWrite:SetInt("Milling.MillTool3.ToolNumber",       Milling.MillTool3.ToolNumber)

  RegValue = RegistryWrite:SetDouble("Milling.MillTool4.FeedRate" ,     Milling.MillTool4.FeedRate)
  RegValue = RegistryWrite:SetBool("Milling.MillTool4.InMM",            Milling.MillTool4.InMM)
  RegValue = RegistryWrite:SetString("Milling.MillTool4.Name",          Milling.MillTool4.Name)
  RegValue = RegistryWrite:SetDouble("Milling.MillTool4.PlungeRate" ,   Milling.MillTool4.PlungeRate)
  RegValue = RegistryWrite:SetInt("Milling.MillTool4.RateUnits",        Milling.MillTool4.RateUnits)
  RegValue = RegistryWrite:SetInt("Milling.MillTool4.SpindleSpeed",     Milling.MillTool4.SpindleSpeed)
  RegValue = RegistryWrite:SetDouble("Milling.MillTool4.Stepdown" ,     Milling.MillTool4.Stepdown)
  RegValue = RegistryWrite:SetDouble("Milling.MillTool4.Stepover" ,     Milling.MillTool4.Stepover)
  RegValue = RegistryWrite:SetDouble("Milling.MillTool4.ToolDia" ,      Milling.MillTool4.ToolDia)
  RegValue = RegistryWrite:SetInt("Milling.MillTool4.ToolNumber",       Milling.MillTool4.ToolNumber)
  return true
end -- function end

REG_CheckRegistryBool()

TopOfPage.png
function REG_CheckRegistryBool()               -- Checks Registry for Bool values
  local RegistryRead = Registry("RegName")
  if RegistryRead:BoolExists("ProjectQuestion.Runtool") then
    DisplayMessageBox("Alert: The Runtool value is saved.")
  else
    DisplayMessageBox("Alert: The Runtool value is not saved.")
  end -- if end
  return true
end -- function end

REG_CheckRegistryDouble()

TopOfPage.png
function REG_CheckRegistryDouble()             -- Checks Registry for Double values
  local RegistryRead = Registry("RegName")
  if RegistryRead:DoubleExists("ProjectQuestion.ProjectCost") then
    DisplayMessageBox("Alert: The project cost is saved.")
  else
    DisplayMessageBox("Alert: The Project Cost is not saved.")
  end -- if end
  return true
end -- function end

REG_CheckRegistryInt()

TopOfPage.png
function REG_CheckRegistryInt()                -- Checks Registry for Int values
  local RegistryRead = Registry("RegName")
  if RegistryRead:IntExists("ProjectQuestion.ProjectCount") then
    DisplayMessageBox("Alert: The Project Count is saved.")
  else
    DisplayMessageBox("Alert: The Project Count is not saved.")
  end -- if end
  return true
end -- function end

REG_CheckRegistryString()

TopOfPage.png
function REG_CheckRegistryString()             -- Checks Registry for String values
  local RegistryRead = Registry("RegName")
  if RegistryRead:StringExists("ProjectQuestion.ProjectPath") then
    DisplayMessageBox("Alert: The Project path is saved.")
  else
    DisplayMessageBox("Alert: The Project path is not saved.")
  end
  return true
end -- function end

String Tools

Back.jpg

This object is a name-value pair that represents a Document Variable within a VectricJob.


StringToArraySplit

TopOfPage.png
function StringToArraySplit(s, delimiter)
--[[
split_string = StringToArraySplit("Hello World,Jim,Bill,Tom", ",")
Returns = array
-- split_string[1] = "Hello World,)
-- split_string[2] = "Jim"
]]
  result = {};
  for match in (s..delimiter):gmatch("(.-)"..delimiter) do
      table.insert(result, match)
  end
  return result
end
  

WrapString

TopOfPage.png
function WrapString(Str, Wid)                           -- wraps text at the nearest space and puts a return char in the space location
  --[[  How to use:
  Call WrapString(string, Number)
 WrapString("Jim is a tall man that lives in Texas. He was raised in North East Texas on 1000 acres from 1970 to 1982. This is a man that knows numbers of great people from a round the world.", 40)
 returns "Jim is a tall man that lives in Texas.\n
          He was raised in North East Texas on\n
          1000 acres from 1970 to 1982. This is a man\n
          that knows numbers of great people from\n
          a round the world."
 ]]
  local Wider = Wid
  local Posx = string.len(Str)
  local StrLen = string.len(Str)
  local pt = 0
  local function FindSpace(MyStr)
  local Pos = string.len(MyStr)
  local str = MyStr
    if string.find(MyStr, " ") ~= nil then
      while Pos>0 do
        Pos = Pos - 1
          if (string.byte(string.sub(str,-1)) == 32) then
            break
          else
            str = string.sub(str, 1, Pos)
          end
        end
    end
    return Pos
  end
  if StrLen > Wider then
    while Wider < Posx do
      pt = FindSpace(string.sub(Str,1, Wider))
      Str = string.sub(Str, 1, pt) .. "\n" ..  string.sub(Str, pt +2)
      Wider = Wider + Wid
    end
  end
  return Str
end -- function end
  

CleanString

TopOfPage.png
function CleanString(inStr)                         -- Check for ascii letters below 127
  local outStr, str1 = ""
  local inStrLen = string.len(inStr)
  for i = 1, inStrLen ,1 do
    str1 = string.sub(inStr, i, i)
    if string.byte(str1) <= 127 then
     outStr=outStr .. str1
    end
  end
  return outStr
end -- function end
  

GetDiameterAndCentre

TopOfPage.png
function CheckString(YourStr)                          -- Check string for specal bite chars for HTML
  local function FindLetter(TheStr, TestChar)
    local outStr = false
    local strChar = ""
    local TheStrLen = string.len(TheStr)
    for i = 1, TheStrLen ,1 do
      strChar = string.sub(TheStr, i, i)
      if string.byte(strChar) == string.byte(TestChar) then
        outStr = true
        break
      end
    end
    return outStr
  end -- function end
  

GetDiameterAndCentre

TopOfPage.png
  local StrTest = false
  StrTest = SwitchLetter(YourStr,  "&")  -- Non frendly File Name letters
  StrTest = SwitchLetter(YourStr,  "#")
  StrTest = SwitchLetter(YourStr,  "@")
  StrTest = SwitchLetter(YourStr,  "^")
  StrTest = SwitchLetter(YourStr,  "$")
    return outStr
end -- function end
  

MakeHTMLReady()

TopOfPage.png
function MakeHTMLReady(MyStr)                          -- fix's string with special bite chars for HTML
  local function SwitchLetter(MyStr, MyChar, NewStr)
  local outStr, str1 = ""
  local inStrLen = string.len(MyStr)
  for i = 1, inStrLen ,1 do
    str1 = string.sub(MyStr, i, i)
    if string.byte(str1) == string.byte(MyChar) then
     outStr=outStr .. NewStr
     else
         outStr=outStr .. str1
    end
  end
  return outStr
end -- function end
  

SwitchLetterTest

TopOfPage.png
function SwitchLetterTest(MyStr)
  local outStr = ""
  outStr = SwitchLetter(MyStr, "!",	"!")
  outStr = SwitchLetter(outStr, "#",	"#")
  outStr = SwitchLetter(outStr, "$",	"$")
  outStr = SwitchLetter(outStr, "%",	"%")
  outStr = SwitchLetter(outStr, "&",	"&")
  outStr = SwitchLetter(outStr, "'",	"'")
  outStr = SwitchLetter(outStr, "(",	"(")
  outStr = SwitchLetter(outStr, ")",	")")
  outStr = SwitchLetter(outStr, "*",	"*")
  outStr = SwitchLetter(outStr, "+",	"+")
  outStr = SwitchLetter(outStr, ",",	",")
  outStr = SwitchLetter(outStr, "-",	"-")
  outStr = SwitchLetter(outStr, ".",	".")
  outStr = SwitchLetter(outStr, "/",	"/")
  outStr = SwitchLetter(outStr, ":",	":")
  outStr = SwitchLetter(outStr, ";",	";")
  outStr = SwitchLetter(outStr, "<",	"<")
  outStr = SwitchLetter(outStr, "=",	"=")
  outStr = SwitchLetter(outStr, ">",	">")
  outStr = SwitchLetter(outStr, "?",	"?")
  outStr = SwitchLetter(outStr, "@",	"@")
  outStr = SwitchLetter(outStr, "[",	"[")
  outStr = SwitchLetter(outStr, "]",	"]")
  outStr = SwitchLetter(outStr, "^",	"^")
  outStr = SwitchLetter(outStr, "_",	"_")
  outStr = SwitchLetter(outStr, "`",	"`")
  outStr = SwitchLetter(outStr, "{",	"&#123")
  outStr = SwitchLetter(outStr, "|",	"&#124")
  outStr = SwitchLetter(outStr, "}",	"&#125")
  outStr = SwitchLetter(outStr, "~",	"&#126")
    return outStr
end -- function end
  

SwitchLetter()

TopOfPage.png
function SwitchLetter(MyStr, MyChar, NewStr)            -- swwap a leter for another letter
  local outStr, str1 = ""
  local inStrLen = string.len(MyStr)
  for i = 1, inStrLen ,1 do
    str1 = string.sub(MyStr, i, i)
    if string.byte(str1) == string.byte(MyChar) then
     outStr=outStr .. NewStr
     else
         outStr=outStr .. str1
    end
  end
  return outStr
end -- function end
  

PadC

TopOfPage.png
function PadC(str, lenth)                        -- Adds spaces to front and back to center text in lenth
-- Local Word = PadC("K", 12) -- returns "     K      "
  if type(str) ~= "string" then
    str = tostring(str)
  end
  if string.len(str) < lenth then
  local a = math.floor(lenth - string.len(str) * 0.5) - 2
  local b = math.ceil(lenth - string.len(str) * 0.5) - 2
  --print ("a = " .. a)
  for _ = 1, a, 1 do
    str =  " " .. str
  end
  for _ = 1, b, 1 do
    str =  str .. " "
  end
  --print ("str len = " .. #str)
  end
  return str
end -- function end
  

PadR()

TopOfPage.png
function PadR(str, len)                        -- Adds spaces to Back of string
-- Local Word = Pad("KPSDFKSPSK", 12) -- returns "KPSDFKSPSK  "
  if type(str) ~= "string" then
    str = tostring(str)
  end
  while string.len(str) < len do
    str = str .. " "
  end
  return str
end -- function end

PadL()

TopOfPage.png
function PadL(str, len)              -- Adds spaces to Front of string
-- Local Word = Pad("KPSDFKSPSK", 12) -- returns "  KPSDFKSPSK"
  if type(str) ~= "string" then
    str = tostring(str)
  end
  while string.len(str) < len do
    str = " " .. str
  end
  return str
end -- function end

NumberPad()

TopOfPage.png
function NumberPad(str, front, back) -- Adds spaces to front and zeros to the back of string
  local mychar
  local  a,b,c,d = 0,0,0,0
  local x,y,z = "","",""
  if type(str) ~= "string" then
    str = tostring(str)
  end
  c = string.len(str)
  for i = 1, c, 1 do
    mychar = string.byte(string.sub(str, i,i))
    if mychar == 46 then
      b = i
    end
  end
--  print("b = " .. b)
  if b == 0 then
    str = str .. "."
    c = c + 1
    b = c
  end -- if loc
  x = string.sub(str, 1, b-1)
  y = string.sub(str, b+1)
  a = c - b
  a = #x
  d = #y
  if a < front then
    front = front - (a - 1)
    for _ = 1, front -1 do
      x = " " .. x
    end -- end for front
  end
  back = back - (c - b)
  for i = 1, back  do
    y = y .. "0"
  end -- end for back
  str =   x .. "." .. y
  return str
end -- function end
  

All_Trim()

TopOfPage.png
function All_Trim(s)                           -- Trims spaces off both ends of a string
  return s:match( "^%s*(.-)%s*$" )
end -- function end
  

MakeProperCase()

TopOfPage.png
function MakeProperCase(str)
  local str=string.gsub(string.lower(str),"^(%w)", string.upper)
  return string.gsub(str,"([^%w]%w)", string.upper)
end
  

ifT()

TopOfPage.png
function ifT(x)                                -- Converts Boolean True or False to String "Yes" or "No"
-- ===ifT(x)===
  if x then
    return "Yes"
  else
    return "No"
  end-- if end
end -- function end
  

ifY()

TopOfPage.png
function ifY(x)                                -- Converts String "Yes" or "No" to Boolean True or False
-- ===ifY(x)===
  if string.upper(x) == "YES" then
    return true
  else
    return false
  end-- if end
end -- function end

Seed Documents

(top)

Back.jpg

This object is a name-value pair that represents a Document Variable within a VectricJob.

-- =====================================================]]
╔═╗╔═╗╔═╗╔╦╗  ╔═╗╦ ╦╔╗╔╔═╗╔╦╗╦╔═╗╔╗╔
╚═╗║╣ ║╣  ║║  ╠╣ ║ ║║║║║   ║ ║║ ║║║║
╚═╝╚═╝╚═╝═╩╝  ╚  ╚═╝╝╚╝╚═╝ ╩ ╩╚═╝╝╚╝
-- =====================================================]]
  -- VECTRIC LUA SCRIPT
-- =====================================================]]
-- Gadgets are an entirely optional add-in to Vectric's core software products.
-- They are provided 'as-is', without any express or implied warranty, and you make use of them entirely at your own risk.
-- In no event will the author(s) or Vectric Ltd. be held liable for any damages arising from their use.
-- Permission is granted to anyone to use this software for any purpose,
-- including commercial applications, and to alter it and redistribute it freely,
-- subject to the following restrictions:
-- 1. The origin of this software must not be misrepresented; you must not claim that you wrote the original software.
-- 2. If you use this software in a product, an acknowledgement in the product documentation would be appreciated but is not required.
-- 3. Altered source versions must be plainly marked as such, and must not be misrepresented as being the original software.
-- 4. This notice may not be removed or altered from any source distribution.
-- Easy Seed Gadget Master is written by Jim Anderson of Houston Texas 2020
-- =====================================================]]
-- require("mobdebug").start()
-- require "strict"
local Tools
-- Global Variables --
local Ver = "1.0"  -- Version 7: Aug 2021 - Clean Up and added Ver to Dialog

-- Table Names
Milling = {}
Project = {}
-- =====================================================]]
function main(script_path)
--[[
	Gadget Notes: Dec 2019 - My New Gadget

  ]]
-- Localized Variables --

-- Job Validation --
  local job = VectricJob()
  if not job.Exists then
    DisplayMessageBox("Error: No job loaded")
    return false
  end

  Tools = assert(loadfile(script_path .. "\\EasyGearToolsVer" .. Ver .. ".xlua")) (Tools) -- Load Tool Function
-- Get Data --

-- Calculation --

-- Do Something --


  return true
end  -- function end

Setup Tools

Back.jpg

This object is a name-value pair that represents a Document Variable within a VectricJob.

-- =====================================================]]
╔═╗╔═╗╔╦╗╦ ╦╔═╗
╚═╗║╣  ║ ║ ║╠═╝
╚═╝╚═╝ ╩ ╚═╝╩
function SetupAndLetter Seeds()
-- =====================================================]]
  function LUA_Seed()
    -- VECTRIC LUA SCRIPT
    -- ==============================================================================
    --  Gadgets are an entirely optional add-in to Vectric's core software products.
    --  They are provided 'as-is', without any express or implied warranty, and you
    --  make use of them entirely at your own risk.
    --  In no event will the author(s) or Vectric Ltd. be held liable for any damages
    --  arising from their use.
    --  Permission is granted to anyone to use this software for any purpose,
    --  including commercial applications, and to alter it and redistribute it freely,
    --  subject to the following restrictions:
    --  1. The origin of this software must not be misrepresented;
    --     you must not claim that you wrote the original software.
    --     If you use this software in a product, an acknowledgement in the product
    --     documentation would be appreciated but is not required.
    --  2. Altered source versions must be plainly marked as such, and
    --     must not be misrepresented as being the original software.
    --  3. This notice may not be removed or altered from any source distribution.
    -- ==============================================================================
    -- "AppName Here" was written by JimAndi Gadgets of Houston Texas
    -- ==============================================================================
    -- =====================================================]]
    -- require("mobdebug").start()
    -- require "strict"
    -- =====================================================]]
    -- Global variables
    -- =====================================================]]
  end -- lua function
-- =====================================================]]
  function Install_letter()
  -- Steps to Install:

  -- 1. Download the gadget x.zip that is attached to this post.
  -- 2. Rename it from x.zip to x.vgadget
  -- 3. In Vectric Pro or Aspire click on Gadgets -> Install Gadget and navigate to where you downloaded the file to, select it and click Ok.

  -- It should give you a pop up saying the gadget was installed and you should see x in the Gadgets menu.

  -- Image Here

  -- Steps for Use:
  -- 1. Select a layer that you want to calculate for
  -- 2. Enter the cut depth
  -- 3. Enter the percentage of coverage for the area that will be filled in
  -- 4. Enter the hardner to resin percentage
  -- 5. Click the Calculate Button and the results will be displayed below in the Results Pane.
  end -- install function

end -- Header function
-- =====================================================]]


Toolpathing Tools

Back.jpg

This object is a name-value pair that represents a Document Variable within a VectricJob.


CreateLayerProfileToolpath

TopOfPage.png
function CreateLayerProfileToolpath(name, layer_name, start_depth, cut_depth, tool_dia, tool_stepdown, tool_in_mm)
    -- clear current selection
    local selection = job.Selection
    selection:Clear()
    -- get layer
    local layer = job.LayerManager:FindLayerWithName(layer_name)
    if layer == nil then
      DisplayMessageBox("No layer found with name = " .. layer_name)
      return false
    end
    -- select all closed vectors on the layer
    if not SelectVectorsOnLayer(layer, selection, true, false, true) then
      DisplayMessageBox("No closed vectors found on layer " .. layer_name)
      return false
    end
    -- Create tool we will use to machine vectors
    local tool = Tool("Lua End Mill", Tool.END_MILL) -- BALL_NOSE, END_MILL, VBIT

    tool.InMM = tool_in_mm
    tool.ToolDia = tool_dia
    tool.Stepdown = tool_stepdown
    tool.Stepover = tool_dia * 0.25
    tool.RateUnits = Tool.MM_SEC -- MM_SEC, MM_MIN, METRES_MIN, INCHES_SEC ...
    tool.FeedRate = 30
    tool.PlungeRate = 10
    tool.SpindleSpeed = 20000
    tool.ToolNumber = 1
    tool.VBit_Angle = 90.0 -- used for vbit only
    tool.ClearStepover = tool_dia * 0.5 -- used for vbit only
    -- Create object used to set home position and safez gap above material surface
    local pos_data = ToolpathPosData()
    pos_data:SetHomePosition(0, 0, 1.0)
    pos_data.SafeZGap = 5.0
    -- Create object used to pass profile options
    local profile_data = ProfileParameterData()
    -- start depth for toolpath
    profile_data.StartDepth = start_depth
    -- cut depth for toolpath this is depth below start depth
    profile_data.CutDepth = cut_depth
    -- direction of cut - ProfileParameterData.
    -- CLIMB_DIRECTION or ProfileParameterData.CONVENTIONAL_DIRECTION
    profile_data.CutDirection = ProfileParameterData.CLIMB_DIRECTION
    -- side we machine on - ProfileParameterData.
    -- PROFILE_OUTSIDE, ProfileParameterData.PROFILE_INSIDE or
    -- ProfileParameterData.PROFILE_ON
    profile_data.ProfileSide = ProfileParameterData.PROFILE_OUTSIDE
    -- Allowance to leave on when machining
    profile_data.Allowance = 0.0
    -- true to preserve start point positions, false to reorder start
    -- points to minimise toolpath length
    profile_data.KeepStartPoints = false
    -- true if want to create 'square' external corners on toolpath
    profile_data.CreateSquareCorners = false
    -- true to perform corner sharpening on internal corners (only with v-bits)
    profile_data.CornerSharpen = false
    -- true to use tabs (position of tabs must already have been defined on vectors)
    profile_data.UseTabs = false
    -- length for tabs if being used
    profile_data.TabLength = 5.0
    -- Thickness for tabs if being used
    profile_data.TabThickness = 1.0
    -- if true then create 3d tabs else 2d tabs
    profile_data.Use3dTabs = true
    -- if true in Aspire, project toolpath onto composite model
    profile_data.ProjectToolpath = false
    -- Create object used to control ramping
    local ramping_data = RampingData()
    -- if true we do ramping into toolpath
    ramping_data.DoRamping = false
    -- type of ramping to perform RampingData.RAMP_LINEAR , RampingData.RAMP_ZIG_ZAG
    -- or RampingData.RAMP_SPIRAL
    ramping_data.RampType = RampingData.RAMP_ZIG_ZAG
    -- how ramp is contrained - either by angle or distance RampingData.CONSTRAIN_DISTANCE
    -- or RampingData.CONSTRAIN_ANGLE
    ramping_data.RampConstraint = RampingData.CONSTRAIN_ANGLE
    -- if we are constraining ramp by distance, distance to ramp over
    ramping_data.RampDistance = 100.0
    -- if we are contraining ramp by angle , angle to ramp in at (in degrees)
    ramping_data.RampAngle = 25.0
    -- if we are contraining ramp by angle, max distance to travel before 'zig zaging'
    -- if zig zaging
    ramping_data.RampMaxAngleDist = 15
    -- if true we restrict our ramping to lead in section of toolpath
    ramping_data.RampOnLeadIn = false
    -- Create object used to control lead in/out
    local lead_in_out_data = LeadInOutData()
    -- if true we create lead ins on profiles (not for profile on)
    lead_in_out_data.DoLeadIn = false
    -- if true we create lead outs on profiles (not for profile on)
    lead_in_out_data.DoLeadOut = false
    -- type of leads to create LeadInOutData.LINEAR_LEAD or LeadInOutData.CIRCULAR_LEAD
    lead_in_out_data.LeadType = LeadInOutData.CIRCULAR_LEAD
    -- length of lead to create
    lead_in_out_data.LeadLength = 10.0
    -- Angle for linear leads
    lead_in_out_data.LinearLeadAngle = 45
    -- Radius for circular arc leads
    lead_in_out_data.CirularLeadRadius = 5.0
    -- distance to 'overcut' (travel past start point) when profiling
    lead_in_out_data.OvercutDistance = 0.0
    -- Create object which can be used to automatically select geometry
    local geometry_selector = GeometrySelector()
    -- if this is true we create 2d toolpaths previews in 2d view, if false we dont
    local create_2d_previews = true
    -- if this is true we will display errors and warning to the user
    local display_warnings = true
    -- Create our toolpath
    local toolpath_manager = ToolpathManager()
    local toolpath_id = toolpath_manager:CreateProfilingToolpath(name, tool, profile_data, ramping_data, lead_in_out_data, pos_data, geometry_selector, create_2d_previews, display_warnings )
    if toolpath_id == nil then
      DisplayMessageBox("Error creating toolpath")
      return false
    end
    return true
end -- end function

CreateProfileToolpath

TopOfPage.png
function CreateProfileToolpath(name, start_depth, cut_depth, tool_dia, tool_stepdown, tool_in_mm)
    -- Create tool we will use to machine vectors
    local tool = Tool("Lua End Mill", Tool.END_MILL) -- BALL_NOSE, END_MILL, VBIT
    tool.InMM = tool_in_mm
    tool.ToolDia = tool_dia
    tool.Stepdown = tool_stepdown
    tool.Stepover = tool_dia * 0.25
    tool.RateUnits = Tool.MM_SEC -- MM_SEC, MM_MIN, METRES_MIN, INCHES_SEC ...
    tool.FeedRate = 30
    tool.PlungeRate = 10
    tool.SpindleSpeed = 20000
    tool.ToolNumber = 1
    tool.VBit_Angle = 90.0 -- used for vbit only
    tool.ClearStepover = tool_dia * 0.5 -- used for vbit only
    -- Create object used to set home position and safez gap above material surface
    local pos_data = ToolpathPosData()
    pos_data:SetHomePosition(0, 0, 1.0)
    pos_data.SafeZGap = 5.0
    -- Create object used to pass profile options
    local profile_data = ProfileParameterData()
    -- start depth for toolpath
    profile_data.StartDepth = start_depth
    -- cut depth for toolpath this is depth below start depth
    profile_data.CutDepth = cut_depth
    -- direction of cut - ProfileParameterData.
    -- CLIMB_DIRECTION or ProfileParameterData.CONVENTIONAL_DIRECTION
    profile_data.CutDirection = ProfileParameterData.CLIMB_DIRECTION
    -- side we machine on - ProfileParameterData.
    -- PROFILE_OUTSIDE, ProfileParameterData.PROFILE_INSIDE or
    -- ProfileParameterData.PROFILE_ON
    profile_data.ProfileSide = ProfileParameterData.PROFILE_OUTSIDE
    -- Allowance to leave on when machining
    profile_data.Allowance = 0.0
    -- true to preserve start point positions, false to reorder start
    -- points to minimise toolpath length
    profile_data.KeepStartPoints = false
    -- true if want to create 'square' external corners on toolpath
    profile_data.CreateSquareCorners = false
    -- true to perform corner sharpening on internal corners (only with v-bits)
    profile_data.CornerSharpen = false
    -- true to use tabs (position of tabs must already have been defined on vectors)
    profile_data.UseTabs = false
    -- length for tabs if being used
    profile_data.TabLength = 5.0
    -- Thickness for tabs if being used
    profile_data.TabThickness = 1.0
    -- if true then create 3d tabs else 2d tabs
    profile_data.Use3dTabs = true
    -- if true in Aspire, project toolpath onto composite model
    profile_data.ProjectToolpath = false
    -- Create object used to control ramping
    local ramping_data = RampingData()
    -- if true we do ramping into toolpath
    ramping_data.DoRamping = false
    -- type of ramping to perform RampingData.RAMP_LINEAR , RampingData.RAMP_ZIG_ZAG
    -- or RampingData.RAMP_SPIRAL
    ramping_data.RampType = RampingData.RAMP_ZIG_ZAG
    -- how ramp is contrained - either by angle or distance RampingData.CONSTRAIN_DISTANCE
    -- or RampingData.CONSTRAIN_ANGLE
    ramping_data.RampConstraint = RampingData.CONSTRAIN_ANGLE
    -- if we are constraining ramp by distance, distance to ramp over
    ramping_data.RampDistance = 100.0
    -- if we are contraining ramp by angle , angle to ramp in at (in degrees)
    ramping_data.RampAngle = 25.0
    -- if we are contraining ramp by angle, max distance to travel before 'zig zaging'
    -- if zig zaging
    ramping_data.RampMaxAngleDist = 15
    -- if true we restrict our ramping to lead in section of toolpath
    ramping_data.RampOnLeadIn = false
    -- Create object used to control lead in/out
    local lead_in_out_data = LeadInOutData()
    -- if true we create lead ins on profiles (not for profile on)
    lead_in_out_data.DoLeadIn = false
    -- if true we create lead outs on profiles (not for profile on)
    lead_in_out_data.DoLeadOut = false
    -- type of leads to create LeadInOutData.LINEAR_LEAD or LeadInOutData.CIRCULAR_LEAD
    lead_in_out_data.LeadType = LeadInOutData.CIRCULAR_LEAD
    -- length of lead to create
    lead_in_out_data.LeadLength = 10.0
    -- Angle for linear leads
    lead_in_out_data.LinearLeadAngle = 45
    -- Radius for circular arc leads
    lead_in_out_data.CirularLeadRadius = 5.0
    -- distance to 'overcut' (travel past start point) when profiling
    lead_in_out_data.OvercutDistance = 0.0
    -- Create object which can be used to automatically select geometry
    local geometry_selector = GeometrySelector()
    -- if this is true we create 2d toolpaths previews in 2d view, if false we dont
    local create_2d_previews = true
    -- if this is true we will display errors and warning to the user
    local display_warnings = true
    -- Create our toolpath
    local toolpath_manager = ToolpathManager()
    local toolpath_id = toolpath_manager:CreateProfilingToolpath(name, tool, profile_data, ramping_data, lead_in_out_data, pos_data, geometry_selector, create_2d_previews, display_warnings )
    if toolpath_id == nil then
      DisplayMessageBox("Error creating toolpath")
      return false
    end
    return true
end -- end function

CreatePocketingToolpath

TopOfPage.png
function CreatePocketingToolpath(name, start_depth, cut_depth, tool_dia, tool_stepdown, tool_stepover_percent, tool_in_mm)
  -- Create tool we will use to machine vectors
    local tool = Tool("Lua End Mill",Tool.END_MILL) -- BALL_NOSE, END_MILL, VBIT
    tool.InMM = tool_in_mm
    tool.ToolDia = tool_dia
    tool.Stepdown = tool_stepdown
    tool.Stepover = tool_dia * (tool_stepover_percent / 100)
    tool.RateUnits = Tool.MM_SEC -- MM_SEC, MM_MIN, METRES_MIN, INCHES_SEC,...
    tool.FeedRate = 30
    tool.PlungeRate = 10
    tool.SpindleSpeed = 20000
    tool.ToolNumber = 1
    tool.VBit_Angle = 90.0 -- used for vbit only
    tool.ClearStepover = tool_dia * (tool_stepover_percent / 100) -- used for vbit only
    -- Create object used to set home position and safez gap above material surface
    local pos_data = ToolpathPosData()
    pos_data:SetHomePosition(0, 0, 1.0)
    pos_data.SafeZGap = 5.0
    -- Create object used to pass pocketing options
    local pocket_data = PocketParameterData()
    -- start depth for toolpath
    pocket_data.StartDepth = start_depth
    -- cut depth for toolpath this is depth below start depth
    pocket_data.CutDepth = cut_depth
    -- direction of cut for offet clearance - ProfileParameterData.CLIMB_DIRECTION or
    -- ProfileParameterData.CONVENTIONAL_DIRECTION - NOTE: enum from ProfileParameterData
    pocket_data.CutDirection = ProfileParameterData.CLIMB_DIRECTION
    -- Allowance to leave on when machining
    pocket_data.Allowance = 0.0
    -- if true use raster clearance strategy , else use offset area clearance
    pocket_data.DoRasterClearance = true
    -- angle for raster if using raster clearance
    pocket_data.RasterAngle = 0
    -- type of profile pass to perform PocketParameterData.PROFILE_NONE ,
    -- PocketParameterData.PROFILE_FIRST orPocketParameterData.PROFILE_LAST
    pocket_data.ProfilePassType = PocketParameterData.PROFILE_LAST
    -- if true we ramp into pockets (always zig-zag)
    pocket_data.DoRamping = false
    -- if ramping, distance to ramp over
    pocket_data.RampDistance = 10.0
    -- if true in Aspire, project toolpath onto composite model
    pocket_data.ProjectToolpath = false
    -- Create object which can be used to automatically select geometry
    local geometry_selector = GeometrySelector()
    -- if this is true we create 2d toolpaths previews in 2d view, if false we dont
    local create_2d_previews = true
    -- if this is true we will display errors and warning to the user
    local display_warnings = true
    -- if we are doing two tool pocketing define tool to use for area clearance
    local area_clear_tool = nill
    -- we just create a tool twice as large for testing here
    area_clear_tool = Tool("Lua Clearance End Mill", Tool.END_MILL) -- BALL_NOSE, END_MILL, VBIT
    area_clear_tool.InMM = tool_in_mm
    area_clear_tool.ToolDia = tool_dia * 2
    area_clear_tool.Stepdown = tool_stepdown * 2
    area_clear_tool.Stepover = tool_dia * 2 *(tool_stepover_percent / 100)
    area_clear_tool.RateUnits = Tool.MM_SEC -- MM_SEC, MM_MIN, METRES_MIN, INCHES_SEC..
    area_clear_tool.FeedRate = 30
    area_clear_tool.PlungeRate = 10
    area_clear_tool.SpindleSpeed = 20000
    area_clear_tool.ToolNumber = 1
    area_clear_tool.VBit_Angle = 90.0 -- used for vbit only
    area_clear_tool.ClearStepover = tool_dia*2*(tool_stepover_percent/100) -- used for vbit
  -- Create our toolpath
    local toolpath_manager = ToolpathManager()
    local toolpath_id = toolpath_manager:CreatePocketingToolpath(name,tool,area_clear_tool,pocket_data,pos_data,geometry_selector,create_2d_previews,display_warnings)
    if toolpath_id == nill then
      DisplayMessageBox("Error creating toolpath")
      return false
    end
    return true
end -- end function

CreateDrillingToolpath

TopOfPage.png
function CreateDrillingToolpath(name, start_depth, cut_depth, retract_gap, tool_dia, tool_stepdown, tool_in_mm)
  -- Create tool we will use to machine vectors
    local tool = Tool("Lua Drill", Tool.THROUGH_DRILL) -- BALL_NOSE, END_MILL, VBIT, THROUGH_DRILL
    tool.InMM = tool_in_mm
    tool.ToolDia = tool_dia
    tool.Stepdown = tool_stepdown
    tool.Stepover = tool_dia * 0.25
    tool.RateUnits = Tool.MM_SEC -- MM_SEC, MM_MIN, METRES_MIN, INCHES_SEC, INCHES_MIN, FEET_MIN
    tool.FeedRate = 30
    tool.PlungeRate = 10
    tool.SpindleSpeed = 20000
    tool.ToolNumber = 1
    tool.VBit_Angle = 90.0 -- used for vbit only
    tool.ClearStepover = tool_dia * 0.5 -- used for vbit only
    -- Create object used to set home position and safez gap above material surface
    local pos_data = ToolpathPosData()
    pos_data:SetHomePosition(0, 0, 1.0)
    pos_data.SafeZGap = 5.0
    -- Create object used to pass profile options
    local drill_data = DrillParameterData()
    -- start depth for toolpath
    drill_data.StartDepth = start_depth
    -- cut depth for toolpath this is depth below start depth
    drill_data.CutDepth = cut_depth
    -- if true perform peck drilling
    drill_data.DoPeckDrill = retract_gap > 0.0
    -- distance to retract above surface when peck drilling
    drill_data.PeckRetractGap = retract_gap
    -- if true in Aspire, project toolpath onto composite model
    drill_data.ProjectToolpath = false
    -- Create object which can be used to automatically select geometry
    local geometry_selector = GeometrySelector()
    -- if this is true we create 2d toolpaths previews in 2d view,
    -- if false we dont
    local create_2d_previews = true
    -- if this is true we will display errors and warning to the user
    local display_warnings = true
    -- Create our toolpath
    local toolpath_manager = ToolpathManager()
    local toolpath_id = toolpath_manager:CreateDrillingToolpath(name,tool,drill_data,pos_data,geometry_selector,create_2d_previews,display_warnings)
    if toolpath_id == nil then
      DisplayMessageBox("Error creating toolpath")
      return false
    end
    return true
end -- end function

CreateVCarvingToolpath

TopOfPage.png
function CreateVCarvingToolpath(name, start_depth, flat_depth, vbit_angle, vbit_dia, vbit_stepdown, tool_stepover_percent, tool_in_mm)
    --[[ -------------- CreateVCarvingToolpath --------------
    |
    | Create a VCarving toolpath within the program for the currently selected vectors
    | Parameters:
    | name, -- Name for toolpath
    | start_depth -- Start depth for toolpath below surface of material
    | flat_depth -- flat depth - if 0.0 assume not doing flat bottom
    | vbit_angle -- angle of vbit to use
    | vbit_dia -- diameter of VBit to use
    | vbit_stepdown -- stepdown for tool
    | tool_stepover_percent - percentage stepover for tool
    | tool_in_mm -- true if tool size and stepdown are in mm
    |
    | Return Values:
    | true if toolpath created OK else false
    |
  ]]
  -- Create tool we will use to machine vectors
    local tool = Tool("Lua VBit",Tool.VBIT )-- BALL_NOSE, END_MILL, VBIT
    tool.InMM = tool_in_mm
    tool.ToolDia = vbit_dia
    tool.Stepdown = vbit_stepdown
    tool.Stepover = vbit_dia * (tool_stepover_percent / 100)
    tool.RateUnits = Tool.MM_SEC -- MM_SEC, MM_MIN, METRES_MIN, INCHES_SEC, INCHES_MIN, FEET_MIN
    tool.FeedRate = 30
    tool.PlungeRate = 10
    tool.SpindleSpeed = 20000
    tool.ToolNumber = 1
    tool.VBit_Angle = 90.0 -- used for vbit only
    tool.ClearStepover = vbit_dia * (tool_stepover_percent / 100) * 2 -- used for vbit only
    -- Create object used to set home position and safez gap above material surface
    local pos_data = ToolpathPosData()    
    vcarve_data:SetHomePosition(Milling.HomeX, Milling.HomeY, Milling.HomeZGap ) -- vcarve_data:SetHomePosition(0, 0, 1.0)
    vcarve_data.SafeZGap = Milling.SafeZGap -- vcarve_data.SafeZGap = 0.5
    local vcarve_data = VCarveParameterData() -- Create object used to pass pocketing options - used for area clearance only
    vcarve_data.StartDepth = start_depth    -- start depth for toolpath
    vcarve_data.DoFlatBottom = flat_depth > 0.0    -- flag indicating if we are creating a flat bottomed toolpath
    vcarve_data.FlatDepth = flat_depth    -- cut depth for toolpath this is depth below start depth
    vcarve_data.ProjectToolpath = false    -- if true in Aspire, project toolpath onto composite model
    vcarve_data.UseAreaClearTool = true    -- set flag indicating we are using flat tool
    local pocket_data = PocketParameterData()    -- Create object used to pass pocketing options - used for area clearance only
    pocket_data.StartDepth = start_depth    -- start depth for toolpath
    pocket_data.CutDepth = flat_depth    -- cut depth for toolpath this is depth below start depth
    pocket_data.CutDirection = ProfileParameterData.CLIMB_DIRECTION    -- direction of cut for offet clearance - ProfileParameterData.CLIMB_DIRECTION or ProfileParameterData.CONVENTIONAL_DIRECTION - NOTE: enum from ProfileParameterData

    -- if true use raster clearance strategy , else use offset area clearance
    pocket_data.DoRasterClearance = false
    -- set flag indicating we are using flat tool
    pocket_data.UseAreaClearTool = true
    -- angle for raster if using raster clearance
    pocket_data.RasterAngle = 0
    -- type of profile pass to perform PocketParameterData.PROFILE_NONE ,
    -- PocketParameterData.PROFILE_FIRST orPocketParameterData.PROFILE_LAST
    pocket_data.ProfilePassType = PocketParameterData.PROFILE_LAST
    -- if this is true we create 2d toolpaths previews in 2d view, if false we dont
    local create_2d_previews = true
    -- if this is true we will display errors and warning to the user
    local display_warnings = true
    -- if we are doing two tool pocketing define tool to use for area clearance
    local area_clear_tool = nil
    -- we just create a 10mm end mill
    area_clear_tool = Tool("Lua Clearance End Mill",Tool.END_MILL) -- BALL_NOSE, END_MILL, VBIT
    area_clear_tool.InMM = true
    area_clear_tool.ToolDia = 10
    area_clear_tool.Stepdown = 3
    area_clear_tool.Stepover = 3
    area_clear_tool.RateUnits = Tool.MM_SEC -- MM_SEC, MM_MIN, METRES_MIN, INCHES_SEC, INCHES_MIN, FEET_MIN
    area_clear_tool.FeedRate = 30
    area_clear_tool.PlungeRate = 10
    area_clear_tool.SpindleSpeed = 20000
    area_clear_tool.ToolNumber = 2
    local geometry_selector = GeometrySelector()    -- Create object which can be used to automatically select geometry
    -- Create our toolpath
    local toolpath_manager = ToolpathManager()
    local toolpath_id = toolpath_manager:CreateVCarvingToolpath(name,tool, area_clear_tool,vcarve_data, pocket_data,pos_data,geometry_selector, create_2d_previews,display_warnings)
    if toolpath_id == nil then
      DisplayMessageBox("Error creating toolpath")
      return false
    end
    return true
end -- end function

CreatePrismToolpath

TopOfPage.png
function CreatePrismToolpath(name, start_depth, cut_depth, vbit_angle, vbit_dia, vbit_stepdown, tool_stepover_percent, tool_in_mm)
  --[[ ------------------- CreatePrismToolpath -------------------
  |
  | Create a prism toolpath within the program for the currently selected vectors
  | Parameters:
  | name, -- Name for toolpath
  | start_depth -- Start depth for toolpath below surface of material
  | cut_depth -- cut depth for drilling toolpath
  | vbit_angle -- angle of vbit to use
  | vbit_dia -- diameter of VBit to use
  | vbit_stepdown -- stepdown for tool
  | tool_stepover_percent - percentage stepover for tool
  | tool_in_mm -- true if tool size and stepdown are in mm
  |
  | Return Values:
  | true if toolpath created OK else false
  |
  ]]
    -- Create tool we will use to machine vectors
    local tool = Tool("Lua VBit", Tool.VBIT ) -- BALL_NOSE, END_MILL, VBIT
    tool.InMM = tool_in_mm
    tool.ToolDia = vbit_dia
    tool.Stepdown = vbit_stepdown
    tool.Stepover = vbit_dia * (tool_stepover_percent / 100)
    tool.RateUnits = Tool.MM_SEC -- MM_SEC, MM_MIN, METRES_MIN, INCHES_SEC, INCHES_MIN, FEET_MIN
    tool.FeedRate = 30
    tool.PlungeRate = 10
    tool.SpindleSpeed = 20000
    tool.ToolNumber = 1
    tool.VBit_Angle = 90.0 -- used for vbit only
    tool.ClearStepover = vbit_dia * (tool_stepover_percent / 100) * 2 -- used for vbit only
    -- Create object used to set home position and safez gap above material surface
    local pos_data = ToolpathPosData()
    pos_data:SetHomePosition(0, 0, 1.0)
    pos_data.SafeZGap = 5.0
    -- Create object used to pass profile options
    local prism_data = PrismCarveParameterData()
    -- start depth for toolpath
    prism_data.StartDepth = start_depth
    -- cut depth for toolpath this is depth below start depth
    prism_data.CutDepth = cut_depth
    -- direction of cut for offet clearance - ProfileParameterData.CLIMB_DIRECTION
    -- or ProfileParameterData.CONVENTIONAL_DIRECTION - NOTE: enum from ProfileParameterData
    prism_data.CutDirection = ProfileParameterData.CLIMB_DIRECTION
    -- calculate the minimum cut depth to fully form the bevel on the current
    -- selection with the current tool
    local min_bevel_depth = prism_data:CalculateMinimumBevelDepth(tool, true)
    if min_bevel_depth > cut_depth then
      DisplayMessageBox("A prism will not be fully formed with a depth of " .. cut_depth .. "\r\n" ..
                        "A depth of " .. min_bevel_depth .. " is required to fully form the prism")
    end -- if end
    -- Create object which can be used to automatically select geometry
    local geometry_selector = GeometrySelector()
    -- if this is true we create 2d toolpaths previews in 2d view, if false we dont
    local create_2d_previews = true
    -- if this is true we will display errors and warning to the user
    local display_warnings = true
    -- Create our toolpath
    local toolpath_manager = ToolpathManager()
    local toolpath_id = toolpath_manager:CreatePrismCarvingToolpath(name, tool, prism_data, pos_data, geometry_selector, create_2d_previews, display_warnings)
    if toolpath_id == nil then
      DisplayMessageBox("Error creating toolpath")
      return false
    end -- if end
    return true
end -- end function

CreateFlutingToolpath

TopOfPage.png
function CreateFlutingToolpath(name, start_depth, cut_depth, tool_dia, tool_stepdown, tool_in_mm)
    --[[ ----------------- CreateFlutingToolpath -----------------
  | Create a flutting toolpath within the program for the currently selected vectors
  | Parameters:
  | name, -- Name for toolpath
  | start_depth -- Start depth for toolpath below surface of material
  | cut_depth -- cut depth for toolpath
  | tool_dia -- diameter of tool to use
  | tool_stepdown -- stepdown for tool
  | tool_in_mm -- true if tool size and stepdown are in mm
  |
  | Return Values:
  | true if toolpath created OK else false
  |
  ]]
    -- Create tool we will use to machine vectors
    local tool = Tool("Lua Ball Nose", Tool.BALL_NOSE) -- BALL_NOSE, END_MILL, VBIT, THROUGH_DRILL
    tool.InMM = tool_in_mm
    tool.ToolDia = tool_dia
    tool.Stepdown = tool_stepdown
    tool.Stepover = tool_dia * 0.25
    tool.RateUnits = Tool.MM_SEC -- MM_SEC, MM_MIN, METRES_MIN, INCHES_SEC, INCHES_MIN, FEET_MIN
    tool.FeedRate = 30
    tool.PlungeRate = 10
    tool.SpindleSpeed = 20000
    tool.ToolNumber = 1
    tool.VBit_Angle = 90.0 -- used for vbit only
    tool.ClearStepover = tool_dia * 0.5 -- used for vbit only
    -- Create object used to set home position and safez gap above material surface
    local pos_data = ToolpathPosData()
    pos_data:SetHomePosition(0, 0, 1.0)
    pos_data.SafeZGap = 5.0
    -- Create object used to pass fluting options
    local fluting_data = FlutingParameterData()
    -- start depth for toolpath
    fluting_data.StartDepth = start_depth
    -- cut depth for toolpath this is depth below start depth
    fluting_data.CutDepth = cut_depth
    -- type of fluting FULL_LENGTH, RAMP_START or RAMP_START_END
    fluting_data.FluteType = FlutingParameterData.RAMP_START_END
    -- type of ramping RAMP_LINEAR, RAMP_SMOOTH
    fluting_data.RampType = FlutingParameterData.RAMP_LINEAR
    -- if true use ratio field for controling ramp length else absolute length value
    fluting_data.UseRampRatio = false
    -- length of ramp as ratio of flute length(range 0 - 1.0)
    -- (for start and end - ratio is of half length)
    fluting_data.RampRatio = 0.2
    -- length to ramp over - if UseRampRatio == false
    fluting_data.RampLength = 15
    -- if true in Aspire, project toolpath onto composite model
    fluting_data.ProjectToolpath = false
    -- Create object which can be used to automatically select geometry
    local geometry_selector = GeometrySelector()
    -- if this is true we create 2d toolpaths previews in 2d view, if false we dont
    local create_2d_previews = true
    -- if this is true we will display errors and warning to the user
    local display_warnings = true
    -- Create our toolpath
    local toolpath_manager = ToolpathManager()
    local toolpath_id = toolpath_manager:CreateFlutingToolpath(name, tool, fluting_data, pos_data, geometry_selector, create_2d_previews, display_warnings)
    if toolpath_id == nil then
      DisplayMessageBox("Error creating toolpath")
      return false
    else
      return true
    end

    end -- end function

SelectVectorsOnLayer

TopOfPage.png
function SelectVectorsOnLayer(layer, selection, select_closed, select_open, select_groups)
    -- Please Note: SelectVectorsOnLayer is provided by Vectric and can be found in the SDK and Sample Gadget files.
    --[[  ---------------- SelectVectorsOnLayer ----------------
    -- |   SelectVectorsOnLayer("Stringer Profile", selection, true, falus, falus)
    -- |   Add all the vectors on the layer to the selection
    -- |     layer,            -- layer we are selecting vectors on
    -- |     selection         -- selection object
    -- |     select_closed     -- if true  select closed objects
    -- |     select_open       -- if true  select open objects
    -- |     select_groups     -- if true select grouped vectors (irrespective of open / closed state of member objects)
    -- |  Return Values:
    -- |     true if selected one or more vectors|
    --]]
    local objects_selected = false
    local warning_displayed = false
    local pos = layer:GetHeadPosition()
    while pos ~= nil do
      local object
      object, pos = layer:GetNext(pos)
      local contour = object:GetContour()
      if contour == nil then
        if (object.ClassName == "vcCadObjectGroup") and select_groups then
          selection:Add(object, true, true)
          objects_selected = true
        else
          if not warning_displayed then
            local message = "Object(s) without contour information found on layer - ignoring"
            if not select_groups then
              message = message ..  "\r\n\r\n" ..
              "If layer contains grouped vectors these must be ungrouped for this script"
            end -- if end
            DisplayMessageBox(message)
            warning_displayed = true
          end -- if end
        end -- if end
      else  -- contour was NOT nil, test if Open or Closed
        if contour.IsOpen and select_open then
          selection:Add(object, true, true)
          objects_selected = true
        elseif select_closed then
          selection:Add(object, true, true)
          objects_selected = true
        end -- if end
      end -- if end
    end -- while end
    -- to avoid excessive redrawing etc we added vectors to the selection in 'batch' mode
    -- tell selection we have now finished updating
    if objects_selected then
      selection:GroupSelectionFinished()
    end -- if end
    return objects_selected
  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