A S T E R O I D   G E N E R A T O R 
 
 V e r s i o n   3 . 1 
 
 F r e e w a r e   
 
 M a r s   2 5 ,   2 0 0 1 
 
 F r a n c o i s   M o u r l e v a t 
 
 h t t p : / / w w w . c h e z . c o m / m o u r l   
 
 m o u r l e v a t @ m a i l . d o t c o m . f r   
 
 = = = = = = = = = = = = = = = = = = = = = = = = =   
 
     
 
 
 
     
 
 T A B L E   O F   C O N T E N T S 
 
 = = = = = = = = = = = = = = = = = =   
 
     
 
 1 .   I n t r o d u c t i o n 
 
 2 .   C o p y r i g h t 
 
 3 .   I n s t a l l a t i o n 
 
 	 A )   P a c k a g e 
 
 	 B )   D i r e c t o r y 
 
 	 C )   L o a d i n g 
 
 	 D )   V e r s i o n 
 
 4 .   C r e a t i n g   a n   A s t e r o i d 
 
 	 A )   S h a p e 
 
 	 B )   S u r f a c e 
 
 	 C )   C r e a t i n g 
 
 	 D )   S p a c e   a r e a 
 
 	 E )   P r a c t i c a l   p r o c e e d i n g   
 
 5 .   Q u i c k   d o c u m e n t a t i o n 
 
 6 .   S u m m a r y 
 
 7 .   C o n t a c t   
 
     
 
     
 
 1 .   I N T R O D U C T I O N 
 
 = = = = = = = = = = = = = = =   
 
 
 
 W e l c o m e   t o   A s t e r o i d   G e n e r a t o r   v e r s i o n   3 . 1 .   T h i s   p r o g r a m   c o r r e s p o n d s   t o   a   s c r i p t   m a d e   f o r   3 D   M a x   3   a n d   4 .   I t   c o n s i s t s   i n   c r e a t i n g   i s o l a t e d   a s t e r o i d   o r   a s t e r o i d   f i e l d   i n   a   s p a c e   z o n e   d e f i n e d   b y   t h e   u s e r .   
 
 T h a n k s   t o   S t  p h a n e   V a n d e n b o g a r d e   f o r   t h e   a d v i c e s .   
 
     
 
 2 .   C O P Y R I G H T 
 
 = = = = = = = = = = = =   
 
 
 
 T h i s   p r o g r a m   i s   s u p p l i e d   a s   f r e e w a r e   w i t h   i t s   u n c r y p t e d   s o u r c e   c o d e .   T h e r e f o r e   i t   c a n   n o t   b e   t h e   s u b j e c t   o f   a n y   c o m m e r c i a l   t r a n s a c t i o n s .   T h a n k s   t o   i n d i c a t e   t h e   a u t h o r ' s   n a m e   o f   t h e   o r i g i n a l   c o d e   i n   c a s e   o f   m o d i f i c a t i o n s .   
 
 
 
 3 .   I N S T A L L A T I O N 
 
 = = = = = = = = = = = = = = =   
 
 
 
 A ) P a c k a g e 
 
 
 
 A s t e r o i d   G e n e r a t o r   3 . 1   i s   d e l i v e r e d   i n   F r e n c h   a n d   E n g l i s h   v e r s i o n .   
 
 H e r e   i s   t h e   d e t a i l e d   c o n t e n t s   o f   t h e   p a c k a g e :   
 
 A s t r e 3 1 . m s :   F r e n c h   v e r s i o n   o f   t h e   p r o g r a m 
 
 A s t r e 3 1 u s . m s :   E n g l i s h   v e r s i o n   o f   t h e   p r o g r a m 
 
 A s t r o . j p g :   i m a g e   o f   t h e   l o g o 
 
 R e a d m e . t x t :   i n f o r m a t i o n   (   t h i s   f i l e ) 
 
 d o c . z i p :   f u l l   d o c u m e n t a t i o n   
 
     
 
 B ) D i r e c t o r y 
 
 
 
 T o   i n s t a l l   t h e   p r o g r a m ,   j u s t   c o p y   A s t r e 3 0 . m s   o r   A s t r e 3 0 u s . m s   a c c o r d i n g   t o   t h e   c h o s e n   v e r s i o n ,   a s   w e l l   a s   A s t r o . j p g   i n   t h e   d i r e c t o r y   o f   y o u r   s c r i p t s .   B y   d e f a u l t ,   t h i s   d i r e c t o r y   i s :   c : \ 3 d s m a x 3 \ s c r i p t s \   o r   c : \ 3 d s m a x 4 \ s c r i p t s . 
 
     
 
 
 
 C )   L o a d i n g 
 
 
 
 T o   l o a d   t h e   p r o g r a m ,   c h o o s e   t h e   U t i l i t i e s   t a b   o f   t h e   c o m m a n d   p a n e l .   P r e s s   t h e   M a x s c r i p t   b u t t o n .   P r e s s   t h e   R u n   S c r i p t   B u t t o n .   A   d i a l o g   i n v i t e s   y o u   t o   l o a d   a   s c r i p t .   Y o u   c a n   c h o o s e   A s t e r o i d   G e n e r a t o r .   
 
     
 
 D ) V e r s i o n 
 
 
 
 T h e   p r o g r a m   c a n   n o t   b e   l o a d e d   f r o m   a   3 D   S t u d i o   M a x   v e r s i o n   2 . x . 
 
 I t   i s   e x c l u s i v e l y   d e d i c a t e d   t o   v e r s i o n   3   a n d   4 . 
 
     
 
 4 .   C R E A T I N G   A N   A S T E R O I D 
 
 = = = = = = = = = = = = = = = = = = = = = = = = = =   
 
 
 
 A )   S h a p e 
 
 
 
 D i s t o r t i o n :   t h i s   p a r a m e t e r   d e t e r m i n e s   t h e   d i m e n s i o n   o f   t h e   s u r f a c e   s t r e t c h i n g   o f   t h e   A s t e r o i d .   T h e   v a l u e s   g o   f r o m   0   t o   4 0 .   
 
 
 
 A s p e r i t i e s :   t h i s   p a r a m e t e r   d e t e r m i n e s   t h e   p h y s i c a l   a s p e c t   o f   t h e   s u r f a c e . 
 
 T h e   v a l u e s   g o   f r o m   0   t o   6 0 0 . 
 
 
 
 S i z e :   t h i s   p a r a m e t e r   d e t e r m i n e s   t h e   d i m e n s i o n   o f   t h e   a s t e r o i d . 
 
 V a l u e s   g o   f r o m   1 0   t o   4 0 .   
 
 
 
 I f   V a r y   S i z e   o p t i o n   i s   c h e c k e d ,   t h e   V a r y   s p i n n e r   i s   a c t i v a t e d 
 
 t o   a l l o w   t h e   c a l c u l a t i o n   o f   h e a v e n l y   b o d i e s   o f   v a r i o u s   s i z e   a c c o r d i n g   t o   t h e   v a l u e .   
 
 
 
 T h e   P e b b l e   o r   S t o n e   c h o i c e   c o r r e s p o n d s   e i t h e r   t o   r o u n d e d   o r   a n g u l a r   s h a p e s . 
 
 
 
 S p a c e   g i v e s   t h e   d i m e n s i o n   o f   t h e   f i e l d   a r e a   b o u n d   b y   a   d u m m y   c a l l e d   A s o n e .   T h e   v a l u e s   a r e   c a l i b r a t e d   f r o m   3 0 0   t o   2 0 0 0 . 
 
 
 
 D e n s i t y   a l l o w s   t o   d e t e r m i n e   t h e   d e n s i t y   o f   t h e   m e s h .   T h e   v a l u e s   g o   f r o m   1   t o   1 6 .   T h e   h i g h e r   t h e   n u m b e r ,   t h e   m o r e   t h e   e f f e c t s   o f   d i s t o r t i o n   a n d   a s p e r i t i e s   a r e   a c c u r a t e .   N o t e   t h a t   t h e   u s e   o f   m e m o r y   i s   i m p o r t a n t   a n d   c a n   s a t u r a t e   t h e   s y s t e m   w h e n   a n   a s t e r o i d   f i e l d   i s   p r o d u c e d .   T h e   h i g h e s t   r e s o l u t i o n s   a r e   r e s e r v e d   t o   c r e a t e   a n   i s o l a t e d   a s t e r o i d   f o r   w h i c h   a   p a r t i c u l a r l y   f i n e   s u r f a c e   i s   n e e d e d .   
 
     
 
 B )   S u r f a c e 
 
 
 
 C o l o r   a l l o c a t e s   a   c o l o u r   t o   t h e   m e s h   o r   m a t e r i a l s . 
 
 
 
 V a r y   c a l c u l a t e s   a   h u e   n u a n c e   f o r   e v e r y   h e a v e n l y   b o d y   o f   a   f i e l d   f r o m   t h e   c o l o r   a c c o r d i n g   t o   t h e   A m p l i t u d e   v a l u e .   T h e   A m p l i t u d e   s p i n n e r   i s   o n l y   a c t i v e   w h e n   V a r y   i s   c h e c k e d ,   t h e   v a l u e s   g o i n g   f r o m   0   t o   6 0 . 
 
   
 
 M a t e r i a l s   a l l o c a t e s   a   b u i l d i n g   m a t e r i a l   t o   e v e r y   h e a v e n l y   b o d y   o f   a   f i e l d .   W h e n   t h i s   o p t i o n   i s   c h e c k e d ,   t h e   S p l a s h   a n d   S i z e   s p i n n e r s   a r e 
 
 a c t i v a t e d ,   a l l o w i n g   t o   m o d i f y   t h e   a s p e c t   o f   t h e   b u i l d i n g   m a t e r i a l .   
 
 
 
 S p l a s h   c o r r e s p o n d s   t o   t h e   a m o u n t   o f   d a r k   z o n e s   o n   t h e   h e a v e n l y   b o d y , 
 
 v a l u e s   g o i n g   f r o m   5 0   t o   1 0 0 .   
 
 
 
 S i z e   c o r r e s p o n d s   t o   t h e   d i m e n s i o n   o f   t h e   d a r k   z o n e s , 
 
 v a l u e s   g o i n g   f r o m   1   t o   4 0 . 
 
 
 
 C )   C r e a t i n g 
 
 
 
 N a m e   a l l o w s   t o   n a m e   t h e   o b j e c t .   I n   t h e   c a s e   o f   a n   a s t e r o i d   f i e l d ,   t h e   n a m e s   a r e   a u t o m a t i c a l l y   i n c r e a s e d .   
 
 
 
 C r e a t i o n   r u n s   t h e   c r e a t i o n   o f   a n   a s t e r o i d   f i e l d .   
 
 
 
 Q u a n t i t y   d e t e r m i n e s   t h e   n u m b e r   o f   a s t e r o i d s   i n   a   f i e l d ,   f r o m   1   t o   1 0 0 .   
 
     
 
 D )   S p a c e   a r e a 
 
 
 
 W h e n   o p e n i n g   t h e   p r o g r a m ,   t h e   b l u e   d u m m y   d e t e r m i n e s   t h e   s p a c e   a r e a   i n   w h i c h   t h e   f i e l d   w i l l   b e   c o n t a i n e d .   T h e   u s e r   c a n   m o v e   i t   w h e r e   h e   w a n t s   t o   l o c a t e   t h e   f i e l d .   W h e n   t h i s   d u m m y   i s   e r a s e d ,   i t   i s   a t   o n c e   r e c r e a t e d   w i t h   a   n e w   f i e l d .   I t   i s   n o t   c a l c u l a t e d   i n   t h e   r e n d e r i n g   a n d   d i s a p p e a r s   w h e n   t h e   p r o g r a m   i s   c l o s e d . 
 
 
 
 E )   P r a c t i c a l   p r o c e e d i n g   
 
 
 
 C h o o s e   p o s s i b l e   v a l u e s   f o r   t h e   A s p e r i t i e s ,   D i s t o r t i o n   a n d   S i z e   p a r a m e t e r s .   
 
 
 
 G i v e   t h e   r e s o l u t i o n   o f   t h e   m e s h   w i t h   t h e   D e n s i t y   p a r a m e t e r .   
 
 
 
 C h o o s e   t h e   k i n d   o f   a s t e r o i d :   S t o n e   o r   P e b b l e . 
 
 
 
 A c t i v a t e   t h e   V a r y   S i z e   c h e c k b o x ,   a n d   c h o o s e   t h e   s i z e   a m p l i t u d e   o f   t h e   h e a v e n l y   b o d i e s   w i t h   t h e   V a r y   s p i n n e r . 
 
 
 
 G i v e   a   d i m e n s i o n   t o   t h e   f i e l d   s p a c e   a r e a   w i t h   t h e   S p a c e   s p i n n e r . 
 
 
 
 G i v e   a   c o l o r   a n d   c h e c k   i f   n e e d e d   t h e   o p t i o n   V a r y ;   g i v e   a   v a l u e   t o   A m p l i t u d e   t o   d e t e r m i n e   t h e   h u e   v a r i a t i o n s   o f   t h e   c e l e s t i a l   b o d i e s   o f   t h e   f i e l d .   A c t i v a t e   M a t e r i a l s   a n d   c h o o s e   t h e   S p l a s h   a n d   S i z e   v a l u e s ,   a l l o w i n g   t o   o b t a i n   m o r e   o r   l e s s   l a r g e   s p o t s .   
 
 
 
 G i v e   a   n a m e   i n   t h e   N a m e   b o x .   M o v e   i n   s p a c e   t h e   b l u e   d u m m y   w h e r e   y o u   w i s h   t o   c r e a t e   a n   a s t e r o i d   f i e l d .   G i v e   t h e   a m o u n t   o f   h e a v e n l y   b o d i e s   i n   t h e   f i e l d .   C l i c k   t h e   C r e a t i o n   b u t t o n .   
 
 
 
 C l i c k   t h e   b u t t o n   s e v e r a l   t i m e s   t o   f i l l   t h e   s p a c e   a r e a .   
 
 C h a n g e   t h e   l o c a t i o n   o f   t h e   s p a c e   a r e a   ( b l u e   d u m m y )   a n d   c l i c k   t h e   b u t t o n   h e a v e n l y   b o d i e s   C r e a t i o n   o f   a s   m a n y   t i m e   a s   n e c e s s a r y .   
 
 
 
 5 .   Q U I C K   D O C U M E N T A T I O N 
 
 = = = = = = = = = = = = = = = = = = = = = = =   
 
 
 
 A   d o c u m e n t a t i o n   i s   a v a i l a b l e   c l i c k i n g   t h e   " ? "   b u t t o n   c l o s e   t o   t h e   C r e a t i o n   b u t t o n .   
 
     
 
 6 .   S U M M A R Y 
 
 = = = = = = = = = = = = =   
 
 
 
 T h e   s t a r t i n g   u p   o f   t h i s   p r o j e c t   g o e s   b a c k   t o   A u g u s t   3 0 ,   1 9 9 8 .   V e r s i o n   1 . 0   w a s   p o s t e d   o n   t h e   M a x s c r i p t   f o r u m   o f   t h e   K i n e t i x   s i t e .   U n t i l   O c t o b e r   2 0 ,   t h e   w o r k   c h a n g e d   t o   a   1 . 6   v e r s i o n . 
 
 
 
 V e r s i o n   2 . 0   o f   D e c e m b e r   5 ,   1 9 9 8   s h o w s   i m p o r t a n t   c h a n g e s .   
 
 
 
 V e r s i o n   3   i s   d e d i c a t e d   t o   M a x   3 ,   t o t a l l y   r e w r i t t e n   f o r   t h e   n e w   r e l e a s e . 
 
 N o   p r e v i e w ,   b u t   m a t e r i a l   a d d i t i o n ,   v a r i a b l e   s i z e   f o r   t h e   h e a v e n l y   b o d i e s   i n   a   f i e l d ,   s i m p l i e r   a n d   m o r e   f u n c t i o n a l   i n t e r f a c e   a r e   t h e   m a i n   l i n e s   o f   t h i s   v e r s i o n   c h a n g e .   A u g u s t   1 2 , 1 9 9 9 . 
 
 
 
 v e r s i o n   3 . 1 ,   m a r s   2 0 0 1 ,   i s   c o m p a t i b l e   M a x   r e l e a s e   3   a n d   4 . 
 
     
 
 
 
 7 .   C O N T A C T 
 
 = = = = = = = = = =   
 
 
 
 Y o u   c a n   g e t   i n   t o u c h   w i t h   t h e   a u t h o r   o f   t h i s   p r o g r a m   f o r   b u g   r e p o r t ,   o r   s u g g e s t i o n s   w i t h   r e g a r d   t o   a   f u t u r e   v e r s i o n .   
 
 
 
 F r a n  o i s   M o u r l e v a t 
 
 C o n t a c t   f o r   b u g   r e p o r t   : 
 
 
 
 E m a i l :   m o u r l e v a t @ m a i l . d o t c o m . f r   
 
 H t t p :   w w w . c h e z . c o m / m o u r l /   
 
 T h e   W e b   s i t e   c o n t a i n s   o t h e r   f r e e w a r e   p r o g r a m s   f r o m   t h e   a u t h o r   i n   f r e e   
 
 d o w n l o a d i n g .   
 
 
 
 