LMMS
Loading...
Searching...
No Matches
juce::Drawable Class Referenceabstract

#include <juce_Drawable.h>

Inheritance diagram for juce::Drawable:
juce::Component juce::MouseListener juce::DrawableComposite juce::DrawableImage juce::DrawableShape juce::DrawableText juce::DrawablePath juce::DrawableRectangle

Public Member Functions

 ~Drawable () override
virtual std::unique_ptr< DrawablecreateCopy () const =0
virtual Path getOutlineAsPath () const =0
void draw (Graphics &g, float opacity, const AffineTransform &transform=AffineTransform()) const
void drawAt (Graphics &g, float x, float y, float opacity) const
void drawWithin (Graphics &g, Rectangle< float > destArea, RectanglePlacement placement, float opacity) const
void setOriginWithOriginalSize (Point< float > originWithinParent)
void setTransformToFit (const Rectangle< float > &areaInParent, RectanglePlacement placement)
DrawableCompositegetParent () const
void setClipPath (std::unique_ptr< Drawable > drawableClipPath)
virtual Rectangle< float > getDrawableBounds () const =0
virtual bool replaceColour (Colour originalColour, Colour replacementColour)
Public Member Functions inherited from juce::Component
 Component () noexcept
 ~Component () override
 Component (const String &componentName) noexcept
