PS ps_findfont

(PECL ps >= 1.1.0)

ps_findfont — Loads a font


설명

ps_findfont(
    resource $psdoc,
    string $fontname,
    string $encoding,
    bool $embed = false
): int
                

나중에 사용할 수 있도록 글꼴을 로드합니다. 로드된 글꼴로 텍스트를 출력하기 전에 ps_setfont()로 설정해야 합니다. 이 함수는 문자가 사용하는 공간을 계산하기 위해 어도비 글꼴 메트릭 파일이 필요합니다. 페이지 내에 로드된 글꼴은 해당 페이지에서만 사용할 수 있습니다. 전체 문서에 사용될 글꼴은 ps_begin_page()의 첫 번째 호출 전에 로드되어야 합니다. 페이지 간에 ps_findfont()를 호출하면 해당 글꼴을 다음 페이지에서 모두 사용할 수 있습니다.

afm 파일의 이름은 fontname.afm이어야 합니다. 글꼴이 포함되어야 하는 경우 글꼴 개요가 포함된 fontname.pfb 파일도 있어야 합니다.

첫 페이지 전에 ps_findfont()를 호출하면 전체 문서에 대한 BoundingBox를 포함하는 포스트스크립트 헤더를 출력해야 합니다. 일반적으로 BoundingBox는 ps_findfont() 다음에 오는 ps_begin_page()의 첫 번째 호출로 설정됩니다. 결과적으로 BoundingBox가 설정되지 않았으며 ps_findfont()가 호출될 때 경고가 발행됩니다. 이러한 상황을 방지하려면 ps_findfont()가 호출되기 전에 ps_set_parameter()를 호출하여 BoundingBox를 설정해야 합니다.


매개변수

psdoc
ps_new()에 의해 반환된 포스트스크립트 파일의 리소스 식별자입니다.
fontname
글꼴의 이름입니다.
encoding
ps_findfont()는 매개변수 encoding으로 전달된 파일을 로드하려고 시도합니다. 인코딩 파일은 dvips(1)에서 사용하는 것과 동일한 구문입니다. 여기에는 글꼴 인코딩 벡터(현재 사용되지는 않지만 반드시 있어야 함)와 afm 파일에서 파생된 합자 목록을 확장하기 위한 추가 합자 목록이 포함되어 있습니다.

encodingnull이거나 기본 인코딩(TeXBase1)이 사용되는 경우 빈 문자열일 수 있습니다.

인코딩이 builtin으로 설정되어 있으면 다시 인코딩하지 않고 글꼴별 인코딩이 사용됩니다. 이것은 기호 글꼴에 매우 유용합니다.

embed
값을 >0으로 설정하면 글꼴이 문서에 포함됩니다. 이를 위해서는 글꼴 윤곽(.pfb 파일)이 있어야 합니다.

반환 값

글꼴의 식별자를 반환하거나 오류가 있는 경우 0을 반환합니다. 식별자는 양수입니다.


기타