Component:BillboardBrushTool: Difference between revisions

From Resonite Wiki
add some info
add info
 
(7 intermediate revisions by 2 users not shown)
Line 3: Line 3:
|Name=Billboard Brush Tool
|Name=Billboard Brush Tool
}}
}}
{{stub}}
The '''BillboardBrushTool''' is a Brush Tool that draws ribbons.
 
TODO: are all these field descriptions correct? These field descriptions were done on a phone with no in game testing or verification done.


== Fields ==
== Fields ==
Line 16: Line 14:
|_overrideActiveTool|'''[[Component:InteractionHandler|InteractionHandler]]'''|TypeAdv5=true| {{Template:ITool _overrideActiveTool}}
|_overrideActiveTool|'''[[Component:InteractionHandler|InteractionHandler]]'''|TypeAdv5=true| {{Template:ITool _overrideActiveTool}}
|_gripPosesGenerated|Bool| {{Template:ITool _gripPosesGenerated}}
|_gripPosesGenerated|Bool| {{Template:ITool _gripPosesGenerated}}
|FixedMinimumPointDistance|Float|The minimum distance that can be between points on the line
|FixedMinimumPointDistance|Float| {{Template:Brush_FixedMinimumPointDistance}}
|PositionSmoothing|Float| how much to smooth the drawing position wise
|PositionSmoothing|Float| {{Template:Brush_PositionSmoothing}}
|RotationSmoothing|Float| how much to smooth the drawing rotation wise
|RotationSmoothing|Float| {{Template:Brush_RotationSmoothing}}
|PressureSmoothing|Float| how much to smooth the drawing trigger strength wise
|PressureSmoothing|Float| {{Template:Brush_PressureSmoothing}}
|MaxStrokeLength|Float| the maximum length of stroke before a new stroke object is made with a new mesh.
|MaxStrokeLength|Float| {{Template:Brush_MaxStrokeLength}}
|StrokeFadeInLength|Float| the length used for the stroke width to fade in
|StrokeFadeInLength|Float| {{Template:Brush_StrokeFadeInLength}}
|StrokeFadeOutLength|Float| the length used for the stroke width to fade out
|StrokeFadeOutLength|Float| {{Template:Brush_StrokeFadeOutLength}}
|StrokeGroupFinishWaitTime|Float|
|StrokeGroupFinishWaitTime|Float|{{Template:Brush_StrokeGroupFinishWaitTime}}
|ActivationThreshold|Float| How much the user has to press primary strength before the tool starts drawing. Doesn't apply to desktop.
|ActivationThreshold|Float| {{Template:Brush_ActivationThreshold}}
|DeactivationThresholdRatio|Float| How much the user has to press primary strength before the tool stops drawing. Doesn't apply to desktop.
|DeactivationThresholdRatio|Float| {{Template:Brush_DeactivationThresholdRatio}}
|MenuSizeChange|Float|
|MenuSizeChange|Float|{{Template:Brush_MenuSizeChange}}
|SnapTip|Bool| Whether to snap the tip to tool storage objects.
|SnapTip|Bool| {{Template:Brush_SnapTip}}
|SnapLine|Bool| Whether to snap the line to snap planes or objects like a plane with a [[Component:SnapPlane]] on it.
|SnapLine|Bool| {{Template:Brush_SnapLine}}
|StrokesSpace|{{RootFieldType|RootSpace}}|TypeAdv20=true| The space in which to do strokes and stroke calculation.
|StrokesSpace|{{RootFieldType|RootSpace}}|TypeAdv20=true| {{Template:Brush_StrokesSpace}}
|MakeStrokesGrabbable|Bool| Whether to allow drawn strokes to be picked up.
|MakeStrokesGrabbable|Bool| {{Template:Brush_MakeStrokesGrabbable}}
|PositionStrokesToTip|Bool|
|PositionStrokesToTip|Bool| {{Template:Brush_PositionStrokesToTip}}
|OrientStrokesToTip|Bool|
|OrientStrokesToTip|Bool| {{Template:Brush_OrientStrokesToTip}}
|ScaleStrokesToUser|Bool| Whether strokes should scale up or down depending on the user holding the tooltip
|ScaleStrokesToUser|Bool| {{Template:Brush_ScaleStrokesToUser}}
|PickMaterials|Bool| Whether to allow this brush to pick materials from material orbs by dipping into them
|PickMaterials|Bool| {{Template:Brush_PickMaterials}}
|PickColors|Bool| Whether to allow this brush to pick colors from material orbs by dipping into them
|PickColors|Bool| {{Template:Brush_PickColors}}
|CurrentMaterial|{{RootFieldType|AssetRef`1|[[Type:Material|Material]]}}|TypeAdv27=true| The material that this tool is currently drawing with.
|CurrentMaterial|{{RootFieldType|AssetRef`1|[[Type:Material|Material]]}}|TypeAdv27=true| {{Template:Brush_CurrentMaterial}}
|ColorMappings|{{RootFieldType|SyncList`1|[[Type:ColorMapping|ColorMapping]]}}|TypeAdv28=true|
|ColorMappings|{{RootFieldType|SyncList`1|[[Type:ColorMapping|ColorMapping]]}}|TypeAdv28=true| {{Template:Brush_ColorMappings}}
|ParticleSystem|'''[[Component:LegacyParticleSystem|LegacyParticleSystem]]'''|TypeAdv29=true| The Particle system to use when drawing Particle emitting lines.
|ParticleSystem|'''[[Component:ParticleSystem|ParticleSystem]]'''|TypeAdv29=true| {{Template:Brush_ParticleSystem}}
|MeshEmitterTemplate|'''[[Component:LegacyMeshEmitter|LegacyMeshEmitter]]'''|TypeAdv30=true|
|MeshEmitterTemplate|'''[[Component:MeshEmitter|MeshEmitter]]'''|TypeAdv30=true| {{Template:Brush_MeshEmitterTemplate}}
|ParticleTemplateHandling|TemplateHandling|
|ParticleTemplateHandling|TemplateHandling| {{Template:Brush_ParticleTemplateHandling}}
|EmissionRatePerUnitLength|'''[[Type:Nullable`1|Nullable`1]]<[[Type:Float|Float]]>'''|TypeAdv32=true|
|EmissionRatePerUnitLength|'''[[Type:Nullable`1|Nullable`1]]<[[Type:Float|Float]]>'''|TypeAdv32=true| {{Template:Brush_EmissionRatePerUnitLength}}
|_colorPicker|{{RootFieldType|SlotCleanupRef`1|[[Component:ColorDialogInterface|ColorDialogInterface]]}}|TypeAdv33=true| The color dialouge currently being used to pick a color for this tool.
|_colorPicker|{{RootFieldType|SlotCleanupRef`1|[[Component:ColorDialogInterface|ColorDialogInterface]]}}|TypeAdv33=true| {{Template:Brush__colorPicker}}
|_pickedColor|ColorX| The color picked for this tool.
|_pickedColor|ColorX| {{Template:Brush__pickedColor}}
|_hideOnStroke|{{RootFieldType|SyncRefList`1|[[Type:Slot|Slot]]}}|TypeAdv35=true| The slots to hide as the tool draws.
|_hideOnStroke|{{RootFieldType|SyncRefList`1|[[Type:Slot|Slot]]}}|TypeAdv35=true| {{Template:Brush__hideOnStroke}}
|_lastUsedMaterial|{{RootFieldType|AssetRef`1|[[Type:Material|Material]]}}|TypeAdv36=true| The last material this tool was drawing with
|_lastUsedMaterial|{{RootFieldType|AssetRef`1|[[Type:Material|Material]]}}|TypeAdv36=true| {{Template:Brush__lastUsedMaterial}}
|_lastCreatedMaterial|{{RootFieldType|AssetRef`1|[[Type:Material|Material]]}}|TypeAdv37=true|
|_lastCreatedMaterial|{{RootFieldType|AssetRef`1|[[Type:Material|Material]]}}|TypeAdv37=true| {{Template:Brush__lastCreatedMaterial}}
|Pressure|{{RootFieldType|RawOutput`1|[[Type:Float|Float]]}}|TypeAdv38=true| How strong the user is pressing primary while using this tool.
|Pressure|{{RootFieldType|RawOutput`1|[[Type:Float|Float]]}}|TypeAdv38=true| {{Template:Brush_Pressure}}
|Position|{{RootFieldType|RawOutput`1|[[Type:Float3|Float3]]}}|TypeAdv39=true| The position of the drawing tip of this tool in local space after applying <code>StrokeSpace</code>.
|Position|{{RootFieldType|RawOutput`1|[[Type:Float3|Float3]]}}|TypeAdv39=true| {{Template:Brush_Position}}
|Rotation|{{RootFieldType|RawOutput`1|[[Type:FloatQ|FloatQ]]}}|TypeAdv40=true| The rotation of the tooltip after applying <code>StrokeSpace</code>.
|Rotation|{{RootFieldType|RawOutput`1|[[Type:FloatQ|FloatQ]]}}|TypeAdv40=true| {{Template:Brush_Rotation}}
|LastPointDelta|{{RootFieldType|RawOutput`1|[[Type:Float3|Float3]]}}|TypeAdv41=true| The distance of the tooltip in <code>StrokeSpace</code> from the last point drawn.
|LastPointDelta|{{RootFieldType|RawOutput`1|[[Type:Float3|Float3]]}}|TypeAdv41=true| {{Template:Brush_LastPointDelta}}
|Velocity|{{RootFieldType|RawOutput`1|[[Type:Float3|Float3]]}}|TypeAdv42=true| the speed of the drawing tip in <code>StrokeSpace</code>.
|Velocity|{{RootFieldType|RawOutput`1|[[Type:Float3|Float3]]}}|TypeAdv42=true| {{Template:Brush_Velocity}}
|RawDelta|{{RootFieldType|RawOutput`1|[[Type:Float3|Float3]]}}|TypeAdv43=true| The Raw unfiltered delta speed of the tooltip (also known as acceleration) in <code>StrokeSpace</code>.
|RawDelta|{{RootFieldType|RawOutput`1|[[Type:Float3|Float3]]}}|TypeAdv43=true| {{Template:Brush_RawDelta}}
|RawVelocity|{{RootFieldType|RawOutput`1|[[Type:Float3|Float3]]}}|TypeAdv44=true| the raw unfiltered velocity of the tooltip in <code>StrokeSpace</code>.
|RawVelocity|{{RootFieldType|RawOutput`1|[[Type:Float3|Float3]]}}|TypeAdv44=true| {{Template:Brush_RawVelocity}}
|RawStrokeLength|{{RootFieldType|RawOutput`1|[[Type:Float|Float]]}}|TypeAdv45=true|The Raw unfiltered stroke length in <code>StrokeSpace</code>.
|RawStrokeLength|{{RootFieldType|RawOutput`1|[[Type:Float|Float]]}}|TypeAdv45=true| {{Template:Brush_RawStrokeLength}}
|StrokeLength|{{RootFieldType|RawOutput`1|[[Type:Float|Float]]}}|TypeAdv46=true| The length of the current stroke in <code>StrokeSpace</code>.
|StrokeLength|{{RootFieldType|RawOutput`1|[[Type:Float|Float]]}}|TypeAdv46=true| {{Template:Brush_StrokeLength}}
|NormalizedStrokeLength|{{RootFieldType|RawOutput`1|[[Type:Float|Float]]}}|TypeAdv47=true| The length of the stroke from 0->1 where 1 is max stroke length in <code>StrokeSpace</code>.
|NormalizedStrokeLength|{{RootFieldType|RawOutput`1|[[Type:Float|Float]]}}|TypeAdv47=true| {{Template:Brush_NormalizedStrokeLength}}
|StrokeFadeMultiplier|{{RootFieldType|RawOutput`1|[[Type:Float|Float]]}}|TypeAdv48=true| the multiplier being used to fade in and out stroke width based on the current stroke length in <code>StrokeSpace</code>.
|StrokeFadeMultiplier|{{RootFieldType|RawOutput`1|[[Type:Float|Float]]}}|TypeAdv48=true| {{Template:Brush_StrokeFadeMultiplier}}
|StrokeGroupIndex|{{RootFieldType|RawOutput`1|[[Type:Int|Int]]}}|TypeAdv49=true| The index of the current stroke within a group of strokes (a slot with a bunch of stroke objects parented under it.
|StrokeGroupIndex|{{RootFieldType|RawOutput`1|[[Type:Int|Int]]}}|TypeAdv49=true| {{Template:Brush_StrokeGroupIndex}}
|TipAnchor|Slot| The slot point where strokes come from.
|TipAnchor|Slot| {{Template:ParticleBrush_TipAnchor}}
|StrokePointRate|Float| The distance between points in meters affected by pressure that come from the tool.
|StrokePointRate|Float| {{Template:ParticleBrush_StrokePointRate}}
|ConstantPointRate|Float| the distance between points in meters. Used if <code>PressureAffectsRate</code> is disabled.
|ConstantPointRate|Float| {{Template:ParticleBrush_ConstantPointRate}}
|PressureAffectsRate|Bool| Whether pressure like primary strength affects tool stroke point placement distance.
|PressureAffectsRate|Bool| {{Template:ParticleBrush_PressureAffectsRate}}
|PressureAffectsRadius|Bool|
|PressureAffectsRadius|Bool| {{Template:ParticleBrush_PressureAffectsRadius}}
|ParticleSpawnRadius|Float|
|ParticleSpawnRadius|Float| {{Template:ParticleBrush_ParticleSpawnRadius}}
|SnapPoints|Bool| Whether the tool should snap to [[Component:SnapPoint]]s.
|SnapPoints|Bool| {{Template:ParticleBrush_SnapPoints}}
|MinColor|Color|
|MinColor|Color| {{Template:PointBrush_MinColor}}
|MaxColor|Color|
|MaxColor|Color| {{Template:PointBrush_MaxColor}}
|Profile|ColorProfile| The color profile to use for <code>MinColor</code> and <code>MaxColor</code>
|Profile|ColorProfile| {{Template:PointBrush_Profile}}
|ColorGap|Float|
|ColorGap|Float| {{Template:PointBrush_ColorGap}}
|MinSize|Float2|
|MinSize|Float2| {{Template:PointBrush_MinSize}}
|MaxSize|Float2|
|MaxSize|Float2| {{Template:PointBrush_MaxSize}}
|SizeGap|Float|
|SizeGap|Float| {{Template:PointBrush_SizeGap}}
|AtlasInfo|'''[[Component:AtlasInfo|AtlasInfo]]'''|TypeAdv64=true|
|AtlasInfo|'''[[Component:AtlasInfo|AtlasInfo]]'''|TypeAdv64=true| {{Template:PointBrush_AtlasInfo}}
|PressureAffectsSize|Bool|
|PressureAffectsSize|Bool| {{Template:PointBrush_PressureAffectsSize}}
|PressureAffectsAlpha|Bool|
|PressureAffectsAlpha|Bool| {{Template:PointBrush_PressureAffectsAlpha}}
|PressureAffectsIntensity|Bool|
|PressureAffectsIntensity|Bool| {{Template:PointBrush_PressureAffectsIntensity}}
|UseColor|Bool| Whether to use the <code>MinColor</code> and <code>MaxColor</code> in Particle system generation.
|UseColor|Bool| {{Template:PointBrush_UseColor}}
|MinRotation|Float| The minimum rotation to use when making Particle system emitters
|MinRotation|Float| the minimum rotation the generated geometry can have.
|MaxRotation|Float| the maximum rotation to use when making Particle system emitters
|MaxRotation|Float| the maximum rotation the generated geometry can have.
|RotationGap|Float|
|RotationGap|Float| the bias of the rotation of generated geometry
|UseRotation|Bool| Whether particle/Particle Emitters should use <code>MinRotation</code> and <code>MaxRotation</code>
|UseRotation|Bool| Whether the generated geometry should use rotation.
|UseSize|Bool|
|UseSize|Bool| Whether the generated geometry should utilize size arguments.
|UseUV|Bool|
|UseUV|Bool| Whether the generated geometry should have UVs.
|_previewRenderer|'''[[Component:MeshRenderer|MeshRenderer]]'''|TypeAdv75=true|
|_previewRenderer|'''[[Component:MeshRenderer|MeshRenderer]]'''|TypeAdv75=true| {{Template:Brush__previewRenderer}}
|_previewMesh|{{RootFieldType|DriveRef`1|[[Component:PointMesh|PointMesh]]}}|TypeAdv76=true|
|_previewMesh|{{RootFieldType|DriveRef`1|[[Component:PointMesh|PointMesh]]}}|TypeAdv76=true| {{Template:Brush__previewMesh}}
|_previewMeshOffset|{{RootFieldType|FieldDrive`1|[[Type:Float3|Float3]]}}|TypeAdv77=true|
|_previewMeshOffset|{{RootFieldType|FieldDrive`1|[[Type:Float3|Float3]]}}|TypeAdv77=true| {{Template:Brush__previewMeshOffset}}
}}
 
