templates templates templates |
add info |
||
(5 intermediate revisions by 2 users not shown) | |||
Line 3: | Line 3: | ||
|Name=Box Brush Tool | |Name=Box Brush Tool | ||
}} | }} | ||
The '''BoxBrushTool''' component is a tool that draws clouds of rotated, scaled, and UV mapped boxes as part of a [[Component:BoxArrayMesh]]. | |||
== Fields == | == Fields == | ||
Line 36: | Line 36: | ||
|CurrentMaterial|{{RootFieldType|AssetRef`1|[[Type:Material|Material]]}}|TypeAdv27=true| {{Template:Brush_CurrentMaterial}} | |CurrentMaterial|{{RootFieldType|AssetRef`1|[[Type:Material|Material]]}}|TypeAdv27=true| {{Template:Brush_CurrentMaterial}} | ||
|ColorMappings|{{RootFieldType|SyncList`1|[[Type:ColorMapping|ColorMapping]]}}|TypeAdv28=true| {{Template:Brush_ColorMappings}} | |ColorMappings|{{RootFieldType|SyncList`1|[[Type:ColorMapping|ColorMapping]]}}|TypeAdv28=true| {{Template:Brush_ColorMappings}} | ||
|ParticleSystem|'''[[Component: | |ParticleSystem|'''[[Component:ParticleSystem|ParticleSystem]]'''|TypeAdv29=true| {{Template:Brush_ParticleSystem}} | ||
|MeshEmitterTemplate|'''[[Component: | |MeshEmitterTemplate|'''[[Component:MeshEmitter|MeshEmitter]]'''|TypeAdv30=true| {{Template:Brush_MeshEmitterTemplate}} | ||
|ParticleTemplateHandling|TemplateHandling| {{Template:Brush_ParticleTemplateHandling}} | |ParticleTemplateHandling|TemplateHandling| {{Template:Brush_ParticleTemplateHandling}} | ||
|EmissionRatePerUnitLength|'''[[Type:Nullable`1|Nullable`1]]<[[Type:Float|Float]]>'''|TypeAdv32=true| {{Template:Brush_EmissionRatePerUnitLength}} | |EmissionRatePerUnitLength|'''[[Type:Nullable`1|Nullable`1]]<[[Type:Float|Float]]>'''|TypeAdv32=true| {{Template:Brush_EmissionRatePerUnitLength}} | ||
Line 55: | Line 55: | ||
|StrokeLength|{{RootFieldType|RawOutput`1|[[Type:Float|Float]]}}|TypeAdv46=true| {{Template:Brush_StrokeLength}} | |StrokeLength|{{RootFieldType|RawOutput`1|[[Type:Float|Float]]}}|TypeAdv46=true| {{Template:Brush_StrokeLength}} | ||
|NormalizedStrokeLength|{{RootFieldType|RawOutput`1|[[Type:Float|Float]]}}|TypeAdv47=true| {{Template:Brush_NormalizedStrokeLength}} | |NormalizedStrokeLength|{{RootFieldType|RawOutput`1|[[Type:Float|Float]]}}|TypeAdv47=true| {{Template:Brush_NormalizedStrokeLength}} | ||
|StrokeFadeMultiplier|{{RootFieldType|RawOutput`1|[[Type:Float|Float]]}}|TypeAdv48=true| {{Template: | |StrokeFadeMultiplier|{{RootFieldType|RawOutput`1|[[Type:Float|Float]]}}|TypeAdv48=true| {{Template:Brush_StrokeFadeMultiplier}} | ||
|StrokeGroupIndex|{{RootFieldType|RawOutput`1|[[Type:Int|Int]]}}|TypeAdv49=true| {{Template:Brush_StrokeGroupIndex}} | |StrokeGroupIndex|{{RootFieldType|RawOutput`1|[[Type:Int|Int]]}}|TypeAdv49=true| {{Template:Brush_StrokeGroupIndex}} | ||
|TipAnchor|Slot| {{Template:ParticleBrush_TipAnchor}} | |TipAnchor|Slot| {{Template:ParticleBrush_TipAnchor}} | ||
Line 64: | Line 64: | ||
|ParticleSpawnRadius|Float| {{Template:ParticleBrush_ParticleSpawnRadius}} | |ParticleSpawnRadius|Float| {{Template:ParticleBrush_ParticleSpawnRadius}} | ||
|SnapPoints|Bool| {{Template:ParticleBrush_SnapPoints}} | |SnapPoints|Bool| {{Template:ParticleBrush_SnapPoints}} | ||
|Pivot|Float3| | |Pivot|Float3| The offset of the rotation Pivot of each box. | ||
|MinColor|ColorX| | |MinColor|ColorX| The min color that each box can be. | ||
|MaxColor|ColorX| | |MaxColor|ColorX| The max color that each box can be. | ||
|ColorGap|Float| | |ColorGap|Float| the bias for the random colors for boxes. | ||
|UniformSize|Bool| | |UniformSize|Bool| Whether all boxes should be the same size always. | ||
|MinSize|Float3| | |MinSize|Float3| the min size a drawn box can be. | ||
|MaxSize|Float3| | |MaxSize|Float3| the max size a drawn box can be. | ||
|SizeGap|Float| | |SizeGap|Float| the bias for the random size for boxes. | ||
|MinRotation|Float3| | |MinRotation|Float3| the minimum rotation of each box. | ||
|MaxRotation|Float3| | |MaxRotation|Float3| the maximum rotation of each box. | ||
|MinUVScale|Float3| | |MinUVScale|Float3| the minimum UV scale of each box. | ||
|MaxUVScale|Float3| | |MaxUVScale|Float3| the maximum uv scale of each box. | ||
|UVScaleGap|Float| | |UVScaleGap|Float| the bias of the uv scale of each box. | ||
|RotationSpace|{{RootFieldType|RootSpace}}|TypeAdv70=true| | |RotationSpace|{{RootFieldType|RootSpace}}|TypeAdv70=true| The transform space that should be used when applying rotation to the boxes. | ||
|UseColor|Bool| | |UseColor|Bool| Whether the boxes should have vertex colors. | ||
|ScaleUVWithSize|Bool| | |ScaleUVWithSize|Bool| Whether boxes should have more UV detail the bigger they are. | ||
|_previewRenderer|'''[[Component:MeshRenderer|MeshRenderer]]'''|TypeAdv73=true| {{Template:Brush__previewRenderer}} | |_previewRenderer|'''[[Component:MeshRenderer|MeshRenderer]]'''|TypeAdv73=true| {{Template:Brush__previewRenderer}} | ||
|_previewMesh|{{RootFieldType|DriveRef`1|[[Component:BoxArrayMesh|BoxArrayMesh]]}}|TypeAdv74=true| {{Template:Brush__previewMesh}} | |_previewMesh|{{RootFieldType|DriveRef`1|[[Component:BoxArrayMesh|BoxArrayMesh]]}}|TypeAdv74=true| {{Template:Brush__previewMesh}} | ||
|_previewMeshOffset|{{RootFieldType|FieldDrive`1|[[Type:Float3|Float3]]}}|TypeAdv75=true| {{Template:Brush__previewMeshOffset}} | |_previewMeshOffset|{{RootFieldType|FieldDrive`1|[[Type:Float3|Float3]]}}|TypeAdv75=true| {{Template:Brush__previewMeshOffset}} | ||
|_previewMeshRotation|{{RootFieldType|FieldDrive`1|[[Type:FloatQ|FloatQ]]}}|TypeAdv76=true| {{Template:Brush__previewMeshRotation}} | |_previewMeshRotation|{{RootFieldType|FieldDrive`1|[[Type:FloatQ|FloatQ]]}}|TypeAdv76=true| {{Template:Brush__previewMeshRotation}} | ||
}} | |||
== Sync Delegates == | |||
{{Table ComponentTriggers | |||
|ChangeSize:[[Type:Action`1|Action`1]]<[[Type:Float|Float]]>|[[Type:Action`1|Action`1]]<[[Type:Float|Float]]>|true| Handles changing the size of the brush of a brush tool. | |||
}} | }} | ||
== Usage == | == Usage == | ||
{{stub}} | |||
== Examples == | == Examples == | ||
Line 94: | Line 100: | ||
[[Category:Components:Tools:Brushes{{#translation:}}|Box Brush Tool]] | [[Category:Components:Tools:Brushes{{#translation:}}|Box Brush Tool]] | ||
[[Category:Components{{#translation:}}|Box Brush Tool]] | [[Category:Components{{#translation:}}|Box Brush Tool]] | ||
Latest revision as of 22:36, 18 March 2025
Component image 
Box Brush Tool component as seen in the Scene Inspector

The BoxBrushTool component is a tool that draws clouds of rotated, scaled, and UV mapped boxes as part of a Component:BoxArrayMesh.
Fields
Name | Type | Description |
---|---|---|
persistent
|
Bool | Determines whether or not this item will be saved to the server. |
UpdateOrder
|
Int | Controls the order in which this component is updated. |
Enabled
|
Bool | Controls whether or not this component is enabled. Some components stop their functionality when this field is disabled, but some don't. |
_equipLink
|
direct LinkTarget`1<ITool> | This is Internal, and is used by the engine to retrieve the component this field is a part of. It cannot be assigned to. |
TipReference
|
Slot | The slot to use as the tool's tip, instead of the component's slot. |
BlockGripEquip
|
Bool | Whether to prevent legacy double grip equipping from equipping this tooltip. |
BlockRemoteEquip
|
Bool | Whether to prevent equipping by clicking via laser |
EquipName
|
String | The name of the tool in the context menu when equipping via context menu. |
_overrideActiveTool
|
InteractionHandler | The interaction handler to use instead of this tool as an interaction handler. |
_gripPosesGenerated
|
Bool | Whether the Grip Pose Reference components and slots have been generated for this tool. |
FixedMinimumPointDistance
|
Float | Stroke point distances within a stroke cannot be less than this value. |
PositionSmoothing
|
Float | How much to smooth the brush tip position when drawing. |
RotationSmoothing
|
Float | How much to smooth the rotation of the brush tip when drawing |
PressureSmoothing
|
Float | How much to smooth the brush pressure being applied |
MaxStrokeLength
|
Float | The longest a Brush stroke can be before being ended forcibly. |
StrokeFadeInLength
|
Float | The length along the stroke that the stroke fades in. |
StrokeFadeOutLength
|
Float | The length along the stroke that the stroke fades out. |
StrokeGroupFinishWaitTime
|
Float | Finishes the group when drawing strokes for more than this many seconds regardless of how full the group is. |
ActivationThreshold
|
Float | When pressure/strength is above this value, the tool starts drawing. |
DeactivationThresholdRatio
|
Float | When pressure/strength is below this value, the tool stops drawing. |
MenuSizeChange
|
Float | How much to increment or decrement the brush size when using the context menu controls. |
SnapTip
|
Bool | Whether the brush tip should snap to snappers like planes or snap spheres. |
SnapLine
|
Bool | Whether to snap new lines to snappers like snap planes or snap spheres. |
StrokesSpace
|
direct RootSpace | The space to create new strokes into. |
MakeStrokesGrabbable
|
Bool | Make new strokes grabbable. |
PositionStrokesToTip
|
Bool | Position the slots of new stroke groups to the brush tip. |
OrientStrokesToTip
|
Bool | Make the rotation of new stroke group slots oriented to the brush tip. |
ScaleStrokesToUser
|
Bool | Whether the brush strokes should be scaled up or down to match the user's scale. |
PickMaterials
|
Bool | Whether this brush can pick a material by dipping the brush tip in a material orb. |
PickColors
|
Bool | Whether this tool can pick colors by dipping the brush tip into a material orb. |
CurrentMaterial
|
Material | The current material the brush is using to draw. |
ColorMappings
|
list of ColorMapping | Associates materials with their color fields. |
ParticleSystem
|
ParticleSystem | The Particle system to Template when making Particle strokes. |
MeshEmitterTemplate
|
MeshEmitter | The template component to use as the mesh emitter of new particle emitting strokes. |
ParticleTemplateHandling
|
TemplateHandling | How to handle the use of the Particle system template per new stroke group. |
EmissionRatePerUnitLength
|
Nullable`1<Float> | The rate of particle emission per unit length section of the stroke mesh. |
_colorPicker
|
direct SlotCleanupRef`1<ColorDialogInterface> | The current color picker dialouge being used to pick a color for this brush. |
_pickedColor
|
ColorX | The color that the tool has picked by being dipped in a material orb or picked via a color picker. |
_hideOnStroke
|
list of Slot | The list of slots to hide while making a Brush stroke. |
_lastUsedMaterial
|
Material | The last used material by this brush. |
_lastCreatedMaterial
|
Material | The last material generated by this brush. |
Pressure
|
raw output of Float | The pressure being applied to the brush. |
Position
|
raw output of Float3 | The position of the brush tip after smoothing. |
Rotation
|
raw output of FloatQ | The rotation of the brush tip after smoothing. |
LastPointDelta
|
raw output of Float3 | The difference between the last drawing position and its current position. |
Velocity
|
raw output of Float3 | The velocity of the tool tips position. |
RawDelta
|
raw output of Float3 | The raw delta of the tool tips position. |
RawVelocity
|
raw output of Float3 | The raw velocity of the tool tip. |
RawStrokeLength
|
raw output of Float | The raw stroke length. |
StrokeLength
|
raw output of Float | The current stroke length in meters in StrokesSpace
|
NormalizedStrokeLength
|
raw output of Float | The length of the current stroke from 0->1 where one is maximum length set for this brush for strokes. |
StrokeFadeMultiplier
|
raw output of Float | The multiplier to the fade in and out effects of the stroke. Making the fade in and out sharper or more gradual. |
StrokeGroupIndex
|
raw output of Int | The running index of strokes being drawn as part of a stroke group. |
TipAnchor
|
Slot | The slot used as the source of strokes being drawn. |
StrokePointRate
|
Float | A multiplier to the affect of speed on the generation of points, so point generation is more concentrated over distance. |
ConstantPointRate
|
Float | A multiplier for the point generation rate while drawing |
PressureAffectsRate
|
Bool | Whether tool pressure affects point generation rate |
PressureAffectsRadius
|
Bool | Whether tool pressure effects the radius around the brush tip that points are generated. |
ParticleSpawnRadius
|
Float | The radius from the brush tip that points are generated including for particles |
SnapPoints
|
Bool | Whether generated points should snap to snappers like snapping planes, circles, lines, etc |
Pivot
|
Float3 | The offset of the rotation Pivot of each box. |
MinColor
|
ColorX | The min color that each box can be. |
MaxColor
|
ColorX | The max color that each box can be. |
ColorGap
|
Float | the bias for the random colors for boxes. |
UniformSize
|
Bool | Whether all boxes should be the same size always. |
MinSize
|
Float3 | the min size a drawn box can be. |
MaxSize
|
Float3 | the max size a drawn box can be. |
SizeGap
|
Float | the bias for the random size for boxes. |
MinRotation
|
Float3 | the minimum rotation of each box. |
MaxRotation
|
Float3 | the maximum rotation of each box. |
MinUVScale
|
Float3 | the minimum UV scale of each box. |
MaxUVScale
|
Float3 | the maximum uv scale of each box. |
UVScaleGap
|
Float | the bias of the uv scale of each box. |
RotationSpace
|
direct RootSpace | The transform space that should be used when applying rotation to the boxes. |
UseColor
|
Bool | Whether the boxes should have vertex colors. |
ScaleUVWithSize
|
Bool | Whether boxes should have more UV detail the bigger they are. |
_previewRenderer
|
MeshRenderer | The renderer being used to render the mesh preview of this brush. |
_previewMesh
|
reference drive of BoxArrayMesh | The mesh being used to preview the stroke of this brush. |
_previewMeshOffset
|
field drive of Float3 | The position offset of the mesh preview for this brush. |
_previewMeshRotation
|
field drive of FloatQ | The rotation field of the preview mesh. |
Sync Delegates
Usage
This article or section is a Stub. You can help the Resonite Wiki by expanding it.