Subject: Understanding SDS compatibility



The primary difference between ADS and SDS is that all SDS functions have an sds_ prefix, and ADS functions have a variety of prefixes, such as ads_, acad_, and acrx_. The exception is dialog-related SDS functions, which have a dlg_ prefix. CADdirect accepts either prefix. Other differences include the additional SDS functions listed in the following table.

SDS functions with no ADS equivalent

SDS function name

Description

sds_grclear

Clears all graphics from the drawing window; similar to the LISP (grclear) function.

sds_name_clear

Clears the entity name or selection set.

sds_name_equal

Verifies whether two entity names or selection sets are equal.

sds_name_nil

Verifies whether the entity name or selection set has been cleared.

sds_name_set

Copies one entity name or selection set to another drawing.

sds_pmtssget

Similar to the ads_ssget function, but allows you to display a prompt appropriate for the specific command, rather than the generic “Select object” prompt.

sds_point_set

Copies a point from one variable to another.

sds_progresspercent

Displays the percentage done in a progress bar.

sds_progressstart

Starts the progress bar.

sds_progressstop

Ends the progress bar.

sds_readaliasfile

Loads the PGP file into CADdirect.

sds_sendmessage

Sends a message to the CADdirect command line.

sds_swapscreen

Flips the off-screen device context to the display.

Some ADS functions are not supported in SDS, including: ads_arxload, ads_arxloaded, ads_arxunload, ads_ssgetx, ads_ssGetKwordCallbackPtr, ads_ssGetOtherCallbackPtr, adsw_acadMainWnd, and adsw_acadDocWnd.

To automatically run an SDS custom application when CADdirect starts

   1   Create an ASCII file named icad.sds that contains the path to the .dll files on each line of the file.

   2   Place icad.sds in the same folder as icad.exe.

   3   Run CADdirect.

For more information

   Read the online documentation for SDS functions.

   See the \CADdirect\Api\Sds folder, which contains the SDS include, header, and library files.

   See the \CADdirect\Api\Dcl folder, which contains the core DCL files.

Understanding_SDS_compatibility
© Copyright 2022. BackToCAD Technologies LLC. All rights reserved. Kazmierczak® is a registered trademark of Kazmierczak Software GmbH. Print2CAD, CADdirect, CAD.direct, CAD Direct, CAD.bot, CAD Bot, are Trademarks of BackToCAD Technologies LLC. DWG is the name of Autodesk’s proprietary file format and technology used in AutoCAD® software and related products. Autodesk, the Autodesk logo, AutoCAD, DWG are registered trademarks or trademarks of Autodesk, Inc. All other brand names, product names, or trademarks belong to their respective holders. This website is independent of Autodesk, Inc., and is not authorized by, endorsed by, sponsored by, affiliated with, or otherwise approved by Autodesk, Inc. The material and software have been placed on this Internet site under the authority of the copyright owner for the sole purpose of viewing of the materials by users of this site. Users, press or journalists are not authorized to reproduce any of the materials in any form or by any means, electronic or mechanical, including data storage and retrieval systems, recording, printing or photocopying.