== Sync Delegates ==
{{Table ComponentTriggers
|ChangeSize:[[Type:Action`1|Action`1]]&lt;[[Type:Float|Float]]&gt;|[[Type:Action`1|Action`1]]&lt;[[Type:Float|Float]]&gt;|true| Handles changing the size of the brush of a brush tool.
}}
}}


== Usage ==
== Usage ==
{{stub}}


== Examples ==
== Examples ==
Line 97: Line 101:
[[Category:Components:Tools:Brushes{{#translation:}}|Billboard Brush Tool]]
[[Category:Components:Tools:Brushes{{#translation:}}|Billboard Brush Tool]]
[[Category:Components{{#translation:}}|Billboard Brush Tool]]
[[Category:Components{{#translation:}}|Billboard Brush Tool]]
[[Category:ComponentStubs]]

Latest revision as of 22:34, 18 March 2025

Component image 
Billboard Brush Tool component as seen in the Scene Inspector

The BillboardBrushTool is a Brush Tool that draws ribbons.

Fields

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
MinColor Color The minimum color that can be generated for points (Quads, Cubes, Etc)
MaxColor Color The maximum color that can be generated for points (Quads, Cubes, Etc)
Profile ColorProfile The color profile of Min and Max color.
ColorGap Float Whether the color generated should bias towards min or max color.
MinSize Float2 The minimum size generated points can be (Quads, Cubes, etc)
MaxSize Float2 The maximum size generated points can be (Quads, cubes, etc)
SizeGap Float Whether the size should lean towards the minimum or maximum size.
AtlasInfo AtlasInfo The atlas info found from a material picked via material orb.
PressureAffectsSize Bool Whether tool pressure effects the size of generated points from this tool. (Quads, cubes, etc)
PressureAffectsAlpha Bool Whether tool pressure should affect color alpha.
PressureAffectsIntensity Bool Whether tool use pressure affects color brightness.
UseColor Bool When points are added to a point based brush, this determines if those points should use a color made from MinColor and MaxColor?.
MinRotation Float the minimum rotation the generated geometry can have.
MaxRotation Float the maximum rotation the generated geometry can have.
RotationGap Float the bias of the rotation of generated geometry
UseRotation Bool Whether the generated geometry should use rotation.
UseSize Bool Whether the generated geometry should utilize size arguments.
UseUV Bool Whether the generated geometry should have UVs.
_previewRenderer MeshRenderer The renderer being used to render the mesh preview of this brush.
_previewMesh reference drive of PointMesh 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.

Sync Delegates

Triggers
Method Name Method type and Arguments. Is the method hidden? Description
ChangeSize:Action`1<Float> Action`1<Float> Handles changing the size of the brush of a brush tool.

Usage

This article or section is a Stub. You can help the Resonite Wiki by expanding it.

Examples

See Also