Implemented by a graphics backend to apply a calculated shadow mask to a layer, according to the shadow settings specified.

Parameters

layer	The layer to apply the shadow to
mask	The mask of the shadow as raw bitmap data
shadow	The shadow specification

Implemented in IGraphicsNanoVG, and IGraphicsSkia.

Referenced by ApplyLayerDropShadow().

Attach your own control to scale or increase the UI size by dragging the plug-in bottom right-hand corner.

Parameters

pControl	control a control that inherits from ICornerResizerControl
sizeMode	Choose whether to scale or size the UI

Definition at line 333 of file IGraphics.cpp.

References GetDelegate().

Attach a control for pop-up menus, to override platform style menus.

Parameters

text	The text style to use for the menu
bounds	The area that the menu should occupy. An empty IRECT will mean the bounds are calculated based on the menu items

Definition at line 364 of file IGraphics.cpp.

References GetDelegate().

Referenced by TestDirBrowseControl::OnMouseDown().

Called to indicate that the platform should cache data about the platform font if needed.

Parameters

fontID	A string that is used to reference the font
font	A const PlatformFontPtr reference to the relevant font

Referenced by LoadFont().

Test to see if a layer needs drawing, for instance if the control's bounds were changed.

Parameters

Returns

true if the layer needs to be updated

Definition at line 2050 of file IGraphics.cpp.

References GetDrawScale(), APIBitmap::GetDrawScale(), APIBitmap::GetScale(), and GetScreenScale().

Referenced by IVPlotControl::Draw(), IWheelControl::Draw(), TestDropShadowControl::Draw(), GFXLabelControl::Draw(), TestKeyboardControl::Draw(), TestLayerControl::Draw(), TestMTControl::Draw(), TestSVGControl::Draw(), and ISVGControl::Draw().

Convert an x, y position in the view to screen coordinates.

Parameters

x	the x position to convert
y	the y position to convert

Definition at line 940 of file IGraphics.h.

Check to see if the control is already captured.

Returns

true is the control is already captured

Definition at line 1420 of file IGraphics.h.

Creates a new API bitmap, either in memory or as a GPU texture.

Parameters

width	The desired width
height	The desired height
scale	The scale in relation to 1:1 pixels
drawScale	The current draw scale for the graphics context
cacheable	Used to make sure the underlying bitmap can be shared between plug-in instances

Returns

APIBitmap* The new API Bitmap

Implemented in IGraphicsNanoVG, and IGraphicsSkia.

Referenced by StartLayer().

Calls the platform backend to create the platform popup menu.

Parameters

menu	The source IPopupMenu
bounds	The rectangular area in which to create the menu
isAsync	This gets set true on platforms where popupmenu creation is asyncronous

Returns

A ptr to the chosen IPopupMenu or nullptr in the case of async or dismissed menu

Creates a platform native text entry field.

Parameters

paramIdx	The index of the parameter associated with the text entry field.
text	The IText style for the text entry field text.
bounds	The rectangle that defines the size and position of the text entry field.
length	The maximum allowed length of the text in the text entry field.
str	The initial string to be displayed in the text entry field.

Referenced by CreateTextEntry().

Shows a pop up/contextual menu at point.

Parameters

control	A reference to the IControl creating this pop-up menu. If it exists IControl::OnPopupMenuSelection() will be called on successful selection
x	The X coordinate at which to pop up the menu
y	The Y coordinate at which to pop up the menu
valIdx	The value index for the control value that the menu relates to

Definition at line 1049 of file IGraphics.h.

References CreatePopupMenu().

Called by IOS platform (or other supported platforms) in order to update a control with a deletion interaction on a popup menu.

Parameters

pMenu	The menu that an item was deleted in
itemIdx	The index of the deleted item

Definition at line 280 of file IGraphics.cpp.

References IControl::OnDeleteFromPopupMenu().

Internal method to draw text.

Parameters

text	The text style to use for drawing
str	The string to draw
bounds	The bounding rectangle for the text
pBlend	Optional blend mode

Implemented in IGraphicsNanoVG, and IGraphicsSkia.

Referenced by DrawText().

Internal method to measure text dimensions.

Parameters

text	The text style to use for measurement
str	The string to measure
bounds	Output rectangle updated with the measured text bounds

Returns

The width of the measured text

Implemented in IGraphicsNanoVG, and IGraphicsSkia.

Referenced by MeasureText().

Draw an arc to the graphics context.

Parameters

color	The color to draw the shape with
cx	The X coordinate of the centre of the circle on which the arc lies
cy	The Y coordinate of the centre of the circle on which the arc lies
r	The radius of the circle on which the arc lies
a1	the start angle of the arc at in degrees clockwise where 0 is up
a2	the end angle of the arc at in degrees clockwise where 0 is up
pBlend	Optional blend method
thickness	Optional line thickness

