This class represents a texture managed by the hardware. Depending on the underlying 3D implementation, the texture may be directly accessible for blitting operations or it may not. If it is directly accessible, then the 'bits' will provide a surface handle for BitBlt. If not, the bits will shadow the upload contents in the format that matches what the underlying implementation requires. In other words: The format of the texture is always identical with the hardware's assumption so that we can perform dithering etc. to achieve the best effect from within Squeak.

WARNING: This class is private to the B3DHardwareEngine; use outside of this context (in particular in client applications) is *STRONGLY* discouraged. Client applications should use regular B3DTextures.

	initialize-release
	destroy

	private
	getExternalHandle initializeFrom: setExtent:depth:bits:rgbaBitMasks:handle:renderer:

	testing
	hasNonStandardPalette isExternalForm

	upload/download
	needsUpload prepareForUpload releaseFromUpload unhibernate

	accessing	top
	colormapFromARGB Return a ColorMap mapping from canonical ARGB pixel values into the receiver
	rgbaBitMasks Return the masks for specifying the R,G,B, and A components in the receiver

	initialize-release	top
	destroy Destroy the receiver

	private	top
	getExternalHandle Private. Return the virtual handle used to represent the receiver
	initializeFrom: Private. Initialize the receiver from aTexture.
	setExtent:depth:bits:rgbaBitMasks:handle:renderer:

	testing	top
	hasNonStandardPalette Quite possible.
	isExternalForm Yup.

	upload/download	top
	needsUpload Return true if the receiver needs to be uploaded
	prepareForUpload The receiver is about to be modified for a texture upload. Bring it's bits in place.
	releaseFromUpload The receiver has been uploaded. Release its bits.
	unhibernate If my bitmap has been compressed into a ByteArray, then expand it now, and return true.