13#define NANOSVG_IMPLEMENTATION
14#pragma warning(disable:4244)
18#include "pluginterfaces/base/ustring.h"
20using VST3_API_BASE = iplug::IPlugVST3;
21#elif defined VST3C_API
22#include "pluginterfaces/base/ustring.h"
24#include "IPlugVST3_View.h"
25using VST3_API_BASE = iplug::IPlugVST3Controller;
41using namespace igraphics;
43static StaticStorage<APIBitmap> sBitmapCache;
44static StaticStorage<SVGHolder> sSVGCache;
46IGraphics::IGraphics(
IGEditorDelegate& dlg,
int w,
int h,
int fps,
float scale)
51, mMinScale(DEFAULT_MIN_DRAW_SCALE)
52, mMaxScale(DEFAULT_MAX_DRAW_SCALE)
55 StaticStorage<APIBitmap>::Accessor bitmapStorage(sBitmapCache);
56 bitmapStorage.Retain();
57 StaticStorage<SVGHolder>::Accessor svgStorage(sSVGCache);
61IGraphics::~IGraphics()
66 mCursorHidden =
false;
69 StaticStorage<APIBitmap>::Accessor bitmapStorage(sBitmapCache);
70 bitmapStorage.Release();
71 StaticStorage<SVGHolder>::Accessor svgStorage(sSVGCache);
81 assert(windowWidth > 0 && windowHeight > 0 &&
"Window dimensions invalid");
84 PlatformResize(parentResized);
94 scale =
Clip(scale, mMinScale, mMaxScale);
106 mCornerResizer->OnRescale();
112 PlatformResize(parentResized);
121void IGraphics::SetLayoutOnResize(
bool layoutOnResize)
123 mLayoutOnResize = layoutOnResize;
128 mMinScale = std::min(lo, hi);
129 mMaxScale = std::max(lo, hi);
135 mCtrlTags.erase(ctrlTag);
142 while (idx >= fromIdx)
149 if(pControl == mMouseOver)
152 if(pControl == mInTextEntry)
155 if(pControl == mInPopupMenu)
156 mInPopupMenu =
nullptr;
158 if(pControl->
GetTag() > kNoTag)
159 mCtrlTags.erase(pControl->
GetTag());
161 mControls.Delete(idx--,
true);
177 if(pControl == mMouseOver)
180 if(pControl == mInTextEntry)
183 if(pControl == mInPopupMenu)
184 mInPopupMenu =
nullptr;
186 if(pControl->
GetTag() > kNoTag)
187 mCtrlTags.erase(pControl->
GetTag());
189 mControls.DeletePtr(pControl,
true);
199 mPopupControl =
nullptr;
200 mTextEntryControl =
nullptr;
201 mCornerResizer =
nullptr;
202 mPerfDisplay =
nullptr;
208 mBubbleControls.Empty(
true);
211 mControls.Empty(
true);
240 const IParam* pParam = mTextEntryValIdx > kNoValIdx ? mInTextEntry->
GetParam(mTextEntryValIdx) :
nullptr;
263 mInPopupMenu->
OnPopupMenuSelection(!pMenu || pMenu->GetChosenItemIdx() == -1 ?
nullptr : pMenu, mPopupMenuValIdx);
265 int nVals = mInPopupMenu->
NVals();
267 for (
int v = 0; v < nVals; v++)
271 if (paramIdx > kNoParameter)
277 mInPopupMenu =
nullptr;
292 mControls.Insert(0, pBG);
299 mControls.Insert(0, pBG);
306 mControls.Insert(0, pBG);
313 auto result = mCtrlTags.insert(std::make_pair(ctrlTag, pControl));
314 assert(result.second &&
"AttachControl failed: ctrl tags must be unique");
322 mControls.Add(pControl);
336 assert(!mCornerResizer);
338 std::unique_ptr<ICornerResizerControl> control(pControl);
342 mCornerResizer.swap(control);
343 mGUISizeMode = sizeMode;
344 mLayoutOnResize = layoutOnResize;
348DBGMSG(
"AttachCornerResizer() is disabled for AUv3");
361 mBubbleControls.Add(pControl);
368 mPopupControl = std::make_unique<IPopupMenuControl>(kNoParameter, text,
IRECT(), bounds);
375 mPopupControl =
nullptr;
380 if (!mTextEntryControl)
382 mTextEntryControl = std::make_unique<ITextEntryControl>();
389 mTextEntryControl =
nullptr;
392void IGraphics::ShowBubbleControl(
IControl* pCaller,
float x,
float y,
const char* str, EDirection dir,
IRECT minimumContentBounds)
394 assert(mBubbleControls.GetSize() &&
"No bubble controls attached");
398 std::vector<ITouchID> touchIDsForCaller;
400 std::vector<IBubbleControl*> availableBubbleControls;
401 int nBubbleControls = mBubbleControls.GetSize();
403 if(touchIDsForCaller.size() == 1)
405 ITouchID touchID = touchIDsForCaller[0];
408 for(
int i=0;i<nBubbleControls;i++)
411 if(pBubbleControl->GetTouchID() == touchID)
413 pBubbleControl->ShowBubble(pCaller, x, y, str, dir, minimumContentBounds, touchID);
417 availableBubbleControls.push_back(pBubbleControl);
420 if(availableBubbleControls.size())
423 static int whichBubbleControl = 0;
424 availableBubbleControls[whichBubbleControl++]->ShowBubble(pCaller, x, y, str, dir, minimumContentBounds, touchID);
425 whichBubbleControl %= nBubbleControls;
434 mBubbleControls.Get(0)->ShowBubble(pCaller, x, y, str, dir, minimumContentBounds);
443 mPerfDisplay = std::make_unique<IFPSDisplayControl>(
GetBounds().GetPadded(-10).GetFromTLHC(200, 50));
449 mPerfDisplay =
nullptr;
458 const auto it = mCtrlTags.find(ctrlTag);
460 if (it != mCtrlTags.end())
466 assert(
"There is no control attached with this tag");
516 for (
auto param : params)
533 if (CStringHasContents(pControl->
GetGroup()))
535 if (strcmp(pControl->
GetGroup(), group) == 0)
553 func(mPerfDisplay.get());
557 func(mLiveEdit.get());
561 func(mCornerResizer.get());
563 if (mTextEntryControl)
564 func(mTextEntryControl.get());
567 func(mPopupControl.get());
569 if (mBubbleControls.GetSize())
571 for(
int i = 0;i<mBubbleControls.GetSize();i++)
573 func(mBubbleControls.Get(i));
578template<
typename T,
typename... Args>
584template<
typename T,
typename... Args>
604 if (pControl->GetParamIdx() > kNoParameter)
605 pControl->SetTooltip(pControl->GetParam()->GetName());
613 double value = pCaller->
GetValue(callerValIdx);
616 auto func = [pCaller, paramIdx, value](
IControl* pControl)
618 int valIdx = pControl->LinkedToParam(paramIdx);
621 if ((valIdx > kNoValIdx) && (pControl != pCaller))
623 pControl->SetValueFromDelegate(value, valIdx);
632 assert(valIdx > kNoValIdx);
640 WDL_String currentText;
642 if ( type == IParam::kTypeEnum || (type == IParam::kTypeBool && nDisplayTexts))
645 mPromptPopupMenu.Clear();
648 for (
int i = 0; i < nDisplayTexts; ++i)
652 if (!strcmp(str, currentText.Get()))
653 mPromptPopupMenu.AddItem(
new IPopupMenu::Item(str, IPopupMenu::Item::kChecked), -1 );
657 mPromptPopupMenu.SetRootTitle(pParam->
GetName());
669 currentText.Append(
" ");
670 currentText.Append(pParam->
GetLabel());
680 if (!str || str[0] ==
'\0')
688 if (!str || str[0] ==
'\0')
696 IRECT bounds = { x, y, x, y };
697 DrawText(text, str, bounds, pBlend);
705 bmpState =
Clip(bmpState, 1, bitmap.
N());
707 if (bitmap.
N() > 1 && bmpState > 1)
711 srcX = bitmap.
W() * (bmpState - 1) / bitmap.
N();
715 srcY = bitmap.
H() * (bmpState - 1) / bitmap.
N();
719 return DrawBitmap(bitmap, bounds, srcX, srcY, pBlend);
724 if (CStringHasContents(str))
726 int stringLength = (int) strlen(str);
728 float basicYOffset = 0.;
729 float basicXOffset = 0.;
732 basicYOffset = bounds.T + ((bounds.
H() - charHeight) / 2.f);
734 basicYOffset = bounds.T;
736 if (text.mAlign == EAlign::Center)
737 basicXOffset = bounds.L + ((bounds.
W() - (stringLength * charWidth)) / 2.f);
738 else if (text.mAlign == EAlign::Near)
739 basicXOffset = bounds.L;
740 else if (text.mAlign == EAlign::Far)
741 basicXOffset = bounds.R - (stringLength * charWidth);
743 int widthAsOneLine = charWidth * stringLength;
748 int nCharsThatFitIntoLine;
752 if (widthAsOneLine > bounds.
W())
754 nCharsThatFitIntoLine = int(bounds.
W() / (
float)charWidth);
755 nLines = int(
float(widthAsOneLine) / bounds.
W()) + 1;
759 nCharsThatFitIntoLine = stringLength;
765 nCharsThatFitIntoLine = int(bounds.
W() / (
float) charWidth);
769 for (
int line=0; line<nLines; line++)
771 float yOffset = basicYOffset + line * charHeight;
773 for (
int linepos=0; linepos<nCharsThatFitIntoLine; linepos++)
775 if (str[stridx] ==
'\0')
return;
777 int frameOffset = (int) str[stridx++] - 31;
779 float xOffset = ((float) linepos * ((
float) charWidth + (float) charOffset)) + basicXOffset;
780 IRECT charRect =
IRECT(xOffset, yOffset, xOffset + charWidth, yOffset + charHeight);
781 DrawBitmap(bitmap, charRect, frameOffset, pBlend);
789 if (dir == EDirection::Horizontal)
797 x =
Clip(x, 0.0f, 1.0f);
798 float xi = bounds.L + int(x * (bounds.R - bounds.L));
804 y =
Clip(y, 0.0f, 1.0f);
805 float yi = bounds.B - (y * (float) (bounds.B - bounds.T));
811 DrawLine(color, xi, yLo, xi, yHi, pBlend, thickness);
816 DrawLine(color, xLo, yi, xHi, yi, pBlend, thickness);
822 RadialPoints(angle, cx, cy, rMin, rMax, 2, data);
823 DrawLine(color, data[0][0], data[0][1], data[1][0], data[1][1], pBlend, thickness);
829 RadialPoints(angle, cx, cy, rMin, rMax, 2, data);
830 PathLine(data[0][0], data[0][1], data[1][0], data[1][1]);
835 if (mDisplayTickFunc)
842 auto func = [&dirty, &rects](
IControl* pControl) {
853 rects.
Add(rectToAdd);
865 else if (++mIdleTicks > IDLE_TICKS)
879 const double timestamp = GetTimestamp();
880 const double timeDiff = timestamp - mPrevTimestamp;
881 mPerfDisplay->Update((
float) timeDiff);
882 mPrevTimestamp = timestamp;
887void IGraphics::DrawControl(
IControl* pControl,
const IRECT& bounds,
float scale)
895 if (clipBounds.
W() <= 0.0 || clipBounds.
H() <= 0)
907 clipBounds.
Clank(parentBounds);
912 PrepareRegion(clipBounds);
913 pControl->
Draw(*
this);
919 if (mShowControlBounds)
921 PrepareRegion(clipBounds);
926 CompleteRegion(clipBounds);
937 PrepareRegion(bounds);
941 CompleteRegion(bounds);
966 for (
auto i = 0; i < rects.
Size(); i++)
983 bool singlePoint = points.size() == 1;
987 mMouseDownX = points[0].x;
988 mMouseDownY = points[0].y;
991 for (
auto& point : points)
997 IControl* pCapturedControl = GetMouseControl(x, y,
true,
false, mod.touchID);
999 if (pCapturedControl)
1001 int nVals = pCapturedControl->
NVals();
1002#if defined AAX_API || !defined IGRAPHICS_NO_CONTEXT_MENU
1004 int paramIdx = pCapturedControl->
GetParamIdx((valIdx > kNoValIdx) ? valIdx : 0);
1008 if (mAAXViewContainer && paramIdx > kNoParameter)
1010 auto GetAAXModifiersFromIMouseMod = [](
const IMouseMod& mod) {
1011 uint32_t modifiers = 0;
1013 if (mod.A) modifiers |= AAX_eModifiers_Option;
1016 if (mod.C) modifiers |= AAX_eModifiers_Command;
1018 if (mod.C) modifiers |= AAX_eModifiers_Control;
1019 if (mod.R) modifiers |= AAX_eModifiers_Command;
1021 if (mod.S) modifiers |= AAX_eModifiers_Shift;
1022 if (mod.R) modifiers |= AAX_eModifiers_SecondaryButton;
1027 uint32_t aaxModifiersForPT = GetAAXModifiersFromIMouseMod(mod);
1030 uint32_t aaxModifiersFromPT = 0;
1031 mAAXViewContainer->GetModifiers(&aaxModifiersFromPT);
1032 aaxModifiersForPT |= aaxModifiersFromPT;
1035 paramID.SetFormatted(32,
"%i", paramIdx+1);
1037 if (mAAXViewContainer->HandleParameterMouseDown(paramID.Get(), aaxModifiersForPT) == AAX_SUCCESS)
1045#ifndef IGRAPHICS_NO_CONTEXT_MENU
1046 if (mod.R && paramIdx > kNoParameter)
1054 for (
int v = 0; v < nVals; v++)
1056 if (pCapturedControl->
GetParamIdx(v) > kNoParameter)
1071 for (
auto& point : points)
1076 auto itr = mCapturedMap.find(mod.touchID);
1078 if(itr != mCapturedMap.end())
1080 IControl* pCapturedControl = itr->second;
1084 int nVals = pCapturedControl->
NVals();
1086 for (
int v = 0; v < nVals; v++)
1088 if (pCapturedControl->
GetParamIdx(v) > kNoParameter)
1092 mCapturedMap.erase(mod.touchID);
1097 if (mResizingInProcess)
1102 if (points.size() == 1 && !points[0].ms.IsTouch())
1103 OnMouseOver(points[0].x, points[0].y, points[0].ms);
1111 for (
auto& point : points)
1117 auto itr = mCapturedMap.find(mod.touchID);
1119 if(itr != mCapturedMap.end())
1121 IControl* pCapturedControl = itr->second;
1123 mCapturedMap.erase(mod.touchID);
1133 Trace(
"IGraphics::OnMouseOver", __LINE__,
"x:%0.2f, y:%0.2f, mod:LRSCA: %i%i%i%i%i",
1134 x, y, mod.L, mod.R, mod.S, mod.C, mod.A);
1137 IControl* pControl = GetMouseControl(x, y,
false,
true);
1139 if (pControl != mMouseOver)
1144 mMouseOver = pControl;
1155 Trace(
"IGraphics::OnMouseOut", __LINE__,
"");
1165 Trace(
"IGraphics::OnMouseDrag:", __LINE__,
"x:%0.2f, y:%0.2f, dX:%0.2f, dY:%0.2f, mod:LRSCA: %i%i%i%i%i",
1166 points[0].x, points[0].y, points[0].dX, points[0].dY, points[0].ms.L, points[0].ms.R, points[0].ms.S, points[0].ms.C, points[0].ms.A);
1168 if (mResizingInProcess && points.size() == 1)
1175 textEntry = mTextEntryControl.get();
1177 for (
auto& point : points)
1181 float dX = point.dX;
1182 float dY = point.dY;
1185 auto itr = mCapturedMap.find(mod.touchID);
1187 if (itr != mCapturedMap.end())
1189 IControl* pCapturedControl = itr->second;
1191 if (textEntry && pCapturedControl != textEntry)
1192 pCapturedControl =
nullptr;
1194 if (pCapturedControl && (dX != 0 || dY != 0))
1205 Trace(
"IGraphics::OnMouseDblClick", __LINE__,
"x:%0.2f, y:%0.2f, mod:LRSCA: %i%i%i%i%i",
1206 x, y, mod.L, mod.R, mod.S, mod.C, mod.A);
1208 IControl* pControl = GetMouseControl(x, y,
true);
1218 std::vector<IMouseInfo> list {info};
1233 IControl* pControl = GetMouseControl(x, y,
false);
1243 Trace(
"IGraphics::OnKeyDown", __LINE__,
"x:%0.2f, y:%0.2f, key:%s",
1246 bool handled =
false;
1248 IControl* pControl = GetMouseControl(x, y,
false);
1251 handled = pControl->
OnKeyDown(x, y, key);
1254 handled = mKeyHandlerFunc ? mKeyHandlerFunc(key,
false) :
false;
1261 Trace(
"IGraphics::OnKeyUp", __LINE__,
"x:%0.2f, y:%0.2f, key:%s",
1264 bool handled =
false;
1266 IControl* pControl = GetMouseControl(x, y,
false);
1269 handled = pControl->
OnKeyUp(x, y, key);
1272 handled = mKeyHandlerFunc ? mKeyHandlerFunc(key,
true) :
false;
1279 IControl* pControl = GetMouseControl(x, y,
false);
1280 if (pControl) pControl->
OnDrop(str);
1285 IControl* pControl = GetMouseControl(x, y,
false);
1291 mCapturedMap.clear();
1296int IGraphics::GetMouseControlIdx(
float x,
float y,
bool mouseOver)
1298 if (!mouseOver || mEnableMouseOver)
1301 for (
auto c =
NControls() - 1; c >= (mouseOver ? 1 : 0); --c)
1313 if (pControl->
IsHit(x, y))
1332IControl* IGraphics::GetMouseControl(
float x,
float y,
bool capture,
bool mouseOver, ITouchID touchID)
1336 auto itr = mCapturedMap.find(touchID);
1340 pControl = itr->second;
1346 int controlIdx = -1;
1348 if (!pControl && mPopupControl && mPopupControl->GetExpanded())
1349 pControl = mPopupControl.get();
1351 if (!pControl && mTextEntryControl && mTextEntryControl->EditInProgress())
1352 pControl = mTextEntryControl.get();
1356 if (!pControl && mLiveEdit)
1357 pControl = mLiveEdit.get();
1360 if (!pControl && mCornerResizer && mCornerResizer->GetRECT().Contains(x, y))
1361 pControl = mCornerResizer.get();
1363 if (!pControl && mPerfDisplay && mPerfDisplay->GetRECT().Contains(x, y))
1364 pControl = mPerfDisplay.get();
1368 controlIdx = GetMouseControlIdx(x, y, mouseOver);
1369 pControl = (controlIdx >= 0) ?
GetControl(controlIdx) :
nullptr;
1372 if (capture && pControl)
1382 mCapturedMap.insert(std::make_pair(touchID, pControl));
1388 mMouseOverIdx = controlIdx;
1395 IControl* pControl = GetMouseControl(x, y,
false);
1396 int idx = mLastClickedParam = pControl ? pControl->
GetParamIdx() : -1;
1402 const int idx = mLastClickedParam;
1403 mLastClickedParam = kNoParameter;
1415 contextMenu.Clear();
1421#if defined VST3_API || defined VST3C_API
1422 VST3_API_BASE* pVST3 =
dynamic_cast<VST3_API_BASE*
>(
GetDelegate());
1424 if (!pVST3->GetComponentHandler() || !pVST3->GetView())
1427 Steinberg::FUnknownPtr<Steinberg::Vst::IComponentHandler3>handler(pVST3->GetComponentHandler() );
1432 Steinberg::Vst::ParamID p = paramIdx;
1434 Steinberg::Vst::IContextMenu* pVST3ContextMenu = handler->createContextMenu(pVST3->GetView(), &p);
1436 if (pVST3ContextMenu)
1438 std::function<void(
IPopupMenu* pCurrentMenu)> populateFunc;
1439 Steinberg::int32 tag = 0;
1441 populateFunc = [&populateFunc, &tag, pVST3ContextMenu, pControl](
IPopupMenu* pCurrentMenu) {
1442 Steinberg::Vst::IContextMenu::Item item = {0};
1444 for (
int i = 0; i < pCurrentMenu->NItems(); i++)
1446 Steinberg::UString128 (pCurrentMenu->GetItemText(i)).copyTo (item.name, 128);
1450 if (pCurrentMenu->GetItem(i)->GetIsSeparator())
1452 item.flags = Steinberg::Vst::IContextMenu::Item::kIsSeparator;
1454 else if (
auto pSubMenu = pCurrentMenu->GetItem(i)->GetSubmenu())
1456 item.flags = Steinberg::Vst::IContextMenu::Item::kIsGroupStart;
1457 pVST3ContextMenu->addItem(item, pControl);
1458 populateFunc(pSubMenu);
1460 item.flags = Steinberg::Vst::IContextMenu::Item::kIsGroupEnd;
1461 pVST3ContextMenu->addItem(item, pControl);
1466 if (!pCurrentMenu->GetItem(i)->GetEnabled())
1467 item.flags |= Steinberg::Vst::IContextMenu::Item::kIsDisabled;
1469 if (pCurrentMenu->GetItem(i)->GetChecked())
1470 item.flags |= Steinberg::Vst::IContextMenu::Item::kIsChecked;
1473 pVST3ContextMenu->addItem(item, pControl);
1477 populateFunc(&contextMenu);
1486 pVST3ContextMenu->popup((Steinberg::UCoord) x, (Steinberg::UCoord) y);
1487 pVST3ContextMenu->release();
1491 if(!contextMenu.NItems())
1494 DoCreatePopupMenu(*pControl, contextMenu,
IRECT(x, y, x, y), kNoValIdx,
true);
1512 if(mGUISizeMode == EUIResizerMode::Scale)
1527 if (mAppearanceChangedFunc)
1528 mAppearanceChangedFunc(appearance);
1540 mEnableTooltips = enable;
1541 if (enable) mEnableMouseOver =
true;
1551 mLiveEdit = std::make_unique<IGraphicsLiveEdit>(mEnableMouseOver);
1557 mLiveEdit =
nullptr;
1571 StaticStorage<SVGHolder>::Accessor storage(sSVGCache);
1572 SVGHolder* pHolder = storage.Find(fileName);
1576 WDL_TypedBuf<uint8_t> svgData =
LoadResource(fileName,
"svg");
1577 if (svgData.GetSize() == 0)
1579 return ISVG(
nullptr);
1583 return LoadSVG(fileName, svgData.Get(), svgData.GetSize(), units, dpi);
1587 return ISVG(pHolder->mSVGDom);
1592 StaticStorage<SVGHolder>::Accessor storage(sSVGCache);
1593 SVGHolder* pHolder = storage.Find(name);
1597 sk_sp<SkSVGDOM> svgDOM;
1600 SkMemoryStream svgStream(pData, dataSize);
1601 svgDOM = SkSVGDOM::MakeFromStream(svgStream);
1604 return ISVG(
nullptr);
1608 if (svgDOM->containerSize().width() == 0)
1610 NSVGimage* pImage =
nullptr;
1613 svgStr.Set((
const char*)pData, dataSize);
1614 pImage = nsvgParse(svgStr.Get(), units, dpi);
1618 svgDOM->setContainerSize(SkSize::Make(pImage->width, pImage->height));
1623 pHolder =
new SVGHolder(svgDOM);
1624 storage.Add(pHolder, name);
1627 return ISVG(pHolder->mSVGDom);
1633 StaticStorage<SVGHolder>::Accessor storage(sSVGCache);
1634 SVGHolder* pHolder = storage.Find(fileName);
1638 WDL_TypedBuf<uint8_t> svgData =
LoadResource(fileName,
"svg");
1639 if (svgData.GetSize() == 0)
1641 return ISVG(
nullptr);
1645 return LoadSVG(fileName, svgData.Get(), svgData.GetSize(), units, dpi);
1649 return ISVG(pHolder->mImage);
1654 StaticStorage<SVGHolder>::Accessor storage(sSVGCache);
1655 SVGHolder* pHolder = storage.Find(name);
1659 NSVGimage* pImage =
nullptr;
1662 svgStr.Set(
reinterpret_cast<const char*
>(pData), dataSize);
1663 pImage = nsvgParse(svgStr.Get(), units, dpi);
1666 return ISVG(
nullptr);
1668 pHolder =
new SVGHolder(pImage);
1670 storage.Add(pHolder, name);
1673 return ISVG(pHolder->mImage);
1679 WDL_TypedBuf<uint8_t> result;
1684 if (resourceFound == EResourceLocation::kNotFound)
1688 if (resourceFound == EResourceLocation::kWinBinary)
1692 result.Resize(size);
1693 result.Set((
const uint8_t*)pResData, size);
1696 if (resourceFound == EResourceLocation::kAbsolutePath)
1698 FILE* fd = fopenUTF8(path.Get(),
"rb");
1704 if (fseek(fd, 0, SEEK_END))
1709 long size = ftell(fd);
1712 if (fseek(fd, 0, SEEK_SET))
1718 result.Resize((
int)size);
1719 size_t bytesRead = fread(result.Get(), 1, (
size_t)size, fd);
1720 if (bytesRead != (
size_t)size)
1723 result.Resize(0,
true);
1734 if (targetScale == 0)
1737 StaticStorage<APIBitmap>::Accessor storage(sBitmapCache);
1738 APIBitmap* pAPIBitmap = storage.Find(name, targetScale);
1743 WDL_String fullPath;
1744 std::unique_ptr<APIBitmap> loadedBitmap;
1745 int sourceScale = 0;
1747 const char* ext = name + strlen(name) - 1;
1748 while (ext >= name && *ext !=
'.') --ext;
1753 if (!bitmapTypeSupported)
1756 EResourceLocation resourceLocation =
SearchImageResource(name, ext, fullPath, targetScale, sourceScale);
1758 if (resourceLocation == EResourceLocation::kNotFound)
1766 if (sourceScale != targetScale)
1767 pAPIBitmap = storage.Find(name, sourceScale);
1772 loadedBitmap = std::unique_ptr<APIBitmap>(
LoadAPIBitmap(fullPath.Get(), sourceScale, resourceLocation, ext));
1773 pAPIBitmap= loadedBitmap.get();
1778 assert(pAPIBitmap &&
"Bitmap not found");
1781 if (pAPIBitmap->
GetScale() != targetScale)
1783 return ScaleBitmap(
IBitmap(pAPIBitmap, nStates, framesAreHorizontal, name), name, targetScale);
1785 else if (loadedBitmap)
1791 return IBitmap(pAPIBitmap, nStates, framesAreHorizontal, name);
1796 if (targetScale == 0)
1799 StaticStorage<APIBitmap>::Accessor storage(sBitmapCache);
1800 APIBitmap* pAPIBitmap = storage.Find(name, targetScale);
1805 WDL_String fullPath;
1806 std::unique_ptr<APIBitmap> loadedBitmap;
1807 int sourceScale = 0;
1809 const char* ext = name + strlen(name) - 1;
1810 while (ext >= name && *ext !=
'.') --ext;
1815 if (!bitmapTypeSupported)
1823 loadedBitmap = std::unique_ptr<APIBitmap>(
LoadAPIBitmap(name, pData, dataSize, 1));
1824 pAPIBitmap= loadedBitmap.get();
1829 assert(pAPIBitmap &&
"Bitmap not found");
1832 if (pAPIBitmap->
GetScale() != targetScale)
1834 return ScaleBitmap(
IBitmap(pAPIBitmap, nStates, framesAreHorizontal, name), name, targetScale);
1836 else if (loadedBitmap)
1842 return IBitmap(pAPIBitmap, nStates, framesAreHorizontal, name);
1847 StaticStorage<APIBitmap>::Accessor storage(sBitmapCache);
1853 StaticStorage<APIBitmap>::Accessor storage(sBitmapCache);
1862 mScreenScale = scale;
1872 mScreenScale = screenScale;
1873 mDrawScale = drawScale;
1878auto SearchNextScale = [](
int& sourceScale,
int targetScale) {
1879 if (sourceScale == targetScale && (targetScale != MAX_IMG_SCALE))
1880 sourceScale = MAX_IMG_SCALE;
1881 else if (sourceScale == targetScale + 1)
1882 sourceScale = targetScale - 1;
1889 for (sourceScale = targetScale ; sourceScale > 0; SearchNextScale(sourceScale, targetScale))
1891 WDL_String fullName(name);
1893 if (sourceScale != 1)
1895 WDL_String baseName(name); baseName.remove_fileext();
1896 WDL_String ext(fullName.get_fileext());
1897 fullName.SetFormatted((
int) (strlen(name) + strlen(
"@2x")),
"%s@%dx%s", baseName.Get(), sourceScale, ext.Get());
1902 if (found > EResourceLocation::kNotFound)
1906 return EResourceLocation::kNotFound;
1911 StaticStorage<APIBitmap>::Accessor storage(sBitmapCache);
1913 for (sourceScale = targetScale; sourceScale > 0; SearchNextScale(sourceScale, targetScale))
1915 APIBitmap* pBitmap = storage.Find(name, sourceScale);
1936 mInTextEntry = &control;
1937 mTextEntryValIdx = valIdx;
1939 int paramIdx = valIdx > kNoValIdx ? control.
GetParamIdx(valIdx) : kNoParameter;
1941 if (mTextEntryControl)
1942 mTextEntryControl->CreateTextEntry(paramIdx, text, bounds, control.
GetTextEntryLength(), str);
1949void IGraphics::DoCreatePopupMenu(
IControl& control,
IPopupMenu& menu,
const IRECT& bounds,
int valIdx,
bool isContext)
1953 mInPopupMenu = &control;
1954 mPopupMenuValIdx = valIdx;
1955 mIsContextMenu = isContext;
1959 mPopupControl->CreatePopupMenu(menu, bounds);
1963 bool isAsync =
false;
1973 DoCreatePopupMenu(control, menu, bounds, valIdx,
false);
1976void IGraphics::EndDragResize()
1978 mResizingInProcess =
false;
1992 const int w =
static_cast<int>(std::ceil(pixelBackingScale * std::ceil(alignedBounds.
W())));
1993 const int h =
static_cast<int>(std::ceil(pixelBackingScale * std::ceil(alignedBounds.
H())));
2002 ownedLayer.swap(layer);
2003 ILayer* pOwnerlessLayer = ownedLayer.release();
2005 if (pOwnerlessLayer)
2018 mLayers.push(pLayer);
2027 ILayer* pLayer =
nullptr;
2029 if (!mLayers.empty())
2031 pLayer = mLayers.top();
2045 const APIBitmap* pBitmap = layer ? layer->GetAPIBitmap() :
nullptr;
2047 if (pBitmap && layer->mControl && layer->mControlRECT != layer->mControl->GetRECT())
2049 layer->mControlRECT = layer->mControl->GetRECT();
2050 layer->Invalidate();
2060 DrawBitmap(layer->GetBitmap(), layer->Bounds(), 0, 0, pBlend);
2066 IBitmap bitmap = layer->GetBitmap();
2067 IRECT layerBounds = layer->Bounds();
2070 IRECT newBounds(0., 0., layerBounds.
W(), layerBounds.
H());
2080 IBitmap bitmap = layer->GetBitmap();
2081 IRECT bounds = layer->Bounds();
2088 auto GaussianBlurSwap = [](uint8_t* out, uint8_t* in, uint8_t* kernel,
int width,
int height,
2089 int outStride,
int inStride,
int kernelSize, uint32_t norm)
2092 int fullKernelSize = kernelSize * 2 + 1;
2095 auto RepeatCheck = [&](
int idx)
2097 repeats = last == in[idx * 4] ? std::min(repeats + 1, fullKernelSize) : 1;
2100 return repeats == fullKernelSize;
2103 for (
int i = 0; i < height; i++, in += inStride)
2105 for (
int j = 0; j < kernelSize - 1; j++)
2107 uint32_t accum = in[j * 4] * kernel[0];
2108 for (
int k = 1; k < j + 1; k++)
2109 accum += kernel[k] * in[(j - k) * 4];
2110 for (
int k = 1; k < kernelSize; k++)
2111 accum += kernel[k] * in[(j + k) * 4];
2112 out[j * outStride + (i * 4)] =
static_cast<uint8_t
>(std::min(
static_cast<uint32_t
>(255), accum / norm));
2114 for (
int j = 0; j < kernelSize * 2 - 2; j++)
2116 for (
int j = kernelSize - 1; j < (width - kernelSize) + 1; j++)
2118 if (RepeatCheck(j + kernelSize - 1))
2120 out[j * outStride + (i * 4)] =
static_cast<uint8_t
>(last);
2124 uint32_t accum = in[j * 4] * kernel[0];
2125 for (
int k = 1; k < kernelSize; k++)
2126 accum += kernel[k] * (in[(j - k) * 4] + in[(j + k) * 4]);
2127 out[j * outStride + (i * 4)] =
static_cast<uint8_t
>(std::min(
static_cast<uint32_t
>(255), accum / norm));
2129 for (
int j = (width - kernelSize) + 1; j < width; j++)
2131 uint32_t accum = in[j * 4] * kernel[0];
2132 for (
int k = 1; k < kernelSize; k++)
2133 accum += kernel[k] * in[(j - k) * 4];
2134 for (
int k = 1; k < width - j; k++)
2135 accum += kernel[k] * in[(j + k) * 4];
2136 out[j * outStride + (i * 4)] =
static_cast<uint8_t
>(std::min(
static_cast<uint32_t
>(255), accum / norm));
2141 RawBitmapData temp1;
2142 RawBitmapData temp2;
2143 RawBitmapData kernel;
2148 if (!temp1.GetSize())
2150 temp2.Resize(temp1.GetSize());
2154 float scale = layer->GetAPIBitmap()->GetScale() * layer->GetAPIBitmap()->GetDrawScale();
2155 float blurSize = std::max(1.f, (shadow.mBlurSize * scale) + 1.f);
2156 float blurConst = 4.5f / (blurSize * blurSize);
2157 int iSize =
static_cast<int>(ceil(blurSize));
2158 int width = layer->GetAPIBitmap()->GetWidth();
2159 int height = layer->GetAPIBitmap()->GetHeight();
2160 int stride1 = temp1.GetSize() / width;
2161 int stride2 = flipped ? -temp1.GetSize() / height : temp1.GetSize() / height;
2162 int stride3 = flipped ? -stride2 : stride2;
2164 kernel.Resize(iSize);
2166 for (
int i = 0; i < iSize; i++)
2167 kernel.Get()[i] =
static_cast<uint8_t
>(std::round(255.f * std::expf(-(i * i) * blurConst)));
2170 int normFactor = kernel.Get()[0];
2172 for (
int i = 1; i < iSize; i++)
2173 normFactor += kernel.Get()[i] + kernel.Get()[i];
2177 uint8_t* inRows = flipped ? asRows + stride3 * (height - 1) : asRows;
2180 GaussianBlurSwap(asCols, inRows, kernel.Get(), width, height, stride1, stride2, iSize, normFactor);
2181 GaussianBlurSwap(asRows, asCols, kernel.Get(), height, width, stride3, stride1, iSize, normFactor);
2200 DBGMSG(
"Could not locate font %s\n", fileNameOrResID);
2217 DBGMSG(
"Could not load font %s\n", fontID);
2234 DBGMSG(
"Could not locate font %s\n", fontID);
2240 double tx = 0.0, ty = 0.0;
2243 rect.
Translate(
static_cast<float>(tx),
static_cast<float>(ty));
2267 IRECT r1(
static_cast<float>(std::min(x0, x3)),
static_cast<float>(std::min(y0, y3)),
static_cast<float>(std::max(x0, x3)),
static_cast<float>(std::max(y0, y3)));
2268 IRECT r2(
static_cast<float>(std::min(x1, x2)),
static_cast<float>(std::min(y1, y2)),
static_cast<float>(std::max(x1, x2)),
static_cast<float>(std::max(y1, y2)));
2269 rect = r1.
Union(r2);
2271 switch (text.mAlign)
2273 case EAlign::Near: tx = bounds.L - rect.L;
break;
2274 case EAlign::Center: tx = bounds.
MW() - rect.
MW();
break;
2275 case EAlign::Far: tx = bounds.R - rect.R;
break;
2278 switch (text.mVAlign)
2280 case EVAlign::Top: ty = bounds.T - rect.T;
break;
2281 case EVAlign::Middle: ty = bounds.
MH() - rect.
MH();
break;
2282 case EVAlign::Bottom: ty = bounds.B - rect.B;
break;
2292 static int base = 48;
2293 static bool keysDown[128] = {};
2295 auto onOctSwitch = [&]() {
2296 base =
Clip(base, 24, 96);
2298 for(
auto i=0;i<128;i++) {
2309 case kVK_A: note = 0;
break;
2310 case kVK_W: note = 1;
break;
2311 case kVK_S: note = 2;
break;
2312 case kVK_E: note = 3;
break;
2313 case kVK_D: note = 4;
break;
2314 case kVK_F: note = 5;
break;
2315 case kVK_T: note = 6;
break;
2316 case kVK_G: note = 7;
break;
2317 case kVK_Y: note = 8;
break;
2318 case kVK_H: note = 9;
break;
2319 case kVK_U: note = 10;
break;
2320 case kVK_J: note = 11;
break;
2321 case kVK_K: note = 12;
break;
2322 case kVK_O: note = 13;
break;
2323 case kVK_L: note = 14;
break;
2324 case kVK_Z:
if(!isUp) { base -= 12; onOctSwitch(); }
return true;
2325 case kVK_X:
if(!isUp) { base += 12; onOctSwitch(); }
return true;
2326 default:
return true;
2329 int pitch = base + note;
2332 if(keysDown[pitch] ==
false) {
2334 keysDown[pitch] =
true;
2341 if(keysDown[pitch] ==
true) {
2343 keysDown[pitch] =
false;
2356 IControl* pControl = GetMouseControl(x, y,
false,
false);
2361 if(mGestureRegions.
Size() == 0)
2365 int regionIdx = mGestureRegions.
Find(x, y);
2376 IControl* pControl = GetMouseControl(info.x, info.y,
false,
false);
2382 int regionIdx = mGestureRegions.
Find(info.x, info.y);
2385 mGestureRegionFuncs.find(regionIdx)->second(
nullptr, info);
2391 if (std::find(std::begin(mRegisteredGestures), std::end(mRegisteredGestures), type) != std::end(mRegisteredGestures))
2393 mRegisteredGestures.push_back(type);
2399 mGestureRegions.
Add(bounds);
2401 mGestureRegionFuncs.insert(std::make_pair(mGestureRegions.
Size()-1, func));
2406 mGestureRegions.
Clear();
2407 mGestureRegionFuncs.clear();
2418 DrawBitmap(bitmap,
IRECT(-width * 0.5f, - height * 0.5f, width * 0.5f, height * 0.5f), 0, 0, pBlend);
2440 if (gridSizeH > 1.f)
2442 for (
float x = bounds.L + gridSizeH; x < bounds.R; x += gridSizeH)
2449 if (gridSizeV > 1.f)
2451 for (
float y = bounds.T + gridSizeV; y < bounds.B; y += gridSizeV)
2468 float xPos = bounds.L;
2470 PathMoveTo(xPos, bounds.B - (bounds.
H() * normYPoints[0]));
2472 for (
auto i = 1; i < nPoints; i++)
2475 xPos = bounds.L + (bounds.
W() * normXPoints[i]);
2477 xPos = bounds.L + ((bounds.
W() / (float) (nPoints - 1) * i));
2479 PathLineTo(xPos, bounds.B - (bounds.
H() * normYPoints[i]));
2495 options.mDash.SetDash(&dashLen, 0.0, 1);
2498 PathStroke(color, thickness, options, pBlend);
2554 options.mDash.SetDash(&dashLen, 0., 1);
2556 PathStroke(color, thickness, options, pBlend);
2657 if (ctl <= 0.f && ctr <= 0.f && cbl <= 0.f && cbr <= 0.f)
2663 const float y = bounds.B - bounds.
H();
2665 PathArc(bounds.L + ctl, y + ctl, ctl, 270.f, 360.f);
2666 PathArc(bounds.L + bounds.
W() - ctr, y + ctr, ctr, 0.f, 90.f);
2667 PathArc(bounds.L + bounds.
W() - cbr, y + bounds.
H() - cbr, cbr, 90.f, 180.f);
2668 PathArc(bounds.L + cbl, y + bounds.
H() - cbl, cbl, 180.f, 270.f);
2682 if (r1 <= 0.0 || r2 <= 0.0)
2702 PathArc(cx, cy, r, 0.f, 360.f);
2709 for(
int i = 1; i < nPoints; i++)
2716 mTransformStates.push(mTransform);
2721 if (!mTransformStates.empty())
2723 mTransform = mTransformStates.top();
2724 mTransformStates.pop();
2725 PathTransformSetMatrix(mTransform);
2733 std::stack<IMatrix> newStack;
2734 mTransformStates.swap(newStack);
2738 PathTransformSetMatrix(mTransform);
2744 PathTransformSetMatrix(mTransform);
2749 mTransform.
Scale(scaleX, scaleY);
2750 PathTransformSetMatrix(mTransform);
2760 mTransform.
Rotate(angle);
2761 PathTransformSetMatrix(mTransform);
2766 mTransform.
Skew(xAngle, yAngle);
2767 PathTransformSetMatrix(mTransform);
2773 PathTransformSetMatrix(mTransform);
2778 IRECT drawArea = mLayers.empty() ? mClipRECT : mLayers.top()->Bounds();
2780 PathTransformSetMatrix(
IMatrix());
2781 SetClipRegion(clip);
2782 PathTransformSetMatrix(mTransform);
2789 IRECT newBounds(0., 0.,
static_cast<float>(bitmap.
W()),
static_cast<float>(bitmap.
H()));
2790 PathTransformScale(bounds.
W() /
static_cast<float>(bitmap.
W()), bounds.
H() /
static_cast<float>(bitmap.
H()));
2797 float xScale = dest.
W() / svg.
W();
2798 float yScale = dest.
H() / svg.
H();
2799 float scale = xScale < yScale ? xScale : yScale;
2804 DoDrawSVG(svg, pBlend, pStrokeColor, pFillColor);
2813 DrawSVG(svg,
IRECT(-width * 0.5f, - height * 0.5f, width * 0.5f, height * 0.5f), pBlend);
2817IPattern IGraphics::GetSVGPattern(
const NSVGpaint& paint,
float opacity)
2819 int alpha = std::min(255, std::max(
int(roundf(opacity * 255.f)), 0));
2823 case NSVG_PAINT_COLOR:
2824 return IColor(alpha, (paint.color >> 0) & 0xFF, (paint.color >> 8) & 0xFF, (paint.color >> 16) & 0xFF);
2826 case NSVG_PAINT_LINEAR_GRADIENT:
2827 case NSVG_PAINT_RADIAL_GRADIENT:
2829 NSVGgradient* pGrad = paint.gradient;
2831 IPattern pattern(paint.type == NSVG_PAINT_LINEAR_GRADIENT ? EPatternType::Linear : EPatternType::Radial);
2834 switch (pGrad->spread)
2836 case NSVG_SPREAD_PAD: pattern.mExtend = EPatternExtend::Pad;
break;
2837 case NSVG_SPREAD_REFLECT: pattern.mExtend = EPatternExtend::Reflect;
break;
2838 case NSVG_SPREAD_REPEAT: pattern.mExtend = EPatternExtend::Repeat;
break;
2842 for (
int i = 0; i < pGrad->nstops; i++)
2844 unsigned int color = pGrad->stops[i].color;
2845 pattern.AddStop(
IColor(255, (color >> 0) & 0xFF, (color >> 8) & 0xFF, (color >> 16) & 0xFF), pGrad->stops[i].offset);
2849 pattern.SetTransform(pGrad->xform[0], pGrad->xform[1], pGrad->xform[2], pGrad->xform[3], pGrad->xform[4], pGrad->xform[5]);
2854 return IColor(alpha, 0, 0, 0);
2858void IGraphics::DoDrawSVG(
const ISVG& svg,
const IBlend* pBlend,
const IColor* pStrokeColor,
const IColor* pFillColor)
2862 svg.mSVGDom->render(canvas);
2864 NSVGimage* pImage = svg.mImage;
2866 assert(pImage !=
nullptr);
2868 for (NSVGshape* pShape = pImage->shapes; pShape; pShape = pShape->next)
2870 if (!(pShape->flags & NSVG_FLAGS_VISIBLE))
2877 for (NSVGpath* pPath = pShape->paths; pPath; pPath = pPath->next)
2881 for (
int i = 1; i < pPath->npts; i += 3)
2883 float *p = &pPath->pts[i*2];
2892 IVec2 p0{pPath->pts[0], pPath->pts[1]};
2893 IVec2 p1{pPath->bounds[0] - 1.0f, pPath->bounds[1] - 1.0f};
2895 for (NSVGpath *pPath2 = pShape->paths; pPath2; pPath2 = pPath2->next)
2897 if (pPath2 == pPath)
2900 if (pPath2->npts < 4)
2902 for (
int i = 1; i < pPath2->npts + 3; i += 3)
2904 float *p = &pPath2->pts[2*i];
2906 IVec2 p2 {p[-2], p[-1]};
2908 IVec2 p3 = (i < pPath2->npts) ?
IVec2{p[4], p[5]} :
IVec2{pPath2->pts[0], pPath2->pts[1]};
2909 float crossing = GetLineCrossing(p0, p1, p2, p3);
2910 float crossing2 = GetLineCrossing(p2, p3, p0, p1);
2911 if (0.0 <= crossing && crossing < 1.0 && 0.0 <= crossing2)
2921 if (pShape->fill.type != NSVG_PAINT_NONE)
2924 options.mFillRule = EFillRule::Preserve;
2926 options.mPreserve = pShape->stroke.type != NSVG_PAINT_NONE;
2927 PathFill(pFillColor ?
IPattern(*pFillColor) : GetSVGPattern(pShape->fill, pShape->opacity), options, pBlend);
2931 if (pShape->stroke.type != NSVG_PAINT_NONE)
2935 options.mMiterLimit = pShape->miterLimit;
2937 switch (pShape->strokeLineCap)
2939 case NSVG_CAP_BUTT: options.mCapOption = ELineCap::Butt;
break;
2940 case NSVG_CAP_ROUND: options.mCapOption = ELineCap::Round;
break;
2941 case NSVG_CAP_SQUARE: options.mCapOption = ELineCap::Square;
break;
2944 switch (pShape->strokeLineJoin)
2946 case NSVG_JOIN_MITER: options.mJoinOption = ELineJoin::Miter;
break;
2947 case NSVG_JOIN_ROUND: options.mJoinOption = ELineJoin::Round;
break;
2948 case NSVG_JOIN_BEVEL: options.mJoinOption = ELineJoin::Bevel;
break;
2951 options.mDash.SetDash(pShape->strokeDashArray, pShape->strokeDashOffset, pShape->strokeDashCount);
2953 PathStroke(pStrokeColor ?
IPattern(*pStrokeColor) : GetSVGPattern(pShape->stroke, pShape->opacity), pShape->strokeWidth, options, pBlend);
This file contains the base IControl implementation, along with some base classes for specific types ...
A collection of IControls for common UI widgets, such as knobs, sliders, switches.
const void * LoadWinResource(const char *resID, const char *type, int &sizeInBytes, void *pHInstance)
Load a resource from the binary (windows only).
EResourceLocation LocateResource(const char *fileNameOrResID, const char *type, WDL_String &result, const char *bundleID, void *pHInstance, const char *sharedResourcesSubPath)
Find the absolute path of a resource based on it's file name (e.g.
A Text entry widget drawn by IGraphics to optionally override platform text entries.
A base class interface for a bitmap abstraction around the different drawing back end bitmap represen...
float GetDrawScale() const
A basic control to draw a bitmap, or one frame of a stacked bitmap depending on the current value.
User-facing bitmap abstraction that you use to manage bitmap data, independant of draw class/platform...
bool GetFramesAreHorizontal() const
const WDL_String & GetResourceName() const
float GetDrawScale() const
APIBitmap * GetAPIBitmap() const
A special control to draw contextual info as a slider etc is moved If used in the main IControl stack...
The lowest level base class of an IGraphics control.
virtual bool GetWantsGestures() const
virtual void OnResize()
Called when IControl is constructed or resized using SetRect().
const char * GetGroup() const
Get the group that the control belongs to, if any.
int GetTextEntryLength() const
Get the max number of characters that are allowed in text entry.
virtual void OnDropMultiple(const std::vector< const char * > &paths)
Implement to handle multiple items drag 'n dropped onto this control.
virtual bool OnKeyUp(float x, float y, const IKeyPress &key)
Implement this method to respond to a key up event on this control.
virtual void OnMouseOut()
Implement this method to respond to a mouseout event on this control.
bool GetWantsMultiTouch() const
virtual void OnGUIIdle()
This is an idle timer tick call on the GUI thread, only active if USE_IDLE_CALLS is defined.
bool GetMouseEventsWhenDisabled() const
bool GetMouseOverWhenDisabled() const
virtual void OnMouseOver(float x, float y, const IMouseMod &mod)
Implement this method to respond to a mouseover event on this control.
virtual void SetPosition(float x, float y)
Set the position of the control, preserving the width and height.
void SetGroup(const char *groupName)
Assign the control to a control group.
virtual void OnPopupMenuSelection(IPopupMenu *pSelectedMenu, int valIdx)
Implement this method to handle popup menu selection after IGraphics::CreatePopupMenu/IControlPromptU...
virtual void OnMouseDown(float x, float y, const IMouseMod &mod)
Implement this method to respond to a mouse down event on this control.
virtual void SetValueFromUserInput(double value, int valIdx=0)
Set the control's value after user input.
virtual bool IsDirty()
Called at each display refresh by the IGraphics draw loop, after IControl::Animate(),...
virtual bool IsHit(float x, float y) const
Hit test the control.
virtual void Hide(bool hide)
Shows or hides the IControl.
virtual void OnRescale()
Implement to do something when graphics is scaled globally (e.g.
void SetDelegate(IGEditorDelegate &dlg)
Used internally to set the mDelegate (and mGraphics) variables.
virtual void OnDeleteFromPopupMenu(IPopupMenu *pMenu, int itemIdx)
Implement this method to handle popup menu deletion interactions (on IOS) after IGraphics::CreatePopu...
virtual void OnTouchCancelled(float x, float y, const IMouseMod &mod)
Implement this method to respond to a touch cancel event on this control.
virtual void OnDrop(const char *str)
Implement to do something when something was drag 'n dropped onto this control.
int GetParamIdx(int valIdx=0) const
Get the index of a parameter that the control is linked to Normaly controls are either linked to a si...
const IRECT & GetRECT() const
Get the rectangular draw area for this control, within the graphics context.
virtual bool OnKeyDown(float x, float y, const IKeyPress &key)
Implement this method to respond to a key down event on this control.
int LinkedToParam(int paramIdx) const
Check if the control is linked to a particular parameter.
bool GetIgnoreMouse() const
virtual void OnMouseDblClick(float x, float y, const IMouseMod &mod)
Implement this method to respond to a mouse double click event on this control.
int GetTag() const
Get the control's tag.
virtual void OnMouseUp(float x, float y, const IMouseMod &mod)
Implement this method to respond to a mouse up event on this control.
virtual void DrawPTHighlight(IGraphics &g)
Implement this to customise how a colored highlight is drawn on the control in ProTools (AAX format o...
virtual void CreateContextMenu(IPopupMenu &contextMenu)
Called by default when the user right clicks a control.
virtual void OnAttached()
Called after the control has been attached, and its delegate and graphics member variable set.
virtual bool OnGesture(const IGestureInfo &info)
virtual void OnMouseDrag(float x, float y, float dX, float dY, const IMouseMod &mod)
Implement this method to respond to a mouse drag event on this control.
virtual void OnMouseWheel(float x, float y, const IMouseMod &mod, float d)
Implement this method to respond to a mouse wheel event on this control.
virtual void Draw(IGraphics &g)=0
Draw the control to the graphics context.
const IParam * GetParam(int valIdx=0) const
Get a const pointer to the IParam object (owned by the editor delegate class), associated with this c...
const IText & GetText() const
Get the Text object for the control.
bool GetMouseDblAsSingleClick() const
Get double click as single click By default, mouse double click has its own handler.
virtual void SetSize(float w, float h)
Set the size of the control, preserving the current position.
void SetPTParameterHighlight(bool isHighlighted, int color)
Used internally by the AAX wrapper view interface to set the control parmeter highlight.
virtual void OnTextEntryCompletion(const char *str, int valIdx)
Implement this method to handle text input after IGraphics::CreateTextEntry/IControlPromptUserInput.
virtual void SetDisabled(bool disable)
Sets disabled mode for the control, the default implementation modifies the mBlend member.
double GetValue(int valIdx=0) const
Get the control's value.
void SetTargetAndDrawRECTs(const IRECT &bounds)
Set BOTH the draw rect and the target area, within the graphics context for this control.
virtual void OnContextSelection(int itemSelected)
Implement this to respond to a menu selection from CreateContextMenu();.
virtual int GetValIdxForPos(float x, float y) const
Check to see which of the control's values relates to this x and y coordinate.
IContainerBase * GetParent() const
virtual void SetDirty(bool triggerAction=true, int valIdx=kNoValIdx)
Mark the control as dirty, i.e.
bool GetPromptShowsParamLabel() const
A control for resizing the plug-in window by clicking and dragging in the bottom right-hand corner Th...
virtual void BeginInformHostOfParamChangeFromUI(int paramIdx)=0
Called by the UI at the beginning of a parameter change gesture, in order to notify the host (via a c...
virtual void EndInformHostOfParamChangeFromUI(int paramIdx)=0
Called by the user interface at the end of a parameter change gesture, in order to notify the host (v...
virtual void SendMidiMsgFromUI(const IMidiMsg &msg)
SendMidiMsgFromUI (Abbreviation: SMMFUI) This method should be used when sending a MIDI message from ...
virtual bool ConstrainEditorResize(int &w, int &h) const
Constrain the incoming editor width and height values based on the minimum and maximum.
virtual bool EditorResizeFromUI(int viewWidth, int viewHeight, bool needsPlatformResize)
If the editor changes UI dimensions, e.g.
An editor delegate base class that uses IGraphics for the UI.
virtual void LayoutUI(IGraphics *pGraphics)
Called to layout controls when the GUI is initially opened and again if the UI size changes.
bool ControlIsCaptured() const
Check to see if any control is captured.
void EnableTooltips(bool enable)
virtual float DoMeasureText(const IText &text, const char *str, IRECT &bounds) const =0
void Resize(int w, int h, float scale, bool needsPlatformResize=true)
virtual void DrawRotatedSVG(const ISVG &svg, float destCentreX, float destCentreY, float width, float height, double angle, const IBlend *pBlend=0)
Draw an SVG image to the graphics context with rotation.
virtual void DrawRect(const IColor &color, const IRECT &bounds, const IBlend *pBlend=0, float thickness=1.f)
Draw a rectangle to the graphics context.
virtual void FillEllipse(const IColor &color, const IRECT &bounds, const IBlend *pBlend=0)
Fill an ellipse within a rectangular region of the graphics context.
ILayer * PopLayer()
Pop a layer off the stack.
virtual void DrawConvexPolygon(const IColor &color, float *x, float *y, int nPoints, const IBlend *pBlend=0, float thickness=1.f)
Draw a convex polygon to the graphics context.
virtual void DrawEllipse(const IColor &color, const IRECT &bounds, const IBlend *pBlend=0, float thickness=1.f)
Draw an ellipse within a rectangular region of the graphics context.
virtual void DrawFittedBitmap(const IBitmap &bitmap, const IRECT &bounds, const IBlend *pBlend=0)
Draw a bitmap (raster) image to the graphics context, scaling the image to fit the bounds.
void DrawBitmapedText(const IBitmap &bitmap, const IRECT &bounds, IText &text, IBlend *pBlend, const char *str, bool vCenter=true, bool multiline=false, int charWidth=6, int charHeight=12, int charOffset=0)
Draws mono spaced bitmap text.
void AttachPopupMenuControl(const IText &text=DEFAULT_TEXT, const IRECT &bounds=IRECT())
Attach a control for pop-up menus, to override platform style menus.
virtual void DrawPoint(const IColor &color, float x, float y, const IBlend *pBlend=0)
Fill a rectangle corresponding to a pixel on a 1:1 screen with a color.
void RemoveControl(int idx)
Remove a control at a particular index, (frees memory).
void DeleteFromPopupMenu(IPopupMenu *pMenu, int itemIdx)
Called by IOS platform (or other supported platforms) in order to update a control with a deletion in...
virtual const char * GetBundleID() const
Get the bundle ID on macOS and iOS, returns emtpy string on other OSs.
void PathConvexPolygon(float *x, float *y, int nPoints)
Add a convex polygon to the current path.
virtual void PathFill(const IPattern &pattern, const IFillOptions &options=IFillOptions(), const IBlend *pBlend=0)=0
Fill the current current path.
virtual float GetPlatformWindowScale() const
Returns a scaling factor for resizing parent windows via the host/plugin API.
void DrawText(const IText &text, const char *str, const IRECT &bounds, const IBlend *pBlend=0)
Draw some text to the graphics context in a specific rectangle.
float GetTotalScale() const
Gets the combined draw and screen/display scaling factor.
int GetParamIdxForPTAutomation(float x, float y)
[AAX only] This can be called by the ProTools API class (e.g.
void CreatePopupMenu(IControl &control, IPopupMenu &menu, const IRECT &bounds, int valIdx=0)
Shows a pop up/contextual menu in relation to a rectangular region of the graphics context.
void CreateTextEntry(IControl &control, const IText &text, const IRECT &bounds, const char *str="", int valIdx=0)
Create a text entry box.
virtual void PathClear()=0
Clear the stack of path drawing commands.
virtual void * GetDrawContext()=0
Gets a void pointer to underlying drawing context, for the IGraphics backend See draw class implement...
void PathRoundRect(const IRECT &bounds, float ctl, float ctr, float cbl, float cbr)
Add a rounded rectangle to the current path, with independent corner roundness.
void SetPTParameterHighlight(int paramIdx, bool isHighlighted, int color)
[AAX only] See AAX_CEffectGUI::SetControlHighlightInfo()
virtual void PathClose()=0
Close the path that is being specified.
void PathTransformTranslate(float x, float y)
Apply a translation transform to the current path.
void ClearInTextEntryControl()
Called when the text entry is dismissed, to reset mInTextEntry.
void DrawRadialLine(const IColor &color, float cx, float cy, float angle, float rMin, float rMax, const IBlend *pBlend=0, float thickness=1.f)
Draw a radial line to the graphics context, useful for pointers on dials.
void PathRect(const IRECT &bounds)
Add a rectangle to the current path.
virtual void RetainBitmap(const IBitmap &bitmap, const char *cacheName)
Adds an IBitmap to the cache/static storage.
void ForMatchingControls(T method, int paramIdx, Args... args)
For all standard controls in the main control stack that are linked to a specific parameter,...
virtual void CreatePlatformTextEntry(int paramIdx, const IText &text, const IRECT &bounds, int length, const char *str)=0
Creates a platform native text entry field.
void ResumeLayer(ILayerPtr &layer)
If a layer already exists, continue drawing to it.
void PathTransformMatrix(const IMatrix &matrix)
Apply an arbitary affine transform matrix to the current path.
void DrawRotatedLayer(const ILayerPtr &layer, double angle)
Draw a layer to the main IGraphics context, with rotation.
void PathTransformScale(float x, float y)
Apply a scale transform to the current path, with independant x, y scales.
virtual ECursor SetMouseCursor(ECursor cursorType=ECursor::ARROW)
Sets the mouse cursor to one of ECursor (implementations should return the result of the base impleme...
void PathLine(float x1, float y1, float x2, float y2)
Add a line to the current path.
virtual void DrawDottedRect(const IColor &color, const IRECT &bounds, const IBlend *pBlend=0, float thickness=1.f, float dashLen=2.f)
Draw a dotted rectangle to the graphics context.
IControl * GetControlWithTag(int ctrlTag) const
Get the control with a particular tag.
virtual void PathSetWinding(bool clockwise)
NanoVG only.
void OnMouseDrag(const std::vector< IMouseInfo > &points)
Called when the platform class sends drag events.
virtual void ReleaseBitmap(const IBitmap &bitmap)
Releases an IBitmap from the cache/static storage.
virtual void DrawRoundRect(const IColor &color, const IRECT &bounds, float cornerRadius=5.f, const IBlend *pBlend=0, float thickness=1.f)
Draw a rounded rectangle to the graphics context.
void OnMouseOut()
Called when the mouse leaves the graphics context.
void UpdatePeers(IControl *pCaller, int callerValIdx)
This method is called after interacting with a control, so that any other controls linked to the same...
void RemovePopupMenuControl()
Remove the IGraphics popup menu, use platform popup menu if available.
virtual float GetBackingPixelScale() const
virtual void DrawRotatedBitmap(const IBitmap &bitmap, float destCentreX, float destCentreY, double angle, const IBlend *pBlend=0)
Draw a bitmap (raster) image to the graphics context with rotation.
bool OnKeyDown(float x, float y, const IKeyPress &key)
virtual int AlphaChannel() const =0
void AttachGestureRecognizerToRegion(const IRECT &bounds, EGestureType type, IGestureFunc func)
Attach a gesture recognizer to a rectangular region of the GUI, i.e.
bool MultiTouchEnabled() const
int Width() const
Gets the width of the graphics context.
virtual void EndFrame()
Called by some drawing API classes to finally blit the draw bitmap onto the screen or perform other c...
void DisableControl(int paramIdx, bool diable)
Disable or enable controls linked to a specific parameter.
void SetControlBounds(IControl *pControl, const IRECT &r)
Set a controls target and draw rect to r, redrawing the interface correctly.
void PathTriangle(float x1, float y1, float x2, float y2, float x3, float y3)
Add a triangle to the current path.
void DoMeasureTextRotation(const IText &text, const IRECT &bounds, IRECT &rect) const
void AttachTextEntryControl()
Attach a control for text entry, to override platform text entry.
void AttachCornerResizer(EUIResizerMode sizeMode=EUIResizerMode::Scale, bool layoutOnResize=false, const IColor &color=COLOR_TRANSLUCENT, const IColor &mouseOverColor=COLOR_BLACK, const IColor &dragColor=COLOR_BLACK, float size=20.f)
Attach the default control to scale or increase the UI size by dragging the plug-in bottom right-hand...
virtual void AttachGestureRecognizer(EGestureType type)
Registers a gesture recognizer with the graphics context.
virtual APIBitmap * CreateAPIBitmap(int width, int height, float scale, double drawScale, bool cacheable=false)=0
Creates a new API bitmap, either in memory or as a GPU texture.
void OnMouseUp(const std::vector< IMouseInfo > &points)
Called when the platform class sends mouse up events.
void PathTransformReset(bool clearStates=false)
Reset the affine transform of the current path, to the default state.
void OnAppearanceChanged(EUIAppearance appearance)
Called by the platform class if the view changes to dark/light mode.
void CalculateTextRotation(const IText &text, const IRECT &bounds, IRECT &rect, double &tx, double &ty) const
bool IsInPlatformTextEntry()
virtual void PathStroke(const IPattern &pattern, float thickness, const IStrokeOptions &options=IStrokeOptions(), const IBlend *pBlend=0)=0
Stroke the current current path.
bool CheckLayer(const ILayerPtr &layer)
Test to see if a layer needs drawing, for instance if the control's bounds were changed.
int WindowWidth() const
Gets the width of the graphics context including draw scaling.
void Draw(IRECTList &rects)
Called by the platform class indicating a number of rectangles in the UI that need to redraw.
EResourceLocation SearchImageResource(const char *fileName, const char *type, WDL_String &result, int targetScale, int &sourceScale)
Search for a bitmap image resource matching the target scale.
IControl * GetControlWithParamIdx(int paramIdx)
Get the first control with a parameter index that matches paramIdx.
virtual void ApplyShadowMask(ILayerPtr &layer, RawBitmapData &mask, const IShadow &shadow)=0
Implemented by a graphics backend to apply a calculated shadow mask to a layer, according to the shad...
void EnableLiveEdit(bool enable)
Live edit mode allows you to relocate controls at runtime in debug builds.
void PathTransformRestore()
Restore the affine transform of the current path, to the previously saved state.
void SetControlValueAfterPopupMenu(IPopupMenu *pMenu)
Called by PopupMenuControl in order to update a control with a new value after returning from the non...
void DrawLayer(const ILayerPtr &layer, const IBlend *pBlend=nullptr)
Draw a layer to the main IGraphics context.
void PushLayer(ILayer *pLayer)
Push a layer on to the stack.
void ReleaseMouseCapture()
Used to tell the graphics context to stop tracking mouse interaction with a control.
int GetLastClickedParamForPTAutomation()
[AAX only]
void ForControlWithParam(int paramIdx, IControlFunction func)
For all standard controls in the main control stack that are linked to a specific parameter,...
void AttachBubbleControl(const IText &text=DEFAULT_TEXT)
Attach the default control to show text as a control changes.
EUIResizerMode GetResizerMode() const
virtual void FillRect(const IColor &color, const IRECT &bounds, const IBlend *pBlend=0)
Fill a rectangular region of the graphics context with a color.
int GetRoundedScreenScale() const
Gets the screen/display scaling factor, rounded up.
APIBitmap * SearchBitmapInCache(const char *fileName, int targetScale, int &sourceScale)
Search the static storage cache for a bitmap image resource matching the target scale.
virtual void DrawLine(const IColor &color, float x1, float y1, float x2, float y2, const IBlend *pBlend=0, float thickness=1.f)
Draw a line to the graphics context.
virtual void DrawArc(const IColor &color, float cx, float cy, float r, float a1, float a2, const IBlend *pBlend=0, float thickness=1.f)
Draw an arc to the graphics context.
void OnTouchCancelled(const std::vector< IMouseInfo > &points)
Called when the platform class sends touch cancel events.
bool OnMouseOver(float x, float y, const IMouseMod &mod)
void OnDragResize(float x, float y)
Called by ICornerResizerControl as the corner is dragged to resize.
virtual PlatformFontPtr LoadPlatformFont(const char *fontID, const char *fileNameOrResID)=0
Load a font from disk or resource in a platform format.
void ForAllControlsFunc(IControlFunction func)
For all controls, including the "special controls" call a method.
void HideControl(int paramIdx, bool hide)
Hide controls linked to a specific parameter.
virtual bool LoadFont(const char *fontID, const char *fileNameOrResID)
Load a font to be used by the graphics context.
virtual bool BitmapExtSupported(const char *ext)=0
Checks a file extension and reports whether this drawing API supports loading that extension.
void RemoveAllControls()
Removes all regular IControls from the control list, as well as special controls (frees memory).
virtual void DrawCircle(const IColor &color, float cx, float cy, float r, const IBlend *pBlend=0, float thickness=1.f)
Draw a circle to the graphics context.
void OnMouseDown(const std::vector< IMouseInfo > &points)
Called when the platform class sends mouse down events.
int Height() const
Gets the height of the graphics context.
void PathClipRegion(const IRECT r=IRECT())
Clip the current path to a particular region.
void PathCircle(float cx, float cy, float r)
Add a circle to the current path.
void PathRadialLine(float cx, float cy, float angle, float rMin, float rMax)
Add a radial line to the current path.
void PathTransformRotate(float angle)
Apply a rotation transform to the current path.
bool OnKeyUp(float x, float y, const IKeyPress &key)
bool IsDirty(IRECTList &rects)
Called repeatedly at frame rate by the platform class to check what the graphics context says is dirt...
virtual void FillRoundRect(const IColor &color, const IRECT &bounds, float cornerRadius=5.f, const IBlend *pBlend=0)
Fill a rounded rectangle with a color.
virtual void GetLayerBitmapData(const ILayerPtr &layer, RawBitmapData &data)=0
Get the contents of a layer as Raw RGBA bitmap data NOTE: you should only call this within IControl::...
bool RespondsToGesture(float x, float y)
Called by platform class to see if the point at x, y is linked to a gesture recognizer.
void ForAllControls(T method, Args... args)
For all controls, including the "special controls" call a method.
void ClearGestureRegions()
Remove all gesture recognizers linked to regions.
void SetControlValueAfterTextEdit(const char *str)
Called by the platform class after returning from a text entry in order to update a control with a ne...
virtual void * GetWinModuleHandle()
virtual void UpdateLayer()
Implemented by a graphics backend to prepare for drawing to the layer at the top of the stack.
virtual void DrawData(const IColor &color, const IRECT &bounds, float *normYPoints, int nPoints, float *normXPoints=nullptr, const IBlend *pBlend=0, float thickness=1.f, const IColor *pFillColor=nullptr)
Draw a line between a collection of normalized points.
void SetQwertyMidiKeyHandlerFunc(std::function< void(const IMidiMsg &msg)> func=nullptr)
A helper to set the IGraphics KeyHandlerFunc in order to make an instrument playable via QWERTY keys.
void AttachSVGBackground(const char *fileName)
Attach an ISVGControl as the lowest IControl in the control stack to be the background for the graphi...
virtual void FillTriangle(const IColor &color, float x1, float y1, float x2, float y2, float x3, float y3, const IBlend *pBlend=0)
Fill a triangle with a color.
void ApplyLayerDropShadow(ILayerPtr &layer, const IShadow &shadow)
Applies a drop shadow directly onto a layer.
virtual void DrawGrid(const IColor &color, const IRECT &bounds, float gridSizeH, float gridSizeV, const IBlend *pBlend=0, float thickness=1.f)
Draw a grid to the graphics context.
void SetAllControlsDirty()
Calls SetDirty() on every control.
virtual IBitmap ScaleBitmap(const IBitmap &inBitmap, const char *cacheName, int targetScale)
Returns a new IBitmap, an integer scaled version of the input, and adds it to the cache.
IControl * GetControlInTextEntry()
IBitmap GetScaledBitmap(IBitmap &inBitmap)
Get a version of the input bitmap from the cache that corresponds to the current screen scale For exa...
void AttachPanelBackground(const IPattern &color)
Attach an IPanelControl as the lowest IControl in the control stack to fill the background with a sol...
virtual void FillConvexPolygon(const IColor &color, float *x, float *y, int nPoints, const IBlend *pBlend=0)
Fill a convex polygon with a color.
bool OnMouseWheel(float x, float y, const IMouseMod &mod, float delta)
void SetAllControlsClean()
Calls SetClean() on every control.
void StyleAllVectorControls(const IVStyle &style)
Helper method to style all of the controls which inherit IVectorBase.
virtual IPopupMenu * CreatePlatformPopupMenu(IPopupMenu &menu, const IRECT bounds, bool &isAsync)=0
Calls the platform backend to create the platform popup menu.
void RemoveControlWithTag(int ctrlTag)
Remove controls from the control list with a particular tag.
void GetTouches(IControl *pControl, std::vector< ITouchID > &touchesOnThisControl) const
Populate a vector with the touchIDs active on pControl.
void DrawVerticalLine(const IColor &color, const IRECT &bounds, float x, const IBlend *pBlend=0, float thickness=1.f)
Draw a vertical line, within a rectangular region of the graphics context.
virtual void PathMoveTo(float x, float y)=0
Move the current point in the current path.
virtual void PathArc(float cx, float cy, float r, float a1, float a2, EWinding winding=EWinding::CW)=0
Add an arc to the current path.
void PopupHostContextMenuForParam(int controlIdx, int paramIdx, float x, float y)
[VST3 primarily] In VST3 plug-ins this enable support for the IContextMenu interface,...
virtual bool FlippedBitmap() const =0
void PromptUserInput(IControl &control, const IRECT &bounds, int valIdx=0)
Prompt for user input either using a text entry or pop up menu.
void SetControlSize(IControl *pControl, float w, float h)
Resize a control, redrawing the interface correctly.
float GetScreenScale() const
Gets the screen/display scaling factor, e.g.
virtual bool LoadAPIFont(const char *fontID, const PlatformFontPtr &font)=0
Drawing API method to load a font from a PlatformFontPtr, called internally.
void OnDropMultiple(const std::vector< const char * > &paths, float x, float y)
void AssignParamNameToolTips()
Call this method in order to create tool tips for every IControl that show the associated parameter's...
virtual ISVG LoadSVG(const char *fileNameOrResID, const char *units="px", float dpi=72.f)
Load an SVG from disk or from windows resource.
virtual APIBitmap * LoadAPIBitmap(const char *fileNameOrResID, int scale, EResourceLocation location, const char *ext)=0
Drawing API method to load a bitmap, called internally.
virtual void HideMouseCursor(bool hide=true, bool lock=true)=0
Call to hide/show the mouse cursor.
void SetScaleConstraints(float lo, float hi)
Sets the minimum and maximum (draw) scaling values.
void DrawHorizontalLine(const IColor &color, const IRECT &bounds, float y, const IBlend *pBlend=0, float thickness=1.f)
Draw a horizontal line, within a rectangular region of the graphics context.
void ForControlInGroup(const char *group, IControlFunction func)
For all standard controls in the main control stack that are linked to a group, execute a function.
virtual void DoDrawText(const IText &text, const char *str, const IRECT &bounds, const IBlend *pBlend=nullptr)=0
void PathTransformSave()
Save the current affine transform of the current path.
virtual void FillArc(const IColor &color, float cx, float cy, float r, float a1, float a2, const IBlend *pBlend=0)
Fill an arc segment with a color.
void SetKeyHandlerFunc(IKeyHandlerFunc func)
Set a function that is called when key presses are not intercepted by any controls.
virtual void DrawDottedLine(const IColor &color, float x1, float y1, float x2, float y2, const IBlend *pBlend=0, float thickness=1.f, float dashLen=2.f)
Draw a dotted line to the graphics context.
void RemoveTextEntryControl()
Remove the IGraphics text entry, use platform text entry if available.
void ShowFPSDisplay(bool enable)
Shows a control to display the frame rate of drawing.
virtual void PathLineTo(float x, float y)=0
Add a line to the current path from the current point to the specified location.
void DrawLineAcross(const IColor &color, const IRECT &bounds, EDirection dir, float pos, const IBlend *pBlend=0, float thickness=1.f)
Draw a horzional or vertical line, within a rectangular region of the graphics context.
const char * GetSharedResourcesSubPath() const
Gets the name of the shared resources subpath.
void PathTransformSkew(float xAngle, float yAngle)
Apply a skew transform to the current path.
float GetDrawScale() const
Gets the graphics context scaling factor.
void DrawFittedLayer(const ILayerPtr &layer, const IRECT &bounds, const IBlend *pBlend)
Draw a layer to the main IGraphics context, fitting it to a rectangle that is different to the layer'...
void RemoveControls(int fromIdx)
Remove controls from the control list above a particular index, (frees memory).
void AttachBackground(const char *fileName)
Attach an IBitmapControl as the lowest IControl in the control stack to be the background for the gra...
void SetStrictDrawing(bool strict)
Enables strict drawing mode.
void OnGUIIdle()
This is an idle timer tick call on the GUI thread, only active if USE_IDLE_CALLS is defined.
IGEditorDelegate * GetDelegate()
Gets a pointer to the delegate class that handles communication to and from this graphics context.
IControl * GetControl(int idx)
Get the control at a certain index in the control stack.
void StartLayer(IControl *pOwner, const IRECT &r, bool cacheable=false)
Create an IGraphics layer.
void OnGestureRecognized(const IGestureInfo &info)
Called by platform class when a gesture is recognized.
virtual void CachePlatformFont(const char *fontID, const PlatformFontPtr &font)=0
Called to indicate that the platform should cache data about the platform font if needed.
bool OnMouseDblClick(float x, float y, const IMouseMod &mod)
virtual void DrawSVG(const ISVG &svg, const IRECT &bounds, const IBlend *pBlend=0, const IColor *pStrokeColor=nullptr, const IColor *pFillColor=nullptr)
Draw an SVG image to the graphics context.
void ForStandardControlsFunc(IControlFunction func)
For all standard controls in the main control stack perform a function.
virtual void DrawTriangle(const IColor &color, float x1, float y1, float x2, float y2, float x3, float y3, const IBlend *pBlend=0, float thickness=1.f)
Draw a triangle to the graphics context.
virtual void PathCubicBezierTo(float c1x, float c1y, float c2x, float c2y, float x2, float y2)=0
Add a cubic bezier to the current path from the current point to the specified location.
int WindowHeight() const
Gets the height of the graphics context including draw scaling.
void PathEllipse(const IRECT &bounds)
Add an ellipse to the current path, specifying the rectangular region.
virtual IBitmap LoadBitmap(const char *fileNameOrResID, int nStates=1, bool framesAreHorizontal=false, int targetScale=0)
Load a bitmap image from disk or from windows resource.
virtual void BeginFrame()
Called at the beginning of drawing.
virtual void FillCircle(const IColor &color, float cx, float cy, float r, const IBlend *pBlend=0)
Fill a circle with a color.
void SetControlPosition(IControl *pControl, float x, float y)
Reposition a control, redrawing the interface correctly.
void SetScreenScale(float scale)
Called by the platform IGraphics class when moving to a new screen to set DPI.
ILayerPtr EndLayer()
End an IGraphics layer.
virtual WDL_TypedBuf< uint8_t > LoadResource(const char *fileNameOrResID, const char *fileType)
Load a resource from the file system, the bundle, or a Windows resource, and returns its data.
void OnDrop(const char *str, float x, float y)
IRECT GetBounds() const
Returns an IRECT that represents the entire UI bounds This is useful for programatically arranging UI...
IControl * AttachControl(IControl *pControl, int ctrlTag=kNoTag, const char *group="")
Attach an IControl to the graphics context and add it to the top of the control stack.
virtual void DrawBitmap(const IBitmap &bitmap, const IRECT &bounds, int srcX, int srcY, const IBlend *pBlend=0)=0
Draw a bitmap (raster) image to the graphics context.
virtual float MeasureText(const IText &text, const char *str, IRECT &bounds) const
Measure the rectangular region that some text will occupy.
An abstraction that is used to store a temporary raster image/framebuffer.
const IRECT & Bounds() const
A basic control to fill a rectangle with a color or gradient.
EParamType Type() const
Get the parameter's type.
double ToNormalized(double nonNormalizedValue) const
Convert a real value to normalized value for this parameter.
void GetDisplay(WDL_String &display, bool withDisplayText=true) const
Get the current textual display for the current parameter value.
const char * GetLabel() const
Returns the parameter's label.
double StringToValue(const char *str) const
Convert a textual representation of the parameter value to a double (real value)
const char * GetName() const
Returns the parameter's name.
const char * GetDisplayText(double value) const
Get the display text for a particular value.
int NDisplayTexts() const
Get the number of display texts for the parameter.
EParamType
Defines types or parameter.
Used to manage a list of rectangular areas and optimize them for drawing to the screen.
void Clear()
Clear the list.
IRECT Bounds()
Get a union of all rectangles in the list.
void Add(const IRECT &rect)
Add a rectangle to the list.
void PixelAlign()
Align the rectangles to pixel boundaries.
void Optimize()
Remove rects that are contained by other rects and intersections and merge any rects that can be merg...
int Find(float x, float y) const
Find the first index of the rect that contains point x, y, if it exists.
const IRECT & Get(int idx) const
Get an IRECT from the list (will crash if idx is invalid)
A basic control to draw an SVG image to the screen.
A base interface to be combined with IControl for vectorial controls "IVControls",...
virtual void SetStyle(const IVStyle &style)
Set the Style of this IVControl.
std::unique_ptr< ILayer > ILayerPtr
ILayerPtr is a managed pointer for transferring the ownership of layers.
Used to describe a particular gesture.
Used to group mouse coordinates with mouse modifier information.
Used to manage stroke behaviour for path based drawing back ends.
BEGIN_IPLUG_NAMESPACE T Clip(T x, T lo, T hi)
Clips the value x between lo and hi.
Used to manage composite/blend operations, independent of draw class/platform.
Used to manage color data, independent of draw class/platform.
void Randomise(int alpha=255)
Randomise the color parts, with optional alpha.
Used to manage fill behaviour.
Used for key press info, such as ASCII representation, virtual key (mapped to win32 codes) and modifi...
Used to store transformation matrices.
IMatrix & Rotate(float a)
Set the matrix for a rotation transform.
IMatrix & Scale(float x, float y)
Set the matrix for a scale transform.
IMatrix & Transform(const IRECT &before, const IRECT &after)
IMatrix & Translate(float x, float y)
Set the matrix for a translation transform.
IMatrix & Skew(float xa, float ya)
Set the matrix for a skew transform.
void TransformPoint(double &x, double &y, double x0, double y0) const
Transforms the point x, y.
Encapsulates a MIDI message and provides helper functions.
void MakeNoteOnMsg(int noteNumber, int velocity, int offset, int channel=0)
Make a Note On message.
void MakeNoteOffMsg(int noteNumber, int offset, int channel=0)
Make a Note Off message.
Used to manage mouse modifiers i.e.
Used to store pattern information for gradients.
Used to manage a rectangular area, independent of draw class/platform.
IRECT Intersect(const IRECT &rhs) const
Create a new IRECT that is the intersection of this IRECT and rhs.
IRECT GetPixelAligned() const
Get a copy of this IRECT with PixelAlign() called.
void PixelAlign()
Pixel aligns the rect in an inclusive manner (moves all points outwards)
void Clank(const IRECT &rhs)
Clank will limit this IRECT's bounds based on the boundaries of the IRECT passed in as an argument.
IRECT Union(const IRECT &rhs) const
Create a new IRECT that is a union of this IRECT and rhs.
bool Intersects(const IRECT &rhs) const
Returns true if this IRECT shares any common pixels with rhs, false otherwise.
void Translate(float x, float y)
Translate this rectangle.
bool Contains(const IRECT &rhs) const
Returns true if this IRECT completely contains rhs.
IRECT GetPadded(float padding) const
Get a copy of this IRECT with each value padded by padding N.B.
User-facing SVG abstraction that you use to manage SVG data ISVG doesn't actually own the image data.
Used to specify properties of a drop-shadow to a layer.
IText is used to manage font and text/text entry style for a piece of text on the UI,...
A struct encapsulating a set of properties used to configure IVControls.
Encapsulate an xy point in one struct.