home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-2.iso / Developer / resources / palettesfor2.xx / CubicSlider.README < prev    next >
Encoding:
Text File  |  1993-08-22  |  4.6 KB  |  130 lines
  1. What is the CubicSlider?
  2.  
  3. A Slider subclass featuring two (YES! TWO!) independent 
  4. useful functionalities:
  5.  
  6. [1] It allows verrrrry precise and direct control (without ALT) 
  7.     of its  of value: you can cram the precision of a 2000 pixel 
  8.     wide slider in a 100 one ! It uses  a cubic polynomial 
  9.     transfer function dynamically redefined on each mouseUp. Yup.
  10.  
  11. [2] Extrema values are user editable (just a double-click away!) by 
  12.     (exactly) hiding the slider  behind a form (where you can type in 
  13.     a new min or max value, enlarging the slider range) and two 
  14.     buttons, which functions are: 1- to put the current knob value 
  15.     as the new min/max value, thus narrowing the slider range; 
  16.     or 2- to double the present range and add it to the specified 
  17.     extremum. 
  18.  
  19. New in 1.4
  20.  
  21.   - Mouse downs outside the knob correctly initiate a mouse tracking
  22.     (as it should, being an expected superclass behavior).
  23.   - Slight demo program mofications (about the meter view).
  24.  
  25. ________________________________________________________________
  26.  
  27.  
  28.            ***  The  CubicSlider  ***
  29.  
  30. "This palette is probably the most respected slider subclass on the planet..."
  31.  
  32. Bibite 93
  33.  
  34.  
  35. "People will buy copies of NeXTSTEP just to use it"
  36.  
  37. (The hypest statement about NeXTSTEP products)  
  38.  
  39.  
  40. "Don't be seduced."
  41.  
  42. An impartial, well informed, Unix Review editorialist. 
  43.  
  44.  
  45. Seriously, this slider has been designed with YOU in mind! It's 
  46. not a spinoff from a personal application, it offers a fully general 
  47. functionality and won't impose you an undesired feature ("well, I would like 
  48. this, but not that"): everything is optional and, as a true subclass, it can
  49. be used EXACTLY (well, almost) like a plain Slider (but who will? 8^) 
  50.  
  51. Finally, great effort have been put in the demo program design, it will 
  52. allow you to instantly grasp the full power of this feature packed slider!
  53.  
  54.     8^)
  55.  
  56. Includes palette and demo sources, NS2.1 nibs, documentation.rtf, etc...
  57.  
  58.  
  59. There have been:
  60.  
  61.     - G.H. Anderson's RangeSlider (soon to be released by AFS ) 
  62.     - Don Yacktman's RotationSlider 1993
  63.     - Vince Demarco's CircularSlider  1991
  64.     - Andrew Stone's DualActingSlider 1990
  65.     - NeXT's MySlider and MySliderCell (Ensemble, ext. dev.version 2.1),
  66.  
  67.     and now... for something a completely different:
  68.  
  69.          **  the CubicSlider1.4   **        
  70.  
  71.  
  72. THIS one is THE definite Slider subclass!... Oops, the definite 
  73. HORIZONTAL, FLAT Slider subclass... 8^)
  74.  
  75.  
  76. Plain Slider drawback #1:
  77.  
  78.   - high granularity (i.e the finest mouse movement create a 
  79.     large value variation).
  80.  
  81. Plain Slider drawback #2:
  82.  
  83.   - minValue and maxValue settings aren't accessible to the User.
  84.  
  85. There are different existing solutions  (ALT drag, 
  86. popping panels, etc...), none completely satisfied me...
  87.  
  88. Here's how I address the low resolution problem: 
  89.  
  90. Create a non-linear transfer function, (for which input is the knob 
  91. position, and output, the slider value) with a very low slope  region
  92. around the current knob position, thus giving a high precision (large
  93. knob moves give small value variations). On mouseUp, redefine the transfer 
  94. function so its flattest zone still surrounds the new value. The function 
  95. used is simply the cubic polynomial  (without any extrema) 
  96. y=x^3, adequately scaled and x y-translated for
  97.  
  98.   a) the point ( minValue, minValue) to be on the curve, 
  99.   b) the point ( maxValue, maxValue) to be on the curve too,
  100.   c) the null slope point to be at y = "value previously selected".
  101.  
  102. One inevitable consequence of the dynamical redefinition of the fct
  103. is the repositioning of the knob (on mouseUp) at a new position in the
  104. slider: new function, same y -> new x... It takes a little time to get
  105. used to, but the advantage is considerable: on a 100 pixels wide slider
  106. one can reach (in three or four trials) a desired value within a precision
  107. of 1 in 100 000... (a trial being a mouseDown, mouseDragging and mouseUp
  108. sequence).
  109.  
  110. What about min and maxValues User access? Just dbl-clicking the slider  
  111. ... "It just works, virtually." TM      8^)
  112.  
  113.  
  114.  
  115.     A NOTE FOR YOU BEGINNERS OUT THERE: ( I know: I'm one...)
  116.  
  117. Subclassing Appkit objects is IMHO a good starting point to learn NeXStep 
  118. programming... It gives occasions to meet overall concepts of NeXStep: 
  119. views, delegation, events & responders, Cells VS Controls , etc... all 
  120. this in a well contained 
  121. small PERSONAL project (uhh? graph paper? Na. I want something of my own 8^). 
  122. What's more, you can palettize it (IB custom palette) and 
  123. make all of us benefice from your first NeXTsteps! Palettes are fun.
  124.   
  125. passez une bonne journee,    RL
  126.  
  127. departement de physique, etat solide, 2e cycle, Raymond Lutz
  128. ND_cube_NeXT_newbe_wannabe lutzray@ERE.UMontreal.CA (ascii only)
  129.  
  130.