AlignChar (CMS) - Revision history

AFRLme at 18:49, 23 August 2022

2022-08-23T18:49:25Z

AFRLme at 18:48, 23 August 2022

2022-08-23T18:48:50Z

AFRLme at 23:23, 20 August 2022

2022-08-20T23:23:11Z

AFRLme at 22:40, 20 August 2022

2022-08-20T22:40:35Z

AFRLme at 22:39, 20 August 2022

2022-08-20T22:39:09Z

AFRLme at 22:38, 20 August 2022

2022-08-20T22:38:29Z

AFRLme at 22:38, 20 August 2022

2022-08-20T22:38:02Z

AFRLme at 18:40, 12 July 2015

2015-07-12T18:40:26Z

AFRLme at 15:34, 8 October 2014

2014-10-08T15:34:55Z

David Stoffel: Text replacement - "wikitable" to "ts"

2014-08-19T17:34:55Z

Text replacement - "wikitable" to "ts"

@@ Line 60: / Line 60: @@
 ! style="text-align:left" | Name !! style="text-align:left" | Type !! style="text-align:left;width:80%" | Description
 |-
-| c || "string" or nil || This should be a "string" value containing the name of the character you want to affect, or <span class="inlinecode">nil</span> if you want to link to the current character.
+| c || "string" or nil || This should be a "string" value containing the name of the character you want to affect, or nil if you want to link to the current character.
 |-
-| t || "string" or nil || This should be a "string" value containing the name of the character you want to align to, or <span class="inlinecode">nil</span> if you want to link to the current character.
+| t || "string" or nil || This should be a "string" value containing the name of the character you want to align to, or nil if you want to link to the current character.
 |}{{toc}}

@@ Line 60: / Line 60: @@
 ! style="text-align:left" | Name !! style="text-align:left" | Type !! style="text-align:left;width:80%" | Description
 |-
-| c || "string" or nil || This should be a "string" value containing the name of the character you want to affect, or nil if you want to link to the current character.
+| c || "string" or nil || This should be a "string" value containing the name of the character you want to affect, or <span class="inlinecode">nil</span> if you want to link to the current character.
 |-
-| t || "string" or nil || This should be a "string" value containing the name of the character you want to align to, or nil if you want to link to the current character.
+| t || "string" or nil || This should be a "string" value containing the name of the character you want to align to, or <span class="inlinecode">nil</span> if you want to link to the current character.
 |}{{toc}}

@@ Line 37: / Line 37: @@
 <syntaxhighlight lang="lua">
 function alignChar(c, t)
-  if c == nil then c = game.CurrentCharacter else c = Characters[c] end -- check if character or current character
+  if c == nil then c = game.CurrentCharacter else c = Characters[c] end -- store character or current character
-  if t == nil then t = game.CurrentCharacter else t = Characters[t] end -- check if character or current character
+  if t == nil then t = game.CurrentCharacter else t = Characters[t] end -- store character or current character
   -- + --
   local p1 = c.Position -- store characters position

@@ Line 62: / Line 62: @@
 | c || "string" or nil || This should be a "string" value containing the name of the character you want to affect, or nil if you want to link to the current character.
 |-
-| t || "string" || This should be a "string" value containing the name of the character you want to align to, or nil if you want to link to the current character.
+| t || "string" or nil || This should be a "string" value containing the name of the character you want to align to, or nil if you want to link to the current character.
 |}{{toc}}

@@ Line 7: / Line 7: @@
 This small function allows you to quickly align a character to another character.
 {| class="toccolours mw-collapsible mw-collapsed ts"
 |-
@@ Line 15: / Line 16: @@
 | There is no simple method for obtaining the top (y) pixel coordinate of the currently active character animation.
 |}
 == Instructions ==
@@ Line 30: / Line 32: @@
 alignChar("Tom")
 </syntaxhighlight>
 == Main Script ==
@@ Line 50: / Line 53: @@
 end
 </syntaxhighlight>
 == Syntax Breakdown ==

