Note that in the discussion of the following error codes, the comments involving "Object Builder" functions RwModelBegin(), RwModelEnd(), RwProtoBegin(), RwProtoEnd(), RwClumpBegin(), RwClumpEnd(), RwTransformBegin() and RwTransformEnd() also apply to their script keyword counterparts.
E_RW_BADOPEN
An error occurred while opening the specified file.
E_RW_CLUMPHASCOMPLEXPOLYGONS
You can only gain access to immediate mode polygons from a clump if the clump contains 'simple' polygons. That is the input polygons have not been split into smaller polygons by renderware (if they are concave for example).
E_RW_COMPLEXPOLYGON
The specified polygon has too many sides. The maximum number of sides a polygon can have in RenderWare V2.1 is 255.
E_RW_DEFSCENE
An attempt was made to destroy the default scene or explicitly remove a clump or light from it.
E_RW_DEGEN
An attempt was made to create a degenerate clump (a clump with no children and no geometry).
E_RW_DEGENPOLYGON
A degenerate polygon (one with less than three sides) was specified.
E_RW_DEVICEALREADYSTARTED
The device could not be started because it was already started.
E_RW_DEVICEINCORRECTVERSION
This device cannot be used with this version of renderware. Currently no version checking is performed.
E_RW_DEVICENOTFOUND
The device to be opened could not be found.
E_RW_DEVICENOTSTARTED
The device has not been started.
E_RW_ENDOFSTREAM
The end of an RwStream has been reached.
E_RW_ENVMAPOUTSIDECAMERAUPDATE
A call has been made to RwEnvMapClump() outside a RwBeginCameraUpdate() .. RwEndCameraUpdate() block.
E_RW_INTERNAL
An internal (library) error has occurred. Contact RenderWare technical support.
E_RW_INVALIDDEVICEFEATURE
The current device does not support the requested feature.
E_RW_INVAXISALIGNMENT
An invalid clump axis alignment type was specified. The legal values are rwNOAXISALIGNMENT, rwALIGNAXISZORIENTX, rwALIGNAXISZORIENTY and rwALIGNAXISXYZ.
E_RW_INVCAMERAPROJECTION
An invalid camera projection type was specified. The legal values are rwPERSPECTIVE and rwPARALLEL.
E_RW_INVCHUNKSTRUCTURE
An invalid chunk structure has been found. This is probably due to a corrupted file.
E_RW_INVCHUNKTYPE
An invalid chunk type has been found. It will be skipped
E_RW_INVCOP
An invalid RwCombineOperation was specified. The legal values are rwREPLACE, rwPRECONCAT and rwPOSTCONCAT.
E_RW_INVDEVICE
An invalid device name was specified in a call to RwOpen() or RwOpenExt().
E_RW_INVDEVICEACTION
An invalid action was specified in a call to RwDeviceControl(). For a description of legal actions see Appendix B.
E_RW_INVDEVICEINFO
An invalid information type was specified in a call to RwGetDeviceInfo(). For a description of legal information types see the description of RwGetDeviceInfo() and Appendix B.
E_RW_INVFRAME
An invalid texture frame number was specified. A valid frame index is greater than or equal to zero and less than the number of frames in the texture.
E_RW_INVFRAMESTEP
An invalid texture frame step was specified. A valid step size is less than the absolute number of frames in the texture.
E_RW_INVGEOMETRYSAMPLING
An invalid geometry sampling type was specified. The legal values are rwPOINTCLOUD, rwWIREFRAME and rwSOLID.
E_RW_INVHINT
An invalid clump hint was specified. The legal values are rwCONTAINER, rwHS and rwEDITABLE.
E_RW_INVIMAGEFILE
An image file (MS Window‘s bitmap file or Sun Rasterfile) being read by RwReadRaster(), RwReadMaskRaster(), RwReadTexture() or RwReadNamedTexture() was not valid. This code indicates an error in the image data in the file.
E_RW_INVLIGHT
An invalid light type was specified. The legal values are rwDIRECTIONAL, rwPOINT and rwCONICAL.
E_RW_INVLIGHTSAMPLING
An invalid light sampling type was specified. The legal values are rwFACET and rwVERTEX.
E_RW_INVMATERIAL
An attempt was made to destroy a material whose handle was not obtained by calling RwCreateMaterial(), e.g., a material obtained by calling RwGetPolygonMaterial()
E_RW_INVMATERIALMODE
An invalid material mode was specified. The legal values are rwDOUBLE.
E_RW_INVOPENOPTION
An invalid option was specified in a call to RwOpenExt(). For a description of legal options see Appendix B.
E_RW_INVPOLYGONINDEX
An attemt was made to access a polygon which doesn't exist.
E_RW_INVPROTOTYPE
A prototype attempted to create an instance of itself.
E_RW_INVRASTEROPTIONS
An invalid raster processing option (or combination of options) was specified. The valid options are rwGAMMARASTER, rwDITHERRASTER and rwFITRASTER.
E_RW_RASTERSIZE
A raster of an invalid size was specified. If the raster was being selected into a texture with RwSetTextureRaster() the raster must have a width of 128 and a height of n * 128 where n is the number of frames in a multi-frame texture.
E_RW_INVBUFFERSIZE
A buffer passed in to a RenderWare function was not large enough
E_RW_INVSEARCHMODE
An invalid search mode was specified. The legal values are rwLOCAL and rwGLOBAL.
E_RW_INVSPP
An invalid spline path type was specified. The legal values are rwSMOOTH and rwNICEENDS.
E_RW_INVSPT
An invalid spline type was specified. The legal values are rwOPENLOOP and rwCLOSEDLOOP.
E_RW_INVSTATE
An invalid state was specified. The legal values are rwON and rwOFF.
E_RW_INVSTREAMACCESSTYPE
An invalid access type for a stream has been specified. The legal values are rwSTREAMREAD, rwSTREAMWRITE and rwSTREAMAPPEND.
E_RW_INVSTREAMTYPE
An invalid stream type has been specified. The legal values are rwSTREAMFILE, rwSTREAMFILENAME and rwSTREAMMEMORY.
E_RW_INVSYSTEMINFO
An invalid system parameter was specified. The legal values are rwVERSIONSTRING, rwVERSIONMAJOR, rwVERSIONMINOR, rwVERSIONRELEASE, rwFIXEDPOINTLIB and rwDEBUGGINGLIB.
E_RW_INVTEXTUREDITHERMODE
An invalid texture dithering mode was specified. The legal values are rwAUTODITHER, rwDITHERON and rwDITHEROFF.
E_RW_INVTEXTUREHEIGHT
A texture with an invalid height was specified.
E_RW_INVTEXTUREMODE
An invalid texture mode was specified. The legal values are rwLIT, rwFORESHORTEN and rwFILTER.
E_RW_INVTEXTURENAME
An invalid texture name was specified.
E_RW_INVTEXTUREWIDTH
A texture with an invalid width was specified.
E_RW_INVUSERDRAWALIGN
An invalid user-draw alignment type was specified. The legal values are rwALIGNTOP, rwALIGNBOTTOM, rwALIGNLEFT and rwALIGNRIGHT. For convenience rwALIGNTOPLEFT and rwALIGNBOTTOMRIGHT are also defined.
E_RW_INVUSERDRAWTYPE
An invalid user-draw type was specified. The legal values are rwCLUMPALIGN, rwVERTEXALIGN, rwBBOXALIGN and rwVPALIGN.
E_RW_INVVERTEXINDEX
An invalid vertex index was found. A valid index for a vertex is greater than or equal to one and less than or equal to the number of vertices in the clump to which it belongs.
E_RW_LIBRARYNOTINITIALIZED
An attempt was made to an operation before the library has been initialized.
E_RW_NESTEDMODEL
A nested RwModelBegin() was found in an RwModelBegin() … RwModelEnd() block or an RwClumpBegin() … RwClumpEnd() or RwProtoBegin() … RwProtoEnd() block. Nested modeling contexts are not allowed.
E_RW_NESTEDPROTOTYPE
A nested RwProtoBegin() was found in an RwProtoBegin() … RwProtoEnd() block or an RwClumpBegin() … RwClumpEnd() block. Nested prototype declarations are not allowed.
E_RW_NOCLUMP
No clump is currently under construction. Note that the current clump is an implicit argument of some "Object Builder" functions, e.g., RwSphere().
E_RW_NOCLUMPBUILT
The parsing of a script file resulted in no clump being created, i.e., the top-level ClumpBegin … ClumpEnd was missing from the script.
E_RW_NODEVICESAVAILABLE
Could not find any suitable devices.
E_RW_NODEVICESPECIFIED
If a device is not specified when opening a renderware, renderware will look for the device held in the RWDEVICE environment variable. If this is not defined then this error is given.
E_RW_NOERROR
No error has been set. This code indicates that no error has been detected.
E_RW_NOFILE
The specified file does not exist.
E_RW_NOMATCHBEGIN
No matching "Begin" was found for an "End". For example, this error would occur if there was no matching RwTransformBegin() for an RwTransformEnd().
E_RW_NOMATCHEND
No matching "End" was found for a "Begin". For example, this error would occur if there was no matching RwModelEnd() for an RwModelBegin().
E_RW_NOMEM
The library was unable to perform the specified operation due to insufficient memory.
E_RW_NOMODELBEGIN
An attempt was made to declare a prototype outside of an RwModelBegin() … RwModelEnd() block.
E_RW_NOPROTOTYPEFOUND
No prototype with the specified name was found.
E_RW_NOSUITABLEDEVICE
After searching for a device if no device matching the required charcteristics is found then this error is returned.
E_RW_NOTAUSERCREATEDRASTER
A user raster operation has been performed on a non user raster object.
E_RW_NOTROOT
An attempt was made to add to a scene or remove from a scene a clump that is not the root of its hierarchy.
E_RW_NOVISIBLEZBUFFER
The camera does not have a visible Z buffer
E_RW_NULLP
A NULL pointer was used as an argument to a library function where a non-NULL object pointer was expected.
E_RW_RANGE
A numeric range error occurred.
E_RW_RASTERINUSE
An attempt was made to select a raster already owned by a texture into a different texture or to destroy a raster owned by a texture.
E_RW_READ
An error occurred while reading from an input stream.
E_RW_RSINVAXISALIGNMENT
An invalid clump axis alignment type was specified in a script file. The legal values are None, ZOrientX, ZOrientY and XYZ.
E_RW_RSINVDITHERMODE
An invalid texture dithering mode was specified in a script file. The legal values are On, Off and Auto.
E_RW_RSINVGAMMAMODE
An invalid texture gamma correction mode was specified in a script file. The legal values are On and Off.
E_RW_RSINVGEOMETRYSAMPLING
An invalid geometry sampling type was specified in a script file. The legal values are PointCloud, Solid and WireFrame.
E_RW_RSINVHINT
An invalid clump hint was specified in a script file. The legal values are NULL, Container, HS and Editable.
E_RW_RSINVLIGHTSAMPLING
An invalid light sampling type was specified in a script file. The legal values are Facet and Vertex.
E_RW_RSINVMATERIALMODE
An invalid material mode was specified in a script file. The legal values are Double
E_RW_RSINVTEXTUREMODE
An invalid texture mode was specified in a script file. The legal values are NULL, Lit, Foreshorten and Filter.
E_RW_RSINVTRACESTATE
A invalid tracing state was specified in a script file. The legal values are On and Off.
E_RW_RSNOHINTS
No hints were specified as arguments for a scripting command that adds, removes, or sets hints. The legal values are NULL, Container, HS and Editable.
E_RW_RSNOMATERIALMODES
No material modes were specified as arguments for a scripting command that adds, removes or sets material modes. The legal values are Double.
E_RW_RSNOTEXTUREMODES
No texture modes were specified as arguments for a scripting command that adds, removes or sets texture modes. The legal values are Null, Lit, Foreshorten and Filter.
E_RW_RSPARSE
An invalid keyword was found in a script file.
E_RW_RSREAD
An I/O error occurred while reading from a script file.
E_RW_SHPPATH
The shape path is too long (greater than 1024 characters).
E_RW_TEXTUREHASNONAME
An attempt to save a rasterless texture chunk in a binary file has failed since the texture has no associated name.
E_RW_TEXTURENOTINDICTIONARY
An attempt to load a binary file texture chunk which has no embedded raster has failed since the texture does not currently exist in the texture dictionary.
E_RW_TEXTURENOTFOUND
The specified texture was not found.
E_RW_UNABLETOSTARTDEVICE
Something is preventing the device from being started. The reason for this is probably due an invalid set of options for the device. This is a general error, the device should generally set a more accurate error code.
E_RW_USER
A call to RwSetUserError() generated this error.
E_RW_WRITE
An error occurred while writing to an output stream.
E_RW_WSWRITE
An error occurred while writing a script to an output stream.
E_RW_ZEROVEC
A zero length vector was specified.