Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Contact Us
Online Help
Domain Status
Man Pages

Virtual Servers

Topology Map

Server Agreement
Year 2038

USA Flag



Man Pages

Manual Reference Pages  -  LIBPLOT3 (3)

.ds Aq ’


libplot3 - graphics interface subroutines



pl_space(FILE *fp , int x0 , y0 , x1 , y1, pl_3space ( fp , x0 , y0 , z0 , x1 , y1 , z1 ) FILE*fp, int x0 , y0 , z0 , x1 , y1 , z1, pl_erase ( fp ) FILE*fp);
pl_color(FILE *fp , int r , g , b, pl_linmod ( fp , s ) FILE*fp, char *s );
pl_label(FILE *fp , char *s );
pl_line(FILE *fp , int x1 , y1 , x2 , y2, pl_3line ( fp , x1 , y1 , z1 , x2 , y2 , z2 ) FILE*fp, int x1 , y1 , z1 , x2 , y2 , z2, pl_move ( fp , x , y ) FILE*fp);

int x, y;

pl_3move(FILE *fp , int x , y , z, pl_cont ( fp , x , y ) FILE*fp, int x , y);
pl_3cont(FILE *fp , int x , y , z, pl_point ( fp , x , y ) FILE*fp, int x , y);
pl_3point(FILE *fp , int x , y , z, pl_box ( fp , x1 , y1 , x2 , y2 ) FILE*fp, int x1 , y1 , x2 , y2);
pl_3box( fp, x1, y1, z1, x2, y2, z2 )

FILE *fp;
int x1, y1, z1, x2, y2, z2;

pl_circle(FILE *fp , int x , y , r, pl_arc ( fp , x , y , x0 , y0 , x1 , y1 ) FILE*fp, int x , y , x0 , y0 , x1 , y1);


These subroutines generate graphic output commands for processing with the plot(1) plotting filters. They are slightly more general than those in libplot as these take a file pointer. They also include the BRL 3-D extensions to the plot intermediate code.

Pl_space or pl_3space must be used before any of the graphic primitives to declare the amount of space necessary. See plot3(5).

Pl_box or pl_3box draws a box between the two given opposite points. The pen will be left at the second point.

Pl_circle draws a circle of radius r with center at the point (x, y). Note that circle and arc cannot be transformed in three space if one is using a filter to do that.

Pl_arc draws an arc of a circle with center at the point (x, y) between the points (x0, y0) and (x1, y1).

String arguments to pl_label and pl_linmod are terminated by nulls and do not contain new-lines.

There are also 2-D and 3_D double-precision versions, with arguments identical to their counterparts above. The naming conventions are to change the prefix to "pd"; examples are thus pd_point and pd_3point. Vector versions for 3_D (also double-precision) are prefixed "pdv", as in pdv_3point.

See plot3(5) and plot(5) for a description of the effect of the remaining functions.


/usr/brlcad/lib/libplot3.a produces output for plot(1G) filters


In order to compile a program containing these functions in file.c it is necessary to use ‘‘cc file.c -lplot3.

Color specification and three-dimensional primitives are BRL extensions to the "unix plot" language that are not generally found on other systems.


plot(1), pl-fb(1), plot3(5), plot(5)




This software is Copyright (c) 1989-2013 by the United States Government as represented by U.S. Army Research Laboratory.


Reports of bugs or problems should be submitted via electronic mail to <>.

Search for    or go to Top of page |  Section 3 |  Main Index

BRL-CAD LIBPLOT3 (3) 04/04/2016

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.