Open 3D Engine AzToolsFramework API Reference 23.10.0
O3DE is an open-source, fully-featured, high-fidelity, modular 3D engine for building games and simulations, available to every industry.
AzToolsFramework::GlobalPaintBrushSettingsRequests Class Referenceabstract

This is used to get/set the global paintbrush settings. More...

#include <GlobalPaintBrushSettingsRequestBus.h>

Inherits AZ::EBusTraits.

Public Types

using MutexType = AZStd::recursive_mutex
 

Public Member Functions

virtual GlobalPaintBrushSettingsGetSettingsPointerForPropertyEditor ()=0
 
virtual GlobalPaintBrushSettings GetSettings () const =0
 Returns a copy of the current global paintbrush settings.
 
virtual PaintBrushMode GetBrushMode () const =0
 Returns the current brush mode for the paint brush settings.
 
virtual void SetBrushMode (PaintBrushMode brushMode)=0
 Sets the brush mode for the paint brush settings.
 
virtual PaintBrushColorMode GetBrushColorMode () const =0
 Returns the current color mode for the paint brush settings.
 
virtual void SetBrushColorMode (PaintBrushColorMode colorMode)=0
 Sets the color mode for the paint brush settings.
 
virtual AZ::Color GetColor () const =0
 
virtual AzFramework::PaintBrushBlendMode GetBlendMode () const =0
 Returns the current brush stroke blend mode.
 
virtual AzFramework::PaintBrushSmoothMode GetSmoothMode () const =0
 Returns the current brush stroke smooth mode.
 
virtual void SetBlendMode (AzFramework::PaintBrushBlendMode blendMode)=0
 
virtual void SetSmoothMode (AzFramework::PaintBrushSmoothMode smoothMode)=0
 
virtual void SetColor (const AZ::Color &color)=0
 
virtual float GetSize () const =0
 
virtual AZStd::pair< float, float > GetSizeRange () const =0
 
virtual float GetHardnessPercent () const =0
 Returns the brush stamp hardness (0=soft falloff, 100=hard edge).
 
virtual float GetFlowPercent () const =0
 Returns the brush stamp flow setting (0=transparent stamp, 100=opaque stamp)
 
virtual float GetDistancePercent () const =0
 Returns the brush distance to move between each stamp placement in % of paintbrush size.
 
virtual void SetSize (float size)=0
 
virtual void SetSizeRange (float minSize, float maxSize)=0
 
virtual void SetHardnessPercent (float hardnessPercent)=0
 
virtual void SetFlowPercent (float flowPercent)=0
 
virtual void SetDistancePercent (float distancePercent)=0
 
virtual size_t GetSmoothingRadius () const =0
 
virtual size_t GetSmoothingSpacing () const =0
 
virtual void SetSmoothingRadius (size_t radius)=0
 
virtual void SetSmoothingSpacing (size_t spacing)=0
 

Static Public Attributes

static const AZ::EBusHandlerPolicy HandlerPolicy = AZ::EBusHandlerPolicy::Single
 

Detailed Description

This is used to get/set the global paintbrush settings.

Member Function Documentation

◆ GetColor()

virtual AZ::Color AzToolsFramework::GlobalPaintBrushSettingsRequests::GetColor ( ) const
pure virtual

Returns the current brush stroke color, including opacity. In monochrome painting, the RGB values will all be identical.

◆ GetSettingsPointerForPropertyEditor()

virtual GlobalPaintBrushSettings * AzToolsFramework::GlobalPaintBrushSettingsRequests::GetSettingsPointerForPropertyEditor ( )
pure virtual

Returns a pointer to the current paintbrush settings. This shouldn't normally be used, but it's necessary for exposing the global paintbrush settings outwards to the Property Editor window.

Returns
The paintbrush settings pointer

◆ GetSize()

virtual float AzToolsFramework::GlobalPaintBrushSettingsRequests::GetSize ( ) const
pure virtual

Returns the brush stamp size (diameter).

Returns
The size of the paintbrush in meters

◆ GetSizeRange()

