home *** CD-ROM | disk | FTP | other *** search
-
- PMAKER 1.0
- ==========
-
- a Pattern Maker for SIS
- (Single Image Stereogram)
-
- Copyright (C) Carlo Moretti (Jul) 1994
-
- email: moretti@cobra.csr.unibo.it
- or: moretti@zeus.csr.unibo.it
-
-
- PMAKER.DOC
- ==========
-
-
-
- INDEX
- =====
-
- 0 INTRODUCTION
-
- 1 HOW TO USE
- 1.0 HOW TO USE PMAKER -intro-
- 1.1 BASIC SYNTAX
- 1.2 GENERAL OPTIONS
- 1.3 HOW TO GET HELP
-
- 2 BASIC CONCEPTS - SPECIFIC OPTIONS
- 2.0 BASIC CONCEPTS -intro-
- 2.1 FEATURES
- 2.2 SIMPLE HELP FOR EACH FEATURE
- 2.2.0 STAIN
- 2.2.1 BLUR
- 2.2.2 LINE
- 2.2.3 WAVE
- 2.2.4 TUBE
- 2.2.5 RIPPLE
- 2.2.6 CIRCLE
- 2.2.7 SPOT
- 2.2.8 SPHERE
- 2.2.9 BUBBLE
- 2.2.10 SQUARE
- 2.2.11 MINE
- 2.2.12 LAKE
- 2.2.13 STAR
- 2.2.14 SKY
-
- 3 GREETINGS
- 3.0 PLEASE TAKE PART IN!!
- 3.1 THE FUTURE...
- 3.2 PLEASE, REGISTER!
- 3.3 GREETINGS
-
-
- - INTRODUCTION - - 0 -
-
-
- INTRODUCTION
- ============
-
-
- This program is the first working version of a sofware developed to
- obtain better result for SIS (Single Image Stereogram) by generating
- pattern files to 'cover' the holusions.
-
- I was tired to always see the same RDSs (Random Dots Stereograms)
- made of simple random pixels, so I wanted to innovate stereograms
- by writing this program... I hope someone likes this!
-
- The output of this program is a simple .TGA file (truecolor 24 bit,
- compressed or uncompressed) which contains the pattern to use with
- the SIS generator; obviously you need a SIS generator (like CRUMBLER)
- to see the final result on your stereograms.
-
- PMAKER 1.0 is able to generate 15 different kind of image patterns,
- by implementing geometrical, fractal and trigonometrical functions and
- uses a random color generation to obtain always different results.
-
- For each feature you have a lot of options to improve your works,
- see next chapters about.
-
-
-
- - HOW TO USE - - 1 -
-
-
- 1.0 HOW TO USE PMAKER -intro-
- =========================
-
-
- PMAKER is totally batch oriented. Every option that you require
- to use must be inserted into the dos prompt command line.
- I'm not too sure if alot of people like this layout (may forget an
- option, must remember the right syntax, etc.), anyway I choose this
- layout because you can run PMAKER inside a batch file and that I can
- also avoid writing tedious user interface that could not be nice but
- needs alot of time.
-
- Anyway, the next version of CRUMBLER will include PMAKER with a GUI.
-
- The syntax is not too hard to remember, I tried to associate a
- menmonical name for each option.
-
-
- 1.1 BASIC SYNTAX
- ============
-
-
- First, say PMAKER doesn't require an input file.
- Type at your prompt dos:
-
- > PMAKER <filename[.TGA]> <basePattern> [+<options>]
-
- - <filename> is the output .TGA file (".TGA" can be omitted)
-
- - <basePattern> is one of the 15 following features:
- stain, blur, line, wave, tube, ripple, circle, spot, sphere,
- bubble,square, mine, lake, star, sky
- (see 2.x about features)
-
- - <options> are *A LOT*! There are:
-
- - general options (these are valid for each feature)
- - specific options (for each feature there are specific options
- which design the characteristics of the pattern)
-
- All the supported options are omittable and for each option
- there's a Default value to make PMAKER easier.
-
- To see help about specific options see 2.2.x
-
-
-
- - HOW TO USE - - 1 -
-
-
- 1.2 GENERAL OPTIONS
- ===============
-
-
- General options tell PMAKER which range of colors to use and give
- the information about the output file:
-
- +xXXX horizontal resoulution (each value is right, limit is your
- conventional memory)
-
- +yXXX vertical resolution (no limits)
-
- +o tells PMAKER to overwrite an existing file;
- if omitted PMAKER stops if encounters an existing file.
-
- +rle lets PMAKER create a compressed Run LEngth .TGA file;
- if omitted the output is uncompressed.
-
- +scRRR,GGG,BBB -and-
- +ecRRR,GGG,BBB tell PMAKER the starting and ending colors for random
- color generation: PMAKER uses red values between
- scRRR and ecRRR, green between scGGG and ecGGG, etc.
-
- +tcRRR,GGG,BBB is the Top background color
- +bcRRR,GGG,BBB is the Bottom background color
- These are used only when choosen feature requires them.
-
- Each RRR, GGG, BBB are 0..255 value, so this is an example:
-
- > PMAKER out.tga sky +sc0,0,0 +ec255,255,255
-
- (+[s|e|t|b]cRRR,GGG,BBB options needs NO spaces between r,g,b colors!!)
-
-
-
- 1.3 HOW TO GET HELP
- ===============
-
-
- If you want to see PMAKER's basic help type:
-
- > PMAKER ?
-
- (this will show the general options above) and type:
-
- > PMAKER ? <basePattern>
-
- to obtain help on specific options about <basePattern>.
-
-
- - BASIC CONCEPTS - - 2 -
-
-
- 2.0 BASIC CONCEPTS -intro-
- ======================
-
-
- PMAKER is made of simple routines which make use of pseudo-fractals
- random color distribution, or mathematical simulation of interference
- between different 2D waves or random colored shapes generation.
- These routines have been simple to implement and lot of the
- patterns results are 'cylindrical', such as the right-hand side can
- be placed next to the left-hand side without appearing discontinuous.
- This is useful for SIS, in which the patterns are always placed next
- to each other.
-
- Unfortunately this feature causes a little loose in execution time.
-
- The base patterns are made of simple shapes like circles (empty,
- filled or blur), lines, 'waved lines', stars and squares or
- random color distributions (similar to plasma) or pseudo-fractal
- actractors which causes odd color patterns.
-
-
-
- 2.1 FEATURES
- ========
-
-
- There are 15 available features (as shown), but few are very similar
- in facts they differ only on the filling method.
-
- These are the base patterns available:
-
- - stain (pseudo-fractal actractors, COOL!)
- - blur (similar to plasma, VERY NICE!)
- - line (disorded and different thickness lines)
- - wave (disorded monodimensional blur waves, THE BEST!!)
- - tube (similar to wave but with a 'depth' appearance)
- - ripple (a single random-colored linear ripple)
- - circle (empty circles)
- - spot (filled circles)
- - sphere (depth effect circles)
- - bubble (blur circles)
- - square (regular flat subdivision in squares)
- - mine (similar to 'mine-sweeper' background)
- - lake (interference between 2D waves, NOT NICE FOR SIS BUT GREAT!)
- - star (four tips stars)
- - sky (random dots)
-
-
-
- - SPECIFIC OPTIONS - - 2 -
-
-
- 2.2 SIMPLE HELP FOR EACH FEATURE
- ============================
-
-
- The following helps are a simple description about the options you
- can use for each base pattern. Often the same options are valid for
- more than one base pattern, maybe only a slight difference
- in their meanings. So check the help that is avaible or use the
- PMAKER ? <pattern>
- command line to see the help commands.
-
-
-
- 2.2.0 STAIN
- =====
-
-
- This is the pseudo-fractal random actractor pattern generator.
- Specific options are:
-
- +nXXX number of random placed actractors
-
- +lXXX onion level. The rgb color values are multiplied for +l option
- and divided for 256; the remainder is used as color.
- It gives a nice 'onion' appearance to the image.
- Good values are 5..20
-
- +rMIN,MAX tells the random number generator the range of the possible
- values of the actractive ray for each actractor.
- Good values are 80-120; Max should be < +x option.
-
- This topic doesn't care about the background colors (see 1.2)
-
-
-
- 2.2.1 BLUR
- ====
-
-
- This is similar to 'plasma' fractal, but it's calculated in a easier
- way: for each <+d> pixels the function calculates a random color, then
- it fills empty pixels by averaging the closed calculated pixels.
- Specific options are:
-
- +dXXX distance between a random color and the next one
- Good values are between 1 (totally random dot) and 10.
- Higher values can make SIS loose details.
-
- This topic doesn't care about background colors (1.2)
-
-
-
- - SPECIFIC OPTIONS - - 2 -
-
-
- 2.2.2 LINE
- ====
-
-
- Creates disorded lines with different thickness.
-
- +nXXX number of lines to be draw
-
- +wMIN,MAX thickness range value
-
- This topic uses every generic options.
-
-
-
- 2.2.3 WAVE
- ====
-
-
- Similar to line topic, draws monodimensional disorded waves.
-
- +nXXX number of waves
-
- +wMIN,MAX range for thickness values
-
- +fMIN,MAX range for frequency values, floating point
-
- +aMIN,MAX range for amplitude values
-
- +pMIN,MAX range for phase values, floating point
-
- Uses every generic options.
-
-
-
- 2.2.4 TUBE
- ====
-
-
- This topic is VERY similar to the previous, but the wave borders
- fade to background color.
-
- +nXXX number of tubes
-
- +wMIN,MAX range for thickness values
-
- +fMIN,MAX range for frequency values, floating point
-
- +aMIN,MAX range for amplitude values
-
- +pMIN,MAX range for phase values, floating point
-
- Uses every generic options.
-
-
-
- - SPECIFIC OPTIONS - - 2 -
-
-
- 2.2.5 RIPPLE
- ======
-
-
- It's a simple linear wave randomly colored.
-
- +wMIN,MAX range for distance values between one random color and next
-
- +fMIN,MAX range for frequency values, floating point
-
- +aMIN,MAX range for amplitude values
-
- +pMIN,MAX range for phase values, floating point
-
- Doesn't care about background colors (1.2).
-
-
-
- 2.2.6 CIRCLE
- ======
-
-
- Draws empty circles
-
- +nXXX number of circles
-
- +rMIN,MAX range of rays values
-
- Uses every generic options.
-
-
-
- 2.2.7 SPOT
- ====
-
-
- Very similar to 'circle' topic: these are filled!
-
- +nXXX number of spots
-
- +rMIN,MAX range of rays values
-
- Uses every generic options.
-
-
- - SPECIFIC OPTIONS - - 2 -
-
-
- 2.2.8 SPHERE
- ======
-
-
- Similar to previous topic, fade the spots to background giving a
- spherical appearance.
-
- +nXXX number of spheres
-
- +rMIN,MAX range of rays values
-
- Uses every generic options.
-
-
-
- 2.2.9 BUBBLE
- ======
-
-
- Similar to previous topic, fade the spots to background after
- previous generation, giving a 'trasparency' effect.
-
- +nXXX number of bubbles
-
- +rMIN,MAX range of rays values
-
- Uses every generic options.
-
-
-
- 2.2.10 SQUARE
- ======
-
-
- Fills the image with regular randomly colored square.
-
- +dXXX side of the squares. It's better if +x option (1.2) is a
- multiple of 'side', otherwise the last column on the right
- is NOT made of squares. Good values are between 1 (RDS) and 5.
-
- Doesn't care about background colors (1.2);
-
-
-
- - SPECIFIC OPTIONS - - 2 -
-
-
- 2.2.11 MINE
- ====
-
-
- Similar to square, but embossed. 'Mine' comes from MineSweeper for
- windows: the final result is similar to a multicolored keyboard.
-
- +dXXX side of base square (2.2.10). Must be > 1.
-
- +hxxx height (prominence) in pixels. Must be < +d and > 0.
-
- Good values are +d6 +h2 or a little greater.
- This topics doesn't care about background colors (1.2).
-
-
-
- 2.2.12 LAKE
- ====
-
-
- Lake a particular base pattern. Draws interference between
- bidimensional waves. It's not good as pattern for SIS (and it's VERY
- slow too), but you can use it to generate big images, don't know,
- to use as windows background... It's not bad!
-
- +nXXX number of waves
-
- +lXXX onion level (2.0). Best value is 1, higher values changes
- colors... Experiment!
-
- +rMIN,MAX range for ray of influence values (experiment!)
-
- +fMIN,MAX range for frequency values, floating point.
- Good values: 0.5 - 10.0
-
- Doesn't care about background colors.
-
-
-
- 2.2.13 STAR
- ====
-
-
- Fill the background with stars. The stars tips fade to background.
- Best results for black background and bright stars.
-
- +nXXX number of stars (good values: 100..2000)
-
- +wMIN,MAX range of lenghts for stars tips (good values: 5-10)
-
- Uses every generic options.
-
-
-
- - SPECIFIC OPTIONS - - 2 -
-
-
- 2.2.14 SKY
- ===
-
-
- Simply fills the background with random pixels.
- Gives quite good results for SIS. Pretty cool!
-
- +nXXX number of active pixels (don't exager... it's quite slow!)
-
- Obviously uses every generic options.
-
-
-
- - GREETINGS - - 3 -
-
-
- 3.0 PLEASE TAKE PART IN!!
- =====================
-
-
- As this program is SHAREWARE, you are encouraged to register it
- (see below) and if you would like to suggest any new ideas,
- algorithms or anything new, please don't hesitate to mail me!.
- You can ALSO mail me new ideas about PMAKER also if you don't
- register it!
-
- Please contact me for any bug you find or you think you have found!
-
- Please send me answers, comments, suggests, [dis]approvals, insults,
- threats, or anything that turns your brain around.
-
- Please mail me too to send comments about:
-
- "batch oriented" vs. "user interface". Thanx!
-
-
-
- 3.1 THE FUTURE...
- ?????????????
-
-
- I hope someone helps me to increase the power of this proggie, so we
- can improve PMAKER with new algo and new topics.
-
- If someone is intersted i'll realize a monochrome version (not only
- black and white), anyway I have no more imagination for now...
-
-
-
-
- - GREETINGS - - 3 -
-
-
- 3.3 PLEASE, REGISTER!
- =================
-
- This program is SHAREWARE like CRUMBLER and, as they are distributed
- together, the registration form is only ONE!
-
- If you continue using this software (both CRUMBLER and PMAKER) after
- a trial evaluation period of 30 days, you are encouraged to pay a
- little registration fee.
- Check the REGISTER.DOC to file the REGISTER.FRM form to order your
- registered versions.
-
-
-
- 3.2 CREDITS
- =======
-
-
- Special thanx to Duzy Patel.
-
- Thanx to:
- Stefano Vitali, Simone Grassi and evryone else tested this prog.
- Thanx to Michelle Bishop for the cat picture.
-
-
-
- 3.3 GREETINGS
- =========
-
-
- I would like to send greetings all over the world, and hope this
- proggie could help someone...somewhere!
-
-
-
- ::::::::::::::::::::::::::::::::::::::::::::::::::::
- For whom i met via internet:
- PLEASE!! mail me at
-
- moretti@cobra.csr.unibo.it
- or
- moretti@zeus.csr.unibo.it
-
- and forget old sis2g19 or einn93_5!! Thanx!
- ::::::::::::::::::::::::::::::::::::::::::::::::::::
-
-
- '' If u wanna b free, follow a cat! ,,
-
- /\_/\
- ____ / o o \
- /~____ =°= /
- (______)__m_m_)
-
- -> Carlo Moretti <-
-
-