Visual LISP Extensions to AutoLISP

Before using the AutoLISP extensions, issue the following command: (vl-load-com) The vl-load-com function also initializes ActiveX support for AutoLISP

Visual LISP Function Reference Chart

Collection Manipulation Functions

(vlax-for symbol collection [expression1 [expression2 ...]]) (vlax-map-collection obj function)

AutoLISP Functions
Basic Functions
Arithmetic Symbol-Handling Functions
(float number) (gcd int1 int2) (log number) (logand int int ...) (logior int int ...) (lsh int numbits) (max number number ...) (min number number ...) (minusp number) (rem num1 num2 ...) (sin ang) (sqrt number) (zerop number) (atom item) (atoms-family format [symlist]) (boundp sym) (not item) (null item) (numberp item) (quote expr) (read [string]) (set sym expr) (setq sym1 expr1 [sym2 expr2] ...) (type item) (vl-symbol-name symbol) (vl-symbol-value symbol) (vl-symbolp object) (+ [number number] ...) (- [number number] ...) (* [number number] ...) (/ [number number] ...) (~ int) (1+ number) (1- number) (abs number) (atan num1 [num2]) (cos ang) (exp number) (expt base power) (fix number)

Curve Measurement Functions

(vlax-curve-getArea curve-obj) (vlax-curve-getDistAtParam curve-obj param) (vlax-curve-getDistAtPoint curve-obj point) (vlax-curve-getEndParam curve-obj) (vlax-curve-getEndPoint curve-obj) (vlax-curve-getParamAtDist curve-obj param) (vlax-curve-getParamAtPoint curve-obj point) (vlax-curve-getPointAtDist curve-obj dist) (vlax-curve-getPointAtParam curve-obj param) (vlax-curve-getStartParam curve-obj) (vlax-curve-getStartPoint curve-obj) (vlax-curve-isClosed curve-obj) (vlax-curve-isPeriodic curve-obj) (vlax-curve-isPlanar curve-obj) (vlax-curve-getClosestPointTo curve-obj givenPnt [extend]) (vlax-curve-getClosestPointToProjection curve-obj givenPnt normal [extend]) (vlax-curve-getFirstDeriv curve-obj param) (vlax-curve-getSecondDeriv curve-obj param)

List Manipulation Functions

(acad_strlsort lst) (append lst ...) (assoc item alist) (car lst) and (cdr lst) (cons new-first-element lst) (foreach name lst expr ...) (last lst) (length lst) (list expr ...) (listp item) (mapcar function list1 ... listn) (member expr lst) (nth n lst) (reverse lst) (subst newitem olditem lst) (vl-consp list-variable) (vl-every predicate-function list [more-lists]...) (vl-list* object [more-objects]...) (vl-list->string char-codes-list) (vl-list-length list-or-cons-object) (vl-member-if predicate-function list) (vl-member-if-not predicate-function list) (vl-position symbol list) (vl-remove element-to-remove list) (vl-remove-if predicate-function list) (vl-remove-if-not predicate-function list) (vl-some predicate-function list [more-lists]...) (vl-sort list less?-function) (vl-sort-i list less?-function) (vl-string->list string)

String-Handling Functions
(strcase string [which]) (strcat string1 [string2] ...) (strlen [string] ...) (substr string start [length]) (vl-prin1-to-string object) (vl-princ-to-string object) (vl-string-elt string position) (vl-string-left-trim character-set string) (vl-string-mismatch str1 str2 [pos1 pos2 ignore-case-p]) (vl-string-position char-code str [start-pos [from-end-p]]) (vl-string-right-trim character-set string) (vl-string-search pattern string [start-pos]) (vl-string-subst new-str pattern string [start-pos]) (vl-string-translate source-set dest-set str) (vl-string-trim char-set str) (vl-string->list string) (wcmatch string pattern)

Data Conversion Functions

