TOPIC LOCATION:     `Detail Editor`;    `Object Menu (Detail)`

PRECEDING TOPIC:    `Attributes (Texture)`
FOLLOWING TOPIC:    `Transformation`

VISUAL DEMONSTRATIONS AVAILABLE:   `(D)_Brush_Map_Flat.demo`

                                   `(D)_Brush_Map_Wrap.demo`     

*    These demonstrations will show you how to wrap brushes (actually they
     are pictures) onto and around objects. The Flat demo will load
    `Colorbars.pic` and place it onto a flat, primitive plane object.
     
     The Wrap demo will load a 2 color picture of the world, `World.pic`,
     and wrap it onto a sphere to create a globe (Wrap X & Wrap Z were
     used).
                                `Globe.pic`
     
Brush
A Brush file created in a program, such as Electronic Arts' DeluxePaint
III, can be attached to an objects surface for different effects (for best
results, use high res.,16 color mode, to create the images necessary; save
the desired pattern as a brush from DeluxePaint's brush menu - consult your
DeluxePaint manual or The Buddy System for DeluxePaint III).  When one of
the four brushes is selected from the`Attributes`requester you will be
prompted to load a previously saved`IFF`brush file from disk.  The brush
info requester will then appear.  You will have to select the method for
brush mapping from one of the four options mentioned below:

     Flat X - Wraps the brush flat on the X axis.

     Flat Z - Wraps the brush flat on the Z axis.

     Wrap X - Wraps the brush by following the horizontal contour.

     Wrap Z - Wraps the brush by following the vertical contour. 

Other options include:

     Apply to Child Objects
     Applies the brush map to any other members that the current object
     is grouped with.

     Edit Axes 
     Clicking on the Edit Axes button takes you back into the `Quad-view`
     so that you can interactively position the`axis`of the brush.  This
     allows you to orient the`brush`on the surface of the object.

     Transform Axes
     Transform Axes takes you back into the`Quad-view`so that you can
     interactively transform the brush's axis.  This allows you to
     `rotate`or`scale`the object for different coverage over the surface of
     the object.

The brush file can be used in four ways:

     Color Map
     Color Map is the usual method.  The`IFF`brush will be`wrapped`onto the
     surface of the object.

     Reflect Map
     Reflect Map is used to create multi-colored objects.  Normally you can
     only specify a single color for`reflection`.  Reflect map lets an
     object `reflect`multiple colors defined by the colors in the brush.
     As an example, you can use a multi-colored stripped pattern to create
     color bands on an object.

          NOTE:  A reflect map is only visible in`trace mode`.

     Altitude Map 
     An Altitude Map allows you to define surface detail such as bumps and
     ridges.  By using an`IFF`brush the altitude map is defined by shades
     of gray.  Dark areas of the brush represent indentations in the
     surface.  White areas of the brush represent surface level.  To create
     a smooth indentation you would define in an area where the color
     gradually changes from white to black.  As an example, if the brush
     has a circular area which gradually turns to black towards the center
     creates a smooth dimple.  The relative depth of an indentation is
     determined by the size of the brush map's Y`axis`(i.e., if the brush
     axis is 10 units long a black area in the brush will create an
     indentation that is 10 units deep.

     Filter Map
     Normally you can only specify a single color filter setting.  Filter
     Map uses the colors defied in a brush to filter multiple colors.  This
     allows you to create stained glass patterns.
    
     Full Scale Value
     This is used to create fog or smoke effects. The value entered 
     controls the dissipation of color, primarily white, when the 
     Filter Map type is set for the Brush Map. The default value of 255
     causes white to completely dissipate. Lower values provide less
     complete dissipation.
 
     Repeat & Mirror
     When wrapping brushes onto a large surface such as the ground, the
     Repeat & Mirror options allow you to use the brush map as the basis
     of a pattern that will be repeated across the surface of the object.
     With Repeat activated, the brush map will, in effect, create a 
     "wallpaper" effect across the object's surface. The Mirror option 
     will mirror the brush as it is repeated across the object's surface.
     In other words, the object will reversed at every adjacent copy in
     order to create a less regular pattern.

     MAX Sequence #
     This setting controls the display of a sequence of pictures on an 
     object. You have the ability to create a "mini animation" of 
     sequencing pictures on an object by setting the filename at the
     top of the brush map requester to the first in a numbered series
     of picture files (i.e. pic.0001, pic.0002,...) The MAX Sequence #
     value sets the number of picture files in the sequence. The rules
     for this function are that you must use the "pic" name exactly for
     the individual picture filename you want to use. Each filename in
     the sequence MUST be serialized by adding the 4 DIGIT extension of
     ".0000". This effect is extremely useful for simulating an active
     picture on a Television monitor within an animation. Therefore, if
     you wanted to animate a sequence of 20 picture files on an object,
     you would have them named: pic.0001, pic.0002, ...., to pic.0020, 
     and you would set the MAX Sequence number to 0020.
