PostScriptRectangle

Syntax

int PostScriptRectangle(struct PostScript *ptr, struct PostScriptMatrix *matrix, float x,float y,float w,float h,int fill,unsigned int color, float width, struct PostScriptDash *dash,struct PostScriptClip *clip);

Header

base/rps.h

Library

rps

Description

The PostScriptRectangle function plots a rectangle.

The argument ptr is a pointer to the PostScript control structure. The argument matrix is an optional transformation matrix that can be applied to the rectangle. If this is set to a NULL pointer then no transformation is applied. The position at which the rectangle is plotted is given by the arguments x, and y. The width and height of the rectangle are given by the arguments w and h.

If the argument fill is set to a non-zero value then the rectangle will be plotted as a solid shape, not an outline.

The color used to plot the rectangle is given by the color which is a 24-bit number that represents the red,green and blue components of the color as 8-bit number. The red channel occupies the most significant bits and the blue channel occupies the least significant bits.

The width of the line used to plot the rectangle is controlled using the argument width, a value of zero will plot a hairline. The dot-dash pattern used to plot the rectangle is given by dash. If this is set to a NULL pointer, a solid line is plotted.

The clipping polygon is given by the argument clip. If this is set to a NULL pointer, no clipping is performed.

Returns

Returns zero on success. On error, (-1) is returned.

Errors

Returns zero on success. On error, (-1) is returned.

Example

PostScriptRectangle
Source Code: PostScriptRectangle.c

/* PostScriptRectangle
   ===================
   Author: R.J.Barnes
 Copyright (c) 2012 The Johns Hopkins University/Applied Physics Laboratory

This file is part of the Radar Software Toolkit (RST).

RST is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program. If not, see <https://www.gnu.org/licenses/>.

Modifications:




#include <stdio.h>
#include <stdlib.h>
#include "rfbuffer.h"
#include "rps.h"

int stream(char *buf,int sze,void *data) {
  FILE *fp;
  fp=(FILE *) data;
  fwrite(buf,sze,1,stdout);
  return 0;
} 


int main(int argc,char *argv[]) {

  struct PostScript *ps=NULL;

  float wdt=400,hgt=400;
  float xoff=50,yoff=50;
  int x;


  unsigned int fgcol=0xff000000;

  ps=PostScriptMake();
  PostScriptSetText(ps,stream,stdout);   

  PostScriptMakeDocument(ps,xoff,yoff,wdt,hgt,0);
  PostScriptMakePlot(ps);

  for (x=0;x<200;x+=10) {
    fgcol=PostScriptColor(255-x,255-x,255-x);
    PostScriptRectangle(ps,NULL,x,x,wdt-2*x,hgt-2*x,
                  1,fgcol,0,NULL,NULL);
  }


  PostScriptEndPlot(ps);
  PostScriptEndDocument(ps);
  return 0;
}