Include file for PostScript routine. More...

#include <stdio.h>
#include "SysDefs.h"
#include "MathType.h"
#include "deprecated.h"

Macros
#define	_PS_H_DEPRECATED

Functions
BOOL	blPSInit (char FName, char creator, char *AltFont)

void	blPSThick (REAL thickness)

void	blPSMove (REAL X, REAL Y)

void	blPSDraw (REAL X, REAL Y)

void	blPSSetDash (char *linepatt)

void	blPSClearDash (void)

void	blPSStroke (void)

void	blPSFont (char *fontname, REAL size)

void	blPSLText (REAL X, REAL Y, char *label)

void	blPSCBText (REAL X, REAL Y, REAL Offset, char *label)

void	blPSROffText (REAL X, REAL Y, REAL offset, char *label)

void	blPSLCText (REAL X, REAL Y, char *label)

void	blPSCTText (REAL X, REAL Y, REAL Offset, char *label)

void	blPSVText (REAL x, REAL y, REAL xoff, char text, char font, REAL size, char label, char lfont, REAL lsize)

void	blPSShowText (char *text)

void	blPSEnd (void)

char *	blPSCorrectCase (char *font)

Variables
REAL	PSxpicsize

REAL	PSypicsize

REAL	PSxoffset

REAL	PSyoffset

FILE *	gPSFile

Detailed Description

Include file for PostScript routine.

Version: V1.14

Date: 14.08.14

Copyright: (c) UCL / Dr. Andrew C. R. Martin 1993-2014

Author: Dr. Andrew C. R. Martin

: Institute of Structural & Molecular Biology, University College London, Gower Street, London. WC1E 6BT.

: andre.nosp@m.w@bi.nosp@m.oinf..nosp@m.org..nosp@m.uk andre.nosp@m.w.ma.nosp@m.rtin@.nosp@m.ucl..nosp@m.ac.uk

This code is NOT IN THE PUBLIC DOMAIN, but it may be copied according to the conditions laid out in the accompanying file COPYING.DOC.

The code may be modified as required, but any modifications must be documented so that the person responsible can be identified.

The code may not be sold commercially or included as part of a commercial product except as described in the file COPYING.DOC.

Description:

Include file for using with PSRoutines.c

Variables are defined only from the main program. Otherwise they are referenced as external.

Usage:

Revision History:

V1.0 06.02.91 Original
V1.7 25.02.91 Fixed prototypes and definition of PSFile.
V1.10 07.05.92 Changed all prototypes to doubles
V1.11 23.06.94 Made gPSFile a global
V1.12 07.07.14 Use bl prefix for functions By: CTP
V1.13 31.07.14 Updated deprecation: Removed deprecated.h and added prototypes for renamed functions. By: CTP
V1.14 14.08.14 Moved deprecated function prototypes to deprecated.h By: CTP

Definition in file ps.h.

Macro Definition Documentation

#define _PS_H_DEPRECATED

Definition at line 116 of file ps.h.

Function Documentation

void blPSCBText	(	REAL	X,
		REAL	Y,
		REAL	Offset,
		char *	label
	)

Parameters

[in]	X	X coordinate
[in]	Y	Y coordinate
[in]	Offset	Y offset - multiple of font height. Moves up by this quantity
[in]	*label	Text to be printed

Centers a piece of text with X,Y being the Coords of the BOTTOM centre point

30.06.92 Removed redundant sprintf()'s
15.09.92 Multiply string width by 0.65
27.07.93 Floating point precision -> double
07.07.14 Use bl prefix for functions By: CTP

Definition at line 490 of file ps.c.

void blPSClearDash ( void )

Clear the dash pattern to a full line

30.06.92 Removed redundant sprintf()'s
07.07.14 Use bl prefix for functions By: CTP

Definition at line 382 of file ps.c.

char* blPSCorrectCase ( char * font )

Parameters

[in] *font Input fontname

Returns: Case-fixed fontname

Goes through a fontname and fixes case to match the required standard.

08.05.92 Original
07.07.14 Use bl prefix for functions By: CTP

Definition at line 861 of file ps.c.

void blPSCTText	(	REAL	X,
		REAL	Y,
		REAL	Offset,
		char *	label
	)

Parameters

[in]	X	X coordinate
[in]	Y	Y coordinate
[in]	Offset	Y offset in points. Moves down by this quantity
[in]	*label	Text to be printed

Centers a piece of text with X,Y being the Coords of the TOP centre point

26.06.92 Changed strlen() to use SimplifyText()
30.06.92 Removed redundant sprintf()'s
01.07.92 Changed Offset to be in pts rather than a multiplier of font size.
27.07.92 Changed update limits to account better for descenders.
15.09.92 Multiply string width by 0.65
27.07.93 Floating point precision -> double
07.07.14 Use bl prefix for functions By: CTP

Definition at line 620 of file ps.c.

void blPSDraw	(	REAL	X,
		REAL	Y
	)

Parameters

[in]	X	X coordinate
[in]	Y	Y coordinate

Draw to X,Y

27.07.93 Floating point precision -> double
07.07.14 Use bl prefix for functions By: CTP

Definition at line 348 of file ps.c.

void blPSEnd ( void )

End of page

08.05.92 Original
07.07.14 Use bl prefix for functions By: CTP

Definition at line 840 of file ps.c.

void blPSFont	(	char *	fontname,
		REAL	size
	)

Parameters

[in]	*fontname	Font to set
[in]	size	Point size of font

Set the font and size

