A C# Oscilloscope Display In Windows Forms
Written by Mike James   
Thursday, 04 June 2015
Article Index
A C# Oscilloscope Display In Windows Forms
ScrollWindowEx

Using ScrollWindowEx

One solution to the problem is to use a direct API call to ScrollWindowEx to scroll the picturebox's display directly.

This has the disadvantage that you have go outside of a managed environment but it is relatively safe. There are some real problems, however.

The ScrollWindowEx call scrolls the internal display bitmap used to show the window. This isn't persistent and in fact if you cause the picturebox to redraw itself at any point you will loose the scrolling and revert to either its background image or its initial state.

This non-persistent effect is one reason why many programmers think that ScrollWindowEx doesn't work - because they never see it for long enough! So we are going to have to be careful not to trigger a redraw of the picturebox and we can't use a bitmap to draw on.

Add a new button to the form and add to the static MyExtensions class:

public static void Scroll(this PictureBox BP,
                             int dx, int dy)
{
 ScrollWindowEx(BP.Handle,
                dx, dy,
                null, null,         
                IntPtr.Zero,
                null, 2);
}

 

This time the extension method has been added directly to the PictureBox. We also need the definition of the API call and the RECT structure it uses. This should be added to the static class:

[DllImport("user32.dll")]
private static extern int ScrollWindowEx(
 System.IntPtr hWnd,
 int dx,
 int dy,
[MarshalAs(UnmanagedType.LPStruct)]
 RECT prcScroll,
[MarshalAs(UnmanagedType.LPStruct)]
 RECT prcClip,
 System.IntPtr hrgnUpdate,
[MarshalAs(UnmanagedType.LPStruct)]
 RECT prcUpdate,
 System.UInt32 flags);

[StructLayout(LayoutKind.Sequential)]
public class RECT
{
 public Int32 left;
 public Int32 top;
 public Int32 right;
 public Int32 bottom;
}

Don't forget to add:

using System.Runtime.InteropServices;

The second button's click handler starts off in roughly the same way:

private void button2_Click(
              object sender, EventArgs e)
{
 Graphics G = pictureBox1.CreateGraphics();
 for (int x = 0; x < 10000; x++)
 {
  int y = (int)(Math.Sin((double)x / 50) *
        pictureBox1.ClientSize.Height / 2 +
        pictureBox1.ClientSize.Height / 2);
        G.DrawLine(Pens.Blue, 1, y, 1, y + 1);

Notice that now we don't need to use a bitmap but draw directly onto the picturebox's Graphics object. 

All that remains is to use the scroll method:

  pictureBox1.Scroll(1, 0);
  Application.DoEvents();
 }

Finally we need to clean up the Graphics object created:

 G.Dispose();
}

It may only be a single Graphics object but not cleaning up still means a memory leak.

Now if you try it out and compare the two plots you will discover that the API based one works much faster. The difference is a factor of more than 100 and very worth the effort.  The only problem is that the API scroll isn't persistent so when the display is completed covering up the final plot erases it.

One final question remains - would this be better done/easier to do using WPF?

But this is another story.

If you would like the code for this project then register and click on CodeBin.

Complete Listing

Omitting the usual using statements:

using System.Runtime.InteropServices;
namespace stripchart1
{

 public partial class Form1 : Form
 {
  public Form1()
  {
   InitializeComponent();
  }

  private void button1_Click(object sender,
                                EventArgs e)
  {
   Bitmap BM = new Bitmap(
              pictureBox1.ClientSize.Width,
              pictureBox1.ClientSize.Height);
   pictureBox1.Image = BM;
   for (int x = 0; x < 10000; x++)
   {
    int y = (int)(Math.Sin((double)x / 50) *
              BM.Height / 2 + BM.Height / 2);
    BM.SetPixel(0, y, Color.Black);
    BM = BM.Scroll(1, 0);
    pictureBox1.Image = BM;
    Application.DoEvents();
   }
  }
 
  private void button2_Click(object sender,
                               EventArgs e)
  {
   Graphics G = pictureBox1.CreateGraphics();
   for (int x = 0; x < 10000; x++)
   {
    int y = (int)(Math.Sin((double)x / 50) *
         pictureBox1.ClientSize.Height / 2 +
         pictureBox1.ClientSize.Height / 2);
    G.DrawLine(Pens.Blue, 1, y, 1, y + 1);
    pictureBox1.Scroll(1, 0);
    Application.DoEvents();
   }
   G.Dispose();
  }
 }
 
 public static class MyExtensions
 {
 [DllImport("user32.dll")]
  private static extern int ScrollWindowEx(
   System.IntPtr hWnd,  
   int dx,
   int dy,
 [MarshalAs(UnmanagedType.LPStruct)]
   RECT prcScroll,
 [MarshalAs(UnmanagedType.LPStruct)]
   RECT prcClip,
   System.IntPtr hrgnUpdate,
 [MarshalAs(UnmanagedType.LPStruct)]
   RECT prcUpdate,
   System.UInt32 flags);

  public static Bitmap Scroll(this Bitmap BM,
                                int dx, int dy)
  {
   Bitmap BMTemp = new Bitmap(BM.Width,
                                   BM.Height);
   Graphics G = Graphics.FromImage(BMTemp);
   G.DrawImage(BM, dx, dy);
   G.Dispose();
   return BMTemp;
  }

  public static void Scroll(this PictureBox BP,
                                   int dx, int dy)
  {
   ScrollWindowEx(BP.Handle,
                  dx, dy,
                  null, null,
                  IntPtr.Zero,
                  null, 2);
  }
 }

 [StructLayout(LayoutKind.Sequential)]
 public class RECT
 {
  public Int32 left;
  public Int32 top;
  public Int32 right;
  public Int32 bottom;
 }
}

Related Articles

Looking at Chaos

Snake - using the GDI+       

 

To be informed about new articles on I Programmer, install the I Programmer Toolbar, subscribe to the RSS feed, follow us on, Twitter, FacebookGoogle+ or Linkedin,  or sign up for our weekly newsletter.

 


AWS Low Cost Mailing List Using phpList And SES

Running a mailing list is not easy or cheap, but if you use AWS it can be. Find out how to create a low-cost and highly effective mailing list server.



QuickSort Exposed

QuickSort was published in July 1961 and so is celebrating its 60th birthday.  QuickSort is the most elegant of algorithms and every programmer should study it. It is also subtle and this often m [ ... ]


Other Projects

 


Huawei Intends To Challenge iOS and Android
24/04/2024

Huawei has just changed its mind and decided to push its HarmonyOS to the rest of the world. A challenger to iOS and Android would be nice, but it is possible?



ACM Adopts Open Access Publishing Model
05/04/2024

ACM, the Association for Computing Machinery, the professional body for computer scientists, has relaunched Communications of the ACM, the organization’s flagship magazine, as a web-first  [ ... ]


More News

 

raspberry pi books

 

Comments




or email your comment to: comments@i-programmer.info

 

<ASIN:9812791035>

<ASIN:0979372518>

<ASIN:0735623945>

 

 



Last Updated ( Thursday, 04 June 2015 )