original_string: function newPage($insert = 0, $id = 0, $pos = 'after')
      {
          // if there is a state saved, then go up the stack closing them
          // then on the new page, re-open them with the right setings
  
          if ($this->nStateStack) {
              for ($i = $this->nStateStack; $i >= 1; $i--) {
                  $this->restoreState($i);
              }
          }
  
          $this->numObj++;
  
          if ($insert) {
              // the id from the ezPdf class is the id of the contents of the page, not the page object itself
              // query that object to find the parent
              $rid = $this->objects[$id]['onPage'];
              $opt = array('rid' => $rid, 'pos' => $pos);
              $this->o_page($this->numObj, 'new', $opt);
          } else {
              $this->o_page($this->numObj, 'new');
          }
  
          // if there is a stack saved, then put that onto the page
          if ($this->nStateStack) {
              for ($i = 1; $i <= $this->nStateStack; $i++) {
                  $this->saveState($i);
              }
          }
  
          // and if there has been a stroke or fill color set, then transfer them
          if (isset($this->currentColor)) {
              $this->setColor($this->currentColor, true);
          }
  
          if (isset($this->currentStrokeColor)) {
              $this->setStrokeColor($this->currentStrokeColor, true);
          }
  
          // if there is a line style set, then put this in too
          if (mb_strlen($this->currentLineStyle, '8bit')) {
              $this->addContent("\n$this->currentLineStyle");
          }
  
          // the call to the o_page object set currentContents to the present page, so this can be returned as the page id
          return $this->currentContents;
      }
code: function newPage($insert = 0, $id = 0, $pos = 'after')
      {
          // if there is a state saved, then go up the stack closing them
          // then on the new page, re-open them with the right setings
  
          if ($this->nStateStack) {
              for ($i = $this->nStateStack; $i >= 1; $i--) {
                  $this->restoreState($i);
              }
          }
  
          $this->numObj++;
  
          if ($insert) {
              // the id from the ezPdf class is the id of the contents of the page, not the page object itself
              // query that object to find the parent
              $rid = $this->objects[$id]['onPage'];
              $opt = array('rid' => $rid, 'pos' => $pos);
              $this->o_page($this->numObj, 'new', $opt);
          } else {
              $this->o_page($this->numObj, 'new');
          }
  
          // if there is a stack saved, then put that onto the page
          if ($this->nStateStack) {
              for ($i = 1; $i <= $this->nStateStack; $i++) {
                  $this->saveState($i);
              }
          }
  
          // and if there has been a stroke or fill color set, then transfer them
          if (isset($this->currentColor)) {
              $this->setColor($this->currentColor, true);
          }
  
          if (isset($this->currentStrokeColor)) {
              $this->setStrokeColor($this->currentStrokeColor, true);
          }
  
          // if there is a line style set, then put this in too
          if (mb_strlen($this->currentLineStyle, '8bit')) {
              $this->addContent("\n$this->currentLineStyle");
          }
  
          // the call to the o_page object set currentContents to the present page, so this can be returned as the page id
          return $this->currentContents;
      }
code_tokens: function newPage ( $ insert = 0 , $ id = 0 , $ pos = 'after' ) { // if there is a state saved, then go up the stack closing them // then on the new page, re-open them with the right setings if ( $ this -> nStateStack ) { for ( $ i = $ this -> nStateStack ; $ i >= 1 ; $ i -- ) { $ this -> restoreState ( $ i ) ; } } $ this -> numObj ++ ; if ( $ insert ) { // the id from the ezPdf class is the id of the contents of the page, not the page object itself // query that object to find the parent $ rid = $ this -> objects [ $ id ] [ 'onPage' ] ; $ opt = array ( 'rid' => $ rid , 'pos' => $ pos ) ; $ this -> o_page ( $ this -> numObj , 'new' , $ opt ) ; } else { $ this -> o_page ( $ this -> numObj , 'new' ) ; } // if there is a stack saved, then put that onto the page if ( $ this -> nStateStack ) { for ( $ i = 1 ; $ i <= $ this -> nStateStack ; $ i ++ ) { $ this -> saveState ( $ i ) ; } } // and if there has been a stroke or fill color set, then transfer them if ( isset ( $ this -> currentColor ) ) { $ this -> setColor ( $ this -> currentColor , true ) ; } if ( isset ( $ this -> currentStrokeColor ) ) { $ this -> setStrokeColor ( $ this -> currentStrokeColor , true ) ; } // if there is a line style set, then put this in too if ( mb_strlen ( $ this -> currentLineStyle , '8bit' ) ) { $ this -> addContent ( "\n$this->currentLineStyle" ) ; } // the call to the o_page object set currentContents to the present page, so this can be returned as the page id return $ this -> currentContents ; }
docstring: add a new page to the document
  this also makes the new page the current active object
  
  @param int $insert
  @param int $id
  @param string $pos
  @return int
docstring_tokens: add a new page to the document this also makes the new page the current active object