/**
* Opens a new 'object' (template in PDFLib-speak)
*
* While an object is open, all drawing actions are recorded to the
* object instead of being drawn on the current page. Objects can
* be added later to a specific page or to several pages.
*
* The return value is an integer ID for the new object.
*
* @see PDFLib_Adapter::close_object()
* @see PDFLib_Adapter::add_object()
*
* @return int
*/
function open_object() {
$this->_pdf->suspend_page("");
$ret = $this->_pdf->begin_template($this->_width, $this->_height);
$this->_pdf->save();
$this->_objs[$ret] = array("start_page" => $this->_page_number);
return $ret;
}
