VectorImage::AddPixMap

Adds a pixmap to the VectorImage.

GSErrCode  AddPixMap (
    short               pen,
    short               layer,
    short               drwIndex,
    GSPixMapHandle      pict,
    Box2DData*          drawnBox,
    bool                mirrored,
    bool                transparent,
    double              rotAngle
);

Parameters

pen

Not used, should be zero.

layer

The containing layer of the pixmap It should range from 1 to 16.

drwIndex

The drawing index of the pixmap. It influences the drawing order of the item.

pict

The pixmap itself in GSPixMap format.

drawnBox

The part of the pixmap which will be used.

mirrored

True, if the pixmap should be drawn mirrored to the vertical axis before rotation.

transparent

True, if the pixmap should be transparent.

rotAngle

The rotation angle of the pixmap.

Return value

If the function succeeds, the return value is NoError. If the function fails, the return value is the error code.

Description

Addition always merges the new item to the end of the primitives list but drawing order can differ from placing order.

Requirements

Version:API 10.0 or later, ModelerGraphics 8 or later

Library:ModelerGraphicsImp.lib (Win) or ModelerGraphics.framework (Mac)

Header:VectorImage.hpp