This is MiscVolumeMeter.h in view mode; [Download] [Up]
/*
MiscVolumeMeter
Version 1.2
Copyright (c) 1995 by Sean Luke
Donated to the MiscKit
Permission to use, copy, modify, and distribute this material
for any purpose and without fee, under the restrictions as noted
in the MiscKit copyright notice, is hereby granted, provided that
the MiscKit copyright notice and this permission notice
appear in all source copies, and that the author's name shall not
be used in advertising or publicity pertaining to this
material without the specific, prior written permission
of the author. SEAN O. LUKE MAKES NO REPRESENTATIONS ABOUT THE
ACCURACY OR SUITABILITY OF THIS MATERIAL FOR ANY PURPOSE.
IT IS PROVIDED "AS IS", WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES.
*/
#import <appkit/appkit.h>
#import <soundkit/soundkit.h>
// Defines
#define VOLUMEMETER_DISPLAYTYPE_NONE 0
#define VOLUMEMETER_DISPLAYTYPE_BEZEL 1
#define VOLUMEMETER_BACKGROUND_INSET 2.0
#define VOLUMEMETER_VALUE_INSET 6.0
#define VOLUMEMETER_LEFT_END 0.4
#define VOLUMEMETER_RIGHT_BEGIN 0.6
#define VOLUMEMETER_TIMED_ENTRY_SPEED 0.1
#define VOLUMEMETER_MAX_REFRESHES 256
#define VOLUMEMETER_STD_REFRESHES 4
// Public Convenience Functions
BOOL VOLUMEMETER_can_draw(const NXRect* aRect);
// given aRect, determines if there's enough space to draw a meter
BOOL VOLUMEMETER_draw_wide(const NXRect* aRect);
// given aRect, determines if the meter should draw wide
// (as opposed to tall)
@interface MiscVolumeMeter:View
{
NXSoundIn* input_device;
NXSoundOut* output_device;
id sound; // can be a sound or soundview
id delegate;
BOOL input; // set to input. Default is NO
BOOL running; // set running. Default is NO
BOOL bezeled;
BOOL peak_bubble_displayed;
BOOL stereo;
float background_gray;
float value_gray;
float bubble_gray;
float refresh;
int refreshes_per_new_peak_bubble;
int refresh_tally;
float refreshes_left[VOLUMEMETER_MAX_REFRESHES];
float refreshes_right[VOLUMEMETER_MAX_REFRESHES];
int current_max_refresh_left;
int current_max_refresh_right;
DPSTimedEntry teNum; // timed entry which displays
}
// constructors and destructors
- initFrame:(const NXRect*) frameRect;
- free;
- awake;
// drawing
- drawSelf:(const NXRect*) rects:(int) rectCount;
// Setting parameters
- setDelegate:this_delegate;
- setMono;
- setStereo;
- setBackgroundGray:(float) this_value; // 0 <= this_value <= 1
- setValueGray:(float) this_value; // 0 <= this_value <= 1
- setBubbleGray:(float) this_value; // 0 <= this_value <= 1
- setBezeled:(BOOL) yes_or_no;
- setPeakBubbleDisplayed:(BOOL) yes_or_no;
- setToInput; // returns self if usable, NULL if not
- setToOutput; // returns self if usable, NULL if not
- setRefresh:(float) number_seconds; // sets update speed in fraction of
// seconds or whole seconds.
// default is .1 second
- setRefreshesPerNewPeakBubble:(int) number_refreshes;
// VOLUMEMETER_MAX_REFRESHES max, 1 min
// Querying the object
- delegate;
- (BOOL) isStereo:sender;
- (float) backgroundGray;
- (float) valueGray;
- (float) bubbleGray;
- (BOOL) isBezeled:sender;
- (BOOL) peakBubbleDisplayed:sender;
- (BOOL) isInput:sender;
- (float) refresh:sender;
- (int) refreshesPerPeakBubble:sender;
// Operating the meter
- reclaim; // tries to reclaim devices
- run;
- stop;
// Archiving
- read:(NXTypedStream*) stream;
- write:(NXTypedStream*) stream;
// Locking Methods. This locks the meter to only
// display when a certain sound or soundview is recording or playing
- setSound:this_sound; // can be a sound or a soundview
- sound;
// Action versions of above methods
- setMono:sender;
- setStereo:sender;
- setToInput:sender;
- setToOutput:sender;
- run:sender;
- stop:sender;
// Convenience methods responding to window action.
// This allows a window to open/close and start up / shut down the meter
- windowDidBecomeKey:sender;
- windowDidBecomeMain:sender;
- windowDidDeminiaturize:sender;
- windowDidMiniaturize:sender;
- windowWillClose:sender;
// Methods implementable by delegates of VolumeMeter:
// (VolumeMeter itself only defines them here--it doesn't do a thing with 'em)
- meterWillUpdateOnOwn:sender; // ...the volume meter will update/display
// (called before meterWillUpdate and before
// the display method is called (so meter
// has not locked focus yet))
- meterWillUpdate:sender; // ...the volume meter will update/display
// (possibly on its own)
- meterDidUpdate:sender; // ...the volume meter updated/displayed
// (possibly on its own)
@end
These are the contents of the former NiCE NeXT User Group NeXTSTEP/OpenStep software archive, currently hosted by Netfuture.ch.