https://jimandi.com/SDK/index.php?action=history&feed=atom&title=CadObjectListCadObjectList - Revision history2026-10-25T11:57:27ZRevision history for this page on the wikiMediaWiki 1.39.2https://jimandi.com/SDK/index.php?title=CadObjectList&diff=36&oldid=prevWikiSysop: Created page with " link=High Level Objects Category:SDK This object holds a list of CadObjects Constructor CadObjectList(bool owns_objects) Creates a n..."2021-08-04T02:42:37Z<p>Created page with " <a href="/SDK/index.php/File:Back.jpg" title="File:Back.jpg">right|50px|link=High Level Objects</a> <a href="/SDK/index.php?title=Category:SDK&action=edit&redlink=1" class="new" title="Category:SDK (page does not exist)">Category:SDK</a> This object holds a list of CadObjects Constructor CadObjectList(bool owns_objects) Creates a n..."</p>
<p><b>New page</b></p><div> [[File:Back.jpg|right|50px|link=High Level Objects]]<br />
[[Category:SDK]]<br />
This object holds a list of CadObjects <br />
<br />
Constructor <br />
<br />
CadObjectList(bool owns_objects) <br />
<br />
Creates a new CadObjectList owns_objects -bool – true if this list owns the objects it contains. If this is true and the list still contains objects when it goes out of scope the objects will be deleted. <br />
<br />
<br />
<br />
== Properties ==<br />
<br />
----<br />
=== .Count ===<br />
<br />
Read Only - integer – return the number of objects in the list <br />
<br />
<br />
<br />
----<br />
=== .IsEmpty ===<br />
<br />
Read Only - bool – return true if the list is empty <br />
<br />
<br />
<br />
== Methods == <br />
<br />
----<br />
=== :AddHead( CadObject obj) ===<br />
<br />
Add the passed object to the front of the list <br />
<br />
::''obj –CadObject –object to put in list ''<br />
<br />
<br />
<br />
----<br />
=== :AddTail( CadObject obj) ===<br />
<br />
Add the passed object to the end of the list <br />
<br />
::''obj –CadObject –object to put in list ''<br />
<br />
<br />
<br />
----<br />
=== :CanTransform( integer flags) ===<br />
<br />
Return true if object can be transformed <br />
<br />
::''flags –integer –value indicating type of transform – these can be combined e.g 3 (1+2) will check for both Move and Rotate'' <br />
<nowiki><br />
1 = Move <br />
2 = Rotate <br />
4 = Mirror <br />
8 = Scale Symetric <br />
16 = Scale Asymetric </nowiki><br />
<br />
<br />
<br />
----<br />
=== :GetAt( POSITION pos) ===<br />
<br />
Returns the object at the current position <br />
<br />
::''pos – POSITION – current position in list ''<br />
<br />
<br />
<br />
----<br />
=== :GetHeadPosition() ===<br />
<br />
Returns a POSITION variable to allow access to the head of the list <br />
<br />
<br />
<br />
----<br />
=== :GetNext( POSITION pos) ===<br />
<br />
Returns the object at the current position AND a new value for position pointing to the next item in the list (or nil if at end of list) <br />
<br />
::''pos – POSITION – current position in list ''<br />
<br />
::''note that GetNext(pos) is returning two values ... ''<br />
<br />
==== Usage Syntax: =====<br />
<nowiki><br />
local pos = obj_list:GetHeadPosition() <br />
local object <br />
while pos ~= nil do<br />
object, pos = obj_list:GetNext(pos)<br />
DO SOMETHING WITH OBJECT .... <br />
end -- while end </nowiki><br />
<br />
<br />
----<br />
=== :GetPrev( POSITION pos) ===<br />
<br />
Returns the object at the current position AND a new value for position, pointing to the previous item in the list (or nil if at start of list) <br />
<br />
::''pos – POSITION – current position in list ''<br />
<br />
<br />
<br />
----<br />
=== :GetTailPosition() ===<br />
<br />
Returns a POSITION variable to allow access to the tail (end) of the list <br />
<br />
<br />
<br />
----<br />
=== :RemoveHead() ===<br />
<br />
Remove the id at the front of the list and return it <br />
<br />
<br />
<br />
----<br />
=== :RemoveTail() ===<br />
<br />
Remove the id at the end of the list and return it <br />
<br />
<br />
----<br />
=== :Transform( Matrix2D xform) === <br />
<br />
Transform all objects in list by passed transform <br />
<br />
::''xform – Matrix2D – transformation matrix to apply to objects ''<br />
<br />
<br />
<br />
[[File:Back.jpg|right|50px|link=High Level Objects]]<br />
==References==<br />
'''Please Note:''' The base material for the contents found in this WiKi was sourced from Vectric Lua Interface for Gadgets, version 2.05, published September 12, 2018. by Vectric Ltd. Most current document from Vertric can be downloaded at [https://gadgets.vectric.com/developerinfo.html Vertric Developer Information]</div>WikiSysop