Abstract interface for drawing on a 2D-surface. More...

#include <graphics_abstraction_layer.h>

Inheritance diagram for GAL:

Public Member Functions
	GAL (GAL_DISPLAY_OPTIONS &aOptions)

virtual	~GAL ()

virtual bool	IsInitialized () const
	Return the initialization status for the canvas.

virtual bool	IsVisible () const
	Return true if the GAL canvas is visible on the screen.

virtual bool	IsCairoEngine ()
	Return true if the GAL engine is a Cairo based type.

virtual bool	IsOpenGlEngine ()
	Return true if the GAL engine is a OpenGL based type.

virtual void	DrawLine (const VECTOR2D &aStartPoint, const VECTOR2D &aEndPoint)
	Draw a line.

virtual void	DrawSegment (const VECTOR2D &aStartPoint, const VECTOR2D &aEndPoint, double aWidth)
	Draw a rounded segment.

virtual void	DrawSegmentChain (const std::vector< VECTOR2D > &aPointList, double aWidth)
	Draw a chain of rounded segments.

virtual void	DrawSegmentChain (const SHAPE_LINE_CHAIN &aLineChain, double aWidth)

virtual void	DrawPolyline (const std::deque< VECTOR2D > &aPointList)
	Draw a polyline.

virtual void	DrawPolyline (const std::vector< VECTOR2D > &aPointList)

virtual void	DrawPolyline (const VECTOR2D aPointList[], int aListSize)

virtual void	DrawPolyline (const SHAPE_LINE_CHAIN &aLineChain)

virtual void	DrawPolylines (const std::vector< std::vector< VECTOR2D > > &aPointLists)
	Draw multiple polylines.

virtual void	DrawCircle (const VECTOR2D &aCenterPoint, double aRadius)
	Draw a circle using world coordinates.

virtual void	DrawHoleWall (const VECTOR2D &aCenterPoint, double aHoleRadius, double aWallWidth)
	Draw a hole wall ring.

virtual void	DrawArc (const VECTOR2D &aCenterPoint, double aRadius, const EDA_ANGLE &aStartAngle, const EDA_ANGLE &aAngle)
	Draw an arc.

virtual void	DrawArcSegment (const VECTOR2D &aCenterPoint, double aRadius, const EDA_ANGLE &aStartAngle, const EDA_ANGLE &aAngle, double aWidth, double aMaxError)
	Draw an arc segment.

virtual void	DrawRectangle (const VECTOR2D &aStartPoint, const VECTOR2D &aEndPoint)
	Draw a rectangle.

void	DrawRectangle (const BOX2I &aRect)

virtual void	DrawGlyph (const KIFONT::GLYPH &aGlyph, int aNth=0, int aTotal=1)
	Draw a polygon representing a font glyph.

virtual void	DrawGlyphs (const std::vector< std::unique_ptr< KIFONT::GLYPH > > &aGlyphs)
	Draw polygons representing font glyphs.

virtual void	DrawPolygon (const std::deque< VECTOR2D > &aPointList)
	Draw a polygon.

virtual void	DrawPolygon (const VECTOR2D aPointList[], int aListSize)

virtual void	DrawPolygon (const SHAPE_POLY_SET &aPolySet, bool aStrokeTriangulation=false)

virtual void	DrawPolygon (const SHAPE_LINE_CHAIN &aPolySet)

virtual void	DrawCurve (const VECTOR2D &startPoint, const VECTOR2D &controlPointA, const VECTOR2D &controlPointB, const VECTOR2D &endPoint, double aFilterValue=0.0)
	Draw a cubic bezier spline.

virtual void	DrawBitmap (const BITMAP_BASE &aBitmap, double alphaBlend=1.0)
	Draw a bitmap image.

virtual void	ResizeScreen (int aWidth, int aHeight)
	Resize the canvas.

virtual bool	Show (bool aShow)
	Show/hide the GAL canvas.

const VECTOR2I &	GetScreenPixelSize () const
	Return GAL canvas size in pixels.

virtual int	GetSwapInterval () const
	Return the swap interval. -1 for adaptive, 0 for disabled/unknown.

virtual void	Flush ()
	Force all remaining objects to be drawn.

void	SetClearColor (const COLOR4D &aColor)

const COLOR4D &	GetClearColor () const

virtual void	ClearScreen ()
	Clear the screen.

virtual void	SetIsFill (bool aIsFillEnabled)
	Enable/disable fill.

bool	GetIsFill () const
	Get the fill status.

virtual void	SetIsStroke (bool aIsStrokeEnabled)
	Enable/disable stroked outlines.

bool	GetIsStroke () const
	Get the stroke status.

virtual void	SetFillColor (const COLOR4D &aColor)
	Set the fill color.

const COLOR4D &	GetFillColor () const
	Get the fill color.

virtual void	SetStrokeColor (const COLOR4D &aColor)
	Set the stroke color.

const COLOR4D &	GetStrokeColor () const
	Get the stroke color.

virtual void	SetLineWidth (float aLineWidth)
	Set the line width.

virtual void	SetMinLineWidth (float aLineWidth)
	Set the minimum line width in pixels.

float	GetLineWidth () const
	Get the line width.

float	GetMinLineWidth () const
	Get the minimum line width in pixels.

virtual void	SetLayerDepth (double aLayerDepth)
	Set the depth of the layer (position on the z-axis)

void	AdvanceDepth ()
	Change the current depth to deeper, so it is possible to draw objects right beneath other.

virtual void	BitmapText (const wxString &aText, const VECTOR2I &aPosition, const EDA_ANGLE &aAngle)
	Draw a text using a bitmap font.

void	ResetTextAttributes ()
	Reset text attributes to default styling.

void	SetGlyphSize (const VECTOR2I aSize)

const VECTOR2I &	GetGlyphSize () const

void	SetFontBold (const bool aBold)

bool	IsFontBold () const

void	SetFontItalic (bool aItalic)

bool	IsFontItalic () const

void	SetFontUnderlined (bool aUnderlined)

bool	IsFontUnderlined () const

void	SetTextMirrored (const bool aMirrored)

bool	IsTextMirrored () const

void	SetHorizontalJustify (const GR_TEXT_H_ALIGN_T aHorizontalJustify)

GR_TEXT_H_ALIGN_T	GetHorizontalJustify () const

void	SetVerticalJustify (const GR_TEXT_V_ALIGN_T aVerticalJustify)

GR_TEXT_V_ALIGN_T	GetVerticalJustify () const

virtual void	Transform (const MATRIX3x3D &aTransformation)
	Transform the context.

virtual void	Rotate (double aAngle)
	Rotate the context.

virtual void	Translate (const VECTOR2D &aTranslation)
	Translate the context.

virtual void	Scale (const VECTOR2D &aScale)
	Scale the context.

virtual void	Save ()
	Save the context.

virtual void	Restore ()
	Restore the context.

virtual int	BeginGroup ()
	Begin a group.

virtual void	EndGroup ()
	End the group.

virtual void	DrawGroup (int aGroupNumber)
	Draw the stored group.

virtual void	ChangeGroupColor (int aGroupNumber, const COLOR4D &aNewColor)
	Change the color used to draw the group.

virtual void	ChangeGroupDepth (int aGroupNumber, int aDepth)
	Change the depth (Z-axis position) of the group.

virtual void	DeleteGroup (int aGroupNumber)
	Delete the group from the memory.

virtual void	ClearCache ()
	Delete all data created during caching of graphic items.

virtual void	ComputeWorldScreenMatrix ()
	Compute the world <-> screen transformation matrix.

const MATRIX3x3D &	GetWorldScreenMatrix () const
	Get the world <-> screen transformation matrix.

const MATRIX3x3D &	GetScreenWorldMatrix () const
	Get the screen <-> world transformation matrix.

void	SetWorldScreenMatrix (const MATRIX3x3D &aMatrix)
	Set the world <-> screen transformation matrix.

BOX2D	GetVisibleWorldExtents () const

void	SetWorldUnitLength (double aWorldUnitLength)
	Set the unit length.

void	SetScreenSize (const VECTOR2I &aSize)

void	SetScreenDPI (double aScreenDPI)
	Set the dots per inch of the screen.

double	GetScreenDPI () const

void	SetLookAtPoint (const VECTOR2D &aPoint)
	Get/set the Point in world space to look at.

const VECTOR2D &	GetLookAtPoint () const

void	SetZoomFactor (double aZoomFactor)

double	GetZoomFactor () const

void	SetRotation (double aRotation)
	Get/set the rotation angle (in radians).

