SDJB_DrawLinesBetween

じ☆ve冰风

PluginName: SDJB_DrawLinesBetween
Author: ShadowDragon





Cool feature, draw progress line (0-1), for skill tree in one way.




CTBolt created a nice plugin "CreateLinesBetween", but has some issues
and bugs, and was for MZ only.

As I re-create it from scratch and some logic from his, I improved performance
and optimized it to make it work for MV and MZ.

I also added some features, see spoiler how to use.

Spoiler: How to use

                Code:       

1. Introduction
2. ͞ ͞ ͞ ͞ ͞ ͞ ͞ ͞ ͞ ͞ ͞ ͞
3. Create Lines between player to event, follower to event, event to event
4. or map coordinates (x,y) in tiles or pixels.
7. How to Use
8. ͞ ͞ ͞ ͞ ͞ ͞ ͞ ͞ ͞ ͞
9. There are some scriptcalls you can use to make it clean, easy and
10. best of all, user-friendly and efficient.
12. There are 3 ways to set it up!
14. $gameScreen.setLine(connect, options)
16. connect:
17.    => There are 2 ways for connect the sources
18.    1) Characters connect is using an array [A, B]
19.       
20.         0 = player
21.       < 0 = followers
22.       > 0 = event ID
24. Example:
25.    $gameScreen.setLine([0, 3])    //=> player ↔ event 3
26.    $gameScreen.setLine([-2, 7])   //=> follower 2 ↔ event 7
27.    $gameScreen.setLine([2, 5])    //=> event 2 ↔ event 5
29. You can use options to customize the line:
30.    pixel, zIndex, width, color, progress, speed, alpha and pulse.
32. Example:
33.    $gameScreen.setLine([2,5], {width: 2, color:0x00ff00, alpha: 1});
35. zIndex:
36.     Sets the line priority, higher values appear above lower values.
37.     Default is 0.
39. width:
40.     The thickness of the line (default is 2)
42. mode:
43.     Determines how the line is animated.
44.        "progress" = line is drawn over time.
45.            The initial progress of the line (0 → 1). Default is 1 (instant).
46.            Can be used to start the line partially drawn.
48.        "pulse"    = line continuously grows and shrinks in width.
49.            Enables a pulsing width animation.
50.            The value is the maximum additional width applied during the pulse cycle.
52.            width: 2, pulse: 2  //=> 2px ↔ 4px
53.            width: 2, pulse: 3  //=> 2px ↔ 5px
55.     Default is "none".
57. speed:
58.     Controls the animation speed.
59.        mode: "progress"
60.            Number of frames required to draw the line completely.
62.        mode: "pulse"
63.            Number of frames required to expand from the base width
64.            to the maximum pulse width.
66. color:
67.     The color of the line in hex: "#FF0000" or 0xFF0000, as both works
68.     The default color is white (0xFFFFFF)
70. alpha:
71.     The alpha color, which by default is 1
74.    2) Coordinates connects is using an object array [{x:n, y:n},{x:n, y:n}]
75.       This can also go in 2 ways, by tiles or by pixels (default false)
77.       By default, pixels is false, meaning: coordinate by tiles.
79. Example:
80.     Start at Map X 4, Y 6 and end at X 10, Y 48:
81.     $gameScreen.setLine([{x:4,y:6}, {x:10,y:48}])
83.     Start at Map X 210, Y 30 and end at X 700, Y 300
84.     $gameScreen.setLine([{x:210,y:30},{x:700,y:300}], {pixel:true});
86.     pixel:
87.       true  = pixel coordinates
88.       false = map tiles
90.     With all options (optional):
91.     $gameScreen.setLine([{x:50,y:50},{x:500,y:500}], {
92.        pixel:true, zIndex:1, width:4, pulse:3, speed:120, color:0x00FF00, alpha:0.7});
95.    3) Besides connecting character to character, or Map coordinates,
96.       you could also connect events to map coordinates.
98. Example:
99.     $gameScreen.setLine([0, {x:8, y: 10}])    //=> player ↔ Map Coordinates
100.     $gameScreen.setLine([0, {x:8, y: 10}], {color: "#00FFFF"})
103. Remove Lines between map coordinates:
105. Example:
106.     $gameScreen.removeLineCoords({x:4, y:6})
108.     This removes all lines, connected to that map coordinate.
111. Removing Lines between connections is relative easy as well.
113. Example:
114.     This require an start point and end point (can be used reversed)
116.     $gameScreen.removeLinesBetween(disconnect)
118.     Sample for characters:
119.     $gameScreen.removeLinesBetween([3,5])
120.     $gameScreen.removeLinesBetween([5,3]) => same effect as above
122.     Sample for map coordinates:
123.     $gameScreen.removeLinesBetween([{x:3,y:5},{x:10,y:20}])
124.     $gameScreen.removeLinesBetween([{x:10,y:20},{x:3,y:5}])  => same effect as above
126.     Sample for character and map coordinates:
127.     $gameScreen.removeLinesBetween([6,{x:10,y:20}])
128.     $gameScreen.removeLinesBetween([{x:10,y:20},6])  => same effect as above
130.     If Multple was connected to the same point, remove one line between them.
133. Removing a Line from one source can break all others.
135. Example:
136.     You have a connect A to B, A to C, A to D, D to E
138.     $gameScreen.removeLine(source)
140.     Removes ALL lines connected to the source.
141.     Remaining nodes stay connected to each other.
143.     Sample:
145.     $gameScreen.removeLine(2);   
147.     This removes all lines connected to event 2
150. To remove all lines, use the following line:
152.     $gameScreen.removeAllLines();
155. Pixel Distance
156. ͞ ͞ ͞ ͞ ͞ ͞ ͞ ͞ ͞ ͞ ͞ ͞ ͞ ͞
157. Check the console log for the pixel distance and use
158. the following scriptcall:
160. Example:
161.    $gameScreen.lineInPixels(sourceA, sourceB, pixels)
163. souceA / sourceB: check the distance between map coords or characters.
164.                    (player, followers, events)
165. pixels (optional): default is false, and only works for map coordinates
166.                    when using pixels.
169. To check the map coordinates (tiles) distance in pixels:
170.    $gameScreen.lineInPixels({x:1, y:4}, {x:5, y:6})
172. To check the map coordinates in pixels:
173.    $gameScreen.lineInPixels({x:32, y:128}, {x:64, y:192}, true)
175. To check the characters distance in pixels (player, followers, events):
176.    $gameScreen.lineInPixels(3, 12)
179. In order to use it in a conditional branch to check if its true or false
180. if map coordinates (tiles) to event id 12 is lower than 96 pixels distance.
182.    $gameScreen.lineInPixels({x:1, y:4}, 12) < 96
185. Or if you use map coords in pixels:
187.    $gameScreen.lineInPixels({x:32, y:128}, 12, true) < 96
190. Use the console log first to see the actual pixel distance.
191. This makes creating pixel-based conditions easier and more accurate.

复制代码

zIndex and pulse






=== TERMS OF USE ===
Free for Non-Commercial and Commercial use when credit is given.
credit one of the following:
ShadowDragon
ShadowDragonJB


=== WARNING ===
YOU ARE NOT ALLOWED TO:
* MODIFY without permission
* EXTEND without permission
* TAKE CODE without permission
* CLAIM AS YOU MADE IT
* REDISTRIBUTE but link back to the forum or itch.io
* SELL this product as standalone.
* DO NOT REMOVE THE HEADER.


Download fromitch.io  (require my base plugin (SDJB_Base or SDJB_BaseMZ (minified version))


本贴来自国际rpgmaker官方论坛作者:ShadowDragon处,因国际论坛即将永久关站,为了存档多年珍贵资料,署名转载到本论坛存档,由于官方帖子为英文原帖，需要中文翻译请点击论坛顶部切换语言为中文就可以将帖子翻译成中文浏览,方便大家随时查看,原文地址：https://forums.rpgmakerweb.com/threads/sdjb_drawlinesbetween.182091/