Component:BillboardBrushTool: Difference between revisions

From Resonite Wiki
fix
add some info
 
Line 5: Line 5:
{{stub}}
{{stub}}


== Usage ==
TODO: are all these field descriptions correct? These field descriptions were done on a phone with no in game testing or verification done.
 
== Fields ==
{{Table ComponentFields
{{Table ComponentFields
|_equipLink|{{RootFieldType|LinkTarget`1|[[Type:ITool|ITool]]}}|TypeAdv0=true|
|_equipLink|{{RootFieldType|LinkTarget`1|[[Type:ITool|ITool]]}}|TypeAdv0=true| {{Template:ITool _equipLink}}
|TipReference|Slot|
|TipReference|Slot| {{Template:ITool TipReference}}
|BlockGripEquip|Bool|
|BlockGripEquip|Bool| {{Template:ITool BlockGripEquip}}
|BlockRemoteEquip|Bool|
|BlockRemoteEquip|Bool| {{Template:ITool BlockRemoteEquip}}
|EquipName|String|
|EquipName|String| {{Template:ITool EquipName}}
|_overrideActiveTool|'''[[Component:InteractionHandler|InteractionHandler]]'''|TypeAdv5=true|
|_overrideActiveTool|'''[[Component:InteractionHandler|InteractionHandler]]'''|TypeAdv5=true| {{Template:ITool _overrideActiveTool}}
|_gripPosesGenerated|Bool|
|_gripPosesGenerated|Bool| {{Template:ITool _gripPosesGenerated}}
|FixedMinimumPointDistance|Float|
|FixedMinimumPointDistance|Float|The minimum distance that can be between points on the line
|PositionSmoothing|Float|
|PositionSmoothing|Float| how much to smooth the drawing position wise
|RotationSmoothing|Float|
|RotationSmoothing|Float| how much to smooth the drawing rotation wise
|PressureSmoothing|Float|
|PressureSmoothing|Float| how much to smooth the drawing trigger strength wise
|MaxStrokeLength|Float|
|MaxStrokeLength|Float| the maximum length of stroke before a new stroke object is made with a new mesh.
|StrokeFadeInLength|Float|
|StrokeFadeInLength|Float| the length used for the stroke width to fade in
|StrokeFadeOutLength|Float|
|StrokeFadeOutLength|Float| the length used for the stroke width to fade out
|StrokeGroupFinishWaitTime|Float|
|StrokeGroupFinishWaitTime|Float|
|ActivationThreshold|Float|
|ActivationThreshold|Float| How much the user has to press primary strength before the tool starts drawing. Doesn't apply to desktop.
|DeactivationThresholdRatio|Float|
|DeactivationThresholdRatio|Float| How much the user has to press primary strength before the tool stops drawing. Doesn't apply to desktop.
|MenuSizeChange|Float|
|MenuSizeChange|Float|
|SnapTip|Bool|
|SnapTip|Bool| Whether to snap the tip to tool storage objects.
|SnapLine|Bool|
|SnapLine|Bool| Whether to snap the line to snap planes or objects like a plane with a [[Component:SnapPlane]] on it.
|StrokesSpace|{{RootFieldType|RootSpace}}|TypeAdv20=true|
|StrokesSpace|{{RootFieldType|RootSpace}}|TypeAdv20=true| The space in which to do strokes and stroke calculation.
|MakeStrokesGrabbable|Bool|
|MakeStrokesGrabbable|Bool| Whether to allow drawn strokes to be picked up.
|PositionStrokesToTip|Bool|
|PositionStrokesToTip|Bool|
|OrientStrokesToTip|Bool|
|OrientStrokesToTip|Bool|
|ScaleStrokesToUser|Bool|
|ScaleStrokesToUser|Bool| Whether strokes should scale up or down depending on the user holding the tooltip
|PickMaterials|Bool|
|PickMaterials|Bool| Whether to allow this brush to pick materials from material orbs by dipping into them
|PickColors|Bool|
|PickColors|Bool| Whether to allow this brush to pick colors from material orbs by dipping into them
|CurrentMaterial|{{RootFieldType|AssetRef`1|[[Type:Material|Material]]}}|TypeAdv27=true|
|CurrentMaterial|{{RootFieldType|AssetRef`1|[[Type:Material|Material]]}}|TypeAdv27=true| The material that this tool is currently drawing with.
|ColorMappings|{{RootFieldType|SyncList`1|[[Type:ColorMapping|ColorMapping]]}}|TypeAdv28=true|
|ColorMappings|{{RootFieldType|SyncList`1|[[Type:ColorMapping|ColorMapping]]}}|TypeAdv28=true|
|ParticleSystem|'''[[Component:LegacyParticleSystem|LegacyParticleSystem]]'''|TypeAdv29=true|
|ParticleSystem|'''[[Component:LegacyParticleSystem|LegacyParticleSystem]]'''|TypeAdv29=true| The Particle system to use when drawing Particle emitting lines.
|MeshEmitterTemplate|'''[[Component:LegacyMeshEmitter|LegacyMeshEmitter]]'''|TypeAdv30=true|
|MeshEmitterTemplate|'''[[Component:LegacyMeshEmitter|LegacyMeshEmitter]]'''|TypeAdv30=true|
|ParticleTemplateHandling|TemplateHandling|
|ParticleTemplateHandling|TemplateHandling|
|EmissionRatePerUnitLength|'''[[Type:Nullable`1|Nullable`1]]<[[Type:Float|Float]]>'''|TypeAdv32=true|
|EmissionRatePerUnitLength|'''[[Type:Nullable`1|Nullable`1]]<[[Type:Float|Float]]>'''|TypeAdv32=true|
|_colorPicker|{{RootFieldType|SlotCleanupRef`1|[[Component:ColorDialogInterface|ColorDialogInterface]]}}|TypeAdv33=true|
|_colorPicker|{{RootFieldType|SlotCleanupRef`1|[[Component:ColorDialogInterface|ColorDialogInterface]]}}|TypeAdv33=true| The color dialouge currently being used to pick a color for this tool.
|_pickedColor|ColorX|
|_pickedColor|ColorX| The color picked for this tool.
|_hideOnStroke|{{RootFieldType|SyncRefList`1|[[Type:Slot|Slot]]}}|TypeAdv35=true|
|_hideOnStroke|{{RootFieldType|SyncRefList`1|[[Type:Slot|Slot]]}}|TypeAdv35=true| The slots to hide as the tool draws.
|_lastUsedMaterial|{{RootFieldType|AssetRef`1|[[Type:Material|Material]]}}|TypeAdv36=true|
|_lastUsedMaterial|{{RootFieldType|AssetRef`1|[[Type:Material|Material]]}}|TypeAdv36=true| The last material this tool was drawing with
|_lastCreatedMaterial|{{RootFieldType|AssetRef`1|[[Type:Material|Material]]}}|TypeAdv37=true|
|_lastCreatedMaterial|{{RootFieldType|AssetRef`1|[[Type:Material|Material]]}}|TypeAdv37=true|
|Pressure|{{RootFieldType|RawOutput`1|[[Type:Float|Float]]}}|TypeAdv38=true|
|Pressure|{{RootFieldType|RawOutput`1|[[Type:Float|Float]]}}|TypeAdv38=true| How strong the user is pressing primary while using this tool.
|Position|{{RootFieldType|RawOutput`1|[[Type:Float3|Float3]]}}|TypeAdv39=true|
|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>.
|Rotation|{{RootFieldType|RawOutput`1|[[Type:FloatQ|FloatQ]]}}|TypeAdv40=true|
|Rotation|{{RootFieldType|RawOutput`1|[[Type:FloatQ|FloatQ]]}}|TypeAdv40=true| The rotation of the tooltip after applying <code>StrokeSpace</code>.
|LastPointDelta|{{RootFieldType|RawOutput`1|[[Type:Float3|Float3]]}}|TypeAdv41=true|
|LastPointDelta|{{RootFieldType|RawOutput`1|[[Type:Float3|Float3]]}}|TypeAdv41=true| The distance of the tooltip in <code>StrokeSpace</code> from the last point drawn.
|Velocity|{{RootFieldType|RawOutput`1|[[Type:Float3|Float3]]}}|TypeAdv42=true|
|Velocity|{{RootFieldType|RawOutput`1|[[Type:Float3|Float3]]}}|TypeAdv42=true| the speed of the drawing tip in <code>StrokeSpace</code>.
|RawDelta|{{RootFieldType|RawOutput`1|[[Type:Float3|Float3]]}}|TypeAdv43=true|
|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>.
|RawVelocity|{{RootFieldType|RawOutput`1|[[Type:Float3|Float3]]}}|TypeAdv44=true|
|RawVelocity|{{RootFieldType|RawOutput`1|[[Type:Float3|Float3]]}}|TypeAdv44=true| the raw unfiltered velocity of the tooltip in <code>StrokeSpace</code>.
|RawStrokeLength|{{RootFieldType|RawOutput`1|[[Type:Float|Float]]}}|TypeAdv45=true|
|RawStrokeLength|{{RootFieldType|RawOutput`1|[[Type:Float|Float]]}}|TypeAdv45=true|The Raw unfiltered stroke length in <code>StrokeSpace</code>.
|StrokeLength|{{RootFieldType|RawOutput`1|[[Type:Float|Float]]}}|TypeAdv46=true|
|StrokeLength|{{RootFieldType|RawOutput`1|[[Type:Float|Float]]}}|TypeAdv46=true| The length of the current stroke in <code>StrokeSpace</code>.
|NormalizedStrokeLength|{{RootFieldType|RawOutput`1|[[Type:Float|Float]]}}|TypeAdv47=true|
|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>.
|StrokeFadeMultiplier|{{RootFieldType|RawOutput`1|[[Type:Float|Float]]}}|TypeAdv48=true|
|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>.
|StrokeGroupIndex|{{RootFieldType|RawOutput`1|[[Type:Int|Int]]}}|TypeAdv49=true|
|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.
|TipAnchor|Slot|
|TipAnchor|Slot| The slot point where strokes come from.
|StrokePointRate|Float|
|StrokePointRate|Float| The distance between points in meters affected by pressure that come from the tool.
|ConstantPointRate|Float|
|ConstantPointRate|Float| the distance between points in meters. Used if <code>PressureAffectsRate</code> is disabled.
|PressureAffectsRate|Bool|
|PressureAffectsRate|Bool| Whether pressure like primary strength affects tool stroke point placement distance.
|PressureAffectsRadius|Bool|
|PressureAffectsRadius|Bool|
|ParticleSpawnRadius|Float|
|ParticleSpawnRadius|Float|
|SnapPoints|Bool|
|SnapPoints|Bool| Whether the tool should snap to [[Component:SnapPoint]]s.
|MinColor|Color|
|MinColor|Color|
|MaxColor|Color|
|MaxColor|Color|
|Profile|ColorProfile|
|Profile|ColorProfile| The color profile to use for <code>MinColor</code> and <code>MaxColor</code>
|ColorGap|Float|
|ColorGap|Float|
|MinSize|Float2|
|MinSize|Float2|
Line 75: Line 77:
|PressureAffectsAlpha|Bool|
|PressureAffectsAlpha|Bool|
|PressureAffectsIntensity|Bool|
|PressureAffectsIntensity|Bool|
|UseColor|Bool|
|UseColor|Bool| Whether to use the <code>MinColor</code> and <code>MaxColor</code> in Particle system generation.
|MinRotation|Float|
|MinRotation|Float| The minimum rotation to use when making Particle system emitters
|MaxRotation|Float|
|MaxRotation|Float| the maximum rotation to use when making Particle system emitters
|RotationGap|Float|
|RotationGap|Float|
|UseRotation|Bool|
|UseRotation|Bool| Whether particle/Particle Emitters should use <code>MinRotation</code> and <code>MaxRotation</code>
|UseSize|Bool|
|UseSize|Bool|
|UseUV|Bool|
|UseUV|Bool|
Line 87: Line 89:
}}
}}


== Behavior ==
== Usage ==


== Examples ==
== Examples ==

Latest revision as of 22:50, 22 December 2024

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.
_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 The minimum distance that can be between points on the line
PositionSmoothing Float how much to smooth the drawing position wise
RotationSmoothing Float how much to smooth the drawing rotation wise
PressureSmoothing Float how much to smooth the drawing trigger strength wise
MaxStrokeLength Float the maximum length of stroke before a new stroke object is made with a new mesh.
StrokeFadeInLength Float the length used for the stroke width to fade in
StrokeFadeOutLength Float the length used for the stroke width to fade out
StrokeGroupFinishWaitTime Float
ActivationThreshold Float How much the user has to press primary strength before the tool starts drawing. Doesn't apply to desktop.
DeactivationThresholdRatio Float How much the user has to press primary strength before the tool stops drawing. Doesn't apply to desktop.
MenuSizeChange Float
SnapTip Bool Whether to snap the tip to tool storage objects.
SnapLine Bool Whether to snap the line to snap planes or objects like a plane with a Component:SnapPlane on it.
StrokesSpace direct RootSpace The space in which to do strokes and stroke calculation.
MakeStrokesGrabbable Bool Whether to allow drawn strokes to be picked up.
PositionStrokesToTip Bool
OrientStrokesToTip Bool
ScaleStrokesToUser Bool Whether strokes should scale up or down depending on the user holding the tooltip
PickMaterials Bool Whether to allow this brush to pick materials from material orbs by dipping into them
PickColors Bool Whether to allow this brush to pick colors from material orbs by dipping into them
CurrentMaterial Material The material that this tool is currently drawing with.
ColorMappings list of ColorMapping
ParticleSystem LegacyParticleSystem The Particle system to use when drawing Particle emitting lines.
MeshEmitterTemplate LegacyMeshEmitter
ParticleTemplateHandling TemplateHandling
EmissionRatePerUnitLength Nullable`1<Float>
_colorPicker direct SlotCleanupRef`1<ColorDialogInterface> The color dialouge currently being used to pick a color for this tool.
_pickedColor ColorX The color picked for this tool.
_hideOnStroke list of Slot The slots to hide as the tool draws.
_lastUsedMaterial Material The last material this tool was drawing with
_lastCreatedMaterial Material
Pressure raw output of Float How strong the user is pressing primary while using this tool.
Position raw output of Float3 The position of the drawing tip of this tool in local space after applying StrokeSpace.
Rotation raw output of FloatQ The rotation of the tooltip after applying StrokeSpace.
LastPointDelta raw output of Float3 The distance of the tooltip in StrokeSpace from the last point drawn.
Velocity raw output of Float3 the speed of the drawing tip in StrokeSpace.
RawDelta raw output of Float3 The Raw unfiltered delta speed of the tooltip (also known as acceleration) in StrokeSpace.
RawVelocity raw output of Float3 the raw unfiltered velocity of the tooltip in StrokeSpace.
RawStrokeLength raw output of Float The Raw unfiltered stroke length in StrokeSpace.
StrokeLength raw output of Float The length of the current stroke in StrokeSpace.
NormalizedStrokeLength raw output of Float The length of the stroke from 0->1 where 1 is max stroke length in StrokeSpace.
StrokeFadeMultiplier raw output of Float the multiplier being used to fade in and out stroke width based on the current stroke length in StrokeSpace.
StrokeGroupIndex raw output of Int The index of the current stroke within a group of strokes (a slot with a bunch of stroke objects parented under it.
TipAnchor Slot The slot point where strokes come from.
StrokePointRate Float The distance between points in meters affected by pressure that come from the tool.
ConstantPointRate Float the distance between points in meters. Used if PressureAffectsRate is disabled.
PressureAffectsRate Bool Whether pressure like primary strength affects tool stroke point placement distance.
PressureAffectsRadius Bool
ParticleSpawnRadius Float
SnapPoints Bool Whether the tool should snap to Component:SnapPoints.
MinColor Color
MaxColor Color
Profile ColorProfile The color profile to use for MinColor and MaxColor
ColorGap Float
MinSize Float2
MaxSize Float2
SizeGap Float
AtlasInfo AtlasInfo
PressureAffectsSize Bool
PressureAffectsAlpha Bool
PressureAffectsIntensity Bool
UseColor Bool Whether to use the MinColor and MaxColor in Particle system generation.
MinRotation Float The minimum rotation to use when making Particle system emitters
MaxRotation Float the maximum rotation to use when making Particle system emitters
RotationGap Float
UseRotation Bool Whether particle/Particle Emitters should use MinRotation and MaxRotation
UseSize Bool
UseUV Bool
_previewRenderer MeshRenderer
_previewMesh direct DriveRef`1<PointMesh>
_previewMeshOffset field drive of Float3

Usage

Examples

See Also