String getName () const noexcept
virtual void setName (const String &newName)
String getComponentID () const noexcept
void setComponentID (const String &newID)
virtual void setVisible (bool shouldBeVisible)
bool isVisible () const noexcept
virtual void visibilityChanged ()
bool isShowing () const
virtual void addToDesktop (int windowStyleFlags, void *nativeWindowToAttachTo=nullptr)
void removeFromDesktop ()
bool isOnDesktop () const noexcept
ComponentPeergetPeer () const
virtual void userTriedToCloseWindow ()
virtual void minimisationStateChanged (bool isNowMinimised)
virtual float getDesktopScaleFactor () const
void toFront (bool shouldAlsoGainKeyboardFocus)
void toBack ()
void toBehind (Component *other)
void setAlwaysOnTop (bool shouldStayOnTop)
bool isAlwaysOnTop () const noexcept
int getX () const noexcept
int getY () const noexcept
int getWidth () const noexcept
int getHeight () const noexcept
int getRight () const noexcept
Point< intgetPosition () const noexcept
int getBottom () const noexcept
Rectangle< intgetBounds () const noexcept
Rectangle< intgetLocalBounds () const noexcept
Rectangle< intgetBoundsInParent () const noexcept
int getScreenX () const
int getScreenY () const
Point< intgetScreenPosition () const
Rectangle< intgetScreenBounds () const
Point< intgetLocalPoint (const Component *sourceComponent, Point< int > pointRelativeToSourceComponent) const
Point< float > getLocalPoint (const Component *sourceComponent, Point< float > pointRelativeToSourceComponent) const
Rectangle< intgetLocalArea (const Component *sourceComponent, Rectangle< int > areaRelativeToSourceComponent) const
Rectangle< float > getLocalArea (const Component *sourceComponent, Rectangle< float > areaRelativeToSourceComponent) const
Point< intlocalPointToGlobal (Point< int > localPoint) const
Point< float > localPointToGlobal (Point< float > localPoint) const
Rectangle< intlocalAreaToGlobal (Rectangle< int > localArea) const
Rectangle< float > localAreaToGlobal (Rectangle< float > localArea) const
void setTopLeftPosition (int x, int y)
void setTopLeftPosition (Point< int > newTopLeftPosition)
void setTopRightPosition (int x, int y)
void setSize (int newWidth, int newHeight)
void setBounds (int x, int y, int width, int height)
void setBounds (Rectangle< int > newBounds)
void setBoundsRelative (float proportionalX, float proportionalY, float proportionalWidth, float proportionalHeight)
void setBoundsRelative (Rectangle< float > proportionalArea)
void setBoundsInset (BorderSize< int > borders)
void setBoundsToFit (Rectangle< int > targetArea, Justification justification, bool onlyReduceInSize)
void setCentrePosition (int x, int y)
void setCentrePosition (Point< int > newCentrePosition)
void setCentreRelative (float x, float y)
void centreWithSize (int width, int height)
void setTransform (const AffineTransform &transform)
AffineTransform getTransform () const
bool isTransformed () const noexcept
int proportionOfWidth (float proportion) const noexcept
int proportionOfHeight (float proportion) const noexcept
int getParentWidth () const noexcept
int getParentHeight () const noexcept
Rectangle< intgetParentMonitorArea () const
int getNumChildComponents () const noexcept
ComponentgetChildComponent (int index) const noexcept
int getIndexOfChildComponent (const Component *child) const noexcept
const Array< Component * > & getChildren () const noexcept
ComponentfindChildWithID (StringRef componentID) const noexcept
void addChildComponent (Component *child, int zOrder=-1)
void addChildComponent (Component &child, int zOrder=-1)
void addAndMakeVisible (Component *child, int zOrder=-1)
void addAndMakeVisible (Component &child, int zOrder=-1)
void addChildAndSetID (Component *child, const String &componentID)
void removeChildComponent (Component *childToRemove)
ComponentremoveChildComponent (int childIndexToRemove)
void removeAllChildren ()
void deleteAllChildren ()
ComponentgetParentComponent () const noexcept
template<class TargetClass>
TargetClass * findParentComponentOfClass () const
ComponentgetTopLevelComponent () const noexcept
bool isParentOf (const Component *possibleChild) const noexcept
virtual void childrenChanged ()
virtual bool hitTest (int x, int y)
void setInterceptsMouseClicks (bool allowClicksOnThisComponent, bool allowClicksOnChildComponents) noexcept
void getInterceptsMouseClicks (bool &allowsClicksOnThisComponent, bool &allowsClicksOnChildComponents) const noexcept
bool contains (Point< int > localPoint)
bool contains (Point< float > localPoint)
bool reallyContains (Point< int > localPoint, bool returnTrueIfWithinAChild)
bool reallyContains (Point< float > localPoint, bool returnTrueIfWithinAChild)
ComponentgetComponentAt (int x, int y)
ComponentgetComponentAt (Point< int > position)
ComponentgetComponentAt (Point< float > position)
void repaint ()
void repaint (int x, int y, int width, int height)
void repaint (Rectangle< int > area)
void setBufferedToImage (bool shouldBeBuffered)
Image createComponentSnapshot (Rectangle< int > areaToGrab, bool clipImageToComponentBounds=true, float scaleFactor=1.0f)
void paintEntireComponent (Graphics &context, bool ignoreAlphaLevel)
void setPaintingIsUnclipped (bool shouldPaintWithoutClipping) noexcept
bool isPaintingUnclipped () const noexcept
void setComponentEffect (ImageEffectFilter *newEffect)
ImageEffectFiltergetComponentEffect () const noexcept
LookAndFeelgetLookAndFeel () const noexcept
void setLookAndFeel (LookAndFeel *newLookAndFeel)
virtual void lookAndFeelChanged ()
void sendLookAndFeelChange ()
void setOpaque (bool shouldBeOpaque)
bool isOpaque () const noexcept
void setBroughtToFrontOnMouseClick (bool shouldBeBroughtToFront) noexcept
bool isBroughtToFrontOnMouseClick () const noexcept
void setExplicitFocusOrder (int newFocusOrderIndex)
int getExplicitFocusOrder () const
void setFocusContainerType (FocusContainerType containerType) noexcept
bool isFocusContainer () const noexcept
bool isKeyboardFocusContainer () const noexcept
ComponentfindFocusContainer () const
ComponentfindKeyboardFocusContainer () const
void setWantsKeyboardFocus (bool wantsFocus) noexcept
bool getWantsKeyboardFocus () const noexcept
void setMouseClickGrabsKeyboardFocus (bool shouldGrabFocus)
bool getMouseClickGrabsKeyboardFocus () const noexcept
void grabKeyboardFocus ()
void giveAwayKeyboardFocus ()
bool hasKeyboardFocus (bool trueIfChildIsFocused) const
void moveKeyboardFocusToSibling (bool moveToNext)
virtual std::unique_ptr< ComponentTraversercreateFocusTraverser ()
virtual std::unique_ptr< ComponentTraversercreateKeyboardFocusTraverser ()
void setHasFocusOutline (bool hasFocusOutline) noexcept
bool hasFocusOutline () const noexcept
bool isEnabled () const noexcept
void setEnabled (bool shouldBeEnabled)
virtual void enablementChanged ()
float getAlpha () const noexcept
void setAlpha (float newAlpha)
virtual void alphaChanged ()
void setMouseCursor (const MouseCursor &cursorType)
virtual MouseCursor getMouseCursor ()
void updateMouseCursor () const
virtual void paint (Graphics &g)
virtual void paintOverChildren (Graphics &g)
void mouseMove (const MouseEvent &event) override
void mouseEnter (const MouseEvent &event) override
void mouseExit (const MouseEvent &event) override
void mouseDown (const MouseEvent &event) override
void mouseDrag (const MouseEvent &event) override
void mouseUp (const MouseEvent &event) override
void mouseDoubleClick (const MouseEvent &event) override
void mouseWheelMove (const MouseEvent &event, const MouseWheelDetails &wheel) override
void mouseMagnify (const MouseEvent &event, float scaleFactor) override
void setRepaintsOnMouseActivity (bool shouldRepaint) noexcept
void addMouseListener (MouseListener *newListener, bool wantsEventsForAllNestedChildComponents)
void removeMouseListener (MouseListener *listenerToRemove)
void addKeyListener (KeyListener *newListener)
void removeKeyListener (KeyListener *listenerToRemove)
virtual bool keyPressed (const KeyPress &key)
virtual bool keyStateChanged (bool isKeyDown)
virtual void modifierKeysChanged (const ModifierKeys &modifiers)
virtual void focusGained (FocusChangeType cause)
virtual void focusLost (FocusChangeType cause)
virtual void focusOfChildComponentChanged (FocusChangeType cause)
bool isMouseOver (bool includeChildren=false) const
bool isMouseButtonDown (bool includeChildren=false) const
bool isMouseOverOrDragging (bool includeChildren=false) const
Point< intgetMouseXYRelative () const
virtual void resized ()
virtual void moved ()
virtual void childBoundsChanged (Component *child)
virtual void parentSizeChanged ()
virtual void broughtToFront ()
void addComponentListener (ComponentListener *newListener)
void removeComponentListener (ComponentListener *listenerToRemove)
void postCommandMessage (int commandId)
virtual void handleCommandMessage (int commandId)
void enterModalState (bool takeKeyboardFocus=true, ModalComponentManager::Callback *callback=nullptr, bool deleteWhenDismissed=false)
void exitModalState (int returnValue)
bool isCurrentlyModal (bool onlyConsiderForemostModalComponent=true) const noexcept
bool isCurrentlyBlockedByAnotherModalComponent () const
virtual bool canModalEventBeSentToComponent (const Component *targetComponent)
virtual void inputAttemptWhenModal ()
NamedValueSetgetProperties () noexcept
const NamedValueSetgetProperties () const noexcept
Colour findColour (int colourID, bool inheritFromParent=false) const
void setColour (int colourID, Colour newColour)
void removeColour (int colourID)
bool isColourSpecified (int colourID) const
void copyAllExplicitColoursTo (Component &target) const
virtual void colourChanged ()
voidgetWindowHandle () const
PositionergetPositioner () const noexcept
void setPositioner (Positioner *newPositioner)
void setCachedComponentImage (CachedComponentImage *newCachedImage)
CachedComponentImagegetCachedComponentImage () const noexcept
void setViewportIgnoreDragFlag (bool ignoreDrag) noexcept
bool getViewportIgnoreDragFlag () const noexcept
String getTitle () const noexcept
void setTitle (const String &newTitle)
String getDescription () const noexcept
void setDescription (const String &newDescription)
String getHelpText () const noexcept
void setHelpText (const String &newHelpText)
void setAccessible (bool shouldBeAccessible)
bool isAccessible () const noexcept
AccessibilityHandlergetAccessibilityHandler ()
void invalidateAccessibilityHandler ()
void setFocusContainer (bool shouldBeFocusContainer) noexcept
void contains (int, int)=delete
Public Member Functions inherited from juce::MouseListener
virtual ~MouseListener ()=default

