Topics   All   Mac OS X (Only)   Windows (Only)   Crossplatform   Server (Not)   Client   Components   Old   Guides
New in version: 4.0   4.1   4.2   4.3   4.4   5.0   5.1   5.2   5.3   5.4   6.0   6.1   6.2    Statistic  

GMImage.New

Component: GraphicsMagick
Version: 2.0
Mac OS X: Yes
Windows: Yes
Server: Yes

MBS( "GMImage.New"; Geometry; Color )

Parameters

Parameter Description Example value
Geometry The rectangle. Geometry is specified as a width and height "100x200". With an optional offset "100x200+10+20". For percent values, add a percent on the end, for % values add a %: "100x200%!" "100x200"
Color A color value.
This can be a string in the following format "HSL h s l a", "YUV y u v a", "RGB r g b a", "MONO m a", "GRAY g a" or "COLOR R G B a". Alpha value a is optional. Range of values is 0 to 1.0 except if you use COLOR where RGB values are 0 to 255.
Starting with version 5.4 of our plugin, you can use hex notation. # followed by 2 digits for red, green, blue and optional alpha, e.g. #FF0000 for full red.
"RGB 1 0 0"

Result

Returns the ImageRef number on success.

Description

Construct a blank image canvas of specified size and color.
Please call GMImage.Destroy later to free memory for this image.
Image reference numbers are starting at 18000 and counting up for each new image.

Examples

New white image:

MBS( "GMImage.New"; "16x16"; "white" )

New red image:

MBS( "GMImage.New"; "16x16"; "COLOR 255 0 0" )

Create red square and save to container:

Set Variable [$img; Value:MBS( "GMImage.New"; "16x16"; "red" )]
Set Field [test::test; MBS( "GMImage.WriteToPNGContainer"; $img; "test.png" )]
Set Variable [$r; Value:MBS( "GMImage.Destroy"; $img)]

Build in a calculation:

SetVars ( [

img = MBS( "GMImage.New"; "16x16"; "random" );
result = MBS( "GMImage.WriteToPNGContainer"; img; "test.png" );
r = MBS( "GMImage.Destroy"; img)

]; result )

See also


GMImage.Negate   -   GMImage.NewFromBase64

Feedback: Report problem or ask question.




Links
MBS Realbasic Chart Plugins - JUZ Nickenich