Command: cell

Syntax

{<entity> = } cell <file>

Description

Create a cell graphic entity from a raster image.

Parameters

• <entity>
  An entity or gstructure identifier. The cell entity will be given this name.

• <file>
  The image file providing the entity image.

Switches

• -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.

Notes

When successful, this command always creates a graphic primitive.

Currently cell primitives are visible in plan views only.

Examples

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

See Also