double	GetRotation () const

void	SetDepthRange (const VECTOR2D &aDepthRange)
	Set the range of the layer depth.

double	GetMinDepth () const

double	GetMaxDepth () const

double	GetWorldScale () const
	Get the world scale.

void	SetFlip (bool xAxis, bool yAxis)
	Sets flipping of the screen.

bool	IsFlippedX () const

bool	IsFlippedY () const

virtual void	SetTarget (RENDER_TARGET aTarget)
	Set the target for rendering.

virtual RENDER_TARGET	GetTarget () const
	Get the currently used target for rendering.

virtual void	ClearTarget (RENDER_TARGET aTarget)
	Clear the target for rendering.

virtual bool	HasTarget (RENDER_TARGET aTarget)
	Return true if the target exists.

virtual void	SetNegativeDrawMode (bool aSetting)
	Set negative draw mode in the renderer.

virtual void	StartDiffLayer ()
	Begins rendering of a differential layer.

virtual void	EndDiffLayer ()
	Ends rendering of a differential layer.

virtual void	StartNegativesLayer ()
	Begins rendering in a new layer that will be copied to the main layer in EndNegativesLayer().

virtual void	EndNegativesLayer ()
	Ends rendering of a negatives layer and draws it to the main layer.

void	SetGridVisibility (bool aVisibility)
	Set the visibility setting of the grid.

bool	GetGridVisibility () const

bool	GetGridSnapping () const

void	SetGridOrigin (const VECTOR2D &aGridOrigin)
	Set the origin point for the grid.

const VECTOR2D &	GetGridOrigin () const

void	SetGridSize (const VECTOR2D &aGridSize)
	Set the grid size.

const VECTOR2D &	GetGridSize () const
	Return the grid size.

VECTOR2D	GetVisibleGridSize () const
	Return the visible grid size in x and y directions.

void	SetGridColor (const COLOR4D &aGridColor)
	Set the grid color.

void	SetAxesColor (const COLOR4D &aAxesColor)
	Set the axes color.

void	SetAxesEnabled (bool aAxesEnabled)
	Enable drawing the axes.

void	SetCoarseGrid (int aInterval)
	Draw every tick line wider.

float	GetGridLineWidth () const
	Get the grid line width.

virtual void	DrawGrid ()

VECTOR2D	GetGridPoint (const VECTOR2D &aPoint) const
	For a given point it returns the nearest point belonging to the grid in world coordinates.

VECTOR2D	ToWorld (const VECTOR2D &aPoint) const
	Compute the point position in world coordinates from given screen coordinates.

VECTOR2D	ToScreen (const VECTOR2D &aPoint) const
	Compute the point position in screen coordinates from given world coordinates.

virtual bool	SetNativeCursorStyle (KICURSOR aCursor, bool aHiDPI)
	Set the cursor in the native panel.

void	SetCursorEnabled (bool aCursorEnabled)
	Enable/disable cursor.

bool	IsCursorEnabled () const
	Return information about cursor visibility.

void	SetCursorColor (const COLOR4D &aCursorColor)
	Set the cursor color.

virtual void	DrawCursor (const VECTOR2D &aCursorPosition)
	Draw the cursor.

virtual void	EnableDepthTest (bool aEnabled=false)

virtual bool	IsContextLocked ()
	Checks the state of the context lock.

virtual void	LockContext (int aClientCookie)
	Use GAL_CONTEXT_LOCKER RAII object unless you know what you're doing.

virtual void	UnlockContext (int aClientCookie)

virtual void	BeginDrawing ()
	Start/end drawing functions, draw calls can be only made in between the calls to BeginDrawing()/EndDrawing().

virtual void	EndDrawing ()
	End the drawing, needs to be called for every new frame.

Protected Member Functions
virtual void	beginUpdate ()
	Enable item update mode.

virtual void	endUpdate ()
	Disable item update mode.

void	computeWorldScale ()
	Compute the scaling factor for the world->screen matrix.

double	computeMinGridSpacing () const
	Compute minimum grid spacing from the grid settings.

COLOR4D	getCursorColor () const
	Get the actual cursor color to draw.

void	OnGalDisplayOptionsChanged (const GAL_DISPLAY_OPTIONS &aOptions) override
	Handler for observer settings changes.

virtual bool	updatedGalDisplayOptions (const GAL_DISPLAY_OPTIONS &aOptions)
	Handle updating display options.

template<typename T>
void	normalize (T &a, T &b)
	Ensure that the first element is smaller than the second.

Protected Attributes
GAL_DISPLAY_OPTIONS &	m_options

UTIL::LINK	m_observerLink

std::stack< double >	m_depthStack
	Stored depth values.

VECTOR2I	m_screenSize
	Screen size in screen (wx logical) coordinates.

double	m_worldUnitLength
	The unit length of the world coordinates [inch].

double	m_screenDPI
	The dots per inch of the screen.

VECTOR2D	m_lookAtPoint
	Point to be looked at in world space.

double	m_zoomFactor
	The zoom factor.

double	m_rotation
	Rotation transformation (radians)

MATRIX3x3D	m_worldScreenMatrix
	World transformation.

MATRIX3x3D	m_screenWorldMatrix
	Screen transformation.

double	m_worldScale
	The scale factor world->screen.

bool	m_globalFlipX
	Flag for X axis flipping.

bool	m_globalFlipY
	Flag for Y axis flipping.

float	m_lineWidth
	The line width.

float	m_minLineWidth
	Minimum line width in pixels.

bool	m_isFillEnabled
	Is filling of graphic objects enabled ?

bool	m_isStrokeEnabled
	Are the outlines stroked ?

COLOR4D	m_fillColor
	The fill color.

COLOR4D	m_strokeColor
	The color of the outlines.

COLOR4D	m_clearColor

double	m_layerDepth
	The actual layer depth.

VECTOR2D	m_depthRange
	Range of the depth.

bool	m_gridVisibility
	Should the grid be shown.

GRID_STYLE	m_gridStyle
	Grid display style.

VECTOR2D	m_gridSize
	The grid size.

VECTOR2D	m_gridOrigin
	The grid origin.

VECTOR2D	m_gridOffset
	The grid offset to compensate cursor position.

COLOR4D	m_gridColor
	Color of the grid.

COLOR4D	m_axesColor
	Color of the axes.

bool	m_axesEnabled
	Should the axes be drawn.

int	m_gridTick
	Every tick line gets the double width.

float	m_gridLineWidth
	Line width of the grid.

int	m_gridMinSpacing
	Minimum screen size of the grid (pixels) below which the grid is not drawn.

bool	m_isCursorEnabled
	Is the cursor enabled?

bool	m_forceDisplayCursor
	Always show cursor.

COLOR4D	m_cursorColor
	Cursor color.

KIGFX::CROSS_HAIR_MODE	m_crossHairMode
	Crosshair drawing mode.

VECTOR2D	m_cursorPosition
	Current cursor position (world coordinates)

KICURSOR	m_currentNativeCursor
	Current cursor.

Static Protected Attributes
static const int	MIN_DEPTH = -2*MAX_LAYERS_FOR_VIEW
	Possible depth range.

static const int	MAX_DEPTH = 2*MAX_LAYERS_FOR_VIEW - 1

static const int	GRID_DEPTH = MAX_DEPTH - 1
	Depth level on which the grid is drawn.

Private Member Functions
double	getLayerDepth () const

Private Attributes
TEXT_ATTRIBUTES	m_attributes

Friends
class	GAL_CONTEXT_LOCKER

class	GAL_UPDATE_CONTEXT

class	GAL_DRAWING_CONTEXT

class	GAL_SCOPED_ATTRS

Detailed Description

Abstract interface for drawing on a 2D-surface.

The functions are optimized for drawing shapes of an EDA-program such as KiCad. Most methods are abstract and need to be implemented by a lower layer, for example by a Cairo or OpenGL implementation. Almost all methods use world coordinates as arguments. The board design is defined in world space units for drawing purposes these are transformed to screen units with this layer. So zooming is handled here as well.

Definition at line 62 of file graphics_abstraction_layer.h.

Constructor & Destructor Documentation

◆ GAL()

GAL::GAL ( GAL_DISPLAY_OPTIONS & aOptions )

Definition at line 40 of file graphics_abstraction_layer.cpp.

◆ ~GAL()

GAL::~GAL ( )

virtual

Definition at line 98 of file graphics_abstraction_layer.cpp.

Member Function Documentation

◆ AdvanceDepth()

void KIGFX::GAL::AdvanceDepth ( )

inline