Definition at line 2543 of file IGraphics.cpp.

References PathArc(), PathClear(), and PathStroke().

Referenced by TestArcControl::Draw().

Draw a bitmap (raster) image to the graphics context.

Parameters

bitmap	The bitmap image to draw to the graphics context
bounds	The rectangular region to draw the image in
srcX	The X offset in the source image to draw from
srcY	The Y offset in the source image to draw from
pBlend	Optional blend method

Implemented in IGraphicsNanoVG, and IGraphicsSkia.

Referenced by IBSliderControl::Draw(), IWheelControl::Draw(), DrawBitmap(), IBitmapBase::DrawBitmap(), DrawBitmapedText(), DrawFittedBitmap(), DrawFittedLayer(), DrawLayer(), DrawRotatedBitmap(), and ScaleBitmap().

Draws mono spaced bitmap text.

Useful for identical looking text on multiple platforms.

Parameters

bitmap	the bitmap containing glyphs to draw
bounds	where to draw the bitmap
text	text properties (note - many of these are irrelevant for bitmapped text)
pBlend	blend operation
str	the string to draw
vCenter	centre the text vertically
multiline	should the text spill onto multiple lines
charWidth	how wide is a character in the bitmap
charHeight	how high is a character in the bitmap
charOffset	what is the offset between characters drawn

Definition at line 727 of file IGraphics.cpp.

References DrawBitmap(), IRECT::H(), and IRECT::W().

Referenced by IBTextControl::Draw().

Draw a circle to the graphics context.

Parameters

color	The color to draw the shape with
cx	The X coordinate of the centre of the circle
cy	The Y coordinate of the centre of the circle
r	The radius of the circle
pBlend	Optional blend method
thickness	Optional line thickness

Definition at line 2550 of file IGraphics.cpp.

References PathCircle(), PathClear(), and PathStroke().

Referenced by TestArcControl::Draw().

Draw a convex polygon to the graphics context.

Parameters

color	The color to draw the shape with
x	Pointer to the first element in an array of X coordinates for the vertices of the polygon
y	Pointer to the first element in an array of Y coordinates for the vertices of the polygon
nPoints	The number of points in the coordinate arrays
pBlend	Optional blend method
thickness	Optional line thickness

Definition at line 2536 of file IGraphics.cpp.

References PathClear(), PathConvexPolygon(), and PathStroke().

Referenced by TestPolyControl::Draw().

Draw a dotted line to the graphics context.

Parameters

color	The color to draw the shape with
x1	The X coordinate of the start of the line
y1	The Y coordinate of the start of the line
x2	The X coordinate of the end of the line
y2	The Y coordinate of the end of the line
pBlend	Optional blend method
thickness	Optional line thickness

Reimplemented in IGraphicsNanoVG.

Definition at line 2497 of file IGraphics.cpp.

References PathClear(), PathLineTo(), PathMoveTo(), and PathStroke().

Draw a dotted rectangle to the graphics context.

Parameters

color	The color to draw the shape with
bounds	The rectangular region to draw the shape in
pBlend	Optional blend method
thickness	Optional line thickness

Reimplemented in IGraphicsNanoVG.

Definition at line 2557 of file IGraphics.cpp.

References PathClear(), PathRect(), and PathStroke().

Referenced by TestAnimationControl::Draw(), TestColorControl::Draw(), TestCursorControl::Draw(), TestDirBrowseControl::Draw(), TestDragAndDropControl::Draw(), TestDrawContextControl::Draw(), TestDropShadowControl::Draw(), TestGesturesControl::Draw(), TestGradientControl::Draw(), TestImageControl::Draw(), TestLayerControl::Draw(), TestMultiPathControl::Draw(), TestSVGControl::Draw(), and IGraphicsLiveEdit::Draw().

Draw an ellipse around a central point given two radii and an angle of orientation.

Parameters

color	The color to draw the shape with
x	The X coordinate of the centre of the ellipse
y	The Y coordinate of the centre of the ellipse
r1	The radius of the ellipse along the line found by rotating the x-axis by the angle
r2	The radius of the ellipse along the line found by rotating the y-axis by the angle
angle	The angle rotates the radii r1 and r2 clockwise in degrees to adjust the orientation
pBlend	Optional blend method
thickness	Optional line thickness

Definition at line 2573 of file IGraphics.cpp.

References PathClear(), PathEllipse(), and PathStroke().

Draw a bitmap (raster) image to the graphics context, scaling the image to fit the bounds.

Parameters

