VisionaireObject Command: getPath

From The Official Visionaire Studio: Adventure Game Engine Wiki
Revision as of 20:39, 11 August 2023 by EK (talk | contribs) (Created page with "Returns the path to a media file, linked in a VisionaireObject field. == Syntax == <syntaxhighlight lang="lua"> getPath(field) </syntaxhighlight> == Parameters == {| clas...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Returns the path to a media file, linked in a VisionaireObject field.


Syntax

getPath(field)


Parameters

Parameter Type Description
field integer The field which specifies a path. The field type must be "t_path".

Specify the field constant name (V + object table name in singular + field name) or the field id, see the example.


Return values

Type Description
string The file path stored in the field.


Examples

Example 1: Get the file path to a scene's background music.

-- Specify the field constant name or the field id
local bg_file = getObject("Scenes[kitchen]"):getPath(VSceneBackgroundMusic)
local bg_file = getObject("Scenes[kitchen]"):getPath(132)

-- The shorthand notation offers a more convenient way to achieve the same
local bg_file = Scenes["kitchen"].BackgroundMusic