User Tools

Site Tools


stretch_mode

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
Last revisionBoth sides next revision
stretch_mode [2024/02/08 19:42] justinstretch_mode [2024/02/18 11:56] justin
Line 1: Line 1:
 ======Stretch Mode====== ======Stretch Mode======
 ---- ----
-The **stretch mode** is used to determine how an [[image]] is displayed within its bounding area.+The **stretch mode** is used to determine how an [[image]] is displayed within its bounding area. This setting is used in various places throughout RPG in a Box, e.g. the [[Display Image]] scripting function, [[image_element|image elements]] in [[widget|widgets]].
  
 ^Mode^Description^ ^Mode^Description^
 |STRETCH_SCALE|The [[image]] is scaled up or down to fit the entire bounding area. Note that the size and aspect ratio of the [[image]] aren't maintained when using this mode, as it's stretched both horizontally and vertically to cover the area.| |STRETCH_SCALE|The [[image]] is scaled up or down to fit the entire bounding area. Note that the size and aspect ratio of the [[image]] aren't maintained when using this mode, as it's stretched both horizontally and vertically to cover the area.|
-|STRETCH_TILE|The [[image]] is tiled across the entire bounding area. The original size is maintained when using this mode.| +|STRETCH_TILE|The [[image]] is tiled across the entire bounding area. The [[image|image's]] original size is maintained when using this mode.| 
-|STRETCH_KEEP| | +|STRETCH_KEEP|The [[image]] is displayed in the top left corner of the bounding area, with its original size maintained.
-|STRETCH_KEEP_CENTERED| | +|STRETCH_KEEP_CENTERED|The [[image]] is displayed in the center of the bounding area, with its original size maintained.
-|STRETCH_KEEP_ASPECT| | +|STRETCH_KEEP_ASPECT|The [[image]] is scaled up or down to fit the bounding area vertically, while being anchored at the top left of the bounding area and having its aspect ratio maintained.
-|STRETCH_KEEP_ASPECT_CENTERED| | +|STRETCH_KEEP_ASPECT_CENTERED|The [[image]] is scaled up or down to fit the bounding area vertically, while also being centered horizontally within the bounding area and having its aspect ratio maintained.
-|STRETCH_KEEP_ASPECT_COVERED| |+|STRETCH_KEEP_ASPECT_COVERED|The [[image]] is scaled up or down (aspect ration maintained) to the extent that it completely covers the bounding area (i.e. no transparent/black bars along the sides or top/bottom). This will potentially cut off some of the sides or top/bottom of the [[image]] according its aspect ratio, but it ensures that the bounding area is covered entirely by the [[image]].|
  
 ~~NOTOC~~ ~~NOTOC~~
stretch_mode.txt · Last modified: 2024/02/18 11:57 by justin