Static Public Member Functions

static std::unique_ptr< DrawablecreateFromImageData (const void *data, size_t numBytes)
static std::unique_ptr< DrawablecreateFromImageDataStream (InputStream &dataSource)
static std::unique_ptr< DrawablecreateFromImageFile (const File &file)
static std::unique_ptr< DrawablecreateFromSVG (const XmlElement &svgDocument)
static std::unique_ptr< DrawablecreateFromSVGFile (const File &svgFile)
static Path parseSVGPath (const String &svgPath)
Static Public Member Functions inherited from juce::Component
static float JUCE_CALLTYPE getApproximateScaleFactorForComponent (const Component *targetComponent)
static Component *JUCE_CALLTYPE getCurrentlyFocusedComponent () noexcept
static void JUCE_CALLTYPE unfocusAllComponents ()
static void JUCE_CALLTYPE beginDragAutoRepeat (int millisecondsBetweenCallbacks)
static bool JUCE_CALLTYPE isMouseButtonDownAnywhere () noexcept
static int JUCE_CALLTYPE getNumCurrentlyModalComponents () noexcept
static Component *JUCE_CALLTYPE getCurrentlyModalComponent (int index=0) noexcept

Protected Member Functions

 Drawable ()
void transformContextToCorrectOrigin (Graphics &)
void parentHierarchyChanged () override
void setBoundsToEnclose (Rectangle< float >)
void applyDrawableClipPath (Graphics &)
void nonConstDraw (Graphics &, float opacity, const AffineTransform &)
 Drawable (const Drawable &)
