Include file for hpgl. More...

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

Macros
#define	_HPGL_H_DEPRECATED

Functions
BOOL	blHPGLInit (char filename, char AltFont, REAL xmargin, REAL ymargin)

void	blHPGLPen (int num)

void	blHPGLMove (REAL x, REAL y)

void	blHPGLDraw (REAL x, REAL y)

void	blHPGLSetDash (int style)

void	blHPGLFont (int font, REAL size)

void	blHPGLLText (REAL x, REAL y, char *string)

void	blHPGLCBText (REAL x, REAL y, REAL offset, char *text)

void	blHPGLROffText (REAL x, REAL y, REAL offset, char *text)

void	blHPGLLCText (REAL x, REAL y, char *text)

void	blHPGLCTText (REAL x, REAL y, REAL offset, char *text)

void	blHPGLVText (REAL x, REAL y, REAL xoff, char text, int TitleFont, REAL TitleSize, char label, int LabelFont, REAL LabelSize)

void	blHPGLEnd (void)

void	blHPGLShowText (char *text, BOOL orientation, int XBase, int YBase)

Detailed Description

Include file for hpgl.

Version: V1.3

Date: 14.08.14

Copyright: (c) UCL / Dr. Andrew C. R. Martin 1991-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:

Usage:

Revision History:

V1.0 25.03.91 Original
V1.1 07.07.14 Use bl prefix for functions By: CTP
V1.2 31.07.14 Updated deprecation: Removed deprecated.h and added prototypes for renamed functions. By: CTP
V1.3 14.08.14 Moved deprecated function prototypes to deprecated.h By: CTP

Definition in file hpgl.h.

Macro Definition Documentation

#define _HPGL_H_DEPRECATED

Definition at line 89 of file hpgl.h.

Function Documentation

void blHPGLCBText	(	REAL	x,
		REAL	y,
		REAL	offset,
		char *	text
	)

Parameters

[in]	x	X coordinate
[in]	y	Y coordinate
[in]	offset	Y-offset (multiplied by font height). Move text up by this amount
[in]	*text	Text to print

Write centre-bottom justified text in HPGL

25.06.92 Framework
26.06.92 Original
29.06.92 Added SimplifyText(). Changed to use HPGLShowText().
06.07.92 Modified x-pos for wider font width
07.07.14 Use bl prefix for functions By: CTP

Definition at line 400 of file hpgl.c.

void blHPGLCTText	(	REAL	x,
		REAL	y,
		REAL	offset,
		char *	text
	)

Parameters

[in]	x	X coordinate
[in]	y	Y coordinate
[in]	offset	Y offset in points. Move text down by this.
[in]	*text	Text to print

Center Top justify text at x,y with y-offset in pts.

25.06.92 Framework
26.06.92 Original
29.06.92 Added SimplifyText(). Changed to use HPGLShowText().
01.07.92 Corrected y-positioning. Changed offset to be in pts rather than a multiplier of font size.
06.07.92 Modified x-pos for wider font width
07.07.14 Use bl prefix for functions By: CTP

Definition at line 521 of file hpgl.c.

void blHPGLDraw	(	REAL	x,
		REAL	y
	)

Parameters

[in]	x	X position (0.0–1.0)
[in]	y	Y position (0.0–1.0)

Draw on HPGL plot

25.06.92 Taken from MoG
07.07.14 Use bl prefix for functions By: CTP

Definition at line 257 of file hpgl.c.

void blHPGLEnd ( void )

Close the HPGL plot file

06.07.93 Original
07.07.14 Use bl prefix for functions By: CTP

Definition at line 651 of file hpgl.c.

void blHPGLFont	(	int	font,
		REAL	size
	)

Parameters

[in]	font	Font number
[in]	size	Point size of font

Set font for HPGL plot

25.06.92 Taken from MoG
29.06.92 Corrected CA to CS and added SS. Changed to use global width and height variables. Altered width to 1/2.4 * height
27.07.93 Changed precision of floating i/o to double
07.07.14 Use bl prefix for functions By: CTP

Definition at line 327 of file hpgl.c.

BOOL blHPGLInit	(	char *	filename,
		char *	AltFont,
		REAL	xmargin,
		REAL	ymargin
	)

Parameters

[in]	*filename	HPGL file name
[in]	*AltFont	Alternative font used for Greek characters
[in]	xmargin	Unprintable x margin
[in]	ymargin	Unprintable y margin

Returns: Success

Initialise an HPGL plot. The parameters specify the unprintable margins on the output device.

