Marblecore Imaging Library Documentation

Documentation Introduction
Documentation / Marblecore Imaging / Methods / DrawRectangleTransparent

DrawRectangleTransparent method

Draws a gradient filled rectangle on the specified position with the specified width and height.

Syntax

Boolean DrawRectangleTransparent(nLeft As Number, nTop As Number, nWidth As Number, nHeight As Number, nOpacityBegin As Number, nOpacityEnd As Number, nGradient As Gradient, nBackgroundColor As Number, nBackgroundOpacity As Number)

Return value

Returns true if the function succeeded.

Parameters

ParameterTypeRequiredDescription
nLeftNumberYesSpecifies the horizontal coordinate.
nTopNumberYesSpecifies the vertical coordinate.
nWidthNumberYesSpecifies the width.
nHeightNumberYesSpecifies the height.
nOpacityBeginNumberNoOptional parameter containing the begin opacity percentage (where 0% is completely transparent).
nOpacityEndNumberNoOptional parameter containing the end opacity percentage (where 0% is completely transparent).
nGradientGradient (Enumeration)NoOptional parameter containing the gradient style.
nBackgroundColorNumberNoOptional parameter which specifies the background color. If omitted, the default background color will be used.
nBackgroundOpacityNumberNoOptional parameter which specifies the opacity of the background color.

Example

The example below shows the effect of this method and how to use it. You can slide the marker in the before/after picture to see the difference. If you take a look at the example code, assume there is a reference to the Marblecore Imaging object with the name 'MarblecoreImaging'. Transparent parts of the image are displayed using a checkerboard pattern.
 
before
after
 
1 // Creates a new transparent image
2 MarblecoreImaging.Create(150, 150, true);
3 
4 // Execute the operation
5 MarblecoreImaging.DrawRectangleTransparent(25, 25, 100, 100, 0, 100, "Vertical");
6 
7 // Save the modified image to the specified file
8 MarblecoreImaging.SaveToFile("example-drawrectangletransparent-after.jpg");

Category

Drawing

See also

DrawArc | DrawArrow | DrawBackground | DrawBezier | DrawCheckerboard | DrawCurve | DrawCurveBorder | DrawCurveFilled | DrawCurveGradient | DrawEllipse | DrawEllipseBorder | DrawEllipseFilled | DrawEllipseGradient | DrawFloodFill | DrawLine | DrawPie | DrawPieBorder | DrawPieFilled | DrawPieGradient | DrawPixel | DrawPolygon | DrawPolygonBorder | DrawPolygonFilled | DrawPolygonGradient | DrawRectangle | DrawRectangleBorder | DrawRectangleFilled | DrawRectangleGradient | DrawRhombus | DrawRhombusBorder | DrawRhombusFilled | DrawRhombusGradient | DrawRoundRectangle | DrawRoundRectangleBorder | DrawRoundRectangleFilled | DrawRoundRectangleGradient | DrawTriangle | DrawTriangleBorder | DrawTriangleFilled | DrawTriangleGradient | GetPixelColor | LineTo | MoveTo