Drawableoperator= (const Drawable &)
Protected Member Functions inherited from juce::Component
virtual ComponentPeercreateNewPeer (int styleFlags, void *nativeWindowToAttachTo)

Protected Attributes

Point< intoriginRelativeToComponent
std::unique_ptr< DrawabledrawableClipPath

Friends

class DrawableComposite
class DrawableShape

Additional Inherited Members

Public Types inherited from juce::Component
enum class  FocusContainerType { none , focusContainer , keyboardFocusContainer }
enum  FocusChangeType { focusChangedByMouseClick , focusChangedByTabKey , focusChangedDirectly }
Static Protected Member Functions inherited from juce::Component
static std::unique_ptr< AccessibilityHandlercreateIgnoredAccessibilityHandler (Component &)

Detailed Description

The base class for objects which can draw themselves, e.g. polygons, images, etc.

See also
DrawableComposite, DrawableImage, DrawablePath, DrawableText

@tags{GUI}

Constructor & Destructor Documentation

◆ Drawable() [1/2]

juce::Drawable::Drawable ( )
protected

The base class can't be instantiated directly.

See also
DrawableComposite, DrawableImage, DrawablePath, DrawableText

◆ ~Drawable()

juce::Drawable::~Drawable ( )
override

Destructor.

◆ Drawable() [2/2]

juce::Drawable::Drawable ( const Drawable & other)
protected

Member Function Documentation

◆ applyDrawableClipPath()

void juce::Drawable::applyDrawableClipPath ( Graphics & g)
protected

◆ createCopy()

virtual std::unique_ptr< Drawable > juce::Drawable::createCopy ( ) const
pure virtual

Creates a deep copy of this Drawable object.

Use this to create a new copy of this and any sub-objects in the tree.

Implemented in juce::DrawableComposite, juce::DrawableImage, juce::DrawablePath, juce::DrawableRectangle, and juce::DrawableText.

◆ createFromImageData()

std::unique_ptr< Drawable > juce::Drawable::createFromImageData ( const void * data,
size_t numBytes )
static

Tries to turn some kind of image file into a drawable.

The data could be an image that the ImageFileFormat class understands, or it could be SVG.

◆ createFromImageDataStream()

std::unique_ptr< Drawable > juce::Drawable::createFromImageDataStream ( InputStream & dataSource)
static

Tries to turn a stream containing some kind of image data into a drawable.

The data could be an image that the ImageFileFormat class understands, or it could be SVG.

◆ createFromImageFile()

std::unique_ptr< Drawable > juce::Drawable::createFromImageFile ( const File & file)
static

Tries to turn a file containing some kind of image data into a drawable.

The data could be an image that the ImageFileFormat class understands, or it could be SVG.

◆ createFromSVG()

std::unique_ptr< Drawable > juce::Drawable::createFromSVG ( const XmlElement & svgDocument)
static

Attempts to parse an SVG (Scalable Vector Graphics) document, and to turn this into a Drawable tree.

If something goes wrong while parsing, it may return nullptr.

SVG is a pretty large and complex spec, and this doesn't aim to be a full implementation, but it can return the basic vector objects.

◆ createFromSVGFile()

std::unique_ptr< Drawable > juce::Drawable::createFromSVGFile ( const File & svgFile)
static

Attempts to parse an SVG (Scalable Vector Graphics) document from a file, and to turn this into a Drawable tree.

If something goes wrong while parsing, it may return nullptr.

SVG is a pretty large and complex spec, and this doesn't aim to be a full implementation, but it can return the basic vector objects.

Any references to references to external image files will be relative to the parent directory of the file passed.

◆ draw()

void juce::Drawable::draw ( Graphics & g,
float opacity,
const AffineTransform & transform = AffineTransform() ) const

Renders this Drawable object.

Note that the preferred way to render a drawable in future is by using it as a component and adding it to a parent, so you might want to consider that before using this method.

See also
drawWithin

◆ drawAt()

void juce::Drawable::drawAt ( Graphics & g,
float x,
float y,
float opacity ) const

Renders the Drawable at a given offset within the Graphics context.