Change the current depth to deeper, so it is possible to draw objects right beneath other.

If you do this, you should consider using a GAL_SCOPED_ATTR to ensure the depth is reset to the original value.

Definition at line 439 of file graphics_abstraction_layer.h.

◆ BeginDrawing()

virtual void KIGFX::GAL::BeginDrawing ( )

inlinevirtual

Start/end drawing functions, draw calls can be only made in between the calls to BeginDrawing()/EndDrawing().

Normally you should create a GAL_DRAWING_CONTEXT RAII object, but I'm leaving these functions public for more precise (i.e. timing/profiling) control of the drawing process - Tom Begin the drawing, needs to be called for every new frame. Use GAL_DRAWING_CONTEXT RAII object unless you know what you're doing.

Definition at line 1027 of file graphics_abstraction_layer.h.

◆ BeginGroup()

virtual int KIGFX::GAL::BeginGroup ( )

inlinevirtual

Begin a group.

A group is a collection of graphic items. Hierarchical groups are possible, attributes and transformations can be used.

Returns: the number of the group.

Definition at line 547 of file graphics_abstraction_layer.h.

◆ beginUpdate()

virtual void KIGFX::GAL::beginUpdate ( )

inlineprotectedvirtual

Enable item update mode.

Private: use GAL_UPDATE_CONTEXT RAII object

Definition at line 1036 of file graphics_abstraction_layer.h.

◆ BitmapText()

void GAL::BitmapText	(	const wxString &	aText,
		const VECTOR2I &	aPosition,
		const EDA_ANGLE &	aAngle )

virtual

Draw a text using a bitmap font.

It should be faster than StrokeText(), but can be used only for non-Gerber elements.

Parameters

aText	is the text to be drawn.
aPosition	is the text position in world coordinates.
aAngle	is the text rotation angle.

Definition at line 271 of file graphics_abstraction_layer.cpp.

◆ ChangeGroupColor()

virtual void KIGFX::GAL::ChangeGroupColor	(	int	aGroupNumber,
		const COLOR4D &	aNewColor )

inlinevirtual

Change the color used to draw the group.

Parameters

aGroupNumber	is the group number.
aNewColor	is the new color.

Definition at line 565 of file graphics_abstraction_layer.h.

◆ ChangeGroupDepth()

virtual void KIGFX::GAL::ChangeGroupDepth	(	int	aGroupNumber,
		int	aDepth )

inlinevirtual

Change the depth (Z-axis position) of the group.

Parameters

aGroupNumber	is the group number.
aDepth	is the new depth.

Definition at line 573 of file graphics_abstraction_layer.h.

◆ ClearCache()

virtual void KIGFX::GAL::ClearCache ( )

inlinevirtual

Delete all data created during caching of graphic items.

Definition at line 585 of file graphics_abstraction_layer.h.

◆ ClearScreen()

virtual void KIGFX::GAL::ClearScreen ( )

inlinevirtual

Clear the screen.

Parameters

aColor is the color used for clearing.

Definition at line 288 of file graphics_abstraction_layer.h.

◆ ClearTarget()

virtual void KIGFX::GAL::ClearTarget ( RENDER_TARGET aTarget )

inlinevirtual

Clear the target for rendering.

Parameters

aTarget is the target to be cleared.

Definition at line 723 of file graphics_abstraction_layer.h.

◆ computeMinGridSpacing()

double GAL::computeMinGridSpacing ( ) const

protected

Compute minimum grid spacing from the grid settings.

Returns: the minimum spacing to use for drawing the grid

Definition at line 218 of file graphics_abstraction_layer.cpp.

◆ computeWorldScale()

void KIGFX::GAL::computeWorldScale ( )

inlineprotected

Compute the scaling factor for the world->screen matrix.

Definition at line 1044 of file graphics_abstraction_layer.h.

◆ ComputeWorldScreenMatrix()

void GAL::ComputeWorldScreenMatrix ( )

virtual

Compute the world <-> screen transformation matrix.

Definition at line 173 of file graphics_abstraction_layer.cpp.

◆ DeleteGroup()

virtual void KIGFX::GAL::DeleteGroup ( int aGroupNumber )

inlinevirtual

Delete the group from the memory.

Parameters

aGroupNumber is the group number.

Definition at line 580 of file graphics_abstraction_layer.h.

◆ DrawArc()

virtual void KIGFX::GAL::DrawArc	(	const VECTOR2D &	aCenterPoint,
		double	aRadius,
		const EDA_ANGLE &	aStartAngle,
		const EDA_ANGLE &	aAngle )

inlinevirtual

Draw an arc.

Parameters

aCenterPoint	is the center point of the arc.
aRadius	is the arc radius.
aStartAngle	is the start angle of the arc.
aAngle	is the angle of the arc.

Definition at line 165 of file graphics_abstraction_layer.h.

◆ DrawArcSegment()

virtual void KIGFX::GAL::DrawArcSegment	(	const VECTOR2D &	aCenterPoint,
		double	aRadius,
		const EDA_ANGLE &	aStartAngle,
		const EDA_ANGLE &	aAngle,
		double	aWidth,
		double	aMaxError )

inlinevirtual

Draw an arc segment.

This method differs from DrawArc() in what happens when fill/stroke are on or off. DrawArc() draws a "pie piece" when fill is turned on, and a thick stroke when fill is off. DrawArcSegment() with fill on behaves like DrawArc() with fill off. DrawArcSegment() with fill off draws the outline of what it would have drawn with fill on.

This has meaning only for back ends that can't draw a true arc, and use segments to approximate.

TODO: Unify Arc routines

Parameters

aCenterPoint	is the center point of the arc.
aRadius	is the arc radius.
aStartAngle	is the start angle of the arc.
aAngle	is the angle of the arc.
aWidth	is the thickness of the arc (pen size).
aMaxError	is the max allowed error to create segments to approximate a circle.

Definition at line 188 of file graphics_abstraction_layer.h.

◆ DrawBitmap()

virtual void KIGFX::GAL::DrawBitmap	(	const BITMAP_BASE &	aBitmap,
		double	alphaBlend = 1.0 )

inlinevirtual

Draw a bitmap image.

Definition at line 249 of file graphics_abstraction_layer.h.

◆ DrawCircle()

virtual void KIGFX::GAL::DrawCircle	(	const VECTOR2D &	aCenterPoint,
		double	aRadius )

inlinevirtual

Draw a circle using world coordinates.

Parameters

aCenterPoint	is the center point of the circle.
aRadius	is the radius of the circle.

Definition at line 145 of file graphics_abstraction_layer.h.

◆ DrawCursor()

virtual void KIGFX::GAL::DrawCursor ( const VECTOR2D & aCursorPosition )

inlinevirtual

Draw the cursor.

Parameters

aCursorPosition is the cursor position in screen coordinates.

Definition at line 1001 of file graphics_abstraction_layer.h.

◆ DrawCurve()

virtual void KIGFX::GAL::DrawCurve	(	const VECTOR2D &	startPoint,
		const VECTOR2D &	controlPointA,
		const VECTOR2D &	controlPointB,
		const VECTOR2D &	endPoint,
		double	aFilterValue = 0.0 )

inlinevirtual

Draw a cubic bezier spline.

Parameters

startPoint	is the start point of the spline.
controlPointA	is the first control point.
controlPointB	is the second control point.
endPoint	is the end point of the spline.
aFilterValue	is used by Bezier to segments approximation, if the Bezier curve is not supported and needs a curve to polyline conversion. aFilterValue = 0 means no filtering.

Definition at line 242 of file graphics_abstraction_layer.h.

◆ DrawGlyph()

virtual void KIGFX::GAL::DrawGlyph	(	const KIFONT::GLYPH &	aGlyph,
		int	aNth = 0,
		int	aTotal = 1 )

inlinevirtual

Draw a polygon representing a font glyph.

Definition at line 208 of file graphics_abstraction_layer.h.

◆ DrawGlyphs()

virtual void KIGFX::GAL::DrawGlyphs ( const std::vector< std::unique_ptr< KIFONT::GLYPH > > & aGlyphs )

inlinevirtual

Draw polygons representing font glyphs.

Definition at line 213 of file graphics_abstraction_layer.h.

◆ DrawGrid()

virtual void KIGFX::GAL::DrawGrid ( )

inlinevirtual

Definition at line 926 of file graphics_abstraction_layer.h.

◆ DrawGroup()

virtual void KIGFX::GAL::DrawGroup ( int aGroupNumber )

inlinevirtual

Draw the stored group.

Parameters

aGroupNumber is the group number.

