Rotates the image by the specified angle in degrees. Valid values are None, Horizontal, Vertical or Both. MaskImageFlip Default: Noneįlips the image. MaskImagePath Default: Noneįolder path where an image is located. If MaskImageName is defined, then ScaleMargins and Tile options cannot be used on the meter. MaskImageName cannot be bound to the meter from a measure with MeasureName N and %1, %2 etc. When both images have a shared area with full or partial transparency, the "most transparent" value is applied. If either the primary image or mask image has areas of transparency or partial transparency, those "alpha channel" values are applied to the final image. Whatever is defined as the primary image with ImageName or MeasureName is then masked into the mask image, displaying in any non-transparent areas of MaskImageName using a "fill" method that sizes and crops the image to fit while preserving the aspect ratio. If MaskImageName is defined, then W and H define the size of the mask image, and the size of the meter. MaskImageName can be a full path and name of any supported image file, or just the name of the file if the MaskImagePath option is used, or the image file is in the current skin folder. The size and shape of MaskImageName will be used to mask and define the size and shape of the primary image. Name of an image file to use as a mask for the primary image defined with MeasureName or ImageName. MaskImage will continue to be supported, but is no longer recommended. Note: This MaskImage functionality is better done with the far more powerful and flexible Container option. License=Creative Commons Attribution-Non-Commercial-Share Alike 3.0Īn example skin demonstrating an Image meter. The Path option to define the location of images is replaced by the ImagePath option in general image options. They are still supported, but may be removed in future versions. The following options have been deprecated and should not be used. Only actual images loaded from a file can be manipulated. However, no manipulations can be done to the resulting square, rectangle or line with any general image options. Hint: Using the SolidColor option, along with W and H options, an image meter may be used to draw squares, rectangles or lines without needing any ImageName or MeasureName. ![]() If set to 1, the image is tiled (repeated) within the bounds defined by W and H. Margins of the image to exclude from scaling when Tile=0 and PreserveAspectRatio=0.Įxample: ScaleMargins=10, 50, 10, 50 Tile Default: 0 ScaleMargins Format: Left, Top, Right, Bottom Note: If only one of either W or H is defined, then PreserveAspectRatio will default to 1. 2: The image is scaled and cropped to fill the bounds specified by W and/or H while preserving the aspect ratio. ![]() 1: The image is scaled to fit within the bounds specified by W and/or H while preserving the aspect ratio.0: The image is scaled to exactly fit the bounds specified by W and H without regard to aspect ratio.PreserveAspectRatio Default: 0Ĭontrols how W and H scale the image when Tile=0. If there is an external process that is changing the image file, while leaving the name the same, use DynamicVariables=1 on the meter to force the image to be reloaded from disk on every meter update. Note: When ImageName is hard-coded with an image file name, the image will be loaded and "cached", to avoid reloading the image from disk on every meter update. %1 and %2 will be replaced by the string values of SomeMeasure and png is not desired, or when ImageName is being used to define an image based on the combined values of the measures in MeasureName N and uses the % N syntax as follows: MeasureName=SomeMeasure The exceptions are when MeasureName returns a file name with no extension, and the default. Generally, MeasureName N and ImageName will not be used together in the same meter. Note: If a MeasureName N option is defined, it will override any named file in the ImageName option. This can be a full path and name of any supported image file, or just the name of the file if the ImagePath option is used or the image file is in the current skin folder. The value can define a full path and name of any supported image file, or just the name if the ImagePath option is used or the image file is in the current skin folder. The value of a measure or measures will define the image file to be used in the meter. Name(s) of the measure(s) bound to the meter. General image optionsĪll general image options are valid for ImageName. Options General meter optionsĪll general meter options are valid. ![]() If W and/or H are included in the meter options, the image will be scaled to fit the meter size. Meter=Image displays either an image defined by a measure value, or any named image.
0 Comments
Leave a Reply. |
AuthorWrite something about yourself. No need to be fancy, just an overview. ArchivesCategories |