08.05.92 Changed to support raise and lower
23.06.92 Set sTextHeight
15.09.92 Changed to support Amiga reencoding
06.07.93 Removed Amiga reecncoding for general distribution
27.07.93 Floating point precision -> double
07.07.14 Use bl prefix for functions By: CTP

Definition at line 418 of file ps.c.

BOOL blPSInit	(	char *	FName,
		char *	creator,
		char *	AltFont
	)

Parameters

[in]	*FName	PostScript filename
[in]	*creator	Creator string
[in]	*AltFont	Alternate font (normall greek style)

Returns: Success?

Initialises the file writing the Prologue. The filename and creator are written into the Prologue and EPSFxoff and EPSFyoff are used to calculate the bounding box size for EPSF plots.

08.05.92 Added definitions of raise, lower and greek. New parameter to specify name of alternate font.
23.06.92 Padded BoundingBox with spaces and setting of PSXMin, etc.
26.07.92 Correctly divide EPSFxoff and EPSFyoff by 72 when writing offsets in prologue.
15.09.92 Added support for Amiga reencoding. Starting dimensions for BoundingBox set to dimensions set by Paper.
06.07.93 Opens the file
27.07.93 Floating point precision -> double
07.07.14 Use bl prefix for functions By: CTP

Definition at line 189 of file ps.c.

void blPSLCText	(	REAL	X,
		REAL	Y,
		char *	label
	)

Parameters

[in]	X	X coordinate
[in]	Y	Y coordinate
[in]	*label	Text to be printed

Left justify text, centred on Y

08.05.92 Original
30.06.92 Removed redundant sprintf()'s
15.09.92 Multiply string width by 0.65
27.07.93 Floating point precision -> double
07.07.14 Use bl prefix for functions By: CTP

Definition at line 583 of file ps.c.

void blPSLText	(	REAL	X,
		REAL	Y,
		char *	label
	)

Parameters

[in]	X	X coordinate
[in]	Y	Y coordinate
[in]	*label	Text to be printed

Left justify text

30.06.92 Removed redundant sprintf()'s
15.09.92 Multiply string width by 0.65
27.07.93 Floating point precision -> double
07.07.14 Use bl prefix for functions By: CTP

Definition at line 457 of file ps.c.

void blPSMove	(	REAL	X,
		REAL	Y
	)

Parameters

[in]	X	X coordinate
[in]	Y	Y coordinate

Move to X,Y

27.07.93 Floating point precision -> double
07.07.14 Use bl prefix for functions By: CTP

Definition at line 328 of file ps.c.

void blPSROffText	(	REAL	X,
		REAL	Y,
		REAL	offset,
		char *	label
	)

Parameters

[in]	X	X coordinate
[in]	Y	Y coordinate
[in]	offset	X offset in points; text moved to the left by this amount
[in]	*label	Text to be printed

Right justify text with offset in device coordinates (points).

07.05.92 Original
30.06.92 Removed use of PSShowText(). This can't be used with the current rightJustifyText
15.09.92 Multiply string width by 0.65
27.07.93 Floating point precision -> double
07.07.14 Use bl prefix for functions By: CTP

Definition at line 548 of file ps.c.

void blPSSetDash ( char * linepatt )

Parameters

[in] *linepatt Line pattern (a string of numbers)

Set a line dash pattern which must be supplied as a string

07.07.14 Use bl prefix for functions By: CTP

Definition at line 366 of file ps.c.

void blPSShowText ( char * text )

Parameters

[in] *text Text to be written

Displays text, processing it first if any control codes are found. Used by the various text positioning routines.

08.05.92 Original
07.07.14 Use bl prefix for functions By: CTP

Definition at line 739 of file ps.c.

void blPSStroke ( void )

Actually draw what you've just done onto the paper

30.06.92 Removed redundant sprintf()'s
07.07.14 Use bl prefix for functions By: CTP

Definition at line 397 of file ps.c.

void blPSThick ( REAL thickness )

Parameters

[in] thickness Line thickness

Set the line thickness

27.07.93 Floating point precision -> double
07.07.14 Use bl prefix for functions By: CTP

Definition at line 309 of file ps.c.

void blPSVText	(	REAL	x,
		REAL	y,
		REAL	xoff,
		char *	text,
		char *	font,
		REAL	size,
		char *	label,
		char *	lfont,
		REAL	lsize
	)

Parameters

[in]	x	X coordinate (in data units)
[in]	y	Y coordinate (in data units)
[in]	xoff	X-offset in pts
[in]	*text	Text to be written
[in]	*font	Font in which to write it
[in]	size	Size of font
[in]	*label	Label to be used to calc x offset
[in]	*lfont	Font of this label
[in]	lsize	Size of this label

Write vertical text centred on x,y offset back along x by the size of label and by xoff in pts. Used, for example, to title the y-axis of a graph. The `label' specification is used to calculate an amount by which to move the text back. Typically this would be the longest data label on the graph's Y-axis.

08.05.92 Original
30.06.92 Removed redundant sprintf()'s
15.09.92 Multiply string width by 0.65
27.07.93 Floating point precision -> double
07.07.14 Use bl prefix for functions By: CTP

Definition at line 688 of file ps.c.

Variable Documentation

FILE* gPSFile

REAL PSxoffset

REAL PSxpicsize

REAL PSyoffset

REAL PSypicsize

Macros

Functions

Variables

Detailed Description

Description:

Usage:

Revision History:

Macro Definition Documentation

Function Documentation

Variable Documentation