ref: 0f56516d9cee6b74ea56a3963fa2b508f286c63f
dir: /sys/lib/troff/font/devutf/charlib/LH.example/
%
% An example logo character. Building the PostScript program that prints
% your company logo is not addressed here; we assume you already have
% such a program, that it's relatively simple, and that it prints the
% logo by itself on a page. What you'll find here are instructions for
% converting that logo program into a character that can be accessed by
% troff and dpost.
%
% Building a new charlib character involves some PostScript programming.
% We've tried to isolate parameters that you'll need to change (Xoffset,
% Yoffset, and Scaling), but we can't guarantee things will work properly
% with every logo program. PostScript is a complex language and subtle
% interactions between your logo program and what we've done here can
% cause problems.
%
% Tuning the new character is an iterative process. You may want to adjust
% the size of the logo (via Scaling), it's position relative to adjacent
% characters and the baseline (Xoffset and Yoffset), and the distance troff
% moves after printing the character (width field in file ../S1). The steps
% to follow are:
%
% 1: Create a simple troff test file for the new character. Something
% like,
%
% .sp 1i
% .ps 10
% size 10: \(LH
% .sp 1i
% .ps 18
% size 18: \(LH
% .sp 1i
% .ps 36
% size 36: \(LH
% .sp 1i
% .ps 10
% four logo characters: \(LH\(LH\(LH\(LH
%
% is sufficient. The test file can go anywhere.
%
% 2: Change into directory /usr/lib/font/devpost/charlib. All file
% pathnames will be relative to that directory.
%
% 3: Save a copy of the working LH logo file. Then replace LH with
% this file (i.e. LH.example). Changes described below should be
% be made in the new LH file (not in LH.example).
%
% 4: Your PostScript logo program will eventually replace whatever
% you find between the <<StartLogo>> and <<EndLogo>> comment lines
% in the PostScript build_LH procedure (below). What's there now
% prints an example logo that you can use until you understand the
% remaining steps.
%
% 5: Print your troff test file using (assuming your making changes
% in the devpost charlib directory),
%
% troff -Tpost testfile | dpost | lp ...
%
% 6: Adjust the logo positioning by changing the numbers assigned to
% Xoffset and Yoffset (below). Both are in units of 72 per inch.
% Positive offsets should move the logo to the right and up the
% page.
%
% 7: Adjust the logo size by changing the the number assigned to
% Scaling. Unitsize also controls scaling, but there's no good
% reason to change both Scaling and Unitsize.
%
% 8: Control the horizontal distance troff moves after printing the
% new LH character by changing the width (i.e. the number in the
% second column) assigned to LH in file ../S1. Character width
% adjustments should probably wait until you're satisfied with
% the Scaling set in step 7.
%
% 9: Back to step 5 until your satisfied with the output.
%
% The remaining steps are suggested but not required:
%
% 10: Delete PostScript comments in your new LH charlib file - comments
% start with % and go to the end of the line.
%
% 11: Update the width field assigned to LH in file ../shell.lib. The
% new width should reflect what's currently in your S1 font file.
%
% 12: Make a similiar set of changes in /usr/lib/font/devLatin1/charlib.
% You can use the devpost version of LH to devLatin1/charlib/LH,
% but changes to files devLatin1/S1 and devLatin1/shell.lib must be
% entered by hand.
%
/Logo_Dict 100 dict dup begin
/Xoffset 0 def % 72 dpi with positive to the right
/Yoffset 0 def % 72 dpi with positive up the page
/Scaling 1.0 def % adjust this number to change the size
/Unitsize 36 def % for point size scaling - leave it be
/showpage {} def
end def
/build_LH { % don't bind this procedure
Logo_Dict begin
gsave
/charwidth exch def
currentpoint translate
resolution 72 div dup scale
Xoffset Yoffset translate
Scaling Scaling scale
ptsize Unitsize div dup scale
%% Replace everything between the <<StartLogo>> and <<EndLogo>>
%% comment lines by the PostScript program that prints your
%% logo.
%% <<StartLogo>>
newpath
.5 .5 scale
0 0 moveto
100 0 lineto
100 100 lineto
closepath
.5 setgray
fill
0 setgray
10 10 translate
45 rotate
0 5 moveto
/Helvetica findfont 18 scalefont setfont
(Example Logo) show
%% <<EndLogo>>
grestore
end
} def