Liren Large Software Subsidy 11

home *** CD-ROM | disk | FTP | other *** search

/ Liren Large Software Subsidy 11 / 11.iso / m / m242 / 1.ddi / READ.ME < prev next >

Wrap

Text File | 1989-12-24 | 14.1 KB | 463 lines

############################################################################## # # # # # # Essential Graphics # # # # Version 3.0 # # # # # # ############################################################################## These diskettes contain version 3.0 of Essential Graphics. Please print or read through the remainder of this file for bug fixes and/or manual updates. ############################################################################## # # # # # # Installation # # # # # # ############################################################################## To install this product run the INSTALL.EXE program from this disk. It is self explanatory and will walk you through its options. ############################################################################## # # # # # # Diskette # # # # Contents # # # # # # ############################################################################## Disk #1 Disk #2 ------- ------- HFILES.ZIP FONTS.ZIP INSTALL.EXE SMSEGL.ZIP /* MSC large */ PKUNZIP.EXE VER2FUNCS.ZIP PKZIP.EXE READ.ME SMSEGS.ZIP /* MSC small model */ SOURCE.ZIP Disk #3 Disk #4 ------- ------- DEMOS1.ZIP DEMOS2.ZIP \Turbo SMSCAPT.ZIP SMSEGS.ZIP /* TC small model */ \Turbo SMSEGL.ZIP /* TC large */ If you have any questions, comments or suggestions call us at : (201) 762-6965. Our BBS # is : (201) 762-0339 ############################################################################## # # # # # # NOTES FOR UPGRADES # # # # FROM VER 2.0 # # # # # # ############################################################################## In order to consolidate and provide a more efficient set of functions for Essential Graphics version 3.0, the following functions have been renamed or are now grouped into 1 function call. See the documentation for more information on the function and the VER2FUNC.ZIP file on disk #2 for source code to these functions. Version 2.0 Name Version 3.0 Name ---------------- ---------------- ARC, ARCQ, GRARCA, GRARC, HTARC EG_ARC TARC EG_TARC A_LINETO, R_LINETO, GRDMOVE, GRMOVE EG_LINETO CIRCLE, CIRCLEQ, GRCIRCA, GRCIRC EG_LINETO COPYPAGE GCOPYPAG DOT EG_DOT FONTLD FONT_LOAD FONTCHG2 FONT_CHANGE FONTINF2 FONT_INFO FONTULD FONT_UNLOAD GRLINE EG_LINE GRDOTB, GRDASH SET_LINE_STYLE GRBXFILL, GRBXCTC, GRBXCT, GRBXULC EG_RECTANGLE GRBXLL, GRBXLR, GRBXLRC, GRBXUL GRBXUR, GRBXURC, GRBXLLC, GRRTURC GRRTCTC, GRRTLL, GRRTLLC, GRRTLR GRRTLRC, GRRTUL, GRRTULC, GRRTUR GRRTCT, HTRECT ABS_POLY, REL_POLY, GRPOLY, GRSHAPE EG_POLYGON POLYFILL GRELIP, GRELIPQ, GRELIPA, GRELIPQA EG_ELLIPSE GRSHDN, GRSHDUP, GRSHLF, GRSHRT EG_SHADE The following functions have been deleted and are no longer available. See the below 3.0 functions for comparable capabilities. Version 2.0 Name Version 3.0 Name ---------------- ---------------- GRXLAB, GRYLAB FHATSAY EASYINIT HATCH FUNCTIONS GETMODE, GETVIEW, GETWORLD EG_STATUS GETWORLD GLABEL, GLABINIT, GSETMARK EG_GRAPH HSALLOC, HSFREE, VSINIT HSBAR???, HTBAR??? EG_GRAPH, TD_CHART HTARC, HTPIE TD_PIE SET_11H SETVGA ############################################################################## # # # # # # 3-D Charting Notes # # # # # # ############################################################################## 1) All data arrays declared as floats should be declared as doubles instead. This will be consistent with our floating point version. 2) Label along the xz-plane and yz-plane will not print if frameflag is set to 0 in td_chart(). 3) Although you can label along both the xz-plane and yz-planes, the number of grids and other information is the same for both sides. 4) If phi > 90 degrees, labels around the XY plane will not be displayed. ############################################################################## # # # # # # 2-D Charting Notes # # # # # # ############################################################################## 1) When filling out the structure members for eg_graph(), remember that the number of grids refers to the number of boxes along any axis. To line up a grid line for each 1 of your labels and/or data values, you should set the num_grids value equal to the number of data values-1 or number of labels-1. This will setup your graph and labels nicely. 2) Try to use small labels when printing. This will help to avoid overwriting and clutter along the axes. 3) Set hatch patterns for drawing bar charts. The item_color member in these cases is a hatch pattern, not a color. ############################################################################## # # # # # # Scanner Notes # # # # # # ############################################################################## Support for the HP ScanJet will be available shortly, call for information on availability. ############################################################################## # # # # # # Floating Point Version # # # # # # ############################################################################## Support for floating point coordinates is available by phone or mail. If you need this version please call or write for a set of disks. ############################################################################## # # # # # # Plotter Notes # # # # # # ############################################################################## Plotter viewport: In order to use clipping and viewports coorectly on the plotter, call p_setview() with the appropriate plotter hard clip limits. For example, on an HP7440 ColorPro the hard clip limits can be found in the HP Programmers Manual under Hard-Clip Limits. They are as follows: X : 0 - 10300 Y : 0 - 7650 Call p_setview(0,0,10300,7650) to use all available plotter space. ---------------------------------------------------------------------------- Plotter initialization: If you wish to use the plotter in a screen mode resolution, call initgraf2() to set up our external variables. ############################################################################## # # # # # # Documentation # # # # Updates # # # # # # ############################################################################## Page 3-12 The default colors for an EGA or VGA card are : 0,1,2,3,4,5,20,7,56,57,58,59,60,61,62,63 ============================================================================== CHECK_VID7 Page 7-7 The example should have a pointer to a char as a parameter for this function. EXAMPLE char banks; if (check_vid7(&banks)) printf("Video Seven card present\n"); else printf("Video Seven card not present\n"); ============================================================================== EG_GRAPH Page 4 - 11 In the example EG_TYPE stack_bars[BARS][BARS_IN_THE_STACK], the stack_bars array is just a suggested name. There is no array defined with this name. Place your own array variable here. Page 4 - 12 For an Above/Below graph, the bar_type structure member must be set equal to VERT_BARS, not HORZ_BARS as in the manual. Page 4 - 18 There is no hatch parameter to EG_CIRCLE. See EG_ARC for hatch fills. Page 7 - 24 Replace any use of the word icon in the structure members with symbol. The corect member names can be found on page 4-2. ============================================================================== GET_BASE,SET_BASE Page 7-62 The parameters for the two functions should be switched. GET_BASE() gets the pointers to the locations, not SET_BASE(). ============================================================================== EG_CIRCLE Page 7-20 There is no hatch parameter in this function. See EG_ARC to fill a 360 degree arc. ============================================================================== MODE_SAVE_SCR, MODE_REST_SCR Page 7-75 After initializing a text screen with the mode number+128, call TEXT_RESET() to reset the text mode correctly. This function has no parameters. ============================================================================== SCRNDUMP Page 7-145 For the 640x200 modes, there are 3 shades for the IBM or Epson printers in sizes 0 or 1. Page 148 For the 720x348 mode, there is an additional size available. Size 2 is approximately 1 page using quad density. Page 154 Sizes for the 800x600 and 1024x768 modes were omitted. They are as follows: Mode Size Description ---- ---- ----------- 800x600 0 approx. 1/15 page, 1 color 1 approx. 1/3 page, 1 color 2 approx. 1/3 page, 3 color 3 approx. 2/3 page, 1 color 1024x768 0 approx. 1/8 page, 1 color 1 approx. 1/2 page, 1 color 2 approx. 2/3 page, 3 color, 300 dpi. Page 155 Sizes for the 640x350 and 640x400 modes were omitted. They are as follows: Mode Size Description ---- ---- ----------- 640x350 0 approx. 1/12 page, 1 color 1 approx. 1/3 page, 3 color 2 approx. 2/3 page, 3 color 3 approx. 1 page, 3 color 640x400 0 approx. 1/10 page, 1 color 1 approx. 1/3 page, 3 color 2 approx. 3/4 page, 3 color Page 156 Sizes for the 640x400 modes were omitted. They are as follows: Mode Size Description ---- ---- ----------- 640x400 0 approx. 1/10 page, 1 color 1 approx. 1/3 page, 3 color 2 approx. 2/3 page, 3 color Page 156 There is no size 3 for 720x348 modes. ============================================================================== TD_CHART page 7-196 Add -5 to the return codes section. -5 = Not enough memory available ============================================================================== TD_MIDPLANE page 7-202 If the fill_color = -99,only the frame is drawn, no filling of color is used. ============================================================================== NAME td_graph_dim - set the dimensions between actual graph area and viewport SYNOPSIS void td_graph_dim(top,bottom,left,right) float top; /* space above the graph */ float bottom; /* space below the graph */ float left; /* space left of the graph */ float right; /* space right of the graph */ DESCRIPTION This function allows you to set the space between the viewport and the actual graph area. This space is used for the labels. Once you call tdbarset(), these values will be set automatically depending on the resolution you use. These values will be estimated automatically for your graph. If the labels still can not fit in the alotted space, you can adjust these values to let the labels fit in. See the figure and graphs in the EXAMPLE. RETURN None NOTE A -1 will use the default or current values. Any other negative value should not be used. EXAMPLE ---------------------------- | (top) r | | ----------------- i | | l | | g | <--- viewport | e | | h | | f | | t | | t | |<---------- actual graph size | ----------------- | | (bottom) | ---------------------------- If the labels were clipped by the viewport since the default space is not enough to fit in the labels. Call this function to increase the dimension between the viewport and the actual graph area. ============================================================================== NAME td_singlecolor - draw a 3-D chart using a single color for the object SYNOPSIS void td_singlecolor(top_color,left_color,right_color) int top_color; /* top object color */ int left_color; /* left side object color */ int right_color; /* right side object color */ DESCRIPTION This function allows you to set all the bars, pyramids, etc. in a 3D chart to have all the same colors on the top, left and right hand sides. RETURN None NOTE A -9999 will reset the colors to use multiple colors. ============================================================================== NAME vfpixn - return the number of pixels needed to print the string SYNOPSIS i = vfpixn(vect,str,dir,space); int i; return value struct vfont *vect; pointer to loaded vector font char *str; string pointer int dir; direction of printing: 0 - horizontal 1 - vertical int space; if vertical printing, number of spaces between characters DESCRIPTION The function returns the number of pixels needed to print the string. RETURNS i >= 0 successful call, return is the number of pixels -1 a character not part of font NOTES If the direction is horizontal, the space parameter is ignored. EXAMPLE struct vfont *fk; /* vector font to use */ dx=vfpixn(fk,"testfont",0,0); ==============================================================================