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;
284 mControls.Insert(0, pBG);
291 mControls.Insert(0, pBG);
298 mControls.Insert(0, pBG);
305 auto result = mCtrlTags.insert(std::make_pair(ctrlTag, pControl));
306 assert(result.second &&
"AttachControl failed: ctrl tags must be unique");
314 mControls.Add(pControl);
328 assert(!mCornerResizer);
330 std::unique_ptr<ICornerResizerControl> control(pControl);
334 mCornerResizer.swap(control);
335 mGUISizeMode = sizeMode;
336 mLayoutOnResize = layoutOnResize;
340DBGMSG(
"AttachCornerResizer() is disabled for AUv3");
353 mBubbleControls.Add(pControl);
360 mPopupControl = std::make_unique<IPopupMenuControl>(kNoParameter, text,
IRECT(), bounds);
367 mPopupControl =
nullptr;
372 if (!mTextEntryControl)
374 mTextEntryControl = std::make_unique<ITextEntryControl>();
381 mTextEntryControl =
nullptr;
384void IGraphics::ShowBubbleControl(
IControl* pCaller,
float x,
float y,
const char* str, EDirection dir,
IRECT minimumContentBounds)
386 assert(mBubbleControls.GetSize() &&
"No bubble controls attached");
390 std::vector<ITouchID> touchIDsForCaller;
392 std::vector<IBubbleControl*> availableBubbleControls;
393 int nBubbleControls = mBubbleControls.GetSize();
395 if(touchIDsForCaller.size() == 1)
397 ITouchID touchID = touchIDsForCaller[0];
400 for(
int i=0;i<nBubbleControls;i++)
403 if(pBubbleControl->GetTouchID() == touchID)
405 pBubbleControl->ShowBubble(pCaller, x, y, str, dir, minimumContentBounds, touchID);
409 availableBubbleControls.push_back(pBubbleControl);
412 if(availableBubbleControls.size())
415 static int whichBubbleControl = 0;
416 availableBubbleControls[whichBubbleControl++]->ShowBubble(pCaller, x, y, str, dir, minimumContentBounds, touchID);
417 whichBubbleControl %= nBubbleControls;
426 mBubbleControls.Get(0)->ShowBubble(pCaller, x, y, str, dir, minimumContentBounds);
435 mPerfDisplay = std::make_unique<IFPSDisplayControl>(
GetBounds().GetPadded(-10).GetFromTLHC(200, 50));
441 mPerfDisplay =
nullptr;
450 const auto it = mCtrlTags.find(ctrlTag);
452 if (it != mCtrlTags.end())
458 assert(
"There is no control attached with this tag");
508 for (
auto param : params)
525 if (CStringHasContents(pControl->
GetGroup()))
527 if (strcmp(pControl->
GetGroup(), group) == 0)
545 func(mPerfDisplay.get());
549 func(mLiveEdit.get());
553 func(mCornerResizer.get());
555 if (mTextEntryControl)
556 func(mTextEntryControl.get());
559 func(mPopupControl.get());
561 if (mBubbleControls.GetSize())
563 for(
int i = 0;i<mBubbleControls.GetSize();i++)
565 func(mBubbleControls.Get(i));
570template<
typename T,
typename... Args>
576template<
typename T,
typename... Args>
596 if (pControl->GetParamIdx() > kNoParameter)
597 pControl->SetTooltip(pControl->GetParam()->GetName());
605 double value = pCaller->
GetValue(callerValIdx);
608 auto func = [pCaller, paramIdx, value](
IControl* pControl)
610 int valIdx = pControl->LinkedToParam(paramIdx);
613 if ((valIdx > kNoValIdx) && (pControl != pCaller))
615 pControl->SetValueFromDelegate(value, valIdx);
624 assert(valIdx > kNoValIdx);
632 WDL_String currentText;
634 if ( type == IParam::kTypeEnum || (type == IParam::kTypeBool && nDisplayTexts))
637 mPromptPopupMenu.Clear();
640 for (
int i = 0; i < nDisplayTexts; ++i)
644 if (!strcmp(str, currentText.Get()))
645 mPromptPopupMenu.AddItem(
new IPopupMenu::Item(str, IPopupMenu::Item::kChecked), -1 );
649 mPromptPopupMenu.SetRootTitle(pParam->
GetName());
661 currentText.Append(
" ");
662 currentText.Append(pParam->
GetLabel());
672 if (!str || str[0] ==
'\0')
680 if (!str || str[0] ==
'\0')
688 IRECT bounds = { x, y, x, y };
689 DrawText(text, str, bounds, pBlend);
697 bmpState =
Clip(bmpState, 1, bitmap.
N());
699 if (bitmap.
N() > 1 && bmpState > 1)
703 srcX = bitmap.
W() * (bmpState - 1) / bitmap.
N();
707 srcY = bitmap.
H() * (bmpState - 1) / bitmap.
N();
711 return DrawBitmap(bitmap, bounds, srcX, srcY, pBlend);
716 if (CStringHasContents(str))
718 int stringLength = (int) strlen(str);
720 float basicYOffset = 0.;
721 float basicXOffset = 0.;
724 basicYOffset = bounds.T + ((bounds.
H() - charHeight) / 2.f);
726 basicYOffset = bounds.T;
728 if (text.mAlign == EAlign::Center)
729 basicXOffset = bounds.L + ((bounds.
W() - (stringLength * charWidth)) / 2.f);
730 else if (text.mAlign == EAlign::Near)
731 basicXOffset = bounds.L;
732 else if (text.mAlign == EAlign::Far)
733 basicXOffset = bounds.R - (stringLength * charWidth);
735 int widthAsOneLine = charWidth * stringLength;
740 int nCharsThatFitIntoLine;
744 if (widthAsOneLine > bounds.
W())
746 nCharsThatFitIntoLine = int(bounds.
W() / (
float)charWidth);
747 nLines = int(
float(widthAsOneLine) / bounds.
W()) + 1;
751 nCharsThatFitIntoLine = stringLength;
757 nCharsThatFitIntoLine = int(bounds.
W() / (
float) charWidth);
761 for (
int line=0; line<nLines; line++)
763 float yOffset = basicYOffset + line * charHeight;
765 for (
int linepos=0; linepos<nCharsThatFitIntoLine; linepos++)
767 if (str[stridx] ==
'\0')
return;
769 int frameOffset = (int) str[stridx++] - 31;
771 float xOffset = ((float) linepos * ((
float) charWidth + (float) charOffset)) + basicXOffset;
772 IRECT charRect =
IRECT(xOffset, yOffset, xOffset + charWidth, yOffset + charHeight);
773 DrawBitmap(bitmap, charRect, frameOffset, pBlend);
781 if (dir == EDirection::Horizontal)
789 x =
Clip(x, 0.0f, 1.0f);
790 float xi = bounds.L + int(x * (bounds.R - bounds.L));
796 y =
Clip(y, 0.0f, 1.0f);
797 float yi = bounds.B - (y * (float) (bounds.B - bounds.T));
803 DrawLine(color, xi, yLo, xi, yHi, pBlend, thickness);
808 DrawLine(color, xLo, yi, xHi, yi, pBlend, thickness);
814 RadialPoints(angle, cx, cy, rMin, rMax, 2, data);
815 DrawLine(color, data[0][0], data[0][1], data[1][0], data[1][1], pBlend, thickness);
821 RadialPoints(angle, cx, cy, rMin, rMax, 2, data);
822 PathLine(data[0][0], data[0][1], data[1][0], data[1][1]);
827 if (mDisplayTickFunc)
834 auto func = [&dirty, &rects](
IControl* pControl) {
845 rects.
Add(rectToAdd);
857 else if (++mIdleTicks > IDLE_TICKS)
871 const double timestamp = GetTimestamp();
872 const double timeDiff = timestamp - mPrevTimestamp;
873 mPerfDisplay->Update((
float) timeDiff);
874 mPrevTimestamp = timestamp;
879void IGraphics::DrawControl(
IControl* pControl,
const IRECT& bounds,
float scale)
887 if (clipBounds.
W() <= 0.0 || clipBounds.
H() <= 0)
899 clipBounds.
Clank(parentBounds);
904 PrepareRegion(clipBounds);
905 pControl->
Draw(*
this);
911 if (mShowControlBounds)
913 PrepareRegion(clipBounds);
918 CompleteRegion(clipBounds);
929 PrepareRegion(bounds);
933 CompleteRegion(bounds);
958 for (
auto i = 0; i < rects.
Size(); i++)
975 bool singlePoint = points.size() == 1;
979 mMouseDownX = points[0].x;
980 mMouseDownY = points[0].y;
983 for (
auto& point : points)
989 IControl* pCapturedControl = GetMouseControl(x, y,
true,
false, mod.touchID);
991 if (pCapturedControl)
993 int nVals = pCapturedControl->
NVals();
994#if defined AAX_API || !defined IGRAPHICS_NO_CONTEXT_MENU
996 int paramIdx = pCapturedControl->
GetParamIdx((valIdx > kNoValIdx) ? valIdx : 0);
1000 if (mAAXViewContainer && paramIdx > kNoParameter)
1002 auto GetAAXModifiersFromIMouseMod = [](
const IMouseMod& mod) {
1003 uint32_t modifiers = 0;
1005 if (mod.A) modifiers |= AAX_eModifiers_Option;
1008 if (mod.C) modifiers |= AAX_eModifiers_Command;
1010 if (mod.C) modifiers |= AAX_eModifiers_Control;
1011 if (mod.R) modifiers |= AAX_eModifiers_Command;
1013 if (mod.S) modifiers |= AAX_eModifiers_Shift;
1014 if (mod.R) modifiers |= AAX_eModifiers_SecondaryButton;
1019 uint32_t aaxModifiersForPT = GetAAXModifiersFromIMouseMod(mod);
1022 uint32_t aaxModifiersFromPT = 0;
1023 mAAXViewContainer->GetModifiers(&aaxModifiersFromPT);
1024 aaxModifiersForPT |= aaxModifiersFromPT;
1027 paramID.SetFormatted(32,
"%i", paramIdx+1);
1029 if (mAAXViewContainer->HandleParameterMouseDown(paramID.Get(), aaxModifiersForPT) == AAX_SUCCESS)
1037#ifndef IGRAPHICS_NO_CONTEXT_MENU
1038 if (mod.R && paramIdx > kNoParameter)
1046 for (
int v = 0; v < nVals; v++)
1048 if (pCapturedControl->
GetParamIdx(v) > kNoParameter)
1063 for (
auto& point : points)
1068 auto itr = mCapturedMap.find(mod.touchID);
1070 if(itr != mCapturedMap.end())
1072 IControl* pCapturedControl = itr->second;
1076 int nVals = pCapturedControl->
NVals();
1078 for (
int v = 0; v < nVals; v++)
1080 if (pCapturedControl->
GetParamIdx(v) > kNoParameter)
1084 mCapturedMap.erase(mod.touchID);
1089 if (mResizingInProcess)
1094 if (points.size() == 1 && !points[0].ms.IsTouch())
1095 OnMouseOver(points[0].x, points[0].y, points[0].ms);
1103 for (
auto& point : points)
1109 auto itr = mCapturedMap.find(mod.touchID);
1111 if(itr != mCapturedMap.end())
1113 IControl* pCapturedControl = itr->second;
1115 mCapturedMap.erase(mod.touchID);
1125 Trace(
"IGraphics::OnMouseOver", __LINE__,
"x:%0.2f, y:%0.2f, mod:LRSCA: %i%i%i%i%i",
1126 x, y, mod.L, mod.R, mod.S, mod.C, mod.A);
1129 IControl* pControl = GetMouseControl(x, y,
false,
true);
1131 if (pControl != mMouseOver)
1136 mMouseOver = pControl;
1147 Trace(
"IGraphics::OnMouseOut", __LINE__,
"");
1157 Trace(
"IGraphics::OnMouseDrag:", __LINE__,
"x:%0.2f, y:%0.2f, dX:%0.2f, dY:%0.2f, mod:LRSCA: %i%i%i%i%i",
1158 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);
1160 if (mResizingInProcess && points.size() == 1)
1167 textEntry = mTextEntryControl.get();
1169 for (
auto& point : points)
1173 float dX = point.dX;
1174 float dY = point.dY;
1177 auto itr = mCapturedMap.find(mod.touchID);
1179 if (itr != mCapturedMap.end())
1181 IControl* pCapturedControl = itr->second;
1183 if (textEntry && pCapturedControl != textEntry)
1184 pCapturedControl =
nullptr;
1186 if (pCapturedControl && (dX != 0 || dY != 0))
1197 Trace(
"IGraphics::OnMouseDblClick", __LINE__,
"x:%0.2f, y:%0.2f, mod:LRSCA: %i%i%i%i%i",
1198 x, y, mod.L, mod.R, mod.S, mod.C, mod.A);
1200 IControl* pControl = GetMouseControl(x, y,
true);
1210 std::vector<IMouseInfo> list {info};
1225 IControl* pControl = GetMouseControl(x, y,
false);
1232 Trace(
"IGraphics::OnKeyDown", __LINE__,
"x:%0.2f, y:%0.2f, key:%s",
1235 bool handled =
false;
1237 IControl* pControl = GetMouseControl(x, y,
false);
1240 handled = pControl->
OnKeyDown(x, y, key);
1243 handled = mKeyHandlerFunc ? mKeyHandlerFunc(key,
false) :
false;
1250 Trace(
"IGraphics::OnKeyUp", __LINE__,
"x:%0.2f, y:%0.2f, key:%s",
1253 bool handled =
false;
1255 IControl* pControl = GetMouseControl(x, y,
false);
1258 handled = pControl->
OnKeyUp(x, y, key);
1261 handled = mKeyHandlerFunc ? mKeyHandlerFunc(key,
true) :
false;
1268 IControl* pControl = GetMouseControl(x, y,
false);
1269 if (pControl) pControl->
OnDrop(str);
1274 IControl* pControl = GetMouseControl(x, y,
false);
1280 mCapturedMap.clear();
1285int IGraphics::GetMouseControlIdx(
float x,
float y,
bool mouseOver)
1287 if (!mouseOver || mEnableMouseOver)
1290 for (
auto c =
NControls() - 1; c >= (mouseOver ? 1 : 0); --c)
1302 if (pControl->
IsHit(x, y))
1321IControl* IGraphics::GetMouseControl(
float x,
float y,
bool capture,
bool mouseOver, ITouchID touchID)
1325 auto itr = mCapturedMap.find(touchID);
1329 pControl = itr->second;
1335 int controlIdx = -1;
1337 if (!pControl && mPopupControl && mPopupControl->GetExpanded())
1338 pControl = mPopupControl.get();
1340 if (!pControl && mTextEntryControl && mTextEntryControl->EditInProgress())
1341 pControl = mTextEntryControl.get();
1345 if (!pControl && mLiveEdit)
1346 pControl = mLiveEdit.get();
1349 if (!pControl && mCornerResizer && mCornerResizer->GetRECT().Contains(x, y))
1350 pControl = mCornerResizer.get();
1352 if (!pControl && mPerfDisplay && mPerfDisplay->GetRECT().Contains(x, y))
1353 pControl = mPerfDisplay.get();
1357 controlIdx = GetMouseControlIdx(x, y, mouseOver);
1358 pControl = (controlIdx >= 0) ?
GetControl(controlIdx) :
nullptr;
1361 if (capture && pControl)
1371 mCapturedMap.insert(std::make_pair(touchID, pControl));
1377 mMouseOverIdx = controlIdx;
1384 IControl* pControl = GetMouseControl(x, y,
false);
1385 int idx = mLastClickedParam = pControl ? pControl->
GetParamIdx() : -1;
1391 const int idx = mLastClickedParam;
1392 mLastClickedParam = kNoParameter;
1404 contextMenu.Clear();
1410#if defined VST3_API || defined VST3C_API
1411 VST3_API_BASE* pVST3 =
dynamic_cast<VST3_API_BASE*
>(
GetDelegate());
1413 if (!pVST3->GetComponentHandler() || !pVST3->GetView())
1416 Steinberg::FUnknownPtr<Steinberg::Vst::IComponentHandler3>handler(pVST3->GetComponentHandler() );
1421 Steinberg::Vst::ParamID p = paramIdx;
1423 Steinberg::Vst::IContextMenu* pVST3ContextMenu = handler->createContextMenu(pVST3->GetView(), &p);
1425 if (pVST3ContextMenu)
1427 std::function<void(
IPopupMenu* pCurrentMenu)> populateFunc;
1428 Steinberg::int32 tag = 0;
1430 populateFunc = [&populateFunc, &tag, pVST3ContextMenu, pControl](
IPopupMenu* pCurrentMenu) {
1431 Steinberg::Vst::IContextMenu::Item item = {0};
1433 for (
int i = 0; i < pCurrentMenu->NItems(); i++)
1435 Steinberg::UString128 (pCurrentMenu->GetItemText(i)).copyTo (item.name, 128);
1439 if (pCurrentMenu->GetItem(i)->GetIsSeparator())
1441 item.flags = Steinberg::Vst::IContextMenu::Item::kIsSeparator;
1443 else if (
auto pSubMenu = pCurrentMenu->GetItem(i)->GetSubmenu())
1445 item.flags = Steinberg::Vst::IContextMenu::Item::kIsGroupStart;
1446 pVST3ContextMenu->addItem(item, pControl);
1447 populateFunc(pSubMenu);
1449 item.flags = Steinberg::Vst::IContextMenu::Item::kIsGroupEnd;
1450 pVST3ContextMenu->addItem(item, pControl);
1455 if (!pCurrentMenu->GetItem(i)->GetEnabled())
1456 item.flags |= Steinberg::Vst::IContextMenu::Item::kIsDisabled;
1458 if (pCurrentMenu->GetItem(i)->GetChecked())
1459 item.flags |= Steinberg::Vst::IContextMenu::Item::kIsChecked;
1462 pVST3ContextMenu->addItem(item, pControl);
1466 populateFunc(&contextMenu);
1475 pVST3ContextMenu->popup((Steinberg::UCoord) x, (Steinberg::UCoord) y);
1476 pVST3ContextMenu->release();
1480 if(!contextMenu.NItems())
1483 DoCreatePopupMenu(*pControl, contextMenu,
IRECT(x, y, x, y), kNoValIdx,
true);
1501 if(mGUISizeMode == EUIResizerMode::Scale)
1516 if (mAppearanceChangedFunc)
1517 mAppearanceChangedFunc(appearance);
1529 mEnableTooltips = enable;
1530 if (enable) mEnableMouseOver =
true;
1540 mLiveEdit = std::make_unique<IGraphicsLiveEdit>(mEnableMouseOver);
1546 mLiveEdit =
nullptr;
1560 StaticStorage<SVGHolder>::Accessor storage(sSVGCache);
1561 SVGHolder* pHolder = storage.Find(fileName);
1565 WDL_TypedBuf<uint8_t> svgData =
LoadResource(fileName,
"svg");
1566 if (svgData.GetSize() == 0)
1568 return ISVG(
nullptr);
1572 return LoadSVG(fileName, svgData.Get(), svgData.GetSize(), units, dpi);
1576 return ISVG(pHolder->mSVGDom);
1581 StaticStorage<SVGHolder>::Accessor storage(sSVGCache);
1582 SVGHolder* pHolder = storage.Find(name);
1586 sk_sp<SkSVGDOM> svgDOM;
1589 SkMemoryStream svgStream(pData, dataSize);
1590 svgDOM = SkSVGDOM::MakeFromStream(svgStream);
1593 return ISVG(
nullptr);
1597 if (svgDOM->containerSize().width() == 0)
1599 NSVGimage* pImage =
nullptr;
1602 svgStr.Set((
const char*)pData, dataSize);
1603 pImage = nsvgParse(svgStr.Get(), units, dpi);
1607 svgDOM->setContainerSize(SkSize::Make(pImage->width, pImage->height));
1612 pHolder =
new SVGHolder(svgDOM);
1613 storage.Add(pHolder, name);
1616 return ISVG(pHolder->mSVGDom);
1622 StaticStorage<SVGHolder>::Accessor storage(sSVGCache);
1623 SVGHolder* pHolder = storage.Find(fileName);
1627 WDL_TypedBuf<uint8_t> svgData =
LoadResource(fileName,
"svg");
1628 if (svgData.GetSize() == 0)
1630 return ISVG(
nullptr);
1634 return LoadSVG(fileName, svgData.Get(), svgData.GetSize(), units, dpi);
1638 return ISVG(pHolder->mImage);
1643 StaticStorage<SVGHolder>::Accessor storage(sSVGCache);
1644 SVGHolder* pHolder = storage.Find(name);
1648 NSVGimage* pImage =
nullptr;
1651 svgStr.Set(
reinterpret_cast<const char*
>(pData), dataSize);
1652 pImage = nsvgParse(svgStr.Get(), units, dpi);
1655 return ISVG(
nullptr);
1657 pHolder =
new SVGHolder(pImage);
1659 storage.Add(pHolder, name);
1662 return ISVG(pHolder->mImage);
1668 WDL_TypedBuf<uint8_t> result;
1673 if (resourceFound == EResourceLocation::kNotFound)
1677 if (resourceFound == EResourceLocation::kWinBinary)
1681 result.Resize(size);
1682 result.Set((
const uint8_t*)pResData, size);
1685 if (resourceFound == EResourceLocation::kAbsolutePath)
1687 FILE* fd = fopenUTF8(path.Get(),
"rb");
1693 if (fseek(fd, 0, SEEK_END))
1698 long size = ftell(fd);
1701 if (fseek(fd, 0, SEEK_SET))
1707 result.Resize((
int)size);
1708 size_t bytesRead = fread(result.Get(), 1, (
size_t)size, fd);
1709 if (bytesRead != (
size_t)size)
1712 result.Resize(0,
true);
1723 if (targetScale == 0)
1726 StaticStorage<APIBitmap>::Accessor storage(sBitmapCache);
1727 APIBitmap* pAPIBitmap = storage.Find(name, targetScale);
1732 WDL_String fullPath;
1733 std::unique_ptr<APIBitmap> loadedBitmap;
1734 int sourceScale = 0;
1736 const char* ext = name + strlen(name) - 1;
1737 while (ext >= name && *ext !=
'.') --ext;
1742 if (!bitmapTypeSupported)
1745 EResourceLocation resourceLocation =
SearchImageResource(name, ext, fullPath, targetScale, sourceScale);
1747 if (resourceLocation == EResourceLocation::kNotFound)
1755 if (sourceScale != targetScale)
1756 pAPIBitmap = storage.Find(name, sourceScale);
1761 loadedBitmap = std::unique_ptr<APIBitmap>(
LoadAPIBitmap(fullPath.Get(), sourceScale, resourceLocation, ext));
1762 pAPIBitmap= loadedBitmap.get();
1767 assert(pAPIBitmap &&
"Bitmap not found");
1770 if (pAPIBitmap->
GetScale() != targetScale)
1772 return ScaleBitmap(
IBitmap(pAPIBitmap, nStates, framesAreHorizontal, name), name, targetScale);
1774 else if (loadedBitmap)
1780 return IBitmap(pAPIBitmap, nStates, framesAreHorizontal, name);
1785 if (targetScale == 0)
1788 StaticStorage<APIBitmap>::Accessor storage(sBitmapCache);
1789 APIBitmap* pAPIBitmap = storage.Find(name, targetScale);
1794 WDL_String fullPath;
1795 std::unique_ptr<APIBitmap> loadedBitmap;
1796 int sourceScale = 0;
1798 const char* ext = name + strlen(name) - 1;
1799 while (ext >= name && *ext !=
'.') --ext;
1804 if (!bitmapTypeSupported)
1812 loadedBitmap = std::unique_ptr<APIBitmap>(
LoadAPIBitmap(name, pData, dataSize, 1));
1813 pAPIBitmap= loadedBitmap.get();
1818 assert(pAPIBitmap &&
"Bitmap not found");
1821 if (pAPIBitmap->
GetScale() != targetScale)
1823 return ScaleBitmap(
IBitmap(pAPIBitmap, nStates, framesAreHorizontal, name), name, targetScale);
1825 else if (loadedBitmap)
1831 return IBitmap(pAPIBitmap, nStates, framesAreHorizontal, name);
1836 StaticStorage<APIBitmap>::Accessor storage(sBitmapCache);
1842 StaticStorage<APIBitmap>::Accessor storage(sBitmapCache);
1851 mScreenScale = scale;
1861 mScreenScale = screenScale;
1862 mDrawScale = drawScale;
1867auto SearchNextScale = [](
int& sourceScale,
int targetScale) {
1868 if (sourceScale == targetScale && (targetScale != MAX_IMG_SCALE))
1869 sourceScale = MAX_IMG_SCALE;
1870 else if (sourceScale == targetScale + 1)
1871 sourceScale = targetScale - 1;
1878 for (sourceScale = targetScale ; sourceScale > 0; SearchNextScale(sourceScale, targetScale))
1880 WDL_String fullName(name);
1882 if (sourceScale != 1)
1884 WDL_String baseName(name); baseName.remove_fileext();
1885 WDL_String ext(fullName.get_fileext());
1886 fullName.SetFormatted((
int) (strlen(name) + strlen(
"@2x")),
"%s@%dx%s", baseName.Get(), sourceScale, ext.Get());
1891 if (found > EResourceLocation::kNotFound)
1895 return EResourceLocation::kNotFound;
1900 StaticStorage<APIBitmap>::Accessor storage(sBitmapCache);
1902 for (sourceScale = targetScale; sourceScale > 0; SearchNextScale(sourceScale, targetScale))
1904 APIBitmap* pBitmap = storage.Find(name, sourceScale);
1925 mInTextEntry = &control;
1926 mTextEntryValIdx = valIdx;
1928 int paramIdx = valIdx > kNoValIdx ? control.
GetParamIdx(valIdx) : kNoParameter;
1930 if (mTextEntryControl)
1931 mTextEntryControl->CreateTextEntry(paramIdx, text, bounds, control.
GetTextEntryLength(), str);
1938void IGraphics::DoCreatePopupMenu(
IControl& control,
IPopupMenu& menu,
const IRECT& bounds,
int valIdx,
bool isContext)
1942 mInPopupMenu = &control;
1943 mPopupMenuValIdx = valIdx;
1944 mIsContextMenu = isContext;
1948 mPopupControl->CreatePopupMenu(menu, bounds);
1952 bool isAsync =
false;
1962 DoCreatePopupMenu(control, menu, bounds, valIdx,
false);
1965void IGraphics::EndDragResize()
1967 mResizingInProcess =
false;
1981 const int w =
static_cast<int>(std::ceil(pixelBackingScale * std::ceil(alignedBounds.
W())));
1982 const int h =
static_cast<int>(std::ceil(pixelBackingScale * std::ceil(alignedBounds.
H())));
1991 ownedLayer.swap(layer);
1992 ILayer* pOwnerlessLayer = ownedLayer.release();
1994 if (pOwnerlessLayer)
2007 mLayers.push(pLayer);
2016 ILayer* pLayer =
nullptr;
2018 if (!mLayers.empty())
2020 pLayer = mLayers.top();
2034 const APIBitmap* pBitmap = layer ? layer->GetAPIBitmap() :
nullptr;
2036 if (pBitmap && layer->mControl && layer->mControlRECT != layer->mControl->GetRECT())
2038 layer->mControlRECT = layer->mControl->GetRECT();
2039 layer->Invalidate();
2049 DrawBitmap(layer->GetBitmap(), layer->Bounds(), 0, 0, pBlend);
2055 IBitmap bitmap = layer->GetBitmap();
2056 IRECT layerBounds = layer->Bounds();
2059 IRECT newBounds(0., 0., layerBounds.
W(), layerBounds.
H());
2069 IBitmap bitmap = layer->GetBitmap();
2070 IRECT bounds = layer->Bounds();
2077 auto GaussianBlurSwap = [](uint8_t* out, uint8_t* in, uint8_t* kernel,
int width,
int height,
2078 int outStride,
int inStride,
int kernelSize, uint32_t norm)
2081 int fullKernelSize = kernelSize * 2 + 1;
2084 auto RepeatCheck = [&](
int idx)
2086 repeats = last == in[idx * 4] ? std::min(repeats + 1, fullKernelSize) : 1;
2089 return repeats == fullKernelSize;
2092 for (
int i = 0; i < height; i++, in += inStride)
2094 for (
int j = 0; j < kernelSize - 1; j++)
2096 uint32_t accum = in[j * 4] * kernel[0];
2097 for (
int k = 1; k < j + 1; k++)
2098 accum += kernel[k] * in[(j - k) * 4];
2099 for (
int k = 1; k < kernelSize; k++)
2100 accum += kernel[k] * in[(j + k) * 4];
2101 out[j * outStride + (i * 4)] =
static_cast<uint8_t
>(std::min(
static_cast<uint32_t
>(255), accum / norm));
2103 for (
int j = 0; j < kernelSize * 2 - 2; j++)
2105 for (
int j = kernelSize - 1; j < (width - kernelSize) + 1; j++)
2107 if (RepeatCheck(j + kernelSize - 1))
2109 out[j * outStride + (i * 4)] =
static_cast<uint8_t
>(last);
2113 uint32_t accum = in[j * 4] * kernel[0];
2114 for (
int k = 1; k < kernelSize; k++)
2115 accum += kernel[k] * (in[(j - k) * 4] + in[(j + k) * 4]);
2116 out[j * outStride + (i * 4)] =
static_cast<uint8_t
>(std::min(
static_cast<uint32_t
>(255), accum / norm));
2118 for (
int j = (width - kernelSize) + 1; j < width; j++)
2120 uint32_t accum = in[j * 4] * kernel[0];
2121 for (
int k = 1; k < kernelSize; k++)
2122 accum += kernel[k] * in[(j - k) * 4];
2123 for (
int k = 1; k < width - j; k++)
2124 accum += kernel[k] * in[(j + k) * 4];
2125 out[j * outStride + (i * 4)] =
static_cast<uint8_t
>(std::min(
static_cast<uint32_t
>(255), accum / norm));
2130 RawBitmapData temp1;
2131 RawBitmapData temp2;
2132 RawBitmapData kernel;
2137 if (!temp1.GetSize())
2139 temp2.Resize(temp1.GetSize());
2143 float scale = layer->GetAPIBitmap()->GetScale() * layer->GetAPIBitmap()->GetDrawScale();
2144 float blurSize = std::max(1.f, (shadow.mBlurSize * scale) + 1.f);
2145 float blurConst = 4.5f / (blurSize * blurSize);
2146 int iSize =
static_cast<int>(ceil(blurSize));
2147 int width = layer->GetAPIBitmap()->GetWidth();
2148 int height = layer->GetAPIBitmap()->GetHeight();
2149 int stride1 = temp1.GetSize() / width;
2150 int stride2 = flipped ? -temp1.GetSize() / height : temp1.GetSize() / height;
2151 int stride3 = flipped ? -stride2 : stride2;
2153 kernel.Resize(iSize);
2155 for (
int i = 0; i < iSize; i++)
2156 kernel.Get()[i] =
static_cast<uint8_t
>(std::round(255.f * std::expf(-(i * i) * blurConst)));
2159 int normFactor = kernel.Get()[0];
2161 for (
int i = 1; i < iSize; i++)
2162 normFactor += kernel.Get()[i] + kernel.Get()[i];
2166 uint8_t* inRows = flipped ? asRows + stride3 * (height - 1) : asRows;
2169 GaussianBlurSwap(asCols, inRows, kernel.Get(), width, height, stride1, stride2, iSize, normFactor);
2170 GaussianBlurSwap(asRows, asCols, kernel.Get(), height, width, stride3, stride1, iSize, normFactor);
2189 DBGMSG(
"Could not locate font %s\n", fileNameOrResID);
2206 DBGMSG(
"Could not load font %s\n", fontID);
2223 DBGMSG(
"Could not locate font %s\n", fontID);
2229 double tx = 0.0, ty = 0.0;
2232 rect.
Translate(
static_cast<float>(tx),
static_cast<float>(ty));
2256 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)));
2257 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)));
2258 rect = r1.
Union(r2);
2260 switch (text.mAlign)
2262 case EAlign::Near: tx = bounds.L - rect.L;
break;
2263 case EAlign::Center: tx = bounds.
MW() - rect.
MW();
break;
2264 case EAlign::Far: tx = bounds.R - rect.R;
break;
2267 switch (text.mVAlign)
2269 case EVAlign::Top: ty = bounds.T - rect.T;
break;
2270 case EVAlign::Middle: ty = bounds.
MH() - rect.
MH();
break;
2271 case EVAlign::Bottom: ty = bounds.B - rect.B;
break;
2281 static int base = 48;
2282 static bool keysDown[128] = {};
2284 auto onOctSwitch = [&]() {
2285 base =
Clip(base, 24, 96);
2287 for(
auto i=0;i<128;i++) {
2298 case kVK_A: note = 0;
break;
2299 case kVK_W: note = 1;
break;
2300 case kVK_S: note = 2;
break;
2301 case kVK_E: note = 3;
break;
2302 case kVK_D: note = 4;
break;
2303 case kVK_F: note = 5;
break;
2304 case kVK_T: note = 6;
break;
2305 case kVK_G: note = 7;
break;
2306 case kVK_Y: note = 8;
break;
2307 case kVK_H: note = 9;
break;
2308 case kVK_U: note = 10;
break;
2309 case kVK_J: note = 11;
break;
2310 case kVK_K: note = 12;
break;
2311 case kVK_O: note = 13;
break;
2312 case kVK_L: note = 14;
break;
2313 case kVK_Z:
if(!isUp) { base -= 12; onOctSwitch(); }
return true;
2314 case kVK_X:
if(!isUp) { base += 12; onOctSwitch(); }
return true;
2315 default:
return true;
2318 int pitch = base + note;
2321 if(keysDown[pitch] ==
false) {
2323 keysDown[pitch] =
true;
2330 if(keysDown[pitch] ==
true) {
2332 keysDown[pitch] =
false;
2345 IControl* pControl = GetMouseControl(x, y,
false,
false);
2350 if(mGestureRegions.
Size() == 0)
2354 int regionIdx = mGestureRegions.
Find(x, y);
2365 IControl* pControl = GetMouseControl(info.x, info.y,
false,
false);
2371 int regionIdx = mGestureRegions.
Find(info.x, info.y);
2374 mGestureRegionFuncs.find(regionIdx)->second(
nullptr, info);
2380 if (std::find(std::begin(mRegisteredGestures), std::end(mRegisteredGestures), type) != std::end(mRegisteredGestures))
2382 mRegisteredGestures.push_back(type);
2388 mGestureRegions.
Add(bounds);
2390 mGestureRegionFuncs.insert(std::make_pair(mGestureRegions.
Size()-1, func));
2395 mGestureRegions.
Clear();
2396 mGestureRegionFuncs.clear();
2407 DrawBitmap(bitmap,
IRECT(-width * 0.5f, - height * 0.5f, width * 0.5f, height * 0.5f), 0, 0, pBlend);
2429 if (gridSizeH > 1.f)
2431 for (
float x = bounds.L + gridSizeH; x < bounds.R; x += gridSizeH)
2438 if (gridSizeV > 1.f)
2440 for (
float y = bounds.T + gridSizeV; y < bounds.B; y += gridSizeV)
2457 float xPos = bounds.L;
2459 PathMoveTo(xPos, bounds.B - (bounds.
H() * normYPoints[0]));
2461 for (
auto i = 1; i < nPoints; i++)
2464 xPos = bounds.L + (bounds.
W() * normXPoints[i]);
2466 xPos = bounds.L + ((bounds.
W() / (float) (nPoints - 1) * i));
2468 PathLineTo(xPos, bounds.B - (bounds.
H() * normYPoints[i]));
2484 options.mDash.SetDash(&dashLen, 0.0, 1);
2487 PathStroke(color, thickness, options, pBlend);
2543 options.mDash.SetDash(&dashLen, 0., 1);
2545 PathStroke(color, thickness, options, pBlend);
2646 if (ctl <= 0.f && ctr <= 0.f && cbl <= 0.f && cbr <= 0.f)
2652 const float y = bounds.B - bounds.
H();
2654 PathArc(bounds.L + ctl, y + ctl, ctl, 270.f, 360.f);
2655 PathArc(bounds.L + bounds.
W() - ctr, y + ctr, ctr, 0.f, 90.f);
2656 PathArc(bounds.L + bounds.
W() - cbr, y + bounds.
H() - cbr, cbr, 90.f, 180.f);
2657 PathArc(bounds.L + cbl, y + bounds.
H() - cbl, cbl, 180.f, 270.f);
2671 if (r1 <= 0.0 || r2 <= 0.0)
2691 PathArc(cx, cy, r, 0.f, 360.f);
2698 for(
int i = 1; i < nPoints; i++)
2705 mTransformStates.push(mTransform);
2710 if (!mTransformStates.empty())
2712 mTransform = mTransformStates.top();
2713 mTransformStates.pop();
2714 PathTransformSetMatrix(mTransform);
2722 std::stack<IMatrix> newStack;
2723 mTransformStates.swap(newStack);
2727 PathTransformSetMatrix(mTransform);
2733 PathTransformSetMatrix(mTransform);
2738 mTransform.
Scale(scaleX, scaleY);
2739 PathTransformSetMatrix(mTransform);
2749 mTransform.
Rotate(angle);
2750 PathTransformSetMatrix(mTransform);
2755 mTransform.
Skew(xAngle, yAngle);
2756 PathTransformSetMatrix(mTransform);
2762 PathTransformSetMatrix(mTransform);
2767 IRECT drawArea = mLayers.empty() ? mClipRECT : mLayers.top()->Bounds();
2769 PathTransformSetMatrix(
IMatrix());
2770 SetClipRegion(clip);
2771 PathTransformSetMatrix(mTransform);
2778 IRECT newBounds(0., 0.,
static_cast<float>(bitmap.
W()),
static_cast<float>(bitmap.
H()));
2779 PathTransformScale(bounds.
W() /
static_cast<float>(bitmap.
W()), bounds.
H() /
static_cast<float>(bitmap.
H()));
2786 float xScale = dest.
W() / svg.
W();
2787 float yScale = dest.
H() / svg.
H();
2788 float scale = xScale < yScale ? xScale : yScale;
2793 DoDrawSVG(svg, pBlend, pStrokeColor, pFillColor);
2802 DrawSVG(svg,
IRECT(-width * 0.5f, - height * 0.5f, width * 0.5f, height * 0.5f), pBlend);
2806IPattern IGraphics::GetSVGPattern(
const NSVGpaint& paint,
float opacity)
2808 int alpha = std::min(255, std::max(
int(roundf(opacity * 255.f)), 0));
2812 case NSVG_PAINT_COLOR:
2813 return IColor(alpha, (paint.color >> 0) & 0xFF, (paint.color >> 8) & 0xFF, (paint.color >> 16) & 0xFF);
2815 case NSVG_PAINT_LINEAR_GRADIENT:
2816 case NSVG_PAINT_RADIAL_GRADIENT:
2818 NSVGgradient* pGrad = paint.gradient;
2820 IPattern pattern(paint.type == NSVG_PAINT_LINEAR_GRADIENT ? EPatternType::Linear : EPatternType::Radial);
2823 switch (pGrad->spread)
2825 case NSVG_SPREAD_PAD: pattern.mExtend = EPatternExtend::Pad;
break;
2826 case NSVG_SPREAD_REFLECT: pattern.mExtend = EPatternExtend::Reflect;
break;
2827 case NSVG_SPREAD_REPEAT: pattern.mExtend = EPatternExtend::Repeat;
break;
2831 for (
int i = 0; i < pGrad->nstops; i++)
2833 unsigned int color = pGrad->stops[i].color;
2834 pattern.AddStop(
IColor(255, (color >> 0) & 0xFF, (color >> 8) & 0xFF, (color >> 16) & 0xFF), pGrad->stops[i].offset);
2838 pattern.SetTransform(pGrad->xform[0], pGrad->xform[1], pGrad->xform[2], pGrad->xform[3], pGrad->xform[4], pGrad->xform[5]);
2843 return IColor(alpha, 0, 0, 0);
2847void IGraphics::DoDrawSVG(
const ISVG& svg,
const IBlend* pBlend,
const IColor* pStrokeColor,
const IColor* pFillColor)
2851 svg.mSVGDom->render(canvas);
2853 NSVGimage* pImage = svg.mImage;
2855 assert(pImage !=
nullptr);
2857 for (NSVGshape* pShape = pImage->shapes; pShape; pShape = pShape->next)
2859 if (!(pShape->flags & NSVG_FLAGS_VISIBLE))
2866 for (NSVGpath* pPath = pShape->paths; pPath; pPath = pPath->next)
2870 for (
int i = 1; i < pPath->npts; i += 3)
2872 float *p = &pPath->pts[i*2];
2881 IVec2 p0{pPath->pts[0], pPath->pts[1]};
2882 IVec2 p1{pPath->bounds[0] - 1.0f, pPath->bounds[1] - 1.0f};
2884 for (NSVGpath *pPath2 = pShape->paths; pPath2; pPath2 = pPath2->next)
2886 if (pPath2 == pPath)
2889 if (pPath2->npts < 4)
2891 for (
int i = 1; i < pPath2->npts + 3; i += 3)
2893 float *p = &pPath2->pts[2*i];
2895 IVec2 p2 {p[-2], p[-1]};
2897 IVec2 p3 = (i < pPath2->npts) ?
IVec2{p[4], p[5]} :
IVec2{pPath2->pts[0], pPath2->pts[1]};
2898 float crossing = GetLineCrossing(p0, p1, p2, p3);
2899 float crossing2 = GetLineCrossing(p2, p3, p0, p1);
2900 if (0.0 <= crossing && crossing < 1.0 && 0.0 <= crossing2)
2910 if (pShape->fill.type != NSVG_PAINT_NONE)
2913 options.mFillRule = EFillRule::Preserve;
2915 options.mPreserve = pShape->stroke.type != NSVG_PAINT_NONE;
2916 PathFill(pFillColor ?
IPattern(*pFillColor) : GetSVGPattern(pShape->fill, pShape->opacity), options, pBlend);
2920 if (pShape->stroke.type != NSVG_PAINT_NONE)
2924 options.mMiterLimit = pShape->miterLimit;
2926 switch (pShape->strokeLineCap)
2928 case NSVG_CAP_BUTT: options.mCapOption = ELineCap::Butt;
break;
2929 case NSVG_CAP_ROUND: options.mCapOption = ELineCap::Round;
break;
2930 case NSVG_CAP_SQUARE: options.mCapOption = ELineCap::Square;
break;
2933 switch (pShape->strokeLineJoin)
2935 case NSVG_JOIN_MITER: options.mJoinOption = ELineJoin::Miter;
break;
2936 case NSVG_JOIN_ROUND: options.mJoinOption = ELineJoin::Round;
break;
2937 case NSVG_JOIN_BEVEL: options.mJoinOption = ELineJoin::Bevel;
break;
2940 options.mDash.SetDash(pShape->strokeDashArray, pShape->strokeDashOffset, pShape->strokeDashCount);
2942 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 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 for a SOMETHING that uses IGraphics for it's 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).
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.
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 OnMouseWheel(float x, float y, const IMouseMod &mod, float delta)
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.