MiscGaugeCell.rtf

This is MiscGaugeCell.rtf in view mode; [Download] [Up]

MiscGaugeCell

Inherits From: Cell

Declared In: <misckit/MiscGaugeCell.h>

Class Description

This class is a simple round analog Gauge that came about while extending the GaugeView class that comes with the BusyBox example (/NextDeveloper/Examples/AppKit/BusyBox). It should also be fairly easy to modify the look of the gauge by overriding drawFace: and/or drawHand:flipped:. Let me know if you try and run into any problems that I hadn't considered.

Instead of me explaining all the features, and what most of the methods do (unless you plan to subclass), load up the palette in Interface Builder and play with the options on the Inspector. If you have any comments and/or suggestions, make improvements, or <gasp> find a bug, please let me know.

Instance Variables

NXImage *cache;
Font *titleFont;
short titlePosition;
float radius;
NXPoint center;
float startAngle;
float angleRange;
float degreesPerUnit;
int tickInterval;
float tickRatio;
float handRatio;
NXColor gaugeColor;
NXColor textColor;
float minValue;
float maxValue;
float value;
char *strValue;
BOOL needRedraw;
NXRect lastRect;

cache Cached NXImage of the gauge face.

titleFont Font used to display the title (The numbers use the Cell's font).

titlePosition Position of the title on the gauge.

radius The radius of the gauge face.

center The center of the gauge face.

startAngle The beginning angle of the numbers on the gauge.

angleRange The span of the gauge numbers, starting at startAngle.

degreesPerUnit The number of degrees per unit mark.

tickInterval The interval of the tick marks.

tickRatio Tick radius in ratio to the gauge's radius.

handRatio Hand length in ratio to the gauge's radius.

gaugeColor Color of the gauge face.

textColor Color of all the text and gauge hand.

minValue Minimum value of the gauge.

maxValue Maximum value of the gauge.

value Current value of the gauge.

Method Types

Initializing a MiscGaugeCell + initialize
- init
- free

Overridden from Cell - calcCellSize:inRect:
- highlight:inView:lit:

Setting the Gauge's values - doubleValue
- setDoubleValue:
- floatValue
- setFloatValue:
- intValue
- setIntValue:
- maxValue
- setMaxValue:
- minValue
- setMinValue:
- stringValue
- setStringValue:

Manipulating the gauge face - angleRange
- setAngleRange:
- handRatio
- setHandRatio:
- startAngle
- setStartAngle:
- tickInterval
- setTickInterval:
- tickRatio
- setTickRatio:

Setting colors - gaugeColor
- gaugeGray
- setGaugeColor:
- setGaugeGray:
- textColor
- textGray
- setTextColor:
- setTextGray:

Manipulating the title - title
- setTitle:
- titleFont
- setTitleFont:
- titlePosition
- setTitlePosition:

Display - drawFace:
� drawHand:flipped:
- drawInside:inView:
- drawSelf:inView:

Archiving - read:
- awake
- write:

Class Methods

initialize
+ initialize

Sets the class verison for archiving purposes.

Instance Methods

angleRange
- (float)angleRange

Returns the sweep of the hand from minimum to maximum value, starting at startAngle. This will not be less than 0 or more than 360 degrees.

See also: � setAngleRange:, � startAngle, � setStartAngle:

awake
- awake

Allocates any ivars that were not archived, which includes the NXImage for the gauge face.