sp_clip_bottom

Prototypeint sp_clip_bottom(int active_sprite, int pixels[-1])

sp_clip_bottom() gets or sets the number of pixels of the active_sprite's sequence and frame that will be visible (any pixels exceeding the value will be clipped off the bottom). If the active_sprite changes sequence or frame, the clipping will remain.

This is similar to sp_clip_right(), but differs to the way sp_clip_top() and sp_clip_left() work, where the set value is the number of pixels to be clipped off.

It should also be noted that clipping has to be initialized, otherwise it will not work.
To initiliase clipping an initial sp_clip_bottom and sp_clip_right() value must be set, with the value being equal to or greater than the sprite's dimensions.

Example:

void main(void)
{
 //In this example, &current_sprite is a sprite 90 pixels in height and we want to clip 10 pixels from the bottom.
 
 //First intialize clipping - rather than measuring the sprite, we can just initliase it to the size of the screen
 //as long as the value is equal to or greater than the sprite's dimensions, it will initialize the clipping.
 sp_clip_right(&current_sprite, 640);
 sp_clip_bottom(&current_sprite, 480);
 
 //now the actual clipping. This will make the first 80 pixels visible, and clip the reamining 10 from the bottom.
 sp_clip_bottom(&current_sprite, 80);
}

This is equivalent to the clipping possible in the map editor.