tableImage: Difference between revisions
Jump to navigation
Jump to search
m (Conversion script moved page TableImage to tableImage: Converting page titles to lowercase) |
No edit summary |
||
Line 6: | Line 6: | ||
|usage= | |usage= | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
tableImage(name) | tableImage(name) | ||
tableImage(name, row) | tableImage(name, row) | ||
Line 13: | Line 13: | ||
tblImage(name, row) | tblImage(name, row) | ||
tblImage(name, row, size) | tblImage(name, row, size) | ||
</ | </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]]. | ||
Line 21: | Line 21: | ||
|examples= | |examples= | ||
'''Example 1:''' Display a random image from [[Table|table]] {{code|"tbl1"}} using default [[Roll|roll]]: | '''Example 1:''' Display a random image from [[Table|table]] {{code|"tbl1"}} using default [[Roll|roll]]: | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
<image src='[r: tableImage("tbl1")]'></image> | <image src='[r: tableImage("tbl1")]'></image> | ||
</ | </syntaxhighlight> | ||
'''Example 1:''' Display the first image from [[Table|table]] {{code|"tbl1"}}: | '''Example 1:''' Display the first image from [[Table|table]] {{code|"tbl1"}}: | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
<image src='[r: tableImage("tbl1", 1)]'></image> | <image src='[r: tableImage("tbl1", 1)]'></image> | ||
</ | </syntaxhighlight> | ||
'''Example 2:''' Display one of the first four images, resized to {{code|40}} pixels tall, from {{code|"tbl1"}}, chosed randomly: | '''Example 2:''' Display one of the first four images, resized to {{code|40}} pixels tall, from {{code|"tbl1"}}, chosed randomly: | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
<image src='[r: tableImage("tbl1", "1d4", 40)]'></image> | <image src='[r: tableImage("tbl1", "1d4", 40)]'></image> | ||
</ | </syntaxhighlight> | ||
<i>'''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 {{code|width}} attribute to your {{code|image}} or {{code|img}} tags can work around this issue if you are experiencing it.</i> | <i>'''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 {{code|width}} attribute to your {{code|image}} or {{code|img}} tags can work around this issue if you are experiencing it.</i> | ||
Revision as of 17:11, 14 March 2023
tableImage() Function
• Introduced in version 1.3b40
Gets the image asset value from the specified table. If the row is not specified then the default roll for the table is used.
Usage
tableImage(name)
tableImage(name, row)
tableImage(name, row, size)
tblImage(name)
tblImage(name, row)
tblImage(name, row, size)
Parameters
name
- A string containing the name of the table.row
- The row 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
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
"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>
width
attribute to your image
or img
tags can work around this issue if you are experiencing it.