Up
Authors
- Richard Frith-Macdonald (
richard@brainstorm.co.uk)
-
- Adam Fedor (
fedor@gnu.org)
-
Date: Generated at 2023-12-22 15:07:50 -0500
GNUstep drawing context class.
Copyright: (C) 1998,1999 Free Software Foundation, Inc.
This is an abstract class which provides a framework for a
device independant drawing.
In addition, this class provides methods to perform the
actual drawing. As a convenience, you can also access
these through various function interfaces. One is a
Display Postscript interface using PS and DPS
operations. Another is a Quartz interface (not yet
written).
- Declared in:
- AppKit/NSGraphicsContext.h
Availability: OpenStep
Description forthcoming.
Instance Variables
Method summary
+ (BOOL)
currentContextDrawingToScreen;
Availability: OpenStep
Returns YES if the current context is
a display context
+ (
NSGraphicsContext*)
graphicsContextWithAttributes: (NSDictionary*)attributes;
Availability: OpenStep
Create a graphics context with
attributes, which contains key/value
pairs which describe the specifics of how the
context is to be initialized.
+ (
NSGraphicsContext*)
graphicsContextWithCGContext: (
CGContextRef)ctx
flipped: (BOOL)flipped;
Availability: MacOS-X 10.10.0
Description forthcoming.
+ (
NSGraphicsContext*)
graphicsContextWithGraphicsPort: (void*)port
flipped: (BOOL)flag;
Availability: MacOS-X 10.4.0
Description forthcoming.
+ (
NSGraphicsContext*)
graphicsContextWithWindow: (
NSWindow*)aWindow;
Availability: OpenStep
Create graphics context with attributes speficied by
aWindow's device description.
+ (void)
restoreGraphicsState;
Availability: OpenStep
Description forthcoming.
+ (void)
saveGraphicsState;
Availability: OpenStep
Description forthcoming.
+ (void)
setCurrentContext: (
NSGraphicsContext*)context;
Availability: OpenStep
Set the current context that will handle
drawing.
+ (void)
setGraphicsState: (NSInteger)graphicsState;
Availability: OpenStep
Description forthcoming.
- (
CGContextRef)
CGContext;
Availability: MacOS-X 10.10.0
Description forthcoming.
- (NSDictionary*)
attributes;
Availability: OpenStep
Description forthcoming.
- (void)
flushGraphics;
Availability: OpenStep
Description forthcoming.
- (void*)
focusStack;
Availability: OpenStep
Description forthcoming.
- (void*)
graphicsPort;
Availability: OpenStep
Description forthcoming.
- (BOOL)
isDrawingToScreen;
Availability: OpenStep
Description forthcoming.
- (BOOL)
isFlipped;
Availability: MacOS-X 10.4.0
Description forthcoming.
- (const gsMethodTable*)
methods;
Availability: OpenStep
Description forthcoming.
- (NSPoint)
patternPhase;
Availability: MacOS-X 10.2.0
Description forthcoming.
- (void)
restoreGraphicsState;
Availability: OpenStep
Description forthcoming.
- (void)
saveGraphicsState;
Availability: OpenStep
Description forthcoming.
- (void)
setCompositingOperation: (
NSCompositingOperation)operation;
Availability: MacOS-X 10.4.0
Description forthcoming.
- (void)
setFocusStack: (void*)stack;
Availability: OpenStep
Description forthcoming.
- (void)
setImageInterpolation: (
NSImageInterpolation)interpolation;
Availability: OpenStep
Description forthcoming.
- (void)
setPatternPhase: (NSPoint)phase;
Availability: MacOS-X 10.2.0
Description forthcoming.
- (void)
setShouldAntialias: (BOOL)antialias;
Availability: OpenStep
Description forthcoming.
- (BOOL)
shouldAntialias;
Availability: OpenStep
Description forthcoming.
Instance Variables for NSGraphicsContext Class
@protected BOOL _antialias;
Availability: OpenStep
Warning the underscore at the start of the
name of this instance variable indicates that, even
though it is not technically private, it is
intended for internal use within the package, and
you should not use the variable in other code.
@protected NSCompositingOperation _compositingOperation;
Availability: OpenStep
Warning the underscore at the start of the
name of this instance variable indicates that, even
though it is not technically private, it is
intended for internal use within the package, and
you should not use the variable in other code.
@protected void* _graphicsPort;
Availability: OpenStep
Warning the underscore at the start of the
name of this instance variable indicates that, even
though it is not technically private, it is
intended for internal use within the package, and
you should not use the variable in other code.
@protected NSImageInterpolation _interp;
Availability: OpenStep
Warning the underscore at the start of the
name of this instance variable indicates that, even
though it is not technically private, it is
intended for internal use within the package, and
you should not use the variable in other code.
@protected BOOL _isFlipped;
Availability: OpenStep
Warning the underscore at the start of the
name of this instance variable indicates that, even
though it is not technically private, it is
intended for internal use within the package, and
you should not use the variable in other code.
@protected NSPoint _patternPhase;
Availability: OpenStep
Warning the underscore at the start of the
name of this instance variable indicates that, even
though it is not technically private, it is
intended for internal use within the package, and
you should not use the variable in other code.
@protected NSMutableData* context_data;
Availability: OpenStep
Description forthcoming.
@protected NSDictionary* context_info;
Availability: OpenStep
Description forthcoming.
@protected NSMutableArray* focus_stack;
Availability: OpenStep
Description forthcoming.
@public const gsMethodTable* methods;
Availability: OpenStep
Description forthcoming.
@protected NSMutableSet* usedFonts;
Availability: OpenStep
Description forthcoming.
- Declared in:
- AppKit/NSGraphicsContext.h
Availability: Not in OpenStep/MacOS-X
Description forthcoming.
Method summary
+ (void)
handleExposeRect: (NSRect)rect
forDriver: (void*)driver;
Availability: Not in OpenStep/MacOS-X
Description forthcoming.
+ (void)
setDefaultContextClass: (Class)defaultContextClass;
Availability: Not in OpenStep/MacOS-X
Description forthcoming.
- (
NSView*)
focusView;
Availability: Not in OpenStep/MacOS-X
Description forthcoming.
- (id)
initWithContextInfo: (NSDictionary*)info;
Availability: Not in OpenStep/MacOS-X
Description forthcoming.
- (id)
initWithGraphicsPort: (void*)port
flipped: (BOOL)flag;
Availability: Not in OpenStep/MacOS-X
Description forthcoming.
- (void)
lockFocusView: (
NSView*)aView
inRect: (NSRect)rect;
Availability: Not in OpenStep/MacOS-X
Description forthcoming.
- (void)
resetUsedFonts;
Availability: Not in OpenStep/MacOS-X
Description forthcoming.
- (void)
unlockFocusView: (
NSView*)aView
needsFlush: (BOOL)flush;
Availability: Not in OpenStep/MacOS-X
Description forthcoming.
- (void)
useFont: (NSString*)fontName;
Availability: Not in OpenStep/MacOS-X
Description forthcoming.
- (NSSet*)
usedFonts;
Availability: Not in OpenStep/MacOS-X
Description forthcoming.
- Declared in:
- AppKit/NSGraphicsContext.h
Availability: OpenStep
Description forthcoming.
Method summary
- (void)
drawGradient: (
NSGradient*)gradient
fromCenter: (NSPoint)startCenter
radius: (CGFloat)startRadius
toCenter: (NSPoint)endCenter
radius: (CGFloat)endRadius
options: (
NSUInteger)options;
Availability: OpenStep
Description forthcoming.
- (void)
drawGradient: (
NSGradient*)gradient
fromPoint: (NSPoint)startPoint
toPoint: (NSPoint)endPoint
options: (
NSUInteger)options;
Availability: OpenStep
Description forthcoming.
- Declared in:
- AppKit/NSGraphicsContext.h
Availability: OpenStep
Description forthcoming.
Method summary
- (NSDictionary*)
GSReadRect: (NSRect)rect;
Availability: OpenStep
Read raw pixels from the device and return the
information as a bitmap. Pixels are read from
the smallest device-pixel aligned rectangle
containing rect (defined in the
current graphics state and clipped to the current
window, but not against the clipping path). If
the resulting device rectangle is degenerate, Size
will be (0,0) and Data will be nil, but
the other entries in the dictionary will be filled
in.
If the device does not support the operation, returns
nil.
The returned dictionary contains at least the
following keys:
- Data
-
An NSData-instance with the image data.
- Size
-
An NSValue/NSSize with the size in pixels of the
returned image data.
- BitsPerSample
-
An NSValue/unsigned int.
- SamplesPerPixel
-
An NSValue/unsigned int.
- ColorSpace
-
An NSString with the name of the color space the
data is in.
- HasAlpha
-
An NSValue/unsigned int. 0 if the
returned image does not have an alpha channel,
1 if it does.
- Matrix
-
An NSAffineTransform-instance that contains the
transform between current user space and
image space for this image.
- (void)
GSWSetViewIsFlipped: (BOOL)flipped;
Availability: OpenStep
This method is used by the backend, but has been
rendered obsolete. Do not use it in any code or in
any backend implementation as it may disappear at any
point.
- (BOOL)
GSWViewIsFlipped;
Availability: OpenStep
Returns YES if the current focused
view is flipped. This is an obsolete method. Use
[[NSView focusView] isFlipped] instead
- (void)
NSBeep;
Availability: OpenStep
Play the System Beep
- (void)
NSDrawBitmap: (NSRect)rect
: (NSInteger)pixelsWide
: (NSInteger)pixelsHigh
: (NSInteger)bitsPerSample
: (NSInteger)samplesPerPixel
: (NSInteger)bitsPerPixel
: (NSInteger)bytesPerRow
: (BOOL)isPlanar
: (BOOL)hasAlpha
: (NSString*)colorSpaceName
: (const unsigned char*const[5])data;
Availability: OpenStep
Generic method to render bitmap images. This method
shouldn't be used anywhere except in the AppKit
itself. It will be replaced by the more flexible
GSDrawImage method sometime in the future.
(Quartz).
- Declared in:
- AppKit/NSGraphicsContext.h
Availability: OpenStep
Description forthcoming.
Method summary
- (void)
DPSPrintf: (const char*)fmt
: (va_list)args;
Availability: OpenStep
Write the string (with printf substitutions) to a
PostScript context. Other output contexts will
likely ignore this
- (void)
DPSWriteData: (const char*)buf
: (unsigned int)count;
Availability: OpenStep
Write the encoded data to a PostScript context. Other
output contexts will likely ignore this
- (void)
DPSarc: (CGFloat)x
: (CGFloat)y
: (CGFloat)r
: (CGFloat)angle1
: (CGFloat)angle2;
Availability: OpenStep
Description forthcoming.
- (void)
DPSarcn: (CGFloat)x
: (CGFloat)y
: (CGFloat)r
: (CGFloat)angle1
: (CGFloat)angle2;
Availability: OpenStep
Description forthcoming.
- (void)
DPSarct: (CGFloat)x1
: (CGFloat)y1
: (CGFloat)x2
: (CGFloat)y2
: (CGFloat)r;
Availability: OpenStep
Description forthcoming.
- (void)
DPSashow: (CGFloat)x
: (CGFloat)y
: (const char*)s;
Availability: OpenStep
Displays a string as in DPSshow, except that (
x,y) is added to the advancement of every
glyph. An alternative means of achieving the same
effect is to use the
-GSSetCharacterSpacing:
method. Either approach should be more efficient
that using
-DPSshow:
with appropriate
-DPSrmoveto::
operations.
- (void)
DPSawidthshow: (CGFloat)cx
: (CGFloat)cy
: (int)c
: (CGFloat)ax
: (CGFloat)ay
: (const char*)s;
Availability: OpenStep
Displays a string as in a combination of DPSashow
and DPSwidthshow: (
ax,ay) is added to the
advancement of every glyph, while (
cx,cy) is also added to the advancement
for character c's glyph specifically. Using this method
should be more efficient that using
-DPSshow:
with appropriate
-DPSrmoveto::
operations.
- (void)
DPScharpath: (const char*)s
: (int)b;
Availability: OpenStep
Appends to the current path a path that is
equivalent to the outlines of the glyphs in the
string. This results in a path that can be used for
stroking, filling or clipping (DPS).
- (void)
DPSclip;
Availability: OpenStep
Clip to the current path. (DPS, Quartz).
- (void)
DPSclosepath;
Availability: OpenStep
Description forthcoming.
- (void)
DPScomposite: (CGFloat)x
: (CGFloat)y
: (CGFloat)w
: (CGFloat)h
: (NSInteger)gstateNum
: (CGFloat)dx
: (CGFloat)dy
: (
NSCompositingOperation)op;
Availability: OpenStep
Description forthcoming.
- (void)
DPScompositerect: (CGFloat)x
: (CGFloat)y
: (CGFloat)w
: (CGFloat)h
: (
NSCompositingOperation)op;
Availability: OpenStep
Description forthcoming.
- (void)
DPSconcat: (const CGFloat*)m;
Availability: OpenStep
Concatenates the coordinate transform
represented by the matrix m with the
current coordinate transform. (DPS).
- (void)
DPScurrentalpha: (CGFloat*)a;
Availability: OpenStep
Returns the current alpha component (DPS).
- (void)
DPScurrentcmykcolor: (CGFloat*)c
: (CGFloat*)m
: (CGFloat*)y
: (CGFloat*)k;
Availability: OpenStep
Returns the current color according to the CMYK
color model (DPS).
- (void)
DPScurrentflat: (CGFloat*)flatness;
Availability: OpenStep
Returns the current flattness parameter, which
controls how curved lines are drawn. (DPS,
Quartz).
- (void)
DPScurrentgray: (CGFloat*)gray;
Availability: OpenStep
Returns the gray-level equivalent in the current
color space. The value may depend on the current
color space and may be 0 if the current color space
has no notion of a gray value (DPS)
- (void)
DPScurrenthsbcolor: (CGFloat*)h
: (CGFloat*)s
: (CGFloat*)b;
Availability: OpenStep
Returns the current color according to the HSB
color model (DPS).
- (void)
DPScurrentlinecap: (int*)linecap;
Availability: OpenStep
Returns the current linecap value. (DPS,
Quartz).
- (void)
DPScurrentlinejoin: (int*)linejoin;
Availability: OpenStep
Returns the current linejoin value.
(DPS, Quartz).
- (void)
DPScurrentlinewidth: (CGFloat*)width;
Availability: OpenStep
Returns the current line width. (DPS,
Quartz).
- (void)
DPScurrentmiterlimit: (CGFloat*)limit;
Availability: OpenStep
Returns the current linecap value. (DPS, Quartz).
- (void)
DPScurrentoffset: (int*)x
: (int*)y;
Availability: OpenStep
Description forthcoming.
- (void)
DPScurrentpoint: (CGFloat*)x
: (CGFloat*)y;
Availability: OpenStep
Returns the current point. (DPS, Quartz).
- (void)
DPScurrentrgbcolor: (CGFloat*)r
: (CGFloat*)g
: (CGFloat*)b;
Availability: OpenStep
Returns the current color according to the RGB
color model (DPS).
- (void)
DPScurrentstrokeadjust: (int*)b;
Availability: OpenStep
Returns the strokeadjust value. (DPS).
- (void)
DPScurveto: (CGFloat)x1
: (CGFloat)y1
: (CGFloat)x2
: (CGFloat)y2
: (CGFloat)x3
: (CGFloat)y3;
Availability: OpenStep
Description forthcoming.
- (void)
DPSdissolve: (CGFloat)x
: (CGFloat)y
: (CGFloat)w
: (CGFloat)h
: (NSInteger)gstateNum
: (CGFloat)dx
: (CGFloat)dy
: (CGFloat)delta;
Availability: OpenStep
Description forthcoming.
- (void)
DPSeoclip;
Availability: OpenStep
Description forthcoming.
- (void)
DPSeofill;
Availability: OpenStep
Description forthcoming.
- (void)
DPSfill;
Availability: OpenStep
Fill the current path. (DPS, Quartz).
- (void)
DPSflattenpath;
Availability: OpenStep
Description forthcoming.
- (void)
DPSgrestore;
Availability: OpenStep
Pops a previously saved gstate from the gstate stack
and makes it current. Drawing information in the
previously saved gstate becomes the current
information. (DPS, Quartz).
- (void)
DPSgsave;
Availability: OpenStep
Saves (pushes) a copy of the current gstate
information onto the gstate stack. This saves
drawing information contained in the gstate, such
as the current path, ctm and colors. (DPS, Quartz).
- (void)
DPSinitclip;
Availability: OpenStep
Description forthcoming.
- (void)
DPSinitgraphics;
Availability: OpenStep
Description forthcoming.
- (void)
DPSinitmatrix;
Availability: OpenStep
Sets the coordinate transform matrix to the initial
values for the particular context
- (void)
DPSlineto: (CGFloat)x
: (CGFloat)y;
Availability: OpenStep
Description forthcoming.
- (void)
DPSmoveto: (CGFloat)x
: (CGFloat)y;
Availability: OpenStep
Description forthcoming.
- (void)
DPSnewpath;
Availability: OpenStep
Description forthcoming.
- (void)
DPSpathbbox: (CGFloat*)llx
: (CGFloat*)lly
: (CGFloat*)urx
: (CGFloat*)ury;
Availability: OpenStep
Description forthcoming.
- (void)
DPSrcurveto: (CGFloat)x1
: (CGFloat)y1
: (CGFloat)x2
: (CGFloat)y2
: (CGFloat)x3
: (CGFloat)y3;
Availability: OpenStep
Description forthcoming.
- (void)
DPSrectclip: (CGFloat)x
: (CGFloat)y
: (CGFloat)w
: (CGFloat)h;
Availability: OpenStep
Description forthcoming.
- (void)
DPSrectfill: (CGFloat)x
: (CGFloat)y
: (CGFloat)w
: (CGFloat)h;
Availability: OpenStep
Description forthcoming.
- (void)
DPSrectstroke: (CGFloat)x
: (CGFloat)y
: (CGFloat)w
: (CGFloat)h;
Availability: OpenStep
Description forthcoming.
- (void)
DPSreversepath;
Availability: OpenStep
Description forthcoming.
- (void)
DPSrlineto: (CGFloat)x
: (CGFloat)y;
Availability: OpenStep
Description forthcoming.
- (void)
DPSrmoveto: (CGFloat)x
: (CGFloat)y;
Availability: OpenStep
Description forthcoming.
- (void)
DPSrotate: (CGFloat)angle;
Availability: OpenStep
Rotate the coordinate system. (DPS).
- (void)
DPSscale: (CGFloat)x
: (CGFloat)y;
Availability: OpenStep
Scale the coordinate system. (DPS).
- (void)
DPSsetalpha: (CGFloat)a;
Availability: OpenStep
Sets the alpha drawing component. For this and other
color setting commands that have no differentiation
between fill and stroke colors, both the fill and
stroke alpha are set (DPS).
- (void)
DPSsetcmykcolor: (CGFloat)c
: (CGFloat)m
: (CGFloat)y
: (CGFloat)k;
Availability: OpenStep
Sets the current colorspace to Device CMYK and the
current color based on the indicated values. For
this and other color setting commands that have no
differentiation between fill and stroke
colors, both the fill and stroke colors are set
(DPS).
- (void)
DPSsetdash: (const CGFloat*)pat
: (NSInteger)size
: (CGFloat)offset;
Availability: OpenStep
Set the pattern for line dashes like the Postscript
setdash operator. (DPS, Quartz).
- (void)
DPSsetflat: (CGFloat)flatness;
Availability: OpenStep
Sets the current flattness parameter, which controls
how curved lines are drawn. (DPS, Quartz).
- (void)
DPSsetgray: (CGFloat)gray;
Availability: OpenStep
Sets the current colorspace to Device Gray and the
current gray value (DPS).
- (void)
DPSsetgstate: (NSInteger)gst;
Availability: OpenStep
Makes the gstate indicated by the tag gst
the current gstate. Note that the gstate is copied, so
that changes to either gstate do not affect the other.
(DPS, Quartz).
- (void)
DPSsethalftonephase: (CGFloat)x
: (CGFloat)y;
Availability: OpenStep
Description forthcoming.
- (void)
DPSsethsbcolor: (CGFloat)h
: (CGFloat)s
: (CGFloat)b;
Availability: OpenStep
Sets the current colorspace to Device RGB and the
current color based on the indicated values (DPS).
- (void)
DPSsetlinecap: (int)linecap;
Availability: OpenStep
Set the current linecap value. (DPS,
Quartz).
- (void)
DPSsetlinejoin: (int)linejoin;
Availability: OpenStep
Set the current linejoin value. (DPS,
Quartz).
- (void)
DPSsetlinewidth: (CGFloat)width;
Availability: OpenStep
Set the current line width. (DPS, Quartz).
- (void)
DPSsetmiterlimit: (CGFloat)limit;
Availability: OpenStep
Set the current meter limit value. (DPS,
Quartz).
- (void)
DPSsetoffset: (short int)x
: (short int)y;
Availability: OpenStep
Description forthcoming.
- (void)
DPSsetrgbcolor: (CGFloat)r
: (CGFloat)g
: (CGFloat)b;
Availability: OpenStep
Sets the current colorspace to Device RGB and the
current color based on the indicated values (DPS).
- (void)
DPSsetstrokeadjust: (int)b;
Availability: OpenStep
Description forthcoming.
- (void)
DPSshfill: (NSDictionary*)shaderDictionary;
Availability: OpenStep
Description forthcoming.
- (void)
DPSshow: (const char*)s;
Availability: OpenStep
Display the string s using the current
font (DPS).
- (void)
DPSstroke;
Availability: OpenStep
Description forthcoming.
- (void)
DPStranslate: (CGFloat)x
: (CGFloat)y;
Availability: OpenStep
Translate the coordinate system. (DPS).
- (void)
DPSwidthshow: (CGFloat)x
: (CGFloat)y
: (int)c
: (const char*)s;
Availability: OpenStep
Displays a string as in DPSshow, except that, for
character
c only, the glpyh
x and
y advancement is
determined by the values (
x,y),
instead of by the glyph itself. This is often used
to adjust the length of a line of text by changing the
width of the space character. Using this method
should be more efficient than using
-DPSshow:
with appropriate
-DPSrmoveto::
operations.
- (void)
DPSxshow: (const char*)s
: (const CGFloat*)numarray
: (int)size;
Availability: OpenStep
Displays a string as in DPSshow, except that the
glyph x advancement is determined by the values in
numarray, one for each glyph, instead of
by the glyphs themselves.
size should be
equal to the length of
s in glyphs. Using
this method should be more efficient than using
-DPSshow:
with appropriate
-DPSrmoveto::
operations.
- (void)
DPSxyshow: (const char*)s
: (const CGFloat*)numarray
: (int)size;
Availability: OpenStep
Displays a string as in DPSshow, except that the
glyph x and y advancement is determined by the values
in
numarray, one x and one y for each glyph,
in alternating order, instead of by the glyphs
themselves.
size should be equal to
the length of
s in glyphs. Using this method
should be more efficient than using
-DPSshow:
with appropriate
-DPSrmoveto::
operations.
- (void)
DPSyshow: (const char*)s
: (const CGFloat*)numarray
: (int)size;
Availability: OpenStep
Displays a string as in DPSshow, except that the
glyph y advancement is determined by the values in
numarray, one for each glyph, instead of
by the glyphs themselves.
size should be
equal to the length of
s in glyphs. Using
this method should be more efficient than using
-DPSshow:
with appropriate
-DPSrmoveto::
operations.
- (void)
GSConcatCTM: (NSAffineTransform*)ctm;
Availability: OpenStep
Concatenates the matrix ctm onto
the current coordinate transform matrix. (Quartz).
- (NSAffineTransform*)
GSCurrentCTM;
Availability: OpenStep
Returns the current coordinate transform matrix.
(Quartz).
- (void)
GSCurrentDevice: (void**)device
: (int*)x
: (int*)y;
Availability: OpenStep
This is a private method used between the window
server and the context. It should not be used in any
application. Typically used by the window
server to find out what window the context is
drawing graphics to. The device pointer
is an opaque type that contains information about the
window. The x and y pointers
indicate the offset of the origin of the window
from the lower left-hand corner
- (NSInteger)
GSDefineGState;
Availability: OpenStep
Creates a copy of the current gstate and associates
it with a tag, which is given in the return value. This
tag can later be used in
-DPSsetgstate:
to set the gstate as being current again. (DPS, Quartz).
- (void)
GSDrawImage: (NSRect)rect
: (void*)imageref;
Availability: OpenStep
Generic method to draw an image into a
rect. The image is defined by
imageref, an opaque structure. Support for
this method hasn't been implemented yet, so it should
not be used anywhere.
- (NSAffineTransform*)
GSGetTextCTM;
Availability: OpenStep
Returns the transfer function for transforming
text from text space to user space. See
-GSSetTextCTM:
for additiona information. (Quartz).
- (NSPoint)
GSGetTextPosition;
Availability: OpenStep
Returns the location at which text will be drawn.
In text-space coordinates. (Quartz).
- (void)
GSRectClipList: (const NSRect*)rects
: (int)count;
Availability: OpenStep
Append the array of rects to the current
clip path (DPS, Quartz).
- (void)
GSRectFillList: (const NSRect*)rects
: (int)count;
Availability: OpenStep
Draw and fill the array of rects. (DPS,
Quartz)
- (void)
GSReplaceGState: (NSInteger)gst;
Availability: OpenStep
Replaces the gstate refered to by the tag
gst with the current gstate. The former
gstate is destroyed. (DPS, Quartz).
- (void)
GSSendBezierPath: (
NSBezierPath*)path;
Availability: OpenStep
Set the bezier path as the current
path
- (void)
GSSetCTM: (NSAffineTransform*)ctm;
Availability: OpenStep
Sets the coordinate transform matrix which describes
how graphics will be transformed into device
coordinates. (Quartz).
- (void)
GSSetCharacterSpacing: (CGFloat)extra;
Availability: OpenStep
Use this method to set the additional spacing between
characters (glyphs). This spacing is added to
the normal spacing for each character. Units are in
text-space coordinate system. (Quartz).
- (void)
GSSetDevice: (void*)device
: (int)x
: (int)y;
Availability: OpenStep
This is a private method used between the window
server and the context. It should not be used in any
application. Typically called by the window
server to tell the context what window it should
draw graphics to. The device pointer is an
opaque type that contains information about the
window. The x and y values
tell the context that it should put the origin of the
transform matrix at the indicated x
and y values from the lower left-hand corner
of the window
- (void)
GSSetFillColor: (const CGFloat*)values;
Availability: OpenStep
Sets the current color for fill operations. The
values array should have n components,
where n corresponds to the number of color components
required to specify the color in the current
colorspace (Quartz).
- (void)
GSSetFillColorspace: (void*)spaceref;
Availability: OpenStep
Sets the colorspace for fill operations based on
values in the supplied dictionary dict.
For device colorspaces (GSDeviceGray, GSDeviceRGB,
GSDeviceCMYK), only the name of the
colorspace needs to be set using the
GSColorSpaceName key.
Other colorspaces will be documented later
(Quartz).
- (void)
GSSetFont: (void*)fontref;
Availability: OpenStep
Set the current font for drawing glyphs. (DPS, Quartz).
- (void)
GSSetFontSize: (CGFloat)size;
Availability: OpenStep
Set the font size of the current NSFont used
for drawing glyphs. (DPS, Quartz).
- (void)
GSSetPatterColor: (
NSImage*)image;
Availability: OpenStep
Description forthcoming.
- (void)
GSSetStrokeColor: (const CGFloat*)values;
Availability: OpenStep
Sets the current color for stroke operations. The
values array should have n components,
where n corresponds to the number of color components
required to specify the color in the current
colorspace (Quartz).
- (void)
GSSetStrokeColorspace: (void*)spaceref;
Availability: OpenStep
Sets the colorspace for stroke operations based on the
values in the supplied dictionary. See
-GSSetFillColorspace:
for a description of the values that need to be
supplied (Quartz).
- (void)
GSSetTextCTM: (NSAffineTransform*)ctm;
Availability: OpenStep
Set the transfer function for transforming text from
text space to user space. This transform is only
applied to text objects and is in addition to the
normal coordinate transform matrix. When drawing
text, this transform is applied before the normal
CTM.
The text matrix can be changed by either modifying it
directly, or just by drawing text, in which
case the tx and ty offset veriables are modified to
point to the location of the next character that
could be rendered (Quartz).
- (void)
GSSetTextDrawingMode: (
GSTextDrawingMode)mode;
Availability: OpenStep
Set the current text drawing mode. The
mode can be one of several values that
fill/stroke the text or add it to the current
clipping path. (Quartz).
- (void)
GSSetTextPosition: (NSPoint)loc;
Availability: OpenStep
Set the location at which text will be drawn, in
text-space coordinates. This routine updates the
current text coordinate matrix. (Quartz).
- (void)
GSShowGlyphs: (const
NSGlyph*)glyphs
: (size_t)length;
Availability: OpenStep
Paints the glyphs using the current font.
(Quartz).
- (void)
GSShowGlyphsWithAdvances: (const
NSGlyph*)glyphs
: (const NSSize*)advances
: (size_t)length;
Availability: OpenStep
Paints the glyphs with the specified
advances using the current font. (Quartz).
- (void)
GSShowText: (const char*)string
: (size_t)length;
Availability: OpenStep
Paints text represented by the characters in
string in the current font. (Quartz).
- (void)
GSUndefineGState: (NSInteger)gst;
Availability: OpenStep
Disassociates the tag gst with
it's gstate and destroys the gstate object. The tag
will no longer be valid and should not be used to
refer to the gstate again. (DPS, Quartz).
- (void)
GScomposite: (NSInteger)gstateNum
toPoint: (NSPoint)aPoint
fromRect: (NSRect)srcRect
operation: (
NSCompositingOperation)op
fraction: (CGFloat)delta;
Availability: OpenStep
Description forthcoming.
- (void)
GSdraw: (NSInteger)gstateNum
toPoint: (NSPoint)aPoint
fromRect: (NSRect)srcRect
operation: (
NSCompositingOperation)op
fraction: (CGFloat)delta;
Availability: OpenStep
An empty method provided for subclasses to override.
Draws a gstate in a way that fully respects the
destination transform, unlike the GSComposite
operator which ignores the rotation and the
scaling effect on the content. Note: For the
GScomposite operator, the scaling and rotation
affects the destination point but not the content.
- (void)
appendBezierPathWithPackedGlyphs: (const char*)packedGlyphs
path: (
NSBezierPath*)aPath;
Availability: OpenStep
Description forthcoming.
- (BOOL)
supportsDrawGState;
Availability: OpenStep
An empty method provided for subclasses to override.
Returns whether the backend supports a GSDraw
operator. By default, returns
NO.
When a GSContext backend subclass overrides
this method to return
YES, the backend
must also implement
-drawGState:fromRect:toPoint:op:fraction:
in its GSState subclass. When
YES is returned, -[NSImage drawXXX] methods that involves rotation, scaling etc. will delegate as much as possible the image drawing to the backend, rather than trying to emulate the resulting image in Gui by using intermediate images to rotate and scale the content, and then composite the result with
-GScomposite:toPoint:fromRect:operation:fraction:
. Backends which doesn't implement -compositeGState:fromRect:toPoint:op:fraction:
can draw rotated or scaled images, but the semantic won't exactly match the NSImage documentation in non-trivial cases.
- Declared in:
- AppKit/NSGraphicsContext.h
Availability: OpenStep
Description forthcoming.
Method summary
- (void)
beginPage: (int)ordinalNum
label: (NSString*)aString
bBox: (NSRect)pageRect
fonts: (NSString*)fontNames;
Availability: OpenStep
Description forthcoming.
- (void)
beginPrologueBBox: (NSRect)boundingBox
creationDate: (NSString*)dateCreated
createdBy: (NSString*)anApplication
fonts: (NSString*)fontNames
forWhom: (NSString*)user
pages: (int)numPages
title: (NSString*)aTitle;
Availability: OpenStep
Description forthcoming.
- (void)
beginSetup;
Availability: OpenStep
Description forthcoming.
- (void)
beginTrailer;
Availability: OpenStep
Description forthcoming.
- (void)
endDocumentPages: (int)pages
documentFonts: (NSSet*)fontNames;
Availability: OpenStep
Description forthcoming.
- (void)
endHeaderComments;
Availability: OpenStep
Description forthcoming.
- (void)
endPageSetup;
Availability: OpenStep
Description forthcoming.
- (void)
endPrologue;
Availability: OpenStep
Description forthcoming.
- (void)
endSetup;
Availability: OpenStep
Description forthcoming.
- (void)
endSheet;
Availability: OpenStep
Description forthcoming.
- (void)
endTrailer;
Availability: OpenStep
Description forthcoming.
- (void)
printerProlog;
Availability: OpenStep
Description forthcoming.
- (void)
showPage;
Availability: OpenStep
Description forthcoming.
Up