Differences

This shows you the differences between two versions of the page.

--- 4rpl:commands:signalgenerator [2019/04/21 20:04] – external edit 127.0.0.1
+++ 4rpl:commands:signalgenerator [2025/09/03 16:43] (current) – [Sine wave in any direction without gaps] kalli
@@ Line 1: / Line 1: @@
-~~NOTOC~~
+<=[[4rpl:start| Index]] \\
+<=[[4rpl:start#math_utility| Math Utility]]
 ====== SignalGenerator ======
-SignalGenerator(<-interval <-sigFrequency <-phaseShift false <-signalType) ->sigValue
+SignalGenerator(<-time <-frequency <-phaseShift <-invert <-signalType) ->sigValue
 ===== Description =====
 Computes the value for a given signal waveform and pushes it to the stack.
-A function to derive the y-coordinate for a given x-co-ordiante on a graph line following one of the indicated wave patterns. Uselful to animate an object or to a given pattern over time. Could be used for instance to vary output from an emitter. Oscillating rightness of light source or beacon; Oscillating strength of an emitter over time - both of these can be thought of as a a use case for this function.
+A function to derive the y-coordinate for a given x-coordinate on a graph line following one of the indicated wave patterns.
-Arguments and type in order: 1: Integer. the X coordinate in the waveform (Eg. time) \\\
+Useful to animate an object or to produce a pattern over time. For instance, could be used  to vary the strength of an emitter over time, or to "pulse" (oscillate) the brightness of light source or beacon.
-: Float. Frequency of the waveform \\\
-: Float. PhaseShift of the waveform \\\
-: Bool. invert the waveform \  5: Integer. Signal type (0 to 6 in types, below) \
-Signal types. 0 = NONE <br/> 1 = SINE <br/> 2 = SQUARE <br/> 3 = TRIANGLE <br/> 4 = SAWTOOTH <br/> 5 = RANDOM <br/> 6 = CONSTANT <br/>
+Arguments and type in order:
+  * time: (float) Current step in the waveform. For a wave duration of 10.0, a step of 2.5 is a quarter of the way into a pattern.
+  * frequency: (float) The frequency dictates the duration of each repeating pattern. A duration of 10.0 must set the frequency to 0.1 (1/10.0)
+  * phaseShift: (float) A starting offset, between 0 and 1, where 0 will start the pattern at the beginning, and 1 will start it at the end. For sine wave, 0.25 will begin the wave at the peak, and 0.75 will begin at the valley.
+  * invert: (0/1) inverts the waveform
+  * signalType: (0 to 6)
+     * 0 = NONE
+     * 1 = SINE
+     * 2 = SQUARE
+     * 3 = TRIANGLE
+     * 4 = SAW-TOOTH
+     * 5 = RANDOM
+     * 6 = CONSTANT
-===== Examples =====
+The resulting variable sigValue contains a float value between -1 and 1 which represents the current state of the wave at the provided step (time) given its provided frequency and other factors.
+===== Example =====
+To create a sine wave that should start at its peak and run for 80 frames until it repeats, we should set the frequency to (1.0/80.0), phase shift to 0.25, start the time value at 0 and add 1 to it every frame.
+Play the following example in the editor console to spawn a continuous stream of creeper using the sine wave at the bottom of the map.
+<code 4RPL>
+$time:0
+$duration:80.0
+$phaseShift:0.25
+$invert:0
+$signalType:1
+SignalGenerator(<-time <-frequency <-phaseShift <-invert <-signalType) ->sigValue
+<-time 1 add ->time
+#Let's use the result to spawn some creeper in a range of cells:
+AddCreeper(<-time <-mapX mod, <-sigValue 20.0 mul 20 add, 1)
+:Once
+.0 <-duration div ->frequency
+   GetMapSize ->mapZ ->mapX
+</code>
+===== Patterns =====
+[{{cw4_signalgenerator_1.png|1 - SINE, Pattern repeated every 60 cells}}] \\
+[{{cw4_signalgenerator_2.png|2 - SQUARE, Pattern repeated every 60 cells}}]
+[{{cw4_signalgenerator_3.png|3 - TRIANGLE, Pattern repeated every 60 cells}}] \\
+[{{cw4_signalgenerator_4.png|4 - SAW-TOOTH, Pattern repeated every 60 cells}}]
+[{{cw4_signalgenerator_5.png|5 - RANDOM, Pattern repeated every 5 cells}}] \\
+===== Extra Notes =====
+This is how each wave is produced in the game's source code:
+==== Sine wave function ====
+<code C#>
+float t = frequency * time + phase;
+value = (float)Mathf.Sin(2f * Mathf.PI * t);
+</code>
+==== Square wave function ====
+<code c#>
+value = Mathf.Sign(Mathf.Sin(2f * Mathf.PI * t));
+</code>
+==== For triangle wave function ====
+<code c#>
+value = 1f - 4f * (float)Mathf.Abs(Mathf.Round(t - 0.25f) - (t - 0.25f));
+</code>
+==== Saw-tooth wave function ====
+<code c#>
+value = 2f * (t - (float)Mathf.Floor(t + 0.5f));
+</code>
+==== Random wave function ====
+The function will output the same number for a given interval.  Interval is 1/frequency.  It only changes to a new value on the next interval.  Hence a random number per interval, or a random number at a given frequency.  Otherwise, just use the rand functions to get a new value on each call.
+<code c#>
+float interval = 1 / frequency;
+int slot = (int)(time / interval) ;
+slot = (slot * 1431655781) + (slot * 1183186591) + (slot * 622729787) + (slot * 338294347);
+if (slot < 0) slot = -slot;
+value = (float)GameSpace.instance.RandDoubleInput(randSeed + slot)*2-1;
+</code>
+===== Extra examples =====
+==== Sine Wave Creeper on Terrain ====
 <code 4rpl>
-#  On a map with terrain of 200 in X direction and at least 150 in Z direction (3D coordinates)
+# On a map with terrain of 200 in X direction and at least 150 in Z direction (3D coordinates)
 # generate a sine wave of creeper across the map.
-    ->numFrames
+# On a map with terrain of 200 in X direction and at least 150 in Z direction (3D coordinates)
-      ->frequency (1 div (AsFloat (<-numFrames)))
+# generate a sine wave of creeper across the map.
-     ->phaseShift
+ ->numFrames 			# at 30 frames a sec, cycle every 6 seconds.
+<-numFrames asFloat div ->frequency	#stepsize
+->phaseShift
 false ->invert
-     ->signalType #sine
+->signalType 				#sine
-do  (<-numFrames 0)
+do (<-numFrames 0)
-    SignalGenerator(I <-frequency <-phaseShift <-invert <-signalType )  ->sigValue
+    SignalGenerator(I <-frequency <-phaseShift <-invert <-signalType) ->sigValue
-    round (<-sigValue) 2) ->sigValue
+    Round(<-sigValue 2) ->sigValue
-    print3 (I " : " <-sigValue )
+    TraceAllSp (I " : " <-sigValue)
-    SetCreeper(I 75 add (<-sigValue mul (50)) 15 true)
+    SetCreeper(I 75 add(<-sigValue mul(50)) 15 true)
 loop
 </code>
+The above command generated this sinusoidal creeper pattern on a map
+{{sine_creeper.png?450}}
+==== Make a Unit Move or "Float" Above Terrain ====
+<code 4RPL>
+# Oscillate
+$UID:1
+GetUnitMoveCell(<-UID) ->cellZ ->cellX
+if (<-cellz  -1 EQ)
+	SignalGenerator(<-time , <-frequency , <-phaseShift , <-invert , <-signaltype) ->sigValue
+	<-time 1 + ->time
+	<-sigvalue 1 + <-scale * ->sigvalue
+	GetUnitPosition(<-UID) ->pos
+	GetExactTerrain(<-pos.X <-pos.Z false) ->exactTerrainHeight
+	SetUnitPosition(<-UID V3(<-pos.x , <-exactTerrainHeight <-sigvalue + , <-pos.z))	# Buil-in unit
+	# SetObjPosition(2  "" V3(0 <-sigValue 0) false)          							# for custom unit
+else
+->time
+endIf
+:Once
+	# Parameters for SignalGenerator
+.0  180 / ->frequency  		# we cycle over 180 frames
+.0 ->phaseShift 			# offset from zero-time
+	false ->invert 				# Invert the waveform
+->signalType				# type of signal generated
+.5 ->scale				# control the maximum size of movement
+</code>
+==== Sine wave in any direction without gaps ====
+{{ :4rpl:commands:sinewaveanydirection.png?nolink&600 |}}
+<code 4RPL>
+30 v2 165 91 v2 15 4.5 0 @getSinusoidCells ->list
+<-list 0 do
+	<-list[i] ev2 dup2 getterrain 5 add setterrain
+loop
+:getSingleLineCells # INPUTS: <-startCell <-endCell. OUTPUT: a list of cells.
+->cell1
+->cell0
+	<-cell1 <-cell0 sub ->dir
+	<-dir.0 abs <-dir.1 abs max ->length
+	<-length eq0 if 0 0 v2 else <-dir <-length asfloat div endif ->dirL
+	<-cell0
+	<-length 0 do
+		dup <-dirL add
+	loop
+	<-length 1 add listN
+:getSinusoidCells # INPUTS: <-startCell <-endCell <-amplitude <-intervals <-phaseShift01. OUTPUT: a list of cells.
+->shift # FLOAT between 0 and 1 that will shift the signal from signalgenerator.
+->intervals # Amount of signal intervals between first and last cell.
+->ampl
+->cell1
+->cell0
+clearstack
+<-cell0 <-cell1 @getSingleLineCells dup ->axisCells getlistcount ->axisLength
+<-axisLength asfloat <-intervals div -1 pow ->freq
+<-cell1 <-cell0 sub normalize ->dir
+<-dir.1 <-dir.0 neg v2 <-ampl mul ->dirP
+<-cell0
+<-axisLength 1 do
+	i <-freq <-shift 0 1 signalgenerator <-dirP mul <-axisCells[i] add @getSingleLineCells ListToStack
+loop
+list
+</code>
+<=[[4rpl:start| Index]]

Knuckle Cracker Wiki

User Tools

Site Tools

Differences

Page Tools