Copyright ©1995 by NeXT Computer, Inc.  All Rights Reserved.




Single-Operator Functions

The single-operator functions listed here begin with the prefix "PS."  For every single-operator function with a "PS" prefix, there's a corresponding single-operator function with a "DPS" prefix.  The PS and DPS functions are identical except that DPS functions take an additional (first) argument that represents the PostScript execution context.  To conserve space, only the single-operator functions prefixed with "PS" are listed here.  (See "Suggested Reading" for references to documentation about Display PostScript.)

Besides using the standard C types, these single-operator functions use boolean and userobject.  A boolean variable is an int having either a zero or a nonzero value.  The zero value is equivalent to the PostScript value false, and the nonzero value is equivalent to the PostScript value true.  The userobject type is an int that refers to the value returned by DPSDefineUserObject().

void PSabs(void)
void PSadd(void)
void PSadjustcursor(float deltaX, float deltaY)¦
void PSaload(void)
void PSalphaimage(void)¦
void PSanchorsearch(boolean *pflag)
void PSand(void)
void PSarc(float x, float y, float radius, float angle1, float angle2)
void PSarcn(float x, float y, float radius, float angle1, float angle2)
void PSarct(float x1, float y1, float x2, float y2, float radius)
void PSarcto(float x, float y, float x2, float y2, float radius, float *pxt1, float *pyt1, float *pxt2, float *pyt2)
void PSarray(int length)
void PSashow(float x, float y, char *string)
void PSastore(void)
void PSatan(void)
void PSawidthshow(float x, float y, int c, float ax, float ay, char *string)
void PSbasetocurrent(float x, float y, float *px, float *py)¦
void PSbasetoscreen(float x, float y, float *px, float *py)¦
void PSbegin(void)
void PSbind(void)
void PSbitshift(int shift)
void PSbuttondown(boolean *pflag)¦
void PSbytesavailable(int *pcount)
void PScachestatus(int *pbsize, int *pbmax, int *pmsize)
void PSceiling(void)
void PScharpath(char *string, boolean flag)
void PSclear(void)
void PScleardictstack(void)
void PScleartomark(void)
void PScleartrackingrect(int tRectNum, userobject gstate)¦
void PSclip(void)
void PSclippath(void)
void PSclosefile(void)
void PSclosepath(void)
void PScolorimage(void)
void PScomposite(float x, float y, float width, float height, userobject srcGstate, float destx, float desty, int op)¦
void PScompositerect(float destx, float desty, float width, float height, int op)¦
void PSconcat(float m[6])
void PSconcatmatrix(void)
void PScondition(void)
void PScopy(int n)
void PScopypage(void)
Warning:  This function has no effect in NeXTSTEP.
void PScos(void)
void PScount(int *pn)
void PScountdictstack(int *plength)
void PScountexecstack(int *pcount)
void PScountframebuffers(int *pcount)¦
void PScountscreenlist(int context, int *pcount)¦
void PScounttomark(int *pn)
void PScountwindowlist(int context, int *pcount)¦
void PScshow(char *string)
void PScurrentactiveapp(int *pcontext)
Warning:  Don't use this function if you're using the Application Kit.
void PScurrentalpha(float *pcoverage)¦
void PScurrentblackgeneration(void)
void PScurrentcacheparams(void)
void PScurrentcmykcolor(float *pc, float *pm, float *py, float *pk)
void PScurrentcolor(void)
void PScurrentcolorrendering(void)
void PScurrentcolorscreen(void)
void PScurrentcolorspace(void)
void PScurrentcolortransfer(void)
void PScurrentcontext(int *pcontext)
void PScurrentdash(void)
void PScurrentdefaultdepthlimit(int *plimit)¦
Warning:  Don't use this function if you're using the Application Kit.
void PScurrentdeviceinfo(userobject window, int *pMinBPS, int *pMaxBPS, int *pColor)¦
void PScurrentdevparams(char *device)
void PScurrentdict(void)
void PScurrenteventmask(userobject window, int *pmask)
Warning:  Don't use this function if you're using the Application Kit.
void PScurrentfile(void)
void PScurrentflat(float *pflatness)
void PScurrentfont(void)
void PScurrentframebuffertransfer(void)
void PScurrentglobal(int *b)
void PScurrentgray(float *pgray)
void PScurrentgstate(userobject gstate)
void PScurrenthalftone(void)
void PScurrenthalftonephase(float *px, float *py)
void PScurrenthsbcolor(float *ph, float *ps, float *pb)
void PScurrentlinecap(int *plinecap)
void PScurrentlinejoin(int *plinejoin)
void PScurrentlinewidth(float *pwidth)
void PScurrentmatrix(void)
void PScurrentmiterlimit(float *plimit)
void PScurrentmouse(userobject window, float *px, float *py)
Warning:  Don't use this function if you're using the Application Kit.
void PScurrentobjectformat(int *pcode)
void PScurrentoverprint(int *b)
void PScurrentowner(userobject window, int *pcontext)¦
void PScurrentpacking(boolean *pflag)
void PScurrentpagedevice(void)
void PScurrentpoint(float *px, float *py)
void PScurrentrgbcolor(float *pr, float *pg, float *pb)
void PScurrentrusage(float *pnow, float *puTime, float *psTime, int *pmsgSend, int *pmsgReceive, int *pnSignals, int *pnVCSw, int *pnIvCSw)¦
void PScurrentscreen(void)
void PScurrentshared(boolean *pflag)
void PScurrentshowpageprocedure(void)
void PScurrentstrokeadjust(boolean *pflag)
void PScurrentsystemparams(void)
void PScurrenttobase(float x, float y, float *px, float *py)¦
void PScurrenttoscreen(float x, float y,float *px, float *py)¦
void PScurrenttransfer(void)
void PScurrentundercolorremoval(void)
void PScurrentuser(int *puid, int *pgid)¦
void PScurrentuserparams(void)
void PScurrentwaitcursorenabled(boolean *pflag)¦
void PScurrentwindow(int *pnum)¦
void PScurrentwindowalpha(userobject window, int *palpha)¦
void PScurrentwindowbounds(userobject window, float *px, float *py, float *pwidth, float *pheight)¦
Warning:  Don't use this function if you're using the Application Kit.
void PScurrentwindowdepth(userobject window, int *pdepth)¦
Warning:  Don't use this function if you're using the Application Kit.
void PScurrentwindowdepthlimit(userobject window, int *plimit)¦
Warning:  Don't use this function if you're using the Application Kit.
void PScurrentwindowdict(userobject window)
Warning:  Don't use this function if you're using the Application Kit.
void PScurrentwindowlevel(userobject window, int *plevel)¦
void PScurrentwriteblock(int *pflag)¦
void PScurveto(float x1, float y1, float x2, float y2, float x3, float y3)
void PScvi(void)
void PScvlit(void)
void PScvn(void)
void PScvr(void)
void PScvrs(void)
void PScvs(void)
void PScvx(void)
void PSdef(void)
void PSdefaultmatrix(void)
void PSdefinefont(void)
void PSdefineresource(char *category)
void PSdefineusername(int index, char *name)
void PSdefineuserobject(void)
Warning:  Use DPSDefineUserObject() instead.
void PSdeletefile(char *filename)
void PSdetach(void)
void PSdeviceinfo(void)
void PSdict(int length)
void PSdictstack(void)
void PSdissolve(float srcx, float srcy, float width, float height, userobject srcGstate, float destx, float desty, float delta)¦
void PSdiv(void)
void PSdtransform(float x, float y, float *px, float *py)
void PSdumpwindow(int level, userobject window)
Warning:  Don't use this function if you're using the Application Kit.
void PSdumpwindows(int level, userobject context)
Warning:  Don't use this function if you're using the Application Kit.
void PSdup(void)
void PSecho(boolean flag)
void PSend(void)
void PSeoclip(void)
void PSeofill(void)
void PSeoviewclip(void)
void PSeq(void)
void PSequals(void)
void PSequalsequals(void)
void PSerasepage(void)
Warning:  This function is different in NeXTSTEP.
void PSerrordict(void)
void PSexch(void)
void PSexec(void)
void PSexecform(void)
void PSexecstack(void)
void PSexecuteonly(void)
void PSexecuserobject(int index)
void PSexit(void)
void PSexp(void)
void PSfalse(void)
void PSfile(char *name, char *access)
void PSfilenameforall(void)
void PSfileposition(int *ppos)
void PSfill(void)
void PSfilter(void)
void PSfindencoding(char *key)
void PSfindfont(char *name)
void PSfindresource(char *key, char *category)
void PSfindwindow(float x, float y, int place, userobject otherWindow, float *px, float *py, int *pwinFound, boolean *pdidFind)¦
void PSflattenpath(void)
void PSfloor(void)
void PSflush(void)
void PSflushfile(void)
void PSflushgraphics(void)¦
Warning:  Don't use this function if you're using the Application Kit.
void PSFontDirectory(void)
void PSfor(void)
void PSforall(void)
void PSfork(void)
void PSframebuffer(int index, int nameLength, char name[], int *pslot, int *punit, int *pROMid, int *px, int *py, int *pwidth, int *pheight, int *pdepth)¦
void PSfrontwindow(int *pnum)
Warning:  Don't use this function if you're using the Application Kit.
void PSgcheck(int *b)
void PSge(void)
void PSget(void)
void PSgetboolean(boolean *pflag)
void PSgetchararray(int size, char string[])
void PSgetfloat(float *pvalue)
void PSgetfloatarray(int size, float array[])
void PSgetint(int *pvalue)
void PSgetintarray(int size, float array[])
void PSgetinterval(void)
void PSgetstring(char *string)
void PSGlobalFontDirectory(void)
void PSglobaldict(void)
void PSglyphshow(char *name)
void PSgrestore(void)
void PSgrestoreall(void)
void PSgsave(void)
void PSgstate(void)
void PSgt(void)
void PShidecursor(void)¦
void PShideinstance(float x, float y, float width, float height)¦
void PSidentmatrix(void)
void PSidiv(void)
void PSidtransform(float x, float y, float *px, float *py)
void PSif(void)
void PSifelse(void)
void PSimage(void)
void PSimagemask(void)
void PSindex(int n)
void PSineofill(float x, float y, boolean *pflag)
void PSinfill(float x, float y, boolean *pflag)
void PSinitclip(void)
void PSiniteventtimes(void)
void PSinitgraphics(void)
Warning:  This function is different in NeXTSTEP.
void PSinitmatrix(void)
void PSinitviewclip(void)
void PSinstroke(float x, float y, boolean *pflag)
void PSinueofill(float x, float y, char nums[n], int n, char ops[l], int l, boolean *pflag)
void PSinufill(float x, float y, char nums[n], int n, char ops[l], int l, boolean *pflag)
void PSinustroke(float x, float y, char nums[n], int n, char ops[l], int l, boolean *pflag)
void PSinvertmatrix(void)
void PSISOLatin1Encoding(void)
void PSitransform(float x, float y, float *px, float *py)
void PSjoin(void)
void PSknown(boolean *pflag)
void PSkshow(char *string)
void PSlanguagelevel(int *n)
void PSle(void)
void PSleftbracket(void)
void PSleftleft(void)
void PSlength(int *pn)
void PSlineto(float x, float y)
void PSln(void)
void PSload(void)
void PSlock(void)
void PSlog(void)
void PSloop(void)
void PSlt(void)
void PSmachportdevice(int w, int h, int bbox[], int bboxSize, float matrix[], char *phost, char *pport, char *ppixelDict)¦
void PSmakefont(void)
void PSmakepattern(void)
void PSmark(void)
void PSmatrix(void)
void PSmaxlength(int *plength)
void PSmod(void)
void PSmonitor(void)
void PSmoveto(float x, float y)
void PSmovewindow(float x, float y, userobject window)
Warning:  Don't use this function if you're using the Application Kit.
void PSmul(void)
void PSne(void)
void PSneg(void)
void PSnewinstance(void)¦
void PSnewpath(void)
void PSnextrelease(int size, char string[])¦
void PSnoaccess(void)
void PSnot(void)
void PSnotify(void)
void PSnull(void)
void PSnulldevice(void)
void PSobscurecursor(void)¦
void PSor(void)
void PSorderwindow(int place, userobject otherWindow, userobject window)
Warning:  Don't use this function if you're using the Application Kit.
void PSosname(int size, char string[])¦
void PSostype(int *ptype)¦
void PSpackedarray(void)
void PSpathbbox(float *pllx, float *plly, float *purx, float *pury)
void PSpathforall(void)
void PSplacewindow(float x, float y, float width, float height, userobject window)
Warning:  Don't use this function if you're using the Application Kit.
void PSplaysound(char *name, int priority)¦
void PSpop(void)
void PSposteventbycontext(int type, float x, float y, int time, int flags, int window, int subtype, int data1, int data2, int context, boolean *psuccess )¦
void PSprint(void)
void PSprinteventtimes(void)
void PSprintobject(int code)
void PSproduct(void)
void PSprompt(void)
void PSpstack(void)
void PSput(void)
void PSputinterval(void)
void PSquit(void)
void PSrand(void)
void PSrcheck(boolean *pflag)
void PSrcurveto(float x, float y, float x2, float y2, float x3, float y3)
void PSread(boolean *pflag)
void PSreadhexstring(boolean *pflag)
void PSreadimage(void)¦
void PSreadline(boolean *pflag)
void PSreadonly(void)
void PSreadstring(boolean *pflag)
void PSrealtime(int *pi)
void PSrectclip(float x, float y, float width, float height)
void PSrectfill(float x, float y, float width, float height)
void PSrectstroke(float x, float y, float width, float height)
void PSrectviewclip(float x, float y, float width, float height)
void PSrenamefile(char *old, char *new)
void PSrepeat(void)
void PSresetfile(void)
void PSresourceforall(char *category)
void PSresourcestatus(char *key, char *category, int *b)
void PSrestore(void)
void PSrevealcursor(void)¦
void PSreversepath(void)
void PSrevision(int *n)
void PSrightbracket(void)
void PSrightbuttondown(boolean *pflag)¦
void PSrightright(void)
void PSrightstilldown(int eventNum, boolean *pflag)¦
void PSrlineto(float x, float y)
void PSrmoveto(float x, float y)
void PSrootfont(void)
void PSroll(int n, int j)
void PSrotate(float angle)
void PSround(void)
void PSrrand(void)
void PSrun(char *name)
void PSsave(void)
void PSscale(float sx, float sy)
void PSscalefont(float size)
void PSscheck(boolean *pflag)
void PSscreenlist(int context, int count, int windows[])¦
void PSscreentobase(float x, float y, float *px, float *py)¦
void PSscreentocurrent(float x, float y, float *px, float *py)¦
void PSsearch(boolean *pflag)
void PSselectfont(char *name, float scale)
void PSsendboolean(boolean flag)
void PSsendchararray(char string[], int size)
void PSsendfloat(float value)
void PSsendfloatarray(float array[], int size)
void PSsendint(int value)
void PSsendintarray(int array[], int size)
void PSsendstring(char *string)
void PSserialnumber(int *n)
void PSsetactiveapp(int context)
Warning:  Don't use this function if you're using the Application Kit.
void PSsetalpha(float coverage)¦
void PSsetautofill(boolean flag, userobject window)¦
void PSsetbbox(float llx, float lly, float urx, float ury)
void PSsetblackgeneration(void)
void PSsetcachedevice(float wx, float wy, float llx, float lly, float urx, float ury)
void PSsetcachelimit(float num)
void PSsetcacheparams(void)
void PSsetcharwidth(float wx, float wy)
void PSsetcmykcolor(float c, float m, float y, float k)
void PSsetcolor(void)
void PSsetcolorrendering(void)
void PSsetcolorscreen(void)
void PSsetcolorspace(void)
void PSsetcolortransfer(void)
void PSsetcursor(float x, float y, float mx, float my)¦
void PSsetdash(float pattern[], int size, float offset)
void PSsetdefaultdepthlimit(int limit)¦
Warning:  Don't use this function if you're using the Application Kit.
void PSsetdevparams(void)
void PSseteventmask(int mask, userobject window)
Warning:  Don't use this function if you're using the Application Kit.
void PSsetexposurecolor(void)¦
void PSsetfileposition(int pos)
void PSsetflat(float flatness)
void PSsetflushexposures(boolean flag)¦
void PSsetfont(userobject font)
void PSsetframebuffertransfer(void)
void PSsetglobal(int b)
void PSsetgray(float num)
void PSsetgstate(userobject gstate)
void PSsethalftone(void)
void PSsethalftonephase(float x, float y)
void PSsethsbcolor(float hue, float sat, float brt)
void PSsetinstance(boolean flag)¦
void PSsetlinecap(int linecap)
void PSsetlinejoin(int linejoin)
void PSsetlinewidth(float width)
void PSsetmatrix(void)
void PSsetmiterlimit(float limit)
void PSsetmouse(float x, float y)¦
void PSsetobjectformat(int code)
void PSsetoverprint(int b)
void PSsetowner(userobject context, userobject window)¦
void PSsetpacking(boolean flag)
void PSsetpagedevice(void)
void PSsetpattern(int patternDict)
void PSsetrgbcolor(float red, float green, float blue)
void PSsetscreen(void)
void PSsetsendexposed(boolean flag, userobject window)¦
Warning:  Don't use this function if you're using the Application Kit.
void PSsetshared(boolean flag)
void PSsetshowpageprocedure(int win)¦
Warning:  Don't use this function if you're using the Application Kit.
void PSsetstrokeadjust(boolean flag)
void PSsetsystemparams(void)
void PSsettrackingrect(float x, float y, float width, float height, boolean leftFlag, boolean rightFlag, boolean inside, int userData, int trectNum, userobject gstate)¦
void PSsettransfer(void)
void PSsetucacheparams(void)
void PSsetundercolorremoval(void)
void PSsetuserparams(void)
void PSsetvmthreshold(int i)
void PSsetwaitcursorenabled(boolean flag)¦
void PSsetwindowdepthlimit(int limit, userobject window)¦
Warning:  Don't use this function if you're using the Application Kit.
void PSsetwindowdict(userobject window)
Warning:  Don't use this function if you're using the Application Kit.
void PSsetwindowlevel(int level, userobject window)¦
void PSsetwindowtype(int type, userobject window)¦
Warning:  Don't use this function if you're using the Application Kit.
void PSsetwriteblock(int flag)¦
void PSshareddict(void)
void PSSharedFontDirectory(void)
void PSshow(char *string)
void PSshowcursor(void)¦
void PSshowpage(void)
Warning:  This function is different in NeXTSTEP.
void PSsin(void)
void PSsizeimage(float x, float y, float width, float height, int *ppixelsWide, int *ppixelsHigh, int *pbitsPerSample, float matrix[], boolean *pmultiProc, int *pnColors)¦
void PSsqrt(void)
void PSsrand(void)
void PSstack(void)
void PSStandardEncoding(void)
void PSstart(void)
void PSstartjob(int b, char *password)
void PSstatus(boolean *pflag)
void PSstatusdict(void)
void PSstilldown(int eventNum, boolean *pflag)¦
void PSstop(void)
void PSstopped(void)
void PSstore(void)
void PSstring(int length)
void PSstringwidth(char *string, float *px, float *py)
void PSstroke(void)
void PSstrokepath(void)
void PSsub(void)
void PSsystemdict(void)
void PStermwindow(userobject window)
Warning:  Don't use this function if you're using the Application Kit.
void PStoken(boolean *pflag)
void PStransform(float x, float y, float *px, float *py)
void PStranslate(float x, float y)
void PStrue(void)
void PStruncate(void)
void PStype(void)
void PSuappend(char nums[], int n, char ops[], int l)
void PSucache(void)
void PSucachestatus(void)
void PSueofill(char nums[], int n, char ops[], int l)
void PSufill(char nums[], int n, char ops[], int l)
void PSundef(char *name)
void PSundefinefont(char *name)
void PSundefineresource(char *key, char *category)
void PSundefineuserobject(int index)
void PSupath(boolean flag)
void PSuserdict(void)
void PSuserobject(void)
void PSusertime(int *pmillisecs)
void PSustroke(char nums[], int n, char ops[], int l)
void PSustrokepath(char nums[], int n, char ops[], int l)
void PSversion(int bufsize, char buf[])
void PSviewclip(void)
void PSviewclippath(void)
void PSvmreclaim(int code)
void PSvmstatus(int *plevel, int *pused, int *pmax)
void PSwait(void)
void PSwcheck(boolean *pflag)
void PSwhere(boolean *pflag)
void PSwidthshow(float x, float y, int c, char *string)
void PSwindow(float x, float y, float width, float height, int type, int *pwindow)
Warning:  Don't use this function if you're using the Application Kit.
void PSwindowdevice(userobject window)¦
void PSwindowdeviceround(userobject window)¦
void PSwindowlist(int context, int count, int windows[])¦
void PSwrite(void)
void PSwritehexstring(void)
void PSwriteobject(int code)
void PSwritestring(void)
void PSwtranslation(float *px, float *py)
void PSxcheck(boolean *pflag)
void PSxor(void)
void PSxshow(char *string, float numArray[], int size)
void PSxyshow(char *string, float numArray[], int size)
void PSyield(void)
void PSyshow(char *string, float numArray[], int size)