// définition de l'unité de longueur
// la même sur les deux axes de coordonnées
unitsize(1cm);
// Construction d'un rectangle (pour voir l'incidence de unitsize)
// de longueur 6 unités (suivant l'axe des abscisses)
// et de largeur 4 unités (suivant l'axe des ordonnées)
draw ((0,0)--(6,0)--(6,4)--(0,4)--cycle,2bp+red);
// bp est l'unité postscript (big point)
// telle que 1bp=1/72pouce=127/360mm=0,3527mm

// définition des unités de longueur :
// différentes suivant les axes de coordonnées
unitsize(1cm,.5cm);
// Construction du même rectangle que précédemment
// mais pour un résultat différent puisque l'unité
// sur l'axe des ordonnées a été réduite de moitié.
draw ((0,0)--(6,0)--(6,4)--(0,4)--cycle,2bp+red);

// l'image précédente...

unitsize(1cm,.5cm);
draw ((0,0)--(6,0)--(6,4)--(0,4)--cycle,2bp+red);

// ... avec une zone blanche de 5mm autour de l'image
// bordée d'un trait dans le style currentpen
shipout(bbox(5mm));

// l'image précédente en ajoutant un fond bleu pâle.
// et un bord bleu d'épaisseur 2bp.

unitsize(1cm,.5cm);
draw ((0,0)--(6,0)--(6,4)--(0,4)--cycle,2bp+red);

shipout(bbox(5mm,p=blue+2bp,Fill(paleblue+white)));

// possibilités de bbox illustrées dans des exemples qui suivent

// On définit la largeur de l'image et alors la hauteur
// va s'adapter automatiquement pour garder les proportions.
size(5cm,0);

// Toujour le même rectangle de 6 sur 4 (unités);
draw ((0,0)--(6,0)--(6,4)--(0,4)--cycle,2bp+red);

// l'unité de longueur est de 5/6cm

// On définit cette fois la hauteur de l'image et alors largeur
// va s'adapter automatiquement pour garder les proportions.
size(0,5cm);

// Toujour le même rectangle de 6 sur 4 (unités);
draw ((0,0)--(6,0)--(6,4)--(0,4)--cycle,2bp+red);

// l'unité de longueur est de 5/4cm=1,25cm.

// Les dimensions de l'image vont s'adapter automatiquement
size(0,0);

// Toujour le même rectangle de 6 sur 4 (unités);
draw ((0,0)--(6,0)--(6,4)--(0,4)--cycle,2bp+red);

// sans précision d'unité :
// l'unité par défaut adoptée est le bp (big point)
// telle que 1bp=1/72pouce=127/360mm=0,3527mm

// Les dimensions de l'image vont s'adapter automatiquement
size(0,0);

// Toujour le même rectangle de 6 sur 4 (unités);
draw ((0,0)--(6cm,0)--(6cm,4cm)--(0,4cm)--cycle,2bp+red);

// mais cette fois, on a précisé 'cm'
// et on retrouve le tout premier rectangle de cette page.

// Cette fois, on indique que l'on souhaite que la figure
// n'excède pas 5cm en largeur et 7 cm en hauteur
// mais les proportions de la figure seront préservées !!
size(5cm,7cm);

// Toujour le même rectangle de 6 sur 4 (unités);
draw ((0,0)--(6,0)--(6,4)--(0,4)--cycle,2bp+red);

// Le rectangle étant plus large que haut,
// la largeur de la figure obtenue est donc de 5cm
// et sa hauteur est 4/6*5cm=3,33cm.

// Cette fois, on indique que l'on souhaite que la figure
// n'excède pas 20cm en largeur et 5 cm en hauteur
// mais les proportions de la figure seront préservées !!
size(20cm,5cm);

// Toujour le même rectangle de 6 sur 4 (unités);
draw ((0,0)--(6,0)--(6,4)--(0,4)--cycle,2bp+red);

// Le rectangle étant plus large que haut,
// c'est la contrainte de 5cm sur la hauteur qui fixe la taille
// de la figure obtenue et la largeur est 6/4*5cm=7,5cm.

// Avec l'argument false, on indique ici, cette fois,
// que la figure doit mesurer 5cm de large et 7cm de hauteur
// quitte à ne pas respecter les proportions.
size(5cm,7cm,false);

// Toujour le même rectangle de 6 sur 4 (unités);
draw ((0,0)--(6,0)--(6,4)--(0,4)--cycle,2bp+red);

size(6cm,0);

// Toujour le même rectangle de 6 sur 4 (unités);
draw ((0,0)--(6,0)--(6,4)--(0,4)--cycle,2bp+red);

// Si on ne veut pas limiter l'image au rectangle précédent
// on peut indiquer une zone rectangulaire de l'écran
// qui doit être vue dans l'image générée.
fixedscaling((-3,-1),(1,1)); 

// fichier image : huile_de_Turner.eps)
size(0,0);

label(graphic("huile_de_Turner.eps","width=5cm"));

shipout(bbox(.8cm,Fill));

size(0,0);

label(graphic("huile_de_Turner.eps","width=4cm, bb=10 10 60 60, clip=true"));

shipout(bbox(.8cm,Fill));

size(0,0);

label(graphic("huile_de_Turner.eps","width=4cm, bb=10 10 60 60, angle=20, clip=true"));

// fichier image : huile_de_Turner.png)

settings.tex="pdflatex";
size(0,0);

label(graphic("huile_de_Turner.png","width=5cm"));
layer(); // The layer() function can be used to force future objects 
         // to be drawn on top of the included image.
label("\textbf{Une huile de Turner}",yellow,Fill(.5blue+opacity(.3)));

shipout(bbox(.8cm,Fill),"pdf");

unitsize(1cm);

draw(circle(c=(0,0),r=2),1bp+yellow);

shipout(bbox(1cm,Fill));

/* 
frame bbox(picture pic=currentpicture, 
           real xmargin=0, real ymargin=xmargin,
           pen p=currentpen, filltype filltype=NoFill)

shipout(string prefix=defaultfilename, 
        frame f,
        string format="", 
        bool wait=false, bool view=true,
        string options="", string script="",
        projection P=currentprojection)
*/           

unitsize(1cm);

draw(circle(c=(0,0),r=2),2bp+blue);

shipout(bbox(1cm,.2cm,Fill(paleblue+white)));

unitsize(1cm);

draw(circle(c=(0,0),r=2),2bp+blue);

shipout(bbox(0.2cm,.5cm,p=.1cm+red));

/* 
frame bbox(picture pic=currentpicture, 
           real xmargin=0, real ymargin=xmargin,
           pen p=currentpen, filltype filltype=NoFill)

shipout(string prefix=defaultfilename, 
        frame f,
        string format="", 
        bool wait=false, bool view=true,
        string options="", string script="",
        projection P=currentprojection)
*/