Panda3D Manual: List of All Config Variables
<<prev | top | next>> |
The following is a complete list of config variables as of Aug, 2007. It was generated by typing this into Python:
    ConfigVariableManager.getGlobalPtr().listVariables()
Bear in mind that this list includes configuration parameters that control functionality that isn't fully implemented yet. Ie, not all of these config variables are as useful as they sound. You can use this command yourself in case this list gets out of date. allow-collider-multiple bool default value = 0 Set this true to enable the use of a DoubleBitMask or QuadBitMask to manage many colliders added to a single traverser in one pass. If this is false, a one-word BitMask is always used instead, which is faster per pass, but may require more passes. allow-incomplete-render bool default value = 0 When this is true, the frame may be rendered even if some of the geometry in the scene has been paged out. The nonresident geometry will be rendered as soon as it can be paged back in, which may be several frames in the future. When this is false, geometry is always paged in when needed, holding up the frame render if necessary. allow-nonpipeline-threads bool default value = 0 This variable should only be set true for debugging or development purposes. When true, the threading-model variable may specify a threaded pipeline mode, even if pipelining is not compiled in. This will certainly result in erroneous behavior, and quite likely will cause a crash. Do not set this unless you know what you are doing. allow-portal-cull bool default value = 0 Set this true to enable portal clipping. This will enable the renderer to cull more objects that are clipped if not in the current list of portals. This is still somewhat experimental. allow-unrelated-wrt bool default value = 1 Set this true to allow unrelated NodePaths (that is, nodes which have no common ancestor) to be adjusted relative to each other. If true, these will be treated as if they had a common node above their top nodes. alpha-bits int default value = 0 The minimum number of alpha buffer bits requested. alpha-scale-via-texture bool default value = 1 When this is true, Panda will try to implement ColorScaleAttribs that affect alpha by creating an additional Texture layer over the geometry with a uniform alpha scale applied everywhere, if there is at least one available Texture slot available on the multitexture pipeline. Set this false to avoid this trickery, so that texturing is only enabled when the application specifically enables it. See also color-scale-via-lighting. anim-blend-type enum default value = normalized_linear The default blend type to use for blending animations between frames, or between multiple animations. See interpolate-frames, and also PartBundle::set_anim_blend_flag() and PartBundle::set_frame_blend_flag(). assert-abort bool default value = 0 Set this true to trigger a core dump and/or stack trace when the first assertion fails asynchronous-clients bool default value = 1 audio-active bool default value = 1 audio-cache-limit int default value = 15 The number of sounds in the cache. audio-dls-file filename default value = Specifies a DLS file that defines an instrument set to load for MIDI file playback. If this is not specified, the sound interface will try to use the system default DLS file, if one is available; the likely success of this depends on the operating system. audio-library-name string default value = fmod_audio audio-output-bits int default value = 16 audio-output-channels int default value = 2 audio-output-rate int default value = 22050 audio-play-midi bool default value = 1 audio-play-mp3 bool default value = 1 audio-play-wave bool default value = 1 audio-software-midi bool default value = 1 audio-volume double default value = 1 auto-break-cycles bool default value = 1 Set this true to automatically detect and break reference-count cycles in the TransformState and RenderState caches. When this is false, you must explicitly call TransformState.clear_cache() from time to time to prevent gradual memory bloat. auto-flip bool default value = 0 This indicates the initial setting of the auto-flip flag. Set it true to cause render_frame() to flip all the windows before it returns (in single-threaded mode only), or false to wait until an explicit call to flip_frame() or the next render_frame(). Setting it true gets more immediate response time, while setting it false can get a better frame rate as more is achieved in parallel with the graphics card. auto-generate-mipmaps bool default value = 0 Set this true to use the hardware to generate mipmaps automatically in all cases, if supported. Set it false to generate mipmaps in software when possible. This is false by default because some drivers (Intel) seem to do a poor job of generating mipmaps when needed. average-frame-rate-interval double default value = 1 See ClockObject::set_average_frame_rate_interval(). back-buffers int default value = 1 The default number of back buffers requested. background-color double default value = 0.41 0.41 0.41 Specifies the rgb(a) value of the default background color for a new window or offscreen buffer. bam-endian enum default value = littleendian The default endianness to use for writing major numeric data tables to bam files. This does not affect all numbers written to bam files, only those for which the individual object was designed to support this flag. The default is "native"; you may set it to "littleendian" or "bigendian" to target a particular platform. bam-texture-mode enum default value = relative Set this to specify how textures should be written into Bam files.See the panda source or documentation for available options. bmp-bpp int default value = 0 This controls how many bits per pixel are written out for BMP files. If this is zero, the default, the number of bits per pixel is based on the image. bounds-type enum default value = sphere Specify the type of bounding volume that is created automatically by Panda to enclose geometry. Use 'sphere' or 'box', or use 'best' to let Panda decide which is most appropriate. cache-report bool default value = 0 cache-report-interval double default value = 5 clip-plane-cull bool default value = 1 This is normally true; set it false to disable culling of objects that are completely behind one or more clip planes (primarily useful for debugging). clock-degrade-factor double default value = 1 In degrade clock mode, returns the ratio by which the performance is degraded. A value of 2.0 causes the clock to be slowed down by a factor of two (reducing performance to 1/2 what would be otherwise). See ClockObject::set_degrade_factor(). clock-frame-rate double default value = 1 In non-real-time clock mode, sets the number of frames per second that we should appear to be running. In forced mode or limited mode, sets our target frame rate. In normal mode, this has no effect. See ClockObject::set_frame_rate(). clock-mode enum default value = normal Specifies the mode of the global clock. The default mode, normal, is a real-time clock; other modes allow non-real-time special effects like simulated reduced frame rate. See ClockObject::set_mode(). collect-tcp bool default value = 0 Set this true to enable accumulation of several small consecutive TCP datagrams into one large datagram before sending it, to reduce overhead from the TCP/IP protocol. See Connection::set_collect_tcp() or SocketStream::set_collect_tcp(). collect-tcp-interval double default value = 0.2 color-bits int default value = 0 The minimum number of color buffer bits requested. color-scale-via-lighting bool default value = 1 When this is true, Panda will try to implement ColorAttribs and ColorScaleAttribs using the lighting interface, by creating a default material and/or an ambient light if necessary, even if lighting is ostensibly disabled. This avoids the need to munge the vertex data to change each vertex's color. Set this false to avoid this trickery, so that lighting is only enabled when the application specifically enables it. See also alpha-scale-via-texture. compose-componentwise bool default value = 1 Set this true to perform componentwise compose and invert operations when possible. If this is false, the compositions are always computed by matrix. compress-chan-quality int default value = 95 The quality level is an integer number that generally ranges between 0 and 100, where smaller numbers indicate greater compression at the cost of quality, and larger numbers indicate higher quality but less compression. Generally, 95 is the highest useful value; values between 95 and 100 produce substantially larger, but not substantially better, output files. This is akin to the JPEG compression level. compress-channels bool default value = 0 Set this true to enable lossy compression of animation channels when writing to the bam file. This serves to reduce the size of the bam file only; it does reduce the memory footprint of the channels when the bam file is loaded. compressed-textures bool default value = 0 Set this to true to compress textures as they are loaded into texture memory, if the driver supports this. Specifically, this changes the meaning of set_compression(Texture::CM_default) to Texture::CM_on. connect-triangle-strips bool default value = 1 Set this true to send a batch of triangle strips to the graphics card as one long triangle strip, connected by degenerate triangles, or false to send them as separate triangle strips with no degenerate triangles. On PC hardware, using one long triangle strip may help performance by reducing the number of separate graphics calls that have to be made. coordinate-system enum default value = zup_right The default coordinate system to use throughout Panda for rendering, user input, and matrix operations, unless specified otherwise. copy-texture-inverted bool default value = 0 Set this true to indicate that the GSG in use will invert textures when it performs a framebuffer-to-texture copy operation, or false to indicate that it does the right thing. If this is not set, the default behavior is determined by the GSG's internal logic. cull-bin list gui-popup 60 unsorted (from /d/panda3d-a/built/etc/Confauto.prc) Creates a new cull bin by name, with the specified properties. This is a string in three tokens, separated by whitespace: 'bin_name sort type'. cursor-filename filename default value = cursor-hidden bool default value = 0 dc-multiple-inheritance bool default value = 1 Set this true to support multiple inheritance in the dc file. If this is false, the old way, multiple inheritance is not supported, but field numbers will be numbered sequentially, which may be required to support old code that assumed this. dc-sort-inheritance-by-file bool default value = 1 This is a temporary hack. This should be true if you are using version 1.42 of the otp_server.exe binary, which sorted inherited fields based on the order of the classes within the DC file, rather than based on the order in which the references are made within the class. dc-virtual-inheritance bool default value = 1 Set this true to support proper virtual inheritance in the dc file, so that diamond-of-death type constructs can be used. This also enables shadowing (overloading) of inherited method names from a base class. decompressor-step-time double default value = 0.1 Specifies the maximum amount of time that should be consumed by a single call to Decompressor::run(). default-converge double default value = 25 The default convergence distance for stereo cameras. default-far double default value = 1000 The default far clipping distance for all cameras. default-fov double default value = 30 The default field of view in degrees for all cameras. This is defined as a min_fov; that is, it is the field-of-view for the smallest of the X and Y sizes of the window, which is usually the vertical field of view (windows are usually wider than they are tall). For a 4x3 window, 30 degrees vertical is roughly 40 degrees horizontal. default-iod double default value = 0.2 The default interocular distance for stereo cameras. default-keystone double default value = 0 The default keystone correction, as an x y pair, for all cameras. default-lod-type enum default value = pop Set this to either 'pop' or 'fade' to determine the type of LODNode that is created by LODNode::make_default_lod(). default-model-extension string default value = This specifies the filename extension (with leading dot) that should be assumed if an attempt is made to load a filename that has no extension. This is primarily designed to support legacy code that used the now-deprecated implicit-extension feature of Panda's loader; new code should probably give the correct name for each model file they intend to load. default-near double default value = 1 The default near clipping distance for all cameras. default_max_angular_dt double default value = 0.0333333 default_max_linear_dt double default value = 0.0333333 default_noise_force_seed int default value = 665 default_terminal_velocity double default value = 400 depth-bits int default value = 0 The minimum number of depth buffer bits requested. depth-offset-decals bool default value = 0 Set this true to allow decals to be implemented via the advanced depth offset feature, if supported, instead of via the traditional (and slower) two-pass approach. This is false by default because it appears that many graphics drivers have issues with their depth offset implementation. detect-graph-cycles bool default value = 1 Set this true to attempt to detect cycles in the scene graph (e.g. a node which is its own parent) as soon as they are made. This has no effect in NDEBUG mode. display-list-animation bool default value = 0 Set this true to allow the use of OpenGL display lists for rendering animated geometry (when the geometry is animated by the hardware). This is not on by default because there appear to be some driver issues with this on my FireGL T2, but it should be perfectly doable in principle, and might get you a small performance boost. display-lists bool default value = 0 Set this true to allow the use of OpenGL display lists for rendering static geometry. On some systems, this can result in a performance improvement over vertex buffers alone; on other systems (particularly low-end systems) it makes little to no difference. On some systems, using display lists can actually reduce performance. This has no effect on DirectX rendering or on dynamic geometry (e.g. soft-skinned animation). downloader-byte-rate int default value = 3600 We'd like this to be about 1 second worth of download assuming a 28.8Kb connection (28.8Kb / 8 = 3600 bytes per second). downloader-disk-write-frequency int default value = 4 How often we write to disk is determined by this ratio which is relative to the downloader-byte-rate (e.g. if disk-write-ratio is 4, we will write every 4 seconds if the frequency is 0.2) downloader-frequency double default value = 0.2 Frequency of download chunk requests in seconds (or fractions of) (Estimated 200 msec round-trip to server). downloader-timeout int default value = 15 downloader-timeout-retries int default value = 5 drive-forward-speed double default value = 20 drive-horizontal-center double default value = 0 drive-horizontal-dead-zone double default value = 0.1 drive-horizontal-ramp-down-time double default value = 0 drive-horizontal-ramp-up-time double default value = 0 drive-reverse-speed double default value = 10 drive-rotate-speed double default value = 80 drive-vertical-center double default value = 0 drive-vertical-dead-zone double default value = 0.1 drive-vertical-ramp-down-time double default value = 0 drive-vertical-ramp-up-time double default value = 0 early-random-seed bool default value = 0 Configure this true to compute the SSL random seed early on in the application (specifically, when the libpandaexpress library is loaded), or false to defer this until it is actually needed (which will be the first time you open an https connection or otherwise use encryption services). You can also call HTTPClient::initialize_ssl() to do this when you are ready. The issue is that on Windows, OpenSSL will attempt to randomize its seed by crawling through the entire heap of allocated memory, which can be extremely large in a Panda application, especially if you have already opened a window and started rendering; and so this can take as much as 30 seconds or more. For this reason it is best to initialize the random seed at startup, when the application is still very small. egg-accept-errors bool default value = 1 When this is true, certain kinds of recoverable errors (not syntax errors) in an egg file will be allowed and ignored when an egg file is loaded. When it is false, only perfectly pristine egg files may be loaded. egg-alpha-mode enum default value = blend Specifies the alpha mode to apply when the alpha specification "on" appears in the egg file (or when a primitive is implicitly transparent, because of a <RGBA> that involves a non-unity alpha, or because of a four-channel texture. egg-combine-geoms bool default value = 0 Set this true to combine sibling GeomNodes into a single GeomNode, when possible. This usually shouldn't be necessary, since the egg loader does a pretty good job of combining these by itself. egg-consider-fans bool default value = 0 Set this true to enable the egg mesher to consider making triangle fans out of triangles that are connected at a common vertex. This may help if your scene involves lots of such connected triangles, but it can also make the overall stripping less effective (by interfering with triangle strips). egg-coordinate-system enum default value = default egg-coplanar-threshold double default value = 0.01 The numerical threshold below which polygons are considered to be coplanar. Determined empirically. egg-emulate-bface bool default value = 0 When this is true, the bface flag applied to a polygon will cause two different polygons to be created, back-to-back. When it is false, a single polygon will be created with the two_sided flag set on it. egg-flat-shading bool default value = 0 Set this true to allow the egg loader to create geometry with the ShadeModelAttrib::M_flat attribute set. It will do this only for geometry that has per-polygon normals and/or colors. This allows the egg loader to avoid duplicating vertices when they are shared between connect polygons with different normals or colors, but it prevents the flat-shaded geometry from being combined with any adjacent smooth-shaded geometry (for instance, as the result of a flatten_strong operation). It is false by default, since flat-shaded geometry is rare; but you may wish to set it true if your scene largely or entirely consists of flat-shaded polygons. egg-flatten bool default value = 1 This is normally true to flatten out useless nodes after loading an egg file. Set it false if you want to see the complete and true hierarchy as the egg loader created it (although the extra nodes may have a small impact on render performance). egg-flatten-radius double default value = 0 This specifies the minimum cull radius in the egg file. Nodes whose bounding volume is smaller than this radius will be flattened tighter than nodes larger than this radius, to reduce the node count even further. The idea is that small objects will not need to have their individual components culled separately, but large environments should. This allows the user to specify what should be considered "small". Set it to 0.0 to disable this feature. egg-ignore-decals bool default value = 0 egg-ignore-filters bool default value = 0 egg-ignore-mipmaps bool default value = 0 egg-load-classic-nurbs-curves bool default value = 0 When this is true (and the above is also true), a <NurbsCurve> entry appearing in an egg file will load a ClassicNurbsCurve object instead of the default, a NurbsCurve object. This only makes a difference when the NURBS++ library is available, in which case the default, NurbsCurve, is actually a NurbsPPCurve object. egg-load-old-curves bool default value = 1 When this is true, a <NurbsCurve> entry appearing in an egg file will load as a NurbsCurve or ClassicNurbsCurve object (see below). When this is false, it will load a RopeNode instead, which uses the new NurbsCurveEvaluator interface. egg-max-indices int default value = 65535 Specifies the maximum number of vertex indices that will be added to any one GeomPrimitive by the egg loader. egg-max-tfan-angle double default value = 40 The maximum average angle per triangle to allow in a triangle fan. If triangles are larger than this--that is, more loosely packed--then we figure a triangle strip is likely to do a more effective job than a triangle fan, and the fan maker leaves it alone. egg-max-vertices int default value = 65535 Specifies the maximum number of vertices that will be added to any one GeomVertexData by the egg loader. egg-mesh bool default value = 1 Set this true to convert triangles and higher-order polygons into triangle strips and triangle fans when an egg file is loaded or converted to bam. Set this false just to triangulate everything into independent triangles. egg-min-tfan-tris int default value = 4 The minimum number of triangles that must be involved in order to generate a triangle fan. Fewer than this is just interrupting a triangle strip. egg-normal-scale double default value = 1 egg-path search-path The search path along which only egg files are searched. Generally, you should use model-path instead of egg-path. egg-retesselate-coplanar bool default value = 0 If this is true, the egg loader may reverse the tesselation direction of a single pair of planar triangles that share the same properties, if that will help get a better triangle strip. In some rare cases, doing so can distort the UV's on a face; turning this off should eliminate that artifact (at the cost of less-effective triangle stripping). egg-rigid-geometry bool default value = 0 Set this true to create rigid pieces of an animated character as separate static nodes, or false to leave these in with the parent node as vertex-animated geometry. Setting this true means less geometry has to be vertex-animated, but there will tend to be more separate pieces. egg-show-normals bool default value = 0 egg-show-qsheets bool default value = 0 Set this true to color each quadsheet a random color, so you can visually observe the quadsheet algorithm. egg-show-quads bool default value = 0 Set this true to color each detected quad a random color, so you can visually observe the algorithm that unifies pairs of triangles into quads (prior to generating triangle strips). egg-show-tstrips bool default value = 0 Set this true to color each triangle strip a random color, with the leading triangle a little bit darker, so you can visually observe the quality of the triangle stripping algorithm. egg-subdivide-polys bool default value = 1 This is obsolete. In the old Geom implementation, it used to be true to force higher-order polygons that were not otherwise meshed to be subdivided into triangles. In the new Geom implementation, this happens anyway. egg-support-old-anims bool default value = 1 Set this true to support loading of old character animation files, which had the convention that the order "phr" implied a reversed roll. egg-suppress-hidden bool default value = 0 When this is true, objects flagged as "hidden" with the visibility scalar are not created at all. When false, these objects are created, but initially stashed. egg-unify bool default value = 1 When this is true, then in addition to flattening the scene graph nodes, the egg loader will also as many Geoms as possible within a given node into a single Geom. This has theoretical performance benefits, especially on higher-end graphics cards, but it also slightly slows down egg loading. egg-unroll-fans bool default value = 1 Set this true to allow the egg loader to convert weak triangle fans--triangles that share the same vertex but aren't connected enough to justify making a triangle fan primitive from them--into a series of zig-zag triangles that can make a triangle strip that might connect better with its neighbors. even-animation bool default value = 0 When this is true, characters' vertices will be recomputed every frame, whether they need it or not. This will tend to balance out the frame rate so that it is more uniformly slow. The default is to compute vertices only when they need to be computed, which can lead to an uneven frame rate. exclude-texture-scale list This is a list of glob patterns for texture filenames (excluding the directory part of the filename, but including the extension); for instance, 'digits_*.png'. Any texture filenames that match one of these patterns will not be affected by max-texture-dimension or texture-scale. expected-ssl-server list extractor-step-time double default value = 0.1 Specifies the maximum amount of time that should be consumed by a single call to Extractor::step(). fake-texture-image string default value = Set this to enable a speedy-load mode in which you don't care what the world looks like, you just want it to load in minimal time. This causes all texture loads via the TexturePool to use the same texture file, which will presumably only be loaded once. fake-view-frustum-cull bool default value = 0 Set this true to cause culling to be performed by rendering the object in red wireframe, rather than actually culling it. This helps make culling errors obvious. fft-error-threshold double default value = 0.2 fft-exponent double default value = 4 fft-factor double default value = 0.1 fft-offset double default value = 0.001 flatten-collision-nodes bool default value = 0 Set this true to allow NodePath::flatten_medium() and flatten_strong() to combine multiple CollisionNodes into a single CollisionNode--but only if they share the same name and collide masks. When false, CollisionNodes are never combined. This is false by default, since collision tests rely heavily on bounding volume tests to be efficient, and combining CollisionNodes is likely to merge bounding volumes inappropriately. fmod-number-of-sound-channels int default value = 128 Guarantee this many channels you will have with FMOD. AKA the max number of sounds you can play at one time. fmod-use-surround-sound bool default value = 0 Determines if an FMOD Flavor of PANDA use 5.1 Surround Sound or Not. frame-rate-meter-layer-sort int default value = 1000 frame-rate-meter-scale double default value = 0.05 frame-rate-meter-side-margins double default value = 0.5 frame-rate-meter-text-pattern string default value = %0.1f fps frame-rate-meter-update-interval double default value = 1.5 framebuffer-alpha bool default value = 1 True if FM_alpha should be added to the default framebuffer properties, which requests an alpha channel if possible. framebuffer-depth bool default value = 1 True if FM_depth should be added to the default framebuffer properties, which requests a depth buffer. framebuffer-hardware bool default value = 1 True if FM_hardware should be added to the default framebuffer properties, which requests a hardware-accelerated display. framebuffer-mode string default value = No longer has any effect. Do not use. framebuffer-multisample bool default value = 0 True if FM_multisample should be added to the default framebuffer properties, which requests a multisample-capable display, if possible. This can be used to implement full-screen antialiasing. framebuffer-software bool default value = 0 True if FM_software should be added to the default framebuffer properties, which requests a software-only display. framebuffer-stencil bool default value = 0 True if FM_stencil should be added to the default framebuffer properties, which requests an stencil buffer if possible. framebuffer-stereo bool default value = 0 True if FM_stereo should be added to the default framebuffer properties, which requests a stereo-capable display, if supported by the graphics driver. fullscreen bool default value = 0 game-server-timeout-ms int default value = 20000 This represents the amount of time to block waiting for the TCP connection to the game server. It is only used when the connection method is NSPR. geom-cache-min-frames int default value = 1 Specifies the minimum number of frames any one particular object will remain in the geom cache, even if geom-cache-size is exceeded. geom-cache-size int default value = 5000 Specifies the maximum number of entries in the cache for storing pre-processed data for rendering vertices. This limit is flexible, and may be temporarily exceeded if many different Geoms are pre-processed during the space of a single frame. hardware-animated-vertices bool default value = 0 Set this true to allow the transforming of soft-skinned animated vertices via hardware, if supported, or false always to perform the vertex animation via software within Panda. If you have a card that supports this, and your scene does not contain too many vertices already, this can provide a performance boost by offloading some work from your CPU onto your graphics card. It may also help by reducing the bandwidth necessary on your computer's bus. However, in some cases it may actually reduce performance. hardware-point-sprites bool default value = 1 Set this true to allow the use of hardware extensions when rendering perspective-scaled points and point sprites. When false, these large points are always simulated via quads computed in software, even if the hardware claims it can support them directly. http-client-certificate-filename filename default value = This provides a default client certificate to offer up should an SSL server demand one. The file names a PEM-formatted file that includes a public and private key specification. A connection-specific certificate may also be specified at runtime on the HTTPClient object, but this will require having a different HTTPClient object for each differently-certificated connection. http-client-certificate-passphrase string default value = This specifies the passphrase to use to decode the certificate named by http-client-certificate-filename. http-connect-timeout double default value = 10 This is the default amount of time to wait for a TCP/IP connection to be established, in seconds. http-direct-hosts string default value = This specifies the default value for HTTPClient::set_direct_host_spec(). It is a semicolon-delimited list of host names that do not require a proxy. See set_direct_host_spec() for more information. http-max-connect-count int default value = 10 This is the maximum number of times to try reconnecting to the server on any one document attempt. This is just a failsafe to prevent the code from attempting runaway connections; this limit should never be reached in practice. http-proxy string default value = This specifies the default value for HTTPClient::set_proxy_spec(). It is a semicolon-delimited list of proxies that we use to contact all HTTP hosts that don't specify otherwise. See set_proxy_spec() for more information. http-proxy-tunnel bool default value = 0 This specifies the default value for HTTPChannel::set_proxy_tunnel(). If this is true, we will tunnel through a proxy for all connections, instead of asking the proxy to serve documents normally. http-proxy-username string default value = This specifies a default username:password to pass to the proxy. http-timeout double default value = 20 This is the default amount of time to wait for the HTTP server (or proxy) to finish sending its response to our request, in seconds. It starts counting after the TCP connection has been established (http_connect_timeout, above) and the request has been sent. http-try-all-direct bool default value = 1 This specifies the default value for HTTPClient::set_try_all_direct(). If this is true, a direct connection will always be attempted after an attempt to connect through a proxy fails. http-username list Adds one or more username/password pairs to all HTTP clients. The client will present this username/password when asked to authenticate a request for a particular server and/or realm. The username is of the form server:realm:username:password, where either or both of server and realm may be empty, or just realm:username:password or username:password. If the server or realm is empty, they will match anything. icon-filename filename default value = img-header-type enum default value = short IMG format is just a sequential string of r, g, b bytes. However, it may or may not include a "header" which consists of the xsize and the ysize of the image, either as shorts or as longs. Specify that with this variable, either 'short', 'long', or 'none' for no header at all (in which case you should also set img-size). img-size int default value = 0 If an IMG file without a header is loaded (e.g. img-header-type is set to 'none', this specifies the fixed x y size of the image. inactivity-timeout double default value = 0 interpolate-frames bool default value = 0 Set this true to interpolate character animations between frames, or false to hold each frame until the next one is ready. This can also be changed on a per-character basis with PartBundle::set_frame_blend_flag(). interrogatedb-path search-path The search path for interrogate's *.in files. interval-precision double default value = 1000 Set this to the default value for set_precision() for each CMetaInterval created. jpeg-quality int default value = 95 Set this to the quality percentage for writing JPEG files. 95 is the highest useful value (values greater than 95 do not lead to significantly better quality, but do lead to significantly greater size). keep-temporary-files bool default value = 0 Set this true to keep around the temporary files from downloading, decompressing, and patching, or false (the default) to delete these. Mainly useful for debugging when the process goes wrong. keep-texture-ram bool default value = 0 Set this to true to retain the ram image for each texture after it has been prepared with the GSG. This will allow the texture to be prepared with multiple GSG's, or to be re-prepared later after it is explicitly released from the GSG, without having to reread the texture image from disk; but it will consume memory somewhat wastefully. load-file-type list egg pandaegg (from /d/panda3d-a/built/etc/Confauto.prc) p3ptloader (from /d/panda3d-a/built/etc/Confauto.prc) List the model loader modules that Panda will automatically import when a new, unknown model type is loaded. This may be either the name of a module, or a space-separate list of filename extensions, followed by the name of the module. loader-num-threads int default value = 1 The number of threads that will be started by the Loader class to load models asynchronously. These threads will only be started if the asynchronous interface is used, and if threading support is compiled into Panda. The default is one thread, which allows models to be loaded one at a time in a single asychronous thread. You can set this higher, particularly if you have many CPU's available, to allow loading multiple models simultaneously. lock-to-one-cpu bool default value = 0 Set this to true if you want the entire process to use one CPU, even on multi-core and multi-CPU workstations. This is mainly a hack to solve a bug in which QueryPerformanceCounter returns inconsistent results on multi-core machines. lod-fade-time double default value = 0.5 The default amount of time (in seconds) over which a FadeLODNode transitions between its different levels. m-dual bool default value = 1 Set this false to disable TransparencyAttrib::M_dual altogether (and use M_alpha in its place). m-dual-flash bool default value = 0 Set this true to flash any objects that use M_dual, for debugging. m-dual-opaque bool default value = 1 Set this false to disable just the opaque part of M_dual. m-dual-transparent bool default value = 1 Set this false to disable just the transparent part of M_dual. matrix-palette bool default value = 0 Set this true to allow the use of the matrix palette when animating vertices in hardware. The matrix palette is not supported by all devices, but if it is, using it can allow animation of more sophisticated meshes in hardware, and it can also improve the performance of animating some simpler meshes. Without this option, certain meshes will have to be animated in software. However, this option is not enabled by default, because its support seems to be buggy in certain drivers (ATI FireGL T2 8.103 in particular.) max-collect-indices int default value = 65535 Specifies the maximum number of vertex indices that are allowed to be accumulated into any one GeomPrimitive as a result of collecting objects together during a flatten operation. This prevents the accidental generation of large index buffers from lots of smaller index buffers, while not imposing a limit on the original size of any one GeomPrimitive. max-collect-vertices int default value = 65535 Specifies the maximum number of vertices that are allowed to be accumulated into any one GeomVertexData structure as a result of collecting objects together during a flatten operation. This prevents the accidental generation of large vertex buffers from lots of smaller vertex buffers, while not imposing a limit on the original size of any one GeomVertexData structure. max-compressed-vertex-data int default value = 0 Specifies the maximum number of bytes of all vertex data that is allowed to remain compressed in system RAM at one time. If more than this number of bytes of vertices are created, the least-recently-used ones will be temporarily flushed to disk until they are needed. Set it to -1 for no limit. max-disk-vertex-data int default value = -1 Specifies the maximum number of bytes of vertex data that is allowed to be written to disk. Set it to -1 for no limit. max-dt double default value = -1 Sets a limit on the value returned by ClockObject::get_dt(). If this value is less than zero, no limit is imposed; otherwise, this is the maximum value that will ever be returned by get_dt(), regardless of how much time has actually elapsed between frames. See ClockObject::set_dt(). max-independent-vertex-data int default value = -1 Specifies the maximum number of bytes of all vertex data that is independent of the paging system. This is an initial buffer before max-ram-vertex-data, specifically designed for vertex datas that are dynamic in nature and may change size or be created and destroyed frequently. max-lag double default value = 0 This represents the time in seconds by which to artificially lag inbound messages. It is useful to test a game's tolerance of network latency. max-occlusion-vertices int default value = 3000 The maximum number of vertices that may be included in a PandaNode and its descendents in order to perform an occlusion query for it. Subgraphs whose total vertex count exceeds this number will be subdivided further before performing an occlusion test--the hope is that we can eventually get to a finer-grained answer. GeomNodes and Geoms will not be subdivided, regardless of this limit. max-resident-vertex-data int default value = -1 Specifies the maximum number of bytes of all vertex data that is allowed to remain resident in system RAM at one time. If more than this number of bytes of vertices are created, the least-recently-used ones will be temporarily compressed in system RAM until they are needed. Set it to -1 for no limit. max-texture-dimension int default value = -1 Set this to the maximum size a texture is allowed to be in either dimension. This is generally intended as a simple way to restrict texture sizes for limited graphics cards. When this is greater than zero, each texture image loaded from a file (but only those loaded from a file) will be automatically scaled down, if necessary, so that neither dimension is larger than this value. min-lag double default value = 0 This represents the time in seconds by which to artificially lag inbound messages. It is useful to test a game's tolerance of network latency. min-occlusion-vertices int default value = 300 The minimum number of vertices a PandaNode or Geom must contain in order to perform an occlusion query for it. Nodes and Geoms smaller than this will be rendered directly, without bothering with an occlusion query. model-path search-path $MAIN_DIR (from /d/panda3d-a/built/etc/Config.prc) $THIS_PRC_DIR/.. (from /d/panda3d-a/built/etc/Config.prc) $THIS_PRC_DIR/../models (from /d/panda3d-a/built/etc/Config.prc) The default directories to search for all models and general files loaded into Panda. multifile-encryption-iteration-count int default value = 0 This is a special value of encryption-iteration-count used to encrypt subfiles within a multifile. It has a default value of 0 (just one application), on the assumption that the files from a multifile must be loaded quickly, without paying the cost of an expensive hash on each subfile in order to decrypt it. multisamples int default value = 0 The minimum number of samples requested. no-unsupported-copy bool default value = 0 Set this true to make an attempt to copy an unsupported type generate an assertion failure instead of just a warning (which can then be trapped with assert-abort). notify-output filename default value = The filename to which to write all the output of notify occlusion-depth-bits int default value = 1 The minimum number of depth bits requested for the occlusion buffer. occlusion-size int default value = 256 256 Specify the x y size of the buffer used for occlusion testing. paranoid-clock bool default value = 0 Set this to true to double-check the results of the high-resolution clock against the system clock. paranoid-compose bool default value = 0 Set this true to double-check the componentwise transform compose (or invert) operation against the equivalent matrix-based operation. This has no effect if NDEBUG is defined. paranoid-const bool default value = 0 Set this true to double-check that nothing is inappropriately modifying the supposedly const structures like RenderState, RenderAttrib, TransformState, and RenderEffect. This has no effect if NDEBUG is defined. paranoid-hpr-quat bool default value = 0 Set this true to doublecheck the quaternion-hpr compose and decompose operations against the quaternion-matrix and matrix-hpr operations. This only has effect if NDEBUG is not defined. particle-path search-path The directories to search for particle files to be loaded. patcher-buffer-size int default value = 16384 Limits the size of the buffer used in a single call to Patcher::run(). Increasing this may help the Patcher perform more work before returning. patchfile-buffer-size int default value = 4096 patchfile-increment-size int default value = 8 patchfile-window-size int default value = 16 patchfile-zone-size int default value = 10000 physics_manager_random_seed int default value = 139 polylight-info bool default value = 0 Set this true to view some info statements regarding the polylight. It is helpful for debugging. prefer-parasite-buffer bool default value = 1 Set this true to make GraphicsOutput::make_texture_buffer() try to create a ParasiteBuffer before it tries to create an offscreen buffer (assuming it could not create a direct render buffer for some reason). This may reduce your graphics card memory requirements by sharing memory with the framebuffer, but it can cause problems if the user subsequently resizes the window smaller than the buffer. prefer-single-buffer bool default value = 1 Set this true to make GraphicsOutput::make_render_texture() first try to create a single-buffered offscreen buffer, before falling back to a double-buffered one (or whatever kind the source window has). This is true by default to reduce waste of framebuffer memory, but you might get a performance benefit by setting it to false (since in that case the buffer can share a graphics context with the window). prefer-texture-buffer bool default value = 1 Set this true to make GraphicsOutput::make_texture_buffer() always try to create an offscreen buffer supporting render-to-texture, if the graphics card claims to be able to support this feature. If the graphics card cannot support this feature, this option is ignored. This is usually the fastest way to render to a texture, and it presumably does not consume any additional framebuffer memory over a copy-to-texture operation (since the texture and the buffer share the same memory). preload-textures bool default value = 1 When this is true, texture images are loaded from disk as soon as the Texture is created from the TexturePool. When this is false, the Texture is created immediately, but the image data is not loaded from disk until the Texture is actually rendered (or otherwise prepared) on the GSG. This can help reduce wasted memory from Textures that are created but never used to render. premunge-data bool default value = 1 Set this true to preconvert vertex data at model load time to match the data requirements of the current GSG. For instance, color columns are pre-converted to match OpenGL or DirectX encoding requirements, as appropriate. When this is false, the data will be munged at render time instead. preserve-triangle-strips bool default value = 0 Set this true to indicate a preference for keeping triangle strips when possible, instead of decomposing them into triangles. When this is true, flatten_strong and unify operations may be less effective at combining multiple Geoms together, but they will not implicitly decompose triangle strips. project-invert-uvs bool default value = 0 If this is true, the UV's generated by all ProjectionScreens are inverted top-to-bottom. This used to be required to compensate for buggy graphics drivers that rendered to a texture upside-down in this manner, but nowadays Panda should be able to autodetect these graphics drivers. If it fails to do this, you should probably set copy-texture-inverted instead, which is more general. pstats-average-time double default value = 3 pstats-history double default value = 60 pstats-host string default value = localhost pstats-max-rate double default value = 1000 The maximum number of packets per second, per thread, to send to the remote PStats server. A packet is defined as a single UDP packet, or each 1024 bytes of a TCP message. pstats-mem-other bool default value = 1 Set this true to collect memory categories smaller than 0.1% of the total into a single "Other" category, or false to show each nonzero memory category. pstats-name string default value = Panda Stats pstats-port int default value = 5185 pstats-scroll-mode bool default value = 1 pstats-target-frame-rate double default value = 30 Specify the target frame rate to highlight on the PStats graph. This frame rate is marked with a different-colored line; otherwise, this setting has no effect. pstats-tcp-ratio double default value = 0.01 This specifies the ratio of frame update messages that are eligible for UDP that are sent via TCP instead. It does not count messages that are too large for UDP and must be sent via TCP anyway. 1.0 means all messages are sent TCP; 0.0 means all are sent UDP. pstats-threaded-write bool default value = 1 Set this true to write to the PStats channel in a sub-thread, if threading is available. Can't think of any reason why you wouldn't want this set true, unless you suspect something is broken with the threaded network interfaces. pstats-unused-states bool default value = 0 Set this true to show the number of unused states in the pstats graph for TransformState and RenderState counts. This adds a bit of per-frame overhead to count these things up. read-compressed-channels bool default value = 1 Set this false to disable reading of compressed animation channels, even if the decompression code is available. The only reason you might want to do this would be to speed load time when you don't care about what the animation looks like. red-blue-stereo bool default value = 0 Set this true to create windows with red-blue stereo mode enabled by default, if the framebuffer does not support true stereo rendering. red-blue-stereo-colors string default value = red blue This defines the color channels that are used for the left and right eye, respectively, for red-blue-stereo mode. This should be a two-word string, where each word is one of 'red', 'blue', 'green', or 'alpha'. rescale-normals enum default value = auto Specifies the kind of RescaleNormalAttrib that should be created for the top of the scene graph. This can automatically ensure that your lighting normals are unit-length, which may be particularly necessary in the presence of scales in the scene graph. Turning it off ('none') may produce a small performance benefit. respect-effective-normal bool default value = 1 This should be true to support the effective_normal interface of polygons. Set it false to disable this feature, so that all collision solids (including polygons and planes) use their actual normal for intersection and physics tests. respect-prev-transform bool default value = 0 Set this true to have all CollisionTraversers in the world respect the previous frame's transform (position) for a given object when determining motion for collision tests. If this is false, you must explicitly enable motion detection for a particular traverser. It is false by default to force programmers to decide on a case-by-case basis whether they really need this feature. retransform-sprites bool default value = 1 To render sprite-based particle effects, Panda must convert the sprite points from object space into clip space, and compute the corners of the quads in clip space. When this variable is false, the resulting quads are then sent to the graphics hardware in clip space. When this is true, the quads are re-transformed back into the original object space, which is necessary in order for fog to work correctly on the sprites. screenshot-extension string default value = jpg This specifies the default filename extension (and therefore the default image type) to be used for saving screenshots. screenshot-filename string default value = %~p-%a-%b-%d-%H-%M-%S-%Y-%~f.%~e This specifies the filename pattern to be used to generate screenshots captured via save_screenshot_default(). See DisplayRegion::save_screenshot(). scroll-continued-delay double default value = 0.1 This is the amount of time, in seconds, to delay between lines scrolled while the user is continuing to hold down the scrollbar button. scroll-initial-delay double default value = 0.3 This is the amount of time, in seconds, to delay after the user first clicks and holds on a scrollbar button before the scrolling continues automatically. sgi-imagename string default value = This string is written to the header of an SGI (*.rgb) file. It seems to have documentation purposes only. sgi-storage-type enum default value = rle Use either 'rle' or 'verbatim' to indicate how SGI (*.rgb) files are written. show-occlusion bool default value = 0 Set this true to visualize the efforts of the occlusion test. show-transparency bool default value = 0 Set this true to flash any objects that are rendered in some transparency mode. The color chosen is based on the particular transparency mode in effect. This only has effect when NDEBUG is not defined. show-vertex-animation bool default value = 0 Set this true to flash any objects whose vertices are animated by Panda on the CPU (flash red) or by hardware (flash blue). This only has effect when NDEBUG is not defined. skel-sample-config-variable int default value = 3 sleep-precision double default value = 0.01 This is the accuracy within which we can expect select() to return precisely. That is, if we use select() to request a timeout of 1.0 seconds, we can expect to actually sleep for somewhere between 1.0 and 1.0 + sleep-precision seconds. sound-path search-path $MAIN_DIR (from /d/panda3d-a/built/etc/Config.prc) $THIS_PRC_DIR/.. (from /d/panda3d-a/built/etc/Config.prc) $THIS_PRC_DIR/../models (from /d/panda3d-a/built/etc/Config.prc) The directories to search for sound and music files to be loaded. ssl-certificates list ssl-cipher-list string default value = DEFAULT This is the default value for HTTPClient::set_cipher_list(). state-cache bool default value = 1 Set this true to enable the cache of RenderState objects, similar to the TransformState cache controlled via transform-cache. stencil-bits int default value = 0 The minimum number of stencil buffer bits requested. support-fade-lod bool default value = 1 Set this false to make FadeLOD nodes behave like regular LOD nodes (ignoring the fade time). This may be useful, for instance, to test the performance impact of using FadeLOD nodes. support-render-texture bool default value = 1 Set this true allow use of the render-to-a-texture feature, if it is supported by your graphics card. Without this enabled, offscreen renders will be copied to a texture instead of directly rendered there. support-rescale-normal bool default value = 1 Set this true allow use of the rescale-normal feature, if it is supported by your graphics card. This allows lighting normals to be uniformly counter-scaled, instead of re-normalized, in the presence of a uniform scale, which should in principle be a bit faster. This feature is only supported by the OpenGL API. support-threads bool default value = 1 Set this false to disallow the creation of threads using Panda's Thread interface, even if threading support is compiled in. This does not affect the operation of mutexes and other synchronization primitives, just the creation of threads. sync-flip bool default value = 1 Set this true to attempt to flip all windows at the same time, or false to flip each window as late as possible. Setting this false can improve parallelization. This is a temporary variable; it will later be replaced with a more explicit control over synchronizing window flip. sync-video bool default value = 1 Configure this true to request the rendering to sync to the video refresh, or false to let your frame rate go as high as it can, irrespective of the video refresh. Usually you want this true, but it may be useful to set it false during development for a cheesy estimate of scene complexity. Some drivers may ignore this request. temp-hpr-fix bool default value = 1 Set this true to compute hpr's correctly. Historically, Panda has applied these in the wrong order, and roll was backwards relative to the other two. Set this false if you need compatibility with Panda's old hpr calculations. text-anisotropic-degree int default value = 1 This is the default anisotropic-degree that is set on dynamic font textures. Setting this to a value greater than 1 can help smooth out the antialiasing for small letters. text-default-font filename default value = This names a filename that will be loaded at startup time as the default font for any TextNode that does not specify a font otherwise. The default is to use a special font that is compiled into Panda, if available. text-embed-graphic-key int default value = 5 This is the decimal character number that, embedded in a string, is used to bracket the name of a model added to the TextPropertiesManager object, to embed an arbitrary graphic image within a paragraph. text-encoding enum default value = iso8859 Specifies how international characters are represented in strings of 8-byte characters presented to Panda. See TextEncoder::set_encoding(). text-flatten bool default value = 1 Set this true to flatten text when it is generated, or false to keep it as a deep hierarchy. Unless you are debugging the text interface, it is almost always a good idea to leave this at its default, true. text-hyphen-ratio double default value = 0.7 If the rightmost whitespace character falls before this fraction of the line, hyphenate a word to the right of that if possible. text-magfilter enum default value = linear The default texture magfilter type for dynamic text fonts text-max-never-break int default value = 3 If we have more than this number of text-never-break-before characters in a row, do not treat any of them as special and instead break the line wherever we can. text-minfilter enum default value = linear_mipmap_linear The default texture minfilter type for dynamic text fonts text-native-antialias bool default value = 1 text-page-size int default value = 256 256 This is the default size for new textures created for dynamic fonts. text-pixels-per-unit double default value = 30 text-point-size double default value = 10 text-poly-margin double default value = 0 This is the amount by which to make each glyph polygon larger than strictly necessary, in screen units that are added to each margin. Increasing this value will decrease the tendency for letters to get chopped off at the edges, but it will also increase the tendency for adjacent glyphs to bleed into each other (unless you also increase text-texture-margin). text-pop-properties-key int default value = 2 This is the decimal character number that undoes the effect of a previous appearance of text_push_properties_key. text-push-properties-key int default value = 1 This is the decimal character number that, embedded in a string, is used to bracket the name of a TextProperties structure added to the TextPropertiesManager object, to control the appearance of subsequent text. text-render-mode enum default value = texture The default render mode for dynamic text fonts text-scale-factor double default value = 2 text-small-caps bool default value = 0 This controls the default setting for TextNode::set_small_caps(). text-small-caps-scale double default value = 0.8 This controls the default setting for TextNode::set_small_caps_scale(). text-soft-break-key int default value = 4 This is similar to text-soft-hyphen-key, except that when it is used as a break point, no character is introduced in its place. text-soft-hyphen-key int default value = 3 This is the decimal character number that, embedded in a string, is identified as the soft-hyphen character. text-tab-width double default value = 5 This controls the default setting for TextNode::set_tab_width(). text-texture-margin int default value = 2 This is the number of texels of empty space reserved around each glyph in the texture. Setting this value larger will decrease the tendency for adjacent glyphs to bleed into each other at small sizes, but it will increase amount of wasted texture memory. text-wrap-mode enum default value = border_color The default wrap mode for dynamic text fonts texture-filter list Names one or more external libraries that should be loaded for the purposes of performing texture filtering. This variable may be repeated several times. As in load-display, the actual library filename is derived by prefixing 'lib' to the specified name. texture-path search-path $MAIN_DIR (from /d/panda3d-a/built/etc/Config.prc) $THIS_PRC_DIR/.. (from /d/panda3d-a/built/etc/Config.prc) $THIS_PRC_DIR/../models (from /d/panda3d-a/built/etc/Config.prc) A special directory path to search for textures only. Textures are also searched for along the model-path, so the use of texture-path is only useful if you have special directories that only contain textures. texture-scale double default value = 1 This is a global scale factor that is applied to each texture as it is loaded from disk. For instance, a value of 0.5 will reduce each texture to one-half its size in each dimension. This scale factor is applied before textures-power-2 or max-texture-dimension. textures-header-only bool default value = 0 If this is true, texture images will not actually be loaded from disk, but the image header information will be consulted to verify number of channels and so forth. The texture images themselves will be generated in a default blue color. textures-power-2 enum default value = down Specify whether textures should automatically be constrained to dimensions which are a power of 2 when they are loaded from disk. Set this to 'none' to disable this feature, or to 'down' or 'up' to scale down or up to the nearest power of 2, respectively. This only has effect on textures which are not already a power of 2. textures-square enum default value = none Specify whether textures should automatically be constrained to a square aspect ratio when they are loaded from disk. Set this to 'none', 'down', or 'up'. See textures-power-2. tga-colormap bool default value = 0 Set this true to write colormapped TGA files. tga-grayscale bool default value = 0 Set this true to enable writing grayscale TGA files. tga-rle bool default value = 0 Set this true to enable RLE compression when writing TGA files. thread-stack-size int default value = 4194304 Specifies the minimum size, in bytes, of the stack that will be created for each newly-created thread. Not all thread implementations respect this value. threading-model string default value = This is the default threading model to use for new windows. Use empty string for single-threaded, or something like "cull/draw" for a 3-stage pipeline. See GraphicsEngine::set_threading_model(). EXPERIMENTAL and incomplete, do not use this! track-memory-usage bool default value = 0 Set this to true to enable full-force tracking of C++ allocations and recordkeeping by type. It's quite expensive. transform-cache bool default value = 1 Set this true to enable the cache of TransformState objects. Using the cache saves time computing transforms and inverse transforms, but imposes some overhead for maintaining the cache itself. unambiguous-graph bool default value = 0 Set this true to make ambiguous path warning messages generate an assertion failure instead of just a warning (which can then be trapped with assert-abort). undecorated bool default value = 0 uniquify-matrix bool default value = 0 Set this true to look up arbitarary 4x4 transform matrices in the cache, to ensure that two differently-computed transforms that happen to encode the same matrix (an unlikely occurrence) will be collapsed into a single pointer (a tiny benefit). We're usually better off not paying the cost of this comparison, and just assuming that any two differently-computed transforms are essentially different. use-high-res-clock bool default value = 1 Set this to false to avoid using the high-precision clock, even if it is available. use-vfs bool default value = 1 Set this true to use the VirtualFileSystem mechanism for loading models, etc. Since the VirtualFileSystem is now the de facto filesystem for Panda, you should always keep this true, since there is now code that assumes it to be true. This variable is now deprecated. verify-intervals bool default value = 0 Set this true to generate an assertion failure if interval functions are called out-of-order. verify-lods bool default value = 0 When this is true, LODNodes will test when they are rendered to ensure that each child's geometry fits entirely within the radius defined by its switch-out distance. When it is false, LODNodes may have any switch in and out distances, regardless of the actual size of their geometry. This test is only made in NDEBUG mode (the variable is ignored in a production build). verify-ssl bool default value = 1 Configure this true (the default) to insist on verifying all SSL (e.g. https) servers against a known certificate, or false to allow an unverified connection. This controls the default behavior; the specific behavior for a particular HTTPClient can be adjusted at runtime with set_verify_ssl(). vertex-arrays bool default value = 1 Set this true to allow the use of vertex arrays for rendering OpenGL vertex data. This, or vertex buffers, is the normal way of issuing vertices ever since OpenGL 1.1, and you almost always want to have this set to true. However, some very buggy graphics drivers may have problems handling vertex arrays correctly, so if you are experiencing problems you might try setting this to false. If this is false, Panda will fall back to using immediate-mode commands like glVertex3f(), etc., to issue the vertices, which is potentially much slower than vertex arrays. Setting this false also disables vertex buffers, effectively ignoring the setting of the vertex-buffers variable (since vertex buffers are a special case of vertex arrays in OpenGL). This variable is normally not enabled in a production build. This has no effect on DirectX rendering. vertex-buffers bool default value = 1 Set this true to allow the use of vertex buffers (or buffer objects, as OpenGL dubs them) for rendering vertex data. This can greatly improve rendering performance on higher-end graphics cards, at the cost of some additional graphics memory (which might otherwise be used for textures or offscreen buffers). On lower-end graphics cards this will make little or no difference. vertex-data-compression-level int default value = 1 Specifies the zlib compression level to use when compressing vertex data. The number should be in the range 1 to 9, where larger values are slower but give better compression. vertex-data-page-size int default value = 512 The number of bytes to allocate at a time for vertex data. This also controls the page size that is compressed and written to disk when vertex data pages are evicted from memory. vertex-data-small-size int default value = 64 When a GeomVertexArrayData is this number of bytes or smaller, it is deemed too small to pay the overhead of paging it in and out, and it is permanently retained resident. vertex-data-threaded-paging bool default value = 1 When this is true (and Panda has been compiled with thread support) then a sub-thread will be spawned to evict vertex pages to disk and read them back again. When this is false, this work will be done in the main thread, which may introduce occasional random chugs in rendering. vertex-save-file-directory filename default value = The directory in which the saved vertex data file is created for saving vertex buffers that have been evicted from RAM. If this is the empty string, or an invalid directory, a system default directory will be chosen. vertex-save-file-prefix string default value = p3d_vdata_ A prefix used to generate the filename for the saved vertex data file which is created for saving vertex buffers that have been evicted from RAM. A uniquifying sequence number and filename extension will be appended to this string. vfs-case-sensitive bool default value = 1 Set this true to make the VirtualFileSystem present the native OS-provided filesystem as if it were a case-sensitive file system, even if it is not (e.g. on Windows). This variable has no effect if the native filesystem is already case-sensitive, and it has no effect on mounted multifile systems, which are always case-sensitive. vfs-implicit-pz bool default value = 1 When this is true, the VirtualFileSystem will pretend a named file exists even if it doesn't, as long as a filename with the same name and the additional extension .pz does exist. In this case, the VirtualFileSystem will implicitly open the .pz file and decompress it on-the-fly. view-frustum-cull bool default value = 1 This is normally true; set it false to disable view-frustum culling (primarily useful for debugging). win-origin int default value = This is the default position at which to open a new window. This replaces the deprecated win-origin-x and win-origin-y variables. win-size int default value = 640 480 This is the default size at which to open a new window. This replaces the deprecated win-width and win-height variables. window-inverted bool default value = 0 Set this true to create all windows with the inverted flag set, so that they will render upside-down and backwards. Normally this is useful only for debugging. window-title string default value = Panda yield-timeslice bool default value = 0 Set this true to yield the timeslice at the end of the frame to be more polite to other applications that are trying to run. z-order enum default value = normal
<<prev | top | next>> |