Instance Method

allocateGState

Causes the view to maintain a private graphics state object, which encapsulates all parameters of the graphics environment.

Declaration

- (void)allocateGState;

Discussion

If you do not invoke allocateGState, a graphics state object is constructed from scratch each time the NSView is focused.

The view builds the graphics state parameters using setUpGState, then automatically establishes this graphics state each time the focus is locked on it. A graphics state may improve performance for view objects that are focused often and need to set many parameters, but use of standard rendering operators is normally efficient enough.

Because graphics states occupy a fair amount of memory, they can actually degrade performance. Be sure to test application performance with and without the private graphics state before committing to its use.

See Also

Deprecated Methods

- convertPointToBase:

Converts the point from the view’s coordinate system to the base coordinate system.

Deprecated
- convertPointFromBase:

Converts the point from the base coordinate system to the view’s coordinate system.

Deprecated
- convertSizeToBase:

Converts the size from the view’s coordinate system to the base coordinate system.

Deprecated
- convertSizeFromBase:

Converts the size from the base coordinate system to the view’s coordinate system.

Deprecated
- convertRectToBase:

Converts the rectangle from the view’s coordinate system to the base coordinate system.

Deprecated
- convertRectFromBase:

Converts the rectangle from the base coordinate system to the view’s coordinate system.

Deprecated
- performMnemonic:

Implemented by subclasses to respond to mnemonics.

Deprecated
- shouldDrawColor

Returns a Boolean value indicating whether the view is being drawn to an environment that supports color.

Deprecated
- gState

Returns the identifier for the view’s graphics state object, or 0 if the view doesn’t have a graphics state object.

Deprecated
- setUpGState

Overridden by subclasses to (re)initialize the view’s graphics state object.

Deprecated
- renewGState

Invalidates the view’s graphics state object, if it has one.

Deprecated
- releaseGState

Frees the view’s graphics state object, if it has one.

Deprecated
- dragImage:at:offset:event:pasteboard:source:slideBack:

Initiates a dragging operation from the view, allowing the user to drag arbitrary data with a specified icon into any application that has window or view objects that accept dragged data.

Deprecated