4 * author: frank zirkelbach (frank.zirkelbach@physik.uni-augsburg.de)
6 * this program tries helping to understand the amorphous depuration
7 * and recrystallization of SiCx while ion implantation at temperatures
8 * below 400 degree celsius.
9 * hopefully the program will simulate the stabilization of the
10 * selforganizing lamella structure in the observed behaviour.
13 * - J. K. N. Lindner. Habilationsschrift, Universitaet Augsburg.
14 * - Maik Haeberlen. Diplomarbeit, Universitaet Augsburg.
16 * Copyright (C) 2004 Frank Zirkelbach
18 * This program is free software; you can redistribute it and/or modify
19 * it under the terms of the GNU General Public License as published by
20 * the Free Software Foundation; either version 2 of the License, or
21 * (at your option) any later version.
23 * This program is distributed in the hope that it will be useful,
24 * but WITHOUT ANY WARRANTY; without even the implied warranty of
25 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
26 * GNU General Public License for more details.
28 * You should have received a copy of the GNU General Public License
29 * along with this program; if not, write to the Free Software
30 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
38 #include <sys/types.h>
48 #define MAKE_AMORPH(N) *(N)|=AMORPH
49 #define MAKE_CRYST(N) *(N)&=~AMORPH
55 puts("-n \t\t no user interaction");
56 puts("-Z \t\t cryst -> amorph c diffusion in z direction");
57 puts("-i \t\t no cryst to cryst diffusion");
58 printf("-a <value> \t slope of nuclear energy loss (default %f)\n",A_EL);
59 printf("-b <value> \t nuclear energy loss offset (default %f)\n",B_EL);
60 printf("-x <value> \t # x cells (default %d)\n",X);
61 printf("-y <value> \t # y cells (default %d)\n",Y);
62 printf("-z <value> \t # z cells (default %d)\n",Z);
63 printf("-s <value> \t steps (default %d)\n",STEPS);
64 printf("-d <value> \t refresh display (default %d)\n",REFRESH);
65 printf("-r <value> \t amorphous influence range (default %d)\n",RANGE);
66 printf("-f <value> \t pressure = <value> * 1/distance^2 (default %f)\n",A_AP);
67 printf("-p <value> \t pressure offset (default %f)\n",B_AP);
68 printf("-F <value> \t proportionality constant between c conc and ability to get amorphous (default %f)\n",A_CP);
69 printf("-A <value> \t slope of linear c distribution (default %f)\n",A_CD);
70 printf("-B <value> \t linear c distribution offset (default %f)\n",B_CD);
71 printf("-D <value> \t diffusion rate from cryst to amorph cells (default %f)\n",DR_AC);
72 printf("-c <value> \t diffusion rate in cryst cells (default %f)\n",DR_CC);
73 printf("-e <value> \t do diffusion every <value> steps (default %d)\n",DIFF_RATE);
74 puts("-g <file> <step> continue simulation from file and step (step > 0)!");
75 printf("-W <value> \t write every <value> steps to save file (default %d)\n",RESAVE);
76 puts("-C <file> \t convert file to gnuplot format");
77 puts("-L <file> \t load from file");
78 puts("-S <file> \t save to file");
79 puts("-R <file> \t read from random file");
80 puts("-P <file> \t specify implantation profile file");
81 printf("-H <value> \t collisions per ion in simulation window (default %d)\n",CPI);
86 int process_cell(d3_lattice *d3_l,u32 x,u32 y,u32 z,info *my_info)
94 thiz=d3_l->status+x+y*d3_l->max_x+z*d3_l->max_x*d3_l->max_y;
95 conc=d3_l->extra+x+y*d3_l->max_x+z*d3_l->max_x*d3_l->max_y;
96 p=my_info->b_ap*URAND_MAX;
97 for(i=-(my_info->range);i<=my_info->range;i++)
99 for(j=-(my_info->range);j<=my_info->range;j++)
103 off=((x+d3_l->max_x+i)%d3_l->max_x)+((y+d3_l->max_y+j)%d3_l->max_x)*d3_l->max_x+z*d3_l->max_x*d3_l->max_y;
104 if(*(d3_l->status+off)&AMORPH) p+=my_info->a_ap*(*(d3_l->extra+off))*URAND_MAX/(i*i+j*j);
108 p+=*conc*my_info->a_cp*URAND_MAX;
111 if(get_rand(URAND_MAX)<=p) MAKE_AMORPH(thiz);
114 /* assume 1-p probability */
115 if(get_rand(URAND_MAX)>p) MAKE_CRYST(thiz);
121 int distrib_c(d3_lattice *d3_l,info *my_info,int step,double c_ratio)
128 /* put one c ion somewhere in the lattice */
129 if(my_info->cc<c_ratio*step)
131 x=get_rand(d3_l->max_x);
132 y=get_rand(d3_l->max_y);
133 z=get_rand_lgp(d3_l->max_z,my_info->a_cd,my_info->b_cd);
134 *(d3_l->extra+x+y*d3_l->max_x+z*d3_l->max_x*d3_l->max_y)+=1;
138 if(step%my_info->diff_rate==0)
141 for(i=0;i<d3_l->max_x;i++)
143 for(j=0;j<d3_l->max_y;j++)
145 for(k=0;k<d3_l->max_z;k++)
147 offset=i+j*d3_l->max_x+k*d3_l->max_x*d3_l->max_y;
148 /* case amorph: amorph <- cryst diffusion */
149 if(*(d3_l->status+offset)&AMORPH)
155 off=((i+d3_l->max_x+c)%d3_l->max_x)+j*d3_l->max_x+k*d3_l->max_x*d3_l->max_y;
157 if(!(*(d3_l->status+off)&AMORPH)) carry=(int)(my_info->dr_ac*(*(d3_l->extra+off)));
160 *(d3_l->extra+offset)+=carry;
161 *(d3_l->extra+off)-=carry;
169 off=i+((j+c+d3_l->max_y)%d3_l->max_y)*d3_l->max_x+k*d3_l->max_x*d3_l->max_y;
171 if(!(*(d3_l->status+off)&AMORPH)) carry=(int)(my_info->dr_ac*(*(d3_l->extra+off)));
174 *(d3_l->extra+offset)+=carry;
175 *(d3_l->extra+off)-=carry;
183 off=i+j*d3_l->max_x+(k-1)*d3_l->max_x*d3_l->max_y;
185 if(!*(d3_l->status+off)&AMORPH) carry=(int)(my_info->dr_ac*(*(d3_l->extra+off)));
188 *(d3_l->extra+off)-=carry;
189 *(d3_l->extra+offset)+=carry;
194 off=i+j*d3_l->max_x+(k+1)*d3_l->max_x*d3_l->max_y;
196 if(!*(d3_l->status+off)&AMORPH) carry=(int)(my_info->dr_ac*(*(d3_l->extra+off)));
199 *(d3_l->extra+off)-=carry;
200 *(d3_l->extra+offset)+=carry;
205 /* case not amorph: cryst <-> cryst diffusion */
206 if(my_info->c_diff) {
207 /* if there is c diff, no diff in z-direction */
213 off=i+((j+c+d3_l->max_y)%d3_l->max_y)*d3_l->max_x+k*d3_l->max_x*d3_l->max_y;
215 if(!(*(d3_l->status+off)&AMORPH))
217 carry=(int)(my_info->dr_cc*(*(d3_l->extra+off)-*(d3_l->extra+offset))/2);
220 *(d3_l->extra+offset)+=carry;
221 *(d3_l->extra+off)-=carry;
230 off=((i+c+d3_l->max_x)%d3_l->max_x)+j*d3_l->max_x+k*d3_l->max_x*d3_l->max_y;
232 if(!(*(d3_l->status+off)&AMORPH))
234 carry=(int)(my_info->dr_cc*(*(d3_l->extra+off)-*(d3_l->extra+offset))/2);
237 *(d3_l->extra+offset)+=carry;
238 *(d3_l->extra+off)-=carry;
251 } /* if step modulo diff_rate == 0 */
256 int calc_pressure(d3_lattice *d3_l,int range)
262 for(x=0;x<d3_l->max_x;x++)
264 for(y=0;y<d3_l->max_y;y++)
266 for(z=0;z<d3_l->max_z;z++)
269 for(i=-range;i<=range;i++)
271 for(j=-range;j<=range;j++)
275 off=((x+d3_l->max_x+i)%d3_l->max_x)+((y+d3_l->max_y+j)%d3_l->max_x)*d3_l->max_x+z*d3_l->max_x*d3_l->max_y;
276 if(*(d3_l->status+off)&AMORPH) count+=((double)*(d3_l->extra+off))/(i*i+j*j);
280 if(count>max) max=count;
285 for(x=0;x<d3_l->max_x;x++)
287 for(y=0;y<d3_l->max_y;y++)
289 for(z=0;z<d3_l->max_z;z++)
292 for(i=-range;i<=range;i++)
294 for(j=-range;j<=range;j++)
298 off=((x+d3_l->max_x+i)%d3_l->max_x)+((y+d3_l->max_y+j)%d3_l->max_x)*d3_l->max_x+z*d3_l->max_x*d3_l->max_y;
299 if(*(d3_l->status+off)&AMORPH) count+=((double)*(d3_l->extra+off))/(i*i+j*j);
303 *(unsigned char *)(d3_l->v_ptr+x+y*d3_l->max_x+z*d3_l->max_x*d3_l->max_y)=(unsigned char)(count*255/max);
311 int calc_max_extra(d3_lattice *d3_l)
316 for(x=0;x<d3_l->max_x;x++)
318 for(y=0;y<d3_l->max_y;y++)
320 for(z=0;z<d3_l->max_z;z++)
322 off=x+y*d3_l->max_x+z*d3_l->max_x*d3_l->max_y;
323 if(*(d3_l->extra+off)>max) max=*(d3_l->extra+off);
331 int write_bmp(d3_lattice *d3_l,int window,u32 x,u32 y,u32 z)
333 int fd,i,j,size=0,foo=0,end=0;
334 int width=0,height=0;
335 char bmpfile[MAX_CHARS];
338 if(((window==4)||(window==5))&&(d3_l->max_z<FFT_HEIGHT) )
340 puts("error: z < FFT_HEIGHT!");
341 puts("not writing bmp file ...");
347 sprintf(bmpfile,"x-z_%d.bmp",y);
351 size=(foo+(4-foo%4))*d3_l->max_z;
356 size=(foo+(4-foo%4))*FFT_HEIGHT;
357 end=d3_l->max_z-FFT_HEIGHT;
364 sprintf(bmpfile,"y-z_%d.bmp",x);
368 size=(foo+(4-foo%4))*d3_l->max_z;
373 size=(foo+(4-foo%4))*FFT_HEIGHT;
374 end=d3_l->max_z-FFT_HEIGHT;
381 sprintf(bmpfile,"x-y_%d.bmp",z);
383 size=(foo+(4-foo%4))*d3_l->max_y;
388 if((fd=open(bmpfile,O_WRONLY|O_CREAT))<0)
390 puts("cannot open bmp file");
395 buf[0]='B'; /* std header start */
397 buf[2]=(size+0x36)&0xff; /* file size */
398 buf[3]=(size+0x36)>>8;
400 buf[10]=0x36; /* offset to data */
402 buf[14]=0x28; /* length of bmp info header */
404 buf[18]=width&0xff; /* width and height */
410 buf[26]=1; /* # planes -> 1 */
412 buf[28]=24; /* bits per pixel -> 2^24 (true color) */
414 memset(buf+30,0,4); /* compression -> none */
415 buf[34]=size&0xff; /* data size */
418 buf[38]=0x12; /* res: pixel/meter */
424 memset(buf+46,0,8); /* no colors, no important colors */
426 if(write(fd,buf,54)<54)
428 puts("failed writing bmp header");
433 for(j=0;j<d3_l->max_z-end;j++)
435 for(i=0;i<d3_l->max_x;i++)
437 if(*(d3_l->status+i+y*d3_l->max_x+(d3_l->max_z-j-1)*d3_l->max_x*d3_l->max_y)&RED) memset(buf,0xff,3);
438 else memset(buf,0,3);
439 if(write(fd,buf,3)<3)
441 puts("failed writing rgb values to bmp file");
447 memset(buf,0,4-foo%4);
448 if(write(fd,buf,4-foo%4)<4-foo%4)
450 puts("failed writing 4 byte ending");
458 for(j=0;j<d3_l->max_z-end;j++)
460 for(i=0;i<d3_l->max_y;i++)
462 if(*(d3_l->status+x+i*d3_l->max_x+(d3_l->max_z-j-1)*d3_l->max_x*d3_l->max_y)&RED) memset(buf,0xff,3);
463 else memset(buf,0,3);
464 if(write(fd,buf,3)<3)
466 puts("failed writing rgb values to bmp file");
472 memset(buf,0,4-foo%4);
473 if(write(fd,buf,4-foo%4)<4-foo%4)
475 puts("failed writing 4 byte ending");
483 for(j=0;j<d3_l->max_y;j++)
485 for(i=0;i<d3_l->max_x;i++)
487 if(*(d3_l->status+i+(d3_l->max_y-j-1)*d3_l->max_x+z*d3_l->max_x*d3_l->max_y)&RED) memset(buf,0xff,3);
488 else memset(buf,0,3);
489 if(write(fd,buf,3)<3)
491 puts("failed writing rgb values to bmp file");
497 memset(buf,0,4-foo%4);
498 if(write(fd,buf,4-foo%4)<4-foo%4)
500 puts("failed writing 4 byte ending");
511 int save_to_file(char *sf,d3_lattice *d3_l,info *my_inf)
515 if((sf_fd=open(sf,O_WRONLY|O_CREAT))<0)
517 puts("cannot open save file");
520 if(write(sf_fd,d3_l,sizeof(d3_lattice))<sizeof(d3_lattice))
522 puts("failed saving d3 lattice struct");
525 if(write(sf_fd,my_inf,sizeof(info))<sizeof(info))
527 puts("failed saving info struct");
530 c=d3_l->max_x*d3_l->max_y*d3_l->max_z;
531 if(write(sf_fd,d3_l->status,c*sizeof(unsigned char))<c*sizeof(unsigned char))
533 puts("failed saving status of d3 lattice sites");
536 if(write(sf_fd,d3_l->extra,c*sizeof(int))<c*sizeof(int))
538 puts("failed saving sites concentration");
546 int load_from_file(char *lf,d3_lattice *d3_l,info *my_inf)
550 if((lf_fd=open(lf,O_RDONLY))<0)
552 puts("cannot open load file");
555 if(read(lf_fd,d3_l,sizeof(d3_lattice))<sizeof(d3_lattice))
557 puts("failed reading d3 lattice struct");
560 if(read(lf_fd,my_inf,sizeof(info))<sizeof(info))
562 puts("failed reading info struct");
565 c=d3_l->max_x*d3_l->max_y*d3_l->max_z;
566 if((d3_l->status=(unsigned char*)malloc(c*sizeof(unsigned char)))==NULL)
568 puts("cannot allocate status buffer");
571 if((d3_l->extra=(int *)malloc(c*sizeof(int)))==NULL)
573 puts("cannot allocate concentration buffer");
576 if(read(lf_fd,d3_l->status,c*sizeof(unsigned char))<c*sizeof(unsigned char))
578 puts("failed reading status of d3 lattice sites");
581 if(read(lf_fd,d3_l->extra,c*sizeof(int))<c*sizeof(int))
583 puts("failed reading sites concentration");
591 int convert_file(char *cf,d3_lattice *d3_l)
596 if((c_fd=open(cf,O_WRONLY|O_CREAT))<0)
598 puts("cannot open convert file");
601 dprintf(c_fd,"# created by nlsop (gnuplot format)\n");
602 for(x=0;x<d3_l->max_x;x++)
604 for(y=0;y<d3_l->max_y;y++)
606 for(z=0;z<d3_l->max_z;z++)
608 if(*(d3_l->status+x+y*d3_l->max_x+z*d3_l->max_x*d3_l->max_y)&AMORPH) dprintf(c_fd,"%d %d %d\n",x,y,z);
617 int get_c_ratio(double *c_ratio,char *pfile,info *my_info,d3_lattice *d3_l)
622 unsigned char buf[32];
626 if((p_fd=open(pfile,O_RDONLY))<0)
628 puts("cannot open profile file");
645 a=atof(p)/10; /* nm */
648 if(a>my_info->b_cd*CELL_LENGTH && a<(my_info->b_cd+d3_l->max_z)*CELL_LENGTH) d+=b;
658 int main(int argc,char **argv)
660 u32 x,y,z,x_c,y_c,z_c;
661 int i,j,quit,escape,switchmode,nowait,bmp;
664 char s_file[MAX_CHARS];
665 char s_file_tmp[MAX_CHARS];
666 char l_file[MAX_CHARS];
667 char c_file[MAX_CHARS];
668 char p_file[MAX_CHARS];
670 char r_file[MAX_CHARS];
672 char xyz_txt[MAX_TXT];
673 char status_txt[MAX_TXT];
674 char conc_txt[MAX_TXT];
675 char steps_txt[MAX_TXT];
676 char cc_txt[MAX_TXT];
679 char ap_txt[MAX_TXT];
680 char el_txt[MAX_TXT];
681 char cd_txt[MAX_TXT];
683 char cp_txt[MAX_TXT];
684 char zdiff_txt[MAX_TXT];
685 char diff_txt[MAX_TXT];
686 char dr_ac_txt[MAX_TXT];
687 char dr_cc_txt[MAX_TXT];
688 char dose_txt[MAX_TXT];
689 char mode_txt[MAX_TXT];
690 char *arg_v[MAX_ARGV];
719 my_info.diff_rate=DIFF_RATE;
729 strcpy(p_file,IMP_PROFILE);
747 my_info.a_el=atof(argv[++i]);
750 my_info.b_el=atof(argv[++i]);
753 d3_l.max_x=atoi(argv[++i]);
756 d3_l.max_y=atoi(argv[++i]);
759 d3_l.max_z=atoi(argv[++i]);
769 my_info.steps=atoi(argv[++i]);
772 refresh=atoi(argv[++i]);
775 my_info.range=atoi(argv[++i]);
778 my_info.a_ap=atof(argv[++i]);
781 my_info.b_ap=atof(argv[++i]);
784 my_info.a_cp=atof(argv[++i]);
787 my_info.a_cd=atof(argv[++i]);
790 my_info.b_cd=atof(argv[++i]);
793 resave=atoi(argv[++i]);
796 strcpy(l_file,argv[++i]);
797 if(i<argc-1) if(argv[i+1][0]!='-') strcpy(c_file,argv[++i]);
801 my_info.dr_ac=atof(argv[++i]);
804 my_info.dr_cc=atof(argv[++i]);
807 my_info.diff_rate=atoi(argv[++i]);
810 strcpy(l_file,argv[++i]);
813 strcpy(s_file,argv[++i]);
816 strcpy(r_file,argv[++i]);
819 strcpy(p_file,argv[++i]);
822 strcpy(l_file,argv[++i]);
823 if(i<argc-1) if(argv[i+1][0]!='-') c_step=atoi(argv[++i]);
826 my_info.cpi=atoi(argv[++i]);
840 if(!strcmp(s_file,""))
842 puts("NODFB defined, run with -S option");
847 if(!strcmp(r_file,"")) rand_init(NULL);
848 else rand_init(r_file);
850 if(!strcmp(l_file,""))
852 i=d3_l.max_x*d3_l.max_y*d3_l.max_z;
854 d3_lattice_init(&argc,argv,&d3_l);
856 if((d3_l.status=(unsigned char *)malloc(i*sizeof(unsigned char)))==NULL)
858 puts("failed allocating status buffer");
861 memset(d3_l.status,0,i*sizeof(unsigned char));
862 if((d3_l.extra=(int *)malloc(i*sizeof(int)))==NULL)
864 puts("failed allocating concentration buffer");
867 memset(d3_l.extra,0,i*sizeof(int));
870 load_from_file(l_file,&d3_l,&my_info);
873 if(!strcmp(c_file,"")) sprintf(c_file,"%s_gnuplot",l_file);
874 printf("converting file %s to %s\n",l_file,c_file);
875 convert_file(c_file,&d3_l);
880 else d3_lattice_init(&argc,argv,&d3_l);
885 d3_event_init(&d3_l);
889 strcpy(a_txt,"args:");
890 sprintf(s_txt,"steps: %d",my_info.steps);
891 sprintf(dose_txt,"dose: %.2fe+17 C/cm²",my_info.steps*1.0/(d3_l.max_x*d3_l.max_y*CELL_LENGTH*CELL_LENGTH*1000));
892 sprintf(r_txt,"pressure range: %d",my_info.range);
893 sprintf(ap_txt,"a_ap: %.3f b_ap: %.3f",my_info.a_ap,my_info.b_ap);
894 sprintf(el_txt,"a_el: %.3f b_el: %.3f",my_info.a_el,my_info.b_el);
895 sprintf(cd_txt,"a_cd: %.3f b_cd: %.3f",my_info.a_cd,my_info.b_cd);
896 sprintf(cp_txt,"a_cp: %.4f",my_info.a_cp);
897 sprintf(dr_ac_txt,"a/c diffusion rate: %.4f",my_info.dr_ac);
898 if(my_info.c_diff!=0) sprintf(dr_cc_txt,"c/c diffusion rate: %.4f",my_info.dr_cc);
899 else sprintf(dr_cc_txt,"c/c diffusion rate: none");
900 sprintf(zdiff_txt,"diffusion in z direction: %c",my_info.z_diff?'y':'n');
901 sprintf(diff_txt,"diffusion every %d steps",my_info.diff_rate);
902 strcpy(mode_txt,"view: a/c mode");
930 if((!strcmp(l_file,""))||(c_step))
932 if(get_c_ratio(&c_ratio,p_file,&my_info,&d3_l)!=1)
934 puts("failed calculating ratio");
938 while((i<my_info.steps) && (quit==0) && (escape==0))
940 for(j=0;j<my_info.cpi;j++)
942 x_c=get_rand(d3_l.max_x);
943 y_c=get_rand(d3_l.max_y);
944 z_c=get_rand_lgp(d3_l.max_z,my_info.a_el,my_info.b_el);
945 process_cell(&d3_l,x_c,y_c,z_c,&my_info);
947 distrib_c(&d3_l,&my_info,i,c_ratio);
951 sprintf(xyz_txt,"x: %d y: %d z: %d",x+1,y+1,z+1);
952 sprintf(status_txt,"status: %c",(*(d3_l.status+x+y*d3_l.max_x+z*d3_l.max_x*d3_l.max_y)&AMORPH)?'a':'c');
953 sprintf(conc_txt,"conc: %d",*(d3_l.extra+x+y*d3_l.max_x+z*d3_l.max_x*d3_l.max_y));
954 sprintf(steps_txt,"step: %d",i);
955 sprintf(cc_txt,"total c: %d",my_info.cc);
956 d3_lattice_draw(&d3_l,x,y,z,25,arg_v,mode,0);
959 if(i%resave==0 && strcmp(s_file,"") && resave!=0 && i!=0)
961 sprintf(s_file_tmp,"%s_%d_of_%d",s_file,i,my_info.steps);
962 save_to_file(s_file_tmp,&d3_l,&my_info);
964 printf("saved %s\n",s_file_tmp);
971 if(strcmp(s_file,""))
973 printf("saved %s\n",s_file);
974 save_to_file(s_file,&d3_l,&my_info);
978 /* allocating buffer for pressure values */
979 if((d3_l.v_ptr=malloc(d3_l.max_x*d3_l.max_y*d3_l.max_z*sizeof(unsigned char)))==NULL)
981 puts("cannot allocate buffer for pressure values");
985 calc_pressure(&d3_l,my_info.range);
986 max_extra=calc_max_extra(&d3_l);
988 while((quit==0) && (escape==0) && (nowait==0))
991 if(switchmode==0) mode=0;
992 if(switchmode==1) mode=1;
993 if(switchmode==2) mode=2;
995 sprintf(xyz_txt,"x: %d y: %d z: %d",x+1,y+1,z+1);
996 sprintf(status_txt,"status: %c",(*(d3_l.status+x+y*d3_l.max_x+z*d3_l.max_x*d3_l.max_y)&AMORPH)?'a':'c');
997 sprintf(conc_txt,"conc: %d",*(d3_l.extra+x+y*d3_l.max_x+z*d3_l.max_x*d3_l.max_y));
998 sprintf(steps_txt,"step: end");
999 sprintf(cc_txt,"total c: %d",my_info.cc);
1000 if(switchmode==0) strcpy(mode_txt,"view: a/c mode");
1001 if(switchmode==1) strcpy(mode_txt,"view: c conc mode");
1002 if(switchmode==2) strcpy(mode_txt,"view: a pressure mode");
1003 d3_lattice_draw(&d3_l,x,y,z,25,arg_v,mode,max_extra);
1005 scan_event(&d3_l,&x,&y,&z,&quit,&escape,&switchmode,&bmp);
1006 if(bmp) write_bmp(&d3_l,bmp,x,y,z);
1010 d3_lattice_release(&d3_l);