1/*
2 * CDDL HEADER START
3 *
4 * The contents of this file are subject to the terms of the
5 * Common Development and Distribution License, Version 1.0 only
6 * (the "License").  You may not use this file except in compliance
7 * with the License.
8 *
9 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
10 * or http://www.opensolaris.org/os/licensing.
11 * See the License for the specific language governing permissions
12 * and limitations under the License.
13 *
14 * When distributing Covered Code, include this CDDL HEADER in each
15 * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
16 * If applicable, add the following below this CDDL HEADER, with the
17 * fields enclosed by brackets "[]" replaced with your own identifying
18 * information: Portions Copyright [yyyy] [name of copyright owner]
19 *
20 * CDDL HEADER END
21 */
22/*
23 * Copyright 2005 Sun Microsystems, Inc.  All rights reserved.
24 * Use is subject to license terms.
25 */
26
27/*	Copyright (c) 1984, 1986, 1987, 1988, 1989 AT&T	*/
28/*	  All Rights Reserved  	*/
29
30
31#pragma ident	"%Z%%M%	%I%	%E% SMI"
32
33/*
34 *
35 * PostScript picture inclusion routines. Support for managing in-line pictures
36 * has been added, and works in combination with the simple picpack pre-processor
37 * that's supplied with this package. An in-line picture begins with a special
38 * device control command that looks like,
39 *
40 *		x X InlinPicture name size
41 *
42 * where name is the pathname of the original picture file and size is the number
43 * of bytes in the picture, which begins immediately on the next line. When dpost
44 * encounters the InlinePicture device control command inlinepic() is called and
45 * that routine appends the string name and the integer size to a temporary file
46 * (fp_pic) and then adds the next size bytes read from the current input file to
47 * file fp_pic. All in-line pictures are saved in fp_pic and located later using
48 * the name string and picture file size that separate pictures saved in fp_pic.
49 *
50 * When a picture request (ie. an "x X PI" command) is encountered picopen() is
51 * called and it first looks for the picture file in fp_pic. If it's found there
52 * the entire picture (ie. size bytes) is copied from fp_pic to a new temp file
53 * and that temp file is used as the picture file. If there's nothing in fp_pic
54 * or if the lookup failed the original route is taken.
55 *
56 * Support for in-line pictures is an attempt to address requirements, expressed
57 * by several orginazations, of being able to store a document as a single file
58 * (usually troff input) that can then be sent through dpost and ultimately to
59 * a PostScript printer. The mechanism may help some users, but the are obvious
60 * disadvantages to this approach, and the original mechanism is the recommended
61 * approach! Perhaps the most important problem is that troff output, with in-line
62 * pictures included, doesn't fit the device independent language accepted by
63 * important post-processors (like proff) and that means you won't be able to
64 * reliably preview a packed file on your 5620 (or whatever).
65 *
66 */
67
68
69#include <stdio.h>
70
71#include "comments.h"			/* PostScript file structuring comments */
72#include "gen.h"			/* general purpose definitions */
73#include "path.h"			/* just for TEMPDIR definition */
74
75
76FILE	*fp_pic = NULL;			/* in-line pictures go here */
77FILE	*picopen();
78
79extern int	res, hpos, vpos;
80extern int	picflag;
81extern FILE	*tf;
82
83static void piccopy(FILE *, FILE *, long);
84
85/*****************************************************************************/
86
87
88void
89picture(char *buf)
90    /* stuff following 'x X PI' command */
91{
92    int		poffset;	/* page offset */
93    int		indent;		/* indent */
94    int		length;		/* line length  */
95    int		totrap;		/* distance to next trap */
96    char	name[100];	/* picture file and page string */
97    char	hwo[40], *p;	/* height, width and offset strings */
98    char	flags[20];	/* miscellaneous stuff */
99    int		page = 1;	/* page number pulled from name[] */
100    double	frame[4];	/* height, width, y, and x offsets from hwo[] */
101    char	units;		/* scale indicator for frame dimensions */
102    int		whiteout = 0;	/* white out the box? */
103    int		outline = 0;	/* draw a box around the picture? */
104    int		scaleboth = 0;	/* scale both dimensions? */
105    double	adjx = 0.5;	/* left-right adjustment */
106    double	adjy = 0.5;	/* top-bottom adjustment */
107    double	rot = 0;	/* rotation in clockwise degrees */
108    FILE	*fp_in;		/* for *name */
109    int		i;		/* loop index */
110
111    char	*strchr();
112
113
114/*
115 *
116 * Called from devcntrl() after an 'x X PI' command is found. The syntax of that
117 * command is:
118 *
119 *	x X PI:args
120 *
121 * with args separated by colons and given by:
122 *
123 *	poffset
124 *	indent
125 *	length
126 *	totrap
127 *	file[(page)]
128 *	height[,width[,yoffset[,xoffset]]]
129 *	[flags]
130 *
131 * poffset, indent, length, and totrap are given in machine units. height, width,
132 * and offset refer to the picture frame in inches, unless they're followed by
133 * the u scale indicator. flags is a string that provides a little bit of control
134 * over the placement of the picture in the frame. Rotation of the picture, in
135 * clockwise degrees, is set by the a flag. If it's not followed by an angle
136 * the current rotation angle is incremented by 90 degrees, otherwise the angle
137 * is set by the number that immediately follows the a.
138 *
139 */
140
141
142    if ( picflag == OFF )		/* skip it */
143	return;
144
145    endtext();
146
147    flags[0] = '\0';			/* just to be safe */
148    if ( sscanf(buf, "%d:%d:%d:%d:%[^:]:%[^:]:%[^:]", &poffset, &indent,
149		&length, &totrap, name, hwo, flags) < 6 )  {
150	    error(NON_FATAL, "too few arguments to specify picture");
151	    return;
152    }	/* End if */
153
154    if ( sscanf(name, "%*[^(](%d", &page) == 1 )	/* grab the page number */
155	strtok(name, "(");			/* and separate it from the name */
156
157    if ( (fp_in = picopen(name)) == NULL ) {
158	error(NON_FATAL, "can't open picture file %s", name);
159	return;
160    }	/* End if */
161
162    frame[0] = frame[1] = -1;		/* default frame height, width */
163    frame[2] = frame[3] = 0;		/* and y and x offsets */
164
165    for ( i = 0, p = hwo-1; i < 4 && p != NULL; i++, p = strchr(p, ',') )
166	if ( sscanf(++p, "%lf%c", &frame[i], &units) == 2 )
167	    if ( units == 'i' || units == ',' || units == '\0' )
168		frame[i] *= res;
169
170    if ( frame[0] <= 0 )		/* check what we got for height */
171	frame[0] = totrap;
172
173    if ( frame[1] <= 0 )		/* and width - check too big?? */
174	frame[1] = length - indent;
175
176    frame[3] += poffset + indent;	/* real x offset */
177
178    for ( i = 0; flags[i]; i++ )
179	switch ( flags[i] )  {
180	    case 'c': adjx = adjy = 0.5; break;	/* move to the center */
181	    case 'l': adjx = 0; break;		/* left */
182	    case 'r': adjx = 1; break;		/* right */
183	    case 't': adjy = 1; break;		/* top */
184	    case 'b': adjy = 0; break;		/* or bottom justify */
185	    case 'o': outline = 1; break;	/* outline the picture */
186	    case 'w': whiteout = 1; break;	/* white out the box */
187	    case 's': scaleboth = 1; break;	/* scale both dimensions */
188	    case 'a': if ( sscanf(&flags[i+1], "%lf", &rot) != 1 )
189			  rot += 90;
190	}   /* End switch */
191
192    fprintf(tf, "cleartomark restore\n");
193
194    ps_include(fp_in, tf, page, whiteout, outline, scaleboth,
195		frame[3]+frame[1]/2, -vpos-frame[2]-frame[0]/2, frame[1], frame[0], adjx, adjy, -rot);
196
197    fprintf(tf, "save mark\n");
198    xymove(hpos, vpos);
199    t_sf();
200
201    fclose(fp_in);
202
203}   /* End of picture */
204
205
206/*****************************************************************************/
207
208
209FILE *
210picopen(char *path)
211    /* picture file pathname */
212{
213    char	name[100];		/* pathnames */
214    long	total;			/* and sizes - from *fp_pic */
215    char	*tname;			/* pathname */
216    FILE	*fp;			/* and pointer for the new temp file */
217
218
219/*
220 *
221 * Responsible for finding and opening the next picture file. If we've accumulated
222 * any in-line pictures fp_pic won't be NULL and we'll look there first. If *path
223 * is found in *fp_pic we create another temp file, open it for update, unlink it,
224 * copy in the picture, seek back to the start of the new temp file, and return
225 * the file pointer to the caller. If fp_pic is NULL or the lookup fails we just
226 * open file *path and return the resulting file pointer to the caller.
227 *
228 */
229
230
231    if ( fp_pic != NULL )  {
232	fseek(fp_pic, 0L, 0);
233	while ( fscanf(fp_pic, "%s %ld\n", name, &total) != EOF )  {
234	    if ( strcmp(path, name) == 0 )  {
235		if ( (tname = tempnam(TEMPDIR, "dpost")) == NULL )
236		    error(FATAL, "can't generate temp file name");
237		if ( (fp = fopen(tname, "w+")) == NULL )
238		    error(FATAL, "can't open %s", tname);
239		unlink(tname);
240		free(tname);
241		piccopy(fp_pic, fp, total);
242		fseek(fp, 0L, 0);
243		return(fp);
244	    }   /* End if */
245	    fseek(fp_pic, total, 1);
246	}   /* End while */
247    }	/* End if */
248
249    return(fopen(path, "r"));
250
251}   /* End of picopen */
252
253
254/*****************************************************************************/
255
256
257void
258inlinepic(FILE *fp, char *buf)
259    /* fp - current input file */
260    /* buf - whatever followed "x X InlinePicture" */
261{
262    char	*tname;			/* temp file pathname - for *fp_pic */
263    char	name[100];		/* picture file pathname */
264    long	total;			/* and size - both from *buf */
265
266
267/*
268 *
269 * Adds an in-line picture file to the end of temporary file *fp_pic. All pictures
270 * grabbed from the input file are saved in the same temp file. Each is preceeded
271 * by a one line header that includes the original picture file pathname and the
272 * size of the picture in bytes. The in-line picture file is opened for update,
273 * left open, and unlinked so it disappears when we do.
274 *
275 */
276
277
278    if ( fp_pic == NULL )  {
279	if ( (tname = tempnam(TEMPDIR, "dpost")) == NULL )
280	    error(FATAL, "can't generate in-line picture file name");
281	if ( (fp_pic = fopen(tname, "w+")) == NULL )
282	    error(FATAL, "can't open in-line picture file %s", tname);
283	unlink(tname);
284    }	/* End if */
285
286    if ( sscanf(buf, "%s %ld", name, &total) != 2 )
287	error(FATAL, "in-line picture error");
288
289    fseek(fp_pic, 0L, 2);
290    fprintf(fp_pic, "%s %ld\n", name, total);
291    getc(fp);
292    fflush(fp_pic);
293    piccopy(fp, fp_pic, total);
294    ungetc('\n', fp);
295
296}   /* End of inlinepic */
297
298
299/*****************************************************************************/
300
301
302static void
303piccopy(FILE *fp_in, FILE *fp_out, long total)
304    /* fp_in - input */
305    /* fp_out - and output file pointers */
306    /* total - number of bytes to be copied */
307{
308    long	i;			/* loop index */
309
310
311/*
312 *
313 * Copies total bytes from file fp_in to fp_out. Used to append picture files to
314 * *fp_pic and then copy them to yet another temporary file immediately before
315 * they're used (in picture()).
316 *
317 */
318
319
320    for ( i = 0; i < total; i++ )
321	if ( putc(getc(fp_in), fp_out) == EOF )
322	    error(FATAL, "error copying in-line picture file");
323    fflush(fp_out);
324
325}   /* End of piccopy */
326