Data/Actors/Site Operation (Forward Vector)

## Site Operation (Forward Vector)

(Editor Screenshot) needs picture of hellion beam

### Description

A site operation that makes the actor that has it in the Site Operations field face the direction of a specific actor or relative to the global map grid

### Hint

* Capable of creating custom animations if used to face an attachment point that moves with scale changes
* Can cause models to invert along the axis parallel to that of rotation unless fixed using a Site Operation (Up Vector)

## Example Usage

### HellionAttackDamageSiteOpForward (Unnamed)

Ensures the **Hellion Attack Damage Site** actor faces towards the beam of the attack

#### URL

As the hellion and all it's attack actors are already in the editor, no URL is needed

### Toss-A-Tron

Experimental project that uses forward vectors that face 0 opacity marine models which alter their scales to create a crude walk animation. As this is a work in progress, there can be several improvements made over the course of time

#### URL

http://www.sc2mapster.com/forums/resources/project-workplace/24854-experimental-toss-a-tron-terrorize/#posts

## Fields Description

### Actor - Aliases

* Aliases that refer to the actor in Events or in Hosting as a subject

### Actor - Filter

* Determines what players can see the actor depending on their diplomatic status eg. Nuke Target/Indicator
* Pointless as this actor has no visuals

### Actor - Flags

* **Add To External Finder:** (Unknown)
* **Not Saved:** (Unknown) used by all tempory Model actors
* **Scale To Host:** overides any scaling the actor has and sets it to the host Unit actor
* **Suppress Creation Errors:** (Unknown)

### Actor - Fog Visibility

* Determines how the actor appears under the fog of war
* Limited by the setting of the **UI: Fog Visibility** field under the Units data type
* Pointless as this actor has no visuals

### Actor - Forward

* Makes the actor always face a specific direction relative to the global map grid
* Leave as 0,0,0 for most purposes

### Actor - Hold Position

* If enabled the actor with this SOp is locked in the position relative to the global map grid but turns to face the desired direction
* Useful for stationary abilities or structures that have parts which need to face a moving target

### Actor - Hold Rotation

* If enabled the actor with this SOp is locked with it's rotation facing the direction of creation relative to the global map grid

### Actor - Sharing

* Determines to what degree the same actor is shared by a unit if there are multiple functions referring to it
* **Always:** means the actor is always shared
* **None:** means the actor is never shared
* **Per Effect Tree:** means that effects within an effect tree share the actor but different effect trees can't

### Event - Events+

* Series of minitriggers that determine the motions and visual effects of the model
* Covered in detail in the Events section of the wiki
* Apparently have no effect on SOps

### Event - Macros

* The Event Macro actors used to supplement the events

### Hosting - Host Forward - Actor

* **Actor Find:** (Not Sure) means the actor has to be found using the scope
* **Creation:** (Not Sure) is the actor that creates this actor is given priority for hosting if there is a choice of several
* **Implicit:** is the default

### Hosting - Host Forward - Effect

* The effect whose scope is used in combination with the Hosting - Host Forward - Scope field to determine valid subjects

### Hosting - Host Forward - Fail If No Host

* Causes the model to be automatically destroyed if no host

### Hosting - Host Forward - Scope

* **Implicit:** is the default but gives an error message if using the scope of an effect
* **Scope Caster:** (Unsure) Uses the scope of the caster of the effect to choose the caster unit as the subject
* **Scope Effect:** (Unknown)
* **Scope Missile:** (Unknown)
* **Scope Outer:** (Unknown)
* **Scope Source:** (Unknown) Uses the scope of the source of the effect to choose the source unit as the subject
* **Scope Target:** (Unknown) Uses the scope of the target of the effect to choose the target unit as the subject

### Hosting - Host Forward - Subject

* Actor, alias or reference that this SOp causes actors with it to face
* Despite **SOpRaynorSnipeBigBloodImpactLaunchGuide (Unnamed)** using a reference in this field, It appears unable to have the target actor swapped on condition like tentacle attachments
* The target actor must exist before the creation of the actor with this SOp or it will face the lower left corner of the map

### Hosting - Host Forward Site Operations - Hold Position

* If enabled the actor with this SOp is locked in the position relative to the global map grid but turns to face the desired direction
* Useful for stationary abilities or structures that have parts which need to face a moving target

