home *** CD-ROM | disk | FTP | other *** search
/ OpenStep 4.2 / Openstep-4.2-Intel-Developer.iso / NextLibrary / Frameworks / AppKit.framework / Versions / B / Headers / NSGraphics.h < prev    next >
Text File  |  1997-02-20  |  5KB  |  97 lines
  1. /*
  2.     NSGraphics.h
  3.     Application Kit
  4.     Copyright (c) 1994-1996, NeXT Software, Inc.
  5.     All rights reserved.
  6. */
  7.  
  8. #import <Foundation/Foundation.h> 
  9. #import <AppKit/dpsclient.h>
  10. #import <AppKit/AppKitDefines.h>
  11.  
  12. @class NSColor;
  13.  
  14. /* Predefined colorspace names.
  15. */
  16. APPKIT_EXTERN NSString *NSCalibratedWhiteColorSpace;    /* 1.0 == white */
  17. APPKIT_EXTERN NSString *NSCalibratedBlackColorSpace;    /* 1.0 == black */
  18. APPKIT_EXTERN NSString *NSCalibratedRGBColorSpace;
  19. APPKIT_EXTERN NSString *NSDeviceWhiteColorSpace;    /* 1.0 == white */
  20. APPKIT_EXTERN NSString *NSDeviceBlackColorSpace;    /* 1.0 == black */
  21. APPKIT_EXTERN NSString *NSDeviceRGBColorSpace;
  22. APPKIT_EXTERN NSString *NSDeviceCMYKColorSpace;
  23. APPKIT_EXTERN NSString *NSNamedColorSpace;        /* Used for "catalog" colors */
  24. APPKIT_EXTERN NSString *NSCustomColorSpace;        /* Used to indicate a custom gstate in images */
  25.  
  26.  
  27. /* NSWindowDepth defines the values used in setting window depth limits. "0" indicates default depth. Window depths should not be made persistent as they will not be the same across systems. Use the functions NSBPSFromDepth(), NSColorSpaceFromDepth(), NSBitsPerPixelFromDepth(), and NSPlanarFromDepth() to extract info from an NSWindowDepth. Use NSBestDepth() to compute window depths. NSBestDepth() will try to accomodate all the parameters (match or better); if there are multiple matches, it gives the closest, with matching colorSpace first, then bps, then planar, then bpp. bpp is "bits per pixel"; 0 indicates default (same as the number of bits per plane, either bps or bps * NSNumberOfColorComponents()); other values maybe used as hints to provide backing stores of different configuration; for instance, 8 bit color. exactMatch is optional and indicates whether all the parameters matched exactly.
  28. */
  29. typedef int NSWindowDepth;
  30. APPKIT_EXTERN NSWindowDepth NSBestDepth (NSString *colorSpace, int bps, int bpp, BOOL planar, BOOL *exactMatch);
  31. APPKIT_EXTERN BOOL NSPlanarFromDepth (NSWindowDepth depth);
  32. APPKIT_EXTERN NSString *NSColorSpaceFromDepth (NSWindowDepth depth);
  33. APPKIT_EXTERN int NSBitsPerSampleFromDepth (NSWindowDepth depth);
  34. APPKIT_EXTERN int NSBitsPerPixelFromDepth (NSWindowDepth depth);
  35. APPKIT_EXTERN int NSNumberOfColorComponents (NSString *colorSpaceName);
  36. APPKIT_EXTERN const NSWindowDepth *NSAvailableWindowDepths (void); /* 0 terminated */
  37.  
  38.  
  39. /* Standard gray values for the 2-bit deep grayscale colorspace.
  40. */
  41. APPKIT_EXTERN const float NSWhite;
  42. APPKIT_EXTERN const float NSLightGray;
  43. APPKIT_EXTERN const float NSDarkGray;
  44. APPKIT_EXTERN const float NSBlack;
  45.  
  46.  
  47. /* Keys for deviceDescription dictionaries.
  48. */
  49. APPKIT_EXTERN NSString *NSDeviceResolution;        /* NSValue containing NSSize, basically dpi */
  50. APPKIT_EXTERN NSString *NSDeviceColorSpaceName;    /* NSString */
  51. APPKIT_EXTERN NSString *NSDeviceBitsPerSample;        /* NSValue containing int */
  52. APPKIT_EXTERN NSString *NSDeviceIsScreen;        /* "YES" or not there */
  53. APPKIT_EXTERN NSString *NSDeviceIsPrinter;        /* "YES" or not there */
  54. APPKIT_EXTERN NSString *NSDeviceSize;            /* NSValue containing NSSize */
  55.  
  56.  
  57. /* Graphics functions
  58. */
  59. APPKIT_EXTERN void NSRectFill(NSRect aRect);
  60. APPKIT_EXTERN void NSRectFillList(const NSRect *rects, int count);
  61. APPKIT_EXTERN void NSRectFillListWithGrays(const NSRect *rects, const float *grays, int num);
  62. APPKIT_EXTERN void NSFrameRect(NSRect aRect);
  63. APPKIT_EXTERN void NSFrameRectWithWidth(NSRect aRect, float frameWidth);
  64. APPKIT_EXTERN void NSRectClip(NSRect aRect);
  65. APPKIT_EXTERN void NSRectClipList(const NSRect *rects, int count);
  66. APPKIT_EXTERN NSRect NSDrawTiledRects(NSRect boundsRect, NSRect clipRect, const NSRectEdge *sides, const float *grays, int count);
  67. APPKIT_EXTERN void NSDrawGrayBezel(NSRect aRect, NSRect clipRect);
  68. APPKIT_EXTERN void NSDrawGroove(NSRect aRect, NSRect clipRect);
  69. APPKIT_EXTERN void NSDrawWhiteBezel(NSRect aRect, NSRect clipRect);
  70. APPKIT_EXTERN void NSDrawButton(NSRect aRect, NSRect clipRect);
  71. APPKIT_EXTERN void NSEraseRect(NSRect aRect);
  72. APPKIT_EXTERN NSColor *NSReadPixel(NSPoint passedPoint);
  73. APPKIT_EXTERN void NSDrawBitmap(NSRect rect, int width, int height, int bps, int spp, int bpp, int bpr, BOOL isPlanar, BOOL hasAlpha, NSString *colorSpaceName, const unsigned char *const data[5]);
  74. APPKIT_EXTERN void NSCopyBitmapFromGState(int srcGState, NSRect srcRect, NSRect destRect);
  75. APPKIT_EXTERN void NSCopyBits(int srcGState, NSRect srcRect, NSPoint destPoint);
  76. APPKIT_EXTERN void NSHighlightRect(NSRect aRect);
  77. APPKIT_EXTERN void NSBeep(void);
  78.  
  79.  
  80. #ifndef STRICT_OPENSTEP
  81.  
  82. APPKIT_EXTERN void NSConvertWindowNumberToGlobal(int winNum, unsigned int *globalNum);
  83. APPKIT_EXTERN void NSConvertGlobalToWindowNumber(int globalNum, unsigned int *winNum);
  84. APPKIT_EXTERN void NSCountWindows(int *count);
  85. APPKIT_EXTERN void NSWindowList(int size, int list[]);
  86.  
  87. /* gets performance stats about window server memory usage */
  88. APPKIT_EXTERN int NSGetWindowServerMemory(DPSContext context, int *virtualMemory, int *windowBackingMemory, NSString **windowDumpString);
  89.  
  90. APPKIT_EXTERN void NSRectFillListWithColors(const NSRect *rects, NSColor **colors, int num);
  91. APPKIT_EXTERN NSRect NSDrawColorTiledRects(NSRect boundsRect, NSRect clipRect, const NSRectEdge *sides, NSColor **colors, int count);
  92. APPKIT_EXTERN void NSDrawDarkBezel(NSRect aRect, NSRect clipRect);
  93. APPKIT_EXTERN void NSDrawLightBezel(NSRect aRect, NSRect clipRect);
  94. APPKIT_EXTERN void NSDottedFrameRect(NSRect aRect);
  95.  
  96. #endif
  97.