Spectrum Device – Arma 3

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\[https?\:\/\/en\.wikipedia\.org\/wiki\/([^ ]+) (.+)\]" to "{{Wikipedia|$1|$2}}")
m (Some wiki formatting)
Line 1: Line 1:
{{TOC|side}}
{{TOC|side}}
{{ConfigPage|abc}}
{{GVI|arma3|1.96}}
 
The Spectrum Device is a tool / feature introduced in [[Arma 3 Contact]]. It's ''fully'' integrated only in the optionally loaded expansion data, relying on systems that cannot exist outside of Contact.
The Spectrum Device is a tool / feature introduced in [[Arma 3 Contact]]. It's ''fully'' integrated only in the optionally loaded expansion data, relying on systems that cannot exist outside of Contact.


The default Arma 3 version contains a light version of the device, which has a basic API for usage in scripts.
The default {{arma3}}  version contains a light version of the device, which has a basic API for usage in scripts.
 
{{GVI|arma3|1.96}}


{{Feature|important|This is documentation for the Spectrum Device in the vanilla game's sandbox. It will not work as described when the spin-off Arma 3 Contact expansion is loaded into the game.<br>
{{Feature|important|This is documentation for the Spectrum Device in the vanilla game's sandbox. It will not work as described when the spin-off Arma 3 Contact expansion is loaded into the game.<br>
Keep in mind that players need to own Arma 3 Contact in order to pick up the device and use it without restrictions (it can still be added by script, but DLC purchase notifications will be shown).}}
Keep in mind that players need to own Arma 3 Contact in order to pick up the device and use it without restrictions (it can still be added by script, but DLC purchase notifications will be shown).}}


== Features ==
== Features ==
On its own, the simplified system handles these features:
On its own, the simplified system handles these features:
* Horizontal compass
* Horizontal compass
Line 26: Line 27:




== Spectrum Device==
== Spectrum Device ==
 
The device can be configured using global variables. Since the device is calculated locally, it is possible to set different values on each client in multiplayer.
The device can be configured using global variables. Since the device is calculated locally, it is possible to set different values on each client in multiplayer.


[[File:contact spectrumAnalyzer.jpg|512px]] [[File:contact spectrumAnalyzerTransmit.jpg|512px]]<br>
[[File:contact spectrumAnalyzer.jpg|512px]] [[File:contact spectrumAnalyzerTransmit.jpg|512px]]<br>
<small style="color:grey;">The images display values set by the following code examples.</small>
<small style="color: grey">The images display values set by the following code examples.</small>