Definition at line 557 of file graphics_abstraction_layer.h.

◆ DrawHoleWall()

virtual void KIGFX::GAL::DrawHoleWall	(	const VECTOR2D &	aCenterPoint,
		double	aHoleRadius,
		double	aWallWidth )

inlinevirtual

Draw a hole wall ring.

Parameters

aCenterPoint	is the center point of the hole.
aHoleRadius	is the radius of the hole.
aWallWidth	is the wall thickness.

Definition at line 154 of file graphics_abstraction_layer.h.

◆ DrawLine()

virtual void KIGFX::GAL::DrawLine	(	const VECTOR2D &	aStartPoint,
		const VECTOR2D &	aEndPoint )

inlinevirtual

Draw a line.

Start and end points are defined as 2D-Vectors.

Parameters

aStartPoint	is the start point of the line.
aEndPoint	is the end point of the line.

Definition at line 99 of file graphics_abstraction_layer.h.

◆ DrawPolygon() [1/4]

virtual void KIGFX::GAL::DrawPolygon ( const SHAPE_LINE_CHAIN & aPolySet )

inlinevirtual

Definition at line 229 of file graphics_abstraction_layer.h.

◆ DrawPolygon() [2/4]

virtual void KIGFX::GAL::DrawPolygon	(	const SHAPE_POLY_SET &	aPolySet,
		bool	aStrokeTriangulation = false )

inlinevirtual

Definition at line 227 of file graphics_abstraction_layer.h.

◆ DrawPolygon() [3/4]

virtual void KIGFX::GAL::DrawPolygon ( const std::deque< VECTOR2D > & aPointList )

inlinevirtual

Draw a polygon.

Parameters

aPointList is the list of the polygon points.

Definition at line 225 of file graphics_abstraction_layer.h.

◆ DrawPolygon() [4/4]

virtual void KIGFX::GAL::DrawPolygon	(	const VECTOR2D	aPointList[],
		int	aListSize )

inlinevirtual

Definition at line 226 of file graphics_abstraction_layer.h.

◆ DrawPolyline() [1/4]

virtual void KIGFX::GAL::DrawPolyline ( const SHAPE_LINE_CHAIN & aLineChain )

inlinevirtual

Definition at line 130 of file graphics_abstraction_layer.h.

◆ DrawPolyline() [2/4]

virtual void KIGFX::GAL::DrawPolyline ( const std::deque< VECTOR2D > & aPointList )

inlinevirtual

Draw a polyline.

Parameters

aPointList is a list of 2D-Vectors containing the polyline points.

Definition at line 127 of file graphics_abstraction_layer.h.

◆ DrawPolyline() [3/4]

virtual void KIGFX::GAL::DrawPolyline ( const std::vector< VECTOR2D > & aPointList )

inlinevirtual

Definition at line 128 of file graphics_abstraction_layer.h.

◆ DrawPolyline() [4/4]

virtual void KIGFX::GAL::DrawPolyline	(	const VECTOR2D	aPointList[],
		int	aListSize )

inlinevirtual

Definition at line 129 of file graphics_abstraction_layer.h.

◆ DrawPolylines()

virtual void KIGFX::GAL::DrawPolylines ( const std::vector< std::vector< VECTOR2D > > & aPointLists )

inlinevirtual

Draw multiple polylines.

Parameters

aPointLists are lists of 2D-Vectors containing the polyline points.

Definition at line 137 of file graphics_abstraction_layer.h.

◆ DrawRectangle() [1/2]

void KIGFX::GAL::DrawRectangle ( const BOX2I & aRect )

inline

Definition at line 200 of file graphics_abstraction_layer.h.

◆ DrawRectangle() [2/2]

virtual void KIGFX::GAL::DrawRectangle	(	const VECTOR2D &	aStartPoint,
		const VECTOR2D &	aEndPoint )

inlinevirtual

Draw a rectangle.

Parameters

aStartPoint	is the start point of the rectangle.
aEndPoint	is the end point of the rectangle.

Definition at line 198 of file graphics_abstraction_layer.h.

◆ DrawSegment()

virtual void KIGFX::GAL::DrawSegment	(	const VECTOR2D &	aStartPoint,
		const VECTOR2D &	aEndPoint,
		double	aWidth )

inlinevirtual

Draw a rounded segment.

Start and end points are defined as 2D-Vectors.

Parameters

aStartPoint	is the start point of the segment.
aEndPoint	is the end point of the segment.
aWidth	is a width of the segment

Definition at line 110 of file graphics_abstraction_layer.h.

◆ DrawSegmentChain() [1/2]

virtual void KIGFX::GAL::DrawSegmentChain	(	const SHAPE_LINE_CHAIN &	aLineChain,
		double	aWidth )

inlinevirtual

Definition at line 120 of file graphics_abstraction_layer.h.

◆ DrawSegmentChain() [2/2]

virtual void KIGFX::GAL::DrawSegmentChain	(	const std::vector< VECTOR2D > &	aPointList,
		double	aWidth )

inlinevirtual

Draw a chain of rounded segments.

Parameters

aPointList	is a list of 2D-Vectors containing the chain points.
aWidth	is a width of the segments

Definition at line 119 of file graphics_abstraction_layer.h.

◆ EnableDepthTest()

virtual void KIGFX::GAL::EnableDepthTest ( bool aEnabled = false )

inlinevirtual

Definition at line 1003 of file graphics_abstraction_layer.h.

◆ EndDiffLayer()

virtual void KIGFX::GAL::EndDiffLayer ( )

inlinevirtual

Ends rendering of a differential layer.

Objects drawn after the StartDiffLayer() will be drawn and composited with a differential blend mode, then drawing is returned to normal.

Definition at line 762 of file graphics_abstraction_layer.h.

◆ EndDrawing()

virtual void KIGFX::GAL::EndDrawing ( )

inlinevirtual

End the drawing, needs to be called for every new frame.

Use GAL_DRAWING_CONTEXT RAII object unless you know what you're doing.

Definition at line 1031 of file graphics_abstraction_layer.h.

◆ EndGroup()

virtual void KIGFX::GAL::EndGroup ( )

inlinevirtual

End the group.

Definition at line 550 of file graphics_abstraction_layer.h.

◆ EndNegativesLayer()

virtual void KIGFX::GAL::EndNegativesLayer ( )

inlinevirtual

Ends rendering of a negatives layer and draws it to the main layer.

No-op in OpenGL.

Definition at line 778 of file graphics_abstraction_layer.h.

◆ endUpdate()

virtual void KIGFX::GAL::endUpdate ( )

inlineprotectedvirtual

Disable item update mode.

Definition at line 1039 of file graphics_abstraction_layer.h.

◆ Flush()

virtual void KIGFX::GAL::Flush ( )

inlinevirtual

Force all remaining objects to be drawn.

Definition at line 271 of file graphics_abstraction_layer.h.

◆ GetClearColor()

const COLOR4D & KIGFX::GAL::GetClearColor ( ) const

inline

Definition at line 278 of file graphics_abstraction_layer.h.

◆ getCursorColor()

COLOR4D GAL::getCursorColor ( ) const

protected

Get the actual cursor color to draw.

Definition at line 258 of file graphics_abstraction_layer.cpp.

◆ GetFillColor()

const COLOR4D & KIGFX::GAL::GetFillColor ( ) const

inline

Get the fill color.

Returns: the color for filling a outline.

Definition at line 349 of file graphics_abstraction_layer.h.

◆ GetGlyphSize()

const VECTOR2I & KIGFX::GAL::GetGlyphSize ( ) const

inline

Definition at line 468 of file graphics_abstraction_layer.h.

◆ GetGridLineWidth()

float KIGFX::GAL::GetGridLineWidth ( ) const

inline

Get the grid line width.

Returns: the grid line width Draw the grid

Definition at line 920 of file graphics_abstraction_layer.h.

◆ GetGridOrigin()

const VECTOR2D & KIGFX::GAL::GetGridOrigin ( ) const

inline

Definition at line 819 of file graphics_abstraction_layer.h.

◆ GetGridPoint()

VECTOR2D GAL::GetGridPoint ( const VECTOR2D & aPoint ) const

For a given point it returns the nearest point belonging to the grid in world coordinates.

Parameters

aPoint is the point for which the grid point is searched.

Returns: The nearest grid point in world coordinates.

Definition at line 226 of file graphics_abstraction_layer.cpp.

◆ GetGridSize()

const VECTOR2D & KIGFX::GAL::GetGridSize ( ) const

inline

Return the grid size.

