find-snip

   

  Returns the snip at a given position or null is an appropriate snip cannot be found.

• (send a-wx:media-edit find-snip pos direction s-pos) ->  wx:snip% object or null
      pos : small integer
      direction : small integer
      s-pos = null : boxed small integer or null

  If the position pos is between two snips, direction specifies which snip to return; direction can be any of the following:

  •  wx:const-snip-before-or-null -- returns the snip before the position, or null if pos is 0
  •  wx:const-snip-before -- returns the snip before the position, or the first snip if pos is 0
  •  wx:const-snip-after -- returns the snip after the position, or the last snip if pos is the last position
  •  wx:const-snip-after-or-null - returns the snip after the position, or null if pos is the last position are larger

  The s-pos box is filled with the position where the returned snip starts, unless s-pos is null.