@@ Line 19: / Line 19: @@
 . Add the [[#Main_Script|main script]] to the Visionaire Studio Script Editor & set the script as a definition script.<br/>
 a. To align current character to another character...
-<syntaxhighlight>
+<syntaxhighlight lang="lua">
-alignChar("", "character_name")
+alignChar(nil, "Tom")
 </syntaxhighlight>
 b. To align a specific character to another character...
-<syntaxhighlight>
+<syntaxhighlight lang="lua">
-alignChar("character_name", "character_name")
+alignChar("Tom", "Barry")
 </syntaxhighlight>
 c. To align a specific character to current character...
-<syntaxhighlight>
+<syntaxhighlight lang="lua">
-alignChar("character_name", "")
+alignChar("Tom", nil)
 </syntaxhighlight>
 == Main Script ==
-<syntaxhighlight>
+<syntaxhighlight lang="lua">
 function alignChar(c, t)
-  if c == "" then c = game:getLink(VGameCurrentCharacter) else c = getObject("Characters[" .. c .. "]") end
+  if c == nil then c = game.CurrentCharacter else c = Characters[c] end -- check if character or current character
-  if t == "" then t = game:getLink(VGameCurrentCharacter) else t = getObject("Characters[" .. t .. "]") end
+  if t == nil then t = game.CurrentCharacter else t = Characters[t] end -- check if character or current character
   -- + --
-  local p1 = c:getPoint(VCharacterPosition)
+  local p1 = c.Position -- store characters position
-  local p2 = t:getPoint(VCharacterPosition)
+  local p2 = t.Position -- store target characters position
   -- + --
   local ax, ay
-  ay = p1.y - p2.y
+ ax = p2.x - p1.x -- calculate x destination coordinate
- ax = p2.x - p1.x
+  ay = p1.y - p2.y -- calculate y destination coordinate
   -- + --
-  local angle = math.deg( math.atan2(ay, ax) )
+  local angle = math.deg( math.atan(ay, ax) ) -- calculate angle
-  if angle < 0 then angle = 360 + angle end
+  if angle < 0 then angle = 360 + angle end -- some fallback? I don't remember why I wrote it
   -- + --
-  c:setValue(VCharacterDirection, angle)
+  c.Direction = angle -- update specified characters direction
 end
 </syntaxhighlight>
@@ Line 56: / Line 56: @@
 ! style="text-align:left" | Name !! style="text-align:left" | Type !! style="text-align:left;width:80%" | Description
 |-
-| c || "string" || This should be a "string" value containing the name of the character you want to affect; if string is empty it will default to current character.
+| c || "string" or nil || This should be a "string" value containing the name of the character you want to affect, or nil if you want to link to the current character.
 |-
-| t || "string" || This should be a "string" value containing the name of the character you want to align to; if string is empty it will default to current character.
+| t || "string" || This should be a "string" value containing the name of the character you want to align to, or nil if you want to link to the current character.
-|}
+|}{{toc}}

@@ Line 7: / Line 7: @@
 This small function allows you to quickly align a character to another character.
-<div class="toccolours mw-collapsible mw-collapsed tbl-ds">
+{| class="toccolours mw-collapsible mw-collapsed ts"
-<span class="bold">Additional Info</span>
+|-
-<div class="mw-collapsible-content">
+! Additional Info
-<div class="alt-bg">Alignment is based on character center which is usually set near the feet.</div>
+|-
-<div>There is no simple method for obtaining the top (y) pixel coordinate of the currently active character animation.</div>
+| Alignment is based on character center which is usually set near the feet.
-</div></div>
+|-
+| There is no simple method for obtaining the top (y) pixel coordinate of the currently active character animation.
 == Instructions ==

@@ Line 1: / Line 1: @@
-{| class="wikitable" style="width:100%"
+{| class="ts" style="width:100%"
 |-
 ! style="text-align:left" | Name !! style="text-align:left" | Type !! style="text-align:left" | By
@@ Line 51: / Line 51: @@
 == Syntax Breakdown ==
-{| class="wikitable" style="width:100%"
+{| class="ts" style="width:100%"
 |-
 ! style="text-align:left" | Name !! style="text-align:left" | Type !! style="text-align:left;width:80%" | Description