Returns: A vector containing the grid size in x and y direction.

Definition at line 846 of file graphics_abstraction_layer.h.

◆ GetGridSnapping()

bool KIGFX::GAL::GetGridSnapping ( ) const

inline

Definition at line 793 of file graphics_abstraction_layer.h.

◆ GetGridVisibility()

bool KIGFX::GAL::GetGridVisibility ( ) const

inline

Definition at line 791 of file graphics_abstraction_layer.h.

◆ GetHorizontalJustify()

GR_TEXT_H_ALIGN_T KIGFX::GAL::GetHorizontalJustify ( ) const

inline

Definition at line 487 of file graphics_abstraction_layer.h.

◆ GetIsFill()

bool KIGFX::GAL::GetIsFill ( ) const

inline

Get the fill status.

Returns: true if fill is enabled, false otherwise.

Definition at line 309 of file graphics_abstraction_layer.h.

◆ GetIsStroke()

bool KIGFX::GAL::GetIsStroke ( ) const

inline

Get the stroke status.

Returns: true if stroke is enabled, false otherwise.

Definition at line 329 of file graphics_abstraction_layer.h.

◆ getLayerDepth()

double KIGFX::GAL::getLayerDepth ( ) const

inlineprivate

Definition at line 1160 of file graphics_abstraction_layer.h.

◆ GetLineWidth()

float KIGFX::GAL::GetLineWidth ( ) const

inline

Get the line width.

Returns: the actual line width.

Definition at line 399 of file graphics_abstraction_layer.h.

◆ GetLookAtPoint()

const VECTOR2D & KIGFX::GAL::GetLookAtPoint ( ) const

inline

Definition at line 655 of file graphics_abstraction_layer.h.

◆ GetMaxDepth()

double KIGFX::GAL::GetMaxDepth ( ) const

inline

Definition at line 676 of file graphics_abstraction_layer.h.

◆ GetMinDepth()

double KIGFX::GAL::GetMinDepth ( ) const

inline

Definition at line 675 of file graphics_abstraction_layer.h.

◆ GetMinLineWidth()

float KIGFX::GAL::GetMinLineWidth ( ) const

inline

Get the minimum line width in pixels.

Returns: the minimum line width.

Definition at line 409 of file graphics_abstraction_layer.h.

◆ GetRotation()

double KIGFX::GAL::GetRotation ( ) const

inline

Definition at line 664 of file graphics_abstraction_layer.h.

◆ GetScreenDPI()

double KIGFX::GAL::GetScreenDPI ( ) const

inline

Definition at line 647 of file graphics_abstraction_layer.h.

◆ GetScreenPixelSize()

const VECTOR2I & KIGFX::GAL::GetScreenPixelSize ( ) const

inline

Return GAL canvas size in pixels.

Definition at line 262 of file graphics_abstraction_layer.h.

◆ GetScreenWorldMatrix()

const MATRIX3x3D & KIGFX::GAL::GetScreenWorldMatrix ( ) const

inline

Get the screen <-> world transformation matrix.

Returns: the transformation matrix.

Definition at line 609 of file graphics_abstraction_layer.h.

◆ GetStrokeColor()

const COLOR4D & KIGFX::GAL::GetStrokeColor ( ) const

inline

Get the stroke color.

Returns: the color for stroking the outline.

Definition at line 369 of file graphics_abstraction_layer.h.

◆ GetSwapInterval()

virtual int KIGFX::GAL::GetSwapInterval ( ) const

inlinevirtual

Return the swap interval. -1 for adaptive, 0 for disabled/unknown.

Definition at line 268 of file graphics_abstraction_layer.h.

◆ GetTarget()

virtual RENDER_TARGET KIGFX::GAL::GetTarget ( ) const

inlinevirtual

Get the currently used target for rendering.

Returns: The current rendering target.

Definition at line 716 of file graphics_abstraction_layer.h.

◆ GetVerticalJustify()

GR_TEXT_V_ALIGN_T KIGFX::GAL::GetVerticalJustify ( ) const

inline

Definition at line 494 of file graphics_abstraction_layer.h.

◆ GetVisibleGridSize()

VECTOR2D KIGFX::GAL::GetVisibleGridSize ( ) const

inline

Return the visible grid size in x and y directions.

Returns: A vector containing the spacing of visible grid marks

Definition at line 856 of file graphics_abstraction_layer.h.

◆ GetVisibleWorldExtents()

BOX2D GAL::GetVisibleWorldExtents ( ) const

Returns: the bounding box of the world that is displayed on screen at the moment

Definition at line 203 of file graphics_abstraction_layer.cpp.

◆ GetWorldScale()

double KIGFX::GAL::GetWorldScale ( ) const

inline

Get the world scale.

Returns: the actual world scale factor.

Definition at line 683 of file graphics_abstraction_layer.h.

◆ GetWorldScreenMatrix()

const MATRIX3x3D & KIGFX::GAL::GetWorldScreenMatrix ( ) const

inline

Get the world <-> screen transformation matrix.

Returns: the transformation matrix.

Definition at line 599 of file graphics_abstraction_layer.h.

◆ GetZoomFactor()

double KIGFX::GAL::GetZoomFactor ( ) const

inline

Definition at line 658 of file graphics_abstraction_layer.h.

◆ HasTarget()

virtual bool KIGFX::GAL::HasTarget ( RENDER_TARGET aTarget )

inlinevirtual

Return true if the target exists.

Parameters

aTarget is the target to be checked.

Definition at line 730 of file graphics_abstraction_layer.h.

◆ IsCairoEngine()

virtual bool KIGFX::GAL::IsCairoEngine ( )

inlinevirtual

Return true if the GAL engine is a Cairo based type.

Definition at line 82 of file graphics_abstraction_layer.h.

◆ IsContextLocked()

virtual bool KIGFX::GAL::IsContextLocked ( )

inlinevirtual

Checks the state of the context lock.

Returns: True if the context is currently locked

Definition at line 1009 of file graphics_abstraction_layer.h.

◆ IsCursorEnabled()

bool KIGFX::GAL::IsCursorEnabled ( ) const

inline

Return information about cursor visibility.

Returns: True if cursor is visible.

Definition at line 981 of file graphics_abstraction_layer.h.

◆ IsFlippedX()

bool KIGFX::GAL::IsFlippedX ( ) const

inline

Definition at line 697 of file graphics_abstraction_layer.h.

◆ IsFlippedY()

bool KIGFX::GAL::IsFlippedY ( ) const

inline

Definition at line 698 of file graphics_abstraction_layer.h.

◆ IsFontBold()

bool KIGFX::GAL::IsFontBold ( ) const

inline

Definition at line 471 of file graphics_abstraction_layer.h.

◆ IsFontItalic()

bool KIGFX::GAL::IsFontItalic ( ) const

inline

Definition at line 474 of file graphics_abstraction_layer.h.

◆ IsFontUnderlined()

bool KIGFX::GAL::IsFontUnderlined ( ) const

inline

Definition at line 477 of file graphics_abstraction_layer.h.

◆ IsInitialized()

virtual bool KIGFX::GAL::IsInitialized ( ) const

inlinevirtual

Return the initialization status for the canvas.

Definition at line 76 of file graphics_abstraction_layer.h.

◆ IsOpenGlEngine()

virtual bool KIGFX::GAL::IsOpenGlEngine ( )

inlinevirtual

Return true if the GAL engine is a OpenGL based type.

Definition at line 85 of file graphics_abstraction_layer.h.

◆ IsTextMirrored()

bool KIGFX::GAL::IsTextMirrored ( ) const

inline

Definition at line 480 of file graphics_abstraction_layer.h.

◆ IsVisible()

virtual bool KIGFX::GAL::IsVisible ( ) const

inlinevirtual

Return true if the GAL canvas is visible on the screen.

Definition at line 79 of file graphics_abstraction_layer.h.

◆ LockContext()

virtual void KIGFX::GAL::LockContext ( int aClientCookie )

inlinevirtual

Use GAL_CONTEXT_LOCKER RAII object unless you know what you're doing.

Definition at line 1016 of file graphics_abstraction_layer.h.

◆ normalize()

template<typename T>

void KIGFX::GAL::normalize	(	T &	a,
		T &	b )

inlineprotected

Ensure that the first element is smaller than the second.

Definition at line 1093 of file graphics_abstraction_layer.h.

◆ OnGalDisplayOptionsChanged()

void GAL::OnGalDisplayOptionsChanged ( const GAL_DISPLAY_OPTIONS & aOptions )

overrideprotected

Handler for observer settings changes.