virtual AZStd::pair< float, float > AzToolsFramework::GlobalPaintBrushSettingsRequests::GetSizeRange ( ) const
pure virtual

Returns the brush stamp min/max size range. The range is used to ensure that our brush size is appropriately sized relative to the world size of the data we're painting. If we let it get too big, we can run into serious performance issues.

Returns
A pair containing the min size and max size that constrain the range of sizes in meters for the paintbrush.

◆ GetSmoothingRadius()

virtual size_t AzToolsFramework::GlobalPaintBrushSettingsRequests::GetSmoothingRadius ( ) const
pure virtual

Returns the number of pixels in each direction to use for smoothing calculations.

Returns
The number of pixels in each direction to use

◆ GetSmoothingSpacing()

virtual size_t AzToolsFramework::GlobalPaintBrushSettingsRequests::GetSmoothingSpacing ( ) const
pure virtual

Returns the number of pixels to skip between pixel fetches for smoothing calculations.

Returns
The number of pixels to skip

◆ SetBlendMode()

virtual void AzToolsFramework::GlobalPaintBrushSettingsRequests::SetBlendMode ( AzFramework::PaintBrushBlendMode  blendMode)
pure virtual

Sets the brush stroke blend mode.

Parameters
blendModeThe new blend mode.

◆ SetColor()

virtual void AzToolsFramework::GlobalPaintBrushSettingsRequests::SetColor ( const AZ::Color &  color)
pure virtual

Set the brush stroke color, including opacity.

Parameters
colorThe new brush color. In monochrome painting, only the Red value will be used.

◆ SetDistancePercent()

virtual void AzToolsFramework::GlobalPaintBrushSettingsRequests::SetDistancePercent ( float  distancePercent)
pure virtual

Set the brush distance % to move between each stamp placement.

Parameters
distancePercentThe new distance %, typically in the 0-100 range.

◆ SetFlowPercent()

virtual void AzToolsFramework::GlobalPaintBrushSettingsRequests::SetFlowPercent ( float  flowPercent)
pure virtual

Sets the brush stamp flow setting.

Parameters
flowThe new flow, in 0-100 range.

◆ SetHardnessPercent()

virtual void AzToolsFramework::GlobalPaintBrushSettingsRequests::SetHardnessPercent ( float  hardnessPercent)
pure virtual

Sets the brush stamp hardness.

Parameters
hardnessThe new hardness, in 0-100 range.

◆ SetSize()

virtual void AzToolsFramework::GlobalPaintBrushSettingsRequests::SetSize ( float  size)
pure virtual

Sets the brush stamp size (diameter).

Parameters
sizeThe new size, in meters.

◆ SetSizeRange()

virtual void AzToolsFramework::GlobalPaintBrushSettingsRequests::SetSizeRange ( float  minSize,
float  maxSize 
)
pure virtual

Sets the brush stamp min/max size range. The range is used to ensure that our brush size is appropriately sized relative to the world size of the data we're painting. If we let it get too big, we can run into serious performance issues.

Parameters
minSizeThe minimum size of the paint brush in meters.
maxSizeThe maximum size of the paint brush in meters.

◆ SetSmoothingRadius()

virtual void AzToolsFramework::GlobalPaintBrushSettingsRequests::SetSmoothingRadius ( size_t  radius)
pure virtual

Set the number of pixels in each direction to use for smoothing calculations.

Parameters
Thenumber of pixels in each direction to use

◆ SetSmoothingSpacing()

virtual void AzToolsFramework::GlobalPaintBrushSettingsRequests::SetSmoothingSpacing ( size_t  spacing)
pure virtual

Set the number of pixels to skip between pixel fetches for smoothing calculations

Parameters
Thenumber of pixels to skip

◆ SetSmoothMode()

virtual void AzToolsFramework::GlobalPaintBrushSettingsRequests::SetSmoothMode ( AzFramework::PaintBrushSmoothMode  smoothMode)
pure virtual

Sets the brush stroke smooth mode.

Parameters
smoothModeThe new smooth mode.

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