AddPicture
Modified in version 5.0
AddPicture ( left ; top ; width ; height ; sourceType ; sourceData ; borderStroke ; borderColor ; borderColorVariant ; shadowEffect ; shadowColor )
| Argument | Type | Range | Default | Note |
|---|---|---|---|---|
| left | num | -inf..+inf | (required) | |
| top | num | -inf..+inf | (required) | |
| width | num | 0..10000 | (image width) | Dimension:[pt] |
| height | num | 0..10000 | (image height) | Dimension:[pt] |
| sourceType | int | 1..4 | clipboard | |
| sourceData | str | "" | ||
| borderStroke | num[] | 0..1000 | 0 | Dimension:[pt], requires xmCHART 5.0 or higher |
| borderColor | rgba | 0..255 | black | Requires xmCHART 5.0 or higher |
| borderColorVariant | int | -1..128 | solid | Requires xmCHART 5.0 or higher |
| shadowEffect | num[] | -1000..1000 | 0 | Requires xmCHART 5.0 or higher |
| shadowColor | rgba | 0..255 | #888a | Requires xmCHART 5.0 or higher |
Examples
AddPicture(100;100;;;file;"images/gradient_01.png")
AddPicture(100;100;;;file;"~/fills/gradient_02.png")
AddPicture(100;100;;;file;"C:/Programs/Fills/Gradient003.png")
AddPicture(100;100;;;stream;"iVBORw0KGgoAAAANSUhEUgAAAEAAAABABAMA...")
Description
By using the AddPicture() function, it is possible to add a picture, e.g. a company logo, to a drawing. Two different picture sources are supported for this: a file (sourceType = file) or a Base64 encoded PNG image stream (sourceType = stream). The arguments sourceType and sourceData are explained in detail in Import Images, together with various examples showing how they are applied. Moreover, by using the arguments borderStroke, borderColor, borderColorVariant, shadowEffect and shadowColor the border and shadow can be varied.
The upper left-hand corner of the picture is positioned by using the arguments left and top. The coordinate origin is located in the upper left-hand corner of the drawing or the view. The arguments width and height serve to scale the picture. If the width and height are not defined, the actual width and height of the picture are used.
| | ADD_PICTURE_01 |
| 1 | OpenDrawing(50;60) |
| 2 | AddPicture(10;10;;;stream; |
| 3 | "data:image/png;base64,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";3;teal;shaded;2 2 4) |
| 4 |