### Hosting - Host Forward Site Operations - Hold Rotation

If enabled the actor with this SOp is locked with it's rotation facing the direction of creation relative to the global map grid

### Hosting - Host Forward Site Operations - Operations

* SOps used to determine the exact direction of facing relative to the **Hosting - Host Forward - Subject**
* Usually a Site Operation (Attachment)
* If the faced attachment point moves due to a scale change, this SOp causes the actor with it to follow the attachment point which has potential for customized animations

### Hosting - Host Supporter - Actor

* **Actor Find:** (Not Sure) means the actor has to be found using the scope
* **Creation:** (Not Sure) is the actor that creates this actor is given priority for hosting if there is a choice of several
* **Implicit:** is the default

### Hosting - Host Supporter - Effect

* The effect whose scope is used in combination with the Hosting - Host Supporter - Scope field to determine valid subjects

### Hosting - Host Supporter - Fail If No Host

* Causes the model to be automatically destroyed if no host

### Hosting - Host Supporter - Scope

* **Implicit:** is the default but gives an error message if using the scope of an effect
* **Scope Caster:** (Unsure) Uses the scope of the caster of the effect to choose the caster unit as the subject
* **Scope Effect:** (Unknown)
* **Scope Missile:** (Unknown)
* **Scope Outer:** (Unknown)
* **Scope Source:** (Unknown) Uses the scope of the source of the effect to choose the source unit as the subject
* **Scope Target:** (Unknown) Uses the scope of the target of the effect to choose the target unit as the subject

### Hosting - Host Supporter - Subject

* Actor, alias or reference refered to by the **::Supporter** system reference for Events+

### Properties - Accepted Property Transfers

* When this actor is in the Hosting - Host - Subject field of another actor, this field determines what properties are able to be inherited from this actor
* As this actor has no visuals this field is pointless
* **Cast Shadows:** allows the attached actor to cast shadows
* **Cloak Effect:** allows the attached actor to show the cloaking bluish effect
* **Decal:** allows the attached actor to show the host unit decal
* **Local Tint Color:** (Unknown)
* **Model Scale:** makes the actor inherit the scale for the host model
* **Opacity:** spreads the opacity set by the Set Opacity event to attached actors
* **Physics State:** (Unknown)
* **Scale:** transfers the scale of the host actor to the attached actors
* **Team Color:** makes the attached actor show the team colour if it can
* **Time Scale:** means the animations of the attached actor are the same as the host actors timescale
* **Tint Color:** (Unknown)
* **Visibility:** allows the attached actor to share the host actor's Actor - Fog Visibility
* **Warp Group:** (Unknown)

### Properties - Accepted Transfers

* As this actor has no visuals this field is pointless
* **Animation Properties:** (Unknown)
* **Animator:** (Unknown)
* **Fog Of War Color:** (Unknown)
* **Fog Of War Shader:** (Unknown)
* **Model:** (Unknown)
* **Position:** (Unknown)
* **Rotation:** (Unknown)
* **Status:** (Unknown)
* **Textures:** (Unknown)

### Properties - Inherit Type

* As this actor has no visuals this field is pointless
* Determines how often the host properties are inherited
* **Continuous:** means the properties are continuously inherited from the host
* **None:** means properties are not inherited from the host
* **Once:** means properties are only inherited on actor creation

### Properties - Inherited Properties

* This field determines what properties are able to be inherited from the actor in the Hosting - Host - Subject or Hosting - Host For Properties - Subject field
* **Cast Shadows:** allows the attached actor to cast shadows
* **Cloak Effect:** allows the attached actor to show the cloaking bluish effect
* **Decal:** allows the attached actor to show the host unit decal
* **Local Tint Color:** (Unknown)
* **Model Scale:** makes the actor inherit the scale for the host model
* **Opacity:** spreads the opacity set by the Set Opacity event to attached actors
* **Physics State:** (Unknown)
* **Scale:** transfers the scale of the host actor to the attached actors
* **Team Color:** makes the attached actor show the team colour if it can
* **Time Scale:** means the animations of the attached actor are the same as the host actors timescale
* **Tint Color:** (Unknown)
* **Visibility:** allows the attached actor to share the host actor's Actor - Fog Visibility
* **Warp Group:** (Unknown)
* As this actor has no visuals this field is pointless

## Related

* Actors
* Site Operation (Attachment)