integer band.AddToBandEndpoint(integer segmentIndex, integer bandIndex, [integer atomIndex])
Add a band to the endpoint of an existing band. Returns band number.
V1 Function Name
New to V2

band.AddToBandEndpoint adds a band that terminates at the same endpoint as an existing band.

The existing band can either a segment-to-segment band or a spaceband.

The new band has a goal length of 3.5 Angstroms and a strength of 1.0.

Symmetry puzzles are one application for band.AddToBandEndpoint. There's no way to create bands that begin on one of the symmetric copies of the protein in a symmetry puzzle. Bands must begin on the main copy of the protein. Also, a recipe can't create bands that end on a symmetric copy of the porotein.

The user can manually add bands from the main copy to points on the symmetric copies. A recipe can then use band.AddToBandEndpoint to create bands that begin on the main copy and end on one of the symmetric copies.

band.AddToBandEndpoint can also be used in a similar manner in other scenarios. Band endpoints can be used to identify interesting points on a protein or a ligand, and then recipes can create new bands to these end points.

As an example, the code below adds a band to empty space from segment 2 of the protein. It then uses the band.AddToBandEndpoint to add a second band from segment 10 of the protein to the same endpoint in space.

local band1 = band.Add ( 2, 1, 3, 20, 0, 0 )
if band1 ~= 0 then
    band.AddToBandEndpoint ( 10, band1 )

See also band.Add and band.AddBetweenSegments.