Index: phpdoc/fr/functions/swf.xml diff -u phpdoc/fr/functions/swf.xml:1.2 phpdoc/fr/functions/swf.xml:1.3 --- phpdoc/fr/functions/swf.xml:1.2 Sat Aug 12 10:23:26 2000 +++ phpdoc/fr/functions/swf.xml Fri Nov 24 03:07:33 2000 @@ -1,2086 +1,2275 @@ - - Fonctions Shockwave Flash - SWF - - - - PHP a la capacité de créer des animations Shockwave Flash grāce au module de Paul - Haeberli : libswf module. Vous pouvez télécharger libswf à - &url.swf;. Une fois que vous avez libswf, tout - ce qui reste à faire est de configurer PHP avec - oú DIR est le dossier qui - accueille les dossiers de include et lib. Le dossier include doit contenir le - fichier swf.h file et le dossier lib doit contenir le fichier libswf.a. - Si vous décompressez la distribution de libswf, les deux fichiers seront dans le - même dossier. Par conséquent, vous devrez les mettre dans le dossier ad hoc - manuellement. - - - Une fois que vous avez réussi à installer PHP avec Shockwave Flash, vous pouvez - créer des animations Flash avec PHP. Vous serez surpris du résultat. Essayez donc - ceci : - - Exemple SWF - -<?php -swf_openfile ("test.swf", 256, 256, 30, 1, 1, 1); -swf_ortho2 (-100, 100, -100, 100); -swf_defineline (1, -70, 0, 70, 0, .2); -swf_definerect (4, 60, -10, 70, 0, 0); -swf_definerect (5, -60, 0, -70, 10, 0); -swf_addcolor (0, 0, 0, 0); - -swf_definefont (10, "Mod"); -swf_fontsize (5); -swf_fontslant (10); -swf_definetext (11, "Voici le mariage de FLASH et PHP!", 1); - -swf_pushmatrix (); -swf_translate (-50, 80, 0); -swf_placeobject (11, 60); -swf_popmatrix (); - -for ($i = 0; $i < 30; $i++) { - $p = $i/(30-1); - swf_pushmatrix (); - swf_scale (1-($p*.9), 1, 1); - swf_rotate (60*$p, 'z'); - swf_translate (20+20*$p, $p/1.5, 0); - swf_rotate (270*$p, 'z'); - swf_addcolor ($p, 0, $p/1.2, -$p); - swf_placeobject (1, 50); - swf_placeobject (4, 50); - swf_placeobject (5, 50); - swf_popmatrix (); - swf_showframe (); -} - -for ($i = 0; $i < 30; $i++) { - swf_removeobject (50); - if (($i%4) == 0) { - swf_showframe (); - } -} - -swf_startdoaction (); -swf_actionstop (); -swf_enddoaction (); - -swf_closefile (); -?> - - - Cela va produire une animation, proche de celle ci - (mais traduite en anglais). - - - - Le support de Flash a été ajouté dans PHP4 RC2. - - - - - - - swf_openfile - Ouvre un nouveau fichier Shockwave Flash - - - Description - - void - swf_openfile - - string - filename - - float - width - - float - height - - float - framerate - - float - r - - float - g - - float - b - - - - swf_openfile crée un nouveau fichier - filename de largeur width, et de - hauteur height, à la vitesse de - framerate, de couleur de fond RGB (r, - g, b). - - - swf_openfile doit être la première fonction à appeler, - sous peine d'erreur mémoire (segmentation fault). Si vous voulez envoyer votre - production au client HTML, utilisez le nom de fichier - "php://stdout" (le support de ceci est prévue pour la version 4.0.1 et ultérieur). - - - - - - - swf_closefile - Ferme le fichier courant Shockwave Flash. - - - Description - - void - swf_closefile - - - - - Ferme le fichier courant, qui a été ouvert avec swf_openfile. - - - - - - - swf_labelframe - Nomme le frame courant. - - - Description - - void - swf_labelframe - - string - name - - - - Donne le nom name au frame courant. - - - - - - - swf_showframe - Affiche le frame courant. - - - Description - - void - swf_showframe - - - - - swf_showframe affiche le frame courant. - - - - - - - swf_setframe - Fixe le frame courant. - - - Description - - void - swf_setframe - - int - framenumber - - - - swf_setframe selectionne le frame - framenumber comme frame actif. - - - - - - - swf_getframe - Retourne le numéro de frame courant. - - - Description - - int - swf_getframe - - - - - swf_getframe retourne le numéro de frame courant. - - - - - - - swf_mulcolor - - Fixe la couleur globale de multiplication (? : the global multiply color). - - - - Description - - void - swf_mulcolor - - float - r - - float - g - - float - b - - float - a - - - - swf_mulcolor fixe la valeur globale de multiplication - (the global multiply color...) à la couleur rgba. - Cette couleur est utilisée (implicitement) par swf_placeobject, - swf_modifyobject et swf_addbuttonrecord. - La couleur d'un objet sera multipliée par rgba - lorsque l'objet est placé sur la scène. - - - - Les valeurs de rgba peuvent être positives ou négatives. - - - - - - - - swf_addcolor - - Fixe la couleur globale d'addition (? : the global add color). - - - - Description - - void - swf_addcolor - - float - r - - float - g - - float - b - - float - a - - - - swf_mulcolor fixe la valeur globale de multiplication - (the global multiply color...) à la couleur rgba. - Cette couleur est utilisée (implicitement) par swf_placeobject, - swf_modifyobject et swf_addbuttonrecord. - La couleur d'un objet sera ajouté à rgba - lorsque l'objet est placé sur la scène. - - - - Les valeurs de rgba peuvent être positives ou négatives. - - - - - - - - swf_placeobject - Place un objet sur la scène. - - - Description - - void - swf_placeobject - - int - objid - - int - depth - - - - Place l'objet objid dans le frame courant, à la profondeur - depth. objid et - depth doivent être compris entre 1 et 65535. - - - Cette fonction utilise la couleur courante de multiplication (specifiée par - swf_mulcolor) et la couleur courante d'addition - (specifiée par swf_addcolor) pour colorer l'objet, et utilise - la matrice courante pour positionner l'objet. - - - - Le support des couleurs RGBA est complet. - - - - - - - - swf_modifyobject - Modifie un objet. - - - Description - - void - swf_modifyobject - - int - depth - - int - how - - - - Modifie la position et/ou la couleur de l'objet situé à la profondeur de - depth. L'argument how détermine - ce qui doit être modifié. how peut prendre les valeurs de - MOD_MATRIX, MOD_COLOR ou la combinaison des deux. - - - MOD_COLOR utilise la couleur courante de multiplication (specifiée par - swf_mulcolor) et la couleur courante d'addition - (specifiée par swf_addcolor) pour colorer l'objet, et - MOD_MATRIX utilise la matrice courante pour positionner l'objet. - - - - - - - swf_removeobject - Enlève un objet. - - - Description - - void - swf_removeobject - - int - depth - - - - Enlève l'objet situé à la profondeur depth de la scène. - - - - - - - swf_nextid - Retourne le prochain identifiant d'objet libre. - - - Description - - int - swf_nextid - - - - - swf_nextid retourne le prochain identifiant d'objet libre. - - - - - - - swf_startdoaction - - Commence la déscription d'une liste d'action pour la frame courante. - - - - Description - - void - swf_startdoaction - - - - - swf_startdoaction commence la déscription d'une liste - d'action pour la frame courante. Cette fonction doit être appelée avant que les - actions ne soient définies pour le cadre courant. - - - - - - - swf_actiongotoframe - Joue un frame puis stoppe. - - - Description - - void - swf_actiongotoframe - - int - framenumber - - - - swf_actionGotoFrame se déplace jusqu'au frame - framenumber, le joue, puis s'arrête. - - - - - - - swf_actiongeturl - Retourne l'URL d'une animation Shockwave Flash. - - - Description - - void - swf_actiongeturl - - string - url - - string - target - - - - swf_actionGetUrl lit l'URL url, - avec la destination target. - - - - - - - swf_actionnextframe - Avance d'un frame. - - - Description - - void - swf_actionnextframe - - - - - swf_actionnextframe avance d'un frame le frame courant. - - - - - - - swf_actionprevframe - Recule d'un frame. - - - Description - - void - swf_actionprevframe - - - - - swf_actionnextframe recule d'un frame le frame courant. - - - - - - - swf_actionplay - - Joue l'animation flash à partir du frame courant. - - - - Description - - void - swf_actionplay - - - - - swf_actionplay joue l'animation flash à partir du frame - courant. - - - - - - - swf_actionstop - - Arrête l'animation flash. - - - - Description - - void - swf_actionstop - - - - - Arrête l'animation flash au frame courant. - - - - - - - swf_actiontogglequality - - Choisi le niveau de qualité haut ou bas. - - - - Description - - void - swf_actiontogglequality - - - - - Choisi le niveau de qualité haut ou bas. - - - - - - - swf_actionwaitforframe - - Ignore les actions si le frame n'est pas chargé. - - - - Description - - void - swf_actionwaitforframe - - int - framenumber - - int - skipcount - - - - swf_actionWaitForFrame vérifie que le frame - framenumber a bien été chargé. Si ce n'est pas le cas, - elle ignore les actions skipcount. Cela est très utile pour - les séquences du type "Chargement...". - - - - - - - swf_actionsettarget - Fixe le contexte des actions. - - - Description - - void - swf_actionsettarget - - string - target - - - - swf_actionSetTarget fixe le contexte des actions. - Vous pouvez utiliser cette fonction pour contrôler d'autres animations Flash qui - seraient en fonctionnement. - - - - - - - swf_actiongotolabel - - Affiche le frame nommé. - - - - Description - - void - swf_actiongotolabel - - string - label - - - - swf_actionGotoLabel affiche le frame de nom - label, puis stoppe. - - - - - - - swf_enddoaction - Termine l'action courante. - - - Description - - void - swf_enddoaction - - - - - swf_startdoaction termine l'action courante. - - - - - - - swf_defineline - Définit une ligne. - - - Description - - void - swf_defineline - - int - objid - - float - x1 - - float - y1 - - float - x2 - - float - y2 - - float - width - - - - swf_defineline définit une ligne commencant aux coordonnées - (x1, y1 ), et finissant au point - de coordonnées (x2, y2). - Elle aura la largeur de width. - - - - - - - swf_definerect - Définit un rectangle. - - - Description - - void - swf_definerect - - int - objid - - float - x1 - - float - y1 - - float - x2 - - float - y2 - - float - width - - - - swf_definerect définit un rectangle, de coin supérieur gauche - aux coordoonées (x1,y1), et de coin - inférieur droit aux coordonnées (x2, y2). - L'épaisseur des bords est données par le paramètre width. - width, 0.0 le rectangle sera rempli. - - - - - - - swf_definepoly - - Définit un polygone. - - - - Description - - void - swf_definepoly - - int - objid - - array - coords - - int - npoints - - float - width - - - - swf_definepoly définit un polygone, dont les coordonnées des - sommets sont placés dans le tableau coords). - npoints est le nombre de points contenu dans le tableau - coords. width est la largeur des bords - du polygone. Si width vaut 0.0, le polygone sera rempli. - - - - - - - swf_startshape - Commence une forme complexe. - - - Description - - void - swf_startshape - - int - objid - - - - swf_startshape commence une forme complexe, qui sera reperé - par l'identifiant d'objet objid. - - - - - - - swf_shapelinesolid - Fixe le style courant de ligne. - - - Description - - void - swf_shapelinesolid - - float - r - - float - g - - float - b - - float - a - - float - width - - - - swf_shapeLineSolid permet de choisir le style de ligne, à savoir - la couleur et la largeur. Si width vaut 0.0, les lignes ne - seront pas dessinées. - - - - - - - swf_shapefilloff - Inactive le remplissage. - - - Description - - void - swf_shapefilloff - - - - - swf_shapeFillOff inactive le remplissage pour la - forme courante. - - - - - - - swf_shapefillsolid - - Fixe la couleur pour le style courant de remplissage. - - - - Description - - void - swf_shapefillsolid - - float - r - - float - g - - float - b - - float - a - - - - swf_shapeFillSolid fixe la couleur pour le style courant - de remplissage à rgba. - - - - - - - swf_shapefillbitmapclip - - Choisi le mode de remplissage par texture. - - - - Description - - void - swf_shapefillbitmapclip - - int - bitmapid - - - - Choisi le mode de remplissage par texture : les espaces vides seront remplis avec - la bitmap bitmapid. - - - - - - - swf_shapefillbitmaptile - - Choisi le mode de remplissage par texture repétée. - - - - Description - - void - swf_shapefillbitmaptile - - int - bitmapid - - - - Choisi le mode de remplissage par texture : les espaces vides seront remplis avec - la bitmap bitmapid, repétée autant de fois qu'il le faut. - - - - - - - swf_shapemoveto - Change la position courante. - - - Description - - void - swf_shapemoveto - - float - x - - float - y - - - - swf_shapeMoveTo fixe la position courante au point de - de coordonnées (x, y). - - - - - - - swf_shapelineto - Dessine une ligne. - - - Description - - void - swf_shapelineto - - float - x - - float - y - - - - swf_shapeLineTo dessine une ligne entre la position courante et - le points de coordonnées (x, y). - La position courante devient alors (x, y). - - - - - - - swf_shapecurveto - - Dessine une courbe de Bézier quadratique entre deux points. - - - - Description - - void - swf_shapecurveto - - float - x1 - - float - y1 - - float - x2 - - float - y2 - - - - swf_shapecurveto dessine la courbe de Bézier quadratique entre les points - de coordonnées (x1 , y1) et - (x2, y2). La position courante - devient alors (x2, et y2). - - - - - - - swf_shapecurveto3 - Dessine une courbe Bézier cubique. - - - Description - - void - swf_shapecurveto3 - - float - x1 - - float - y1 - - float - x2 - - float - y2 - - float - x3 - - float - y3 - - - - Dessine une courbe de Bézier cubique, en utilisant les points de coordoonnées - (x1, y1) et - (x2,y2) comme points de contrôle, - et le point de coordonnées (x3, y3) - comme point final. La position finale devient alors la position courante. - - - - - - - swf_shapearc - Dessine une arc de cercle. - - - Description - - void - swf_shapearc - - float - x - - float - y - - float - r - - float - ang1 - - float - ang2 - - - - swf_shapeArc dessine un arc de cercle, depuis l'angle - ang1 jusqu'à l'angle ang2. - Le centre du cercle est aux coordonnées (x, - y), et de rayon r. - - - - - - - swf_endshape - - Complète la définition de la forme courante. - - - - Description - - void - swf_endshape - - - - - swf_endshape complète la définition de la forme courante. - - - - - - - swf_definefont - - Définit une police. - - - - Description - - void - swf_definefont - - int - fontid - - string - fontname - - - - swf_definefont définit la police - fontname et lui affecte l'identifiant - fontid. Cette police devient alors la police courante. - - - - - - - swf_setfont - Change la police courante. - - - Description - - void - swf_setfont - - int - fontid - - - - swf_setfont remplace la police courante par la police - repérée par l'identifiant fontid. - - - - - - - swf_fontsize - Change la taille de la police. - - - Description - - void - swf_fontsize - - float - size - - - - swf_fontsize remplace la taille de la police par la taille - size. - - - - - - - swf_fontslant - Change l'inclinaison de la police courante. - - - Description - - void - swf_fontslant - - float - slant - - - - swf_fontslant fixe l'inclinaison de la police courante à - slant. Les valeurs positives values créeront une inclinaison - vers la droite, et les valeurs négatives, vers la gauche. - - - - - - - swf_fonttracking - Change l'espacement des caractères. - - - Description - - void - swf_fonttracking - - float - tracking - - - - swf_fonttracking change l'espacement, et lui affecte la valeur - de thtracking. Cette fonction sert à accroître l'espace entre - les lettres et le texte. Les valeurs positives accroissent cet espace, et les valeurs - négatives le réduisent. - - - - - - - swf_getfontinfo - - Retourne la hauteur du A majuscule, et du x minuscule. - - - - Description - - array - swf_getfontinfo - - - - - swf_getfontinfo retourne la hauteur du A majuscule, et du x - minuscule, dans un tableau associatif : - - - - Aheight - La hauteur du A majuscule, en pixels. - - - - - xheight - La hauteur du x minuscule, en pixels. - - - - - - - - - - swf_definetext - Définit une chaîne de texte. - - - Description - - void - swf_definetext - - int - objid - - string - str - - int - docenter - - - - Définit la chaîne de texte str, en utilisant la police - courante. docenter indique si la chaîne doit être centrée - (valeur de 1), ou pas. - - - - - - - swf_textwidth - Retourne la longueur d'une chaîne. - - - Description - - float - swf_textwidth - - string - str - - - - swf_textwidth retourne la longueur de la chaîne - str, en pixels, en utilisant la police courante. - - - - - - - swf_definebitmap - Définit une image bitmap. - - - Description - - void - swf_definebitmap - - int - objid - - string - image_name - - - - The swf_definebitmap function defines a - bitmap given a GIF, JPEG, RGB or FI image. The image will be - converted into a Flash JPEG or Flash color map format. - - - - - - - swf_getbitmapinfo - Lit les informations sur une image. - - - Description - - array - swf_getbitmapinfo - - int - bitmapid - - - - swf_getbitmapinfo retourne un tableau d'information sur l'image - bitmap repérée par bitmapid. Le tableau a les éléments - suivant : - - - - "size" - La taille en octets de l'image. - - - - - "width" - La largueur en pixels de l'image. - - - - - "height" - La hauteur en pixels de l'image. - - - - - - - - - - swf_startsymbol - Définit un symbole. - - - Description - - void - swf_startsymbol - - int - objid - - - - Définit un identifiant d'objet comme symbole. Les symboles sont des petites - animations flash qui peuvent être jouées simultanément. - objid est l'identifiant d'objet que vous voulez définir comme - symbole. - - - - - - - swf_endsymbol - Termine la définition de symbole. - - - Description - - void - swf_endsymbol - - - - - swf_endsymbol termine la définition de symble, qui a été - commencée avec swf_startsymbol. - - - - - - - swf_startbutton - Commence la définition d'un bouton. - - - Description - - void - swf_startbutton - - int - objid - - int - type - - - - swf_startbutton commence la définition d'un bouton. - type peut prendre les valeurs de TYPE_MENUBUTTON ou - TYPE_PUSHBUTTON. La constante TYPE_MENUBUTTON permet au focus de traverser - lorsque la souris est cliquée, alors que TYPE_PUSHBUTTON ne le permet pas. - - - - - - - swf_addbuttonrecord - - Contrôle la situation, l'aparance et la zone active du bouton courant. - - - - Description - - void - swf_addbuttonrecord - - int - states - - int - shapeid - - int - depth - - - - swf_addbuttonrecord permet de modifier les caractéristiques - d'un bouton. states, définit les états du bouton autorisés : - ce peut être : BSHitTest, BSDown, BSOver ou BSUp. shapeid - est l'apparance du bouton, c'est à dire l'objet qui représente le bouton. - depth est la profondeur de placement du bouton, dans le frame - courant. - - - Exemple avec <function>Swf_addbuttonrecord</function> - - -swf_startButton ($objid, TYPE_MENUBUTTON); - swf_addButtonRecord (BSDown|BSOver, $buttonImageId, 340); - swf_onCondition (MenuEnter); - swf_actionGetUrl ("http://www.designmultimedia.com", "_level1"); - swf_onCondition (MenuExit); - swf_actionGetUrl ("", "_level1"); -swf_endButton (); - - - - - - - - - swf_oncondition - - Décrit une transition utilisée pour déclencher une liste d'actions. - - - - Description - - void - swf_oncondition - - int - transition - - - - swf_onCondition décrit une transition qui va déclencher une - liste d'actions. Il y a plusieurs types de transitions possibles, les suivantes sont - destinées aux boutons de type TYPE_MENUBUTTON: - - - - IdletoOverUp - - - - - OverUptoIdle - - - - - OverUptoOverDown - - - - - OverDowntoOverUp - - - - - IdletoOverDown - - - - - OutDowntoIdle - - - - - MenuEnter (IdletoOverUp|IdletoOverDown) - - - - - MenuExit (OverUptoIdle|OverDowntoIdle) - - - - Pour les types TYPE_PUSHBUTTON voici les options : - - - - IdletoOverUp - - - - - OverUptoIdle - - - - - OverUptoOverDown - - - - - OverDowntoOverUp - - - - - OverDowntoOutDown - - - - - OutDowntoOverDown - - - - - OutDowntoIdle - - - - - ButtonEnter (IdletoOverUp|OutDowntoOverDown) - - - - - ButtonExit (OverUptoIdle|OverDowntoOutDown) - - - - - - - - - - swf_endbutton - - Termine la définition du bouton courant. - - - - Description - - void - swf_endbutton - - - - - swf_endButton termine la définition du bouton courant. - - - - - - - swf_viewport - Sélectionne une nouvelle zone pour un dessin ultérieur. - - - Description - - void - swf_viewport - - double - xmin - - double - xmax - - double - ymin - - double - ymax - - - - swf_viewport sélectionne une nouvelle zone pour y dessiner - ultérieurement. La zone est définie de xmin à - xmax et de ymin à - ymax. Si cette fonction n'est pas appelée, les valeurs par - défaut sont celles de l'écran courant. - - - - - - - swf_ortho - - Définit une projection orthogonale entre les coordonnées utilisateur - et le port courant. - - - - Description - - void - swf_ortho - - double - xmin - - double - xmax - - double - ymin - - double - ymax - - double - zmin - - double - zmax - - - - swf_ortho définit une projection orthogonale entre les - coordonnées utilisateur et le port courant. - - - - - - - swf_ortho2 - - Définit une projection orthogonale à 2 dimensions entre les coordonnées utilisateur - et le port courant. - - - - Description - - void - swf_ortho2 - - double - xmin - - double - xmax - - double - ymin - - double - ymax - - - - swf_ortho2 définit une projection orthogonale à 2 dimensions - entre les coordonnées utilisateur et le port courant. C'est la projection par - défaut des animations Flash. Si vous souhaitez une perspective, utilisez plutôt - swf_perspective. - - - - - - - - swf_perspective - - définit une projection orthogonale à 3 dimensions - entre les coordonnées utilisateur et le port courant - - - - Description - - void - swf_perspective - - double - fovy - - double - aspect - - double - near - - double - far - - - - swf_perspective définit une projection orthogonale à 3 - dimensions entre les coordonnées utilisateur et le port courant. - Le paramètre fovy est l'angle de vue de la direction y. - Le paramètre aspect doit être choisi pour correspondre au - ratio de la vue utilisée. near est le plan adjacent proche - far est le plan adjacent distant. - - - - Diverses distortions peuvent apparaître lors de ce genre de projection, car - Flash ne dispose que d'une matrice à 2 dimensions. Certaines distortions font - vraiment tāche d'encre. - - - - - - - - swf_polarview - - Défini le point de vue de l'utilisateur en coordonnées polaire. - - - - Description - - void - swf_polarview - - double - dist - - double - azimuth - - double - incidence - - double - twist - - - - swf_polarview définit la position de l'utilisateur en coordonnées - polaires. dist est la distance entre le point de vue et - l'origine. azimuth définit l'angle azimutal dans le plan - x,y mesuré en distance depuis l'axe y. incidence - définit l'angle d'incidence dans le plan y,z, mesuré en distance depuis l'axe z. - Finalement, twist est l'angle de rotation du point de vue - sur la ligne de vue, en utilisant la règle de la main droite. - - - - - - - swf_lookat - Définit une transformation de vue. - - - Description - - void - swf_lookat - - double - view_x - - double - view_y - - double - view_z - - double - reference_x - - double - reference_y - - double - reference_z - - double - twist - - - - swf_lookat définit une transformation de vue, en donnant la - position de la vue, de coordonnées (view_x, - view_y, et view_z) et les coordonnées - du point de référence dans la scène, de coordonnées - (reference_x, reference_y - , reference_z). Le paramètre - twist contrôle la rotation le long de l'axe des z de - l'utilisateur. - - - - - - - swf_pushmatrix - - Empile la matrice de transformation courante dans la pile. - - - - Description - - void - swf_pushmatrix - - - - - swf_pushmatrix empile la matrice de transformation courante - dans la pile. - - - - - - - swf_popmatrix - - Dépile la matrice de transformation. - - - - Description - - void - swf_popmatrix - - - - - swf_popmatrix dépile la matrice de transformation. - - - - - - - swf_scale - Homothétie. - - - Description - - void - swf_scale - - double - x - - double - y - - double - z - - - - swf_scale fait une mise à l'échelle de - x pour les coordonnées x, de - y pour les coordonnées y et - z pour les coordonnées z. - - - - - - - swf_translate - Translate la transformation courante. - - - Description - - void - swf_translate - - double - x - - double - y - - double - z - - - - swf_translate translate la transformation courante de - x, y, et z, - dans les directions x, y et z. - - - - - - - swf_rotate - Rotation de la transformation courante. - - - Description - - void - swf_rotate - - double - angle - - string - axis - - - - swf_rotate fait subir la roation d'angle - angle, autour de l'axe axis. - Les valeurs possibles pour axis sont : - 'x' (axe x), 'y' (axe y) ou 'z' (axe z). - - - - - - - swf_posround - - Active l'approximation des translation d'objets. - - - - Description - - void - swf_posround - - int - round - - - - swf_posround active ou désactive l'approximation lors des - translations, lorsque des objets sont placés ou déplacés. Il y a des situations oú - le texte devient plus lisible lorsque l'approximation a été activée. - round active l'approximation (1) ou la désactive (0). - - - - - - - + + Fonctions Shockwave Flash + SWF + + + PHP a la capacité de créer des animations Shockwave Flash + grâce au module de Paul Haeberli : libswf module. Vous pouvez + télécharger libswf à + &url.swf;. Une fois que vous avez libswf, tout + ce qui reste à faire est de configurer PHP avec + oú DIR est + le dossier qui accueille les dossiers de include et lib. Le dossier + include doit contenir le fichier swf.h file et le dossier lib doit + contenir le fichier libswf.a. Si vous décompressez la distribution + de libswf, les deux fichiers seront dans le même dossier. Par + conséquent, vous devrez les mettre dans le dossier ad hoc manuellement. + + + Une fois que vous avez réussi à installer PHP avec + Shockwave Flash, vous pouvez créer des animations Flash avec + PHP. Vous serez surpris du résultat. Essayez donc ceci : + + Exemple SWF + +<?php +swf_openfile ("test.swf", 256, 256, 30, 1, 1, 1); +swf_ortho2 (-100, 100, -100, 100); +swf_defineline (1, -70, 0, 70, 0, .2); +swf_definerect (4, 60, -10, 70, 0, 0); +swf_definerect (5, -60, 0, -70, 10, 0); +swf_addcolor (0, 0, 0, 0); +swf_definefont (10, "Mod"); +swf_fontsize (5); +swf_fontslant (10); +swf_definetext (11, "This be Flash wit PHP!", 1); +swf_pushmatrix (); +swf_translate (-50, 80, 0); +swf_placeobject (11, 60); +swf_popmatrix (); +for ($i = 0; $i < 30; $i++) { + $p = $i/(30-1); + swf_pushmatrix (); + swf_scale (1-($p*.9), 1, 1); + swf_rotate (60*$p, 'z'); + swf_translate (20+20*$p, $p/1.5, 0); + swf_rotate (270*$p, 'z'); + swf_addcolor ($p, 0, $p/1.2, -$p); + swf_placeobject (1, 50); + swf_placeobject (4, 50); + swf_placeobject (5, 50); + swf_popmatrix (); + swf_showframe (); +} +for ($i = 0; $i < 30; $i++) { + swf_removeobject (50); + if (($i%4) == 0) { + swf_showframe (); + } +} +swf_startdoaction (); +swf_actionstop (); +swf_enddoaction (); +swf_closefile (); +?> + + + Cela va produire une animation, proche de + celle ci (mais traduite en anglais). + + + + Le support de Flash a été ajouté dans PHP4 RC2. + + + La librairie libswf n'est pas disponible pour Windows : son développement + a été stoppé, et les sources ne sont plus disponibles pour + permettre le portage vers d'autres systèmes. + + + + + + swf_openfile + Ouvre un nouveau fichier Shockwave Flash + + + Description + + + void + swf_openfile + + string + filename + + float + width + + float + height + + float + framerate + + float + r + + float + g + + float + b + + + + + swf_openfile crée un nouveau fichier + filename de largeur width, + et de hauteur height, à la vitesse de + framerate, de couleur de fond RGB + (r, g, b). + + + swf_openfile doit être la première fonction + à appeler, sous peine d'erreur mémoire (segmentation fault). + Si vous voulez envoyer votre production au client HTML, utilisez le nom + de fichier "php://stdout" (le support de ceci est prévue pour la + version 4.0.1 et ultérieur). + + + + + + swf_closefile + Ferme le fichier courant Shockwave Flash. + + + Description + + + void + swf_closefile + + int + + return_file + + + + + + swf_closefile ferme le fichier courant, qui a + été ouvert avec swf_openfile. Si le + paramètre return_file a été fourni, il contiendra + le fichier SWF fermé. + + + + + Création d'un fichier Flash simple, basé sur une entrée + de l'utilisateur, et sauvegarde dans une base. + + +<?php +// La variable $text est fournie par l'utilisateur +// Variables globales pour l'accès à la base de données +// utilisée dans la fonction wf_savedata()) +$DBHOST = "localhost"; +$DBUSER = "sterling"; +$DBPASS = "secret"; +swf_openfile ("php://stdout", 256, 256, 30, 1, 1, 1); + swf_definefont (10, "Ligon-Bold"); + swf_fontsize (12); + swf_fontslant (10); + swf_definetext (11, $text, 1); + swf_pushmatrix (); + swf_translate (-50, 80, 0); + swf_placeobject (11, 60); + swf_popmatrix (); + swf_showframe (); + swf_startdoaction (); + swf_actionstop (); + swf_enddoaction (); +$data = swf_closefile (1); +$data ? + swf_savedata ($data) : + die ("Error could not save SWF file"); +// void swf_savedata (string data) +// Sauve le fichier généré dans la base de données +// pour accès ultérieur +function swf_savedata ($data) +{ + global $DBHOST, + $DBUSER, + $DBPASS; + $dbh =  <email protected> ($DBHOST, $DBUSER, $DBPASS); + if (!$dbh) { + die (sprintf ("Error [%d]: %s", + mysql_errno (), mysql_error ())); + } + $stmt = "INSERT INTO swf_files (file) VALUES ('$data')"; + $sth =  <email protected> ($stmt, $dbh); + if (!$sth) { + die (sprintf ("Error [%d]: %s", + mysql_errno (), mysql_error ())); + } +  <email protected> ($sth); +  <email protected> ($dbh); +} +> + + + + + + + + swf_labelframe + Nomme le frame courant. + + + Description + + + void + swf_labelframe + + string + name + + + + + swf_labelframe donne le nom name + au frame courant. + + + + + + swf_showframe + Affiche le frame courant. + + + Description + + + void + swf_showframe + + + + + + swf_showframe affiche le frame courant. + + + + + + swf_setframe + Fixe le frame courant. + + + Description + + + void + swf_setframe + + int + framenumber + + + + + swf_setframe selectionne le frame + framenumber comme frame actif. + + + + + + swf_getframe + Retourne le numéro de frame courant. + + + Description + + + int + swf_getframe + + + + + + swf_getframe retourne le numéro de frame courant. + + + + + + swf_mulcolor + + Fixe la couleur globale de multiplication (? : the global multiply color). + + + + Description + + + void + swf_mulcolor + + float + r + + float + g + + float + b + + float + a + + + + + swf_mulcolor fixe la valeur globale de multiplication + (the global multiply color...) à la couleur rgba. + Cette couleur est utilisée (implicitement) par + swf_placeobject, swf_modifyobject + et swf_addbuttonrecord. La couleur d'un objet sera + multipliée par rgba lorsque l'objet est + placé sur la scène. + + + + Les valeurs de rgba peuvent être positives + ou négatives. + + + + + + + swf_addcolor + + Fixe la couleur globale d'addition (? : the global add color). + + + + Description + + + void + swf_addcolor + + float + r + + float + g + + float + b + + float + a + + + + + swf_mulcolor fixe la valeur globale de multiplication + (the global multiply color...) à la couleur rgba. + Cette couleur est utilisée (implicitement) par + swf_placeobject, swf_modifyobject + et swf_addbuttonrecord. + La couleur d'un objet sera ajouté à rgba + lorsque l'objet est placé sur la scène. + + + + Les valeurs de rgba peuvent être positives + ou négatives. + + + + + + + swf_placeobject + Place un objet sur la scène. + + + Description + + + void + swf_placeobject + + int + objid + + int + depth + + + + + swf_placeobject place l'objet objid + dans le frame courant, à la profondeur + depth. objid et + depth doivent être compris entre 1 et 65535. + + + swf_placeobject utilise la couleur courante de + multiplication (specifiée par swf_mulcolor) et + la couleur courante d'addition (specifiée par + swf_addcolor) pour colorer l'objet, et utilise + la matrice courante pour positionner l'objet. + + + + Le support des couleurs RGBA est complet. + + + + + + + swf_modifyobject + Modifie un objet. + + + Description + + + void + swf_modifyobject + + int + depth + + int + how + + + + + swf_modifyobject modifie la position et/ou la + couleur de l'objet situé à la profondeur de + depth. L'argument how + détermine ce qui doit être modifié. + how peut prendre les valeurs de + MOD_MATRIX, MOD_COLOR ou la combinaison des deux. + + + MOD_COLOR utilise la couleur courante de multiplication (specifiée par + swf_mulcolor) et la couleur courante d'addition + (specifiée par swf_addcolor) pour colorer + l'objet, et MOD_MATRIX utilise la matrice courante pour positionner l'objet. + + + + + + swf_removeobject + Enlève un objet. + + + Description + + + void + swf_removeobject + + int + depth + + + + + swf_removeobject enlève l'objet situé + à la profondeur depth de la scène. + + + + + + swf_nextid + Retourne le prochain identifiant d'objet libre. + + + Description + + + int + swf_nextid + + + + + + swf_nextid retourne le prochain identifiant d'objet libre. + + + + + + swf_startdoaction + + Commence la déscription d'une liste d'action pour la frame courante. + + + + Description + + + void + swf_startdoaction + + + + + + swf_startdoaction commence la déscription + d'une liste d'actions pour la frame courante. Cette fonction doit + être appelée avant que les actions ne soient définies + pour le cadre courant. + + + + + + swf_actiongotoframe + Joue un frame puis stoppe. + + + Description + + + void + swf_actiongotoframe + + int + framenumber + + + + + swf_actiongotoframe se déplace jusqu'au frame + framenumber, le joue, puis s'arrête. + + + + + + swf_actiongeturl + Retourne l'URL d'une animation Shockwave Flash. + + + Description + + + void + swf_actiongeturl + + string + url + + string + target + + + + + swf_actiongeturl lit l'URL url, + avec la destination target. + + + + + + swf_actionnextframe + Avance d'un frame. + + + Description + + + void + swf_actionnextframe + + + + + + swf_actionnextframe avance d'un frame le frame courant. + + + + + + swf_actionprevframe + Recule d'un frame. + + + Description + + + void + swf_actionprevframe + + + + + + swf_actionnextframe recule d'un frame le frame courant. + + + + + + swf_actionplay + + Joue l'animation flash à partir du frame courant. + + + + Description + + + void + swf_actionplay + + + + + + swf_actionplay joue l'animation Flash + à partir du frame courant. + + + + + + swf_actionstop + + Arrête l'animation flash. + + + + Description + + + void + swf_actionstop + + + + + + swf_actionstop arrête l'animation + Flash au frame courant. + + + + + + swf_actiontogglequality + + Choisi le niveau de qualité haut ou bas. + + + + Description + + + void + swf_actiontogglequality + + + + + + swf_actiontogglequality modifie le niveau de + qualité haut ou bas. + + + + + + swf_actionwaitforframe + + Ignore les actions si le frame n'est pas chargé. + + + + Description + + + void + swf_actionwaitforframe + + int + framenumber + + int + skipcount + + + + + swf_actionwaitforframe vérifie que le frame + framenumber a bien été + chargé. Si ce n'est pas le cas, elle ignore les actions + skipcount. Cela est très utile pour + les séquences du type "Chargement...". + + + + + + swf_actionsettarget + Fixe le contexte des actions. + + + Description + + + void + swf_actionsettarget + + string + target + + + + + swf_actionsettarget fixe le contexte des actions. + Vous pouvez utiliser cette fonction pour contrôler + d'autres animations Flash qui seraient en fonctionnement. + + + + + + swf_actiongotolabel + + Affiche le frame nommé. + + + + Description + + + void + swf_actiongotolabel + + string + label + + + + + swf_actiongotolabel affiche le frame de nom + label, puis stoppe. + + + + + + swf_enddoaction + Termine l'action courante. + + + Description + + + void + swf_enddoaction + + + + + + swf_startdoaction termine l'action courante, + démarrée par swf_startdoaction. + + + + + + swf_defineline + Définit une ligne. + + + Description + + + void + swf_defineline + + int + objid + + float + x1 + + float + y1 + + float + x2 + + float + y2 + + float + width + + + + + swf_defineline définit une ligne + commencant aux coordonnées (x1, + y1 ), et finissant au point de + coordonnées (x2, y2). + Elle aura la largeur de width. + + + + + + swf_definerect + Définit un rectangle. + + + Description + + + void + swf_definerect + + int + objid + + float + x1 + + float + y1 + + float + x2 + + float + y2 + + float + width + + + + + swf_definerect définit un rectangle, de + coin supérieur gauche aux coordoonées + (x1,y1), et de coin + inférieur droit aux coordonnées + (x2, y2). + L'épaisseur des bords est données par le + paramètre width. + width, 0.0 le rectangle sera rempli. + + + + + + swf_definepoly + + Définit un polygone. + + + + Description + + + void + swf_definepoly + + int + objid + + array + coords + + int + npoints + + float + width + + + + + swf_definepoly définit un polygone, + dont les coordonnées des sommets sont placés dans + le tableau coords). + npoints est le nombre de points contenu dans + le tableau coords. width + est la largeur des bords du polygone. Si width + vaut 0.0, le polygone sera rempli. + + + + + + swf_startshape + Commence une forme complexe. + + + Description + + + void + swf_startshape + + int + objid + + + + + swf_startshape commence une forme complexe, + qui sera reperé par l'identifiant d'objet + objid. + + + + + + swf_shapelinesolid + Fixe le style courant de ligne. + + + Description + + + void + swf_shapelinesolid + + float + r + + float + g + + float + b + + float + a + + float + width + + + + + swf_shapelinesolid permet de choisir le style + de ligne, à savoir la couleur et la largeur. Si + width vaut 0.0, les lignes ne + seront pas dessinées. + + + + + + swf_shapefilloff + Inactive le remplissage. + + + Description + + + void + swf_shapefilloff + + + + + + swf_shapefilloff inactive le remplissage pour la + forme courante. + + + + + + swf_shapefillsolid + + Fixe la couleur pour le style courant de remplissage. + + + + Description + + + void + swf_shapefillsolid + + float + r + + float + g + + float + b + + float + a + + + + + swf_shapefillsolid fixe la couleur pour le style courant + de remplissage à rgba. + + + + + + swf_shapefillbitmapclip + + Choisi le mode de remplissage par texture. + + + + Description + + + void + swf_shapefillbitmapclip + + int + bitmapid + + + + + Choisi le mode de remplissage par texture : les espaces + vides seront remplis avec la bitmap bitmapid. + + + + + + swf_shapefillbitmaptile + + Choisi le mode de remplissage par texture repétée. + + + + Description + + + void + swf_shapefillbitmaptile + + int + bitmapid + + + + + Choisi