snapping to edges when invoking an enterBox

The easiest way to do this is to use the built-in snapping (or gravity) functions. Since not everyone has the same preferences for these, I would do the following:

1. get the current settings for the user
2. set the default gravity options for your command
3. run your enter function
4. reset the user's settings

            ;Get user settings
            gravity = envGetVal("layout" "gravityOn")
            depth   = envGetVal("layout" "gravityDepth")
            type    = envGetVal("layout" "gravityType")
            bouncex = envGetVal("layout" "gravityBounceX")
            bouncey = envGetVal("layout" "gravityBounceY")
            ;Set your commands preferences
            envSetVal("layout" "gravityOn"      'boolean t)
            envSetVal("layout" "gravityDepth"   'int     20)
            envSetVal("layout" "gravityType"    'string  "edge")
            envSetVal("layout" "gravityBounceX" 'float   0)
            envSetVal("layout" "gravityBounceY" 'float   0)
            ;
            ; Do your stuff here
            enterBox ...
            ;
            ;Reset to the user's settings
            envSetVal("layout" "gravityOn"      'boolean gravity)
            envSetVal("layout" "gravityDepth"   'int     depth)
            envSetVal("layout" "gravityType"    'string  type)
            envSetVal("layout" "gravityBounceX" 'float   bouncex)
            envSetVal("layout" "gravityBounceY" 'float   bouncey)

If your command errors out, you could end up changing the default gravity settings for the user (since the code doesn't made it to the reset step). To avoid this, you should probably wrap your command with errset to trap the error.

errset(enterBox(...) t)

Derek

i use the the code that you provided but the cursor point fails to snap on to edges... i also toggled the infix option in the bbox but no change was observed. in addition, in layout editor options i unclicked turn off infix in smart snapping, but still the same.

Here are some things you should try to get this working:

1. Test the gravity control settings in the leHiEditEditorOptions() form until you can get them to work the way you want for this command. Then set the appropriate cdsenv variables before and after your command.
2. One other variable you may need to set is the gravityAperture. Maybe this variable isn't big enough so you aren't seeing any significant snap. This setting indicates how close you need to get to an edge before snapping occurs. The code I sent left this at the default which is 0.3 as provided by Cadence.
envSetVal("layout" "gravityAperture" 'float   1.0)
3. You will not see the edges highlighted like when you are using the ruler command. I don't know how to enable this or if it is even possible. These settings will simply snap the cursor to an edge.
4. The settings I provided only enable snapping to edges. If you are wanting to snap to vertices or centerlines, you'll to update the gravityType string.
5. The layers must be selectable for snapping to work.

I hope this helps.

Derek

It's probably a little bit late, but maybe it will help others:

You have to give the enterBox function a cmdName and then use leRegisterUseGravity to enable gravity for this command.

Example:

 enterBox(
      ?cmdName "mbMultiLayerRect"
      ?prompts list("Enter the first corner of your box."
                   "Enter the last corner of your box.")
      ?doneProc "boxDone"
      ?formProc "boxForm"
      ?alwaysMap t
      ?form eval(mbMultiLayerDrawForm)
      )

leRegisterUseGravity("mbMultiLayerRect")