 |
   PicArt PicArt: Script |
Last update 2001/07/16
The Reference Manual of PicArt-Script
PicArtScript is the core of the PicArt-Package. It's a very simple stack oriented language like PostScript.In example, to add two numbers: 2 5 add, executed you will have 7 on the stack:
Stack: 2 5
2add
5
27 Token: 2 5 add
Philosophy of PicArtScript is that images are objects which you can apply effect(s) on (all programs listed).
There are only five types of operands:If an ordinary token is an executable token then it will be, otherwise considered as operand. Numbers, strings and images are all stored as string internally, only the commands then decide how things are handled.
- numbers: 1.545 13434
- strings: "Hello" "After all"
- images: a.jpg /tmp/mylocal.ppm
- literals: /name /test
- ordinary token: show xyz paste
<font> text.font <points> text.size <x> <y> text.scale <r> <g> <b> text.rgb <text> text <imgout>
<path> setfontpath <font> setfont <points> setfontsize <x> <y> setfontscale <r> <g> <b> setrgb <text> show <imgout>
<w> <h> <r> <g> <b> <a> make <imgout>
<img> sizeof <w> <h> <imgbase> <w> <h> scale <imgout>
<imgbase> <rot> rotate <imgout>
<imgbase> <h> <s> <l> hsl <imgout>
<imgbase> <contrast> contrast <imgout>
<imgbase> <x> <y> <imgpaste> paste <imgout>
<imgbase> <imgalpha> alpha <imgout>
<imgbase> <r> <g> <b> alpha <imgout> <imgbase> <which> extract <imgred> <imggreen> <imgblue> <imgalpha> <imgbase> <w> <h> tile <imgout>
<imgbase> <shadeimg> shade <imgout>
<img> <shear> shear <imgout>
<img> <spread> spread <imgout>
<img> <depth> <rot> smear <imgout>
<imgbase> smooth <imgout>
<imgbase> <depth> smooth <imgout> <xs> <ys> wavy.noise <rot> wavy.linear <xr> <yr> wavy.circular <imgbase> <scale> <heavyness> wavy <imgout>
<imgbase> <a> <b> <c> <x> <y> whirl <imgout>
<imgbase> <scale> <heavyness> <r> <g> <b> <a> noise <imgout>
<imgbase> <scale> <heavyness> <octave> <r> <g> <b> <a> turbulence <imgout> <imgbase> <scale> <heavyness> bumpy <imgout>
<imgbase> <factor> blowup <imgout>
<img> <brush> <dir> stroke <imgout>
<img1> <img2> <fade> fade <imgout>
<img> <r> <g> <b> <a> gamma <imgout>
<imgbase> <x> <y> <w> <h> cut <imgout>
<imgbase> <x> <y> <w> <h> pick <r> <g> <b> <a> <imgbase> flipv <imgout>
<imgbase> fliph <imgout>
<imgbase> flipcw <imgout>
<img1> <img2> catv <imgout>
<img1> <img2> cath <imgout>
<img> invert <imgout>
<imgbase> <w> <h> border <imgout>
<img> <w> <h> <r> <g> <b> <a> border <imgout> <w> <h> <border> <r> <g> <b> button <imgout>
<imgbase> <imgmask> mask <imgout>
<imgbase> <r> <g> <b> <a> map <imgout>
<imgbase> <imgmask> map <imgout> <img> <freq> <bright> stars <imgout>
<base> <x> <y> <r> <spks> <sharp> <bright> <r> <g> <b> supernova <imgout>
<x> <y> <z> <r> <g> <b> <intens> light.point <x> <y> <z> <r> <g> <b> <intens> light.direction <ambient> light.ambient <spec> <specwidth> light.specular <imgbase> <imgheight> light <imgout>
<imgbase> <xr0> <yr0> <xr1> <yr1> <type> <r> <g> <b> <a> <r1> <g1> <b1> <a1> blend <imgout>
<imgbase> <xr0> <yr0> <xr1> <yr1> <type> <imgpalette> blend <imgout> <img> <r> <g> <b> <a> <x> <y> <tolerance> fill <imgout>
<x> <y> <x1> <y1> draw.line <r> <g> <b> <a> draw.rgba <x> <y> draw.point <x> <y> <x1> <y1> draw.rect <x> <y> <x1> <y1> draw.fillrect <x> <y> <rx> <ry> draw.ellipse <x> <y> <rx> <ry> draw.fillellipse <x> <y> <x2> <y2> .. <xN> <yN> <n> draw.poly <x> <y> <x2> <y2> .. <xN> <yN> <n> draw.fillpoly <imgbase> draw <imgout>
<img> <cols> <name> togif <img> <r> <g> <b> <cols> <name> togif <img> <quality> <name> tojpeg <img> <name> toppm <img> xv <fname> fstat <mtime> <length> <any> <any1> <any2> lt <boolean> <any1> <any2> < <boolean> <any1> <any2> gt <boolean> <any1> <any2> > <boolean> <any1> <any2> eq <boolean> <any1> <any2> == <boolean> <any1> <any2> add <sum> <any1> <any2> + <sum> <any1> <any2> sub <sub> <any1> <any2> - <sub> <any1> <any2> div <div> <any1> <any2> / <div> <any1> <any2> mul <sum> <any1> <any2> * <sum> <any1> int <int> <any1> sin <sin> <any1> asin <asin> <any1> cos <cos> <any1> acos <acos> <any1> tan <tan> <any1> atan <atan> <any1> abs <abs> <any1> <any2> exch <any2> <any1> <any> pop <any> dup <any> <any> /<name> <any> def <any> <token> find <ntimes> <any> <token> split <...> <anyN> .. <any1> <n> ncat <outstr> <filename> exec <sequence> execstack <bool> <{...}> if <bool> <{true...}> <{false...}> ifelse <start> <end> <step> <{loop...}> for
text.font(<font>) text.size(<points>) text.scale(<x>, <y>) text.rgb(<r>, <g>, <b>) text(<text>) <imgout> setfontpath(<path>) setfont(<font>) setfontsize(<points>) setfontscale(<x>, <y>) setrgb(<r>, <g>, <b>) show(<text>) <imgout> make(<w>, <h>, <r>, <g>, <b>, <a>) <imgout> sizeof(<img>) <w> <h> scale(<imgbase>, <w>, <h>) <imgout> rotate(<imgbase>, <rot>) <imgout> hsl(<imgbase>, <h>, <s>, <l>) <imgout> contrast(<imgbase>, <contrast>) <imgout> paste(<imgbase>, <x>, <y>, <imgpaste>) <imgout> alpha(<imgbase>, <imgalpha>) <imgout> alpha(<imgbase>, <r>, <g>, <b>) <imgout> extract(<imgbase>, <which>) <imgred> <imggreen> <imgblue> <imgalpha> tile(<imgbase>, <w>, <h>) <imgout> shade(<imgbase>, <shadeimg>) <imgout> shear(<img>, <shear>) <imgout> spread(<img>, <spread>) <imgout> smear(<img>, <depth>, <rot>) <imgout> smooth(<imgbase>) <imgout> smooth(<imgbase>, <depth>) <imgout> wavy.noise(<xs>, <ys>) wavy.linear(<rot>) wavy.circular(<xr>, <yr>) wavy(<imgbase>, <scale>, <heavyness>) <imgout> whirl(<imgbase>, <a>, <b>, <c>, <x>, <y>) <imgout> noise(<imgbase>, <scale>, <heavyness>, <r>, <g>, <b>, <a>) <imgout> turbulence(<imgbase>, <scale>, <heavyness>, <octave>, <r>, <g>, <b>, <a>) <imgout> bumpy(<imgbase>, <scale>, <heavyness>) <imgout> blowup(<imgbase>, <factor>) <imgout> stroke(<img>, <brush>, <dir>) <imgout> fade(<img1>, <img2>, <fade>) <imgout> gamma(<img>, <r>, <g>, <b>, <a>) <imgout> cut(<imgbase>, <x>, <y>, <w>, <h>) <imgout> pick(<imgbase>, <x>, <y>, <w>, <h>) <r> <g> <b> <a> flipv(<imgbase>) <imgout> fliph(<imgbase>) <imgout> flipcw(<imgbase>) <imgout> catv(<img1>, <img2>) <imgout> cath(<img1>, <img2>) <imgout> invert(<img>) <imgout> border(<imgbase>, <w>, <h>) <imgout> border(<img>, <w>, <h>, <r>, <g>, <b>, <a>) <imgout> button(<w>, <h>, <border>, <r>, <g>, <b>) <imgout> mask(<imgbase>, <imgmask>) <imgout> map(<imgbase>, <r>, <g>, <b>, <a>) <imgout> map(<imgbase>, <imgmask>) <imgout> stars(<img>, <freq>, <bright>) <imgout> supernova(<base>, <x>, <y>, <r>, <spks>, <sharp>, <bright>, <r>, <g>, <b>) <imgout> light.point(<x>, <y>, <z>, <r>, <g>, <b>, <intens>) light.direction(<x>, <y>, <z>, <r>, <g>, <b>, <intens>) light.ambient(<ambient>) light.specular(<spec>, <specwidth>) light(<imgbase>, <imgheight>) <imgout> blend(<imgbase>, <xr0>, <yr0>, <xr1>, <yr1>, <type>, <r>, <g>, <b>, <a>, <r1>, <g1>, <b1>, <a1>) <imgout> blend(<imgbase>, <xr0>, <yr0>, <xr1>, <yr1>, <type>, <imgpalette>) <imgout> fill(<img>, <r>, <g>, <b>, <a>, <x>, <y>, <tolerance>) <imgout> draw.line(<x>, <y>, <x1>, <y1>) draw.rgba(<r>, <g>, <b>, <a>) draw.point(<x>, <y>) draw.rect(<x>, <y>, <x1>, <y1>) draw.fillrect(<x>, <y>, <x1>, <y1>) draw.ellipse(<x>, <y>, <rx>, <ry>) draw.fillellipse(<x>, <y>, <rx>, <ry>) draw.poly(<x>, <y>, <x2>, <y2>, .., <xN>, <yN>, <n>) draw.fillpoly(<x>, <y>, <x2>, <y2>, .., <xN>, <yN>, <n>) draw(<imgbase>) <imgout> togif(<img>, <cols>, <name>) togif(<img>, <r>, <g>, <b>, <cols>, <name>) tojpeg(<img>, <quality>, <name>) toppm(<img>, <name>) xv(<img>) fstat(<fname>) <mtime> <length> print(<any>) lt(<any1>, <any2>) <boolean> <(<any1>, <any2>) <boolean> gt(<any1>, <any2>) <boolean> >(<any1>, <any2>) <boolean> eq(<any1>, <any2>) <boolean> ==(<any1>, <any2>) <boolean> add(<any1>, <any2>) <sum> +(<any1>, <any2>) <sum> sub(<any1>, <any2>) <sub> -(<any1>, <any2>) <sub> div(<any1>, <any2>) <div> /(<any1>, <any2>) <div> mul(<any1>, <any2>) <sum> *(<any1>, <any2>) <sum> int(<any1>) <int> sin(<any1>) <sin> asin(<any1>) <asin> cos(<any1>) <cos> acos(<any1>) <acos> tan(<any1>) <tan> atan(<any1>) <atan> abs(<any1>) <abs> exch(<any1>, <any2>) <any2> <any1> pop(<any>) dup(<any>) <any> <any> def(/<name>, <any>) find(<any>, <token>) <ntimes> split(<any>, <token>) <...> ncat(<anyN>, .., <any1>, <n>) <outstr> exec(<filename>) execstack(<sequence>) if(<bool>, <{...}>) ifelse(<bool>, <{true...}>, <{false...}>) for(<start>, <end>, <step>, <{loop...}>)
You can mix stack-oriented or function-oriented calls:
"Hello" show 2 2 255 255 0 0 border xv is the same as
show("Hello") border(2,2,255,255,0,0) xv border requires as first argument the image, that is obmitted and taken from the stack, which was given by output of show already. In this way, whatever you are more familiar, use function-oriented or stack-oriented calls.
Important Note: Be aware that always arguments are put on stack, even when it's a function-oriented call!
Since PicArtScript was designed as stack oriented language, addtionally the function-call style is available as mentioned above, there are also several ways to make assignments:Assignment is done with def or =:
/posx 10 def 10 /posx exch def posx = 10; also valid
/posx 10 5 add def 10 5 add /posx exch def posx = 10 5 add; The character ";" is used to terminate an "="-assignment, otherwise it's ignored, so you can write also:
/a = "test file"; show(a); xv(); which is the same as
/a "test file" def a show xv or very compact
"test file" show xv So whatever you are comfortable with, your choice.
Online help you get by calling pascript -help or pascript -man search.
% pascript -man blend
PicArt Cookbook Further information of how to write stand-alone scripts and tricks PicArt Script Collection Collection of stand-alone & shaders
| PicArt: Programs |  PicArt | PicArt Cookbook |
All Rights Reserved - (C) 1997 - 2008 by The Labs.Com
Top of PageThe Labs.Com