bitmap	The bitmap image to draw to the graphics context
bounds	The rectangular region to draw the image in
pBlend	Optional blend method

Definition at line 2792 of file IGraphics.cpp.

References DrawBitmap(), IBitmap::H(), IRECT::H(), PathTransformRestore(), PathTransformSave(), PathTransformScale(), PathTransformTranslate(), IBitmap::W(), and IRECT::W().

Referenced by TestBlendControl::Draw(), TestImageControl::Draw(), and TestMaskControl::Draw().

Draw a clipped horizontal line at a position bounds.

Parameters

color	The color to draw the line with
yi	The position of the line on the y axis
xLo	The start of the horizontal line on the x axis
xHi	The end of the horizontal line on the x axis
pBlend	Optional blend method
thickness	Optional line thickness

Definition at line 819 of file IGraphics.cpp.

References DrawLine().

Draw a layer to the main IGraphics context.

Parameters

layer	The layer to draw
pBlend	Optional blend method

Definition at line 2063 of file IGraphics.cpp.

References DrawBitmap(), PathTransformReset(), PathTransformRestore(), and PathTransformSave().

Referenced by IVPlotControl::Draw(), TestBlendControl::Draw(), TestDropShadowControl::Draw(), GFXLabelControl::Draw(), TestKeyboardControl::Draw(), TestLayerControl::Draw(), TestMTControl::Draw(), TestShadowGradientControl::Draw(), TestSVGControl::Draw(), and ISVGControl::Draw().

Draw a horzional or vertical line, within a rectangular region of the graphics context.

Parameters

color	The color to draw the line with
bounds	The rectangular region to draw the line in
dir	The direction of the line
pos	The normalized position of the line on the horizontal or vertical axis, within bounds
pBlend	Optional blend method
thickness	Optional line thickness

Definition at line 792 of file IGraphics.cpp.

References DrawHorizontalLine(), and DrawVerticalLine().

Draw some multi-line text to the graphics context in a specific rectangle (NanoVG only)

Parameters

text	An IText struct containing font and text properties and layout info
str	The text string to draw
bounds	The rectangular region in the graphics where you would like to draw the text
pBlend	Optional blend method

Reimplemented in IGraphicsNanoVG, and IGraphicsSkia.

Definition at line 363 of file IGraphics.h.

References DrawText().

Referenced by IMultiLineTextControl::Draw().

Fill a rectangle corresponding to a pixel on a 1:1 screen with a color.

Parameters

color	The color to fill the point with
x	The X coordinate at which to draw
y	The Y coordinate at which to draw
pBlend	Optional blend method

Definition at line 2429 of file IGraphics.cpp.

References FillRect().

Draw a radial line to the graphics context, useful for pointers on dials.

Parameters

color	The color to draw the line with
cx	centre point x coordinate
cy	centre point y coordinate
angle	The angle to draw at in degrees clockwise where 0 is up
rMin	minima of the radial line (distance from cx,cy)
rMax	maxima of the radial line (distance from cx,cy)
pBlend	Optional blend method
thickness	Optional line thickness

Definition at line 824 of file IGraphics.cpp.

References DrawLine().

Referenced by TestArcControl::Draw(), and TestLayerControl::Draw().

Draw a rectangle to the graphics context.

Parameters

bounds	The rectangular area in which to draw the shape
color	The color to draw the shape to draw the shape with
pBlend	Optional blend method
thickness	Optional line thickness

Definition at line 2515 of file IGraphics.cpp.

References PathClear(), PathRect(), and PathStroke().

Referenced by IVLabelControl::Draw(), IVXYPadControl::Draw(), IVPlotControl::Draw(), IFPSDisplayControl::Draw(), IVBarGraphSpectrumAnalyzerControl< MAXNC, MAX_FFT_SIZE >::Draw(), IVDisplayControl::Draw(), IVKeyboardControl::Draw(), IWheelControl::Draw(), IVMeterControl< MAXNC >::Draw(), IVMultiSliderControl< MAXNC >::Draw(), IVScopeControl< MAXNC, MAXBUF >::Draw(), IVSpectrumAnalyzerControl< MAXNC, MAX_FFT_SIZE >::Draw(), TestArcControl::Draw(), TestBezierControl::Draw(), TestBlendControl::Draw(), TestDirBrowseControl::Draw(), TestFlexBoxControl::Draw(), TestMTControl::Draw(), IPanelControl::Draw(), IVRangeSliderControl::DrawWidget(), and IVColorSwatchControl::DrawWidget().

Draw a rounded rectangle to the graphics context with individual corner roundness.

Parameters

