Difference between revisions of "RLVa RFC setsphere"
Jump to navigation
Jump to search
Line 1: | Line 1: | ||
+ | ==Mode: Chromatic Aberration== | ||
+ | {| class="wikitable" | ||
+ | ! style="text-align:left;"| Command | ||
+ | ! Value(s) | ||
+ | ! Description | ||
+ | |- | ||
+ | |setsphere_mode | ||
+ | |3 | ||
+ | |Switches @setsphere to 'chromatic aberration' mode | ||
+ | |- | ||
+ | |setsphere_param | ||
+ | |<horiz red shift>/<vert red shift>/<horiz blue shift>/<vert blue shift> | ||
+ | |The first 2 numbers specify the offset of the red component; the last 2 the offset of the green component | ||
+ | |- | ||
+ | |setsphere_distmin | ||
+ | |<distance> | ||
+ | |Sets the distance (in m) at which the effect should start | ||
+ | |- | ||
+ | |setsphere_distmax | ||
+ | |<distance> | ||
+ | |Sets the distance (in m) at which the effect should end | ||
+ | |- | ||
+ | |setsphere_distextend | ||
+ | |1 or 0 | ||
+ | |Specify 1 (default) to extend the effect past the maximum distance or 0 to end it | ||
+ | |- | ||
+ | |setsphere_valuemin | ||
+ | |0.0-1.0 | ||
+ | |Sets the strength of the effect at distmin | ||
+ | |- | ||
+ | |setsphere_valuemax | ||
+ | |0.0-1.0 | ||
+ | |Sets the strength of the effect at distmax | ||
+ | |- | ||
+ | |} | ||
+ | |||
+ | ===Notes=== | ||
+ | * If both values (valuemin and valuemax) and both distances (distmin and distmax) are different then - much like the blending mode - the offsets for the colour components of each pixel will gradually increase (or decrease) depending on the distance | ||
+ | |||
+ | ===Example=== | ||
+ | # Clear all modifiers and switch @setsphere to 'ca' mode | ||
+ | #: <pre>@clear,setsphere=n,setsphere_mode:3=force</pre> | ||
+ | # Shift the red channel to the left by 8 pixels and blue to the right by 8 pixels | ||
+ | #: <pre>@setsphere_param:8/0/-8/0=force</pre> | ||
+ | # Increase the color shifts but blend back with the original colour at 50% (animate the change across 5 seconds) | ||
+ | #: <pre>@setsphere_tween:5=force,setsphere_param:0/-25/0/25=force,setsphere_valuemax:0.5=force,setsphere_tween=force</pre> | ||
+ | # Enforce the effect only when >=10m away (only objects >10m away appear affected) | ||
+ | #: <pre>@setsphere_distmin:10=force</pre> | ||
+ | |||
+ | {| width="100%" | ||
+ | | [[File:setsphere ca 1.png|500px|thumb|center|(Step 2) Red shifted by 8 left and 0 down. Blue shifted by 8 right and 0 down.]] | ||
+ | | [[File:setsphere ca 2.png|500px|thumb|center|(Step 3) Using valuemin/valuemax blends the original colour with the effect making it appear more like a ghost artifact]] | ||
+ | |} | ||
+ | [[File:setsphere ca 3.png|500px|thumb|center|(Step 4) Inner sphere radius set to 10m]] | ||
+ | |||
==Mode: Pixelate== | ==Mode: Pixelate== | ||
{| class="wikitable" | {| class="wikitable" |
Revision as of 22:52, 8 January 2021
Mode: Chromatic Aberration
Command | Value(s) | Description |
---|---|---|
setsphere_mode | 3 | Switches @setsphere to 'chromatic aberration' mode |
setsphere_param | <horiz red shift>/<vert red shift>/<horiz blue shift>/<vert blue shift> | The first 2 numbers specify the offset of the red component; the last 2 the offset of the green component |
setsphere_distmin | <distance> | Sets the distance (in m) at which the effect should start |
setsphere_distmax | <distance> | Sets the distance (in m) at which the effect should end |
setsphere_distextend | 1 or 0 | Specify 1 (default) to extend the effect past the maximum distance or 0 to end it |
setsphere_valuemin | 0.0-1.0 | Sets the strength of the effect at distmin |
setsphere_valuemax | 0.0-1.0 | Sets the strength of the effect at distmax |
Notes
- If both values (valuemin and valuemax) and both distances (distmin and distmax) are different then - much like the blending mode - the offsets for the colour components of each pixel will gradually increase (or decrease) depending on the distance
Example
- Clear all modifiers and switch @setsphere to 'ca' mode
@clear,setsphere=n,setsphere_mode:3=force
- Shift the red channel to the left by 8 pixels and blue to the right by 8 pixels
@setsphere_param:8/0/-8/0=force
- Increase the color shifts but blend back with the original colour at 50% (animate the change across 5 seconds)
@setsphere_tween:5=force,setsphere_param:0/-25/0/25=force,setsphere_valuemax:0.5=force,setsphere_tween=force
- Enforce the effect only when >=10m away (only objects >10m away appear affected)
@setsphere_distmin:10=force
Mode: Pixelate
Command | Value(s) | Description |
---|---|---|
setsphere_mode | 4 | Switches @setsphere to pixelate mode |
setsphere_param | <width>/<height>/0/0 | Specifies the pixelate block size (in pixels) - last 2 params are unused by this mode |
setsphere_distmin | <distance> | Sets the distance (in m) at which the effect should start |
setsphere_distmax | <distance> | Sets the distance (in m) at which the effect should end |
setsphere_distextend | 1 or 0 | Specify 1 (default) to extend the effect past the maximum distance or 0 to end it |
setsphere_valuemin | - | Unused |
setsphere_valuemax | - | Unused |
Notes
- don't use @setsphere_distextend:1=force with a min/max distance value in this mode; just setting distmin will suffice (see examples)
Example
- Clear all modifiers and switch @setsphere to 'pixelate' mode
@clear,setsphere=n,setsphere_mode:4=force
- Set the block size to 10x10 (everything is pixelated)
@setsphere_param:10/10/0/0=force
- Enforce the effect only when >=10m away (only objects >10m away appear pixelated)
@setsphere_distmin:10=force
- Tween to a block size of 25x25 in 15 seconds (and then reset the tween duration for following commands)
@setsphere_tween:15=force,setsphere_param:25/25/0/0=force,setsphere_tween=force