{<entity> = } cell <file>
Create a cell graphic entity from a raster image.
<entity>
An entity or gstructure identifier. The cell entity will be given this name.
<file>
The image file providing the entity image.
-alph=<num>
An alpha transparency factor between 0 and 1. A value 1 implies fully opaque,
0 means fully transparent (therefore invisible). The default is 1.
-ang=<num>
A rotation angle, measured anticlockwise.
-br=<num>
A brightness factor between -1 and +1. A value 0 means normal, -1 means
very dark (black), +1 means very bright (white). The default is 1.
-fr=<num>
Define a fragment number for the entity. If omitted, the default fragment def_fragment is used.
-g=<groups>
The graphic groups of which the entity is to be a member. If this is an assignment
of a compound child entity, the -g switch is ignored
and the child assumes the group membership of its compound parent.
-int
During rendering, interpolate the image pixels using anti-aliasing. The default behavior is not to.
-hot=<x,y>
The hotspot of the image, used for positioning. If this is omitted the justification
(-j) is used. If there is no justification specified
then the hotspot within the file is used, or 0,0 if no hotspot is available.
The Y coordinate system of an image has zero at the top-left corner.
-j=<string>
The justification of the image, i.e which point of the image is placed at
the control position (defined by -p). This may
be a combination of L,R,T,B and M or omitted altogether in which case
the hotspot of the image is used.
-out
Draw the cell in outline only. The default behavior is to fully draw
the image.
-p=<point>
The position of the cell in 3-D space. If omitted, the current value of graphic
control is used.
-ra=<num>
Define a rank for the entity. If omitted, the default rank def_rank
is used.
-s=<num>
A uniform scaling factor to be applied to both axes, equivalent to -x=< num>,-y=<num>.
-su=<text>
The units in which the dimensions of the image are measured.
Possible values can be found here.
If omitted, the default is P (pixels).
-trans
Display the image through a stencil. This will result in only non-background
pixels being displayed. The default behavior is to show the image opaque.
-x=<num> and -y=<num>
Stretch factors to be applied to one or more axes. The default values are 1,1.
Negative value mirror pixels in the relevant axis.
When successful, this command always creates a graphic primitive.
Currently cell primitives are visible in plan views only.
Create an unnamed cell entity at a point indicated interactively .
cell myfile.ras,-p=pcur,-j='m',-trans
Create a named cell entity.
entity print_image print_image = cell $MXIMAGES/printer,-trans
Commands: |
|
Identifiers: |
angle_mode (string) def_fragment (cursor), def_rank (numeric) |