The plot is also affected by global variables:

  PSxpicsize  X picture size
  PSypicsize  Y picture size
  PSxoffset   X offset
  PSyoffset   Y offset

25.06.92 Taken from MoG. Changed to support offsets. Added parameters.
29.06.92 Added initialisation of alternate font.
06.07.93 Added AltFont parameter
07.07.14 Use bl prefix for functions By: CTP

Definition at line 170 of file hpgl.c.

void blHPGLLCText	(	REAL	x,
		REAL	y,
		char *	text
	)

Parameters

[in]	x	X coordinate
[in]	y	Y coordinate
[in]	*text	Text to print

Print left-centre justified text

25.06.92 Framework
26.06.92 Original
29.06.92 Changed to use HPGLShowText().
07.07.14 Use bl prefix for functions By: CTP

Definition at line 482 of file hpgl.c.

void blHPGLLText	(	REAL	x,
		REAL	y,
		char *	string
	)

Parameters

[in]	x	X coordinate
[in]	y	Y coordinate
[in]	*string	Text to print

Write left justified text on HPGL plot

25.06.92 Taken from MoG
29.06.92 Changed to use HPGLShowText().
07.07.14 Use bl prefix for functions By: CTP

Definition at line 368 of file hpgl.c.

void blHPGLMove	(	REAL	x,
		REAL	y
	)

Parameters

[in]	x	X position (0.0–1.0)
[in]	y	Y position (0.0–1.0)

Move on HPGL plot

25.06.92 Taken from MoG
07.07.14 Use bl prefix for functions By: CTP

Definition at line 235 of file hpgl.c.

void blHPGLPen ( int num )

Parameters

[in] num Pen number

Select a Pen

25.06.92 Taken from MoG
08.09.92 Changed to store pen first (having seen IntroCAD output)
07.07.14 Use bl prefix for functions By: CTP

Definition at line 214 of file hpgl.c.

void blHPGLROffText	(	REAL	x,
		REAL	y,
		REAL	offset,
		char *	text
	)

Parameters

[in]	x	X coordinate
[in]	y	Y coordinate
[in]	offset	Move left by this amount (pts)
[in]	*text	Text to print

Print right-justified text to HPGL

25.06.92 Framework
26.06.92 Original
29.06.92 Added SimplifyText(). Changed to use HPGLShowText().
06.07.92 Modified x-pos for wider font width
07.07.14 Use bl prefix for functions By: CTP

Definition at line 440 of file hpgl.c.

void blHPGLSetDash ( int style )

Parameters

[in] style Line style

Set the line style (may be printer dependent):

  0 Solid line
  1 ............
  2 -.-.-.-.-.-.
  3 ------------
  4 -..-..-..-..
  5 --.--.--.--.

25.06.92 Framework
26.06.92 Original
07.07.14 Use bl prefix for functions By: CTP

Definition at line 286 of file hpgl.c.

void blHPGLShowText	(	char *	text,
		BOOL	orientation,
		int	XBase,
		int	YBase
	)

Parameters

[in]	*text	Text to be displayed with control codes
[in]	orientation	TRUE=vertical, FALSE=horizontal
[in]	XBase	Position at which to start (device coords)
[in]	YBase	Position at which to start (device coords)

Displays the text, raising or lowering as appropriate and selecting alternate font where required. Used by the various ...Text() routines.

29.06.92 Original based on PostScript version.
27.07.93 Changed precision of floating i/o to double
11.03.94 Changed orientation to BOOL
07.07.14 Use bl prefix for functions By: CTP

Definition at line 674 of file hpgl.c.

void blHPGLVText	(	REAL	x,
		REAL	y,
		REAL	xoff,
		char *	text,
		int	TitleFont,
		REAL	TitleSize,
		char *	label,
		int	LabelFont,
		REAL	LabelSize
	)

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]	*TitleFont	Font in which to write it
[in]	TitleSize	Size of font
[in]	*label	Label to be used to calc x offset
[in]	*LabelFont	Font of this label
[in]	LabelSize	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 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. The FIXVERT code is used to correct character dimensions. Not sure if it is a bug in the PLT: interpreter which requires this, or whether it is standard HPGL. Define FIXVERT if it improves your output.

25.06.92 Framework
29.06.92 Original
06.07.92 Modified x-pos for wider font width
27.07.93 Changed precision of floating i/o to double
07.07.14 Use bl prefix for functions By: CTP

Definition at line 577 of file hpgl.c.

Macros

Functions

Detailed Description

Description:

Usage:

Revision History:

Macro Definition Documentation

Function Documentation