;-------------------------------------------------------------------------------------------------------------
;Notce: all media and tree files must reside in the tpMedia directory based off your main development directory.
;ie: c:\myGameProj\tpMedia
;-------------------------------------------------------------------------------------------------------------

;-------------------------------------------------------------------------------------------------------------
;Contents
;-- tpLoadEngine() ;used before all else, this sets the engines dim's
;-- tpLoadTree(filename$, COLLTYPE_geometry) :used to load a tree into the tpEngine
;-- tpUpdateEngine(tpCam) :called once per loop, updates the trees ( pass it the game camera )
;-- tpScaleTree(tree, xs#, ys#, zs#) :used to scale a tpTree, dont use standard blitz Scaleentity command on tpTree's
;-- tpTreeColor(tree, r, g, b) ;if you wish to set tpTree coloring, use this. ( notice: defaults to 255,255,255 if not called)
;-- tpDeleteTree(tree) :if you wish to correctly remove a tpTree from your map use this call
;-- tpUnloadEngine() :unloads the entire tpEngine including all trees and resources, call this when map clearing
;-------------------------------------------------------------------------------------------------------------

;-------------------------------------------------------------------------------------------------------------
;Usage
;tpLoadEngine() ;--- Notice this must be called first
;tree=tpLoadtree(treefilename$, collision type)
;PositionEntity tree, 100,0,50
;tpScaleTree(tree, x#, y#, z# )
;..
;;main loop
;repeat
;tpUpadeEngine(camera)
;updateworld()
;renderworld()
;flip()
;forever
;..
;tpUnloadEngine()
;End
;-------------------------------------------------------------------------------------------------------------

;-------------------------------------------------------------------------------------------------------------
;Notes:
;v1.0 released
; - created user definable tree editor
; - improved load times as trees no longer load on startup
; - optimized the cache routines, quads released on Kill()
;-------------------------------------------------------------------------------------------------------------

;-------------------------------------------------------------------------------------------------------------
;( User settings )
Global tpMaxTrees=1 ;-- set this to the max number of trees your map will contain
Global tpLodRange#=60 ;-- when the tree exeedes this range the billboard model is dispalyed
Global tpMaxRange#=340 ;-- when the camera exceedes this range the tree is turned off completely
Global tpProngAnimation=True ;-- set to true or false, true allows prong( leaf) animations to occer
Global tpBranchAnimation=True ;-- set to true or false, true allows the branches to animate

;force settings
Global tpProngSpeed#=3.3 ;-- set value for speed at which prongs will animatie
Global tpBranchSpeed#=.30 ;-- set value for speed at which branches will animatie
Global tpProngForce#=7.0 ;-- set value for the overall force(distance) the prongs will sway to.
Global tpBranchForce#=1.7 ;-- set valuse for the overall force(distance) the branches will sway to.

;misc prong settings
Global tpProngRandomShading=True ;-- if True, prongs will recieve a mild shade factor to adjust for tiling effects
Global tpProngFullBright=True ;-- If True, prongs willbe set to fullbright relying upon tpTreeColor(tree, r, g, b) for color/lighting effects.
;-------------------------------------------------------------------------------------------------------------