map_dwgtrimobj

Trims linear objects inside or outside of a specified boundary.

int

map_dwgtrimobj(

ads_name ssclip,

ads_name boundary,

int inorout,

int skiptopo,

int keepod,

int bitflag,

ads_name ssreturn);

Returns RTNORM or RTERROR.

ssclip	Selection set of objects to trim.
boundary	Entity name of a boundary object. Valid objects: a single circle or a single closed 2D polyline.
inorout	Trim flag: 1 Trim outside boundary 0 Trim inside boundary
skiptopo	Skip flag: 1 Skip objects referenced by a topology 0 Trim objects referenced by a topology
keepod	Keep flag that sets whether to keep object data of trimmed objects in result object: 1 Drop object data from all trimmed objects 0 Retain object data on all trimmed objects
bitflag	Bit flag that sets the way to handle objects that cannot be trimmed: 0 Delete these objects within or on trim boundary 1 Ignore these objects within or on trim boundary 2 Reference the insertion point of any of these objects within or on trim boundary
ssreturn	A selection set of trimmed objects.

The following example prompts you to select an object to trim and make choices about the trim operation. It includes error reporting.

ads_name sscut, boundary, result;
ads_point point;
int ret, nb, i, skiptopo, keepod, inorout, bitflag;
char kword[50];
 
ads_printf ("\nSelect objects to trim  : ");
if (ads_ssget (NULL, NULL, NULL, NULL, sscut) != RTNORM)
      return; 
 
if (ads_entsel ("\nSelect boundary object : ", boundary, point) != RTNORM) {
      ads_ssfree (sscut); 
      return; 
}
 
ads_initget (0, "Yes No");
ret = ads_getkword ("\nSkip objects referenced by a topology Yes/No <Yes> : ", kword);
if (ret != RTNORM && ret != RTNONE) {
      ads_ssfree (sscut); 
      return; 
}
 
if (ret == RTNONE || kword[0] == 'Y')
      skiptopo = 1; 
else
      skiptopo = 0; 
 
ads_initget (0, "Yes No");
ret = ads_getkword ("\nRetain object data Yes/No <Yes> : ", kword);
if (ret != RTNORM && ret != RTNONE) {
      ads_ssfree (sscut); 
      return; 
}
 
if (ret == RTNONE || kword[0] == 'Y')
      keepod = 0; 
else
      keepod = 1; 
 
ads_initget (RSG_NONULL, "Inside Outside");
ret = ads_getkword ("\nTrim Inside or Outside : ", kword);
if (ret != RTNORM) {
      ads_ssfree (sscut); 
      return; 
}
 
if (kword[0] == 'I')
      inorout = 0; 
else
      inorout = 1; 
 
ads_initget (0, "Delete Ignore insertionPoint");
ret = ads_getkword ("\nObjects that cannot be trimmed Delete/Ignore/insertionPoint : ", kword);
if (ret != RTNORM && ret != RTNONE) {
      ads_ssfree (sscut); 
      return; 
}
 
if (ret == RTNONE || kword[0] == 'P')
      bitflag = 2; 
else if (kword[0] == 'I')
      bitflag = 1; 
else
      bitflag = 0; 
 
ret = map_dwgtrimobj (sscut, boundary, inorout, skiptopo, keepod, bitflag, result);
if (ret == RTNORM) {
      ads_printf ("\nObject(s) successfully trimmed."); 
      ads_ssfree (result); 
}
else {
      nb = ade_errqty (); 
      for (i = 0; i < nb; i ++) 
            ads_printf ("\nError %d of %d : %s", i + 1, nb, ade_errmsg (i)); 
}
ads_ssfree (sscut);