PS ps_begin_page

(PECL ps >= 1.1.0)

ps_begin_page — 새 페이지 시작


설명

ps_begin_page(resource $psdoc, float $width, float $height): bool

새 페이지를 시작합니다. widthheight 매개변수는 페이지마다 다른 페이지 크기를 의미하지만 PostScript에서는 불가능합니다. ps_begin_page()의 첫 번째 호출은 전체 문서의 페이지 크기를 설정합니다. 연속 호출은 새 페이지를 만드는 것 외에는 아무 효과가 없습니다. PostScript 문서를 PDF로 변환하려는 경우 상황이 다릅니다. 이 함수는 각 페이지의 크기를 개별적으로 설정할 수 있는 문서에 pdfmarks를 배치합니다. 결과 PDF 문서의 페이지 크기가 다릅니다.

PostScript는 다른 페이지 크기를 알지 못하지만 pslib는 각 페이지에 대한 경계 상자를 문서에 배치합니다. 이 크기는 일부 PostScript 뷰어에 의해 평가되며 문서 헤더의 BoundingBox보다 우선합니다. 페이지의 경계 상자는 항상 왼쪽 아래 모서리(0, 0)를 가지며 전역 설정을 덮어쓰기 때문에 왼쪽 아래 모서리가 (0, 0)이 아닌 BoundingBox를 설정할 때 예기치 않은 결과가 발생할 수 있습니다.

각 페이지는 저장/복원으로 캡슐화됩니다. 즉, 한 페이지에서 설정한 대부분의 설정이 다음 페이지에서 유지되지 않습니다.

ps_begin_page()의 첫 번째 호출이 있고 ps_findfont()의 호출이 없는 경우 PostScript 문서의 헤더가 출력되고 경계 상자가 첫 번째 페이지의 크기로 설정됩니다. 경계 상자의 왼쪽 아래 모서리는 (0, 0)으로 설정됩니다. ps_findfont()가 이전에 호출된 경우 헤더가 이미 출력되었으며 문서에는 유효한 경계 상자가 없습니다. 이를 방지하려면 ps_findfont() 또는 ps_begin_page() 호출 전에 정보 필드 BoundingBox 및 가능하면 Orientation을 설정하기 위해 ps_set_info()를 호출해야 합니다.

메모: pslib 버전 0.2.6까지 이 함수는 이전에 ps_set_info()로 설정되었고 ps_findfont()가 이전에 호출되지 않은 경우 항상 BoundingBox 및 Orientation을 덮어씁니다.


매개변수

psdoc
ps_new()에 의해 반환된 포스트스크립트 파일의 리소스 식별자입니다.
width
픽셀 단위의 페이지 너비입니다. 예: A4 형식의 경우 596입니다.
height
픽셀 단위의 페이지 높이(예: A4 형식의 경우 842입니다.

반환 값

성공하면 true를, 실패하면 false를 반환합니다.


기타