The cpdf_clip() function clips all drawing to the current path. Returns TRUE on success or FALSE on failure.