Share

Primitive list

[Desktop Automation]

This object provides access to the primitive generators as they are available in the part library. It is created by the system method createprimitivelist().

Important: Generating this list first before running the actual generator of choice is always required even when a generator of just one type is to be used. Once generated, it may be used for multiple primitive generators of same or different type.

Properties

Property Read/write Type Description
Count read-only Number Number of primitive generators in the list

Back to top

Methods

Name Syntax Description
createprimitive primitivelist:createprimitive(name:string) Creates a primitive generator specified by identifier. Case-sensitive.
createprimitivebyindex primitivelist:createprimitivebyindex(index:number) Creates a primitive generator by index of the list
getname primitivelist:getname(index:number) Gets the identifier of primitive generator at given index of the list. Returns a string.

Back to top

Examples

List available primitive generators and their parameters

myprimlist = system:createprimitivelist()
mytext = system:createtextfile()

for i=0, myprimlist.count-1, 1 do
  local mylistitem = myprimlist:getname(i)

  mytext:writeline(mylistitem)

  local myprim = myprimlist:createprimitivebyindex(i)

  for j=0, myprim.settingcount-1, 1 do
    local mysettingitem = myprim:getsettingname(j)
    local mysettingvalue = myprim:getsettingvalue(j)
    mytext:writeline("- " .. mysettingitem .. " " .. mysettingvalue)
  end

  mytext:writeline("")
end

mytext:savetofile("C:\\primlist.txt")

Excerpt:

box
- name Box
- color 8421504
- sizex 100
- sizey 100
- sizez 100
- boxtype 0
- wallthickness 10
- trianglelength 50

Back to top

Was this information helpful?