sp_clip_left

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

sp_clip_left() gets or sets the number of pixels to clip off of the left of the active_sprite's sequence and frame. If the active_sprite changes sequence or frame, the clipping will remain.

This is similar to sp_clip_top(), but differs to the way sp_clip_bottom() and sp_clip_right() work, where the set value is the number of pixels to be visible, and any exceeding that value will be clipped.

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)
{
 //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 clip 10 pixels off the left of the sprite.
 sp_clip_left(&current_sprite, 10);
}

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