The cpdf_save() function saves the current environment. It works like the postscript command gsave. Very useful if you want to translate or rotate an object without effecting other objects. Returns TRUE on success or FALSE on failure.
See also cpdf_restore().