Transform Object Command

TRANSFORM Object Commands

Copies, scales, offsets, rotates, slants and twists selected object(s).

** objectcount = TRANSFORM count [OFFSET deltax deltay] [PGS50: [+OBJECTWIDTH|-OBJECTWIDTH][+OBJECTHEIGHT|-OBJECTHEIGHT][SCALE xscale yscale] PGS41:[PAGEOFFSET poffset][STACK ] ** [ROTATE angle | SKEW slant twist] [ABOUT x y] [IDLIST &objectidlist/.0.1.2] ** [DOCUMENT document | WINDOW document-window | OBJECTID objectid] ** prior to 5.0.2.12, IDLIST also included .COUNT

transform [OFFSET offsetx offsety] [+OBJECTWIDTH|-OBJECTWIDTH][+OBJECTHEIGHT|-OBJECTHEIGHT] [SCALE scalex scaley] [ROTATE angle | SKEW slantangle twistangle | SLANT angle | TWIST angle] [ABOUT pointx pointy | ABOUTCENTER] [PAGEOFFSET poffset] [STACK INFRONT|INBACK] [FADETO FALSE|TRUE] [IDLIST &objectidlist/.0.1.2] [DOCUMENT name | WINDOW name | OBJECTID number]

count/i The number of copies to make.

OFFSET/d The offset from the original or previous copy.
+OBJECTWIDTH|-OBJECTWIDTH new in 5.0
+OBJECTHEIGHT|-OBJECTHEIGHT new in 5.0
ROTATE/d The rotation angle. Default=0.
SKEW/d The slant and twist angle. Default=0.
SLANT/d The slant angle. Default=0.
TWIST/d The twist angle. Default=0.
ABOUT/d The rotation point.
ABOUTCENTER Rotates around its center. Default.
PAGEOFFSET/d each copy will be advanced by pageoffset pages. Default=0. New in 4.1
STACK/s INFRONT places each copy in front of the previous. INBACK places behind the previous. Default=INFRONT. New in 4.1
FADETO/b If set to TRUE, changes the line, fill and color of each copy in equal increments to end with the last copy at the defined attributes.
IDLIST/s Name of stem variable to return list of new object handles. Prior to 5.0.2.11, IDLIST also included .COUNT.

DOCUMENT/s The document name.

WINDOW/s The window name.

OBJECTID/i The number of the object.

Default=current.

Results:

Returns number of new objects. Removed .COUNT from idlist in 5.0.2.11 so that they can be returned as a list instead of a dict in python. The return result still contains the count. However, any older Arexx script that relies on this stem variable will need to be updated.

Notes:

If count=0, the the original object will be transformed. If count>0, then each successive object will be transformed by these values.

Examples:

transform 5 offset 0.25 0 scale 100 83

transform 3 skew 90 131 about 2.2 3.125 ยจ
   document 'project.doc'

 

Transform  Command Definition  url:PGScmd/transform
  created:2006-03-30 20:20:52   last updated:2006-03-31 13:59:54
  Copyright © 1985-2024 GrasshopperLLC. All Rights Reserved.

User Contributed Comments For Transform
Dan Kilroy wrote...2006-05-03 19:10:28

Script command submitted from PageStream internal documentation. Needs to be checked and merged with the command documentation above.

Transform the {...} .

objectcount = Transform (count [OFFSET deltax deltay] [PGS50: [+OBJECTWIDTH|-OBJECTWIDTH][+OBJECTHEIGHT|-OBJECTHEIGHT][SCALE xscale yscale] PGS41:[PAGEOFFSET poffset][STACK <INFRONT|INBACK][FADETO <FALSE|TRUE>] [ROTATE angle | SKEW slant twist] [ABOUT x y] [IDLIST &objectidlist/.0.1.2] [DOCUMENT document | WINDOW document-window | OBJECTID objectid])


Parameters:


Results:


Notes:
prior to 5.0.2.12, IDLIST also included .COUNT


See Also:


Examples:
Python:


ARexx:

Applescript:

User Contributed Comments For Transform