Raycasting::testPointToPoint

2018-07-07T14:17:46Z

J03Y: /* Example */

This function casts a ray from Point1 to Point2 and returns the position and entity of what's in the way, or undefined if the way is cleared. Flags are intersection bit flags. They tell the ray what to care about and what not to care about when casting. Passing -1 will intersect with everything, presumably. Flags: 1: Intersect with map 2: Intersect with vehicles (used to be mission entities?) (includes train) 4: Intersect with peds? (same as 8) 8: Intersect with peds? (same as 4) 16: Intersect with objects 32: Unknown 64: Unknown 128: Unknown 256: Intersect with vegetation (plants, coral. trees not included) NOTE: Raycasts that intersect with mission_entites (flag = 2) has limited range and will not register for far away entites. The range seems to be about 30 metres.
==Syntax==
<syntaxhighlight lang="javascript">mp.raycasting.testPointToPoint(pos1, pos2, [ignoredEntity], [flags]);</syntaxhighlight>
=== Required Arguments ===
*'''pos1:''' Vector3
*'''pos2:''' Vector3
*'''ignoreEntity:''' Entity handle or object
*'''flags:''' Int
===Return value===
*'''object'''
==Example==
<div class="header" style="background-color: #408DAE; color: #FFFFFF; border: 2px solid #408DAE;">
<div style="margin: 10px 10px 10px 10px;">Client-Side</div>
<syntaxhighlight lang="javascript" highlight="5">
mp.events.add('render', () => {
const startPosition = mp.players.local.getBoneCoords(12844, 0.5, 0, 0);
const endPosition = new mp.Vector3(0, 0, 75);

const hitData = mp.raycasting.testPointToPoint(startPosition, endPosition);
if (!hitData) {
mp.game.graphics.drawLine(startPosition.x, startPosition.y, startPosition.z, endPosition.x, endPosition.y, endPosition.z, 255, 255, 255, 255); // Is in line of sight
} else {
mp.game.graphics.drawLine(startPosition.x, startPosition.y, startPosition.z, endPosition.x, endPosition.y, endPosition.z, 255, 0, 0, 255); // Is NOT in line of sight
}
});

</syntaxhighlight>
</div>

==See also==
{{Worldprobe_s_function_c}}
[[Category:Clientside API]]
[[Category:TODO: Example]]

Blip::Blip

2018-05-31T13:24:10Z

J03Y: /* Parameters */

{{Shared}}

Creates a blip to display on your map & minimap.

== Syntax ==

<syntaxhighlight lang="javascript">
mp.blips.new(sprite, position,
{
name: name,
scale: scale,
color: color,
alpha: alpha,
drawDistance: drawDistance,
shortRange: shortRange,
rotation: rotation,
dimension: dimension,
});
</syntaxhighlight>

=== Parameters ===
*'''*sprite''': {{RageType|Int}} ([[Blips#Blip_model|Blip sprites]])
*'''*position''': {{RageType|Vector3}}
*'''name''': {{RageType|String}}
*'''scale''': {{RageType|Float}}
*'''color''': {{RageType|Color ID}} ([[Blips#Blip_colors|Blip colors]])
*'''alpha''': {{RageType|Int}} [0:255]
*'''drawDistance''': {{RageType|Float}}
*'''shortRange''': {{RageType|Boolean}}: Auto-hide on the minimap
*'''rotation''': {{RageType|Float}}
*'''dimension''': {{RageType|Int}}

* = Required

== Examples ==

This creates a blip at the police station. The blip is assigned to the variable '''policeBlip'''.

<syntaxhighlight lang="javascript">
let policeBlip = mp.blips.new(60, new mp.Vector3(427.95, -981.05, 0),
{
name: 'Los Santos Police Station',
color: 3,
shortRange: true,
});
</syntaxhighlight>

== See Also ==
{{Blip_definition}}

RAGE Multiplayer Wiki - User contributions [en]

Raycasting::testPointToPoint

Blip::Blip