The VSTGUI4 authors made fundamental changes to the library which breaks old VSTGUI4 project code. The new version of RackAFX v6.7 and above will now use and install VSTGUI4.3 for use in your Custom GUI projects. At the bottom of this docuemnt you will find a list of the changes that were made in VSTGUI4.3.

The CustomViews projects and documents will be updated on the Advanced GUI Tutorial webpage when v6.7 is released. If yyou are using the BETA version of v6.7 and you need to convert your CustomViews-based projects, use the following procedure:

First, open the CustomViews project in RackAFX v6.7 and let it do the automatic file update. This will fix several of the problems. Then, follow the instructions depending on which CustomView project you used as your basis code:

CustomViews:
1) Change all occurances of CControlListener to IControlListener
2) Change all occurances where.v to where.y

CustomViewsTwo:
1) Change all occurances of CControlListener to IControlListener

CustomViewsThree:
1) Change all occurances of CControlListener to IControlListener

CustomViewsFour - in the waveformview.cpp file you need to:
1) Change all occurrences of size.width() to size.getWidth()
2) Change all occurrences of size.height() to size.getHeight()
3) Change the drawing code:

OLD CODE:
	// --- move and draw line
	pContext->moveTo(p1);
	pContext->lineTo(p2);
	pContext->moveTo(p1);
	pContext->lineTo(p3);

NEW CODE:
	// --- draw lines
	pContext->drawLine(p1, p2);
	pContext->drawLine(p1, p3);

CustomViewsFive - in the VSTGUIController.h file you need to:
1) Change CControlListener to IControlListener in the class definition

In the VSTGUIController.cpp file you need to:
1) in CVSTGUIController::loadTiledBitmap() change the CNinePartTiledBitmap intantiation code:

OLD CODE:
CNinePartTiledBitmap* pBM = new CNinePartTiledBitmap(desc, (CNinePartTiledBitmap::PartOffsets(left, top, right, bottom)));

NEW CODE:
CNinePartTiledBitmap* pBM = new CNinePartTiledBitmap(desc, (CNinePartTiledDescription(left, top, right, bottom)));

The changes above will update the old CustomViews-project code. If you have added your own custom controls, you will also need to modify them accordingly (in most cases, a simple Find-and-Replace operation will work for the whole project). See the change notes below.


The changes made in VSTGUI4.3 that affect the CustomViews projects are as follows:

1) the name of the CControlListener object was changed to IControlListener

2) CPoint's member variables "h" and "v" (corresponding to "horizontal" and "vertical") have been removed. Use the alternate member variables "x" and "y" respectively instead.

3) CRect's member functions width() and height() have been renamed to getWidth() and getHeight() respectively

4) CDrawContext's member functions moveTo() and lineTo() have been removed; use the drawLine() function instead (there is also a function called drawLines() if you have many lines to draw at once; see the definition of CDrawContext to learn how to use it).

5) CNinePartTiledBitmap's instantation code has been simplified by removing the PartOffsets() function; see example above for CustomViewsFive


The following are NOT affected in the CustomViews projects, but you may be using them in your own, pure custom drawn GUI code:

6) CXYPad's member function bounceValues() has been renamed to boundValues()

7) the datatype vstguiOutSize has been redefined as uint32_t

8) the datatype vstguiInSize has been redefined as uint32_t

- Will Pirkle
6/18/16