(vlax-3D-point list) (vlax-3D-point x y [z]) (vlax-ename->vla-object entname) (vlax-make-variant value type) (vlax-safearray-fill var 'element-values) (vlax-safearray-get-dim var) (vlax-safearray-get-element var element) (vlax-safearray-get-l-bound var dim) (vlax-safearray-get-u-bound var dim) (vlax-safearray-put-element var element value) (vlax-safearray-type var) (vlax-safearray->list var) (vlax-tmatrix list) (vlax-variant-change-type var type) (vlax-variant-type var) (vlax-variant-value var) (vlax-vla-object->ename obj)

Equality & Conditional Functions

(= numstr [numstr] ...) (/= numstr [numstr] ...) (< numstr [numstr] ...) (<= numstr [numstr] ...) (> numstr [numstr] ...) (>= numstr [numstr] ...) (and expr ...) (Boole func int1 int2 ...) (cond (test1 result1 ...) ...) (eq expr1 expr2) (equal expr1 expr2 [fuzz]) (if testexpr thenexpr [elseexpr]) (or expr ...) (repeat int expr ...) (while testexpr expr ...)

Function-Handling Functions
(apply function lst) (defun sym argument-list expr ...) (eval expr) (lambda arguments expr ...) (progn [expr] ...) (trace function ...) (untrace function ...) (defun-q sym [arguments] [/variables...] expr ...) (defun-q-list-ref 'function) (defun-q-list-set 'sym)

Application-Handling Functions
(ads) (arx) (arxload application [onfailure]) (arxunload application [onfailure]) (autoarxload filename cmdlist) (autoload filename cmdlist) (autoxload filename cmdlist) (load filename [onfailure]) (startapp appcmd file) (vl-vbaload "filename") (vl-vbarun "macroname") (vlax-add-cmd "global-name 'func-sym ["local--name" cmd-flags])

Error-Handling Functions
(alert string) (*error* string) (exit) (quit) (vl-catch-all-apply 'function list) (vl-catch-all-error-message error-obj) (vl-catch-all-error-p arg)

Dictionary Functions
(vlax-ldata-delete dict key) (vlax-ldata-get dict key [default-data]) (vlax-ldata-list dict) (vlax-ldata-put dict key data) (vlax-ldata-test data)

Utility Functions
Query & Command Functions
(acad_colordlg colornum [flag]) (acad_helpdlg helpfile topic) (command [arguments] ...) (getcfg cfgname) (getcname cname) (getenv variable-name) (getvar varname) (help [helpfile [topic [command]]]) (setcfg cfgname cfgval) (setenv varname)
(setfunhelp function [helpfile [topic [command]]])

Memory Management Functions

File-Handling Functions
(close file-desc) (findfile filename) (open filename mode) (read-char [file-desc]) (read-line [file-desc]) (vl-directory-files [directory pattern directories]) (vl-file-copy "source-filename" "destination-filename" [append?]) (vl-file-delete "filename") (vl-file-directory-p "filename") (vl-file-rename "old-filename" "new-filename") (vl-file-size "filename") (vl-file-systime "filename") (vl-filename-base "filename") (vl-filename-directory "filename") (vl-filename-extension "filename") (vl-filename-mktemp ["pattern" "directory" "extension"]) (write-char num [file-desc]) (write-line string [file-desc])

Memory Management Functions

(alloc int) (expand number) (gc) (mem)

(setvar varname value) (ver) (vl-cmdf [arguments] ...)

(vlax-add-cmd global-name func-sym [local-name cmd-flags])

Reactor Functions
Reactor Functions
(vlr-acdb-reactor data callbacks) (vlr-add obj) (vlr-added-p obj) (vlr-beep-reaction [args]) (vlr-current-reaction-name) (vlr-data obj) (vlr-data-set obj data) (vlr-editor-reactor data callbacks) (vlr-linker-reactor data callbacks) (vl-load-reactors) (vlr-object-reactor owners data callbacks) (vlr-owner-add reactor owner) (vlr-owner-remove reactor owner) (vlr-owners reactor) (vlr-pers reactor) (vlr-pers-p reactor) (vlr-pers-release reactor) (vlr-reaction-names reactor-type) (vlr-reaction-set reactor event function) (vlr-reactions reactor) (vlr-reactors reactor-type) (vlr-remove reactor) (vlr-remove-all reactor-type) (vlr-trace-reaction any number of arguments) (vlr-type reactor) (vlr-types)

Method Invocation Functions

(vlax-invoke-method obj method list) (vlax-method-applicable-p obj method)

(vlax-remove-cmd global-name)

Display Control Functions

(graphscr) (grdraw from to color [highlight]) (grtext [box text [highlight]]) (grvecs vlist [trans]) (menucmd string) (menugroup groupname) (prin1 [expr [file-desc]]) (princ [expr [file-desc]]) (print [expr [file-desc]]) (prompt msg) (redraw [ename [mode]]) (terpri) (textpage) (textscr) (vports)

Object-Handling Functions
(vlax-create-object "prog-id") (vlax-dump-object obj) (vlax-erased-p obj) (vlax-get-acad-object) (vlax-get-object "prog-id") (vlax-import-type-library :tlb-filename filename [ :methods-prefix mprefix :properties-prefix pprefix :constants-prefix cprefix]) (vlax-method-applicable-p obj method) (vlax-object-released-p obj) (vlax-read-enabled-p obj) (vlax-release-object obj) (vlax-typeinfo-available-p obj) (vlax-write-enabled-p obj)

Selection Set, Object & Symbol Table Functions

Selection Set Manipulation Functions
(ssadd [ename [ss]]) (ssdel ename ss) (ssget [mode] [pt1 [pt2]] [pt-list] [filter-list]) (ssgetfirst) (sslength ss) (ssmemb ename ss) (ssname ss index) (ssnamex ss index) (sssetfirst gripset [pickset])

User Input Functions

(entsel [msg]) (getangle [pt] [msg]) (getcorner pt [msg]) (getdist [pt] [msg]) (getfiled title default ext flags) (getint [msg]) (getkword [msg]) (getorient [pt] [msg]) (getpoint [pt] [msg]) (getreal [msg]) (getstring [cr] [msg]) (initget [bits] [string]) (nentsel [msg]) (nentselp [msg] [pt])

Object (Entity)-Handling Functions

(entdel ename) (entget ename [applist]) (entlast) (entmake [elist]) (entmakex [elist]) (entmod elist) (entnext [ename]) (entupd ename) (handent handle) (vlax-dump-object obj) (vlax-erased-p obj) (vlax-get-acad-object) (vlax-method-applicable-p obj method) (vlax-object-released-p obj) (vlax-read-enabled-p obj) (vlax-release-object obj) (vlax-typeinfo-available-p obj) (vlax-write-enabled-p obj)

VLX Namespace Functions

VLX Namespace Functions
(vl-arx-import [function | application]) (vl-doc-export 'function) (vl-doc-import ['function | application]) (vl-doc-ref symbol) (vl-doc-set symbol value) (vl-exit-with-error "msg") (vl-exit-with-value value) (vl-list-exported-functions "appname") (vl-list-loaded-vlx) (vl-unload-vlx "appname") (vlx-loaded-p "appname")

Property-Handling Functions
(vlax-get-property obj property) (vlax-property-available-p obj prop [T]) (vlax-put-property obj property arg)

Geometric Functions
(angle pt1 pt2) (distance pt1 pt2) (inters pt1 pt2 pt3 pt4 [onseg]) (osnap pt mode) (polar pt ang dist) (textbox elist)

Extended Data-Handling Functions

(regapp application) (xdroom ename) (xdsize lst)

Namespace Communication Functions

Namespace Communication Functions
(vl-bb-ref 'variable) (vl-bb-set 'variable value) (vl-load-all "filename") (vl-propagate 'variable)

Conversion Functions
(angtof string [mode]) (angtos angle [mode [precision]]) (ascii string) (atof string) (atoi string) (chr integer) (cvunit value from to) (distof string [mode]) (itoa int) (rtos number [mode [precision]]) (trans pt from to [disp])

Symbol Table & Dictionary-Handling Functions

(dictadd ename symbol newobj) (dictdel ename symbol) (dictnext ename symbol [rewind]) (dictrename ename oldsym newsym) (dictsearch ename symbol [setnext]) (namedobjdict) (setview view_description [vport_id]) (snvalid sym_name) (tblnext table-name [rewind]) (tblobjname table-name symbol) (tblsearch table-name symbol [setnext]) (vlax-ldata-delete dict key) (vlax-ldata-get dict key [default-data]) (vlax-ldata-list dict) (vlax-ldata-put dict key data) (vlax-ldata-test data)

Windows Registry Functions

Windows Registry Functions
(vlax-product-key) (vl-registry-read reg-key [val-name]) (vl-registry-delete reg-key [val-name]) (vl-registry-write reg-key [val-name val-data]) (vl-registry-descendents reg-key [val-names])

Device Access Functions

Built with

(grread [track] [allkeys [curtype]])

(tablet code [row1 row2 row3 direction])

For more information on AutoCAD Developer Tools and Marketing Programs, go online to www. autodesk.com
Autodesk, the Autodesk logo, AutoCAD, and AutoLISP are registered trademarks, and ObjectARX, the Built with ObjectARX logo, and Visual LISP are trademarks of Autodesk, Inc., in the USA and/or other countries. ActiveX is a trademark of Microsoft Corporation. 1999 Autodesk, Inc. All rights reserved. 18420-010000-3161