Definition at line 103 of file graphics_abstraction_layer.cpp.

◆ ResetTextAttributes()

void GAL::ResetTextAttributes ( )

Reset text attributes to default styling.

FONT TODO: do we need any of this in GAL anymore?

Normally, custom attributes will be set individually after this, otherwise you can use SetTextAttributes()

Definition at line 157 of file graphics_abstraction_layer.cpp.

◆ ResizeScreen()

virtual void KIGFX::GAL::ResizeScreen	(	int	aWidth,
		int	aHeight )

inlinevirtual

Resize the canvas.

Definition at line 256 of file graphics_abstraction_layer.h.

◆ Restore()

virtual void KIGFX::GAL::Restore ( )

inlinevirtual

Restore the context.

Definition at line 533 of file graphics_abstraction_layer.h.

◆ Rotate()

virtual void KIGFX::GAL::Rotate ( double aAngle )

inlinevirtual

Rotate the context.

Parameters

aAngle is the rotation angle in radians.

Definition at line 513 of file graphics_abstraction_layer.h.

◆ Save()

virtual void KIGFX::GAL::Save ( )

inlinevirtual

Save the context.

Definition at line 530 of file graphics_abstraction_layer.h.

◆ Scale()

virtual void KIGFX::GAL::Scale ( const VECTOR2D & aScale )

inlinevirtual

Scale the context.

Parameters

aScale is the scale factor for the x- and y-axis.

Definition at line 527 of file graphics_abstraction_layer.h.

◆ SetAxesColor()

void KIGFX::GAL::SetAxesColor ( const COLOR4D & aAxesColor )

inline

Set the axes color.

Parameters

aAxesColor is the color to draw the axes if enabled.

Definition at line 892 of file graphics_abstraction_layer.h.

◆ SetAxesEnabled()

void KIGFX::GAL::SetAxesEnabled ( bool aAxesEnabled )

inline

Enable drawing the axes.

Definition at line 900 of file graphics_abstraction_layer.h.

◆ SetClearColor()

void KIGFX::GAL::SetClearColor ( const COLOR4D & aColor )

inline

Definition at line 273 of file graphics_abstraction_layer.h.

◆ SetCoarseGrid()

void KIGFX::GAL::SetCoarseGrid ( int aInterval )

inline

Draw every tick line wider.

Parameters

aInterval increase the width of every aInterval line, if 0 do not use this feature.

Definition at line 910 of file graphics_abstraction_layer.h.

◆ SetCursorColor()

void KIGFX::GAL::SetCursorColor ( const COLOR4D & aCursorColor )

inline

Set the cursor color.

Parameters

aCursorColor is the color of the cursor.

Definition at line 991 of file graphics_abstraction_layer.h.

◆ SetCursorEnabled()

void KIGFX::GAL::SetCursorEnabled ( bool aCursorEnabled )

inline

Enable/disable cursor.

Parameters

aCursorEnabled is true if the cursor should be drawn, else false.

Definition at line 971 of file graphics_abstraction_layer.h.

◆ SetDepthRange()

void KIGFX::GAL::SetDepthRange ( const VECTOR2D & aDepthRange )

inline

Set the range of the layer depth.

Usually required for the OpenGL implementation, any object outside this range is not drawn.

The MinDepth (x) is closest to the clipping plane (top) while the MaxDepth (y) is farthest from the clipping plane (bottom).

Definition at line 674 of file graphics_abstraction_layer.h.

◆ SetFillColor()

virtual void KIGFX::GAL::SetFillColor ( const COLOR4D & aColor )

inlinevirtual

Set the fill color.

Parameters

aColor is the color for filling.

Definition at line 339 of file graphics_abstraction_layer.h.

◆ SetFlip()

void KIGFX::GAL::SetFlip	(	bool	xAxis,
		bool	yAxis )

inline

Sets flipping of the screen.

Parameters

xAxis	is the flip flag for the X axis.
yAxis	is the flip flag for the Y axis.

Definition at line 691 of file graphics_abstraction_layer.h.

◆ SetFontBold()

void KIGFX::GAL::SetFontBold ( const bool aBold )

inline

Definition at line 470 of file graphics_abstraction_layer.h.

◆ SetFontItalic()

void KIGFX::GAL::SetFontItalic ( bool aItalic )

inline

Definition at line 473 of file graphics_abstraction_layer.h.

◆ SetFontUnderlined()

void KIGFX::GAL::SetFontUnderlined ( bool aUnderlined )

inline

Definition at line 476 of file graphics_abstraction_layer.h.

◆ SetGlyphSize()

void KIGFX::GAL::SetGlyphSize ( const VECTOR2I aSize )

inline

Definition at line 467 of file graphics_abstraction_layer.h.

◆ SetGridColor()

void KIGFX::GAL::SetGridColor ( const COLOR4D & aGridColor )

inline

Set the grid color.

Parameters

aGridColor is the grid color, it should have a low alpha value for the best effect.

Definition at line 882 of file graphics_abstraction_layer.h.

◆ SetGridOrigin()

void KIGFX::GAL::SetGridOrigin ( const VECTOR2D & aGridOrigin )

inline

Set the origin point for the grid.

Parameters

aGridOrigin is a vector containing the grid origin point, in world coordinates.

Definition at line 804 of file graphics_abstraction_layer.h.

◆ SetGridSize()

void KIGFX::GAL::SetGridSize ( const VECTOR2D & aGridSize )

inline

Set the grid size.

Parameters

aGridSize is a vector containing the grid size in x and y direction.

Definition at line 829 of file graphics_abstraction_layer.h.

◆ SetGridVisibility()

void KIGFX::GAL::SetGridVisibility ( bool aVisibility )

inline

Set the visibility setting of the grid.

Parameters

aVisibility is the new visibility setting of the grid.

Definition at line 789 of file graphics_abstraction_layer.h.

◆ SetHorizontalJustify()

void KIGFX::GAL::SetHorizontalJustify ( const GR_TEXT_H_ALIGN_T aHorizontalJustify )

inline

Definition at line 482 of file graphics_abstraction_layer.h.

◆ SetIsFill()

virtual void KIGFX::GAL::SetIsFill ( bool aIsFillEnabled )

inlinevirtual

Enable/disable fill.

Parameters

aIsFillEnabled is true, when the graphics objects should be filled, else false.

Definition at line 299 of file graphics_abstraction_layer.h.

◆ SetIsStroke()

virtual void KIGFX::GAL::SetIsStroke ( bool aIsStrokeEnabled )

inlinevirtual

Enable/disable stroked outlines.

Parameters

aIsStrokeEnabled is true, if the outline of an object should be stroked.

Definition at line 319 of file graphics_abstraction_layer.h.

◆ SetLayerDepth()

virtual void KIGFX::GAL::SetLayerDepth ( double aLayerDepth )

inlinevirtual

Set the depth of the layer (position on the z-axis)

If you do this, you should consider using a GAL_SCOPED_ATTR to ensure the depth is reset to the original value.

Parameters

aLayerDepth the layer depth for the objects. Smaller is closer to the viewer.

Definition at line 422 of file graphics_abstraction_layer.h.

◆ SetLineWidth()

virtual void KIGFX::GAL::SetLineWidth ( float aLineWidth )

inlinevirtual

Set the line width.

Parameters

aLineWidth is the line width.

Definition at line 379 of file graphics_abstraction_layer.h.

◆ SetLookAtPoint()

void KIGFX::GAL::SetLookAtPoint ( const VECTOR2D & aPoint )

inline

Get/set the Point in world space to look at.

This point corresponds with the center of the actual drawing area.

Definition at line 654 of file graphics_abstraction_layer.h.

◆ SetMinLineWidth()

virtual void KIGFX::GAL::SetMinLineWidth ( float aLineWidth )

inlinevirtual

Set the minimum line width in pixels.

Parameters

aLineWidth is the minimum line width.

Definition at line 389 of file graphics_abstraction_layer.h.

◆ SetNativeCursorStyle()

bool GAL::SetNativeCursorStyle	(	KICURSOR	aCursor,
		bool	aHiDPI )

virtual

Set the cursor in the native panel.

Parameters

aCursor is the cursor to use in the native panel

Returns: true if the cursor was updated, false if the cursor given was already set

Definition at line 291 of file graphics_abstraction_layer.cpp.

◆ SetNegativeDrawMode()

virtual void KIGFX::GAL::SetNegativeDrawMode ( bool aSetting )

inlinevirtual

Set negative draw mode in the renderer.

