=== Jury-Rigged BJP Tools ===

Modified Quake Map Compiler based on Tools by Bengt Jardrup
[ http://user.tninet.se/~xir870k/ ]

Detail- and Hint-Brush code based on Quest-Ed Tools by Alexander Malmberg.

This readme covers only newly added features - for information about basic
usage please refer to the readme_TxQBSP.txt, readme_WVis.txt and
readme_VisLight.txt files.

Feel free to send inquiries / bug reports to < rebb@voidspark.net >



=== ChangeLog

v1.2.4 ( June 9th 2014 )

QBSP

* Support for BSP2 format

  Compiling to BSP2 can be forced using new -bsp2 switch, otherwise
  BSP2 output will be chosen automatically if BSP29 limits are exceeded.

* New switches ( see documentation )

  -maxnodesize [n]
  -portalacc [n]
  -nodetail

* func_detail now handled properly during -onlyents compile
* func_detail intersecting water no longer causes problems when watervis
  is enabled
* additional HOM countermeasures

VIS

* Support for BSP2 format
* additional HOM countermeasures
* fixed a problem in sound pvs calculation

LIGHT

* Support for BSP2 format



=== Documentation

--- QBSP ---

Switches :

-bsp2

  Force BSP2 format output.
  If not supplied, the format is chosen automatically as needed.

-maxnodesize [n]

  Force simpler BSP split heuristic when node size exceeds value in any
  dimension. Can have positive effect on Vis compilation times.

  Enabled by default ( 1024 ), set to less than 64 to disable.

-portalacc [n]

  Setting this to 1 causes portal-file information to be written with higher
  definition values than normal.  

-nodetail

  Treat detail-brushes like worldspawn. Effectively disabled detail brushes.

-noclipmerge

  Disables merging of surfaces during clipping-hull creation.

-splitaxisratio [n]

  Used during BSP heuristic phase.
  Affects placement of bsp splits / portals.
  Suggested values : 1, 2 ( default )

-normalizesplitbounds

  Used during BSP heuristic phase.
  Affects placement of bsp splits / portals.

-forcegoodtree

  ( Use not recommended )
  Forces creation of a "full" BSP Tree in all stages, which can help
  lower marksurface counts slightly in some cases, increase them in others,
  or cause leaks. Use generally not recommended ;)



=== Additional Information

--- DETAIL BRUSHES ---

Detail brushes behave like standard brushes without adding to Vis compilation
complexity - which can greatly reduce calculation times.

- USAGE -

Turn brushes into either "am_detail" or "func_detail" brush-entities.

Only brushes that are unlikely to have any sizable impact on visibility should
be turned into detail-brushes. Things like crates, pipes, barrels, teapots
or bunnies are prime candidates for this ( this does not mean that you
should overdo it with details ).


--- HINT BRUSHES ---

Hint brushes are a special type of brush which allows finer control over
Vis-Portal placement. By using them it is possible to manually
place vis-portals, which can improve the quality of the final visibility
information.

- USAGE -

Apply the "hint" texture to any side of a brush where you want a vis-portal
to be placed.

!!! Important !!!
The remaining sides of the same brush must be textured using the "hintskip"
texture, to avoid unnecessarily placed portals.

Both a "hint" and "hintskip" texture are provided in the hintskip.wad which
comes with this package.

There are various hint-brush related tutorials available for game-engines
closely related to Quake. Those largely apply for this implementation as well.

[ https://developer.valvesoftware.com/wiki/Hint_brush ]



Special thanks to :
	id Software
	Bengt 'aguirre' Jardrup
	Alexander Malmberg
	Forest 'LordHavoc' Hale
	neg 'negke' ke
	Maik 'mfx' Badtke
	Hrimfaxi
	

Original TxQBSP by Bengt Jardrup :
[ http://user.tninet.se/~xir870k/ ]
[ http://quakeone.com/119496-post103.html ]

Original WVis by Willem :
[ http://www.celephais.net/board/view_thread.php?id=60365 ]
[ http://www.quaketastic.com/upload/files/tools/windows/misc/WVis.zip ]
[ http://quakeone.com/files/9-mapping-developer-server-admin-tools/110-wvis_20100119-7z/ ]

Quest-Ed by Alexander Malmberg :
[ http://quest-ed.sourceforge.net/ ]