load entities from the hard drive
read obj
read obj(id)name("nnn")
Reads file nnn.ext in objetc id type obj:
alea
alea
audio
image
fog
field
genetic
law
light
memory
menu
object
network
scale
vol
view
matrix
device
read name("nnn.ext")[sort]
Reads the objects described in the file nnn.ext overwriting any other objects of the same indicator.
ext depends on the type of the objects.
If sort is present, objects are renumbered in the order they are read.
read memory(id)format("anyflo")name("nnn")
Reads file nnn anyflo formated in
memory id;
read audio
read audio name("nnn")
Opens file nnn in read mode, returns -1 if error.
read(n)audio
Returns n current values read from file nnn,
and NIL if end of file.
Options:
number(num): reads n values numbers [num,num+n-1],
num must been < file size.
format(ff): set datas type:
"char": characteres string
"long": long
"float": float (default)
read(n)audio
Returns ncurrent values from file nnn,
and NIL if end of file.
See also:
end write audio to close the file.
write audio
read audio(id)name("NNN.wav")
Reads audio file nnn.wav in objetc id type audio
with properties:
audio: containt of file nnn.wav.
max: list of amplitudes each 1/25 second.
read directory
read directory("dir"
Returns the names of files in dir.
Options:
name("eee"): only file eee
Example:
read directory("ima")name("*.bmp");
or: read directory("ima")format("bmp");
Returns the list of all files extension bmp from directory ima.
read displ
read displ "nnn"
Reads the ASCII file nnn.displ of light-vol-view written by write displ
read alea
read alea "nnn"
Reads the random file nnn.alea.
read ascii
read ascii vol "nnn"
Reads the volumes file nnn.ascii.vol ASCII coded according to the format
described in file manuel.format.htm
of the environment folder.
read fog
read fog "nnn"
Reads the fogs file nnn.fog
read format
read format vol
read format("Z") vol("nnn")
Reads the compressed filr nnn.vol.Z by write format(1) vol("nnn")
read format("hrc") vol("nnn") (obsolète)
Reads the volumes file /MODELS/nnn.1-0.hrc SOFTIMAGE format.
Remarques:
1) Only volumes of type mesh are processed
2) Coordnates are multiplied by 50, they will be divided by 50 when a
formated writing.
read format("hrc") vol("nnn") coe(c)
Allows specify the multiplier coefficient.
3) The datas base directory is ima.
4) defaul is 1, in order to specify this value:
read format("hrc") vol("nnn")ext(number_version)
Example:
directory "ima"="/usr/people/jules/Database_jules"
read format light
read format("lig") light("nnn")
(obsolète)
Reads the /MODELS/name.1-0.lig SOFTIMAGE formated file.
Notes:
1) Tne coordinates are multiplied by 50, they will be divided by 50
with a write format("dsc") secen name("nnn")´
read format("lif") lun("nnn") coe(c)
Allows specify the multiplier coefficient.
2) The datas base directory is "ima"
3) By default version is 1, for specify this value:
read format("lig") light("nnn")ext(number_version)
read graphic
read graphic("nnn")
Lit le fichier d´images name write par write graphic
Pour jouer see play graphic
read image name
read image name("nnn.eee")
Returns the size (nx,ny,nz) of image name nnn.eee
read image (id)name("nnn.eee")
Reads the file image nnn.ext in image id
Options:
abs: alows to read an image whose name contains a space.
coe(c): image size *= c.
dim(nx,ny): changes the image sizes in (nx,ny).
ini(0): does nor reads an existing image.
name("name1;name2 ..."): reads files image nnni.ext in the the successive
bitmaps of the 3D image id.
name("name.ext")number("4D",num,nb): reads the files image
namei.ext (with i in [num,num+nb-1]) in successives bitmaps of the 3D image id.
normal: coordinates display normalized.
NP(ind): adds ind to num.
number(num): concates num to the name.
number("nD",num): concates num coded with b digits to the name.
poi(x,y): botom left corner (x,y) (screen botom left corner by default).
read image bitmap
read image(id)name("nnn.ima")bitmap(num)
Reads bitmap num of 3D image nnn.ima
in image id and returns secz image id.
Options:
dim(nx,ny): resizing to (nx,ny).
read image(id)name("nnn.eee")number(im,nb)bitmap
Reads images nnn[im,im+nb-1].eee in the the successive
bitmaps of the 3D image id.
Options:
dim(nx,ny): changes the image sizes in (nx,ny).
directory("dir"): from directory dir.
read image(id)directory("dir")bitmap
Reads all images of directory dir in the the successive
bitmaps of image id.
read image(id)name("nnn.eee")number(im,nb)bitmap
Reads images nnn[im,im+nb-1].eee in the the successive
bitmaps of the 3D image id.
read image(id)number(im,nb)bitmap
Copies images [im,im+nb-1] (must exist) in the the successive
bitmaps of the 3D image id.
Example:
read image(1)name("../../bmp:A.bmp")number("4D",700)NP(100);
Reads the image file ../../A0700.bmp in image 1.
Note: It is possible that the message name_image.bmp already exists, overwrite it? [Y / n]
appears in the text, while the program is waiting for a response:
focus on the window and type y.
read image(id)name("nnn.raw")line(n,nb)
Reads nb lines of file nnn.raw (non compressed anyflo image format) from line n
and returns the number of the next line to read, can be used for read images in pieces.
Options:
generate: if the image is a texture mapping.
read image(id)name("nnn.ima")cut(n)
Initiates process of reading a 3D image name nnn.ima
in image id, returnes nz = number of layers of this image. Every frame n bytes are read.
Notes
interaction must has been done.
Usually n = 4 * nx * ny = size of a layer.
read image(num)directory("dir")
Reads every images of directory ddd in images num,num+1, ... and returns
the number of the last image.
Options:
ext=eee: only files name nnn.eee.
read image("nnn") ext("eee")format(f)number(num)interpol(im1,im2,di)
Reads images name nnn.eee numbers im1 to im2 according to
format f calculating di interpolated images, the images
are stored from the number num.
Example:
read image("A") ext("jpg")format(f)number(100)interpol(1,4,6)
Reads images A0001.jpg, A0002.jpg, A0003.jpg and A0004.jpg which are stored
in 100, 105, 110 et 115.
Images 100 and 105 are interpolated in 101, 102, 103 et 104.
Images 105 and 110 are interpolated in 106, 107, 108 et 109.
Images 110 and 115 are interpolated in 111, 112, 113 et 114.
Useful to animate textures: just do for example, ecah image:
interaction texture vol(1)=m
with m = num + c * 15
with c as a parameter varying between 0 and 1 (for example the normalized module of a sensor).
read image name("nnn.eee")network(id)
Reads image nnn.eee, relizes a convolution to the dimensions of a motif of the network id,
transmits the result res to validate motif(res)network(id)
and returns the output (the size of a law).
read image(num1,num2)name("nnn.eee")network(id)
Reads image nnn.eee, relizes a convolution to the dimensions of a motif of the network id in image num1,
transmits the result res to validate motif(res)network(id)
and returns the output (the size of a law) in image num2.
read image name("n1 n2 ... nn")network(id)dim(nx,ny)
Reads images names n1 n2 ... nn in neural network id
resizing (nx,ny).
Options:
inv: y symetrize images.
motif in motifs.
law in laws.
motif law in motifs and laws.
Options:
format("fff"):
format("L")network(id): image(rgba) -> motif(a)network(id) (default value).
format("R")network(id): image(rgba) -> motif(r)network(id).
format("V")network(id): image(rgba) -> motif(v)network(id).
format("B")network(id): image(rgba) -> motif(b)network(id).
read image(id)name("nnn.ext") win(x,y)
Reads the image file nnn.ext the file nnn.ext in (x,y).
read memory
read memory obj(id) name("x")
Reads file x in memory of object id type obj
Notes:
1) obj is: ´cin´, ´fog´, ´light´, ´traj´, ´vol´, ´view´
2) only one number can be read
read matrix
The commande read matrix can be extended to
motifs and laws of a
neural network:
read("MOT)matrix motif network(id);
Loads the matrices file MOT in the motifs of the network id.
read("LOI)matrix law network(id);
Loads the matrices file LOI in the laws of the network id.
read("ML)matrix motif law network(id);
Loads the same matrices files MM in the motifs and in the laws of the network id.
Returns the read floats list and NIL if error:
Constraints: each file must consist of matrices of same dimensions as dimensions of motifs and laws
(nx=columns number, ny=lines number).
Note:
dim matrix returns nb,nx,ny with:
nb = read matrices number.
nx,ny = common dimensions of matrices.
read menu
read menu("nnn")
Loads the file nnn.menu as menus.
read meta
Automatic editing.
read meta add
directory("dir1")
directory("dir2")
write("dir3")NP(np)
Builds dir3=dir1,dir2 by interpolating the last np images of dir1
with the first np images of dir2.
Note: dir1 must be different from dir3.
read meta
image("ima1.ee1")
write("ima2.ee2")number(num)
Copies image ima1.ee1 into ima2[num].ee2 and returns num+1.
read meta
image("ima1.ee1")
write("ima2.ee2")number(num)NP(np)
ima1.ee1 into ima2[num,num+np-1].ee2 and returns num+np.
read meta
image("ima1.ee1")
image("ima2.ee2")
write("ima3.ee3")number(num)NP(np)
Builds images ima3[num,num+np-1].ee3 interpolation from ima1.eee to
ima2.eee into and returns num+np.
read meta
image("ima1.ee1")
directory("dir")
write("ima3.ee3")number(num)
Interpolates image ima1.ee1 with all files of directory dir, writes
the results as ima3[num,num+n-1].ee3 and returna num+n (n=numbers of the
directory files).
read meta
directory("dir")
write("ima.eee")number(num)
Copies all files of directory dir into ima[num,num+n-1].eee with
n=files' number directory and returns num+n.
read meta
directory("dir1")directory("dir2")
write("ima.eee")number(num)NP(np)
Adds directories dir1 and dir2 in ima.eee:
interpol(np) np last images of dir1 with np first images of dir2
copy the others images of dir2.
Options
add: connecting to directory dir (interpolating dir1[nb_np,nb] to
dir2[1,np]).
back(r,g,b): np last images -> (r,g,b) (black default).
ext("eee"): only files *.eee.
NP(n): builds files ima[num,num+n-1].eee and returns num+n.
number("4D",num): number coded on 4 digits.
Example
read meta
image("ima1.bmp")image("title.jpg")image("ima2.bmp")
directory("../../bmp1")
directory("../../bmp2")
back ext("jpg")
write("../../bmp3/BUG.bmp")number("4D",1)NP(50);
Realizes a complete video editing:
interpolating image ima1.bmp to image title.jpg in 2 seconds
interpolating image title.jpg to image ima2.bmp in 2 seconds
interpolating image ima2.bmp to directory ../../bmp1 in 2 seconds
interpolating directory ../../bmp1 to directory ../../bmp2
and fadink to black in 2 seconds.
The results are written as files "../../bmp3/BUG[0001,...].bmp"
read poi
read poi format name number
read poi(n1,n2) format(f) name("fic")
Returns the coordinates of the point numbered [n1,n2] of the file fic.
read poi(n1,n2) format(f) name("fic1") number(num)
Assigns points numbers [n1, n2] volume number num from the fic file.
The file is assumed formatted as follows:
x1 f y1 f z1
x2 f y2 f z2
....
f is a space (dafqult) or a comma.
read poi(n1,n2) format(f) line(num) name("fic")
Lets start with the line num of file fic.
read poi vol("nnn")
Replaces the volume points in memory by those of file nnn.vol
See also:
read format vol
read text
read text "toto"
Loads the font of name toto.
read write
Image converter:
read image("rrr.ee1")write image("www.ee2")
Reads file name (rrr.ee1) and writes it in file name
(www.ee2).
Options:
number("4D",im1)number("4D",im2):
Reads file name (rrrim1.ee1) and writes it in file name (wwwim2.ee2).
read image("*.ee1")write image("*.ee2");
reads every files *.ee1 and writes them as *.ee2.
Legal
extension.
Examples:
read image("X.jpg")write image("Y.bmp");
Converts X.jpg in Y.bmp
read image("env/*.jpg")write image("*.bmp");
Converts every file env/*.jpg in *.bmp
Images interpolating
read
image("nnn1.ee1")
image("nnn2.ee2")
write("nnn3.ee3")number(num)NP(np)
Buils files nn3[num,num+np-1].ee3 from image nn1.ee1 to image nn2.ee2.
read
image("nnn1.ee1")number(num1)
image("nnn2.ee2")number(num2)
write image("nn3.ee3")number(num3)NP(nb)
Interpolates image file name ("nnn1.ee1") number num1 and
image file name ("nnn2.ee2") number num2 saving the nb result in
image files name ("nnn3.ee3") number num3.
Options:
acc: accelerated
dec: decelerated
directory("dir"): searching files in directoty dir/.
law(x1,y1,0, x2,y2,0, ...): acording to the law.
NP(n): n consecutive files.
number("nD",num): numbers coded on ndigits.
pend: pendular
Example:
read image("dir1/A.bmp")number("4D",600)
image("dir2/B.bmp")number("4D",1)
write image("dir3/C.bmp")number("4D",1)NP(6);
Creates images files named dir3/C0001.bmp, dir3/C0002.bmp, ..., dir3/C0006.bmp
interpolated between images dir1/A0600.bmp and dir2/B0700.bmp
sequences interpolation
read
directory("dir1 dir2 ...")
write("dir0")interpol(ni)
Directories diri contain 3D images which are
copied in directory dir0 as _n.ima. Images
_i_j.ima interpolating images i and j are written in dire0.
Options:
sin: sinusoidale interpolation.
Note:
Useful for interaction metawith option read.
read write image directory("dir1")concat
motion blur of 2 images on images of directory dir1, using images number 1,2.
Options:
coe(c): coefficient c.
coe(c1,c2,...): coefficients c1,c2,....
normal: coefficients normalized.
concat(n): of n images (2 by default).
directory("dir2") writting the results in directory dir2
instead of dir1.
number(num): using images [num+1,num+n].
read image write inclu
read write image write inclu
name("name1wwww.ee1")
name("name2rrrr.ee2")
NP(np)
Inserts name2[rrrr,rrrr+np-1] into name1[wwww+np-1]
Options:
center(x,y): mdallion (x et y normalised between 0 and 1, 0.5 by default).
center(x1,y1,0, x2,y2,0, ...): line of medallions (xi and yi normalized between 0 and 1).
name("name3sss.ee3.ee3"): writing the result in name3sss.ee3.ee3 (for testing
without testroying name1wwww.ee1).
pend: pendulum on transp(t1,t2,t3).
radius(rx1,ry1, rx2,ry2, ...): radius
transp(t1,t2,...): with transparencies.
var(n,v1,v2): according to adjust,
must be two references:
first fot transparency: var(n,t1,t2, ...)
second to radius: var(n,rx1,ry1, rx2,ry2, ...)
Examples
Inserts bid1/A[1010,1021].jpg into bid0/A[1012,1023].jpg
read write image inclu name("bid0/A1012.jpg")name("bid1/A1010.jpg")
NP(25)center var(12, 1,1)var(12, 0,0, 1,1, 0,0)ext(7,1,1);
same insertion with a pendulum transparency (fade in fade out).
read write image inclu name("bid0/A1012.jpg")name("bid1/A1010.jpg")NP(100)
center var(25, 1,1,1)var(n, 0,0, .75,.57, 0,0)ext(7,1,1);
with medallion and transparency, fade in on 25 images, constant on 50 images and fade out on 25 images.
read image directory directory interpol
read image directory("rrr.ee1")write directory("www")interpol(ni)
Adds directoty www to directoty rrr interpolating the ni last images of rrr
with the ni first images of www and copying the next images of www in www.
Options:
directory("aaa"): writes the result in directory aaa instead of rrr.
write image NP interpol
read image("rrr.ee1")number(num1)write name("www")number(num2)NP(np)interpol(ni)
smoothes the animation rrr[num1,num1+np] and writes the result in www[num2,num2+np] by
interpolating every image number n in [n-ni,n+ni].
Example:
read image name(rrr)number("4D",1)write name(www)number("4D",1)NP(200)interpol(3);
smoothes the animation rrr[1,200] and writes the result in www[1,200] by
interpolating every image number n in [n-3,n+3].
transparency color interpolating
read image("nnn1.ee1")number(num1)image("nnn2.ee2")number(num2)
write image("nn3.ee3")number(num3)NP(nb)
transp(t11,t12)col(r11,g11,b11, r12,g12,b12)
transp(t21,t22)col(r12,g12,b12, r22,g22,b22)
Interpolates images nnn1_[num1,num1+nb-1] with images nnn2_[num1,num2+nb-1] by varying
the parameters transp(t1,t2)color(r1,g1,b1, r2,g2,b2) and writing the results
in files nnn1_[num3,num3+nb-1].
read write image>
transparency luminance interpolating (images crossfade):
read image("nnn1.ee1")number(num1)image("nnn2.ee2")number(num2)
write image("nn3.ee3")number(num3)NP(nb)
transp(t11,t12)luminance(lum11,lum12)transp(t21,t22)luminance(lum21,lum22)
Interpolates images nnn1_[num1,num1+nb-1] with images nnn2_[num1,num2+nb-1] by varying
the parameters transp(t1,t2)luminance(lum1,lum2) and writing
the results in files nnn1_[num3,num3+nb-1].
Example:
read("A.bmp")number("4D",600)read("B.bmp")number("4D",700) write("C.bmp")number("4D",1)NP(25)
transp(0,1, 0,1)luminance(0,1, 1,1)
transp(0,1, 0,1)luminance(1,1, 0,1);
Interpolates images A0600.bmp, ..., A0625.bmp with images B0700.bmp, ..., B0725.bmp
with a constant transparency (0,1), the luminance varying from (0,1) to (1,1) for
the images A and from (1,1) to (0,1) for the image B
and write the results in files C0001.bmp, ..., C0025.bmp, this a fade in fade out.
fade in image
read back(r,g,b)image(\"nn1.ee\")number(\"4D\",n1)write image(\"nn2.eee\")
number(\"4D\",n2)NP(np)
Builds images nn2[n2,n2+np-1].eee as a fade in from color (r,g,b)
to animated sequence nn1[n1,n1+np-1].eee.
image fade out
read image(\"nn1.ee\")number(\"4D\",n1)back(r,g,b)write image(\"nn2.eee\")
number(\"4D\",n2)NP(np)
Builds images nn2[n2,n2+np-1].eee as a fade out from
to animated sequence nn1[n1,n1+np-1].eee to color (r,g,b).
read write audio
sounds crosfade:
read audio("nnn1.wav")audio("nnn2.wav")
write audio("nn3.wav")time(t)
cros fade between the latest t seconds of file nn1.wav and the
first t seconds of file nn2.wav, the result written in file
nn3.wav.
read write image directory("dir1")col(r,g,b)
reads images of directory and writes them with correction image image col.
Options:
directory("dir2"): write results in dir2
limit: evoides color overflows.
sin(r,g,b): withe sine variations 0.5*(1+sin(r*t)) 0.5*(1+sin(g*t)) 0.5*(1+sin(b*t))
sin(r,g,b,kr,kg,kb): 0.5*(kr+sin(r*t)) 0.5*(kg+sin(g*t)) 0.5*(kb+sin(b*t))
read zbuf
read zbuf("nnn")
Reads the name.zbuf in the zbuffer.
Note:
The type of z-buffer can be changed depending on those during the write zbuf.
Options:
read(2): reads the file name name.zbuf saved by
write(2) zbuf("nnn") unformatted in shorts.
read(3): reads the file name name.zbuf saved by
write(2) zbuf("nnn") unformatted in floats.
Voir aussi
See also: