Difference between revisions of "Noise SOP"

From TouchDesigner Documentation
Jump to: navigation, search
(cleaning)
Line 1: Line 1:
 
{{Summary
 
{{Summary
|OPclass=noiseSOP_Class
+
|opClass=noiseSOP_Class
|OPtype=noise
+
|opType=noise
|OPlicense=Non-Commercial
+
|opLicense=Non-Commercial
|OPlabel=Noise
+
|opLabel=Noise
 
|long=The Noise SOP displaces geometry points using noise patterns. It uses the same math as the [[Noise CHOP]].
 
|long=The Noise SOP displaces geometry points using noise patterns. It uses the same math as the [[Noise CHOP]].
|OPfilter=True
+
|opFilter=True
|OPfamily=SOP
+
|opFamily=SOP
 
|short=The Noise SOP displaces geometry points using noise patterns.
 
|short=The Noise SOP displaces geometry points using noise patterns.
 
}}
 
}}
 
{{ParameterPage
 
{{ParameterPage
 
|items=
 
|items=
{{ParMiniMenu
+
{{Parameter|opType=noise
|OPtype=noise
+
|parOrder=0
|Parorder=0
+
|parItems=
|Paritems=
+
|parLabel=Group
|Parlabel=Group
+
|parName=group
|Parname=group
+
|parSummary=If there are input groups, specifying a group name in this field will cause this SOP to act only upon the group specified. Accepts patterns, as described in [[Pattern Matching]].
|Parsummary=If there are input groups, specifying a group name in this field will cause this SOP to act only upon the group specified. Accepts patterns, as described in [[Pattern Matching]].
+
|opFamily=SOP
|OPfamily=SOP
+
|parType=
}}
+
|parReadOnly=
{{ParMenu
+
}}
|OPtype=noise
+
{{Parameter|opType=noise
|Parorder=1
+
|parOrder=1
|Paritems=
+
|parItems=
 
{{Menuitem
 
{{Menuitem
 
|Itemlabel=Point Position
 
|Itemlabel=Point Position
Line 67: Line 67:
 
}}
 
}}
 
 
|Parlabel=Attribute
+
|parLabel=Attribute
|Parname=attribute
+
|parName=attribute
|Parsummary=This menu sets which attribute of the geometry the Noise SOP acts on.
+
|parSummary=This menu sets which attribute of the geometry the Noise SOP acts on.
|OPfamily=SOP
+
|opFamily=SOP
}}
+
|parType=
{{ParMenu
+
|parReadOnly=
|OPtype=noise
+
}}
|Parorder=2
+
{{Parameter|opType=noise
|Paritems=
+
|parOrder=2
 +
|parItems=
 
{{Menuitem
 
{{Menuitem
 
|Itemlabel=Sparse
 
|Itemlabel=Sparse
Line 119: Line 120:
 
}}
 
}}
 
 
|Parlabel=Type
+
|parLabel=Type
|Parname=type
+
|parName=type
|Parsummary=The noise function used to generate noise. The functions available are:
+
|parSummary=The noise function used to generate noise. The functions available are:
|OPfamily=SOP
+
|opFamily=SOP
}}
+
|parType=
{{ParFloat
+
|parReadOnly=
|OPtype=noise
+
}}
|Parorder=3
+
{{Parameter|opType=noise
|Parlabel=Seed
+
|parOrder=3
|Parname=seed
+
|parLabel=Seed
|Parsummary=Any number, integer or non-integer, which starts the random number generator. Each number gives completely different noise patterns, but with similar characteristics.
+
|parName=seed
|OPfamily=SOP
+
|parSummary=Any number, integer or non-integer, which starts the random number generator. Each number gives completely different noise patterns, but with similar characteristics.
}}
+
|opFamily=SOP
{{ParFloat
+
|parType=
|OPtype=noise
+
|parReadOnly=
|Parorder=4
+
|parItems=
|Parlabel=Period
+
}}
|Parname=period
+
{{Parameter|opType=noise
|Parsummary=The approximate separation between peaks of a noise cycle. It is expressed in Units. Increasing the period stretches the noise pattern out.
+
|parOrder=4
 +
|parLabel=Period
 +
|parName=period
 +
|parSummary=The approximate separation between peaks of a noise cycle. It is expressed in Units. Increasing the period stretches the noise pattern out.
 
 
 
Period is the opposite of frequency. If the period is 2 seconds, the base frequency is 0.5 cycles per second, or 0.5Hz for short. Hz refers to Hertz, the electrical and audio engineer of the 19th century, not the car guy.
 
Period is the opposite of frequency. If the period is 2 seconds, the base frequency is 0.5 cycles per second, or 0.5Hz for short. Hz refers to Hertz, the electrical and audio engineer of the 19th century, not the car guy.
Line 143: Line 147:
 
If the Type is set to Random, setting this to zero will produce completely random noise. Otherwise, the period should be greater than zero.
 
If the Type is set to Random, setting this to zero will produce completely random noise. Otherwise, the period should be greater than zero.
 
 
|OPfamily=SOP
+
|opFamily=SOP
}}
+
|parType=
{{ParInteger
+
|parReadOnly=
|OPtype=noise
+
|parItems=}}
|Parorder=5
+
{{Parameter|opType=noise
|Parlabel=Harmonics
+
|parOrder=5
|Parname=harmon
+
|parLabel=Harmonics
|Parsummary=The number of higher frequency components to layer on top of the base frequency. The higher this number, the bumpier the noise will be (as long as roughness is not set to zero). 0 Harmonics give the base shape.
+
|parName=harmon
 +
|parSummary=The number of higher frequency components to layer on top of the base frequency. The higher this number, the bumpier the noise will be (as long as roughness is not set to zero). 0 Harmonics give the base shape.
 
 
 
Harmonics with a base frequency of 0.1Hz will by default produce harmonics at 0.2Hz, 0.4Hz, 0.8Hz, etc. (up to the number of harmonics specified by the Harmonics parameter).
 
Harmonics with a base frequency of 0.1Hz will by default produce harmonics at 0.2Hz, 0.4Hz, 0.8Hz, etc. (up to the number of harmonics specified by the Harmonics parameter).
|OPfamily=SOP
+
|opFamily=SOP
}}
+
|parType=
{{ParFloat
+
|parReadOnly=
|OPtype=noise
+
|parItems=}}
|Parorder=6
+
{{Parameter|opType=noise
|Parlabel=Harmonic Spread
+
|parOrder=6
|Parname=spread
+
|parLabel=Harmonic Spread
|Parsummary=The factor by which the frequency of the harmonics are increased. It is normally 2. A spread of 3 and a base frequency of 0.1Hz will produce harmonics at 0.3Hz, 0.9Hz, 2.7Hz, etc.. This parameter is only valid for the Harmonic Summation type.
+
|parName=spread
|OPfamily=SOP
+
|parSummary=The factor by which the frequency of the harmonics are increased. It is normally 2. A spread of 3 and a base frequency of 0.1Hz will produce harmonics at 0.3Hz, 0.9Hz, 2.7Hz, etc.. This parameter is only valid for the Harmonic Summation type.
}}
+
|opFamily=SOP
{{ParFloat
+
|parType=
|OPtype=noise
+
|parReadOnly=
|Parorder=7
+
|parItems=
|Parlabel=Roughness
+
}}
|Parname=rough
+
{{Parameter|opType=noise
|Parsummary=Controls the effect of the higher frequency noise. When Roughness is zero, all harmonics above the base frequency have no effect. At one, all harmonics are equal in amplitude to the base frequency. When Roughness is between one and zero, the amplitude of higher harmonics drops off exponentially from the base frequency.
+
|parOrder=7
 +
|parLabel=Roughness
 +
|parName=rough
 +
|parSummary=Controls the effect of the higher frequency noise. When Roughness is zero, all harmonics above the base frequency have no effect. At one, all harmonics are equal in amplitude to the base frequency. When Roughness is between one and zero, the amplitude of higher harmonics drops off exponentially from the base frequency.
 
 
 
The default roughness is 0.5. This means the amplitude of the first harmonic is 0.5 of the base frequency, the second is 0.25, the third is 0.125. The harmonics are added to the base to give the final shape. The Harmonics parameter and the Roughness parameter must both be non-zero to see the harmonic effects.
 
The default roughness is 0.5. This means the amplitude of the first harmonic is 0.5 of the base frequency, the second is 0.25, the third is 0.125. The harmonics are added to the base to give the final shape. The Harmonics parameter and the Roughness parameter must both be non-zero to see the harmonic effects.
 
 
|OPfamily=SOP
+
|opFamily=SOP
}}
+
|parType=
{{ParFloat
+
|parReadOnly=
|OPtype=noise
+
|parItems=}}
|Parorder=8
+
{{Parameter|opType=noise
|Parlabel=Exponent
+
|parOrder=8
|Parname=exp
+
|parLabel=Exponent
|Parsummary=Pushes the noise values toward 0, or +1 and -1. (It raises the value to the power of the exponent.) Exponents greater than one will pull the channel toward zero, and powers less than one will pull peaks towards +1 and -1. It is used to reshape the channels.
+
|parName=exp
|OPfamily=SOP
+
|parSummary=Pushes the noise values toward 0, or +1 and -1. (It raises the value to the power of the exponent.) Exponents greater than one will pull the channel toward zero, and powers less than one will pull peaks towards +1 and -1. It is used to reshape the channels.
}}
+
|opFamily=SOP
{{ParInteger
+
|parType=
|OPtype=noise
+
|parReadOnly=
|Parorder=9
+
|parItems=
|Parlabel=Number of Integrals
+
}}
|Parname=numint
+
{{Parameter|opType=noise
|Parsummary=Defines the number of times to integrate (see the [[Speed CHOP]]) the Brownian noise. Higher values produce smoother curves with fewer features. Values beyond 4 produce somewhat identical curves. This parameter is only valid for the Random noise type.
+
|parOrder=9
|OPfamily=SOP
+
|parLabel=Number of Integrals
}}
+
|parName=numint
{{ParFloat
+
|parSummary=Defines the number of times to integrate (see the [[Speed CHOP]]) the Brownian noise. Higher values produce smoother curves with fewer features. Values beyond 4 produce somewhat identical curves. This parameter is only valid for the Random noise type.
|OPtype=noise
+
|opFamily=SOP
|Parorder=10
+
|parType=
|Parlabel=Amplitude
+
|parReadOnly=
|Parname=amp
+
|parItems=
|Parsummary=Defines the noise value's amplitude (a scale on the values output).
+
}}
|OPfamily=SOP
+
{{Parameter|opType=noise
}}
+
|parOrder=10
{{ParToggle
+
|parLabel=Amplitude
|OPtype=noise
+
|parName=amp
|Parorder=11
+
|parSummary=Defines the noise value's amplitude (a scale on the values output).
|Parlabel=Keep Computed Normals
+
|opFamily=SOP
|Parname=keepnormals
+
|parType=
|Parsummary=
+
|parReadOnly=
|OPfamily=SOP
+
|parItems=
}}
+
}}
 +
{{Parameter|opType=noise
 +
|parOrder=11
 +
|parLabel=Keep Computed Normals
 +
|parName=keepnormals
 +
|parSummary=
 +
|opFamily=SOP
 +
|parType=
 +
|parReadOnly=
 +
|parItems=}}
 
 
|Pagename=Noise
+
|pageName=Noise
|OPfamily=SOP
+
|opFamily=SOP
|Pagesummary=
+
|pageSummary=
 
}}
 
}}
 
{{ParameterPage
 
{{ParameterPage
 
|items=
 
|items=
{{ParMenu
+
{{Parameter|opType=noise
|OPtype=noise
+
|parOrder=0
|Parorder=0
+
|parItems=
|Paritems=
 
 
{{Menuitem
 
{{Menuitem
 
|Itemlabel=Scale Rotate Translate
 
|Itemlabel=Scale Rotate Translate
Line 260: Line 276:
 
}}
 
}}
 
 
|Parlabel=Transform Order
+
|parLabel=Transform Order
|Parname=xord
+
|parName=xord
|Parsummary=
+
|parSummary=
|OPfamily=SOP
+
|opFamily=SOP
}}
+
|parType=
{{ParMenu
+
|parReadOnly=}}
|OPtype=noise
+
{{Parameter|opType=noise
|Parorder=1
+
|parOrder=1
|Paritems=
+
|parItems=
 
{{Menuitem
 
{{Menuitem
 
|Itemlabel=Rx Ry Rz
 
|Itemlabel=Rx Ry Rz
Line 312: Line 328:
 
}}
 
}}
 
 
|Parlabel=Rotate Order
+
|parLabel=Rotate Order
|Parname=rord
+
|parName=rord
|Parsummary=
+
|parSummary=
|OPfamily=SOP
+
|opFamily=SOP
}}
+
|parType=
{{ParFloat
+
|parReadOnly=}}
|OPtype=noise
+
{{Parameter|opType=noise
|Parorder=2
+
|parOrder=2
|Paritems=
+
|parItems=
 
{{floatitem
 
{{floatitem
 
|Itemlabel=X
 
|Itemlabel=X
Line 343: Line 359:
 
}}
 
}}
 
 
|Parlabel=Translate
+
|parLabel=Translate
|Parname=t
+
|parName=t
|Parsummary=
+
|parSummary=
|OPfamily=SOP
+
|opFamily=SOP
}}
+
|parType=
{{ParFloat
+
|parReadOnly=}}
|OPtype=noise
+
{{Parameter|opType=noise
|Parorder=3
+
|parOrder=3
|Paritems=
+
|parItems=
 
{{floatitem
 
{{floatitem
 
|Itemlabel=X
 
|Itemlabel=X
Line 374: Line 390:
 
}}
 
}}
 
 
|Parlabel=Rotate
+
|parLabel=Rotate
|Parname=r
+
|parName=r
|Parsummary=
+
|parSummary=
|OPfamily=SOP
+
|opFamily=SOP
}}
+
|parType=
{{ParFloat
+
|parReadOnly=}}
|OPtype=noise
+
{{Parameter|opType=noise
|Parorder=4
+
|parOrder=4
|Paritems=
+
|parItems=
 
{{floatitem
 
{{floatitem
 
|Itemlabel=X
 
|Itemlabel=X
Line 405: Line 421:
 
}}
 
}}
 
 
|Parlabel=Scale
+
|parLabel=Scale
|Parname=s
+
|parName=s
|Parsummary=
+
|parSummary=
|OPfamily=SOP
+
|opFamily=SOP
}}
+
|parType=
{{ParFloat
+
|parReadOnly=}}
|OPtype=noise
+
{{Parameter|opType=noise
|Parorder=5
+
|parOrder=5
|Paritems=
+
|parItems=
 
{{floatitem
 
{{floatitem
 
|Itemlabel=X
 
|Itemlabel=X
Line 436: Line 452:
 
}}
 
}}
 
 
|Parlabel=Pivot
+
|parLabel=Pivot
|Parname=p
+
|parName=p
|Parsummary=
+
|parSummary=
|OPfamily=SOP
+
|opFamily=SOP
}}
+
|parType=
 +
|parReadOnly=}}
 
 
|Pagename=Transform
+
|pageName=Transform
|OPfamily=SOP
+
|opFamily=SOP
|Pagesummary=The Translate, Rotate, Scale and Pivot parameters let you sample in a different part of the 3D noise space. Imagine a different noise value for every XYZ point in space. Normally, the Noise SOP samples the noise space from (0,0,0) along the X-axis in steps of 2/period.
+
|pageSummary=The Translate, Rotate, Scale and Pivot parameters let you sample in a different part of the 3D noise space. Imagine a different noise value for every XYZ point in space. Normally, the Noise SOP samples the noise space from (0,0,0) along the X-axis in steps of 2/period.
 
 
 
By changing the transform, you are translating, rotating and scaling the line along which the Noise SOPs samples the noise space. A slight Y-rotation is like walking in a straight path in the mountains, recording your altitude along the way, then re-starting from the same initial location, walking in a slightly different direction. Your altitude starts off being similar but then diverges.
 
By changing the transform, you are translating, rotating and scaling the line along which the Noise SOPs samples the noise space. A slight Y-rotation is like walking in a straight path in the mountains, recording your altitude along the way, then re-starting from the same initial location, walking in a slightly different direction. Your altitude starts off being similar but then diverges.
 
}}
 
}}
{{History
+
{{InputsPage
 +
|opFamily=SOP
 +
|opInputs={{OPInput
 +
|opFamily=SOP
 +
|inputIndex=0
 +
|inputName=
 +
|inputSummary=
 +
}}
 +
}}{{History
 
}}
 
}}
 
{{SOPNavBox
 
{{SOPNavBox
|OPfamily=SOP
+
|opFamily=SOP
 
}}
 
}}
 
{{#invoke:Category
 
{{#invoke:Category
 
|list|SOPs}}
 
|list|SOPs}}

Revision as of 16:28, 24 January 2019

Summary
[edit]

The Noise SOP displaces geometry points using noise patterns. It uses the same math as the Noise CHOP.

PythonIcon.pngnoiseSOP_Class


Parameters - Noise Page

Group group - If there are input groups, specifying a group name in this field will cause this SOP to act only upon the group specified. Accepts patterns, as described in Pattern Matching.  

Attribute attribute - - This menu sets which attribute of the geometry the Noise SOP acts on.

Type type - - The noise function used to generate noise. The functions available are:

Seed seed - Any number, integer or non-integer, which starts the random number generator. Each number gives completely different noise patterns, but with similar characteristics.  

Period period - The approximate separation between peaks of a noise cycle. It is expressed in Units. Increasing the period stretches the noise pattern out.

Period is the opposite of frequency. If the period is 2 seconds, the base frequency is 0.5 cycles per second, or 0.5Hz for short. Hz refers to Hertz, the electrical and audio engineer of the 19th century, not the car guy.

If the Type is set to Random, setting this to zero will produce completely random noise. Otherwise, the period should be greater than zero.  

Harmonics harmon - The number of higher frequency components to layer on top of the base frequency. The higher this number, the bumpier the noise will be (as long as roughness is not set to zero). 0 Harmonics give the base shape.

Harmonics with a base frequency of 0.1Hz will by default produce harmonics at 0.2Hz, 0.4Hz, 0.8Hz, etc. (up to the number of harmonics specified by the Harmonics parameter).  

Harmonic Spread spread - The factor by which the frequency of the harmonics are increased. It is normally 2. A spread of 3 and a base frequency of 0.1Hz will produce harmonics at 0.3Hz, 0.9Hz, 2.7Hz, etc.. This parameter is only valid for the Harmonic Summation type.  

Roughness rough - Controls the effect of the higher frequency noise. When Roughness is zero, all harmonics above the base frequency have no effect. At one, all harmonics are equal in amplitude to the base frequency. When Roughness is between one and zero, the amplitude of higher harmonics drops off exponentially from the base frequency.

The default roughness is 0.5. This means the amplitude of the first harmonic is 0.5 of the base frequency, the second is 0.25, the third is 0.125. The harmonics are added to the base to give the final shape. The Harmonics parameter and the Roughness parameter must both be non-zero to see the harmonic effects.  

Exponent exp - Pushes the noise values toward 0, or +1 and -1. (It raises the value to the power of the exponent.) Exponents greater than one will pull the channel toward zero, and powers less than one will pull peaks towards +1 and -1. It is used to reshape the channels.  

Number of Integrals numint - Defines the number of times to integrate (see the Speed CHOP) the Brownian noise. Higher values produce smoother curves with fewer features. Values beyond 4 produce somewhat identical curves. This parameter is only valid for the Random noise type.  

Amplitude amp - Defines the noise value's amplitude (a scale on the values output).  

Keep Computed Normals keepnormals -  


Parameters - Transform Page

The Translate, Rotate, Scale and Pivot parameters let you sample in a different part of the 3D noise space. Imagine a different noise value for every XYZ point in space. Normally, the Noise SOP samples the noise space from (0,0,0) along the X-axis in steps of 2/period.

By changing the transform, you are translating, rotating and scaling the line along which the Noise SOPs samples the noise space. A slight Y-rotation is like walking in a straight path in the mountains, recording your altitude along the way, then re-starting from the same initial location, walking in a slightly different direction. Your altitude starts off being similar but then diverges.

Transform Order xord - -

Rotate Order rord - -

Translate t - -

Rotate r - -

Scale s - -

Pivot p - -


Operator Inputs

  • Input 0 -

TouchDesigner Build:

SOPs
Add • Alembic • Align • Arm • Attribute Create • Attribute • Basis • Blend • Bone Group • Boolean • Box • Bridge • Cache • Cap • Capture Region • Capture • Carve • CHOP to • Circle • Clay • Clip • Convert • Copy • CPlusPlus • Creep • Curveclay • Curvesect • DAT to • Deform • Delete • Divide • Extrude • Facet • File In • Fillet • Fit • Font • Force • Fractal • Grid • Group • Hole • Import Select • In • Introduction To SOPs id • Inverse Curve • Iso Surface • Join • Joint • Kinect • Lattice • Limit • Line • Line Thick • LOD • LSystem • Magnet • Material • Merge • Metaball • Model • Noise • Null • Object Merge • Oculus Rift • OpenVR • Out • Particle • Point • Polyloft • Polypatch • Polyreduce • Polyspline • Polystitch • Primitive • Profile • Project • Rails • Experimental:Raster • Ray • Rectangle • Refine • Resample • Revolve • Script • Select • Sequence Blend • Skin • Sort • Sphere • Spring • Sprite • Stitch • Subdivide • Superquad • Surfsect • Sweep • Switch • Text • Texture • Torus • Trace • Trail • Transform • Trim • Tristrip • Tube • Twist • Vertex • Wireframe • ZED

An Operator Family that reads, creates and modifies 3D polygons, curves, NURBS surfaces, spheres, meatballs and other 3D surface data.