When negative mode is enabled, drawn items will subtract from previously drawn items. This is mainly needed for Gerber negative item support in Cairo, since unlike in OpenGL, objects drawn with zero opacity on top of other objects would not normally mask objects in Cairo. This method is a no-op in OpenGL.

Parameters

aSetting is true if negative mode should be enabled

Definition at line 746 of file graphics_abstraction_layer.h.

◆ SetRotation()

void KIGFX::GAL::SetRotation ( double aRotation )

inline

Get/set the rotation angle (in radians).

Definition at line 663 of file graphics_abstraction_layer.h.

◆ SetScreenDPI()

void KIGFX::GAL::SetScreenDPI ( double aScreenDPI )

inline

Set the dots per inch of the screen.

This value depends on the user screen, it should be configurable by the application. For instance a typical notebook with HD+ resolution (1600x900) has 106 DPI.

Definition at line 646 of file graphics_abstraction_layer.h.

◆ SetScreenSize()

void KIGFX::GAL::SetScreenSize ( const VECTOR2I & aSize )

inline

Definition at line 638 of file graphics_abstraction_layer.h.

◆ SetStrokeColor()

virtual void KIGFX::GAL::SetStrokeColor ( const COLOR4D & aColor )

inlinevirtual

Set the stroke color.

Parameters

aColor is the color for stroking the outline.

Definition at line 359 of file graphics_abstraction_layer.h.

◆ SetTarget()

virtual void KIGFX::GAL::SetTarget ( RENDER_TARGET aTarget )

inlinevirtual

Set the target for rendering.

Parameters

aTarget is the new target for rendering.

Definition at line 709 of file graphics_abstraction_layer.h.

◆ SetTextMirrored()

void KIGFX::GAL::SetTextMirrored ( const bool aMirrored )

inline

Definition at line 479 of file graphics_abstraction_layer.h.

◆ SetVerticalJustify()

void KIGFX::GAL::SetVerticalJustify ( const GR_TEXT_V_ALIGN_T aVerticalJustify )

inline

Definition at line 489 of file graphics_abstraction_layer.h.

◆ SetWorldScreenMatrix()

void KIGFX::GAL::SetWorldScreenMatrix ( const MATRIX3x3D & aMatrix )

inline

Set the world <-> screen transformation matrix.

Parameters

aMatrix is the 3x3 world <-> screen transformation matrix.

Definition at line 619 of file graphics_abstraction_layer.h.

◆ SetWorldUnitLength()

void KIGFX::GAL::SetWorldUnitLength ( double aWorldUnitLength )

inline

Set the unit length.

This defines the length [inch] per one integer. For instance a value 0.001 means that the coordinate [1000, 1000] corresponds with a point at (1 inch, 1 inch) or 1 mil resolution per integer.

Definition at line 636 of file graphics_abstraction_layer.h.

◆ SetZoomFactor()

void KIGFX::GAL::SetZoomFactor ( double aZoomFactor )

inline

Definition at line 657 of file graphics_abstraction_layer.h.

◆ Show()

virtual bool KIGFX::GAL::Show ( bool aShow )

inlinevirtual

Show/hide the GAL canvas.

Definition at line 259 of file graphics_abstraction_layer.h.

◆ StartDiffLayer()

virtual void KIGFX::GAL::StartDiffLayer ( )

inlinevirtual

Begins rendering of a differential layer.

Used by gerbview's differential mode.

Differential layers have their drawn objects blended onto the lower layers differently so we need to end drawing of current objects and start a new set to be completed with a different blend mode.

Definition at line 755 of file graphics_abstraction_layer.h.

◆ StartNegativesLayer()

virtual void KIGFX::GAL::StartNegativesLayer ( )

inlinevirtual

Begins rendering in a new layer that will be copied to the main layer in EndNegativesLayer().

For Cairo, layers with negative items need a new layer so when negative layers _CLEAR sections it doesn't delete drawings on layers below them. No-op in OpenGL

Definition at line 772 of file graphics_abstraction_layer.h.

◆ ToScreen()

VECTOR2D KIGFX::GAL::ToScreen ( const VECTOR2D & aPoint ) const

inline

Compute the point position in screen coordinates from given world coordinates.

Parameters

aPoint the point position in world coordinates.

Returns: the point position in screen coordinates.

Definition at line 953 of file graphics_abstraction_layer.h.

◆ ToWorld()

VECTOR2D KIGFX::GAL::ToWorld ( const VECTOR2D & aPoint ) const

inline

Compute the point position in world coordinates from given screen coordinates.

Parameters

aPoint the point position in screen coordinates.

Returns: the point position in world coordinates.

Definition at line 942 of file graphics_abstraction_layer.h.

◆ Transform()

virtual void KIGFX::GAL::Transform ( const MATRIX3x3D & aTransformation )

inlinevirtual

Transform the context.

Parameters

aTransformation is the transformation matrix.

Definition at line 506 of file graphics_abstraction_layer.h.

◆ Translate()

virtual void KIGFX::GAL::Translate ( const VECTOR2D & aTranslation )

inlinevirtual

Translate the context.

Parameters

aTranslation is the translation vector.

Definition at line 520 of file graphics_abstraction_layer.h.

◆ UnlockContext()

virtual void KIGFX::GAL::UnlockContext ( int aClientCookie )

inlinevirtual

Definition at line 1018 of file graphics_abstraction_layer.h.

◆ updatedGalDisplayOptions()

bool GAL::updatedGalDisplayOptions ( const GAL_DISPLAY_OPTIONS & aOptions )

protectedvirtual

Handle updating display options.

Derived classes should call up to this to set base-class methods.

Returns: true if the new settings changed something. Derived classes can use this information to refresh themselves

Definition at line 112 of file graphics_abstraction_layer.cpp.

Friends And Related Symbol Documentation

◆ GAL_CONTEXT_LOCKER

friend class GAL_CONTEXT_LOCKER

friend

Definition at line 66 of file graphics_abstraction_layer.h.

◆ GAL_DRAWING_CONTEXT

friend class GAL_DRAWING_CONTEXT

friend

Definition at line 68 of file graphics_abstraction_layer.h.

◆ GAL_SCOPED_ATTRS

friend class GAL_SCOPED_ATTRS

friend

Definition at line 1167 of file graphics_abstraction_layer.h.

◆ GAL_UPDATE_CONTEXT

friend class GAL_UPDATE_CONTEXT

friend

Definition at line 67 of file graphics_abstraction_layer.h.

Member Data Documentation

◆ GRID_DEPTH

const int GAL::GRID_DEPTH = MAX_DEPTH - 1

staticprotected

Depth level on which the grid is drawn.

Definition at line 1064 of file graphics_abstraction_layer.h.

◆ m_attributes

TEXT_ATTRIBUTES KIGFX::GAL::m_attributes

private

Definition at line 1165 of file graphics_abstraction_layer.h.

◆ m_axesColor

COLOR4D KIGFX::GAL::m_axesColor

protected

Color of the axes.

Definition at line 1142 of file graphics_abstraction_layer.h.

◆ m_axesEnabled

bool KIGFX::GAL::m_axesEnabled

protected

Should the axes be drawn.

Definition at line 1143 of file graphics_abstraction_layer.h.

◆ m_clearColor

COLOR4D KIGFX::GAL::m_clearColor

protected

Definition at line 1130 of file graphics_abstraction_layer.h.

◆ m_crossHairMode

KIGFX::CROSS_HAIR_MODE KIGFX::GAL::m_crossHairMode

protected

Crosshair drawing mode.

Definition at line 1153 of file graphics_abstraction_layer.h.

◆ m_currentNativeCursor

KICURSOR KIGFX::GAL::m_currentNativeCursor

protected

Current cursor.

Definition at line 1156 of file graphics_abstraction_layer.h.

◆ m_cursorColor

COLOR4D KIGFX::GAL::m_cursorColor

protected

Cursor color.

Definition at line 1152 of file graphics_abstraction_layer.h.

◆ m_cursorPosition

VECTOR2D KIGFX::GAL::m_cursorPosition

protected

Current cursor position (world coordinates)

Definition at line 1154 of file graphics_abstraction_layer.h.

◆ m_depthRange

VECTOR2D KIGFX::GAL::m_depthRange

protected

Range of the depth.

Definition at line 1133 of file graphics_abstraction_layer.h.

◆ m_depthStack

std::stack<double> KIGFX::GAL::m_depthStack

protected

Stored depth values.

Definition at line 1106 of file graphics_abstraction_layer.h.

◆ m_fillColor

COLOR4D KIGFX::GAL::m_fillColor

protected

