Skip to content

Part modules

Jump to bottom
MOARdV edited this page Jun 16, 2016 · 28 revisions

A few of the modules in the package are actually part modules and go into part.cfg to support the function of IVA components:

JSIExternalCameraSelector

It may often be desirable to provide the user with an option to place a camera elsewhere on the vessel, but then you have to provide a part for it, since cameras require a named transform to work from. If you want to have a lot of cameras, as many people seem to prefer, it would require creating lots of parts with individual models, which feels like kind of a waste. This PartModule permits the user to switch the camera ID between a set of predefined names by right-clicking the camera part itself. The selected IDs will persist.

To work, the module requires the camera object to have a named transform, which either has a child transform you don't care about, or doesn't have any children. If it has any, they will be cruelly twisted and consumed, so beware. That child transform is getting renamed as soon as the vessel loads, and it's orientation and position is forcibly set to that of it's parent transform. Configuration:

  • cameraContainer -- Name of the parent transform that has a child transform that will be the actual camera transform.
  • cameraIDPrefix -- Defaults to "ExtCam"
  • maximum -- Maximum camera ID the user will be permitted, defaults to 8.
  • rotateCamera -- Additional rotation vector to be applied to the child transform after it's position and rotation are slaved to that of the parent transform, around X,Y,Z, in degrees. Unity rotates them in reverse order, so remember that first rotation around Z will be applied, then around Y. Using this is only recommended if you have no other option and are forced to use a model that you can't edit for whatever reason -- it is always better to just correctly orient the parent transform if you can.
  • translateCamera -- Additional offset vector (also X,Y,Z) to be applied to the child transform. Note that it is applied in the local scale, so may need quite a bit of tuning to get right.
  • showRay -- Boolean, defaults to true. If it is false, the visibility cone will not be turned on automatically when the camera is picked up.

The generated camera names will have the form <cameraIDPrefix><number>, camera numbering starts with 1, so on the first launch of the vessel the camera will by default be named "ExtCam1" and allow switching all the way up to "ExtCam8". You probably want to have your own name prefix.

In editor, the part with this module enabled will display a light cone indicating the general direction of what it will be seeing, with the default field of view angle of 60 degrees. Selecting the camera ID in the editor can be accomplished through tweakables. Holding down U (or whatever the light toggle button is mapped to) will display the field of view of all cameras at once.

JSIFlashModule

This module typically does not need to be created manually. It is used to coordinate "flashing" effects within a part. All prop modules that use a particular flash frequency use a JSIFlashModule configured for that frequency, which allows flashing props to be synchronized, even when they're using different modules (such as JSILabel and JSICallbackAnimator).

  • flashRate -- The frequency with which the variable will switch on and off. A 1.0 means the flash will be on for one second, and then off for one second. Negative and zero values disable flashing.

JSIRadar

This module adds a "radar" capability to a craft. The radar is able to automatically target something (vessel, asteroids, optionally debris, but not planets/moons) that is within range and within the radar's field of view. Multiple configuration options are available to change the behavior of the radar, such as requiring the target to remain in the radar's range and field of view. When added to a part with a docking node, the radar configures itself as a docking radar, searching for targets whichever direction the docking port faces.

In the VAB and in flight, the radar can be switched on or off, and the radar can be set to ignore debris or target debris. In the VAB, there are also action group options to turn the radar on, turn it off, or toggle it.

  • maxRange -- The maximum range, in kilometers, that the radar can detect objects. Defaults to 200km.
  • scanAngle -- The field of view of the radar, in degrees. Any target within this angle of the center of the cone (defined below) may be detected, if it's in range. Defaults to 30°.
  • resourceAmount, resourceName -- The amount of resources consumed per second, plus the resource type. It defaults to 0 and "ElectricCharge", but someone could make a monopropellant-fueled radar if they really wanted to...
  • radarTransform -- The optional name of a transform in the part that should be used as the radar's transmitter. If omitted, the transmitter is positioned as described below, under Radar Behavior.
  • targetDockingPorts -- When set to true, when the target is close, the radar will select the nearest docking port (if one exists); if the radar is on a part that has a docking port, it will target the nearest compatible docking port. Defaults to false.
  • restrictTracking -- When set to true, the radar will unselect a target if the target moves outside of the tracking cone. Use caution with this feature: if there are multiple radars using this feature and the target moves outside the tracking cone of any of those radars, it will be unselected. Defaults to false.
  • trackWhileOff -- When set to false, the target will be cleared when the radar is switched off. As with restrictTracking, use caution when applying this feature to multiple radars. Defaults to true.
  • targetDebris -- When set to true, the radar will target debris, not just vessels. Defaults to false. This option can be changed in the VAB and in flight. Defaults to false.
  • radarEnabled -- Is the radar switched on? Can be toggled in the VAB, in flight, and using action groups.

Radar Behavior

The radar searches for targets within a cone defined by the scanAngle and maxRange parameters. The direction of this cone depends on the following: if radarTransform is defined and exists on the part, the radar uses the "up" direction of radarTransform. If the radar is on a part that has one or more docking nodes, and there is no defined radarTransform, the radar uses the "forward" direction of the first docking node (which corresponds to the direction the docking port faces. If radarTransform is undefined (or not found), and the radar is not on a part with a docking node, the "forward" direction of the part's root transform is used (the front of a spaceplane, the top of a rocket).

When the radar is switched on, if there is no target currently being tracked, the radar will look for the nearest target within its range and field of view. If it finds something, it will target it. If there are multiple options, it selects the nearest one.

While the radar is on, it will consume resources (if configured to do so). If it runs out of resources, it will stop scanning. If trackWhileOff is false and it runs out of resources, the vessel will clear the current target (NOTE: this rule applies even if the target was manually selected, or a celestial body that the radar would not normally track).

While the radar is on, if a vessel is currently being tracked and targetDockingPorts is true, the radar will attempt to target docking ports when the target is close enough. The radar will select the nearest docking port. If the radar is on a part that has a docking port, it will select the nearest compatible docking port, instead.

If the radar is switched off while a target is selected and trackWhileOff is false, the target will be cleared.

If restrictTracking is true, the target must remain within the cone of the radar, and within range, in order to keep tracking it. This rule applies even to targets that the radar wouldn't normally track.

This radar does not model real-world sensor behaviors (detecting larger targets at longer distances), since I am trying to keep the computational overhead to a minimum.

JSIThrustReverser

This module is added to a part (usually an engine) that has a ModuleAnimateGeneric module on it. Adding this module allows RasterPropMonitor to query the state of the animation (which is what controls the thrust reverser) and to toggle that animation. JSIThrustReverser does not require that the part it is added to contains an engine, so it is possible to add this module to other animated parts so that they can be triggered with any thrust reverser controls.

There are no configuration options:

MODULE
{
  name = JSIThrustReverser
}
Clone this wiki locally