color	The color to draw the shape with
bounds	The rectangular region to draw the shape in
cRTL	The top left corner radius in pixels
cRTR	The top right corner radius in pixels
cRBR	The bottom right corner radius in pixels
cRBL	The bottom left corner radius in pixels
pBlend	Optional blend method
thickness	Optional line thickness

Definition at line 2529 of file IGraphics.cpp.

References PathClear(), PathRoundRect(), and PathStroke().

Draw an SVG image to the graphics context.

Parameters

svg	The SVG image to the graphics context
bounds	The rectangular region to draw the image in
pBlend	Optional blend method
pStrokeColor	Optional color to override all SVG stroke commands
pFillColor	Optional color to override all SVG fill commands

Definition at line 2802 of file IGraphics.cpp.

References ISVG::H(), IRECT::H(), PathTransformRestore(), PathTransformSave(), PathTransformScale(), PathTransformTranslate(), ISVG::W(), and IRECT::W().

Referenced by ISVGButtonControl::Draw(), ISVGToggleControl::Draw(), ISVGSwitchControl::Draw(), ISVGSliderControl::Draw(), TestDropShadowControl::Draw(), TestSVGControl::Draw(), ISVGControl::Draw(), and DrawRotatedSVG().

Draw some text to the graphics context in a specific rectangle.

Parameters

text	An IText struct containing font and text properties and layout info
str	The text string to draw
bounds	The rectangular region in the graphics where you would like to draw the text
pBlend	Optional blend method

Definition at line 683 of file IGraphics.cpp.

References DoDrawText().

Referenced by IVLabelControl::Draw(), IFPSDisplayControl::Draw(), ITextEntryControl::Draw(), IVKeyboardControl::Draw(), TestAnimationControl::Draw(), TestBlendControl::Draw(), TestColorControl::Draw(), TestCursorControl::Draw(), TestCustomShaderControl::Draw(), TestDirBrowseControl::Draw(), TestDragAndDropControl::Draw(), TestDrawContextControl::Draw(), TestFlexBoxControl::Draw(), TestFontControl::Draw(), TestGesturesControl::Draw(), GFXLabelControl::Draw(), TestImageControl::Draw(), TestKeyboardControl::Draw(), TestLayerControl::Draw(), TestMPSControl::Draw(), TestMTControl::Draw(), TestSizeControl::Draw(), TestTextControl::Draw(), TestTextOrientationControl::Draw(), TestTextSizeControl::Draw(), ITextControl::Draw(), IURLControl::Draw(), PlaceHolder::Draw(), IPopupMenuControl::DrawCellText(), IVectorBase::DrawLabel(), IGraphicsSkia::DrawMultiLineText(), DrawMultiLineText(), DrawText(), IVectorBase::DrawValue(), IVToggleControl::DrawValue(), IVRadioButtonControl::DrawWidget(), and IVColorSwatchControl::DrawWidget().

Draw some text to the graphics context at a point.

Parameters

text	An IText struct containing font and text properties and layout info
str	The text string to draw
x	The x position in the graphics where you would like to draw the text
y	The y position in the graphics where you would like to draw the text
pBlend	Optional blend method

Definition at line 699 of file IGraphics.cpp.

References DrawText().

Draw a clipped vertical line at a position bounds.

Parameters

color	The color to draw the line with
xi	The position of the line on the x axis
yLo	The start of the vertical line on the y axis
yHi	The end of the vertical line on the y axis
pBlend	Optional blend method
thickness	Optional line thickness

Definition at line 814 of file IGraphics.cpp.

References DrawLine().

Parameters

enable

Set true if you want to handle mouse over messages. Note: this may increase the amount CPU usage if you redraw on mouse overs etc

Definition at line 1601 of file IGraphics.h.

Referenced by IGraphicsLiveEdit::OnInit().

Parameters

enable

Set true to enable tool tips when the user mouses over a control

Definition at line 1543 of file IGraphics.cpp.

Called by some drawing API classes to finally blit the draw bitmap onto the screen or perform other cleanup after drawing.

Reimplemented in IGraphicsNanoVG, and IGraphicsSkia.

Definition at line 100 of file IGraphics.h.

Referenced by Draw().

Fill an arc segment with a color.

Parameters

color	The color to fill the shape with
cx	The X coordinate of the centre of the circle on which the arc lies
cy	The Y coordinate of the centre of the circle on which the arc lies
r	The radius of the circle on which the arc lies
a1	the start angle of the arc at in degrees clockwise where 0 is up
a2	the end angle of the arc at in degrees clockwise where 0 is up
pBlend	Optional blend method

Definition at line 2615 of file IGraphics.cpp.

References PathArc(), PathClear(), PathClose(), PathFill(), and PathMoveTo().

Referenced by TestArcControl::Draw().