Click here to Skip to main content
Click here to Skip to main content

An Improved Analog Meter Control

, 19 Jun 2000
Rate this:
Please Sign up or sign in to vote.
An Analog Meter Control for displaying real-time data
  • Download demo project - 42 Kb
  • Sample Image - 3dMeter.gif

    Once again I'm working on real-time data displays and to be perfectly honest - I'm tired of seeing my rather flat analog meter given in the article "Analog Meter Class".   Furthermore, the app I'm currently working on requires that the meter be displayed in a CFormView derived view.

    Thus, I've embarked on improving the meter - providing the following enhancements:

    • A better looking, 3D-style meter.
    • The use of system colors thereby allowing the meter to "blend-in" with the rest of the dialog or FormView regardless of the display settings.  (The meter colors are determined based on your Display Properties.)
    • A simpler interface for modifying the parameters.

    To add the meter to your Dialog or FormView:

    1. In the resource editor, draw a new "Picture" and name it something like "IDC_STATICMETER".  Make sure that "Visible" is checked and that the type is "Frame".
    2. In the ClassWizard (for your Dialog of FormView) add a member variable for the IDC_STATICMETER.  Make the "name" something like "m_3DMeterCtrl".   Under "Category" select "Control" and make the "Variable Type" "CStatic".
    3. Go to the header file associated with the Dialog or the FormView and replace CStatic with C3DMeterCtrl for the newly assigned variable.
    	C3DMeterCtrl m_3DMeterCtrl ;
    1. Make sure you include the header file 3DMeterCtrl.h in the header file associated with your Dialog or FormView.

     

    Positioning the Needle

    To place the needle, simply call the meter's "UpdateNeedle" member function:

    	dValue = 1.234 ;
    	m_3DMeterCtrl.UpdateNeedle(dValue);

     

    How it works:

    The meter is drawn in the desired rectangle in three steps.

    1. The background is drawn.  This is typically achieved by BitBlt'ing a stored background image with the meter face, units and limit values.  The background image is generated when the meter is first drawn and whenever the background items are changed.
    2. The needle is drawn on the background.  The needle is clipped based on a region established around the meter face.
    3. The numerical value is displayed in the box below the needle.

     

    Having a Little more Fun with the Meter

    As stated above, the meter control detects the colors that you've set through your display properties.  (No this isn't dynamic, thus you'll have to force the meter to redraw itself to have it change when you change display properties.)  However, there are some things you can do to the meter.

    Set the needle color:

    	colorNeedle = RGB(0, 255, 0) ;
    	m_3DMeterCtrl.SetNeedleColor(colorNeedle) ;

    Set the range:

    	dMeterMin = -2.0 ;
    	dMeterMax =  2.0 ;
    	m_3DMeterCtrl.SetRange(dMeterMin, dMeterMax) ;

    Set the units:

    	strUnits.Format("mm") ;
    	m_3DMeterCtrl.SetUnits(strUnits);

    Set the decimal places on the max and min values:

    	nScaleDecimals = 2 ;
       	m_3DMeterCtrl.SetScaleDecimals(nScaleDecimals) ;

    Set the decimal places on the current value:

    	nDecimals = 4 ;
    	m_3DMeterCtrl.SetDecimals(nDecimals) ;

    Thus far, I've deployed this in a splitter application (CFormView on the left with the meter and a CView on the right) and it seems to be working fine under Windows 98-SE.   However, I'm sure you guy's can find "areas for improvement".  (I hate to use the "b-u-g-s" word.)

    Have fun with this and please post your feedback!

        - Mark Malburg

    License

    This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

    A list of licenses authors might use can be found here

    About the Author

    Mark C. Malburg
    Software Developer (Senior) Digital Metrology Solutions, Inc.
    United States United States
    No Biography provided

    Comments and Discussions

     
    GeneralNeed Help Pinmemberganesh.dp9-Dec-09 1:04 
    GeneralGood Job PinmemberJBAK_CP24-Mar-09 8:57 
    GeneralSetName Pinmembervarandas10-Jul-08 6:34 
    GeneralGPF PinmemberMichel Wassink29-Jun-05 23:33 
    GeneralSetUnits PinmemberMichel Wassink22-Jun-05 22:56 
    GeneralGreat Meter.... need to change on the fly Pinmemberclav16-May-05 9:13 
    GeneralRe: Great Meter.... need to change on the fly PinmemberMark C. Malburg16-May-05 9:24 
    GeneralRe: Great Meter.... I fixed my problem Pinmemberclav18-May-05 8:52 
    Generaldivision by zero PinmemberMichel Wassink18-Nov-04 0:31 
    GeneralRe: division by zero PinsussAnonymous18-Nov-04 1:05 
    GeneralGreat work Pinmemberphilliad2-Sep-04 13:46 
    GeneralRe: Great work PinmemberMark C. Malburg2-Sep-04 16:30 
    QuestionHow to add this to a dialog box? Pinmemberjianxing16-Jun-04 18:15 
    GeneralLooks good - A request though Pinmemberalan9318-Jun-03 17:32 
    GeneralRe: Looks good - A request though PinmemberMark C. Malburg19-Jun-03 2:56 
    GeneralRe: Looks good - A request though PinmemberBoaz Avta15-Apr-05 21:43 
    GeneralRe: Looks good - A request though PinmemberDieter6821-Jan-09 9:10 
    QuestionNo tap button? PinmemberTim Smith3-Jan-03 6:26 
    AnswerRe: No tap button? PinmemberMark C. Malburg3-Jan-03 6:52 
    GeneralVery Nice!! PinmemberMiki3-Jan-03 6:09 
    GeneralRe: Very Nice!! PinmemberMark C. Malburg3-Jan-03 6:51 
    GeneralGreat - just what the doctor ordered :) PinmemberLea Robbo30-Jul-02 6:13 
    GeneralSmall Bug PinmemberErnesto Perales Soto10-May-02 4:32 
    GeneralRe: Small Bug PinmemberMark Malburg10-May-02 4:35 
    Thanks!
     
    - Mark
    GeneralNice PinmemberJimbob15-Jan-02 14:34 

    General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

    Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

    | Advertise | Privacy | Mobile
    Web01 | 2.8.140721.1 | Last Updated 20 Jun 2000
    Article Copyright 2000 by Mark C. Malburg
    Everything else Copyright © CodeProject, 1999-2014
    Terms of Service
    Layout: fixed | fluid