The fill color.

Definition at line 1128 of file graphics_abstraction_layer.h.

◆ m_forceDisplayCursor

bool KIGFX::GAL::m_forceDisplayCursor

protected

Always show cursor.

Definition at line 1151 of file graphics_abstraction_layer.h.

◆ m_globalFlipX

bool KIGFX::GAL::m_globalFlipX

protected

Flag for X axis flipping.

Definition at line 1119 of file graphics_abstraction_layer.h.

◆ m_globalFlipY

bool KIGFX::GAL::m_globalFlipY

protected

Flag for Y axis flipping.

Definition at line 1120 of file graphics_abstraction_layer.h.

◆ m_gridColor

COLOR4D KIGFX::GAL::m_gridColor

protected

Color of the grid.

Definition at line 1141 of file graphics_abstraction_layer.h.

◆ m_gridLineWidth

float KIGFX::GAL::m_gridLineWidth

protected

Line width of the grid.

Definition at line 1145 of file graphics_abstraction_layer.h.

◆ m_gridMinSpacing

int KIGFX::GAL::m_gridMinSpacing

protected

Minimum screen size of the grid (pixels) below which the grid is not drawn.

Definition at line 1146 of file graphics_abstraction_layer.h.

◆ m_gridOffset

VECTOR2D KIGFX::GAL::m_gridOffset

protected

The grid offset to compensate cursor position.

Definition at line 1140 of file graphics_abstraction_layer.h.

◆ m_gridOrigin

VECTOR2D KIGFX::GAL::m_gridOrigin

protected

The grid origin.

Definition at line 1139 of file graphics_abstraction_layer.h.

◆ m_gridSize

VECTOR2D KIGFX::GAL::m_gridSize

protected

The grid size.

Definition at line 1138 of file graphics_abstraction_layer.h.

◆ m_gridStyle

GRID_STYLE KIGFX::GAL::m_gridStyle

protected

Grid display style.

Definition at line 1137 of file graphics_abstraction_layer.h.

◆ m_gridTick

int KIGFX::GAL::m_gridTick

protected

Every tick line gets the double width.

Definition at line 1144 of file graphics_abstraction_layer.h.

◆ m_gridVisibility

bool KIGFX::GAL::m_gridVisibility

protected

Should the grid be shown.

Definition at line 1136 of file graphics_abstraction_layer.h.

◆ m_isCursorEnabled

bool KIGFX::GAL::m_isCursorEnabled

protected

Is the cursor enabled?

Definition at line 1150 of file graphics_abstraction_layer.h.

◆ m_isFillEnabled

bool KIGFX::GAL::m_isFillEnabled

protected

Is filling of graphic objects enabled ?

Definition at line 1125 of file graphics_abstraction_layer.h.

◆ m_isStrokeEnabled

bool KIGFX::GAL::m_isStrokeEnabled

protected

Are the outlines stroked ?

Definition at line 1126 of file graphics_abstraction_layer.h.

◆ m_layerDepth

double KIGFX::GAL::m_layerDepth

protected

The actual layer depth.

Definition at line 1132 of file graphics_abstraction_layer.h.

◆ m_lineWidth

float KIGFX::GAL::m_lineWidth

protected

The line width.

Definition at line 1122 of file graphics_abstraction_layer.h.

◆ m_lookAtPoint

VECTOR2D KIGFX::GAL::m_lookAtPoint

protected

Point to be looked at in world space.

Definition at line 1111 of file graphics_abstraction_layer.h.

◆ m_minLineWidth

float KIGFX::GAL::m_minLineWidth

protected

Minimum line width in pixels.

Definition at line 1123 of file graphics_abstraction_layer.h.

◆ m_observerLink

UTIL::LINK KIGFX::GAL::m_observerLink

protected

Definition at line 1104 of file graphics_abstraction_layer.h.

◆ m_options

GAL_DISPLAY_OPTIONS& KIGFX::GAL::m_options

protected

Definition at line 1103 of file graphics_abstraction_layer.h.

◆ m_rotation

double KIGFX::GAL::m_rotation

protected

Rotation transformation (radians)

Definition at line 1114 of file graphics_abstraction_layer.h.

◆ m_screenDPI

double KIGFX::GAL::m_screenDPI

protected

The dots per inch of the screen.

Definition at line 1110 of file graphics_abstraction_layer.h.

◆ m_screenSize

VECTOR2I KIGFX::GAL::m_screenSize

protected

Screen size in screen (wx logical) coordinates.

Definition at line 1107 of file graphics_abstraction_layer.h.

◆ m_screenWorldMatrix

MATRIX3x3D KIGFX::GAL::m_screenWorldMatrix

protected

Screen transformation.

Definition at line 1116 of file graphics_abstraction_layer.h.

◆ m_strokeColor

COLOR4D KIGFX::GAL::m_strokeColor

protected

The color of the outlines.

Definition at line 1129 of file graphics_abstraction_layer.h.

◆ m_worldScale

double KIGFX::GAL::m_worldScale

protected

The scale factor world->screen.

Definition at line 1117 of file graphics_abstraction_layer.h.

◆ m_worldScreenMatrix

MATRIX3x3D KIGFX::GAL::m_worldScreenMatrix

protected

World transformation.

Definition at line 1115 of file graphics_abstraction_layer.h.

◆ m_worldUnitLength

double KIGFX::GAL::m_worldUnitLength

protected

The unit length of the world coordinates [inch].

Definition at line 1109 of file graphics_abstraction_layer.h.

◆ m_zoomFactor

double KIGFX::GAL::m_zoomFactor

protected

The zoom factor.

Definition at line 1113 of file graphics_abstraction_layer.h.

◆ MAX_DEPTH

const int GAL::MAX_DEPTH = 2*MAX_LAYERS_FOR_VIEW - 1

staticprotected

Definition at line 1061 of file graphics_abstraction_layer.h.

◆ MIN_DEPTH

const int GAL::MIN_DEPTH = -2*MAX_LAYERS_FOR_VIEW

staticprotected

Possible depth range.

Definition at line 1060 of file graphics_abstraction_layer.h.

The documentation for this class was generated from the following files:

Public Member Functions

Protected Member Functions

Protected Attributes

Static Protected Attributes

Private Member Functions

Private Attributes

Friends

Detailed Description

Constructor & Destructor Documentation

◆ GAL()

◆ ~GAL()

Member Function Documentation

◆ AdvanceDepth()

◆ BeginDrawing()

◆ BeginGroup()

◆ beginUpdate()

◆ BitmapText()

◆ ChangeGroupColor()

◆ ChangeGroupDepth()

◆ ClearCache()

◆ ClearScreen()

◆ ClearTarget()

◆ computeMinGridSpacing()

◆ computeWorldScale()

◆ ComputeWorldScreenMatrix()

◆ DeleteGroup()

◆ DrawArc()

◆ DrawArcSegment()

◆ DrawBitmap()

◆ DrawCircle()

◆ DrawCursor()

◆ DrawCurve()

◆ DrawGlyph()

◆ DrawGlyphs()

◆ DrawGrid()

◆ DrawGroup()

◆ DrawHoleWall()

◆ DrawLine()

◆ DrawPolygon() [1/4]

◆ DrawPolygon() [2/4]

◆ DrawPolygon() [3/4]

◆ DrawPolygon() [4/4]

◆ DrawPolyline() [1/4]

◆ DrawPolyline() [2/4]

◆ DrawPolyline() [3/4]

◆ DrawPolyline() [4/4]

◆ DrawPolylines()

◆ DrawRectangle() [1/2]

◆ DrawRectangle() [2/2]

◆ DrawSegment()

◆ DrawSegmentChain() [1/2]

◆ DrawSegmentChain() [2/2]

◆ EnableDepthTest()

◆ EndDiffLayer()

◆ EndDrawing()

◆ EndGroup()

◆ EndNegativesLayer()

◆ endUpdate()

◆ Flush()

◆ GetClearColor()

◆ getCursorColor()

◆ GetFillColor()

◆ GetGlyphSize()

◆ GetGridLineWidth()

◆ GetGridOrigin()

◆ GetGridPoint()

◆ GetGridSize()

◆ GetGridSnapping()

◆ GetGridVisibility()

◆ GetHorizontalJustify()

◆ GetIsFill()

◆ GetIsStroke()

◆ getLayerDepth()

◆ GetLineWidth()

◆ GetLookAtPoint()

◆ GetMaxDepth()

◆ GetMinDepth()

◆ GetMinLineWidth()

◆ GetRotation()

◆ GetScreenDPI()