Want to harness the power of custom programming to save your company countless hours of repetitive work?
If there is a specific task that you wish to automate using custom programming, feel free to contact me to hire my services. Want to know what you're missing out on? Read the testimonials of those who have worked with me and my programs.
Make AutoCAD work for you by using custom programming to automate many repetitive tasks.
This site is primarily aimed towards utilising the AutoLISP & Visual LISP APIs to create custom programs which may be run within full versions of AutoCAD (not LT versions) and many of its derivative programs.
In addition to my custom programming services, I offer a plethora of free LISP programs available for you to download, covering a huge range of applications: from text manipulation to attribute extraction and everything inbetween.
The Tutorials page also offers an insight into how you can learn to create your own AutoLISP programs and quickly increase your AutoCAD efficiency and productivity.
Whether you are a complete beginner or perhaps more experienced, I have no doubt that you can benefit from the help & resources available here.
AutoLISP is a dialect of the LISP programming language engineered to enable manipulation & customisation of AutoCAD and many of its derivative programs such as Civil 3D, MEP, Architecture, Electrical etc. AutoLISP is restricted to running on full versions of AutoCAD and cannot be run in any version of AutoCAD LT. Other applications such as Bricscad and IntelliCAD also offer the ability to run AutoLISP programs.
Visual LISP is an extension of AutoLISP introduced as an add-on to AutoCAD R14, and subsequently fully incorporated into the release of AutoCAD 2000. Visual LISP provides access to the ActiveX/COM and offers many advanced functions to aid with customisation.
Not sure how to run a program? Be sure to see my tutorial on Running an AutoLISP Program.
I have updated my Remove Support File Search Paths function as part of my set of Add & Remove Support File Search Paths functions to allow users to remove paths containing forward-slash path delimiters and with trailing path delimiters. The code has also been condensed for efficiency & readability.
New Program! Layer Prefix/Suffix allows the user to apply or remove a prefix and/or suffix to all layers found in a selection of objects.
I have updated my LM:intersections function as part of my set of Intersection Functions to validate the applicability of the ActiveX intersectwith method on the two supplied vla-objects prior to invoking this method. The function will therefore gracefully return nil if either of the supplied objects do not support this method.
I have updated my Delete Blocks program to Version 1.1. This update alters the program operation to allow the user to select a block to be deleted from the drawing, with the option of selecting a block by name (using the dialog displayed by the previous version of the program) available upon the user typing N at the selection prompt. The dialog interface has also been enhanced to include an edit box, allowing the user to filter the displayed list of block names.
I have updated my List Box with Filter function to Version 1.1. This version fixes a bug arising when the user selects multiple items, applies a filter which excludes one or more of the selected items, and then accepts the resulting selection.
Following valuable feedback from a user, I have updated my Incremental Array application to Version 1.8. This revision fixes a bug causing the program to crash if parentheses or double-quotes were found in the text content.
My Update Titleblock Attributes program has been revised to Version 1.9. This version fixes the implementation of the block filter parameter when processing attributed dynamic blocks (Version 1.8 would ignore the block filter when processing such blocks).
Following valuable feedback received from a member of the CADTutor forums, I have now updated my Viewport Outline program to Version 1.1. The updated code now accounts for polygonal viewports represented by 2D (Heavy) Polylines (this can arise when rotating a rectangular viewport, for example).
New Program: Limited Length Polyline allows the user to dynamically construct a straight-segmented polyline whose overall length may optionally be limited to a given value. The program uses my GrText and GrSnap functions to allow the polyline to be accurately constructed with the length displayed in real-time at the cursor.
Following user feedback for the previous version, I now have updated my Selection Counter utility to Version 1.4. This new version ensures that the selection count for selected objects following grip-editing operations is retained, and corrects the reported selection count for non-rectangular viewports (which were previously counted as two objects).
I have updated my Selection Counter utility to Version 1.3 to account for the use of the standard QSELECT and SELECTSIMILAR AutoCAD commands and display the number of selected objects accordingly.
As promised below, I have now updated the page for my Background Mask application to include detailed instructions describing how to create your own custom background mask programs which bypass the main program dialog to apply predefined background mask properties to all objects in a selection.
I have again updated my Background Mask application to Version 1.3 to include a dedicated selection function to facilitate the creation of custom background mask programs which bypass the main program dialog. I will also soon update the program description to include instructions on how to create such programs.
I have updated my Background Mask application to Version 1.2. The new version has been entirely restructured and now provides dedicated functions to allow the user to bypass the main program dialog if desired. The program also now enables the user to manipulate the background mask for dimensions.
I have tweaked my recently updated Layer Director application to account for the use of the legacy CLASSICXREF command.
Following an excellent suggestion received from an avid user of my programs, I have updated my Layer Director utility to Version 1.5. This new version incorporates the option to enable an 'xref-dependent' layer assignment, causing external references to be automatically inserted on a layer whose name matches that of the inserted xref, with an optional prefix & suffix, and fully-configurable layer properties.
My Segment Curve program has now been entirely rewritten and updated to Version 1.1. In rewriting the application, I have improved the error handling, program performance and code readability, paving the way for possible future enhancements.
I have updated my Quick Field utility to invoke the AutoCAD UPDATEFIELD command when inserting a new field expression into the content of a selected attribute reference, as the use of such command or a drawing regeneration is required in order to display the value of new fields within attributes.
Upon receiving a report by a reader of my site that my MD5 Cryptographic Hash Function was returning results which were inconsistent with other online MD5 hash generators for some input data, I ascertained that the results were indeed incorrect for input data longer than 56 bytes (i.e. 56 characters). I determined that the cause of this issue was due to the arithmetic operations that are performed on the 4 32-bit hash values after processing each 512-bit chunk of input data not being wrapped to a 32-bit unsigned integer (as required by the algorithm), and also that such operations could potentially be introducing rounding errors as a consequence of the use of doubles to store the 4 32-bit items of hash data. To resolve this issue, I designed a bitwise addition function so that all operations could be performed on a list of 32-bits, with no loss of precision. I have therefore updated my MD5 Cryptographic Hash Function to Version 1.1.
I have updated my Selection Counter utility to Version 1.2. This update implements an additional fail-safe to ensure that the MODEMACRO system variable is correctly reset when objects are deselected.
Since releasing the latest version of my Copy or Swap Text application yesterday, I am pleased to have received a wealth of positive feedback, and also several bug reports from avid users of the program. I have now fixed the reported bugs and have updated the program to Version 1.6. I wish to extend a huge thank you to all of my readers who were kind enough to test the program to its limit and report back with their feedback, in turn improving the application for others.
I have also updated my Copy to Drawings program to incorporate the latest version of my Get Files Dialog function (which also addresses a number of bugs), and to also refine the command-line output to report the number of successful & unsuccessful drawings processed by the program.
Finally, I have updated my Get Files Dialog function to Version 1.6 to fix a bug causing the 'Add Files' button to be incorrectly enabled when the user selected a directory.
Following valuable and encouraging user feedback, I have now updated my Copy or Swap Text application to Version 1.5. The program has been mostly rewritten in order to incorporate compatibility for all types of Dimensions, and for Multileaders with Attributed Block content.
As an academic diversion from my typical programming, I have explored the fascinating fractal nature of the Sierpinski Triangle, along with its 3D analog: the Sierpinski Tetrahedron. This brief study forms part of my selection of Mathematical Endeavours.
I have also updated my code to generate an example of Barnsley's Fern in AutoCAD, as part of my study of Iterated Function Systems. This page also demonstrates an alternative method in which to generate the Sierpinski Triangle by recursively applying one of three randomly selected transformations to a given point.
I have updated my Random in Range function as part of my Random Number Functions to accept negative integer arguments and to also permit the arguments to be supplied in any order. This function will return a pseudo-random number within the range given by the two integer arguments.
Following a suggestion from member 'Jef!' of the CADTutor forum, I have updated my Selection Set Processing tutorial to include an additional method: Method 4a: Reverse ssdel. This method demonstrates how to process a selection set by sequentially removing the entity at the (sslength - 1)th index until no entities remain in the set. I have also updated the page to include a table of contents to assist with navigation of the tutorial.
I have updated my Arrow Arc program to Version 1.2. This new version offers an additional option within the aarcsettings command to allow the user to control whether the arrowheads are created at the start point, end point, or both the start & end point of the arc.
Following user feedback, I have updated my Outline Objects program to Version 1.1. This new version will offer the user the option to erase the set of objects in the original selection.
I have updated my Area Field to Attribute program to Version 1.2. This new version no longer restricts the user to selecting a visible attribute to house the resulting Field Expression, but instead allows the user to select any attributed block and will prompt the user to choose the attribute tag to be populated with the Field Expression if the selected block contains more than one attribute. The updated program also enables the user to predetermine the attribute tag to be populated with the Field Expression using a parameter defined in the program source code. Finally, this new version also accounts for 64-bit versions of AutoCAD 2008 in which the ActiveX getobjectidstring method is not available.
I have updated my Align Text program to Version 1.4. The new version includes an additional prompt for an optional line spacing factor which offers a default option allowing the user to retain the existing spacing between the selected text objects.
I have updated my Length at Midpoint program to Version 1.1. This update implements a new version of my LM:objectid function which has been modified to account for 64-bit versions of AutoCAD 2008 in which the ActiveX getobjectidstring method is not available.
I have updated my Layer Director program to Version 1.4. The new version allows the user to cue an automatic layer change following the use of a custom AutoLISP command, and also adds the Layer Plot Style to the list of layer properties which may be configured by the program.
Following user feedback, I have updated my reactor-driven utility allowing a user to automatically select all MText content on a double-click to enable compatibility with Multileader objects, such that all MLeader text content is selected when double-clicking on an MLeader object.
For the first item of the new year, I shall share a new Polyline Taper program. This program will allow the user to apply a tapered width across all segments of a selected 2D polyline, and is compatible with polylines containing linear and/or arc segments, constructed in any UCS.
Finally, I shall take this opportunity to wish all visitors to my site a Happy New Year and all the best for a healthy & prosperous 2016!
I have updated my Dimension Overlap program to Version 1.1. In this new version, the core function which performs the overlap test has been completely rewritten in order to account for dimensions which overlap on both sides, and to also enable compatibility with dimensions created in any UCS or construction plane.
I have updated my Get Files Dialog function to Version 1.5; this minor update resolves a bug present in the filename sorting functions causing the function to error when processing file or folder names which contained a set of numbers interspersed with multiple points (e.g. "01.02.03").
As an early Christmas present, I have added a new tutorial to the site - Building Association Lists: A Simple Block Counter provides a step-by-step explanation of how to use an association list to construct a simple block counter program in AutoLISP, which will prompt the user for a selection of block references and will output the quantities of each block in the selection to the AutoCAD command-line.
Finally, I wish all of my readers a very Merry Christmas!
I have added a new Dimension Overlap program to the site. This program will automatically detect overlapping linear dimensions in all layouts and all blocks in the active drawing, moving such dimensions to a separate layer to be reviewed by the draftsman.
I have updated my set of Add & Remove Support File Search Paths functions to reduce the amount of code required for each function, improve the overall readability of the functions, and to ensure that the functions only modify the ACAD registry key if a modification is necessary.
I have rewritten my old Sum Attribute Values program and have updated the program to Version 1.1. The new version allows the user to select which attribute tags are displayed in the table, and offers the ability to use field expressions to automatically update the table totals. Constant attributes with numerical content are also now included, and the table columns are sized appropriately for the content. I have also added a new GIF demonstration to show the program in action.
I have updated my popular Incremental Numbering Suite application to Version 3.9. This relatively minor update improves the method used to determine the appropriate width for an MText object in order to account for multiple lines of text; removes the case-sensitivity of attribute tag comparison to account for applications which do not enforce uppercase attribute tags; and fixes a bug causing an oblique angle to be applied to single-line text if the current text style has an oblique angle set, but the text style selected for use does not.
I have updated my Layer Director utility to Version 1.3 - this release introduces several new features:
I have added a new program to the site: Chain Length will allow the user to calculate the total object length between two points along a chain of connected objects. Be sure to also check out my related Chain Selection program, which allows the user to automatically select all connected objects following selection of a single object in the chain.
Following feedback received from a user of my programs, I have now updated my Burst Upgraded & Nested Burst programs to enable compatibility with non-uniformly scaled blocks. There remain some restrictions when attempting to burst nested blocks which are nested within non-uniformly scaled parent blocks, however these restrictions are inherent in the way that AutoCAD handles such objects.
As an extension & generalisation of my old List Box Synchronisation tutorial, I have developed & published a new developer function to enable automatic DCL List Tile Dependency. This function automatically configures & manages a set of DCL list tiles (i.e. list_box & popup_list tiles) enabling dependency between the tiles - that is, the items displayed in a list tile will be dependent on the item selected in other list tiles.
I have updated my Quick Field utility to account for selection of existing annotation objects (Text, MText, Attributes etc.) which already contain one or more field expressions.
I have added a new Cursor Rotate program to the site. This program allows the user to rotate the AutoCAD crosshairs (SNAPANG system variable) to align with an object at a selected point, a fixed angle, or percentage representing a slope grade.
I have further developed my Automatically Label Attributes program and have updated the program to Version 1.2. The new version enables full compatibility with multileaders containing attributed block content, and the user may configure the program to renumber attributed blocks, attributed mleaders, or both. The new version also rectifies a number of bugs present in the previous version, and restructures the program code to improve readability. There is also a new GIF animation for your viewing pleasure.
I have updated my Automatically Label Attributes program to Version 1.1. The program has been completely rewritten to improve performance & stability, and the new version offers several new improvements, including the ability to match multiple block names & attribute tags using wildcard patterns, use a numbering prefix & suffix, specify a starting number, use fixed length numbering with leading zeros, and compatibility for multiline attributes.
I have updated the page for my Group List by Number function to offer developers two types of function: the function LM:group<n will group a supplied list into sublists of a maximum length; whereas the LM:group-n function will group a list into sublists of a fixed length.
I have tweaked the code for my Get Anonymous References function to allow the calling expression to supply the function with a wildcard pattern as the block name argument in order to match multiple block names.
I have added a new Multi-Polyline program to the site. This simple program enables the user to create objects with the appearance of multilines, however which are composed of standard polylines.
I have added a small reactor-driven utility to the site which causes the text content of an MText object to be automatically selected on a double-click. The idea was spawned from a question received from a visitor to my site who was looking for a consistent result when double-clicking on MText and single-line text (DText).
I have added a new Justify Block Base Point program to the General Programs section of the site. Similar to my existing Change Block Base Point program, this new program allows the user to change the base point location for multiple blocks to one of nine standard justifications.
I have updated my Incremental Numbering Suite application to Version 3.8. The new version enhances the 'Replacement Mode' option, which now allows the user to replace the text content of primary or nested text, mtext, dimensions, or multileaders containing mtext or attributed block content.
Following user feedback, I have tweaked my Block Counter program to enable full compatibility with the ZWCAD application in which the ActiveX regeneratetablesuppressed property is not implemented.
I have added a new program to the General Programs section of the site: Double Extend allows the user to extend both ends of all lines, arcs, 2D & 3D polylines in a selection by a specified amount. As demonstrated, the program will perform successfully with both 2D and 3D objects, constructed in any UCS plane.
I have updated my very old set of Polyline Programs, rewriting & consolidating the code for all three custom commands into a single program file. These simple programs allow the user to join sets of lines, arcs & polylines to form continuous polylines, close sets of open polylines, and modify the width of all segments for all polylines in a selection.
I have revised my Update Titleblock Attributes application to Version 1.8 to incorporate a number of enhancements:
I have updated my Polyline Information program to Version 1.3 to fix a bug causing the program to crash when constructing the table output for polylines containing arc segments.
Following feedback received from a frequent user of my Incremental Numbering Suite, I have updated the program to Version 3.7 to tweak the behaviour of the program dialog. The program will now set the initial focus of the dialog to the Prefix edit box tile, and the user may dismiss the program dialog at any time using the ENTER key.
I have added a new Field Objects program to the General Programs section of the site. This program enables the user to easily view the object or set of objects referenced by all field expressions held by a selected Text, MText or Attribute object.
I have updated my Ellipse to Arc program to incorporate some tolerance for the ellipse axis ratio into the selection filter in order to enable the user to select ellipses & elliptical arcs which are very close to being circular.
I have completely rewritten my Copy or Swap Text program and have up-issued the program to Version 1.4. The new version fixes a number of bugs reported from the previous version.
I have updated my Box Text program to Version 1.2. This new version allows the user to select multiple text or mtext objects, with each resulting text frame inheriting the properties of the enclosed text object.
I have performed minor updates to various pages of the site, such as Insert Nth, Intersection Functions to update the page layout, code headers & code formatting, and to include Tables of Content where appropriate.
I have updated my Get Field Objects function to ensure that the function returns the objects referenced by all field expressions held by the supplied annotation object (where previously, only objects referenced by the first field expression encountered would be returned). The function has also now been renamed to Field Objects.
I have now rewritten my Get All Files function and have renamed this function to Directory Files. The code is now cleaner & substantially more concise, and the arguments for the function have been reordered to be in line with those used by the AutoLISP vl-directory-files function. An example program is included on the program page to demonstrate how this function may be used.
I have updated my Incremental Numbering Suite application to Version 3.6. This minor update fixes a bug causing the program to crash upon selecting the 'Fixed' border option in conjunction with either a 'Rectangle' or 'Slot' border.
I have completely rewritten my set of Draw Order Functions and have up-issued the set of functions to Version 1.2. These functions now require one fewer argument and are now much cleaner & far more concise.
I have updated the Geometric Intersections section of my library of Mathematical Functions to include an alternative version of my Circle-Circle Intersection function, and a new Arc-Arc Intersection function.
First & foremost, I wish all visitors to my site a very happy New Year and all the best for 2015!
To start the new year, I have added a new program to my site: Viewport Outline. This program allows the user to automatically generate a polyline in modelspace representing the outline of a selected paperspace viewport.
I have added a new Outline Objects program to the site. This program enables the user to generate one or more closed polylines or regions representing a silhouette or outline of all objects in a selection.
I have updated my Automatic Block Break program to Version 1.7. The new version changes the method used to detect objects found at the block insertion point when determining the angle for automatic block rotation, fixing a bug causing polylines with non-zero width to be ignored.
I have updated my recently published Selection Counter utility to Version 1.1 in order to fix a bug causing the MODEMACRO system variable to not be reset when the UNDO command is used.
I have added a short & simple utility to the site which I have named Selection Counter. This reactor-driven application will silently run in the background and will automatically display the number of objects in the active selection at the AutoCAD status bar, offering an alternative to the Quick Properties functionality available in newer versions of AutoCAD.
I have updated my Flatten List function to update the code formatting in line with my other functions.
I have revised my Update Titleblock Attributes application to Version 1.7 to fix a bug causing drawings with filenames containing ASCII character 46 (point) to not be found within the first column of the CSV file.
I have updated my library of Mathematical Functions to include a vector version of my Line-Circle Intersection function as part of my Geometric Intersection Functions, and a Quadratic Solution function as part of my Arithmetic Functions.
I have added a new 2D Projection program to the site. This program provides the user with a means of projecting a selected set of planar objects from one reference frame (or projective space) to another, using a projective (or 'perspective') transformation.
I have added a new Nested Burst program to the site. This program enables the user to burst (explode whilst retaining attribute values) a selection of block references, including any nested block references found within the selected blocks, nested to any level.
I have updated my Strikethrough Text program to Version 1.1. The new version provides a generic function to allow the user to create any number of custom commands in order to generate any number of lines above, below or through selected text objects.
I have added a new Circle Tangents program to the site. This program allows the user to dynamically construct two circles connected with a pair of lines meeting the circumference of each circle at a tangent. The program also utilises my recently published GrSnap utility to enable full Object Snap functionality at each prompt.
After much delay, I have finally found some spare time to add my new GrSnap utility to the Subfunction Library section of the site. This utility was in fact written at the end of last year & provides a means of enabling the use of full Object Snap functionality within a grread loop.
Finally, I have shared yet another dynamic program which also utilises my recently published GrSnap utility: my new 3-Point Rectangle program enables the user to dynamically construct a rectangle defined by three supplied points.
I have updated my Get Files Dialog function to Version 1.4 to fix a bug causing folders with folder names containing a dot to incorrectly appear as selectable files.
I have implemented a minor update to my Dynamic Attribute Width program to cause the attribute width factor to be reset to its original value should the user right-click during the operation of the program - this behaviour is more consistent with standard AutoCAD behaviour. The program is now at Version 1.2.
I have added a new function: Evaluate Once on Startup to the Subfunction Library section of the site. This function provides the facility for a supplied expression to be evaluated only once on the next drawing startup, and not subsequently.
I have updated my Areas to Field program to Version 1.3. This new version of the program will populate the contents of an AutoCAD table cell with the appropriate field expression if the point specified by the user is found to reside within a table cell.
I have updated my Copy to XRef program to Version 1.2 to account for cases in which the XLOADCTL system variable is equal to 1, and also provide more detailed feedback to the user should the program fail to interface with the source drawing of the selected xref.
My Dynamic Attribute Width program has been updated to Version 1.1. The 'Reset' option in the new version will now reset the width factor of the selected attribute to that of its associated attribute definition, rather than always resetting the factor to 1.0.
I have entirely rewritten my oldest & most popular block counting application: Count Version 1.4 should now be fully compatible with all full versions of AutoCAD (including 2015) running on both 32-bit & 64-bit Windows operating systems. The new version also offers an enhanced settings dialog, allowing the user to configure several additional parameters which were not available in the previous version.
I have also updated my Layer Director program to Version 1.2. The new version will allow the user to specify basic layer properties to be applied to layers which are automatically created by the program. I have also changed the loading method to use the post-initialisation s::startup function and have restructured the code used to construct the Visual LISP Command Reactor to hopefully resolve some reported issues in which the application was not automatically enabled for some drawing files.
I have updated my Polyline Information program to Version 1.2 to fix a bug causing the final polyline segment to be omitted from output data when processing closed polylines.
I have added a new program to the site: Dynamic Attribute Width will allow the user to dynamically alter the width factor of a selected attribute, with a real-time preview as the cursor is moved relative to the attribute.
I have updated my Incremental Array program to Version 1.7. This version fixes accumulated rounding errors appearing at item 44 onwards when incrementing a value of 1 by an increment of 1.
My Reset XRef Layers program has been rewritten and the code updated to Version 1.2. The new version now also accounts for layers whose colour property has been assigned a True Colour or Colour Book colour.
I have updated my Incremental Numbering Suite program to Version 3.5 to fix a reported intermittent bug causing the program to crash when generating the first object after dimissing the program dialog with Dynamic Mode enabled.
Following the recent release of my heavily updated Incremental Array program, I have revised this program to Version 1.6 to correct a few minor bugs reported by Swamp user CAB.
I have completely rewritten my old Incremental Array program, and have updated the code to Version 1.5. This new version incorporates a more advanced incrementing engine similar to that used by my Incremental Numbering Suite application, and also allows the user to specify an increment value.
My most popular and most extensively developed program, Incremental Numbering Suite has now been updated to Version 3.4. This new version fixes a number of bugs present in the previous version following bug reports submitted by numerous users which have accumulated since the release of Version 3.3 almost two years ago. For information detailing the changes to the program in this new version, please see the version history section of the program code header.
I am honoured to announce that I have been nominated to become a member of the prestigious Autodesk Expert Elite program!
I have updated my Error Message Troubleshooter page to include several additional error messages and their accompanying explanations and possible causes.
I have updated my Burst Upgraded program to Version 1.2. The new version of the program has been restructured to accept a selection set argument, allowing the program to be called from other custom programs; the program will also now explode non-attributed blocks, rather than restricting the selection to only those with attributes.
I have added a new developer utility function to the site: Print List is a relatively simple (but incredibly useful) function to assist with the understanding of the structure of a given list. The function will print a supplied list to the command-line or file, with nested lists displayed in a hierarchical format so that the list structure is revealed.
New program: Modelspace to Paperspace added to the site. Similar to the standard CHSPACE command, this program allows the user to copy a selection of objects from Modelspace to the current Paperspace layout, through an active viewport.
I have updated my tutorial: An Introduction to Script Writing to include more detailed explanations & examples. This tutorial is a basic explanation of how to write & run your very first AutoCAD Script.
My Nested Block Counter has been updated to Version 1.5. The new version fixes a couple of bugs arising when counting nested dynamic blocks with different visibility states, and when counting multiple block references occurring several nesting levels deep.
My sincere thanks go to Helmut Schröder, who kindly brought these issues to my attention and also suggested possible fixes for the code.
I have completely rewritten my novelty Tip of the Day program; the new Version 1.1 ensures that the same tip is never displayed twice in a row, and provides the user with more control over the appearance of the tip dialog.
Firstly, I would like to apologise to my readers for the distinct lack of updates to my site over the past month - my workload has increased substantially this year and my free time is unfortunately currently in short supply. To those who have contacted me directly, please know that I have received your messages, but finding the time to adequately respond to everyone in a timely manner is becoming increasingly difficult - for this I apologise.
Now to get back on topic, I am pleased to announce that my Change Block Base Point program has been published to the Autodesk Exchange App Store. I invite you to rate & review the app at your earliest convenience!
As with my other published applications, the published version of the program has a professional application installer and comes complete with a custom ribbon panel and individual toolbar icons for each command which may be used to launch the application.
The original program has also been updated to Version 1.5 to implement to some minor changes to the code in keeping with the published app.
I have updated my library of Mathematical Functions to include a new set of Arithmetic Functions; such functions include calculation of the Least Common Multiple of two or more numbers, obtaining a list of Prime Factors of a number, and testing whether or not a given number is prime.
I have updated the code for my old Elevation Marker program. This very simple program enables the user to create multiple elevation markers composed of a variable-width polyline and a text object displaying the UCS Y-coordinate of the picked point.
New tutorial: The Apostrophe and the Quote Function. This tutorial provides a detailed explanation describing the behaviour & purpose of the apostrophe and equivalent quote function in AutoLISP.
I have updated my set of Matrix & Vector Functions to update the matrix determinant function by ElpanovEvgeniy which calculates the determinant by transforming the matrix into upper triangular form; and also include my version of a matrix determinant function implementing Laplace's formula.
I have updated the code for my Load Linetypes function to exclude known metric & imperial linetype definition files based on the value of the MEASUREMENT system variable, and also incorporate a boolean parameter to determine whether linetypes should be redefined from file if already loaded. I would like to thank Jason Bourhill from CAD Concepts for suggesting these improvements for the function.
Following a bug reported by a user, I have updated my Dynamic Block Counter program to Version 1.1. This new version fixes a bug causing the previous version of the program to error when processing non-uniformly scaled dynamic blocks, and also offers the user the ability to process a selection of blocks (rather than processing all blocks) and output the results to a Text or CSV file.
I have updated the code for my Selection Set Bounding Box function. This function returns the lower-left & upper-right coordinates of a rectangular frame bounding all objects in a supplied selection set.
I have updated the code and function description for my Browse for Folder function; the code is now more concise and includes a smaller code header for a reduced footprint, and the function description page now includes an example function call with accompanying image, and a reformatted list of bit code values.
The new version of the program has also been published to the Autodesk Exchange App Store!
The published version has a professional application installer and comes complete with a custom ribbon panel from which to launch the application. Feel free to rate & review the app!
After evaluating the wealth of feedback & suggestions submitted by numerous users of this program, I have invested some time rewriting & restructuring the entire program to implement many of the suggestions and also incorporate several new ideas of my own. This new release also improves the general performance of the program, providing a more stable and reliable program.
A number of the more significant changes and new features are detailed below:
New Show Hatch Text program added to the site. This program enables the user to clear the area of a hatch pattern obscuring selected Text and MText objects, or Text, MText and Attributes contained within selected primary & nested block references.
I have added a new Length at Midpoint program to the site. This program automatically generates MText objects positioned over the midpoint of every object in a selection, with each item of MText containing a field expression referencing the length of the object.
New Field Formatting Code program added to the site. This utility enables the user to determine the field formatting code associated with the field expression held by a selected object, and may be used in conjunction with my Length at Midpoint, Areas to Field, and Area Field to Attribute programs in order to determine the correct field formatting code to use with each of the programs.
I have updated the descriptions for my Areas to Field, and Area Field to Attribute programs to update the set of instructions indicating how to determine the correct field formatting code to use with each program.
New Offset Polyline Section program added to the site. This program enables the user to offset a section of a polyline enclosed by two selected points on the polyline.
I have updated my set of Colour Conversion Functions to improve the concision of the code for many of the functions.
Added MD5 Cryptographic Hash Function to the Subfunction Library section of the site. This function is an AutoLISP implementation of the MD5 message-digest algorithm developed in 1992 by Ronald Rivest.
My Error Message Troubleshooter has been updated to add the bad argument type: streamp error message, and to also include possible AutoLISP functions pertaining to the cause of each error.
I have recently updated my Minimum Bounding Box function to overhaul the old function code, include additional error trapping, and furthermore update the code formatting to meet my current standard.
I am pleased to list DuctiSoft as a friend of Lee Mac Programming. Andrea Andreetti, the proprietor of DuctiSoft, is a very creative programmer whom I have had the pleasure of collaborating with in the past to create a novelty Dynamic Laser program (requires Swamp membership to view).
My Extract Nested Block program has now been published to the Autodesk Exchange App Store! The published version has a professional application installer and comes complete with a custom ribbon panel from which to launch the application. Feel free to rate & review the app!
I have now updated my Circular Wipeout program to Version 1.2. This version fixes a UCS bug arising when the UCS origin is not equal to the WCS origin.
I am pleased to list Paul Stafford's blog: CADsmarter as an affiliate site of Lee Mac Programming. Paul's blog is relatively new, but already contains many useful tips & tricks to help you get the most out of AutoCAD.
Following a bug reported by a user, I have updated my Automatic Block Break program to Version 1.6. The updated version fixes a bug causing the program to return an error if an object intersected the bounding box of the block at only one point.
I have recently updated my set of Attribute Functions to fix a few minor bugs, improve the concision of the code, and update the formatting to be consistent with my other function sets.
My Steal & Associative Textbox programs have now been published and are available to download from the Autodesk Exchange App Store! These published versions come complete with professional application installers and custom ribbon panels from which to launch the applications.
I have updated my Extract Nested Block program to Version 1.1. The updated version incorporates additional error trapping to prohibit selection of blocks nested within dynamic blocks or xrefs (with which the program is incompatible), and nested blocks residing on locked layers. The program will also now ignore non-uniformly-scaled block references (for which the previous version returned an error).
My Background Mask program has now been published and is available to download from the Autodesk Exchange App Store. The published version includes an application installer and a custom ribbon panel from which to launch the application. Feel free to rate and review the app!
I am pleased to announce that gileCAD is now an affiliate of Lee Mac Programming. Gilles Chanteau, the proprietor of gileCAD, is an incredibly talented programmer who I have had the pleasure of knowing for several years, and from whom I have learnt a great deal.
My Batch Attribute Editor program is now also available to download from the Autodesk Exchange App Store! The version published at the Exchange App Store comes complete with an installer and also features a custom ribbon panel from which to launch the program.
Feel free to rate & review the app and let me know what you think!
A new novelty program gift to my readers for the first post of September: Password Generator was inspired by a recent 'challenge thread' posted at TheSwamp CAD forum, and will generate a pseudo-random password string based on the parameters specified.
I have updated my Nested Move program to Version 1.2. The new version implements a fix for a bug causing the program to crash when a nested attributed block or nested 2D/3D Polyline is selected.
My Burst Upgraded program has now been rewritten and updated to Version 1.1. The new version has cleaner & more concise code, with additional error trapping to account for xrefs and objects on locked layers. I have also included an animated demonstration to exhibit the program capabilities.
Following valuable feedback received from several users, my Nested Move program has now been updated to Version 1.1. The new version allows the user to select multiple nested objects (with the same parent) to be moved, with selection highlighting to provide visual feedback for the selected objects. The new version will also move only the 'outermost' nested object when the user has selected an object nested several levels deep - this also resolves an issue in which the user could move nested dimension components. The accompanying animated demonstration has also been updated to reflect the new functionality.
List Box function rewritten and updated to Version 1.2. This updated version alters the third argument for the function to a bit-coded integer controlling whether the list box permits selection of multiple items, and also whether the function will either return a list of selected items or a list of zero-based indexes corresponding to the position of each item within the supplied data set - a necessary enhancement when working with data containing duplicate items.
I have uploaded a sample zip folder containing an example CSV file & accompanying sample drawing containing an attributed block for use with my Update Titleblock Attributes program.
Added new LM:sfsp+n (Add Support File Search Paths at n) function to my set of Support File Search Path Functions. This function will add a list of paths at a position in the list of AutoCAD Support File Search Paths given by a supplied zero-based index parameter.
My old Centerline program has recently been rewritten & updated to Version 1.2. The new version has cleaner code and performs successfully on a wider range of CAD platforms following a recently received bug report submitted by an avid user.
I have recently updated my entire set of Dynamic Block Functions. The code for each function is now clearer & more concise, and the functions have a reduced footprint, carrying smaller code headers. A new LM:ToggleFlipState function has also been added to allow a developer to effortlessly toggle the Flip State Parameter held by a Dynamic Block reference.
I am pleased to list PHCAD as an affiliate of Lee Mac Programming. Paul is a talented & certified professional draughtsman and, in addition to advertising his services, his site offers free resources in the form of LISP tips & an expanding block library.
Inspired by a request posted at the Autodesk Discussion Groups, I have added a new Nested Move program to the site. This program enables the user to move a selected object nested within a block, dynamic block or xref (nested to any depth), without opening the xref source drawing.
I am pleased to list Matthew Nichols' blog Talk about CAD as an affiliate of Lee Mac Programming. Matthew's blog is packed with useful information and includes several macros & DIESEL examples for LT users who unfortunately cannot take advantage of AutoLISP.
New ssget Function Reference added to the Programming References section of the site. This reference includes information gathered over the years from various sources, including information on undocumented ssget functionality and several examples to demonstrate function usage.
I have extensively updated my tutorial on Debugging Code with the Visual LISP IDE to include better explanations for actions performed in the tutorial, and clearer & cleaner graphics & animation.
Following a bug reported by a user, I have updated my Get Files Dialog function to Version 1.3; this update fixes a bug wherein the function would crash if the user double-clicked in empty space in the left-hand list box pane.
I have now rewritten my Create Directory function to improve the concision & readability of the code. This function will recursively create each level of a supplied directory folder structure.
Following the recent addition of my Match Field Formatting program, I have now also added a new Copy Field program to the site. This program enables the user to copy a field expression from a selected source object to multiple destination objects in a drawing.
My Copy to XRef program has now been completely rewritten and updated to Version 1.1; the new version incorporates substantially improved error trapping and improves code readability in general. An animated demonstration of the program in action has also been included on the program page.
I have added a brand new Match Field Formatting program to the site. This program enables the user to copy the formatting from a selected source field expression to multiple destination fields in a drawing.
Following the above addition, I have also included my Field Code function in the Subfunction Library section of the site. This function is heavily utilised by my recently added Match Field Formatting program, and will return the field expression associated with a Text, MText, Attribute, MLeader, or Dimension object.
My Copy to Layouts program has now been completely rewritten and updated to Version 1.1. The program enables a user to copy a selection of objects to all or selected layout tabs in a drawing; this updated version is more robust with cleaner code for improved readability.
I have now updated my Copy or Rename Block Reference program to Version 1.5; this new version enables the user to copy or rename anonymous block references in a drawing.
My Copy or Rename Block Reference program has now been completely rewritten and updated to Version 1.4. The code for the updated program has improved clarity, concision and readability, with additional error trapping to allow for block references residing on locked layers.
I have rewritten my old Copy Block from Drawing program and have renamed the program to a more apt: Import Block. This program is the precursor of my far more generalised and extensively developed Steal from Drawing program and allows a user to import a block from a selected drawing file into the active drawing, without opening the external file.
My novelty Clock application has now been completely rewritten and updated to Version 1.1. In addition to incorporating cleaner and far more efficient & readable code, the new version also includes a new runclock command, enabling the user to run the clock continuously. I have also rewritten the description found on the program page and have added a new animation to demonstrate the program in action.
I have updated my set of Column Reference Functions; these functions are ideal for converting and manipulating alphabetical 'column references' (e.g. A,B,...,Z,AA,...) as used by applications such as Excel. I have also provided alternative versions for many of the functions in order to demonstrate different ways to obtain the same result. A table of contents has been included on the page for ease of navigation.
I have updated my set of Colour Conversion Functions to provide functions for conversion between all 5 colour enumerations listed on the page; a table of contents has also been included for ease of navigation.
New Object Break program added to the General Programs section of the site. This program is a generalisation and enhancement of my existing (and recently updated) Circle Break program, enabling the user to break a selected object either at two specified points, or at two points of intersection with another selected object, and apply a set of properties to the selected portion of the object.
My Circle Break program has now been entirely rewritten and updated to Version 1.3. The much improved new version enables the user to use the program with ellipses in addition to circles, and apply a whole set of properties to the 'hidden' arc or elliptical arc, as opposed to simply assigning a layer as performed by the previous version. The accompanying program description has also been rewritten and a new animated demonstration has been included.
My Change Block Insertion program has been completely rewritten and updated to Version 1.4; I have furthermore renamed the program to a more appropriate: Change Block Base Point. Please note that the commands for this program have also been renamed accordingly. I have also rewritten the accompanying program description, providing an explanation for each available command, and including a new animated demonstration.
I have completely rewritten my set of functions which enable a user to Add & Remove Support File Search Paths and have also updated the accompanying function description found on that page.
My Area Field to Attribute & Areas to Field programs have also been completely rewritten and updated to Version 1.1 & Version 1.2 respectively, to improve the readability of the code and to enable the user to easily configure the area format of the Field generated by the programs. The accompanying program descriptions have also been heavily updated to provide instructons detailing how to determine the correct Field formatting code when configuring the area format.
I have updated my Arrow Arc program to Version 1.1; the new version incorporates an aarcsettings command to enable the user to control the length & width of the arrow heads without modifying the program source code.
My very old Box Text program has been completely rewritten to vastly improve the readability of the code and to fix a few general bugs.
Following a bug report, I have updated my Read CSV function to Version 1.3 to correctly process some uncommon cell values containing a certain combination of comma & quote characters. I have also updated my complementary Write CSV function and have condensed the code for both functions, resulting in improved readability & performance.
I have furthermore revised my Update Titleblock Attributes program to Version 1.6 in order to incorporate the above changes to my Read CSV file parsing function and to remove the need to include the file extension when listing drawings in the CSV file read by the program.
I have now updated my old Copy to Drawing program to Version 1.2 and have renamed the program: Copy to Drawings. As the new name suggests, I have now lifted the single drawing restriction, with the updated version allowing the user to copy a selection of objects to an entire set of drawings, without opening each drawing in the AutoCAD Editor.
I have now included a new tutorial on the topic of Selection Set Processing to the AutoLISP & Visual LISP Tutorials section of the site. This tutorial demonstrates a variety of different methods of how to iterate over all objects in a selection set, together with a brief explanation of how each method works and the efficiency of its operation.
Updated my recently released Associative Textbox program to Version 1.2 to fix a bug causing MText & LWPolyline objects residing in Paperspace Layouts to be transferred to Modelspace.
Updated Associative Textbox program to Version 1.1 to fix a bug causing the program to crash during loading if other reactors with reactor data with non-string data type are already running in the active drawing session.
Added Associative Textbox program to the site. This reactor-based program enables the user to create an associative textbox surrounding a Text or MText object, with the size, position, orientation & rotation of the textbox frame automatically updated following modification to the associated Text or MText object.
Added Filtered List Box function to the Subfunction Library section of the site. Similar to my existing List Box function, this function also presents the user with a dialog interface containing a list box tile from which the user may select one or more items, however, the displayed dialog for this function also includes an edit box tile, enabling the user to filter the list of items displayed.
I have updated my Align Text program to Version 1.3; this version allows the user to reposition a selection of single-line text objects with any rotation, aligned in a direction perpendicular to the text rotation. The updated program will furthermore perform successfully with text constructed in any UCS plane.
I have updated my Total Length & Area Programs to simplify the code and improve the readability & consistency of the programs.
My Get Files function has been completely rewritten and updated to Version 1.2. The updated version implements a bug fix to account for Library folders encountered with Windows 7, and also incorporates a new and improved file sorting function.
ObjectDBX Wrapper function completely rewritten and updated to Version 1.2 to include more error trapping and to condense the code, improving both readability & performance. Directory Dialog function also updated and renamed to BrowseForFolder for consistency with the method used by the function.
I have updated my GrText function to Version 1.1. The function has been completely rewritten with the previous 'Extended ASCII' version now included in the main function for consistency. The redundant colour argument has also now been removed to improve compatibility when the function is used with DCL. The program page has also been overhauled to provide a far better description of the various demonstration programs, which have also been rewritten and updated.
Added Text to Words program to the site. This program enables the user to convert a selection of single-line text objects into separate text objects for every word in the selection, whilst retaining all properties of the original objects.
I have added the functions Matrix Inverse (gile / Lee Mac) & Identity Matrix to the Matrix & Vector Functions section of my Mathematical Functions page. The Matrix Inverse function uses the technique of Gauss-Jordan elimination to calculate the inverse of a given nxn non-singular matrix. The original version of this function was written by the talented gile (Gilles Chanteau), which I have modified for increased performance & concision. The included Identity Matrix function will return an nxn Identity Matrix with dimension given by the supplied integer parameter.
Updated my Dump Object utility function to Version 1.1 to improve the function structure & readability.
My Automatic Block Break program has been mostly rewritten and updated to Version 1.5 to incorporate a new & improved function to calculate the rectangular bounding box of a block, resulting in accurate results when applied to Dynamic Block references; and furthermore to fix a bug wherein the program would attempt to break Multiline objects. Other minor changes have also been implemented to improve and streamline the program.
I have also updated the Automatic Block Break program page, rewriting the description to describe each available command in greater detail and to include several new animations to better demonstrate the program capabilities.
Updated my Mapcar & Lambda tutorial to reformat the examples and fix a reported broken link.
Following recent development of my 5-Point Ellipse function, I have added a new Advanced Polyline Outline program to the General Programs section of the site. The program allows the user to construct an outline silhouette of an LWPolyline with straight and/or arc segments with varying or constant width.
Added 5-Point Ellipse function to the Subfunction Library section of the site. This function will return the parameters of the unique ellipse passing through five supplied points, if such an ellipse exists. The method used to determine these parameters is described on the function page linked above.
Added Matrix Determinant (by ElpanovEvgeniy) & Matrix Trace functions to the Matrix & Vector Functions section of my Mathematical Functions page; as the names indicate, these functions will respectively calculate the determinant and trace of a given nxn matrix.
Updated Background Mask program to Version 1.1 to alter the command syntax for the program to bmask, since mask is an existing command in AutoCAD Civil 3D. The update also implements several other minor improvements to the code.
Added Ellipse to Arc program to the site. This program will allow the user to convert a selection of circular Ellipses & Elliptical Arcs (that is, Ellipses or Elliptical Arcs with axes of equal length) into Circles & Arcs respectively, whilst retaining all properties of the original objects.
I have also updated my Circular Wipeout program to Version 1.1. This updated version includes an additional command, c2wipe, which enables the user to convert a selection of circles to circular wipeouts.
Added Circular Wipeout program to the site. As the name implies, this program enables the user to create a circular wipeout with a given center & radius in the drawing.
I have updated my set of Unique & Duplicate List Functions to rewrite & improve many of the existing functions and moreover to include iterative versions of every function listed. I have also added a table of contents to facilitate navigation of the page.
It's a bit late in the month, but I wish all of my readers best wishes for 2013!
To keep with the festive theme of this time of year, I have published an article exploring the curious & intriguing geometrical properties of the Koch Snowflake. This program may be found under the Mathematical Endeavours section of the site.
I have also updated my study of various chaotic Attractors to include a table of contents, clearer systems of equations for each attractor, greatly improved & more readable code, and finally, a derivation for the Duffing Oscillator.
Finally, I wish all of my readers a very Merry Christmas!
Added Chain Selection program to the site. This program prompts the user to select an object and generates a 'chain selection' of all objects sharing endpoints with objects in the accumulative selection.
Updated Align Objects to Curve program to Version 1.3 to enable the user to align the selection of objects to a nested curve within a Standard or Dynamic Block or XRef, nested to any level.
My Align Objects to Curve program has now been completely rewritten and updated to Version 1.2 to enable the program to perform successfully in all UCS & Views. The alignment controls offered by the program have also been refined, with the additional option to allow the user to rotate the set of objects relative to the selected curve.
Added functions LM:Reflect & LM:InsideTriangle-p to my set of Mathematical Functions. The former will reflect a given point in the axis defined by two supplied points in the plane; the latter is a predicate function which will return T if a given point lies within a triangle defined by three supplied points. In addition to the inclusion of these supplementary functions, I have also organised the library of Geometric Functions into appropriate sub-categories for ease of navigation.
As a treat for Halloween, I have added a new novelty program to the site. Lottery Numbers is a relatively simple novelty program generating a sequence of random numbers in the form of lottery balls in the drawing. Good luck!
I have updated my library of Intersection Functions; this set of functions provides the ability to retrieve points of intersection between either two objects, all objects within a Selection Set or list, or between objects of two Selection Sets or lists. The functions have been completely rewritten to improve readability, concision & performance, and the entire function page has been overhauled to provide detailed information about every function, including animated demonstrations and diagrams.
I have updated my Mathematical Functions page to incorporate a set of Complex Number Functions, pertaining to the arithmetic manipulation of complex numbers; and Factorial Functions, which may be used to calculate the factorial of a positive integer, in addition to the multiplication and division of two factorials. I have also renamed several of the Matrix & Vector Functions present on the page to improve consistency. Various Geometric Functions have also been updated to reflect the renamed function names and earlier modifications to the Polygon Centroid function.
Updated Polygon Centroid function to account for the case in which the coordinate scale factor is zero, and hence eliminating a potential divide-by-zero error.
I have updated the Testimonials section of the site to include a testimonial kindly received from John Hailey at CBI/Matrix Engineering - thanks John!
Added set of Random Number Functions to the site. These functions involve the generation and manipulation of pseudo-random numbers using a linear congruential generator.
Updated Popup function to Version 1.1 to revise the code formatting and improve the readability of the function.
I am pleased to list Paul Munford's blog The CAD Setter Out as an affiliate site of Lee Mac Programming. Paul's blog is packed with useful information on AutoCAD and Inventor, including a cornucopia of tips, tricks and tutorials exuding Paul's evident enthusiasm for everything CAD related. I also encourage followers of my site to vote for my link as your favourite CAD site on his links page here.
Added Isometric Polygon program to the site. This program enables the user to construct a regular polygon projected in the active isometric plane.
I have updated my Update Titleblock Attributes program to Version 1.5. The new version of the code revises the CSV file parser function to account for the use of alternative cell delimiter characters (such as a semi-colon) used by some systems.
Updated Steal program to Version 1.8. This revision fixes a minor bug present in the recently released Version 1.7 wherein the program would error if all items in a selected collection were deselected by the user using the Ctrl key, and then the Import button is pressed. Furthermore, in this updated version, the active drawing will only be regenerated (following program completion) if one or more items have been imported by the program.
After evaluating the excellent feedback submitted by numerous users for this program, and having reviewed the many suggestions for improvement that were submitted since the program was first released to the public, I have invested some time implementing many of the proposed ideas and have injected a few additional features of my own into this new release of my Steal from Drawing program.
This release also improves the general performance of the program, with much of the original source code rewritten and restructured, furthermore, some previously undetected bugs have now been ironed out to provide a more stable and reliable program.
A number of the more significant changes and new features are detailed below:
Added Polyline Information program to the General Programs section of the site. This program provides the user with detailed information about every segment of a selected LWPolyline in the form of an AutoCAD Table (if available), Text file, or CSV file.
Updated my Batch Attribute Editor program to Version 1.4. This version implements a refined file and folder sorting function to emulate the Windows Explorer filename sort when selecting drawings to be processed by the program. The updated program also increases the character limits of the edit_box tiles in the dialog to allow for the use of long Field Expressions in attribute values. Other general bug fixes are noted in the program code header.
Added HTML versions of many of the programs available for download on the site, allowing the user to view the program source code directly in the web browser, with the choice of three syntax-highlighting themes. Take a look at the various programs under the General Programs section of the site, and click on the 'View HTML Version' link try this new feature of the site.
Added Delete Blocks program to the site. This program enables the user to quickly remove all traces of multiple blocks from a drawing.
Updated List Box function to standardise code formatting and rewrite several expressions to improve clarity and readability.
I have once again updated my Nested Block Counter to Version 1.4 to implement another fix for an issue relating to counting Standard Blocks nested within Dynamic Blocks which are using different Visibility States. This issue should now (hopefully) be fully resolved.
I have restructured and rewritten several sections of my Error Handling tutorial to provide clearer explanations and cleaner code samples.
I have updated my Nested Block Counter program to Version 1.3. This update provides a fix for an issue arising when counting Standard Blocks nested within Dynamic Blocks which are using different Visibility States. The new version also offers the ability to extract the block report to either a Text or CSV file.
Added Write CSV function to enable a user to write a list of cell values to a CSV file. An example program is also included on the program page, demonstrating the ease of constructing a program to extract point data to a CSV file by utilising the LM:WriteCSV function.
Updated my Read CSV function to restructure the code for better readability and performance, provide support for international systems which do not necessarily use a comma as a CSV delimiter character, and improve the cell parsing function to return more accurate results for cells containing commas and quotes.
Minor updates to my Bulge Conversion Functions to update the code formatting, shorten and improve the test functions and re-order the returned values for my Arc->Bulge function to reflect the order in which the values are used when constructing an LWPolyline.
Updated set of Draw Order Functions to Version 1.1. This update is a complete overhaul of the code for both the draw order functions and example custom draw order programs found on the program page. The functions now provide support for 64-bit systems, and the example programs will now process objects on locked layers.
After much planning, experimentation, redesign and deliberation of ideas for new features, I have finally released the new version of by far my largest, most popular and also most extensively developed program:
I present Version 3.3 of my Incremental Numbering Suite.
This release includes more changes and is packed with more new features than any other release since the program was first drafted. The Program Description has also been predominantly rewritten to document all of the new program functionality.
A number of the more significant changes and new features are detailed below:
Added Consistent rtos function to the Subfunction Library section of the site. This fairly simple wrapper for the rtos function will always return the result of evaluating the rtos function with the DIMZIN System Variable set to 0, thus eradicating any incongruency when using this function in different drafting environments.
Added Version 1.1 of my Label program to the site. This program is a stripped down, faster & improved version of my previously published Align Text to Curve program; the program has been streamlined to allow the user to create MText 'labels' dynamically aligned to a selected primary or nested object, with additional placement controls available at the command-line.
Modified the following programs to both update code formatting and improve the flow & readability of the code:
Added Extract Nested Block program to the General Programs section of the site. This program will allow the user to convert a nested block into a primary block inserted at the same position for each reference of the nested block, with the same scale, rotation, orientation and all other properties possessed by the original nested block.
My Batch Attribute Editor has now been upgraded to Version 1.3. This update implements several new features in addition to remedying a couple of minor bugs present in the previous versions.
A brief summary of the notable improvements have been included below:
Updated my Steal program to Version 1.6. Amongst other general updates to the program code, this version fixes a bug causing the program to crash for versions in which some collections are not available.
Updated Layer Director to Version 1.1. In this version, the majority of the program has been rewritten to streamline the code. The previous Command Reactor toggle has been removed in lieu of two separate commands to switch the program on & off; this alteration follows reports by users that the previous version would toggle on then promptly off when loaded through the Startup Suite.
Updated Quick Field program to Version 1.1. This version implements a fix for a reported bug which was causing the program to crash when used in 64-bit environments.
Added Background Mask program to the site. This program allows the user to manipulate all properties of the background mask for a selection of Multiline Text (MText) and Multileader (MLeader) objects.
Areas to Field program completely rewritten to incorporate better support for 64-bit systems and also improve code readability. GIF demonstration added to the program description page.
I have updated my Batch Attribute Editor program to Version 1.2. This update hopefully implements a fix for the scripting bug present in previous versions of the program, and also offers the user the ability to select multiple attributed blocks from the active drawing whose attribute values may be added to the list of items to be modified. This should no doubt greatly reduce the tediousness of manually inputting the attribute information.
Updated Incremental Numbering Suite program to Version 3.2. This update fixes a number of bugs, the most prominent pertaining to the collection of attributed block data.
Rewritten the code for Copy Block from Drawing program to make it consistent with many of my more recent programs and furthermore to improve code readability.
I have completely rewritten my Slinky Text program and have updated the program to Version 1.4. This new version has cleaner code and includes several performance enhancements which should allow the program to run smoother.
Added Format DCL program to the Utilities section of the program page. This program will read a selected DCL file and create a formatted version of the DCL code in the same directory as the selected file.
Updated Batch Attribute Editor to Version 1.1. This update fixes some scripting issues reported in the last version and splits the main dialog into two separate screens to account for those users without access to a widescreen resolution. More information about the update can be found in the program code header.
In June of 2009 I put together the first version of my Global Attribute Extractor & Editor program, offering the user the ability to extract attribute data from multiple blocks in many drawings, and edit several attributes in a block across multiple drawings.
This program used ObjectDBX to process many drawings very quickly, but this approach also included drawbacks stemming from the underdevelopment of the ObjectDBX interface, which, to this day, still has bugs. Furthermore, the Editor part of the program only offered the ability to modify attributes in a single block.
Almost three years later, I am now offering a new Batch Attribute Editor program. This program allows the user to modify the values of multiple attributes residing within multiple attributed blocks across multiple drawings. A full description of this new and improved program may be found on the dedicated program page.
Added LISP Command Logger program to the site. This program will automatically (and silently) record daily LISP command usage in every drawing to a CSV Log File, saved to a folder specified in the program source code.
Added Nested Block Counter program to the list of General Programs. This program will generate a report detailing the individual quantities of primary and nested blocks, dynamic blocks & XRefs in a selection or an entire drawing.
Updated Read CSV function to return the correct content of CSV cells containing commas and quotes, and to correctly read CSV files generated using OpenOffice software.
Previously, when reading a CSV file with the following content:
The old ReadCSV function would incorrectly return the list:
(("abc" "\"a" "b" "c\"" "\"\"\"abc\"\"\"" "\"\"\"a" "b" "c\"\"\""))
The updated function now correctly returns:
(("abc" "a,b,c" "\"abc\"" "\"a,b,c\""))
I found a few minor bugs in the code for my recently added Get Files Dialog function pertaining to the behaviour of mode_tile statements for the Add Files and Remove Files buttons. These have now been fixed and the code has been updated to Version 1.1.
First post of 2012: a Happy New Year to my readers!
Added Read CSV function to the Subfunction Library. This function will read an Excel Comma Separated Value (CSV) file and return a matrix list of the cell values, that is, a list of lists where each sublist is a row of cell values.
The code for my Unformat String function has been completely rewritten; the new version should be more robust with far more error trapping. The Unformat String function will remove all MText formatting codes from a supplied string.
Updated Open function code and included an extra example demonstrating how the function may be used to open an arbitrary file selected by the user.
Reformatted the code for the Ortho Point function and included a 'Vector Calculus' version of the same function to demonstrate another approach.
Revised the Update Titleblock Attributes program to Version 1.3. This version implements a modification to allow the program to correctly process CSV files generated using OpenOffice software.
Updated the Iterated Function Systems mathematical program to Version 1.2. This is a complete rewrite of the program, including an update to the Barnsley's Fern program on the main page.
Updated Fractal code to remove unnecessary expressions and hence improve performance.
Updated the Dynamic Block Functions page and added a Contents section to ease navigation of the various functions.
Added Polygon Centroid function to the Subfunction Library. This function will return the centroid (expressed relative to WCS) of an LWPolyline Polygon, that is, a non-self-intersecting closed LWPolyline consisting entirely of straight segments.
Also added PolyCentroid function to my set of Geometric Functions.
Updated Attribute Functions page to reformat all code and include new function: SetAttributeValues.
Added a Contents section to the Attribute Functions page.
Added Get Anonymous References function to the Subfunction Library. This function will iterate over the block table and return a list of the names of all anonymous references associated with a supplied block name; armed with such a list, an appropriate ssget filter list may be constructed to include only those references which are relevant to a specific dynamic block.
Added 3-Point Circle & Arc Functions to the Subfunction Library. These functions return the data required to construct a Circle or Arc from three supplied points. A variety of non-dynamic and dynamic test programs are also included.
Added mid, 3PCircle & 3PArc to my set of Geometric Functions.
Added v1 function to my set of Matrix & Vector Functions. This function will return a unit vector representation of a supplied vector.
Updated Reset XRef Layers program to Version 1.1. This version incorporates code to search the working directory and AutoCAD support directories for the XRef source file, should such file not be found at the filepath encoded in the XRef.
Tweaked the style of the Programs page.
Added Reset XRef Layers program to the General Programs section of the site. This program enables the user to reset all or specific layer properties of XRef dependent layers to match the properties present in the XRef source drawing file.
Added Minimum Enclosing Circle program to the General Programs section of the site. This program offers two commands to allow the user to make a selection of one or more objects, then proceed to construct the unique minimum enclosing circle containing all objects in the selection.
A minor update to the Entity to Point List function to include Point Entities.
Added Entity to Point List function to the Subfunction Library. This function will return a list of points describing or approximating a supplied entity, whilst minimising the length of the returned point list where possible.
Added Quick Field program to the site. This function is designed to enable the user to quickly and easily design & create custom programs for inserting multiple fields into a drawing. This could be for use in situations in which the user is required to create many fields in a drawing, with each field referencing the same object property, and continued use of the Field Command Dialog can become tedious.
Added Get Field Objects function to the Subfunction Library. This function requires a single parameter: an entity containing a Field, and will return a list of entities referenced by the supplied Field.
Added Friends of Lee Mac Programming to the homepage sidebar. If you wish to become a friend of Lee Mac Programming and feel that your site has suitable content which is relevant to my site, feel free to contact me.
Whether or not your site is suitable to become an affiliate of Lee Mac Programming feel free to display my microbar on your site, I appreciate you linking to my site.
Added to the Subfunction Library a function to compute the Convex Hull of a set of points. The Convex Hull is the set of points describing the minimum convex polygon enclosing all points in a given set. The function shown implements the Graham Scan algorithm to compute the Convex Hull - a description of this algorithm including a visual demonstration of the process is included on the program page.
In other news... Lee Mac Programming is a year old!
Updated Area Label program to Version 1.9. This update fixes a bug causing the program to crash when Region Objects were selected.
Tweaked the code for the Entity List utility. The program has now been renamed and more accreditation has been included to recognise the author of the program on which the utility is based.
Redesigned the site Contact Form.
If you or your company wish to share your thoughts about my site, or working with me or my programs in the form of a testimonial, feel free to contact me.
Added Draw Grid program to the site. This program will prompt the user for a number of rows and columns then proceed to dynamically construct a grid composed of Line Entities between two corner points.
Added Automatically Label Attributes program to the site. This program uses multiple reactors to automatically label / number a specific attribute in a set of blocks, automatically renumbering if blocks are added, copied or erased.
Updated Incremental Numbering Suite to Version 3.1. This fixes a bug concerning a null variable when an Annotative Text Style is set and the Object type is set to use an Attributed Block.
The program is now faster & smoother and has become my largest and most developed application, with many new features and updates included in the new version, a handful of which I have listed below.
I have also completely rewritten the program description to give a more complete overview of the program capabilities.
Version 3.0 of my Incremental Numbering Suite program.
Following the popularity of this program on my site, I am currently working on a new version which promises to be smoother, faster and packed with new features.
Click here to read about some of the planned new features and see a preview of the new interface.
Added set of Text Case Functions to the Subfunction Library. These functions demonstrate how to convert a text string to various text cases and formats. Included are functions to enable conversion of a text string to Sentence Case, Title Case, or finally, the case of each character in a string may be switched using the Toggle Case function.
Copy to Drawing program completely rewritten and updated to Version 1.1. When rewriting this program I have significantly condensed the code, reformatted the code style to make the source code more readable and easier to follow, and hopefully improved the performance of the program.
Updated Automatic Block Break program to Version 1.4. Included in this version is an option to enable or disable the automatic rotation of the block if a curve object is found at the block insertion point.
Added set of Assoc++ Functions to the Subfunction Library. These functions may be used to increment the associated value of a key in an association list, or a nested key as part of a hierarchy of keys in a nested association list. Such functions are useful when counting the number of occurrences of distinct items in a set, or when counting items which are dependent upon other items. These functions are used in many of my programs: Block Counter, Text Counter, Count Attribute Values & Dynamic Block Counter to name a few.
Updated Incremental Array program to Version 1.4. This version fixes a bug when arraying and incrementing attributes on locked layers.
Added Clockwise-p and ListClockwise-p to my set of Geometric Functions. These functions may be utilised to determine whether 3 or more points are clockwise oriented, that is, whether a path passing through the points follows a clockwise direction.
Implemented a facility to allow users to change the width of pages on the site, depending on their preference. Users may select a Fluid, Wide, Medium or Narrow width setting. The default width is Fluid in which the width of the page is set by the width of the browser. Other settings may be more suitable for various screen resolutions.
Added Pad Between Strings function to the subfunction library. This function returns a string of a minimum specified length which is the concatenation of two supplied strings, padded between using a supplied character. Such a function is extremely useful when printing reports or lists to the command-line, and is used extensively in my Dynamic Block Counter program.
Implemented a facility to allow users to alter the size of text on my site, increasing readability.
Added Custom Programming Services section to the Home page, for those companies looking to automate repetitive tasks in their procedures via the use of custom programming, potentially saving hours of valuable time.
Added Dynamic Block Counter program to the site. Very similar to my Block Counter program, this program will count all blocks in the current layout of a drawing - be they standard, dynamic, or XRef; generating a report of the quantities at the command-line. Furthermore, for every dynamic block with a Visibility Parameter present, the number of blocks assuming every Visibility State of the dynamic block is detailed in the output report.
Added Get Visibility Parameter Name, Get Visibility State, & Set Visibility State functions my set of Dynamic Block Functions. These functions allow the user to manipulate the Visibility Parameter of a Dynamic Block.
Updated SelectionSet Bounding Box function and test program to make the code more succinct and increase function performance.
Updated Steal from Drawing program to Version 1.5. This version implements a number of changes to improve the program:
Updated Polyline Outline program to Version 1.1. This version includes a fix for a minor bug relating to incorrect processing of the ending width of the final polyline segment.
Added Polyline Outline program to the site. This program will create one or more LWPolylines along the boundary of a supplied LWPolyline with varying or constant width.
Upgraded Update Titleblock Attributes program to Version 1.2. This version removes case-sensitivity from the 'Drawing Filename' column of the CSV Drawing Register so that both the drawing filename data (first column) and layout data (optional, second column) are not case-sensitive. I have furthermore added a GIF animation providing a succinct demonstration of how the program may be used to link a set of drawings to a drawing register.
Updated Copy or Rename Block program to Version 1.3. This version allows the user to copy and rename External References (XRefs) in addition to Standard and Dynamic Blocks; retaining any XClips associated with the selected block.
Added Incremental Array program to the site. This program will array a selection of objects, whilst incrementing any numerical content found in objects containing text within the selection.
Added Elevation Marker program to the site. This relatively simple program allows the user to continuously place elevation markers composed of an LWPolyline and Text object at specific points in a drawing.
Added Minimum Bounding Box function to the subfunction library. This function uses a brute-force method to determine the minimum rectangular bounding box framing all objects in a supplied selection set.
Added Visual LISP IDE tutorial: A Shortcut to Localising Variables to help relieve the tedium of localising many variables in larger programs, reducing the task to a simple copy & paste operation.
Updated Text Counter to Version 1.1. This program will count the number of occurrences of distinct text strings in a selection of objects. In addition to reformatting the code for this program, this updated version includes the ability to count MLeader text and Dimensions with a text override. Annotative text styles have also been taken into consideration when determining the size of the resultant table object.
Added Error Message Troubleshooter to the Tutorials page. This page provides a brief guide detailing the possible causes of a selection of common error messages received when executing an AutoLISP program.
Updated my Automatic Block Break program to Version 1.3. This update implements a complete change to the method used to detect intersections between the inserted block and surrounding objects, improving program performance. The new version of the program will now exclude attributes from the trimming operation, and will trim objects surrounding blocks whose insertion points do not lie on a curve object (in previous versions such objects were not trimmed). Finally, a new command: 'ABBS' (AutoBlockBreakSelection) has been added to allow users to make a selection of multiple blocks to be processed by the AutoBlockBreak subfunction.
Added Edit Box subfunction to the site. This very simple function utilises a predefined AutoCAD dialog definition to display an interface allowing the user to input a text string.
It has been almost a year since I have worked on my Batch Find & Replace Text program, and considering its apparent popularity amongst the other programs on my site, I felt it was about time that I updated it.
The majority of the program code has hence been rewritten and reformatted in line with my other more recent programs, and the following enhancements have been incorporated:
Added String Wrap function to the site. This subfunction will break a supplied string at spaces (if possible) into a list of substrings, each of a specified length or less.
Added set of Bulge Conversion Functions to the subfunction library. These functions demonstrate various methods to convert between the quantities used to define a Polyline Arc segment and those used to define an Arc Entity, with diagrammatic explanations of the calculations used in each method.
Updated List Box Synchronisation tutorial to fix a few typos.
Added set of List Box Functions to the subfunction library. These functions may be used to manipulate the order of multiple items in a DCL List Box, as demonstrated by my TabSort program and Layer Draw Order program.
Added Centered Measure program to the site. This program is designed to emulate the behaviour of the standard AutoCAD Measure command, however, the resultant measured intervals are centered on the selected object, as opposed to extending along the object from one end.
Added SubList function to the subfunction library. This subfunction is the list equivalent of the AutoLISP substr function, and will return the sublist of a supplied list from a specified starting index and with a specified length.
Added List Collinear-p, Coplanar-p and List Coplanar-p predicate functions to set of Geometric Functions. These functions offer the ability to test the collinearity of a list of points, or the coplanarity of four or more points.
Added Collinear-p and Perpendicular-p functions to set of Geometric Functions. These predicate functions may be used to test the collinearity of three points, or the perpendicularity of two vectors.
Updated Change Block Insertion program to Version 1.3. This version fixes a reported bug pertaining to the position of the selected block reference not being retained when nested in other blocks in the drawing. When called with 'CBIR', the program will now update the position of every reference of the selected block (nested to any level) in all block definitions.
Updated Layer Draw Order program to Version 1.2. This version allows the user to select specific layers for which to change the draw-order from a filterable list of non-XRef dependent layers, whilst retaining the inherent draw-order of entities on the other remaining layers in the drawing. Furthermore, selected layers may be ordered above or below the other layers in the drawing. A Help button is also included to assist the user.
Updated Layer Draw Order program to Version 1.1. This version increases the height of the layer list to ease use in drawings with a large number of layers. The updated program also offers the ability to add a wildcard pattern to the list of layers in order to group a set of layers matching the pattern.
Added Layer Draw Order program to the site. Similar to the Express Tools' CDOrder program, this program enables the user to control the draw order of all entities on each layer in a drawing, relative to other layers.
Added Parse Numbers function to the site. This function will extract numbers represented in decimal format from a supplied string, returning a list of all numerical values found in the string.
Added both a Visual & Vanilla LISP version of an Effective Block Name function to the site. These subfunctions demonstrate methods to obtain the true name of a block reference as per its associated block definition in the block collection of the drawing in which it resides.
Tweaked ArcSine and ArcCosine functions as part of the set of Trigonometric Functions to make the code more readable.
Added List Difference function to the site. This function will return a list expressing the difference or relative complement of two or more lists, that is, a list of items appearing exclusively in one list but not the other(s).
Added List Symmetric Difference function to the site. This subfunction will return a list expressing the symmetric difference of two or more lists, that is, a list of items appearing exclusively in each list and not in the intersection of any pair of lists.
Added List Union and List Intersection functions to the subfunction library section of the site. These functions will return a list expressing the union and intersection, respectively, of two or more supplied lists.
Added Line-Circle Intersection function to set of Geometric Functions. This function will return the point(s) of intersection between a line and a circle.
Added some extra functions to the Unique & Duplicate List Functions page. This page contains various functions engineered for manipulating lists in which items appear more than once.
Added List Box subfunction to the subfunction library of the programs page. This subfunction displays a dialog with a List Box interface enabling the user to select one or more items from the supplied data set.
Added Strikethrough Text program to the site. This program will create an LWPolyline passing through the centre of selected Text or MText objects to create a strikethrough text effect.
Updated set of Intersection Functions to include functions to return the intersection points between objects in a list, two sets, or two lists.
Updated Circle Break program to Version 1.2 following a received bug report.
Added RGB->HSL and HSL->RGB conversion functions to set of Colour Conversion Functions. These functions will convert between Red, Green, & Blue colour values and Hue, Saturation & Luminance values for the two colour models.
Updated Copy Block program once more to Version 1.2. I realised there was a much easier way to implement the transference of block properties from the source block to the copied block. This approach has consequently removed a lot of excess code from the previous version.
Completely rewrote my Copy Block program, which has now been updated to Version 1.1. This program will allow the user to copy and rename a block (which may be dynamic) in the working drawing. The program uses an ObjectDBX Document as an intermediary in which the block definition can be copied and renamed without resulting in a duplicate key in the Block Collection of the working drawing.
Added 'Preview' GIF animation to Copy Block page demonstrating program usage on a dynamic block example.
Updated the Change Block Insertion program to Version 1.2. This program was written around the same time (if not earlier) as my recently updated Add Objects to Block program. Hence this update carries forward many of the changes applied to that program.
Updated the Add Objects to Block program to Version 1.1. I first wrote the code for this program in June of last year and have now implemented knowledge I have since gained to remove some excess code from the program to hopefully streamline the process. The AddObjectstoBlock subfunction has also been rewritten to require a VLA Document Object parameter, enabling the developer to utilise the subfunction on blocks in arbitrary documents (i.e. also through ObjectDBX).
Updated the Align Text program to Version 1.1. Once again, removing excess code to increase the performance of the program and to bring the coding style in line with my other programs.
Added Popup subfunction to the site. This function uses the Popup method of the Windows Script Host Shell Object to display a customisable pop-up message box.
Added Permutations function to subfunction library. This recursive subfunction will return a list of all possible permutations of elements in a supplied list.
Added Insert Nth function to subfunction library. This function will insert an item at the nth position in a list.
Added Remove Items function to the site. This function will remove items at specified indexes from a list.
Added set of Geometric Functions to Mathematical functions page.
Added 3D Reflection function (including test functions) to set of Matrix Transformation Functions. This function will reflect a target (VLA-Object or List of 3D Points) in an arbitrary plane.
Added 3D Rotation function (including test functions) to set of Matrix Transformation Functions. This function will rotate a target (VLA-Object or List of 3D Points) by a given angle about an axis defined by two 3D points.
Added set of Base Conversion functions to demonstrate methods of converting a number between numeral systems using different bases or radixes.
Updated Directory Dialog subfunction to incorporate better error trapping and a more concise and structured code layout.
Updated Get All Files subfunction to remove excess code and hence improve performance and readability.
Updated subfunctions enabling the user to Add & Remove Support Paths to make the code more concise and readable.
Added Remove Once subfunction to the site, a function which enables the developer to remove the first occurrence of an item from a list.
Added Apply to Block Objects subfunction to the site. This subfunction will evaluate a supplied function on all objects in a block definition and return a list of the return of each function evaluation.
Tweaked site formatting to make table text on program pages more readable.
Added Update Titleblock Attributes program to the site. This program offers the ability to automatically update drawing titleblock attributes with values sourced from a CSV drawing register. When a drawing is opened, a CSV Drawing Register may be automatically read by the program, and titleblock attributes are updated using values corresponding to the drawing entry in the register.
Updated Select If subfunction to apply the optional predicate function to the entity selection list returned by the selection function, and also return this entity selection list; this provides the developer with the ability to use other elements in the selection list to validate the predicate function in addition to the selected entity name. An optional keyword argument (in the form of a list of parameters to be supplied to the initget function) is also included.
Added a selection of Clockwise-p subfunctions to determine whether three points are oriented clockwise; complete with brief explanations of the mathematical methods utilised by each function.
Added 'Jump To' quick navigation bar to sidepanel of site so that visitors can find what they need faster.
Updated TabSort program to Version 2.2. This program was written back in late 2009 and so I figured it needed a little updating. In the end, I decided to rewrite the entire program. I haven't added any new functionality, but the program should be more robust and run smoother than the previous version, with a few bugs squashed in the process. The Find and Replace engine has been completely overhauled, now permitting the user to use self-referencing find and replace terms (for example, replacing 'ABC' with 'AB'), and the visual feedback during the find and replace process has been improved significantly. With the vast number of changes to the program, I expect there are still a few bugs lurking, but in my preliminary tests, I haven't found anything as yet.
Added Object Lock program to the site - a purely academic piece of code demonstrating the ability to prevent modification of a set of objects using reactors.
Added Associative Centerlines program to the site. This reactor based program enables the user to create associative circle centerlines which will automatically update following modification of the associated circle.
Updated the set of Attribute Functions to remove case-sensitivity from the attribute tag argument and also add a couple of recursive variations to the Vanilla subfunctions.
Updated the set of Dynamic Block Functions to remove case-sensitivity from the dynamic block property argument.
Fixed a bug found in the Area Label program (updated to Version 1.8).
Added Area Label program to the site. This versatile program enables the user to annotate picked areas or selected objects with custom labels and either display the labels and associated areas in an AutoCAD Table Object, or write the data to file.
Added Steal from Drawing program to the site. This program allows the user to import (humourously: 'steal') items from another drawing into the current drawing. The user can choose to import multiple items from a list of Blocks, Layers, Linetypes, Dimension Styles, Text Styles, Table Styles, MLeader Styles, MLine Styles, Layouts, Page Setups, User Coordinate Systems, Views, Layer States & Scales.
Updated the ObjectDBX Wrapper subfunction and associated test function.
Added program to allow the user to dynamically align a selection of objects to a selected curve. The user is prompted to make a selection of objects to align to a selected curve, and a base point to use during alignment. The objects are then dynamically aligned to the curve in real-time, whilst the user may refine the alignment using additional controls offered at the command-line.