User Tools

Site Tools


4rpl:commands:setthemeoverlaypixels

Differences

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

Link to this comparison view

Next revision
Previous revision
4rpl:commands:setthemeoverlaypixels [2021/02/09 20:52] – created virgilw4rpl:commands:setthemeoverlaypixels [2025/02/14 14:57] (current) – external edit 127.0.0.1
Line 4: Line 4:
 :!: Available in version 1.3 and later. :!: Available in version 1.3 and later.
 ====== SetThemeOverlayPixels ====== ====== SetThemeOverlayPixels ======
-SetThemeOverlayPixels(<-overlayNumber <-targetX <-targetY <-blockWidth <-blockHeight <-pixelData)+SetThemeOverlayPixels(<-overlayNumber <-targetX <-targetZ <-blockWidth <-blockHeight <-pixelData)
  
 ===== Description ===== ===== Description =====
 Sets a block of pixels in the theme overlay texture. The overlayNumber should be 0 or 1.\\ Sets a block of pixels in the theme overlay texture. The overlayNumber should be 0 or 1.\\
-The targetX and targetY parameters specify the location to apply the block of pixel data. The block will be applied starting at the lower leftof the block.\\+The targetX and targetZ parameters specify the location to apply the block of pixel data. The block will be applied starting at the lower leftof the block.\\
 The blockWidth and blockHeight specify the width and height of the pixelData.\\ The blockWidth and blockHeight specify the width and height of the pixelData.\\
 The pixelData is a list of color values. It's length should be blockWidth * blockHeight.\\ The pixelData is a list of color values. It's length should be blockWidth * blockHeight.\\
-The colors in the pixelData are V4 values and the 4th field is treated as the transparency (alpha) value. If the alpha value is higher than 1, this is interpreted as a special value meaning to not apply the pixel. This allows for pixel values within blocks that will not be applied to the overlay texture (the pixels in the overlay texture will remain undisturbed).+The colors in the pixelData are V4 values and the 4th field is treated as the transparency (alpha) value.  
 + 
 +An alpha value of 0 is transparent, 1 is opaque. If the alpha value is higher than 1, this is interpreted as a special value meaning to not apply the pixel. This allows for pixel values within blocks that will not be applied to the overlay texture (the pixels in the overlay texture will remain undisturbed).
  
 ===== Examples ===== ===== Examples =====
-<code 4rpl>+<file 4rpl Overlay Test.4rpl>
 $pixelsPerCell:8 #The block size should match this $pixelsPerCell:8 #The block size should match this
  
Line 57: Line 59:
  <-T <-Y <-Y <-Y <-Y <-Y <-Y <-T  <-T <-Y <-Y <-Y <-Y <-Y <-Y <-T
  <-T <-T <-Y <-Y <-Y <-Y <-T <-T List ->yellowBlock  <-T <-T <-Y <-Y <-Y <-Y <-T <-T List ->yellowBlock
-</code>+</file>
  
 <=[[4rpl:start| Index]] <=[[4rpl:start| Index]]
4rpl/commands/setthemeoverlaypixels.1612903976.txt.gz · Last modified: 2025/02/14 14:56 (external edit)