This is macnapp.h in view mode; [Download] [Up]
/* macnapp.h -- general mac application library header
*/
/* (C) Copyright 1995 by Carnegie Mellon University
* All Rights Reserved.
*
* Permission to use, copy, modify, distribute, and sell this software
* and its documentation for any purpose is hereby granted without
* fee, provided that the above copyright notice appear in all copies
* and that both that copyright notice and this permission notice
* appear in supporting documentation, and that the name of Carnegie
* Mellon University not be used in advertising or publicity
* pertaining to distribution of the software without specific,
* written prior permission. Carnegie Mellon University makes no
* representations about the suitability of this software for any
* purpose. It is provided "as is" without express or implied
* warranty.
*
* CARNEGIE MELLON UNIVERSITY DISCLAIMS ALL WARRANTIES WITH REGARD TO
* THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
* AND FITNESS, IN NO EVENT SHALL CARNEGIE MELLON UNIVERSITY BE LIABLE
* FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
* WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN
* AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING
* OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
* SOFTWARE.
*/
/* (C) Copyright 1990-1995 by Christopher J. Newman
* All Rights Reserved.
*
* Permission to use, copy, modify, and distribute this software and its
* documentation for any purpose is hereby granted without fee, provided that
* the above copyright notice appear in all copies and that both that
* copyright notice and this permission notice appear in supporting
* documentation, and that the name of Christopher J. Newman not be used in
* advertising or publicity pertaining to distribution of the software without
* specific, written prior permission. Christopher J. Newman makes no
* representations about the suitability of this software for any purpose. It
* is provided "as is" without express or implied warranty.
*
* CHRISTOPHER J. NEWMAN DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
* INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT
* SHALL CHRISTOPHER J. NEWMAN BE LIABLE FOR ANY SPECIAL, INDIRECT OR
* CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
* DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
* TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
* OF THIS SOFTWARE.
*
* Author: Chris Newman
* Message: This is a nifty program.
*/
#ifdef THINK_C
#define QD(x) (x)
#ifndef NULL
#define NULL 0
#endif
#else
#define QD(x) (qd.x)
#include <MacTypes.h>
#include <Quickdraw.h>
#include <Events.h>
#include <Controls.h>
#include <Windows.h>
#include <MemoryMgr.h>
#include <Menus.h>
#include <OSUtils.h>
#include <TextEdit.h>
#include <Dialogs.h>
#endif
/* dual pascal/C strings
*/
typedef unsigned char PCstr;
#define C(str) ((char*)(str) + 1)
#define P(str) ((unsigned char*)(str))
/* various machine types.
*/
typedef unsigned short WORD;
typedef unsigned char BYTE;
/* useful macros:
*/
#define HIWORD(x) ( (WORD) ( (x) >> 16) )
#define LOWORD(x) ( (WORD) (x) )
/* most window/menu procedures return short integers (see defines below)
*/
typedef short (*na_menup)(struct na_win *, WORD, WORD);
typedef short (*na_mousep)(struct na_win *, Point, short, short);
typedef short (*na_ctrlp)(struct na_win *, Point, short, short, ControlHandle);
typedef short (*na_activep)(struct na_win *, Boolean);
typedef short (*na_closep)(struct na_win *);
typedef void (*na_afterp)(struct na_win *);
typedef short (*na_updatep)(struct na_win *, Boolean);
typedef short (*na_keyp)(struct na_win *, long, short);
typedef short (*na_cursorp)(struct na_win *, Point);
typedef short (*na_miscp)(struct na_win *, EventRecord *);
typedef short (*na_idlep)(struct na_win *);
typedef short (*na_taskp)(struct na_win *);
typedef short (*na_resizep)(struct na_win *, Point, Rect *);
typedef short (*na_openp)(short, FSSpec *, FInfo *);
typedef short (*na_initp)(struct na_win *, long *);
typedef struct na_win {
long flags; /* flags indicating various window settings (see below) */
short delay; /* delay between main loop cycles (in ticks) */
short mousepix; /* number of pixels mouse can move until drag starts */
short minw, minh; /* minimum width and height for the window */
short maxw, maxh; /* maximum width and height for the window */
short type; /* current window type (negatives reserved) */
BYTE locks; /* locks on this window structure */
short priority; /* priority if there is a taskp (-1 = everytime) */
RgnHandle cursorRgn; /* cursor region */
RgnHandle uncrsrRgn; /* region cursor isn't in */
WindowPtr pwin; /* window pointer */
struct na_win **next; /* handle to next window in linked list */
struct na_win **task; /* handle to next task in a linked list of active tasks */
struct na_win **child; /* handle to child window list (NULL = no child) */
struct na_win **parent; /* handle to parent window (NULL = toplevel) */
na_menup menup; /* menu proc */
na_mousep mousep; /* mouse proc */
na_ctrlp ctrlp; /* dialog item/control proc */
na_activep activep; /* activate proc */
na_closep closep; /* close proc */
na_afterp afterp; /* after proc */
na_updatep updatep; /* update proc */
na_keyp keyp; /* key proc */
na_cursorp cursorp; /* cursor setting proc */
na_miscp miscp; /* miscellaneous event proc (disk/net/app/driver) */
na_idlep idlep; /* idle proc */
na_taskp taskp; /* task proc */
na_resizep resizep; /* resize proc */
long resid; /* storage for window resource id or user data. */
char *data; /* data pointer for user */
} na_win;
typedef struct nate_win {
na_win winp;
TEHandle hTE; /* textedit handle for auto-textedit routines */
ControlHandle hctrl; /* horizontal scroll bar for textedit */
ControlHandle vctrl; /* vertical scroll bar for textedit */
long docwidth; /* width of the document */
short lheight; /* line height of text */
short topoff; /* offset from top of window to textedit area */
} nate_win;
/* procedures types:
*
* // called for menu events when window is frontmost
* // supercedes global menu function unless NA_NOTPROCESSED is returned.
* // if menuid is 0, the procedure should enable/disable menus appropriately
* // if menuid is 1, the procedure should disable enabled menus appropriately
* short menu(winp, menuid, itemno)
* WORD menuid; // resource id of the menu
* WORD itemno; // item number of the menu item
*
* // called for mouse down/up/move events in the window
* short mouse(winp, p, type, mods)
* Point p; // location of mouse action
* short type; // type of mouse action (see below)
* short mods; // modifier keys
*
* // called for dialog events in dialog windows
* // control events in windows with controls
* // In a dialog window with no key procedure, ESC, command-., return, enter are
* // mapped to iCancel and iOk.
* short control(winp, p, itemHit, mods, ctrlh)
* Point p; // point in window local coords
* short itemHit; // the item/part code clicked
* short mods; // modifier keys
* ControlHandle ctrlh; // handle to the control
*
* // called when window is activated or deactivated
* // close return values may be ignored on a deactivate
* short activate(winp, on)
* Boolean on; // true = activate, false = deactivate
*
* // called when a window close request has been made (close box/close menu item)
* // called when any window function returns NA_REQCLOSE or NA_REQCLOSEALL
* // respond with either NA_CLOSED or NA_NOTPROCESSED
* short close(winp)
*
* // called after window closed & removed from lists, but before window object freed
* void afterp(winp)
*
* // called on update events
* short update(winp, newsize)
* Boolean newsize; // true if r is a new window size
*
* // called on key/autokey events (menu keys are parsed out first)
* short key(winp, c, mods)
* long c; // ASCII value of the key (unless NA_RAWKEY option set)
* short mods; // modifier keys
*
* // called when cursor moves into or out of a window
* // use winp->flags & NA_CURSORON
* // close request return values are ignored.
* // return NA_PROCESSED only when the cursorRgn is changed
* short cursor(winp, p)
* Point p; // point where the cursor is
*
* // This is called for miscellaneous events (disk/network/driver/app1-3)
* short miscp(winp, pevent)
* EventRecord *pevent; // the event
*
* // called every time through the event loop when window active
* short idle(winp)
*
* // called cyclicly with other tasks with each pass through event loop
* // only used when task is installed
* // the task procedure can only close it's own window.
* short task(winp)
*
* // function called to resize the window
* // (parameters similar to GrowWindow function)
* short resize(winp, where, rct)
* Point where;
* Rect *rct;
*
* // function passed to NAinit:
* // should return 0 if OK, and -1 to stop opening files
* short open(message, afile, fspec)
* short message; // either appOpen or appPrint (in SegLoad.h)
* FSSpec *fspec; // file to open/print
* Finfo *finfo; // finder info
*
* // function passed to NAwindow:
* // returns standard window status
* short init(winp, datap)
* na_win *winp; // pointer to new window structure
* long *datap; // pointer to data passed through NAwindow
*/
/* niftyapp globals */
extern na_win **NAhead; /* handle to the head of the window tree */
extern na_win **NAtask; /* handle to the head of the window task list */
extern na_win **NActask; /* handle to the current task */
extern na_win *NAwin; /* pointer to current window (NULL = no current window) */
extern na_menup NAmenup; /* pointer to default menu procedure */
extern MenuHandle **NAmenus; /* list of menu handles */
extern short NAnewitem; /* item number of the new item on the file menu (0 = not avail) */
extern short NAcloseitem; /* item number of the close item on the file menu (0 = not avail) */
extern short NAappleitems; /* the number of (user) items at the top of the apple menu */
extern short NAhelpitems; /* the number of (user) help items */
extern short NAhelpcount; /* the number of (system) items at the top of the help menu */
extern Boolean NAhasedit; /* true if application has an edit menu */
extern long NAdelay; /* the wait next event delay */
extern SysEnvRec NAsysenv; /* mac system environment */
extern Boolean NAinBack; /* true if application is backgrounded */
extern long NAmousetime; /* time of last mouse up event */
extern short NAlastmouse; /* kind of last mouse event */
extern Cursor NAibeam; /* the ibeam cursor */
extern long NAgestaltBits; /* 0 = gestalt not on system */
/* globals for your convenience */
extern RgnHandle NAfullRgn, NAnullRgn;
/* niftyapp definitions */
/* default resource id for niftyapp windows */
#define NA_CLIPWINDOW 1000
#define NA_ABOUTDLOG 1000
#define NA_PREFSDLOG 1001
#define NA_HELPSTR 1000
/* default item numbers for OK & cancel */
#define iOk 1
#define iCancel 2
/* default ids for APPLE, FILE, EDIT, and HELP menus */
#define mApple 128
#define mFile 129
#define mEdit 130
#define mHelp ((WORD)-16490)
/* default item numbers for about & edit menu */
#define iAbout 1
#define iUndo 1
#define iCut 3
#define iCopy 4
#define iPaste 5
#define iClear 6
#define iSelAll 7
#define iClipboard 9
/* new window positions */
#define NA_HFULLSCN 0x0000
#define NA_HQUARTERSCN 0x0001
#define NA_HHALFSCN 0x0002
#define NA_H3QUARTERSCN 0x0003
#define NA_VFULLSCN 0x0000
#define NA_VQUARTERSCN 0x0004
#define NA_VHALFSCN 0x0008
#define NA_V3QUARTERSCN 0x000C
#define NA_CENTERSCN 0x0000
#define NA_TOPSCN 0x0010
#define NA_BOTTOMSCN 0x0020
#define NA_LEFTSCN 0x0040
#define NA_RIGHTSCN 0x0080
#define NA_TITLEOFFSET 0x0100
/* new window flags */
#define NA_PLAINWIN 0x00000000L /* plain window -- no title, simple border */
#define NA_COLORWINDOW 0x00000001L /* allow color in the window */
#define NA_DIALOGWINDOW 0x00000002L /* open as a dialog */
#define NA_TITLEBAR 0x00000004L /* have title bar */
#define NA_GROWBOX 0x00000008L /* have a grow box (enables automatic drawing) */
#define NA_ZOOMBOX 0x00000010L /* have a zoom box */
#define NA_CLOSEBOX 0x00000020L /* have a close box (enables close menu item) */
#define NA_SHADOWBORDER 0x00000040L /* have a shadow border (for dialogs) */
#define NA_DOUBLEBORDER 0x00000080L /* have a double (dialog) border */
#define NA_ROUNDBORDER 0x000000c0L /* have rounded corners and black title bar */
#define NA_CHILDWINDOW 0x00000100L /* open as a child window of current window */
#define NA_NOTVISIBLE 0x00000200L /* do not make window visible on open */
#define NA_BEHIND 0x00000400L /* open window behind current window */
#define NA_HASCONTROLS 0x00000800L /* process/draw/kill controls automatically */
#define NA_HASTASK 0x00001000L /* install window in background task list */
#define NA_USERESOURCE 0x00002000L /* use res parameter as WIND/DLOG/wctb/dctb resource */
#define NA_CURSORON 0x00004000L /* true if application has set the cursor */
#define NA_MODAL 0x00008000L /* set if window/dialog will be modal */
#define NA_DEFBUTTON 0x00010000L /* show default button after init proc */
#define NA_COPYDATA 0x00020000L /* data will by copied by NAwindow */
#define NA_SMARTSIZE 0x00040000L /* window resizes & placements are saved in WIND res */
#define NA_FORCESIZE 0x00080000L /* when a resource is used, re-size the window anyway */
#define NA_RAWKEY 0x00100000L /* if set, key event fields aren't stripped */
#define NA_HILITECTRLS 0x00200000L /* if set, hilite controls on activate/deactive */
#define NATE_FLAGS 0x0f000000L /* flags reserved for NATE */
#define NA_USER_FLAG1 0x10000000L /* flags reserved for users */
#define NA_USER_FLAG2 0x20000000L
#define NA_USER_FLAG3 0x40000000L
#define NA_USER_FLAG4 0x80000000L
/* niftyapp window/task types */
#define NA_CLIPTYPE -1
#define NA_DEBUGTYPE -2
#define NA_TCPTYPE -3
#define NA_SMTPTYPE -4
/* mouse click types */
#define NA_DOWN1 0
#define NA_UP1 1
#define NA_DOWN2 2
#define NA_UP2 3
#define NA_DOWNN 4
#define NA_UPN 5
#define NA_DRAG 6
#define NA_RELEASE 7
/* return values for window/menu procedures */
#define NA_ALLCLOSED -4 /* all windows are to be destroyed & exit app immediately */
#define NA_REQCLOSEALL -3 /* request to close all windows & exit app */
#define NA_CLOSED -2 /* current window is ready to close (used by closep/taskp) */
#define NA_REQCLOSE -1 /* request to close current window */
#define NA_NOTPROCESSED 0 /* use any default handler available */
#define NA_PROCESSED 1 /* do nothing more */
#define NA_USERINTERACT 2 /* user interaction pending -- don't do tasks */
/* Gestalt bits */
#define NA_HASAEVENTS 0x00000001L /* Apple events supported */
#define NA_HASFSSPEC 0x00000002L /* FSSpec calls supported */
#define NA_HASSTDFILE 0x00000004L /* New standard file available */
/* niftyapp basic macros */
#define NAunlockWindow(winp) {if (!--(winp)->locks) HUnlock((Handle) GetWRefCon((winp)->pwin));}
#define NAunlockWindowh(winh, winp) {if (!--(winp)->locks) HUnlock((Handle) winh);}
#define NAisDAWindow(pWnd) (( (WindowPeek) pWnd)->windowKind < 0)
#define NAmenuh(menu) ((*NAmenus)[(menu) - mApple])
#define NAenableMItem(menu, item) EnableItem(NAmenuh(menu), item)
#define NAdisableMItem(menu, item) DisableItem(NAmenuh(menu), item)
#define NAcheckItem(menu, item, c) CheckItem(NAmenuh(menu), item, c)
#define NAgetDHandle(dlg, it, hn) {short ty; Rect r; GetDItem(dlg, it, &ty, (Handle *) (hn), &r);}
#define NAgetDRect(dlg, it, rct) {short ty; Handle hn; GetDItem(dlg, it, &ty, &hn, (rct));}
#define NAsetIval(dlg, it, val) {short ty; Rect r; Handle hn; GetDItem(dlg, it, &ty, &hn, &r); SetCtlValue((ControlHandle)hn, (val));}
#define NAsetInum(dlg, it, val) NAsetIText(dlg, it, longtoPCstr(val))
#define NAalert(resid) Alert(resid, NAfilterProc)
/* niftyapp basic procedures */
/* initialize the Macintosh managers and niftyapp internal variables.
* optionally set up a menu bar & menu procedure.
* Returns 0 if OK, negative if an error occured, 1 if print files requested & app should quit
* short minK; // minimum K needed to execute
* short masters; // number of times to call MoreMasters()
* na_proc *openp; // open file procedure -- called for each application in the startup list
* na_proc *menup; // pointer to a menu procedure (NULL = no menu handling)
* short nummenu; // number of menus (starting at mApple == 128)
* short numapple; // number of apple menu items
* short newitem; // item number of new item (mFile)
* short closeitem; // item number of close item (mFile)
*/
short NAinit(short, short, na_openp, na_menup, short, short, short, short);
/* call the main loop procedure
*/
void NAmainloop(void);
/* create a rectangle based on the screen size
* short position; // see above
*/
Rect *NAscreenrect(short);
/* create a new window structure
* returns window status result, up to the caller to pass on NA_ALLCLOSED
* Rect *rpos; // placement rectangle
* long flags; // flags determining type of window
* char *title; // window title (C string may not be NULL unless NA_USERESOURCE)
* short res; // resource number of WIND/DLOG/wctb/dctb/DITL
* long *initdata; // window data (may be NULL)
* long datasize; // bytes of window data
* na_proc *initp; // procedure to initialize the window functions, etc.
*/
short NAwindow(Rect *, long, char *, short, long *, long, na_initp);
/* create & add a new task to the task list, given pointer to task procedure,
* and data size
*/
na_win **NAaddtask(na_taskp, long);
/* standard init procedure for an about box -- stops all background tasks, however */
short NAabout(na_win*, long*);
/* standard button flash procedure used by shell for keypresses */
void NAflashButton(DialogPtr, short);
/* draw the default button */
void NAdefaultButton(DialogPtr);
/* filter proc for modal dialogs which handles ESC and command-. */
pascal Boolean NAfilterProc(DialogPtr, EventRecord *, short *);
/* re-calculate cursor region information (after changing winp->cursorRgn) */
void NAcalcCursor(na_win*);
/* this saves a window's dimensions into a 'WIND' resource with appropriate resid */
void NAsaveWin(na_win*);
/* This is available to access window structures other than the current window
* best for looking at parent window or child window(s).
*/
na_win *NAlockWindow(na_win**);
/* This is available, but the user should only call it is severe cases */
short NAcloseWindow(na_win*, short);
/* this is for closing all windows, the user should only call it from main
* usually NAhead is the first parameter.
*/
short NAcloseWindows(na_win**, short);
/* this is for sending an event directly to the misc procedure of all windows.
* usually NAhead is the first parameter.
*/
short NAallWindows(na_win**, EventRecord*);
/* niftyapp clipboard library:
* NAclipboard: true = window on, false = window off, 'TEXT' or 'PICT'
*/
void NAclipboard(Boolean, ResType);
/* niftyapp debug library:
*/
void NAdebug(char *, ...);
#ifdef DEBUG
#define NADEBUG(x) NAdebug x
#else
#define NADEBUG(x)
#endif
/* niftyapp dialog library:
*/
/* select a radio button
* returns number from 0 to firstitem - lastitem: the button that's been pressed
* DialogPtr dialog; // the dialog window
* short firstitem; // the itemno of first radio button
* short lastitem; // the itemno of last radio button
* short setting; // the radio button to set (itemno to lastitem)
*/
short NAradioSet(DialogPtr, short, short, short);
/* get the itemno of the active radio button
* DialogPtr dialog; // the dialog window
* short firstitem; // the itemno of first radio button
* short lastitem; // the itemno of last radio button
*/
short NAradioGet(DialogPtr, short, short);
/* enable/disable,hilite,show/hide an item in a dialog window */
void NAenableDItem(DialogPtr, short, Boolean);
void NAhiliteDItem(DialogPtr, short, short);
void NAvisibleDItem(DialogPtr, short, Boolean);
/* set/get the item text in a dialog item */
void NAsetIText(DialogPtr, short, PCstr*);
void NAgetIText(DialogPtr, short, PCstr*);
/* enable/disable modal menus for a moveable modal dialog box (1 = go modal) */
void NAmodalMenus(int);
/* handle edit menu for dialogs */
short NAdialogMenu(na_win *, WORD, WORD);
/* NATE (NiftyApp TextEdit) libraries
*/
#define NATEflags (NA_TITLEBAR | NA_GROWBOX | NA_ZOOMBOX | NA_CLOSEBOX \
| NA_HASCONTROLS | NA_HILITECTRLS)
#define NATE_DEFAULT 0x00000000L
#define NATE_READONLY 0x01000000L
#define NATE_NOMOUSE 0x02000000L
#define NATE_NOHSCROLL 0x04000000L
#define NATE_NOVSCROLL 0x08000000L
void NATEinit(na_win*, long, short, Ptr, long); /* winp, flags, horizwidth, data, len */
short NATEinitp(na_win*, long*);
short NATEmousep(na_win*, Point, short, short);
short NATEidlep(na_win*);
short NATEactivep(na_win*, Boolean);
short NATEkeyp(na_win*, long, short);
short NATEmenup(na_win*, WORD, WORD);
short NATEupdatep(na_win*, Boolean);
short NATEctrlp(na_win*, Point, short, short, ControlHandle);
short NATEclosep(na_win*);
void NATEsetscroll(na_win*, Boolean, Rect*, Rect*);
void NATEappend(na_win*, char*, long);
/* Niftyapp file library
*/
/* get a file to open -- similar to StandardGetFile, but works on older systems
* extra fields in "StandardFileReply" are only valid if NA_HASSTDFILE is set in
* NAgestaltBits
*/
void NAgetFile(FileFilterProcPtr, short, SFTypeList, StandardFileReply *);
/* put a file to open -- similar to StandardPutFile, but works on older systems
* extra fields in "StandardFileReply" are only valid if NA_HASSTDFILE is set in
* NAgestaltBits
*/
void NAputFile(Str255, Str255, StandardFileReply *);
/* Niftyapp TCP library
*/
/* tcp stream descriptor */
typedef int na_tcp;
/* tcp init function
* passed NATCP_connect for success, NATCP_nodriver/NATCP_nomem for failure
* passed 1 to 100 for progress waiting for MacTCP to finish cleanly
*/
typedef void na_tcpinitp(short);
/* TCP read/status callback for connection, or TCP window
* void *user; Context generic pointer (passed to NATCPopen)
* na_tcp s; TCP stream id
* short status; TCP status (see below)
* long size; size of buffer (or Macintosh error)
* char *data; data or NULL
*/
typedef void na_tcpreadp(void *, na_tcp, short, long, char *);
typedef void na_readp(na_win *, short, long, char *);
/* TCP window */
typedef struct natcp_win {
na_win winp;
na_tcp s;
na_readp *readp;
} natcp_win;
/* status values/bits */
#define NATCP_closing 0x08 /* other end of connection closed */
#define NATCP_urgent 0x04 /* in urgent mode */
#define NATCP_more 0x02 /* more data will follow immediately */
#define NATCP_data 0x01 /* data to read */
#define NATCP_connect 0x00 /* connection ready */
#define NATCP_noread -1 /* non-fatal */
#define NATCP_nowrite -2 /* fatal... */
#define NATCP_nodriver -3
#define NATCP_notcpbuf -4
#define NATCP_nomem -5
#define NATCP_nohost -6
#define NATCP_nocon -7
#define NATCP_closed -8 /* connection fully closed */
/* open flags */
#define NATCP_server 0x01 /* be a server */
/* functions */
void NATCPinit(na_tcpinitp *);
/* NATCPsettings: TCP buffer size, type of service, precedence, write buffer size */
void NATCPsettings(long, short, short, unsigned short);
short NATCPtask(na_win *);
/* NATCPopen: callback, context, host, port, flags */
na_tcp NATCPopen(na_tcpreadp *, void *, char *, long, short);
na_tcp NATCPwinopen(natcp_win *, char *, long, short); /* tcp window, host, port, flags */
short NATCPwrite(na_tcp, Ptr, long, short); /* tcp, buffer, length, dispose */
short NATCPputchar(na_tcp, char);
void NATCPclose(na_tcp);
void NATCPdone(long); /* number of 1/60 sec intervals to wait for MacTCP to finish cleanly */
/* returns passes NATCP_connect to readp on success with hostname as argument */
void NATCPgethost(na_tcpreadp *, void *);
/* niftyapp SMTP library
*/
/* status:
* void *context; user context
* short code; see below
* short err; SMTP error code or NATCP error code (NASMTP_tcpfail) or 0
* long num; macintosh TCP error code or address number or 0
* char *errstr; SMTP error string or NULL
*/
typedef void (*na_smtpstat)(void *, short, short, long, char *);
#define NASMTP_progress 2 /* progress: err = % done */
#define NASMTP_badaddr 1 /* address was not valid */
#define NASMTP_completed 0 /* success */
#define NASMTP_nomem -1 /* not enough memory */
#define NASMTP_badargs -2 /* input arguments invalid */
#define NASMTP_oserr -3 /* OS failure (e.g. file error) */
#define NASMTP_tcpfail -4 /* TCP connection to SMTP server failed */
#define NASMTP_conclosed -5 /* connection closed by other side before completion */
#define NASMTP_badprot -6 /* other end sent unrecognizable protocol */
#define NASMTP_temperr -7 /* SMTP persistant temporary failure */
#define NASMTP_permerr -8 /* SMTP permanent failure */
/* Submit email: statf, server, fspec, headers, envelope, flags, context */
void NASMTPsubmit(na_smtpstat, char *, FSSpec *, Handle, Handle, short, void *);
#define NASMTP_crtrans 0x01 /* flag indicating translation of CR -> CRLF desired */
/* PC, C string libraries:
*/
#define SetClen(pcstr) (*((pcstr) + *(pcstr) + 1) = '\0')
#define PCstrlen(pcstr) (*(pcstr))
#define Pstrlen(pstr) (* (unsigned char *) (pstr))
void PtoPCstrcpy(PCstr*, char*);
void CtoPCstrcpy(PCstr*, char*);
void PCtoPCstrcpy(PCstr*, PCstr*);
void PtoPCstrncpy(PCstr*, char*, short);
void CtoPCstrncpy(PCstr*, char*, short);
void PtoPCstrcat(PCstr*, char*);
void CtoPCstrcat(PCstr*, char*);
PCstr *PtoPCstr(char*);
PCstr *CtoPCstr(char*);
void SetPlen(PCstr*);
PCstr *longtoPCstr(long);
These are the contents of the former NiCE NeXT User Group NeXTSTEP/OpenStep software archive, currently hosted by Netfuture.ch.