=== Frequency ===
=== Frequency ===
Frequency range in which the analyzer operates. The values are in {{Wikipedia|Megahertz|MHz}}.
Frequency range in which the analyzer operates. The values are in {{Wikipedia|Megahertz|MHz}}.
[[missionNamespace]] [[setVariable]] ["<span style="color:#ff6600;">#EM_FMin</span>", 140];
<sqf>
[[missionNamespace]] [[setVariable]] ["<span style="color:#ff6600;">#EM_FMax</span>", 143];
missionNamespace setVariable ["#EM_FMin", 140];
missionNamespace setVariable ["#EM_FMax", 143];
</sqf>


=== Sensitivity ===
=== Sensitivity ===
Sensitivity of signals the analyzer is able to detect. The values are in {{Wikipedia|Decibel|dBm}}.
Sensitivity of signals the analyzer is able to detect. The values are in {{Wikipedia|Decibel|dBm}}.
[[missionNamespace]] [[setVariable]] ["<span style="color:#ff6600;">#EM_SMin</span>", -60];
<sqf>
[[missionNamespace]] [[setVariable]] ["<span style="color:#ff6600;">#EM_SMax</span>", -10];
missionNamespace setVariable ["#EM_SMin", -60];
missionNamespace setVariable ["#EM_SMax", -10];
</sqf>


=== Selected Frequency ===
=== Selected Frequency ===
Currently selected frequency. Must be within the frequency range, otherwise it will not be shown. The values are in MHz.
Currently selected frequency. Must be within the frequency range, otherwise it will not be shown. The values are in MHz.
[[missionNamespace]] [[setVariable]] ["<span style="color:#ff6600;">#EM_SelMin</span>", 141.6];
<sqf>
[[missionNamespace]] [[setVariable]] ["<span style="color:#ff6600;">#EM_SelMax</span>", 141.9];
missionNamespace setVariable ["#EM_SelMin", 141.6];
missionNamespace setVariable ["#EM_SelMax", 141.9];
</sqf>
Since the player can change the selection, it is possible to use [[getVariable]] to get the current value.
Since the player can change the selection, it is possible to use [[getVariable]] to get the current value.


=== Scanning Progress ===
=== Scanning Progress ===
When a signal is selected, it is possible to progress the scanning bar by setting the following variable. The value is in a range from 0 to 1.
When a signal is selected, it is possible to progress the scanning bar by setting the following variable. The value is in a range from 0 to 1.
[[missionNamespace]] [[setVariable]] ["<span style="color:#ff6600;">#EM_Progress</span>", 0.5];
<sqf>missionNamespace setVariable ["#EM_Progress", 0.5];</sqf>


=== Transmission ===
=== Transmission ===
To visualize transmitting, set the following variable to [[true]].
To visualize transmitting, set the following variable to [[true]].
[[missionNamespace]] [[setVariable]] ["<span style="color:#ff6600;">#EM_Transmit</span>", true];
<sqf>missionNamespace setVariable ["#EM_Transmit", true];</sqf>


=== Spectrum Signals ===
=== Spectrum Signals ===
List of displayed signal values. The array is in format ''[frequency1, strength1, frequency2, strength2, ... frequencyN, strengthN]''.
List of displayed signal values. The array is in format ''[frequency1, strength1, frequency2, strength2, ... frequencyN, strengthN]''.
[[missionNamespace]] [[setVariable]] ["<span style="color:#ff6600;">#EM_Values</span>", [141.8,-30, 140.85,-50, 141.12,-40]];
<sqf>missionNamespace setVariable ["#EM_Values", [141.8, -30, 140.85, -50, 141.12, -40]];</sqf>




{{GameCategory|arma3|Editing}}
{{GameCategory|arma3|Editing}}
[[Category:Introduced with Arma 3 version 1.96]]
[[Category:Introduced with Arma 3 version 1.96]]

Revision as of 15:02, 3 May 2022

Arma 3 logo black.png1.96

The Spectrum Device is a tool / feature introduced in Arma 3 Contact. It's fully integrated only in the optionally loaded expansion data, relying on systems that cannot exist outside of Contact.

The default Arma 3 version contains a light version of the device, which has a basic API for usage in scripts.

⚠
This is documentation for the Spectrum Device in the vanilla game's sandbox. It will not work as described when the spin-off Arma 3 Contact expansion is loaded into the game.
Keep in mind that players need to own Arma 3 Contact in order to pick up the device and use it without restrictions (it can still be added by script, but DLC purchase notifications will be shown).


Features

On its own, the simplified system handles these features:

  • Horizontal compass
  • Spectrum line animation (i.e., noise)
  • Player-controlled frequency selection (mouse wheel by default while in the 'sights' view)

All other features have to be controlled by user-made scripting, notably:

  • Setting signal values (e.g., a stronger signal when pointing towards its source)
  • Playing sounds
  • Transmitting signals

Certain aspects are not supported at all:

  • Signal labels (frequency and signal name above the peak)
  • Selected signal to transmit (shown below the compass in Contact)


Spectrum Device

The device can be configured using global variables. Since the device is calculated locally, it is possible to set different values on each client in multiplayer.

contact spectrumAnalyzer.jpg contact spectrumAnalyzerTransmit.jpg
The images display values set by the following code examples.

Frequency

Frequency range in which the analyzer operates. The values are in MHz.

missionNamespace setVariable ["#EM_FMin", 140]; missionNamespace setVariable ["#EM_FMax", 143];

Sensitivity

Sensitivity of signals the analyzer is able to detect. The values are in dBm.

missionNamespace setVariable ["#EM_SMin", -60]; missionNamespace setVariable ["#EM_SMax", -10];

Selected Frequency

Currently selected frequency. Must be within the frequency range, otherwise it will not be shown. The values are in MHz.

missionNamespace setVariable ["#EM_SelMin", 141.6]; missionNamespace setVariable ["#EM_SelMax", 141.9];

Since the player can change the selection, it is possible to use getVariable to get the current value.

Scanning Progress

When a signal is selected, it is possible to progress the scanning bar by setting the following variable. The value is in a range from 0 to 1.

missionNamespace setVariable ["#EM_Progress", 0.5];

Transmission

To visualize transmitting, set the following variable to true.

missionNamespace setVariable ["#EM_Transmit", true];

Spectrum Signals

List of displayed signal values. The array is in format [frequency1, strength1, frequency2, strength2, ... frequencyN, strengthN].

missionNamespace setVariable ["#EM_Values", [141.8, -30, 140.85, -50, 141.12, -40]];

Retrieved from "https://community.bistudio.com/wiki?title=Arma_3:_Spectrum_Device&oldid=309144"