The coordinates passed-in are used to translate the object relative to its own origin before drawing it - this is basically a quick way of saying:

static AffineTransform translation(float deltaX, float deltaY) noexcept
Definition juce_AffineTransform.cpp:81
void draw(Graphics &g, float opacity, const AffineTransform &transform=AffineTransform()) const
Definition juce_Drawable.cpp:66
int y
Definition inflate.c:1588
int g
Definition inflate.c:1573
unsigned x[BMAX+1]
Definition inflate.c:1586

Note that the preferred way to render a drawable in future is by using it as a component and adding it to a parent, so you might want to consider that before using this method.

◆ drawWithin()

void juce::Drawable::drawWithin ( Graphics & g,
Rectangle< float > destArea,
RectanglePlacement placement,
float opacity ) const

Renders the Drawable within a rectangle, scaling it to fit neatly inside without changing its aspect-ratio.

The object can placed arbitrarily within the rectangle based on a Justification type, and can either be made as big as possible, or just reduced to fit.

Note that the preferred way to render a drawable in future is by using it as a component and adding it to a parent, so you might want to consider that before using this method.

Parameters
gthe graphics context to render onto
destAreathe target rectangle to fit the drawable into
placementdefines the alignment and rescaling to use to fit this object within the target rectangle.
opacitythe opacity to use, in the range 0 to 1.0

◆ getDrawableBounds()

virtual Rectangle< float > juce::Drawable::getDrawableBounds ( ) const
pure virtual

Returns the area that this drawable covers. The result is expressed in this drawable's own coordinate space, and does not take into account any transforms that may be applied to the component.

Implemented in juce::DrawableComposite, juce::DrawableImage, juce::DrawableShape, and juce::DrawableText.

◆ getOutlineAsPath()

virtual Path juce::Drawable::getOutlineAsPath ( ) const
pure virtual

Creates a path that describes the outline of this drawable.

Implemented in juce::DrawableComposite, juce::DrawableImage, juce::DrawableShape, and juce::DrawableText.

◆ getParent()

DrawableComposite * juce::Drawable::getParent ( ) const

Returns the DrawableComposite that contains this object, if there is one.

◆ nonConstDraw()

void juce::Drawable::nonConstDraw ( Graphics & g,
float opacity,
const AffineTransform & transform )
protected

◆ operator=()

Drawable & juce::Drawable::operator= ( const Drawable & )
protected

◆ parentHierarchyChanged()

void juce::Drawable::parentHierarchyChanged ( )
overrideprotectedvirtual

Called to indicate that the component's parents have changed.

When a component is added or removed from its parent, this method will be called on all of its children (recursively - so all children of its children will also be called as well).

Subclasses can override this if they need to react to this in some way.

See also
getParentComponent, isShowing, ComponentListener::componentParentHierarchyChanged

Reimplemented from juce::Component.

Reimplemented in juce::DrawableComposite.

◆ parseSVGPath()

Path juce::Drawable::parseSVGPath ( const String & svgPath)
static

Parses an SVG path string and returns it.

◆ replaceColour()

bool juce::Drawable::replaceColour ( Colour originalColour,
Colour replacementColour )
virtual

Recursively replaces a colour that might be used for filling or stroking. return true if any instances of this colour were found.

Reimplemented in juce::DrawableShape, and juce::DrawableText.

◆ setBoundsToEnclose()

void juce::Drawable::setBoundsToEnclose ( Rectangle< float > area)
protected

◆ setClipPath()

void juce::Drawable::setClipPath ( std::unique_ptr< Drawable > drawableClipPath)

Sets a the clipping region of this drawable using another drawable. The drawable passed in will be deleted when no longer needed.

◆ setOriginWithOriginalSize()

void juce::Drawable::setOriginWithOriginalSize ( Point< float > originWithinParent)

Resets any transformations on this drawable, and positions its origin within its parent component.

◆ setTransformToFit()

void juce::Drawable::setTransformToFit ( const Rectangle< float > & areaInParent,
RectanglePlacement placement )

Sets a transform for this drawable that will position it within the specified area of its parent component.

◆ transformContextToCorrectOrigin()

void juce::Drawable::transformContextToCorrectOrigin ( Graphics & g)
protected

◆ DrawableComposite

friend class DrawableComposite
friend

◆ DrawableShape

friend class DrawableShape
friend

Member Data Documentation

◆ drawableClipPath

std::unique_ptr<Drawable> juce::Drawable::drawableClipPath
protected

◆ originRelativeToComponent

Point<int> juce::Drawable::originRelativeToComponent
protected

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