Component:BillboardBrushTool: Difference between revisions

From Resonite Wiki
add some info
add templates
Line 16: Line 16:
|_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:LegacyParticleSystem|LegacyParticleSystem]]'''|TypeAdv29=true| {{Template:Brush_ParticleSystem}}
|MeshEmitterTemplate|'''[[Component:LegacyMeshEmitter|LegacyMeshEmitter]]'''|TypeAdv30=true|
|MeshEmitterTemplate|'''[[Component:LegacyMeshEmitter|LegacyMeshEmitter]]'''|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_}}
|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:Brush_TipAnchor}}
|StrokePointRate|Float| The distance between points in meters affected by pressure that come from the tool.
|StrokePointRate|Float| {{Template:Brush_StrokePointRate}}
|ConstantPointRate|Float| the distance between points in meters. Used if <code>PressureAffectsRate</code> is disabled.
|ConstantPointRate|Float| {{Template:Brush_ConstantPointRate}}
|PressureAffectsRate|Bool| Whether pressure like primary strength affects tool stroke point placement distance.
|PressureAffectsRate|Bool| {{Template:Brush_PressureAffectsRate}}
|PressureAffectsRadius|Bool|
|PressureAffectsRadius|Bool| {{Template:Brush_PressureAffectsRadius}}
|ParticleSpawnRadius|Float|
|ParticleSpawnRadius|Float| {{Template:Brush_ParticleSpawnRadius}}
|SnapPoints|Bool| Whether the tool should snap to [[Component:SnapPoint]]s.
|SnapPoints|Bool| {{Template:Brush_SnapPoints}}
|MinColor|Color|
|MinColor|Color| {{Template:Brush_MinColor}}
|MaxColor|Color|
|MaxColor|Color| {{Template:Brush_MaxColor}}
|Profile|ColorProfile| The color profile to use for <code>MinColor</code> and <code>MaxColor</code>
|Profile|ColorProfile| {{Template:Brush_Profile}}
|ColorGap|Float|
|ColorGap|Float| {{Template:Brush_ColorGap}}
|MinSize|Float2|
|MinSize|Float2| {{Template:Brush_MinSize}}
|MaxSize|Float2|
|MaxSize|Float2| {{Template:Brush_MaxSize}}
|SizeGap|Float|
|SizeGap|Float| {{Template:Brush_SizeGap}}
|AtlasInfo|'''[[Component:AtlasInfo|AtlasInfo]]'''|TypeAdv64=true|
|AtlasInfo|'''[[Component:AtlasInfo|AtlasInfo]]'''|TypeAdv64=true| {{Template:Brush_AtlasInfo}}
|PressureAffectsSize|Bool|
|PressureAffectsSize|Bool| {{Template:Brush_PressureAffectsSize}}
|PressureAffectsAlpha|Bool|
|PressureAffectsAlpha|Bool| {{Template:Brush_PressureAffectsAlpha}}
|PressureAffectsIntensity|Bool|
|PressureAffectsIntensity|Bool| {{Template:Brush_PressureAffectsIntensity}}
|UseColor|Bool| Whether to use the <code>MinColor</code> and <code>MaxColor</code> in Particle system generation.
|UseColor|Bool| {{Template:Brush_UseColor}}
|MinRotation|Float| The minimum rotation to use when making Particle system emitters
|MinRotation|Float| {{Template:Brush_MinRotation}}
|MaxRotation|Float| the maximum rotation to use when making Particle system emitters
|MaxRotation|Float| {{Template:Brush_MaxRotation}}
|RotationGap|Float|
|RotationGap|Float| {{Template:Brush_RotationGap}}
|UseRotation|Bool| Whether particle/Particle Emitters should use <code>MinRotation</code> and <code>MaxRotation</code>
|UseRotation|Bool| {{Template:Brush_UseRotation}}
|UseSize|Bool|
|UseSize|Bool| {{Template:Brush_UseSize}}
|UseUV|Bool|
|UseUV|Bool| {{Template:Brush_UseUV}}
|_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}}
}}
}}



Revision as of 21:30, 10 January 2025

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

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

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
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 LegacyParticleSystem The Particle system to Template when making Particle strokes.
MeshEmitterTemplate LegacyMeshEmitter 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 Template:Brush
StrokeGroupIndex raw output of Int The running index of strokes being drawn as part of a stroke group.
TipAnchor Slot Template:Brush TipAnchor
StrokePointRate Float Template:Brush StrokePointRate
ConstantPointRate Float Template:Brush ConstantPointRate
PressureAffectsRate Bool Template:Brush PressureAffectsRate
PressureAffectsRadius Bool Template:Brush PressureAffectsRadius
ParticleSpawnRadius Float Template:Brush ParticleSpawnRadius
SnapPoints Bool Template:Brush SnapPoints
MinColor Color Template:Brush MinColor
MaxColor Color Template:Brush MaxColor
Profile ColorProfile Template:Brush Profile
ColorGap Float Template:Brush ColorGap
MinSize Float2 Template:Brush MinSize
MaxSize Float2 Template:Brush MaxSize
SizeGap Float Template:Brush SizeGap
AtlasInfo AtlasInfo Template:Brush AtlasInfo
PressureAffectsSize Bool Template:Brush PressureAffectsSize
PressureAffectsAlpha Bool Template:Brush PressureAffectsAlpha
PressureAffectsIntensity Bool Template:Brush PressureAffectsIntensity
UseColor Bool Template:Brush UseColor
MinRotation Float Template:Brush MinRotation
MaxRotation Float Template:Brush MaxRotation
RotationGap Float Template:Brush RotationGap
UseRotation Bool Template:Brush UseRotation
UseSize Bool Template:Brush UseSize
UseUV Bool Template:Brush UseUV
_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.

Usage

Examples

See Also