tableImage: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
Line 3: Line 3:
|version=1.3b40
|version=1.3b40
|description=
|description=
Gets the image asset value from the specified [[Table|table]]. If the row is not specified then the default [[Roll|roll]] for the [[Table|table]] is used.
Gets the image asset value from the specified [[Table|table]]. If the roll is not specified then the default [[Roll|roll]] for the [[Table|table]] is used.


|usage=
|usage=
<syntaxhighlight lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
tableImage(name)
tableImage(name)
tableImage(name, row)
tableImage(name, roll)
tableImage(name, row, size)
tableImage(name, roll, size)
tblImage(name)
tblImage(name)
tblImage(name, row)
tblImage(name, roll)
tblImage(name, row, size)
tblImage(name, roll, size)
</syntaxhighlight>
</syntaxhighlight>
'''Parameters'''
'''Parameters'''
* {{code|name}} - A string containing the name of the [[Table|table]].
* {{code|name}} - A string containing the name of the [[Table|table]].
* {{code|row}} - The row of the [[Table|table]] that should have the image asset returned.
* {{code|row}} - The entry of the [[Table|table]] that should have the image asset returned.
* {{code|size}} - The size the image asset returned should be. If the image is not square, this will be the size of the height.
* {{code|size}} - The size the image asset returned should be. If the image is not square, this will be the size of the height.



Latest revision as of 19:20, 15 July 2024

tableImage() Function

Introduced in version 1.3b40
Gets the image asset value from the specified table. If the roll is not specified then the default roll for the table is used.

Usage

tableImage(name)
tableImage(name, roll)
tableImage(name, roll, size)
tblImage(name)
tblImage(name, roll)
tblImage(name, roll, size)

Parameters

  • name - A string containing the name of the table.
  • row - The entry of the table that should have the image asset returned.
  • size - The size the image asset returned should be. If the image is not square, this will be the size of the height.

Examples

Example 1: Display a random image from table "tbl1" using default roll:
<image src='[r: tableImage("tbl1")]'></image>

Example 1: Display the first image from table "tbl1":

<image src='[r: tableImage("tbl1", 1)]'></image>

Example 2: Display one of the first four images, resized to 40 pixels tall, from "tbl1", chosed randomly:

<image src='[r: tableImage("tbl1", "1d4", 40)]'></image>
Note: In these examples, an image is sent into the chat. When sending multiple images to chat, a rendering issue can occur where images are not fully displayed until the chat panel is updated. Adding a width attribute to your image or img tags can work around this issue if you are experiencing it.

See Also