fix |
add some info |
||
Line 5: | Line 5: | ||
{{stub}} | {{stub}} | ||
== | 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: | ||
}} | }} | ||
== | == Usage == | ||
== Examples == | == Examples == |
Latest revision as of 22:50, 22 December 2024
Component image
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
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 |